dsh-sansheng-liubu/docs/p0/compat.md

30 KiB
Raw Blame History

DSH 宿主 × ds-bot 0.3.2 兼容性核查(P0-C)

核查性质:只读。本次未安装 ds-bot,未修改 profile 的 package.json / cordis.patch.yml / pnpm-workspace.yaml,未执行任何 dsh plugin add。 核查对象:ds-bot 上游固定 commit 8e0013e077eaeccc137327956e18425e73a5bb8c,包版本 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.js 1,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>。该命令 "reconciles dsh.profile.bundles against 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 -r profile。
  • 优先用版本控制与包管理器自身的可逆操作。
  • 本项目仓库(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. 结论

  1. 宿主 DSH = 0.2.1-rc.5(asar dsh/package.json + exe VersionInfo 双证)。
  2. 5 个 peerDeps 逐项 satisfied,但区间全是 *,不构成任何版本保障;5 个包由宿主 asar 提供,profile 不应也不需安装,必须保持 autoInstallPeers: false。
  3. 8 个 inject 服务 8/8 存在,被调用的 9 处方法(create / list / page / projections / prompt / selectModel / resolveAgent / rename / connection.fetch.register)签名与返回形状全部对齐;软依赖 skills / schedule / jobs / goals 也齐备。
  4. npm 已发布 ds-bot@0.3.2(latest,2026-11-09T09:56:14Z,integrity 已记录),无需本地 tarball;本地 6.1 MB 包是 GitHub 归档,与 npm 包不同源。
  5. 推荐安装方式:dsh plugin --profile desktop add ds-bot@0.3.2(一条命令完成依赖 + bundles 对账,不手改 profile 文件)。
  6. 风险可控:无阻断项;需人为守住的是 R4(双挂载)与 R5(peer 自动安装),需产品层面确认的是 R2(web 搜索切 auto)与 R3(原生设置页被接管)。
  7. 回退成本低: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 安装后立即验证(建议脚本化)

  1. 宿主启动日志无 bot 相关 error;
  2. 打开 Web GUI(http://127.0.0.1:8457),侧边栏出现 DS Bot 座位;
  3. 触发一次 web_search,确认走 auto 未失败;
  4. 打开一次会话,确认 sessionController.create/list 正常(新建会话、历史列表);
  5. 确认原生设置「通用」页状态符合预期(被接管 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 字节)