@ch4acko3/dsh-turn-fold 0.3.0 → 0.3.1

package/README.md

@@ -5,6 +5,8 @@ English | [简体中文](README.zh-CN.md)
 A [dsh-harmony](https://github.com/memorax-ai/dsh-harmony) provider that adds
 Codex-Desktop-style turn folding to the DSH WebUI conversation.
 
+https://github.com/user-attachments/assets/3c9dfdcf-a454-4750-9edf-76771ed5a9a6
+
 During a turn, the summary bar remains visible while native thinking, notes,
 commands, and tool calls keep streaming. Consecutive reasoning and tool activity
 share one compact group from the second item onward. When a turn settles, known
@@ -29,7 +31,7 @@ short open/close transition that unmounts the activity after it closes.
 
 ## How it works
 
-Two pinned Source Patches run in memory against the compiled browser bundle of
+Three pinned Source Patches run in memory against the compiled browser bundle of
 `@deepseek-ai/dsh-client-ui-conversation` (`lib/client.js`); installed DSH files
 are never modified.
 
@@ -37,12 +39,13 @@ are never modified.
 | --- | --- | --- |
 | `inject-turn-fold-runtime` | `FunctionDeclaration[name.name="ChatView"], VariableStatement:has(VariableDeclaration[name.name="ChatView"])` | Injects the fold renderer + disclosure UI into either native or decorated `ChatView` |
 | `rewrite-node-render-loop` | `CallExpression[expression.name.name="map"][expression.expression.name="order"]` | Replaces the `order.map(...)` node loop with the per-turn renderer |
+| `install-turn-fold-services` | `VariableStatement:has(VariableDeclaration[name.name="t"][initializer.expression.name.name="bind"])` | Registers the bundled English and Chinese dictionaries through DSH's native locale service and binds the native settings scope |
 
 ## Install
 
 ```sh
 dsh plugin --profile web add github:CH4ACKO3/dsh-turn-fold
-dsh harmony status --profile web   # both patches must be `bound`
+dsh harmony status --profile web   # all three patches must be `bound`
 ```
 
 ## Test
@@ -51,9 +54,31 @@ dsh harmony status --profile web   # both patches must be `bound`
 node test/run.cjs
 ```
 
-`npm install` installs test-only copies of the pinned DSH conversation package,
-TypeScript, and TSQuery. The test suite applies both patches in memory, parses
-the final browser bundle, and covers completed, split-activity, post-closing,
-partial-history, failed, interrupted, open, accessibility, and state-retention
+`npm install` installs the dependencies required by the test harness. The test
+suite applies all three patches in memory, parses the final browser bundle, and
+covers completed, split-activity, post-closing, partial-history, failed,
+interrupted, open, accessibility, localization, settings, and state-retention
 behavior. A missing target or selector mismatch fails the test; it is never
 reported as a skipped pass.
+
+## CI and release
+
+GitHub Actions runs the test suite and a package dry run for every pull request
+and every push to `main`. Version tags publish to npm through Trusted Publishing
+(OIDC), without a long-lived npm token.
+
+Configure the npm trusted publisher once:
+
+```sh
+npx npm@^11.15.0 trust github @ch4acko3/dsh-turn-fold \
+  --repo ch4acko3/dsh-turn-fold \
+  --file release.yml \
+  --allow-publish
+```
+
+Then create and push a version tag whose value matches `package.json`:
+
+```sh
+npm version patch
+git push --follow-tags
+```

package/README.zh-CN.md

@@ -4,6 +4,8 @@
 
 一个基于 [dsh-harmony](https://github.com/memorax-ai/dsh-harmony) 的 Provider，为 DSH WebUI 对话添加 Codex Desktop 风格的回合折叠。
 
+https://github.com/user-attachments/assets/3c9dfdcf-a454-4750-9edf-76771ed5a9a6
+
 回合进行期间，摘要栏保持可见，原生思考、说明、命令和工具调用继续流式输出。从第二项开始，连续的推理和工具活动会合并为一个紧凑分组。回合结束后，包括上下文注入在内的已知 Agent 活动会收进最终答复前方的折叠栏。摘要指标可以配置，默认显示耗时、工具调用次数以及输入/输出 token；只有当已加载的回合包含足够数据、无需猜测即可计算时才会展示对应指标。
 
 最终答复通过 `turn-tail.closing.finalNode` 定位，不依赖 `finish_reason` 或 DOM 位置。正常完成、已停止和已中断的回合都会折叠，后两者显示不同的状态标签。当 DSH 将结束分支标记为不可用、结束答复之后仍有节点，或者用户的键盘焦点或文本选择位于活动内容中时，回合会保持展开。失败、达到最大 token、缺少结束节点以及仍在进行的回合也会保持展开，避免隐藏错误或未完成的工作。
@@ -12,18 +14,19 @@
 
 ## 工作原理
 
-两个固定目标的 Source Patch 会在内存中修改 `@deepseek-ai/dsh-client-ui-conversation` 的编译后浏览器包（`lib/client.js`），不会修改已安装的 DSH 文件。
+三个固定目标的 Source Patch 会在内存中修改 `@deepseek-ai/dsh-client-ui-conversation` 的编译后浏览器包（`lib/client.js`），不会修改已安装的 DSH 文件。
 
 | Patch | 选择器（预期命中 1 次） | 作用 |
 | --- | --- | --- |
 | `inject-turn-fold-runtime` | `FunctionDeclaration[name.name="ChatView"], VariableStatement:has(VariableDeclaration[name.name="ChatView"])` | 向原生或已装饰的 `ChatView` 注入折叠渲染器和折叠 UI |
 | `rewrite-node-render-loop` | `CallExpression[expression.name.name="map"][expression.expression.name="order"]` | 将 `order.map(...)` 节点循环替换为按回合渲染器 |
+| `install-turn-fold-services` | `VariableStatement:has(VariableDeclaration[name.name="t"][initializer.expression.name.name="bind"])` | 通过 DSH 原生语言服务注册内置的中英文词典，并绑定原生设置作用域 |
 
 ## 安装
 
 ```sh
 dsh plugin --profile web add github:CH4ACKO3/dsh-turn-fold
-dsh harmony status --profile web   # 两个 Patch 都必须为 `bound`
+dsh harmony status --profile web   # 三个 Patch 都必须为 `bound`
 ```
 
 ## 测试
@@ -32,4 +35,26 @@ dsh harmony status --profile web   # 两个 Patch 都必须为 `bound`
 node test/run.cjs
 ```
 
-`npm install` 会安装仅用于测试的固定版本 DSH 对话包、TypeScript 和 TSQuery。测试套件会在内存中应用两个 Patch、解析最终浏览器包，并覆盖已完成回合、分段活动、结束后活动、部分历史、失败、中断、进行中、无障碍和状态保留等行为。目标缺失或选择器不匹配会使测试失败，不会被报告为跳过后通过。
+`npm install` 会安装测试工具所需的依赖。测试套件会在内存中应用三个 Patch、解析最终浏览器包，并覆盖已完成回合、分段活动、结束后活动、部分历史、失败、中断、进行中、无障碍、本地化、设置和状态保留等行为。目标缺失或选择器不匹配会使测试失败，不会被报告为跳过后通过。
+
+## CI 与发布
+
+GitHub Actions 会在每个 Pull Request 和每次推送到 `main` 时运行测试套件及
+包内容预检。版本标签通过 Trusted Publishing（OIDC）发布到 npm，无需保存
+长期 npm Token。
+
+首次使用时配置一次 npm 可信发布者：
+
+```sh
+npx npm@^11.15.0 trust github @ch4acko3/dsh-turn-fold \
+  --repo ch4acko3/dsh-turn-fold \
+  --file release.yml \
+  --allow-publish
+```
+
+之后创建与 `package.json` 版本一致的标签并推送：
+
+```sh
+npm version patch
+git push --follow-tags
+```

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@ch4acko3/dsh-turn-fold",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Codex-style turn folding for the DSH WebUI conversation, implemented as a dsh-harmony provider.",
   "main": "./index.cjs",
+  "engines": {
+    "node": "^22.22.3 || >=24.11.1"
+  },
   "files": [
     "README.md",
     "README.zh-CN.md",
@@ -20,7 +23,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/ch4acko3/dsh-turn-fold.git"
+    "url": "https://github.com/CH4ACKO3/dsh-turn-fold"
   },
   "dsh": {
     "bundle": {
@@ -47,12 +50,18 @@
     "check": "node test/run.cjs"
   },
   "dependencies": {
-    "@deepseek-ai/dsh-settings": "0.1.0-rc.8",
     "@deepseek-ai/schemastery": "^3.18.1"
   },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.8",
+    "dsh-harmony": "^0.7.0"
+  },
   "devDependencies": {
     "@deepseek-ai/dsh-client-ui-conversation": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-settings": "0.1.0-rc.8",
     "@phenomnomnominal/tsquery": "^6.2.0",
+    "dsh-harmony": "^0.7.0",
     "react": "18.3.1",
     "react-test-renderer": "18.3.1",
     "typescript": "^6.0.3"

package/patch.cjs

@@ -13,7 +13,7 @@
 //   3. install-turn-fold-services — registers the plugin's native DSH locale
 //      namespace and binds its native settings scope during conversation boot.
 //
-// Both selectors are pinned with an exact `expect: 1` and a target version so
+// All three selectors are pinned with an exact `expect: 1` and a target version so
 // a compiled-shape drift fails loudly in `dsh harmony status`.
 
 const INLINE = require('./inline-source.cjs')
@@ -21,7 +21,7 @@ const INLINE = require('./inline-source.cjs')
 const TARGET = {
   package: '@deepseek-ai/dsh-client-ui-conversation',
   version: '0.1.0-rc.8',
-  files: ['lib/client.js'],
+  file: 'lib/client.js',
 }
 
 module.exports = [