dsh-minimal-ptc 0.5.3 → 0.5.5

package/CHANGELOG.md

@@ -4,6 +4,16 @@
 
 [历史英文记录](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 预设“加载失败”的问题。现在等待服务激活，再通过宿主加载官方定时工具；旧版宿主不会导入缺失的模块。
+
 ## 0.5.3 (2026-10-05)
 
 - 对齐官方 dsh-v0.2.1-alpha.1 PTC 的定时任务工具与子代理禁止调度规则，保留固定一句提示词、Windows Git Bash 和持久 PowerShell。

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/CHANGELOG.en.md

@@ -4,6 +4,10 @@
 
 These English notes preserve the earlier translations. The main changelog contains the consolidated version history.
 
+## 0.5.4 (2026-10-05)
+
+- Wait for the Host schedule service before importing its official tools. Fixes a parallel startup race that marked the whole preset as failed; hosts without scheduling never import the unavailable module.
+
 ## 0.5.3 (2026-10-05)
 
 - Align with dsh-v0.2.1-alpha.1 PTC scheduling tools and subagent scheduling restrictions while preserving the one-line prompt and Windows shells.

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 activate only when the host provides its `schedule` service. Older hosts skip this 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/docs/VALIDATION.md

@@ -2,6 +2,14 @@
 
 本页整理原 README 的历史验证说明，保留当时的版本、日期与范围。自动测试、启动检查、浏览器操作和真实服务验收分别记录，不能相互替代。更详细的版本验收文件仍保留在仓库中。
 
+## 2026-10-05：0.5.4 启动与可见操作
+
+- Windows 自动测试：22 通过、1 按环境跳过。覆盖旧宿主不导入定时模块、服务延迟到达及模块失败的回报。
+- 官方 npm Harness `0.2.1-alpha.1` 的实际网页中选择「极简 PTC 模式」，通过 `run_code` 调用 SQL，返回 `preset_ok = 1`，并列出 `schedule_create/list/delete/update` 四个官方工具。
+- 工具调用由验证专用脚本选择，未测试模型自主选择工具。全部操作位于隔离配置和合成项目，不涉及用户数据。
+- 本环境「工作区内修改」遇到 `SetNamedSecurityInfoW failed (Win32 5): grantWrite`；上述执行成功发生在隔离会话的「完全权限」模式，之后已恢复原模式。默认权限下的 Windows 沙箱执行仍记为受阻，不建议以降低日常权限来解决。
+- RC2 的完整插件契约验证通过，保留旧宿主兼容；桌面原生窗口未在本轮重新操作。
+
 ## 2026-10-02：0.5.2 与官方 RC2 源码核对
 
 - 官方基线：Harness `0.2.0-rc.2`，提交 `639ed015397290b3745d163aafe02ffee4aa3f84`。

package/lib/index.js

@@ -60,7 +60,7 @@ function materialize(logger, modernRuntime) {
     return
   }
 
-  for (const file of ['agent.cordis.yml', 'preset.yml', 'gitbash-executor.mjs']) {
+  for (const file of ['agent.cordis.yml', 'preset.yml', 'gitbash-executor.mjs', 'schedule-tools.mjs']) {
     let content = readFileSync(join(presetSourceDir, file), 'utf8')
     if (modernRuntime && file === 'agent.cordis.yml') {
       content = content.replaceAll('workflow-worker-thread', 'workflow-ptc')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-minimal-ptc",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "description": "把官方极简提示词与 PTC 编排组合起来，提供完整插件工具和 Windows 终端适配。",
   "type": "module",
   "main": "lib/index.js",
@@ -10,7 +10,9 @@
     },
     "./cordis.patch.yml": "./cordis.patch.yml",
     "./package.json": "./package.json",
-    "./gitbash-executor": "./presets/ptc-minimal/gitbash-executor.mjs"
+    "./gitbash-executor": "./presets/ptc-minimal/gitbash-executor.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

@@ -120,8 +120,7 @@
   name: '@deepseek-ai/dsh-tool-jobs'
 
 - id: tool-schedule
-  name: '@deepseek-ai/dsh-tool-schedule'
-  disabled: !!js "!ctx.get('schedule')"
+  name: ./schedule-tools.mjs
 
 # ── skills ──────────────────────────────────────────────────────────────────
 
@@ -218,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'
@@ -231,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/presets/ptc-minimal/schedule-tools.mjs

@@ -0,0 +1,12 @@
+// Optional Host capability: wait for the service instead of evaluating its
+// current readiness in a Loader `disabled` expression. The official module
+// is resolved by the Host so this preset never bundles a second core copy.
+export const name = 'ptc-minimal-schedule-tools'
+export const inject = ['tools']
+
+export function apply(ctx) {
+  ctx.inject(['schedule'], async (scheduleCtx) => {
+    const exports = await scheduleCtx.loader.import('@deepseek-ai/dsh-tool-schedule')
+    scheduleCtx.plugin(scheduleCtx.loader.unwrapExports(exports))
+  })
+}

package/ptc-minimal.patch.yml

@@ -130,10 +130,9 @@
             name: '@deepseek-ai/dsh-tool-jobs'
 
           - id: tool-schedule
-            name: '@deepseek-ai/dsh-tool-schedule'
-            # Older hosts have no schedule service or module. Disabled rows
-            # are never imported; enable only when the host supplies it.
-            disabled: !!js "!ctx.get('schedule')"
+            # Wait for service activation; do not freeze an early readiness
+            # check into a disabled row while the Host is still booting.
+            name: dsh-minimal-ptc/schedule-tools
 
           # ── skills ──────────────────────────────────────────────────────────────────
 
@@ -230,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'
@@ -243,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.