dsh-plugin-dingtalk-bridge 0.3.9 → 0.4.1

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 CHANGED
@@ -26,7 +26,9 @@
26
26
  - **Star / Issue 入口**:面板右上角「使用说明」旁边有 **★ Star** 与 **提交 Issue**,说明卡底部也有同样的链接与 npm 入口,方便反馈问题。
27
27
  - **彩色插件图标**:侧边栏与面板标题使用 3D 机器人图标,宿主提供 `GET /icon` 路由,加载失败时回退单色 SVG。
28
28
  - **授权与去重**:默认 `loginMode=loopback`(浏览器授权,**不需要授权码**);`loginReset=true` 时重新授权会先 `dws auth logout --yes` 退出旧组织,只保留本次登录的组织;也支持手动「退出」。
29
- - **dws 自动检测 / 安装 / 更新**:插件启动时只做检测,不会偷偷装东西。如果这台机器没有 `dws`,面板顶部会出现一条提示,点 **安装 dws** 即自动安装:有 npm 时执行 `npm install -g dingtalk-workspace-cli`(含 npm 12 会拦掉的 `install.js` 准备步骤),**没有 npm 时直接下载 npm 包 tarball 解压到插件数据目录**(自带纯 Node 解压器,不依赖系统 tar),两条路径都会自动定位 `vendor/dws.exe`。已装的话点 **检查更新** 能看到最新版本,再点 **更新到 vX** 升级。收件箱提示卡与设置页按钮都能触发,npm 源可用 `dwsRegistry` 换成国内镜像。
29
+ - **dws 自动检测 / 安装 / 更新**:插件启动时只做检测,不会偷偷装东西。如果这台机器没有 `dws`,面板顶部会出现一条提示,点 **安装 dws** 即自动安装:有 npm 时执行 `npm install -g dingtalk-workspace-cli`(含 npm 12 会拦掉的 `install.js` 准备步骤),**没有 npm 时直接下载 npm 包 tarball 解压到插件数据目录**(自带纯 Node 解压器,不依赖系统 tar),两条路径都会自动定位 `vendor/dws.exe`。已装的话点 **检查更新** 能看到最新版本,再点 **更新到 vX** 升级。收件箱提示卡与设置页按钮都能触发,npm 源可用 `dwsRegistry` 换成国内镜像。安装过程分五步展示进度与耗时,tarball 会本地缓存,同版本重装秒完成;**卸载插件再装回来也不会误报「未安装」**——配置路径不可用时会自动去插件数据目录、npm 全局目录、PATH 里找一遍。
30
+ - **安装进度可见**:安装时卡片会显示 **五步清单**(读取版本信息 → 下载安装包 → 解压 → 准备可执行文件 → 校验版本),每步带 ✓/◐/○ 与耗时,下载实时显示 MB 与百分比,标题还带「已用时 Ns」;同一版本重复安装直接命中 `dws-cache` 缓存。
31
+ - **「没登录」不等于「dws 坏了」**:dws 可用但还没登录时,面板显示黄点「未登录钉钉 · 点右上角「钉钉授权」」,授权入口照常可用(0.4.0 修掉了旧版 `dws not ready` 死循环)。
30
32
  - **演练模式**:`dryRun=true` 时只预览将发送的内容(`dws --dry-run`),不真正发到钉钉,适合先试跑。
31
33
  - **持久化与自愈**:状态存在 `<DSH_HOME>/integrations/dingtalk-bridge/state.json`(tmp + rename 原子写,mode 0600),图片在 `.../media/`;早于 2020 年或超前一天的时间戳重置为当前时间,旧版 `confirmation_required` 失败记录自动清掉。
32
34
 
@@ -78,7 +80,7 @@ DSH → 插件市场(Open Plugin Market)→ 搜索 `dsh-plugin-dingtalk-brid
78
80
  **方式三 · 手动装 npm 包**
79
81
 
80
82
  ```bash
81
- npm i -g dsh-plugin-dingtalk-bridge@0.3.9 # 或装到 profile 的 dependencies 里
83
+ npm i -g dsh-plugin-dingtalk-bridge@0.4.0 # 或装到 profile 的 dependencies 里
82
84
  ```
83
85
 
84
86
  然后在 DSH profile 的 `package.json` 的 `dsh.profile.bundles` 里加入 `"dsh-plugin-dingtalk-bridge"`,执行 `pnpm install`,重启 DSH。
@@ -122,7 +124,7 @@ npm i -g dsh-plugin-dingtalk-bridge@0.3.9 # 或装到 profile 的 dependencies
122
124
  | 配置 | 类型 / 默认 | 说明 |
123
125
  | --- | --- | --- |
124
126
  | `enabled` | bool / `true` | 总开关,关闭后不启动事件监听、不注册路由。 |
125
- | `dwsPath` | string / `dws` | dws 可执行文件路径;已在 PATH 里就留 `dws`。安装成功后插件会自动指向 npm 全局包里的 `vendor/dws.exe`。 |
127
+ | `dwsPath` | string / `dws` | dws 可执行文件路径;已在 PATH 里就留 `dws`。安装成功后插件会自动指向 `vendor/dws.exe`(并写进 `state.json`);这个值不可用时插件会自动在常见安装位置里找回已装的 dws。 |
126
128
  | `dwsRegistry` | string / `https://registry.npmjs.org/` | 自动安装 / 更新 dws 时用的 npm 源,只在点「安装 dws」「更新 dws」时生效,可换国内镜像。 |
127
129
  | `profiles` | string[] / `[]` | 只监听这些组织(profile 标识);留空表示跟随 dws 当前登录账号。 |
128
130
  | `listenDirect` | bool / `true` | 是否接收私信。 |
@@ -182,6 +184,7 @@ npm i -g dsh-plugin-dingtalk-bridge@0.3.9 # 或装到 profile 的 dependencies
182
184
  | --- | --- |
183
185
  | 点授权报错 `'dws' 不是内部或外部命令` / `spawn dws ENOENT` | 这台机器没装 dws。点「钉钉授权」时插件会先拦住并提示去安装;在提示卡或设置页点 **安装 dws** 即可:有 npm 走全局安装,**没有 npm 也能装**(直接下载 npm 包解压,自带解压器,并借用 DSH 自带的 Node 跑 `install.js`)。装完自动重新检测并开始接收。 |
184
186
  | 想升级 dws | 点提示卡或设置页的 **检查更新**(只查 npm 上的版本),发现新版后点 **更新到 vX**;npm 源慢就改 `dwsRegistry`(如 `https://registry.npmmirror.com/`)。 |
187
+ | 卸载插件再装回来,又说「未安装 dws」 | 0.4.1 起会自动找回:`dws --version` 失败时插件会依次探测「配置的 `dwsPath` → 插件数据目录 `dws-runtime/…/vendor` → Node 同目录 `node_modules` → `%APPDATA%\npm` / `Program Files\nodejs`(macOS/Linux 为 `/usr/local/lib`、`/opt/homebrew/lib`、`/usr/lib`)→ PATH → `npm root -g`」,命中就写回 `dwsPath` 并落盘。装在哪、怎么彻底重装见使用说明 **10.0.1**;设置页「dws 路径」一行显示实际使用的可执行文件。 |
185
188
  | 点「钉钉授权」后没有二维码 | **默认 loopback 模式本来就没有二维码**——弹框里是授权说明 + **打开钉钉授权页面** 按钮,浏览器会自动弹出授权页;没弹出就点 **复制链接**。只有 `loginMode=device` 才显示二维码。 |
