@takboo/dsh-coopanion 0.4.15 → 0.4.16
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 +3 -3
- package/THIRD_PARTY_NOTICES.md +4 -0
- package/dist/build-info.json +2 -2
- package/docs/README.md +1 -0
- package/docs/compatibility.md +39 -0
- package/docs/development.md +1 -1
- package/docs/notification-contract.md +1 -1
- package/docs/release-notes.md +10 -0
- package/docs/releasing.md +2 -2
- package/docs/session-chat-contract.md +1 -1
- package/docs/usage.md +5 -5
- package/npm-shrinkwrap.json +812 -648
- package/package.json +47 -42
- package/scripts/compatibility/LICENSE +21 -0
- package/scripts/compatibility/admission.mjs +11 -0
- package/scripts/compatibility/check.mjs +43 -0
- package/scripts/compatibility/common.mjs +104 -0
- package/scripts/compatibility/desktop-artifact.mjs +34 -0
- package/scripts/compatibility/desktop-bootstrap.mjs +27 -0
- package/scripts/compatibility/desktop.mjs +83 -0
- package/scripts/compatibility/discover.mjs +89 -0
- package/scripts/compatibility/inspect-desktop.mjs +9 -0
- package/scripts/compatibility/planning.mjs +38 -0
- package/scripts/compatibility/prepare.mjs +58 -0
- package/scripts/compatibility/proposal.mjs +37 -0
- package/scripts/compatibility/report.mjs +198 -0
- package/scripts/compatibility/runner.mjs +59 -0
- package/scripts/observe-companion.mjs +1 -1
- package/tests/compatibility-monitor.mjs +164 -0
- package/tests/goal-host-contract.mjs +4 -2
- package/tests/install.mjs +11 -6
- package/tests/session-host-contract.mjs +4 -2
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.
|
|
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.
|
|
61
|
+
@takboo/dsh-coopanion@0.4.16
|
|
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.
|
|
73
|
+
dsh plugin --profile desktop add @takboo/dsh-coopanion@0.4.16
|
|
74
74
|
```
|
|
75
75
|
|
|
76
76
|
完成后重新打开 Desktop。其他 profile 的安装方法见[使用指南](docs/usage.md#通过-dsh-命令行安装)。
|
package/THIRD_PARTY_NOTICES.md
CHANGED
|
@@ -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.
|
package/dist/build-info.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schema": 1,
|
|
3
|
-
"commit": "
|
|
3
|
+
"commit": "ddf6e54e590aa3963fa0e67f98ef41ce1f02f19c",
|
|
4
4
|
"dirty": false,
|
|
5
|
-
"productDigest": "
|
|
5
|
+
"productDigest": "00251d71dc180e03ce10bd7cdc88054003826def31b8b8a711e87d97a2685468"
|
|
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 服务。
|
package/docs/development.md
CHANGED
|
@@ -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
|
|
32
|
+
macOS CI 固定使用 `macos-15` Apple Silicon 标准 runner。浏览器回归结束后再执行原生桌面检查,保留既有执行顺序,系统桌面操作串行进行。三平台测试和十八组宿主安装保留全部断言与期限;本地 VM 验证仍单独记录实际系统、提交与包摘要。
|
|
33
33
|
|
|
34
34
|
真实轻抚回归在角色宽度的 20%/80% 位置间往返,保持每次十八个可信移动,避免窄幅轨迹在输入调度迟缓时衰减为无效手势。伪造事件拒绝、二十次反馈、增长冷却、500 ms 响应和原有等待期限继续检查,产品判定规则不变。
|
|
35
35
|
|
|
@@ -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
|
|
73
|
+
三平台 CI 执行共享检查并保留原型摘要;十八组实际安装检查分别执行对应宿主版本的接口检查并上传报告。每份 Host 报告记录源码 commit、插件版本、包实现摘要及实际控制样本事件。
|
|
74
74
|
|
|
75
75
|
独立 `textScale` 是呈现偏好,不改变类别、提醒身份、已读/结算或驻留时间;详见[文字契约](text-readability-contract.md)。
|
|
76
76
|
|
package/docs/release-notes.md
CHANGED
|
@@ -1,3 +1,13 @@
|
|
|
1
|
+
# v0.4.16
|
|
2
|
+
|
|
3
|
+
## DSH 0.2.1-rc.5 兼容与自动检查
|
|
4
|
+
|
|
5
|
+
- 将 rc.5 加入宿主和 peer 的精确支持列表,开发契约检查使用 rc.5,保留此前五版支持;未验证的 rc.4 及其他版本仍不放行。
|
|
6
|
+
- 三平台同包安装矩阵扩为六版宿主、十八组,覆盖正式 Loader、通知与目标完成、接受回执与会话续接、原生窗口及恢复。
|
|
7
|
+
- 新增每小时兼容性监测:发现官方 Release、npm 与 Desktop 发布物,按身份去重、分组件有限重试、保留 Issue 证据并准备依赖草稿 PR。候选结果不自动扩大正式支持或触发发布。
|
|
8
|
+
|
|
9
|
+
安装包:`dsh-coopanion-0.4.16.tgz`;npm 与 GitHub Release 使用同一份发布 CI 验证的压缩包。
|
|
10
|
+
|
|
1
11
|
# v0.4.15
|
|
2
12
|
|
|
3
13
|
## 启动、显示几何与退出修复
|
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
|
|
|
@@ -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.
|
|
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.
|
|
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.
|
|
13
|
+
打开侧边栏 **插件 → 添加插件**,在「包名或地址」输入 **`@takboo/dsh-coopanion@0.4.16`**,点击安装,再启用 `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.16
|
|
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.16
|
|
35
35
|
dsh --profile web
|
|
36
36
|
```
|
|
37
37
|
|