dsh-minimal-ptc 0.5.1 → 0.5.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +28 -0
- package/README.en.md +46 -71
- package/README.md +46 -71
- package/docs/CHANGELOG.en.md +17 -0
- package/docs/USAGE.en.md +67 -0
- package/docs/USAGE.md +67 -0
- package/docs/VALIDATION.md +23 -0
- package/lib/index.js +171 -171
- package/package.json +9 -4
- package/presets/ptc-minimal/agent.cordis.yml +16 -0
- package/presets/ptc-minimal/preset.yml +1 -1
- package/ptc-minimal.patch.yml +325 -307
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# 更新记录
|
|
2
|
+
|
|
3
|
+
[返回简介](README.md) · [使用说明](docs/USAGE.md) · [验证记录](docs/VALIDATION.md)
|
|
4
|
+
|
|
5
|
+
[历史英文记录](docs/CHANGELOG.en.md)
|
|
6
|
+
|
|
7
|
+
## 0.5.3 (2026-10-05)
|
|
8
|
+
|
|
9
|
+
- 对齐官方 dsh-v0.2.1-alpha.1 PTC 的定时任务工具与子代理禁止调度规则,保留固定一句提示词、Windows Git Bash 和持久 PowerShell。
|
|
10
|
+
|
|
11
|
+
## 0.5.2 (2026-09-28)
|
|
12
|
+
|
|
13
|
+
- 更新官方 Harness 0.2.0-rc.1 的兼容声明和共同加载验证;运行时代码未变。验证范围见[验证记录](docs/VALIDATION.md)。
|
|
14
|
+
|
|
15
|
+
## 0.5.1 (2026-09-27)
|
|
16
|
+
|
|
17
|
+
补齐 tools 服务依赖声明,让启动健康检查可以在新版 Cordis 宿主中读取工具调度器。
|
|
18
|
+
|
|
19
|
+
## 0.5.0 (2026-09-23)
|
|
20
|
+
|
|
21
|
+
- 使用 Harness 0.1.7 官方的声明式 Agent 预设注册方式,修复升级后模式消失的问题。
|
|
22
|
+
- 预设随插件安装和更新;保留用户旧的 `.agent-presets/ptc-minimal` 目录,不覆盖其中的自定义内容。
|
|
23
|
+
- 启动检查只提示会影响工具运行的核心包副本,不再把 `schemastery`、`cosmokit` 等正常依赖误报为冲突。
|
|
24
|
+
- 使用新版 `workflow-ptc`,保留插件工具、Git Bash、持久 PowerShell、搜索、计划、目标与子代理能力。
|
|
25
|
+
|
|
26
|
+
## 更早的改动
|
|
27
|
+
|
|
28
|
+
完整历史可查阅 [GitHub 提交记录](https://github.com/STARDUSTLC666/dsh-minimal-ptc/commits/main)。
|
package/README.en.md
CHANGED
|
@@ -1,71 +1,46 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
| :-- | :-- | :-- |
|
|
48
|
-
| `shellPath` | auto-detected | Git Bash path |
|
|
49
|
-
| `timeoutMs` | 120000 | Per-command timeout in ms |
|
|
50
|
-
| `maxTimeoutMs` | 600000 | Maximum requested timeout |
|
|
51
|
-
| `maxOutputBytes` | 64000 | Output cap per call |
|
|
52
|
-
| `maxSpillBytes` | 67108864 | Output spill-to-disk cap |
|
|
53
|
-
| `graceMs` | 3000 | Grace period after timeout |
|
|
54
|
-
|
|
55
|
-
## Troubleshooting
|
|
56
|
-
|
|
57
|
-
If the mode is missing, confirm Harness is 0.1.7 or later and restart after installation. Recreating a retired preset directory will not help: the new host does not discover presets there.
|
|
58
|
-
|
|
59
|
-
If every tool fails with `Cannot read properties of undefined (reading 'prepare')`, check startup logs for duplicate runtime packages. Update the plugin bringing in extra `dsh-tools` / `cordis` copies and reinstall dependencies. Do not remove the entire `@deepseek-ai` directory: public helpers are supported dependencies. Another confirmed cause is the host loading two tool build outputs with a module-local scheduler `Symbol`; source builds can use `Symbol.for('@deepseek-ai/dsh-tools.scheduler')` and rebuild.
|
|
60
|
-
|
|
61
|
-
## Uninstall
|
|
62
|
-
|
|
63
|
-
```bash
|
|
64
|
-
dsh plugin --profile web remove dsh-minimal-ptc
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
Restart the Web service afterward.
|
|
68
|
-
|
|
69
|
-
## License
|
|
70
|
-
|
|
71
|
-
MIT
|
|
1
|
+
# dsh-minimal-ptc
|
|
2
|
+
|
|
3
|
+
[中文](README.md)
|
|
4
|
+
|
|
5
|
+

|
|
6
|
+
|
|
7
|
+
Combine the official minimal prompt with PTC orchestration, plugin tools and Windows shell support.
|
|
8
|
+
|
|
9
|
+
[](https://www.npmjs.com/package/dsh-minimal-ptc) [](https://www.npmjs.com/package/dsh-minimal-ptc)
|
|
10
|
+
|
|
11
|
+
## What it does
|
|
12
|
+
|
|
13
|
+
- Use the official run_code entry for multi-step tool calls.
|
|
14
|
+
- Keep files, search, skills, plans, goals and subagent tools.
|
|
15
|
+
- Offer Git Bash and the official persistent PowerShell on Windows.
|
|
16
|
+
|
|
17
|
+
## Install
|
|
18
|
+
|
|
19
|
+
In DSH Desktop, install `dsh-minimal-ptc` from the Plugins panel. If the bundled dsh command is available:
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
dsh plugin --profile desktop add dsh-minimal-ptc
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
For the web version, replace `desktop` with `web`. Restart DSH after installation.
|
|
26
|
+
|
|
27
|
+
## Start using it
|
|
28
|
+
|
|
29
|
+
Restart DSH, create a session and select “Minimal PTC” from the mode selector before describing your task.
|
|
30
|
+
|
|
31
|
+
## Requirements and configuration
|
|
32
|
+
|
|
33
|
+
Uses the official declarative preset interface. Git Bash requires Git for Windows. The guide documents extensions beyond the stock PTC preset.
|
|
34
|
+
|
|
35
|
+
Detailed configuration, tool arguments and troubleshooting are in the [usage guide](docs/USAGE.en.md). For standalone development, follow the Node requirement in [package.json](package.json).
|
|
36
|
+
|
|
37
|
+
## Documentation
|
|
38
|
+
|
|
39
|
+
- [Usage and troubleshooting](docs/USAGE.en.md)
|
|
40
|
+
- [Changelog](CHANGELOG.md)
|
|
41
|
+
- [Validation scope and history](docs/VALIDATION.md)
|
|
42
|
+
- [Report a problem or suggest a feature](https://github.com/STARDUSTLC666/dsh-minimal-ptc/issues)
|
|
43
|
+
|
|
44
|
+
## License
|
|
45
|
+
|
|
46
|
+
[MIT](LICENSE)
|
package/README.md
CHANGED
|
@@ -1,71 +1,46 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
| :-- | :-- | :-- |
|
|
48
|
-
| `shellPath` | 自动探测 | 指定 Git Bash 路径 |
|
|
49
|
-
| `timeoutMs` | 120000 | 单次命令超时,毫秒 |
|
|
50
|
-
| `maxTimeoutMs` | 600000 | 允许请求的最长超时 |
|
|
51
|
-
| `maxOutputBytes` | 64000 | 单次输出上限 |
|
|
52
|
-
| `maxSpillBytes` | 67108864 | 输出落盘上限 |
|
|
53
|
-
| `graceMs` | 3000 | 超时后的退出宽限时间 |
|
|
54
|
-
|
|
55
|
-
## 排错
|
|
56
|
-
|
|
57
|
-
模式未出现时,先确认 DSH 为 0.1.7 及以上且安装后已重启。不要通过重建旧预设目录解决,新宿主不再从该目录发现预设。
|
|
58
|
-
|
|
59
|
-
若每个工具都报 `Cannot read properties of undefined (reading 'prepare')`,查看启动日志中的核心包冲突提示。应升级带入额外 `dsh-tools` / `cordis` 副本的插件并重新安装依赖;不要删除整个 `@deepseek-ai` 目录,官方的公共辅助包属于正常依赖。另一个已确认原因是宿主同时加载两份工具构建产物且调度器键使用模块局部 `Symbol`;源码构建可将其改为 `Symbol.for('@deepseek-ai/dsh-tools.scheduler')` 后重新构建。
|
|
60
|
-
|
|
61
|
-
## 卸载
|
|
62
|
-
|
|
63
|
-
```bash
|
|
64
|
-
dsh plugin --profile web remove dsh-minimal-ptc
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
重启 Web 服务后生效。
|
|
68
|
-
|
|
69
|
-
## License
|
|
70
|
-
|
|
71
|
-
MIT
|
|
1
|
+
# dsh-minimal-ptc
|
|
2
|
+
|
|
3
|
+
[English](README.en.md)
|
|
4
|
+
|
|
5
|
+

|
|
6
|
+
|
|
7
|
+
把官方极简提示词与 PTC 编排组合起来,提供完整插件工具和 Windows 终端适配。
|
|
8
|
+
|
|
9
|
+
[](https://www.npmjs.com/package/dsh-minimal-ptc) [](https://www.npmjs.com/package/dsh-minimal-ptc)
|
|
10
|
+
|
|
11
|
+
## 功能
|
|
12
|
+
|
|
13
|
+
- 以官方 run_code 入口编排多步工具调用。
|
|
14
|
+
- 保留文件、检索、技能、计划、目标和子代理能力。
|
|
15
|
+
- Windows 提供 Git Bash 与官方持久 PowerShell。
|
|
16
|
+
|
|
17
|
+
## 安装
|
|
18
|
+
|
|
19
|
+
桌面版可在「插件」面板按包名 `dsh-minimal-ptc` 安装。已配置 dsh 命令时也可使用:
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
dsh plugin --profile desktop add dsh-minimal-ptc
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
网页版把命令中的 `desktop` 改为 `web`。安装后重启 DSH。
|
|
26
|
+
|
|
27
|
+
## 开始使用
|
|
28
|
+
|
|
29
|
+
安装后重启 DSH,新建会话,在模式选择器中选择「极简 PTC 模式」,然后描述任务。
|
|
30
|
+
|
|
31
|
+
## 依赖与配置
|
|
32
|
+
|
|
33
|
+
使用官方声明式预设接口。Windows 的 Git Bash 需要 Git for Windows;与官方 PTC 的扩展差异见使用说明。
|
|
34
|
+
|
|
35
|
+
详细配置、工具参数与排错见[使用说明](docs/USAGE.md)。从源码独立开发时,Node 要求以 [package.json](package.json) 为准。
|
|
36
|
+
|
|
37
|
+
## 文档
|
|
38
|
+
|
|
39
|
+
- [使用与排错](docs/USAGE.md)
|
|
40
|
+
- [更新记录](CHANGELOG.md)
|
|
41
|
+
- [验证范围与历史记录](docs/VALIDATION.md)
|
|
42
|
+
- [问题反馈与功能建议](https://github.com/STARDUSTLC666/dsh-minimal-ptc/issues)
|
|
43
|
+
|
|
44
|
+
## License
|
|
45
|
+
|
|
46
|
+
[MIT](LICENSE)
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# Historical release notes
|
|
2
|
+
|
|
3
|
+
[Current changelog](../CHANGELOG.md) · [Overview](../README.en.md)
|
|
4
|
+
|
|
5
|
+
These English notes preserve the earlier translations. The main changelog contains the consolidated version history.
|
|
6
|
+
|
|
7
|
+
## 0.5.3 (2026-10-05)
|
|
8
|
+
|
|
9
|
+
- Align with dsh-v0.2.1-alpha.1 PTC scheduling tools and subagent scheduling restrictions while preserving the one-line prompt and Windows shells.
|
|
10
|
+
|
|
11
|
+
## 0.5.1 (2026-09-27)
|
|
12
|
+
|
|
13
|
+
Declares the tools service dependency so the startup health check can inspect the tool scheduler on the current Cordis host.
|
|
14
|
+
|
|
15
|
+
Validation host: Harness `0.2.0-rc.1` built from official sources (commit `407e65c8`) with Node `24.16.0` on 2026-09-28. All 18 plugin tests pass in an isolated environment; all 18 plugins mount together in one host registering 0 tools, with tool schemas and health-check contracts passing. No live ports or external services were exercised in this round.
|
|
16
|
+
|
|
17
|
+
Adds **Minimal PTC** to DeepSeek Harness: a concise system prompt with files, terminals, search, skills and installed plugin tools, orchestrated through `run_code`. Windows includes Git Bash and persistent PowerShell.
|
package/docs/USAGE.en.md
ADDED
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# dsh-minimal-ptc usage guide
|
|
2
|
+
|
|
3
|
+
[Overview](../README.en.md) · [Changelog](../CHANGELOG.md) · [Validation](VALIDATION.md)
|
|
4
|
+
|
|
5
|
+
## Current improvements
|
|
6
|
+
|
|
7
|
+
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.
|
|
8
|
+
|
|
9
|
+
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.
|
|
10
|
+
|
|
11
|
+
## Install and use
|
|
12
|
+
|
|
13
|
+
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.
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
dsh plugin --profile web add dsh-minimal-ptc
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
Restart `dsh web`, start a new session and choose **极简 PTC 模式** (Minimal PTC) from the mode picker above the message box. Describe your task normally; no preset directory or YAML editing is required.
|
|
20
|
+
|
|
21
|
+
For example: “Run this project’s tests, find the failures and fix them.” Existing email, calendar and other plugin tools remain available.
|
|
22
|
+
|
|
23
|
+
## Official presets and extensions
|
|
24
|
+
|
|
25
|
+
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).
|
|
26
|
+
|
|
27
|
+
The following extensions make its defaults differ from the stock PTC preset:
|
|
28
|
+
|
|
29
|
+
- The minimal prompt does not automatically include project AGENTS.md. Rules written by Dream therefore do not automatically enter this mode's context.
|
|
30
|
+
- Windows adds Git Bash and the official persistent PowerShell, while disabling the one-shot PowerShell entry.
|
|
31
|
+
- Ralph and workflow tools are enabled; the official PTC preset disables both by default.
|
|
32
|
+
- Codex, Claude, plugin management and generic `tool-workflow` remain disabled, matching their official defaults.
|
|
33
|
+
|
|
34
|
+
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.
|
|
35
|
+
|
|
36
|
+
## Windows terminals
|
|
37
|
+
|
|
38
|
+
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.
|
|
39
|
+
|
|
40
|
+
Developers creating their own preset can use the bundled `ptc-minimal.patch.yml` as a reference; the executor module is `dsh-minimal-ptc/gitbash-executor`.
|
|
41
|
+
|
|
42
|
+
| Executor option | Default | Purpose |
|
|
43
|
+
| :-- | :-- | :-- |
|
|
44
|
+
| `shellPath` | auto-detected | Git Bash path |
|
|
45
|
+
| `timeoutMs` | 120000 | Per-command timeout in ms |
|
|
46
|
+
| `maxTimeoutMs` | 600000 | Maximum requested timeout |
|
|
47
|
+
| `maxOutputBytes` | 64000 | Output cap per call |
|
|
48
|
+
| `maxSpillBytes` | 67108864 | Output spill-to-disk cap |
|
|
49
|
+
| `graceMs` | 3000 | Grace period after timeout |
|
|
50
|
+
|
|
51
|
+
## Troubleshooting
|
|
52
|
+
|
|
53
|
+
If the mode is missing, confirm Harness is 0.1.7 or later and restart after installation. Recreating a retired preset directory will not help: the new host does not discover presets there.
|
|
54
|
+
|
|
55
|
+
If every tool fails with `Cannot read properties of undefined (reading 'prepare')`, check startup logs for duplicate runtime packages. Update the plugin bringing in extra `dsh-tools` / `cordis` copies and reinstall dependencies. Do not remove the entire `@deepseek-ai` directory: public helpers are supported dependencies. If the problem persists, report the host version and startup error in an issue; do not apply an old host source patch to a newer release without checking it.
|
|
56
|
+
|
|
57
|
+
## Uninstall
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
dsh plugin --profile web remove dsh-minimal-ptc
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
Restart the Web service afterward.
|
|
64
|
+
|
|
65
|
+
## License
|
|
66
|
+
|
|
67
|
+
MIT
|
package/docs/USAGE.md
ADDED
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# dsh-minimal-ptc 使用说明
|
|
2
|
+
|
|
3
|
+
[返回简介](../README.md) · [更新记录](../CHANGELOG.md) · [验证记录](VALIDATION.md)
|
|
4
|
+
|
|
5
|
+
## 本次改进
|
|
6
|
+
|
|
7
|
+
极简 PTC 的主代理现在可使用官方定时任务;spawn / fork 子代理保持官方限制,不可创建、列举、更新或删除任务。极简模式仍不注入运行时上下文、时间提示或 AGENTS 指令。
|
|
8
|
+
|
|
9
|
+
定时工具只在宿主提供 `schedule` 服务时启用。旧版宿主会跳过这个模块,继续使用原有 PTC 能力;无需另外安装 DSH 核心包。
|
|
10
|
+
|
|
11
|
+
## 安装和使用
|
|
12
|
+
|
|
13
|
+
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`。
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
dsh plugin --profile web add dsh-minimal-ptc
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
重启 `dsh web`,新建会话,在输入框上方的模式列表中选择 **极简 PTC 模式**,然后像平时一样描述任务。无需创建预设目录或修改 YAML。
|
|
20
|
+
|
|
21
|
+
例如:「检查这个项目的测试,找出失败原因并修复。」已有的邮件、日历等插件也可按原来的方式使用。
|
|
22
|
+
|
|
23
|
+
## 官方预设与扩展
|
|
24
|
+
|
|
25
|
+
核心提示词与官方 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)。
|
|
26
|
+
|
|
27
|
+
本插件保留以下扩展,因此与官方 PTC 的默认开关并非完全相同:
|
|
28
|
+
|
|
29
|
+
- 使用极简提示词,不自动注入项目 AGENTS.md。Dream 写入的项目规则也不会因此自动进入这个模式的上下文。
|
|
30
|
+
- Windows 增加 Git Bash 和官方持久 PowerShell;停用官方一次性 PowerShell 入口。
|
|
31
|
+
- 启用 Ralph 与 workflow 工具;官方 PTC 默认关闭这两项。
|
|
32
|
+
- Codex、Claude、插件管理与通用 `tool-workflow` 的默认开关仍与官方一致,保持关闭。
|
|
33
|
+
|
|
34
|
+
工具实现由宿主提供,插件不捆绑另一份核心运行时,也不覆盖宿主审批规则。核对范围见[验证记录](VALIDATION.md)。
|
|
35
|
+
|
|
36
|
+
## Windows 终端
|
|
37
|
+
|
|
38
|
+
安装常规版 Git for Windows 后会自动找到 Git Bash。若安装在自定义位置,可设置 `GIT_BASH` 为 `bash.exe` 的完整路径,再启动 DSH。PowerShell 会话会保留当前目录、变量和函数。
|
|
39
|
+
|
|
40
|
+
开发者如需自建预设,可参考包内的 `ptc-minimal.patch.yml`,执行器模块为 `dsh-minimal-ptc/gitbash-executor`。
|
|
41
|
+
|
|
42
|
+
| 执行器选项 | 默认值 | 作用 |
|
|
43
|
+
| :-- | :-- | :-- |
|
|
44
|
+
| `shellPath` | 自动探测 | 指定 Git Bash 路径 |
|
|
45
|
+
| `timeoutMs` | 120000 | 单次命令超时,毫秒 |
|
|
46
|
+
| `maxTimeoutMs` | 600000 | 允许请求的最长超时 |
|
|
47
|
+
| `maxOutputBytes` | 64000 | 单次输出上限 |
|
|
48
|
+
| `maxSpillBytes` | 67108864 | 输出落盘上限 |
|
|
49
|
+
| `graceMs` | 3000 | 超时后的退出宽限时间 |
|
|
50
|
+
|
|
51
|
+
## 排错
|
|
52
|
+
|
|
53
|
+
模式未出现时,先确认 DSH 为 0.1.7 及以上且安装后已重启。不要通过重建旧预设目录解决,新宿主不再从该目录发现预设。
|
|
54
|
+
|
|
55
|
+
若每个工具都报 `Cannot read properties of undefined (reading 'prepare')`,查看启动日志中的核心包冲突提示。应升级带入额外 `dsh-tools` / `cordis` 副本的插件并重新安装依赖;不要删除整个 `@deepseek-ai` 目录,官方的公共辅助包属于正常依赖。仍有问题时,记录宿主版本和启动错误,提交 issue;旧宿主的源码修补不应直接套用到新版本。
|
|
56
|
+
|
|
57
|
+
## 卸载
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
dsh plugin --profile web remove dsh-minimal-ptc
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
重启 Web 服务后生效。
|
|
64
|
+
|
|
65
|
+
## License
|
|
66
|
+
|
|
67
|
+
MIT
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# dsh-minimal-ptc 验证记录
|
|
2
|
+
|
|
3
|
+
本页整理原 README 的历史验证说明,保留当时的版本、日期与范围。自动测试、启动检查、浏览器操作和真实服务验收分别记录,不能相互替代。更详细的版本验收文件仍保留在仓库中。
|
|
4
|
+
|
|
5
|
+
## 2026-10-02:0.5.2 与官方 RC2 源码核对
|
|
6
|
+
|
|
7
|
+
- 官方基线:Harness `0.2.0-rc.2`,提交 `639ed015397290b3745d163aafe02ffee4aa3f84`。
|
|
8
|
+
- YAML 语义比对确认核心提示词匹配官方 Minimal、PTC 展示匹配官方 PTC;[使用说明](USAGE.md#官方预设与扩展)列出了开关与 Windows 终端的差异。
|
|
9
|
+
- 本地 Windows 测试:18 通过、1 按环境跳过、0 失败。
|
|
10
|
+
- 本机 Desktop profile 安装的 0.5.2 链接到当前源码,未发现覆盖本模式的 profile 配置。
|
|
11
|
+
- 本次为源码、安装路径与自动测试核对;未重新进行模型调用或桌面窗口的可见操作。本轮文档整理没有改变预设开关。
|
|
12
|
+
|
|
13
|
+
## 2026-09-28:原中文记录
|
|
14
|
+
|
|
15
|
+
验证宿主:官方源码构建的 Harness `0.2.0-rc.1`(commit `407e65c8`)+ Node `24.16.0`(2026-09-28)。18 项插件测试在隔离环境通过(1 项按环境跳过);同一个宿主里 18 个插件共同加载,工具契约与技能注册通过;极简 PTC 出现在实际网页模式列表中并可选择,真实 Agent 挂载后以 `run_code` 为模型入口,保留插件工具与 Shell。
|
|
16
|
+
|
|
17
|
+
已在沙箱开启的 Windows 隔离工作区通过 `run_code` 实际调用 RSS 插件,重启后再次通过。测试工作区由当前用户拥有完整管理权限,以便宿主设置沙箱权限;外部邮箱、数据库等业务仍需各插件的有效配置。
|
|
18
|
+
|
|
19
|
+
Node 要求为 22.19 及以上的 22.x,或 24 及以上。
|
|
20
|
+
|
|
21
|
+
## 0.5.1 原验证说明
|
|
22
|
+
|
|
23
|
+
验证宿主:官方源码构建的 Harness `0.2.0-rc.1`(commit `407e65c8`)+ Node `24.16.0`(2026-09-28)。18 项插件测试在隔离环境全部通过;同一个宿主里 18 个插件共同加载,注册 0 个工具,工具 schema 与健康检查契约通过。本轮未启用真实端口与外部服务。
|