@takboo/dsh-coopanion 0.4.19 → 0.4.21

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.
Files changed (40) hide show
  1. package/README.md +3 -2
  2. package/THIRD_PARTY_NOTICES.md +4 -0
  3. package/assets/coopanion.png +0 -0
  4. package/assets/coopanion.svg +9 -0
  5. package/dist/bridge.js +38 -6
  6. package/dist/bridge.js.map +2 -2
  7. package/dist/build-info.json +2 -2
  8. package/dist/client.js +30 -1
  9. package/dist/index.js +47 -11
  10. package/dist/index.js.map +2 -2
  11. package/docs/README.md +2 -0
  12. package/docs/compatibility.md +41 -27
  13. package/docs/desktop-recovery-contract.md +1 -1
  14. package/docs/development.md +22 -3
  15. package/docs/market/takboo__dsh-coopanion.yml +1 -0
  16. package/docs/notification-contract.md +1 -1
  17. package/docs/release-notes.md +16 -0
  18. package/docs/releasing.md +32 -5
  19. package/docs/session-chat-contract.md +1 -1
  20. package/docs/usage.md +7 -7
  21. package/npm-shrinkwrap.json +2 -2
  22. package/package.json +5 -1
  23. package/scripts/check-package.mjs +9 -0
  24. package/scripts/compatibility/check.mjs +10 -2
  25. package/scripts/compatibility/discover.mjs +8 -0
  26. package/scripts/compatibility/planning.mjs +1 -1
  27. package/scripts/compatibility/published.mjs +157 -0
  28. package/scripts/compatibility/report.mjs +39 -9
  29. package/scripts/compatibility/runner.mjs +6 -3
  30. package/scripts/verify-engineering.sh +91 -0
  31. package/src/client/Settings.tsx +8 -1
  32. package/src/client/locales.ts +6 -0
  33. package/src/controls.ts +17 -11
  34. package/src/desktop-lifecycle.ts +11 -0
  35. package/src/electron-runtime.ts +25 -7
  36. package/tests/compatibility-monitor.mjs +32 -0
  37. package/tests/electron-startup.test.ts +29 -4
  38. package/tests/engineering-targets.json +12 -0
  39. package/tests/engineering-web-probe.mjs +58 -0
  40. package/tests/install.mjs +11 -0
package/docs/README.md CHANGED
@@ -27,4 +27,6 @@
27
27
 
