dsh-minimal-ptc 0.5.4 → 0.5.5

package/CHANGELOG.md

@@ -4,6 +4,12 @@
 
 [历史英文记录](docs/CHANGELOG.en.md)
 
+## 0.5.5 (2026-10-15)
+
+- 修复 DSH 0.2.1-alpha.3 移除子代理 `toolFilter` 后预设挂载失败；子代理仍由官方定时工具拒绝使用提醒，主代理保持定时能力。
+- 提供可直接复制使用的官方 Node 持久执行覆盖补丁与中英文指引，需 DSH 0.2.1-alpha.3 及以上；默认仍为每次独立执行。
+- 明确持久模式的返回值、变量重声明和状态清理行为；读图、自动压缩与 `/compact` 保留官方宿主实现。
+
 ## 0.5.4 (2026-10-05)
 
 - 修复新版 DSH 并行启动时，定时服务就绪较晚导致整套极简 PTC 预设“加载失败”的问题。现在等待服务激活，再通过宿主加载官方定时工具；旧版宿主不会导入缺失的模块。

package/README.en.md

@@ -8,6 +8,8 @@ Combine the official minimal prompt with PTC orchestration, plugin tools and Win
 
 [![npm](https://img.shields.io/npm/v/dsh-minimal-ptc)](https://www.npmjs.com/package/dsh-minimal-ptc) [![downloads](https://raw.githubusercontent.com/STARDUSTLC666/dsh-suite/npm-downloads/assets/dsh-minimal-ptc-downloads.svg)](https://www.npmjs.com/package/dsh-minimal-ptc)
 
+Feedback and contributions are welcome: report [issues](https://github.com/STARDUSTLC666/dsh-minimal-ptc/issues) or submit [pull requests](https://github.com/STARDUSTLC666/dsh-minimal-ptc/pulls).
+
 ## What it does
 
 - Use the official run_code entry for multi-step tool calls.

package/README.md

@@ -8,6 +8,8 @@
 
 [![npm](https://img.shields.io/npm/v/dsh-minimal-ptc)](https://www.npmjs.com/package/dsh-minimal-ptc) [![downloads](https://raw.githubusercontent.com/STARDUSTLC666/dsh-suite/npm-downloads/assets/dsh-minimal-ptc-downloads.svg)](https://www.npmjs.com/package/dsh-minimal-ptc)
 
+欢迎使用，遇到问题或有改进建议，请提交 [issues](https://github.com/STARDUSTLC666/dsh-minimal-ptc/issues) 和 [PR](https://github.com/STARDUSTLC666/dsh-minimal-ptc/pulls)。
+
 ## 功能
 
 - 以官方 run_code 入口编排多步工具调用。

package/docs/USAGE.en.md

@@ -6,11 +6,11 @@
 
 The primary minimal PTC agent can use official scheduling tools. Spawn/fork subagents follow official restrictions against creating, listing, updating or deleting schedules. Minimal mode still omits runtime context, time prompts and AGENTS instructions.
 
-Scheduling tools wait for the host's `schedule` service to activate, avoiding preset failures during parallel startup. Older hosts skip the official scheduling module and retain their existing PTC capabilities; do not install duplicate DSH core packages.
+Scheduling tools wait for the host's `schedule` service to activate, avoiding preset failures during parallel startup. Older hosts skip the scheduling module and retain existing PTC capabilities; do not install duplicate core packages. The retired subagent `toolFilter` field is no longer passed. Official scheduling tools reject delegated callers at execution time.
 
 ## Install and use
 
-Version 0.5.x requires **Harness 0.1.7 or later**. The current official comparison baseline is **0.2.0-rc.2**. Use `dsh-minimal-ptc@0.4.7` on Harness 0.1.5/0.1.6.
+Version 0.5.x requires **Harness 0.1.7 or later**. This iteration compares the official **0.2.1-alpha.3** source. Use `dsh-minimal-ptc@0.4.7` on Harness 0.1.5/0.1.6.
 
 ```bash
 dsh plugin --profile web add dsh-minimal-ptc
@@ -22,7 +22,7 @@ For example: “Run this project’s tests, find the failures and fix them.” E
 
 ## Official presets and extensions
 
-The core prompt matches the official Minimal preset. PTC presentation and the `run_code` entry follow the official PTC preset, registered through the host's declarative preset service. Compare [Minimal](https://github.com/deepseek-ai/deepseek-harness/blob/639ed015397290b3745d163aafe02ffee4aa3f84/packages/bundle/web-app/presets/minimal.patch.yml) and [PTC](https://github.com/deepseek-ai/deepseek-harness/blob/639ed015397290b3745d163aafe02ffee4aa3f84/packages/bundle/web-app/presets/ptc.patch.yml).
+The core prompt matches the official Minimal preset. PTC presentation and the `run_code` entry follow the official PTC preset, registered through the host's declarative preset service. Compare [Minimal](https://github.com/deepseek-ai/deepseek-harness/blob/dsh-v0.2.1-alpha.3/packages/bundle/web-app/presets/minimal.patch.yml) and [PTC](https://github.com/deepseek-ai/deepseek-harness/blob/dsh-v0.2.1-alpha.3/packages/bundle/web-app/presets/ptc.patch.yml).
 
 The following extensions make its defaults differ from the stock PTC preset:
 
@@ -33,6 +33,20 @@ The following extensions make its defaults differ from the stock PTC preset:
 
 The host provides tool implementations. The plugin does not bundle a second core runtime or override host approval policy. See [validation records](VALIDATION.md) for the scope of the comparison.
 
+## Optional: retain intermediate Node state
+
+DSH 0.2.1-alpha.3 adds the official `persistent-in-memory` Node execution mode. The default remains `per-call`; this plugin does not automatically change the shared provider.
+
+Copy the bundled `presets/ptc-minimal/persistent-node.patch.yml` to a convenient location and run `dsh --profile web --patch <path>`. Alternatively, save this override as a local YAML file:
+
+```yaml
+- id: ptc-runtime
+  config:
+    executionMode: persistent-in-memory
+```
+
+This configures the host's shared Node provider while retaining independent state for each Agent. Return a final JSON expression rather than top-level `return`. Repeating a `let`/`const` declaration fails; assign to an existing variable or choose a new name. Restarting, switching modes or terminating the runtime clears its state; save important results to files. Image reading, automatic compaction and `/compact` use the host's official implementations.
+
 ## Windows terminals
 
 A standard Git for Windows installation is detected automatically. For a custom location, set `GIT_BASH` to the full path of `bash.exe` before starting DSH. PowerShell sessions preserve their current directory, variables and functions.

package/docs/USAGE.md

@@ -6,11 +6,11 @@
 
 极简 PTC 的主代理现在可使用官方定时任务；spawn / fork 子代理保持官方限制，不可创建、列举、更新或删除任务。极简模式仍不注入运行时上下文、时间提示或 AGENTS 指令。
 
-定时工具等待宿主的 `schedule` 服务激活后启用，避免启动顺序导致模式加载失败。旧版宿主会跳过官方定时模块，继续使用原有 PTC 能力；无需另外安装 DSH 核心包。
+定时工具等待宿主的 `schedule` 服务激活后启用，避免启动顺序导致模式加载失败。旧版宿主会跳过官方定时模块，继续使用原有 PTC 能力；无需另外安装 DSH 核心包。新版已移除子代理 `toolFilter` 参数，本插件不再传入该字段；官方定时工具会在执行入口拒绝委派子代理使用提醒。
 
 ## 安装和使用
 
-0.5.x 需要 **Harness 0.1.7 及以上**，当前官方核对基线为 **0.2.0-rc.2**。仍使用 Harness 0.1.5/0.1.6 时，请安装 `dsh-minimal-ptc@0.4.7`。
+0.5.x 需要 **Harness 0.1.7 及以上**，本次对照 **0.2.1-alpha.3** 的官方源码。仍使用 Harness 0.1.5/0.1.6 时，请安装 `dsh-minimal-ptc@0.4.7`。
 
 ```bash
 dsh plugin --profile web add dsh-minimal-ptc
@@ -22,7 +22,7 @@ dsh plugin --profile web add dsh-minimal-ptc
 
 ## 官方预设与扩展
 
-核心提示词与官方 Minimal 一致，PTC 工具展示与 `run_code` 入口沿用官方 PTC，通过官方声明式预设服务注册。对照源码：[Minimal](https://github.com/deepseek-ai/deepseek-harness/blob/639ed015397290b3745d163aafe02ffee4aa3f84/packages/bundle/web-app/presets/minimal.patch.yml)、[PTC](https://github.com/deepseek-ai/deepseek-harness/blob/639ed015397290b3745d163aafe02ffee4aa3f84/packages/bundle/web-app/presets/ptc.patch.yml)。
+核心提示词与官方 Minimal 一致，PTC 工具展示与 `run_code` 入口沿用官方 PTC，通过官方声明式预设服务注册。对照源码：[Minimal](https://github.com/deepseek-ai/deepseek-harness/blob/dsh-v0.2.1-alpha.3/packages/bundle/web-app/presets/minimal.patch.yml)、[PTC](https://github.com/deepseek-ai/deepseek-harness/blob/dsh-v0.2.1-alpha.3/packages/bundle/web-app/presets/ptc.patch.yml)。
 
 本插件保留以下扩展，因此与官方 PTC 的默认开关并非完全相同：
 
@@ -33,6 +33,20 @@ dsh plugin --profile web add dsh-minimal-ptc
 
 工具实现由宿主提供，插件不捆绑另一份核心运行时，也不覆盖宿主审批规则。核对范围见[验证记录](VALIDATION.md)。
 
+## 可选：保留 Node 中间变量
+
+DSH 0.2.1-alpha.3 起，官方 Node 执行器可在同一 Agent 的多次 `run_code` 之间保留变量、函数和已导入模块。默认仍是每次独立执行；本插件不会自动切换宿主的执行模式。
+
+需要时，将包内 `presets/ptc-minimal/persistent-node.patch.yml` 复制到方便的位置，执行 `dsh --profile web --patch <该文件路径>`。也可以把以下覆盖配置保存为本机 YAML 文件后使用：
+
+```yaml
+- id: ptc-runtime
+  config:
+    executionMode: persistent-in-memory
+```
+
+此开关作用于宿主共享的 Node provider，每个 Agent 各自保存状态。持久模式用最后一个 JSON 表达式返回结果，不能在顶层使用 `return`；重复声明同名 `let` / `const` 会报错，可改为赋值或使用新变量名。重启、切换执行模式或执行器被终止后状态会清空，重要结果仍应保存到文件。读图、自动压缩和 `/compact` 沿用宿主提供的官方实现。
+
 ## Windows 终端
 
 安装常规版 Git for Windows 后会自动找到 Git Bash。若安装在自定义位置，可设置 `GIT_BASH` 为 `bash.exe` 的完整路径，再启动 DSH。PowerShell 会话会保留当前目录、变量和函数。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-minimal-ptc",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "把官方极简提示词与 PTC 编排组合起来，提供完整插件工具和 Windows 终端适配。",
   "type": "module",
   "main": "lib/index.js",
@@ -11,7 +11,8 @@
     "./cordis.patch.yml": "./cordis.patch.yml",
     "./package.json": "./package.json",
     "./gitbash-executor": "./presets/ptc-minimal/gitbash-executor.mjs",
-    "./schedule-tools": "./presets/ptc-minimal/schedule-tools.mjs"
+    "./schedule-tools": "./presets/ptc-minimal/schedule-tools.mjs",
+    "./persistent-node.patch.yml": "./presets/ptc-minimal/persistent-node.patch.yml"
   },
   "files": [
     "lib",

package/presets/ptc-minimal/agent.cordis.yml

@@ -217,12 +217,6 @@
         toolName: subagent
         modelSelectionSettings: true
         backgroundMode: continuable
-        toolFilter:
-          deny:
-            - schedule_create
-            - schedule_delete
-            - schedule_list
-            - schedule_update
 
     - id: tool-subagent-fork
       name: '@deepseek-ai/dsh-tool-subagent'
@@ -230,12 +224,6 @@
         provider: fork
         toolName: subagent_fork
         backgroundMode: continuable
-        toolFilter:
-          deny:
-            - schedule_create
-            - schedule_delete
-            - schedule_list
-            - schedule_update
 
     # Product providers are host-plane singletons. Remove `disabled` from
     # either ordinary tool row to expose that product to agents on this preset.

package/presets/ptc-minimal/persistent-node.patch.yml

@@ -0,0 +1,6 @@
+# Optional host-provider configuration for DSH 0.2.1-alpha.3 and newer.
+# Apply with `dsh --profile web --patch <this-file>`; the default remains per-call.
+# This configures the shared Node provider. Each Agent's retained state is isolated.
+- id: ptc-runtime
+  config:
+    executionMode: persistent-in-memory

package/ptc-minimal.patch.yml

@@ -229,12 +229,6 @@
                   toolName: subagent
                   modelSelectionSettings: true
                   backgroundMode: continuable
-                  toolFilter:
-                    deny:
-                      - schedule_create
-                      - schedule_delete
-                      - schedule_list
-                      - schedule_update
 
               - id: tool-subagent-fork
                 name: '@deepseek-ai/dsh-tool-subagent'
@@ -242,12 +236,6 @@
                   provider: fork
                   toolName: subagent_fork
                   backgroundMode: continuable
-                  toolFilter:
-                    deny:
-                      - schedule_create
-                      - schedule_delete
-                      - schedule_list
-                      - schedule_update
 
               # Product providers are host-plane singletons. Remove `disabled` from
               # either ordinary tool row to expose that product to agents on this preset.