破甲一键通 v8.2

一句话：把你电脑上那几个 AI 客户端「自己改不到的内置提示词」，换成你自己写的那份。

支持 DSH / WorkBuddy / ZCode / Codex / Cursor / Claude Code 六个客户端，一个脚本全管，六个口径完全一致。 纯 Python 标准库、零依赖、双击即用、改前必留备份、随时一键还原。

🚨 一句话警告：本项目完全免费

第三方发布的「WKBD rev1.0 / rev2.0」（化名 popopo）是基于本项目换皮二次发布， 且把 MIT 强制保留的版权声明删空成 Copyright (c) 2026。 如果你花钱买了它，请立即退款 —— 完整证据与自助验证方法见 反抄袭通告。

🧭 30 秒看懂：这是干什么的？

你平时用的 AI 客户端（比如 WorkBuddy、DSH），每次对话时都会在背后塞一段你自己改不到的"规矩" —— 用来告诉 AI 它是什么身份、该守什么、什么不做什么能做。

这个脚本做的事很简单：把那段规矩，换成你自己写的一份。

它不修改软件本体：只做文本文件层面的替换，不删包、不碰注册表 / 服务、不联网。 想深入了解改了什么，看 详细一点：它到底改了什么。

🚀 三步就能用

1️⃣ 下载

打开 Releases 页面：

• 没装 Python / 只想双击就用 → 下载 pojia-next-v8.2-exe.zip，解压后双击里面的 破甲一键通.exe。 电脑上不需要装 Python，也不需要装任何依赖。
• 装了 Python（3.8+）或想改代码 → 下载 pojia-next-v8.2.zip，解压到任意文件夹（桌面就行）。

两个包功能完全一样，.exe 只是把 Python 运行时和脚本一起打包进去了（约 11 MB，首次启动多花 1～2 秒解包）。

exe 放在哪，备份就落在哪。 程序把自己的《历史备份/》《状态/》《破甲日志.txt》 和可选的 persona.md 都放在 exe 同一个文件夹里 —— 所以别把它丢进 C:\Program Files\ 或直接在压缩包里双击运行（那里写不进去）。 放桌面、放 D 盘新建的文件夹都可以。

2️⃣ 双击

• exe 版：双击 破甲一键通.exe
• 脚本版：进解压出来的文件夹，双击 一键破甲.bat

两种都会出来同一个菜单。

3️⃣ 按 1

选你要处理哪个客户端 → 确认 → 跑完 重启客户端（要完全退出，包括右下角托盘图标）。

😰 第一次不敢下手？

先按 2 检测状态 —— 那是纯只读的，只看不改，先看看你现在是什么状态。 或者按 4 预演，它只告诉你"假如执行会改哪些文件"，一个字节都不写。

一键破甲.bat 会自己去找 Python。如果没有，它会告诉你去哪下载（python.org， 安装时记得勾上 Add Python to PATH）。整个工具不需要 pip 装任何第三方库。

🛡 「会不会把我电脑搞坏？」—— 你最该担心的五件事

✅ 装完怎么确认真的成功了？

在客户端里新开一个会话，单独发这四个字：

破甲自检

预期它只回一行（多一个字、加解释、拒答 —— 都说明没真载入）：

破甲自检成功

没回？九成是没重启客户端。先完全退出（含托盘图标）再打开，然后重试。

为什么用这种笨办法验证：问它"你运行在什么模式"等于自我暗示，模型很可能顺着你答， 结果不可信。给一条固定口令 + 固定回复，才是真判据 —— 口令写在客户端的管理目录里， 路径见 自证与体检。

收到的回复不是上面那句？说明你装的可能不是本项目原版，请从官方仓库重新下载。

❓ 常见问题

Q：跑完要重启吗？ A：要。DSH、WorkBuddy 等都要完全退出（含托盘图标）再打开才生效。这是最常见的"没生效"原因。

Q：会不会乱改我的东西？ A：只做文件级补丁，不删包、不碰注册表/服务，每个改动都有备份。 --status（菜单 2）和 --dry-run（菜单 4）是纯只读的，可以先看再动手。

