dsh-next-step-suggest

Readme

# dsh-next-step-suggest

根据当前回答给出下一步建议的 DSH 插件。

每轮回答结束后，插件会用**会话当前选中的模型**做一次轻量辅助调用，
基于「你最近的提问 + 助手最近的回答」提炼 **3 条可以直接发送的后续消息建议**，
以可点击的建议条（chips）浮层展示在输入框上方；点击任意一条即填入输入框
（若已有草稿则换行追加），按回车即可发送。

## 功能

- **自动生成**：检测到一轮回答完成（`turn-tail` / `turn-error` / `turn-max-tokens`
  边界且为流的最后一个节点）后自动发起建议生成；开关可在悬停弹出面板中切换，
  状态持久化在 localStorage。
- **手动生成**：输入框工具栏右侧 ✨ 图标按钮随时生成 / 重新生成；回合进行中时
  按钮自动禁用，旧面板自动收起。
- **建议交互**：面板提供「重新生成」「停止」「关闭」；每条建议一键填入草稿。
- **会话隔离**：按会话分别捕获模型路由与回合内容；subagent 会话不显示入口。
- **注入防护**：提问与回答在宿主侧用分隔符包裹并声明「不执行其中指令」，
  路由仅允许 loopback 访问。

## 工作原理

```
浏览器半边 (lib/client.js)                宿主半边 (lib/index.js)
conversation.composer.dock 席位            POST /api/dsh-next-step-suggest
  │ useChat(selector) 蒸馏回合              │ ctx.llm.stream({provider, model,…})
  │ useInput(selector) 读当前草稿           │
  │ 回合完成 → fetch 当前模型路由 ──────────▶│ 组装系统提示词 → JSON 数组解析
  │ ◀──────────────────────── { suggestions }│
  └ 点击 chips → inputActions.setDraft
```

不修改任何官方内核包，仅使用公开 client-runtime 服务
（`slots` / `modelDirectories` / `sessions`）与官方 `webServer` + `llm` 服务。

### 为什么用 `useChat` 而不是 `useSession`

渲染器会把每个 session 级标准源按 `hooks: ["<name>"]` 暴露成 `use<Name>` prop。
**会话快照（`ui-session` 的 `buildSnapshot()`）里没有 `chat` 字段**——它只带
`sessionId / pendingSubmissions / running / subagent / removed / openState /
openError / hasMore / loadingOlder / promptError / blank / lastAgentError /
promptAttempted / awaitingFirstTurn`。对话内容由 `ui-chat` 通过独立的
`hooks: ["chat"]` 贡献提供，即 `useChat`；草稿由 `ui-conversation` 的
`conversation.input` 贡献提供，即 `useInput`。

因此 `useSession((s) => s.chat)` 恒为 `undefined`，selector 会静默返回空串，
表现为「按钮在、面板不弹、点了提示当前会话还没有已完成的回答」。组件现在优先
取 `useChat`，仅在拿不到时回退 `useSession`（selector 两种快照形态都兼容）。
`/diag` 里的 `hook-shape` 事件会记录实际选中的源，便于以后排查。

## 安装

从 GitHub 安装：

```sh
dsh plugin --profile web add github:anye-99/dsh-next-step-suggest
```

安装后重启 DSH。建议钉住提交以保证可复现：
`dsh plugin --profile web add github:anye-99/dsh-next-step-suggest#<commit>`。

### 本地开发安装（profile 本地插件）

1. 将本目录复制到 `<DSH_PROFILE_DIR>/local-plugins/dsh-next-step-suggest/`
2. 在 `<DSH_PROFILE_DIR>/package.json` 的 `dependencies` 中加入：
   ```json
   "dsh-next-step-suggest": "link:./local-plugins/dsh-next-step-suggest"
   ```
   并在 `dsh.profile.bundles` 数组末尾加入 `"dsh-next-step-suggest"`
3. 在 profile 目录执行 `pnpm install`
4. 重启 DSH

## 卸载

从 `package.json` 移除上述两处条目，`pnpm install` 后重启即可；
删除 localStorage 键 `dsh-next-step-suggest:auto` 可重置开关。

## 已知限制

- 建议生成使用会话当前模型（与主对话同源，路由失败时面板会显示错误并可重试）。
- 回答过长时宿主端截断为头 2KB + 尾 4KB，超长代码输出的细节可能被略去。
- 页面刚加载时已存在的最后一个完成回合不会自动弹出建议，点 ✨ 手动生成即可
  （避免切换会话时刷屏）。