前言¶
DeepSeek Harness（DSH）采用插件化架构。在开发或使用过程中，管理会话（创建、重命名、归档）通常需要切换上下文或操作侧边栏。dsh-session-pilot 插件允许模型和用户在当前对话内部直接管理 DSH 会话，无需离开当前聊天窗口。
核心能力¶
该插件主要提供两类能力：模型可调用的工具和 UI 上的操作入口。
模型工具¶
插件向模型暴露了五个工具，用于会话的全生命周期管理：
new_conversation：从当前对话中剥离一个 drifted topic 或 well-scoped task，在侧边栏创建一个全新的会话。新会话零历史，仅包含模型构造的一条完整的自包含用户消息。rename_session：重命名当前会话。list_sessions：按最近活动列出会话（显示标题、运行状态、目录）。支持通过 content-search 消息传递 query 进行搜索。read_session：读取指定会话的紧凑型文本记录（仅包含最新的用户/助手文本消息，有界）。archive_session：将会话从工作区会话列表中归档（日志持久化保留）。
UI 操作¶
插件复用了 DSH 官方 UI 的插槽，未进行 DOM 注入：
- Session-header “＋ New chat”：点击该按钮可在当前工作区打开一个空白会话。
- Per-assistant-message “⧉”：点击助手消息上的该按钮，会将该消息的文本（有界）作为新会话的第一条用户消息内容。
安装与启用¶
安装插件需要使用 DSH 的插件管理命令。安装后需重启 dsh 进程。
dsh plugin add dsh-session-pilot
安装完成后，模型将获得上述五个工具，会话标题栏将出现“＋ New chat”按钮，每条助手消息旁将出现“⧉”操作。
使用方法¶
1. 通过模型工具操作¶
直接在对话中输入自然语言指令，由模型调用对应的工具。
- 创建新会话：说 “spin this task off into a new conversation”。
- 重命名：说 “rename this conversation to X”。
- 列表：说 “list my recent conversations”。
- 读取：说 “what did we discuss in session X”。
- 归档：说 “archive session X”。
2. 通过 UI 操作¶
- 创建空白会话：点击会话标题栏的 “＋ New chat”。
- 基于上下文创建：点击助手消息旁的 “⧉”，将消息文本作为上下文引用到新会话的开头。
局限性与注意事项¶
- 文本摘录限制：
read_session仅返回文本消息。助手消息中的图片和工具调用块不会被携带。在新会话中引用文件时，建议使用@符号。 - 预设继承差异：通过 UI 创建的会话会使用部署的默认 agent preset（跳过了源会话预设的继承），而通过工具路径创建的会话会继承源会话的预设。
- 归档与撤销：归档操作仅是从工作区列表中移除会话，日志依然保留，且插件内不支持取消归档（需在 UI 中恢复）。创建会话后没有撤销操作，需通过归档来清理。
- 工具调用过滤：
read_session会跳过工具事件，仅展示用户/助手文本。
结尾¶
dsh-session-pilot 填补了社区中“让模型直接创建、重命名和归档用户可见的一级会话”的空白。它与纯 UI 的会话管理插件（如 dsh-session-kit）互不冲突，前者提供模型可调用的操作接口，后者提供可视化的管理面板。
