SuperAPI AI 工具集

setup

部署与运维

查看项目

更新于 10-15 21:53

技能介绍

用途:humane:setup 是 humane 技能体系中的环境诊断与配置技能,先诊断机器实际缺什么,再只修复用户同意修复的部分,避免先安装后报告。

主要能力:doctor 只读诊断,不写入、不安装、不索取密钥;仅在存在真正阻塞性缺口时退出码为 1,缺少可选组件仍退出 0。config 可查看与设置配置,并打印每个取值的来源。配置优先级为项目 humane.json > ~/.humane/config.json > HUMANE_* 环境变量 > 内置默认值。可配置项包括 corpus_root(默认 ~/jtbd)、token_base、image_backend、task_export、language、design_tool、artifact_root(默认 .design)、browser_tool。doctor 还会枚举已知技能根目录与已注册插件市场,将副本分类为 linked、链接到其他来源、缺失若干文件、暂时一致,用于发现副本漂移。

使用方式:先运行 doctor 并逐条向用户说明输出,把缺口作为事实而非警报报告;再逐项询问仍为默认值且与当前任务相关的设置,写入时说明文件名与作用域;随后按 doctor 打印的同一命令逐条确认安装,非交互运行需 --yes,斜杠命令需由用户在智能体中执行;安装后重新运行 doctor 验证。

限制:漂移只报告不自动修复;不读取、写入、打印或传递密钥,只指出缺失的环境变量名;配置文件存在但 JSON 无效时,doctor 与 config 会标记所有取值可疑,config 退出非零,config --set 拒绝写入;design_tool 属于宿主能力,doctor 无法验证;缺少浏览器工具时,驱动式走查回退为让用户自行操作。具体安装命令与命令目录见 references/commands.md,资料未提供其内容。