SuperAPI AI 工具集

engram-plugin-thin

智能体与模型

查看项目

更新于 10-15 21:50

技能介绍

用途:在编辑插件钩子/脚本/适配器、接入被动或主动记忆采集集成、配置特定智能体的初始化行为时使用本技能。

主要能力与规则:适配器保持精简,只做解析输入、调用 API/工具、返回三步;复杂逻辑放入 Go 内核(store/server/mcp);避免为插件脚本引入额外运行时依赖;在所有支持的智能体间复用共享契约。

Pi 特例:Pi 原生 mem_save 可能只能解决模糊确认,因为 Go 服务端无法观测到某客户端丢失了确认。Go 仍是持久账本、规范指纹、校验、冲突、墓碑、保留与变更效果的唯一权威。初始派发前生成一个操作 UUID 并冻结精确的脱敏载荷及两个目标。遇到模糊时只查询权威的 GET /observations/save-result。带 code observation_save_result_not_found 的类型化 404 允许在可取消的 250 ms 退避后进行一次精确重放。重放收据为正则立即成功;只有模糊重放(含重放 409 或 410)才做最后一次 GET。保持现有总截止时间与调用方取消边界。查询只有在正 ID 且 status: "committed" 时才确认成功;初始 POST 成功保留旧式正 {id} 确认兼容。初始收到的 HTTP 错误保持类型化,绝不重放或自愈。调用方取消应被传播;未解决的写入不确定性保持未知,绝不视为已保存。该例外不授予其他路由或工具重试权、不建通用重试框架、不做本地业务账本决策、不豁免遥测。计时遥测不得记录操作 UUID;不授予更广日志权限,也不改变现有面向用户的未知结果诊断。

兼容性检查清单:Claude Code 流程仍可用、OpenCode 流程仍可用、Gemini/Codex 配置路径仍有效、文档反映真实集成行为。