会话分享页 huazhiliange/dsh-share-page

dsh-share-page

把任意 DeepSeek Harness（DSH）会话 一键变成可分享的只读静态网页 —— 自包含单文件 HTML（内联样式/脚本、零外部请求、离线可开），时间线渲染，可折叠工具调用与思考块，默认脱敏，双层 SHA-256 指纹防篡改，可选水印。

给同事、客户、读者看的会话快照：点击即开、不怕改、不泄密。

插件预览 —— 头部多了「分享」按钮

📑 目录

- 📸 它长什么样
- 它解决什么问题
- 真正有用的场景（按价值排序）
- 结论：它适合谁
- 功能特性
- 快速开始（3 步）
- 安装
- 使用方式
- 1. Web UI（推荐，主入口）
- 2. 斜杠命令
- 3. Agent 工具
- 输出位置
- 📸 分享页效果预览
- 验证
- 安全与隐私
- 架构与实现
- 限制与 Roadmap
- License

📸 它长什么样

装上插件之后，DSH Web 会话 Header 右上角会多一颗「分享」按钮：

Header 分享按钮

点开是一个轻量对话框，确认主题 / 脱敏 / 思考块 / 水印，一键生成：

分享会话对话框

默认脱敏 + 默认折叠思考 + 默认跟随系统主题，三项全部可以临时关掉。

生成的分享页长这样（可一键切换主题、展开/折叠工具）：

分享页 meta 与时间线

分享页对话时间线

它解决什么问题

DSH 生态里已有的导出/分享能力，目标各不相同：

| 工具 | 产出 | 面向对象 |
| 官方 /export | 原始 ZIP（JSONL） | 机器 / 续聊 |
| 本插件 dsh-share-page | 可读的分享网页 | 人 |

面向人的可读分享网页此前是空白 —— 本插件补上这一环：一份点击即开、离线可用、被改动就能发现的会话快照。

真正有用的场景（按价值排序）

| 场景 | 为什么有用（简版） |
| ① 给同事/团队看「AI 是怎么干的」 | 分享页含完整时间线 / 思考过程 / 工具调用 / 报错，一次讲清「AI 做了什么、为什么」。 |
| ② 交付/评审留档 | 重要改动配一份可追溯的执行记录；页面含双层指纹防篡改。 |
| ③ 给非技术的人看 | 老板、客户、业务方只关心结论与证据，分享页是排版好的版面。 |
| ④ 长期归档/复盘/检索 | 自包含 HTML，可打印 PDF、离线存档、之后翻找。 |
| ⑤ 分享给另一个 AI/工具 | 把一次漂亮 agent 操作导出为上下文喂给其他模型，或作内训示例。 |
| ⑥ 只读安全 | 默认脱敏（邮箱/密钥/路径）+ 水印 + 转义防注入；可放心外传。 |

结论：它适合谁

适合「agent 产出需要对外沟通/留档/交付」的用户 —— 团队协作、给客户交付、做重要自动化任务、想沉淀知识的人。如果你是重度使用 DSH 干活、且经常要「把过程拿给别人看」，它就有用。

功能特性

- 自包含单文件 HTML：内联 CSS/JS、系统字体栈、零外部请求，断网也能打开；Ctrl+P 可直接打印 / 存 PDF。
- 时间线渲染：用户 / 助手消息气泡、模型徽标（provider/model）、每轮 usage token 统计。
- Markdown 渲染：消息正文按 Markdown 渲染（标题 / 嵌套列表 / 代码块 / 表格 / 链接等），服务端生成、无 JS 也可读；内置极简渲染器（先转义后解析、零外部请求），思考过程与工具参数/结果保持纯文本。
- 可折叠工具调用： 卡片，参数 + 结果并排（错误结果红色标记），一键展开 / 折叠全部。
- 思考过程：reasoning 块默认折叠展示（可关闭）。
- 默认脱敏：邮箱、密钥（sk-/AKIA/ghp_/Bearer）、IPv4、Windows 绝对路径、长随机串自动替换；可关闭。
- 双层 SHA-256 指纹（对齐 REQ-56 思想）：
- 会话指纹：规范化事件流（type+seq+data）的 SHA-256，随页面页脚展示，跨渲染可对比；
- 文件指纹：最终 HTML 字节的 SHA-256，由生成器返回，分享文件被改动即可用 sha256sum 校验出来。
- 水印：页脚可注入分享者 / 日期等水印文本。
- 只读安全：只用 sessionPersistence.inspect/list 消费会话日志，绝不 load/prepare/append，绝不改写历史事件。

快速开始（3 步）

1) 前置：已安装 dsh，且 Node.js ≥ 18
2) 从 npm 安装（推荐）
dsh plugin --profile web add dsh-share-page

3) 重启 dsh，会话 Header 右侧即出现「分享」按钮
dsh --profile web

打开任意会话 → 点 分享 → 选好选项 → 生成。详见使用方式。

安装

从 npm 安装（推荐，自动获取最新版）：
dsh plugin --profile web add dsh-share-page

锁定版本（建议，DSH 处于开发者预览期，上游可能有破坏性变更）：
dsh plugin --profile web add dsh-share-page@0.1.0

本地路径安装（开发期 / 试用）：
dsh plugin --profile web add "file:"

安装后重启 dsh --profile web，会话 Header 右侧会出现「分享」按钮。

使用方式

