- agent-templates/: AGENTS.md, SOUL.md, IDENTITY.md, USER.md, TOOLS.md, HEARTBEAT.md - 所有个人标识已替换为占位符(ADMIN_QQ, ADMIN_NAME, AGENT_WORKSPACE) - 配 README 说明替换方法和安全注意事项
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 替换所有占位符。
如需手动应用:
# 复制到 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 内容(含安全规则)
- 本模板中所有标识符已脱敏,可安全公开