dsh-share-page

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

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

!Plugin preview — header 多了「分享」按钮

---

📑 目录

[📸 它长什么样](#-它长什么样)
[它解决什么问题](#它解决什么问题)
[真正有用的场景（按价值排序）](#真正有用的场景按价值排序)
[结论：它适合谁](#结论它适合谁)
[功能特性](#功能特性)
[快速开始（3 步）](#快速开始3-步)
[安装](#安装)
[使用方式](#使用方式)

- [1. Web UI（推荐，主入口）](#1-web-ui推荐主入口) - [2. 斜杠命令](#2-斜杠命令) - [3. Agent 工具](#3-agent-工具) - [输出位置](#输出位置)

[📸 分享页效果预览](#-分享页效果预览)
[验证](#验证)
[安全与隐私](#安全与隐私)
[架构与实现](#架构与实现)
[限制与 Roadmap](#限制与-roadmap)
[License](#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 也可读；内置极简渲染器（先转义后解析、零外部请求），思考过程与工具参数/结果保持纯文本。
可折叠工具调用：<details> 卡片，参数 + 结果并排（错误结果红色标记），一键展开 / 折叠全部。
思考过程：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/<sessionId>.html（$DSH_HOME 缺省 ~/.dsh），可用 outDir 覆盖。

---

📸 分享页效果预览

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

!meta 区与时间线概览

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

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

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

---

验证

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

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

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

---

安全与隐私

转义优先：所有动态内容（消息 / 工具输出 / 标题）一律 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

dsh-share-page

Install

Check the source files

dsh-share-page

📑 目录

📸 它长什么样

它解决什么问题

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

结论：它适合谁

功能特性

快速开始（3 步）

安装

使用方式

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

2. 斜杠命令

3. Agent 工具

输出位置

📸 分享页效果预览

验证

安全与隐私

架构与实现

限制与 Roadmap

License

Source facts

Install

Check the source files

dsh-share-page

📑 目录

📸 它长什么样

它解决什么问题

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

结论：它适合谁

功能特性

快速开始（3 步）

安装

使用方式

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

2. 斜杠命令

3. Agent 工具

输出位置

📸 分享页效果预览

验证

安全与隐私

架构与实现

限制与 Roadmap

License

More related plugins

dsh-hooks-claude-code

dsh-hooks-codex

WeKnora#dsh-weknora