SuperAPI AI 工具集

brain-link-discipline

智能体与模型

查看项目

更新于 10-16 05:48

技能介绍

用途:这是一条报告约定,用于约束 gbrain 中 brain 页面的交付消息。核心规则是:若提交并推送了 brain 页面,链接必须出现在报告该工作的同一条消息中,用户无需再索要链接。适用于新建或编辑页面的报告、批量报告(每页单独一行链接)、日常对话中引用 brain 页面,以及转述提及 brain 路径的子代理结果。

主要能力与机制:区分两种输出面——聊天消息使用绝对且经验证的 URL;brain 页面正文内部使用相对 markdown 链接,因为 gbrain 的链接/反向链接图依赖文件系统相对链接,绝对 URL 对图不可见。路径需机械推导,而非手写:cd "$(dirname <file>)" && git ls-files --full-name "$(basename <file>)",再拼 https://<host>/<owner>/<repo>/blob/<branch>/<路径>。顺序为先推送后给链接,推送成功(退出 0 并打印 pushed <sha>)才输出链接。有托管远端时先验证路径存在,仅在 200 时发送;令牌只发给其签发主机。回退链依次为:经验证的托管 URL、仓库相对路径加范围说明、gbrain publish 生成的本地 HTML 文件(作为可附件,绝不当作 URL)。子代理返回本地路径,转述前必须重写。

限制:这是约定而非工具强制保证;私有仓库链接仅对仓库成员可见,不适合对外分享;推送未落地前链接会 404,不得猜测 URL;gbrain publish 输出的是本地文件路径。具体错误处理与命令细节以资料所述为准,其余未提供。