SuperAPI AI 工具集

settings

编程与开发

查看项目

更新于 11-16 04:58

技能介绍

Repowise Settings 是 Repowise 的配置查看与变更工具,围绕 repowise config 命令组织。每个 Repowise 设置(.repowise/config.yaml 中的键、两个用户级开关以及 REPOWISE_* 环境变量)均可被列出、解释和修改。官方建议不要直接读取或编辑配置文件,而是通过该工具操作:它会显示设置的当前生效值及其来源(默认、仓库文件、用户文件或环境),在 set 时校验取值并写入该设置实际所在位置。

主要能力:

  1. 查看变更项:repowise config list --changed 列出当前仓库相对默认值所做的改动及每个值的来源,适合排查异常时首先使用。
  2. 按区域查看:repowise config list --area <area> 查看某一区域的设置与取值。区域包括 account、attribution、decisions、distill、editor、events、generation、health、hooks、indexing、mcp、providers、server;不带区域参数时按区域显示全部设置。
  3. 解释单个设置:repowise config explain <key> --format json 说明该设置的作用、可接受值、默认值、变更何时生效(applies),以及修改和重置它的确切命令(set_with、reset_with)。
  4. JSON 输出:在上述命令后加 --format json 即可解析结果;list 返回 {"repo", "settings": [...]},每个设置包含 key、description、value、source、default 和 changed 字段。官方建议优先结合 --area 或 --changed 使用 JSON,因为完整列表较大。

使用方式:修改前先向用户说明要改的键、新值和影响,征得同意后才执行 repowise config set <key> <value>。开关接受 true/false,列表接受 a,b 或 [a, b]。文本输出较简短;--format json 会给出每个被改动设置的前后状态。需要转达影响和命令打印出的撤销方式;某些开关会连带影响其他设置(例如 decisions.mode 会重置更细粒度的决策开关),此时应说明所有被移动的设置,而不只是所设置的那一个。若提示环境变量优先于文件(JSON 中的 env_override),应告知用户在取消该变量前由它决定取值。repowise config reset <key> 可将设置恢复默认;被拒绝时退出码为 1 并返回 {"error", "message", ...},错误类型包括 unknown_setting(消息会建议相近名称)、invalid_value(accepts 说明可接受值)、env_only(该设置是环境变量,需告知用户在哪里设置)和 config_unreadable(文件损坏,未写入任何内容)。

适用场景:用户询问可修改哪些设置或如何开关某功能;用户询问成本开销,如每次会话新增的 token、更新期间的模型调用、每次工具调用运行的钩子;出现异常行为(如“这个钩子为什么触发”“这些页面为什么缺失”)而某项设置可能解释原因;用户要求更改 Repowise 选项。

限制与注意事项:不得自行主动变更设置;不要手工编辑 .repowise/config.yaml,因为 set 会校验取值并保持文件其余部分不变。