Repository navigation
Releases
dsh-craft-anything v0.7.2
[v0.7.2] - 2026-11-17
合并社区 PR #5(作者 @yuran123345678,rebase 合并,署名保留):把状态点配色改回 #4 的原始意图——琥珀 = 这个 chip 正在做事(深度模式 / 桥开启),灰 = 休息状态(净室 / 桥关闭),修掉 v0.7.1 里「桥关才亮琥珀」的读法问题。
变更
- 桥 chip 现在开 = 琥珀、关 = 灰(
data-on="true"点琥珀);模式 chip 不变(深度 = 琥珀、净室 = 灰)。两个 chip 共用同一套「亮 = 热」语言:琥珀标的是「正在生效、有代价」的状态(深度模式会读源码,桥开启意味着mcp__craft__*的 schema 在上下文里),灰是「安静/不做事」。 opacity规则同步:琥珀(热)状态保持不透明,其余 0.85。- 取舍说明(两次改动的原因):v0.7.1 采用的是「琥珀 = 非默认状态」,于是桥关闭时会亮琥珀——作者指出这会让「桥关」看起来像待处理告警,而且和旁边模式 chip 的「亮 = 更能/更费力」相反。接受该论点:琥珀不再承载「非默认」,只承载「正在做事」。默认行里桥 chip 亮着(工具在线)、模式 chip 灰着(不读源码),一眼能看出哪些能力在生效。
- 无行为变化:改的仍是一个注释 + 两个 CSS 选择器;标签、
aria-pressed、点击逻辑、data-on属性都不动。
验证
- PR 分支上独立复跑:
node --check client.js、tests/ui/run.mjs14/14、tests/ui/client-registration.mjs4/4、tests/bridge/run.cjs41 passed, 0 failed(与 PR 里给出的数字一致)。 - 合并后在 main 上再跑同样三套(
scripts/release.ps1另外覆盖node --check与 manifest 校验)。
已知限制
- 视觉仍未做像素级验收:本机运行中的 Harness 加载的是上一次启动的模块,也没有浏览器自动化,「默认态桥 chip 常亮琥珀是否足够安静」要更新 + 重启后在真实界面里确认。
- 这是同一处颜色语义的第二次调整(v0.7.1 桥关亮 → v0.7.2 桥开亮),两个版本的观感相反;如果之后还想同时表达「非默认」和「正在做事」,只能引入第二个颜色 token(例如热 = 品牌蓝、警示 = 琥珀),本轮没做。
Install
dsh plugin --profile desktop add github:Fanqi89/dsh-craft-anything#v0.7.2dsh-craft-anything v0.7.1
[v0.7.1] - 2026-11-16
合并社区 PR #4(作者 @yuran123345678,rebase 合并,署名保留):输入框工具行的两个 Craft Anything 控件(模式、MCP 桥)从带边框的胶囊改成纯文本 + 一个小状态点,不再和旁边的文字抢视觉;风格改动后补了一条配色语义修正,并随本次发版带上 README 顶部的插件图标。
变更
- 两个 chip 改为纯文本 + 小状态点(PR #4):去掉边框、底色和悬停底色,文字用
color: inherit+opacity: .85(悬停恢复label-primary/ 不透明);状态点 7px → 6px,默认灰(border-l2),background 150ms过渡,切状态时能看见但不吵。模式和桥的标签、aria-pressed、点击行为都没变。 - 状态点配色语义(维护者跟进):琥珀色(主题的 warn token)只用于非默认状态——模式 chip 的「深度模式」、桥 chip 的「关闭」;默认的「净室 + 桥开」保持灰点。这样两个 chip 的配色语言一致(灰=默认、琥珀=值得注意),默认状态也不会常驻一个警告色点。同时把状态规则限定为
:not(:disabled),请求进行中时开关仍按:disabled变暗(原先[data-deep="true"]的opacity:1会盖掉:disabled)。 - README 顶部图标:v0.7.0 之后补的 docs 改动(
icon.svg居中 112×112,位于标题与徽章之上),随本版一起打包。
验证
- 合并前在贡献者分支上独立复跑:
node --check client.js、tests/ui/run.mjs14/14、tests/ui/client-registration.mjs4/4、tests/bridge/run.cjs41/41,与其 PR 里给出的数字一致。 - 跟进改动后同样复跑三套测试全绿,
node --check通过;只改 CSS 字符串与一个 data 属性,无逻辑/接口变化。 - 视觉验收限制:本机运行中的 Harness 仍加载上一次启动的模块,且没有浏览器自动化,像素级观感(点的大小、灰/琥珀对比、窄窗口下是否真的更安静)尚未在真实页面里复核,待更新+重启后确认。
已知限制
- 纯文本样式把点击区域压到约 20px 高(
padding: 4px 2px,去掉了边框),桌面端够用,触屏上偏小;如果后续收到误触反馈,再单独把min-height调回 24px。 - 状态点颜色改由
data-deep/data-on两个属性驱动,目前只有client.js消费它们;以后加新 chip 要沿用同一套语义(灰=默认、琥珀=非默认)。
Install
dsh plugin --profile desktop add github:Fanqi89/dsh-craft-anything#v0.7.1dsh-craft-anything v0.7.0
[v0.7.0] - 2026-11-15
处理 issue #3:输入框工具行里的两个 Craft Anything 控件(净室/深度模式开关、MCP 桥开关)现在可以在设置 → Craft Anything 里分别隐藏,窄窗口和手机上不再和别的开关挤在一起。隐藏只针对 composer 控件:模式、桥的状态、mcp__craft__* 工具和插件页都不受影响。
新增
- 设置页「Craft Anything / 输入框开关」:新增
settings.section,两个独立开关(显示中 / 已隐藏),改完立刻生效——隐藏是取消注册那个槽位,不是渲染一个空盒子,所以工具行不会留空位;插件页(MCP 卡)和craft_mode/craft_bridge工具仍然能切换模式和桥。 - 偏好持久化与优先级:设置页写入
<root>\ui.json;Host 新增受鉴权的GET/POST /craft-anything/api/ui路由(guarded(),与其他管理路由同一套 Bearer/Host/Origin 检查)。优先级<root>\ui.json→CRAFT_ANYTHING_COMPOSER_MODE/CRAFT_ANYTHING_COMPOSER_BRIDGE(0/1、false/true、off/on)→ 行配置composerMode/composerBridge→ 默认都显示(升级不会悄悄拿走控件)。报告里带source,设置页和排障都能看出值来自哪一层。 - 无闪烁的首帧:浏览器侧把偏好缓存进 localStorage;有缓存时先用缓存注册槽位,再和 Host 对一次账;没有缓存(首次)则等 Host 第一次回答再注册,所以隐藏过的用户不会先看到控件再消失。读不到 Host(旧版插件 / 无 webServer 的 profile)时回退为两个都显示,行为和以前一致。
host/ui-prefs.mjs单独承载文件格式、优先级合并和路由体,便于单测;package.json#files与dsh.client.inject同步(新增@deepseek-ai/dsh-client-ui-settings)。
验证
tests/ui/run.mjs14/14:默认值、env 解析、行配置与 env 的覆盖关系、ui.json合并写(只改一个键不丢另一个)、设置页优先于 env/config、坏 JSON/恶意结构被忽略、空 patch 不写盘;路由 GET/POST/400/405/HEAD。tests/ui/client-registration.mjs4/4:用假模块加载器 + 假 slots + 假 ui 路由真实执行client.js,断言「只显示桥」「只显示模式」「两个都隐藏后 composer 里一个槽位都不剩但 side/main/settings 仍在」「Host 读失败时两个都显示」。- 回归:
tests/bridge/run.cjs41/41、tests/bridge/bool-schema.mjs7/7、tests/install-cli/run.cjs12/12、tests/restart/run.mjs、tests/update/check.mjs全绿;node --check三个改动文件通过。
已知限制
- 设置页的界面观感只在代码/注册层面验证过(本机 Harness 里加载的是上一次启动的模块,要更新插件并重启 DSH 才会看到新设置页);真实浏览器里的像素级验收留待重启后复核,不在本版声称。
- 隐藏是每台机器一份
<root>\ui.json(外加各浏览器自己的 localStorage 缓存),不是账号级同步;同一台机器的多个浏览器会各自带着本机缓存显示,随后与 Host 对齐。
Install
dsh plugin --profile desktop add github:Fanqi89/dsh-craft-anything#v0.7.0dsh-craft-anything v0.6.1
[v0.6.1] - 2026-11-12
修复 issue #2:core_evidence_browse 的 inputSchema 里有一个布尔子 schema(properties.evidence: true),basalt / LM Studio / llama.cpp server 这类把工具 schema 编译成解码语法的后端会因此让整个请求 400(表现为整轮对话失败,看不出跟插件有关)。同时补上 README 徽章。
修复
- 布尔子 schema 让整轮请求 400(issue #2):JSON Schema draft-07 允许把子 schema 写成布尔(
true≡ 任意值),上游 schemars 对serde_json::Value就是这么生成的;但 llama.cpp 的 schema→grammar 转换器要求每个子 schema 是对象。现在scripts/mcp-bridge.cjs在tools/list出口统一归一化:true→{}、false→{ "not": {} },语义完全等价;additionalProperties的布尔保持不变(实测这些本来就合法)。桥是所有工具列表的唯一必经点,所以以后上游再新增同类字段也会被兜住,不用等上游发版。
新增
- README 顶部徽章:GitRank 评分、DSH(≥0.2.1-rc.2)、DeepSeek Harness 插件库收录、
dsh-plugintopic、最新 Release、MIT 许可证。 - 新增回归测试
tests/bridge/bool-schema.mjs:假 MCP 服务返回evidence: true,断言桥下发{}、additionalProperties: false保持不变、普通 schema 不动。
验证
tests/bridge/run.cjs41/41、tests/bridge/bool-schema.mjs7/7。- 真实 CLI(
--all-tools --deep,321 个工具)过桥后:evidence:true剩余 0 处、evidence:{}1 处(正是core_evidence_browse的那一处);321 个工具里没有其它布尔子 schema。 - 复现口径与 issue 一致:修复前只坏这一个工具,但会让整轮请求失败;修复后按 issue 里的最小对照实验应全部 200。
已知限制
- 只归一化
tools/list下发的 schema;上游 CLI 自身的--json输出不受影响。建议上游也用schemars(schema_with)把该字段渲染成对象(issue 建议的修法 A),桥的兜底只是接入层保险。
Install
dsh plugin --profile desktop add github:Fanqi89/dsh-craft-anything#v0.6.1dsh-craft-anything v0.6.0
[v0.6.0] - 2026-11-11
修复别人机器上一键安装依赖整片失败的问题,并按需求把下载改成"最快镜像优先、官方源兜底",把原来只能复制命令的依赖也变成点一下就装。
修复
- Windows 一键安装 CLI 报
Invoke-WebRequest : InvalidOperation(截图问题):install-cli.ps1只用Invoke-WebRequest下载,在 TLS/代理/受限网络下直接抛错;现在优先用系统curl.exe(--retry、超时、--ssl-no-revoke),没有 curl 才回退 IWR 并显式打开 TLS 1.2;错误信息不再因为 PowerShell 用 ANSI 代码页输出而变成乱码(Host 用 UTF-8 控制台包装执行,脚本自己设置[Console]::OutputEncoding)。 - 最新版本解析有备用路径:
api.github.com不通时改为读github.com/.../releases/latest的 302 Location(curl),两者都不通才提示用-Version vX.Y.Z。 - 「Neither npm nor the Harness pnpm wrapper was found」:pnpm 探测不再只看
dirname(process.execPath),而是从process.resourcesPath、process.argv[1]里的resources/app.asar/...反推 Harness 安装目录;Windows 上两者都缺时先用winget install OpenJS.NodeJS.LTS装 Node,再用新装 npm 装 Claude Code;npm 安装走镜像/官方两个 registry 逐个重试。 - Ghidra 的连锁失败:CLI 装好后 Ghidra 的一键安装才有意义,本次随 CLI/npm 修复一起消失;Ghidra 仍优先复用本机安装。
新增
- 镜像源优先 + 官方兜底(GitHub 下载):新增
scripts/mirrors.mjs;默认候选 ghfast.top / gh-proxy.com / ghproxy.net / mirror.ghproxy.com,先对SHA256SUMS.txt发 range 请求测延迟,按最快排序、官方 github.com 永远排最后;每个候选下载后都要过 SHA256SUMS 校验,校验失败或下载不完整就换下一个源,全部失败才报错并列出每个源的失败原因。可用CRAFT_ANYTHING_GITHUB_MIRRORS覆盖候选(逗号分隔)。 - npm registry 镜像:
registry.npmmirror.com与官方registry.npmjs.org先测/-/ping延迟,快的先装、失败换下一个(可用CRAFT_ANYTHING_NPM_REGISTRY覆盖)。 - 复制命令 → 一键安装:Chromium、Java、GDB 从"只能复制命令"改成
auto: true,Windows 走 winget(Chromium/Chrome、Temurin 21、MSYS2 里的 mingw gdb),macOS 走 brew,Linux 走 apt(必要时 sudo -n);安装失败时页面上会同时出现「复制命令」按钮,不会变成死路。
验证
tests/install-cli/run.cjs12/12(镜像改造后仍全绿,含 sha 不匹配、资产缺失、无 CLI、CRAFT_ANYTHING_CLI短路、元数据失败回退)。- 真实 v0.6.0 资产 dry-run:镜像测速后按顺序给出下载源,官方源兜底;所有候选都失败时会打印每个源的失败原因(本机实验:镜像不可达 → 直接落到 github.com)。
node --check:host/index.js、client.js、scripts/install-cli.mjs、scripts/mirrors.mjs、restart-dsh.mjs、mcp-bridge.cjs 全部通过;PowerShell 脚本用 AST 解析 0 语法错误。
已知限制
- Ghidra 本体由上游 CLI 自己下载(
engines_install),镜像只覆盖本插件自己的下载;上游 CLI 的下载源无法从插件侧替换。 - winget/brew/apt 属于系统包管理器,速度取决于它们的源,插件不代理;失败时仍给出复制命令。
- 镜像只是传输层:内容永远以 SHA256SUMS 为准,镜像无法替换成别的二进制。
Install
dsh plugin --profile desktop add github:Fanqi89/dsh-craft-anything#v0.6.0dsh-craft-anything v0.5.1
[v0.5.1] - 2026-11-11
v0.5.0 的更新/重启链路在两处边界上修正:多实例(独立 DSH_HOME)里的更新只动自己那个 profile;从命令行启动的 DSH 重启后仍然是同一条 CLI 服务,而不是弹出一个桌面窗口。
修复
- 更新会改错 profile(多实例):
findProfile()原来只看~/.dsh/profiles,因此在独立DSH_HOME(探针/测试实例)里点「立即更新」会去改默认 home 里的 profile。现在优先用DSH_HOME定位 profiles,更新只落在点击按钮的那个实例。 - 命令行启动的 DSH 重启成了桌面窗口:
dsh web --profile X --port N是用DeepSeek Harness.exe+ELECTRON_RUN_AS_NODE跑cli.js,process.execPath是 app 二进制;原启动命令只写回[exe],重启会打开 GUI。现在识别 CLI 模式,用[exe, cli.js, --profile X, …原参数]重新拉起,并避免重复追加已经在 argv 里的--profile(重复会让 commander 直接退出)。 - 第二次重启被误拒:helper 成功后没有清理
<root>/restart.pending.json,120 秒内的下一次重启会被当成"已在重启中"。现在把 pending marker 传给 helper,成功拉起后删除。
验证
- 探针实例(独立
DSH_HOME、隔离插件数据 root、端口 51235)走完整页面链路:0.4.0 副本 → 「检查更新」显示 有新版本 v0.5.0 → 弹窗「先 v0.4.0 → v0.5.0 + 更新说明」→ 「立即更新」→ pnpm 安装 49.8 s、profile 依赖变为github:Fanqi89/dsh-craft-anything#v0.5.0→ 自动弹出「重启 DeepSeek Harness?」→ 「立即重启」→restart.log记录the Harness stopped/relaunched pid 6980,新进程在同一端口监听(HTTP 401 = 服务已起),profile 仍为probe。 - 回归:桥
41/41、安装器12/12、重启 helper(stand-in 进程,含 pid 已消失路径)全绿、tests/update/check.mjs全绿。
已知限制
- 重启后端口可能变化;桌面版会重新打开窗口,CLI 版沿用原端口(若端口被占用则新进程会换端口,日志里能看到)。
- 走 GitHub 的更新仍需要 GitHub 可达(直连或
HTTPS_PROXY/env.json)。
Install
dsh plugin --profile desktop add github:Fanqi89/dsh-craft-anything#v0.5.1dsh-craft-anything v0.5.0
[v0.5.0] - 2026-11-11
回应 B 站实测视频(BV13n4J6yEhY)与来信里提到的两个问题:模式切换不再打断在途调用、Linux/macOS 一键安装 CLI 修好(并支持手动指定 CLI 路径);同时按需求在环境卡加了「检查更新」按钮:查 GitHub 最新版本 → 一键安装 → 询问是否重启 DSH。
修复
- 模式切换打断在途调用(来信 1):v0.4.0 及以前写
mode.json后启动器直接退出,dsh-mcp-client重连,切换瞬间正在执行的tools/call会失败、工具列表短暂消失。v0.5.0 把scripts/mcp-bridge.cjs改成常驻的 MCP stdio 服务:检测到模式变化后先 drain 已转发未回包的请求(默认最多 20 秒,CRAFT_ANYTHING_DRAIN_MS可调),期间的请求排队,然后按原有「双 SIGTERM → SIGKILL → 2.5 秒兜底」只替换 CLI 子进程,自己完成新子进程的initialize/initialized/tools/list握手(内部 id 永不下发 DSH),按原 id 重放排队与超时请求,最后发notifications/tools/list_changed。DSH 不重连、在途调用照常拿到结果;子进程意外退出也会自动重拉,没有子进程时请求返回-32603而不是挂死。 - Linux 一键安装 CLI 报错(视频 1):v0.1.x 的
package.json#files根本没打包scripts/install-cli.mjs,非 Windows 上runCliInstaller()只会抛 "installer script is missing"(视频里的现象)。install-cli.mjs重写为:从 release 元数据解析资产名(craft-anything-<ver>-linux-{x86_64,aarch64,riscv64}.tar.gz/ macOS universal zip,元数据失败时回退构造名)、SHA256SUMS 强校验、递归查找任意嵌套目录里的craft-anything-cli(优先)或craft-anything、每个失败路径都给出可复制的回退命令;CRAFT_ANYTHING_CLI已指向可用 CLI 时直接返回(不下载)。 - Linux 模式开关不生效(视频 2):视频测的是 v0.1.x,当时启动器只发一次 SIGTERM 而 CLI 故意忽略第一次;v0.2.0 已改成双 SIGTERM + SIGKILL + 2.5 秒兜底。v0.5.0 的桥内热切换进一步不再依赖 DSH 重连,三个平台走同一代码路径。
dsh.plugin.json补上 v0.4.0 漏登记的craft_bridge工具。- 页面「CLI 路径」写入的
CRAFT_ANYTHING_CLI现在参与 Host 的 CLI 发现(以前只影响子进程)。
新增
- 检查更新(页面按钮):环境与依赖卡顶部、「一键补齐可自动项」右边新增「检查更新 / Check for updates」,显示当前版本;点击查 GitHub 最新 Release,有新版本弹出确认框(当前 → 最新、Release 说明),确认后在插件所在 profile 里执行
dsh plugin --profile <p> add github:Fanqi89/dsh-craft-anything#v<tag> --config.minimumReleaseAge=0(固定标签),完成后弹「是否重启 DSH」,点是则由分离 helper 结束主进程并重新拉起。路由:GET/POST /craft-anything/api/update、POST /craft-anything/api/restart,与既有路由同一套鉴权。无网/限流/找不到 profile 只影响报告,不会改动已安装版本。 - 环境卡「CLI 路径」输入框:把已有
craft-anything-cli的路径写进<root>/env.json,Host 发现、安装器、MCP 启动器统一生效。 - 上下文开销提示:桥卡显示
visible / total与估算 token;>60 个工具时提示可点「仅核心 / 仅调查流程」收窄。 - 桥的
mcp.state.json增加switching、pendingCalls、restarts、lastSwitchAt、lastRestartReason;GET /api/bridge同步返回切换状态;写入<root>/mcp.restart会用同一模式重启子进程(重装 CLI 后自动生效)。
兼容性
engines.dsh仍为>=0.2.1-rc.2;新代码只用既有webServer/connection/ 工具注册 API。- 桥的
start()签名、bridge.json语义、导出都不变,cordis.patch.yml的启动器无需修改。 - 更新走 DSH 自带 CLI(
<app>/resources/app.asar/.../dsh-desktop-host/lib/cli.js+ELECTRON_RUN_AS_NODE),不要求 PATH 上有dsh;可用CRAFT_ANYTHING_DSH_CLI覆盖。
验证
- 桥:
node tests/bridge/run.cjs41/41(5 次连跑全绿):切换期间在途调用照常返回、期间的请求排队后被重放、桥 pid 全程不变、内部 id 零泄漏、list_changed只发一次、drain 超时后同 id 重放且只回答一次、无子进程时-32603、mcp.restart重启同模式、bridge.json过滤/关闭/恢复;真实 CLI 冒烟 clean 30 → deep 38 → clean 30(225/228 ms,桥 pid 不变)。 - 安装器:
node tests/install-cli/run.cjs12/12(Linux tar.gz 嵌套 FHS 布局、macOS zip、SHA256 不匹配、资产缺失、SHA256SUMS 缺项、无 CLI、CRAFT_ANYTHING_CLI短路、元数据失败回退、--dry-run、缺 curl、--force);真实 v0.6.0 API dry-run 解析出craft-anything-0.6.0-linux-x86_64.tar.gz/craft-anything-cli-0.6.0-macos-universal.zip。 - 更新:
node tests/update/check.mjs全绿(版本比较、GitHub 最新 Release、profile 发现);tests/update/install-probe.mjs用真实 DSH CLI + pnpm 把 v0.4.0 装进一次性 profile(34.1 s):profile 依赖变为github:Fanqi89/dsh-craft-anything#v0.4.0、node_modules里包版本 0.4.0、update.state.json落盘;node tests/restart/run.mjs对 stand-in 进程验证「停旧进程 → 等退出 → 拉起新进程 → 清理 pending 标记」,含 pid 已消失的路径。 - 页面:中英文、检查更新弹窗、更新进度、重启询问、CLI 路径输入框在 DSH 0.2.1-rc.5 真机页面验证(截图见 PR/发布说明)。
已知限制
- 超时未完成的调用会在新子进程上以同一 id 重放:read-only 工具,理论上可能重复执行一次(换来的是不再报错)。
- 桥内部握手固定
protocolVersion 2025-06-18(dsh-mcp-client协商的版本);DSH 侧自己的 initialize 仍是客户端原始消息。 - 一键更新依赖 GitHub 可达(走系统代理环境变量或
env.json);完全离线时只能手动dsh plugin add。 - 重启会更换 Web 端口,当前页面需要重新打开;进行中的 agent 回合会中断。
- 本机无 Linux/macOS,安装器的非 Windows 分支用
--platform交叉验证(资产解析、下载、校验、解包、安装、失败路径),未执行真实 Linux/macOS 二进制。
Install
dsh plugin --profile desktop add github:Fanqi89/dsh-craft-anything#v0.5.0dsh-craft-anything v0.4.0
[v0.4.0] - 2026-11-08
MCP 桥按需连接:新增桥开关与工具白名单(回应 issue #1「避免 300+ 工具常驻上下文」)。功能行为不变,新增的是可控性。
新增
- MCP 代理(
scripts/mcp-bridge.cjs):启动器不再把 stdio 直接透传给craft-anything-cli mcp,而是经过一个 JSON-RPC 代理。代理按<root>/bridge.json过滤tools/list(隐藏不在白名单里的工具),并对被隐藏工具的tools/call直接返回错误。 - 动态重同步、不重启:
bridge.json变化时代理向 DSH 发notifications/tools/list_changed;dsh-mcp-client订阅该通知并重新listTools()(其 SDK 的onChanged → refreshTools),约 1 秒内上下文里的mcp__craft__*工具就增减完毕。CLI、桥进程与 DSH 都不重启,pid 不变。 craft_bridge工具:{enabled?, allow?}设置或读取状态,返回可见/总数;allow是只支持*的通配符列表,空数组=全部工具。- 页面与输入栏控制:MCP 桥卡新增「MCP 桥开关(开/关)+ 工具计数(visible/total)+ 工具白名单输入框 + 保存 + 预设(全部工具 / 仅核心 / 仅调查流程)」;对话框左下角新增「桥 开/关」chip(order 84,紧邻净室/深度模式开关),中英文双语。
- 新增 HTTP 路由
GET/POST /craft-anything/api/bridge(与 status/mode/env 一样受鉴权守卫)。
设计说明
- 默认仍是开启且全部工具,升级后行为不变;需要省 token 的用户在页面点「关」或用白名单裁剪即可,也可以写
bridge.json。 - 白名单只影响 DSH 上下文里注册的 tool schema,不改变 CLI 内部工具集;需要更多工具时仍用
mcp__craft__list_toolsets/enable_toolset,或用 allow 白名单挑常用组。 - 干净/深度模式切换仍会重启 CLI(上游模式在启动时固定),重启后代理自动重新读
bridge.json。
兼容与回退
- Host 半在 apply 时把代理写到
<root>/mcp-bridge.cjs;启动器最多等 5 秒加载它,加载失败则回退旧的直连方式(升级时序不会把桥弄坏)。 engines.dsh仍为>=0.2.1-rc.2;只用 mcp-client 已支持的notifications/tools/list_changed与 stdio JSON-RPC。
验证
- 独立 node 测试(真实 craft-anything-cli 0.5.0):initialize/tools/list 30 → 白名单
core_investigation_*,core_evidence_*后 5 个、收到list_changed→ 关闭后 0 个且tools/call被拒 → 重开 30 个;mode.json 改动后进程以 0 退出。 - DSH 真机(0.2.1-rc.5):
craft_bridge设白名单后mcp.state.json记录tools:{total:30,visible:5};关闭后工具从上下文消失(调用报 unknown tool),重开后恢复 30 个;两次变更 pid 均保持 8268(未重启)。页面「仅调查流程」预设点击后 visible=18,恢复「全部工具」后 30/30。
已知限制
- 代理是行分帧的 JSON-RPC 转发,不解析工具内容;极大的
tools/list(321 工具约 350KB 单行)仍会一次性缓冲,但正常使用无影响。 - 白名单匹配只支持
*(不支持?/正则);大小写不敏感。
Install
dsh plugin --profile desktop add github:Fanqi89/dsh-craft-anything#v0.4.0dsh-craft-anything v0.3.1
[v0.3.1] - 2026-11-08
安全修复:Web 管理接口接入宿主认证 + Bearer Token + Host/Origin 双校验。功能行为不变。
修复(安全审查意见)
- 管理接口无鉴权:
/craft-anything/api/status、/mode、/env之前任何人都能直接 GET/POST(包括触发 CLI 依赖安装的POST /api/env {"action":"install"})。现在三条路由统一走guarded():- Host 头只接受
127.0.0.1/localhost/::1,否则 403(防 DNS rebinding); - Origin 必须与本地 authority 一致,跨站(含跨域 POST)→ 403(防 CSRF);
- 宿主 connection 准入:浏览器请求必须通过
ctx.connection.requestRejection()(复用 DSH 的 Host/Origin/浏览器会话认证),未认证 → 401; - Bearer Token:启动时
crypto.randomBytes(32)生成,Authorization: Bearer <token>缺失/错误 → 401,比较用timingSafeEqual。
- Host 头只接受
- Token 下发(无用户输入):新增
GET /craft-anything/api/token(本身在 connection 准入之后),状态页自动引导并缓存;Token 同时写入<root>/http.token(0600)供本地 CLI 使用;支持CRAFT_ANYTHING_HTTP_TOKEN(≥32 字符)覆盖。 - 新增配置:
trustedHosts(默认空)与allowNonLoopback(默认 false),只有显式放开时才接受非回环 Host;默认严格回环。 - 前端(client.js):新增
fetchToken()+apiFetch(),所有 status/mode/env 请求自动带 Bearer 并带credentials: same-origin;401 时重新引导并重试一次(覆盖插件重载导致的 Token 轮换)。
验证(Windows,DSH 0.2.1-rc.5,真机)
- 无鉴权
GET /api/status→ 401;无鉴权POST /api/mode→ 401(不再触发模式切换或安装); - 正确 Bearer → 200;错误 Token → 401;
Origin: https://evil.example→ 403;Host: evil.example→ 403; - 状态页(中文/英文)在浏览器里照常加载环境卡、本地安装、MCP 桥;页面内切换模式到深度再切回净室成功(浏览器 POST 带 Bearer + DSH cookie 通过);
- Token 文件 64 hex 字符、位于
<root>/http.token。
兼容性
- 仍为
engines.dsh >=0.2.1-rc.2:@deepseek-ai/dsh-client-connection的requestRejection/admit在 0.2.1-rc.2 与 rc.5 都存在(且 rc.2 与 rc.5 该包内容一致)。 - 非 Web profile(无
webServer)时路由不注册,工具不受影响;connection服务缺失时浏览器请求一律 401(fail-closed),非浏览器请求仍需 Bearer。
Install
dsh plugin --profile desktop add github:Fanqi89/dsh-craft-anything#v0.3.1dsh-craft-anything v0.3.0
[v0.3.0] - 2026-11-07
页面双语 + 环境与依赖一键补齐。功能行为与 v0.2.0 相同,新增的是界面能力和安装自动化。
新增
- 中英文切换:页面右上角「中文 / English」分段开关,切换标题/说明/本地安装/MCP 桥/工作流命令/环境与依赖全部文案,以及模式菜单与对话框左下角模式开关;选择存 localStorage,首次打开跟随浏览器语言。中文文案包含模式菜单、状态说明、环境提示与按钮。
- 环境与依赖卡(按操作系统检查 + 一键补齐):
- 检查项:craft-anything CLI、Chromium 内核浏览器、Claude Code 编码智能体、Ghidra、Java 21+、GDB;核心 / 深度模式两组。
- 判定来源:插件探测 +
craft-anything-cli engines_list --json(与doctor/capabilities同源的 found 路径),结果缓存 2 分钟,页面「刷新」走?full=1强制重查。 - 自动项:CLI(复用 v0.2.0 安装器)、Claude Code(
npm install -g @anthropic-ai/claude-code,Windows 走 npm 的 JS 入口避开npm.CMD的 spawn EINVAL;npm 缺失时回退 DSH 自带 pnpm)、Ghidra(优先把现成GHIDRA_INSTALL_DIR/tools/ghidra_*通过settings_set engines.ghidra.install_dir写进 CLI,几秒完成;没有现成安装才让 CLIengines_install ghidra下载 Ghidra+Java)。 - 手动项:Java / GDB / Chromium 给出当前系统命令(winget / brew / apt),「复制命令」一键复制。
- 后台任务:POST 立即返回 job,页面 2.5 秒轮询显示进度日志与失败原因;安装完成自动刷新状态卡与检查项;顶部「Install all fixable / 一键补齐可自动项」一次处理全部缺失自动项。
- 新增 HTTP 路由
GET/POST /craft-anything/api/env(GET 返回检查项+job 快照,POST{"action":"install","id"}或{"action":"fix-all"})。
修复
- 环境接口首次实现时
report.noteCodes未初始化,GET /api/env 返回 500(Cannot read properties of undefined (reading 'push'))——已初始化并按需写入,状态工具输出保持英文 notes 不变。 npm.CMD在 Node 下直接 spawn 报EINVAL,经cmd.exe又因 /s 去引号失败——改为用 DSH 自带 Node 执行node_modules/npm/bin/npm-cli.js,实测安装 Claude Code 成功并出现在 PATH(%APPDATA%\npm\claude.CMD)。- 页面「刷新」现在绕过 engines 缓存;环境任务完成后自动刷新本地安装卡。
兼容性
engines.dsh仍为>=0.2.1-rc.2;新代码只用既有 API(ctx.inject(['webServer'])路由、普通 Client ESM),0.2.1-rc.2 / 0.2.1-rc.5 / 0.2.2-rc.1 均适用。- 本机实测:DSH 0.2.1-rc.5 + craft-anything 0.5.0,Windows:环境卡 6/6 就绪;Ghidra「缺失 → 点击 Install → 已就绪」真机点击验证;Claude Code 后台安装完成;中英文切换与页面持久化真机验证。
已知限制
- Ghidra 的
engines_install(无现成安装时的 570 MB 下载 + 自带 Java)本次未在本机完整跑通——本机已有C:\tools\ghidra_12.1.4_PUBLIC,走的是「复用现成安装」路径;下载路径按 CLI 自身工具实现编写,需在无 Ghidra 的机器上再验一次。 - macOS/Linux 的自动安装(npm/pnpm、
settings_set)未真机验证;命令均按平台分支编写。 - Claude Code 安装完成后仍需登录(
claude)或配置 API Key,rebuild才能使用;npm 可能提示allow-scripts(claude 的 postinstall 未跑),如遇原生依赖缺失可手动放行一次。
Install
dsh plugin --profile desktop add github:Fanqi89/dsh-craft-anything#v0.3.0