dsh-friendly-steps

dsh-friendly-steps（过程精简）

Friendly process collapse for the DeepSeek Harness Web GUI — hides technical Think / tool-call rows behind a small summary pill, for non-technical readers. 100% presentation-only CSS + a createRoot pill on document.body; zero interference with React rendering.

把 DSH Web GUI 会话消息流里的技术过程行（Think / 工具调用 / 重试 / 压缩） 用纯 CSS 折叠，右下角浮条显示「✓ 已完成 N 步 · M 步未成功」， 点击浮条一键展开/收起全部过程。失败/中断的步骤计入折叠并在浮条红色反馈。

安装

# 直接从 GitHub 安装（安装时经 prepare 自动从 src/ 构建，开箱即用）
dsh plugin --profile web add github:dongwenxiu83-web/dsh-friendly-steps

# 桌面版 profile 名为 desktop 时：
dsh plugin --profile desktop add github:dongwenxiu83-web/dsh-friendly-steps

安装后重启 DSH 生效；之后升级插件只需重新执行安装命令并重启。

构建（src → lib）

源码唯一权威在 src/；lib/ 是构建产物，不入库（已加入 .gitignore）， 杜绝打包时拿到旧产物：

• npm run build — 清空并从 src/ 重新生成 lib/（零依赖纯拷贝）
• prepack — npm pack / pnpm pack 打 tarball 前自动强制重建
• prepare — git 方式安装（dsh plugin add github:…）时由 pnpm 自动构建

本地 link: 安装前先执行一次 npm run build（改动源码后同理）。

效果

• 过程行（Think / 工具调用 / 重试 / 压缩）纯 CSS 折叠，页面只剩对话正文
• 右下角浮条：✓ 已完成 N 步，出错时红色追加 · M 步未成功， 运行中显示 ⏳ 正在处理…（已进行 N 步）
• 点击浮条在「全部展开 ⇄ 全部收起」间切换

v2 设计（零侵入）

• 行折叠 = 纯 CSS display:none：所有行仍由官方 React 渲染和持有， 不向 React 列表注入任何外来节点——v1 的"展开后内容消失"（React 重排 移除注入节点）在本版结构上不可能发生。
• 浮条 = pet 同款官方模式：createRoot 挂在 document.body 安全区。
• 计数节流 400ms，只做几次选择器统计，无布局读取、无全量扫描—— v1 的主线程风暴（页面卡死）在本版不存在。
• 任何 DOM 契约变化 → fail-open（按官方原样渲染），不会弄坏页面。

模式

模式	行为
minimal（默认）	折叠过程行 + 隐藏 Think + 显示浮条
brief	只隐藏 Think
off	完全官方呈现

切换方式（浏览器控制台，立即生效并记忆）：

dshFriendlySteps.setMode('minimal') // 或 'brief' / 'off'
dshFriendlySteps.debug()            // 排查：输出各行计数

挂载方式（本机开发）

• 包本体：本目录
• symlink：~/.dsh/profiles/node_modules/dsh-friendly-steps → 本目录
• insert 行：~/.dsh/profiles/desktop/cordis.patch.yml（id friendly-steps）
• 新增包需重启 DSH 生效；之后改 client.js 只需刷新页面

其他用户请用上方「安装」一节的命令，无需手动挂载。

卸载

1. 删除 ~/.dsh/profiles/desktop/cordis.patch.yml 里的 friendly-steps insert 段
2. 删除 symlink：rm ~/.dsh/profiles/node_modules/dsh-friendly-steps
3. 重启 DSH

抗升级说明

• 依赖官方 DOM 契约：data-chat-flow-kind、[data-variant="think"]、 工具行内 [data-tool][data-state]（running / ok / error / stopped）
• 不依赖任何生成的 CSS 类名，不与 React 争 DOM
• DSH 升级后若契约变化，最坏表现是"不再折叠"（fail-open）

已知取舍

• 摘要是全局浮条而非每组一行（官方 tool-call renderer 可被 priority 遮蔽，但官方行组件未导出，展开态无法交还官方渲染——故不遮蔽）。
• 浮条固定在右下角输入区上方，与其他右下角插件（如桌宠）可能相邻。