版本: v1.0 | 更新: 2026-07-08 适用范围: 全Profile（运维/财务/项目/品宣/研学/行政/商务/其他） 存放位置:
/root/.hermes/BOT_BEHAVIOR_MANUAL.md
所有写入 /var/www/html/ 生产目录的文件，一律使用 base64 方式，不走 write_file 工具。
write_file 对相对路径的解析存在不可靠性，可能写入到非预期位置（如 /root/ 下）但返回成功状态码。
标准流程：
# ① base64 编码内容
base64_content=$(echo -n "文件内容" | base64 -w 0)
# ② 写入绝对路径
echo "$base64_content" | base64 -d > /var/www/html/products/目标文件.html
# ③ 验证文件大小
wc -c /var/www/html/products/目标文件.html
# ④ 验证页面可访问
curl -sL -o /dev/null -w "%{http_code} %{size_download}" https://sxbh.ltd/products/目标文件.html
如果验证结果与预期不符（文件大小偏小或 HTTP 非 200），立即重新写入。
安装任何新软件/包之前，必须先做安全评估。
检查维度： - 来源可信度（官方源 vs 第三方 PPA） - 权限要求（是否需要 root） - 网络行为（是否会外连） - 社区评价（GitHub stars、维护状态）
执行高危命令前先调用 approval-gate。
# Step 1: Dry-Run 安全预览
approval-gate dry-run "<命令>"
# → READY / WARNING / BLOCKED
# Step 2: 高风险命令熔断
approval-gate check "<命令>"
# → LOW/MEDIUM 自动放行
# → HIGH/CRITICAL 拦截，等人工确认
| # | 铁律 | 说明 |
|---|---|---|
| 1 | 唯一执行人 | 一个任务只由一个 agent 执行，有人认领不得并行 |
| 2 | 先确认再落笔 | 动工前先在群聊确认方案 |
| 3 | 写后必验证 | 改完立即验证语法/功能 |
| 4 | 进度汇总归研学 | 老板问全局进度时等研学汇总 |
| 5 | 文件写前占位 | 先喊 我要改 xxx，改完喊 已释放 xxx |
| 6 | bus/send 不送达 Bot | 广播只到用户，不到 Bot 自己 |
| 7 | 定时任务新增前避让 | 见第4节 |
发现问题时直接通过 system-bus 调度对方 Bot 修复，不只报告问题。
curl -s -X POST http://127.0.0.1:8660/bus/send \
-H 'X-API-Key: system-bus-relay-key-2026' \
-d '{"touser":"200653946","agentid":<AGENT_ID>,"msgtype":"markdown","content":"..."}'
注意：bus/send 只发消息给用户，不发消息给 Bot 自己。要让另一个 Bot 执行任务，需要用对方的 API Server 或直接编辑其文件后重启网关。
各Bot Agent ID：
| Bot | Agent ID | API Server | 端口 |
|---|---|---|---|
| 财务 | 1000040 | ❌ 关闭 | 8651 |
| 项目 | 1000039 | ❌ 关闭 | 8650 |
| 品宣 | 1000037 | ❌ 关闭 | 8642 |
| 行政 | 1000020 | ❌ 关闭 | 8646 |
| 研学 | 1000032 | ❌ 关闭(未认证) | 8652 |
| 商务 | 1000043 | ❌ 关闭 | 8647 |
| 运维 | — | ✅ 开启 | 8649 |
| 老板 | 1000041 | ❌ 未配置 | 8648 |
清理 /root/ 下的项目代码前，必须先做部署交叉验证。
三步法： 1. 收集部署链路信息（Docker / Nginx / 进程） 2. 收集 /root 项目信息 3. 交叉对照：有 Nginx 域名 + 进程 cwd 指向 /root → 不可删
所有 Profile 新增定时任务前，必须先跑预检定时任务脚本，避开已有时间段。
无法避开时（如业务必须特定时间），必须通过运维BOT告知管理者（任富海）。
python3 /root/.hermes/profiles/wecom-ops/scripts/check-cron-conflict.py "分 时" "任务名"
# 示例
python3 check-cron-conflict.py "30 14" "数据同步"
# → ✅ 空闲 或 ⚠️ 列出冲突任务
完整排布表：/root/.hermes/profiles/wecom-ops/scripts/CRON_SCHEDULE.md
禁止扎堆时段: 08:00~09:30（已排 17 个任务）
| 优先级 | 规则 |
|---|---|
| 🥇 | 选完全空闲的时段 |
| 🥈 | 与同Profile任务间隔 ≥ 15分钟 |
| 🥉 | 跨Profile任务可适当靠近 |
curl -s http://127.0.0.1:8800/send -d 'msg=消息内容&source=Bot名称'
| Bot | 视角 |
|---|---|
| 运维 | 技术可行性：服务器撑不撑得住、安全风险、技术资源 |
| 财务 | 财务影响：投入多少、多久回本、现金流压力 |
| 项目 | 项目管理：时间进度、代码质量、CI/CD |
| 商务 | 商务条款：合同、供应商、商务风险 |
| 品宣 | 内容/设计：品牌形象、用户体验 |
| 行政 | 行政流程：流程合规、资源协调 |
| 研学 | 技术调度：方案评估、跨Profile协调、研究 |
所有 Shell/Python 运维脚本遵循 四层契约：
# 输入层：命令行参数 / 环境变量 / 配置文件
# 输出层：stdout 结构化输出
# 错误层：stderr 退出码 + 错误信息
# 元数据层：版本号、运行时间、调用方
详见：ops-tool-standard skill
| 角色 | R 执行者 | A 拍板人 | C 咨询者 | I 知会者 |
|---|---|---|---|---|
| 运维 | 系统监控、安全审计、故障处理 | 系统配置变更、安全策略 | 架构变更方案 | 重大故障通知 |
| 财务 | 成本核算、财务日报、预算监控 | 预算控制 | 采购方案评估 | 预算超支告警 |
| 项目 | 代码编译、CI/CD、版本发布 | 代码合并、发布审批 | 技术选型 | 发布通知 |
| 商务 | 合同流转、供应商对接 | 商务条款审批 | 风险评估 | 合同到期提醒 |
| 品宣 | 内容创作、设计出图 | 内容审核、品牌规范 | 创意方向 | 品牌舆情 |
| 行政 | 流程执行、通知下发 | 行政决策 | 流程优化建议 | 异常上报 |
| 研学 | 技术研究、方案验证 | 技术方案选型 | 行业调研 | 研究发现通报 |
通用铁律: 高危操作需 approval-gate 审批。预算审批不跨过任富海。
# 安全熔断
approval-gate dry-run "<命令>"
approval-gate check "<命令>"
# cron预检
python3 /root/.hermes/profiles/wecom-ops/scripts/check-cron-conflict.py "分 时" "任务名"
# 发全员群
curl -s http://127.0.0.1:8800/send -d 'msg=...&source=Bot名'
# 跨Bot调度
curl -s http://127.0.0.1:8660/bus/send -H 'X-API-Key: system-bus-relay-key-2026' \
-d '{"touser":"200653946","agentid":<ID>,"msgtype":"markdown","content":"..."}'
# 文件写入生产目录
echo "base64内容" | base64 -d > /var/www/html/<路径>
wc -c /var/www/html/<路径>
curl -sL -o /dev/null -w "%{http_code}" https://sxbh.ltd/<路径>
1000041 → boss 1000040 → finance 1000039 → project
1000037 → creative 1000032 → yanxue 1000020 → admin
1000043 → business 1000045 → employees
/root/.hermes/profiles/wecom-ops/scripts/CRON_SCHEDULE.md