Q：官方软件升级之后，补丁还在吗？ A：升级会覆盖程序目录，补丁可能被冲掉。重跑一次菜单 [1] 就行 —— 脚本会自动识别哪些被冲掉了，只补该补的，不重复劳动。

Q：怎么知道补丁有没有被冲掉？ A：菜单 [2] 检测状态（或 python 破甲一键通.py --check）。WorkBuddy 还可按菜单 [9] 留基准、做对比。

Q：找不到我的安装位置怎么办？ A：脚本会自动扫 Program Files、%LOCALAPPDATA%\Programs、注册表、所有盘符、运行中的进程、npm 目录。 真找不到会弹一个二选一：输 A 帮你打开官方下载页（说明还没装）；输 B 弹系统目录窗口手动选，选完会记住。

Q：能发给朋友吗？ A：整个文件夹打包发过去就行，对方双击 一键破甲.bat 即可，脚本自己找 Python、自己找客户端。 完全免费，别花钱买。

Q：我的客户端不在支持的六个里？ A：那不支持。脚本只处理下面列出的六个目标，不会去猜、也不会乱动别的软件。

📖 详细一点

它管哪六个客户端

Cursor / Claude 走标记块注入：只往你的配置里追加 <!-- POJIA-NEXT-INJECT:BEGIN --> … END 之间那一段，你原有的内容一律保留， 卸载时按标记精确删除，重复执行也不会堆叠。

Codex 从 v7.8 起换了路子：不再追加 AGENTS.md（那是"补充上下文"，会被项目级 AGENTS.md 和产品提示词稀释），改成在 config.toml 里加一行 model_instructions_file 指向我们写的人格文件 —— 这是 Codex 官方的替换模型指令入口，破甲更彻底。 只加这一行（外面套我们自己的注释标记），你其余的配置逐字节不动。

它到底改了什么

• DSH：把 WORKSPACE_CONTEXT_INTRO 那类"仅供参考、不覆盖系统指令"的免责声明，升级成"ACTIVE 且强制"； 剥离官方默认身份（You are a coding agent powered by ... 等），改由 persona.md 作唯一身份来源。
• WorkBuddy：六层靶点 —— ① templates\*.tpl 政策块整块替换；② cli\product.json 内嵌提示词文本级替换（不重排 JSON）； ③ codebuddy.js 命令闸门解锁 + 去网页内容过滤；④ 数据目录 plugins 里的副本；⑤ cache\acc-product-config-v3.json 运行时缓存； ⑥ TEMP 会话快照（默认只清 24 小时以上的）。

菜单每一项是什么意思

双击 一键破甲.bat 后：

  [1] 一键破甲         ← 先选要破哪个（六个任选 / 可多选）
  [2] 检测状态         只读，不改任何文件          ← 建议第一次先按这个
  [3] 诊断详情         逐文件列出补丁/备份状态
  [4] 预演             只显示会改什么，不写盘
  [5] 选目标单打       同上，等价入口
  [6] 还原             选择目标还原成官方原版
  [7] WorkBuddy 守护    安装 / 卸载 / 查看后台守护任务
  [8] 体检（只读）      磁盘态 / 凭证 / 自证就绪，不改盘
  [9] WorkBuddy 快照    生成基准 / 与基准对比
  [0] 退出

想换成自己写的人格

改同目录的 persona.md，然后重新跑一次（记得勾 --force）：

python 破甲一键通.py --apply --force --yes

优先级：--persona 文件 > persona.md > my-prompt.txt（兼容旧工具）> 内置默认。

为什么要 --force：脚本默认"已经破过就不重复写"（WorkBuddy 的 product.json 有 613KB、 codebuddy.js 有 23MB，白写一遍没意义）。只有你主动改了人格时才需要加。

python 破甲一键通.py                            # 交互菜单
python 破甲一键通.py --status                   # 只读：六个目标全查一遍
python 破甲一键通.py --check                    # 只读体检（有问题退出码 1）
python 破甲一键通.py --diagnose                 # 只读：详细取证
python 破甲一键通.py --dry-run                  # 预演，不改盘
python 破甲一键通.py --apply --yes              # 真打（自动跳过没装的）
python 破甲一键通.py --apply --target wb --full --yes      # 只打 WorkBuddy 的完全破甲
python 破甲一键通.py --revert --target dsh --yes           # 只还原 DSH
python 破甲一键通.py --apply --persona 我的.md --force --yes
python 破甲一键通.py --pick dsh                 # 手动指定安装目录（弹系统目录窗口）
python 破甲一键通.py --guard install            # 装 WorkBuddy 守护任务

