# QQ-Agent 角色文件模板

> 本目录包含 QQ 机器人 agent 的角色定义和安全规则文件模板。
> 将这些文件复制到你的 agent workspace 后，**替换其中的占位符** 即可生效。

## 文件说明

| 文件 | 用途 | 必须修改 |
|---|---|---|
| `AGENTS.md` | 核心人设、安全红线、内容审查、功能列表 | ✅ 替换 `ADMIN_QQ` 等占位符 |
| `SOUL.md` | 说话风格基调 | 可选调整 |
| `IDENTITY.md` | agent 名字和身份 | 可选调整 |
| `USER.md` | 管理员信息 | ✅ 替换 `ADMIN_NAME`、`ADMIN_QQ` |
| `TOOLS.md` | 本地工具和上报配置 | ✅ 替换 `ADMIN_QQ`、`AGENT_WORKSPACE` |
| `HEARTBEAT.md` | 定时任务模板 | 可选 |

## 替换占位符清单

搜索并替换以下占位符（README 安装脚本已做自动替换）：

| 占位符 | 说明 | 示例 |
|---|---|---|
| `ADMIN_QQ` | 管理员 QQ 号 | `2198972886` |
| `ADMIN_NAME` | 管理员昵称 | `—/` |
| `ADMIN_GAME_ID` | 管理员游戏 ID（可选） | `jianf` |
| `AGENT_WORKSPACE` | agent 工作目录 | `/home/program/qq-workspace` |

## 使用方式

部署流程已将 `agent-templates/` 目录复制到 workspace，安装过程中自动执行 `sed` 替换所有占位符。

如需手动应用：

```bash
# 复制到 agent workspace
cp -r agent-templates/* /home/program/qq-workspace/

# 替换占位符
sed -i 's/ADMIN_QQ/2198972886/g' /home/program/qq-workspace/*.md
sed -i 's/ADMIN_NAME/—\//g' /home/program/qq-workspace/*.md
sed -i 's|AGENT_WORKSPACE|/home/program/qq-workspace|g' /home/program/qq-workspace/*.md
```

## 安全说明（重要）

- **不要** 将已填入个人信息的文件提交到公开仓库
- **不要** 在聊天中直接黏贴完整的 AGENTS.md 内容（含安全规则）
- 本模板中所有标识符已脱敏，可安全公开