侧问实时 neutron42-jp/dsh-btw-live

dsh-btw-live

DeepSeek Harness 的 /btw。可以连当前正在跑的回合也算上，从旁边向会话提问，答案不会留在对话历史里，也不会进入模型的上下文。

特点

- 正在执行的回合里的工具调用和结果也能读到（session.snapshotEvents()）。和 fork 式的旁问不同，不用停回合就能问「现在到哪一步了」
- 只调一次 LLM。不执行工具，也不写进历史
- 模型用该会话正在用的那个（未发送的选择 → 上一次请求的请求头 → 默认模型，按这个顺序）。会话换了模型也跟着换
- 答案显示在转录里的「BTW 卡片」中。支持 Markdown，长回答在卡片内滚动，点标题栏折叠
- 等回答时显示「思考中…」，失败显示红字。回答一到自动展开
- 用和会话相同的模型、相同的 reasoning effort（没指定就用适配器默认值）发送，只收紧输出上限。服务商拒绝这种形式时，去掉上限、按和会话相同的形状只重试一次

环境要求

| DeepSeek Harness | 在 0.2.1-rc.2 上验证（用到 conversation.chat.commandview 插槽） |
| Node.js | 22 以上 |

安装

cd "${DSH_HOME:-$HOME/.dsh}/profiles/web"
pnpm add link:/path/to/dsh-btw-live

加到 package.json 的 dsh.profile.bundles 里：

"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"@local/btw-live"
]

重启 dsh web 并刷新页面。客户端只在启动时扫描一次，所以第一次必须重启（之后改 client.js 由 HMR 接管）。

用法

/btw 现在进展到哪了？

配置

cordis.patch.yml 的 config（默认值）：

| 键 | 默认 | 含义 |
| maxEvents | 80 | 读取的事件数（从末尾算） |
| maxChars | 16000 | 转录字符数上限 |
| toolArgChars | 300 | 工具参数的显示字符数 |
| toolResultChars | 900 | 工具结果的显示字符数 |
| maxTokens | 4096 | 回答的最大 token 数 |
| timeoutMs | 120000 | 单次调用的超时 |

实现原理

- index.js（宿主侧）— 在 commands 里注册 btw。从会话日志拼出转录，用 llm 只流式调用一次。答案作为 command/done 的 text 返回。调用时把会话的 id 作为 sessionId 传进去（OpenCode 系用 x-opencode-session 路由请求，没有就返回 400 MissingSessionID 拒绝）
- client.js（浏览器侧）— 只替换 conversation.chat.commandview 的 btw 键。其他命令还是通用行。locale 里带 ja / en / zh 三套词典

没有服务商专属分支。调用和会话本体同形（provider / model / reasoningEffort / sessionId，系统提示词按契约走 system，不带工具），唯一区别是输出上限 4096。重试判断也只看 dsh-llm 里与服务商无关的失败码（EMPTY_RESPONSE / PI_AI_ERROR / TIMEOUT / TRANSPORT）。

失败时

卡片会显示每次尝试的结果（finish 的 reason.kind 和 failure.code / HTTP status / 消息）。

btw failed: no answer (#1 error PI_AI_ERROR HTTP 400 — …; #2 stop; provider=… model=…)

- #1 带输出上限，#2 不带上限（和会话本体同形）。第二次成功的话显示仍是成功
- 不重试的码：认证、配额、上下文超限等，换个形状重发结果也一样

许可证

MIT