dsh-chat-plus

DeepSeek Harness 的对话体验增强套件：让对话读得更顺、能出可交互的卡片、把执行过程翻译成人话，
再把记忆 / SKILL / 用量 / 画廊 / 档案 / 系统提示词 / 同步设置收成一排工作台；档案支持账号密码、
证件与任意文件附件（Clash 订阅、证书、脚本），敏感值加密落盘且绝不进上下文。

零 DSH 源码改动 —— 全部能力以 Cordis 插件注入，官方升级不动它。

dsh plugin --profile web add github:Kr-ATG/dsh-chat-plus

装完重启 DSH 即可。本包声明了 dsh.bundle.patch，dsh plugin add 会自动加进 profile 的
bundles 层，不用手改配置文件。

目录

• 你可能最想要的
• Seeker 视图：双栏执行大盘
• 正文里能出卡片
• 对话读起来更顺
• 对话完成胶囊
• 七个工作台
• 输入区与工具栏
• Agent 邮箱（只读卡片）
• 供应商中心（设置 → 供应商）
• 提示词通道：什么时候模型才知道这些围栏
• 安装与卸载
• 插件页面功能开关
• 配置一览
• 常见问题
• 从旧版本升级
• 开发
• 许可

你可能最想要的

Seeker 视图：双栏执行大盘

会话头部标签栏多一个 「Seeker」（内部代号 KR），与官方「对话 / 轨迹」并列。点进去，
底层仍是官方 ChatView（多轮历史、虚拟滚动、Markdown、输入框全部原样），右边多一栏全高执行大盘。

┌─ 左栏（官方 ChatView）────────────┬─ 右栏 Seeker 大盘 ────────────┐
│                                   │ ┌ 子智能体 ────────────────┐ │
│  [你]  …                          │ │ 固定 5 行，整行可点跳转   │ │
│  [AI]  …                          │ └──────────────────────────┘ │
│                                   │ ┌ 操作面板 ────────────────┐ │
│  (Seeker 正在读取文件 ··· 12s)     │ │ 任务动画 + 当前这一件事    │ │
│  ┌ 思考过程 ─────────────────┐    │ │ 默认收起，点开看完整流水   │ │
│  │ 贴在对话流里，跑时展开     │    │ └──────────────────────────┘ │
│  │ 收口自动折叠成一行         │    │ ┌ 任务 ────────────────────┐ │
│  └───────────────────────────┘    │ │ 只列本轮清单              │ │
│  ┌ 提问与回答 ───────────────┐    │ └──────────────────────────┘ │
│  │ 问了什么 / 你答了什么      │    │ ┌ 产出物 ──────────────────┐ │
│  └───────────────────────────┘    │ │ 本次做出的文件，可点预览  │ │
│                                   │ └──────────────────────────┘ │
│  ┌ 最终回答（总结卡）─────────┐    │ ┌ 记忆 ────────────────────┐ │
│                                   │ │ 钉在底部，默认折叠        │ │
└───────────────────────────────────┴──────────────────────────────┘

**为什么子智能体卡固定 5 行**：它顶在滚动区最上面、卡高与内容无关，所以紧贴
其下的「操作面板」永远停在同一位置 —— 子智能体多几个少几个都不会把操作面板
推走。没有子智能体时整卡不可见但位置照留（同样是为了不推动下面的卡）。

左栏干净：只有一行状态卡（头像 + 「Seeker 正在…」+ 末尾三点 + 用时读数）。工具明细不在这边堆。

> 顶栏标签行位置：Seeker 排在官方「对话 / 轨迹」左侧、紧贴右侧工具区，是插件用一组
> order 规则把标签行插到标题与工具区之间实现的（零 DOM 改动，官方按 tabs.length 增删
> 标签行时不会崩）。DSH 0.2.1-rc.3 给标签行外面多包了一层 .tabs 容器，旧规则全部打在
> 内层 tablist 上导致标题被挤到最右、官方「…」跑到 Seeker 左边 —— 已按新结构补规则，两版
> 选择器靠 :not([role='tablist']) 区分，rc.2 / rc.3 都能正常显示。

大盘设置：「Seeker」标签右侧有一枚齿轮按钮，点开在视口中央弹出设置卡片，里面是
「提示词通道」四条（中文优先 / 对话内交互卡片 / 团队协作 / Agent 邮箱）、「任务清单」
两条（任务清单纪律 / 回合结束自动收口）、「展示」三条（总结卡外框 / 工具调用卡 / 操作面板），
以及下方通栏的「工作区记忆」。齿轮与卡片
联动（再点收起、Esc 关闭、点遮罩关闭），改完立刻生效、刷新后保留。

卡片约 1000×512，排版在 2026-10-25 按「拥挤、排版不合理」重做过一轮：

• 上方两栏：左「提示词通道」4 行（中文优先 / 对话内交互卡片 / 团队协作 / Agent 邮箱），
  右「展示」3 行 +「任务清单」2 行（任务清单纪律 / 回合结束自动收口），中间一道发丝线。
• 任务清单组里的两行没有合并成一个开关：任务清单纪律往提示词里写一条行为约束（开工
  先列、收尾清零），回合结束自动收口是 host 侧监听器（agent/turn-stopping 把残留的
  in_progress 改写成 pending），一个字都不进提示词。两者作用机理相反，绑成一个开关
  会强迫用户做无意义的交易 —— 想关掉「末项别再转圈」就得连带关掉「清单纪律」。归到同一
  组只负责「看起来归一类」。
