桌面 AI 客户端人格注入工具 v5.6:支持 10 个客户端,新增标记块与守护任务
从 6 个客户端扩到 10 个:新增 DSH 与 Cursor / Claude Code / ZCode,后者走标记块写入、块外字节逐字保留,不误伤你自己的规则。附一键备份、护照式还原与人格守护任务。下载地址已更新。
技术摘要:从 6 个客户端扩到 10 个:新增 DSH 与 Cursor / Claude Code / ZCode,后者走标记块写入、块外字节逐字保留,不误伤你自己的规则。附一键备份、护照式还原与人格守护任务。下载地址已更新。
你有没有过这种感觉:好不容易把 AI 客户端的系统提示词调教成自己想要的样子,客户端一升级,全没了。
WorkBuddy、Qoder、Codex、Hermes、Cursor 这类桌面客户端的系统提示词都写死在程序包里,官方不给你改的地方。每次版本更新都会换掉这些文件,之前折腾的成果直接归零。
这个工具的思路很直接:不去跟官方拼装管线较劲,而是在最后一棒把提示词换掉。同时把「备份、校验、回滚」这套保命机制一起做好,让你敢用。
一、它解决什么问题
一句话:让你自己写的人格提示词,真正成为客户端的系统提示词,并且能随时一键还原。
具体做到四件事:
| 能力 | 说明 |
|---|---|
| 注入人格 | 把你写的 .txt 文本注入客户端,成为模型看到的首要指令 |
| 自动备份 | 所有被改动的文件都先生成 .bak,原样留存 |
| 失败回滚 | 写入后自动做语法自检,不合格立刻回滚,不留半吊子状态 |
| 一键还原 | 双击「恢复」即可回到客户端原生状态 |
它支持两类完全不同的客户端,打法也不一样——这一点很重要,后面选目标时会用到:
| 类型 | 代表客户端 | 做法 | 更新后有官方指令通道 |
|---|---|---|---|
| 拦截发送层 | WorkBuddy、WorkBuddy AI | 在客户端发出请求前替换系统提示词 | 需要重跑一次 |
| 原生指令通道 | Qoder、Codex、Hermes、DSH、Cursor、Claude Code、ZCode | 直接写它们的官方配置文件或标记块 | 基本不受影响 |
二、从 v5.2 到 v5.6 更新了什么
这轮不是加功能凑数。真正值钱的是两件事:目标从 6 个扩到 10 个,以及新增的四个目标改用「标记块」写法——对已经有你自己规则文件的客户端,这是唯一不会误伤你原有配置的做法。
1. 新增 DSH(DeepSeek Harness)
第 7 个目标。DSH 的人格装配入口不在 AGENTS.md,而在 profile 目录下的 cordis.patch.yml 的 persona.prefix 字段里。
这里有个坑值得单独说:网上抄来的说明会告诉你写 ~/.dsh/.agent-presets/<slug>/,那个目录根本没人读。装完状态显示「已部署」,实际不生效——是那种最难查的静默失败。
DSH 目标只改 persona.prefix 块,块外字节逐字保留(这份文件里还有 MCP、技能迁移、主题、模型等几十项配置)。另外它有多个预设,实际生效的由 agent-preset-registry.selectedDefault 决定,所以工具会先读注册表确定当前预设,改在真正在用的那个上。
2. 新增 Cursor / Claude Code / ZCode:标记块式注入
这三个客户端的用户级规则文件,通常已经写了你自己的规则。整文件覆盖等于把你的规则全抹掉。
所以这三个目标走「标记块」路线:工具在文件里维护一对标记,人格只写在标记之间,块外的每一个字节都逐字保留。标记块长这样:
# >>> pojia-inject BEGIN (managed by WorkBuddy-Deploy, do not edit) >>>
(这里是你的 .txt 人格全文)
# <<< pojia-inject END <<<配合三项配套机制:
| 机制 | 作用 |
|---|---|
| 护照式还原 | 部署时把「我改过哪些路径」登记进 passport.json,还原时只按名单处理,不扫全盘 |
| 自检口令 | 检查人格里有没有「破甲自检成功」这个应答词,没有就告警;部署完提示你在客户端新会话里发一句「破甲自检」,对方只回「破甲自检成功」才算真载入 |
| 人格守护任务 | 计划任务 WorkBuddy-Deploy-PersonaGuard 定期跑一次自检,人格被客户端覆写或删掉时补回;纯静默,不打扰 |
3. 打包方式修掉一个会让文件名的坑
旧包是用 Compress-Archive 打的,所有中文条目都没打 UTF-8 标志位,文件名靠 GBK 猜回——在非中文系统或换个解压工具就必然乱码。
新包改用 Python zipfile 手工构造:zipfile.write 自动为非 ASCII 名置 bit11 标志位,固定时间戳与权限位(结果可复现),只按白名单打包(不写 glob——有一次就因为凭记忆写错一个文件名被存在性校验当场拦下)。
4. 人格库精简与重排
对外发布的包里带 8 套人格,编号 01–08 连续,每套都有一份 .txt(注入用,唯一真源)和一份 .md(查阅用角色卡)。编号连续是有意为之——留空号会跟历史卡片混淆。
5. 菜单与自检
菜单是彩色分组的,标出每个客户端的注入方式和要不要重启,10 个条目全部列出来,不用记编号含义。三个 .bat 已退化成纯转发器(每个 7 行),目标清单收敛到单一真源,测试会断言「菜单集合 == 参数 ValidateSet 集合」,以后新增客户端漏改任一处都会被测出来。
自动化验证 324 项断言,覆盖路径探测、真实包打补丁、注入后真正执行一次确认替换生效、语法自检失败能回滚、没有 Node 时的兜底、双版本隔离、标记块块外字节不变等等。
补充一句实话:这 324 项在本机实测时是 321 过 / 3 挂,挂的三项全都是「两版目录互不串位」这类目录探测断言——原因不是工具逻辑坏了,而是测试机器上国内版和国际版被装进了同一个目录(注册表里两个卸载项的图标都指向 C:\Program Files\WorkBuddyAI)。断言在如实报告环境现状。其余 321 项全过。三、支持的 10 个客户端
| 编号 | 客户端 | 注入方式 | 需重启 |
|---|---|---|---|
| 1 | WorkBuddy(国内版) | 拦截发送层,硬替换系统提示词 | 是(自动) |
| 2 | WorkBuddy AI(国际版) | 同上 | 是(自动) |
| 3 | Qoder(国际版) | 原生 ~/.qoder/AGENTS.md | 否 |
| 4 | Qoder CN(国内版) | 原生 ~/.qoder-cn/AGENTS.md | 否 |
| 5 | Hermes | SOUL.md | 否 |
| 6 | Codex | 全局 AGENTS.md | 否 |
| 7 | DSH(DeepSeek Harness) | profile 的 cordis.patch.yml 人格块 | 否 |
| 8 | Cursor | 标记块规则 | 否 |
| 9 | Claude Code | 标记块记忆 | 否 |
| A | ZCode | 标记块 AGENTS | 否 |
国内版和国际版是两个完全隔离的目标——选国际版绝不会碰国内版,反之亦然。
四、怎么用:三步
第 1 步:下载并解压
下载地址:https://pan.ailxw.com/pickup/15144?ref=teyir.com
大小 167,894 字节(约 164 KB) · 本站自建网盘 · 取件码 15144
链接长期有效,如遇失效请在评论区留言。
压缩包除脚本外,还包含 8 套现成的人格模板(人格\*.txt + 查阅用角色卡)、以及两份完整说明文档(部署工具说明与人格库索引)。
第 2 步:把人格放进目录
把你自己的提示词存成 .txt(UTF-8),丢进 人格\ 目录。包里已经有 8 套可以参考格式。放几个都可以,运行时会让你选。加新人格不用改任何脚本,部署器自动扫描并按文件名排序。
第 3 步:双击运行
双击 部署.bat,菜单里按编号选目标,回车。想先看看情况不想动任何东西,就双击 查看状态.bat——它是只读的。改主意了双击 恢复.bat。
五、安全边界(务必看完)
这个工具会改动客户端自身的程序包或配置文件,这一点必须说清楚,不能含糊:
| 项 | 说明 |
|---|---|
| 改动前 | 被修改的文件都会先生成同名 .bak 备份 |
| 写入时 | 先在内存里算好全部改动并校验,再统一写盘;任何一个文件不合格就整体回滚 |
| 写入后 | 做一次语法自检,失败自动还原 |
| 想还原 | 双击 恢复.bat,从备份完整还原(标记块目标按护照名单还原) |
| 不用装 Node | 没装 Node 会自动改用客户端自带的运行时做自检 |
| 会重启客户端 | WorkBuddy 目标会强制关闭并重启客户端,正在进行的对话会中断;其余目标不需要重启 |
| 使用风险 | 请自行确认在你的环境里使用这类定制方式符合软件许可与相关规定,使用风险自负 |
六、几个常见疑问
| 问题 | 回答 |
|---|---|
| 需要会编程吗? | 不需要。放好文本文件,双击 bat,按编号选。菜单里的「注入方式」「是否重启」都是给你看的提示 |
| 客户端更新后失效怎么办? | 拦截发送层的 WorkBuddy 需要重跑一次部署。如果提示「找不到任何受支持的注入锚点」,说明客户端内部结构大改,需要重新定位注入点(改一处正则即可) |
| Cursor / Claude Code 里我原来写的规则会丢吗? | 不会。这三个目标走标记块,人格只写在标记之间,块外字节逐字保留 |
| 我两版 WorkBuddy 装在同一台机器上,会互相打架吗? | 目标列表里是两个独立条目,选一个不会主动去动另一个。但有一种情况工具也救不了:两版共用同一个安装目录。比如国内版升级之后和国际版被装进了同一个文件夹(注册表里两个卸载项的图标都指向同一目录),那它们本来就是同一份文件,给任一版注入等于两版一起生效。这种情况下 查看状态 会报「两版目录互不串位」检查失败——它不是工具出了故障,是在如实报告你的目录现状 |
| 会不会把客户端弄坏? | 所有改动都有备份,写盘前先校验、失败即回滚。最差情况下跑一次「恢复」回到原状 |
| 人格文本要多长? | 没有硬限制。但它是「写给模型看的系统提示词」,不是说明书,控制在能读完的长度更好 |
七、技术细节(可跳过)
给想弄明白原理的人。不看也不影响使用。
为什么不在程序包里直接改提示词
因为主进程的拼装管线在 app.asar 里且带完整性校验——改一个字节就可能拒绝启动。所以对 WorkBuddy 选择在发送函数的最后一棒拦截:客户端怎么拼都行,请求发出前把系统消息换成你的文本。
注入点的定位方式
注入点不在入口包里,而在 SDK 的请求类上。入口包还会按场景分派(TUI / headless / 精简版),并且带 lazy-* 分块目录,文件名带哈希、每次更新都会变。所以工具不认文件名,只扫内容,匹配 create(参数,参数){return this._client.post("/chat/completions",{body:...,stream:...})} 这样一个形状。
用命名分组把压缩变量名捕获出来再回填,变量名怎么变都不影响匹配——这是「客户端升级不再失效」的关键。
遇到过的一个隐蔽坑:ESM 里没有 require
精简版包是 ESM 产物,里面根本没有 require。如果注入代码只写 require("fs"),那么 CJS 包能生效、ESM 包静默失效——最难查的一类问题。修法是优先用 process.getBuiltinModule("fs"),再逐级退回 require。
Qoder 为什么不用同一套做法
它的请求层在一个 33MB 的混淆包里(字符串是明文但标识符全被打乱),而且该文件被官方更新清单登记了哈希,改了有被判定损坏并自动回滚的风险。相比之下,它自带的 AGENTS.md 是标记为「每次会话都加载」的官方通道——没有任何理由为了「效果更硬」去改二进制。
八、说在最后
这类工具的价值不在于「技术多高深」,而在于把备份、校验、回滚这套保命机制做扎实,让你敢真的去用。改程序包本身是有风险的动作,能做的是把风险控制到「最差也能一键回来」。
如果你的客户端版本比较新、或者结构和我这边的不一样,欢迎把 查看状态.bat 的输出发给我,能看出来是哪种情况。
下载地址:https://pan.ailxw.com/pickup/15144?ref=teyir.com (取件码 15144)
登录后即可参与讨论
注册会员可以发表评论、接收回复提醒。