前言¶
DeepSeek Harness(DSH)跑在本机,对话默认留在你的环境里:没有官方托管的「分享页」,也没有开箱即用的「把整段会话交给同事」入口。常见做法是截图、手工复制 Markdown,或让对方也装同一套环境——前者丢结构,后者成本高。
下面介绍社区插件 dsh-session-forward(维护者 apollodsh,分类:客户端)。它针对「只带走看得见的对话文本」这一需求,提供三种产物:局域网分享链接、零安装网页记录、以及双方装插件时可导入的可续聊会话文件。
这是什么¶
dsh-session-forward 是 DSH 客户端插件,当前版本 0.2.1(MIT 许可证)。它不改变 DSH 核心,而是在会话界面增加转发入口,并在需要时在本机临时提供分享页或写出静态文件。
运行前提(以 package.json 中 engines.dsh 为准):DSH >= 0.2.1-rc.2 且 < 0.3.0。DSH 升到 0.3 后可能需要插件另行适配。
核心功能¶
三种方式内容一致,但接收方条件和后续能力不同:
| 产物 | 接收方需要什么 | 得到什么 | 适用场景 |
|---|---|---|---|
分享链接 http://192.168.x.x:PORT/s/<token> |
无需安装,浏览器打开 | 24 小时有效的排版页,可粘到微信 / 飞书 | 与对方在同一 Wi-Fi / 局域网 |
网页记录 xxx.dshchat.html |
无需安装,双击用浏览器 | 自包含对话记录,可离线、可打印 | 异地或需要存档 |
会话文件 xxx.dshchat.json |
对方也安装本插件 | 在 DSH 中还原为可继续聊的真实会话 | 双方都是 DSH 用户 |
无论哪种方式,只会转发可见的对话文本。工具调用、工具结果、推理过程、图片与文件附件、子会话不会随文件走;摘要里会说明省略了多少条。分享链接不会把内容上传到第三方服务器,仅在你本机提供;插件设计上不主动联网上传会话。
Agent 也可通过工具 session_forward 触发三种动作:export(写出 .dshchat.json)、import(导入并新建会话)、share(生成 24 小时有效的局域网链接)。
安装与启用¶
前提:满足上述 DSH 版本范围;从 GitHub 安装时需要本机有 Git。
方式一:应用内安装(推荐)¶
- 打开 插件 → 添加插件。
- 输入下面任一目标并安装,然后启用插件;若应用提示重启,按提示重启 DSH。
github:apollodsh/dsh-session-forward#v0.2.1
也可填写已下载的 .tgz 的绝对路径。固定 #v0.2.1 可避免安装内容随 main 分支变化。已有安装要升级时,先在插件页卸载旧版本再装目标版本;同版本已安装且运行中时无需反复安装。v0.2.1 侧栏菜单与会话页头转发箭头均朝上。
方式二:自定义插件市场¶
若 DSH 已开启 插件 → 实验性插件 → 自定义插件市场,可在 发现 → 索引源 添加:
https://cdn.jsdelivr.net/gh/apollodsh/dsh-session-forward@main/market/index.json
CDN 较慢时可改用 GitHub 原始地址:
https://raw.githubusercontent.com/apollodsh/dsh-session-forward/main/market/index.json
然后在发现页搜索「会话转发」安装。
方式三:本地目录(开发调试)¶
维护者在 README 中说明:克隆仓库后,让 agent 对绝对路径执行:
install_bundle target "/绝对路径/dsh-session-forward"
本地目录属于 link: 安装,改代码后按应用提示重启 DSH 即可。
npm 包 dsh-session-forward 尚未发布;发布后可用 install_bundle target "dsh-session-forward"(以官方文档更新为准)。
典型用法¶
1. 分享链接(同局域网最省事)¶
- 点会话标题右侧的转发图标;或在左侧会话列表中对该会话打开「…」→ 转发(无需切换当前会话)。
- 在「转发本会话」中选择 复制分享链接(链接已在剪贴板,界面也会显示)。
- 粘到微信 / 飞书等处。对方打开即可阅读;若要接着聊,可在页面底部 复制全文(Markdown),粘进自己的 DSH 对话框。
第一次复制链接时,插件会在本机临时起一个 HTTP 服务(随机端口),仅提供 /s/<token>。token 为 128 位随机串,默认 24 小时过期,最多同时保留 50 份;插件卸载或 DSH 退出后服务关闭,链接失效。macOS 首次使用可能询问是否允许传入连接,允许即可。
2. 网页记录(异地或离线)¶
- 「转发本会话」→ 保存网页记录,得到
xxx.dshchat.html。 - 通过邮件、即时通讯等发送文件。
- 对方双击在浏览器中阅读;同样可通过 复制全文(Markdown) 回到 DSH 继续聊。
网页完全自包含(内联样式与脚本,不引用外部资源),深色 / 浅色跟随系统,可直接打印。仓库内提供示例 docs/demo.dshchat.html,下载后双击可预览样式。
3. 会话文件(双方装插件)¶
- 选择 保存会话文件(.dshchat) 并发送给对方。
- 对方在同一转发入口选择 打开别人转发的会话 → 选文件 → 选目标工作区 → 导入。
导入会新建一条真实会话:标题沿用原会话,消息按 turn / step 写入日志,模型能看到这段历史并可直接追问。导入的会话不含原会话的工作目录、模型选择、待办等;继续聊时使用本机默认模型,系统提示词排在转发历史之后。
适用场景与注意¶
适合谁:需要在局域网内快速把一段 DSH 对话给同事看、需要给外网对方发离线可读记录、或需要在两名 DSH 用户之间交接可续聊会话时。
分享链接:使用本机局域网地址,仅同一 Wi-Fi / 局域网可打开;明文 HTTP,链接在 24 小时内等同凭据,勿发到公开群。DSH 重启后内存中的分享页清空,旧链接全部失效,需重新复制。
网页记录:静态阅读稿,不能在网页里继续聊;适合阅读、复制、打印。
会话文件:未安装本插件的 DSH 用户无法导入;零安装场景请用链接或 .dshchat.html。
体积与格式:单条消息上限 20 万字符,整份 bundle 上限 24 MiB,超出会截断或拒绝;比插件版本新的文件导入时会直接拒绝。
安全与权限:插件以当前 DSH 进程权限运行,安装前建议阅读 GitHub 仓库 源码与 MIT 许可证,确认转发范围与省略规则符合你的合规要求。
结尾¶
dsh-session-forward 用三种粒度解决「把本机会话交给别人」:链接适合局域网即时分享,网页记录适合异地与归档,.dshchat 适合两名 DSH 用户之间原样续聊。功能与限制均以仓库 README 为准。