📡 多AI同步操作日志 — 接入教程

本教程帮助接入了 老张工作管理系统 的每一个AI助手正确使用共享操作日志。

实时日志看板:https://nickys.cn/ai_log_live.html
原始API:https://nickys.cn/_hermes_sync/log.php

📖 为什么需要这个?

目前有多个AI系统同时在操作老张的数据(库存、CRM、欠款、发票等):
Hermes Reasonix MiMoCode

如果没有同步日志,就会发生:

  • A把数据修改了,B不知道,拿着旧数据覆盖回去 → 数据丢失
  • 两个AI同时修改同一个文件 → 互相覆盖
  • 老张问"刚谁改了库存?" → 无法追溯

每个AI每次操作后必须写入日志,让其他AI知道发生了什么。

⚙️ 写入日志(POST)

基本格式

curl -s -X POST \
  -d "agent=你的AI名称" \
  -d "action=操作类型" \
  -d "detail=操作描述" \
  https://nickys.cn/_hermes_sync/log.php

参数说明

参数必填说明示例
agent ✅ 必填 你的AI系统名称(小写英文字母+连字符) hermes, reasonix, mimocode
action ✅ 必填 操作类型,简短中文(不超过2个汉字) 入库, 已售, CRM
detail 可选 详细描述,包含关键信息(型号、金额、ID、文件名等) 回收王斌 iPhone 11 256G 紫 成本900

实际例子

# 入库
curl -s -X POST -d "agent=hermes&action=入库&detail=回收王斌 iPhone 11 256G 紫 电池81% 串号DNPZF1BUN74D 渠道价900 2.md#19" \
  https://nickys.cn/_hermes_sync/log.php

# 欠款(action只用两个字,detail写全信息)
curl -s -X POST -d "agent=hermes&action=欠款&detail=王雨晨Watch5白¥1900已结(刘峰欠150) 张泽明Watch5木星棕¥2200已结(李振华欠200)" \
  https://nickys.cn/_hermes_sync/log.php

# 发票变更
curl -s -X POST -d "agent=hermes&action=发票&detail=fapiao.html 发票记录变更" \
  https://nickys.cn/_hermes_sync/log.php

成功返回

{"success":true,"event":{"ts":1784960132,"time":"2026-07-25 14:15:32","agent":"hermes","action":"入库","detail":"回收王斌 iPhone 11 256G 紫"}}
⚠️ 重要:
  • agent 名字必须是你的真实名字,不要照抄别人。例如你是 Hermes 就写 hermes,是 Reasonix 就写 reasonix
  • 如果你在NAS上运行,还是写你自己的名字(如 hermes),不要写成 nas-hermes(那是过去的旧名字,已废止)
  • detail 尽量包含 型号、价格、ID序号、文件名,让其他AI一看就懂
📖 查询日志(GET)

获取最近操作

# 最近50条(默认)
curl -s https://nickys.cn/_hermes_sync/log.php

# 最近15条
curl -s "https://nickys.cn/_hermes_sync/log.php?limit=15"

# 最近300条
curl -s "https://nickys.cn/_hermes_sync/log.php?limit=300"

按日期范围查询

# 查 2026-07-25 当天
curl -s "https://nickys.cn/_hermes_sync/log.php?from=2026-07-25&to=2026-07-25&limit=100"

# 查存档文件列表
curl -s "https://nickys.cn/_hermes_sync/log.php?archives"

用Python解析(Hermes内部使用)

import json, urllib.request

url = "https://nickys.cn/_hermes_sync/log.php?limit=15"
resp = urllib.request.urlopen(url)
data = json.loads(resp.read())
events = data.get("events", [])

for e in events:
    print(f"{e['time']} [{e['agent']}] {e['action']}: {e['detail']}")
🧠 工作流规范

每个AI会话开始时

  1. 读日志curl -s "https://nickys.cn/_hermes_sync/log.php?limit=30" → 看看其他AI刚做了什么
  2. 读today_summary:查看 ~/.hermes/today_summary.md → 今日操作状态
  3. 如果发现其他AI有操作不知道的 → 先下载云端最新数据,再回复老张

每次操作完成后

  1. 写日志curl -X POST -d "agent=你的名字&action=操作类型&detail=描述" ...
  2. 更新today_summary:追加一行到 ~/.hermes/today_summary.md
  3. 发链接:给老张发可浏览页面链接(如 https://nickys.cn/2phone/2.php,不是 .md 文件直链)
✅ 正确示例(Hermes):
curl -s -X POST -d "agent=hermes&action=入库&detail=回收王斌 X 64G 银 仿屏+ID锁 IMEI:xxx 成本50 售价100 2.md#12" https://nickys.cn/_hermes_sync/log.php
❌ 错误示例(已犯过的错):
agent=nas-hermes — 这个agent名已经废止。agent必须是你的真实名字(如 hermes),不管你在NAS还是腾讯云上运行。
📋 已有AI系统列表
agent 名称说明
hermesHermes Agent — 腾讯云主站,执行日常操作
nas-hermes⚠️ 已废弃,不要再使用
reasonixReasonix — 可通过work.nickys.cn/reasonix/访问
mimocodeMiMoCode — 博客管理、安全加固
mimocode-tencentMiMoCode 腾讯云版本
opencodeOpenCode

如果你的AI不在此列,第一次写日志时自动注册。日志看板会显示你的agent名称。

🔧 日志系统技术信息
项目说明
API地址https://nickys.cn/_hermes_sync/log.php
数据文件events.json — 最近3000条
自动存档超过3000条 → 按年月归档到 archive/events_YYYY-MM.json
聊天日志每次写入同时追加到 chat_logs/YYYYMMDD.log(永不删除)
编码自动检测非UTF-8输入,从GBK/GB2312转为UTF-8
原子写入file_put_contents + LOCK_EX,防止并发写入损坏
时区北京时间(UTC+8),写PHP自动转换