dsh-toolfold 0.1.7

package/CHANGELOG.md

@@ -0,0 +1,63 @@
+# Changelog
+
+所有显著变更将记录于此。格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+## [0.1.7] - 2026-08-26
+
+### Fixed
+- npm 发布命令增加 `--no-git-checks`，跳过 pnpm 的 git 状态检查，避免在 CI 检出态下发布失败。
+
+### Changed
+- 将发布工作流 Node 版本由 `lts/*` 固定为 `24`，与当前构建环境对齐。
+
+## [0.1.6] - 2026-08-26
+
+### Fixed
+- 修复 WSL `bash` 工具在折叠后标题消失的问题。`BashRow` 使用 `data-sample="bash"` 独立渲染，无 `data-disclosure-row`，旧克隆逻辑回退到空的 `[data-tool]` 导致折叠条只剩计数。现按优先级克隆：`[data-disclosure-row]`（通用 `ToolRow` / `pwsh`）→ `[data-sample="bash"]`（Bash 头部）→ `[data-tool]` 首子 → `lastRow.firstElementChild`，并保持 120 ms 节流。（`lib/client.js`, `lib/dynamic-body.js`）
+
+### Changed
+- 重构 npm 发布工作流 `.github/workflows/npm-publish.yml`：改为 `release.created` 触发，使用 `pnpm@11` + `setup-node` LTS 并通过 `secrets.npm_token` 发布。
+
+## [0.1.5] - 2026-08-21
+
+### Added
+- 兼容 DSH `v0.1.1-rc1` 的设置存储与类型。
+
+### Fixed
+- 修正 `peerDependencies` 中 `@deepseek-ai/dsh-settings` 的预发布版本区间（`>=0.1.0-rc.7 <0.1.1 || >=0.1.1-rc.0 <0.1.2`），避免 pnpm 解析冲突。
+
+## [0.1.4] - 2026-08-20
+
+### Fixed
+- 适配 DSH 0.2.4 `settings.plugin.item` 由 `list` 改为 `keyed`：注册时同时提供 `key: 'toolfold'` 与 `id`，`toolfold settings card failed to register` 消失，设置卡在新版 Web 中重新出现。
+- 同步 `peerDependencies`：`@deepseek-ai/dsh-settings@^0.1.0-rc.7` 与实际 `0.0.1-rc.1` 的差异说明。
+
+## [0.1.3] - 2026-08-16
+
+### Fixed
+- 修复多条目折叠动画尾段卡顿：`ccxRise` 与高度收缩统一使用 `cubic-bezier(0,0,0.58,1)`，清理计时改为 `max(0,N-1)*step+dur+60`（收起）/`+260`（吸底），长卡片不再“先透明后瞬收”。
+
+### Changed
+- 更新依赖 `deepseek-seetings` 版本。
+
+## [0.1.2] - 2026-08-16
+
+### Added
+- `splitThink`（思考分隔调用组）默认开启：已完成的思考把前后两组工具调用隔开、各自独立折叠；关闭时恢复旧的“思考并入同组”行为。
+
+### Fixed
+- 修复 `think` 若在两工具块之间整组被误合并为一条折叠条的问题。
+
+## [0.1.1] - 2026-08-16
+
+### Added
+- 首个可用版本：连续 `tool-call` 折叠为最后一条的单行摘要 + “已折叠 N 个工具调用”，支持 `durMs / keepThink / splitThink / stats` 四项设置（DSH `settings` 服务 → `~/.dsh/settings.yaml`，回退到 Host 路由与 `localStorage`）与瀑布动画。
+- `toolfold` 远端包与一键安装、设置双半通信（Host `GET/POST /api/dsh-toolfold/settings` + Client 桥）。
+
+[0.1.7]: https://github.com/Minecraftbe/dsh-toolfold/compare/v0.1.6...v0.1.7
+[0.1.6]: https://github.com/Minecraftbe/dsh-toolfold/compare/v0.1.5...v0.1.6
+[0.1.5]: https://github.com/Minecraftbe/dsh-toolfold/compare/v0.1.4...v0.1.5
+[0.1.4]: https://github.com/Minecraftbe/dsh-toolfold/compare/v0.1.3...v0.1.4
+[0.1.3]: https://github.com/Minecraftbe/dsh-toolfold/compare/v0.1.2...v0.1.3
+[0.1.2]: https://github.com/Minecraftbe/dsh-toolfold/compare/v0.1.1...v0.1.2
+[0.1.1]: https://github.com/Minecraftbe/dsh-toolfold/releases/tag/v0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Minecraftbe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,136 @@
+# dsh-toolfold · Tool Call Folding
+
+> A DSH Web GUI plugin delivering a **Codex-like folding experience**: runs of consecutive
+> **tool calls** fold into a single compact bar showing a one-line summary of the **last call** —
+> click to expand/collapse. It replaces no built-in renderer, and uninstalling restores the UI
+> completely.
+
+![Folding demo](assets/demo-fold.gif)
+<!-- 🖼️ IMAGE SLOT: assets/demo-fold.gif — record 6–10s: a run of tool calls auto-folds into one bar → click to expand (cards waterfall down) → click to collapse (cards rise, heights shrink), 16:9, ≤2MB -->
+
+## Highlights
+
+- **Runs of tool calls fold into one bar**: consecutive tool calls collapse into a single bar
+  showing the **last call's** one-line summary, labelled "已折叠 N 个工具调用 · 点击展开"
+  (N folded calls · click to expand);
+- **Thinking separates call groups (default on)**: settled think blocks SPLIT the calls around
+  them into independent bars — calls before and after a completed think never merge into one bar;
+  turn it off to restore the original fold, where thinking folds WITH the surrounding tool group;
+- **Thinking hidden by default, keepable**: settled think blocks are hidden outright by default;
+  with "保留思考" enabled they never disappear — shown between the folded bars in split mode, or
+  **re-inserted in their original order** between the calls on expand in merge mode;
+- **In-progress thinking stays visible**: streaming think blocks render as their own row until
+  they complete, then follow the "split thinking" setting;
+- **Spring waterfall animations**: cards cascade down on expand (spring overshoot) and rise with a
+  synchronized height shrink on collapse — content below follows continuously, no end snap;
+  disabled automatically under `prefers-reduced-motion`;
+- **Bottom-pinned expand**: expanding near the bottom pins the bar's viewport position, so the
+  chat's auto-scroll never shoves it off the top of the screen;
+- **Near-zero performance cost**: no page-wide observer, zero work while content streams, and
+  everything pauses when the tab is hidden — measured ≈0.03% of one core while idle
+  (see [Performance](#performance)).
+
+![Expand / collapse animation](assets/expand-collapse.gif)
+<!-- 🖼️ IMAGE SLOT: assets/expand-collapse.gif — close-up of one 3–4 call run expanding (waterfall + label slide) and collapsing (rise + height shrink), square or 4:3, ≤2MB -->
+
+## Installation
+
+### One-line GitHub install
+
+```sh
+dsh plugin --profile web add github:Minecraftbe/dsh-toolfold
+```
+
+### Install from source
+
+```sh
+git clone https://github.com/Minecraftbe/dsh-toolfold.git
+dsh plugin --profile web add ./dsh-toolfold
+```
+
+After installing, **restart dsh and refresh the browser** to activate (bundle layers are composed
+at boot). Verify the plugin reached the final config with:
+
+```sh
+dsh --profile web --dump-config
+```
+
+> If an earlier version was mounted manually with a `toolfold` row in `cordis.patch.yml`,
+> remove that row before switching to this channel to avoid double-mounting.
+
+### Uninstall
+
+```sh
+dsh plugin --profile web remove dsh-toolfold
+```
+
+After a restart the UI is completely restored.
+
+## Usage & Settings
+
+Settings: **Settings → Plugins → 工具折叠** (the card matches the built-in plugin cards and follows
+the light/dark theme).
+
+![Settings card](assets/settings.png)
+<!-- 🖼️ IMAGE SLOT: assets/settings.png — screenshot of the expanded "工具折叠" card in Settings → Plugins (duration slider + keep-think toggle + stats toggle + storage-location hint), light theme, PNG/WebP ≤1MB -->
+
+| Setting | Description |
+| --- | --- |
+| **展开动画时长** (expand duration) | Per-card duration of the expand/collapse waterfall, 0–1000ms, default 240ms; 0 = instant |
+| **保留思考** (keep thinking) | Settled thinking is hidden by default; on: it never disappears — shown between the folded bars in split mode, or re-inserted in its original order between the calls on expand in merge mode |
+| **思考分隔调用组** (split call groups) | On (default): settled thinking splits the calls around it into independent bars; Off: thinking folds with the surrounding tool group (legacy behavior) |
+| **性能统计** (performance stats) | Shows the plugin's own live cost in the card (cumulative counts and ms/s for observer callbacks / engine refreshes / merge passes / safety rescans / summary clones, plus the streaming batches ignored by the zero-cost short-circuit) |
+
+Interactions: click the bar to expand/collapse; `Enter` or `Space` works too.
+
+### Where settings live
+
+- **Installed (bundle) mode**: the DSH **settings service** persists them to
+  `~/.dsh/settings.yaml` (namespace `toolfold`) — the same document the product and other
+  plugins use, host-side, so they survive browser/device changes. The card footer shows
+  "设置保存在 DSH 主机配置". The file is editable directly:
+
+  ```yaml
+  toolfold:
+    durMs: 240        # expand animation duration, 0–2000ms
+    keepThink: false  # keep settled thinking visible (between bars / on expand)
+    splitThink: true  # settled thinking splits call groups into independent bars (default true)
+    stats: false      # performance meter
+  ```
+
+- **When no DSH settings service is detected** (remote browsers and other setups without the DSH
+  settings bridge): degrades to browser `localStorage` (key `dsh-toolfold.settings.v1`) and the
+  card says "仅保存在本浏览器"; the legacy key `dsh-codex-collapse.settings.v1` migrates
+  automatically on first load.
+
+![Keep-thinking comparison](assets/keep-think.gif)
+<!-- 🖼️ IMAGE SLOT: assets/keep-think.gif — same run expanded twice, "keep thinking" off vs on, showing the think block hidden vs re-inserted in order, ≤2MB -->
+
+## Performance
+
+- **Measured on the live GUI (8s idle window)**: engine total ≈1.6–2.8ms (≈0.3ms/s, ≈0.03% of one
+  core); a 5s CPU sample in the same window shows **zero samples from the engine** — the page's long
+  tasks (141–686ms) come from page load, product rendering, and other plugins;
+- **Zero work while streaming**: text/think token mutations are short-circuited in O(1) and never
+  trigger a recompute (≈0.1–0.4µs per node);
+- **Hidden tab = literally zero**: all observers and timers disconnect on hide and re-attach with a
+  reconciliation pass on return;
+- Turn on "性能统计" to watch every cost item live inside the settings card.
+
+## Notes & Limitations
+
+- Folding works on the rendered DOM and depends on stable product markers; if the product markup
+  changes, the worst case is that folding stops applying — the chat itself is never harmed;
+- **In-progress thinking** and **AI text output** separate runs; **settled thinking** also
+  separates runs by default ("思考分隔调用组" on) — with it off, settled thinking folds with the
+  surrounding tool group instead;
+- Expanded state is remembered per session flow + node key; reopening a session with the same keys
+  restores it;
+- Settings are owned by the DSH host config (`~/.dsh/settings.yaml`); browser `localStorage` is
+  only the fallback when the host bridge is unreachable (then each browser needs its own setup);
+- Requires `MutationObserver` and `requestAnimationFrame`; without them it degrades to "fold once on
+  initial render".
+
+---
+
+This project was entirely completed by dsh + deepseek v4 flash(max).

package/README.md

@@ -0,0 +1,120 @@
+# dsh-toolfold · 工具调用折叠
+
+> DSH Web GUI 插件，提供**类 Codex 的工具折叠体验**：把连续的**工具调用**折叠成一条简洁的
+> 折叠条，只展示最后一个调用的一行摘要，点击即可展开/收起。
+> 不替换任何内置渲染器，卸载后界面完全恢复原样。
+
+![折叠效果演示](assets/demo-fold.gif)
+<!-- 🖼️ 图片位：assets/demo-fold.gif —— 建议录制 6~10s：多个工具调用自动折成一条 → 点击展开（卡片瀑布落下）→ 点击收起（卡片上行、高度收缩），16:9，≤2MB -->
+
+## 特性一览
+
+- **连续工具调用折叠为一条**：相邻的工具调用整段收起，条内直接显示**最后一个调用**的一行
+  摘要，并标注「已折叠 N 个工具调用 · 点击展开」；
+- **思考分隔调用组（默认开启）**：已完成的思考会把前后两组工具调用**隔开、各自独立折叠**，
+  不会把思考前后的调用合并成一条；关闭后恢复原折叠方式——思考并入所在工具组一起折叠；
+- **思考默认隐藏，可保留**：已完成的思考默认隐藏（不占版面）；开启「保留思考」后思考不再
+  消失——分隔模式下显示在两条折叠条之间，合并模式下展开时按**原顺序插回调用之间**；
+- **进行中的思考独立显示**：流式思考保持原样可见，完成后按「思考分隔」设置处理；
+- **弹性瀑布动画**：展开时卡片自上而下逐张落下（spring 回弹），收起时逐张上行且行高度同步收缩，
+  下方内容连续上移、结尾无跳变；系统开启「减少动态效果」时动画自动关闭；
+- **贴底不顶出**：靠近底部展开时，折叠条视口位置被钉住，不会因聊天自动滚动被顶出屏幕；
+- **接近零性能占用**：无页面级观察器、流式期间引擎零工作、标签页隐藏时全部暂停——
+  实机测量空闲开销约 0.03% 单核（详见[性能](#性能)）。
+
+![展开/收起动画](assets/expand-collapse.gif)
+<!-- 🖼️ 图片位：assets/expand-collapse.gif —— 建议：单段 3~4 个调用的展开（瀑布落下 + 标签滑左）与收起（上行 + 高度收缩）特写，正方形或 4:3，≤2MB -->
+
+## 安装
+
+
+
+### GitHub 一行安装
+
+```sh
+dsh plugin --profile web add github:Minecraftbe/dsh-toolfold
+```
+
+### 从源码安装
+
+```sh
+git clone https://github.com/Minecraftbe/dsh-toolfold.git
+dsh plugin --profile web add ./dsh-toolfold
+```
+
+装完**重启 dsh 并刷新浏览器**即可生效（bundle 层在启动时合成）。可用以下命令确认已进入
+最终配置：
+
+```sh
+dsh --profile web --dump-config
+```
+
+> 早期版本若曾在 `cordis.patch.yml` 手工加过 `toolfold` 行，先删除该行再切换，避免双挂载。
+
+### 卸载
+
+```sh
+dsh plugin --profile web remove dsh-toolfold
+```
+
+重启后界面完全恢复原样。
+
+## 使用与设置
+
+设置入口：**设置 → 插件 → 工具折叠**（卡片外观与内置插件卡片一致，跟随深浅主题）。
+
+![设置卡片](assets/settings.png)
+<!-- 🖼️ 图片位：assets/settings.png —— 截图建议：设置 → 插件 页内「工具折叠」卡片展开态（时长滑块 + 保留思考开关 + 性能统计开关 + 存储位置提示），浅色主题，PNG/WebP ≤1MB -->
+
+| 设置项 | 说明 |
+| --- | --- |
+| **展开动画时长** | 展开/收起瀑布动画的单卡时长，0–1000ms，默认 240ms；0 为瞬时切换 |
+| **保留思考** | 已完成的思考默认隐藏；开启后思考保留——分隔模式下显示在两条折叠条之间，合并模式下展开时按原顺序插回调用之间 |
+| **思考分隔调用组** | 开启（默认）：已完成的思考把前后两组工具调用隔开、各自独立折叠；关闭：思考并入所在工具组一起折叠（旧行为） |
+| **性能统计** | 在卡片内实时显示插件自身耗时（观察回调/引擎刷新/合并重算/安全重扫/摘要克隆的累计次数与 ms/s，以及被零开销短路忽略的流式批次），用于验证插件开销 |
+
+交互方式：点击折叠条展开/收起；键盘 `Enter` 或 `Space` 同样有效。
+
+### 设置存到哪里
+
+- **已安装（bundle）模式**：设置由 DSH **设置服务**持久化到
+  `~/.dsh/settings.yaml`（命名空间 `toolfold`），与产品和其他插件的设置在同一个文档里，
+  随 dsh 主机走，换浏览器/设备不丢失；卡片底部会显示「设置保存在 DSH 主机配置」。
+  也可以直接手工编辑该文件：
+
+  ```yaml
+  toolfold:
+    durMs: 240        # 展开动画时长 0–2000ms
+    keepThink: false  # 是否保留已完成的思考（显示在折叠条之间 / 展开时插回）
+    splitThink: true  # 是否让已完成的思考隔开前后两组工具调用（默认 true）
+    stats: false      # 是否开启性能统计
+  ```
+
+- **未检测到 DSH 设置服务时**（远程浏览器等未接入 DSH 设置服务的场景）：降级为浏览器
+  `localStorage`（键 `dsh-toolfold.settings.v1`），卡片会显示「仅保存在本浏览器」；
+  旧版键 `dsh-codex-collapse.settings.v1` 首次加载自动迁移。
+
+![保留思考对比](assets/keep-think.gif)
+<!-- 🖼️ 图片位：assets/keep-think.gif —— 建议：同一段调用分别以「保留思考 关 / 开」各演示一次展开，展示思考不显示 / 按原顺序插回，≤2MB -->
+
+## 性能
+
+- **实测（真实 GUI 页面，空闲窗口 8s）**：引擎总耗时约 1.6–2.8ms（≈0.3ms/s，约 0.03% 单核）；
+  同窗口 5s CPU 采样中引擎函数零样本，页面长任务（141–686ms）来自页面加载与产品/其他插件渲染；
+- **流式零工作**：思考/文本 token 流式变更被 O(1) 短路直接忽略，不触发任何重算（约 0.1–0.4µs/节点）；
+- **标签页隐藏 = 字面零占用**：隐藏时断开全部观察器与定时器，回到可见时重挂并补一次对账；
+- 打开「性能统计」即可在设置卡片内实时查看插件自身的每一项耗时。
+
+## 说明与限制
+
+- 折叠基于渲染后的 DOM，依赖产品稳定标记；若产品标记变动，最坏情况是折叠停止生效，不会破坏聊天；
+- **进行中的思考**与 **AI 文字输出**会隔开工具调用；**已完成的思考**默认也会隔开（「思考分隔
+  调用组」开启时），关闭该选项后已完成的思考并入所在工具组一起折叠；
+- 展开状态按会话流 + 节点 key 记忆；会话重开且 key 相同时会恢复展开状态；
+- 设置以 DSH 主机配置（`~/.dsh/settings.yaml`）为准；仅当主机桥不可达时才退化为浏览器
+  `localStorage`（此时换浏览器/设备需重新设置）；
+- 需要浏览器支持 `MutationObserver` 与 `requestAnimationFrame`；不支持时退化为「初始渲染折叠一次」。
+
+---
+
+本项目完全由 dsh + deepseek v4 flash(max) 完成。

package/cordis.patch.yml

@@ -0,0 +1,23 @@
+# dsh-toolfold bundle patch — the `dsh.bundle.patch` layer of the npm package.
+#
+# Installing through the official plugin CLI —
+#
+#   dsh plugin --profile web add dsh-toolfold
+#   (or, from this checkout:  npm run install:dsh)
+#
+# — reconciles `dsh.profile.bundles` against the installed package and, seeing
+# this declaration, appends `dsh-toolfold` to the bundle stack. The profile
+# boot then merges THIS patch (one `insert` of the plugin row) exactly like a
+# manual cordis.patch.yml mount line used to. One command installs AND mounts;
+# no profile file edits needed.
+#
+# The browser half needs no row of its own: the web client loader scans
+# installed bundles for the package's `dsh.client.platform: "web"` manifest
+# and serves `exports["./client"]` to the page.
+#
+# If the profile still carries a manual `toolfold` row from an earlier manual
+# install, remove it before switching to the bundle channel to avoid
+# double-mounting (two host halves, two API routes).
+- insert:
+    - id: toolfold
+      name: 'dsh-toolfold'

package/lib/build-dynamic.cjs

@@ -0,0 +1,69 @@
+/**
+ * build-dynamic.js — generate lib/dynamic-body.js (the `code.client` body for
+ * cordis_define) from lib/client.js.
+ *
+ * The dynamic runner wraps the body in `async () => { ... }` and evaluates it
+ * in a scope where `React` is a closure parameter, so the body must:
+ *   - NOT redeclare `var React` (var hoisting would shadow the closure
+ *     parameter and the settings card would silently never render);
+ *   - end with `return plugin;` (a bare function body has no exports).
+ *
+ * Usage: node lib/build-dynamic.js
+ */
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const srcPath = path.join(__dirname, 'client.js');
+const outPath = path.join(__dirname, 'dynamic-body.js');
+
+let src = fs.readFileSync(srcPath, 'utf8');
+
+// 1. Extract the factory function body: everything between
+//    "factory: function (require) {" and the final "\n});".
+const factoryMarker = 'factory: function (require) {';
+const start = src.indexOf(factoryMarker);
+if (start === -1) throw new Error('factory marker not found in client.js');
+const bodyStart = start + factoryMarker.length;
+
+const endMarker = '\n});';
+const end = src.lastIndexOf(endMarker);
+if (end === -1) throw new Error('module end marker not found in client.js');
+
+let body = src.slice(bodyStart, end);
+// Drop the factory's own closing brace (the trailing "  }").
+body = body.replace(/\n[ \t]*\}\s*$/, '');
+
+// 2. Remove the CommonJS export boilerplate.
+const boilerplate =
+  '    var module = { exports: {} };\n' +
+  '    var exports = module.exports;\n' +
+  '    Object.defineProperty(exports, Symbol.toStringTag, { value: \'Module\' });\n';
+if (body.indexOf(boilerplate) === -1) throw new Error('module boilerplate not found');
+body = body.replace(boilerplate, '');
+
+// 3. Replace the React require block with an explanatory comment (see header).
+const reactBlock =
+  '    // React is a platform seed word in the web shell; the settings card\n' +
+  '    // needs it, the folding engine does not.\n' +
+  '    var React = null;\n' +
+  '    try {\n' +
+  '      React = require(\'react\');\n' +
+  '    } catch (err) {\n' +
+  '      React = null;\n' +
+  '    }\n';
+if (body.indexOf(reactBlock) === -1) throw new Error('React block not found');
+body = body.replace(reactBlock,
+  '    // React is the runner\'s closure parameter; the folding engine does not\n' +
+  '    // need it directly, and redeclaring it here would shadow the parameter.\n');
+
+// 4. Replace the module.exports tail with a bare `return plugin;`.
+const tail =
+  '    module.exports = plugin;\n' +
+  '    return module.exports;';
+if (body.indexOf(tail) === -1) throw new Error('export tail not found');
+body = body.replace(tail, 'return plugin;\n');
+
+fs.writeFileSync(outPath, body, 'utf8');
+console.log('wrote', outPath, body.length, 'bytes');