dsh-compact-activity

dsh-compact-activity

简体中文 | English

让 DeepSeek Harness 的思考、工具调用和图片输出更容易浏览。

插件把连续的思考和工具调用收进一个默认折叠的总过程项。展开后仍使用 DSH 官方组件，模型正文保持可见。

功能概览

• 过程折叠：连续或单条思考、工具调用都可以收进一个总过程项。
• 实时状态：显示进行中、已完成或执行错误，以及思考、工具和失败步骤计数；运行中的工具会复用官方摘要。
• 错误识别：统计结构化工具错误、思考中断，以及 Bash/PWSH 等终端工具的非零退出码和终止信号。
• 正文保留：同一 step 同时包含思考和正文时，只折叠 Think，正文继续显示。
• 图片折叠：非用户输入的图片默认收起，用户和 steering 消息中的图片保持原样。
• 官方交互不变：不替换官方渲染器，不修改模型上下文、会话日志或工具执行。

状态、计数和图片文案跟随 DSH 的语言设置，支持 中文 和 English。切换语言后，已显示的总过程项和图片标记会同步更新。

效果展示

安装

DSH Desktop 2.0.12（Beta：2.0.12-beta.1）

从系统托盘打开 DSH Terminal，针对当前 profile 运行：

dsh plugin add dsh-compact-activity@latest
dsh --dump-config
pnpm list dsh-compact-activity --depth 0

配置输出应包含 id: ui-compact-activity 和 name: dsh-compact-activity。验证后重启 DSH Desktop。

Desktop 已内置 Node.js、pnpm 和 DSH。无需为本插件全局安装这些工具，也不要使用 npm 代替 pnpm。DSH Terminal 中的命令默认操作 Desktop 当前 profile，不要添加 --profile web。

Desktop 对刚发布的 npm 包默认应用 24 小时最短发布时间策略。安装时应优先使用 @latest，然后比较 npm 的最新版本和 profile 实际安装版本：

$latest = pnpm view dsh-compact-activity dist-tags.latest
pnpm list dsh-compact-activity --depth 0

如果实际版本不是 $latest，再显式安装查询到的版本以确认用户选择：

dsh plugin add "dsh-compact-activity@$latest"

dsh plugin update dsh-compact-activity --latest 也可能因安全窗口继续保留旧版本并显示 Already up to date，因此必须核对实际版本，不能只看命令是否成功。

Desktop 的每个 profile 有独立的插件清单和构建配置。托盘从 desktop 切换到 web 后，之前安装在 desktop 的插件不会自动出现在 web；必须切换到目标 profile 后，在该 profile 的 DSH Terminal 中再次执行上面的安装、更新和验证命令。切回其他 profile 时同理。

普通 DSH CLI/Web

适用于终端中已有 dsh 和 pnpm 的 Linux、macOS 和 Windows 环境。只有 Node.js 和 npm 无法安装 DSH 插件；请先按 DSH 官方方式配置 pnpm 和 DSH。

dsh plugin --profile web add dsh-compact-activity@latest
dsh --profile web --dump-config

配置输出应包含 id: ui-compact-activity 和 name: dsh-compact-activity。验证后运行 dsh --profile web。插件默认启用。

让 Agent 帮你安装

如果你的 Agent 可以使用终端，把下面这段话直接发给它：

请安装并验证最新版 dsh-compact-activity。

1. 如果目标是 DSH Desktop（稳定版 2.0.12 或 Beta 2.0.12-beta.1），直接定位并使用 Desktop 提供的 DSH Terminal 程序或启动入口。不要用普通 PowerShell、CMD 或其他终端代替。找不到 DSH Terminal 时停止并报告，不要猜测路径。
2. 在 DSH Terminal 中优先运行 `dsh plugin add dsh-compact-activity@latest`、`dsh --dump-config` 和 `pnpm list dsh-compact-activity --depth 0`。这些命令操作 Desktop 当前 profile，不要添加 `--profile web`。
3. 用 `pnpm view dsh-compact-activity dist-tags.latest` 查询 npm 最新版本。如果实际安装版本不一致，再运行 `dsh plugin add "dsh-compact-activity@<查询到的版本>"`，不要预先写死版本号。
4. 只有目标明确是普通 DSH CLI/Web 时，才使用带 `--profile web` 的插件命令。此路径需要 `dsh` 和 `pnpm`；npm 不能代替 pnpm。
5. 配置输出必须包含 `id: ui-compact-activity` 和 `name: dsh-compact-activity`。读取已安装包的 `package.json` 并报告 npm 最新版本、实际版本、安装路径和验证结果。
6. 如果定位或启动终端、执行命令、联网下载或读取验证结果需要当前没有的权限，立即向用户说明受阻操作、所需权限和用途，并请求授权。得到授权前不要继续，不要自行提权或绕过限制。
7. 不要安装全局工具，不要检查 app.asar 内部路径，也不要编辑 profile 清单、修改 Desktop 应用文件或手动复制插件。

