创造模式（cordis 预设）下所有文件系统技能不可用：Electron asar 破坏了 fs 的 bigint 统计契约

[zrwangems]

环境

项	值
DSH	0.1.7-rc.2
端	Desktop（Electron 打包版，resources/app.asar）
系统	Windows 11 22631 x64
Node	Electron 内置
受影响预设	cordis（创造模式），以及任何自行提供 customSkillDirs 的预设
不受影响预设	standard / ptc / minimal

现象

在创造模式下新建会话：

1. skill 工具本身存在、可调用；

2. 运行时注册的技能一切正常 —— 例如第三方插件注入的 browser-skill，skill("browser-skill") 成功返回；

3. 但所有文件系统技能（C:\Users\<user>\.agents\skills\ 下的用户技能、项目 .agents/skills\ 下的技能）一律失败：

   Error: skill "manage-dsh-configuration" is unknown or no longer available
   

4. 会话上下文里根本没有 <available_skills> 技能目录 —— 不是目录不完整，而是一条都没有。

切到标准模式（standard）后同样的技能立刻可用。也就是说：同一个技能目录，换个预设就活/死两态。

根因

一行配置解析到了 app.asar 内部，而 Electron 的 asar 层不满足 fs 的 bigint 统计契约。

第 1 步：customSkillDirs 落在 asar 里

standard / ptc / minimal 三个预设的 skill-filesystem 行都没有 config；只有 cordis 有：

# presets/cordis.patch.yml
- id: skill-filesystem
  name: '@deepseek-ai/dsh-skill-filesystem'
  config:
    customSkillDirs:
      - !!js process.getBuiltinModule('node:path').join(process.getBuiltinModule('node:path').dirname(process.getBuiltinModule('node:module').createRequire(baseUrl).resolve('@deepseek-ai/dsh-agent-preset/package.json')), 'skills')

该表达式以 baseUrl 为锚解析 @deepseek-ai/dsh-agent-preset，得到的目录：

• Web / npm 安装：…\npm\node_modules\@deepseek-ai\dsh\node_modules\@deepseek-ai\dsh-agent-preset\skills —— 实体目录，一切正常；
• Desktop / Electron：…\resources\app.asar\dsh\node_modules\@deepseek-ai\dsh-agent-preset\skills —— asar 内部。

这解释了为什么该预设的写法在 Web 端多年无事、一到桌面端就失效：同一份代码，只有 baseUrl 的落点不同。

第 2 步：asar 的 bigint 统计被降级

Electron 的 asar 补丁层对 asar 内部路径的 fs.statSync(p, { bigint: true }) 返回 size: number，而真实文件返回 size: bigint。实测：

路径	typeof statSync(p, {bigint:true}).size	fs.watch
Web 实体安装目录	bigint ✅	OK
Desktop asar 内部目录	number ❌	ENOENT ❌

第 3 步：DSH 的 fs 服务做 BigInt 运算 → 抛错

DSH 有包按 bigint 契约调用 stat，例如 @deepseek-ai/dsh-session-persistence-jsonl/lib/index.js：

// L696-697
const held = await handle.stat({ bigint: true });
await stat(path, { bigint: true });
// L1607
stat: (path) => stat(path, { bigint: true }),

拿到 number 后再与 BigInt 混算，抛：

TypeError: Cannot mix BigInt and other types, use explicit conversions

第 4 步：这个错误不是 ENOENT，因此不被吞掉

@deepseek-ai/dsh-skill-filesystem/lib/index.js 的 discoverRoot 只对「路径不存在」类错误做静默跳过：

// list(options) 大致形状
const roots = await this.roots(options.cwd);          // ← 无保护
try { await this.watchManager.observeRoots(roots) }
catch (error) { if (this.disposal !== undefined) throw error; complete = false }
for (const root of roots)
  for (const skill of await discoverRoot(root, this.ctx, this.name))   // ← 无保护
    candidates.push(skill);

TypeError 逃出 discoverRoot，整个 provider 被放弃：

// @deepseek-ai/dsh-skill/lib/index.js L354 / L358
this.ctx.logger.warn(`skill provider "${provider.name}" skipped: ${errorMessage(error)}`);
if (!observation.complete) cacheable = false;

第 5 步：complete=false 直接掐掉整份技能目录

@deepseek-ai/dsh-tool-skill/lib/index.js 发布技能目录前有硬门槛：

// L207-216
const snapshot = ctx.tools.get(skillTool.name, agent) === skillTool
  ? await ctx.skills.snapshot({ … })
  : { skills: [], complete: true };
if (!snapshot.complete) return decision;      // ← 直接返回，一条都不发布

于是技能目录完全不发布（而不是"少几个"）。skill 工具查不到任何名字，全部报 unknown or no longer available；而运行时注册的技能（browser-skill）走 registerProvider 的 runtime 层，不经文件系统，所以照常工作。

完整链路