186
189
  | 授权页要求输入授权码 | 说明 `loginMode` 是 `device`(设备流)。改回 `loopback` 并重启 DSH,即浏览器授权、无需授权码。 |
187
190
  | 每授权一次「实时监听中 · N 个组织」就多一个 | 钉钉登录态按组织累积。`loginReset: true`(默认)会在重新授权前先 `dws auth logout --yes` 退出全部旧组织,只保留本次登录的组织;想把现有组织清干净就点面板右上 **退出** 再重新授权。 |
package/client.js CHANGED
@@ -24,7 +24,7 @@ window.__ModuleLoader__.load({
24
24
  const POLL_MS = 5000
25
25
  const SOFT_POLL_MS = 30000
26
26
  // 与 package.json 的 version 保持一致:宿主上报的 build 前缀对不上,说明 DSH 还在跑旧宿主代码。
27
- const CLIENT_BUILD = '0.3.9'
27
+ const CLIENT_BUILD = '0.4.1'
28
28
  // 源码仓库(GitHub):Star 与 Issue 入口都指向这里
29
29
  const REPO_URL = 'https://github.com/gcggcg/dsh-plugin-dingtalk-bridge'
30
30
  const ISSUES_URL = `${REPO_URL}/issues`
@@ -171,6 +171,13 @@ window.__ModuleLoader__.load({
171
171
  .dsh-dt-install-log summary{cursor:pointer;color:${C.brand}}
172
172
  .dsh-dt-install-log pre{margin:6px 0 0;padding:8px 10px;border-radius:8px;background:${C.layer2};
173
173
  border:1px solid ${C.border1};font-size:11.5px;line-height:1.5;max-height:180px;overflow:auto;white-space:pre-wrap}
174
+ .dsh-dt-steps{margin-top:8px;display:flex;flex-direction:column;gap:3px;font-size:12px;line-height:1.55}
175
+ .dsh-dt-step{display:flex;align-items:baseline;gap:7px;min-width:0}
176
+ .dsh-dt-stepmark{width:12px;flex:none;text-align:center;font-weight:600}
177
+ .dsh-dt-step[data-step="running"] .dsh-dt-stepmark{animation:dsh-dt-pulse 1.1s ease-in-out infinite}
178
+ .dsh-dt-steplabel{flex:none}
179
+ .dsh-dt-stepdetail{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;opacity:.8}
180
+ .dsh-dt-stepms{flex:none;opacity:.6;font-variant-numeric:tabular-nums}
174
181
  .dsh-dt-listbox{margin:0 20px 16px;border:1px solid ${C.border1};border-radius:14px;background:${C.layer1};
175
182
  box-shadow:0 1px 2px rgba(16,24,40,.04);display:flex;flex-direction:column;
176
183
  height:calc(100vh - 330px);min-height:340px;max-height:900px;overflow:hidden}
@@ -291,7 +298,7 @@ window.__ModuleLoader__.load({
291
298
  margin:12px 20px;box-sizing:border-box}
292
299
  .dsh-dt-kv{display:grid;grid-template-columns:150px 1fr;gap:8px 14px;font-size:12.5px;margin-top:12px}
293
300
  .dsh-dt-kv dt{color:${C.sub}}
294
- .dsh-dt-kv dd{margin:0;color:${C.text};word-break:break-word}
301
+ .dsh-dt-kv dd{margin:0;color:${C.text};word-break:break-word;overflow-wrap:anywhere}
295
302
  @keyframes dsh-dt-pulse{0%,100%{opacity:1}50%{opacity:.4}}
296
303
  @keyframes dsh-dt-fade{from{opacity:0}to{opacity:1}}
297
304
  @keyframes dsh-dt-rise{from{opacity:0;transform:translateY(10px) scale(.99)}to{opacity:1;transform:none}}
@@ -1148,7 +1155,20 @@ window.__ModuleLoader__.load({
1148
1155
  const expiredNote = expired > 0 ? ` · ${expired} 个组织登录已过期,建议重新授权` : ''
1149
1156
  if (!state || !state.enabled) return { dot: 'error', text: '插件已禁用', detail: '在设置 → 插件中启用后可用' }
1150
1157
  if (!state.tool || !state.tool.ok) {
1151
- return { dot: 'error', text: 'dws 未就绪', detail: state.tool && state.tool.error ? state.tool.error : '请检查 dws 是否已安装并登录' }
1158
+ return {
1159
+ dot: 'error',
1160
+ text: 'dws 未就绪',
1161
+ detail: state.tool && state.tool.error ? state.tool.error : '请先在下方提示卡里点「安装 dws」',
1162
+ }
1163
+ }
1164
+ const profileCount = Array.isArray(state.profiles) ? state.profiles.length : 0
1165
+ if (profileCount === 0) {
1166
+ // dws 能用但还没登录钉钉:这不是故障,引导去授权,别显示成「dws 未就绪」。
1167
+ return {
1168
+ dot: 'connecting',
1169
+ text: '未登录钉钉',
1170
+ detail: state.loginNotice || '点右上角「钉钉授权」,扫码或登录后即可开始接收私信与群 @',
1171
+ }
1152
1172
  }
1153
1173
  if (online.length > 0) {
1154
1174
  return {
@@ -1323,16 +1343,29 @@ window.__ModuleLoader__.load({
1323
1343
  const latest = String(install.latestVersion || '')
1324
1344
  const updateAvailable = Boolean(status === 'ready' && latest && current && latest !== current)
1325
1345
  const ready = Boolean(tool.ok)
1326
- if (ready && !updateAvailable) return null
1346
+ const steps = Array.isArray(install.steps) ? install.steps : []
1347
+ const running = steps.some((step) => step.status === 'running')
1348
+ const startedAt = Number(install.startedAt) || 0
1349
+ // 安装中每秒刷新一次「已用时」,用户能直观看到还在动。
1350
+ const [, tickNow] = useState(Date.now())
1351
+ useEffect(() => {
1352
+ if (!running) return undefined
1353
+ const timer = setInterval(() => tickNow(Date.now()), 1000)
1354
+ return () => clearInterval(timer)
1355
+ }, [running])
1356
+ if (ready && !updateAvailable && steps.length === 0) return null
1327
1357
 
1328
1358
  const source = String(install.source || '配置的 npm 源')
1329
1359
  const busy = props.busy || ''
1330
1360
  const installing = status === 'installing' || busy === 'install-dws' || busy === 'update-dws'
1331
1361
  const failed = status === 'error'
1332
1362
  const tone = failed ? C.error : installing ? C.brand : C.warn
1363
+ const elapsed = startedAt > 0 ? Math.max(0, Math.round((Date.now() - startedAt) / 1000)) : 0
1364
+ const currentStep = steps.find((step) => step.status === 'running')
1365
+ const doneCount = steps.filter((step) => step.status === 'done').length
1333
1366
 
1334
1367
  const headline = installing
1335
- ? `正在安装 dws${install.targetVersion ? ` v${install.targetVersion}` : ''}…`
1368
+ ? `正在安装 dws${install.targetVersion ? ` v${install.targetVersion}` : ''}${currentStep ? ` · ${currentStep.label}` : ''}`
1336
1369
  : failed
1337
1370
  ? 'dws 安装 / 更新失败'
1338
1371
  : ready
@@ -1340,13 +1373,49 @@ window.__ModuleLoader__.load({
1340
1373
  : '未检测到 dws 命令'
1341
1374
 
1342
1375
  const body = installing
1343
- ? '安装过程通常需要 10~60 秒,完成后会自动重新检测并开始接收消息。'
1376
+ ? `第 ${Math.min(doneCount + 1, steps.length || 1)}/${steps.length || 1} 步${currentStep && currentStep.detail ? ` · ${currentStep.detail}` : ''} · 已用时 ${elapsed}s。装完会自动重新检测并开始接收消息。`
1344
1377
  : failed
1345
1378
  ? String(install.log || tool.error || '安装失败,请查看下面的日志。').slice(0, 600)
1346
1379
  : ready
1347
1380
  ? `更新后会重启监听,登录状态不受影响。安装来源:${source}`
1348
1381
  : `这个插件通过 dws CLI 收发钉钉消息。点「安装 dws」会自动安装 dingtalk-workspace-cli(来源:${source}):有 npm 时走全局安装,没有 npm 时直接下载安装包解压到插件数据目录,全程无需你手动配置。`
1349
1382
 
1383
+ const stepIcon = (stepStatus) =>
1384
+ stepStatus === 'done' ? '✓' : stepStatus === 'running' ? '◐' : stepStatus === 'error' ? '✗' : stepStatus === 'skipped' ? '–' : '○'
1385
+
1386
+ const stepList =
1387
+ steps.length === 0
1388
+ ? null
1389
+ : h(
1390
+ 'div',
1391
+ { className: 'dsh-dt-steps' },
1392
+ steps.map((step) =>
1393
+ h(
1394
+ 'div',
1395
+ {
1396
+ key: step.key,
1397
+ className: 'dsh-dt-step',
1398
+ 'data-step': step.status,
1399
+ style: {
1400
+ color:
1401
+ step.status === 'error'
1402
+ ? C.error
1403
+ : step.status === 'running'
1404
+ ? C.brand
1405
+ : step.status === 'done'
1406
+ ? C.text
1407
+ : C.sub,
1408
+ opacity: step.status === 'pending' || step.status === 'skipped' ? 0.6 : 1,
1409
+ },
1410
+ },
1411
+ h('span', { className: 'dsh-dt-stepmark' }, stepIcon(step.status)),
1412
+ h('span', { className: 'dsh-dt-steplabel' }, step.label),
1413
+ step.detail ? h('span', { className: 'dsh-dt-stepdetail' }, step.detail) : null,
1414
+ step.ms > 0 ? h('span', { className: 'dsh-dt-stepms' }, `${(step.ms / 1000).toFixed(1)}s`) : null,
1415
+ ),
1416
+ ),
1417
+ )
1418
+
1350
1419
  return h(
1351
1420
  'div',
1352
1421
  { className: 'dsh-dt-install', 'data-tone': failed ? 'error' : installing ? 'busy' : 'warn' },
@@ -1356,6 +1425,7 @@ window.__ModuleLoader__.load({
1356
1425
  { style: { minWidth: 0, flex: 1 } },
1357
1426
  h('div', { className: 'dsh-dt-install-title' }, headline),
1358
1427
  h('div', { className: 'dsh-dt-install-body' }, body),
1428
+ stepList,
1359
1429
  failed && install.log && install.log.length > 600
1360
1430
  ? h('details', { className: 'dsh-dt-install-log' }, h('summary', null, '查看完整日志'), h('pre', null, install.log))
1361
1431
  : null,
@@ -2490,6 +2560,10 @@ window.__ModuleLoader__.load({
2490
2560
  : 'npm 全局安装'
2491
2561
  : '—',
2492
2562
  ],
2563
+ [
2564
+ 'dws 路径',
2565
+ state && state.dwsPath ? state.dwsPath : '—',
2566
+ ],
2493
2567
  [
2494
2568
  'npm 安装源',
2495
2569
  state && state.install && state.install.source ? state.install.source : 'https://registry.npmjs.org/',
Binary file
@@ -98,10 +98,10 @@ DSH → **插件市场**(Open Plugin Market)→ 搜索 `dsh-plugin-dingtalk-
98
98
  #### 方式三 · 手动装 npm 包
99
99
 
100
100
  ```bash
101
- npm i -g dsh-plugin-dingtalk-bridge@0.3.9
101
+ npm i -g dsh-plugin-dingtalk-bridge@0.4.0
102
102
  ```
103
103
 
104
- 或者把 `"dsh-plugin-dingtalk-bridge": "^0.3.9"` 加进 DSH profile 的 `dependencies`、并把包名追加到 `dsh.profile.bundles`,然后 `pnpm install`,最后**完全退出 DSH 再启动**。
104
+ 或者把 `"dsh-plugin-dingtalk-bridge": "^0.4.0"` 加进 DSH profile 的 `dependencies`、并把包名追加到 `dsh.profile.bundles`,然后 `pnpm install`,最后**完全退出 DSH 再启动**。
105
105
 
106
106
  <details>
107
107
  <summary><b>开发者:从源码目录安装(改代码即时生效)</b></summary>
@@ -157,7 +157,8 @@ npm i -g dsh-plugin-dingtalk-bridge@0.3.9
157
157
  | 状态文案 | 含义 | 处理 |
158
158
  | --- | --- | --- |
159
159
  | **插件已禁用** | `enabled` 为 `false` | 到「设置 → 插件」启用后重启 DSH |
160
- | **dws 未就绪** | `dws --version` 失败,或没有登录态(详情为 dws 返回的错误与「尚未登录钉钉」提示) | 没装 dws 时面板顶部会有「未检测到 dws 命令」提示卡,先点 **安装 dws**;已装则点 **钉钉授权**([第 8 节](#8-钉钉授权登录));其余见 [10.1](#101-顶部显示dws-未就绪) |
160
+ | **dws 未就绪** | `dws --version` 跑不起来(命令不存在或报错) | 面板顶部会有「未检测到 dws 命令」提示卡,先点 **安装 dws**;其余见 [10.1](#101-顶部显示dws-未就绪) |
161
+ | **未登录钉钉** | dws 可用,但还没有登录组织(新机器首次使用就是这样) | 点右上角 **钉钉授权**,扫码或登录即可([第 8 节](#8-钉钉授权登录));此时授权入口**是可用的**,见 [10.1.2](#1012-点钉钉授权提示-dws-not-ready040-已修) |
161
162
  | **正在连接钉钉…** | 监听进程已启动、还没就绪 | 等几秒;长期停留见 [10.2](#102-顶部显示监听异常或一直正在连接钉钉) |
162
163
  | **监听异常** | 监听进程报错或已退出 | 点右上角 **重启监听**;仍有问题见 [10.2](#102-顶部显示监听异常或一直正在连接钉钉) |
163
164
 
@@ -1367,13 +1368,23 @@ dws 版本 1.0.68
1367
1368
  | 情形 | 面板表现 | 点哪里 |
1368
1369
  | --- | --- | --- |
1369
1370
  | 本机没有 `dws` 命令 | 提示卡「未检测到 dws 命令」,附当前 `dwsPath` 与 npm 源 | **安装 dws** → 有 npm 走全局安装,没有 npm 直接下载安装包解压 |
1370
- | 正在安装 | 提示卡变蓝色「正在安装 dws vX…」 | 等 10~120 秒(免 npm 方式要下整包),装完自动重新检测并开始接收 |
1371
+ | 正在安装 | 提示卡变蓝色,标题带当前步骤,正文「第 3/5 步 · 已解压 1850 个文件 · 已用时 23s」,下面是 **五步清单**(读取版本信息 → 下载安装包 → 解压 → 准备可执行文件 → 校验版本),每一步有 ✓ / ◐ / ○ 与各自耗时 | 不用点,看着进度走完即可;装完自动重新检测并开始接收 |
1371
1372
  | 装完仍不可用 | 提示卡变红色「dws 安装 / 更新失败」+ 折叠日志 | 展开 **查看完整日志**,多数是网络 / 权限问题 |
1372
1373
  | 已安装,npm 上有新版 | 提示卡「发现新版本 dws vY(当前 vX)」 | **更新到 vY**(会先弹确认框,更新后重启监听,登录态不受影响) |
1373
1374
  | 已是最新 | 提示卡不显示 | 想手动再查一次就去设置页点 **检查 dws 更新** |
1374
1375
 
1375
1376
  ![dws 未安装时的提示卡](images/dws-install.png)
1376
1377
 
1378
+ **安装过程是可见的(0.4.0 起)**:界面会实时显示走到第几步、每步在做什么、已经用了多少秒,不会出现「点了没反应、不知道卡在哪」的情况。各步含义:
1379
+
1380
+ | 步骤 | 在做什么 | 典型耗时 |
1381
+ | --- | --- | --- |
1382
+ | 读取版本信息 | 请求 `<dwsRegistry>/dingtalk-workspace-cli/latest` 拿版本号与包地址 | < 1s |
1383
+ | 下载安装包 | 下载约 30 MB 的 tarball,**实时显示已下载 MB 与百分比**;同一个版本第二次装会直接命中本地缓存 `<数据目录>/dws-cache/*.tgz` | 10~120s(取决于网速;命中缓存 < 1s) |
1384
+ | 解压安装包 | 纯 Node 解压器把 tar.gz 摊开,实时显示「已解压 N 个文件」 | 3~20s |
1385
+ | 准备 dws 可执行文件 | 跑包内 `install.js`,把当前平台的二进制解压到 `vendor/` | 2~15s |
1386
+ | 校验 dws 版本 | `dws --version` 读出版本号,写回 `dwsPath` 并开始监听 | < 1s |
1387
+
1377
1388
  **两处都能装**:收件箱顶部的提示卡,以及 **设置 → 插件配置 → 底部按钮区**(「安装 dws」「检查 dws 更新」「更新到 vX」)。没装 dws 时点「钉钉授权」不会再去执行命令报错,而是直接提示「请先安装 dws」。
1378
1389
 
1379
1390
  实现要点(便于排障时对照):
@@ -1388,6 +1399,36 @@ dws 版本 1.0.68
1388
1399
  - 想换国内镜像:配置项 `dwsRegistry` 改成 `https://registry.npmmirror.com/`(两条安装路径都会用它)。
1389
1400
  - 安装成功后插件会把 `vendor/dws.exe` 的绝对路径写进 `state.json`,**重启后自动沿用**(前提是你没有在配置里显式指定 `dwsPath`),所以即使安装目录不在 PATH 里也能一直用。
1390
1401
  - 设置页「安装方式」一行会显示本次用的是 **npm 全局安装** 还是 **免 npm(直接下载安装包解压)**。
1402
+ - **卸载插件再装回来也不会再误报「未安装」**(0.4.1 起):配置的路径不可用时,插件会自动去下面这些位置找一遍,找到就写回 `dwsPath` 并落盘 —— 详见 [10.0.1](#1001-dws-到底装在哪为什么卸载重装后会提示未安装)。
1403
+
1404
+ #### 10.0.1 dws 到底装在哪?为什么卸载重装后会提示「未安装」
1405
+
1406
+ **装在哪,取决于安装时有没有 npm:**
1407
+
1408
+ | 安装路径 | 实际落点 | 特点 |
1409
+ | --- | --- | --- |
1410
+ | 有 npm(走 `npm install -g`) | npm 全局目录:Windows 一般是 `%APPDATA%\npm\node_modules\dingtalk-workspace-cli\vendor\dws.exe`;macOS/Linux 一般是 `/usr/local/lib/node_modules/…` 或 `/opt/homebrew/lib/node_modules/…` | 和手动 `npm i -g` 装的一样,**全局可用**,但 npm 全局目录通常**不在 PATH 里** |
1411
+ | 没有 npm(或 npm 装失败) | 插件数据目录:`<DSH_HOME>/integrations/dingtalk-bridge/dws-runtime/node_modules/dingtalk-workspace-cli/vendor/dws.exe` | **不污染全局**,卸载插件/删数据目录就一起没了 |
1412
+
1413
+ 另外 tarball 会缓存一份在 `<DSH_HOME>/integrations/dingtalk-bridge/dws-cache/`,所以同版本重装不需要重新下载。
1414
+
1415
+ **为什么卸载插件再装回来会说「未安装」**(0.4.0 及更早):
1416
+
1417
+ 1. 插件记住的只是 `state.json` 里的 `dwsPath` 绝对路径;
1418
+ 2. 卸载插件(或清理数据目录)会把 `state.json` 一起删掉,路径记忆就丢了;
1419
+ 3. 插件退回默认值 `dws`,也就是「去 PATH 里找」——可 npm 全局目录一般不在 PATH 里;
1420
+ 4. 于是 `dws --version` 失败 → 误判成「未安装」(其实文件还在)。
1421
+
1422
+ **0.4.1 起会自动找回**:`dws --version` 失败时,插件按顺序探测下面这些位置,第一个能读出 `x.y.z` 的就直接采用并写回 `dwsPath`:
1423
+
1424
+ 1. 配置项 `dwsPath`(如果显式填了);
1425
+ 2. 插件数据目录的 `dws-runtime/node_modules/dingtalk-workspace-cli/vendor/`;
1426
+ 3. Node 同目录的 `node_modules/…/vendor/`、`../lib/node_modules/…/vendor/`;
1427
+ 4. Windows:`%APPDATA%\npm\node_modules`、`Program Files\nodejs\node_modules`、`Program Files (x86)\nodejs\node_modules`;macOS/Linux:`/usr/local/lib`、`/opt/homebrew/lib`、`/usr/lib`;
1428
+ 5. 最后才是 PATH 里的 `dws`;
1429
+ 6. 还找不到就用 `npm root -g` 问一次 npm 的全局目录。
1430
+
1431
+ **怎么确认它到底在哪**:设置页 →「dws 路径」一行显示的就是当前实际使用的可执行文件绝对路径(`/state` 里也有 `dwsPath`、`dwsRuntimeDir`、`dwsCacheDir` 三个字段)。想彻底重装:先点「退出」清登录态,再删掉上表对应的目录,然后点「安装 dws」。
1391
1432
 
1392
1433
  ### 10.1 顶部显示「dws 未就绪」
1393
1434
 
@@ -1426,6 +1467,22 @@ dws profile list -f json # 查看当前组织与 status(只有 active 会
1426
1467
 
1427
1468
  > 登录态已过期(`status` 不是 `active`)的组织不再被监听,面板会提示「· N 个组织登录已过期,建议重新授权」。
1428
1469
 
1470
+ ### 10.1.2 点「钉钉授权」提示 `dws not ready`(0.4.0 已修)
1471
+
1472
+ **现象**:新机器上 dws 明明装好了(设置页「dws 版本 1.0.68」「dws 安装状态 已就绪」),点「钉钉授权」却弹「连接提示:dws not ready」,怎么点都进不去授权页。
1473
+
1474
+ **原因**:旧版把「还没登录钉钉」和「dws 不可用」混成了同一个 `tool.ok=false`。新机器首次使用必然没有登录组织 → 插件认为 dws 不可用 → 授权入口被自己的前置检查挡住 → 死循环。
1475
+
1476
+ **现在(0.4.0 起)**:
1477
+
1478
+ | 状态 | 面板显示 | 能否点授权 |
1479
+ | --- | --- | --- |
1480
+ | dws 命令不可用 | 红点「dws 未就绪 · <具体错误>」 | 不能(会提示先点「安装 dws」) |
1481
+ | dws 可用、还没登录 | 黄点「**未登录钉钉** · 点右上角「钉钉授权」…」 | **能**,点开就是授权页 |
1482
+ | dws 可用、已登录 | 绿点「实时监听中 · N 个组织」 | 能(按钮变「重新授权」) |
1483
+
1484
+ 如果你还在旧版本:重启 DSH 升级到 0.4.0 即可;临时绕过办法是先用命令行登录一次(`dws auth login --no-browser --yes`),有了登录组织后授权入口就能用了。
1485
+
1429
1486
  ### 10.2 顶部显示「监听异常」或一直「正在连接钉钉…」
1430
1487
 
1431
1488
  先点面板右上角 **重启监听**(等价于重跑 `dws --version` + 重建全部监听)。仍然不行时在终端核对订阅状态:
@@ -1866,7 +1923,11 @@ dws chat +messages-send --as user --group cidAbCdEf123456= --text "收到,下
1866
1923
  | `build` | string | 宿主代码编译标记(如 `0.2.9-20261117T0940`),设置页「宿主版本」显示它;与界面版本不一致时面板头部会多一个 **宿主待重启** 徽标 |
1867
1924
  | `requests` | `Array<{ at, method, path, status, detail }>` | 最近 8 条 API 请求,便于排查写操作被拦、阈值没保存之类的问题 |
1868
1925
  | `lastError` | string | 最近一次失败请求的摘要,如 `POST /api/dingtalk-bridge/action → 403` |
1869
- | `install` | object | dws 安装 / 更新状态:`status`(`unknown`/`missing`/`installing`/`ready`/`error`)、`mode`(`npm` 或 `tarball`)、`currentVersion`、`latestVersion`、`updateAvailable`、`targetVersion`、`source`(npm 源)、`log`(失败日志尾部)、`latestError`、`checkedAt`。见 [10.0](#100-dws-没安装--想升级036-起支持免-npm) |
1926
+ | `install` | object | dws 安装 / 更新状态:`status`(`unknown`/`missing`/`installing`/`ready`/`error`)、`mode`(`npm` 或 `tarball`)、`currentVersion`、`latestVersion`、`updateAvailable`、`targetVersion`、`source`(npm 源)、`log`(失败日志尾部)、`latestError`、`steps`(`[{ key, label, status, detail, ms }]`,`status` 为 `pending`/`running`/`done`/`error`/`skipped`)、`startedAt`/`finishedAt`(毫秒时间戳,界面据此算「已用时」)、`checkedAt`。见 [10.0](#100-dws-没安装--想升级036-起支持免-npm) |
1927
+ | `loginNotice` | string | 「还没登录钉钉」的提示文案(与 `tool.ok` 分开:没登录不是 dws 故障)。为空表示已有可用登录组织。见 [10.1.2](#1012-点钉钉授权提示-dws-not-ready040-已修) |
1928
+ | `dwsPath` | string | 当前实际使用的 dws 可执行文件(可能是绝对路径,也可能就是 `dws`)。设置页「dws 路径」显示它;卸载重装后由自动探测回填。见 [10.0.1](#1001-dws-到底装在哪为什么卸载重装后会提示未安装) |
1929
+ | `dwsRuntimeDir` | string | 免 npm 安装路径的包目录(`<数据目录>/dws-runtime/node_modules/dingtalk-workspace-cli`) |
1930
+ | `dwsCacheDir` | string | tarball 缓存目录(`<数据目录>/dws-cache`),同版本重装直接命中 |
1870
1931
 
1871
1932
  ### 12.3 关键常量
1872
1933
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-plugin-dingtalk-bridge",
3
- "version": "0.3.9",
3
+ "version": "0.4.1",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "description": "钉钉私信 / 群 @ 消息实时接收、按发送人记录来源、AI 建议回复与自动回复插件",
@@ -49,13 +49,14 @@ function safeRelativePath(raw) {
49
49
  * npm 包里的顶层目录通常是 `package/`,这里会把 `package/` 前缀剥掉,
50
50
  * 让调用方拿到 `<destDir>/package.json`、`<destDir>/install.js` 这样的结构。
51
51
  */
52
- export async function extractTarGz(buffer, destDir) {
52
+ export async function extractTarGz(buffer, destDir, onProgress) {
53
53
  const tar = gunzipSync(buffer)
54
54
  let offset = 0
55
55
  let pendingPath = ''
56
56
  let pendingLink = ''
57
57
  let longName = ''
58
58
  const written = []
59
+ const report = typeof onProgress === 'function' ? onProgress : null
59
60
 
60
61
  while (offset + BLOCK <= tar.length) {
61
62
  const header = tar.subarray(offset, offset + BLOCK)
@@ -106,6 +107,7 @@ export async function extractTarGz(buffer, destDir) {
106
107
  const mode = readOctal(header, 100, 8)
107
108
  await writeFile(target, data, { mode: mode > 0 ? mode : 0o644 })
108
109
  written.push(withoutPackage)
110
+ if (report && written.length % 50 === 0) report(written.length)
109
111
  }
110
112
 
111
113
  return written
@@ -21,7 +21,7 @@ import { buildSuggestPrompt, generateSuggestion, formatClock } from './suggest.j
21
21
 
22
22
  export const ROUTE_PREFIX = '/api/dingtalk-bridge'
23
23
  /** 每次改动宿主行为就换个标记:界面与 http-debug.log 都会带上,用来确认「跑的是新代码」。 */
24
- export const HOST_BUILD = '0.3.9-20261117T1615'
24
+ export const HOST_BUILD = '0.4.1-20261117T1810'
25
25
 
26
26
  /** 私信(单聊)全部消息。 */
27
27
  const O2O_KEY = 'user_im_message_receive_o2o_all'
@@ -371,6 +371,8 @@ export class DingTalkBridgeService {
371
371
  selfName: '',
372
372
  currentProfile: '',
373
373
  profiles: [],
374
+ // 「还没登录钉钉」的提示。和 tool.ok 分开:没登录不是 dws 坏了。
375
+ loginNotice: '',
374
376
  }
375
377
 
376
378
  this.tool = { ok: false, version: '', error: '', checkedAt: 0 }
@@ -385,9 +387,14 @@ export class DingTalkBridgeService {
385
387
  source: '',
386
388
  log: '',
387
389
  latestError: '',
390
+ // 安装步骤(进度):[{ key, label, status, detail, ms }]
391
+ steps: [],
392
+ startedAt: 0,
393
+ finishedAt: 0,
388
394
  checkedAt: 0,
389
395
  }
390
396
  this.installPromise = null
397
+ this.stepClock = new Map()
391
398
  this.login = { status: 'idle', code: '', url: '', qr: '', startedAt: 0, error: '', message: '' }
392
399
  this.loginChild = null
393
400
  this.listeners = new Map()
@@ -525,6 +532,41 @@ export class DingTalkBridgeService {
525
532
  return this.install
526
533
  }
527
534
 
535
+ /** 开始一次安装:把步骤清单重置为 pending,并记下开始时间(界面据此显示进度与耗时)。 */
536
+ beginInstallSteps(steps) {
537
+ this.stepClock = new Map()
538
+ this.setInstall({
539
+ steps: steps.map(([key, label]) => ({ key, label, status: 'pending', detail: '', ms: 0 })),
540
+ startedAt: Date.now(),
541
+ finishedAt: 0,
542
+ })
543
+ }
544
+
545
+ /** 更新某个安装步骤的状态;running / done / error 会记下该步骤耗时。 */
546
+ markStep(key, status, detail = '') {
547
+ const now = Date.now()
548
+ if (status === 'running' && !this.stepClock.has(key)) this.stepClock.set(key, now)
549
+ const startedAt = this.stepClock.get(key) ?? 0
550
+ const steps = (this.install.steps ?? []).map((step) => {
551
+ if (step.key !== key) return step
552
+ const next = { ...step, status }
553
+ if (detail !== '') next.detail = detail
554
+ if ((status === 'done' || status === 'error') && startedAt > 0) next.ms = now - startedAt
555
+ return next
556
+ })
557
+ this.setInstall({ steps })
558
+ }
559
+
560
+ /** 安装结束:没走到的步骤标成 skipped,失败的当前步标成 error,并记下结束时间。 */
561
+ finishInstallSteps(ok) {
562
+ const steps = (this.install.steps ?? []).map((step) => {
563
+ if (step.status === 'done' || step.status === 'error' || step.status === 'skipped') return step
564
+ if (step.status === 'running') return { ...step, status: ok ? 'done' : 'error' }
565
+ return { ...step, status: 'skipped' }
566
+ })
567
+ this.setInstall({ steps, finishedAt: Date.now() })
568
+ }
569
+
528
570
  /**
529
571
  * 查 npm 上 dingtalk-workspace-cli 的最新版本(只查不装)。
530
572
  * 换源时也走这里,所以界面上「检查更新」按钮可以随时点。
@@ -609,6 +651,68 @@ export class DingTalkBridgeService {
609
651
  return join(this.dataDir(), 'dws-runtime', 'node_modules', DWS_PACKAGE)
610
652
  }
611
653
 
654
+ /** 平台上的 dws 可执行文件名。 */
655
+ dwsExeName() {
656
+ return process.platform === 'win32' ? 'dws.exe' : 'dws'
657
+ }
658
+
659
+ /**
660
+ * 可能藏着 dws 的位置(按「便宜的先试」排序)。
661
+ * 为什么要这份清单:dws 可能装在 npm 全局目录、也可能装在插件数据目录,
662
+ * 而全局目录通常**不在 PATH 里**。卸载插件再装回来时 state.json 里的 dwsPath 会丢,
663
+ * 只靠 PATH 就会误报「未安装」——所以启动时要把这些位置都探一遍。
664
+ */
665
+ dwsCandidates() {
666
+ const exe = this.dwsExeName()
667
+ const vendor = (root) => join(root, DWS_PACKAGE, 'vendor', exe)
668
+ const list = []
669
+ const configured = String(this.config.dwsPath ?? '').trim()
670
+ if (configured !== '' && configured !== 'dws') list.push(configured)
671
+ list.push(join(this.runtimePackageDir(), 'vendor', exe))
672
+ const nodeDir = dirname(process.execPath)
673
+ list.push(vendor(join(nodeDir, 'node_modules')))
674
+ list.push(vendor(join(nodeDir, '..', 'lib', 'node_modules')))
675
+ if (process.platform === 'win32') {
676
+ if (process.env.APPDATA) list.push(vendor(join(process.env.APPDATA, 'npm', 'node_modules')))
677
+ const programFiles = process.env.ProgramFiles ?? 'C:\\Program Files'
678
+ list.push(vendor(join(programFiles, 'nodejs', 'node_modules')))
679
+ const programFilesX86 = process.env['ProgramFiles(x86)'] ?? 'C:\\Program Files (x86)'
680
+ list.push(vendor(join(programFilesX86, 'nodejs', 'node_modules')))
681
+ } else {
682
+ for (const root of ['/usr/local/lib/node_modules', '/opt/homebrew/lib/node_modules', '/usr/lib/node_modules']) {
683
+ list.push(vendor(root))
684
+ }
685
+ }
686
+ // 最后才试 PATH 里的 dws(配置里显式写了别的路径时也兜底)。
687
+ list.push('dws')
688
+ return [...new Set(list.filter((item) => item !== ''))]
689
+ }
690
+
691
+ /** 挨个试候选路径,返回第一个能跑出 `x.y.z` 的。 */
692
+ async discoverDws() {
693
+ for (const candidate of this.dwsCandidates()) {
694
+ // 明确是文件路径的,先看文件在不在——省掉一次进程启动(找不到时这步最费时间)。
695
+ if (candidate !== 'dws' && !existsSync(candidate)) continue
696
+ const probe = await runDws(candidate, ['--version'], { timeoutMs: 8000 })
697
+ const version = /(\d+\.\d+\.\d+)/.exec(`${probe.stdout}\n${probe.stderr}`)?.[1] || ''
698
+ if (probe.code === 0 && version !== '') return { command: candidate, version }
699
+ }
700
+ // 还有一处:npm 全局目录(prefix 可能不在上面这些常见位置)。
701
+ const npm = await this.findNpm()
702
+ if (npm !== '') {
703
+ const root = await this.npmGlobalRoot(npm)
704
+ if (root !== '') {
705
+ const candidate = join(root, DWS_PACKAGE, 'vendor', this.dwsExeName())
706
+ if (existsSync(candidate)) {
707
+ const probe = await runDws(candidate, ['--version'], { timeoutMs: 8000 })
708
+ const version = /(\d+\.\d+\.\d+)/.exec(`${probe.stdout}\n${probe.stderr}`)?.[1] || ''
709
+ if (probe.code === 0 && version !== '') return { command: candidate, version }
710
+ }
711
+ }
712
+ }
713
+ return null
714
+ }
715
+
612
716
 
613
717
  /** `npm root -g`:全局 node_modules,用来找安装后的包目录。 */
614
718
  async npmGlobalRoot(npm) {
@@ -641,6 +745,11 @@ export class DingTalkBridgeService {
641
745
  return this.installFromTarball(target)
642
746
  }
643
747
 
748
+ this.beginInstallSteps([
749
+ ['npm', 'npm 全局安装'],
750
+ ['prepare', '准备 dws 可执行文件'],
751
+ ['verify', '校验 dws 版本'],
752
+ ])
644
753
  this.setInstall({
645
754
  status: 'installing',
646
755
  mode: 'npm',
@@ -650,10 +759,12 @@ export class DingTalkBridgeService {
650
759
  })
651
760
 
652
761
  const args = buildInstallArgs({ target, registry })
762
+ this.markStep('npm', 'running', 'npm 正在下载并写入全局目录…')
653
763
  const result = await runDws(npm, args, { timeoutMs: INSTALL_TIMEOUT })
654
764
  const output = `${result.stdout}\n${result.stderr}`.trim()
655
765
  if (result.code !== 0) {
656
766
  // npm 装失败(权限、网络、被拦的 postinstall…)同样退到免 npm 方式,别让用户卡住。
767
+ this.markStep('npm', 'error', `npm 退出码 ${result.code}`)
657
768
  this.setInstall({
658
769
  status: 'installing',
659
770
  mode: 'tarball',
@@ -661,22 +772,30 @@ export class DingTalkBridgeService {
661
772
  })
662
773
  return this.installFromTarball(target)
663
774
  }
775
+ this.markStep('npm', 'done', 'npm 安装完成')
664
776
 
665
777
  const root = await this.npmGlobalRoot(npm)
666
778
  const pkgDir = join(root || join(dirname(process.execPath), 'node_modules'), DWS_PACKAGE)
779
+ this.markStep('prepare', 'running', '正在执行包内 install.js(解压平台二进制)…')
667
780
  const postinstallLog = await this.preparePackage(pkgDir)
668
781
  const vendor = join(pkgDir, 'vendor', process.platform === 'win32' ? 'dws.exe' : 'dws')
669
782
  const installed = await runDws(vendor, ['--version'], { timeoutMs: 20_000 })
670
783
  if (installed.code === 0) this.config.dwsPath = vendor
784
+ this.markStep('prepare', 'done', postinstallLog.split('\n').filter(Boolean).at(-1) || '平台二进制已就绪')
671
785
 
786
+ this.markStep('verify', 'running', '正在校验 dws --version…')
672
787
  await this.checkTool()
673
788
  if (!this.tool.ok) {
789
+ this.markStep('verify', 'error', this.tool.error)
790
+ this.finishInstallSteps(false)
674
791
  this.setInstall({
675
792
  status: 'error',
676
793
  log: `${output.slice(-INSTALL_LOG_LIMIT)}\n\n${postinstallLog}\n\n安装完成但 dws 仍不可用:${this.tool.error}`.trim(),
677
794
  })
678
795
  return { ok: false, error: this.tool.error }
679
796
  }
797
+ this.markStep('verify', 'done', `dws v${this.tool.version}`)
798
+ this.finishInstallSteps(true)
680
799
 
681
800
  this.setInstall({
682
801
  status: 'ready',
@@ -718,7 +837,16 @@ export class DingTalkBridgeService {
718
837
  const registry = this.registry().replace(/\/+$/, '')
719
838
  const wanted = String(target ?? '').replace(/^v/, '').trim()
720
839
  const metaUrl = wanted === '' ? `${registry}/${DWS_PACKAGE}/latest` : `${registry}/${DWS_PACKAGE}/${wanted}`
840
+ this.beginInstallSteps([
841
+ ['resolve', '读取版本信息'],
842
+ ['download', '下载安装包'],
843
+ ['extract', '解压安装包'],
844
+ ['prepare', '准备 dws 可执行文件'],
845
+ ['verify', '校验 dws 版本'],
846
+ ])
847
+ this.setInstall({ status: 'installing', mode: 'tarball', source: registry, targetVersion: wanted })
721
848
  try {
849
+ this.markStep('resolve', 'running', '正在查询 npm 上的版本信息…')
722
850
  const metaResponse = await fetch(metaUrl, {
723
851
  headers: { accept: 'application/json' },
724
852
  signal: AbortSignal.timeout(20_000),
@@ -728,23 +856,35 @@ export class DingTalkBridgeService {
728
856
  const url = tarballUrl(meta, DWS_PACKAGE)
729
857
  const version = String(meta?.version ?? wanted ?? '')
730
858
  if (url === '') throw new Error('版本信息里没有安装包地址')
859
+ this.markStep('resolve', 'done', `v${version}`)
731
860
 
732
- const response = await fetch(url, { signal: AbortSignal.timeout(180_000) })
733
- if (!response.ok) throw new Error(`下载安装包失败(HTTP ${response.status})`)
734
- const buffer = Buffer.from(await response.arrayBuffer())
861
+ const buffer = await this.fetchTarball(url, version)
735
862
 
863
+ this.markStep('extract', 'running', '正在解压…')
736
864
  const pkgDir = this.runtimePackageDir()
737
865
  await rm(pkgDir, { recursive: true, force: true })
738
866
  await mkdir(pkgDir, { recursive: true })
739
- const files = await extractTarGz(buffer, pkgDir)
867
+ let lastReport = 0
868
+ const files = await extractTarGz(buffer, pkgDir, (count) => {
869
+ const now = Date.now()
870
+ if (now - lastReport < 300) return
871
+ lastReport = now
872
+ this.markStep('extract', 'running', `已解压 ${count} 个文件`)
873
+ })
874
+ this.markStep('extract', 'done', `${files.length} 个文件`)
740
875
 
876
+ this.markStep('prepare', 'running', '正在执行 install.js(解压平台二进制)…')
741
877
  const postinstallLog = await this.preparePackage(pkgDir)
742
878
  const vendor = join(pkgDir, 'vendor', process.platform === 'win32' ? 'dws.exe' : 'dws')
743
879
  const probe = await runDws(vendor, ['--version'], { timeoutMs: 20_000 })
744
880
  if (probe.code === 0) this.config.dwsPath = vendor
881
+ this.markStep('prepare', 'done', '平台二进制已就绪')
745
882
 
883
+ this.markStep('verify', 'running', '正在校验 dws --version…')
746
884
  await this.checkTool()
747
885
  if (!this.tool.ok) {
886
+ this.markStep('verify', 'error', this.tool.error)
887
+ this.finishInstallSteps(false)
748
888
  this.setInstall({
749
889
  status: 'error',
750
890
  mode: 'tarball',
@@ -752,6 +892,8 @@ export class DingTalkBridgeService {
752
892
  })
753
893
  return { ok: false, error: this.tool.error }
754
894
  }
895
+ this.markStep('verify', 'done', `dws v${this.tool.version}`)
896
+ this.finishInstallSteps(true)
755
897
 
756
898
  this.setInstall({
757
899
  status: 'ready',
@@ -766,6 +908,7 @@ export class DingTalkBridgeService {
766
908
  return { ok: true, version: this.tool.version, mode: 'tarball' }
767
909
  } catch (error) {
768
910
  const message = String(error?.message || error)
911
+ this.finishInstallSteps(false)
769
912
  this.setInstall({
770
913
  status: 'error',
771
914
  mode: 'tarball',
@@ -775,6 +918,60 @@ export class DingTalkBridgeService {
775
918
  }
776
919
  }
777
920
 
921
+ /** 下载 tarball:优先用本地缓存(<dataDir>/dws-cache),否则带进度下载后写入缓存。 */
922
+ async fetchTarball(url, version) {
923
+ const cacheDir = join(this.dataDir(), 'dws-cache')
924
+ const cachePath = join(cacheDir, `${DWS_PACKAGE}-${version || 'latest'}.tgz`)
925
+ try {
926
+ const cached = await readFile(cachePath)
927
+ if (cached.length > 1024) {
928
+ this.markStep('download', 'done', `使用本地缓存(${(cached.length / 1048576).toFixed(1)} MB)`)
929
+ return cached
930
+ }
931
+ } catch {
932
+ // 没有缓存就正常下载。
933
+ }
934
+
935
+ this.markStep('download', 'running', '正在连接 npm 源…')
936
+ const response = await fetch(url, { signal: AbortSignal.timeout(180_000) })
937
+ if (!response.ok) throw new Error(`下载安装包失败(HTTP ${response.status})`)
938
+ const total = Number(response.headers.get('content-length') ?? 0)
939
+ const chunks = []
940
+ let received = 0
941
+ let lastReport = 0
942
+ if (response.body && typeof response.body.getReader === 'function') {
943
+ const reader = response.body.getReader()
944
+ for (;;) {
945
+ const { done, value } = await reader.read()
946
+ if (done) break
947
+ if (!value) continue
948
+ chunks.push(Buffer.from(value))
949
+ received += value.length
950
+ const now = Date.now()
951
+ if (now - lastReport > 300) {
952
+ lastReport = now
953
+ const mb = (received / 1048576).toFixed(1)
954
+ const percent = total > 0 ? ` · ${Math.round((received / total) * 100)}%` : ''
955
+ this.markStep('download', 'running', `已下载 ${mb} MB${percent}`)
956
+ }
957
+ }
958
+ } else {
959
+ const whole = Buffer.from(await response.arrayBuffer())
960
+ chunks.push(whole)
961
+ received = whole.length
962
+ }
963
+ const buffer = Buffer.concat(chunks)
964
+ if (buffer.length === 0) throw new Error('下载到的安装包是空的')
965
+ this.markStep('download', 'done', `${(buffer.length / 1048576).toFixed(1)} MB`)
966
+ try {
967
+ await mkdir(cacheDir, { recursive: true })
968
+ await writeFile(cachePath, buffer)
969
+ } catch {
970
+ // 缓存写不进去不影响安装。
971
+ }
972
+ return buffer
973
+ }
974
+
778
975
  /** 「更新 dws」:先查最新版,再按版本号安装。 */
779
976
  async updateDws() {
780
977
  const latest = await this.checkLatestDws()
@@ -785,7 +982,7 @@ export class DingTalkBridgeService {
785
982
  return this.installDws(target)
786
983
  }
787
984
 
788
- async checkTool() {
985
+ async checkTool({ discover = true } = {}) {
789
986
  const result = await runDws(this.config.dwsPath, ['--version'], { timeoutMs: 15000 })
790
987
  const output = `${result.stdout}\n${result.stderr}`.trim()
791
988
  const version = /(\d+\.\d+\.\d+)/.exec(output)?.[1] || ''
@@ -795,6 +992,17 @@ export class DingTalkBridgeService {
795
992
  error: result.code === 0 ? '' : describeFailure(result),
796
993
  checkedAt: Date.now(),
797
994
  }
995
+ // 配置里的路径不可用时,去常见位置找一遍:卸载重装后 state.json 会丢 dwsPath,
996
+ // 而 npm 全局目录通常不在 PATH 里,不主动找就会误报「未安装」。
997
+ if (!this.tool.ok && discover) {
998
+ const found = await this.discoverDws()
999
+ if (found && found.command !== this.config.dwsPath) {
1000
+ this.config.dwsPath = found.command
1001
+ await this.saveState()
1002
+ this.noteRequest('DISCOVER', ROUTE_PREFIX, 200, found.command)
1003
+ return this.checkTool({ discover: false })
1004
+ }
1005
+ }
798
1006
  const missing = !this.tool.ok && looksLikeMissingCommand(output)
799
1007
  const current = version || this.install.currentVersion || ''
800
1008
  this.install = {
@@ -835,15 +1043,17 @@ export class DingTalkBridgeService {
835
1043
  this.state.selfName = current?.userName || this.state.selfName || ''
836
1044
 
837
1045
  if (profiles.length === 0) {
838
- this.tool = {
839
- ok: false,
840
- version: this.tool.version,
841
- error: result.code === 0 ? '未找到已登录的钉钉组织,请点击右上角「钉钉授权」登录' : describeFailure(result),
842
- checkedAt: Date.now(),
1046
+ // 注意:这里**不能**把 tool.ok 置 false。tool.ok 只表示「dws 二进制能不能用」,
1047
+ // 「还没登录钉钉」是另一种状态——否则 startLogin() 的前置检查会认为 dws 不可用,
1048
+ // 用户就永远点不动「钉钉授权」(新机器上首次授权必然如此)。
1049
+ this.state.loginNotice =
1050
+ result.code === 0 ? '未找到已登录的钉钉组织,请点击右上角「钉钉授权」登录' : describeFailure(result)
1051
+ } else {
1052
+ this.state.loginNotice = ''
1053
+ if (!this.tool.ok) {
1054
+ // 重新授权成功后要把「dws 未就绪」的旧结论翻回来,否则面板一直显示错误态。
1055
+ this.tool = { ok: true, version: this.tool.version, error: '', checkedAt: Date.now() }
843
1056
  }
844
- } else if (!this.tool.ok) {
845
- // 重新授权成功后要把「dws 未就绪」的旧结论翻回来,否则面板一直显示错误态。
846
- this.tool = { ok: true, version: this.tool.version, error: '', checkedAt: Date.now() }
847
1057
  }
848
1058
 
849
1059
  return profiles
@@ -2537,6 +2747,9 @@ export class DingTalkBridgeService {
2537
2747
  started: this.started,
2538
2748
  tool: this.tool,
2539
2749
  install: this.install,
2750
+ dwsPath: this.config.dwsPath,
2751
+ dwsRuntimeDir: this.runtimePackageDir(),
2752
+ dwsCacheDir: join(this.dataDir(), 'dws-cache'),
2540
2753
  selfName: this.state.selfName,
2541
2754
  currentProfile: this.state.currentProfile,
2542
2755
  profiles: this.state.profiles,
@@ -2547,6 +2760,7 @@ export class DingTalkBridgeService {
2547
2760
  status: item.status,
2548
2761
  })),
2549
2762
  loginReset: this.config.loginReset,
2763
+ loginNotice: String(this.state.loginNotice ?? ''),
2550
2764
  autoReply: this.state.autoReply,
2551
2765
  autoReplyAt: Number(this.state.autoReplyAt) || 0,
2552
2766
  autoSuggest: this.config.autoSuggest,