DeepSeek Harness 插件

dcrzsy/dsh-enhance-tool

Star 数 ★ 0 分类 UI 增强 收录于 2026-08-24

DeepSeek Harness Web 一站式界面增强:提示词库(快选+管理)、两步 AI 润色、预测回复栏(点击直接发送)、MCP 工具管理、定时自动化、智能会话标题、对话宽度可调、AI 回复占满无灰底、超长用户消息自动折叠(带平滑展开/收起动效),以及各面板的场景化入场动效。

安装

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:dcrzsy/dsh-enhance-tool

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

DeepSeek Harness (dsh) web 界面增强插件 — 润色、提示词库、预测回复、消息工具条常显、工具调用耗时、宽度/字号/侧栏缩放、会话分享为图片。

  • 安装形态:100% 插件注入(slot / shell.overlay / settings / sessionTitle 官方机制)+ 一个随包发布的声明式挂载层 cordis.patch.yml(package.json 的 dsh.bundle.patch:insert ui-enhancer + 禁用官方 session-title-llm)。它不改 dsh 官方 bundle 源文件、也不手改 profile 的 patch 配置(旧文档「零 bundle 补丁」的说法不准确,已删)
  • 兼容版本:dsh ^0.2.0-rc.2(以 package.json 的 peerDependencies 为准;已实测 0.2.0-rc.2)。此前的实测版本为 0.1.0-rc.7 / 0.1.1-rc.2 / 0.1.2-rc.1 / 0.1.5-rc.2——0.1.x 已不在当前声明范围内(dsh 0.2.0 起会按 peerDependencies 跳过版本不匹配的 bundle),0.1.x 用户请继续使用 v0.13.1
  • 许可证:MIT

安装

方式一:dsh 官方插件命令(推荐)

dsh plugin --profile web add github:dcrzsy/dsh-enhance-tool

安装后需要补一个 pnpm 解析不到的依赖(它位于全局 dsh 包内):

DSH=$(dirname "$(dirname "$(node -e 'console.log(require.resolve("@deepseek-ai/dsh/package.json"))')")")
ln -sfn "$DSH/node_modules/@deepseek-ai/dsh-session-title"        ~/.dsh/profiles/web/node_modules/@deepseek-ai/
ln -sfn "$DSH/node_modules/@deepseek-ai/dsh-session-title-llm"    ~/.dsh/profiles/web/node_modules/@deepseek-ai/

dsh plugin 是官方插件管理命令(转发到 profile 目录的 pnpm),与 dsh-power-button、dsh-better-sidebar 等社区插件的安装方式一致。

方式二:一键脚本

git clone https://github.com/dcrzsy/dsh-enhance-tool
cd dsh-enhance-tool
bash install.sh

install.sh 自动完成:dsh plugin add 标准安装(本地目录失败时依次退到 github 目标、自包含拷贝安装)→ 确认 profile 的 dsh.profile.bundles 真的启用了本插件 → 链接 dsh-session-title-llm 依赖 → 全文件语法验证。任何一步没做成都会给出可行动文案并以非 0 退出(不会再出现"没启用却打印 [7/7] done.")。

link: 提示:dsh plugin --profile web add <本地目录> 会被 pnpm 记成 link: 符号链接,指向你 clone 的那个目录。脚本会检测并提示:clone 一移走/删掉,下次启动插件就只剩一行 skipping profile bundle "dsh-enhance-tool"(已实测)。要"拷贝安装、与 clone 脱钩"就用:

bash install.sh --copy

--copy 直接把文件拷进 profile 的 node_modules 并把 dsh-enhance-tool 写进 dsh.profile.bundles(不经过 pnpm)。它可以叠加在默认的 link 安装之上:拷贝前会先清掉 node_modules/dsh-enhance-tool(活链接、悬空链接、旧目录三种情况都按 rm -rf 处理;只删链接本身,不动 clone),所以从默认安装切到 --copy 不会卡在 [4/7];重复跑也幂等。实测:装完把 clone 移走/删掉,dsh --profile web --dump-config 仍能挂上 ui-enhancer、stderr 0 行。取舍:它不在 pnpm 的依赖图里,之后对 profile 跑 dsh plugin add/install 这类包管理操作时可能被清掉——那时重跑一次 bash install.sh --copy 即可。

卸载

dsh plugin --profile web remove dsh-enhance-tool   # 正确:依赖与 dsh.profile.bundles 条目一起清掉

没有 dsh CLI,或用 --copy 安装时:

bash install.sh --uninstall

别只删目录(旧版 install.sh 结尾曾这么写):rm -rf …/node_modules/dsh-enhance-tool 会留下 dsh.profile.bundles 里的条目,之后每次启动都打一行 dsh: skipping profile bundle "dsh-enhance-tool"(已实测)。--uninstall 会删目录、清条目,并用 dsh --profile web --dump-config 复验不再出现该告警。

安装后

# 重启 dsh web:优雅退出(SIGINT),不写死端口、不用 fuser/SIGKILL
#   前台运行:在它自己的终端里 Ctrl+C,然后重新执行 `dsh web`
#   后台/分离运行:先确认 PID 再发 SIGINT(3080 可能被别的服务占着,
#   `fuser -k 3080/tcp` 会杀错进程、而且 -k 默认就是 SIGKILL 硬杀)
pgrep -af 'dsh web'      # 确认是你那份 dsh web
kill -INT <pid>
# 装了 dsh-power-button 的话,直接用它的 restart 入口即可

浏览器 Ctrl+Shift+R 硬刷新即可。

插件通过自带的 cordis.patch.yml(dsh.bundle.patch)自动挂载,无需手动改配置。 卸载:dsh plugin --profile web remove dsh-enhance-tool 后重启 dsh web(细节与"只删目录会留下永久 skip 告警"的对照见上面的「卸载」)。


功能清单

1. 输入增强(composer)

功能 机制 位置
润色 /polish API,用当前会话的模型重写草稿(默认润色 / 自定义要求润色) conversation.input.left 按钮
发送前自动润色 设置开关(默认关闭)+ 可选「自动润色规范」:拦截输入框的普通 Enter 与发送按钮,先调用 /polish(规范作为 requirement),再把润色后的草稿发出;润色期间的再次 Enter/点击会被吞掉,避免重复发送;/ 开头的命令跳过;失败回退原文并浮动提示 设置 → 界面增强
提示词库 /prompt-library API,持久化 ~/.dsh/prompts.json;支持分组 / 搜索 / 增删改 / 一键插入。插入按“粘贴”语义:输入框已有内容时先换行再追加,不覆盖原草稿(读不到 useInput 的旧构建回退读 Lexical contenteditable,避免把非空草稿当成空串) conversation.input.left 按钮
自动润色规范 设置里的多行文本,最多 4000 字,随状态持久化;开启自动润色时作为 /polish 的 requirement 发送,例如“保持简洁 / 保留 Markdown / 不要改代码块”。留空即使用默认润色 设置 → 界面增强
预测回复(建议条) /suggest API:把你的上一条提问 + AI 的最后一条回复一起给模型,要求三条覆盖不同意图(推进 / 追问原因 / 换做法)并跟随对话语言;带「预测回复」标签与 1/2/3 序号的胶囊按钮。点击直接发送(设置可改为"仅填入输入框");Shift+点击或 Alt+Shift+1/2/3 只填入不发送;Alt+1/2/3 快捷选择 conversation.input.dock

本插件的主要配置项按「界面布局 / 输入与润色 / 消息与分享 / 任务看板」分类集中在 设置 → 界面增强 独立菜单中;不再写入产品的「设置 → 通用」页。默认系统提示词是左侧栏的独立入口,不重复放进设置。

2. 布局与宽度(设置页 + 运行时)

功能 说明
对话内容宽度滑块 60%–200%(100%=748px,200% 占满可用宽),localStorage 持久化
对话字号滑块 12–20px,消息区字号 + 行高联动
AI 消息占满消息列 无背景卡片、width:100% 消除右侧空白
用户消息自适应宽度 fit-content + max-width:100%:内容少小气泡、内容多撑满整列
用户长消息折叠 渲染行 > 5 行自动折叠,点击展开/收起(含历史消息)
任务看板(通用面板) 会话头部「轨迹」右侧的「看板」页签式入口:待办 / 进行中 / 完成 / 搁置 / 归档 / 垃圾桶六列;卡片默认是会话,「待办」列可新建自由待办卡,点一下就建会话并开始执行;支持拖拽跨列与列内排序、批量选择、列折叠、搜索/工作区过滤、自动归类
新会话系统提示词 左侧「默认提示词」入口(工作区上方):全局默认 + 每个工作区覆盖;工作区优先,存 profile enhancer-system-prompt.json,替换新会话原有系统提示词;只对尚未开始第一轮对话的会话生效
上下文面板 「轨迹」和「看板」之间的「上下文」入口:上下文用量(% / tokens)+ 组成(系统提示词 / 工具定义 / 对话消息)+ 两个页签(上下文内容 / 单独查看系统提示词),实时跟随会话与压缩结果;「压缩」直接发 /compact 并回报真实结果,「编辑上下文」可改会话内容并作为新消息发回
看板归档时同时从侧栏收起会话 默认关闭。开启后只有手动把卡片移入「归档」列(拖拽 / ⋯菜单 / 批量 / 「归档过期」)才调用核心 workspaces.archiveSession 把会话从侧栏收起,移出「归档」列用核心 unarchiveSession 恢复;规则自动归类永不触发;失败写进看板提示栏
消息工具条常显 每条消息常显发送时间与复制 / 分叉 / 调用量 / 耗时按钮(当天 HH:mm,跨天带日期)——产品默认需悬浮才显示
工具调用耗时 每条工具调用与子工具(PTC 子调用)右侧常显耗时(296ms / 2分02秒);进行中的调用实时计时(蓝色脉动,如 35s…),完成后自动定型;悬浮显示开始 / 结束时刻
面板打开时消息区让位 工作台面板 / 侧边栏打开时消息列自适应,不重叠不压缩
hero 页面适配 hero composer 固定底部、headline 置顶

3. 会话标题

  • 自定义标题 provider(所有消息触发)+ 创建时间戳后缀(-YYYYMMDDHHmmss)
  • 自动禁用官方 session-title-llm(通过 bundle.patch)