• 下方通栏：「工作区记忆」独占一整条，带极淡底色与上方分隔线（不套卡片外框 ——
  面板里再套一层圆角卡就是卡中卡，本仓库老坑）。它从右栏搬下来是因为三个性质都对不上：
  它是列表（长度跟工作区数量走）、是唯一按工作区存的一组、行结构是「名称 + 路径 +
  两枚迷你开关」横排 —— 挤在 392px 右栏里路径会被截成 D:\AI\E…，而路径正是「哪个工作区」
  唯一无歧义的标识。
• 行内三列 grid：标签定宽 132px / 说明弹性 / 开关定宽 40px。原来是 flex，开关跟着文字
  长度浮动，左右两栏停在两条不同的竖线上，扫「开没开」时每换一栏都要重新找位置。
• 说明常态一行：短句只讲「这一行与别行有什么不同」，共性提到组头右侧（「每会话首步 ·
  存于 host」「本机浏览器 · 不进提示词」）。全文挂在 title 上，鼠标悬停 / 键盘聚焦 / 触摸
  点按任一方式都能展开 —— 是按需展开，不是删字。
• 窗口窄于 820px 回退单列；窄于 560px 时行降成两列（标签+开关一行、说明独占下一行）。

「工作区记忆」列出本机全部工作区，每个工作区两枚开关：记录（要不要往这个工作区攒新记忆 ——
关掉后不再自动提取、模型也不能手动记）与不注入（要不要把已有记忆读进它的会话）。
两件事语义相反、互不影响：关掉「记录」不影响已有记忆照常注入，打开「不注入」也不影响继续攒。
当前会话所在的工作区带「当前」角标与左侧主色竖条；列表限高可滚，工作区多了不会把下面顶出卡片。

右栏五张卡：

思考过程卡贴在对话流里（不在右栏）：左侧一条 2px 竖线，无底色无投影，跑时展开跟随、
收口自动折叠成一行让位给正式回答。与它配套的还有提问与回答卡，紧贴在下方，
同一时机一起收成一行——回复落定后不再占屏，点标题行随时能再展开重读。

与官方「设置 → 字号」联动：左栏两张 + 右栏四张卡的字号、行高、图标全部跟随官方字号设置。
字号 14（默认）时与你之前的观感逐像素一致，调大调小会一起变。

> 右栏被挤压时（窗口窄 / 记忆卡内容多），操作面板与记忆卡会自动缩一档。
> 「思考 / 提问 / 产出物」等卡片各有独立开关，见 配置一览。

卡头 Git 状态与一键提交

操作面板卡头上，人物右侧那排按钮里有一枚 Git 分支图标（在邮件与设置按钮旁边），
图标右上角还会像邮箱未读那样挂一枚简约小角标（同款淡色小圆片，邮箱用淡红、Git 用主色），直接显示 Git 大盘里有多少个仓库
（工作区 + 自制插件）有未提交改动（0 时隐藏，三位数折成 99+；一个仓库改 11 个文件也只算 1，
不是文件条数），把「现在还有几个项目没提交」直接摆在眼前：

数据来自 host 侧 GET /api/chat-flow/git-status：分支、最后提交、改动列表（按 M/A/D/R/?/U 分类）、
staged/unstaged 计数、ahead/behind，以及一个 needsMerge 判定——「这个工作区现在不适合
直接提交」的三种情形（有冲突 / 落后远端 / 正在合并）会被标出来，而不是让你在冲突中途提交。

> 提交走严格 execFile、参数定长、不经过 shell，天然免疫命令注入；所有 Git 异常与分支
> 判断都平稳兜底，路由绝不 500。跨站请求同样过 rejectCrossSite 闸门。

旁边还有一枚入口打开「工作区与自制插件 Git 大盘」（GET /api/chat-flow/git-roster）：
把工作区本身和每个自制插件仓库各自的改动状况收在一张表里，一眼看出哪个仓库有东西没提交。

任务动画：卡头那 9 段

右栏卡头（以及空白新对话页的 Hero 卡头）那块 92×164 的立绘位，2026-10-26 起不再
是静态图片，而是一组按状态切换的透明底 WebM。用户给了 9 个本地 GIF，换成播放器
之后，一整轮对话里她都是「一直在动」的。

几条刻意的取舍：

• 允许打断（用户点名要的）：任何时刻只有一段是激活的，新状态直接顶掉旧的，不等
  前一段播完。回看历史轮次时，running 是 false，所以看到的是空闲那三段之一。
• 收尾的判据天生有歧义：「本轮还在跑、但没有任何一步在跑」在两次工具调用之间同样
  成立（模型在想下一步）。所以要求它连续 2.2 秒才认，而且 end-op 演完回「操作中」
  而不是冻在最后一帧 —— 万一误报，后果是「她做一个收尾手势又继续干活」，不是卡住。
• 切片段不卸载 ``：9 个一次性挂满、永不卸载，切状态只改 CSS 类名与
  play / pause。面板每 250 毫秒重渲染一次，按需挂载会让浏览器反复中断请求，
  表现是「每次都要闪一下才动起来」。
• preload="none" + 首帧海报：9 段合计 2.6 MB，全量预载等于每次打开大盘先拉
  一遍；真播起来之前看到的是同片段的首帧 WebP，不会有一闪的黑块。
• 系统「减少动态效果」时不播，只把画面切到该状态对应的静止片段（循环段的首帧）。
  滚出视口、标签页切到后台同样暂停解码；新对话页与右栏两个卡头同时存在时各播各的。
• 「你发了图」单独立一档：photo 是「某个读图工具正在跑」，演完就回「操作中」；
  viewing 是「你刚把图发过来、她正在看」，一条工具都还没跑（模型看完经常直接作答），
  所以要停在看图这一幕反复重播，直到真的开始动工具。判据只看输入侧的 image
  内容块（turn-input-images.ts），两处取数部位 data.content 与 payload.content
  都认 —— 写死一处会静默失效、界面上只是「不演了」，没有任何报错。
