Claude Desktop Linux 补丁套件解密Cowork 分发链路中的.asar路径守卫机制、起源与官方 deb rebase 命运【免费下载链接】claude-desktop-debianClaude Desktop for Linux项目地址: https://gitcode.com/GitHub_Trending/cl/claude-desktop-debian本篇技术指南以仓库中的补丁档案文档docs/reports/CDL-ANT-0009_patch-suite-history/dossiers/asar-guards.md为核心主体深入剖析 claude-desktop-debian 项目在 v2.x 时代为修复Electron 把app.asar误当作待打开文件这一根因问题而引入的两个 JS 级守卫补丁——patch_asar_path_filter()与patch_asar_argv_file_drop_guard()。读完本文你将理解 ASAR 虚拟文件系统VFSshim 的isDirectory()/existsSync()语义偏差如何引发权限弹窗、强制 Cowork 模式与--add-dir致命错误掌握针对压缩混淆 JS 的动态锚点正则、幂等性守卫与唯一性断言的实战写法并了解这些守卫在 v3.0.0 官方 deb rebase 中被判删除的字节级证据与推理过程。背景为什么一个.asar路径会被误判为文件夹拖放根因launcher 重复向 Electron argv 注入app.asar四个 legacy 启动器deb、rpm、appimage、nix都曾把app.asar的完整路径追加到 Electron 的 argv 上——尽管 Electron 本来就会自动加载同目录resources/app.asar。于是这个冗余参数以要打开的文件身份进入应用该结论由 PR #700 的根因复盘事后确认上游时代对应 v2.0.x 对 Windows 包的重新打包约 1.9255.2。ASAR VFS shim 的两处语义偏差问题之所以表现为文件夹/文件拖放根源在 Electron ASAR 虚拟文件系统 shim 对 NodefsAPI 的模拟语义fs.statSync(path).isDirectory()对.asar归档返回true——因为归档在逻辑上是一个目录容器fs.existsSync(path)对.asar路径同样返回true。于是当 repackaged launcher 把app.asar传给 Electron 的 argv 后应用内部的目录检查 helper 会把它归类为文件夹进而分发给 Cowork 的 folder-drop 路径第二实例 argv 收集器也会把它送进 file-drop 处理器。三个可复现症状记录于当时scripts/patches/cowork.sh头部注释#383每次启动都弹权限对话框app.asar permission.#622每次关闭窗口再重开应用都强制进入 Cowork Mode#632app.asar被当作--add-dir传入在捆绑的 Claude Code ≥ 2.1.111 中触发致命错误No conversation found 循环。机制详解一patch_asar_path_filter()—— 目录检查守卫该函数当时位于scripts/patches/cowork.sh的 28 行附近针对的是目录检查 helper当时构建中的压缩名wFA。它通过 node heredoc 重写压缩后的主进程 bundleapp.asar.contents/.vite/build/index.js采用动态标识符捕获函数名、参数名、fs 变量全部由正则捕获无一硬编码——这正是 docs/learnings/patching-minified-js.md 中记载的 CLAUDE.md 压缩 JS 补丁规则的核心手法。核心锚点正则承载性锚点函数名/参数/fs 变量动态捕获/function\s([\w$])\s*\(\s*([\w$])\s*\)\s*\{\s*try\s*\{\s*return\s([\w$])\.statSync\(\s*\2\s*\)\.isDirectory\(\)/重写结果为return!PARAM.endsWith(.asar)FSVAR.statSync(PARAM).isDirectory()重写被限定在匹配到的函数体内因此不会误伤其他任何statSync调用点。该补丁的幂等性检查是粗粒度的code.includes(.endsWith(.asar))已应用则直接以 0 退出。锚点失配或重写后验证失败则是致命的node 中process.exit(1)、bash 中exit 1——这是刻意设计的响亮失败注释中明确引用了 #383/#622/#632 三个 issue。注释还特别说明此补丁独立于 Cowork 模式守卫运行即使 Cowork 代码缺失该函数依然存在。值得注意的是该补丁在scripts/cowork-patch-markers.tsv中没有对应标记行对照 main 分支的标记名清单验证过asar 类行只有asar-adddir-filter和asar-file-drop-guard两条前者属于 config.sh 的兄弟守卫家族。机制详解二patch_asar_argv_file_drop_guard()—— argv 文件拖放守卫该函数当时位于scripts/patches/cowork.sh的 128 行附近针对的是第二实例 argv 文件拖放收集器该构建中的lKr。它有一个独立分支if (!i.startsWith(-) FSVAR.existsSync(i)) { A.push(i); }由于 ASAR shim 让existsSync()对.asar路径返回trueapp.asar通过了检查并被送往文件拖放处理器cCA导致每次关闭窗口并重开都出现权限提示头部注释#383、#622 在 v2.0.16 回归。两级幂等性与唯一性断言该补丁的幂等性设计比前者精细采用两级检查bash 层grep -qP匹配守卫在上下文中的形态——\.startsWith\(-\)\s*\s*![\w$]\.endsWith\(\.asar\)。注释明确说明当时 cowork.sh:131-135这个 grep 刻意锚定startsWith以避免来自其他 .asar 守卫如 statSync 补丁或 --add-dir 过滤器的误报匹配。node 层匹配正则/(![\w$]\.startsWith\s*\(\s*-\s*\)\s*\s*)([\w$])\.existsSync\(\s*([\w$])\s*\)/并附带显式唯一性断言对转义后的完整匹配做全局再 grep匹配数 1 即为致命错误。注入内容是在existsSync调用前插入!PARAM.endsWith(.asar)随后做容空格whitespace-tolerant的验证。威胁模型注释精确后缀匹配是刻意选择后续修订新增了一条威胁模型注释见下文 Revision history解释为何采用精确后缀、大小写敏感的.asar匹配是刻意决策argv 路径确实可通过用户启动Exec... %u桌面条目触达但唯一的 sink 是附加到草稿dispatchOnCoworkFromMain - selectedFiles——没有内容读取、没有特权边界、没有路径穿越 sink因此toLowerCase()加固被明确否决。这一以 sink 决定加固强度的思路值得任何补丁作者借鉴。与补丁套件其他层的配合TSV 标记与验证链路该补丁在验证体系中拥有专属标记asar-file-drop-guard行记录于scripts/cowork-patch-markers.tsvmain 分支 37 行由当时的scripts/verify-patches.sh、tests/verify-patches.bats以及 CI 的静态 grep 步骤.github/workflows/build-amd64.ymlissue #559 D6共同消费。这与 docs/learnings/patching-minified-js.md 中记载的四层验证模型构建日志 → 语法有效性 → asar 标记 → 运行时完全对应标记层验证的是结构而运行时层验证行为。起源三个 issue、两个 PR、一条根因链patch_asar_path_filterPR #640提交6bfb296d5cf2f66619f1ded2dc55b8d6402715332026-05-24作者 aaddrick主题 fix(patches): reject .asar paths in directory check to prevent false Cowork dispatchtrailer Fixes #383, #622, #632以 PR #640 合并2026-05-24T21:00:39Z。动机 issue#3832026-04-06awake4realapp.asar permission.——每次启动的权限弹窗恰好在 PR #640 合并时间戳被关闭#6222026-05-17mathys-lopinto——每次关闭窗口重开后应用都进入 Cowork Mode#6322026-05-22beneshengineering——app.asar被当作--add-dir捆绑的 claude-code 2.1.111 中致命No conversation found 循环。PR #640 正文声明单一根因ASAR VFS shim 对归档报告isDirectory() true把app.asar送进了 Cowork folder-drop 路径。patch_asar_argv_file_drop_guardPR #669提交623f1b03731a0bfe80660376e6711a5be71120b92026-05-29作者 Mitch/MitchSchwartz以 PR #669 合并Fixes #668。#6682026-05-29MitchSchwartzapp.asar still reaches file drop handler on every cowork screen focus — incomplete fix after #640/#650 (v2.0.16, KDE, X11)。提交正文解释缺口启动扫描通过路径相等检查tA.resolve(n) ! appPath排除了应用包但第二实例处理器把 argv 直接交给lKr()没有任何等价守卫。该提交针对 v2.0.16上游 1.9255.2提取的 index.js 做过验证并同时新增了asar-file-drop-guardTSV 标记。修订史5772cc1的容空格修复提交5772cc12026-06-04whitespace-tolerant verify correct threat-model comment for #668 guard修复了一个典型的美化输入假阴性beautified false-negative问题node 匹配正则已容忍周围空白但 bash 幂等性 grep、node 验证正则和 TSV 标记模式没有导致在美化后的输入上错误报告 not patched、验证可能失败。修复方式是在三处统一加\s*同时删除了一条无意义的cd $project_root位于无条件exit 1之前并重写了威胁模型注释。这正是 docs/learnings/patching-minified-js.md 中美化输入假阴性陷阱一节的现实案例。承重上下文PR #700 与 a4b8511ab17b69PR #700emandel822026-06-09——stop passing app.asar as an Electron arg in all launchers这是 #696以及追溯性的 #668/#383的根因修复。PR 正文明确把 #640/#650/#669 这批 JS 侧守卫定位为在 launcher 持续注入路径的同时修补接收方。a4b85112026-06-09——仅在 deb/rpm 的 global-Electron 回退分支恢复显式 app 路径PATH 解析出的electron启动 default_app此时位置参数形式的 app 路径是承重的。main 分支的scripts/packaging/deb.sh:119把该路径设为.../resources/app.asar因此 #700 之后回退分支是.asarargv 可能存在的唯一剩余路径——守卫在 #700 之后继续留在套件里主路径上是纵深防御回退路径上可能承重——后者是推断无提交声明。83ea637PR #7362026-06-23yukonSilver 重推导大改 cowork.sh但未修改任一守卫函数行范围历史无命中TSV asar 行仅以上下文行出现。问题与 PR 时间线速查编号类型状态说明#383issueCLOSEDapp.asar permission.推动 path_filter由 PR #640 关闭#622issueCLOSED每次关闭窗口重开都进 Cowork Mode由 PR #640 修复#632issueCLOSEDapp.asar被当作--add-dirclaude-code 2.1.111 致命由 PR #640 修复#640PRMERGED (2026-05-24)引入 patch_asar_path_filter提交 6bfb296#668issueCLOSED#640/#650 后不完整修复的回归报告推动 argv 守卫#669PRMERGED引入 patch_asar_argv_file_drop_guard提交 623f1b0#696issueCLOSED (2026-06-04)v2.0.18 更新后任务栏重开仍出现附加提示暴露 launcher argv 为根因#700PRMERGED (2026-06-09)停止在所有 launcher 中传app.asar参数移除守卫主要触发器兄弟守卫家族同一根因、不同分发点当时位于scripts/patches/config.sh#649额外目录路径绕过 #640 守卫、#650patch_asar_additional_dirs_guard/patch_asar_trusted_folder_guardasar-adddir-filter标记、#685addTrustedFolder 锚点修复、#718/#723上游 1.12603.1 构建失败——唯一性断言误触改为放宽恰好-1 假设、#736yukonSilver 重推导未触及本单元。官方 deb rebase 后的命运判删除的字节级证据在 v3.0.0 迁移到 Anthropic 官方 Linux.deb的 rebase 中本单元的裁定是无条件删除。判定行docs/learnings/official-deb-rebase-verification.md 工作树 26 行原文为| cowork asar-path guards (#383/#622/#632) |delete| ThestatSync().isDirectory()helpers still exist (3 anchors, no upstream.asarguard), but the official launcher is a bare ELF symlink — noapp.asarargv ever reaches them. The guards existed only because the repackage passed the asar on argv. |三层证据字节级审计tools/patch-necessity-audit.sh 的probe_asar_guards()233-243 行统计官方 1.17377.2index.js中的statSync(try/catch 锚点数量与上游\.endsWith\(\.asar\)出现次数报告 official launcher passes no asar argv, so likely not-needed——上游 helper 自身没有任何.asar守卫。安装布局事实同一文档记载 /usr/bin/claude-desktopis a symlink to../lib/claude-desktop/claude-desktop——一个裸 ELF无 wrapper、无 argv 注入。打包器注释新 deb launcher 由 scripts/packaging/deb.sh 生成直接 exec 官方二进制注释写道 The official Electron binary; it auto-loads the co-located resources/app.asar, so no app path is ever passed (issue #696)。rpm.sh:92与appimage.sh:65有相同注释。且不再有 global-Electron 回退——二进制缺失即硬错误因此 main 分支那条唯一仍传.asarargv 的路径a4b8511 的回退分支也不复存在。工作树中的落地方式提交d9cef9ePhases 12 — acquisition swap ... patch triage2026-07-02把cowork.sh停靠park为 scripts/cowork-fallback/cowork.shdiffstat 显示scripts/{patches cowork-fallback}/cowork.sh | 302 ------在迁移中剥掉了两个 asar 守卫函数只保留patch_cowork_linux验证于该文件 14 行并删除scripts/cowork-patch-markers.tsv-37 行。两个守卫函数被删文件被搬迁。其提交信息把 cowork/.config .asar guards 列入 11 condemned patches deleted。scripts/patches/app-asar.sh 头部声明了 patch-zero 契约the default verdict for any patch is delete, and when the array is empty the official app.asar ships byte-identical (no extract, no repack)。档案撰写时active_patches仅剩patch_quick_window与patch_org_plugins_path两个候选当前工作树已进一步演进为五个成员新增patch_virtiofsd_probe、patch_cowork_bwrap、patch_tray_icon_env_overrideasar 路径守卫不在其中。下游后果记录在 scripts/launcher-common.sh390-396 行进程指纹不能再依赖app.asar——自 #700 起 launcher 不再把它作为参数传递因此 UI 进程检测改用--class$WM_CLASS这一跨 deb/rpm/AppImage/nix 的稳定签名。停靠后的 Cowork 代码仅保留patch_cowork_linux工作树中scripts/与tests/下已无任何endsWith(.asar)守卫残留grep 验证。残余风险矩阵自身指出的残余风险上游 helper 依然没有自己的.asar守卫因此只有当某个未来 launcher 改动重新引入.asarargv 时症状家族才会回归守卫的推导过程保存在 main 分支历史6bfb296、623f1b0中如需可随时恢复。该行不属于文档的 Open items判定无条件。对现代构建与补丁开发的启示即使守卫已被删除这条完整的问题链仍提供了三类可迁移的经验修补接收方之前先找发送方JS 侧守卫#640/#650/#669反复回归的根源是 launcher 持续注入路径——PR #700 的 launcher 侧根因修复才真正终结问题。防御纵深有价值但根因修复才是终止符。压缩 JS 补丁的工程纪律动态标识符捕获[\w$]而非\w$不会被\w匹配、锚点锚定开发者字符串而非压缩名、两级幂等性粗粒度includes检查 上下文锚定 grep、显式唯一性断言1 即致命、容空格的验证正则、以 sink 决定加固强度精确后缀匹配而非toLowerCase()——所有这些都可以在 docs/learnings/patching-minified-js.md 中找到系统化记录包括美化输入假阴性5772cc1 修复的正是这类 bug与引号分隔符不稳定1.26832.0 双引号→反引号的全面翻转等陷阱。字节证据优于代码考古判定一个补丁是否还需要最有力的证据是当前分发路径是否还能触发该缺陷——官方 launcher 是裸 ELF 符号链接、/usr/bin/claude-desktop指向裸二进制、打包器不传任何 app 路径这三条事实合起来比任何源码推理都更有说服力。仓库还提供了可复现的验证工具 tools/patch-necessity-audit.shreport-only抓取官方 APT 池中固定的.deb并 grep 解包后的 bundle以及 tests/test-patch-stage.sh验证二次补丁为 no-op 且重打包 asar 字节一致等测试设施供后续维护者随时复核。档案自身的已知缺口Gaps档案如实记录了未验证项引用时应保持同样的审慎PR #700 之后守卫在 deb/rpm global-Electron 回退中是否严格承重未经证实default_app 模式下 Electron 可能把位置参数消费为 app 路径而非文件打开纵深防御是作者推断。#383 的 24 条评论线程未完整阅读报告到 PR #640 之间的临时 workaround 未验证。#718 完整线程未读与兄弟单元的关联依赖 PR #723 的正文。rebase 判定基于静态字节证据矩阵 审计工具未对真实官方安装做 #383/#622/#632 症状的运行时复现——这与文档的方法论一致静态字节优先。【免费下载链接】claude-desktop-debianClaude Desktop for Linux项目地址: https://gitcode.com/GitHub_Trending/cl/claude-desktop-debian创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Claude Desktop Linux 补丁套件解密：Cowork 分发链路中的 `.asar` 路径守卫机制、起源与官方 deb rebase 命运
Claude Desktop Linux 补丁套件解密Cowork 分发链路中的.asar路径守卫机制、起源与官方 deb rebase 命运【免费下载链接】claude-desktop-debianClaude Desktop for Linux项目地址: https://gitcode.com/GitHub_Trending/cl/claude-desktop-debian本篇技术指南以仓库中的补丁档案文档docs/reports/CDL-ANT-0009_patch-suite-history/dossiers/asar-guards.md为核心主体深入剖析 claude-desktop-debian 项目在 v2.x 时代为修复Electron 把app.asar误当作待打开文件这一根因问题而引入的两个 JS 级守卫补丁——patch_asar_path_filter()与patch_asar_argv_file_drop_guard()。读完本文你将理解 ASAR 虚拟文件系统VFSshim 的isDirectory()/existsSync()语义偏差如何引发权限弹窗、强制 Cowork 模式与--add-dir致命错误掌握针对压缩混淆 JS 的动态锚点正则、幂等性守卫与唯一性断言的实战写法并了解这些守卫在 v3.0.0 官方 deb rebase 中被判删除的字节级证据与推理过程。背景为什么一个.asar路径会被误判为文件夹拖放根因launcher 重复向 Electron argv 注入app.asar四个 legacy 启动器deb、rpm、appimage、nix都曾把app.asar的完整路径追加到 Electron 的 argv 上——尽管 Electron 本来就会自动加载同目录resources/app.asar。于是这个冗余参数以要打开的文件身份进入应用该结论由 PR #700 的根因复盘事后确认上游时代对应 v2.0.x 对 Windows 包的重新打包约 1.9255.2。ASAR VFS shim 的两处语义偏差问题之所以表现为文件夹/文件拖放根源在 Electron ASAR 虚拟文件系统 shim 对 NodefsAPI 的模拟语义fs.statSync(path).isDirectory()对.asar归档返回true——因为归档在逻辑上是一个目录容器fs.existsSync(path)对.asar路径同样返回true。于是当 repackaged launcher 把app.asar传给 Electron 的 argv 后应用内部的目录检查 helper 会把它归类为文件夹进而分发给 Cowork 的 folder-drop 路径第二实例 argv 收集器也会把它送进 file-drop 处理器。三个可复现症状记录于当时scripts/patches/cowork.sh头部注释#383每次启动都弹权限对话框app.asar permission.#622每次关闭窗口再重开应用都强制进入 Cowork Mode#632app.asar被当作--add-dir传入在捆绑的 Claude Code ≥ 2.1.111 中触发致命错误No conversation found 循环。机制详解一patch_asar_path_filter()—— 目录检查守卫该函数当时位于scripts/patches/cowork.sh的 28 行附近针对的是目录检查 helper当时构建中的压缩名wFA。它通过 node heredoc 重写压缩后的主进程 bundleapp.asar.contents/.vite/build/index.js采用动态标识符捕获函数名、参数名、fs 变量全部由正则捕获无一硬编码——这正是 docs/learnings/patching-minified-js.md 中记载的 CLAUDE.md 压缩 JS 补丁规则的核心手法。核心锚点正则承载性锚点函数名/参数/fs 变量动态捕获/function\s([\w$])\s*\(\s*([\w$])\s*\)\s*\{\s*try\s*\{\s*return\s([\w$])\.statSync\(\s*\2\s*\)\.isDirectory\(\)/重写结果为return!PARAM.endsWith(.asar)FSVAR.statSync(PARAM).isDirectory()重写被限定在匹配到的函数体内因此不会误伤其他任何statSync调用点。该补丁的幂等性检查是粗粒度的code.includes(.endsWith(.asar))已应用则直接以 0 退出。锚点失配或重写后验证失败则是致命的node 中process.exit(1)、bash 中exit 1——这是刻意设计的响亮失败注释中明确引用了 #383/#622/#632 三个 issue。注释还特别说明此补丁独立于 Cowork 模式守卫运行即使 Cowork 代码缺失该函数依然存在。值得注意的是该补丁在scripts/cowork-patch-markers.tsv中没有对应标记行对照 main 分支的标记名清单验证过asar 类行只有asar-adddir-filter和asar-file-drop-guard两条前者属于 config.sh 的兄弟守卫家族。机制详解二patch_asar_argv_file_drop_guard()—— argv 文件拖放守卫该函数当时位于scripts/patches/cowork.sh的 128 行附近针对的是第二实例 argv 文件拖放收集器该构建中的lKr。它有一个独立分支if (!i.startsWith(-) FSVAR.existsSync(i)) { A.push(i); }由于 ASAR shim 让existsSync()对.asar路径返回trueapp.asar通过了检查并被送往文件拖放处理器cCA导致每次关闭窗口并重开都出现权限提示头部注释#383、#622 在 v2.0.16 回归。两级幂等性与唯一性断言该补丁的幂等性设计比前者精细采用两级检查bash 层grep -qP匹配守卫在上下文中的形态——\.startsWith\(-\)\s*\s*![\w$]\.endsWith\(\.asar\)。注释明确说明当时 cowork.sh:131-135这个 grep 刻意锚定startsWith以避免来自其他 .asar 守卫如 statSync 补丁或 --add-dir 过滤器的误报匹配。node 层匹配正则/(![\w$]\.startsWith\s*\(\s*-\s*\)\s*\s*)([\w$])\.existsSync\(\s*([\w$])\s*\)/并附带显式唯一性断言对转义后的完整匹配做全局再 grep匹配数 1 即为致命错误。注入内容是在existsSync调用前插入!PARAM.endsWith(.asar)随后做容空格whitespace-tolerant的验证。威胁模型注释精确后缀匹配是刻意选择后续修订新增了一条威胁模型注释见下文 Revision history解释为何采用精确后缀、大小写敏感的.asar匹配是刻意决策argv 路径确实可通过用户启动Exec... %u桌面条目触达但唯一的 sink 是附加到草稿dispatchOnCoworkFromMain - selectedFiles——没有内容读取、没有特权边界、没有路径穿越 sink因此toLowerCase()加固被明确否决。这一以 sink 决定加固强度的思路值得任何补丁作者借鉴。与补丁套件其他层的配合TSV 标记与验证链路该补丁在验证体系中拥有专属标记asar-file-drop-guard行记录于scripts/cowork-patch-markers.tsvmain 分支 37 行由当时的scripts/verify-patches.sh、tests/verify-patches.bats以及 CI 的静态 grep 步骤.github/workflows/build-amd64.ymlissue #559 D6共同消费。这与 docs/learnings/patching-minified-js.md 中记载的四层验证模型构建日志 → 语法有效性 → asar 标记 → 运行时完全对应标记层验证的是结构而运行时层验证行为。起源三个 issue、两个 PR、一条根因链patch_asar_path_filterPR #640提交6bfb296d5cf2f66619f1ded2dc55b8d6402715332026-05-24作者 aaddrick主题 fix(patches): reject .asar paths in directory check to prevent false Cowork dispatchtrailer Fixes #383, #622, #632以 PR #640 合并2026-05-24T21:00:39Z。动机 issue#3832026-04-06awake4realapp.asar permission.——每次启动的权限弹窗恰好在 PR #640 合并时间戳被关闭#6222026-05-17mathys-lopinto——每次关闭窗口重开后应用都进入 Cowork Mode#6322026-05-22beneshengineering——app.asar被当作--add-dir捆绑的 claude-code 2.1.111 中致命No conversation found 循环。PR #640 正文声明单一根因ASAR VFS shim 对归档报告isDirectory() true把app.asar送进了 Cowork folder-drop 路径。patch_asar_argv_file_drop_guardPR #669提交623f1b03731a0bfe80660376e6711a5be71120b92026-05-29作者 Mitch/MitchSchwartz以 PR #669 合并Fixes #668。#6682026-05-29MitchSchwartzapp.asar still reaches file drop handler on every cowork screen focus — incomplete fix after #640/#650 (v2.0.16, KDE, X11)。提交正文解释缺口启动扫描通过路径相等检查tA.resolve(n) ! appPath排除了应用包但第二实例处理器把 argv 直接交给lKr()没有任何等价守卫。该提交针对 v2.0.16上游 1.9255.2提取的 index.js 做过验证并同时新增了asar-file-drop-guardTSV 标记。修订史5772cc1的容空格修复提交5772cc12026-06-04whitespace-tolerant verify correct threat-model comment for #668 guard修复了一个典型的美化输入假阴性beautified false-negative问题node 匹配正则已容忍周围空白但 bash 幂等性 grep、node 验证正则和 TSV 标记模式没有导致在美化后的输入上错误报告 not patched、验证可能失败。修复方式是在三处统一加\s*同时删除了一条无意义的cd $project_root位于无条件exit 1之前并重写了威胁模型注释。这正是 docs/learnings/patching-minified-js.md 中美化输入假阴性陷阱一节的现实案例。承重上下文PR #700 与 a4b8511ab17b69PR #700emandel822026-06-09——stop passing app.asar as an Electron arg in all launchers这是 #696以及追溯性的 #668/#383的根因修复。PR 正文明确把 #640/#650/#669 这批 JS 侧守卫定位为在 launcher 持续注入路径的同时修补接收方。a4b85112026-06-09——仅在 deb/rpm 的 global-Electron 回退分支恢复显式 app 路径PATH 解析出的electron启动 default_app此时位置参数形式的 app 路径是承重的。main 分支的scripts/packaging/deb.sh:119把该路径设为.../resources/app.asar因此 #700 之后回退分支是.asarargv 可能存在的唯一剩余路径——守卫在 #700 之后继续留在套件里主路径上是纵深防御回退路径上可能承重——后者是推断无提交声明。83ea637PR #7362026-06-23yukonSilver 重推导大改 cowork.sh但未修改任一守卫函数行范围历史无命中TSV asar 行仅以上下文行出现。问题与 PR 时间线速查编号类型状态说明#383issueCLOSEDapp.asar permission.推动 path_filter由 PR #640 关闭#622issueCLOSED每次关闭窗口重开都进 Cowork Mode由 PR #640 修复#632issueCLOSEDapp.asar被当作--add-dirclaude-code 2.1.111 致命由 PR #640 修复#640PRMERGED (2026-05-24)引入 patch_asar_path_filter提交 6bfb296#668issueCLOSED#640/#650 后不完整修复的回归报告推动 argv 守卫#669PRMERGED引入 patch_asar_argv_file_drop_guard提交 623f1b0#696issueCLOSED (2026-06-04)v2.0.18 更新后任务栏重开仍出现附加提示暴露 launcher argv 为根因#700PRMERGED (2026-06-09)停止在所有 launcher 中传app.asar参数移除守卫主要触发器兄弟守卫家族同一根因、不同分发点当时位于scripts/patches/config.sh#649额外目录路径绕过 #640 守卫、#650patch_asar_additional_dirs_guard/patch_asar_trusted_folder_guardasar-adddir-filter标记、#685addTrustedFolder 锚点修复、#718/#723上游 1.12603.1 构建失败——唯一性断言误触改为放宽恰好-1 假设、#736yukonSilver 重推导未触及本单元。官方 deb rebase 后的命运判删除的字节级证据在 v3.0.0 迁移到 Anthropic 官方 Linux.deb的 rebase 中本单元的裁定是无条件删除。判定行docs/learnings/official-deb-rebase-verification.md 工作树 26 行原文为| cowork asar-path guards (#383/#622/#632) |delete| ThestatSync().isDirectory()helpers still exist (3 anchors, no upstream.asarguard), but the official launcher is a bare ELF symlink — noapp.asarargv ever reaches them. The guards existed only because the repackage passed the asar on argv. |三层证据字节级审计tools/patch-necessity-audit.sh 的probe_asar_guards()233-243 行统计官方 1.17377.2index.js中的statSync(try/catch 锚点数量与上游\.endsWith\(\.asar\)出现次数报告 official launcher passes no asar argv, so likely not-needed——上游 helper 自身没有任何.asar守卫。安装布局事实同一文档记载 /usr/bin/claude-desktopis a symlink to../lib/claude-desktop/claude-desktop——一个裸 ELF无 wrapper、无 argv 注入。打包器注释新 deb launcher 由 scripts/packaging/deb.sh 生成直接 exec 官方二进制注释写道 The official Electron binary; it auto-loads the co-located resources/app.asar, so no app path is ever passed (issue #696)。rpm.sh:92与appimage.sh:65有相同注释。且不再有 global-Electron 回退——二进制缺失即硬错误因此 main 分支那条唯一仍传.asarargv 的路径a4b8511 的回退分支也不复存在。工作树中的落地方式提交d9cef9ePhases 12 — acquisition swap ... patch triage2026-07-02把cowork.sh停靠park为 scripts/cowork-fallback/cowork.shdiffstat 显示scripts/{patches cowork-fallback}/cowork.sh | 302 ------在迁移中剥掉了两个 asar 守卫函数只保留patch_cowork_linux验证于该文件 14 行并删除scripts/cowork-patch-markers.tsv-37 行。两个守卫函数被删文件被搬迁。其提交信息把 cowork/.config .asar guards 列入 11 condemned patches deleted。scripts/patches/app-asar.sh 头部声明了 patch-zero 契约the default verdict for any patch is delete, and when the array is empty the official app.asar ships byte-identical (no extract, no repack)。档案撰写时active_patches仅剩patch_quick_window与patch_org_plugins_path两个候选当前工作树已进一步演进为五个成员新增patch_virtiofsd_probe、patch_cowork_bwrap、patch_tray_icon_env_overrideasar 路径守卫不在其中。下游后果记录在 scripts/launcher-common.sh390-396 行进程指纹不能再依赖app.asar——自 #700 起 launcher 不再把它作为参数传递因此 UI 进程检测改用--class$WM_CLASS这一跨 deb/rpm/AppImage/nix 的稳定签名。停靠后的 Cowork 代码仅保留patch_cowork_linux工作树中scripts/与tests/下已无任何endsWith(.asar)守卫残留grep 验证。残余风险矩阵自身指出的残余风险上游 helper 依然没有自己的.asar守卫因此只有当某个未来 launcher 改动重新引入.asarargv 时症状家族才会回归守卫的推导过程保存在 main 分支历史6bfb296、623f1b0中如需可随时恢复。该行不属于文档的 Open items判定无条件。对现代构建与补丁开发的启示即使守卫已被删除这条完整的问题链仍提供了三类可迁移的经验修补接收方之前先找发送方JS 侧守卫#640/#650/#669反复回归的根源是 launcher 持续注入路径——PR #700 的 launcher 侧根因修复才真正终结问题。防御纵深有价值但根因修复才是终止符。压缩 JS 补丁的工程纪律动态标识符捕获[\w$]而非\w$不会被\w匹配、锚点锚定开发者字符串而非压缩名、两级幂等性粗粒度includes检查 上下文锚定 grep、显式唯一性断言1 即致命、容空格的验证正则、以 sink 决定加固强度精确后缀匹配而非toLowerCase()——所有这些都可以在 docs/learnings/patching-minified-js.md 中找到系统化记录包括美化输入假阴性5772cc1 修复的正是这类 bug与引号分隔符不稳定1.26832.0 双引号→反引号的全面翻转等陷阱。字节证据优于代码考古判定一个补丁是否还需要最有力的证据是当前分发路径是否还能触发该缺陷——官方 launcher 是裸 ELF 符号链接、/usr/bin/claude-desktop指向裸二进制、打包器不传任何 app 路径这三条事实合起来比任何源码推理都更有说服力。仓库还提供了可复现的验证工具 tools/patch-necessity-audit.shreport-only抓取官方 APT 池中固定的.deb并 grep 解包后的 bundle以及 tests/test-patch-stage.sh验证二次补丁为 no-op 且重打包 asar 字节一致等测试设施供后续维护者随时复核。档案自身的已知缺口Gaps档案如实记录了未验证项引用时应保持同样的审慎PR #700 之后守卫在 deb/rpm global-Electron 回退中是否严格承重未经证实default_app 模式下 Electron 可能把位置参数消费为 app 路径而非文件打开纵深防御是作者推断。#383 的 24 条评论线程未完整阅读报告到 PR #640 之间的临时 workaround 未验证。#718 完整线程未读与兄弟单元的关联依赖 PR #723 的正文。rebase 判定基于静态字节证据矩阵 审计工具未对真实官方安装做 #383/#622/#632 症状的运行时复现——这与文档的方法论一致静态字节优先。【免费下载链接】claude-desktop-debianClaude Desktop for Linux项目地址: https://gitcode.com/GitHub_Trending/cl/claude-desktop-debian创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考