cordis 预设 customSkillDirs !!js → 解析到 app.asar 内部
  → Electron asar 层 statSync(...,{bigint:true}).size 返回 number
    → DSH fs 服务 BigInt 混算 → TypeError: Cannot mix BigInt and other types
      → 不是 ENOENT，isAbsentSkillPathError 不匹配
        → discoverRoot 抛出（无保护）
          → skill provider "filesystem" skipped，complete = false
            → dsh-tool-skill: if (!snapshot.complete) return
              → 整份技能目录不发布
                → 所有文件系统技能报 unknown or no longer available

最小复现

// 在 Electron 主进程里运行（普通 Node 读 asar 会得到 ENOENT，必须跑在 Electron 里）
const fs = require('node:fs');
const p = '<应用目录>/resources/app.asar/dsh/node_modules/@deepseek-ai/dsh-agent-preset/skills';
console.log(typeof fs.statSync(p, { bigint: true }).size);   // 期望 'bigint'，实得 'number'
fs.watch(p, () => {});                                        // 抛 ENOENT

对照：把同一段代码指向任意实体目录，typeof 为 'bigint'、fs.watch 正常。

验证「预设 vs 技能可用性」的对应关系：

dsh --profile web --dump-config | Select-String -Context 0,8 'skill-filesystem'
# 观察哪些预设的该行带 customSkillDirs —— 只有 cordis 带

影响面

• 桌面端创造模式（以及任何派生自 cordis、继承其 customSkillDirs 的自定义预设）下，用户技能与项目技能全部不可用；
• 不影响 standard / ptc / minimal；
• 不影响运行时注册的技能（插件自带技能）；
• 不影响 Web / npm 安装形态；
• 注意 bundledSkillDir 默认为 undefined（除非设置了 DSH_BUNDLED_SKILL_DIR），所以它不是第二个 asar 根 —— 本问题只由 customSkillDirs 引起。

建议的修法

按优先级：

① 让该预设指向 asar 外的实体目录（推荐，改动最小）

上游其实已经在 Office 技能上用了这个模式：@deepseek-ai/dsh-skill-office 的 assetRoot 指向 resources/runtime/office-skills（asar 之外的实体目录），由 @deepseek-ai/dsh-desktop-host 注入：

// dsh-desktop-host/lib/index.js L80-84
await ctx.plugin(officeSkills, {
  assetRoot: join(dirname(config.source), "office-skills"),   // 实体目录
  node: join(config.source, "dependencies", "node", "bin", "node.exe"),
  cli: join(packageRoot, "lib", "cli.js")
});

把 dsh-agent-preset/skills 同样以实体目录随包分发（或让 customSkillDirs 在解析到 asar 路径时改指 unpacked 副本），问题即消失。

② 让 dsh-skill-filesystem 单根失败不拖垮整个 provider

list() 里对每个 root 的 discoverRoot 加 try/catch：坏根记 warning、complete = false，但其余根照常产出。这样即使某个 root 不可用，用户技能仍然可用。

③ 让 fs 服务容忍 asar 的 bigint 降级

在 stat 包装层把 size 归一为 BigInt（或对 asar 路径跳过 bigint 调用）。覆盖面最广，能一并修掉同类问题。

④ 让技能目录在 !complete 时仍然发布

dsh-tool-skill 目前对不完整快照直接放弃。改为发布已有的条目并标注不完整，可把"全灭"降级为"缺几个"。

个人建议 ① + ②：① 治本且与既有 Office 技能的做法一致；② 把任何单点故障的爆炸半径限制在一个 root 内。

绕过办法（不依赖上游修复）

在自定义预设里把 customSkillDirs 换成一个解析到实体目录的表达式，例如把技能目录随自定义预设包一起分发，再用包内子路径锚定：

- id: skill-filesystem
  name: '@deepseek-ai/dsh-skill-filesystem'
  config:
    customSkillDirs:
      - !!js >-
          (() => { const p = process.getBuiltinModule('node:path');
          const req = process.getBuiltinModule('node:module').createRequire;
          const anchors = [baseUrl, process.env.DSH_PROFILE_DIR === undefined ? undefined : p.join(process.env.DSH_PROFILE_DIR, 'package.json')];
          for (const a of anchors) { if (typeof a !== 'string' || a.length === 0) continue;
          try { return p.join(p.dirname(req(a).resolve('<自定义包名>/filter')), 'skills'); } catch {} }
          throw new Error('<自定义包名>: cannot locate the bundled skills directory'); })()

注意两点：

• 不要写成相对路径（./skills）—— 补丁装载器只把顶层 patch.insert 行的相对 name 改写成 file:// URL，不会递归进 config.plugins，预设内部的相对路径在 0.1.7 下无法解析；用包名子路径引用。
• 该写法故意 fail-loud：解析不到就抛错，让"技能目录丢失"当场可见，而不是静默退化。

相关代码位置

