dsh-compact-activity

简体中文 | English

让 DeepSeek Harness 的思考与工具调用更紧凑、更容易浏览。

插件会把连续的思考和工具调用收进一个单行折叠项。默认保持收起，需要查看细节时再展开；模型最终输出始终正常显示。

为什么使用它

• 减少滚动距离：连续的思考和工具调用合并为一个折叠项。
• 柔和底板外观：轻量底色、细边框和状态轨迹增强层次；紫色表示运行中、Miku 绿表示完成、红色表示执行错误。
• 展开归属清晰：中性过程轨道从折叠条平直下沿连接官方子项；统一圆角的子项底板分别使用淡紫、淡绿或淡红表示运行、完成或错误。
• 不改变官方内容：展开后仍使用 DSH 官方 Think、Code 和工具组件。
• 保留正文边界：下一条模型正文不会被折叠进过程列表。
• 实时显示状态：执行期间显示 进行中...、计数和最后一项活动摘要。
• 保留失败统计：过程中的失败步骤单独计数；后续步骤恢复成功时仍显示 已完成。
• 准确显示终态：最后一个过程项失败或中断时显示 执行错误，后续模型正文不会覆盖该状态。
• 单条消息不受影响：只有一条思考或工具调用时，继续使用 DSH 官方行为。

插件只调整 Web 界面的展示方式，不修改模型上下文、会话日志或工具执行。

总折叠的状态和计数文案跟随 DSH 的语言设置，支持 中文 和 English。未设置显式语言时由 DSH 使用浏览器语言；在 DSH 中切换语言后，已显示的总过程项会同步更新。官方工具的标题和摘要仍原样复用。

安装

DSH Desktop 2.0.x

从系统托盘打开 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.x，直接定位并使用 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 设置统一控制：

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

效果展示

更新与卸载

Desktop 2.0.x 在 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 后插件不生效

按以下顺序排查：

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

2. 从该 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

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

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

5. 重启 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+：

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

如果使用 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，并检查源码、测试、构建配置及脚本。

兼容性

兼容性状态：

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 翻译函数呈现；不读取或猜测 DOM／浏览器语言。其余标记由 DSH 提供，不属于本插件控制的公共 API。升级 DSH 后，建议人工检查总过程折叠、官方子项交互、语言切换和工具实时摘要。

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