@takboo/dsh-coopanion 0.4.13 → 0.4.15
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 +4 -4
- package/desktop/display-controller.cjs +8 -4
- package/desktop/main.cjs +8 -2
- package/desktop/preload.cjs +2 -0
- package/dist/bridge.js +90 -8
- package/dist/bridge.js.map +4 -4
- package/dist/build-info.json +2 -2
- package/dist/client.js +1 -1
- package/dist/figure-server.cjs +1 -1
- package/dist/index.js +91 -9
- package/dist/index.js.map +4 -4
- package/docs/desktop-recovery-contract.md +4 -0
- package/docs/development.md +20 -0
- package/docs/multi-display-contract.md +6 -0
- package/docs/release-notes.md +25 -0
- package/docs/releasing.md +2 -2
- package/docs/session-chat-contract.md +1 -1
- package/docs/usage.md +22 -7
- package/npm-shrinkwrap.json +21 -21
- package/package.json +20 -20
- package/scripts/observe-companion.mjs +1 -1
- package/src/bridge.ts +19 -4
- package/src/client/index.ts +1 -1
- package/src/controls.ts +1 -1
- package/src/electron-runtime.ts +50 -0
- package/src/figure-server.ts +3 -1
- package/tests/companionship-ui.mjs +38 -4
- package/tests/display-geometry.test.js +37 -1
- package/tests/electron-startup.test.ts +93 -0
- package/tests/figures.test.ts +45 -2
- package/tests/fixtures/late-display-quit.cjs +8 -0
- package/tests/fixtures/lifecycle-shutdown-trace.cjs +37 -0
- package/tests/helpers/native-pointer.mjs +33 -7
- package/tests/helpers/windows-taskbar.ps1 +22 -0
- package/tests/inbox-ui.mjs +1 -0
- package/tests/install.mjs +15 -5
- package/tests/lifecycle-startup-native.mjs +44 -9
- package/tests/locale-client.mjs +23 -0
- package/tests/multi-display-ui.mjs +42 -0
- package/tests/preload-geometry.test.js +23 -0
- package/tests/session-replies-ui.mjs +22 -0
- package/tests/windows-geometry-native.mjs +78 -0
- package/tests/windows-pointer-native.mjs +43 -0
- package/web/pet.js +23 -5
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# 桌面异常恢复契约
|
|
2
2
|
|
|
3
|
+
默认 Electron 路径解析不执行会同步下载的 `electron/index.js`。已有二进制直接复用;缺失时异步运行官方安装器,继承网络/镜像环境,最多准备四分钟,随后仍按 20 秒检查原生 ready。Host 启动总期限为 265 秒,包含准备和窗口启动;自定义测试期限可覆盖。准备阶段保持 `starting`,停止/停用立即取消安装器并等待其退出,不启动迟到的窗口;下载失败直接显示可手动重试的错误,不触发自动恢复风暴。
|
|
4
|
+
|
|
3
5
|
Host 的 `PetControls` 独占恢复调度。意外退出(包括没有主动关闭回执的 exit 0)及明确标记为可恢复的启动失败,最多自动重试三次,依次等待 1、3、10 秒;连续运行 60 秒后清零。休眠或锁屏中不计算稳定时间。时间参数可注入。未知错误、缺少图形环境、无效或不可执行的运行时路径直接进入 error;清理未确认成功也不启动新进程。
|
|
4
6
|
|
|
5
7
|
共享原生寿命类型位于 [desktop-lifecycle.ts](../src/desktop-lifecycle.ts)。`NativeStartError.recoverable` 明确标记启动错误;spawn 仅 EAGAIN / ENOMEM 可重试,原生初始化捕获的异常仅 EADDRINUSE / EAGAIN / ENOMEM 经 `startup-error` 消息允许重试。启动超时、未发送错误分类便异常退出属于失去原生进程的可恢复路径。主动退出回执为 `closed`,不会依赖 exit code 0 猜测用户意图。
|
|
@@ -8,6 +10,8 @@ Host 的 `PetControls` 独占恢复调度。意外退出(包括没有主动关
|
|
|
8
10
|
|
|
9
11
|
停止、停用和卸载同步取消等待及在途启动,随后在有界期限内清理。用户从托盘退出或关闭窗口属于主动关闭,不自动重启。手动启动/重启重置重试预算,设置页显示等待、次数和有界诊断;停止在启动及等待期间始终可用。清理失败保留错误与手动重启入口,Harness 不等待恢复完成。
|
|
10
12
|
|
|
13
|
+
本地资源服务关闭监听后,已接受连接仍可交付排队请求。Host/Origin 校验使用该连接的实际本地端口,避免读取已变成 `null` 的监听地址而抛出未处理异常;退出断言仍要求进程在原期限内正常结束。
|
|
14
|
+
|
|
11
15
|
新进程 ready 后 Host 下发 `init { baseline: true, options, snapshot }`(完整结果)及 `notification-state`(有效请求)。baseline 只将已有结果加入 renderer 的已展示集合,不标记已读,结果仍在收件箱;后续新结果正常呈现。恢复不重新折叠历史、不增加未读、不重发旧提醒,也不调用聊天提交或任务执行。已领取通知继续按 broker 的 generation/visibilityRevision 取消和结算,迟到的送达证据不重新派发其他通道。锁屏/休眠状态由原生回执报告;已观察的锁屏和休眠分别传入新进程,resume 不会清除锁屏,unlock 不会清除休眠。新进程在收到初始化回执前保持无投递资格。
|
|
12
16
|
|
|
13
17
|
通用异常的已查看回执仅属于当前 renderer,不进入任务或请求持久状态;重载/进程恢复后按 Host 的当前事实重新呈现。
|
package/docs/development.md
CHANGED
|
@@ -29,6 +29,14 @@ 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 验证仍单独记录实际系统、提交与包摘要。
|
|
33
|
+
|
|
34
|
+
真实轻抚回归在角色宽度的 20%/80% 位置间往返,保持每次十八个可信移动,避免窄幅轨迹在输入调度迟缓时衰减为无效手势。伪造事件拒绝、二十次反馈、增长冷却、500 ms 响应和原有等待期限继续检查,产品判定规则不变。
|
|
35
|
+
|
|
36
|
+
帧时间戳先于点击事件的回归使用角色已有的 `happy → nod → neutral` 短配方,专门检查时钟顺序、完成前不增长及完成后只增长一次。长舞蹈在低帧率下的物理播放可能合法超过该用例的十秒等待;长配方的完成、打断和增长仍由其他陪伴回归覆盖。产品二十秒活动期限及所有测试等待期限不变。
|
|
37
|
+
|
|
38
|
+
完成、打断与存档回归保留默认 `happy → dance → neutral` 长配方。该用例使用调度虚拟时钟,并通过 API 2 补充有效 `tick` 输入推进真实角色物理;每次等待输入处理回执,再读取角色实际报告的 `moving`。额外物理输入最多 400 × 50ms,回执与进度检查仍保留原十秒等待。角色实现、真实布局/事件及存档服务共同参与验证;渲染帧率与交互延迟继续由真实时间用例检查。
|
|
39
|
+
|
|
32
40
|
原生测试和安装使用隔离数据目录,系统桌面操作串行执行。CI 测试沙箱参数仅供隔离实例;普通安装保留 Chromium sandbox 与 contextIsolation,关闭 Node integration。测试通知适配器和模型答复器属于受控边界,不能代替通知中心实机送达或真实模型会话验收。
|
|
33
41
|
|
|
34
42
|
## 关键行为回归
|
|
@@ -45,6 +53,10 @@ npm run test:install
|
|
|
45
53
|
|
|
46
54
|
原生 NPC 用例控制时钟、粗粒度输入和鼠标感知;身体移动及 arrived/interrupted 保持真实。受控循环通过与物理输入、自然体验分别报告。
|
|
47
55
|
|
|
56
|
+
Windows 的 125% 缩放与任务栏回归可在已登录、解锁的隔离控制台运行 `node tests/windows-geometry-native.mjs`。先通过系统显示设置选择 125%;脚本核对 Electron 读取的真实 DPI,不强制 Chromium 比例。它通过 Windows Shell API 切换任务栏自动隐藏、核对实际工作区及 viewport,再注入过期边界检查重同步与角色保持,结束时恢复原任务栏状态。NPC 时钟和感知为受控输入;这项 VM 检查不代替物理多屏或用户体验验收。RDP 会话不允许更改显示缩放时,先在虚拟机控制台设置并验证实际比例。
|
|
57
|
+
|
|
58
|
+
同一控制台运行 `node tests/windows-pointer-native.mjs` 可核对真实 125% 下的右键菜单及面板点击;在 100% 下用 `DSH_WINDOWS_EXPECT_SCALE=1` 明确对应预期比例。Windows 输入辅助线程先启用 Per-Monitor V2 DPI 感知,再使用 Electron 换算出的物理坐标移动并读回光标,避免 DPI-unaware 辅助进程的坐标虚拟化造成误判。此检查同时使用 OS 光标和 CDP 点击,不代替物理混合 DPI 实机验收。
|
|
59
|
+
|
|
48
60
|
小窝回归支持录制隔离页面,不录桌面其他窗口或音频:
|
|
49
61
|
|
|
50
62
|
```bash
|
|
@@ -68,6 +80,14 @@ node tests/lifecycle-startup-native.mjs
|
|
|
68
80
|
|
|
69
81
|
它要求真实初态已知、未挂起且键盘适配器 available。锁屏场景使用 `DSH_LIFECYCLE_EXPECT_STATE=locked`,在实际锁屏环境单独执行;探针不改变锁屏状态。物理键盘、跨应用、锁屏/休眠、远程会话与平台资源分别验证。
|
|
70
82
|
|
|
83
|
+
CI 的受控冷启动检查先启用 `DSH_LIFECYCLE_TRACE=1`,在退出消息、窗口关闭与进程退出边界记录阶段和资源类型,不记录路径、URL 或正文;随后关闭诊断入口再次检查,避免诊断代码的时序变化掩盖退出问题。两次均保留原有断言和退出期限,报告分别写入 `lifecycle-startup-traced.json` 和 `lifecycle-startup-native.json`。失败也写报告;原始断言与清理错误分别保留。普通沙箱实测不加载该诊断入口。
|
|
84
|
+
|
|
85
|
+
受控 macOS 检查退出超过 1.5 秒时,用系统 `sample` 对本次启动的隔离原生进程采样一秒,采集器自身最多运行三秒;原有十秒退出期限和失败断言保持不变,耗时只计进程退出。堆栈随 `lifecycle-shutdown-*.txt` 上传,用于定位窗口已关闭、`quit` 已触发后的原生停留;该探针没有用户会话或模型内容。
|
|
86
|
+
|
|
87
|
+
同一诊断入口通过 `uncaughtExceptionMonitor` 观察默认异常路径,只记录分类、错误码与源码文件名/函数帧,不拦截异常或关闭原生错误框;出现异常也判为失败。Windows 手动几何探针先等待首个本地页面加载完成,再刷新以注入受控时钟,避免窗口刚创建便取消尚未完成的首次导航。
|
|
88
|
+
|
|
89
|
+
CI 额外用 `DSH_LIFECYCLE_LATE_DISPLAY=1` 在原生窗口关闭后强制派发显示器更新,复现排队回调的寿命竞态;同样要求正常退出、无未处理异常,报告单独写入 `lifecycle-startup-late-display.json`。这是受控事件验证,不改变系统显示设置。
|
|
90
|
+
|
|
71
91
|
## 资源与诊断
|
|
72
92
|
|
|
73
93
|
先按[使用指南](usage.md#自主陪伴)核对开关,再按[诊断契约](diagnostics-contract.md)解释时长、缺口和报告状态。独立采样器 `scripts/sample-companion.mjs` 使用本地诊断接口及 OS 指标,不操作窗口、不读取聊天正文、不启动模型。
|
|
@@ -8,6 +8,8 @@ Electron 44 的 `screen.getAllDisplays().workArea`、`getCursorScreenPoint()`、
|
|
|
8
8
|
|
|
9
9
|
Windows 的物理输入工具必须使用 Electron `screen.dipToScreenPoint`,不能把多屏全局 DIP 原点乘目标屏比例;macOS CoreGraphics 光标使用逻辑全局点;Linux X11 输入应按 Electron 转换(Wayland 的光标查询/转换能力未声明支持)。隔离测试 profile 只有同时启用测试沙箱参数与 debug port 时才加载只读坐标探针,preload 通过额外启动参数开放测试测量;普通安装及角色 frame 均没有该入口。不添加强制设备缩放参数。混合 DPI 的真实转换和点击必须另列原生实测,受控比例不能代替物理显示器。
|
|
10
10
|
|
|
11
|
+
Windows 测试输入与物理坐标读回在 Per-Monitor V2 DPI-aware 辅助线程中执行。停放光标也先将窗口内 CSS 点经同一原生探针转换为物理坐标。DPI-unaware 辅助进程的读数不能直接作为物理基准再次缩放。
|
|
12
|
+
|
|
11
13
|
原生归属记录完整显示器 ID。布局变化优先保留仍存在的当前 ID;移除当前屏后,从旧工作区中心选择最近有效 workArea,同距保持稳定。新增、移除其他屏不移动当前窗口;workArea / bounds / scaleFactor / rotation 更新重新核对当前屏与实际内容矩形。任务栏条带与布局空洞按到各 workArea 的距离选择,不能按所有屏幕包围盒命中。
|
|
12
14
|
|
|
13
15
|
拖拽在本地松手或取消时通过 API 2 drop 放下,不延续抛掷惯性;普通松手发出本地 `move-display`,主进程从真实原生光标选择目标,覆盖左右、上下与错位屏。托盘提供按显示器标签及 ID 的显式切屏入口,隐藏时切屏不改变显示意图;不依赖拖拽跨过空洞。显示器 ID 只在本进程保留,不新增持久配置。自由跨屏漫游、抛掷与贴边休息不在本项范围。
|
|
@@ -16,10 +18,14 @@ Windows 的物理输入工具必须使用 Electron `screen.dipToScreenPoint`,
|
|
|
16
18
|
|
|
17
19
|
Main → Renderer 使用同包消息 `display-changed { revision, displayId, workArea, contentBounds, scaleFactor }`;revision 在本代单调增加,初始化完成后补发最新状态。`cursor { x, y, revision }` 中 x/y 是该 contentBounds 内的 DIP,只有匹配 revision 的消息参与命中测试。Renderer 依据实际 viewport 做本地换算,丢弃旧几何和旧 cursor;不复用变更前的 stationary cursor / hit-state。
|
|
18
20
|
|
|
21
|
+
Renderer 订阅完成后通过独立的 `pet:geometry-request` 请求当前几何;Main 验证发送者是主 frame 后,重新读取实际 contentBounds 再重发。窗口 resize/resized/move 也重新核对边界。缺少几何或 viewport 与边界尺寸不一致时,Renderer 最多每秒重试一次,暂停 NPC 直到收到匹配状态;不以虚构显示器或零原点替代原生坐标,也不重载角色或正文。
|
|
22
|
+
|
|
19
23
|
窗口 resize 与显示消息可先后到达。只用当前实际 viewport 更新角色 bounds,角色异步返回新 frame 后重置面板锚点;跨屏按先前水平比例放回新工作区地面,当前屏缩放或工作区调整只夹入新 bounds,不启动新角色。几何变化打断正在拖拽的角色时,释放本地指针捕获,等新 bounds 到达后用 API 2 的 drop 直接安全落地,不先 pointer(cancel) 生成 throw;避免上游 place 在 drag 下被忽略而留下屏外命中区。已经松手的空中角色沿原物理系统在新 bounds 内落地,不扩展跨屏抛掷。面板按实际尺寸夹入 viewport,保留文字三档和长代码/表格的滚动。
|
|
20
24
|
|
|
21
25
|
切屏与布局变化只更新几何,不重建 Renderer、角色 frame 或正文,不调用内容 render;保留捕获阅读 DOM/正文、滚动像素偏移、草稿、焦点/选择、在途请求身份与气泡时钟,不增加 read/select/chat。不改变完成语义、准入去重、generation/visibilityRevision 和恢复基线、文字配置;崩溃后的临时状态丢失边界保持。
|
|
22
26
|
|
|
27
|
+
原生窗口销毁后解除显示器监听;已排队的布局刷新、回放、切屏与光标查询直接停止,不再访问已销毁的窗口或发送新几何。受控原生退出回归在窗口关闭后强制派发显示器更新,仍要求无异常、无强制终止并在原期限内退出。
|
|
28
|
+
|
|
23
29
|
## 验证边界
|
|
24
30
|
|
|
25
31
|
纯几何及原生控制器的注入布局测试由 `npm test` 执行;浏览器覆盖不规则布局、混合 DPR、状态保持与命中;原生/安装检查核对实际 screen、窗口、viewport、文字放大后点击及布局更新。三平台与宿主安装矩阵以工作流结果为准。
|
package/docs/release-notes.md
CHANGED
|
@@ -1,3 +1,28 @@
|
|
|
1
|
+
# v0.4.15
|
|
2
|
+
|
|
3
|
+
## 启动、显示几何与退出修复
|
|
4
|
+
|
|
5
|
+
- 修复首次准备 Electron 时同步下载阻塞 Harness:在独立进程后台准备运行时,保持界面与服务响应;准备可取消,窗口启动单独计时,错误可手动重试。
|
|
6
|
+
- 修复原生内容边界晚于窗口变化到达时,NPC 持续停在 `reason=geometry`:重新采样并按需补发几何,边界一致后恢复活动,保留角色、阅读与草稿。
|
|
7
|
+
- 修复退出时晚到的显示器事件访问已销毁窗口,引发原生错误框和进程无法正常结束;窗口关闭后解除监听并停止排队几何操作。
|
|
8
|
+
- 修复本地资源服务关闭监听后,已接受连接上的排队请求读取空监听地址产生未处理异常;继续校验实际连接的 Host/Origin。
|
|
9
|
+
- 修复自动恢复期间设置页误报运行状态无效;正确显示等待自动恢复和重试次数。
|
|
10
|
+
- 修复从完整回复继续来源会话时,较早的已读/状态快照把目标退回旧会话的竞态;选择经 Host 确认前保持最新目标,避免后续输入或导航指向旧会话。
|
|
11
|
+
- 补充真实 HTTP 排队请求、原生晚到显示事件、Windows 实际 125% 缩放和任务栏工作区回归;修正测试输入的 DPI 感知与首次导航等待。
|
|
12
|
+
|
|
13
|
+
安装包:`dsh-coopanion-0.4.15.tgz`;npm 与 GitHub Release 使用同一份发布 CI 验证的压缩包。
|
|
14
|
+
|
|
15
|
+
# v0.4.14
|
|
16
|
+
|
|
17
|
+
## DSH 0.2.1-rc.3 兼容
|
|
18
|
+
|
|
19
|
+
- 将 DSH 0.2.1-rc.3 加入 `engines.dsh` 与所有宿主 peer 的精确支持列表,保留既有四版宿主兼容;未验证的后续候选版仍不放行。
|
|
20
|
+
- 三平台同包安装矩阵扩为五版宿主、十五组,检查正式插件安装、设置与语言切换、完成通知、会话续接、原生窗口及恢复。
|
|
21
|
+
- 安装检查通过宿主官方兼容性判断复现旧声明拒绝 rc.3,并验证新声明接受全部支持版本;独立观察工具同步支持 rc.3。
|
|
22
|
+
- Linux/macOS 安装重启验证使用宿主正式信号退出路径,Windows 保留 IPC 退出;继续要求退出码为 0,避免旧宿主清理后的残留句柄阻塞测试重启。
|
|
23
|
+
|
|
24
|
+
安装包:`dsh-coopanion-0.4.14.tgz`;npm 与 GitHub Release 使用同一份发布 CI 验证的压缩包。
|
|
25
|
+
|
|
1
26
|
# v0.4.13
|
|
2
27
|
|
|
3
28
|
## NPC 日常与交互修复
|
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`
|
|
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
|
|
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
|
|
|
@@ -35,7 +35,7 @@ Host 返回同一完整 `sessionId` 和 `requestId`:
|
|
|
35
35
|
|
|
36
36
|
每个会话独立保存当前窗口内的草稿与提交状态。发送时固定请求内容、时区和目标,快速重复点击被发送状态拦截;切换关注会话不改变在途请求。草稿在收到完全匹配的接受回执后才清空。失败或 15 秒未收到回执保留草稿,重试使用原身份;修改正文再发送成为新请求,新消息即使正文相同也使用新 ID。接受状态不被迟到失败覆盖。
|
|
37
37
|
|
|
38
|
-
从收件箱或完整回复选择“继续对话”会显式选择该来源会话并打开桌宠输入框;“打开源会话”仍可从聊天框返回 Harness
|
|
38
|
+
从收件箱或完整回复选择“继续对话”会显式选择该来源会话并打开桌宠输入框;“打开源会话”仍可从聊天框返回 Harness。显式切换后保留最近一次选择,直到 Host 快照确认目标或目标从列表消失;切换前排队的已读或状态快照不能把输入、草稿及导航退回旧目标。确认后继续接收 Host 的后续选择变化。阅读本身不切换关注会话,正在阅读的正文保持其捕获快照,新结果另计未读。草稿只保留在当前窗口运行期,重载或关闭后丢失。
|
|
39
39
|
|
|
40
40
|
启动时通过正式列表与查询恢复最多 100 个最近的普通会话,不激活冷 Agent、不调用模型,历史回复作为已读基线。Agent 分离不证明持久会话被删除,保留其续接入口;实际提交时重新核对目标是否仍存在。不可用目标保留明确失败反馈,不改投其他会话。
|
|
41
41
|
|
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.
|
|
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**;其他版本未声明兼容。
|
|
8
8
|
|
|
9
|
-
在 0.2.1-rc.1 / rc.2 中,从左下角账号菜单(未登录时显示“更多”)选择“设置”,再进入“桌宠”;0.2.0-rc.2/0.2.1-alpha.1 从侧栏“设置”进入。
|
|
9
|
+
在 0.2.1-rc.1 / rc.2 / rc.3 中,从左下角账号菜单(未登录时显示“更多”)选择“设置”,再进入“桌宠”;0.2.0-rc.2/0.2.1-alpha.1 从侧栏“设置”进入。
|
|
10
10
|
|
|
11
11
|
### 在 Harness 中从 npm 安装
|
|
12
12
|
|
|
13
|
-
打开侧边栏 **插件 → 添加插件**,在「包名或地址」输入 **`@takboo/dsh-coopanion@0.4.
|
|
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#安装一个组合包)。
|
|
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.
|
|
26
|
+
dsh plugin --profile desktop add @takboo/dsh-coopanion@0.4.15
|
|
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.
|
|
34
|
+
dsh plugin --profile web add @takboo/dsh-coopanion@0.4.15
|
|
35
35
|
dsh --profile web
|
|
36
36
|
```
|
|
37
37
|
|
|
@@ -51,6 +51,19 @@ dsh plugin --profile desktop add /absolute/path/dsh-coopanion.tgz
|
|
|
51
51
|
|
|
52
52
|
完全退出并重新打开 Harness。首次启动会下载并校验 Electron 44 运行时;在 **Settings → 桌宠** 查看运行状态,打开一段会话后双击角色即可聊天。
|
|
53
53
|
|
|
54
|
+
### Electron 运行时准备
|
|
55
|
+
|
|
56
|
+
首次安装或升级 Electron 后,桌宠在独立子进程中下载、校验并解压运行时;准备期间设置页显示“正在启动”,Harness 的窗口、服务和其他插件继续响应,也可随时关闭桌宠来取消准备。准备最多等待四分钟,失败后设置页显示错误;检查网络后点击启动重试。运行时准备完成后才开始原生窗口的 20 秒启动检查。
|
|
57
|
+
|
|
58
|
+
网络受限时可设置 Electron 支持的 `ELECTRON_MIRROR`,并从设置了该变量的终端启动 Harness。也可完全退出 Harness 后,在实际 profile 目录手动准备(下面以 Windows PowerShell 为例):
|
|
59
|
+
|
|
60
|
+
```powershell
|
|
61
|
+
$env:ELECTRON_MIRROR='https://npmmirror.com/mirrors/electron/'
|
|
62
|
+
node "$env:DSH_HOME\profiles\desktop\node_modules\electron\install.js"
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
使用实际配置的 `DSH_HOME`;CLI 的其他 profile 替换 `desktop`。运行时继续按 Electron 的安装器校验。成功后重新打开 Harness;已准备好的二进制直接复用。自备运行时也可使用 `electronPath` 的绝对路径配置。
|
|
66
|
+
|
|
54
67
|
## 配置与会话
|
|
55
68
|
|
|
56
69
|
**Settings → 桌宠** 沿用 Harness 的主题、中英文与系统语言设置。可控制随 Harness 启动、闲时活动、任务通知、系统通知、待处理请求补提醒、等待时间、角色尺寸(90–240)、文字大小(100% / 125% / 150%)和气泡时长(2–60 秒);数值按 Enter 或离开输入框保存。文字大小选择后立即保存并同步到当前桌宠,独立于角色尺寸,保留当前阅读、草稿与在途发送;旧配置默认 100%。
|
|
@@ -75,13 +88,13 @@ dsh plugin --profile desktop add /absolute/path/dsh-coopanion.tgz
|
|
|
75
88
|
|
|
76
89
|
鼠标靠近先停;最近键盘活动时暂停外出和邀请,保留未完成目标。角色始终保持设置中的尺寸,打字、选中、悬停或拖动都不自动缩放;稳定空闲至少 12 秒后重新评估活动。键盘感知包含 macOS 聚合事件时间、Windows Raw Input 通知和 Linux X11/XInput2 适配,辅助进程仅输出 active/idle/unknown;不能区分打字与快捷键,也不读取具体按键或其他应用内容。Windows 需要系统 Windows PowerShell;X11 需要 `/usr/bin/python3`、libX11 与 libXi。Wayland(含 Xwayland)、无图形会话、非交互/远程 Windows、接口或依赖不可用均为 unknown,此时安静停留。macOS 不再将“事件监听授权”误当成聚合时间接口的前置条件,无需先授予额外权限。若辅助进程失效,可关闭再开启陪伴重试;诊断中的 keyboardBackend/keyboardStatus 可区分不支持、缺依赖、失败与过期。物理键盘、跨应用/锁屏场景及资源表现按平台分别验证。
|
|
77
90
|
|
|
78
|
-
无需 DSH 在前台或先打开会话。新工作、异常和审批优先;已呈现的长期待办保留入口,可允许小窝内安静观察。任务与 NPC
|
|
91
|
+
无需 DSH 在前台或先打开会话。新工作、异常和审批优先;已呈现的长期待办保留入口,可允许小窝内安静观察。任务与 NPC 情绪各自保留。关闭闲时走动、用户休息、隐藏、锁屏/休眠及减少动态效果暂停自动路径,宿主退出后桌宠仍退出。显示器工作区变化或几何消息遗漏时,会向原生窗口重新同步;尺寸确认前暂停,确认后恢复,无需重启角色。详见[日常契约](companionship-contract.md)。
|
|
79
92
|
|
|
80
93
|
在角色上连续轻轻抚摸,或从右键菜单选择“一起活动”;实际完成的互动才计入熟悉度,五分钟内不重复增长,每天最多三次。跨至少三天累计六次会解锁挥手后的爱心招呼,缺席和忽略不会扣分。角色更新或换配色不重置,换角色各自保存。菜单可查看相处进展。
|
|
81
94
|
|
|
82
95
|
邀请可选择“一起活动/稍后/今天安静”,十秒不回应便自然结束。稍后至少等待一小时,今天安静跨重启保留,菜单可恢复邀请;它们不影响任务通知。进度无法保存时菜单会提示,原工作功能仍可使用。详情见[陪伴契约](companionship-contract.md)。
|
|
83
96
|
|
|
84
|
-
桌宠意外退出后按 1、3、10 秒间隔最多自动恢复三次,连续稳定运行 60
|
|
97
|
+
桌宠意外退出后按 1、3、10 秒间隔最多自动恢复三次,连续稳定运行 60 秒后清零。设置页显示等待自动恢复状态、恢复次数和诊断,可随时关闭或在失败后手动重启;主动关闭不触发恢复。隐藏的角色恢复后仍隐藏,关注会话、完整结果、未读和有效待办保留,旧结果不再次主动提醒。窗口内草稿与阅读位置会随进程退出丢失,恢复不会重发聊天或任务。缺少图形环境、无效运行时路径或未确认清理的进程直接反馈错误,详见[恢复契约](desktop-recovery-contract.md)。
|
|
85
98
|
|
|
86
99
|
```yaml
|
|
87
100
|
- id: dsh-coopanion
|
|
@@ -157,4 +170,6 @@ npm run character:pack -- examples/star paper-star.zip
|
|
|
157
170
|
|
|
158
171
|
信封直接打开回复与待办收件箱:同一会话的多个未读回合合并展示最新回复,未读数量按会话计算。只有一份回复时展开全文;多份回复显示摘要和各自的 **继续对话 ↗**(在桌宠输入框继续来源会话),审批、提问及异常提供 **去处理 ↗**。全文支持 Markdown 标题、粗体、列表、表格和代码块。阅读不会切换正在聊天的会话;收件箱阅读器可连续读不同会话的结果,并返回收件箱查看新内容。正在阅读的回复不会被新结果替换。保留最近 200 份完整结果,优先淘汰已读;只有本次 Harness 运行中实时完成的回复计入未读,打开历史会话或重启 Harness 不会把旧回复重新标为未读。重启后原始对话仍由 Harness 保存;任务动画根据当前 Agent 的运行状态恢复。
|
|
159
172
|
|
|
173
|
+
从回复选择“继续对话”或在会话列表切换目标后,输入和“打开源会话”保持最近一次明确选择,等待 Harness 确认;较早的已读或状态更新不会把目标退回旧会话。目标消失时采用 Harness 的实际可用列表。
|
|
174
|
+
|
|
160
175
|
回复气泡展示或自动收起、查看收件箱摘要及收起收件箱均不会标记已读;主动展开阅读、关闭单份回复气泡或通过该回复回到源会话时,确认展示时合并的未读回合。阅读期间新到的回合继续保留未读,旧回合的完整结果仍可通过历史导航查看。通用异常/暂停项点击“去处理/Take a look”后,会清除该轮的信封条目与持续悲伤/等待神态;相同快照不会恢复,新异常仍会提醒。任务的原始失败/暂停事实保留,查看回执只在当前桌宠窗口运行期有效。审批与 AI 提问由 Harness 的实际答复、决定或取消结果结算;查看、收起互动提示或打开源会话均不会代替处理请求。
|
package/npm-shrinkwrap.json
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@takboo/dsh-coopanion",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.15",
|
|
4
4
|
"lockfileVersion": 3,
|
|
5
5
|
"requires": true,
|
|
6
6
|
"packages": {
|
|
7
7
|
"": {
|
|
8
8
|
"name": "@takboo/dsh-coopanion",
|
|
9
|
-
"version": "0.4.
|
|
9
|
+
"version": "0.4.15",
|
|
10
10
|
"license": "AGPL-3.0-or-later",
|
|
11
11
|
"dependencies": {
|
|
12
12
|
"dompurify": "3.4.17",
|
|
@@ -49,29 +49,29 @@
|
|
|
49
49
|
},
|
|
50
50
|
"engines": {
|
|
51
51
|
"node": ">=22.19",
|
|
52
|
-
"dsh": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2"
|
|
52
|
+
"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"
|
|
53
53
|
},
|
|
54
54
|
"peerDependencies": {
|
|
55
55
|
"@deepseek-ai/cordis": "~4.0.4 || 4.0.5-alpha.1",
|
|
56
|
-
"@deepseek-ai/dsh-agent": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
57
|
-
"@deepseek-ai/dsh-api-session-controller": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
58
|
-
"@deepseek-ai/dsh-client-connection": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
59
|
-
"@deepseek-ai/dsh-client-locale": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
60
|
-
"@deepseek-ai/dsh-client-store": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
61
|
-
"@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
62
|
-
"@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
63
|
-
"@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
64
|
-
"@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
65
|
-
"@deepseek-ai/dsh-client-ui-workspace": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
66
|
-
"@deepseek-ai/dsh-goal": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
67
|
-
"@deepseek-ai/dsh-llm": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
68
|
-
"@deepseek-ai/dsh-session": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
69
|
-
"@deepseek-ai/dsh-session-projection": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
70
|
-
"@deepseek-ai/dsh-settings": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
71
|
-
"@deepseek-ai/dsh-user-approval": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
72
|
-
"@deepseek-ai/dsh-user-questions": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
56
|
+
"@deepseek-ai/dsh-agent": "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",
|
|
57
|
+
"@deepseek-ai/dsh-api-session-controller": "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",
|
|
58
|
+
"@deepseek-ai/dsh-client-connection": "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",
|
|
59
|
+
"@deepseek-ai/dsh-client-locale": "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",
|
|
60
|
+
"@deepseek-ai/dsh-client-store": "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",
|
|
61
|
+
"@deepseek-ai/dsh-client-ui-primitives": "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",
|
|
62
|
+
"@deepseek-ai/dsh-client-ui-renderer": "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",
|
|
63
|
+
"@deepseek-ai/dsh-client-ui-settings": "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",
|
|
64
|
+
"@deepseek-ai/dsh-client-ui-slots": "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",
|
|
65
|
+
"@deepseek-ai/dsh-client-ui-workspace": "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",
|
|
66
|
+
"@deepseek-ai/dsh-goal": "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",
|
|
67
|
+
"@deepseek-ai/dsh-llm": "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",
|
|
68
|
+
"@deepseek-ai/dsh-session": "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",
|
|
69
|
+
"@deepseek-ai/dsh-session-projection": "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",
|
|
70
|
+
"@deepseek-ai/dsh-settings": "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",
|
|
71
|
+
"@deepseek-ai/dsh-user-approval": "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",
|
|
72
|
+
"@deepseek-ai/dsh-user-questions": "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",
|
|
73
73
|
"@deepseek-ai/schemastery": ">=3.18.4 <4",
|
|
74
|
-
"@deepseek-ai/dsh-session-query": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2"
|
|
74
|
+
"@deepseek-ai/dsh-session-query": "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"
|
|
75
75
|
},
|
|
76
76
|
"peerDependenciesMeta": {
|
|
77
77
|
"@deepseek-ai/dsh-api-session-controller": {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@takboo/dsh-coopanion",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.15",
|
|
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",
|
|
@@ -25,7 +25,7 @@
|
|
|
25
25
|
},
|
|
26
26
|
"engines": {
|
|
27
27
|
"node": ">=22.19",
|
|
28
|
-
"dsh": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2"
|
|
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"
|
|
29
29
|
},
|
|
30
30
|
"main": "./dist/index.js",
|
|
31
31
|
"exports": {
|
|
@@ -104,25 +104,25 @@
|
|
|
104
104
|
},
|
|
105
105
|
"peerDependencies": {
|
|
106
106
|
"@deepseek-ai/cordis": "~4.0.4 || 4.0.5-alpha.1",
|
|
107
|
-
"@deepseek-ai/dsh-agent": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
108
|
-
"@deepseek-ai/dsh-api-session-controller": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
109
|
-
"@deepseek-ai/dsh-client-connection": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
110
|
-
"@deepseek-ai/dsh-client-locale": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
111
|
-
"@deepseek-ai/dsh-client-store": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
112
|
-
"@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
113
|
-
"@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
114
|
-
"@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
115
|
-
"@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
116
|
-
"@deepseek-ai/dsh-client-ui-workspace": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
117
|
-
"@deepseek-ai/dsh-goal": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
118
|
-
"@deepseek-ai/dsh-llm": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
119
|
-
"@deepseek-ai/dsh-session": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
120
|
-
"@deepseek-ai/dsh-session-projection": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
121
|
-
"@deepseek-ai/dsh-settings": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
122
|
-
"@deepseek-ai/dsh-user-approval": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
123
|
-
"@deepseek-ai/dsh-user-questions": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2",
|
|
107
|
+
"@deepseek-ai/dsh-agent": "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",
|
|
108
|
+
"@deepseek-ai/dsh-api-session-controller": "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",
|
|
109
|
+
"@deepseek-ai/dsh-client-connection": "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",
|
|
110
|
+
"@deepseek-ai/dsh-client-locale": "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",
|
|
111
|
+
"@deepseek-ai/dsh-client-store": "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",
|
|
112
|
+
"@deepseek-ai/dsh-client-ui-primitives": "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",
|
|
113
|
+
"@deepseek-ai/dsh-client-ui-renderer": "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",
|
|
114
|
+
"@deepseek-ai/dsh-client-ui-settings": "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",
|
|
115
|
+
"@deepseek-ai/dsh-client-ui-slots": "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",
|
|
116
|
+
"@deepseek-ai/dsh-client-ui-workspace": "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",
|
|
117
|
+
"@deepseek-ai/dsh-goal": "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",
|
|
118
|
+
"@deepseek-ai/dsh-llm": "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",
|
|
119
|
+
"@deepseek-ai/dsh-session": "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",
|
|
120
|
+
"@deepseek-ai/dsh-session-projection": "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",
|
|
121
|
+
"@deepseek-ai/dsh-settings": "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",
|
|
122
|
+
"@deepseek-ai/dsh-user-approval": "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",
|
|
123
|
+
"@deepseek-ai/dsh-user-questions": "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",
|
|
124
124
|
"@deepseek-ai/schemastery": ">=3.18.4 <4",
|
|
125
|
-
"@deepseek-ai/dsh-session-query": "0.2.0-rc.2 || 0.2.1-alpha.1 || 0.2.1-rc.1 || 0.2.1-rc.2"
|
|
125
|
+
"@deepseek-ai/dsh-session-query": "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"
|
|
126
126
|
},
|
|
127
127
|
"devDependencies": {
|
|
128
128
|
"@deepseek-ai/cordis": "4.0.4",
|
|
@@ -21,7 +21,7 @@ assert.match(args['source-commit'], /^[a-f0-9]{40}$/);
|
|
|
21
21
|
assert.ok(process.env.DISPLAY);
|
|
22
22
|
const runtime = resolve(args.runtime), archivePath = resolve(args.package), output = resolve(args.output);
|
|
23
23
|
const version = args.version ?? '0.2.0-rc.2';
|
|
24
|
-
assert.ok(['0.2.0-rc.2', '0.2.1-alpha.1', '0.2.1-rc.1', '0.2.1-rc.2'].includes(version));
|
|
24
|
+
assert.ok(['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'].includes(version));
|
|
25
25
|
const seconds = Number(args.seconds ?? 7200), interval = Number(args.interval ?? 5), windowSeconds = Number(args.window ?? 1800), warmup = Number(args.warmup ?? 20);
|
|
26
26
|
assert.ok([seconds, interval, windowSeconds, warmup].every(Number.isFinite) && seconds >= windowSeconds * 2 && windowSeconds >= 10 && interval >= 1 && interval <= 10 && warmup >= 20);
|
|
27
27
|
await mkdir(dirname(output), { recursive: true }); await mkdir(output);
|
package/src/bridge.ts
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
import { spawn, type ChildProcess } from 'node:child_process';
|
|
2
|
-
import { createRequire } from 'node:module';
|
|
3
2
|
import { fileURLToPath } from 'node:url';
|
|
4
3
|
import { EventEmitter } from 'node:events';
|
|
5
4
|
import type { ChatReceipt } from '../web/chat-contract.js';
|
|
6
5
|
import type { PetSnapshot, PetNotice } from './model.ts';
|
|
7
6
|
import type { NotificationRuntime, NotificationSnapshot, TaskNotice } from './notification-contract.ts';
|
|
8
7
|
import { NativeStartError, type StartLifetime, type NativeLifecycle } from './desktop-lifecycle.ts';
|
|
8
|
+
import { electronExecutable } from './electron-runtime.ts';
|
|
9
9
|
export { NativeStartError, type StartLifetime, type NativeLifecycle } from './desktop-lifecycle.ts';
|
|
10
10
|
|
|
11
11
|
import type { CompanionshipMode } from '../web/companionship.js';
|
|
@@ -37,6 +37,8 @@ export class ElectronBridge extends EventEmitter implements PetBridge {
|
|
|
37
37
|
private latestOptions?: DesktopOptions;
|
|
38
38
|
private resultKey?: string;
|
|
39
39
|
private closing = false;
|
|
40
|
+
private preparing?: AbortController;
|
|
41
|
+
private preparation?: Promise<string>;
|
|
40
42
|
|
|
41
43
|
private generation = 0;
|
|
42
44
|
private visibilityRevision = 0;
|
|
@@ -47,7 +49,7 @@ export class ElectronBridge extends EventEmitter implements PetBridge {
|
|
|
47
49
|
private lastNotificationState?: NotificationSnapshot;
|
|
48
50
|
|
|
49
51
|
async start(options: DesktopOptions, lifetime?: StartLifetime): Promise<void> {
|
|
50
|
-
if (this.child) throw new NativeStartError('Desktop pet is already running', false);
|
|
52
|
+
if (this.child || this.preparing) throw new NativeStartError('Desktop pet is already running or starting', false);
|
|
51
53
|
if (lifetime?.signal.aborted) throw new Error('桌宠启动已取消');
|
|
52
54
|
this.latestOptions = { ...options };
|
|
53
55
|
this.closing = false;
|
|
@@ -55,8 +57,19 @@ export class ElectronBridge extends EventEmitter implements PetBridge {
|
|
|
55
57
|
this.visibilityRevision = 0; this.nativeVisible = false;
|
|
56
58
|
if (process.platform === 'linux' && !process.env.DISPLAY && !process.env.WAYLAND_DISPLAY) throw new NativeStartError('桌宠需要桌面显示环境。', false);
|
|
57
59
|
let executable: string;
|
|
58
|
-
|
|
59
|
-
|
|
60
|
+
if (options.electronPath !== undefined) executable = options.electronPath;
|
|
61
|
+
else {
|
|
62
|
+
const preparing = new AbortController(); this.preparing = preparing;
|
|
63
|
+
const abort = () => preparing.abort();
|
|
64
|
+
lifetime?.signal.addEventListener('abort', abort, { once: true });
|
|
65
|
+
if (lifetime?.signal.aborted) abort();
|
|
66
|
+
try {
|
|
67
|
+
this.preparation = electronExecutable(preparing.signal);
|
|
68
|
+
executable = await this.preparation;
|
|
69
|
+
if (preparing.signal.aborted || this.closing) throw new Error('桌宠启动已取消');
|
|
70
|
+
} catch (error) { throw error instanceof NativeStartError ? error : new NativeStartError(String(error).slice(0, 600), false); }
|
|
71
|
+
finally { lifetime?.signal.removeEventListener('abort', abort); this.preparing = undefined; this.preparation = undefined; }
|
|
72
|
+
}
|
|
60
73
|
const env: NodeJS.ProcessEnv = { ...process.env, DSH_PET_GENERATION: String(this.generation), DSH_PET_VISIBLE: lifetime?.visible === false ? '0' : '1', DSH_PET_SCREEN_LOCKED: this.screenLocked ? '1' : '0', DSH_PET_SYSTEM_ASLEEP: this.systemAsleep ? '1' : '0' };
|
|
61
74
|
delete (env as NodeJS.ProcessEnv).ELECTRON_RUN_AS_NODE;
|
|
62
75
|
const args = [fileURLToPath(new URL('../desktop/main.cjs', import.meta.url))];
|
|
@@ -147,6 +160,8 @@ export class ElectronBridge extends EventEmitter implements PetBridge {
|
|
|
147
160
|
|
|
148
161
|
async dispose(): Promise<void> {
|
|
149
162
|
this.closing = true;
|
|
163
|
+
this.preparing?.abort();
|
|
164
|
+
await this.preparation?.catch(() => undefined);
|
|
150
165
|
const child = this.child;
|
|
151
166
|
if (!child) return;
|
|
152
167
|
if (child.pid === undefined || child.exitCode !== null || child.signalCode !== null) { if (this.child === child) this.child = undefined; return; }
|
package/src/client/index.ts
CHANGED
|
@@ -49,7 +49,7 @@ export function apply(ctx: Context): void {
|
|
|
49
49
|
const reply = await ctx.connection.rpc.call('/api', command ? 'coopanion/control' : 'coopanion/status', command ? { command } : {}, signal);
|
|
50
50
|
if (!reply.ok) throw new Error(reply.error.message);
|
|
51
51
|
const value = reply.value as PetStatus;
|
|
52
|
-
if (!value || !['stopped', 'starting', 'running', 'stopping', 'error'].includes(value.phase) || typeof value.visible !== 'boolean') throw new Error('Invalid desktop pet status');
|
|
52
|
+
if (!value || !['stopped', 'starting', 'running', 'stopping', 'recovering', 'error'].includes(value.phase) || typeof value.visible !== 'boolean') throw new Error('Invalid desktop pet status');
|
|
53
53
|
return value;
|
|
54
54
|
},
|
|
55
55
|
};
|
package/src/controls.ts
CHANGED
|
@@ -90,7 +90,7 @@ export class PetControls {
|
|
|
90
90
|
if (this.disposed || !this.wanted || epoch !== this.epoch) return;
|
|
91
91
|
const startup = new AbortController(); this.startup = startup; this.startupExit = undefined;
|
|
92
92
|
this.set({ ...this.state, phase: 'starting', error: undefined, retryAt: undefined, visible: false, generation: this.state.generation + 1, visibilityRevision: 0, suspended: false });
|
|
93
|
-
try { await this.withDeadline(this.bridge.start(this.options(), { signal: startup.signal, generation: this.state.generation, visible: this.state.desiredVisible }), this.limits.startTimeoutMs ??
|
|
93
|
+
try { await this.withDeadline(this.bridge.start(this.options(), { signal: startup.signal, generation: this.state.generation, visible: this.state.desiredVisible }), this.limits.startTimeoutMs ?? 265_000, '桌宠启动超时', startup.signal, true); }
|
|
94
94
|
catch (error) { throw this.startupExit ?? error; }
|
|
95
95
|
if (startup.signal.aborted || this.disposed || epoch !== this.epoch) throw new Error('桌宠启动已取消');
|
|
96
96
|
this.startup = undefined;
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import { spawn } from 'node:child_process';
|
|
2
|
+
import { access, readFile } from 'node:fs/promises';
|
|
3
|
+
import { createRequire } from 'node:module';
|
|
4
|
+
import { dirname, join } from 'node:path';
|
|
5
|
+
import { NativeStartError } from './desktop-lifecycle.ts';
|
|
6
|
+
|
|
7
|
+
// Electron 44's index.js may spawnSync its installer. Resolve files without
|
|
8
|
+
// executing that entrypoint, then prepare missing binaries off the Host loop.
|
|
9
|
+
export async function electronExecutable(signal: AbortSignal): Promise<string> {
|
|
10
|
+
const directory = dirname(createRequire(import.meta.url).resolve('electron'));
|
|
11
|
+
async function installed(): Promise<string | undefined> {
|
|
12
|
+
let relative: string;
|
|
13
|
+
try { relative = await readFile(join(directory, 'path.txt'), 'utf8'); }
|
|
14
|
+
catch (error) { if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error; relative = ''; }
|
|
15
|
+
if (process.env.ELECTRON_OVERRIDE_DIST_PATH) return join(process.env.ELECTRON_OVERRIDE_DIST_PATH, relative || 'electron');
|
|
16
|
+
if (!relative) return;
|
|
17
|
+
const executable = join(directory, 'dist', relative);
|
|
18
|
+
try { await access(executable); return executable; }
|
|
19
|
+
catch (error) { if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error; }
|
|
20
|
+
}
|
|
21
|
+
if (signal.aborted) throw new Error('桌宠启动已取消');
|
|
22
|
+
const existing = await installed();
|
|
23
|
+
if (existing) return existing;
|
|
24
|
+
await new Promise<void>((resolve, reject) => {
|
|
25
|
+
if (signal.aborted) { reject(new Error('桌宠启动已取消')); return; }
|
|
26
|
+
const child = spawn(process.execPath, [join(directory, 'install.js')], {
|
|
27
|
+
env: { ...process.env, ELECTRON_RUN_AS_NODE: '1' }, stdio: 'ignore', windowsHide: true,
|
|
28
|
+
});
|
|
29
|
+
let failure: Error | undefined, killTimer: ReturnType<typeof setTimeout> | undefined;
|
|
30
|
+
const stop = (error: Error) => {
|
|
31
|
+
if (failure) return;
|
|
32
|
+
failure = error; child.kill();
|
|
33
|
+
killTimer = setTimeout(() => child.kill('SIGKILL'), 1000);
|
|
34
|
+
};
|
|
35
|
+
const aborted = () => stop(new Error('桌宠启动已取消'));
|
|
36
|
+
const timer = setTimeout(() => stop(new NativeStartError('Electron 运行时准备超时,请检查网络或按使用指南预先安装运行时。', false)), 240_000);
|
|
37
|
+
signal.addEventListener('abort', aborted, { once: true });
|
|
38
|
+
const finish = (error?: Error) => {
|
|
39
|
+
clearTimeout(timer); clearTimeout(killTimer); signal.removeEventListener('abort', aborted);
|
|
40
|
+
if (failure || error) reject(failure ?? error); else resolve();
|
|
41
|
+
};
|
|
42
|
+
child.once('error', error => finish(new NativeStartError(error.message.slice(0, 600), false)));
|
|
43
|
+
child.once('exit', code => finish(code === 0 ? undefined : new NativeStartError(`Electron 运行时准备失败 (${code}),请检查网络或按使用指南预先安装运行时。`, false)));
|
|
44
|
+
if (signal.aborted) aborted();
|
|
45
|
+
});
|
|
46
|
+
if (signal.aborted) throw new Error('桌宠启动已取消');
|
|
47
|
+
const executable = await installed();
|
|
48
|
+
if (!executable) throw new NativeStartError('Electron 安装未生成可用运行时,请按使用指南重新准备。', false);
|
|
49
|
+
return executable;
|
|
50
|
+
}
|
package/src/figure-server.ts
CHANGED
|
@@ -35,7 +35,9 @@ async function sourceArchive(project: string): Promise<Uint8Array> {
|
|
|
35
35
|
export function createPetServer({ webRoot, store, companions, prefix = '/' }: { webRoot: string; store: CharacterStore; companions?: CompanionStore; prefix?: string }) {
|
|
36
36
|
let operation = Promise.resolve();
|
|
37
37
|
const server = createServer(async (req, res) => {
|
|
38
|
-
|
|
38
|
+
// Accepted connections can deliver queued requests after close() has made
|
|
39
|
+
// server.address() null. Their local port still identifies the bound origin.
|
|
40
|
+
const origin = `http://127.0.0.1:${req.socket.localPort}`;
|
|
39
41
|
const json = (value: unknown, status = 200) => { res.writeHead(status, { 'Content-Type': 'application/json', 'Cache-Control': 'no-store' }); res.end(JSON.stringify(value)); };
|
|
40
42
|
try {
|
|
41
43
|
if (req.headers.host !== new URL(origin).host) { res.writeHead(403).end(); return; }
|