@takboo/dsh-coopanion 0.4.15 → 0.4.17

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 (37) hide show
  1. package/README.md +3 -3
  2. package/THIRD_PARTY_NOTICES.md +4 -0
  3. package/desktop/always-on-top.cjs +32 -0
  4. package/desktop/main.cjs +4 -3
  5. package/dist/build-info.json +2 -2
  6. package/docs/README.md +1 -0
  7. package/docs/compatibility.md +39 -0
  8. package/docs/desktop-recovery-contract.md +2 -0
  9. package/docs/development.md +4 -1
  10. package/docs/notification-contract.md +1 -1
  11. package/docs/release-notes.md +22 -0
  12. package/docs/releasing.md +2 -2
  13. package/docs/session-chat-contract.md +1 -1
  14. package/docs/usage.md +7 -5
  15. package/npm-shrinkwrap.json +812 -648
  16. package/package.json +47 -42
  17. package/scripts/compatibility/LICENSE +21 -0
  18. package/scripts/compatibility/admission.mjs +11 -0
  19. package/scripts/compatibility/check.mjs +43 -0
  20. package/scripts/compatibility/common.mjs +104 -0
  21. package/scripts/compatibility/desktop-artifact.mjs +34 -0
  22. package/scripts/compatibility/desktop-bootstrap.mjs +27 -0
  23. package/scripts/compatibility/desktop.mjs +83 -0
  24. package/scripts/compatibility/discover.mjs +89 -0
  25. package/scripts/compatibility/inspect-desktop.mjs +9 -0
  26. package/scripts/compatibility/planning.mjs +38 -0
  27. package/scripts/compatibility/prepare.mjs +58 -0
  28. package/scripts/compatibility/proposal.mjs +37 -0
  29. package/scripts/compatibility/report.mjs +198 -0
  30. package/scripts/compatibility/runner.mjs +59 -0
  31. package/scripts/observe-companion.mjs +1 -1
  32. package/tests/always-on-top.test.js +67 -0
  33. package/tests/compatibility-monitor.mjs +164 -0
  34. package/tests/goal-host-contract.mjs +4 -2
  35. package/tests/install.mjs +11 -6
  36. package/tests/session-host-contract.mjs +4 -2
  37. package/tests/windows-topmost-native.mjs +112 -0
package/README.md CHANGED
@@ -51,14 +51,14 @@
51
51
 
52
52
  ## 开始一起工作
53
53
 
54
- 需要 **DeepSeek Harness Desktop 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**。这是 Harness 插件,聊天使用你在 Harness 中配置的模型,无需另填 API Key。
54
+ 需要 **DeepSeek Harness Desktop 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**。这是 Harness 插件,聊天使用你在 Harness 中配置的模型,无需另填 API Key。
55
55
 
56
56
  ### 在 Harness 中从 npm 安装(推荐)
57
57
 
58
58
  打开侧边栏 **插件 → 添加插件**,在「包名或地址」中填入:
59
59
 
60
60
  ```text
61
- @takboo/dsh-coopanion@0.4.15
61
+ @takboo/dsh-coopanion@0.4.17
62
62
  ```
63
63
 
64
64
  点击安装,完成后启用 `dsh-coopanion`,再完全退出并重新打开 Harness。
@@ -70,7 +70,7 @@
70
70
  使用 **Desktop 自带的 `dsh` 命令**。先启动 Desktop 一次完成初始化,完全退出应用后执行:
71
71
 
72
72
  ```bash
73
- dsh plugin --profile desktop add @takboo/dsh-coopanion@0.4.15
73
+ dsh plugin --profile desktop add @takboo/dsh-coopanion@0.4.17
74
74
  ```
75
75
 
