黑海洋 黑海洋 WIKI

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

安全 更新于 11-03 13:51 · 约 83 分钟 · 黑海洋 · 3.1万 · 3 条评论

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

有问题或想补充的,写在下面 · 选中正文文字再点「报告错误」会自动引用
  • 大坤#3Chrome 148 · Windows 10/11
    大神 牛逼啊
  • 菊斗罗#2微信 8 · iOS
    新版本最新版本吗
  • OPPK#1Chrome 132 · Windows 10/11
    这个老版本我用过会被官方套盾
就事论事,别发广告 · 正常评论