4. 任务看板(通用面板)

会话头部**「轨迹」紧右边的 pill 按钮「看板」打开一个宽模态看板,卡片 = 会话。入口的实现方式:不用 utilities slot(那个位是头部最右侧的一簇控制,离「轨迹」有 600px 以上,实测容易看不见),而是把按钮作为纯 DOM 节点插到 tab 条之后**,并按产品的 pill 规则逐条复刻一套 token:28px 高、0 14px 内边距、1px --dsw-alias-border-l2 描边、14px 圆角、13/500 字重、--dsw-alias-label-secondary 文字 —— 静息态与「轨迹」逐像素一致;面板打开时换成 --dsw-alias-state-business-primary 填充 + 反色文字,也就是「对话」选中态。入口不带图标(原先那枚自绘柱状图让它成了整条 tab 里唯一的图标页签,2026-10-19 去掉);也不借产品 tab 的类名:产品的 pill 规则是后代选择器 [class$="_tabs"] [class*="_tab"],而看板按钮是 tab 条的兄弟(不塞进产品 React 管的 role=tablist),借来的类只命中基础规则 padding:0 0 9px,反而被拉成无底无边的文字链。设置项关闭时同一个节点隐藏,无需重载。这是给「一堆并行会话」做的人工分诊台,不改动任何会话数据。

六列与自动归类(未被手动拖过的会话按下列规则自动落列,从上到下首个命中)

列 自动规则
进行中 running,或该会话有 running / stopping 的后台任务,或 inbox 里有排队消息(next-turn / next-step)
待办 真的还有事没完:最后一轮还没被回复(turnOutline 最后一条的 response 为空),或会话自己的 todo 还有未完成项(todos[].status !== "completed")
完成 已回复的会话,且最近 7 天内动过(工具栏「显示全部」可放开这个窗口)
搁置 只有手动拖入(不自动进;用来把"暂时不做"单独放一边)
归档 其余(更早的、或投影信息未缓存的会话)
垃圾桶 只有手动拖入(不自动进)

自动规则只读 host 侧已有的 session 投影(summary.projectionValues 里的 turnOutline / todos / inbox),不发额外请求:turnOutline 记录了每一轮的 prompt 与 response,所以"这一轮跑完没有"是可直接观察的事实。

为什么不再用"最近动过 = 待办":dsh 的 SessionSummary 根本没有 completed 字段(只有 sessionId / updatedAt / running / blank / parentSessionId / origin / cwd / projectionValues),所以早先"完成 = completed"这条规则永远不会命中,跑完的会话全都掉进「待办」。现在「待办」只放真正没完成的事,跑完的会话进「完成」,更早的进「归档」;冷会话(投影未缓存、没有 turnOutline)按"已回复"处理。

手动拖拽/菜单/批量移动 = manual,之后自动规则不再改它;卡片上的「⋯ → 重置为自动」交还给自动规则。设置项「跑完自动移到完成」开启时,手动放进「进行中」的会话在这一轮结束后会自动落到「完成」。

「待办」支持新建(自由待办卡)

「待办」列底部常驻一条虚线 + 新建待办:点开变成输入框,回车添加、输入框保留(可以连着敲好几条),Esc 或失焦关闭。新建的卡片不属于任何会话,因此:

  • 卡片表面用 bg-layer-1(内凹感)与「会话卡」区分,元信息行是 ☑ 待办项 · 工作区 · 相对时间;
  • 点卡片 = 创建会话并执行这条待办(见下);改名走元信息行右端的 ✎ 按钮或 E 键或 ⋯ 菜单(因为单击已经是"执行"了);左下角勾选框 = 完成 → 卡片进「完成」,再取消勾选回到「待办」(列内顺序仍由稀疏 order 维护);
  • ⋯ / M 菜单是六列(去掉垃圾桶)+ 删除(自由卡片没有"重置为自动"的说法,它本来就是手动放置的);
  • 它们和会话卡一样能拖拽、批量选择、被搜索命中;但不受工作区过滤影响(无 cwd),也永远不会被"过期归档"或剪枝清掉(boardPrune 只清理会话来路不明的条目);
  • 垃圾桶「清空」时:自由卡片是看板自己的数据,直接删掉;只有会话走归档→回收站→物理删除那条链路(0.2.0 起先探测 dsh-archived-chats 是否可用:不可用时一个会话都不归档,只把卡片移出看板并如实提示,见「0.2.0-rc.2 兼容性修复(本轮)」的 B16)。

点一下 → 建会话并执行

点自由待办卡(或卡片右下的 ▶ 执行、或 ⋯ → 创建会话并执行)会:

  1. sessions.create({ cwd }) 建一个会话 —— cwd 用建卡时记下的工作区(建卡时落在 item.cwd:当时的面板工作区过滤,或当前打开会话的 cwd),所以卡片天然知道"这条待办该在哪干";
  2. 用产品自己的提交链路发首条消息:binding(id).session.beginSubmission({mode:'queue', text}) 先登记本地回显(新会话立刻显示 pending 消息),再 prompt([{type:'text', text}], 'queue', …, requestId);被拒时 abandon() 撤掉回显;
  3. 成功后撤掉这张自由卡片 —— 它已经变成一个真会话,会话卡会在「进行中」出现(不会重复显示两张卡);标题栏给一行提示「已创建会话并开始执行:…」;
  4. 失败则保留卡片并提示原因;如果只是首条消息没发出去(会话已建好),会自动帮你打开那个会话,手动发即可。

批量选择模式下点击仍然是勾选(不会误触发执行);▶ 执行 的创建期间卡片显示 data-busy 并忽略点击。

落在看板状态里的 items 字段({id: {title, done, at}},placement 仍在 entries 里,因此拖拽/排序逻辑完全复用)。payload 版本仍是 1,旧状态照样能解析。

交互

  • 拖拽:原生 HTML5 DnD;拖到列内会显示插入位置(2px 品牌色横线),目标列高亮描边(垃圾桶用 danger 色)。列内排序用稀疏 order(插入取中点,间隙收窄时自动重排)。
  • 键盘 / 触屏兜底:卡片可聚焦,Enter 打开会话,M 或卡片「⋯」打开「移到…」菜单(六列 + 重置为自动);Esc 先关已打开的菜单 / 「清空」确认,再按一次才关面板(不会一下把整个面板关掉)。
  • 从侧边栏拖入:dsh 侧栏的行拖拽 payload 就是 sessionId(实测 dataTransfer.getData("text/plain")),所以可以直接把侧边栏会话拖到某一列。
  • 点击卡片 = 弹窗预览会话内容(用户提问 + 助手回复的文本,最多 80 轮/次;数据来自会话事件窗口 sessions.using → binding.session.open() → eventSource.getSnapshot(),只读;<system-reminder> 这类注入的 user 消息会过滤掉);预览右上角「打开会话」才切换主视图并关闭面板(走产品的 ctx.uiWorkspace.openSession,旧的 sessions.open 在 0.2.x 并不导航);Esc 先关预览、再关菜单/面板。批量选择 模式下点击 = 勾选,工具栏出现批量条(六列 + 清除)。
  • 其他:搜索(标题/路径,也搜自由待办卡)、工作区下拉、含子会话 / 显示全部(分段控件)、列折叠(持久化,折叠后保留竖排列名)、待办列「新建待办」与**「归档过期」图标按钮**(时钟图标 + 计数,完整语义在 tooltip / aria-label:把超过窗口的待办一次性归档)、垃圾桶「清空」(两步确认)。
  • 标题右侧计数形如 共 108 个会话 · 3 条待办(有自由待办卡时才显示后半段)。
  • 卡片徽标:● 运行中、… 等待回复(最后一轮还没被回复)、⏱ N 个后台任务、☑ N 项待办(会话自己的 todo 未完成项)、⏳ 有排队消息、子会话、· 手动(只标记被手动固定的卡片——「自动」是默认态,不占位)。
  • 自由待办卡的「执行」(▶ 图标)会真的创建会话并消耗模型调用;只想记一笔就先别点,或在批量选择模式下点(= 勾选)。

排版(0.10.2 起)

  • 面板 1360×830(随视口收缩),六列等宽(每列 ≥160px:1360 板宽时 210px,约 1220 板宽时 187px),列间距 10px、圆角 14px,沿用产品弹层底色/描边/字号变量。160 这个下限是为了让六列在 ~1220px 的板上也铺满:原先的 196px 下限让六列最小要 1274px(6×196+5×10+2×24),板窄于它时最后一列会被板的圆角裁掉、并出现横向滚动条。
  • 卡片两行制:标题(13px/20px,最多 2 行,最小 2 行高 40px —— 同列卡片因此等高、meta 行对齐;代价是单行标题的卡多 20px 留白)→ 元信息行(工作区 · 相对时间 · · 手动);「⋯」是卡片右上角常显的菜单按钮(静止 0.7 透明度、命中区 24×24,hover / 键盘聚焦时提亮;原先是独占一行),菜单是浮层(position:absolute 展开在卡片下方,列底空间不足时自动翻到卡片上方,带 --dsw-elevation-prominent 阴影,打开不再把整列往下推)。垃圾桶里的「恢复」在元信息行右端;垃圾桶的卡不再标「· 手动」(那一列本来就只有手动卡),把宽度让给工作区和时间。卡片高度从 142px 降到 ~78px(带徽标的卡再高一层)。自由待办卡的元信息行只放「完成勾选 + 相对时间 + 执行/重命名两个图标」:它在 180–210px 的列里放不下「待办项」说明文字和工作区名(旧版把「待办项」挤成每行一个字的竖排、工作区只剩 3px),所以说明文字删掉(勾选语义由 checkbox + 标题删除线承担),工作区名移进「执行」按钮的 tooltip(在 <工作区> 创建会话并执行),元信息行强制单行不换行。看板上的标题会剥掉创建时间戳后缀(-YYYYMMDDHHmmss,侧栏与存储仍保留),否则在密集列里会吃掉大半标题宽度。
  • 长列按工作区分组 + 组内分页:组头是「工作区名 + 计数」,可点折叠 / 展开该组(aria-expanded 同步,折叠后只留组头、组内卡片和「显示更多」都收起),每组先渲染 20 张,紧跟该组卡片的是虚线「显示更多 <组名>(剩 N 个)」按钮(按钮归属它上面那一组);归档列里超过一页(20 张)的组默认折叠——归档是规则倾倒旧会话的地方,200+ 会话时它就是一面墙,小组合照常展开;折叠状态随看板状态持久化(state.folded,键是 列|工作区),展开过的组刷新后仍然展开。搜索 / 批量选择 / 只有单个工作区时不分组也不分页(要看到全部结果)。
  • 图标:面板里的控制图标(列折叠 ▾/▸、卡片 ⋯、重命名、执行、归档过期、新建待办)统一为产品同款的 16px / 1.2px 线性 SVG(BoardIcon),不再混用 emoji 字形;徽标文字里的语义符号(● … ⏱ ☑ ⏳)保留。
  • 顶部:计数移到标题行右侧;工具条按「筛选 | 视图 | 批量」用细分隔线分组,控件高度统一 32px。
  • 列容器与列头:六列都有可辨的列容器(浅色 1.08:1、深色 1.13:1)与列头底色;待办 / 进行中 / 完成三列带极轻语义色,搁置 / 归档 / 垃圾桶用中性底色(1.11–1.26:1);列计数徽标、底部提示与右上计数在浅色下均 ≥3:1。
  • 底部提示压成一行短句(拖拽跨列 · M 移动 · 垃圾桶「清空」需 dsh-archived-chats 才能真删),完整语义在 tooltip 里。

