如何用 5 条命令完成桌面客户端白标构建Qwen Code 换肤打包完整实战指南【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-codeQwen Code 的 desktop-shell 内置了 Desktop Brand Builder 技能你只需一份brand.json和一个零依赖脚本就能完成 Tauri 桌面壳的白标构建产出 DMG、NSIS、AppImage、deb 安装包。本文讲清输入规则、三层补丁机制与交叉编译的完整链路。一图看懂白标构建全链路整条链路只有一句话一份brand.json进一个零依赖 Node 脚本跑三层补丁build:runtime按目标平台捆绑运行时最后tauri build出多平台安装包。brand.json (brandId logo) | v brand-create.mjs ── 三层补丁配置层 tauri.conf.json / 资源层 icons / 界面层 bootstrap | v build:runtime (QWEN_DESKTOP_TARGET 决定捆绑哪个平台的 Node 运行时) | v npx tauri build ── dmg / nsis / appimage / deb桌面壳启动后呈现的就是 Web Shell 界面换肤替换的正是这类界面中的品牌标识Qwen Code 的桌面端已从早期的 Electron 实现迁到 Tauripackages/desktop-shell是唯一桌面实现品牌化挂载点也就收敛为三处。前置准备环境与构建目录约定开始动手前先确认下表里的依赖都已就位需要什么在哪找说明Node ≥ 18node -v确认品牌脚本零依赖纯 Node 即可运行Tauri CLI v2desktop-shell 的 package.json 已声明tauri-apps/cli执行npm install后由npx tauri build调用独立构建克隆每个品牌自己克隆一份工作仓库保持干净每品牌一个全新克隆检出brand-brandId分支仓库只读约束本仓库所有修改只发生在构建克隆内严禁改动源仓库任何文件技能说明与完整流程定义在 SKILL.md建议先读一遍再动手。克隆或检出分支失败时必须立即停止并报告不得当作分支已创建而继续。最小输入清单快速上手命令链必填项只有两个。缺失时只询问一次不要反复追问字段齐全后直接进入构建无确认步骤。项要求brandId必须匹配^[a-z][a-z0-9-]*$小写字母开头只允许小写字母、数字、短横线logo本地路径且文件必须存在扩展名限.png/.jpg/.jpeg/.svg/.ico/.webp建议 1024px 以上方形 PNG可选项全部用于覆盖自动派生值不填就走默认项用途website官网地址用于推导 appIdappName/appId/artifactPrefix覆盖对应的派生值updaterEndpoints你的更新源端点数组空数组表示禁用应用内更新updaterPubkeybase64 公钥updaterEndpoints非空时必填targetmac/win/linux/all下面这条命令链按顺序可直接复制以nova-lab为例覆盖克隆 → 写配置 → 装依赖 → 跑脚本 → 打包# 1) 每品牌独立克隆 BUILD_ROOT$PWD/brand-builds/nova-lab-$(date %s) mkdir -p $BUILD_ROOT git clone --branch main --single-branch \ https://gitcode.com/GitHub_Trending/qw/qwen-code \ $BUILD_ROOT/qwen-code cd $BUILD_ROOT/qwen-code git checkout -B brand-nova-lab origin/main{ brandId: nova-lab, logo: /absolute/path/to/logo.png, website: https://novahq.io }# 2) 装依赖根部build:runtime 会调用 cross-env 等与 desktop-shell 都要装 npm install cd packages/desktop-shell npm install --workspacesfalse cd ../.. # 3) 运行品牌脚本路径传绝对路径 node packages/desktop-shell/.agents/skills/desktop-brand-builder/scripts/brand-create.mjs \ --shell-root $BUILD_ROOT/qwen-code/packages/desktop-shell \ --config $BUILD_ROOT/brand.json # 4) 打包宿主平台 cd packages/desktop-shell npm run build:runtime --workspacesfalse npx tauri build脚本跑完会打印一份 JSON 报告brandId、appName、appId、artifactPrefix、updaterEndpoints、被补丁的tauriConfig路径、icons结果、bootstrapPatched文件列表对照检查后再打包。缺省字段由脚本按确定性规则推导无需你补充。以nova-lab走一遍推导链字段推导规则nova-lab 示例appName按短横线分段首字母大写空格连接Nova LabartifactPrefix同样处理但用短横线连接Nova-LabappIdwebsitehost 去掉www.后反转标签、追加.desktophost 需至少两段io.novahq.desktopappId回退host 不合法时用app.brandId.desktopapp.nova-lab.desktopupdaterEndpoints默认空数组禁用应用内更新[]细节ai、api、cli、ide、sdk、ui、url这些段会被整体大写所以acme-cli会得到Acme CLI而非Acme Cli。脚本到底改了什么三层补丁拆解brand-create.mjs 的全部工作就是三层补丁逐层看它动了什么、防住了什么。配置层tauri.conf.json 的四个字段tauri.conf.json 被改写四处productName换成品牌名、identifier换成 appId、bundle.shortDescription换成「品牌名 desktop shell for the Qwen Code Web Shell」、plugins.updater.endpoints换成品牌端点。端点为空时还会连带把bundle.createUpdaterArtifacts置为false并把plugins.updater.pubkey清空。防御设计一pubkey 置空字符串而不是删字段。原因写在源码注释里——tauri-plugin-updater的 schema 声明pubkey: String且没有 serde 默认值直接删字段会让应用启动时反序列化失败而端点同为空时空字符串不会触发任何更新检查无害。防御设计二失败关闭fail closed。若你在 brand.json 里提供了更新配置端点非空或给了公钥但目标tauri.conf.json缺少plugins.updater段常见于手工改过的 shell-root脚本在写入任何文件之前直接报错。否则它会悄悄丢弃已校验的更新配置交付一个永远无法更新的品牌包。资源层图标全家桶重生成脚本调用 Tauri CLI 的icon子命令从你的 logo 重新生成src-tauri/icons/下整套图标。调用方式值得注意脚本先用require.resolve(tauri-apps/cli/tauri.js)解析 CLI 入口再以spawnSync让 logo 路径作为普通 argv 元素传递全程不经过命令解释器——路径里的$(cmd)或反引号无法构成 shell 注入。CLI 失败时按 logo 格式降级PNG 则只复制覆盖icons/icon.png并告警「其余尺寸仍是旧 logo」非 PNG 则不动任何图标提示转成 PNG 后手动重跑。界面层bootstrap 启动 UI 换肤logo 被复制为bootstrap/brand-logo扩展名然后 bootstrap/index.html 与bootstrap/bootstrap.js中的Qwen Code字面量全部替换为品牌名qwen-code-logo.svg引用换成品牌 logo 文件名。防御设计三JS/HTML 双语境转义。两个文件里品牌名所处的上下文不同bootstrap.js中是单引号字符串字面量脚本先用JSON.stringify转义反斜杠、换行等控制字符再剥掉外层双引号并补转单引号——只转单引号不够以反斜杠结尾的名字会「逃逸」掉结束引号index.html中是文本与双引号属性按→→→→顺序做实体转义先转避免新实体被二次转义。替换全部使用函数式 replacer防止品牌名里的$之类被展开为匹配文本。最后说回开头detectAlreadyBranded单次使用守卫。脚本启动时检查productName是否已偏离默认值Qwen Code Desktop是则拒绝运行——因为 bootstrap 补丁依赖原始字面量pubkey/endpoints 变更也无法回滚脚本天然不可逆。同理若你的appName恰好等于Qwen Code Desktop加载期就会报错否则第二次运行会在文件中重复拼接品牌串。进阶与易踩坑交叉编译、密钥配对与产物定位四个高频坑按「现象 → 原因 → 正确做法」排查。交叉编译启动即报 exec format error现象目标平台装机后应用启动即崩。原因prepare-runtime.js 按QWEN_DESKTOP_TARGET默认宿主平台下载并捆绑对应平台的 Node 运行时漏设就会把错误架构的二进制打进包。做法每个tauri build --target之前带着环境变量重跑build:runtime如QWEN_DESKTOP_TARGETaarch64-apple-darwin npm run build:runtime --workspacesfalse。不支持的目标值会直接抛错不要硬试。应用内更新永远校验失败现象更新检查每次都签名校验失败。原因更新器用配置里的公钥验签用官方公钥配自建源或干脆漏了公钥必然不匹配。脚本在加载期就强制端点非空必须有updaterPubkey。做法npx tauri-apps/cli signer generate -w ~/.tauri/my-brand.key生成独立密钥对.key作为TAURI_SIGNING_PRIVATE_KEY放入你的构建 CI.pub内容贴进 brand.json。找不到打包产物现象打包结束但bundle/下看不到文件。原因宿主目标与指定 triple 的产物路径不同。做法宿主目标看packages/desktop-shell/src-tauri/target/release/bundle/指定 triple 看src-tauri/target/triple/release/bundle/子目录dmg/、nsis/、appimage/、deb/与配置中的 targets 一一对应。品牌包与官方更新源串线⚠️现象品牌客户端开始轮询官方更新源或被官方源推送更新。原因端点默认沿用官方配置违反隔离约定。做法updaterEndpoints默认必须为空只有品牌方自建了更新源才填且必须搭配自备公钥与签名密钥严禁复用上游任何凭据。打包后 5 步验证与排障速查验证按顺序执行确认产物出现在src-tauri/target/release/bundle/交叉编译时为src-tauri/target/triple/release/bundle/的dmg/、nsis/、appimage/或deb/中对每个产物计算sha256summacOS 用shasum -a 256macOS 上对生成的 DMG 执行hdiutil verify只有文件真实存在才能声称产出了对应平台安装包向使用方汇报产物路径、SHA-256、应用名、appId 与构建目录。常见失败场景的处理场景处理方式brandId非法展示正则^[a-z][a-z0-9-]*$请对方修正logo 缺失或扩展名不符要求提供合法本地路径与支持格式品牌脚本缺失报告packages/desktop-shell/.agents/skills/desktop-brand-builder/scripts/brand-create.mjs不存在附预期命令shell-root 已品牌化脚本拒绝运行从全新克隆重新开始构建中途失败保留构建目录返回最后的有用错误行与完整日志路径或失败命令两条硬性约定 ⚠️失败时不得删除构建目录它用于事后排查而非重试品牌步骤严禁在同一克隆中重跑brand-create脚本是单次使用的——品牌配置有误时丢弃该克隆从头再来。收尾最小命令链一份brand.json 一次brand-create.mjs 每目标一次build:runtimenpx tauri build。它适合团队以自有品牌分发 Qwen Code 桌面壳的白标场景。边界要记牢脚本单次使用重跑须用新克隆签名与更新源必须完全自建严禁与官方发布体系混用。【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考