dsh-greater-clarity（GreaterClarity）

DeepSeek Harness（DSH）Web 会话增强插件。在会话头部（「对话 / 轨迹」标签条右侧）提供四个入口：

• 折叠 / 展开（Switch）：一键全局折叠所有 AI 的「思考链路」与「工具调用」，只保留每轮的最终回答；开关 ON=「折叠」、OFF=「展开」。
• 导出：把当前会话导出为排版清晰的 Markdown，点击即下载到浏览器默认目录（无二次确认）。AI 只导出最终回答文本，用户只导出输入文本，图片用文件名指代；保留代码块 / 表格 / 列表结构。用户输入与附件文件名经过严格转义（反斜杠 / 结构符号 / 实体化 / 行首标记），阻断 Markdown 结构注入与裸 HTML 注入；AI 最终回答保持原样不转义。导出走「客户端直出」：直接用浏览器内存中的会话快照本地生成下载（毫秒级响应），快照不可用时自动回退服务端路径。文件名规则见下。
• 历史：打开/关闭「用户历史输入记录」快速定位面板，面板出现在按钮正下方。
• 设置：左导航 + 右内容的弹窗，配置插件总开关（启用/停用）、导出按钮显隐、AI 头像上传 / 大小（16–128px）/ 显隐，底部提供一键卸载。

此外：每条 AI 回复左侧显示头像（纯展示，可开关/调大小/上传自定义），头像下方带轮次标签（第 N 轮）。

历史快速定位面板：打开后持续悬停（仅随「历史」按钮再次点击关闭）；顶部固定「回到顶部」按钮；每条记录带「第 N 轮」序号徽章，支持搜索与点击跳转（跳转定位到该输入第一行）。若会话存在未加载完全的更早历史（DSH 原生「加载更早」可补），顶部显示「历史未加载完全」提示。

导出文件名规则：标题取左侧工作区显示的会话名称（displayTitle）；时间戳取导出当日（点分格式，如 2026.8.24）；会话存在未加载完全的历史时加前缀——

• 未加载完全：未加载完全历史对话_2026.8.24_会话标题.md
• 已加载完全：2026.8.24_会话标题.md

轮次语义：每条用户输入独立一轮并递增编号（含运行期插入的中途引导/steering）——历史窗口序号、头像下方标签、导出文档轮次三处编号严格一致。

状态持久化：全局折叠/展开开关保存在 Host 设置文件中，刷新页面或重启服务后自动还原。

目录结构

dsh-GreaterClarity-plugin/
├── package.json          # dsh.bundle.patch + dsh.client.inject/platform + peerDeps 范围声明
├── cordis.patch.yml      # 官方 dsh plugin add 的 insert 挂载声明
├── tsconfig.json         # NodeNext，exclude src/client
├── tsdown.config.ts      # host 自包含 ESM + client CJS(ModuleLoader banner)
├── scripts/build.sh      # junction link + tsc 编译 host
├── src/index.ts          # HOST：webServer 路由 + 设置持久化 + Markdown 导出
├── src/client/index.ts   # CLIENT：按钮、设置弹窗、折叠 CSS、头像层、导出触发
├── assets/DSH_Avatar.png # 默认头像
└── README.md

安装

方式 A：官方装配

dsh plugin --profile web add <本目录绝对路径>
# 或发布到 npm 后：
dsh plugin --profile web add @dsh-external/dsh-greater-clarity

方式 B：运行时注入（开发）

# 在 DSH 会话内使用注入器工具：
#   dev_build_plugin  -> dev_inject_plugin

构建

# 需 DSH_CHECKOUT 指向 dsh 源码 checkout（含 packages/）
$env:DSH_CHECKOUT = "D:\dsharness\deepseek-harness"
bash scripts/build.sh        # link 依赖 + tsc 编译 host
npm run build:client         # tsdown 打包 host + client

设置持久化

设置写入 $DSH_HOME/greater-clarity/settings.json；上传的头像落盘 $DSH_HOME/greater-clarity/avatar.<ext>；默认头像来自包内 assets/DSH_Avatar.png。三处均通过 Host 路由 /dsh-greater-clarity/* 读写。

卸载与停用

三种粒度，按需选择：

需求	操作	效果
临时停用（保留设置）	设置弹窗 → 「启用 GreaterClarity」开关关闭	全部功能与 DOM 层下线，会话头部仅留「启用」按钮；重启后保持停用
软卸载（清除数据）	设置弹窗 → 底部「卸载插件…」（双确认）	清空 $DSH_HOME/greater-clarity/（设置 + 头像），写入 uninstalled.flag 停用标记，跨重启生效；重新「启用」即恢复默认配置
彻底移除（profile 级）	终端运行 dsh plugin --profile <名称> remove @dsh-external/dsh-greater-clarity	从 profile 组合中移除 bundle 层，插件不再加载；建议先用软卸载清掉数据目录

说明：bundle 插件由 profile 配置层装配，「彻底移除」必须走官方 dsh plugin remove 命令——这是 DSH 的架构约定；弹窗内的卸载按钮负责的是数据清理与停用标记。

已知限制

…