状态存放(设置 → 界面增强)

模式 说明
本浏览器(默认) localStorage["dsh-enhance-tool.board"],即时生效,无需重启
随 profile 保存 额外通过 GET/POST /enhancer/board 写入 ~/.dsh/profiles/web/enhancer-board.json(带 .bak,payload 形状校验,>256KB 返回 413)。写盘 debounce 800ms;打开面板时按 updatedAt 较新者胜(host 较新则采纳并回写 localStorage,反之推送 host)。该路由随 host 半边加载,需重启一次 dsh web 后才可用;未生效时自动只走 localStorage,不报错

已知限制 / 有意未做

  • 侧边栏行不显示所属列的小色点:侧栏 DOM 里没有任何会话 id 属性(实测只有 class/role/aria-*;id 只在拖拽 payload 里),按标题匹配太脆,故不做。
  • 不与 dsh-archived-chats 联动:那个插件自带 host 侧归档/回收站/保留策略与自己的路由,跨插件读它的内部状态很脆,且两套「真删」逻辑并存有风险;本看板的归档/垃圾桶只影响看板本身(面板底部有明确提示)。需要借它路由的例外只有「清空」链路:需要真删时会按需调用它的路由(0.2.0 起先做一次能力探测,不可用就不动手,见下)。另外,上文「看板归档时同时从侧栏收起会话」(默认关)走的是核心 workspaces.archiveSession / unarchiveSession,与这个插件的路由无关。
  • 垃圾桶的清空 = 真删尝试(两步确认):链路是「核心 workspaces.archiveSession 归档 → dsh-archived-chats 的 /delete-all 移入它的回收站 → /trash/purge 物理删除」,并带上它要求的 CSRF 头 x-dsh-archived-chats: 1;每个会话的失败原因会显示在垃圾桶列里(例如 persistence-response-invalid)。dsh 核心没有删除会话的 API(workspace/delete 删的是工作区登记,不是会话),所以真删只能借这个插件。0.2.0 起这条链路是"先探测后动手":不可用时立刻返回、一个会话都不归档,只把卡片移出看板并如实提示(dsh-archived-chats@1.4.5 在 0.2.0 上会被版本门禁跳过,探测必然不通过)。
  • 运行中的会话删不掉(2026-10-19):dsh 不允许归档还有运行中任务的会话(workspace/session-active),而插件只删已归档的会话,于是链路会以 session-not-archived 半失败——卡片被移出看板、会话还在,所以「还能恢复」。看板现在先查 summary.running:把这类会话直接标成 session-running,提示写人话(「会话还在运行:dsh 不允许归档/删除运行中的会话,等它跑完再清空」),并且不把归档/删除请求发出去;常见失败码也翻译成可读文案(session-live-purge-pending → 已停放、重启 dsh 后才真删;already-trashed → 已在插件回收站;trash-record-missing、persistence-response-invalid)。实测:运行中清空 → 未删除 1 个(会话还在运行…);等它跑完再清空 → 「已删除 1 个会话(数据已删,不可恢复)」,无恢复入口。
  • 归档调用每次都发(2026-10-19):核心 workspaces.archiveSession 对已归档 id 是幂等的(直接 resolve、不写盘),所以看板不再用客户端的 archivedSessionIds 快照去跳过归档——那个快照会过期(插件直接改注册表、客户端收不到事件),一过期就变成"看板以为已归档 → 跳过;插件看 host → 没归档 → session-not-archived",提示还只能说"通常是因为它还在运行"。现在归档失败的真实原因(session-running / session-missing / archive: <原文>)会覆盖那条笼统提示。
  • 两条契约(2026-10-19 修,1.5.2 实测):① /trash/purge 只读 sessionIds —— 旧实现发 ids 会被 400 sessionIds-required 拒掉,于是"清空"永远删不掉,会话只是被移进插件回收站(探测也用 {sessionIds:[]})。② /delete-all 对已经在它回收站里的会话回 already-trashed —— 这类 id 现在直接并入 purge 列表删一次,而不是记成"未删除";只有 purge 也失败才如实报失败。清空失败时,本来就处于归档状态的会话也会被记进 undo 并尝试取消归档,不再静默留在归档里(没有 undo 时用侧栏「全部对话(显示已归档)」或插件回收站放回)。
  • 注意(0.1.5 时代的旧记录):实测本机装的 dsh-archived-chats@1.1.0 在 dsh 0.1.5 上删不掉:它校验会话头必须 version === 2,而 0.1.5 写的是 version: 3,因此其 /delete-all 对任何会话都回 persistence-response-invalid(它自己的回收站/删除大概也是坏的,建议更新或反馈给该插件作者)。在它能用之前,清空的效果是:把卡片从看板移除(不再弹回待办/归档),会话本身仍在 dsh 里;垃圾桶列头上的「恢复显示 N」可以把它们放回看板。
  • 撤销归档:清空会先归档(归档 = 会话从侧栏消失),所以"归档了但没删掉"必须可逆 —— 看板把这类会话记在 state.undo 里,垃圾桶列头出现「撤销归档 N」,点击走 /unarchive-all 取消归档并把卡片放回看板;否则那些会话会一直不出现在侧栏。
  • 真删成功的会话不可恢复(2026-10-19):/trash/purge 真正删掉的会话数据已经没了,所以看板把它们的卡片和 id 从可恢复列表里移除(boardDrop)——不进「恢复显示 N」、也不进「撤销归档 N」,避免给一个不存在的会话造出"可恢复"的假承诺;提示写成「已删除 N 个会话(数据已删,不可恢复)」,关掉面板时清空(它是一次操作的结果,不是常驻计数器)。删除成功的 id 另记一枚墓碑(state.gone):冷会话被删不会触发会话列表事件,客户端的旧列表会滞后、卡片会按自动规则"弹回来",墓碑在这个窗口里把它压住,等列表不再提到它时由 boardPrune 清掉;空的列表快照(还没加载完)不参与剪枝,否则会把隐藏/撤销/墓碑误删。垃圾桶头的「恢复显示 N」也只数会话仍在列表里的隐藏卡片(隐藏 ≠ 删除:被真删、或列表已不再提的 id 不再计数)。反过来,只是移进垃圾桶、或清空时没删掉(失败 / 能力不可用 / 探测未确认)的会话,数据都还在,卡片留在隐藏/撤销列表里,可用「恢复显示」「撤销归档」放回——这两类必须在 UI 上分得清。

归档时同时从侧栏收起会话(设置 → 界面增强,默认关闭)

  • 默认关闭时,看板的「归档」列只是看板内的分诊状态:移动卡片不碰任何会话,与既有行为完全一致(零 archiveSession / unarchiveSession 调用)。
  • 开启后,手动把卡片移入「归档」列(拖拽 / 卡片「⋯」菜单 / 批量移动 / 待办列「归档过期」)会同时调用核心 workspaces.archiveSession,会话真的从侧栏(含工作区分组)消失;把卡片移出「归档」列时用核心 workspaces.unarchiveSession 恢复。不依赖 dsh-archived-chats(0.2.0 上它会被版本门禁跳过,且它管的是"真删"而不是看板分诊)。
  • “这是本功能收起的”标记就是看板状态里的手动落列(entries[id].manual === true && column === "archived"),随看板状态持久化,所以刷新之后拖出「归档」列仍然能恢复;核心取消归档对没被归档的 id 是幂等空操作,标记过时最多多一次无害调用。
  • 安全阀(只有手动动作会触发):规则自动归类永不触发——按窗口自动落进「归档」、跑完自动落到「完成」都只改看板状态,不碰会话。代码级断言在 tools/board-logic-test.mjs:自动落列/状态函数(boardView / boardAutoColumn / boardMove / boardWatchRunning / boardPrune …)里不许出现 boardSidebarAction、两个 owner 或 archiveSession,且这两个 owner 只能在 BoardDialog 的手动处理函数里被调用。
  • 失败可见:归档/恢复失败会写进看板标题栏的提示(.enhc-board-note),不静默吞掉——例如会话正在跑(Host 回 workspace/session-active;本功能不会替你 stopActivity 杀掉正在跑的回合)、核心 API 不可用、恢复失败;批量场景的提示形如「已从侧栏收起 N 个会话,拖出「归档」列即可恢复」。
  • 被收起的会话在侧栏的真实入口(已按产品文案核对):侧栏「筛选会话」→「全部对话(显示已归档)」;只显示归档里那些选「仅显示已归档」。归档中的对话取消归档之前打不开(产品提示 已归档对话暂时无法查看,请取消归档后查看),所以「拖出『归档』列」才是主恢复路径。
  • ⚠️ 关闭开关不会自动放回已经收起的会话(关闭 = 一次调用都不发,与旧行为完全一致):要放回,请在开关还开着时把卡片移出「归档」列,或用上面那个侧栏入口手动取消归档;建议先把卡片移出「归档」列,再关闭本开关。

