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 安装：

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 中加入：

   "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，超长代码输出的细节可能被略去。
• 页面刚加载时已存在的最后一个完成回合不会自动弹出建议，点 ✨ 手动生成即可 （避免切换会话时刷屏）。