1. Web UI（推荐，主入口）

会话 Header → 分享（见 Header 截图） → 选项对话框：

| 选项 | 默认值 | 说明 |
| 默认主题 | 跟随系统 | 跟随系统 / 浅色 / 深色 |
| 脱敏（邮箱/密钥/绝对路径/IP） | ✅ 开 | 默认开启；分享前在内容侧做正则替换，不依赖页面运行时。 |
| 包含思考过程（折叠） | ✅ 开 | reasoning 块默认折叠，可单击展开。 |
| 水印文本（可选） | 空 | 例如 内部资料，请勿外传，页脚展示。 |

对话框见 分享会话对话框 截图。

点「生成分享页」 → 弹窗显示 输出路径 + 会话指纹 + 文件指纹，并提供「复制路径」按钮。

2. 斜杠命令

/share # 无参时提示（当前会话 id 由 Web UI 按钮侧获取） /share session-xxx # 指定会话生成

3. Agent 工具

模型可直接调用 share_session，参数：

| 字段 | 必填 | 说明 |
| sessionId | ✅ | 会话 ID |
| redact | ❌ | 脱敏开关，默认 true |
| includeReasoning | ❌ | 是否包含思考块，默认 false |
| theme | ❌ | follow / light / dark |
| watermark | ❌ | 任意字符串，写入页脚 |
| outDir | ❌ | 输出目录，默认 $DSH_HOME/shares |

返回 { path, size, sessionFingerprint, fileFingerprint, stats }。

输出位置

默认 $DSH_HOME/shares/.html（$DSH_HOME 缺省 ~/.dsh），可用 outDir 覆盖。

📸 分享页效果预览

生成的分享页是一个完整、离线可看、不会偷偷改你本地任何东西的只读网页。下面两张截图展示了一次「列出目录下文件」会话的渲染效果：

meta 区与时间线概览

- 顶部是会话元数据卡片（时间 / 会话 ID / 模型 / 预设 / 工作目录 / 规模 / Token）；
- 下面有三个动作：切换主题 / 展开全部工具 / 折叠全部工具；
- 时间线呈现多轮 USER / ASSISTANT 消息，token 统计附着每条消息末尾。

时间线展开——工具与表格

- 工具调用卡片以可折叠 形式呈现，参数 + 结果并排；
- 模型回复里 Markdown 表格被保留为原生表格；
- 页脚展示 会话指纹 + 文件指纹，可与 sha256sum 命令交叉校验。

验证

cd dsh-share-page
npm install # 安装 fzstd（解压会话日志用）
npm run verify # 真实会话渲染 + 注入转义 / 脱敏 / 指纹 18 项自检

也可手动指定会话（脱离 DSH 独立运行）：

node scripts/verify-render.mjs "C:\Users\you\.dsh\sessions" outmarkdown

安全与隐私

- 转义优先：所有动态内容（消息 / 工具输出 / 标题）一律 HTML 转义 —— 分享页可能被他人打开，agent 与工具输出不可信。
- 默认脱敏：高置信模式（邮箱 / 密钥 / IP / 绝对路径 / 长随机串）默认替换，redact:false 显式关闭。
- 自包含 = 无外联：页面不请求任何外部资源，打开它不会泄漏到第三方。
- 只读消费：不写回会话、不触发修复、不调用删除。

架构与实现

dsh-share-page/
├── cordis.patch.yml # bundle patch：insert service session-share-page ├── index.mjs # host 入口 apply(ctx)：工具 + 命令 + HTTP 路由 ├── lib/ │ ├── render-html.mjs # 事件流 → 分享页 HTML（纯函数，核心） │ ├── markdown.mjs # 极简 Markdown 渲染器（先转义后解析，零依赖） │ ├── session-reader.mjs # 会话读取（host: sessionPersistence.inspect；独立: fzstd+JSONL） │ ├── redact.mjs # 脱敏（纯函数） │ ├── fingerprint.mjs # 双层 SHA-256 指纹（纯函数） │ └── locales.mjs # host 端文案（zh/en） ├── client/ │ └── index.mjs # Web UI 插件：会话 Header「分享」按钮 + 选项对话框 ├── docs/screenshots/ # README 用到的效果截图 ├── scripts/ │ └── verify-render.mjs # 独立验证（真实会话渲染 + 注入转义/脱敏/指纹自检） └── README.md

分层与通道：

| 层 | 角色 | 通道 |
| client | 会话 Header conversation.session.header.utilities 槽位注入「分享」按钮 + Modal（与官方 dsh-session-log-export 的 Session log 按钮同一机制） | POST /api/session-share/render |
| host | 渲染核心 + 写盘 + 指纹 | ctx.sessionPersistence.inspect（只读） |
| agent | 模型可直接调用 share_session 工具 | ctx.tools.register(defineTool(...)) |
| 命令 | /share [sessionId]（人类命令面，不占模型轮次） | ctx.commands.register |

限制与 Roadmap

- [ ] 会话 descendants / 附件 纳入分享（当前只渲染根会话事件流）
- [ ] 浏览器内预览（大文件不返回 HTML 正文，仅返回路径）
- [ ] 会话列表选择器（当前经 Web UI 当前会话或显式 sessionId）
- [ ] 子代理（subagent）会话树展开
- [ ] 分享页内置「对照校验」：把文件指纹与页脚会话指纹做可视化比对

License

MIT