SuperAPI AI 工具集

gjc-sdk-discover

通用与其它

查看项目

更新于 10-16 06:16

技能介绍

用途:面向外部代理,用于发现与检查本地受信任的 GJC 会话;通过 broker 绑定的会话 CLI 进行,不依赖终端抓取、MCP 或 coordinator 委派。

主要能力:先用 gjc sdk session list --json 列出会话并消费其不含凭证的 Broker DTO,选定精确 session ID 后,用 gjc sdk session inspect <sessionId> --json 或 raw query 命令检查。核心检查配方按序组合:gjc sdk session raw query <sessionId> --query <query> --json,依次查询 session.metadata、context.get、goal.list/get、todo.list、workflow.gates.list、session.stats;仅在任务需要时读取 transcript.list、transcript.body 与 diff.list_files、diff.list_hunks、diff.read_hunk。每次机器 CLI 调用须显式加 --json;非零退出时消费 gjc.command-error version 1 的 stdout envelope,用法错误退出码 2,操作失败为 1。读取非原子快照,每个字段需标注来源查询并分类为 confirmed、inferred、stale、unavailable 或 unknown,保留部分结果,不臆造缺失值。

限制:对缺失、不可用、过期、失效、未知或有歧义的 Broker 结果应失败关闭;禁止扫描 .gjc/state/sdk、解析 endpoint 记录、读取凭证或打开原始 per-session WebSocket。帮助、普通错误与证据页各不超过 8192 UTF-8 字节,不界定成功查询正文。仅当失败声明有已验证的保留续体时才按返回 argv 检索,保留期恰为 24 小时且非滑动。磁盘、权限、配额或发布失败可能出现 complete: false、evidence.status: "unavailable"、continuation: null,不得盲重放或虚构定位符。其他细节暂未提供。