76
76
  完成后重新打开 Desktop。其他 profile 的安装方法见[使用指南](docs/usage.md#通过-dsh-命令行安装)。
@@ -67,3 +67,7 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
67
67
  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
68
68
  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
69
69
  SOFTWARE.
70
+
71
+ ## Compatibility monitor
72
+
73
+ The discovery, Issue-state, retry and proposal lifecycle in `scripts/compatibility/` adapts takboo/dsh-session-bin and takboo/dsh-usage-state. Copyright (c) 2026 takboo; the MIT notice is preserved in [scripts/compatibility/LICENSE](scripts/compatibility/LICENSE). Project-specific candidate packaging, companion installation and Desktop integration are maintained here.
@@ -0,0 +1,32 @@
1
+ // Windows can lose TOPMOST without a corresponding Electron window event.
2
+ // Check periodically while shown, but only repair a missing flag: repeatedly
3
+ // raising an already-topmost window changes its order among other overlays.
4
+ module.exports.installAlwaysOnTop = (win, { platform = process.platform, isSuspended = () => false } = {}) => {
5
+ win.setAlwaysOnTop(true, platform === 'win32' ? 'screen-saver' : 'floating');
6
+ if (platform !== 'win32') return () => {};
7
+ let disposed = false, timer, pending;
8
+ const pause = () => { clearInterval(timer); timer = undefined; clearImmediate(pending); pending = undefined; };
9
+ const repair = () => {
10
+ if (disposed || win.isDestroyed() || !win.isVisible() || win.isMinimized() || isSuspended()) return;
11
+ if (!win.isAlwaysOnTop()) win.setAlwaysOnTop(true, 'screen-saver');
12
+ };
13
+ const reconcile = () => {
14
+ pending = undefined;
15
+ if (disposed || win.isDestroyed() || !win.isVisible() || win.isMinimized()) { pause(); return; }
16
+ repair();
17
+ timer ??= setInterval(repair, 3000);
18
+ timer.unref?.();
19
+ };
20
+ const schedule = () => { if (!disposed && pending === undefined) pending = setImmediate(reconcile); };
21
+ const events = ['show', 'restore', 'focus', 'blur'];
22
+ const dispose = () => {
23
+ if (disposed) return;
24
+ disposed = true; pause();
25
+ for (const event of events) win.off(event, schedule);
26
+ win.off('hide', pause); win.off('minimize', pause); win.off('closed', dispose);
27
+ };
28
+ for (const event of events) win.on(event, schedule);
29
+ win.on('hide', pause); win.on('minimize', pause); win.once('closed', dispose);
30
+ reconcile();
31
+ return dispose;
32
+ };
package/desktop/main.cjs CHANGED
@@ -14,6 +14,7 @@ const { CharacterStore } = require('../dist/character-store.cjs');
14
14
  const { createPetServer } = require('../dist/figure-server.cjs');
15
15
  const { trayState, trayLocale } = require('./tray-state.cjs');
16
16
  const { createDisplayController } = require('./display-controller.cjs');
17
+ const { installAlwaysOnTop } = require('./always-on-top.cjs');
17
18
  const { petCopy, petLanguage } = require('../web/locale.js');
18
19
  app.setName(petCopy('en').defaultName);
19
20
  if (process.env.DSH_PET_TEST_DATA_DIR) {
@@ -34,7 +35,7 @@ if (process.env.DSH_PET_TEST_DEBUG_PORT) {
34
35
  const displayTest = process.env.DSH_PET_TEST_NO_SANDBOX === '1' && !!process.env.DSH_PET_TEST_DEBUG_PORT;
35
36
  const keyboardActivity = require('./keyboard-activity.cjs').createKeyboardActivity();
36
37
  const { initialLockState } = require('./lifecycle-state.cjs');
37
- let win, tray, options, lastFrame, poll, assetServer, characters, companions, displays, diagnostics, diagnosticRead;
38
+ let win, tray, options, lastFrame, poll, assetServer, characters, companions, displays, diagnostics, diagnosticRead, disposeAlwaysOnTop;
38
39
  let lifecycle = { locks: 0, unlocks: 0, suspends: 0, resumes: 0 };
39
40
  const configureDiagnostics = () => {
40
41
  if (options?.diagnostics !== true) {
@@ -216,7 +217,7 @@ app.whenReady().then(async () => {
216
217
  return characters.import(new Uint8Array(value));
217
218
  });
218
219
  win = new BrowserWindow({ ...screen.getPrimaryDisplay().workArea, transparent: true, frame: false, resizable: false, skipTaskbar: true, hasShadow: false, show: false, alwaysOnTop: true, backgroundColor: '#00000000', webPreferences: { additionalArguments: displayTest ? ['--dsh-pet-display-test'] : [], preload: join(__dirname, 'preload.cjs'), sandbox: true, contextIsolation: true, nodeIntegration: false } });
219
- win.setAlwaysOnTop(true, 'floating');
220
+ disposeAlwaysOnTop = installAlwaysOnTop(win, { isSuspended: () => suspended });
220
221
  win.on('show', visibility); win.on('hide', visibility);
221
222
  win.webContents.on('render-process-gone', () => app.exit(1));
222
223
  win.setVisibleOnAllWorkspaces(true, { visibleOnFullScreen: true });
@@ -280,5 +281,5 @@ app.whenReady().then(async () => {
280
281
  if (process.connected) process.send(failure, () => app.exit(1)); else app.exit(1);
281
282
  });
282
283
 
283
- app.on('before-quit', () => { if (userClosed) process.send?.({ type: 'closed' }); clearInterval(poll); keyboardActivity.configure(false); if (diagnosticRead) { clearTimeout(diagnosticRead.timer); diagnosticRead.resolve(null); diagnosticRead = undefined; } diagnostics?.release(); void diagnostics?.close(); assetServer?.close(); tray?.destroy(); });
284
+ app.on('before-quit', () => { if (userClosed) process.send?.({ type: 'closed' }); disposeAlwaysOnTop?.(); clearInterval(poll); keyboardActivity.configure(false); if (diagnosticRead) { clearTimeout(diagnosticRead.timer); diagnosticRead.resolve(null); diagnosticRead = undefined; } diagnostics?.release(); void diagnostics?.close(); assetServer?.close(); tray?.destroy(); });
284
285
  app.on('window-all-closed', () => { userClosed = true; app.quit(); });
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "schema": 1,
3
- "commit": "54684143f4c86724c852b1a93cde00cb2c43a7e0",
3
+ "commit": "d8b930bddd060c516b8757f7c417e41a66d7be57",
4
4
  "dirty": false,
5
- "productDigest": "b0c7471a03a716d55e364b5871f5098c1727d24b036ccd247aee06d5bbaa039a"
5
+ "productDigest": "a777e132bc1fb41588a60ad7a288d2958b5fc2daa3930920a71980c1de2986d7"
6
6
  }
package/docs/README.md CHANGED
@@ -16,6 +16,7 @@
16
16
  | NPC 日常、小窝、邀请与关系存档 | [自主陪伴契约](companionship-contract.md) |
17
17
  | 本地诊断、采样与资源报告 | [诊断契约](diagnostics-contract.md) |
18
18
  | 角色制作、API 2 与动作回退 | [角色接口](characters.md) |
19
+ | DSH 新版发现、隔离候选与兼容性报告 | [兼容性检查](compatibility.md) |
19
20
  | 同包安装验证、npm 与 GitHub Release | [发布流程](releasing.md) |
20
21
  | 首页展示素材的来源与重拍 | [素材说明](assets/README.md) |
21
22
  | 源码、素材与依赖许可 | [第三方声明](../THIRD_PARTY_NOTICES.md)、[上游版本](../web/upstream/UPSTREAM.md) |
@@ -0,0 +1,39 @@
1
+ # DSH 兼容性自动检查
2
+
3
+ `.github/workflows/dsh-compatibility.yml` 每小时第 37 分钟读取官方 GitHub Release(含候选版)、npm latest/next 和官方 macOS ARM64 Desktop feed。手动执行可提供精确版本或 dsh-v tag,当前最高已支持版本也可演练。默认只检查高于当前精确支持列表最高版本的目标,每轮最多三个版本。定时运行在工作流合入 main 后生效,平台调度可能延迟。
4
+
5
+ ## 检查与状态
6
+
7
+ 每个版本一个 Issue;发布物身份包含 npm integrity、上游 Release/commit 与 Desktop ZIP SHA-512。只有仓库所有者及 GitHub Actions 机器人的有效状态标记参与去重。执行前先记录 running 与尝试次数;npm 和 Desktop 独立结算。
8
+
9
+ - 同一发布物已完成时不重复安装;仅新增 Release 元数据时更新报告。
10
+ - Desktop 后到时只补 Desktop,保留原 npm 检查的提交与运行身份。
11
+ - 网络或安装准备暂时失败、超时、中断及缺报告为 retry;至少六小时后重试,同一组件身份最多自动三次。明确断言、依赖冲突或完整性错误为 failed。手动精确版本可复验。
12
+ - 候选检查成功为 partial,不能替代最终提交的常规 CI 或正式支持声明。未知 Desktop 运行时必须审阅,不能自动放宽。
13
+
14
+ 准备 job 在隔离副本更新精确 DSH 开发依赖、peer/engines 声明及 npm-shrinkwrap.json。保留原有支持和其他顶层依赖;旧 Host 锁解析重建,其他锁条目保留。正式源码与工作区在前后做摘要核对。若新版需要新的 Cordis/Schemastery 等依赖基线,报告冲突,由维护者审阅后调整。
15
+
16
+ 基线和候选分别执行类型及单元检查,候选执行完整浏览器、通知与 test:inbox-ui。Linux 只构建一次候选 .tgz,三个安装 job 下载同一字节,验证摘要后分别在 Linux x64、Windows x64 与 macOS ARM64 运行真实 Loader、网页设置、通知/目标/会话契约、原生桌宠与恢复。未改声明的原包仍须通过官方准入判断拒绝未支持宿主。既有完整安装断言保留,候选没有跳过完成或接受回执检查。
17
+
18
+ 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、通知中心、真实账号模型或物理多屏/输入设备。
19
+
20
+ ## 报告与提案
21
+
22
+ 检查 job 仅有读取权限,环境剔除令牌及 API 凭据,使用临时 HOME、DSH_HOME 与 profile。默认分支的报告 job 才能更新 Issue、创建分支与 Draft PR;pull_request 只检查。流程直接串联候选验证,不依赖机器人 PR 触发第二轮 CI。
23
+
24
+ 依赖提案只允许 package.json 与 npm-shrinkwrap.json,严格核对目标版本、基线 manifest、锁内 registry 来源和 integrity。已有提案或人工修改不自动覆盖。候选报告不自动修改正式分支、标记 Ready、合并、打标签或发布。报告保留来源提交、目标身份、包摘要、平台、阶段及对应 Actions 链接;报告、必要日志、失败截图和候选包保留 14 天,应用 ZIP、依赖、浏览器和测试会话不上传。
25
+
26
+ 当前发布资格仍由 [发布流程](releasing.md) 的最终提交全量 CI、十八组同包安装和 npm/Release 字节核验决定。
27
+
28
+ ## 本地执行
29
+
30
+ 使用 `.node-version` 和 packageManager 固定工具链,先 npm ci --ignore-scripts。可只读发现:
31
+
32
+ ```bash
33
+ npm run compat:discover -- --local
34
+ DSH_VERSION=0.2.1-rc.5 npm run compat:prepare
35
+ ```
36
+
37
+ 准备输出目录含 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 指向测试缓存。原生检查串行执行。
38
+
39
+ 本地命令不写 Issue 或 PR。发现、状态与提案机制复用 dsh-session-bin / dsh-usage-state,MIT 许可保留在 scripts/compatibility/LICENSE;本流程不调用付费 AI 服务。
@@ -1,5 +1,7 @@
1
1
  # 桌面异常恢复契约
2
2
 
3
+ Windows 窗口使用 `screen-saver` 置顶层级;macOS/Linux 保留 `floating`。Windows 在显示/还原/焦点变化后复核原生置顶标志,并在可见期间每三秒检查,以覆盖没有 Electron 事件的系统置顶丢失;标志仍有效时不重复提升窗口。隐藏、最小化时取消检查,锁屏/休眠时不修复,不调用显示或焦点接口;关闭窗口和退出应用均解除定时器、排队回调及监听。此恢复只维护可见窗口的置顶资格,不改变用户的显示意图。
4
+
3
5
  默认 Electron 路径解析不执行会同步下载的 `electron/index.js`。已有二进制直接复用;缺失时异步运行官方安装器,继承网络/镜像环境,最多准备四分钟,随后仍按 20 秒检查原生 ready。Host 启动总期限为 265 秒,包含准备和窗口启动;自定义测试期限可覆盖。准备阶段保持 `starting`,停止/停用立即取消安装器并等待其退出,不启动迟到的窗口;下载失败直接显示可手动重试的错误,不触发自动恢复风暴。
4
6
 
5
7
  Host 的 `PetControls` 独占恢复调度。意外退出(包括没有主动关闭回执的 exit 0)及明确标记为可恢复的启动失败,最多自动重试三次,依次等待 1、3、10 秒;连续运行 60 秒后清零。休眠或锁屏中不计算稳定时间。时间参数可注入。未知错误、缺少图形环境、无效或不可执行的运行时路径直接进入 error;清理未确认成功也不启动新进程。
@@ -29,7 +29,7 @@ npm run test:install
29
29
 
30
30
  浏览器检查真实 API 2 动画、聊天、完整阅读、角色导入及脚本隔离;桌面检查真实 Electron 窗口、IPC、托盘和恢复;安装检查使用官方 DSH loader 安装实际 `.tgz`。用 `DSH_TEST_VERSION=<支持版本>` 选择宿主,用 `DSH_TEST_PACKAGE_DIR=<规范包目录>` 消费已有规范包及校验文件。完整平台/宿主列表以 CI 矩阵为准。
31
31
 
32
- macOS CI 固定使用 `macos-15` Apple Silicon 标准 runner。浏览器回归结束后再执行原生桌面检查,保留既有执行顺序,系统桌面操作串行进行。三平台测试和十五组宿主安装保留全部断言与期限;本地 VM 验证仍单独记录实际系统、提交与包摘要。
32
+ macOS CI 固定使用 `macos-15` Apple Silicon 标准 runner。浏览器回归结束后再执行原生桌面检查,保留既有执行顺序,系统桌面操作串行进行。三平台测试和十八组宿主安装保留全部断言与期限;本地 VM 验证仍单独记录实际系统、提交与包摘要。
33
33
 
34
34
  真实轻抚回归在角色宽度的 20%/80% 位置间往返,保持每次十八个可信移动,避免窄幅轨迹在输入调度迟缓时衰减为无效手势。伪造事件拒绝、二十次反馈、增长冷却、500 ms 响应和原有等待期限继续检查,产品判定规则不变。
35
35
 
@@ -50,9 +50,12 @@ macOS CI 固定使用 `macos-15` Apple Silicon 标准 runner。浏览器回归
50
50
  | 拖放与小窝 | `tests/npc-drag-ui.mjs`:真实指针轨迹、两侧边缘、区域外停留、旧路线取消、按住及释放后小窝锚点 |
51
51
  | 自主循环与互动存档 | `tests/npc-life.test.js`、`tests/npc-life-native.mjs`、`tests/companionship-ui.mjs`、`tests/companionship-native.mjs` |
52
52
  | 原生冷启动 | `tests/lifecycle-startup-native.mjs`:受控 unknown/locked 与实际系统状态分别检查 |
53
+ | Windows 置顶 | `tests/always-on-top.test.js`、`tests/windows-topmost-native.mjs`:平台策略、寿命清理与真实 Win32 TOPMOST 丢失/恢复 |
53
54
 
54
55
  原生 NPC 用例控制时钟、粗粒度输入和鼠标感知;身体移动及 arrived/interrupted 保持真实。受控循环通过与物理输入、自然体验分别报告。
55
56
 
57
+ Windows 置顶回归由 CI 的隔离 Windows runner 串行运行 `node tests/windows-topmost-native.mjs`。它启动真实 Electron 窗口,用 Win32 读取 `WS_EX_TOPMOST`,主动清除标志后核对恢复和前台焦点保持,并检查隐藏/显示、最小化/还原与正常退出。失败也保留 `artifacts/windows-topmost-native.json`,绑定实际提交、构建与 Electron 版本。系统置顶丢失为受控注入;它不代替 Windows 11 物理设备、独占全屏游戏或长期桌面体验验收。本地缺少 Windows VM 时可使用此 CI 检查,本地 macOS 原生测试仍使用主项目虚拟机。
58
+
56
59
  Windows 的 125% 缩放与任务栏回归可在已登录、解锁的隔离控制台运行 `node tests/windows-geometry-native.mjs`。先通过系统显示设置选择 125%;脚本核对 Electron 读取的真实 DPI,不强制 Chromium 比例。它通过 Windows Shell API 切换任务栏自动隐藏、核对实际工作区及 viewport,再注入过期边界检查重同步与角色保持,结束时恢复原任务栏状态。NPC 时钟和感知为受控输入;这项 VM 检查不代替物理多屏或用户体验验收。RDP 会话不允许更改显示缩放时,先在虚拟机控制台设置并验证实际比例。
57
60
 
58
61
  同一控制台运行 `node tests/windows-pointer-native.mjs` 可核对真实 125% 下的右键菜单及面板点击;在 100% 下用 `DSH_WINDOWS_EXPECT_SCALE=1` 明确对应预期比例。Windows 输入辅助线程先启用 Per-Monitor V2 DPI 感知,再使用 Electron 换算出的物理坐标移动并读回光标,避免 DPI-unaware 辅助进程的坐标虚拟化造成误判。此检查同时使用 OS 光标和 CDP 点击,不代替物理混合 DPI 实机验收。
@@ -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 执行共享检查并保留原型摘要;十八组实际安装检查分别执行对应宿主版本的接口检查并上传报告。每份 Host 报告记录源码 commit、插件版本、包实现摘要及实际控制样本事件。
74
74
 
75
75
  独立 `textScale` 是呈现偏好,不改变类别、提醒身份、已读/结算或驻留时间;详见[文字契约](text-readability-contract.md)。
76
76
 
@@ -1,3 +1,25 @@
1
+ # v0.4.17
2
+
3
+ 修复 Windows 桌宠失去置顶后不能恢复的问题(#31)。
4
+
5
+ - Windows 单独使用 `screen-saver` 层级;显示期间定期检查丢失的置顶标志,并在窗口事件后复核。仍有效时不重复提升,不抢当前应用焦点;隐藏、最小化、锁屏或休眠时不修复,窗口关闭与应用退出时清理回调和监听。
6
+ - macOS/Linux 保留 `floating` 层级及既有行为。
7
+ - 新增真实 Windows Win32 样式位与焦点回归,以及平台策略和寿命清理测试。Windows CI 的受控置顶丢失验证与物理设备/独占全屏体验分别记录。
8
+
9
+ 问题定位与修复方向参考 @zhuhuaikuan 提供的 #31/#33 数据。
10
+
11
+ 安装包:`dsh-coopanion-0.4.17.tgz`;npm 与 GitHub Release 使用同一份发布 CI 验证的压缩包。
12
+
13
+ # v0.4.16
14
+
15
+ ## DSH 0.2.1-rc.5 兼容与自动检查
16
+
17
+ - 将 rc.5 加入宿主和 peer 的精确支持列表,开发契约检查使用 rc.5,保留此前五版支持;未验证的 rc.4 及其他版本仍不放行。
18
+ - 三平台同包安装矩阵扩为六版宿主、十八组,覆盖正式 Loader、通知与目标完成、接受回执与会话续接、原生窗口及恢复。
19
+ - 新增每小时兼容性监测:发现官方 Release、npm 与 Desktop 发布物,按身份去重、分组件有限重试、保留 Issue 证据并准备依赖草稿 PR。候选结果不自动扩大正式支持或触发发布。
20
+
21
+ 安装包:`dsh-coopanion-0.4.16.tgz`;npm 与 GitHub Release 使用同一份发布 CI 验证的压缩包。
22
+
1
23
  # v0.4.15
2
24
 
3
25
  ## 启动、显示几何与退出修复
package/docs/releasing.md CHANGED
@@ -18,11 +18,11 @@ git push origin v<实际版本>
18
18
 
19
19
  ## 自动检查与同包分发
20
20
 
21
- CI 在 Linux、macOS、Windows 上运行元数据、类型、单元、浏览器、键盘辅助进程及真实 Electron 窗口检查;宿主安装矩阵使用 `package.json` 声明支持的五版 DSH,三平台共十五组。实际配置以 `.github/workflows/ci.yml` 为准。Linux 窗口检查由 Xvfb + Openbox 提供隔离显示,原生桌面步骤保留进程日志并设置六分钟上限。
21
+ CI 在 Linux、macOS、Windows 上运行元数据、类型、单元、浏览器、键盘辅助进程及真实 Electron 窗口检查;宿主安装矩阵使用 `package.json` 声明支持的六版 DSH,三平台共十八组。实际配置以 `.github/workflows/ci.yml` 为准。Linux 窗口检查由 Xvfb + Openbox 提供隔离显示,原生桌面步骤保留进程日志并设置六分钟上限。
22
22
 
23
23
  发布验证标签是 `origin/main` 的祖先、包与 shrinkwrap 版本一致且当前发布说明存在,然后检出不可变提交并重新执行完整 CI。PR 或 main 的先前测试结果不能代替标签上的发布检查。
24
24
 
25
- Linux 构建并打包一次,成为规范产物。`npm pack` 产生的 `takboo-dsh-coopanion-<版本>.tgz` 只重命名为 `dsh-coopanion-<版本>.tgz`;固定别名通过复制获得。十五组安装、npm 和 Release 都消费这份压缩包,发布使用 `--ignore-scripts`,不会再次构建。
25
+ Linux 构建并打包一次,成为规范产物。`npm pack` 产生的 `takboo-dsh-coopanion-<版本>.tgz` 只重命名为 `dsh-coopanion-<版本>.tgz`;固定别名通过复制获得。十八组安装、npm 和 Release 都消费这份压缩包,发布使用 `--ignore-scripts`,不会再次构建。
26
26
 
27
27
  `verification.json` 绑定完整源码提交、版本、SHA-256 与 npm SHA-512 integrity;`dist/build-info.json` 记录产品输入摘要。生成正式报告要求干净、已提交的 checkout。构建摘要不代替完整 `.tgz` 的身份。
28
28
 
@@ -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`。共享线协议定义在 [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
+ 支持 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)。
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**;其他版本未声明兼容。
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**;其他版本未声明兼容。
8
8
 
9
- 在 0.2.1-rc.1 / rc.2 / rc.3 中,从左下角账号菜单(未登录时显示“更多”)选择“设置”,再进入“桌宠”;0.2.0-rc.2/0.2.1-alpha.1 从侧栏“设置”进入。
9
+ 在 0.2.1-rc.1 / rc.2 / rc.3 / rc.5 中,从左下角账号菜单(未登录时显示“更多”)选择“设置”,再进入“桌宠”;0.2.0-rc.2/0.2.1-alpha.1 从侧栏“设置”进入。
10
10
 
11
11
  ### 在 Harness 中从 npm 安装
12
12
 
13
- 打开侧边栏 **插件 → 添加插件**,在「包名或地址」输入 **`@takboo/dsh-coopanion@0.4.15`**,点击安装,再启用 `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.17`**,点击安装,再启用 `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.15
26
+ dsh plugin --profile desktop add @takboo/dsh-coopanion@0.4.17
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.15
34
+ dsh plugin --profile web add @takboo/dsh-coopanion@0.4.17
35
35
  dsh --profile web
36
36
  ```
37
37
 
@@ -51,6 +51,8 @@ dsh plugin --profile desktop add /absolute/path/dsh-coopanion.tgz
51
51
 
52
52
  完全退出并重新打开 Harness。首次启动会下载并校验 Electron 44 运行时;在 **Settings → 桌宠** 查看运行状态,打开一段会话后双击角色即可聊天。
53
53
 
54
+ Windows 桌宠显示期间会在失去置顶后自动恢复,恢复时不抢当前应用焦点;隐藏或最小化后不会因此重新显示。macOS/Linux 的窗口层级保持原有行为。
55
+
54
56
  ### Electron 运行时准备
55
57
 
56
58
  首次安装或升级 Electron 后,桌宠在独立子进程中下载、校验并解压运行时;准备期间设置页显示“正在启动”,Harness 的窗口、服务和其他插件继续响应,也可随时关闭桌宠来取消准备。准备最多等待四分钟,失败后设置页显示错误;检查网络后点击启动重试。运行时准备完成后才开始原生窗口的 20 秒启动检查。