5. 上下文面板

入口:「轨迹」与「看板」之间的 pill「上下文」(与看板入口同一套 token、同一显隐开关)。会话未打开时头部没有 tab 条,入口也就不出现。

面板(点入口打开,Esc / 遮罩 / ✕ 关闭):

  • 顶部:会话标题 + 「上下文已用 N%」 + ~已用 / 窗口(如 ~261k / 1.0M);
  • 组成行:系统提示词 / 工具定义 / 对话消息 各自的 token 数(色点区分);「系统提示词」整行可点,直接跳到系统提示词页签;
  • 两个页签:上下文内容(默认)与 系统提示词;
  • 上下文内容:用户消息、助手回复与压缩摘要,<system-reminder> 这类注入消息过滤掉;压缩后按当前可见 surface 显示——被压缩替换掉的旧消息隐藏,摘要落在它实际替换的位置上(会话日志与「轨迹」仍保留完整历史);
  • 系统提示词:单独、完整地显示系统提示(不混在对话内容里,最多 200k 字符)。长会话的系统提示在日志最开头、尾页窗口里通常没有,第一次切到这个页签时会自动向前翻页(每轮最多 12 页)直到找到;找不到时显示「加载更早历史」按钮继续,翻到会话开头仍没有则如实提示;
  • 底部两个动作。

实时刷新:面板打开期间订阅会话的 eventSource 与 contextPressure / contextBreakdown 两个投影(160ms 合并),所以对话在跑、或压缩完成时,百分比、组成和内容都会自动更新,不需要关掉重开。

「压缩」:直接调用产品的宿主命令 binding.session.command("/compact")(agent 忙时宿主会拒绝,面板底部如实显示)。发起后面板进入「压缩中…」,并按会话日志里的 command/run + command/done 等待真实结果:成功显示「压缩完成,上下文已更新」;没有可压缩历史时显示「没有可压缩的历史」(这种成功不会产生任何 compaction 事件);失败显示宿主返回的错误文本;3 分钟仍无结果则恢复按钮并提示结果会出现在对话里。压缩摘要同时以 flow node 出现在对话里。

「编辑上下文」:把当前会话内容(系统提示词不参与)渲染成可编辑文本([你] / [助手] / [压缩摘要] 前缀),改完点**「发送」把文本作为新消息发进会话——它真正进入上下文**;要替换旧历史而不是追加,再点一次「压缩」。

数据来源与坑(0.2.0 实测):用量/组成从会话自己的投影 store 读(binding.session.projections.faceOf("contextPressure" | "contextBreakdown").getSnapshot())——列表 summary 的 projectionValues 只带列表种子(title/turnOutline/todos/inbox 等),拿不到这两个;contextPressure 给的是 projectedTokens / pressureTokens / contextWindow(没有 surfaceTokens),contextBreakdown 的值直接是 {systemTokens, toolsTokens, messageTokens}(没有再包一层 breakdown)——两处都做了兜底。内容列表覆盖事件窗口(最多显示 80 条),「系统提示词」页签最多显示 8 条;压缩替换由 compaction/summary.shadowedSeqs 与替换消息的 surfaceOp 共同确定,面板按 surface 位置(不是 seq 顺序)还原,所以摘要会出现在它实际所在的位置。

5.1 系统提示词(新会话 / 按工作区)

左侧栏「工作区」上方的「默认提示词」入口维护新会话的 system prompt;它不放在按会话打开的「上下文」面板里。

  • 作用域:全局默认 + 每个工作区覆盖;有工作区覆盖时优先用工作区,否则回退全局;
  • 存储:profile 的 enhancer-system-prompt.json,结构 { global: {text,updatedAt}, workspaces: { [cwd]: {text,updatedAt} } };由 host 路由 GET|POST /enhancer/system-prompt 读写,POST 可带 workspace;
  • 替换:host 在 system-prompt/assemble waterfall 中把 assembly.sections 整体替换为命中作用域的文本;工具定义与运行时上下文仍由产品提供,不会被删;
  • 生效范围:只替换尚未开始第一轮对话的会话(按日志里第一条 user/message 的时间与命中作用的 updatedAt 比较);已有用户消息的会话不变;
  • 工作区留空保存 = 删除该工作区覆盖并回退全局;全局留空保存 = 恢复产品默认系统提示词。

6. 会话分享(图片)

会话头部最右侧的「分享」按钮进入选择模式,把选中的轮次一键生成图片并写入剪贴板:

  • 选择粒度是内容块:每条用户消息、每段助手正文各自一个勾选;想「去掉」某段内容,只要取消对应勾选。思考过程、工具调用、复制 / 分叉等交互控件不会出现。
  • 进入后每段内容上方出现勾选胶囊(默认全选):用户块显示 你 · 时间 · 预览,助手块显示 AI · 预览,点一下切换;底部浮动条显示「已选 N / M 段」并支持 全选 / 清空 / 复制图片 / 退出(Esc 也可退出)。
  • 复制图片:把所选轮次渲染成一张 PNG 后直接写入剪贴板;成功时退出选择模式并提示「已复制图片到剪贴板」。
  • 图片内容:会话标题、轮次数与时间范围、只渲染勾选的内容块(按轮次分组、保持原 DOM 顺序)、未选轮次的「省略 N 轮」分隔、页脚;表格 / 代码块 / 列表 / 引用 / 内联图片按页面样式保留。
  • 失败可恢复:剪贴板被浏览器拒绝(未聚焦、权限、非安全上下文)时弹出预览对话框,可重试复制或下载 PNG,不会丢图。
  • 尺寸兜底:宽度 760 CSS px、默认 2x 输出;内容过长自动降采样,超过画布上限(16000px)时提示减少内容,不生成半张图;一次最多 120 段内容。
  • 长图不截断:页脚后放一条整宽结束标记,按它在 SVG 栅格里的实际位置裁剪;SVG 中表格 / 容器布局比活 DOM 更高时自动扩大渲染视口重试,底部内容与页脚不会丢。
  • 主题跟随:图片颜色取自当前页面主题变量,浅色 / 深色主题下都与界面一致。
  • 设置 → 界面增强 → 会话分享(图片) 可隐藏头部按钮(默认显示)。

实现要点:图片不是截图,而是克隆产品 DOM + 回放页面 CSS,通过 SVG foreignObject 光栅化到 Canvas —— 表格、代码块、语法高亮直接沿用产品样式,不需要 Markdown 渲染器或新依赖。SVG 图片是不透明源,因此复制 CSS 前会清掉所有非 data: URL(否则 Canvas 被污染、toBlob() 抛错),DOM 中的图片会转成 data: URL 内联,跨域 / 不支持的类型跳过;ClipboardItem 在点击的瞬时激活内创建(先传 Promise<Blob>,随后再渲染),避免长渲染丢掉用户手势。

已知边界:用户消息的附件卡片(文件 / 图片缩略图)不进入图片,只分享消息气泡文本;KaTeX 数学公式使用系统字体回退(不内联 KaTeX 字体),复杂公式可能与页面略有差异;剪贴板只写 PNG,浏览器不支持 ClipboardItem 时走下载兜底。

7. 注入控件与面板沿用 dsh 默认样式(不自带皮肤/容器外观)

按钮

  • composer 工具栏的「提示词库 / 润色」按钮、建议条候选按钮,挂载后从活的 DOM 读取相邻产品控件的类名并复制到自己身上(adoptProductButtonStyle):工具按钮取同排的 指令 / 添加附件,建议条取 composer 里的文字 pill(如「完全权限」)。外观与产品逐像素一致,产品改样式自动跟随,类名是从 DOM 读的、不写死哈希。

面板(弹层 / 对话框)

  • 产品自己的弹层/对话框只在打开时存在,所以用一个被动学习的登记表(rememberProductStyles,rAF 节流的 MutationObserver):一旦屏幕上出现过 [role=menu] / [role=menuitem] / [role=dialog] / 对话框里的导航行,就把它们的类名记下来。提示词库弹层、润色小面板借产品的 menu(background:--dsw-specific-menu、20px 圆角、--dsw-elevation-prominent 阴影、4px 内边距),管理对话框借产品的设置面板(32px 圆角 + 同款阴影),列表行借 menu cell / 对话框 navCell(40px、10/12px 圆角、hover 用 --dsw-alias-interactive-bg-hover)。
  • 学习失败时(用户还没打开过任何产品弹层、或产品改了类名)由 :where() 包裹的零优先级回退兜底,取值全部照抄产品规则体(含 token)——实测回退与产品数值完全一致,所以不存在“没学到就难看”的窗口。
  • 我们自己的行因为要放两行内容(标题 + 摘要),用双类名(.PmptLb_item.PmptLb_item)提高优先级来放宽产品行的固定高度、并 flex:0 0 auto 防止被列表压缩;选中态同理(.PmptLb_manageRowActive.PmptLb_manageRowActive)以免被借来的类名盖掉。

面板排版(0.9.3)

  • 润色弹窗:提示文案(12px 次级色)→ 自定义要求输入框 → 右侧动作行[按要求润色][默认润色];主按钮用产品 composer 发送键的 --dsw-alias-button-info-fill(蓝色),去掉原来的分隔线与整行按钮。
  • 提示词管理:左侧 236px 导航列(搜索 + 分组筛选 + 两行行项:标题 + 分组胶囊 + 摘要,删除按钮常驻右侧、不挤压标题)+ .5px 分隔线;右侧表单列固定 520px 宽、字段带 12px 标签(标题 / 分组(可选)/ 提示词内容)、8 行文本域;底部动作行以 .5px 上边线隔开,左侧「润色提示词」、右侧「取消 / 保存」(保存为蓝色主按钮)。
  • 弹层/对话框层级:管理对话框 z-index: 1200,高于润色/提示词库弹层(1100),避免弹窗叠在对话框之上。
  • 新增类名必须同时加进 PromptTools_module_css_default 映射表(lib/client.js 里那张手写表),否则 className 是 undefined、样式静默不生效。