28
28
  正式发布使用 [GitHub Release](https://github.com/takboo/dsh-coopanion/releases) 中的版本、提交和包摘要核验;`verification.json`、`SHA256SUMS` 与版本包一起提供。本地试装包不代表该版本的正式分发产物。
29
29
 
30
+ 已发布版本的 CI、VM、分发字节核验和已知限制集中在[最近一次发布核验](releasing.md#最近一次发布核验);候选检查的状态与结案范围见[兼容性检查](compatibility.md#正式支持与候选结案)。
31
+
30
32
  仓库的 `docs/evidence/` 只保留历史原始证据,普通搜索及安装包均排除它。追溯时先读其说明并核对实际产物身份。`.cache/`、`artifacts/` 与 `dist/` 属于本机或生成内容,可能来自其他提交。
@@ -1,6 +1,12 @@
1
1
  # DSH 兼容性自动检查
2
2
 
3
- `.github/workflows/dsh-compatibility.yml` 每小时第 37 分钟读取官方 GitHub Release(含候选版)、npm latest/next 和官方 macOS ARM64 Desktop feed。手动执行可提供精确版本或 dsh-v tag,当前最高已支持版本也可演练。默认只检查高于当前精确支持列表最高版本的目标,每轮最多三个版本。定时运行在工作流合入 main 后生效,平台调度可能延迟。
3
+ [兼容性工作流](../.github/workflows/dsh-compatibility.yml) 每小时第 37 分钟从 main 读取官方 GitHub Release(含候选版)、npm latest/next 和官方 macOS ARM64 Desktop feed,平台调度可能延迟。默认只检查高于当前精确支持列表最高版本的目标,每轮最多三个版本;手动执行可指定精确版本或 dsh-v tag。
4
+
5
+ ## 正式支持与候选结案
6
+
7
+ 正式宿主范围以 [package.json](../package.json) 的 `engines.dsh` 和 DSH peer 声明为准。v0.4.19 已将 `0.2.2-rc.1` 的审阅提案纳入正式 manifest 与 shrinkwrap,保留此前六版 Host 支持和原有运行时依赖;[PR #38](https://github.com/takboo/dsh-coopanion/pull/38) 已合并,三个兼容性 Issue 已结案。发布身份、最终 CI、VM 范围及已知限制集中见[最近一次发布核验](releasing.md#最近一次发布核验)。
8
+
9
+ `0.2.2-alpha.2` 与 `alpha.3` 只保留固定配套组合的候选证据,未加入正式支持列表。alpha.2 默认浮动解析曾复现上游 preset 初始化失败;候选成功和 Issue 结案均不表示旧 alpha 的默认安装已通过。原始失败及后续复验入口见[历史失败追溯](#历史失败追溯)。
4
10
 
5
11
  ## 检查与状态
6
12
 
@@ -11,41 +17,31 @@
11
17
  - 网络或安装准备暂时失败、超时、中断及缺报告为 retry;至少六小时后重试,同一组件身份最多自动三次。明确断言、依赖冲突或完整性错误为 failed。手动精确版本可复验。
12
18
  - 候选检查成功为 partial,不能替代最终提交的常规 CI 或正式支持声明。未知 Desktop 运行时必须审阅,不能自动放宽。
13
19
 
14
- 报告读取兼容下载后的两种布局:多个 artifact 的具名子目录,以及单个 artifact 直接展开到输出根目录。准备阶段已经确认的依赖冲突保留为 failed,不因后续平台 job 未执行而降为“缺报告、等待重试”;单个组件仍须通过原有来源、目标和包摘要校验。
20
+ 准备提案要求目标版本不低于正式支持列表的最高版本。当前最高已支持版本可手动演练;较旧版本的复现需使用原记录对应的源码基线和产物。
15
21
 
16
- 2026-11-05 核查的三个候选均在 `target-lock` 阶段发生 `ERESOLVE`:
17
-
18
- | 候选 | 上游 dsh-agent 要求的 Cordis | 原始检查 |
19
- |---|---|---|
20
- | 0.2.2-alpha.2 | `~4.0.6-alpha.1` | [Issue #35 / Actions](https://github.com/takboo/dsh-coopanion/actions/runs/41626179738) |
21
- | 0.2.2-alpha.3 | `~4.0.6-alpha.2` | [Issue #36 / Actions](https://github.com/takboo/dsh-coopanion/actions/runs/41788822490) |
22
- | 0.2.2-rc.1 | `~4.1.0` | [Issue #37 / Actions](https://github.com/takboo/dsh-coopanion/actions/runs/41922628817) |
22
+ 报告读取兼容下载后的两种布局:多个 artifact 的具名子目录,以及单个 artifact 直接展开到输出根目录。准备阶段已经确认的依赖冲突保留为 failed,不因后续平台 job 未执行而降为“缺报告、等待重试”;单个组件仍须通过原有来源、目标和包摘要校验。
23
23
 
24
- 这些检查使用的 Cordis 开发基线为 `4.0.5`,基线安装、类型检查与单元检查通过,候选平台安装及 Desktop 检查没有运行。恢复三个原始 artifact 可以重放失败报告汇总;这不等于重新执行候选检查。支持新版需先审阅相应依赖基线,再执行精确版本复验及最终提交资格检查。
24
+ ## 双轨宿主证据
25
25
 
26
- `scripts/compatibility/reviewed-dependencies.mjs` 记录已审阅的精确配套基线,准备 job 与提案校验共用同一份表:
26
+ 发现阶段读取 npm `latest` 的精确版本和 integrity。SDK 组件身份同时绑定宿主和这份发布物,原包更新后会重新观察。发布轨在独立 Linux Docker 任务中下载并校验 npm 原始 tarball,使用默认准入安装到干净 profile。接受后用包内探针验证真实 Web 宿主和插件设置。拒绝时核对官方诊断、profile 回滚和配置中无该插件,报告 `refused-as-expected`。候选轨继续运行原有三平台适配安装矩阵,报告候选包 SHA-256、integrity、实际准入和运行阶段。两轨核对同一精确 DSH 版本和 integrity。插件断言失败记 `failed`,安装准备、浏览器启动或执行中断按实际阶段记 `retry`。
27
27
 
28
- | DSH 候选 | Cordis | Schemastery | Loader / Include / Group | Cosmokit |
29
- |---|---|---|---|---|
30
- | 0.2.2-alpha.2 | 4.0.6-alpha.1 | 3.18.6-alpha.1 | 1.0.7-alpha.1 / 1.0.11-alpha.1 / 1.0.6-alpha.1 | 1.8.7-alpha.1 |
31
- | 0.2.2-alpha.3 | 4.0.6-alpha.2 | 3.18.6-alpha.2 | 1.0.7-alpha.2 / 1.0.11-alpha.2 / 1.0.6-alpha.2 | 1.8.7-alpha.2 |
32
- | 0.2.2-rc.1 | 4.1.0 | 3.19.0 | 1.1.0 / 1.1.0 / 1.1.0 | 1.9.0 |
28
+ 手动工作流输入一个精确宿主版本可同时演练两轨。可用 Docker 在本地复现发布轨,容器内安装项目锁定的 Playwright Chromium 后运行 `DSH_VERSION=0.2.2-rc.1 npm run compat:published`。候选适配使用 `compat:prepare` 和 `compat:check`,传入同一发现目标和构建目录。正式支持范围由项目 PR 审阅决定。
33
29
 
34
- 这些版本与各候选 SDK 发布包的 peer 要求对应,包来自 npm 官方 registry,并按发布 integrity 校验后审阅源码。Schemastery 的 `src/index.ts` 相对 3.18.5 未变;Cordis 的配置解析、更新、事件分发和依赖卸载实现,以及 Loader/Include 的配置写入和挂载实现发生变化,必须继续经过类型、单元、真实 Loader 和恢复契约验证。候选准备通过精确配套表改变候选开发依赖及已有 peer 声明;Loader/Include/Group/Cosmokit 显式列入候选开发依赖,以免预发布范围解析到下一轮组件,不会由候选工作流自动改变正式 package.json、版本号或运行时依赖。准备阶段额外检查完整依赖树,提案校验也拒绝嵌套锁条目混入未审阅的配套版本。组件身份包含配套基线,避免复用旧依赖上的失败或成功证据。
30
+ ## 配套基线与验证范围
35
31
 
36
- SDK 检查及 Desktop 的 npm Web Host 安装也使用这份精确配套基线,并分别固定 Timer 为 `1.1.8-alpha.1`、`1.1.8-alpha.2`、`1.2.0`。所有包保持官方发布字节及原有 peer 约束;安装后检查完整依赖树,并在报告中保存 `hostDependencies`。成功报告必须与该输入组合一致。官方 Desktop ASAR 继续按原字节独立验证。此证据只覆盖所记录的组合;默认 npm 浮动解析另行验证,不能把前者的成功套用到后者。alpha.2 默认解析到后一轮 Cordis 组件时,本地真实 Loader 的目标契约已复现上游 preset 初始化失败;固定匹配组合后,同一检查通过。
32
+ 已审阅的 Cordis、Schemastery、Loader/Include/Group、Cosmokit 及 Host Timer 精确输入统一由 [reviewed-dependencies.mjs](../scripts/compatibility/reviewed-dependencies.mjs) 维护。准备 job、SDK/Desktop 的 npm Web Host 安装和提案/报告校验共用该定义。
37
33
 
38
- 准备 job 在隔离副本更新精确 DSH 开发依赖、peer/engines 声明及 npm-shrinkwrap.json。保留原有支持和配套表以外的顶层依赖;旧 Host 锁解析重建,其他锁条目保留。正式源码与工作区在前后做摘要核对。未知版本不自动推断配套依赖,仍按既有基线执行,若存在冲突则报告失败,待源码审阅后再调整精确配套表。
34
+ 各配套版本与候选 SDK 发布包的 peer 要求对应,包来自 npm 官方 registry,并按发布 integrity 校验后审阅源码。0.2.2 基线审阅中,Schemastery 的 `src/index.ts` 相对 3.18.5 未变;Cordis 的配置解析、更新、事件分发和依赖卸载,以及 Loader/Include 的配置写入和挂载发生变化,仍需类型、单元、真实 Loader 和恢复契约验证。
39
35
 
40
- 基线和候选分别执行类型及单元检查,候选执行完整浏览器、通知与 test:inbox-ui。Linux 只构建一次候选 .tgz,三个安装 job 下载同一字节,验证摘要后分别在 Linux x64、Windows x64 与 macOS ARM64 运行真实 Loader、网页设置、通知/目标/会话契约、原生桌宠与恢复。未改声明的原包仍须通过官方准入判断拒绝未支持宿主。既有完整安装断言保留,候选没有跳过完成或接受回执检查。
36
+ 准备 job 在隔离副本更新精确 DSH 开发依赖、已有 peer、engines 及 npm-shrinkwrap.json,保留原有支持和配套表以外的顶层依赖;重建旧 Host 锁条目,保留其他锁条目。正式源码与工作区在前后做摘要核对,不自动改变正式 manifest、版本号或运行时依赖。未知版本沿用既有基线,若冲突则报告失败,待源码审阅后再调整精确配套定义。
41
37
 
42
- Desktop job 在独立目录下载匹配的官方 macOS ARM64 ZIP,检查摘要、路径及符号链接、完整代码签名和 DeepSeek Team ID。当前审阅载体为 Electron 44.7.0 / Node 24.21.0 / libuv 1.52.1 / ABI 149。验证真实 ASAR 的 Host 契约,目标完成与会话契约也单独运行于真实 ASAR;随后在官方 Electron 中运行同包安装与桌宠联动,此完整 GUI 流程的 Web Host/Client 由对应 npm 产物提供,桌宠按产品正常路径使用其声明的独立 Electron 依赖。该自动化不声称驱动原生 Desktop shell、通知中心、真实账号模型或物理多屏/输入设备。
38
+ Loader/Include/Group/Cosmokit 显式列入候选开发依赖,避免预发布范围解析到下一轮组件。准备阶段检查完整依赖树,提案校验拒绝嵌套锁条目混入未审阅版本;组件身份包含配套基线,避免复用旧组合上的证据。
43
39
 
44
- ## 0.4.19 正式支持范围
40
+ SDK 检查及 Desktop 的 npm Web Host 安装保持官方发布字节和原有 peer 约束,安装后检查完整依赖树,并在报告中保存 `hostDependencies`;成功报告必须与审阅输入一致。官方 Desktop ASAR 按原字节独立验证。固定配套证据与普通 npm 浮动解析分别结算;正式 rc.1 的普通安装由发布矩阵验证。
45
41
 
46
- 0.4.19 将 `0.2.2-rc.1` 的已审阅提案纳入正式 manifest 和 shrinkwrap:开发基线为 Cordis `4.1.0`、Schemastery `3.19.0`,保留此前六版 Host 的精确支持和原有运行时依赖。常规及发布 CI 从 manifest 读取七版宿主,执行三平台二十一组同一规范包安装;rc.1 使用普通 npm 发布宿主安装路径,候选检查的固定配套输入不替代这项资格验证。
42
+ 基线和候选分别执行类型及单元检查,候选执行完整浏览器、通知与 test:inbox-ui。Linux 只构建一次候选 .tgz,三个安装 job 下载同一字节,验证摘要后分别在 Linux x64、Windows x64 与 macOS ARM64 运行真实 Loader、网页设置、通知/目标/会话契约、原生桌宠与恢复。项目基线继续保留静态准入断言。既有完整安装断言保留,候选没有跳过完成或接受回执检查。
47
43
 
48
- `0.2.2-alpha.2` 与 `alpha.3` 保留固定配套候选证据,不加入正式支持列表;alpha.2 默认浮动组合已有上游初始化失败复现。对应 issue 在修复检查器、保留复验身份并转入后续 rc.1 支持后结案,不表示旧 alpha 的默认安装已通过。真实账号/模型、通知中心、物理多屏及长期体验仍需单独验收;macOS 原生补验使用项目隔离 VM。
44
+ Desktop job 在独立目录下载匹配的官方 macOS ARM64 ZIP,检查摘要、路径及符号链接、完整代码签名和 DeepSeek Team ID;允许的载体运行时由 [desktop-artifact.mjs](../scripts/compatibility/desktop-artifact.mjs) 校验。通知、目标完成与会话契约单独运行于真实 ASAR,随后在官方 Electron 中运行同包安装与桌宠联动。该 GUI 流程的 Web Host/Client 由对应 npm 产物提供,桌宠按产品正常路径使用其声明的独立 Electron 依赖;原生 Desktop shell、通知中心、真实账号模型及物理输入/多屏另行验收。
49
45
 
50
46
  ## 报告与提案
51
47
 
@@ -57,13 +53,31 @@ Desktop job 在独立目录下载匹配的官方 macOS ARM64 ZIP,检查摘要
57
53
 
58
54
  ## 本地执行
59
55
 
60
- 使用 `.node-version` 和 packageManager 固定工具链,先 npm ci --ignore-scripts。可只读发现:
56
+ 使用 `.node-version` 和 `packageManager` 固定工具链。只读发现不启动浏览器:
61
57
 
62
58
  ```bash
63
59
  npm run compat:discover -- --local
64
- DSH_VERSION=0.2.1-rc.5 npm run compat:prepare
65
60
  ```
66
61
 
67
- 准备输出目录含 candidate.json、proposal.json、候选包、paper-star.zip 和 report.json。随后设置 DSH_TARGET_JSON 为发现的完整目标 JSON,DSH_CANDIDATE_DIR 为该输出目录,再运行 npm run compat:check;Desktop 检查使用 npm run compat:desktop,只接受匹配的官方 feed 身份。浏览器依赖须提前安装,使用 PLAYWRIGHT_BROWSERS_PATH 指向测试缓存。原生检查串行执行。
62
+ 候选准备前先安装依赖和 Chromium。隔离进程会使用临时 HOME,浏览器缓存需通过绝对路径传入:
63
+
64
+ ```bash
65
+ npm ci --ignore-scripts
66
+ export PLAYWRIGHT_BROWSERS_PATH="$PWD/.cache/compatibility-browsers"
67
+ npx playwright-core install chromium
68
+ DSH_VERSION=0.2.2-rc.1 npm run compat:prepare
69
+ ```
70
+
71
+ 示例版本对应 v0.4.19 的最高支持宿主,切换源码基线时先核对 `package.json`。准备输出目录含 candidate.json、proposal.json、候选包、paper-star.zip 和 report.json。随后设置 DSH_TARGET_JSON 为发现的完整目标 JSON,DSH_CANDIDATE_DIR 为该输出目录,再运行 `npm run compat:check`;macOS ARM64 上的 `npm run compat:desktop` 只接受匹配的官方 feed 身份。原生检查在隔离 VM 中串行执行,范围及环境要求见[开发指南](development.md)。
68
72
 
69
73
  本地命令不写 Issue 或 PR。发现、状态与提案机制复用 dsh-session-bin / dsh-usage-state,MIT 许可保留在 scripts/compatibility/LICENSE;本流程不调用付费 AI 服务。
74
+
75
+ ## 历史失败追溯
76
+
77
+ 2026-11-05 核查的三个原始运行使用 Cordis `4.0.5` 开发基线,与候选 SDK 的 peer 要求冲突,均在 `target-lock` 阶段发生 `ERESOLVE`。当时基线安装、类型和单元检查通过,候选平台安装及 Desktop 检查没有运行;单 artifact 下载布局还曾使汇总器将该失败误报为待重试。
78
+
79
+ - `0.2.2-alpha.2`:[Issue #35](https://github.com/takboo/dsh-coopanion/issues/35)、[原运行](https://github.com/takboo/dsh-coopanion/actions/runs/41626179738)。
80
+ - `0.2.2-alpha.3`:[Issue #36](https://github.com/takboo/dsh-coopanion/issues/36)、[原运行](https://github.com/takboo/dsh-coopanion/actions/runs/41788822490)。
81
+ - `0.2.2-rc.1`:[Issue #37](https://github.com/takboo/dsh-coopanion/issues/37)、[原运行](https://github.com/takboo/dsh-coopanion/actions/runs/41922628817)。
82
+
83
+ Issue 保留原始要求、失败摘要、来源身份与后续候选复验,已随 v0.4.19 发布结案。重放原 artifact 只验证报告汇总,不算新一轮候选检查;后续成功不改写早期失败的含义。
@@ -2,7 +2,7 @@
2
2
 
3
3
  Windows 窗口使用 `screen-saver` 置顶层级;macOS/Linux 保留 `floating`。Windows 在显示/还原/焦点变化后复核原生置顶标志,并在可见期间每三秒检查,以覆盖没有 Electron 事件的系统置顶丢失;标志仍有效时不重复提升窗口。隐藏、最小化时取消检查,锁屏/休眠时不修复,不调用显示或焦点接口;关闭窗口和退出应用均解除定时器、排队回调及监听。此恢复只维护可见窗口的置顶资格,不改变用户的显示意图。
4
4
 
5
- 默认 Electron 路径解析不执行会同步下载的 `electron/index.js`。已有二进制直接复用;缺失时异步运行官方安装器,继承网络/镜像环境,最多准备四分钟,随后仍按 20 秒检查原生 ready。Host 启动总期限为 265 秒,包含准备和窗口启动;自定义测试期限可覆盖。准备阶段保持 `starting`,停止/停用立即取消安装器并等待其退出,不启动迟到的窗口;下载失败直接显示可手动重试的错误,不触发自动恢复风暴。
5
+ 默认 Electron 路径解析不执行会同步下载的 `electron/index.js`。已有二进制直接复用;缺失时异步运行官方安装器,继承网络/镜像环境,最多准备四分钟,随后仍按 20 秒检查原生 ready。Host 启动总期限为 265 秒,包含准备和窗口启动;自定义测试期限可覆盖。准备阶段保持 `starting`,停止/停用立即取消安装器并等待其退出,不启动迟到的窗口。同一轮启动中收到的启动/显示/角色管理请求共用本轮结果;失败后可发起新的手动启动,其他插件的下载独立。设置页只显示归类后的原因和 HTTP 状态,不显示安装器原始输出、镜像地址或路径。运行时准备失败不触发自动恢复。
6
6
 
7
7
  Host 的 `PetControls` 独占恢复调度。意外退出(包括没有主动关闭回执的 exit 0)及明确标记为可恢复的启动失败,最多自动重试三次,依次等待 1、3、10 秒;连续运行 60 秒后清零。休眠或锁屏中不计算稳定时间。时间参数可注入。未知错误、缺少图形环境、无效或不可执行的运行时路径直接进入 error;清理未确认成功也不启动新进程。
8
8
 
@@ -15,6 +15,7 @@ npx playwright-core install chromium
15
15
  npm run character:pack -- examples/star paper-star.zip
16
16
  npm run test:ui
17
17
  npm run test:notification-ui
18
+ npm run test:hint-ui
18
19
  npm run test:inbox-ui
19
20
  npm run test:keyboard-native
20
21
  npm run test:desktop
@@ -27,9 +28,11 @@ npm run test:install
27
28
 
28
29
  `npm run dev` 打开浏览器演示(默认 `http://127.0.0.1:4173`),`npm run demo` 启动桌面演示,二者的任务事件均为模拟。首页素材的重拍见[素材说明](assets/README.md)。
29
30
 
30
- 浏览器检查真实 API 2 动画、聊天、完整阅读、角色导入及脚本隔离;桌面检查真实 Electron 窗口、IPC、托盘和恢复;安装检查使用官方 DSH loader 安装实际 `.tgz`。用 `DSH_TEST_VERSION=<支持版本>` 选择宿主,用 `DSH_TEST_PACKAGE_DIR=<规范包目录>` 消费已有规范包及校验文件。完整平台/宿主列表以 CI 矩阵为准。
31
+ 浏览器检查真实 API 2 动画、聊天、完整阅读、角色导入及脚本隔离;桌面检查真实 Electron 窗口、IPC、托盘和恢复;安装检查使用官方 DSH loader 安装实际 `.tgz`。`test:install` 默认检查 `0.2.0-rc.2`;用 `DSH_TEST_VERSION=<支持版本>` 选择其他已声明宿主,用 `DSH_TEST_PACKAGE_DIR=<规范包目录>` 消费已有规范包及校验文件。完整平台/宿主列表以 [CI 配置](../.github/workflows/ci.yml) 和 `package.json` 为准。
31
32
 
32
- macOS CI 固定使用 `macos-15` Apple Silicon 标准 runner。浏览器回归结束后再执行原生桌面检查,保留既有执行顺序,系统桌面操作串行进行。三平台测试和二十一组宿主安装保留全部断言与期限;本地 VM 验证仍单独记录实际系统、提交与包摘要。
33
+ macOS CI 固定使用 `macos-15` Apple Silicon 标准 runner。原生测试和安装使用隔离数据目录,浏览器回归结束后再串行执行系统桌面操作。三平台测试和正式宿主安装矩阵保留全部断言与期限,同包发布规则见[发布流程](releasing.md)。
34
+
35
+ 本地 macOS 原生与交互验证使用项目隔离 VM。VM 管理入口和 SSH 身份属于本机环境配置;本分支不提供 VM 管理脚本。执行前核对实例状态和来宾工作目录,为每轮另建独立 checkout,只传选定源码与分发包,保持原有 profile、凭证和证据。结果记录实际系统、宿主、完整源码提交与包摘要;测试结束后停止本轮启动且已无其他工作使用的实例。VM 的验证范围与物理设备、真实账号模型和长期体验分别报告。
33
36
 
34
37
  真实轻抚回归在角色宽度的 20%/80% 位置间往返,保持每次十八个可信移动,避免窄幅轨迹在输入调度迟缓时衰减为无效手势。伪造事件拒绝、二十次反馈、增长冷却、500 ms 响应和原有等待期限继续检查,产品判定规则不变。
35
38
 
@@ -37,23 +40,39 @@ macOS CI 固定使用 `macos-15` Apple Silicon 标准 runner。浏览器回归
37
40
 
38
41
  完成、打断与存档回归保留默认 `happy → dance → neutral` 长配方。该用例使用调度虚拟时钟,并通过 API 2 补充有效 `tick` 输入推进真实角色物理;每次等待输入处理回执,再读取角色实际报告的 `moving`。额外物理输入最多 400 × 50ms,回执与进度检查仍保留原十秒等待。角色实现、真实布局/事件及存档服务共同参与验证;渲染帧率与交互延迟继续由真实时间用例检查。
39
42
 
40
- 原生测试和安装使用隔离数据目录,系统桌面操作串行执行。CI 测试沙箱参数仅供隔离实例;普通安装保留 Chromium sandbox 与 contextIsolation,关闭 Node integration。测试通知适配器和模型答复器属于受控边界,不能代替通知中心实机送达或真实模型会话验收。
43
+ CI 测试沙箱参数仅供隔离实例;普通安装保留 Chromium sandbox 与 contextIsolation,关闭 Node integration。测试通知适配器和模型答复器属于受控边界,不能代替通知中心实机送达或真实模型会话验收。
41
44
 
42
45
  通知单元、Host 契约和同包安装探针通过 Cordis 插件生命周期挂载并等待 `UserQuestionService`;使用实际审批服务的探针也等待 `ApprovalService`,再读取相关投影。DSH 0.2.2 把投影注册移到了 `Service.init`,仅调用构造函数无法代表已就绪的真实服务。模拟 Agent 也提供新版 `model` 接口,同时保留旧 SDK 的结构类型检查;原有身份、continued 状态、精确答复和卸载断言保持不变。
43
46
 
44
47
  安装探针按当前可见的“账号菜单/Account menu”或直接“设置/Settings”入口打开同一设置面板,不按宿主版本前缀推断布局。面板关闭后的有限重开、桌宠分区、状态加载及可写配置断言保持不变。原生多屏拖拽未进入 `drag` 时,另存已有 OS/CDP 输入轨迹及按压/命中状态到 `multi-display-native-drag-failure.json`,保留原失败与等待期限。
45
48
 
49
+ ## 固定基座验收
50
+
51
+ 在干净 checkout 准备 Git、Bash、Node.js 和 Docker。共享基座为 [dsh-plugin-engineering](https://github.com/takboo/dsh-plugin-engineering) 提交 `9ed36752356975cd7d47c11d63744220443c1bf7`,在该提交下阅读 `docs/engineering-contract.md`、`docs/plugin-onboarding.md`、`docs/distribution.md` 和 `docs/test-environments.md`。传入已构建的包,以及包含这个固定提交的基座 checkout。
52
+
53
+ 试点的普通浏览器检查在 Linux Docker 内使用锁定的 Chromium。本机 macOS 的浏览器与原生桌面检查按上方隔离环境执行。
54
+
55
+ ```bash
56
+ bash scripts/verify-engineering.sh /path/to/dsh-plugin-engineering /path/to/candidate.tgz artifacts/engineering-acceptance
57
+ ```
58
+
59
+ 入口从包内构建信息读取源码提交,并核对[宿主目标配置](../tests/engineering-targets.json)和 Web 探针在源码提交、候选包和 checkout 中的字节一致。输出目录需为新路径。基座在 Linux 容器内验证宿主准入、Web 行为和卸载,并把输入摘要和基座身份写入 `host.json`。Coopanion 的 `test:inbox-ui` 在同一个容器镜像内运行,使用同一包和包内锁文件,结果及 Chromium 版本写入 `inbox-ui.log`。
60
+
61
+ DSH 插件管理器通过 `./package.json` 导出读取安装包的顶层 `icon`。发布包校验同时检查导出、图标字节和原始 SVG。升级图标后在真实插件管理器核对实际渲染的 PNG。
62
+
46
63
  ## 关键行为回归
47
64
 
48
65
  | 改动 | 检查入口与范围 |
49
66
  |---|---|
50
67
  | 完成、通知与请求结算 | `npm test`、`test:n0`、`test:notification-ui`;宿主接口检查由安装入口执行 |
68
+ | 同进程插件临时提示 | `npm test`、`test:hint-ui`;检查临时气泡、来源身份及可见性撤下,保持独立通知结算 |
51
69
  | 聊天、收件箱、字号、多屏、NPC 日常 | `test:inbox-ui`;会话与字号浏览器用例串行,初始化失败保留有界状态、控制台与截图 |
52
70
  | NPC 配置 | `tests/npc-controls-ui.mjs`:关闭许可、quiet/interactive、热切状态保持与禁用上游随机漫游 |
53
71
  | 异常查看与尺寸 | `tests/attention-size-ui.mjs`:通用异常回执、新修订、审批/提问与固定角色尺寸 |
54
72
  | 拖放与小窝 | `tests/npc-drag-ui.mjs`:真实指针轨迹、两侧边缘、区域外停留、旧路线取消、按住及释放后小窝锚点 |
55
73
  | 自主循环与互动存档 | `tests/npc-life.test.js`、`tests/npc-life-native.mjs`、`tests/companionship-ui.mjs`、`tests/companionship-native.mjs` |
56
74
  | 原生冷启动 | `tests/lifecycle-startup-native.mjs`:受控 unknown/locked 与实际系统状态分别检查 |
75
+ | Electron 首次准备 | `tests/electron-startup.test.ts` 检查安装器、取消和并发启动;`tests/engineering-web-probe.mjs` 由共享基座在真实 Web Host 验证设置和重试。Windows 官方 Desktop 的拒绝、完整挂起、取消和真实窗口单独复测 |
57
76
  | Windows 置顶 | `tests/always-on-top.test.js`、`tests/windows-topmost-native.mjs`:平台策略、寿命清理与真实 Win32 TOPMOST 丢失/恢复 |
58
77
 
59
78
  原生 NPC 用例控制时钟、粗粒度输入和鼠标感知;身体移动及 arrived/interrupted 保持真实。受控循环通过与物理输入、自然体验分别报告。
@@ -5,3 +5,4 @@ description:
5
5
  en: Adds an animated desktop companion with task notifications, session chat, character packs, and native settings for DeepSeek Harness.
6
6
  zh: 为 DeepSeek Harness 添加动画桌面伙伴,支持任务提醒、会话聊天、角色包和原生设置。
7
7
  tarball: https://github.com/takboo/dsh-coopanion/releases/latest/download/dsh-coopanion.tgz
8
+ icon: https://raw.githubusercontent.com/takboo/dsh-coopanion/main/assets/coopanion.png
@@ -70,7 +70,7 @@ Host 按运行状态、显示状态及用户设置选择通道。系统投递需
70
70
 
71
71
  `npm run test:n0` 检查共享协议和网页适配器,并构建私有原型。`npm run test:n0:host -- --runtime <runtime-dir> --version <dsh-version>` 在实际安装的宿主包上检查公开请求、投影、审批配对和取消语义。
72
72
 
73
- 三平台 CI 执行共享检查并保留原型摘要;十八组实际安装检查分别执行对应宿主版本的接口检查并上传报告。每份 Host 报告记录源码 commit、插件版本、包实现摘要及实际控制样本事件。
73
+ 三平台 CI 执行共享检查并保留原型摘要;[宿主安装矩阵](../.github/workflows/ci.yml) 从 `package.json` 的精确支持列表生成,分别执行对应宿主版本的接口检查并上传报告。每份 Host 报告记录源码 commit、插件版本、包实现摘要及实际控制样本事件;同包分发与发布资格见[发布流程](releasing.md)。
74
74
 
75
75
  独立 `textScale` 是呈现偏好,不改变类别、提醒身份、已读/结算或驻留时间;详见[文字契约](text-readability-contract.md)。
76
76
 
@@ -1,3 +1,19 @@
1
+ # v0.4.21
2
+
3
+ - 接入固定共享工程基座。兼容性巡检分别验证 npm 已发布原包和隔离适配候选包,记录两者的宿主准入及运行阶段。
4
+ - 添加 dshfind 徽章和项目原创的随包图标,市场目录可使用同一枚 PNG。
5
+
6
+ 安装包为 `dsh-coopanion-0.4.21.tgz`,npm 与 GitHub Release 使用同一份通过发布检查的包。
7
+
8
+ # v0.4.20
9
+
10
+ 修复 Windows 上首次准备 Electron 时桌宠无法启动、设置页缺少具体错误提示的问题(#40)。
11
+
12
+ - 缺少 Electron 时,在桌宠设置页显示下载拒绝、连接失败、超时或安装失败,并提供重试及手动准备入口。
13
+ - 下载期间的并发启动请求共用同一次准备的结果,失败后等待用户手动重试。下载期间可从桌宠设置点击关闭,取消本轮准备。
14
+
15
+ 安装包为 `dsh-coopanion-0.4.20.tgz`,npm 与 GitHub Release 使用同一份通过发布检查的包。
16
+
1
17
  # v0.4.19
2
18
 
3
19
  新增 DSH `0.2.2-rc.1` 正式支持,并修复新版兼容性检查(#35、#36、#37)。
package/docs/releasing.md CHANGED
@@ -14,19 +14,26 @@ git tag v<实际版本> <发布提交>
14
14
  git push origin v<实际版本>
15
15
  ```
16
16
 
17
- 稳定标签新建 push 会派发 **main 上的 `release.yml`**。也可在 Actions → Release → Run workflow 选择 main,输入已有标签;默认 `mode=verify` 仅验证,选择 `publish` 才发布。发布授权应覆盖合并、标签及随后执行的 npm/GitHub Release 发布。
17
+ 稳定标签首次推送后,main 上的 `release.yml` 会以 `mode=verify` 执行完整验证。也可从 Actions 在 main 手动派发验证。等待验证通过并下载该运行的 `desktop-pet`,用其中的版本包完成对应的桌面验收。记录验证运行编号、包的 SHA-256 和验收结果,再在 main 派发发布。
18
+
19
+ ```bash
20
+ gh workflow run release.yml --ref main -f tag="$RELEASE_TAG" -f mode=publish \
21
+ -f verified-run="$VERIFIED_RUN" -f verified-sha256="$VERIFIED_SHA256"
22
+ ```
23
+
24
+ 发布任务从指定的成功验证运行取回原始附件,复核标签、构建提交和所填摘要。验证报告和产物保留七天,过期后需要重新验证并验收新运行的包。
18
25
 
19
26
  ## 自动检查与同包分发
20
27
 
21
- CI 在 Linux、macOS、Windows 上运行元数据、类型、单元、浏览器、键盘辅助进程及真实 Electron 窗口检查;宿主安装矩阵使用 `package.json` 声明支持的七版 DSH,三平台共二十一组。实际配置以 `.github/workflows/ci.yml` 为准。Linux 窗口检查由 Xvfb + Openbox 提供隔离显示,原生桌面步骤保留进程日志并设置六分钟上限。
28
+ CI 在 Linux、macOS、Windows 上运行元数据、类型、单元、浏览器、键盘辅助进程及真实 Electron 窗口检查;宿主安装矩阵按三平台与 `package.json#engines.dsh` 的精确版本列表组合生成,实际配置以 [.github/workflows/ci.yml](../.github/workflows/ci.yml) 为准。Linux 窗口检查由 Xvfb + Openbox 提供隔离显示,原生桌面步骤保留进程日志并设置六分钟上限。
22
29
 
23
30
  发布验证标签是 `origin/main` 的祖先、包与 shrinkwrap 版本一致且当前发布说明存在,然后检出不可变提交并重新执行完整 CI。PR 或 main 的先前测试结果不能代替标签上的发布检查。
24
31
 
25
- Linux 构建并打包一次,成为规范产物。`npm pack` 产生的 `takboo-dsh-coopanion-<版本>.tgz` 只重命名为 `dsh-coopanion-<版本>.tgz`;固定别名通过复制获得。二十一组安装、npm 和 Release 都消费这份压缩包,发布使用 `--ignore-scripts`,不会再次构建。
32
+ Linux 构建并打包一次,成为规范产物。`npm pack` 产生的 `takboo-dsh-coopanion-<版本>.tgz` 只重命名为 `dsh-coopanion-<版本>.tgz`;固定别名通过复制获得。完整宿主安装矩阵、npm 和 Release 都消费这份压缩包,发布使用 `--ignore-scripts`,不会再次构建。
26
33
 
27
34
  `verification.json` 绑定完整源码提交、版本、SHA-256 与 npm SHA-512 integrity;`dist/build-info.json` 记录产品输入摘要。生成正式报告要求干净、已提交的 checkout。构建摘要不代替完整 `.tgz` 的身份。
28
35
 
29
- 发布顺序为 **完整 CI → npm → GitHub Release**。npm job 使用 Trusted Publisher OIDC;Release job 独立拥有内容写权限。发布前再次核对标签没有移动。fork、其他分支、移动/删除标签和预发布标签不进入稳定版自动发布路径。
36
+ 发布顺序为 **完整 CI → 本轮要求的额外宿主验收 → npm → GitHub Release**。npm job 使用 Trusted Publisher OIDC;Release job 独立拥有内容写权限。发布前再次核对标签没有移动。fork、其他分支、移动/删除标签和预发布标签不进入稳定版验证与发布流程。
30
37
 
31
38
  Release 附件包括:
32
39
 
@@ -38,6 +45,8 @@ Release 附件包括:
38
45
 
39
46
  ## 失败与重跑
40
47
 
48
+ 检查失败时先保留对应 job 的日志与 artifact,核对失败断言、运行环境及规范包身份,再决定修复或复验。对失败检查复验时沿用规范包、原断言及原期限,并保留首轮失败与后续结果;复验通过单独记账,不能据此宣称根因已修复。
49
+
41
50
  npm 上传后可能异步处理。发布后的 `--require-published` 对 404 每十秒重试、最多五分钟;不同字节占用版本、其他 HTTP 错误或超时均失败。上传前的版本检查只查询一次。
42
51
 
43
52
  npm 成功但 Release 附档失败时,优先在 artifact 的七天保留期内重跑失败 job。重跑 publish 仅在 npm integrity 与规范包完全相同时跳过上传;字节冲突必须增加版本。已发布标签、包和原始报告保持不可变,不能本地重打包替换。
@@ -46,10 +55,28 @@ OIDC 认证失败时核对实际 Trusted Publisher 绑定和 job 日志。认证
46
55
 
47
56
  ## 发布后核验
48
57
 
49
- 核对 npm 版本和 `latest`、Release 正文、版本包、固定别名、`verification.json` 及 `SHA256SUMS`。下载字节应与通过安装矩阵的规范包相同。新的核验使用独立记录并绑定本次提交和包摘要。
58
+ 核对 npm 版本和 `latest`、Release 正文、版本包、固定别名、`verification.json` 及 `SHA256SUMS`。下载字节应与通过安装矩阵的规范包相同。新的核验使用独立记录并绑定本次提交和包摘要;结论更新本页“最近一次发布核验”,链接对应 Release 与运行记录。
50
59
 
51
60
  安装入口使用精确 `@takboo/dsh-coopanion@<版本>`。pnpm 的发布时间保护可能使裸包名暂时解析为旧版,详情页显示新版不证明安装了新版;检查隔离 profile 中的精确版本安装及实际日志。原因与操作见[使用指南](usage.md#安装版本与发布时间保护)。
52
61
 
62
+ ## 最近一次发布核验
63
+
64
+ ### v0.4.20
65
+
66
+ 2026-11-09 发布 [v0.4.20](https://github.com/takboo/dsh-coopanion/releases/tag/v0.4.20),发布源码为 `5febec8cfe35b4b106ab1587157b2f2574136564`,规范包 SHA-256 为 `4591faa7c1164b944ab844bc62cd83bb3cfa10b0ed86b63a5c47e528952cc0c0`。核验时 npm `latest` 为 `0.4.20`,DSH `0.2.2-rc.1` 从 npm 安装精确版本通过。npm tarball、Release 版本包、固定别名及 latest 下载与规范包逐字节一致。[verification.json](https://github.com/takboo/dsh-coopanion/releases/download/v0.4.20/verification.json)
67
+
68
+ [main CI](https://github.com/takboo/dsh-coopanion/actions/runs/42603391595) 通过。发布验证完成七版宿主、三平台共 21 组同包安装,OIDC 发布复用该运行的规范包。[发布验证](https://github.com/takboo/dsh-coopanion/actions/runs/42606722518) · [OIDC 发布](https://github.com/takboo/dsh-coopanion/actions/runs/42609601652)
69
+
70
+ 固定基座 `5fe3e92c64d4dfbbcfd3926fb52c347b10cc641e` 的 Linux 容器验证了 DSH `0.2.2-rc.1` 安装、设置和卸载,以及 `0.2.1-rc.4` 拒绝且无残留。Coopanion 收件箱测试同样在 Linux 容器通过。官方 Windows Desktop `0.2.2-rc.1` 的两个隔离 profile 分别验证了插件管理器安装后的真实桌宠窗口,以及冷下载中点击关闭后安装器和连接退出、Host 保持可用。正式复测覆盖隔离 VM 的交互会话。详细身份、检查范围和市场快照见[补充核验记录](https://github.com/takboo/dsh-coopanion/releases/download/v0.4.20/additional-verification.json)。
71
+
72
+ ### v0.4.19
73
+
74
+ 2026-11-05 已发布 [v0.4.19](https://github.com/takboo/dsh-coopanion/releases/tag/v0.4.19),核验时 npm `latest` 为 `0.4.19`。发布提交为 `28ed7679fe28fabff3f2b2d0fa48e69d85d05a55`,规范包 SHA-256 为 `7f5d0cc83823c25985a99ec30741662e64f17b6185b2fa5dc40ac863d2559ba1`;npm tarball、Release 版本包、固定别名和当时的 latest 下载字节一致。固定身份见该 Release 的 [verification.json](https://github.com/takboo/dsh-coopanion/releases/download/v0.4.19/verification.json),详细范围见[补充核验记录](https://github.com/takboo/dsh-coopanion/releases/download/v0.4.19/additional-verification.json)。
75
+
76
+ [main CI](https://github.com/takboo/dsh-coopanion/actions/runs/41995247279) 和[标签发布流程](https://github.com/takboo/dsh-coopanion/actions/runs/41998629966) 最终通过七版宿主、三平台共 21 组同包安装。首轮标签检查在 DSH `0.2.1-rc.5` 上分别出现 Linux 重启后陪伴模式不符和 Windows Host 退出超时,另有 Windows/DSH `0.2.1-rc.3` 原生窗口未就绪;三项在同源同包、原断言与原期限下复验通过,根因尚未确认,原始失败保留。
77
+
78
+ 隔离 macOS 15.7.7 ARM64 VM 预检完成单元、收件箱与原生桌面验证,正式规范包在普通 npm rc.1 Host 上的实际安装通过;匹配的官方签名 Desktop/ASAR 12 阶段检查也通过,报告仍保留 `partial` 范围。原生 Desktop shell、系统通知中心、真实账号模型、物理多屏及长期体验未据此验收。
79
+
53
80
  ## 社区市场
54
81
 
55
82
  市场从社区目录读取条目,npm 发布本身不完成收录。仓库维护的条目为 [takboo__dsh-coopanion.yml](market/takboo__dsh-coopanion.yml),使用固定 Release 下载地址;投稿按[社区贡献规范](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/blob/main/contributing.md)核对,不修改生成文件。
@@ -1,6 +1,6 @@
1
1
  # 会话直接续接契约
2
2
 
3
- 支持 DSH `0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-rc.1` 、`0.2.1-rc.2`、`0.2.1-rc.3` 和 `0.2.1-rc.5`。共享线协议定义在 [chat-contract.js](../web/chat-contract.js) 和[类型声明](../web/chat-contract.d.ts),Host 准入在 [chat.ts](../src/chat.ts),Client 草稿状态在 [session-ui.js](../web/session-ui.js)。
3
+ 宿主精确支持范围以 [package.json](../package.json) 的 `engines.dsh` 与 DSH peer 声明为准,安装入口见[使用指南](usage.md)。共享线协议定义在 [chat-contract.js](../web/chat-contract.js) 和[类型声明](../web/chat-contract.d.ts),Host 准入在 [chat.ts](../src/chat.ts),Client 草稿状态在 [session-ui.js](../web/session-ui.js)。
4
4
 
5
5
  ## 消息与回执
6
6
 
package/docs/usage.md CHANGED
@@ -4,13 +4,13 @@
4
4
 
5
5
  ## 安装到 Desktop
6
6
 
7
- 支持 **DSH 0.2.0-rc.2、0.2.1-alpha.1、0.2.1-rc.1、0.2.1-rc.2、0.2.1-rc.3、0.2.1-rc.5 和 0.2.2-rc.1**;其他版本未声明兼容。
7
+ 支持的宿主版本见[首页的安装入口](../README.md#开始一起工作),精确准入声明以 [package.json](../package.json) 的 `engines.dsh` 与 DSH peer 为准;其他版本未声明兼容。
8
8
 
9
- 在 0.2.1-rc.1 / rc.2 / rc.3 / rc.5 和 0.2.2-rc.1 中,从左下角账号菜单(未登录时显示“更多”)选择“设置”,再进入“桌宠”;0.2.0-rc.2/0.2.1-alpha.1 从侧栏“设置”进入。
9
+ 从左下角账号菜单(未登录时可能显示“更多”)选择“设置”,再进入“桌宠”;如果侧栏直接提供“设置”,则从该入口进入。
10
10
 
11
11
  ### 在 Harness 中从 npm 安装
12
12
 
13
- 打开侧边栏 **插件 → 添加插件**,在「包名或地址」输入 **`@takboo/dsh-coopanion@0.4.19`**,点击安装,再启用 `dsh-coopanion`。显式版本可以避免发布首日的裸包名解析回退,原因见下方。安装方式见 [Harness 官方插件管理说明](https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/client/ui-plugin-manager/README.zh.md#安装一个组合包)。
13
+ 打开侧边栏 **插件 → 添加插件**,在「包名或地址」输入 **`@takboo/dsh-coopanion@0.4.21`**,点击安装,再启用 `dsh-coopanion`。显式版本可以避免发布首日的裸包名解析回退,原因见下方。安装方式见 [Harness 官方插件管理说明](https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/client/ui-plugin-manager/README.zh.md#安装一个组合包)。
14
14
 
15
15
  ### 安装版本与发布时间保护
16
16
 
@@ -23,7 +23,7 @@ pnpm 11 的 `minimumReleaseAge` 默认为 1440 分钟(24 小时)。详情页
23
23
  **Desktop:** 使用 Desktop 自带的 `dsh` 命令。先启动 Desktop 一次初始化 profile,完全退出应用,再执行:
24
24
 
25
25
  ```bash
26
- dsh plugin --profile desktop add @takboo/dsh-coopanion@0.4.19
26
+ dsh plugin --profile desktop add @takboo/dsh-coopanion@0.4.21
27
27
  ```
28
28
 
29
29
  npm 安装的 dsh 不能管理 Desktop 所拥有的 profile;若系统找不到 Desktop 的命令,先在 Desktop 的菜单栏中使用 **Manage dsh command/管理 dsh 命令** 安装命令入口。
@@ -31,7 +31,7 @@ npm 安装的 dsh 不能管理 Desktop 所拥有的 profile;若系统找不到
31
31
  **本机 Web profile:** 使用 npm 安装的 dsh 时,向实际使用的 profile 安装。例如默认 `web` profile:
32
32
 
33
33
  ```bash
34
- dsh plugin --profile web add @takboo/dsh-coopanion@0.4.19
34
+ dsh plugin --profile web add @takboo/dsh-coopanion@0.4.21
35
35
  dsh --profile web
36
36
  ```
37
37
 
@@ -55,7 +55,7 @@ Windows 桌宠显示期间会在失去置顶后自动恢复,恢复时不抢当
55
55
 
56
56
  ### Electron 运行时准备
57
57
 
58
- 首次安装或升级 Electron 后,桌宠在独立子进程中下载、校验并解压运行时;准备期间设置页显示“正在启动”,Harness 的窗口、服务和其他插件继续响应,也可随时关闭桌宠来取消准备。准备最多等待四分钟,失败后设置页显示错误;检查网络后点击启动重试。运行时准备完成后才开始原生窗口的 20 秒启动检查。
58
+ 首次安装或升级 Electron 后,桌宠在独立子进程中下载、校验并解压运行时;准备期间设置页显示“正在启动”,Harness 可继续使用。点击“关闭桌宠”可取消准备。准备最多等待四分钟;失败后,设置页会区分下载被拒(含 HTTP 状态码)、连接失败、超时和安装失败,并提供恢复入口。检查网络后点击“启动桌宠”重试。运行时准备完成后才开始原生窗口的 20 秒启动检查。
59
59
 
60
60
  网络受限时可设置 Electron 支持的 `ELECTRON_MIRROR`,并从设置了该变量的终端启动 Harness。也可完全退出 Harness 后,在实际 profile 目录手动准备(下面以 Windows PowerShell 为例):
61
61
 
@@ -64,7 +64,7 @@ $env:ELECTRON_MIRROR='https://npmmirror.com/mirrors/electron/'
64
64
  node "$env:DSH_HOME\profiles\desktop\node_modules\electron\install.js"
65
65
  ```
66
66
 
67
- 使用实际配置的 `DSH_HOME`;CLI 的其他 profile 替换 `desktop`。运行时继续按 Electron 的安装器校验。成功后重新打开 Harness;已准备好的二进制直接复用。自备运行时也可使用 `electronPath` 的绝对路径配置。
67
+ 使用实际配置的 `DSH_HOME`(默认是用户目录下的 `.dsh`);CLI 的其他 profile 替换 `desktop`。运行时继续按 Electron 的安装器校验。成功后重新打开 Harness;已准备好的二进制直接复用。也可在该 profile 的桌宠配置中设置 `electronPath` 为已准备好且平台、架构匹配的 Electron 44.7.0 可执行文件的绝对路径,例如 Windows 的 `C:\Electron\electron.exe`,然后重新打开 Harness。
68
68
 
69
69
  ## 配置与会话
70
70
 
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "@takboo/dsh-coopanion",
3
- "version": "0.4.19",
3
+ "version": "0.4.21",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "@takboo/dsh-coopanion",
9
- "version": "0.4.19",
9
+ "version": "0.4.21",
10
10
  "license": "AGPL-3.0-or-later",
11
11
  "dependencies": {
12
12
  "dompurify": "3.4.17",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@takboo/dsh-coopanion",
3
- "version": "0.4.19",
3
+ "version": "0.4.21",
4
4
  "description": "DeepSeek Whale desktop companion and task notifications for DeepSeek Harness",
5
5
  "type": "module",
6
6
  "license": "AGPL-3.0-or-later",
@@ -27,14 +27,17 @@
27
27
  "node": ">=22.19",
28
28
  "dsh": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.5 || 0.2.2-rc.1"
29
29
  },
30
+ "icon": "./assets/coopanion.png",
30
31
  "main": "./dist/index.js",
31
32
  "exports": {
32
33
  ".": "./dist/index.js",
34
+ "./package.json": "./package.json",
33
35
  "./cordis.patch.yml": "./cordis.patch.yml",
34
36
  "./client": "./dist/client.js"
35
37
  },
36
38
  "files": [
37
39
  "dist",
40
+ "assets",
38
41
  "desktop",
39
42
  "web",
40
43
  "web/markdown-runtime.js",
@@ -97,6 +100,7 @@
97
100
  "test:m2:host": "node tests/session-host-contract.mjs",
98
101
  "compat:discover": "node scripts/compatibility/discover.mjs",
99
102
  "compat:prepare": "node scripts/compatibility/prepare.mjs",
103
+ "compat:published": "node scripts/compatibility/published.mjs",
100
104
  "compat:check": "node scripts/compatibility/check.mjs",
101
105
  "compat:desktop": "node scripts/compatibility/desktop.mjs",
102
106
  "compat:report": "node scripts/compatibility/report.mjs"
@@ -25,6 +25,15 @@ assert.ok(unpack('dist/client.js').includes(`id: ${JSON.stringify(packed.name)}`
25
25
  if (values['expected-version']) assert.equal(packed.version, values['expected-version'], 'archive version differs from tag');
26
26
  else assert.equal(packed.version, pkg.version);
27
27
  assert.equal(packed.repository.url, pkg.repository.url);
28
+ assert.equal(packed.icon, './assets/coopanion.png');
29
+ assert.equal(packed.exports['./package.json'], './package.json', 'DSH needs the exported manifest to read the installed icon');
30
+ const icon = execFileSync('tar', ['-xOzf', archive, `package/${packed.icon.slice(2)}`]);
31
+ assert.deepEqual(icon, readFileSync(packed.icon), 'archive icon differs from project icon');
32
+ assert.equal(icon.subarray(0, 8).toString('hex'), '89504e470d0a1a0a');
33
+ assert.equal(icon.readUInt32BE(16), 180);
34
+ assert.equal(icon.readUInt32BE(20), 180);
35
+ assert.ok(icon.length <= 32 * 1024, 'icon must fit the DSH index inline limit');
36
+ assert.ok(entries.includes('package/assets/coopanion.svg'), 'missing original icon source');
28
37
  for (const required of ['dist/client.js', 'dist/index.js', 'dist/character-store.cjs', 'dist/figure-server.cjs', 'cordis.patch.yml', 'desktop/main.cjs', 'desktop/tray-state.cjs', 'desktop/preload.cjs', 'web/index.html', 'web/pet.js', 'web/speech.js', 'web/session-ui.js', 'web/chat-contract.js', 'web/chat-contract.d.ts', 'web/text-scale.js', 'web/text-scale.d.ts', 'docs/text-readability-contract.md', 'tests/text-scale-ui.mjs', 'tests/helpers/text-scale-native.mjs', 'src/chat.ts', 'tests/session-host-contract.mjs', 'tests/fixtures/session-host.mjs', 'docs/session-chat-contract.md', 'web/locale.js', 'web/locale.d.ts', 'src/client/locale-sync.ts', 'tests/locale-ui.mjs', 'tests/locale-client.mjs', 'web/reply-markdown.js', 'web/markdown-runtime.js', 'web/tray-icon.js', 'web/upstream/kit/rig.js', 'web/upstream/kit/body.js', 'web/upstream/figure-frame.html', 'web/upstream/body-host.js', 'web/upstream/whale/figure.json', 'web/upstream/whale/model.json', 'web/upstream/whale/tex/face.png', 'web/upstream/UPSTREAM.md', 'web/upstream/THIRD_PARTY_NOTICES.md', 'src/figure-server.ts', 'src/upstream/packs.ts', 'scripts/build.mjs', 'npm-shrinkwrap.json', 'tsconfig.json', 'tsconfig.client.json', '.node-version', 'docs/characters.md', 'examples/star/figure.json', 'examples/star/figure.js', 'tests/figures.test.ts', 'docs/licenses/marked.txt', 'docs/licenses/dompurify.txt', 'THIRD_PARTY_NOTICES.md', 'LICENSE', 'LICENSE-MIT', 'README.md']) assert.ok(entries.includes(`package/${required}`), `missing ${required}`);
29
38
  assert.ok(!entries.some(path => path.includes('node_modules/') || path.includes('.cache/')));
30
39
  assert.ok(!entries.some(path => /character-runtime|character.schema|\/animation\.|\/character-pack\.(?:[cm]?[jt]s)(?:\.map)?$|\/web\/characters\//.test(path)), 'old engine and format must not be packaged');
@@ -21,7 +21,11 @@ try {
21
21
  assert.equal(meta.version, report.version); assert.equal(meta.sourceCommit, report.sourceCommit); assert.equal(meta.targetIdentity, report.target.identity);
22
22
  const baseline = JSON.parse(await readFile(join(root, 'package.json'), 'utf8'));
23
23
  const archive = join(bundle, `dsh-coopanion-${baseline.version}.tgz`);
24
- report.archiveSha256 = createHash('sha256').update(await readFile(archive)).digest('hex'); assert.equal(report.archiveSha256, meta.archiveSha256);
24
+ const bytes = await readFile(archive);
25
+ report.archiveSha256 = createHash('sha256').update(bytes).digest('hex');
26
+ assert.equal(report.archiveSha256, meta.archiveSha256);
27
+ report.package = { name: baseline.name, version: baseline.version, sha256: report.archiveSha256,
28
+ integrity: `sha512-${createHash('sha512').update(bytes).digest('base64')}`, sourceCommit: report.sourceCommit };
25
29
  const metadata = await request(`https://registry.npmjs.org/@deepseek-ai%2Fdsh/${report.version}`);
26
30
  assert.equal(metadata.dist.integrity, report.target.npm.integrity);
27
31
  await copySource(workspace);
@@ -31,13 +35,17 @@ try {
31
35
  await npm('platform-install', ['ci', '--ignore-scripts', '--no-audit', '--no-fund'], { setup: true });
32
36
  report.hostDependencies = hostDependencies(report.version);
33
37
  await npm('host-install', ['install', '--prefix', runtime, '--no-audit', '--no-fund', ...Object.entries(report.hostDependencies).map(([name, exact]) => `${name}@${exact}`)], { setup: true, timeout: 10 * 60000 });
38
+ const lock = JSON.parse(await readFile(join(runtime, 'package-lock.json'), 'utf8'));
39
+ assert.equal(lock.packages['node_modules/@deepseek-ai/dsh'].integrity, report.target.npm.integrity);
34
40
  await npm('host-dependency-tree', ['ls', '--all', '--prefix', runtime]);
35
41
  await command(report, output, 'normal-admission', process.execPath, [join(workspace, 'scripts/compatibility/admission.mjs'), runtime, report.version, join(bundle, 'candidate.json')], { cwd: workspace, env });
36
- Object.assign(env, { DSH_TEST_VERSION: report.version, DSH_TEST_RUNTIME: runtime, DSH_TEST_PACKAGE_DIR: bundle });
42
+ Object.assign(env, { DSH_TEST_VERSION: report.version, DSH_TEST_RUNTIME: runtime, DSH_TEST_PACKAGE_DIR: bundle, DSH_TEST_PHASE_FILE: join(output, 'candidate-phases.json') });
37
43
  await npm('candidate-installation', ['run', 'test:install'], { timeout: 25 * 60000 });
38
44
  report.status = 'partial'; report.reason = 'Actual Loader, browser Client, native companion, notification/goal/session contracts and recovery passed on the same candidate archive and reported exact Host dependency composition; source review and unpinned upstream installations remain separate.';
39
45
  } catch (error) { report.status = error instanceof StageError ? error.status : error instanceof FetchError ? 'retry' : 'failed'; report.reason = String(error.stack ?? error).slice(0, 6000); }
40
46
  finally {
47
+ try { report.candidatePhases = JSON.parse(await readFile(join(output, 'candidate-phases.json'), 'utf8')); }
48
+ catch (error) { if (error.code !== 'ENOENT') throw error; }
41
49
  for (const name of await readdir(join(workspace, 'artifacts')).catch(() => [])) if (/\.(json|png)$/.test(name)) await cp(join(workspace, 'artifacts', name), join(output, name));
42
50
  report.productionSourcesStable = before === await sourceDigest();
43
51
  if (!report.productionSourcesStable) { report.status = 'failed'; report.reason = 'Source files changed during candidate installation'; }
@@ -3,6 +3,7 @@ import assert from 'node:assert/strict';
3
3
  import { appendFile, readFile, writeFile } from 'node:fs/promises';
4
4
  import { pathToFileURL } from 'node:url';
5
5
  import { compareVersions, digest, pages, request, version, versionPattern, assertRepository, FetchError } from './common.mjs';
6
+ import { packageName, stableVersion } from '../release-support.mjs';
6
7
  import { selectChecks } from './planning.mjs';
7
8
  export const desktopFeed = 'https://download.deepseek.com/dsh-desk/feeds/mac-arm64/nightly-mac.yml';
8
9
  export function parseDesktopFeed(source) {
@@ -70,6 +71,13 @@ export async function discover({ manual = '', token, repo, local = false, pullRe
70
71
  assert(/^[a-f\d]{40}$/.test(commit.sha)); target.commit = commit.sha;
71
72
  }
72
73
  for (const target of targets) target.identity = digest({ version: target.version, npm: target.npm, release: target.release ?? null, desktop: target.desktop ?? null, commit: target.commit ?? null });
74
+ if (targets.some(target => target.npm.integrity)) {
75
+ const metadata = await request(`https://registry.npmjs.org/${encodeURIComponent(packageName)}/latest`);
76
+ assert.equal(metadata.name, packageName);
77
+ assert.match(metadata.version, stableVersion);
78
+ assert.match(metadata.dist.integrity, /^sha512-[A-Za-z0-9+/]{86}==$/);
79
+ for (const target of targets) target.published = { name: metadata.name, version: metadata.version, integrity: metadata.dist.integrity };
80
+ }
73
81
  const selected = selectChecks(targets, issues, { baseline, manual: normalized, pullRequest });
74
82
  if (manual) assert.equal(selected.length, 1, 'Exact published target not found');
75
83
  return selected;
@@ -6,7 +6,7 @@ export { validComponents } from './common.mjs';
6
6
  export function componentIdentities(target) {
7
7
  const dependencies = reviewedDependencies(target.version);
8
8
  const reviewed = dependencies ? { dependencyBaseline: dependencies, hostDependencies: hostDependencies(target.version) } : {};
9
- return { sdk: digest({ contract: 1, version: target.version, npm: target.npm, ...reviewed }),
9
+ return { sdk: digest({ contract: 2, version: target.version, npm: target.npm, published: target.published, ...reviewed }),
10
10
  desktop: target.desktop ? digest({ contract: 1, version: target.version, desktop: target.desktop, npm: target.npm, ...reviewed }) : null };
11
11
  }
12
12
  export function componentDue(previous, identity, { manual = false, now = Date.now() } = {}) {