DeepSeek Harness(DSH)的插件化设计允许用户通过社区插件扩展功能。dsh-session-chat-share 专注于会话数据的导出与分享,解决开发者或用户需要将对话记录以特定格式(Markdown、HTML、TXT 或 PNG)保存或分发的需求。该插件通过命令行和界面操作两种方式,让用户能够精确控制导出的范围与内容。
核心功能¶
1. 命令行与界面集成¶
插件在 Web 端注册了 /share 斜杠命令,并在 Session Header 中添加了“Share”操作按钮。如果当前 Harness 的 UI Workspace 支持贡献点(registry)sessionRowMenu,该插件还会在 Sidebar 的 ... 菜单中增加“Share”和“Save TXT”选项,允许直接对单条会话行进行操作。
2. 范围选择与导出¶
通过 /share 命令打开的对话框会列出会话的可共享消息。用户可以通过 From/To 选择器、点击行或切换到“多选模式”来选择导出的范围。支持以下四种导出格式:
* Markdown:纯文本,按角色(User/Assistant)标题组织。
* HTML:自包含页面,使用 GFM-lite 渲染(支持标题、列表、表格、引用、代码块、链接),图片以 Data URI 嵌入。
* TXT:纯文本文件。
* PNG:将上述 HTML Artifact 栅格化为图片文件。
3. 配置选项¶
导出前可配置以下选项:
* Redact sensitive info(默认开启):对凭据形状和本地绝对路径进行模糊处理,但这是基于模式匹配的尽力而为操作,非绝对保证。
* Include tool calls(默认关闭):包含工具调用行。
* Include subagent conversations(默认关闭):包含子代理对话,并附带分隔标题。
4. 数据读取机制¶
插件通过主机的 session-query 服务以“冷读”方式读取会话数据。这意味着无论浏览器当前缓存了多少条消息,导出都能覆盖整个会话。命令运行在人类指令层面,不产生 Token 消耗。
5. 可选自动保存¶
在插件配置中设置 autoSaveDir 后,每次会话回合结束后,系统会自动将当前会话保存为 TXT 文件到指定目录。
安装与启用¶
确保你的 DeepSeek Harness 版本为 0.1.6-alpha.2 或更高。使用以下命令安装插件:
dsh plugin --profile demo add dsh-session-chat-share
安装后,插件即可在任意会话中生效。
典型用法¶
- 打开分享对话框:在任意会话中输入
/share。 - 导出全文为 TXT:输入
/share txt。 - 导出最近 10 条消息:输入
/share last 10。 - 导出最近 10 条为 TXT:输入
/share txt last 10。 - 从 UI 选择范围:点击 Session Header 的 Share 按钮,或 Sidebar 的
...菜单,选择行并导出。
注意事项¶
- 版本依赖:此插件需要 DeepSeek Harness 0.1.6-alpha.2 或更高版本。
- 数据量限制:对话框列表最多显示 300 条可共享的消息。若需导出更早的消息,请使用
/share txt等命令直接导出全文。 - 托管限制:分享功能仅涉及将 Artifact 复制到剪贴板或下载到本地,不会上传到任何服务器。
- 内容包含:消息文本按表面渲染内容分享;推理文本和工具结果默认不包含(除非开启对应选项)。
- Sidebar 菜单:Sidebar 中的 Share/Save TXT 行需要 Harness 支持
sessionRowMenu贡献点注册。
总结¶
dsh-session-chat-share 为 DeepSeek Harness 提供了标准化的会话导出能力。通过集成在 UI 和命令行中,它允许用户灵活地以 Markdown、HTML、TXT 或 PNG 格式保存对话。其基于 Host Session Query 的读取机制确保了数据的完整性,而 Redaction 选项则在默认情况下保护了敏感信息。
- GitHub: https://github.com/chrisx9z/dsh-session-chat-share
- Catalog: https://www.skillhub.cn/plugins/chrisx9z/dsh-session-chat-share