使用方式

插件没有独立的设置页面。安装后重启 DSH Web 或 Desktop 即可生效；语言由 DSH 的 Language 设置控制：

场景	显示行为
连续或单条过程消息	合并为一个默认收起的总折叠项
正在思考	显示 进行中...、计数和 正在思考
正在调用工具	显示最后一个官方工具的类型和摘要
正常完成	显示 已完成 和计数；历史失败保留在失败计数中
最后过程项失败或中断	显示 执行错误；后续正文不会覆盖该状态
同一 step 同时有思考和正文	只折叠 Think，正文继续显示
展开总过程	继续使用官方 Think 和工具组件，并显示成员状态
切换 DSH 语言	总过程和图片标记同步切换中文或英文

过长的实时摘要会自动截断，不会挤压页面布局。

更新与卸载

在 DSH Desktop 的 DSH Terminal 中更新或卸载：

dsh plugin update dsh-compact-activity --latest
dsh plugin remove dsh-compact-activity

更新后运行 pnpm view dsh-compact-activity dist-tags.latest 和 pnpm list dsh-compact-activity --depth 0 对比版本。若版本不一致，再使用查询到的明确版本执行 dsh plugin add "dsh-compact-activity@<version>"。

普通 CLI/Web 更新或卸载：

dsh plugin --profile web update dsh-compact-activity --latest
dsh plugin --profile web remove dsh-compact-activity

操作后请重启 DSH Desktop 或 DSH Web。

Desktop 切换 profile 后插件不生效

按以下顺序排查：

• 从托盘切换到需要使用插件的目标 profile。

• 从该 profile 打开 DSH Terminal，运行：

  dsh plugin add dsh-compact-activity@latest
  dsh --dump-config
  $latest = pnpm view dsh-compact-activity dist-tags.latest
  pnpm list dsh-compact-activity --depth 0
  

• 确认输出同时包含 id: ui-compact-activity、name: dsh-compact-activity，并比较 npm 最新版本和实际安装版本。

• 如果版本不一致，运行 dsh plugin add "dsh-compact-activity@$latest"，然后重新检查实际版本和配置。

• 重启 DSH Desktop，再检查总过程折叠。

pnpm peers check 对旧版插件可能报告缺少 React、DSH Client 或 Locale peer dependencies。这些模块由 DSH 宿主提供，不应手动安装到 profile；当前版本已将它们标记为 optional peer。若目标 profile 已包含上述配置但仍无效果，记录 DSH/Desktop 版本、启动方式、npm 最新版本、实际插件版本、安装路径和浏览器控制台错误。不要编辑 profile 清单、复制插件文件或检查 app.asar；这些操作会绕过 Desktop 的正常插件加载流程。

从本地源码安装

项目使用严格模式 TypeScript。需要 Node.js 22.19+ 或 24+：

pnpm install
npm run check
dsh plugin --profile web add .
dsh --profile web --dump-config
dsh --profile web

当前 DSH alpha 的 client 包尚未发布到 npm；本分支的开发依赖通过 ../clone/deepseek-harness 链接到本地 alpha checkout。若两个仓库目录不同， 请相应调整 package.json 中的 link: 开发依赖。

如果使用 Harness 源码版，请在 Harness 源码根目录执行 pnpm dsh ...，并把 . 换成本插件目录的绝对路径。

从 tarball 安装

npm pack
dsh plugin --profile web add ./dsh-compact-activity-<version>.tgz

请将 <version> 替换为 npm pack 输出中的实际版本。tarball 已包含预构建的 lib/，安装时不需要再次构建。

开发与验证

npm run typecheck
npm test
npm run build
npm pack --dry-run

npm run check 会依次执行严格类型检查、测试和生产构建。lib/ 是本地生成且不纳入 Git 的构建产物；prepack 会在发布或打包前重新生成它，并将其包含在 npm 包中。

