前言¶
在 DeepSeek Harness (DSH) 的插件生态中，会话内容往往以原始文本或流式数据呈现。若需将对话记录归档为可读文件，通常需要手动复制粘贴。本文介绍 dsh-save-session，一个能够直接在会话标题栏一键导出内容为 Markdown 或渲染 HTML 的插件。
简介¶
dsh-save-session 是一个客户端插件，由用户 jh1016248 维护，开源协议为 MIT。它的核心价值在于简化会话导出流程：通过界面按钮或对话指令，自动过滤掉思考过程、工具调用记录等噪音，仅保留用户与助手的正文内容，生成干净的 Markdown 或渲染后的 HTML 文件。
核心功能¶
导出格式¶
插件提供两种导出模式：
- 保存 MD：下载
session-<时间戳>.md文件，内容为纯净的 Markdown 格式，适合直接编辑或作为文档存储。 - 保存 HTML：下载
session-<时间戳>.html文件。该文件包含 Markdown 渲染效果，支持标题、代码块、列表、引用、链接、表格等格式。文件左侧设有目录面板，每条消息一行（角色 + 单行预览），点击可跳转；窄屏下自动隐藏。
内容过滤¶
导出的文件仅包含用户消息与助手正文。以下内容一律被过滤：
- 模型思考过程
- 工具调用与工具结果
- 注入的上下文 / 子代理报告
工具集成¶
插件在模型侧注册了工具 save_session_md。开发者可以在对话中通过自然语言指令调用该工具，例如说“保存当前会话为 md”。工具支持可选的 path 参数，默认写入会话工作目录。
安装与启用¶
安装前请确保环境满足依赖要求。
- 安装插件
使用以下命令安装：
dsh plugin --profile web add dsh-save-session
-
环境依赖
* Node.js 版本需 >= 20。
* 需安装@deepseek-ai/dsh-tools版本 >= 0.1.0-rc.8。
* Client 槽位需注入@deepseek-ai/dsh-client-runtime和@deepseek-ai/dsh-client-ui-slots。 -
重启 Profile
安装完成后，必须重启 profile 才能生效。执行dsh web重启服务。
典型用法¶
安装并重启后，可通过以下两种方式使用：
- 界面操作：在会话标题栏右侧的操作行，点击「保存 MD」或「保存 HTML」按钮，浏览器会自动下载对应文件。
- 对话指令：在对话中直接发送包含工具意图的文本（如“保存当前会话为 md”），系统将自动调用
save_session_md工具执行导出。
注意事项¶
- 生效机制：插件通过注册 UI 槽位和工具注册表实现功能，安装后务必重启 profile。
- 源码检查：作为插件使用，建议在安装前检查其源码与许可证，确保符合本地环境的安全规范。
