Skip to content

Releases

v0.2.10 — README 重写

Choose a tag to compare

@EvilJoker EvilJoker released this 08 Oct 03:59

v0.2.10 — README 重写 + 文档化 0.2.x 安装流程

📝 主要内容

重写 README,让它反映 v0.2.x 之后的真实安装/升级/排错流程。

之前 README 是为单文件安装("local file: protocol")写的,写完之后没跟上 npm
发布 + postinstall 自动拉 binary 的演进,里面有几个明显事实错误:

旧值 新值
@deepseek-ai/... @ashtonsun/...
local file: protocol — no npm publish npm 包发布,从 npm 安装
EvilJoker/computer-use-linux-nde EvilJoker/computer-use-linux-zte-nde(实际 binary 上游)
computer-use-linux.static-claude-nde-v0.7.7-nde.3-musl computer-use-linux-static-claude-nde-x86_64-unknown-linux-musl
28+ Linux desktop-control tools 21 个(含 setup* 一族,以 tools/list 实返回为准)
硬编码绝对路径 相对路径 bin/<asset> + provider 内部 resolveCommand()

🧭 新章节

  • 它在 DSH 里做什么 —— ctx.computerUse.register 独占 slot 的说明
  • 安装 —— 3 种方式(npm / dsh-market catalog / 本地 file:)
  • postinstall 第一次安装会发生什么 —— GH release 拉取 + SHA 校验 + chmod + smoke
  • 工具表 —— 21 个 tool 的中文用途对照
  • Nde 特有的修复点 —— KWin caption+coords / SnapshotCache / X11 root fallback / NDE_AT_SPI_SCOPE_REQUIRED
  • 升级 —— 二进制升级(binaryTag bump + republish)+ provider 升级(npm semver)
  • 它不做什么 —— 明确本包不编译 binary、不维护 Nde 源码、不兼容多 computer-use provider
  • Troubleshooting —— spawn ENOENT / SHA 不匹配 / entry did not activate / 多个 computer-use provider 冲突

⚙ 技术细节保持不变

  • src/index.ts(含 resolveCommand())无改动
  • cordis.patch.yml mount 写法无改动
  • scripts/install-binary.js postinstall 行为无改动
  • binaryTag 仍是 v0.7.7-nde.3

📦 安装

cd ~/.dsh/profiles/<your-profile>
npm install @ashtonsun/dsh-experimental-computer-use-linux-nde-mcp@0.2.10 --legacy-peer-deps

postinstall 会自动下载 v0.7.7-nde.3 的 musl binary 到
node_modules/@ashtonsun/.../bin/ 并 SHA 校验。

⚠ 关于 0.2.5 的说明

0.2.5 是早期误发布版本,tar 包里错误地打包了 8.9 MB binary(npm bin
字段的副作用)。本版本 0.2.10 的 tar 不含 binary。如果你装到了 0.2.5
跑得起来,但建议升到 0.2.7+ 以减小 npm 包体积、避免破坏 npm publish 的
provenance 签名。

🔗 链接