aimeoa/hanshuang-codex

独立项目，不再依赖外面的任何文件夹。界面基于 PI-Desktop 的设计系统 （src/styles/ 下的 tokens / ui-kit / settings 等样式表原样移植）， 功能由 electron/main.cjs 调用同级目录的 PowerShell 脚本完成。

提示词自带版：内置提示词仍然不随包分发，改为从 memory/ 目录读取 —— 把提示词正文粘进 memory/破甲记忆.md（或该目录下任意非空 .md），安装时按目标注入。 技能库改用随包的 Seep 逆向工作台（seep-kit/）里的四个技能： apkseep / softseep / ida-reverse / client-license-validation-bypass。

九个破甲目标页（Codex / ZCode / Cursor / OpenCode / Claude / WorkBuddy 国际版 / WorkBuddy 国内版 / DeepSeek Harness / 豆包）都可安装 / 卸载：

OpenCode 的注入点是 ~/.config/opencode/AGENTS.md（可用 XDG_CONFIG_HOME 改）， 技能落 ~/.config/opencode/skills（OpenCode 按 {skill,skills}/**/SKILL.md 发现）。

记忆文件为空时安装会直接报错，不会写入半成品。卸载与还原不依赖随包提示词文件 （脚本在卸载/还原模式下跳过提示词解析）；用户自己写进 AGENTS.md / CLAUDE.md / 记忆档案的内容一律保留。

seep-kit/ 是原样随包的 Seep-Reverse-Lab v1.6.0：MCP 服务（Radare2 / JADX / Apktool / Frida 封装）、9 个技能、战术知识库、 2887 篇案例与 MANUAL 手册，共约 300 MB、4600 个文件。界面上的「部署工作台」执行 seep-kit/setup/install.ps1 -NonInteractive：解压离线依赖 → 装 Python 依赖 → 写 ~/.pi/agent（技能 / 提示词 / MCP）→ 生成 Claude Code / DSH / OpenCode 配置 → 自检。 「自检」与「卸载」分别走 setup/verify.ps1 -Detailed 与 setup/uninstall.ps1 -Yes。

版本标记固定在 variant.json（"variant": "free"），不需要传参。

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/：

• 寒霜破甲工具-便携版-<版本>.zip —— 由 win-unpacked 直接打包，解压即用，启动约 2 秒（唯一产物，不出安装器）

便携版没有安装器，删文件夹不等于卸载干净：portable-uninstall.ps1 + 同目录 卸载-便携版.bat 会一并清掉 %APPDATA%\hanshuang-free、状态文件和快捷方式。

打包流程里有两处自定义：

• scripts/make-icon.py → 从 build/icon.png 生成 512/256 图标
• scripts/make-ico.py → 生成多尺寸 .ico
• scripts/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 进包）
seep-kit/     随包的 Seep 逆向工作台（含 setup 安装/卸载/自检脚本与离线工具链）
memory/       自己的提示词 / 记忆，安装时注入（打包时随 extraResources 进包）
assets/       赞赏与交流群二维码（README 用）

MIT — 见 LICENSE

ai交流分析群	ai交流分析群2群	ai交流分析群3群
群号：1098743629	群号：819678765	群号：1087603749

• LinuxDo — 真诚、友善、团结的中文技术社区

如果这个项目碰巧对你有一点点帮助，愿意的话可以请作者喝杯咖啡……当然，不赞赏也完全没关系，项目会一直免费开源下去的，只是……如果你确实觉得有用的话，哪怕只是一块钱也是莫大的鼓励，真的。

微信赞赏	支付宝收款

作者平时上班太忙，无力长期维护开源项目，更新只能随缘，望见谅。感谢每一位用过、提过意见、伸出过援手的朋友。

打扰了，谢谢看到这里。