8. UI 修复

  • hero 菜单 overlay 修复:下拉菜单覆盖输入框时自动限高滚动(不影响模型选择等短菜单)

兼容性与已知问题(重要,安装前必读)

版本锁定声明

本插件的 布局增强(AI 消息无背景、用户气泡自适应、长消息折叠、面板让位、宽度设置)通过运行时 CSS 注入实现。用户消息相关选择器已改为哈希无关的后缀匹配([class*=_userStack] / [class*=_bubble] / [class*=_bubble] div),因此不受 dsh 0.1.2 把用户气泡从 dsh-client-ui-conversation 迁到 dsh-client-ui-chat(哈希前缀 gdEzaW_* → Sixlwa_*)的影响;其余布局选择器仍依赖 dsh 客户端 bundle 的 CSS-in-JS 哈希类名(wSkVaW_* / pXSMma_*)。这些类名随 dsh 每次构建可能变化。

  • 实测版本:0.2.0-rc.2(2026-09 全量审计:宿主 A1–A6 + 客户端 B1–B16 + 打包 C1–C4 共 26 项 + 2 个假设,原始证据见 reports/compat-0.2.0/REPORT.md);此前实测版本为 0.1.0-rc.7、0.1.1-rc.2、0.1.2-rc.1、0.1.5-rc.2
  • 支持版本:dsh >=0.2.1-rc.1 <0.3.0(见 package.json 的 engines.dsh / peerDependencies);0.20.2 的提示词插入修复已在活体客户端 0.2.2-rc.1 上验证(既有草稿保留 + 换行追加)
  • 0.2.0 的实际情况(修正旧说法,别再按"哈希漂移"排查):wSkVaW_* / pXSMma_* 在 0.2.0 仍然存在(0.2.0 头部实测 [class$="_tabs"]=1 且类名就是 wSkVaW_tabs;插件代码里这两个前缀分别仍有 13 / 1 处引用),hero 布局与头部 tab 条照常命中。本轮真正静默失效的是 D1 / D2 / D3 三条(会话判据、宽度变量名、消息时间节点层级),与哈希前缀无关——详见下方「0.2.0-rc.2 兼容性修复(本轮)」。VOzbGW_* / nArs4W_* 插件已 0 引用(旧文档提到它们属清理前的记录)
  • 布局增强失效表现:安装后 AI/用户消息样式无变化(无错误提示,功能静默不生效)
  • 处理方式:布局失效时,其余功能(润色 / 提示词库 / 建议条 / 标题 / 消息工具条 / 工具耗时)不受影响;请提交 issue 附上你的 dsh 版本与 document.querySelector('*[class]').className 中对应的消息区类名前缀,我们会更新注入选择器。

其他已知问题

0.2.0-rc.2 引入、本轮已修(机制与复验证据见下方「0.2.0-rc.2 兼容性修复(本轮)」)

  • D1 当前会话判据(已修):0.2.0 的会话列表快照 SessionListState 已没有 current 字段(只剩 ids / byId / phase / projectionsBySession),插件原先读 sessions.list.getSnapshot().current → 恒 undefined → 事件窗口永不订阅,于是建议条不渲染、工具调用耗时全为 0、看板当前会话卡不高亮(同一个根因)。现改为 resolveCurrentSessionId():优先用 slot 给的显式 sessionId,否则取 byId 里 retainedBy.mainView > 0 的那个,老版 .current 仅作回退。
  • D2 对话内容宽度滑块无效(已修):插件原来写 --dsh-user-chat-width,0.2.0 里没有消费者;而 --dsh-chat-content-width 会被 .wSkVaW_body 自身声明的 clamp(…) 覆盖 → 消息列宽恒 ~742px。现改写产品真旋钮 --dsh-chat-user-width(--dsh-user-chat-width 保留作 0.1.x 回退),字号三项未动。
  • D3 消息工具条常显失效(已修):0.2.0 把每条消息的 END 时钟包进 span._endInfo,它不再是 _actions 的直接子元素 → CSS :has(> [class*=_timeEnd]) 与 JS clock.parentElement 双路失配(不悬浮时助手消息行仍 opacity:0)。CSS 改为后代匹配 :has([class*=_timeEnd]),JS 改为 clock.closest("[class*=_actions]")。

0.1.x 时代的问题(保留原记录)

  • dsh 0.1.1-rc.2 的 modlens 适配器缺少 prepareCall:插件启动时自动为缺失的适配器补丁(包装 stream 实现),使 /polish、/suggest、标题生成直接使用用户会话选择的模型;若补丁不可用则自动 fallback 到内置 deepseek-official。(0.2.0 现状:LlmAdapter 基类已自带具体 prepareCall(dsh-llm/lib/index.js:1734,只有 stream 是 abstract),所以补丁在这条路径上必然是 no-op——不是坏了,而是不再需要;因此启动日志里不会出现 patched prepareCall onto adapter,别用它判断插件是否加载。)
  • dsh 0.1.5 输入框改成 Lexical contenteditable(页面里已无 <textarea>):composer 不再有 textarea,因此「润色」与「提示词库插入」原先读 composerTextarea().value 会拿到空串(潦色直接不动、库插入丢失已有草稿)。现改为从 slot 的 useInput((state) => state.draft) 读草稿、用 inputActions.setDraft(text) 写回——这是能到达 Lexical 内部状态的唯一写入口;DOM textarea 仅作老版本回退(composerDraft / setComposerDraft / focusComposer 三个小助手)。
  • dsh 0.1.5 的 dock slot session 只带生命周期字段(无 nodes):预测回复原先用 session.nodes 找最后一条 AI 回复,所以 lastText 恒为空、整个建议条不渲染(表现为“功能消失”)。现改为从 Session 事件窗口取最后一条 assistant/message 的 text 块(suggestTextFeed 共享馈送),session.nodes 路径仅作回退。
  • 建议条点击行为读错了 localStorage key:useDraft 读的是旧版 harness-ui-enhancer.state(迁移时已经被删掉),所以“仅填入”设置被忽略、永远直接发送。现改读 dsh-enhance-tool.state(旧 key 作为回退)。
  • dsh 0.1.5 的 conversation.input.left props 用 sessionId 而不是 session:润色与库内润色现在优先传 sessionId,让 /polish 用会话自己的模型路由,session?.sessionId 仅作回退。
  • dsh 0.1.2 起 web 端需要认证:直接访问 http://127.0.0.1:3080/ 会返回 401,请使用启动日志中打印的 http://127.0.0.1:3080/?token=...(换取 cookie 后即可正常访问)。
  • dsh 0.1.2 的用户气泡结构变化:文本由块级 div 改为内联 span,折叠逻辑改为裁剪气泡本体(高度 = 5 行 + 气泡内边距),展开按钮挂在气泡外的 userStack 上以免被 overflow:hidden 裁掉。
  • 消息工具条常显(29-msgmeta):不新增 DOM,直接复用产品自身的消息工具条(*_actions 行:时钟 *_timeStart / *_timeEnd、复制 / 分叉、用量 / 耗时),时间随产品本地化格式(当天 HH:mm,跨天 M月D日 HH:mm)。产品在 @media (hover:hover) 下把整行设为 opacity:0(仅 hover / 最近一条时才显示),本插件做两层保证:
    1. CSS:两条独立的 :has() 选择器强制该行可见(不用 :is(:has()) 嵌套,部分引擎对嵌套支持不完整)——用户行的 _timeStart 是 _actions 的直接子元素,用 :has(> [class*=_timeStart]);助手行的 END 时钟在 0.2.0 被包进 span._endInfo,改用后代匹配 :has([class*=_timeEnd])(见上方 D3)。两者都不依赖任何哈希类名前缀。
    2. JS 传保险:一个 rAF 节流的 MutationObserver 给时钟行加内联 opacity:1!important——内联 !important 胜过任何样式表规则,即使产品改了 hover 规则、其它插件注入更强的 opacity:0!important、或浏览器 :has() 异常,工具条也不会再被 hover 挡住(已用“注入 opacity:0!important 敌意规则”的方式实测)。关闭开关或插件卸载时会移除内联样式。 产品本身的隐藏规则只作用在整行上(单个按钮没有 opacity 规则),所以强制该行可见就能同时露出时间与全部按钮。若某个 dsh 版本没有渲染该工具条,此开关静默无效果。
  • 工具调用耗时(30-calldur):数据来自 Session 事件窗口,不靠观察计时:
    • 根调用:tool/call(data.callId)→ 开始,tool/result(data.message.source.callId)→ 结束。
    • 子工具(PTC 子调用):tool/ptc-dispatch-start(data.subCallId)→ 开始,tool/ptc-dispatch → 结束。
    • 事件窗口通过 ctx.inject(["sessions"], …) 取(sessions.binding(id).eventSource)——用 ctx.inject 而不是写进 inject 数组,依赖缺失时插件照常加载、只是不显示耗时;同时订阅 sessions.list 跟踪会话切换、订阅 eventSource 跟踪新事件。
    • 行定位靠转录里的 [data-chat-call-id](子调用就是 <rootCallId>:ptc:<n>,与事件里的 subCallId 完全一致);只有开始没有结束 = 进行中 → 500ms 定时器实时刷新,结果事件落地后自动定型。
    • 工具卡片有三种渲染形态([data-disclosure-row] / role=button[aria-expanded] / 无 body 的 bash 行),host 元素按此顺序回退,最后一档用标题 / 摘要 span 的父元素,所以三种形态都能挂上耗时。
    • DOM 扫描用 rAF 节流(与长消息折叠同一套思路);开关关闭或插件卸载时删除 chip 并停掉定时器。窗口外的历史行(hasMore 截断)没有数据,不显示耗时。
  • 会话标题 provider 需要 @deepseek-ai/dsh-session-title-llm(install.sh 自动链接)。

0.2.0-rc.2 兼容性修复(本轮)

2026-09 对 dsh 0.2.0-rc.2 做了一次只读全量审计(26 项 + 2 个假设),并把其中用户可见的失效修完、用实浏览器复验。审计与复核报告在 reports/compat-0.2.0/(REPORT.md 判定表、verification.md 反证、fix-verification.md 修复后实测 + 17 张截图)。

