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 安装脚本已做自动替换）：
| 占位符 | 来源 | 说明 |
|---|---|---|
AGENT_NAME |
NapCat API 自动获取 | QQ 登录账号的昵称（agent 的人设名字） |
ADMIN_QQ |
用户提供 | 管理员 QQ 号 |
ADMIN_NAME |
用户提供 | 管理员昵称（AGENT_NAME 获取失败时回退） |
ADMIN_GAME_ID |
用户提供 | 管理员游戏 ID（可选） |
AGENT_WORKSPACE |
自动推导 | agent 工作目录 |
使用方式
本仓库的 README 第 6.2 步会自动将本目录文件复制到 agent workspace 并替换占位符。
如需手动应用：
# 确定仓库克隆路径
REPO_DIR="/opt/chatrebot_aireply_plug"
AGENT_WORKSPACE="/home/program/qq-workspace"
ADMIN_QQ="你的QQ号"
ADMIN_NAME="你的昵称"
# 复制模板文件
cp "${REPO_DIR}/config/agent-templates/"*.md "${AGENT_WORKSPACE}/"
# 替换占位符
cd "${AGENT_WORKSPACE}"
sed -i "s/ADMIN_QQ/${ADMIN_QQ}/g" *.md
sed -i "s|ADMIN_NAME|${ADMIN_NAME}|g" *.md
sed -i "s|AGENT_NAME|${AGENT_NAME}|g" *.md
sed -i "s|AGENT_WORKSPACE|${AGENT_WORKSPACE}|g" *.md
安全说明（重要）
- 不要 将已填入个人信息的文件提交到公开仓库
- 不要 在聊天中直接黏贴完整的 AGENTS.md 内容（含安全规则）
- 本模板中所有标识符已脱敏，可安全公开