文档目录 7 / 9
ICEONIX 文档 07 / 09

Hermes、CLI 与 MCP

Hermes / Agent 负责理解需求、生成脚本和编排任务;冰爪负责确定性的本地执行、锁、重试、Safari 操作、结果验证和写回。你也可以完全通过 App 手动使用冰爪。

从开箱设置接入 Hermes

在“开箱设置”或“AI 团队 → Agent”中可以完成:

  1. 安装或检测 Hermes。
  2. 安装 iceonix 命令行桥接。
  3. 创建默认 Agent Profile。
  4. 同步 Iceonix Skill 与 MCP 配置。
  5. 按 Hermes 官方向导配置模型和通信网关。

冰爪不另造一套模型供应商或通信配置。模型、Key、飞书 / 微信等通道由 Hermes 管理。

AI 团队页面

  • Agent:安装、初始化、状态和接入操作。
  • Hermes WebUI:对话、历史和运行日志。
  • 成员:管理多个 Profile / Agent。
  • 创作核:维护共享 AGENTS.md 和资料库,让不同 Agent 使用一致的创作规则。

项目目录和 Workspace 仍是内容事实源;Agent 记忆只用于辅助理解,不应替代项目状态。

CLI

CLI 适合终端脚本和诊断。安装后可先查看帮助:

iceonix --help
iceonix platforms

常用能力包括发布、平台登录检查、模型下载、转写、TTS、音频增强、音轨分离和说话人识别。

CLI / MCP 不会直接与 Safari 抢控制权。请求会通过本机 127.0.0.1 Relay 和随机令牌交给正在运行的 Iceonix App;App 必须保持打开。

MCP 工具范围

当前工具覆盖:

  • 视频单平台或多平台发布
  • 微信公众号文章上传到草稿箱
  • 平台登录检查、发起登录、等待扫码
  • 合集预设
  • 灵感列表、读取与 AI 加工
  • AI 生图
  • 视频转写与语音合成

工具名和 JSON 字段是 Agent 依赖的稳定契约,不建议在外部脚本中猜测未公开字段。

人工确认边界

真实发布属于不可逆操作。Agent 在调用前应向你复述:

  • 使用哪个素材
  • 发布到哪些平台
  • 标题、文案和标签
  • 原创与平台声明
  • 是否为 dry-run

信息不明确时先 dry-run。微信公众号最终群发始终需要在公众号后台人工确认;Agent 和冰爪只负责生成并上传草稿。

定时任务

如果你告诉 Hermes“明天发布”,应由 Hermes 保存计划并在到点后调用冰爪。冰爪收到 MCP 请求后立即执行或加入队列,不再重复创建另一份未来定时。

通过 App 或 iceonix.json 设置的本地项目仍可使用冰爪自己的定时和发布时间窗口。