• 深色主题给人物补光：这套素材是白底 GIF 抠的，皮肤本身是冷调中低明度（L ≈ 101），
  白蕾丝与高光在 L ≈ 220 以上。白底上这是「白底上一段灰」，深底（L ≈ 24）上它就成了
  整块画面里最暗的一层，看起来像脸发黑。.kr-stage 在 body[data-ds-dark-theme]
  下统一提亮 brightness(1.12) contrast(0.94) 并在背后加一圈中性浅光（实测脸部
  L 101 → 114）。提亮幅度必须留在 1.05–1.2：再高白蕾丝先过曝，人会「发光」而不是变清楚。

素材是那 9 个 320×640 的原 GIF，在 Node 里按边沿洪泛把近白底抠成透明，再编码成
VP9 yuva420p（crf 38）配一张首帧 WebP。走 host 路由
/api/chat-flow/motion/<片段 id>.webm|.webp（cache-control: immutable），不内联
进 client 产物 —— 内联会让每个用户冷启动多下 3.4 MB base64，关掉动画的人也照下。

正文里能出卡片

流程图卡片（历史兼容）

早期版本用 ```diagram 围栏画流程图，要模型手工给出每个节点的坐标与折线点——
画歪是常态，且这个能力有独立开关、默认关，模型多半不知道它存在，常年闲置。

现在流程图 / 架构图 / 时序图 / 任何示意图，一律用 ```html 围栏手写内联 SVG
（见下一节）。iu 曾有的 graph / arch / sequence 三个图形 kind 已整块下线：
它们只能画算法排版的拓扑图，视觉上限被组件锁死，而图形恰恰最吃设计感。
能力文档随「html 卡片」通道默认注入，直接说「画个架构图」即可。

> ```diagram 围栏的渲染器仍然保留：历史消息里的老围栏照常渲染成 SVG 卡片
> （节点 / 连线 / 分支标注 / 三档比例），不会变成一坨 JSON。只是不再往提示词里注入
> 它的规范，模型也不会再主动产出——那个独立开关早已移除。

HTML 沙箱卡片（能跑真 HTML/JS）

```html
计数器
+10
let n = 0
document.getElementById('b').onclick = () => { document.getElementById('v').textContent = ++n }
```

对话流里出现的就是这张卡本身，没有任何常驻控件（2026-10-19 起把标题栏、源码/复制、
缩放、重载、全屏整组砍掉）：卡片是正文的一部分，不是嵌进来的组件。
里面是真在跑的 HTML/JS —— 小工具、计算器、图表、可视化、单页原型都能直接交付。

内置设计系统（kit）：正文里出现 k- 类名或 --k- 变量时自动注入，不写 CSS 也能
得到与宿主同一套视觉语言 —— .k-title / .k-lede / .k-h 排版，.k-num 等宽数字，
.k-rule 发丝分隔线，.k-kv 键值两栏，.k-grid / .k-cols 自适应多列，.k-bar /
.k-track 条状图元，.k-swatch + .k-a1~.k-a4 色标。尺寸全部跟随官方「设置 → 字号」
缩放（内部是 --k-scale），不写死 px。

内置交互（按需注入，不用自己写 JS）：data-tooltip="…" 提示气泡（hover / 键盘聚焦 /
触摸点按，Escape 关闭）；.k-tabs + role="tablist" 页签（点击与方向键已接管）；
__dshState.set({…}) / __dshState.ready(fn) 把交互状态持久化，刷新不丢；
window.__dshFill(text) 把结果回填输入框，由你确认后发送。

安全：卡片跑在独立 iframe 里，只给 allow-scripts、不给 allow-same-origin ——
卡片里的脚本读不到你的会话数据与页面 DOM。高度自适应上报；点卡片里的链接会开新标签页。

流式期先出占位卡：模型逐字吐 HTML 时先显示「正在预渲染…」，围栏闭合后原地变成真卡片。
空内容、只有注释、语言标记不是精确的 html，都会回退成代码块（你能看到原文，
而不是一张空白框）。

> 这个能力默认开启 —— 它是交付形态本身，不注入模型就永远想不起来用。

iu 原生交互卡片

输入框以 /iu 开头，这条消息会连 /iu 一起原样发给模型，模型据此出卡。十二种：

原生卡（不走 iframe）体积小、不白屏，还能把结果一键回填输入框由你确认后发送。
卡片状态会记住：勾过的清单、拖过的滑块、移过的看板卡片、切过的页签、填了一半的表单，
都存本地（localStorage），刷新页面不丢。

> 图形不再走 iu：graph / arch / sequence 三个图形 kind 已整块下线，图表 kind
> chart 也已下线 —— iu 只能画算法排版的拓扑图，而图形最吃设计感。现在任何示意图都写
> ```html 围栏手写内联 SVG（见上一节），文档随「html 卡片」通道默认注入。
> 历史消息里的 ```graph / ```diagram 围栏仍照常渲染（渲染器保留，只是模型不再产出）。

每张 iu 卡右上角只有全屏（Esc 退出，全屏态不再持久化——否则刷新后整页滚不动）。
缩放档位按钮已按用户要求移除：卡片字号统一跟随官方「设置 → 字号」，不再自成一档。

细节记不住没关系 —— 直接说「用 /iu 给我算一下」「用 /iu 做个对比」即可。

@ 不会把普通中文变成文件芯片