客户端 4 处静默失效 + 1 组死规则:

# 原来为什么坏(0.2.0 的机制) 现在怎么修 复验
D1 建议条 / 工具耗时 / 看板当前会话高亮 会话列表快照没有 current → 当前会话判据恒 null → 事件窗口永不订阅(建议条 return null、.enhc-call-dur 恒 0、[data-current] 恒 0) 新增 resolveCurrentSessionId(sessions, explicit)(显式 slot id → byId 中 retainedBy.mainView > 0 → 老版 .current 回退),三处调用点全部改走它 36/36 调用行有真实耗时 chip(改前恒 0);42 张卡中 1 张 [data-current] 且正是当前会话;dock 出现 .Sggst_root + 3 条真实候选
D2 对话内容宽度滑块无效 写的是 0.2.0 无消费者的 --dsh-user-chat-width,而 --dsh-chat-content-width 被 .wSkVaW_body 自己的 clamp(…) 覆盖 → 列宽恒 ~742px 改写产品真旋钮 --dsh-chat-user-width(旧名仅作 0.1.x 回退);字号三项未动 消息列宽 748px → 1089px,page.reload() 后仍 1089px;字号 14→18px 不回归
D3 消息工具条常显失效 END 时钟被包进 span._endInfo,不再是 _actions 直接子元素 → CSS :has(>…) 与 JS parentElement 双路失配 CSS 改后代匹配 :has([class*=_timeEnd]);JS 改 closest("[class*=_actions]") 12/12 _actions 行 computed opacity=1(鼠标不在消息上),其中 9 行正是旧的失配情形
B16 垃圾桶「清空」语义(外部依赖被跳过) 原链路「先归档 → /delete-all → /trash/purge」在 dsh-archived-chats 被 0.2.0 门禁跳过时,前两步已经把会话归档掉;失败文案也与实际不符 改为先探测后动手:开板时对该路由发一次空 id 列表 POST 判定能力,不可用就一个会话都不碰、只移出看板并如实提示;真删中途发现路由已死则降级缓存;恢复改用核心 workspaces.unarchiveSession 垃圾桶列头的 ⓘ 图标(完整说明在 tooltip)表示「真删不可用:未加载 dsh-archived-chats」;开板仅 1 次空 id 探测 POST、0 次归档请求
P2 三条死规则 [data-slot="conversation.session.header"]>header(+:after) 方向反了(0.2.0 的 header 是 slot 的父元素,实测 header:has(>…) 才命中)、[class*=_userStack] [class*=_userRow] 层级反了(真实是 userRow > userStack)、fillSectionTitle 依赖「通用」分区已不存在的 p[class$=_intro] → 三处静默 return 删掉两条 0 命中规则(留恢复条件注释,不强行反向以免引入未验证的布局副作用);fillSectionTitle 去掉 intro 硬前置,改为「产品自有 h1/h2/h3 或本插件页头 → 不注入」 设置页五个分区无重复标题、13 个 slot 子元素 / 3 个滑块完好;看板入口三页签位置不变

打包与安装侧(同轮):

  • C1 版本门禁:package.json 现在显式声明 "@deepseek-ai/dsh": "^0.2.0-rc.2"。dsh 0.2.0 会按 peerDependencies 跳过版本不匹配的 bundle(dsh-app-boot 的 evaluatePluginCompatibility);此前是"零声明 → 门禁完全不检查"的幸运通过。新声明已用真实门禁函数求值确认在 0.2.0-rc.2 上判定为兼容(不会被跳过)。
  • C2 失真声明:dsh.client.inject 由 5 项清理为 3 项(-ui-settings / -locale / -ui-conversation)——删掉 0.2.0 全树都不存在的 @deepseek-ai/dsh-client-runtime,以及存在但已无 dsh.client 声明的 -ui-slots。
  • install.sh:版本前提不再写死(直接读 package.json 的 peerDependencies),并在写入前用 dsh 自己的门禁做前置检查(读取 profile 的 compatibility.json 豁免、不匹配时给出可行动报错并以非 0 退出);bash install.sh --check 只读干跑(--help 里有退出码说明)。第二轮打包复查后补齐:全局 dsh 解析优先取 PATH 上那份 dsh(标准 nvm 布局下旧写法按 glob 字典序取到最老的 node 版本 → 误拒),无 node 时前置报错而不是死在 行 325: node: 未找到命令,dsh plugin add 失败时打印诊断并依次退到 github 目标与自包含拷贝安装(拷文件 + 写 dsh.profile.bundles,失败则回滚并 exit 1),新增 --copy 与 --uninstall。

仍未闭合(UNKNOWN / 按设计接受,不要当已修)

  • B6 自由待办卡的「执行」功能链路:4 个 API 签名一致,但未授权真的建会话执行 → 功能 UNKNOWN(点 ▶ 执行 会消耗模型调用)。
  • B13 hero 菜单限高:按设计退让(产品自带 ≈视口高度的 max-height 时主动让位),锚点回退命中 [data-composer-input];用户可见目标未达成(菜单仍会压住 composer)。
  • B16 端到端:只读面 PASS(文案 + 探测请求),但按钮级语义未渲染(垃圾桶为空)、破坏性拖拽未做 → PARTIAL;dsh-archived-chats 仍是外部依赖。
  • B7 hero 布局效果:前缀确实还在(见上),但最初那条证据测的是产品自身的 hWmORq_root,不足以证明 hero 规则的用户可见效果 → 未验。
  • D1 的 data-live 子项(进行中调用实时计时):80 次钉底采样未捕捉到运行态行 → PARTIAL(chip 本身已 PASS,代码侧 data-live 与 500ms ticker 存在)。
  • A1 的 400 文案分支:本机 profile 配了默认模型,该分支不可达 → UNKNOWN(自检里已注明前提)。
  • 0.1.x 真机回归:本轮无 0.1.x 运行时,未跑 → 未验(0.1.x 也不在当前 peerDependencies 声明范围内)。

0.1.5 API 漂移体检(2026-09 实测)

本节是 0.1.5 时代的历史记录(保留原始结论与证据);0.2.0-rc.2 的同类体检见上方「0.2.0-rc.2 兼容性修复(本轮)」。

插件大量依赖产品内部结构。以 dsh 0.1.5-rc.2 为基准,对每一处依赖都做了“选择器/服务是否还命中”的实测,结论如下。

有效(无需改动)

类别 命中项
slot conversation.input.left / conversation.input.dock / settings.general.item / shell.overlay / sidebar.footer.action 全部照常挂载;hero 三个 slot 也存在
布局类名 wSkVaW_root / _scrollBody / _composerSeat / _titleCluster(标签页搬运生效)、hero 的 wSkVaW_composerHero / pXSMma_root / div[data-phase=hero]
后缀类名 _add _bubble _composerSeat _crumbCurrent _iconButton _logoRow _newSession _primary _sectionHeader _tabs _time _title _titleRow _trigger _viewArea
产品属性 [role=menu]、[data-chat-call-id]、[data-disclosure-row]、[data-composer-input]、[data-composer-card]、[data-conversation-scroll]、[data-input-scroll]、各 [data-slot=…]
host 侧 ctx.webServer/fs/jobs/agents/subagents/sessionTitle/llm/sessions 及所用方法均在;/enhancer/enhancer-api(mcp/list、jobs/list、tasks/list)、/polish、/suggest、/prompt-library 均 200

本次修好的漂移

症状 原因(实测证据) 修法
侧边栏「新建会话」文字宽度不随字号缩放 [class$=_newSessionLabel] 命中 0,产品现在在类名后还挂 hHd-Xa_wide 等([class*=] 命中) 改为 [class*=_newSessionLabel](实测 max-width 200px → 286px 随 scale 生效)
侧边栏品牌 lockup(鲸鱼 + deepseek HARNESS)随字号缩放 0.1.5 把它拆成两个 svg(mark 24×18 + wordmark 156×24)挂在 [class*=_brandIdentity] 下;旧规则「给 _brand 下的 svg 定死 182×24」一旦改成 [class*=] 就会把 wordmark 压成 26px(文字变小),用 zoom 放大又会被侧栏宽度裁切 撤销品牌缩放:产品自己拥有该 lockup 的尺寸(老版本的单 svg lockup 规则仍按后缀匹配保留)。其余侧栏元素(新建会话、设置触发器、图标按钮、工作区列表)仍随 工作区字号 缩放
面包屑宽度限制失效 [class$=_crumb] 命中 0 / [class*=] 命中 3 button[class*=_crumb]
设置滑块自定义外观失效 滑块类名已变为无哈希的 uitw-slider input[type=range][class*=uitw-slider](实测 appearance:none、height:4px)
hero 菜单限高修复完全不执行 锚点 …composer.bar textarea 在 0.1.5 已不存在(输入框是 Lexical contenteditable) 锚点回退链 textarea → [data-composer-input] → [data-composer-card](实测效果已执行;0.1.5 菜单自带≈视口高度的 max-height,按原设计会主动让位——强行限高只会让菜单变矮却仍压住输入框,故保留让位语义)

已删除的死代码(2026-09 清理)

以下样式与逻辑都做了“命中数 0 + 产品与所有已装插件里都不存在该类名/变量”的双重确认后删除,删完复测功能与布局无变化:

删除项 依据
.nArs4W_panel / .nArs4W_bottomPanel 相关的 JS 效应(alignPanel、syncBottomPanel)与 --dsh-bottom-panel-height 两条 CSS 类名与变量在产品内全库搜索为 0(仅插件自己引用);面板让位/底部留白由产品自身处理
.W-zNGW_*、.dsx-stats-*、--dsx-rail-w 及相关 syncToggleStates 效应 属于“统计/工作台侧栏”类插件,未安装且产品无此类名
[class$=_toggleButton] _toggleCluster [class$=_badge] _badgeCount 电源按钮/统计插件内部类名,当前 UI 命中 0
[class$=_versionPicker] select*(4 条) 设置页已无 _versionPicker 也无任何 <select>(命中 0)
.dsh_notification_title/subtitle/heading 皮肤 插件市场/设置页命中 0
html #root{margin-right:0}、…>div:nth-child(2){margin-bottom:0}、_viewArea/_composerSeat 的 margin-right:0 覆盖 实测“启用 vs 禁用插件样式表”四项计算值完全相同(都是 0px),即全是空操作

