dsh-agile-workbench 2.0.1 → 2.2.0
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/README.md +21 -0
- package/cordis.patch.yml +9 -2
- package/package.json +1 -1
- package/pm-workbench-dsh/README.md +5 -5
- package/pm-workbench-dsh/index.js +98 -13
- package/pm-workbench-dsh/package.json +1 -1
package/README.md
CHANGED
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
> **一句话安装**:在 DSH 里对 AI 说 **「帮我装一下 dsh-agile-workbench」**。
|
|
4
4
|
>
|
|
5
5
|
> 装完即得到:工作台启动器(`pm_workbench_open`)+ 记忆插件 + 浏览器插件 + 搜索插件 + 视觉插件 + 安全搜索 MCP。
|
|
6
|
+
> **不需要预装 Node.js**(MCP 用运行 DSH 的同一运行时);**第一次打开工作台会自动安装本体**(便携 Node / Electron / 应用,约 2–5 分钟),不会再让你粘命令。
|
|
6
7
|
> node 运行时不用单装,`@deepseek-ai/dsh-base` 已内置 `ptc-runtime-node`。
|
|
7
8
|
|
|
8
9
|
- 包名:`dsh-agile-workbench`
|
|
@@ -35,6 +36,16 @@
|
|
|
35
36
|
|
|
36
37
|
AI 会走 `plugin_manager` 的 `install_bundle`:装包 + 把包名注册进 profile 的 `dsh.profile.bundles`。
|
|
37
38
|
|
|
39
|
+
**一句话之后会自动发生(套装 `dsh-agile-workbench` 2.2.0 · 应用本体 v2.1.0)**:
|
|
40
|
+
|
|
41
|
+
1. 首次打开工作台时,启动器发现本机没有本体 → 自动后台运行官方安装器(便携 Node + Electron + 应用 + 桌面快捷方式),**无需 Node、无需管理员权限**;
|
|
42
|
+
2. 工作台启动/首启后执行一次 **DSH 互通探针**(只读,不写 DSH、不改 asar),结果进 `data/install-result.json` 与「关于」页,失败不阻断;
|
|
43
|
+
3. **可读日志**:每阶段结果写 `data/install-result.json`(`ok/stage/next/warnings[]`),MCP 失败写 `~/.dsh/logs/mcp-*.log`(command/args/errno/stderr),不再只有 "server is disconnected";
|
|
44
|
+
4. **在线升级**:工作台「更多 → 检查更新」;源缺 `sha256` 时显示「暂不可升级」且不下载;强制升级需填原因并写审计;成功提示明确「请重启后生效 / 无需重启」;
|
|
45
|
+
5. **开局引导**:新项目第一次 `boot` 的简报带「可直接复制的下一步命令」+ 红线「禁止用 DSH 子代理代跑团队角色任务」。
|
|
46
|
+
|
|
47
|
+
> 详细 FAQ(`AWB_NO_MIRROR=1`、Electron 缓存兜底、`~/.dsh/logs`、执行策略)见仓库根 `README.md` 的「安装 FAQ(干净 Windows / 无 Node)」。
|
|
48
|
+
|
|
38
49
|
### 方式 B:命令行
|
|
39
50
|
|
|
40
51
|
```powershell
|
|
@@ -120,3 +131,13 @@ dsh-plugin/
|
|
|
120
131
|
4. P0 缺陷当天修;P1 三天内;P2 一周内;P3 两周内。
|
|
121
132
|
|
|
122
133
|
> 完整口径见仓库内《团队宪法》与 `团队/流程.md` 第二部分「现行工作流」。
|
|
134
|
+
|
|
135
|
+
|
|
136
|
+
## 七、零额外步骤(一句话之后会自动做什么)
|
|
137
|
+
|
|
138
|
+
1. AI 调用 `plugin_manager install_bundle` 安装 `dsh-agile-workbench`,6 行插件全部上树;
|
|
139
|
+
2. 第一次对 AI 说「打开工作台」(或 AI 自动调用 `pm_workbench_open`)时:
|
|
140
|
+
- 插件找不到工作台本体 → **自动在后台启动官方安装器**(`install.ps1`:便携 Node、Electron、应用本体、桌面快捷方式);
|
|
141
|
+
- 工具立即返回「正在安装,约 2–5 分钟」;安装完成后再次调用即可打开;
|
|
142
|
+
- 安装日志:`%TEMP%\pm-workbench-install.log`。
|
|
143
|
+
3. 安全搜索 MCP 默认用运行 DSH 的运行时(Electron 下 `ELECTRON_RUN_AS_NODE=1`),**PATH 里没有 node 也能连通**;仍可用环境变量 `DSH_WEB_SEARCH_SAFE_NODE` / `DSH_WEB_SEARCH_SAFE_SCRIPT` 覆盖。
|
package/cordis.patch.yml
CHANGED
|
@@ -24,7 +24,10 @@
|
|
|
24
24
|
# mkdir 抛错、又被静默吞掉,导致 Owner 重启 DSH 后面板永远「未接入」。
|
|
25
25
|
# 现在给默认值;插件侧另有 cfg > env > workbench.json 上溯 > 默认目录 的多级兜底。
|
|
26
26
|
config:
|
|
27
|
-
|
|
27
|
+
# e379:默认值不再写死作者机器路径(旧值 'D:/deepseek/agile-workbench/团队' 在新机器上必然不存在,
|
|
28
|
+
# 插件采集会静默失败 → 面板「未接入」)。现在要求由安装器写 AWB_TEAM_ROOT 用户环境变量,
|
|
29
|
+
# 插件侧还有 cfg → env → workbench.json 上溯多级兜底;解析不到时给出可读 warn(SQ_TEAMROOT_UNRESOLVED)。
|
|
30
|
+
teamRoot: !!js process.env.AWB_TEAM_ROOT || ''
|
|
28
31
|
- id: dsh-memory-evolve
|
|
29
32
|
name: dsh-memory-evolve
|
|
30
33
|
config: {}
|
|
@@ -45,6 +48,10 @@
|
|
|
45
48
|
# 可配置,不写死本机路径:
|
|
46
49
|
# DSH_WEB_SEARCH_SAFE_NODE node 可执行文件(默认 PATH 里的 node)
|
|
47
50
|
# DSH_WEB_SEARCH_SAFE_SCRIPT 安全搜索脚本(默认本包 mcp/web-search-safe.js)
|
|
48
|
-
|
|
51
|
+
# 不依赖 PATH 里的 node:用运行 DSH 的同一运行时(Electron 下配 ELECTRON_RUN_AS_NODE 当 node 用),
|
|
52
|
+
# 这样新机器没装 Node.js 也能立刻连通;仍可用 DSH_WEB_SEARCH_SAFE_NODE 覆盖。
|
|
53
|
+
command: !!js process.env.DSH_WEB_SEARCH_SAFE_NODE || process.execPath
|
|
54
|
+
env:
|
|
55
|
+
ELECTRON_RUN_AS_NODE: '1'
|
|
49
56
|
args:
|
|
50
57
|
- !!js process.env.DSH_WEB_SEARCH_SAFE_SCRIPT || (process.env.DSH_PROFILE_DIR + '/node_modules/dsh-agile-workbench/mcp/web-search-safe.js')
|
package/package.json
CHANGED
|
@@ -70,9 +70,9 @@ pm_workbench_open
|
|
|
70
70
|
3. 插件配置 `workbenchDir`
|
|
71
71
|
4. 环境变量 `PM_WORKBENCH_START`
|
|
72
72
|
5. 环境变量 `PM_WORKBENCH_DIR`
|
|
73
|
-
6.
|
|
74
|
-
7.
|
|
75
|
-
8.
|
|
73
|
+
6. 默认:按运行环境推算的候选目录(`%USERPROFILE%\PM工作台`、`%LOCALAPPDATA%\PM工作台`、`PM_WORKBENCH_HOME`/`DSH_PROFILE_DIR` 推算位置),不再写死任何作者机器路径
|
|
74
|
+
7. 插件装在工作台自身依赖里时,自动向上找 `start.cmd` 所在安装目录
|
|
75
|
+
8. 兜底 `%USERPROFILE%\PM工作台\start.cmd`
|
|
76
76
|
|
|
77
77
|
显式路径(参数/配置/环境变量)不存在时直接报错并列出该路径,**不会**偷偷换成别的目录。
|
|
78
78
|
全部默认路径都找不到时,返回已查找路径、安装命令和手动安装命令。
|
|
@@ -84,13 +84,13 @@ pm_workbench_open
|
|
|
84
84
|
```yaml
|
|
85
85
|
- id: pm-workbench-dsh
|
|
86
86
|
config:
|
|
87
|
-
workbenchDir: '
|
|
87
|
+
workbenchDir: '<你的安装目录>\PM工作台'
|
|
88
88
|
```
|
|
89
89
|
|
|
90
90
|
也可以不写配置,直接用环境变量:
|
|
91
91
|
|
|
92
92
|
```powershell
|
|
93
|
-
$env:PM_WORKBENCH_DIR = '
|
|
93
|
+
$env:PM_WORKBENCH_DIR = '<你的安装目录>\PM工作台'
|
|
94
94
|
```
|
|
95
95
|
|
|
96
96
|
改了配置后需要让插件重新加载(DSH 重启或重新挂载该行)。
|
|
@@ -12,17 +12,20 @@
|
|
|
12
12
|
* 3. 插件配置 workbenchDir
|
|
13
13
|
* 4. 环境变量 PM_WORKBENCH_START
|
|
14
14
|
* 5. 环境变量 PM_WORKBENCH_DIR
|
|
15
|
-
* 6.
|
|
16
|
-
* 7.
|
|
17
|
-
* 8.
|
|
15
|
+
* 6. 默认:按「运行环境 + 安装位置」推算的候选目录(见 DEFAULT_DIRS,不含任何作者机器绝对路径)
|
|
16
|
+
* 7. 插件装在工作台自身依赖里(<安装目录>\node_modules\...)时,自动向上找 start.cmd 的安装目录
|
|
17
|
+
* 8. 兜底:%USERPROFILE%\PM工作台、%LOCALAPPDATA%\PM工作台
|
|
18
18
|
*
|
|
19
|
-
*
|
|
19
|
+
* 找不到时**自动在后台启动官方安装器**(install.ps1,装好 Node/Electron/应用本体),
|
|
20
|
+
* 并返回「正在安装,约 2–5 分钟后重试」;也可传 skipInstall=true 只看安装命令。
|
|
21
|
+
* 不抛异常、不阻塞会话。
|
|
20
22
|
* ============================================================================
|
|
21
23
|
*/
|
|
22
24
|
import { spawn } from 'node:child_process'
|
|
23
25
|
import fs, { existsSync, statSync } from 'node:fs'
|
|
24
26
|
import { homedir } from 'node:os'
|
|
25
27
|
import { basename, dirname, extname, isAbsolute, join, normalize, resolve } from 'node:path'
|
|
28
|
+
import { fileURLToPath } from 'node:url'
|
|
26
29
|
// c9ac 快照 v2:复用 session-queue.js 的唯一组装实现(三条通道共用一套 schema,不另立第二套)。
|
|
27
30
|
import {
|
|
28
31
|
SNAPSHOT_SCHEMA,
|
|
@@ -37,13 +40,31 @@ export const inject = ['tools', 'sessionController']
|
|
|
37
40
|
|
|
38
41
|
const TOOL_NAME = 'pm_workbench_open'
|
|
39
42
|
const START_FILE = 'start.cmd'
|
|
40
|
-
const DEFAULT_DIRS =
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
43
|
+
const DEFAULT_DIRS = (() => {
|
|
44
|
+
// 发版清理(2026-11-19):候选目录全部按运行环境/安装位置推算,不写死任何作者机器路径。
|
|
45
|
+
const dirs = [
|
|
46
|
+
process.env.PM_WORKBENCH_HOME,
|
|
47
|
+
join(homedir(), 'PM工作台'),
|
|
48
|
+
process.env.LOCALAPPDATA ? join(process.env.LOCALAPPDATA, 'PM工作台') : '',
|
|
49
|
+
process.env.DSH_PROFILE_DIR ? join(dirname(process.env.DSH_PROFILE_DIR), 'PM工作台') : '',
|
|
50
|
+
process.env.DSH_PROFILE_DIR ? join(process.env.DSH_PROFILE_DIR, 'PM工作台') : '',
|
|
51
|
+
]
|
|
52
|
+
// 插件被装进工作台自身的依赖(<安装目录>\node_modules\...)时,从插件位置向上找 start.cmd。
|
|
53
|
+
try {
|
|
54
|
+
let cur = dirname(fileURLToPath(import.meta.url))
|
|
55
|
+
for (let i = 0; i < 5; i += 1) {
|
|
56
|
+
if (existsSync(join(cur, START_FILE))) { dirs.unshift(cur); break }
|
|
57
|
+
const parent = dirname(cur)
|
|
58
|
+
if (!parent || parent === cur) break
|
|
59
|
+
cur = parent
|
|
60
|
+
}
|
|
61
|
+
} catch { /* 定位失败不影响其它候选 */ }
|
|
62
|
+
return [...new Set(dirs.filter((dir) => typeof dir === 'string' && dir.trim()))]
|
|
63
|
+
})()
|
|
64
|
+
const INSTALLER_SCRIPT_URL =
|
|
65
|
+
'https://cdn.jsdelivr.net/gh/781237194/agile-workbench@v2.1.0/install.ps1'
|
|
45
66
|
const INSTALL_COMMAND =
|
|
46
|
-
'$f="$env:TEMP\\pm-workbench-install.ps1"; iwr "
|
|
67
|
+
'$f="$env:TEMP\\pm-workbench-install.ps1"; iwr "' + INSTALLER_SCRIPT_URL + '" -OutFile $f; & $f'
|
|
47
68
|
const MANUAL_INSTALL_COMMAND =
|
|
48
69
|
'git clone https://github.com/781237194/agile-workbench.git; cd agile-workbench; npm install'
|
|
49
70
|
|
|
@@ -117,7 +138,7 @@ function resolveLaunchTarget(args, config) {
|
|
|
117
138
|
code: 'PM_WORKBENCH_PATH_INVALID',
|
|
118
139
|
error: `${request.source} 指向的路径不存在,或目录里没有 ${START_FILE}:${toAbsolute(request.value)}`,
|
|
119
140
|
searched: [toAbsolute(request.value)],
|
|
120
|
-
hint: `请把 path / workbenchDir / startScript 指向 PM
|
|
141
|
+
hint: `请把 path / workbenchDir / startScript 指向 PM工作台安装目录(例如用户目录下的 PM工作台,或你选择安装的位置)或 ${START_FILE} 文件。`,
|
|
121
142
|
}
|
|
122
143
|
}
|
|
123
144
|
|
|
@@ -157,6 +178,44 @@ function preflight(target) {
|
|
|
157
178
|
}
|
|
158
179
|
}
|
|
159
180
|
|
|
181
|
+
const INSTALL_INFLIGHT = { startedAt: 0, logFile: '' }
|
|
182
|
+
|
|
183
|
+
/**
|
|
184
|
+
* 找不到工作台本体时自动引导安装:后台启动官方 install.ps1,
|
|
185
|
+
* 立即返回。安装器自己负责便携 Node / Electron / 应用与桌面入口。
|
|
186
|
+
* 5 分钟内重复调用不重复起安装进程。
|
|
187
|
+
*/
|
|
188
|
+
function autoBootstrapInstall() {
|
|
189
|
+
if (INSTALL_INFLIGHT.startedAt && Date.now() - INSTALL_INFLIGHT.startedAt < 5 * 60 * 1000) {
|
|
190
|
+
return { started: false, reused: true, logFile: INSTALL_INFLIGHT.logFile }
|
|
191
|
+
}
|
|
192
|
+
const logDir = process.env.TEMP || process.env.TMP || homedir()
|
|
193
|
+
const logFile = join(logDir, 'pm-workbench-install.log')
|
|
194
|
+
const safeLog = logFile.replace(/'/g, "''")
|
|
195
|
+
const script =
|
|
196
|
+
"$ProgressPreference='SilentlyContinue'; " +
|
|
197
|
+
"$f=Join-Path $env:TEMP 'pm-workbench-install.ps1'; " +
|
|
198
|
+
"try { iwr '" + INSTALLER_SCRIPT_URL + "' -OutFile $f -UseBasicParsing } " +
|
|
199
|
+
"catch { iwr '" + INSTALLER_SCRIPT_URL + "' -OutFile $f }; " +
|
|
200
|
+
"& $f *> '" + safeLog + "'"
|
|
201
|
+
const env = { ...process.env }
|
|
202
|
+
delete env.ELECTRON_RUN_AS_NODE
|
|
203
|
+
let child
|
|
204
|
+
try {
|
|
205
|
+
child = spawn(
|
|
206
|
+
process.env.ComSpec || 'powershell.exe',
|
|
207
|
+
['/d', '/s', '/c', 'powershell -NoProfile -ExecutionPolicy Bypass -Command "' + script + '"'],
|
|
208
|
+
{ detached: true, stdio: 'ignore', windowsHide: true, env },
|
|
209
|
+
)
|
|
210
|
+
} catch (error) {
|
|
211
|
+
return { started: false, error: error?.message ?? String(error), logFile }
|
|
212
|
+
}
|
|
213
|
+
child.unref()
|
|
214
|
+
INSTALL_INFLIGHT.startedAt = Date.now()
|
|
215
|
+
INSTALL_INFLIGHT.logFile = logFile
|
|
216
|
+
return { started: true, pid: child.pid ?? null, logFile }
|
|
217
|
+
}
|
|
218
|
+
|
|
160
219
|
async function launch(target) {
|
|
161
220
|
const workbenchDir = dirname(target)
|
|
162
221
|
const extension = extname(target).toLowerCase()
|
|
@@ -650,7 +709,7 @@ export function apply(ctx, config) {
|
|
|
650
709
|
name: TOOL_NAME,
|
|
651
710
|
description:
|
|
652
711
|
'启动本机的 PM工作台(PM Workbench,Electron 桌面应用)。这是 DSH 启动器插件,不把 Electron UI 嵌入 DSH;' +
|
|
653
|
-
'调用后只负责拉起 start.cmd
|
|
712
|
+
'调用后只负责拉起 start.cmd 并立即返回,不等待工作台退出。默认按安装位置/用户目录自动查找 start.cmd,' +
|
|
654
713
|
'也可用 path 参数或 workbenchDir 配置指定安装目录;找不到时会返回安装命令。',
|
|
655
714
|
parameters: {
|
|
656
715
|
type: 'object',
|
|
@@ -659,6 +718,10 @@ export function apply(ctx, config) {
|
|
|
659
718
|
type: 'string',
|
|
660
719
|
description:
|
|
661
720
|
'可选:PM工作台安装目录或 start.cmd 的绝对路径。省略时依次尝试插件配置、环境变量和默认路径。',
|
|
721
|
+
}, skipInstall: {
|
|
722
|
+
type: 'boolean',
|
|
723
|
+
description:
|
|
724
|
+
'可选:找不到 PM工作台本体时不自动启动安装器,只返回安装命令。默认 false(自动安装)。',
|
|
662
725
|
},
|
|
663
726
|
},
|
|
664
727
|
additionalProperties: false,
|
|
@@ -674,7 +737,29 @@ export function apply(ctx, config) {
|
|
|
674
737
|
async execute(args) {
|
|
675
738
|
const input = args && typeof args === 'object' ? args : {}
|
|
676
739
|
const resolved = resolveLaunchTarget(input, pluginConfig)
|
|
677
|
-
if (!resolved.ok)
|
|
740
|
+
if (!resolved.ok) {
|
|
741
|
+
// 找不到本体:自动引导官方安装器(一句话安装的第 2 步)
|
|
742
|
+
if (resolved.code === 'PM_WORKBENCH_NOT_FOUND' && input.skipInstall !== true) {
|
|
743
|
+
const boot = autoBootstrapInstall()
|
|
744
|
+
return {
|
|
745
|
+
ok: false,
|
|
746
|
+
code: 'PM_WORKBENCH_INSTALLING',
|
|
747
|
+
installing: boot.started || boot.reused === true,
|
|
748
|
+
autoInstallStarted: boot.started,
|
|
749
|
+
pid: boot.pid ?? null,
|
|
750
|
+
logFile: boot.logFile || '',
|
|
751
|
+
retryAfterSeconds: 180,
|
|
752
|
+
installCommand: INSTALL_COMMAND,
|
|
753
|
+
manualInstallCommand: MANUAL_INSTALL_COMMAND,
|
|
754
|
+
message:
|
|
755
|
+
'没有找到 PM工作台本体,已自动开始安装(含便携 Node / Electron / 应用本体)。约 2–5 分钟;完成后再次调用本工具即可打开。',
|
|
756
|
+
hint: '安装日志见 logFile;若 5 分钟后仍失败,把日志末尾贴给 PM 排查。',
|
|
757
|
+
searched: resolved.searched,
|
|
758
|
+
error: resolved.error,
|
|
759
|
+
}
|
|
760
|
+
}
|
|
761
|
+
return resolved
|
|
762
|
+
}
|
|
678
763
|
|
|
679
764
|
const blocked = preflight(resolved.target)
|
|
680
765
|
if (blocked) return blocked
|