dsh-session-kit

dsh-session-pilot

为 DeepSeek Harness 补上"在对话中管理会话"的能力——模型与人都能在对话途中新建、重命名、列出、查看、归档会话。

English

五个模型工具（模型在对话里即可整理会话）：

两个官方插槽按钮（无 DOM 注入）：

• 会话头部「＋ 新对话」——在当前工作区一键开空白新对话
• 助手消息「⧉」——把这条回复的正文作为上下文摘录，开一个全新对话继续讨论

只走官方路径：Host 复用 Web UI 同款的 sessionController / sessionQuery / workspaceRegistry 接缝；UI 只用官方插槽（conversation.session.header.actions、conversation.chat.assistant-actions）。通过 dsh-client-locale 接入中英双语界面。

安装

dsh plugin add dsh-session-pilot

重启 dsh 后生效。模型会在工具列表里看到五个工具；会话头部出现「＋ 新对话」按钮；每条已落定的助手消息的操作区出现「⧉」按钮。

使用

• 新建对话：直接说"把这个任务开个新对话去做"，模型调用 new_conversation 把任务简报作为首条消息。
• 整理会话：说"把这个对话重命名为 XX"、"列出我最近的会话"、"看看 XX 会话里聊了什么"、"把 XX 会话归档"。
• 头部按钮：点「＋ 新对话」，在当前工作区开一个空白对话并自动跳转。
• 消息操作：点助手消息上的「⧉」，插件把该消息正文（限 4000 字符）包成 <quoted-context> 摘录，作为新对话的首条用户消息。

为什么不是 subagent / fork

相近社区插件（截至 2026-09 的普查）

没有插件提供这一组模型工具——让模型自己创建、命名、整理用户可见的顶层对话；这是本插件的核心缺口定位。

设计说明

• 单一事务：new_conversation 与 HTTP 路由共享 createSessionPilot——解析来源会话的工作区（直连挂载），调用 sessionController.create（Host 侧自动完成工作区挂载），再按需 rename 与 prompt（mode: 'queue'，透传 exec.signal）。创建的会话就是普通的耐久 Session，重启后仍在。
• 工作区与 preset 继承：新对话落在来源会话的工作区；未挂载时退化为继承 cwd；Agent preset 随来源会话的最近 agent-preset/selected 继承（工具路径）。
• 只读走独立接缝：list_sessions 用 sessionController.list/search；read_session 用 sessionQuery.readSession（live 优先、冷读持久层）+ readTitle，消息级投影有界（每条 ≤600 字符、最多 100 条、总量 ≤12000 字符）。
• HTTP 信任围栏：路由仅接受回环 Origin/Host（与 dsh-turn-fork 同一约定），application/json 且正文 ≤ 64 KiB。
• 跨版本：面向 0.1.5-rc.1 的 API 编写（peer deps），并在 0.1.2-alpha.4 运行时验证通过；prompt 始终显式传 mode: 'queue' 以兼容两个版本的 SessionPromptRequest。

Known Limitations and Deferred Work

• 摘录只携带文本——助手消息中的图片、工具调用块不进入新对话；需要文件上下文时请用 @ 重新引用。
• 工具路径之外不传 preset——路由（UI 按钮）创建的会话使用部署的默认 Agent preset，不继承来源会话的 preset（需要在路由侧加 inspect 才能读到来源 preset，v1 未做）。
• 归档不可在插件内撤销——归档只是移出工作区列表（日志保留），恢复需要在工作区界面操作；插件不提供 unarchive。
• read_session 不含工具事件——只投影用户/助手文本消息，查看工具调用细节请用官方 tool-session-query 包。
• 空白对话与「继续」不可撤销——新会话一旦创建即普通存在，请用 archive_session 或在会话列表中归档。

开发

pnpm install
pnpm run typecheck
pnpm test          # build + node --test

目录约定与 dsh-turn-fork 一致：src/index.ts（Host）、src/client/（Client）、src/shared.ts（共享值契约）、scripts/dsh-client-preset.ts（vendor 自 dsh 仓库的 client bundle preset，MIT）。