清理后插件样式表规则数 156 → 127,lib/client.js 约 -6.3 KB。

保留(仍有用,不算死代码):textarea 老版本回退路径、fillSectionTitle(0.1.5 的 Agent 预设页仍有 p[class$=_intro],逻辑可命中)、.enhc-* 自身类名。


已移除的功能:MCP 服务器管理、定时自动化(0.9.0)

这两个面板曾经由本插件提供(侧栏底部的「MCP」「自动化」入口 + POST /enhancer/enhancer-api 路由 + enhancer-tasks.json / profile cordis.patch.yml 写入)。0.9.0 起整体移除,原因:

  • 它们属于 harness 的能力,不属于「界面增强」;dsh 自身提供 MCP 客户端运行时(dsh-mcp-client)与 profile patch 层机制,MCP 服务器可以直接写进 ~/.dsh/profiles/web/cordis.patch.yml(dsh 会热应用)。
  • 0.1.5 的 ctx.fs 实施 workspace-write 沙箱,profile 下的文件写入被拒,这两个面板的保存路径在实现上先天不可靠。
  • 移除前的实现、体检结论与回归测试都保留在 git 历史里:git show 845f415:lib/index.js、git log --oneline -- lib/index.js。

移除后的自检对照:侧栏底部不再出现「MCP / 自动化」(只剩 dsh 自带的「设置」与第三方插件的「电源」);/enhancer/enhancer-api 路由不再注册;插件 host 半边只保留 /polish、/suggest、/prompt-library 路由、适配器 prepareCall 补丁与标题 provider。


安装后自检

# 0. 安装前:只读干跑(检查 profile / 全局 dsh / 版本门禁 / 依赖 / 源码语法,不安装任何东西)
bash install.sh --check        # 期望 exit 0,末行 "nothing was installed (--check)"

# 1. 插件会被加载(全部只读,不碰 profile)
grep -n 'dsh-enhance-tool' ~/.dsh/profiles/web/package.json      # dsh.profile.bundles 里有它
node -e "console.log(require(process.env.HOME+'/.dsh/profiles/web/node_modules/dsh-enhance-tool/package.json').version)"   # 期望 0.20.0
grep -c 'skipping profile bundle "dsh-enhance-tool"' <启动日志>   # 期望 0,即没被版本门禁跳过
# 注意:别用 `grep "patched prepareCall"` 判断——0.2.0 的 LlmAdapter 基类已自带 prepareCall,
#       补丁必然跳过,那条日志不会出现(此时插件仍可能完全正常)。
# 可选(更强,但会按设计重写 profile 根文件 cordis.yml——固定模板、幂等,介意就别跑):
#   dsh --profile web --dump-config | grep -A1 'id: ui-enhancer'   # 期望 - id: ui-enhancer / name: dsh-enhance-tool

# 2. 润色 API 可用
curl -s -X POST http://127.0.0.1:3080/polish -H "content-type: application/json" -d '{"text":"测试"}'
# 期望 A(profile 未选默认模型): HTTP 400 {"ok":false,"error":"no model route configured: open a session and pick a model first"}
# 期望 B(profile 配了默认模型,如本机 agent-default-model = deepseek-official/deepseek-flash):
#          HTTP 200 {"ok":true,"text":"…"} —— 两种都算通过。
# 需要认证时:curl -s -c /tmp/jar "http://127.0.0.1:3080/?token=<启动日志里的 token>",之后请求加 -b /tmp/jar

# 3. 浏览器(Ctrl+Shift+R 硬刷新):composer 工具栏出现 提示词库 / 润色 按钮;消息右侧常显时间与工具耗时;
#    打开有消息的会话后,输入框上方出现建议条(0.2.0 上这三项依赖本轮 D1/D2/D3 修复);
#    会话头部最右侧出现「分享」按钮:进入选择模式 → 点「复制图片」→ 剪贴板里应是一张 PNG

开发

插件本体就是仓库根目录(旧文档写的"插件本体在 dsh-enhance-tool/"指的不是这个仓库的嵌套目录):

.
├── package.json          # dsh.bundle.patch 声明(自动挂载)+ dsh.client.inject、peerDependencies 门禁
├── cordis.patch.yml      # 插件挂载 + 禁用官方 session-title-llm
├── lib/
│   ├── index.js          # host 侧:路由 / 定时器 / 标题 provider / 适配器补丁
│   ├── client.js         # client 侧:全部 UI 组件 + 注入样式(构建产物)
│   └── polish-routes.js  # /polish /suggest /prompt-library 路由
├── install.sh            # 安装辅助:默认 pnpm 路径;--copy / --check / --uninstall
├── tools/                # 测试与工具(见下):board-logic-test / board-ui-probe / board-archive-gate-test / share-logic-test / css-diff.py
├── .github/workflows/    # CI:语法检查 + 三个回归网(含负控)
├── LICENSE               # MIT
└── reports/              # 兼容性审计与复验报告(本机证据,package.json 的 files 不含它)

package.json 的 files 只发布 lib/ 与 cordis.patch.yml,tools/、reports/、install.sh 都不进 tarball。

client.js 是对 dsh 官方 client bundle 的注入产物(通过 slot 注入 + 运行时 CSS,不修改 bundle 源文件)。重注入脚本与本地开发流程见内部 dsh-patches/(未随仓库发布)。

会话分享的回归网

node tools/share-logic-test.mjs      # 45 条断言:轮次归组 / 内容块拆分 / 时间回退 / URL 清洗 / 结束标记裁剪 / 结构锚点(CI 跑)

share-logic-test.mjs 从 lib/client.js 里抠出 shareGroupTurns(把 flow 行归成轮次)、shareBlocksFromGroups(把轮次拆成可勾选的内容块,并保持用户消息 / 助手正文的 DOM 顺序)和 shareCleanUrlText(把 CSS / style 里的外部 URL 抹成 none,只留 data:),在沙箱里断言最容易静默退化的规则:助手一轮里的所有正文段都要成为独立内容块(不能只取最后一段,否则无法逐段「去掉」且会丢内容)、块顺序与角色正确、缺少锚点时 key 仍稳定,以及任何外部 URL 都不得进入 SVG(漏一个就会污染 Canvas、toBlob() 直接抛错)。另外锁定结构锚点:utilities slot 注册、ClipboardItem + Promise<Blob> 交接、foreignObject 光栅化、画布上限、默认开启的设置项、会话重挂载不退出分享模式、120 段上限、勾选态不会画进图片(克隆时会剥掉 enhc-share-picked / enhc-share-excluded,否则选中框会被烘焙成图片的一部分),以及长图按结束标记裁剪(shareFindSentinel / shareCropCanvas + 放大的 SVG 视口,防止底部页脚与最后几行被截断)。

看板的三个测试工具

node tools/board-logic-test.mjs      # 纯逻辑:落列/排序/剪枝/隐藏/撤销的不变量(CI 跑)
node tools/board-ui-probe.mjs "$TOKEN" "$SESSION_ID" [/tmp/shot.png]   # 真界面 e2e(需活的 dsh web + Chrome + xvfb)
node tools/board-archive-gate-test.mjs                        # B16 门禁回归网:清空不得先把会话归档(exit 0 = 39 条断言全过,组 0 + A–G)
node tools/board-archive-gate-test.mjs --mutate <name>|all    # 负控:exit 0 = 变异被检出(不检出 = 这张网形同虚设);all 在 shipped guard 是 layout (a) 时额外用内存生成的 layout (b) 等价重构再跑一遍(是 layout (b) 则只跑 1 源并打 note)
node tools/context-logic-test.mjs                            # 上下文面板纯逻辑:系统提示拆分、压缩 shadow/surface 位置、注入过滤、截断上限、/compact 结果配对(exit 0 = 26 条断言)
node tools/prompt-insert-logic-test.mjs                      # 提示词插入纯逻辑:已有草稿保留 + 单个换行分隔 + useInput 缺失时读 contenteditable 回退(exit 0 = 16 条断言)

board-logic-test.mjs 从 lib/client.js 里把纯函数抠出来跑沙箱断言,不需要浏览器。board-ui-probe.mjs 用 puppeteer 驱动真实面板(拖拽、菜单、批量、折叠、搜索、新建/改名/勾选/删除自由待办卡、清空→撤销归档、刷新持久化);默认不碰会话,加 BOARD_PROBE_RUN=1 才会真的走一遍"待办 → 建会话执行"(会新建一个会话,脚本会打印 id 方便清理),会动真会话,但结束时会把动过的都还原,并断言没有残留归档(会话被归档就会从侧栏消失,所以这个收尾很重要)。

context-logic-test.mjs 同样从 lib/client.js 抠出 contextItems / contextCompactCommand 跑沙箱:系统提示与对话内容分栏、<system-reminder> 注入过滤、compaction/summary.shadowedSeqs 隐藏被压缩历史、替换消息的 surfaceOp 按位置插入(不是按 seq 追加)、连续压缩与系统提示重写、截断上限,以及 /compact 的 command/run ↔ command/done 配对(含 "No compactable history yet." 这种没有压缩事件的成功)。

board-archive-gate-test.mjs 守的是破坏性顺序:真删会话要靠 dsh-archived-chats 的 /delete-all → /trash/purge,而 0.2.0-rc.2 的版本门禁会跳过 archived-chats@1.4.5,这两条路由只会 404/405 —— 这时"清空"只能降级成"把卡片移出看板"。一旦实现退化成"先归档、再发现删不掉",会话就被移出侧栏且没有东西能把它放回来(用户却以为只是从看板移走了卡片)。所以它断言 boardDeleteSessions 的能力门禁必须排在 workspaces.archiveSession 循环之前:不可用时核心归档调用数必须为 0,唯一的请求是一次空 id 的能力探测,且探测结论被缓存为不可用。