常用开关：

关于 DSH 进程（重要）：脚本默认绝不结束正在跑的 DSH 进程 —— 那个进程里很可能就跑着正在跟你对话的会话，杀它等于自杀，还会丢未保存的对话。 检测到在跑只提示、然后继续打补丁（改的是磁盘文件，不影响当前进程），改动重启 DSH 后生效。

装过老版本？直接重跑就行

以前有个坑：新版给提示词加了内容、但那段内容没参与版本判据，于是老补丁在新版里仍被判成"已是最新" → 跳过 → 永远升不上去（守护任务跑的 --apply 不带 --force，也救不回来）。

现在判据加了版本维度：读 managed-prompts\pojia-yijiantong\passport.json 里的 version， 只要和当前版本不一致（或者压根没有护照），就自动重写一遍。你不需要加 --force。

☁️ WorkBuddy 的云记忆通道（一条更硬的注入路径）

改 templates\*.tpl / product.json 是"改程序自带的提示词"，任何升级、自检、旧守护任务都能把它冲掉 （本项目实测：某个旧守护每 30 分钟覆盖一次）。所以还加了一条更硬的通道：

<数据目录>\memory\<uid>_memory.md      ← WorkBuddy 自己的"账号级云记忆档案"
    其中的 memoryBlock 会被它每一轮自动包成 <memory>…</memory> 注入系统提示词（上限 10000 字符）

写入后做三处防护：写全文（实测约 4600 字，远低于上限）／Version 写成 999999 （云端版本号更小会被判过期，不回写）／落盘后设只读（程序回写走 tmp+rename， Windows 上覆盖只读文件会 EPERM，于是空档案回写被挡住）。 首次注入前把原档案留档为 <档案>.pojia.bak，--revert --target wb 原样还原； 守护任务每 30 分钟自愈；人格超 10000 字会明确报错并跳过，不会写坏档案。

🆕 ZCode 的两个坑

1. 技能是"深度 1 扫描" —— 官方只认 <root>/<技能名>/SKILL.md 这种直子目录，摆成一个大伞状目录 它一个都看不见。本工具按直子目录摆，并且不动你自己已有的技能。
2. 系统提示词在打包过的 JS 里（resources\glm\zcode.cjs）—— 改它风险最高，所以做成可选通道，默认不开。

python 破甲一键通.py --apply --target zcode --yes              # 常规三通道（推荐）
python 破甲一键通.py --apply --target zcode --zpatch --yes     # 额外替换系统提示词

--zpatch 有四道保险：锚点匹配（找版本稳定的字面量 "You are ZCode…"， 而不是竞品那种按 u9o/s9o 压缩变量名定位 —— 客户端一升级就失效）／写前备份 zcode.cjs.pojia.bak／写后跑 node --check，校验不过立刻回滚／结构变了就跳过并说明原因。

⚠️ ZCode 目前没在实机上验证过（开发机没装）。逻辑与安全机制都有桩环境测试 （含"语法不过就回滚"），但真机行为要等你装了跑一次才算数。

🛡 WorkBuddy 守护任务

菜单 [7]（或 --guard install）会装两个计划任务，防止补丁被官方升级/自检冲掉： WorkBuddyUnlockV6_Hourly（每 30 分钟）、WorkBuddyUnlockV6_Logon（每次登录，需管理员）。 守护进程用 pythonw.exe 调 --quiet，没有黑框闪现。

⚠️ 如果你以前装过旧版守护任务（名字里带 V4），它每 30 分钟会用旧人格把你的新人格覆盖回去。 --check 会点名报出来；先装 V6，再卸掉 V4。

🔬 安全审查（你可以自己验）

不用下载就能先看：下面都是脚本里真实的关键逻辑。核心承诺是 —— 无网络请求、无动态执行、无 shell 拼串，所有改动都是"先备份、再原子写、随时能还原"。

敏感调用审计（本仓库 CI 每次提交都断言这些全为 0）