30 KiB
DSH 宿主 × ds-bot 0.3.2 兼容性核查(P0-C)
核查性质:只读。本次未安装 ds-bot,未修改 profile 的
package.json/cordis.patch.yml/pnpm-workspace.yaml,未执行任何dsh plugin add。 核查对象:ds-bot 上游固定 commit8e0013e077eaeccc137327956e18425e73a5bb8c,包版本0.3.2。 核查时间:2026-11-10(Asia/Shanghai)。宿主为 nightly 通道,结论有时效性。
1. 版本对照表
| 维度 | 本机宿主实测 | ds-bot 0.3.2 声明 / 期望 | 判定 |
|---|---|---|---|
| DSH 宿主版本 | 0.2.1-rc.5 | README:Tested with dsh 0.2.2-rc.1 |
⚠ 比测试基线低 1 个 rc(peerDeps 拦不住,见 §4) |
@deepseek-ai/cordis |
4.0.5 | peerDeps * |
✅ satisfied(区间为通配,无约束力) |
@deepseek-ai/dsh-llm |
0.2.1-rc.5 | peerDeps * |
✅ satisfied |
@deepseek-ai/dsh-scope |
0.2.1-rc.5 | peerDeps * |
✅ satisfied |
@deepseek-ai/dsh-tools |
0.2.1-rc.5 | peerDeps * |
✅ satisfied |
@deepseek-ai/dsh-web |
0.2.1-rc.5 | peerDeps * |
✅ satisfied |
| 上述 5 个 peer 的提供方 | 宿主 app.asar 内置(profile 的 node_modules/@deepseek-ai/ 只有 4 个无关包) |
— | ✅ 不会装出第二份 |
| inject 服务(8 个) | 8/8 均存在于宿主 | inject = [llm, tools, systemPrompt, sessionController, sessions, sessionTitle, workspaceRegistry, connection] |
✅ 全部 satisfied |
| 被调用的服务方法 | 逐一比对通过(create / list / page / projections / prompt / selectModel / resolveAgent / rename / connection.fetch.register) |
— | ✅ 签名与返回形状对齐 |
| client 半边 | dsh.client.platform = "web",走 window.__ModuleLoader__ |
同 | ✅ |
manifestVersion |
宿主已装插件中 dsh-better-sidebar 用 1,dsh-image-gen 未声明 |
ds-bot 未声明 | ✅ 非阻断(与 image-gen 同类) |
| npm 发布状态 | ds-bot@0.3.2 已发布,dist-tags.latest = 0.3.2 |
— | ✅ 可走 registry,无需本地 tarball |
| profile 安装状态 | 未安装(dependencies 与 bundles 均无 ds-bot) |
— | 待安装 |
| profile 尺寸基线 | 36 个 dependencies(5 个 link:)、38 条 dsh.profile.bundles |
— | 已较重,注意增量 |
一句话结论:静态兼容性通过,可以安装;唯一实质风险是宿主版本比上游自测基线低一个 rc(0.2.1-rc.5 vs 0.2.2-rc.1),而 peerDeps 全是 * 不具备任何版本闸门作用,因此真正的把关来自本次的 API 面逐项比对(已做,见 §4)。
2. 核查方法与证据链
2.1 环境与限制
| 项 | 值 |
|---|---|
| 工作目录 | C:\Users\qyh15\三省六部 |
| 宿主安装目录 | C:\Users\qyh15\AppData\Local\Programs\DeepSeek Harness\ |
宿主 app.asar |
...\resources\app.asar,182,766,714 字节,18,234 个条目 |
| profile | C:\Users\qyh15\.dsh\profiles\desktop\ |
| node | v24.21.0(需 export PATH="/c/Users/qyh15/.dsh/dsh-runtimes/dsh-primary-runtime/dependencies/node/bin:$PATH") |
| 网络 | git 的 https 远程与 curl 均不可用(pipe/schannel 错误),只能用 node 内置 fetch |
| 安全网 | profile 的 .npmrc 被 CC Safety Net 拦截(Rule: secret.basename.npmrc),未读取、未绕过;本报告不依赖该文件 |
2.2 取证工具(均落在 .scratch/p0/,未纳入提交)
| 脚本 / 产物 | 用途 |
|---|---|
asar-read.cjs |
解析 asar pickle header(uint32 headerPickleSize @4、headerStringSize @8,baseOffset = 8 + headerPickleSize),按路径解出条目 |
asar-grep.cjs |
一次读入 index,按路径正则筛文件并在进程内按文本正则 grep,输出 路径:行号:内容 |
npm-fetch.mjs |
用 node fetch 打 npm registry |
host-package.json |
从 asar 解出的宿主 package.json 原始 17,168 字节 |
asar-index.txt / core-pkgs.txt / host-services.txt |
asar 条目清单 / 307 个 @deepseek-ai/* 包名 / 宿主 88 个 cordis 服务名 |
api-session-controller.js、session-title.js、client-connection.index.js |
从 asar 解出的相关服务源码(3,368 / 652 / — 行) |
关键命令形态:
node asar-read.cjs "<...>/resources/app.asar" "dsh/package.json"
node asar-grep.cjs "<...>/resources/app.asar" "<路径正则>" "<文本正则>"
node npm-fetch.mjs https://registry.npmjs.org/ds-bot
2.3 重要限制:asar 内没有任何 .d.ts
对 18,234 个条目按 \.d\.ts$ 计数为 0。因此"类型层面"的对齐无法用 d.ts 佐证,本报告只能用 JS 实现源码 + 服务声明 + README 作为等效证据,并在 §5 把结论强度分层标注。
3. 宿主版本:0.2.1-rc.5(双独立证据)
| 证据 | 内容 |
|---|---|
E1:asar 内 dsh/package.json |
name = @deepseek-ai/dsh-desktop-runtime,version = 0.2.1-rc.5;305 个 dependencies 中全部 @deepseek-ai/* 均为 0.2.1-rc.5(cordis 例外为 4.0.5) |
E2:DeepSeek Harness.exe 的 VersionInfo |
FileVersion = 0.2.1-rc.5,ProductVersion = 0.2.1.0,ProductName = DeepSeek Harness |
| E3:asar 顶层结构 | dsh/ 17,188 条、node_modules/ 1,019 条、renderer/ 13、lib/ 13、package.json 1 —— 与 "Electron 外壳 + 内嵌 dsh runtime" 一致 |
干扰项(不要用它们判断版本)
- 安装目录下的
version文件内容是44.7.0—— 这是 Electron 版本,不是应用版本。 app-update.yml:channel: nightly,url: https://download.deepseek.com/dsh-desk/feeds/win-x64/—— 说明本机走 nightly 通道,后续宿主会自动前进到 0.2.2+,届时需复测(见 §7 R1)。
附:
resources/runtime/cli/bin/dsh.cmd --version从 git bash 需写全路径调用(dsh无 shell wrapper,直接敲dsh报command not found)。
4. peerDependencies 满足性(逐项)
4.1 ds-bot 0.3.2 声明的 peerDeps
package.json(本地 source 与 npm registry 元数据完全一致):
"peerDependencies": {
"@deepseek-ai/cordis": "*",
"@deepseek-ai/dsh-llm": "*",
"@deepseek-ai/dsh-scope": "*",
"@deepseek-ai/dsh-tools": "*",
"@deepseek-ai/dsh-web": "*"
}
4.2 逐项判定
| peer | 区间 | 本机实际提供 | 满足 |
|---|---|---|---|
@deepseek-ai/cordis |
* |
4.0.5(宿主 dsh/package.json) |
✅ satisfied |
@deepseek-ai/dsh-llm |
* |
0.2.1-rc.5 | ✅ satisfied |
@deepseek-ai/dsh-scope |
* |
0.2.1-rc.5 | ✅ satisfied |
@deepseek-ai/dsh-tools |
* |
0.2.1-rc.5 | ✅ satisfied |
@deepseek-ai/dsh-web |
* |
0.2.1-rc.5 | ✅ satisfied |
全部 satisfied —— 但这个结论几乎没有信息量:* 对任何版本都成立,包括 0.1.x 这种 API 完全不同的版本。真正的兼容性证据只能来自 §5 的服务与方法比对。
4.3 这 5 个包从哪来(关键机制)
C:\Users\qyh15\.dsh\profiles\desktop\node_modules\@deepseek-ai\下只有 4 个包:cosmokit、dsh-brand、dsh-home-paths、schemastery;node_modules/.pnpm下也没有deepseek相关目录。- 即:这 5 个 peer 由宿主
app.asar提供,profile 既不必也装不到同名包。 C:\Users\qyh15\.dsh\profiles\desktop\pnpm-workspace.yaml:packages: ['.']、nodeLinker: hoisted、autoInstallPeers: false。
autoInstallPeers: false是当前 profile 的安全网:一旦改成true,pnpm 会去 npm 拉这 5 个 peer,而@deepseek-ai/dsh-llm等在 npm 上的latest是0.0.1-rc.1(stub)、cordis的latest是4.1.0——会装出第二份 cordis 与第二套服务,比版本漂移严重得多。见 §7 R5。
5. inject 服务存在性(8/8)
ds-bot index.js:54:
export const inject = ['llm', 'tools', 'systemPrompt', 'sessionController',
'sessions', 'sessionTitle', 'workspaceRegistry', 'connection']
(同文件 index.js:53 export const name = 'ds-bot',index.js:63 export function apply(ctx, config = {}))
5.1 服务声明定位(路径均在 app.asar 内 dsh/node_modules/ 下)
| # | 服务 | 宿主声明位置 | 存在 |
|---|---|---|---|
| 1 | llm |
@deepseek-ai/dsh-llm/lib/index.js:1816 |
✅ |
| 2 | tools |
@deepseek-ai/dsh-tools/lib/index.js:2798 |
✅ |
| 3 | systemPrompt |
@deepseek-ai/dsh-system-prompt/lib/index.js:226 |
✅ |
| 4 | sessionController |
@deepseek-ai/dsh-api-session-controller/lib/index.js:2952(super(ctx, "sessionController", { namespace: "session" })) |
✅ |
| 5 | sessions |
@deepseek-ai/dsh-session/lib/index.js:1739 |
✅ |
| 6 | sessionTitle |
@deepseek-ai/dsh-session-title/lib/index.js:214 |
✅ |
| 7 | workspaceRegistry |
@deepseek-ai/dsh-workspace/lib/index.js:376 |
✅ |
| 8 | connection |
@deepseek-ai/dsh-client-connection/lib/index.js:710(HostConnectionService,注释原文 "Host Connection service") |
✅ |
宿主服务全集共 88 个(清单见 .scratch/p0/host-services.txt),包括 agentPresets agents approval attachments compaction goals jobs schedule skills tokenMeter shellEnv agentTeams workflowEngine 等。
5.2 软依赖也全部命中
ds-bot 除 8 个硬依赖外,还用 ctx.inject([...]) 挂可选能力,全部存在:
| 位置 | 软依赖 | 宿主 |
|---|---|---|
capabilities.js:320 |
inject: ['skills'] |
✅ |
schedules.js:97 |
ctx.inject(['schedule'], attach) |
✅ |
steer.js:22 |
ctx.inject(['jobs'], attachJobs) |
✅ |
tools.js:1114 |
ctx.inject(['goals'], attachGoals) |
✅ |
另有 ctx.get(...) 取 agentPresets / agents / attachments / compaction / shellEnv / tokenMeter,均存在。
把 ds-bot 里所有 ctx.<name> 与 ctx.get('<name>') 做全集差集,未命中的只有 cordis Context 自身成员(on/get/inject/effect/fiber/plugin/reflect/logger/origin/complete)与局部变量 session,没有缺失的业务服务。
5.3 方法级比对(调用点 → 宿主实现)
| ds-bot 调用 | 宿主实现 | 形状 |
|---|---|---|
src/host/agents.js:40 ctx.sessionController.create({ workspaceId }) |
api-session-controller/lib/index.js:3090 create(request) |
返回 { sessionId, agentPreset? } ✅ |
src/host/usage.js:411 (await ctx.sessionController.list({}, signal)).items ?? [] |
同文件 :3061 async list(_request, signal) → { items: [...] } |
✅(注意:同文件 :1959 的 async list(signal) 返回裸数组,那是内部 ApiSessionList 路径,不是服务方法,勿混淆) |
src/host/chat-index.js:58、src/host/parts.js:1640/1653 page({...}) |
:3262 page(request, signal) |
✅ |
src/host/usage.js:361 projections({ sessionId }, signal) |
:3281 async projections(request, signal) |
✅ |
src/host/channel.js:719 prompt({...}) |
:3218 async prompt(request, signal) |
✅ |
src/host/delivery.js:11 resolveAgent(sessionId) |
:3037 resolveAgent(sessionId) |
✅ |
src/host/models.js:231 selectModel({...}) |
:3098 selectModel(request) |
✅ |
src/host/agents.js:100、roster.js:97/412/600 ctx.sessionTitle.rename(session, title) |
dsh-session-title/lib/index.js:295 rename(session, title)(另 refresh:319、register:358) |
✅ |
src/host/channel.js:754、src/host/feed.js:90 ctx.connection.fetch.register({...}) |
HostConnectionService 的 get fetch() { return { register: (route) => this.registerFetchRoute(route) } } |
✅ |
结论:8 个 inject 服务全部存在,被调用的方法签名与返回形状逐项对齐,未发现硬性 API 缺失。
5.4 client 半边(前端)
client.js1,712,874 字节,首行注释// Generated from src/client by npm run build,格式window.__ModuleLoader__.load({ id: 'ds-bot', factory: (require) => ... })。- 硬 require
@deepseek-ai/dsh-client-ui-primitives(见src/client/dsh-primitives.js)。 - 该包在
app.asar里没有磁盘实体(按路径 grep 0 命中),但宿主自带 client 插件(dsh-client-locale、dsh-client-shortcuts、dsh-client-ui-approval等)同样 require 它并作为0.2.1-rc.5依赖 → 它是前端__ModuleLoader__提供的虚拟共享模块,ds-bot 用同一机制即可解析。 - ds-bot 对它做了特性探测而非硬假设:
src/client/user-message.js:250附近canDrawUserMessages = () => typeof ui.projectUserText === 'function'—— 宿主缺该 API 时会降级,不会崩。 - 另有字符串常量
VOICE_BUNDLE = "@deepseek-ai/dsh-experimental-voice-input-bundle"(src/client/speech.js),该 bundle 在宿主包列表中存在。
6. npm registry:已发布,无需本地 tarball
node npm-fetch.mjs https://registry.npmjs.org/ds-bot → HTTP 200,81,795 字节。
| 项 | 值 |
|---|---|
dist-tags |
{"latest": "0.3.2"} |
| 已有版本 | 0.0.0-stage、0.1.0–0.1.7、0.2.0–0.2.7、0.3.0、0.3.1、0.3.2 |
0.3.2 发布时间 |
2026-11-09T09:56:14.583Z(registry created 2026-10-10T15:48:38.408Z,modified 2026-11-09T09:56:14.958Z) |
| tarball | https://registry.npmjs.org/ds-bot/-/ds-bot-0.3.2.tgz |
| integrity | sha512-M+Wn55IOjy8T54JY6OS3RqOuuaKX72B7lRZ7DK/y2DzkGEXXtNGmf4lqKUSVaY+ecWnByFv/a3uWVW0/Zc/1SA== |
| shasum | 909d3ee37acd3c3b89163725c040f6840368db53 |
| 体积 | fileCount 122,unpackedSize 3,936,182 |
registry 元数据中的 peerDependencies / dsh |
与本地 source 完全一致 |
6.1 本地 tarball 与 npm tarball 不是同一份
.scratch/p0/dsbot-8e0013e077eaeccc137327956e18425e73a5bb8c.tar.gz(6,101,133 字节)是 GitHub commit 归档:顶层目录 DS-Bot-<sha>/ds-bot/,含 dev/、test/、package-lock.json。
npm 包只发 files 白名单(index.js、src/host/、src/shared/、src/office/、client.js、office.js、web-search.js、cordis.patch.yml、README.md、LICENSE),122 个文件 / 3.9 MB。
→ 优先走 npm registry;本地 tarball 仅在完全离线时作后备(此时走 pnpm add file:... 或 vendor 目录 + link:,见附录 A.2)。
6.2 exports 面(决定 cordis 能否按子路径挂载)
package.json:"type": "module"、"main": "index.js"、exports 键 = . / ./client / ./web-search / ./package.json。
对应 cordis.patch.yml 里 name: ds-bot/web-search 的子路径加载,以及 browser 半边通过 ./client 发现。三者在本机均可解析(web-search.js、client.js、index.js 均在包内)。
7. profile 变更点(参照已装插件 manifest)
7.1 三个 manifest 对照
| 字段 | dsh-image-gen@0.9.3 |
dsh-better-sidebar@0.28.2 |
ds-bot@0.3.2 |
|---|---|---|---|
dsh.bundle.patch |
./cordis.patch.yml |
./cordis.patch.yml |
./cordis.patch.yml |
dsh.client.platform |
web |
web |
web |
dsh.client.inject |
8 个 client 包(含 dsh-client-ui-settings、dsh-client-ui-settings-plugins、dsh-client-ui-sidebar-right…) |
5 个 client 包(dsh-client-locale/ui-slots/ui-conversation/ui-sidebar-right/client-modules) |
无该数组 |
manifestVersion |
未声明 | 1 |
未声明 |
peerDependencies |
— | ^0.2.1-rc.1 / ^4.0.5 真实区间 |
全部 * |
判定:ds-bot 的 dsh 字段结构与 dsh-image-gen 同类(有 bundle.patch + client.platform,无 manifestVersion),而 image-gen 在本机正常工作 → manifest 层不构成阻断。client.inject 缺省表示它自带完整的 client 依赖解析策略(其 client.js 是预打包的单文件,由 __ModuleLoader__ 注入宿主 client 模块),与 better-sidebar 显式声明注入是两种合法风格。
7.2 官方安装通道(profile 文件不必手改)
dsh-better-sidebar/cordis.patch.yml 头部注释原文(该注释同时是 DSH 插件分发机制的官方说明):
安装 CLI 为
dsh plugin --profile <name> add dsh-better-sidebar@<version>。该命令 "reconcilesdsh.profile.bundlesagainst installed packages and, seeing this declaration, appends … to the bundle stack. The profile boot then merges THIS patch … No profile file edits needed — one command installs and mounts."
并且明确警告:
"If the profile still carries the old manual mount line in its own
cordis.patch.yml, remove it before switching to the bundle channel to avoid double-mounting."
本机 CLI 实测(--help,只读):
$ "<...>/resources/runtime/cli/bin/dsh.cmd" plugin --help
Usage: dsh plugin [options] [args...]
manage a profile's plugins by forwarding the remaining arguments to pnpm in the
profile directory
Arguments: args pnpm arguments, forwarded verbatim (add <pkg>, remove <pkg>, why <pkg>, ...)
Options: --profile <name> the profile whose plugins to manage (initialized on first use)
→ dsh plugin = 在 profile 目录里跑 pnpm,bundle 列表由宿主在 profile 启动时按 dsh.bundle 声明对账。
7.3 具体变更点
| # | 位置 | 变更 | 是否需要手改 |
|---|---|---|---|
| 1 | profiles/desktop/package.json → dependencies |
增加 "ds-bot": "0.3.2" |
否,dsh plugin add 代劳 |
| 2 | profiles/desktop/package.json → dsh.profile.bundles |
追加 "ds-bot" |
否,启动时对账(当前 38 条,最后一条是 dsh-sansheng-liubu-workbench) |
| 3 | profiles/desktop/cordis.patch.yml |
不需要 insert:ds-bot 自带的 patch 已经 insert: [{id: bot, name: ds-bot}, {id: web-search-auto, name: ds-bot/web-search}] |
否(手改反而会双挂,见 §7.5) |
| 4 | node_modules/ |
新增 ds-bot 及其 runtime 依赖 |
自动 |
ds-bot 自带 cordis.patch.yml(25 行,4 段)的完整语义:
- insert:
- id: bot
name: ds-bot
- id: web-search-auto
name: ds-bot/web-search
- id: web
config:
searchProvider: auto
fetchProvider: http
- id: ui-settings-general
disabled: true
(第 11–15 行注释警告:配置覆盖是整段替换,所以 fetchProvider 必须重述;若 profile 层另外指定 searchProvider: exa|perplexity|deepseek-official,则本段失效;而单独关掉 web-search-auto 会让每次 web_search 都失败。)
7.4 与本机现有 profile patch 的冲突分析
profiles/desktop/cordis.patch.yml(23,489 字节,profile 层,最后应用)现有相关条目:
| 行 | 条目 | 内容 |
|---|---|---|
| :27–30 | ui-settings |
name: @deepseek-ai/dsh-client-ui-settings,config.enabled: false |
| :31 | dsh-better-sidebar-plugin-office |
disabled: true |
| :35 | better-sidebar |
disabled: false |
| :37–40 | image-gen |
disabled: false,config.provider: dashscope |
对 ds-bot 三段覆盖的逐段核对:
| ds-bot 覆盖 | 本机 profile 层是否已有同名 id | 结论 |
|---|---|---|
- id: web(searchProvider: auto / fetchProvider: http) |
无 - id: web 条目 |
✅ 不冲突,会生效(web 的搜索供应商将从宿主默认变为 auto) |
- id: ui-settings-general(disabled: true) |
无 该 id(注意 profile 的 ui-settings 是另一个 id:@deepseek-ai/dsh-client-ui-settings) |
⚠ 会新生效:宿主原生「通用设置」页被关掉,由 DS Bot 的设置壳接管 |
- id: web-search-auto(insert) |
无 | ✅ 不冲突 |
- id: bot(insert) |
无 | ✅ 不冲突 |
关于 ui-settings-general:宿主侧它是真实存在的插件包 @deepseek-ai/dsh-client-ui-settings-general(asar 内命中,含独立 LICENSE/包目录)。本机已经把 ui-settings(dsh-client-ui-settings)的 config.enabled 设为 false,方向上与 ds-bot 的做法一致,故冲突面很小;但语义要清楚:装 ds-bot 后,原生设置抽屉的「通用」页会消失,改由 Bot 的 Settings 对话框渲染。
已装 38 个插件中没有任何一个的 cordis.patch.yml 引用 ui-settings-general(grep -rl ui-settings-general --include=cordis.patch.yml . 在 profile node_modules 下 0 命中),因此不存在"别的插件往这个设置页挂面板、被 ds-bot 一并关掉"的连带损失。
7.5 双挂载陷阱(必须避免)
- 若既用
dsh plugin add ds-bot(→ 进dsh.profile.bundles),又在 profile 的cordis.patch.yml手写- insert: [{id: bot, name: ds-bot}],bot会被实例化两次 → 两套web-search路由、两个 settings 座位,connection.fetch.register可能触发重复路由注册。 - 正确姿势:只用一个通道。本机建议走 bundle 通道(CLI),profile patch 保持不动。
8. 风险清单与最小补丁
按"是否阻断安装"排序。无阻断项。
| # | 级别 | 风险 | 证据 / 说明 | 最小补丁 |
|---|---|---|---|---|
| R1 | 中 | 版本漂移:宿主 0.2.1-rc.5 < ds-bot 自测基线 0.2.2-rc.1(低一个 rc) | README.md:7 "Tested with dsh 0.2.2-rc.1 (Web and Desktop)";peerDeps 全 * 无闸门 |
已用 §5 的服务/方法比对覆盖;残留面是 client 半边(1.7 MB 预打包 JS)对虚拟模块 dsh-client-ui-primitives 的运行时假设,只能靠实际启动验证 |
| R2 | 中 | web 搜索行为改变:- id: web 被覆盖为 searchProvider: auto + fetchProvider: http |
ds-bot patch:16–19;配置覆盖是整段替换 | 装后若 web_search 报错:在 profile patch 里加 - id: web / config: {searchProvider: <原值>, fetchProvider: <原值>}(profile 层最后应用,优先于 bundle 层) |
| R3 | 中 | 原生设置页被接管:ui-settings-general 被 disable |
ds-bot patch:24–25;宿主包 @deepseek-ai/dsh-client-ui-settings-general |
profile patch 加 - id: ui-settings-general / disabled: false;同时需接受 DS Bot settings shell 与原生壳并存 |
| R4 | 高(人为) | 双挂载:bundles + 手写 insert 并存 | §7.5 | 只用 CLI;若已手写,删除 profile patch 中的 bot insert |
| R5 | 高(人为) | peer 自动安装:若把 autoInstallPeers 改 true,会装出第二份 cordis / dsh-*(npm 上 cordis@latest=4.1.0、dsh-llm@latest=0.0.1-rc.1 stub) |
pnpm-workspace.yaml: autoInstallPeers: false;npm dist-tags 实测 |
保持 autoInstallPeers: false;pnpm why @deepseek-ai/cordis 应只指向宿主 |
| R6 | 中 | 宿主 nightly 自动升级:升到 0.2.2+ 后 ds-bot 的 API 假设可能变化(也可能变好) | app-update.yml: channel: nightly |
升级后复跑本报告 §5 的比对脚本;升级前在插件市场禁用 ds-bot |
| R7 | 低 | profile 体量:已 36 deps / 38 bundles,ds-bot 再引入 122 文件 | — | 装后 du -sh node_modules/ds-bot 记录增量 |
| R8 | 低 | 网络:curl/git https 不可用 | 本次 node fetch 成功 → registry 可达,pnpm 应可用;若 pnpm 走代理失败,退回本地 tarball(附录 A.2) |
— |
| R9 | 低 | 无类型层证据:asar 内 0 个 .d.ts |
§2.3 | 结论强度按 JS 源码计;建议装后用 dsh plugin --profile desktop why ds-bot + 启动日志核验 |
| R10 | 低 | web-search 的密钥路径:searchProvider: auto 走"当前会话路由自带的 key",否则无 key 的结果页兜底 |
ds-bot patch:6–9、README "Web search" | 若所在会话用第三方 provider,auto 可能取不到 key → 显式配 deepseek-official |
8.1 需要的最小补丁(若安装后出问题)
按症状对症,改动都发生在 profile 层(最后应用,可覆盖 bundle 层),不动 ds-bot 包本身:
| 症状 | 补丁(追加到 profiles/desktop/cordis.patch.yml) |
|---|---|
每次 web_search 都失败 |
- id: web-search-auto / disabled: true,并且给 - id: web 配一个非 auto 的 searchProvider(两者必须同时做,见 ds-bot patch:13–15 的警告) |
| 设置页消失不可接受 | - id: ui-settings-general / disabled: false |
| 想整体停用但不卸载 | 在插件市场禁用,或 profile patch 加 - id: bot / disabled: true(保留 bundles 中的记录) |
9. 回退方案(禁止批量备份目录)
9.1 原则
- 不建备份目录、不复制
node_modules、不cp -rprofile。 - 优先用版本控制与包管理器自身的可逆操作。
- 本项目仓库(
C:\Users\qyh15\三省六部)只跟踪docs/p0/*这类文档与大文件清单;profile 不在本仓库内,因此 profile 侧的回退靠"装之前只留 1 个.bak"。
9.2 安装前的唯一允许备份(若决定手改而不是走 CLI)
只有在你放弃 CLI、选择手工编辑时,才需要:
cd /c/Users/qyh15/.dsh/profiles/desktop
cp package.json package.json.bak # 单个文件
cp cordis.patch.yml cordis.patch.yml.bak # 单个文件
共 2 个 .bak,都是单文件、同目录、无目录复制。走 dsh plugin add 时连这两个都不需要(pnpm 自己维护 pnpm-lock.yaml,且 bundles 可随时重算)。
9.3 回退步骤(推荐路径:CLI 安装)
# 1) 卸载包(forward 给 pnpm remove)
"<...>/resources/runtime/cli/bin/dsh.cmd" plugin --profile desktop remove ds-bot
# 2) 重启 DSH Desktop(宿主启动时按已装包重新对账 dsh.profile.bundles,ds-bot 条目自动消失)
# 3) 校验:两处都不应再出现 ds-bot
grep -n "ds-bot" /c/Users/qyh15/.dsh/profiles/desktop/package.json # 期望无输出
grep -n "ds-bot" /c/Users/qyh15/.dsh/profiles/desktop/cordis.patch.yml # 期望无输出
9.4 回退步骤(手工安装路径)
cd /c/Users/qyh15/.dsh/profiles/desktop
cp package.json.bak package.json # 覆盖回原样:dependencies + bundles 一起复原
cp cordis.patch.yml.bak cordis.patch.yml # 仅在手工改过 patch 时
# 然后用 profile 自带的 pnpm 重装依赖
pnpm install --frozen-lockfile || pnpm install
9.5 回退后的验收清单
| 检查 | 期望 |
|---|---|
package.json 的 dsh.profile.bundles 条数 |
回到 38 |
package.json 的 dependencies 条数 |
回到 36 |
node_modules/ds-bot |
不存在 |
| 宿主启动日志 | 无 bot / ds-bot 相关报错 |
ui-settings-general |
设置页恢复(若曾因此消失) |
web_search |
行为回到装前(若曾覆盖 - id: web) |
10. 结论
- 宿主 DSH = 0.2.1-rc.5(asar
dsh/package.json+ exe VersionInfo 双证)。 - 5 个 peerDeps 逐项 satisfied,但区间全是
*,不构成任何版本保障;5 个包由宿主 asar 提供,profile 不应也不需安装,必须保持autoInstallPeers: false。 - 8 个 inject 服务 8/8 存在,被调用的 9 处方法(
create/list/page/projections/prompt/selectModel/resolveAgent/rename/connection.fetch.register)签名与返回形状全部对齐;软依赖skills/schedule/jobs/goals也齐备。 - npm 已发布
ds-bot@0.3.2(latest,2026-11-09T09:56:14Z,integrity 已记录),无需本地 tarball;本地 6.1 MB 包是 GitHub 归档,与 npm 包不同源。 - 推荐安装方式:
dsh plugin --profile desktop add ds-bot@0.3.2(一条命令完成依赖 + bundles 对账,不手改 profile 文件)。 - 风险可控:无阻断项;需人为守住的是 R4(双挂载)与 R5(peer 自动安装),需产品层面确认的是 R2(web 搜索切
auto)与 R3(原生设置页被接管)。 - 回退成本低:
dsh plugin remove ds-bot+ 重启即可;手工路径最多 2 个单文件.bak,不产生备份目录。
附录 A:安装命令草案(本次未执行)
A.1 registry 路径(推荐)
# 版本固定,避免 latest 漂移
"/c/Users/qyh15/AppData/Local/Programs/DeepSeek Harness/resources/runtime/cli/bin/dsh.cmd" \
plugin --profile desktop add ds-bot@0.3.2
# 校验
"/c/.../runtime/cli/bin/dsh.cmd" plugin --profile desktop why ds-bot
grep -n '"ds-bot"' /c/Users/qyh15/.dsh/profiles/desktop/package.json
dsh.cmd只能写全路径调用(git bash 的PATH里虽有该 bin 目录,但只有.cmd后缀,直接敲dsh报command not found)。
A.2 离线 / 本地 tarball 路径(仅在 registry 不可达时)
# 方案 1:直接装本地包(含 dev/test,比 npm 包大)
"/c/.../runtime/cli/bin/dsh.cmd" plugin --profile desktop \
add file:/c/Users/qyh15/三省六部/.scratch/p0/dsbot-8e0013e077eaeccc137327956e18425e73a5bb8c.tar.gz
# 方案 2:vendor 目录 + link:(保持可编辑,便于打最小补丁)
# 1. 解包到 C:\Users\qyh15\.dsh\vendor\ds-bot\ (该目录同时含 package.json 与 client.js)
# 2. package.json 的 dependencies 写 "ds-bot": "link:../../ds-bot"
# 3. pnpm install
风险:link: 会让宿主加载工作副本,改动即生效,但也绕过了 integrity 校验;仅在离线应急时使用,并把 commit 8e0013e0 记录在案。
A.3 安装后立即验证(建议脚本化)
- 宿主启动日志无
bot相关 error; - 打开 Web GUI(
http://127.0.0.1:8457),侧边栏出现 DS Bot 座位; - 触发一次
web_search,确认走auto未失败; - 打开一次会话,确认
sessionController.create/list正常(新建会话、历史列表); - 确认原生设置「通用」页状态符合预期(被接管 or 已用补丁恢复)。
附录 B:证据文件清单(.scratch/p0/,未纳入提交)
| 文件 | 来源 |
|---|---|
host-package.json |
asar dsh/package.json(17,168 字节有效 JSON;解出文件尾部有重复拼接,解析时按偏移截断) |
asar-index.txt |
asar 18,234 条目清单 |
core-pkgs.txt |
307 个 @deepseek-ai/* 包名 |
host-services.txt |
宿主 88 个 cordis 服务名 |
api-session-controller.js |
@deepseek-ai/dsh-api-session-controller/lib/index.js(3,368 行) |
session-title.js |
@deepseek-ai/dsh-session-title/lib/index.js(652 行) |
client-connection.index.js |
@deepseek-ai/dsh-client-connection/lib/index.js |
core/*.README.md |
dsh-llm / dsh-tools / dsh-web / dsh-scope 的宿主内置 README |
asar-read.cjs / asar-grep.cjs / npm-fetch.mjs |
取证脚本 |
DS-Bot-8e0013e0.../ds-bot/ |
上游固定 commit 解包源码 |
dsbot-8e0013e0....tar.gz |
GitHub commit 归档(6,101,133 字节) |