文件	位置	作用
@deepseek-ai/dsh-web-app/presets/cordis.patch.yml	skill-filesystem 行	唯一带 customSkillDirs 的出厂预设
@deepseek-ai/dsh-skill-filesystem/lib/index.js	list() / roots() / discoverRoot	根枚举与发现；discoverRoot 无保护
@deepseek-ai/dsh-skill/lib/index.js	≈L354、L358	provider 抛错 → warn + 跳过；complete 影响缓存
@deepseek-ai/dsh-tool-skill/lib/index.js	L207-216	!snapshot.complete → 不发布技能目录
@deepseek-ai/dsh-session-persistence-jsonl/lib/index.js	L696-697、L1607	bigint stat 调用方，TypeError 来源
@deepseek-ai/dsh-desktop-host/lib/index.js	L80-84	Office 技能的 asar 外实体目录范式（可参照）

---

本文所述现象在 DSH 0.1.7-rc.2 桌面端实测复现；对照实验（同一表达式分别以 Web npm 路径与 asar 路径为 baseUrl 求值）结果如上表。 #

[cxu050760-gif]

补充一条最新版仍然复现的确认（Windows x64，官方桌面版 @deepseek-ai/dsh-desktop 0.2.0-rc.1，nightly 源 2026-09-28 发布；Electron 44.0.0 / Node 24.18.1；profile=desktop；未改动任何 skill 相关配置）。

• 现象一致：创造模式下会话上下文里 <available_skills> 一条都没有；skill <name> 对任何名字都返回 unknown or no longer available；$DSH_HOME/skills 下 17 个 frontmatter 合法的用户技能 + 随包 4 个 cordis-* 技能全部不可见。
• 抛错点可再精确一层：@deepseek-ai/dsh-fs-local/lib/index.js 的 probe() / probeNoFollow() 用 stat(path, { bigint: true })（:239 / :254），随后 pathType()（:213-218）调用 info.isFile()。asar 路径下 Electron 返回的是 BigInt/Number 混合 Stats，isFile() 内部用 Number 掩码与 BigInt mode 运算，即抛 TypeError: Cannot mix BigInt and other types, use explicit conversions。最小复现：对 %LOCALAPPDATA%\Programs\DeepSeek Harness\resources\app.asar\dsh\node_modules\@deepseek-ai\dsh-tool-cordis\README.zh.md 调用宿主 read 工具即报该错；同一工具读普通路径正常。
• 连坐链路确认：@deepseek-ai/dsh-skill-filesystem/lib/index.js:103 对所有技能根是单循环 await discoverRoot(...)，没有 per-root try/catch；isAbsentSkillPathError（:572-577）只认 ENOENT / ENOTDIR / FS_NOT_FOUND / FS_NOT_DIRECTORY；@deepseek-ai/dsh-skill/lib/index.js:346-354 在 provider 抛错时记一条 skill provider "…" skipped 并整条丢弃 → 正常的用户技能根被连坐。
• 跨产品对照：社区桌面端 anywhere-labs/dsh-desktop 已用「禁用 ASAR 打包」（PR #973，2026-09-13 合并；其 issue 创建自定义模型报错 #135 / 执行任务中所有和 Powershell 相关的调用都会触发 unknown_tool 报错 #225 / Third-party plugins cannot expose Web settings sections (WEB_SETTINGS_NAMESPACES allowlist) #903 为同一根因）绕过同类问题；官方桌面版目前仍把运行时放在 app.asar 内。
• 建议（任一即可解决）：① fs 层对 asar 路径避免 { bigint: true }，或对返回的 Stats 做类型归一；② dsh-skill-filesystem 单根失败只丢该根，并把观测标为 incomplete；③ 或把 preset 技能放到实体目录（如 bundledSkillDir）而不是 app.asar 内。

（本报告由本机会话中的 agent 依据实测整理并代为提交。）

[Mercer08572]

Same on my computer.
版本：0.2.0-rc.2
平台：macOS 26（darwin / arm64）

[xu-zhipeng]

补充一个复现环境

Environment / 环境

DSH	0.2.0-rc.2 (desktop app, profile desktop)
OS	macOS 15.7.1 (24G231), arm64
Bundled runtime	Electron 44.0.0, Node 24.18.1, Chrome 152.0.7977.54
Agent preset	cordis (profile default)

[huangbaba1992]

补一条加固建议（fs 侧本身的修复另见 #8445，那边有跨平台最小复现）。

当前 list() 里 discoverRoot(root, …) 没有逐 root 保护：

for (const root of roots)
  for (const skill of await discoverRoot(root, this.ctx, this.name))   // ← 无保护
    candidates.push(skill);

于是一个 root 的非缺失类错误（本例是 asar 的 TypeError → FsError(FS_IO_ERROR)）会让整个 provider 的 list() reject，dsh-skill 捕获后置 cacheable = false 并跳过整个 provider —— 连带把本来已经扫到的候选（用户 $DSH_HOME/skills、项目 .dsh/skills）一起丢掉，而且用户侧完全没有提示，只能靠 skill <name> 返回 unknown 来猜。

建议把 discoverRoot 调用改成逐 root try/catch：失败 root 只记 warning 并跳过，其余 root 的候选照常返回、complete 仅标记为不完整。这样这类宿主兼容问题的影响面可从「全部文件系统技能消失」收缩到「某个 root 不可用」，也让 #8445 那类故障在技能层面表现为可降级而不是全灭。