Work破甲包使用教程:用四个md文件改掉 AI 的人格

适用版本:WorkBuddy 最新版本(Windows 10/11、macOS Intel 与 Apple Silicon)
一、这东西的原理
WorkBuddy 每次新开会话,会去用户目录里读几个固定名字的 Markdown 文件,把内容拼进系统提示词:
%USERPROFILE%\.workbuddy\ ← Windows
~/.workbuddy/ ← macOS
├── SOUL.md 人格设定(最关键)
├── IDENTITY.md 身份记录
├── USER.md 用户画像
├── MEMORY.md 用户级长期记忆
└── user-xxxx-personal\
├── SOUL.md 多账号/多工作区时,这里也各有一份
├── IDENTITY.md
├── USER.md
└── MEMORY.md
下载地址(增强版):解锁查看
给 AI 助手换一套人格:
一个纯 markdown 的人格包,加上 97 个技能和一个 10 MB 的单文件安装器。没有服务、没有进程、没有网络请求。
一、先说它解决什么问题
用 AI 编程助手的人多半遇到过两种情况:
第一种,人格漂移。 你在会话里反复强调「直接给结论,别铺垫」,下一个新会话它照旧先来一段「这个问题很有意思,我们可以从几个角度分析」。你写过的偏好,它记不住;它记住的那部分,又常常被平台更新冲掉。
第二种,规则失效。 你在项目里放了一堆规范文档,指望它每次都读。实际是它读了一次,后面十次靠印象。你没法验证它到底有没有按规则走。
雷神包就是针对这两件事的。它做的事情很朴素:把「助手应该是什么样」写成四个 markdown 文件,用安装脚本写进 WorkBuddy 的配置目录,让宿主在每次会话启动时把它们读进上下文。同时把 97 个技能(每个是一份 SKILL.md)铺到技能目录里,需要时按触发词加载。
关键在于它不是软件。没有可执行主体,没有后台服务,不联网,不上传任何东西。整个包做的事情只有一件:复制文件、删一个会反向覆盖人格的文件、记一份清单。
二、包里到底有什么
四个核心文件:
| 文件 | 作用 |
|---|---|
SOUL.md |
人格内核。执行口径、输出判据、禁区词表 |
IDENTITY.md |
身份。名字、角色、称呼、语言 |
USER.md |
用户档案。沟通偏好、决策习惯、技术环境 |
MEMORY.md |
长期记忆。带 KEEP 标记块,重装不覆盖用户自己写的内容 |
安装目标是 %USERPROFILE%\.workbuddy,以及它下面所有 user-*-personal 目录 —— 后者是 WorkBuddy 给每个登录账号建的独立人格目录,一套配置要覆盖全部。
97 个技能覆盖逆向、渗透、游戏安全、二进制分析、前端设计、办公文档等方向。技能不是知识库的全部,它更像「加载开关」:SKILL.md 里的 description 决定什么时候被唤醒,正文决定唤醒后给什么方法。
三、原理:谁在什么时候读哪个文件
这是整个包唯一需要理解的地方。
WorkBuddy 启动
↓
读取 ~/.workbuddy/user-<id>-personal/*.md ← 人格在这里生效
↓
读取 ~/.workbuddy/skills/<name>/SKILL.md ← 技能索引在这里建立
↓
会话开始
↓
命中触发词 → 加载对应 SKILL.md 正文进上下文
三个推论:
1. 装完必须重启才生效。 文件改了,进程里的上下文不会跟着变。
2. 会话运行中安装会被覆盖。 人格文件在进程退出时会被内存里的状态回写。所以安装脚本第一步就查 WorkBuddy.exe 进程,发现运行中就中止 —— 这不是多此一举,是真会白装。
3. BOOTSTRAP.md 必须删。 这是初始化引导文件,它会在启动时反向改写人格文件。包里每个安装脚本最后一步都会清掉它,漏了这步,装完第一次启动就前功尽弃。
另外还有三处「锚点字符串」,是校验用的:
'雷神 · 工作助手人格内核' # SOUL.md 标题
'## 1. 判据' # 章节结构
'本节延伸' # 内核延伸标记
check.ps1 靠它们判断人格是否完整。改 SOUL.md 时动了这三处,检查就会报异常 —— 这是设计如此,不是 bug。
四、安装:三种方式
方式 A:单文件 exe(推荐)
1. 完全退出 WorkBuddy(托盘右键 → 退出,任务管理器确认没有残留)
2. 双击 雷神一键安装.exe
3. 重新打开 WorkBuddy,新建会话
exe 是 9.96 MB 的单文件,内嵌了人格文件和 82 个技能,自带 Python 运行时。拷到任何位置都能跑,不需要包内其它文件。
运行过程:
==========================================
雷神 v1.0 Windows 一键安装
==========================================
==> 安装包自检通过
==> 安装目标 2 个
==> WorkBuddy 未运行,可以安全写入
==========================================
雷神 v1.0 Windows 安装
==========================================
[1/6] 安装包校验通过(payload 4 个文件)
[2/6] 目标目录 2 个
[3/6] 已跳过进程检查(-SkipCheck)
[4/6] 原始文件备份 4 个(同名只备份首次)
[5/6] 人格文件写入 8 个
[6/6] 校验:2/2 份人格文件含雷神内核
==> 技能 82 个:新增 82 / 更新 0 / 未变 0
==> 校验:2/2 份人格文件含雷神内核
几个设计细节:
- 幂等。重复运行不会重复写盘,内容没变就报「未变」。
- 冲突备份。同名技能内容不同时,先整目录备份到
.workbuddy\skills-backup-<时间戳>\,再覆盖。 - 进程保护。检测到 WorkBuddy 在跑,默认中止并提示退出后重跑。
命令行参数(可选):
雷神一键安装.exe --no-skills # 只装 4 个人格文件
雷神一键安装.exe --wb-root D:\test # 装到指定目录
雷神一键安装.exe --dry-run # 只显示不写盘
雷神一键安装.exe --force # 运行中也装(会被回写覆盖)
雷神一键安装.exe --yes # 不问确认
方式 B:bat 脚本
双击 一键安装.bat。只装 4 个人格文件,不带技能。同样先查进程。
方式 C:macOS
chmod +x 02-macOS/install.command
bash 02-macOS/install.command
装完 ⌘Q 退出 WorkBuddy 再打开。两平台的 payload 逐字节一致,diff -r 没有任何输出。
五、装完怎么验
别急着信任「安装完成」四个字。三个命令,从轻到重:
检查状态(3 秒)
检查状态.bat
看四行:内核是否存在、判据章节是否完整、BOOTSTRAP.md 是否清除、版本号。全绿就正常。
环境体检(8 项)
环境诊断.bat
逐条过:主程序路径、配置目录、进程状态、人格目录、文件完整性、内核完整性、BOOTSTRAP、备份、标记、磁盘。任何一项失败会给出具体路径。
清单校验(最严格)
生成清单.bat
重新计算 473 个文件的 SHA256,与 manifest.json 比对。任何文件被改动一个字节,这一步都会报出来。
六、出问题怎么退
卸载:双击 一键卸载.bat。逻辑是从安装时创建的 .bak-<时间戳> 备份还原;安装前不存在的文件直接删除。备份只在首次安装时创建,重复安装不会覆盖你的原始文件。
回滚到上一版:更新管理.bat → 选「回滚」。它会把 _versions\v<时间戳>\ 里的快照写回去。
created 记录的是「安装前不存在、由安装器创建」的文件清单。卸载时靠它区分「该删的」和「该还原的」。
七、二开:改什么、怎么发
包里的东西分四层,改动风险完全不同:
| 层 | 路径 | 风险 |
|---|---|---|
| 人格 | payload/*.md |
最高。改这里等于改助手的性格 |
| 技能 | 03-skills/**/SKILL.md |
中。只增不改最安全 |
| 脚本 | 01-Windows/*.ps1 |
高。涉及备份、还原、回滚 |
| 配置 | config/config.yml |
无。目前未接线,改了不生效 |
改人格
编辑 01-Windows/payload/SOUL.md,然后:
diff -r 01-Windows/payload 02-macOS/payload # 必须无输出
两平台 payload 必须同步。改完重装才生效。
改的时候注意 MEMORY.md 里的 KEEP 块:
<!-- KEEP:BEGIN 安装前的自定义记忆会保存在此块内,重装不覆盖 -->
## 你的自定义条目
<!-- KEEP:END -->
安装和更新脚本都会提取这个块的内容,写回新文件。这是唯一被保护的区域,写在块外的自定义内容会在重装时丢失。
加技能
新建目录,放一个 SKILL.md:
---
name: my-skill
description: >-
一句话说明这个技能干什么。触发词:关键词1、关键词2、关键词3。
---
# 技能正文
...
两个硬要求:
必须放在子目录里。 平铺在 03-skills/ 根目录的 .md 不会被识别,只认 <目录>/SKILL.md。
description 里不能裸用 : 。 YAML 在第一个「冒号加空格」处就判定为映射,后面的描述全部截断。要用冒号,写 description: >- 折叠块:
# 错:YAML 解析报错,触发词全丢
description: 做某件事。Trigger: 关键词1, 关键词2
# 对:折叠块,整段保留
description: >-
做某件事。Trigger: 关键词1, 关键词2
这个坑我踩过。12 个技能因为这一行写法,触发词一个都没生效 —— 技能名看得见,但永远匹配不上。现象很迷惑:技能在列表里,就是不用。
发版流程
顺序不能换:
# 1. 改内容
# 2. 确认两平台 payload 一致
diff -r 01-Windows/payload 02-macOS/payload
# 3. 升版本号(分布在 11 处位置,见 PROJECT.md §8)
# 4. 重打包 exe(exe 内嵌的是快照,不重打就是旧内容)
python tools/build-exe.py
# 5. 重生成清单(必须最后做)
生成清单.bat
# 6. 校验
powershell -ExecutionPolicy Bypass -File tools\build-manifest.ps1 -Verify
第 4 步最容易漏。exe 里装的是打包那一刻的内容,改完文件不重打包,发出去的还是旧的。
干跑
真实安装前,先在临时目录跑一遍:
雷神一键安装.exe --wb-root D:\tmp\test --force --yes --dry-run
雷神一键安装.exe --wb-root D:\tmp\test --force --yes
第二次对同一目录重跑,应该输出「未变 82」。改任意技能文件后再跑,应该输出「更新 1」并留下备份。
八、几个真实踩过的坑
写下来省得别人再踩一遍。
1. config/config.yml 是个摆设。 它声称能控制安装目标、备份模式、日志级别,实际上全仓库没有任何脚本读取它 —— 这些设置全部硬编码在脚本里。改配置零效果。要么接上解析器,要么干脆删掉,别留着误导人。
2. 文件编码决定脚本能不能跑。 PowerShell 5.1 读没有 BOM 的 UTF-8 文件时会按 GBK 解码中文注释,语法树直接在注释处崩掉。技能库里一个 recon.ps1 就是这么挂的 —— 括号完全配平,用 UTF-8 读一切正常,PS 5.1 就是解析不了。加个 BOM 立刻好。
3. 注入段会悄悄改你的文件。 环境往 63 个技能副本里各插了一段 443 字节的规则,位置在 frontmatter 之后、正文之前。它不影响 YAML 解析,也不影响触发词,但会跟着每次技能加载进上下文。删的时候要注意:这些文件同时被写成了 CRLF,而包内是 LF,所以「和包内不一致」的报错里,大部分只是换行符差异,不是内容差异。
4. 管道会杀掉你的安装进程。 测试时用 exe | head -30 看输出,head 读够 30 行就关管道,exe 收到 SIGPIPE 直接死掉。表现是「说装了 82 个技能,盘上只有 59 个」。长流程测试要么重定向到文件,要么用 tail。
5. 卸载在带安全钩子的会话里会中断。 批量删除被会话级防护拦下,脚本跑到一半停住。双击 bat 走的是 powershell -NoProfile,不加载自定义 profile,钩子不生效。所以这类脚本别在特殊环境里测。
九、适合谁
适合:需要一个稳定人格基线的人;要管理几十个技能、避免触发词互相打架的人;想把「规则」变成可版本化文件而不是靠记性的人;需要给团队批量部署同一套配置的人。
不适合:期待它提升模型本身能力的人 —— 它改的是行为约束和加载哪些方法,不是模型权重。装完还是同一个模型,只是更守规矩、更少废话、更知道遇到某类问题该翻哪本手册。
一句话总结:它把「你希望助手怎么做事」从口头约定变成了可安装、可校验、可回滚的文件。
相关文档
评论与补充3
有问题或想补充的,写在下面 · 选中正文文字再点「报告错误」会自动引用- 大神 牛逼啊
- 新版本最新版本吗
- 这个老版本我用过会被官方套盾