42b5e022e1
- AGENTS.md/SOUL.md/IDENTITY.md 中 'the Real' → AGENT_NAME 占位符 - Step 6.2 新增 NapCat /get_login_info 接口自动获取登录 QQ 昵称 - 获取失败时回退到 ADMIN_NAME - sed 替换新增 AGENT_NAME 占位符替换 - config/agent-templates/README.md 同步更新
58 lines
2.0 KiB
Markdown
58 lines
2.0 KiB
Markdown
# 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 并替换占位符。
|
||
|
||
如需手动应用：
|
||
|
||
```bash
|
||
# 确定仓库克隆路径
|
||
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 内容（含安全规则）
|
||
- 本模板中所有标识符已脱敏，可安全公开
|