测试使用开发依赖 jsdom、react-dom 和 tsx，用于验证核心分组逻辑及浏览器控制器行为。这些依赖不会进入 npm tarball；npm test 会自动发现 test/*.test.ts。

scripts/
└── clean.ts                         # 使用 Node 原生 TypeScript 清理构建目录
src/
├── index.ts                         # Host 入口，让 Loader 发现浏览器插件
└── client/
    ├── index.ts                     # 注册控制器并管理样式生命周期
    ├── activity-group.ts            # 过程分组、边界、状态和计数
    ├── locales.ts                   # DSH Locale namespace 的中英文词典
    ├── styles.ts                    # 总折叠行及隐藏状态样式
    └── components/
        └── CompactActivityController.tsx # 控制官方过程行的总折叠状态

tsconfig.json 开启 strict、noUncheckedIndexedAccess 和 exactOptionalPropertyTypes，并检查源码、测试、构建配置及脚本。

兼容性

兼容性状态：

截至 2026-09-19，以下结果基于本地源码和 Desktop 内置运行时包；尚未启动真实 Electron/Desktop 窗口做人工回归。

运行环境	版本	结果
DeepSeek Harness 官方 Web	0.1.6-alpha.2（commit ddefc45f）	插件开发依赖直接链接本地源码；npm run typecheck、npm test 和 npm run build 通过。真实 Web 窗口未做人工回归。
社区 DSH Desktop 稳定版	2.0.12，内置 DSH 0.1.5-rc.2	vendor/dsh-runtime/0.1.5-rc.2 的 Client bundle 仍保留 Chat Flow、Think、Tool 和 Turn-process 标记；未发现源码契约冲突，但真实 Desktop 启动和 profile 组合未回归。
社区 DSH Desktop Beta	2.0.12-beta.1，内置 DSH 0.1.6-alpha.2	与当前官方 Web 源码使用同一 Client 契约；Beta 的内置运行时版本与本地源码一致。真实 Desktop 启动和 profile 组合未回归。

Linux 和 macOS 用户也可通过官方 CLI/Web 使用插件。

插件依赖以下 DSH Web 扩展点和稳定标记：

• conversation.session.header.actions
• @deepseek-ai/dsh-client-locale 的 locale service 与 slot t 翻译 seat
• Chat Flow 的 data-chat-flow 与 data-chat-flow-key
• 官方过程项的 data-variant="think"、data-tool、data-state 和 data-disclosure-row
• assistant-step 与 tool-call Chat Node 数据

语言词典注册到插件自有的 compact-activity namespace，状态和计数通过 DSH 注入的 t 翻译函数呈现；其余标记由 DSH 提供，不属于本插件控制的公共 API。升级 DSH 后，建议人工检查总过程折叠、官方子项交互、语言切换和工具实时摘要。

图片折叠

非用户输入的图片默认收起，范围包括：

• Assistant 消息中的附件图片和 Markdown 图片；
• 工具结果中的图片画廊；
• 其他非 user / steering Chat Flow 行中的图片展示。

用户输入和 steering 消息中的图片保持原样。插件使用自己的独立标记：data-dca-image-group、data-dca-image-target 和 data-dca-image-hidden，只插入原生 <details>/<summary> 标记并隐藏原图片目标，不移动或替换 DSH 的图片 DOM 子树。

图片折叠支持淡入淡出过渡，并遵循 prefers-reduced-motion。检测复用 DSH 的图片按钮、Markdown 图片属性和失败回退结构；同一 Markdown 图片引用只生成一个标记，展开后显示图片名称和路径。Windows Desktop 中的本地 Markdown 路径会根据当前 Session 工作目录补全盘符，并通过已鉴权的 /api/file 路由重新挂载；无法解析或文件不存在时保留 DSH 的回退文本。升级 DSH 后，建议检查 Assistant 图片、工具图片、多图画廊、失败回退、用户图片和 lightbox 展开。

DSH Desktop 服务边界

本插件是跨环境 Web UI 插件，不执行 profile 切换、插件安装/更新/卸载或依赖修复，因此不使用 Desktop 专用的 desktopProfiles、desktopPnpm、desktopRuntime 或 Electron IPC。Desktop 仍通过普通 DSH Web Client 模块加载本插件；不要为本插件添加 Desktop Host 服务作为必需注入，也不要访问 app.asar 或其他 Desktop 私有路径。

Desktop 真实环境验证应使用 Desktop 提供的 DSH Terminal，并确认当前 profile 的配置包含 id: ui-compact-activity 和 name: dsh-compact-activity。仓库中的 jsdom 测试不能替代真实 Desktop/Web 宿主回归检查。

问题反馈

遇到兼容性问题时，请在 GitHub Issues 提交：

• DSH 版本和启动方式；
• 插件版本；
• 浏览器控制台错误；
• 能复现问题的界面截图。

请勿在 issue 中提交模型上下文、令牌或其他敏感信息。

许可证

MIT © 2026 wallpap