39 条断言,分 0 + A–G 八组:0 哨兵(切片确实来自当前 lib/client.js、归档路径仍在,--mutate 也跑)/ A 不可用时降级 / B 可用时走完整链路(core archive → /delete-all → /trash/purge;already-trashed 的会话直接进 purge 而不是记失败;原本就归档的会话失败时也要能被撤销归档)/ C purge 半途失败后核心 workspaces.unarchiveSession 能把会话收回(不留悬空归档)/ D 插件 /unarchive-all 成功时走插件且不碰 core,回 405 时仍能被 core 收回 / E 探测请求抛错时判 false 且不抛 / F 探测通过但 /delete-all 失败时如实上报并降级缓存 / G 归属(整包范围,10 条)。

G 组是第二轮复查(F6/R1)加的,因为只切函数的运行时断言挡不住"把归档调用搬到切片之外":把 boardBridge.workspaces.archiveSession(id) 循环塞进调用点 purgeTrash(它只是组件里的一个闭包,从来不在切片里)后,旧版仍是 18/18 全绿。验收规则现在是显式的:任何把归档调用挪到门禁之前的等价改法都必须转红,包括挪出被切片函数的范围。G 组因此在整份 lib/client.js 上断言(10 条):BOARD_ARCHIVE_BASE 的每一次引用(声明处除外)都必须落在路由层的声明内(boardDeleteSessions / boardProbeArchiveRoutes / boardRestoreArchived / boardRestoreSessions,这份白名单是显式写死的,新加的 boardArchive* helper 不会被自动放行);路由字面量 /plugins/dsh-archived-chats 全包只能出现一次且必须在常量声明处;boardBridge 不许在路由层之外做计算成员访问;并且在该函数内门禁必须存在、文本上先于归档循环、且是提前 return。

archiveSession 的归属断言是显式两个 owner(2026-09,为「看板归档时同时从侧栏收起会话」扩过一次):被门禁保护的 boardDeleteSessions,以及那个开关的 owner boardArchiveSessions(默认关;只由 BoardDialog 的手动移动处理函数经 boardSidebarAction 调用,规则自动归类走不到)。第三个声明只要写出 archiveSession 就转红——这正是 helper / move 等负控仍在抓的东西;同时 boardArchiveSessions 不在 BOARD_ARCHIVE_BASE 的路由白名单里,所以它也不能借归档插件的路由。

已知残余局限(刻意不追):以上都是文本级归属断言,能拦住所有通过 BOARD_ARCHIVE_BASE 常量或 archiveSession 这个名字的等价破坏(包括"复用常量手搓路由"与"新 helper + 复用常量"这两种曾经的逃逸),但刻意拼写变形(例如 workspaces["archive" + "Session"](id))不在保证范围内——静态文本匹配追不出所有变形,追下去只会把测试变成脆弱的字符串迷宫,而且这个项目已经因为"锚点耦合 lib/client.js 内部结构"吃过一次亏。风险可接受的理由:这类写法在实践中只会出现在刻意规避审查的场景(常量就摆在同一个文件里,正常改法都会用它),代码评审可见;运行期网络(A–F 组)仍然保证被切片的 owner 在链路不可用时一个会话都不归档。

负控现在有 8 个,全部纳入 --mutate all(CI 跑):函数内破坏 gate(把门禁条件短路)与 reorder(门禁与归档循环换位)、probe(探测恒 true);切片外破坏 move(调用方直接归档)、helper(新 helper 直接归档)、move-route(调用方复用常量手搓 /delete-all,即上一轮复审的逃逸 A)、move-helper-route(新顶层 helper boardArchivePurge 复用常量路由,即逃逸 C)、inline(调用方重打路由字面量)。每一轮都要求"原始全绿 + 变异转红"。

重构容忍是有边界的,而且是可执行验证的:工具容忍的门禁写法只有两种(与它的 JSDoc/头部逐字一致)——

  • layout (a):if (await boardArchiveAvailable() !== true) { … }
  • layout (b):const capability = await boardArchiveAvailable(); if (capability !== true) { … }

这两种形状内部的格式差异(加括号、换行、插注释、局部变量改名)都能容忍。--mutate all 会验证它:当 shipped guard 是 layout (a) 时,它额外在内存里生成一份语义等价的 layout (b) 变体再跑一遍整套负控(2 源 / 16 次检出,输出 … detected on 2 source(s));当 shipped guard 本来就是 layout (b) 时没有第二份源可生成,工具会打印 note: the shipped guard already uses the hoisted layout — the refactor-tolerance pass reuses it 并只跑1 源 / 8 次检出(输出 … on 1 source(s))。两种情况都要求"原始全绿 + 全部负控转红",否则 exit 1。这正是不让 t9 的 O1 复活的那道保险(当时 guardBlock 的 layout (b) 分支把语句自己的 ; 也算进切片检查 → 恒不命中 → gate/reorder 抛错 → --mutate all 假红,而文档还写着"不会让负控假红")。

边界之外会怎样(已实测,写在文档里而不是靠读者猜):把门禁再深一层、经过一个中间布尔变量,例如

const capability = await boardArchiveAvailable();
const denied = capability !== true;
if (denied) { … }

仍然会让 --mutate all exit 1,报 REFACTOR TOLERANCE FAILED: could not build the layout-(b) equivalence source … the guard locator is coupled to one code layout, so a legal refactor of the gate would redden CI for no reason。这是假红,不是漏检:主套件(真正守回归的那条)仍然全绿——它的断言读的是结构而非文本;所有真实破坏也仍被抓住;报错本身干净、可行动(指明了原因和出路:把守卫写成上面两种布局之一,或者按下面的原则收敛声明)。

为什么不再扩定位器(有意的设计边界):静态定位器对任意嵌套的容忍是无穷递归——每容忍一层,就会有人写出更深一层的等价写法;而且每扩一次都在把测试与 lib/client.js 的现实写法绑得更紧(这个项目已经因为"锚点耦合"在同一天让两个成员互相打破了对方的改动)。所以规则是:声明边界,不扩容器。将来若又遇到新的等价写法导致假红,按同一原则限定声明(或把守卫写成两种已记明布局之一),而不是加大容错。假红是可接受的失败方向:宁可多报,不可漏检——一张会多报的网仍然拦住破坏,一张会漏检的网什么也拦不住。

切片也是自适应的:boardArchive* / boardProbe* 一族在文件顶层的声明会被自动纳入沙箱(漏掉一个只会变成宽松模式下的隐式全局——旧版就是这样侥幸通过的),必需的 8 个声明消失才会抛错。--mutate gate / --mutate probe 不锚定具体代码文本,而是结构化地把门禁条件改写成 false/把探测函数体换成 return true。

实现沿用 board-logic-test.mjs 的 matchDelimiter() / locate() 惯用法,从当前 lib/client.js 切出真实声明并注入桩(fetch + boardBridge.workspaces),因此不需要浏览器、不启 dsh、不碰 $DSH_HOME;锚点消失会直接抛错(canary),不会静默变成空跑。--mutate <name>(或 all)是它的负控:在内存里改写整份源码(仓库文件不动)再重新切片,先跑原始、再跑变异,只有"原始全绿、变异后转红"才 exit 0 —— 这是证明这张网不是恒绿的唯一手段(变异仍通过则 exit 1,说明网形同虚设);参数错 exit 2,--help exit 0。CI 里同时跑主套件与 --mutate all,所以这类破坏性回归过不了 PR。

改注入样式前先跑规则级 diff

注入的样式表在 lib/client.js 里是一整行 JS 字符串,普通 git diff 看不出「从逗号列表里删掉一个选择器」这类改动——已因此踩过两次坑([data-slot=x] [class$=_meta],[data-slot=x] [class$=_time] 删掉前半段后变成 [data-slot=x] [data-slot=x] …,永不命中;[class$=_brand] svg 放宽成 [class*=_brand] svg 把品牌 wordmark 压扁)。所以改完必须跑:

python3 tools/css-diff.py            # HEAD vs 工作区,按规则列出增删
python3 tools/css-diff.py --lint --check   # 只扫可疑模式(重复属性步、空规则),CI 也跑这条
python3 tools/css-diff.py 0f8acdb HEAD     # 任意两个版本对比

规则 diff 只说明「改了什么」,是否该这么改还得在浏览器里确认:把 style[data-plugin-css="dsh-enhance-tool/enhancer.module.css"] 的 sheet.disabled 在 true/false 之间切换,对比 getComputedStyle + getBoundingClientRect,并逐个列出被新命中的元素(放宽后缀→子串匹配时尤其重要)。

本地开发闭环(只改 client.js 时无需重启 dsh web)

profile 里的 dsh-enhance-tool 是拷贝还是符号链接,取决于安装方式:

  • dsh plugin --profile web add github:… / npm 上的 tarball 装法(以及 install.sh --copy):profile 里是拷贝(content-addressed store 的硬链接,或直接拷进去),改完仓库文件必须覆盖过去;
  • dsh plugin --profile web add <本地目录>(install.sh 的默认路径):pnpm 记成 link: 符号链接指向 clone,这时 profile 里那份就是仓库文件(cp -f 反而是"自己覆盖自己",会报 are the same file,无害),改仓库即生效;但把 clone 移走/删掉插件就会静默消失(install.sh 会检测并提示,建议改用 --copy)。

按拷贝安装(最常见)覆盖:

cp -f lib/client.js ~/.dsh/profiles/web/node_modules/dsh-enhance-tool/lib/client.js

@deepseek-ai/dsh-client-hmr 会以 500ms 轮询 profile 里的 client bundle,检测到变化后重新计算该插件的 bundle rev(index.html 中 dsh-enhance-tool/client.js&rev=... 会变)并通知浏览器热重载 —— 不需要重启 dsh web。实测:已打开的标签页会在几秒内自动热替换插件(SSE rebuilt 帧 → 重载模块 + 重建样式标签),无需刷新;但标签页被浏览器冻结/SSE 断连时会错过该帧,此时 Ctrl+Shift+R 硬刷新即可。注意 index.html 里合并大 bundle 的那个 rev= 不会变,别用它判断是否生效;host 侧 lib/index.js 的改动仍然要重启 dsh web。


数据文件(勿提交 / 勿外发)

  • ~/.dsh/prompts.json — 提示词库(可能含环境敏感信息)
  • ~/.dsh/profiles/web/enhancer-board.json(+ .bak)— 任务看板状态(仅当选择「随 profile 保存」时生成)

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。