官方 @ 文件引用的判据只要求「@ 前面是空白、后面跟一串非空白字符」，不检查那串
东西像不像路径。中文里不打空格，于是「@的时候不是实时获取的」这种写法会被认成一个
叫「的时候不是实时获取的」的文件，文件当然不存在 —— 那段文字就渲染成一枚蓝色虚线芯片。

这里用一条 order 更小的 user-text 规则抢在官方前面，只把不像路径的 @ 盖回普通文字。
判据：带引号 @"..." / 含 / 或 \ / 含扩展名 / 纯 ASCII 且至少一个字母 —— 满足任一才算
路径。所以 @的时候、@帮我看看、@3.5 都是纯文字，而 @src/main.ts、@README.md、
菜单里选的 @package.json 照旧是芯片。

可交互卡片（proto-tabs）

```tabs 围栏 → 可点的页签卡片，适合并列展示几套方案。

运行中的程序：打 @ 直接挑窗口

输入框打 @，候选里除了官方的文件 / 会话，最上面多一组 「运行中的程序」 —— 你此刻
真的开着的窗口，每条带真实进程图标 + 窗口标题，右侧一行灰字是程序名（浏览器窗口写
Chrome / Edge）。前台窗口排第一，最小化的排最后。

选中后草稿里落一枚 @ 窗口标题 的芯片，模型收到的是结构化上下文：

[运行中的程序] 程序：chrome；窗口标题：Example Domain - Google Chrome；
路径：C:\Program Files (x86)\Google\Chrome\Application\chrome.exe；状态：当前前台窗口

于是「帮我把这个页面整理成笔记」「这个报错窗口是什么问题」这类话不用再说程序名 —— 指一下就够。

怎么采集的：host 半身用一个常驻 PowerShell 子进程枚举可见顶层窗口（标题 / 进程 /
图标 / 前台 / 最小化），暴露只读路由 GET /api/chat-flow/running-apps。首次冷启动约
600~700ms，之后每次往返 2~4ms（客户端还有 30s 缓存 + 后台刷新）。

过滤掉什么：托盘浮层、输入法候选窗、Progman / Shell_TrayWnd 这类桌面外壳、
Chrome 的「翻译此页？」气泡、TextInputHost 等系统提示宿主 —— 都有实测依据，见
src/running-apps/collect.ts 的注释。

失败面：采集器不可用时整组静默消失，官方的文件 / 会话候选照常工作，界面上不报错。
客户端只保留两层不算缓存的机制：并发去重（同一时刻一个请求）与失败兜底（用上一次成功的结果）。
宿主被强杀（任务管理器结束进程 / 崩溃）时，采集器由 C# 看门狗线程 TerminateProcess
自我终止，不会在机器上留下孤儿 pwsh。

对话读起来更顺

动效（移植自 aa2246740/dsh-better-display，MIT）：思考两行步进跟随、流式新文字淡入、
忙碌标签微光、展开收起过渡。全部只动 opacity / transform，并在系统开启
「减少动态效果」时自动关闭。

对话完成胶囊

移植自 dsh-companion 的 done-pill 模块。任一会话（含后台会话）回合结束时提醒一次；点胶囊直接跳进那条会话，悬停滑出「进行中 + 最近完成」面板，看问题与回复全文。

设置入口：官方「设置 → 通用」里新增 9 行（胶囊形态 / 对话完成胶囊 / 任务完成提醒 / 休息时间提醒 / 凌晨注意休息 / 胶囊大小 / 胶囊字体 / 录屏帧率 / 录屏画质）。

┌ 左下角小横条（默认形态）──────────────┐
│ ● 3 个对话完成 · 「整理会议纪要」摘要… │  ← 侧边栏设置行上方
└────────────────────────────────────────┘
悬停/点按 → 上方滑出「进行中 + 最近完成」面板

> 从 dsh-companion 迁入：存储键（dsh.donePill.*）、样式类名与宿主路由保持原样，浏览器里的已读状态、位置与外观设置无缝延续。dsh-companion 若同时启用，两套胶囊会重复显示——只保留一个即可（本插件已内置完整胶囊，不需要再开 companion 的 pill 模块）。

侧边栏：工作区 ⇄ 操作间

侧边栏「更多」下面只有一行切换菜单，两屏互斥：

也就是「这一行永远写着点下去会去哪」。当前停在哪一屏会记住（刷新不跳屏），
从任何一个工作台页回到会话时自动切回工作区——否则在操作间里点「新会话」
会看不到会话列表。

侧栏折叠成 56px 图标态时，这条二级导航整块让位，官方「工作台」图标行接管
（那里放不下一整屏二级导航），入口在任何形态下都不会丢。

二级菜单：手风琴

记忆（工作区）、画廊（八个类别）、档案（场景）这几行展开后列出的子项，是手风琴：

• 点开「画廊」，之前展开的「记忆」在同一拍收起，同一时刻只有一组子项展开；
• 展开态记在 localStorage 的 dsh-sidebar-expanded-menu，刷新后仍是上次那一行；
• 实现是「展开 = 覆盖成单值」（writeExpandedMenus），渲染层只判断自己那行，
  所以互斥是数据结构自带的，不需要每次点开头再遍历兄弟行去收一遍。

档案的场景子项还多一层三级分组（账号与登录 / 支付与联系方式 / 证件与文件）：分组行
点击只展开 / 收起，叶子节点才切换场景；默认展开当前选中项所在组，自定义场景平铺在分组之后。

> 旧版本允许多行同时展开，存量数据里可能还留着 memory,gallery 这种多值。
> readExpandedMenus 只认第一个，任何一次展开/收起都会把它写回单值——升级后
> 不会出现「一进来所有行全撑开」。

加一个新菜单（给二次开发）

侧栏二级导航是注册表驱动的：src/client/triad/hub/nav-registry.ts 里两级数据
——区域（section）与条目（entry），侧栏只按表渲染。加一个菜单不需要碰挂载器、
样式或显隐逻辑：

// 打开某个官方 main 面板（例：加一个「任务」菜单）
ctx.effect(() => navMenuItem({
id: 'tasks', label: '任务', icon: MyTasksIcon, panelId: 'schedule',
}), 'dsh-chat-plus: 任务菜单')

// 打开工作台的某个分类
ctx.effect(() => navMenuItem({
id: 'gallery-entry', label: '画廊', icon: MyGalleryIcon, workbenchTab: 'gallery',
}), 'dsh-chat-plus: 画廊菜单')

// 自定义动作（弹浮层、发命令……）
ctx.effect(() => navMenuItem({
id: 'custom', label: '随便什么', icon: MyIcon, run: () => { /* ... */ },
}), 'dsh-chat-plus: 自定义菜单')

// 再加一整屏（第三个区域，按 order 轮转）
ctx.effect(() => navSection({
id: 'tools', label: '工具间', icon: MyIcon, order: 30,
}), 'dsh-chat-plus: 工具间区域')

条目缺省落在操作间（section 不写就是它），order 决定行序（工作台七个
条目占 10–70）。注册返回的 dispose 交给 ctx.effect 回收，热重载不残留；
同 id 重复注册 = 覆盖，不会叠出两份。

七个工作台

侧边栏工作台，每页独立（邮箱不在其中，它的入口在 Seeker 标签右侧，见
邮箱）：

记忆

自动沉淀的长期记忆：每轮对话后由模型提炼值得跨会话保留的事实（你的偏好、项目约定、踩过的坑），
按项目 / 全局分层。可在面板里增删改、置顶、按标签检索。在左栏选中某个项目后，列表头下方
出现一条项目上下文条，可改别名、可清空该项目的全部记忆（置顶记忆会保留）。

两个按工作区的开关（记录要不要往这个项目里攒新记忆、不注入这个项目的记忆要不要
进上下文）不在这个面板里 —— 它们在 Seeker 的 大盘设置
卡片里，按工作区逐个列出、一次能拨完好几个。一处入口、一份真相。

SKILL

管理技能（Skill）：安装 / 停用 / 查看说明 / 归入技能包 / 设置分类。技能包与状态筛选在同一行，
分类在左、启用状态在右。

观测 / 用量

整页是一块观测大盘：顶部范围胶囊（今日 / 昨日 / 近 7 天 / 近 30 天 / 本月 / 上月 / 今年 /
全部 / 自定义）+ 自动刷新间隔；第二行供应商 / 模型下拉、请求状态分段（全部 / 失败 /
重试后成功）、关键字搜索与 CSV 导出。

四张 KPI 卡：Token（输入 / 输出 / 缓存拆分）、请求（失败数、成功率、重试后成功）、
缓存命中率（带进度条）、输出速度（token/秒 + 首字平均）。中段按日堆叠柱状图，
三档口径 Token / 请求 / 速度可切，悬浮出卡片式 tooltip、点某天下钻；右栏是「拆分维度」
列表（模型 / 供应商两个维度，同色系与柱图对齐）。底部 52 周活动热力图。

进入页面默认落在「今日」：中段趋势图按 24 小时（00:00–23:00） 出柱，能看出一天里的
用量分布；切到其它范围（近 7 天 / 本月 / 自定义等）恢复按日聚合。

版面铺满可用宽度：KPI 用 auto-fit 栅格（宽屏均分、窄屏折行），右栏宽度 clamp 到 22%，
热力图格子按容器实测宽度在 12–28px 之间自适应，断点用容器查询而不是视口查询——工作台
既可能全屏也可能嵌在窄栏里。

画廊

所有对话生成的图片 / 网页 / 演示 / 文档 / 表格 / 音视频一页看全：跨会话增量索引、
类别筛选、搜索、跳回来源会话。

点任意一张卡片 = 用系统默认应用打开这个文件（2026-10-20）—— 图进看图器、视频进
播放器、PPT 进 PowerPoint，与你双击资源管理器里的图标完全一致。走官方 open-in-app
那条 shell-open 链路（remote.session.openWorkspacePath），不自建路由。

> 产出物卡的口径与画廊不同（2026-10-22）：侧栏能正常展示的类型走侧栏（图片 /
> 文档 / PDF / Office / 表格 / 页面 / 音视频），展示不了的才交给系统默认应用。
> 判据逐扩展名核验过（含 ods 的接管、avif/tif/heic 这类"看着像图但官方不认"的
> 坑），见 src/client/sidebar-display.ts。

本机没有桌面时（手机远程访问 / 纯服务端部署）自动退回内置预览：可内联的进就地
弹窗（图片缩放、视频播放、html 沙箱 iframe、PDF / Office 页图翻页），不可内联的走
官方右栏，行为与升级前一致。那个弹窗右上角也留着一枚「用默认应用打开」，本地看到
想拿去用的那一刻就能直接送出去。

生图与生视频的结果原本只存在于 spill 的文本里，打开前会先由 host 落成真正的
png / mp4 —— 直接把 .txt 交给系统只会弹记事本。

每个类别标签上写着该类的真实条目数（图片几百张就显示几百，不做 99+ 之类的截断）。

时间轴视图（默认视图）的方格在 2026-10-24 整体放大约 21%：最小列宽 150 → 182px、
gutter 10 → 14px，缩略图与占位图标同步加法，格子仍是 1:1 正方形。四种格式
（图片 / 网页 / 视频 / 音频）共用同一套方格尺寸，换类别不会跳变。

同一次改动里去掉了方格右上角的类型徽标（分类已经在工具条上选定，每格再挂一枚纯属
噪声）；2026-10-25 又把文件名与时间从常驻改成 hover 浮层：默认格子是干净的正方形
缩略图，鼠标移上来（或键盘聚焦）时以自下而上的渐变浮层淡入在缩略图内部的下缘，
压图显示。一屏因此多放一整行（实测 6 行 → 缩略图 187×187、日期分组间距压到 2px）。
网格视图的文件名仍是常驻，未受影响。

删除有两条路，互不干扰：

• 按类别整批删：每个类别标签带一枚删除键 —— 点它，标签原地变成「删除 N 项？不可恢复
  确认 / 取消」，确认后把这个类别下的条目连同磁盘文件一起删掉（不可恢复，所以有
  这一步二次确认；按 Esc 或点别处即取消，几秒不操作也会自动收回）。
• 单条删（2026-10-24）：鼠标移到任意卡片上，右上角浮现一枚垃圾桶 ——
  第一次点变成红底「删除?」，再点一次才真删。键盘用户聚焦卡片后按 Delete /
  Backspace 走同一套两拍语义。确认态没有自动回退（视线就在这张卡上，自动收回
  反而像静默失败），取消出口是点别处 / Esc。

两条路都先播淡出退场再发请求；若有个别文件删不掉（被占用、已不存在），它们会留在
画廊里并给出原因。删除只作用于画廊索引里的普通文件，符号链接与目录一律拒删，也不会
连带删除目录内容。

> 图库缩略图是真实首页位图而不是类型图标。PDF / Office 由插件的侧栏渲染器接管
> （官方内嵌 pdf.js 对带 /ID 的 PDF 会崩），音视频由插件的媒体渲染器接管 —— 官方把
> mp4 / mp3 这类后缀列为「没有渲染器」，不接管的话侧栏只会说一句「不支持预览」。

档案

「不管工作区关不关记忆，它都会自动记录并自动注入」——这是档案与记忆最根本的区别。
记忆库的两道闸门（按工作区「记录 / 不注入」）对档案完全不生效：档案有自己的
autoRecord / autoInject 开关，默认全开，且注入以 prepend 优先级注册，
跑在记忆库那两道闸门之前。

一页管完七类结构化信息：账号密码 / 邮箱与登录 / 支付方式 / 联系方式 / 证件 /
配置文件 / 其它，分组可改名、可加自定义分组。页面是「概览 + 场景切换 + 记录卡片网格」
的形态：顶部 Hero 给记录 / 场景 / 照片 / 占用的四格统计，下面一排场景胶囊切换视图，
每条记录是一张卡片，点开在卡片下方原地展开详情（不遮页面、不滑抽屉）。深色模式
页面底固定 #151517。每条记录是一个实体（一个站点账号、一张卡、一份证件），字段级就地
更新——「密码从 A 变成 B」是一次字段 patch 加一行历史，不是一个追加句子。证件这类
场景可以挂图片（正面 / 反面 / 补充），浏览器侧压成三档再传上来。

四条不变量（改代码时不要破坏）

模型那侧只有 3 个工具（vault_search / vault_get / vault_remember），
查得到「有没有这个账号」，拿不到密码。要明文必须用户自己在页面上点眼睛。

谁来写：主 agent 当场写，后台抽取兜底

2026-10-26 起写入以主 agent 自己调 vault_remember 为主：用户这一轮说出新的账号 /
密码 / 证件信息，模型当场写进去，当轮即时生效（用户下一句就能用）。turn/end 的
后台抽取退为兜底——模型漏调时仍能捡到，不会丢数据。两条路写同一份 store，靠
「场景 + 归一化标题」去重、patchField 的「值没变就不写」保证重复写幂等，不需要额外互斥。

这么改的原因很实际：抽取是回合结束之后跑的，写入永远滞后一轮。原来的注入规则
甚至明说「正常对话即可，回合结束会自动抽取入库」，等于劝住模型别自己写——于是用户
刚给完密码紧接着说「那你去登一下」，模型手上还是旧值。

自动抽取的结果也直接生效，没有「待确认」环节。 写进去是什么样，模型下一轮就读到
什么样：记录上没有「待确认」状态、页面没有确认 / 驳回按钮、也没有 POST /confirm 路由。

> 这里原本有一套「抽取结果挂 pending、等用户点确认/驳回才算数」的机制，2026-10-27 用户
> 明确要求档案不需要确认，整套退役（VAULT_SCHEMA_VERSION 1→2）。理由是那道闸门
> 同样把「当场写、当场用」拖住了：模型明明在会话里听见「密码改了」，档案里却还是旧值、
> 页面还堆着一栏待确认。现在护栏只剩三条——update 只改模型明确点名的字段、create 先按
> 「场景 + 归一化标题」查重、patchField 值没变就不写——改错了也只错在那一个字段上，
> 下一轮抽取还能改回来。老库里已经挂着的 pending 标记由 migrate 的 v1→v2 一级
> 主动删掉（不是「从此不再写」），否则会留下一条永远挂着、页面上却没有入口能处置的
> 假状态。

> ⚠ 这条路上绕不开的一件事：模型自写意味着明文要经过模型厂商一次。官方的 tool/call
> 事件保存的是模型产出的原始 arguments JSON 串（dsh-session 类型里原话：
> the raw arguments JSON string exactly as the model produced it），而 ToolCallBlock
> 属于 ContentBlockMap，会随 assistant message 在后续每一轮重发给 provider。所以明文
> 与其他对话内容同级别地走了厂商、并留在会话历史里。后台抽取同样要发给模型才能抽出
> 字段（只是不落在主会话历史里）。两条路都做不到「模型不看见明文」——真正的零暴露
> 只有用户自己在页面手录。代码里因此把「参数里传一次是必须的，但不要在回复正文里
> 复述」写成硬纪律，把凭空多出来的那一份副本消掉。

存储与占用

/memories/dsh-chat-vault/
vault.json            记录 + 分组（几 KB~几百 KB，原子写 tmp+rename）
key                   32 字节 AES-256 密钥（0600）
blobs/<2位>/  图片与文件字节，内容寻址：同样的字节只存一份（照片压三档、文件原样存）
blobs/index.json      blob 索引 + 引用计数
revisions/<日期>.json 每日快照（「回到昨天」）
audit.jsonl           敏感字段明文查看审计

占用的三档压缩实测（同一张 2.1MB 原图，JPEG q75）：

| 档位 | 长边 | 体积 | 占比 | 用在哪 |
|---|---|---|---|
| thumb | 512 | 36KB | 1.7% | 列表 / 网格 |
| display | 1600 | 270KB | 12% | 详情 / 灯箱 |
| original | 原样 | 2100KB | 100% | 默认不存（keepOriginal） |

配额默认 512MB，超出时按 original → display 顺序淘汰，缩略图和记录文本永不删
（照片全没了，账号密码也还在——这是「有损但不会丢命」的方向）。

到期提醒：它会提前告诉你哪几样东西要失效

页面右上角有一枚「提醒」按钮（显示有几项要到期），点开是一个独立的窗口，
按紧急度分三档列出 90 天内到期、以及已经过期的记录：

数据来自 GET /api/dsh-vault/reminders。三条设计约束：

1. 每条记录只看最近的那一个日期，不把「签发日期 / 到期日期」都列出来——用户要
   动的手只有一处（去换掉那张证），同一件事报两遍只是噪音；
2. 只读日期字段，不读任何明文。这条路由用的是掩码版 listRecords，整个窗口
   连一次解密都不做；
3. 与每轮对话注入行尾那句「有效期还剩 89 天」是同一个函数（reminders.ts 的
   expiryNoteOf / nearestExpiryOf）——两处各算一遍，迟早会出现「窗口里没有、但
   模型被提示了」。

> 早先这里还有一整套「密码健康审计」：0–100 的分数、弱口令 / 复用 / 明文落盘 / 同名
> 重复四类问题，以及一个「一键批量换密」（GET /health + POST /rotate）。
> 用户 2026-10-27 明确要求删掉：那一整套里只有日期会自己变坏，其余都是用户自己
> 造出来的状态，报出来只是替他数落一遍，而每一条都得他去各个站点手动改密。
> 路由、引擎、页面入口与对应测试一并删除，别照着旧文档加回来。

实战中的几个小工具

• TOTP 动态验证码：存了「二次验证」种子后，详情页点一下就能出 6 位码 + 倒计时环，
  到期自动换。种子支持裸 base32、otpauth:// 链接、带空格 / 短横线的分组写法三种形态。
  实现按 RFC 6238，测试里直接对官方测试向量（T=59s 出 94287082）做了断言。
• 强口令生成：服务端 crypto.randomInt（不是 Math.random），保证含大小写与数字、
  去掉 l/O/0/1 这类易混字符，附带熵值显示。
• 加密备份：用你自己的口令把密钥 + 全部记录打包成 .dshvault 文件
  （口令经 scrypt 派生，AES-GCM 加密后再 gzip）。换电脑 / 重装系统 / 改了 DSH_HOME 时，
  只要还记得那个口令就能整库救回——这是不依赖网络的换机通道，因为密钥只存在本机。
  恢复的顺序是「先解包校验 → 再换密钥 → 最后覆盖数据」：口令打错一次就覆盖掉现有
  密钥，会让原本能用的数据当场全部解不开。
• 文件附件：任意软件的配置文件、订阅、证书、脚本都可以直接挂在档案记录下：
  原样保存、按原文件名下载，单文件上限 20MB、每条记录最多 20 个；和照片一样计入占用
  并随工作台云同步上传。入口在记录详情页的「文件」区；新建时选内置的「配置文件」场景
  最方便（字段是名称 / 用途 / 说明）。
• 云端同步：档案已并入工作台「同步设置」的云端双向同步（见下文「同步设置」），
  同步范围里可以只勾选「档案数据」。档案页右上角不再单独提供「云端」入口。

隐私边界

所有 /api/dsh-vault/* 路由自带两道闸门：只接受 loopback 来源（远程访问由 DSH
自己的鉴权挡住），并且拒绝跨站请求（浏览器跨站时 IP 与 Host 都满足 loopback，
只看 IP 是不够的）。图片直链只服务索引里登记过的 sha256，杜绝路径穿越。

> 档案不替代密码管理器：它没有浏览器插件、不会自动填表、不会在钓鱼站上识别
> 「这个域名和记录里的不一样」。它解决的是「AI 需要知道你有没有这个账号」以及
> 「换机之后还记得住」。

系统提示词

看这一次发送会话时，模型真正收到的那段系统提示词。这个面板只读，但它是唯一能看到
「组装完之后长什么样」的地方——提示词不是浏览器侧拼出来的，而是 host 在每个 step 之前
把「全局段 + 作用域段 + 运行时上下文 + 工具清单 + 变量」组装出来、再经
system-prompt/assemble 这条 waterfall 逐层改写（本插件的工具闸门就在这条链上删工具、
删提示词段、追加「哪些能力关着」的说明），最后渲染成一段纯文本交给 provider。

所以快照是在 waterfall 的出口抓的：抓到的是最终值，任何插件改写之后的形态。
会话事件里回放的 system/message 做不到这一点——那是「过去某一步的渲染结果」，不带分段，
也看不到「关掉工具组之后剩什么」。

两条设计取舍：

1. 不落盘。工作目录、模型、各开关状态、时间都在里面，每次组装都会变；落盘等于存一堆
   只有几分钟价值的副本，还要处理清理、迁移与（更麻烦的）加密边界。所以只留最近几个会话
   各一份，进程重启即清空——页面会如实说明这件事，而不是给一个「空的但不知道为什么空」的页面。
2. 绝不抛穿。出口 hook 抛错会毁掉用户真实的那一轮请求，路由抛错会变成页面上的红屏。
   所以记录逻辑整段 try/catch，路由一律 200 + ok 字段，失败只是「这一次没抓到快照」。
   新会话一个字都没发时，路由会现场跑一次 assemble（同一套链、同一个出口），结果与真要发出去的
   一致；只有「活会话」才有 agent，历史会话直接如实回「不在本进程内」，不编一份看起来像真的
   提示词。

数据源：GET /api/chat-flow/system-prompt（?session= 指定会话，缺省 = 最近一次组装；
?fresh=1 跳过缓存现场重算）。

同步设置

把工作台资产（档案 / 记忆 / 技能）加密后推到你自己的 GitHub 私有仓库，用于换机、
多机漫游。档案原先那套单独的「云端备份」已经并入这里——同一件事只保留一个入口、一份凭据。
档案里的文件附件（Clash 订阅、配置文件等）也会随包上传，换机后能原样下载。

设置三项：仓库地址（owner/repo）、同步口令（≥8 位）、访问令牌（可留空走 gh auth token）
同步范围：档案 / 记忆 / 技能，三档独立开关
主次优先级：本地为主（主力机） / 智能双向（默认） / 云端为主（从属机）
自动节奏：自动上传 + 自动同步，间隔 1 / 2 / 5 / 12 / 24 小时（默认 5 小时）

几条硬约束：

• 只认私有仓库：先探 GET /repos/{owner}/{repo} 确认 private: true，公开仓库直接拒绝
  ——包里含本机密钥，一旦公开等于把整库交给全世界的离线暴力；
• 令牌与口令加密落盘，接口只回「来源 + 末四位」，任何日志与响应里都不出现明文；
• 端侧加密后才出门：上传前在本地打包加解密，推上去的是一个 .dshsync 加密包，
  不是可读的 JSON；
• 内容没变就不产生新提交（按内容哈希短路），不打扰你的提交历史；
• 同步/上传结束后，侧栏「操作间」那行文字后面会挂一枚小字（「已同步」/「已上传」），
  停留 1 分钟后淡出；刷新页面在有效期内仍会继续显示。

同步完成后记忆引擎会热重载（MemoryStore.reload()），不需要重启 DSH 才看到还原的条目。

Agent 邮箱（只读卡片）

腾讯 Agent Mail 的专属邮箱（与你的个人邮箱完全隔离）。入口在 Seeker 标签右侧的邮件按钮，
紧跟「大盘设置」齿轮 —— 点开在视口中央弹出只读卡片（约 1080×760，四周留边、点外面或按
Esc 收起）：左列文件夹（收件箱 / 已发送 / 回收站 / 垃圾邮件 + 只看未读 / 只看附件）、
中间的邮件列表、选中后的正文与附件。窗口压窄到卡片不足 620px 时，自动切成
「列表 ↔ 正文」单栏，点邮件看内容、点返回回到列表。

只看，不发：面板里没有写信、回复、转发、移入回收站、永久删除的入口。
模型那侧同样只剩 6 个只读工具（mail_account / mail_list / mail_search /
mail_read / mail_download_attachment / mail_wait_code）—— 它能自己查收件箱、
读信、找邮件、下附件、等验证码，但发不了信也删不了信。写类那 5 个工具已下架。

邮箱地址 / 授权状态 / 额度、开关（启用邮箱工作台、对话里自动声明邮箱能力）、
附件保存位置、CLI 与数据目录这些设置仍在面板左下角的「设置」里。

> 「新邮件实时监听」已于 2026-10 整块移除：它靠一个常驻的 agently-cli message +watch
> 长轮询进程，产出只有「面板开着时弹一下」，面板关掉后什么都没有；而且事件缓冲从不清空，
> 每次打开面板都会把历史事件当新邮件误报一遍。未读数本来就由列表自带，代价大于收益。

输入区与工具栏

优化提示词：点输入框右侧的 ✨ 图标，用当前选中的模型把草稿改写成更清晰的提示词。

结果由共享清洗器（prompt-optimize-clean.ts，host / client 同一份）收敛成可直接发送的正文：去掉围栏、去「优化后的提示词」小标题、去结尾「主要改动」段落。两条安全线：正文里的代码块不会被当成答案（草稿含代码时不会只剩几行 SQL）、用户自己写的「备注：」约束不会被当成改动说明删掉。输出顶到长度上限时会明确提示，不会把半截结果当成功。

download 工具：模型可以把文件下给你，带实时进度条 / 速度 / ETA。

对话截图：把这条回复渲染成图片，代码块带语法高亮、mermaid 出真图。

面板里的选项：范围（本条回复 / 这一轮问答 / 整段会话）、宽度（540 / 720 / 960 / 1200 / 1440 / 1920，或填 360~2560 的自定义值）、画质（1080P / 2K / 4K）、主题（浅色 / 阅读版 / 深色 / 玻璃 / 玻璃深色）、标题与徽章。
六项全部记住：改完下次打开面板还