dsh-handoff-tab
DeepSeek Harness(DSH)Web 会话视图的「交接」tab:在后台读当前会话日志、调用当前默认模型,生成一段可直接粘贴到新会话第一条消息的交接提示词,保存在 DSH 存储域($DSH_HOME/storages/dsh_handoff_tab.json)。
English: a Handoff tab for the DSH conversation view. It generates a paste-ready handoff prompt for a fresh session, in the background, and stores it in the DSH storage domain — no workspace files, no session messages.
不写工作区、不往会话加消息/命令事件;每个会话只保留最新一份,60 天自动清理。
功能
- 「交接」tab 与「对话」「轨迹」并列(order 20),窄屏自动收进「更多会话视图」省略号菜单。
- 空状态一键「生成交接提示词」;生成在宿主后台执行:切 tab、切会话、关页面都不中断,重新进入按宿主状态(
idle/generating/ready/error)恢复。 - 生成的提示词要求接手的新会话先复述理解、问清下一步再开工,不会读完就直接执行。
- 就绪后顶部工具行显示生成时间,支持「重新生成」「复制」;正文就是全部复制内容。
- 生成时附带一份当前工作区快照(顶层文件树、引用路径存在性、移动文件检测),避免提示词引用已移动/不存在的文件或并不存在的构建产物。
- tab 激活时隐藏底部输入框,正文区域完整可用(切回其他 tab 自动恢复)。
- 生成失败给出错误文案与重试,不留半成品;重新生成直接覆盖旧值。
- 界面文本中英双语(跟随 DSH locale),颜色/圆角/字体跟随宿主主题 token。
截图
| 未生成 | 生成中 | 已就绪 |
|---|---|---|
![]() |
![]() |
![]() |
截图同时登记在 screenshots.json,社区市场(dsh-market 详情页)会直接读取这个清单。
环境要求
- DSH 0.2.2-rc.1(web profile)实测;
engines.dsh兼容范围>=0.2.0-rc.1 <0.3.0-0。 - Node.js >= 22.19。
- 无构建步骤、无运行时 npm 依赖。
- 数据/路由只在 loopback 的 DSH Web 进程内使用。
安装
三种方式任选其一,装完若宿主没有热装载,重启一次 dsh web 即可。
1. 直接从 GitHub 安装(pnpm git 依赖)
dsh plugin --profile web add github:works-on-my-laptop/dsh-handoff-tab
2. 克隆到本地后按目录安装
git clone https://github.com/works-on-my-laptop/dsh-handoff-tab.git
dsh plugin --profile web add /path/to/dsh-handoff-tab
3. 用 DSH 的 plugin_manager
在 DSH 里让 agent 调 plugin_manager,action: install_bundle,target 指向仓库目录。它会完成包安装与 bundle 选择。
安装后可自查(应看到 - id: dsh-handoff-tab 行):
dsh --profile web --dump-config | grep -A1 handoff
卸载见文末。
使用
- 打开任意会话,切到 tab 行的「交接」。
- 空状态点「生成交接提示词」。单次生成约 10–60 秒(模型/上下文长度而异)。
- 生成完成后:
- 「复制」把正文整段放进剪贴板,粘到新会话第一条消息即可;
- 「重新生成」覆盖旧结果并刷新生成时间;
- 生成期间切走/关页面不会中断,回来会显示进行中或已完成。
- 生成内容要求:正文即提示词,不含标题、引言、生成时间、会话 ID;覆盖任务与验收、当前进度与证据、关键决策与否决方案、产物路径、坑、下一步、硬约束;开头要求接手者先复述理解、问下一步,确认后再动手;目标 800–2000 字。
数据与隐私
- 只写入
$DSH_HOME/storages/dsh_handoff_tab.json,结构:
{
"unit": { "name": "dsh_handoff_tab", "version": 1 },
"global": null,
"tables": {
"documents": {
"<sessionId>": { "text": "…", "generatedAt": 1730000000000, "model": "…", "promptVersion": 3 }
}
}
}
存储域名 dsh_handoff_tab 由插件名派生(UNIT_NAME_RE 只允许小写字母、数字与下划线,不能带连字符),避免与其他插件的 handoff 域抢同一个文件。
- 不写工作区文件,不往会话日志追加消息、命令卡片或事件(路由是纯客户端↔宿主 side channel)。
- 生成会调用当前默认模型并产生 token 费用;若装了
dsh-cost-meter,该次费用会计入目标会话(它自己的账本,不写会话事件)。 - 进程重启会丢失进行中的生成任务;已生成的结果保留在存储文件里。
- 插件路由与 DSH Web 同源、仅监听 loopback,不额外鉴权;不要在不可信网络暴露 DSH Web 端口。
卸载
# 推荐:用 DSH 插件管理页卸载,或让 agent 调 plugin_manager remove_bundle
dsh plugin --profile web remove dsh-handoff-tab
命令行卸载后还需把 profile package.json 的 dsh.profile.bundles 里的 dsh-handoff-tab 条目删掉(插件管理页会自动处理)。清空数据(可选):
rm "$DSH_HOME/storages/dsh_handoff_tab.json"
兼容性与已知限制
- 仅在 DSH 0.2.2-rc.1 / Windows 实测;其他版本未验证,尤其是客户端 slot API。
- 正文用等宽
<pre>渲染,暂不做 Markdown。 - 长度由模型自行控制,可能略超出 800–2000 字目标。
- 记录 schema 使用最小校验对象(只要求
parse/safeParse)而不是 zod:本地目录以 linked 方式装入 profile 时解析不到 profile 的zod,而 harness 只代理自己安装的@deepseek-ai/*;这样插件保持零依赖。 - 视图组件只
require('react'),不 require 任何 DSH Client 包(官方建议,避免版本漂移与 slot 崩溃)。
上架到社区市场
社区列表是 awesome-dsh-plugin(网站 https://awesome-dsh-plugin.com / dsh-market 读取同一份数据)。收录要求、npm 发布、截图、注册表条目 YAML 与 PR 流程都写在 docs/publishing.md,这里不重复。
当前准备度:
- 已满足:
dsh.bundlemanifest、真实代码、engines.dsh、带预发布分支的 peer 范围、assets/icon-256.png市场卡片图。 - 待办:在 GitHub 仓库加
dsh-plugintopic、npm 发布(npm publish --access public)、仓库满 1 天后向注册表提 PR。
开发
npm test # 客户端注册冒烟 + 提示词同步 + 包元信息(图标/截图)校验
node --check index.js && node --check client.js
- 本地目录安装是 linked 方式:改
client.js由 client-hmr 热替换;改index.js需要在插件管理里关/开该插件或重启。 - 宿主接口:
GET /dsh-handoff-tab/doc?sessionId=<id>返回{state, text?, generatedAt?, model?, error?};POST /dsh-handoff-tab/generatebody{sessionId}立即 202 并在后台生成。 - Agent 维护约定(README 入口、文档同步、验证与发布规则)见
AGENTS.md。
仓库结构 / 文档索引
README 是唯一入口:每个受版本控制的文件都在下表里有用途说明。 新增、移动或删除文件时,请同步更新此表。
| 路径 | 用途 |
|---|---|
README.md |
本文件:功能、安装、使用、隐私、卸载、开发与文档入口 |
AGENTS.md |
Agent 维护约定:README 入口、文档同步、验证与发布规则 |
LICENSE |
MIT 许可证 |
.gitignore |
忽略依赖、日志、系统/编辑器噪音与本地临时产物 |
package.json |
npm 包元数据、dsh.bundle / dsh.client 清单、测试脚本 |
cordis.patch.yml |
bundle patch:插入 Host 行 id: dsh-handoff-tab |
index.js |
宿主半部:两条路由、storageDomain、会话读取与转录压缩、LLM 调用、工作区快照、60 天清理 |
client.js |
浏览器半部:conversation.view 交接 tab、状态机、轮询、复制、主题样式、本 tab 激活时隐藏输入框 |
assets/icon-256.png |
唯一对外图标:插件管理页(package.json 的 icon 字段)与社区市场卡片(GitHub 托管的位图) |
assets/icon.svg |
图标矢量源文件(不直接对外;改图后重新导出 icon-256.png) |
screenshots.json |
社区市场截图清单(1–8 张,路径相对于本文件) |
screenshots/1.png / 2.png / 3.png |
界面截图:未生成 / 生成中 / 已就绪 |
locale/zh.json / locale/en.json |
插件管理页的中英文标题与描述 |
docs/plugin-design.md |
已冻结的设计规格:需求、架构、数据模型、接口、里程碑、风险 |
docs/handoff-prompt.md |
交接提示词契约;其「提示词正文」与 index.js 的 SYSTEM_PROMPT 逐字一致(由测试校验) |
docs/publishing.md |
社区市场上架清单、npm 发布、截图、注册表条目与 PR 流程 |
test/client-smoke.cjs |
客户端插件注册结构冒烟测试(零依赖) |
test/prompt-sync.cjs |
校验 docs/handoff-prompt.md 与 index.js 的 SYSTEM_PROMPT 保持同步 |
test/package-meta.cjs |
校验图标声明(icon / ./icon)、图标文件与 screenshots.json 路径都存在 |
.github/workflows/check.yml |
CI:push/PR 时跑语法检查、JSON 校验与 npm test |
验证记录(DSH 0.2.2-rc.1)
- 真实生成多次(19–66 秒);产物均为「正文即提示词」,无可粘贴外壳。
- 零会话足迹:空闲会话生成前后日志行数 332 → 332。
- 零工作区足迹:生成前后
git status无新增文件。 - 60 天清理:注入
generatedAt=0的测试纪录后重载插件,5 秒后删除,其余保留。 - 错误路径:不存在的会话 → POST 202 → GET 一次性返回
{state:'error', …},随后回到idle。 - 越界请求:错误方法 405、空 body/非法 JSON 400。
- 事实校准:生成时注入当前工作区快照与引用路径校验,提示词不再沿用转录里的旧路径或声称不存在的构建产物。
- 提示词 v3(先复述、确认后再开工):真实重新生成 19 秒,正文开头即「先别动手……复述三件事……得到确认后才开始执行」,落库
promptVersion: 3;生成前后会话日志 sha256 与工作区文件均未变。
License
MIT © dsh-handoff-tab contributors
assets/icon.svg 是项目原创几何矢量图(本仓库内从零绘制,未使用任何第三方图标库或素材),assets/icon-256.png 由它导出,两者随项目同以 MIT 许可发布,无额外署名要求。



No comments yet. Be the first to write one.