# dsh-sideask

在任意 DSH 会话里，查看并回答别的会话挂着的 `ask_user_question`，不用切过去。

**Powered by [DSH](https://github.com/deepseek-ai/deepseek-harness)**，是个插件，不是分支。

[English](README.md)

## 解决什么

DSH 只把 `ask_user_question` 的卡片画在发起提问的那个会话里。人在会话 B 干活时，会话 A 正等着一个回答，你既看不见，也没法在 B 处理。要么切过去翻，要么让那边干等。

## 做什么

- 把一个工作区里所有会话挂着的提问收在一起。
- 侧栏底部一个「待答 N」小按钮，没有待答时完全不显示。
- 点一下，左下角浮出面板：一个会话一张卡，写清会话标题、问题、选项，另带一个自由输入框。
- 提交后通过 `userQuestions.answer` 把答案送回发起提问的会话。

面板不占输入区，不抢焦点，不遮页面中间。

## 前提

- DSH `0.2.0` 及以上。
- **`ask_user_question` 必须工作在 `timed` 模式。**

这一条关键。默认的 `blocking` 模式下，提问一直停在前台等待，只有发起它的会话里的卡片能结算，任何外部界面都答不了。`timed` 模式到期后工具返回 `pending`，提问变成 *continued*：仍然可答，但不再归某一个界面独占。本插件接的就是这个状态。

在 profile 的 `cordis.patch.yml` 里给 `tool-ask-user` 那一行加配置：

```yaml
- id: tool-ask-user
  name: '@deepseek-ai/dsh-tool-ask-user'
  config:
    mode: timed
    timeout: 60
```

这样提问在 `timeout` 秒之后就能从面板答。工具也接受每次调用自带的 `timeout` 参数，调用方想快一点可以传更小的值。

## 安装

1. 把包放进 profile 的插件目录，例如 `~/.dsh/profiles/desktop/plugins/dsh-sideask`。
2. 在 profile 的 `node_modules/@local` 下建一条与包名一致的链接：

   ```powershell
   New-Item -ItemType Junction `
     -Path  "$HOME\.dsh\profiles\desktop\node_modules\@local\dsh-sideask" `
     -Target "$HOME\.dsh\profiles\desktop\plugins\dsh-sideask"
   ```

3. 在 `cordis.patch.yml` 里加一行：

   ```yaml
   - id: dsh-sideask
     name: '@local/dsh-sideask'
   ```

4. 重启 DSH。客户端插件在启动时打包，刷新页面不够。

## 实现

两半。

**host 半** `index.js` 全局监听 `session/event`，用 `sessionId|callId` 作键维护一张待答表。

- 名字是 `ask_user_question` 的 `tool/call`：记下调用、问题、会话工作目录。
- `tool/result` 收尾时看结果：返回 `pending` 说明到期放行、问题仍可答，保留记录；其他结果说明问题已经结算，划掉。
- `turn/end` 不清表；到期挂起的提问跨回合有效。

两个 HTTP 路由：

- `GET /dsh-sideask/list?session=<id>` 返回工作目录与请求方一致的待答项，一个工作区与别的工作区分开。
- `POST /dsh-sideask/answer`，body 是 `{ sessionId, callId, answers }`，内部调 `ctx.userQuestions.answer(agent, callId, { answers })`。

**client 半** `client.js` 注册两个 slot：

- `sidebar.footer.action`：计数按钮，数量为 0 时不渲染。
- `shell.overlay`：面板，贴左下角，点 × 或按 Esc 收起。

计数按钮挂载期间每 4 秒拉一次列表，打开面板时立即刷新一次。

## 几个坑

- `userQuestions.answer` 要的是 `{ answers: [...] }` 对象，传裸数组会被判没答上，返回 `false`。
- `stillOpen === true` 才是答案进了队列；`false` 是没找到这个可答的提问。
- `pending` 的 tool 结果不是「答完了」。当成答完，问题会在没人回答时从面板消失。
- 提交成功后立刻从本地缓存里删掉那一条。等服务端划掉的话，中间有一段面板还列着已经答过的问题。

## 已知限制

- 只显示同一工作目录下的提问。
- 还在前台等待期内的问题不能从这里答，见「前提」。
- 待答记录在内存里，DSH 重启会清空；仍然可答的提问要等再次提问才会重新出现。
- 超过 24 小时的记录不再返回。

## 许可

MIT