Files
chatrebot_aireply_plug/agent-templates
root fdd5b55a82 feat: 添加 QQ-agent 角色文件模板(脱敏版)
- agent-templates/: AGENTS.md, SOUL.md, IDENTITY.md, USER.md, TOOLS.md, HEARTBEAT.md
- 所有个人标识已替换为占位符(ADMIN_QQ, ADMIN_NAME, AGENT_WORKSPACE)
- 配 README 说明替换方法和安全注意事项
2026-05-04 20:16:10 +08:00
..

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 内容(含安全规则)
  • 本模板中所有标识符已脱敏,可安全公开