独立项目，不再依赖外面的任何文件夹。界面基于 PI-Desktop 的设计系统
（src/styles/ 下的 tokens / ui-kit / settings 等样式表原样移植），
功能由 electron/main.cjs 调用同级目录的 PowerShell 脚本完成。
八个破甲目标（Codex / ZCode / Cursor / Claude / WorkBuddy 国际版 / WorkBuddy 国内版 / DeepSeek Harness / 豆包），每个目标提供各自的全版本列表。
WorkBuddy 国际版与国内版是同一个程序的两套发行，数据目录不同
（~/.workbuddy-ai 与 ~/.workbuddy），可并存，因此拆成两个独立目标、
各自安装与卸载。豆包的全局记忆不在本地磁盘，注入经 CDP 走客户端自身的
登录会话写云端接口，脚本会自动把豆包重启到调试模式。
版本标记已经固定在 variant.json（"variant": "free"），不需要传参。
各目标的注入位置：
| 目标 | 脚本 | 注入位置 |
|---|---|---|
| Codex | install.ps1 |
~/.codex/config.toml → model_instructions_file |
| ZCode | install-zcode.ps1 |
AGENTS.md + 全局记忆 + 系统提示词 |
| Cursor | install-cursor.ps1 |
Cursor 全局规则（User Rules） |
| Claude | install-claude.ps1 |
~/.claude/CLAUDE.md + skills |
| WorkBuddy 国际版 | install-workbuddy.ps1 |
云记忆 memoryBlock + MEMORY.md + 技能库（~/.workbuddy-ai） |
| WorkBuddy 国内版 | install-workbuddy.ps1 |
同上，数据目录 ~/.workbuddy |
| DeepSeek Harness | install-dsh.ps1 |
~/.dsh/AGENTS.md（DSH 全局记忆）+ ~/.dsh/skills |
| 豆包 | install-doubao.ps1 |
云端全局记忆（CDP 走客户端登录会话写入） |
DeepSeek Harness 用 Claude Code 版提示词（寒霜v4-claude.md / 寒霜v3.md），
因为 DSH 的 AGENTS.md 与 Claude Code 的 CLAUDE.md 是同一套 Markdown 记忆规范。
备份落在 ~/.dsh/managed-prompts/，卸载即还原（含原 AGENTS.md 全文）。
npm install
npm run dev # 起 Vite 开发服务器
npm run build # 只构建渲染层到 dist/
npx electron . # 跑起来（默认加载 dist/）
HS_DEV=1 npx electron . # 连开发服务器截图验收（开发用）：HS_CAPTURE=<输出目录> npx electron . 会逐页截图后自动退出。
npm run dist产物落在本文件夹的 release/：
寒霜破甲工具-安装版-<版本>.exe—— NSIS 安装版寒霜破甲工具-免安装版-<版本>.exe—— electron-builder 的 portable 目标，每次启动要自解压到临时目录，开窗慢寒霜破甲工具-便携版-<版本>.zip—— 由win-unpacked直接打包，解压即用，启动约 2 秒（发布用这个）
便携版没有安装器，删文件夹不等于卸载干净：portable-uninstall.ps1 + 同目录
卸载-便携版.bat 会一并清掉 %APPDATA%\hanshuang-free、状态文件和快捷方式。
打包流程里有两处自定义：
scripts/make-icon.py→ 从build/icon.png生成 512/256 图标scripts/make-ico.py→ 生成多尺寸.icoscripts/after-pack.js→ electron-builder 打完应用目录后，用 rcedit 把图标和版本信息写进 exe
最后一步是必需的：electron-builder 自带的 signAndEditExecutable 在 Windows 上要先解压
winCodeSign 压缩包，包里含 macOS 符号链接，普通权限创建不了会直接中断构建，所以关掉它、
改由 afterPack 钩子自己调 rcedit。
替换 build/icon.png（512×512 方形 PNG）后重新 npm run dist 即可。
electron/ 主进程、preload、PowerShell 调度、压缩守护、WorkBuddy 记忆守护
src/ 渲染层（React）
data/ 目标与版本文案
pages/ 破甲详情页 / Skills 管理 / 使用教程 / 个人中心
styles/ PI-Desktop 的样式表 + app.css
assets/ 界面用的字标图
scripts/ 构建与图标脚本
build/ 图标源文件（png / ico）
install*.ps1 安装脚本（打包时随 extraResources 进包）
codex-skills* 技能库（打包时进包）
assets/ 赞赏与交流群二维码（README 用）
MIT — 见 LICENSE
| ai交流分析群 | ai交流分析群2群 |
|---|---|
 |
 |
| 群号：1098743629 | 群号：819678765 |
- LinuxDo — 真诚、友善、团结的中文技术社区
如果这个项目碰巧对你有一点点帮助，愿意的话可以请作者喝杯咖啡……当然，不赞赏也完全没关系，项目会一直免费开源下去的，只是……如果你确实觉得有用的话，哪怕只是一块钱也是莫大的鼓励，真的。
| 微信赞赏 | 支付宝收款 |
|---|---|
 |
 |
作者平时上班太忙，无力长期维护开源项目，更新只能随缘，望见谅。感谢每一位用过、提过意见、伸出过援手的朋友。
打扰了，谢谢看到这里。