dsh-deep-ptc-mode 1.7.2 → 1.7.4
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 +105 -71
- package/README.md +204 -174
- package/README.zh.md +219 -189
- package/TEST_REPORT.md +33 -0
- package/lib/ask-user.mjs +2 -1
- package/lib/client.js +59 -9
- package/lib/creative.mjs +127 -0
- package/lib/environment.mjs +2 -1
- package/lib/executor.mjs +31 -6
- package/lib/guard.mjs +2 -1
- package/lib/host.mjs +25 -17
- package/lib/index.mjs +105 -11
- package/lib/jobs-tool.mjs +2 -1
- package/lib/lab.mjs +13 -0
- package/lib/model.mjs +47 -21
- package/lib/official-names.mjs +115 -0
- package/lib/resident.mjs +27 -0
- package/lib/rules.mjs +5 -5
- package/lib/shells.mjs +114 -0
- package/lib/sleep-lint.mjs +391 -41
- package/lib/tool-catalog.mjs +1 -1
- package/lib/tool-compatibility.mjs +29 -11
- package/lib/tool-policy.mjs +250 -184
- package/lib/upstream.mjs +94 -1
- package/package.json +127 -125
- package/lib/official-tools.mjs +0 -8
package/README.zh.md
CHANGED
|
@@ -1,189 +1,219 @@
|
|
|
1
|
-
# 深度 PTC 模式
|
|
2
|
-
|
|
3
|
-
[English](README.md) · MIT · 当前版本:**1.7.
|
|
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
|
-
const
|
|
41
|
-
const
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
|
55
|
-
|
|
|
56
|
-
|
|
|
57
|
-
|
|
|
58
|
-
|
|
|
59
|
-
|
|
|
60
|
-
|
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
|
70
|
-
|
|
|
71
|
-
|
|
|
72
|
-
|
|
|
73
|
-
|
|
|
74
|
-
| `
|
|
75
|
-
| `
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
|
91
|
-
|
|
|
92
|
-
|
|
|
93
|
-
|
|
|
94
|
-
|
|
|
95
|
-
|
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
##
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
```
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
- `lib/
|
|
174
|
-
|
|
175
|
-
- `
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
1
|
+
# 深度 PTC 模式
|
|
2
|
+
|
|
3
|
+
[English](README.md) · MIT · 当前版本:**1.7.4**
|
|
4
|
+
|
|
5
|
+
[1.7.3 实测汇总 / Test summary](TEST_REPORT.md)
|
|
6
|
+
**让插件协作,让当前官方 PTC 工具兜底,让任务始终可沟通。**
|
|
7
|
+
|
|
8
|
+
深度 PTC 是面向插件生态的 DeepSeek Harness Agent 模式(preset):优先在当前可用的外部插件中寻找同功能工具,没有合适能力或插件工具故障时,再用当前官方 PTC 的工具继续完成任务。多个插件可以分工完成同一个任务,各自保留原有参数、发现方式和结果契约;深度 PTC 本身不提供新的任务工具。
|
|
9
|
+
|
|
10
|
+
原有的工作特点完整保留:把模型能力用满,长命令交给后台 job,运行中随时回应你的插话,按任务大小规划,意图不清先问,并在你选择的 WSL / PowerShell / Zsh / Bash 环境执行。
|
|
11
|
+
|
|
12
|
+
## 为「一切皆插件」的协作方式而设计
|
|
13
|
+
|
|
14
|
+
兼容性有两个方向:向官方,跟随当前安装版本的 PTC 组成演进;向外部,允许工具插件参与任务,不把工具清单固定下来。这更贴合 DSH「一切皆插件」的组合理念:模式负责工作规则和故障恢复指引,工具能力由各自的插件负责。
|
|
15
|
+
|
|
16
|
+
| 分工 | 如何协作 |
|
|
17
|
+
| --- | --- |
|
|
18
|
+
| 外部能力优先 | 先按功能寻找可用的插件工具,需要时使用该插件自己的发现/SDK 加载接口 |
|
|
19
|
+
| 多插件相互配合 | 同一任务的不同步骤可以交给不同插件,不要求只绑定某一个增强插件 |
|
|
20
|
+
| 当前官方工具兜底 | 增强能力缺失或故障时,回到当前安装 Harness 的官方 PTC 能力 |
|
|
21
|
+
| 工作方式保持一致 | 保留后台运行、随时插话、澄清、任务规划和所选执行环境 |
|
|
22
|
+
|
|
23
|
+
外部插件需支持当前宿主,并在 `deep-ptc` 的作用域中发布工具;支持保留官方工具的插件,应在自身配置中保留兜底能力。这是任务级的合作选择机制,不代表所有插件或整个替换执行器都能直接互换。OPS 可以作为其中一个提供者,不是内置依赖,也不表示已经完成 OPS 的实际联调。
|
|
24
|
+
|
|
25
|
+
官方兜底沿用 1.6.1 的动态派生机制:自动读取实际运行宿主的官方 PTC 声明;每 5 秒检测声明变化,仅在声明或本插件配置变化时重建预设,工具模块和配置跟随该声明;仅在声明无法读取、解析或派生时使用随包快照并记录日志。官方升级后需重载并创建使用新版预设的会话,既有会话不被强制切换。最低支持当前桌面端 DSH RC `>=0.2.2-rc.1`。只支持 RC,不支持 alpha。不设 RC 上限;更高的 RC 仍需验证宿主接口。
|
|
26
|
+
|
|
27
|
+
## 1.7.2:轻量、按需、可恢复的工具调用层
|
|
28
|
+
|
|
29
|
+
本版增加一个工具与 Skill 的目录入口 `deep_ptc_tools`,具体任务继续交给外部插件和当前官方 PTC 工具完成。
|
|
30
|
+
|
|
31
|
+
- **先搜摘要,再加载定义。** 本地元数据检索优先返回外部工具,未找到匹配项时返回官方候选。默认每页 6 项,最多 8 项;完整 schema 每次最多加载 6 个、总预算 16 KB。普通官方工具继续可用,额外工具按需进入宿主生成的 PTC SDK,最多保留 12 个近期选择。
|
|
32
|
+
- **确认损坏才禁用。** 工具明确不可用(如模块缺失、接口不存在、声明不可用)时立即禁用;临时错误和原因不明的失败连续 3 次才禁用,中间成功一次就清零。参数错误、路径错误、权限拒绝、取消,以及工具正常返回的业务结果(如“构建失败”)都不算工具故障。官方工具不参与禁用,包括配置根层的官方工具(如 `lsp`、`terminal_*`)。禁用后由程序拦截后续调用,故障记录随对话保存;切换 agent、恢复对话或重载插件不会自动解除。调用开始时捕获来源和状态代次,用户重载前的迟到结果不会污染新状态。普通空结果、分页续读和命令非零退出同样不算故障。
|
|
33
|
+
- **任务优先,不查坏工具。** 输入有误就改正,临时错误最多重试两次;工具一旦被禁用,就尽快改用其他可用同类工具或官方工具,不再探测、重试或查根因。仅在写入或命令可能已部分完成时核查必要的任务状态,避免重复操作。
|
|
34
|
+
- **完成时简报。** 模型结束任务时简短列出失败工具与已声明的插件来源;程序同时在回合结束后生成可展开的“工具适配提醒”。来源不明就列工具名,不猜插件身份或故障原因。
|
|
35
|
+
- **输入框下方一键重载。** “重载所有工具状态”仅清除当前对话的故障标记与按需加载选择;不调用模型,也不停止正在运行的任务。另有用户命令 `/deep-ptc-reset-tools`。
|
|
36
|
+
- **Skill 两阶段调用。** 目录只查询宿主已解析的技能元数据和调用权限;选中后使用官方 `skill` 工具加载正文并遵守完整指令,复用上下文中已有指令。检索不读取 Skill 正文。
|
|
37
|
+
|
|
38
|
+
```js
|
|
39
|
+
// 在官方 run_code 中使用;这些操作本身不会执行搜索到的任务工具。
|
|
40
|
+
const matches = await tools.deep_ptc_tools({ action: 'search', query: 'search files' });
|
|
41
|
+
const loaded = await tools.deep_ptc_tools({ action: 'load', names: ['实际工具名'] });
|
|
42
|
+
const skills = await tools.deep_ptc_tools({ action: 'skills', query: 'build test' });
|
|
43
|
+
// 之后按返回的真实 schema 调用工具,或通过官方 skill 加载选定技能。
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
可在 `deep-ptc-settings` 设置 `compactToolCatalog: false` 保留完整宿主 SDK,故障禁用与重载机制仍工作。`toolCompatibility: false` 则停用整套新增调用层。`toolPreferences` 继续支持对已有工具的可选优先关系。
|
|
47
|
+
|
|
48
|
+
精简只作用于当前官方渲染器生成且未被其他插件改写的 SDK 段;插件自建 SDK 继续由其自身加载器管理。外部插件仍须支持当前宿主并在 `deep-ptc` 作用域发布工具;本层不会绕过工具隐藏、授权或接管被卸载的整个执行器。未进行实际 OPS/在线模型端到端评测。
|
|
49
|
+
|
|
50
|
+
## 简介
|
|
51
|
+
|
|
52
|
+
日常 Agent 工作中常见六个问题,深度 PTC 模式逐一针对:
|
|
53
|
+
|
|
54
|
+
| 你遇到的问题 | 深度PTC模式的做法 |
|
|
55
|
+
| --- | --- |
|
|
56
|
+
| 增强工具与自定义模式难以自然配合 | 外部插件能力优先,多提供者按功能协作,故障时使用动态继承的官方 PTC 基线恢复任务 |
|
|
57
|
+
| 模型总想帮你省 token,少查、少测,结果质量打折 | 人设写明「在深度求索工作,本模式 token 预算无限,把预算花在工作上」:不为省 token 跳过读取、搜索、命令或验证;同时禁止注水、啰嗦和撑爆上下文 |
|
|
58
|
+
| 任务跑起来后模型在 sleep 或干等,你发消息它不理 | 由代码强制:前台命令超过 30 秒自动转后台,你一发消息正在等的命令立即转后台、模型马上看到消息,长 sleep 直接拒绝;job 完成会自动唤醒模型(详见下方「代码层强制」) |
|
|
59
|
+
| 不管大小任务都同一种开工方式 | 按预计耗时分三档:5 分钟内自己计划直接做;5–20 分钟先告诉你计划、不等审批就执行;超过 20 分钟先给计划、等你批准 |
|
|
60
|
+
| 意思没弄懂就开干,最后返工 | 意思归用户,事实归工具:不认识的名称、多个可能目标、技术路线、范围和验收标准不确定时先问你(1–3 个带选项的问题),不靠搜索去猜你的意图;文件位置、当前行为这类事实自己查 |
|
|
61
|
+
| 命令环境固定,Windows 上想用 WSL、Mac 上想用 Zsh 都不方便 | 设置里可选 WSL Bash、PowerShell、Zsh(macOS/Linux)或原生 Bash,只对本模式生效,不改全局 shell |
|
|
62
|
+
|
|
63
|
+
使用三步:安装插件 → 在 **设置 → 插件 → 深度 PTC** 里选执行环境 → 新建任务时在模式选择器里选「深度PTC模式」。
|
|
64
|
+
|
|
65
|
+
## 代码层强制:不休眠、随时可插话
|
|
66
|
+
|
|
67
|
+
「不 sleep、不干等」不只写在提示词里,1.5.0 起由插件代码强制执行,由运行时执行以下已覆盖的规则:
|
|
68
|
+
|
|
69
|
+
| 场景 | 代码行为 |
|
|
70
|
+
| --- | --- |
|
|
71
|
+
| 前台命令跑得久 | 超过 **30 秒**(可配置 5–600)自动转为后台 job,命令不会被杀掉;模型请求更长的 `timeoutMs` 也会被压到这个上限 |
|
|
72
|
+
| 命令运行中你发了消息 | 约 2 秒内结束前台等待,命令转入后台继续跑,模型立刻看到你的消息;job 完成后仍会自动唤醒模型 |
|
|
73
|
+
| `job_output` 等待 job | 等待上限同为 30 秒;你一发消息就提前返回;你的消息未读时再次等待会被拒绝 |
|
|
74
|
+
| 模型写 `sleep 60`、`Start-Sleep 30`、`timeout /t 20` | 前台超过 5 秒的暂停直接拒绝(`run_in_background` 的命令不受限);`sleep 1` 这类就绪循环照常 |
|
|
75
|
+
| `run_code` 程序里 `setTimeout`/`setInterval`/`time.sleep` | 仅拒绝能静态确认超过 5 秒的实际等待;未知时长放行;同一程序里轮询同一个运行中 job 超过 3 次也会被拒绝 |
|
|
76
|
+
| `ask_user_question` | 改为限时模式:默认等 120 秒,最多 300 秒,`-1`(无限等)被拒绝;超时后问题变为「待回答」,你之后的回答会作为消息送达;你不点卡片、直接打字回复,也会立刻结束等待 |
|
|
77
|
+
|
|
78
|
+
这些规则只作用于「深度PTC模式」会话,不影响其他模式。前提是桌面端设置里「忙碌时回车」为**插入当前任务(steer)**;若为排队(queue),消息会等整轮结束才送达。
|
|
79
|
+
|
|
80
|
+
```yaml
|
|
81
|
+
- id: deep-ptc-settings
|
|
82
|
+
config:
|
|
83
|
+
foregroundSeconds: 30 # 前台等待上限(秒),5–600
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
## 选择 WSL、PowerShell 或 macOS 工具
|
|
87
|
+
|
|
88
|
+
安装并加载后,打开 **设置 → 插件 → 深度 PTC**,选择执行环境并保存,再新建一个「深度PTC模式」会话。
|
|
89
|
+
|
|
90
|
+
| 选项 | 宿主 | 实际执行方式 / 模型工具 |
|
|
91
|
+
| --- | --- | --- |
|
|
92
|
+
| 自动 | Windows / macOS / Linux | Windows 选 PowerShell,macOS 选 Zsh,Linux 选 Bash |
|
|
93
|
+
| WSL Bash | Windows | `wsl.exe ... --exec bash -lc`,工具名 `bash` |
|
|
94
|
+
| PowerShell | Windows | Harness 官方原生 PowerShell 执行器,工具名 `pwsh` |
|
|
95
|
+
| Zsh | macOS / Linux | macOS 用 `/bin/zsh -lc`;Linux 用已安装的 `zsh`;工具名 `zsh` |
|
|
96
|
+
| 原生 Bash | macOS / Linux | Harness 官方 Bash 执行器,工具名 `bash` |
|
|
97
|
+
|
|
98
|
+
不适用于宿主的选项会禁用,运行时配置也会拒绝这些选择。WSL 发行版留空时使用 Windows 默认发行版,也可填写 `Ubuntu` 等已安装名称。Linux 上选择 Zsh 前需要安装 Zsh。
|
|
99
|
+
|
|
100
|
+
**选择会改变实际执行器和模型看到的命令语法,不只改工具名称。** 执行器隔离在本 preset 中,不修改全局 shell,也不影响其他 preset。保存设置后,新会话使用新版本;已有会话和后台任务继续使用创建时的环境。切换环境时请新建会话,避免同一任务中途换方言。
|
|
101
|
+
|
|
102
|
+
WSL 命令使用 Linux/POSIX 语法;文件工具和 `workdir` 仍用 Windows 宿主路径。执行器用 `--cd` 进入目录,发行版、目录和命令分别作为 argv 传递,不额外拼接 shell 字符串。WSL 内的 PATH、代理等由所选发行版的登录 shell 配置决定,Windows 环境变量不会全部自动变成 Linux 环境变量。
|
|
103
|
+
|
|
104
|
+
### 沙箱边界
|
|
105
|
+
|
|
106
|
+
原生 PowerShell、Bash 和 Zsh 继续使用 Harness 的沙箱、审批和进程管理。WSL 跨越 Windows/Linux 边界,目前仅支持宿主已经授权的 `danger-full-access` 执行;`read-only` 或 `workspace-write` 调用在启动命令前失败。插件不会自行升权、改变默认权限或悄悄换 shell。
|
|
107
|
+
|
|
108
|
+
选择 PowerShell、Bash 或 Zsh 时,可以指定本机已经发现的常见可执行文件。留空则沿用官方查找顺序。WSL 仍只选择发行版。所选文件不存在时记一条警告并回到自动。PowerShell 的选择写入官方执行器的 `pwshPath`。Bash 和 Zsh 只改启动参数。
|
|
109
|
+
|
|
110
|
+
## 插件实验台:官方创造模式,只在内存里试
|
|
111
|
+
|
|
112
|
+
深度 PTC 经常用来编程,也可以用来设计和试写 DSH 插件。**插件实验台**默认关闭。在 **设置 → 插件 → 深度 PTC** 里勾选,然后新建会话。Cordis 配置里的 `pluginLab: true` 是同一个开关。
|
|
113
|
+
|
|
114
|
+
打开后,深度 PTC 用和官方 PTC 相同的方式读取宿主正在发布的**创造模式**:走 `agentPresets.readDocument`,优先名称正好是「创造模式」的预设,否则用已随宿主发布的 id `cordis`。只追加创造模式相对当前 PTC 多出来的那些行。模块名保持该预设原文,官方以后改名时跟着宿主走,不把包名写死在本插件里。创造模式技能目录如果写成相对它自己文件的位置,就按那个预设所在目录解析。桌面端已经挂了宿主运行器,这些行留给宿主,不在深度 PTC 里再挂一份。
|
|
115
|
+
|
|
116
|
+
实验台用来在当前进程里设计和试运行插件:检查当前组合,定义一个通过语法检查的包,再经宿主原有的批准后运行。包只留在本进程内存里,不写入仓库、已发布预设、桌面端组合或本插件源码。宿主的批准保持原样。创造模式预设读不到,或实验工具缺失、失败时,会话继续使用官方 PTC 工具。
|
|
117
|
+
|
|
118
|
+
## dsh-go 与其他外部工具
|
|
119
|
+
|
|
120
|
+
外部插件按它们实际注册出来的工具和工作流接入。先按能力选用,第三方工具失败时官方 PTC 工具仍在,并作为兜底。本包不把任何外部插件(包括 dsh-go)写成依赖。
|
|
121
|
+
|
|
122
|
+
**dsh-go**(手机端,以及手机屏幕控制)在深度 PTC 会话里保持可用:
|
|
123
|
+
|
|
124
|
+
- 屏幕控制工具留在初始 PTC SDK 里,不收进按需目录,失败后也不隔离。满足下面任一条件即可:工具自己标了 `resident`(或 `deepPtc.resident`);展示信息带有 `dsh-go/view`;名称是 `intent`、`collect`、`tap_xy`,或以 `screen_` 开头;提供者标记为 dsh-go、屏幕控制、computer use 或手机控制。其他插件也可以用同一个 `resident` 标记把自己留在初始列表。普通扩展仍按需加载。
|
|
125
|
+
- 深度 PTC 不声明 dsh-go 自己的槽位,也不替换它的设置表单。表单仍来自 Cordis schema,由应用自己渲染。
|
|
126
|
+
- 输入框下方的工具状态控件先读自己的状态。投影缺失、不属于本预设或抛错时,这块控件留空。这里失败不会拆掉输入区,也不会拆掉屏幕控制界面。
|
|
127
|
+
|
|
128
|
+
本版没有在真机上点过手机屏幕控制。上面保证的是 SDK 成员资格、隔离规则,以及界面投影失败时的退让。
|
|
129
|
+
|
|
130
|
+
## 工作规则
|
|
131
|
+
|
|
132
|
+
- **不为 token 省力:** 人设写明在深度求索工作、本模式 token 预算无限,按问题需要而不是成本决定读取、搜索、命令和验证的深度;同时禁止注水和啰嗦,单次上下文仍有限,靠压缩、裁剪和子代理控制。
|
|
133
|
+
- **任务运行中随时可插话:** 由代码强制(见上文),提示词同时要求:不 sleep、不轮询、不挂长时间前台调用。构建、测试、安装、服务器等耗时命令放后台 job,期间继续做短步骤,用不阻塞的方式查看进度;没事可做就一句话说明在跑什么并结束回合,job 完成会自动唤醒模型,你的消息会被立即处理。
|
|
134
|
+
- **按任务长短计划:** ≤5 分钟内部计划直接做,不单独告知;5–20 分钟展示计划后立即执行,不等审批;>20 分钟展示计划并等你批准再改动。估计升档时重新说明计划;显式 plan mode 的规则优先。
|
|
135
|
+
- **意图不清先问:** 意思归用户,事实归工具。不认识的名称、多个可能目标、技术路线、权威来源、做事方式、验收标准和范围不确定时先问,不用搜索去猜你的术语;文件位置、当前行为、版本等可检查的事实自己查。每次 1–3 个带选项的问题,推荐项在前;你的回答优先于模型推断。
|
|
136
|
+
- **进度可见:** 每次 `run_code` 前一句话说明要做什么,里程碑稍长汇报,连续两三个工具调用必须出声。
|
|
137
|
+
- **充分验证并停止,按需委派:** 验证改动触及的行为和边界,满足验收标准后交付;只在任务确实可拆分或需要独立复核时委派,按实际工具渠道收集结果。
|
|
138
|
+
|
|
139
|
+
提示词能改变模型的工作倾向,但不改变实际的 token 上限或计费,也不保证模型每次完全遵守。真正影响思考深度的设置是模型的 `reasoningEffort`。
|
|
140
|
+
|
|
141
|
+
## 安装和升级
|
|
142
|
+
|
|
143
|
+
要求 Node `>=24`、DSH RC `>=0.2.2-rc.1`(当前桌面端)。不支持 alpha 版本。1.3.0 已用 Windows 桌面端 rc.5 做 WSL/PowerShell 命令验证。macOS/Zsh 分支做了配置、工具挂载与参数测试,尚未在 macOS 真机执行。
|
|
144
|
+
|
|
145
|
+
本地目录或构建产物可通过插件管理器安装:
|
|
146
|
+
|
|
147
|
+
```js
|
|
148
|
+
plugin_manager({ action: "install_bundle", target: "dsh-deep-ptc-mode@1.7.4" })
|
|
149
|
+
// 也可从本地目录或安装包安装:
|
|
150
|
+
plugin_manager({ action: "install_bundle", target: "C:\\path\\to\\dsh-deep-ptc-mode" })
|
|
151
|
+
// 或 target: "C:\\path\\to\\dsh-deep-ptc-mode-1.7.4.tgz"
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
GitHub 地址:`github:lishize20040802-rgb/dsh-deep-ptc-mode`。该地址安装远端实际内容;本地升级不会自动发布到 GitHub/npm。
|
|
155
|
+
|
|
156
|
+
已有旧版时,安装同一个 bundle 即更新。从只有 persona 的旧版切到 1.3.0,需要宿主重新加载插件;桌面端若未出现设置卡片,可重新打开应用。安装不会将其他新任务的默认模式改为深度 PTC。
|
|
157
|
+
|
|
158
|
+
设置持久化到当前 profile 的 Cordis patch:
|
|
159
|
+
|
|
160
|
+
```yaml
|
|
161
|
+
- id: deep-ptc-settings
|
|
162
|
+
config:
|
|
163
|
+
environment: wsl # auto | wsl | powershell | zsh | bash
|
|
164
|
+
wslDistribution: Ubuntu # 留空为 Windows 默认发行版
|
|
165
|
+
shellExecutable: '' # 留空沿用官方查找
|
|
166
|
+
pluginLab: false # true 时加载宿主创造模式多出来的行
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
优先使用界面保存,宿主会处理版本冲突和原子配置写入。
|
|
170
|
+
|
|
171
|
+
## 兼容性与维护
|
|
172
|
+
|
|
173
|
+
Deep PTC 在加载时依据已安装 Harness 声明的 PTC 预设(`@deepseek-ai/dsh-web-app/presets/ptc.patch.yml`)现场组合:官方行原样继承,仅替换 persona 文本、把两个互斥 shell 工具换成一个带 `shell` 隔离的执行组、加入可达性守卫,并包装官方 job 与提问工具。包装层和执行组自身不写死任何官方模块名:加载的都是官方行里写的模块(shell 执行器取自基础部署声明 `@deepseek-ai/dsh-base/cordis.patch.yml`),并沿用官方配置。官方怎么改 PTC,本模式无需发版即可继承;官方改名或删除的模块也不会留下失效行。所选执行环境无法对应到官方行时,保留官方 shell 行并在日志中说明。只有在该声明无法解析、读取或解析失败时,才退回内置的 `lib/preset.json` 快照,并在日志中说明。
|
|
174
|
+
|
|
175
|
+
官方声明通过宿主运行时解析,因此插件静态引用的宿主包都必须声明在 `peerDependencies` 中(包括 `@deepseek-ai/dsh-web-app`):对 `link:` 本地安装,宿主只有看到 peer 声明才会把这些包名路由到已安装运行时。漏声明时 `npm run check` 会失败——这正是避免本地安装静默退回快照的关键。`compatibility.json` 记录 fixture 所取自的上游版本及其哈希;`npm run check` 会验证内置回退快照与 fixture 仍组合出同一预设,并检查继承不变量。`engines` 是安装下限,不能证明之后所有宿主都经过测试,遇到新版本先用 `npm run check:upstream -- <path>` 复核。
|
|
176
|
+
|
|
177
|
+
```sh
|
|
178
|
+
npm ci
|
|
179
|
+
npm run check
|
|
180
|
+
npm test
|
|
181
|
+
npm run check:upstream -- /path/to/ptc.patch.yml
|
|
182
|
+
npm run sync:snapshot # 从已安装声明刷新 lib/preset.json 与 lib/base-snapshot.json 回退快照
|
|
183
|
+
PTC_RUNTIME_MODULES=/path/to/dsh/node_modules node scripts/check-preset.cjs # 用真实运行时检查每行模块可解析
|
|
184
|
+
PTC_RUNTIME_MODULES=/path/to/dsh/node_modules node scripts/check-reachability.mjs # 用真实运行时验证可打断等待
|
|
185
|
+
npm pack
|
|
186
|
+
```
|
|
187
|
+
|
|
188
|
+
检查器把 `!!js` 当数据解析,并断言派生不变量:除 persona、shell 行与两个包装行外,官方行必须原样保留(官方把它们嵌进 group 时也同样处理);行 id 唯一;九种平台/环境组合下派生结果确定。测试同时覆盖未来可能出现的组合变化(新增未知行、调整行顺序、删除 shell 行或包装行),以及平台选择、命令边界、受限 WSL 拒绝、设置表单原子保存及并发版本约束。真实任务评测仍应记录成功率、无必要提问、范围控制、后台收尾和耗时。
|
|
189
|
+
|
|
190
|
+
## 文件和卸载
|
|
191
|
+
|
|
192
|
+
- `cordis.patch.yml`:宿主设置入口。
|
|
193
|
+
- `lib/index.mjs`:配置 schema、preset 注册和版本切换。
|
|
194
|
+
- `lib/model.mjs`:平台选择、参数、隔离配置和环境说明,以及从官方声明派生 preset。
|
|
195
|
+
- `lib/executor.mjs`:继承基础部署声明里的官方 bash 执行器,实现 WSL/Zsh。
|
|
196
|
+
- `lib/terminal.mjs`:运行官方声明指定的 shell 工具,等待可被用户消息打断,并提供 Zsh 方言与工具名。
|
|
197
|
+
- `lib/jobs-tool.mjs`、`lib/ask-user.mjs`:运行官方声明指定的 job 工具与提问工具,等待可被用户消息打断。
|
|
198
|
+
- `lib/host.mjs`:通过已安装运行时解析这些官方模块。
|
|
199
|
+
- `lib/guard.mjs`、`lib/rules.mjs`、`lib/sleep-lint.mjs`、`lib/reachable.mjs`:拒绝长暂停与轮询的工具守卫,以及可打断等待的实现。
|
|
200
|
+
- `lib/client.js`:中英文设置卡片。
|
|
201
|
+
- `lib/upstream.mjs`:定位并解析已安装的 PTC 声明。
|
|
202
|
+
- `lib/preset.json`:persona,以及仅在声明不可用时的回退快照。
|
|
203
|
+
- `test/`、`scripts/check.mjs`、`compatibility.json`:回归与上游差异检查。
|
|
204
|
+
|
|
205
|
+
卸载使用插件管理器的 `remove_bundle`,目标为 `dsh-deep-ptc-mode`。本地 link 安装直接依赖源目录,应先卸载再删除目录。
|
|
206
|
+
|
|
207
|
+
## 作者
|
|
208
|
+
|
|
209
|
+
深度PTC模式由 [lishize20040802-rgb](https://github.com/lishize20040802-rgb) 编写与维护。
|
|
210
|
+
|
|
211
|
+
- 问题与需求:[GitHub Issues](https://github.com/lishize20040802-rgb/dsh-deep-ptc-mode/issues)
|
|
212
|
+
- 邮箱:lishize20040802@gmail.com
|
|
213
|
+
|
|
214
|
+
上游 DeepSeek Harness 本身的问题请提到 [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness)。
|
|
215
|
+
|
|
216
|
+
|
|
217
|
+
实际边界:暂停检测识别命令位置和真实等待,字符串、注释、普通定时器回调不当作暂停;可解析常量和乘积,未知时长放行。`wsl -- sleep 20` 会真实暂停,仍拒绝。静态检测不是完整语言解释器。任意 `run_code` 程序、同步子进程或长 workflow 内部的等待,目前不能保证被插话提前结束;这类长工作应使用宿主受管理的后台任务。官方工具无论失败多少次都不隔离,旧错误记录也不应阻断它们;来源不明的工具保持可用,只对来源明确的外部工具执行隔离。
|
|
218
|
+
|
|
219
|
+
1.7.3 优先读取正在运行宿主公开的官方 PTC 注册表;接口不可用时自动寻找实际安装的声明文件,只有这些都不可用才使用带告警的快照。注册表、声明内容或本插件配置变化会自动更新新预设;来源缓存也会随模块文件变化失效,不按预先固定的 DSH 版本选择工具清单。旧会话持有的执行环境和任务不会被强切换。
|
package/TEST_REPORT.md
ADDED
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# 1.7.3 实测汇总 / Test summary
|
|
2
|
+
|
|
3
|
+
日期 / Date: 2026-11-05。测试宿主:Windows 桌面 DSH 0.2.2-rc.1 + WSL Ubuntu、Node 24。此版本是测试样本,运行时不据此固定工具清单。
|
|
4
|
+
|
|
5
|
+
## 中文
|
|
6
|
+
|
|
7
|
+
本版修复官方工具被旧隔离记录误拦、工具来源缓存不更新、暂停检测误判、缺失可执行程序误分类、大 schema 无法加载、适配失败后残留部分注册,以及重载按钮依赖缺失和网关返回结构处理错误。官方预设优先从运行宿主公开注册表读取,接口不可用时查找实际安装声明;仅最终兜底使用快照并告警。声明变化自动更新新预设,不强切换旧会话。
|
|
8
|
+
|
|
9
|
+
| 检查 | 汇总结果 |
|
|
10
|
+
| --- | --- |
|
|
11
|
+
| 自动化回归 | 77 项全通过;暂停检测另含 125 条断言用例,0 不符 |
|
|
12
|
+
| 官方适配 | 隔离宿主实际提供的 28 个官方工具身份、参数和可见性对照通过;官方工具不隔离,来源不明工具保留可用 |
|
|
13
|
+
| 动态更新 | 运行中改变官方声明,新增能力自动进入新预设;旧作用域保持不变。公开注册表变更与来源缓存刷新测试通过 |
|
|
14
|
+
| 降级与协作 | 可选模块/服务缺失、外部插件故障、自身适配失败时,官方 PTC 保持可用;部分注册回滚、大 schema 完整披露通过 |
|
|
15
|
+
| 桌面实测 A | 日志记录 43 次调用、19 种工具(含目录入口)。文件、图片、搜索、shell、job、联网和目标工具正常;4 次有意读取不存在文件失败后,官方 read 仍正常 |
|
|
16
|
+
| 桌面实测 B | 普通 subagent、fork、代理列表、限时提问正常;自有 WSL job 取消后 Linux PID 已消失。对子代理 UUID 使用 teammate 通信接口不满足前置条件,按此记录,不归因插件故障 |
|
|
17
|
+
| 真实插话 | 自动在真实命令开始约 1 秒后发送消息,调用约 2 秒后返回后台 job,原命令继续并完成;区别于伪造事件的单元测试 |
|
|
18
|
+
| 重载按钮 | 实际桌面点击成功,界面和会话命令日志均确认;不触发模型调用、不终止后台任务 |
|
|
19
|
+
| 打包 | 干净目录中在宿主依赖图下加载通过;交接文档与原始审计数据不进入发行包 |
|
|
20
|
+
|
|
21
|
+
边界:静态暂停检测不是完整语言解释器,未知时长放行;任意 `run_code`、同步子进程和长 workflow 内部等待不能保证被插话提前结束,应使用受管理的后台任务。`wsl -- sleep 20` 的实际暂停仍被拒绝。实际桌面未提供 workflow;未为测试创建真实定时任务/工作树,未在 macOS 真机执行。报告不宣称穷尽所有 bug 或全部第三方插件组合。
|
|
22
|
+
|
|
23
|
+
## English
|
|
24
|
+
|
|
25
|
+
The release fixes stale official-tool quarantine, source-cache refresh, false pause detection, missing-executable classification, oversized schema disclosure, partial registration rollback, and the composer's reset dependency/response handling. It prefers the running host's public PTC registry, discovers installed declarations as fallback, and warns before using a bundled snapshot. Changed declarations refresh new generations without switching leased sessions.
|
|
26
|
+
|
|
27
|
+
77 regression tests pass, including a 125-case pause table. Actual-host comparison covers the 28 official capabilities and their identity, schema and visibility. Missing optional services, incompatible plugins and adapter failures preserve official operation. Live declaration changes and registration rollback pass.
|
|
28
|
+
|
|
29
|
+
Desktop audit A records 43 calls across 19 tool names, including the directory; four intentional missing-file reads do not disable official read. File/image/search/shell/job/web/goal operations succeed. Audit B covers subagents, fork, lists and timed questions; cancelling the owned WSL job removes its Linux PID. Teammate-only communication with a subagent UUID is recorded as an unmet precondition, not a plugin defect.
|
|
30
|
+
|
|
31
|
+
A real interjection sent about one second after command start releases its foreground wait about two seconds later; the job continues and completes. The actual composer reset button and command log both confirm success. Clean-package loading passes; private handoffs and raw session logs are excluded.
|
|
32
|
+
|
|
33
|
+
Limits: static pause detection is not a full interpreter; unresolved waits pass through. Arbitrary run_code/synchronous/workflow waits cannot guarantee early steering. Use managed jobs. The real `wsl -- sleep 20` pause remains blocked. No workflow was exposed in the desktop session; live schedules/worktrees and native macOS were not exercised. This is bounded coverage, not a universal defect-free claim.
|
package/lib/ask-user.mjs
CHANGED
|
@@ -9,6 +9,7 @@ export const Config = z.object({
|
|
|
9
9
|
// The official question tool module and its options, as the installed PTC declaration names them.
|
|
10
10
|
upstream: z.string().required(),
|
|
11
11
|
options: z.any(),
|
|
12
|
+
overrides: z.any(),
|
|
12
13
|
});
|
|
13
14
|
|
|
14
15
|
// The official question tool. In timed mode a question the user leaves unanswered becomes pending,
|
|
@@ -17,5 +18,5 @@ export async function apply(ctx, config) {
|
|
|
17
18
|
const watch = steeringWatch(ctx);
|
|
18
19
|
await applyOfficial(ctx, config.upstream, config.options, child => adaptContext(child, {
|
|
19
20
|
userQuestions: questions => steerableQuestions(questions, watch),
|
|
20
|
-
}));
|
|
21
|
+
}), config.overrides);
|
|
21
22
|
}
|