检查并更新 Tool

用途

用户直接描述希望修改的命令、参数或输出后，先读取当前版本并展示简洁的四段式计划：修改内容、版本选择、影响范围、工具作用；不要在主展示中列出完整配置或内部执行细节。确认修改意图后，必须先执行 fkit tool info TARGET:VERSION --json 查询 Flow 引用状态；查询成功前禁止展示更新模式。若 locked=true，只能展示“创建新版本”并说明保留旧版本；若 locked=false，才让用户选择“修改当前版本”或“创建新版本”。随后展示对应计划并确认一次。check 模式仅用于只读查看。

语法

fkit update <TOOL[:VERSION]> [OPTIONS]

参数与选项

• --mode <MODE> — 选择 check（默认）、in-place 或 new-version；对话式更新必须先用 fkit tool info TARGET:VERSION --json 查询锁定状态；查询失败则停止，禁止猜测。未锁定时让用户选择当前版本或新版本；锁定时只能创建新版本。
• --config <FILE> — 配置 JSON 补丁；新版本会基于所选基线合并。
• --summary <FILE> — Markdown 摘要替换内容。
• --dry-run — 执行本地与只读校验，但不提交创建或更新请求；正式对话流程不单独要求 dry-run。
• --json — 输出机器可读 JSON。

影响范围

会向 BioLine 写入、创建或更新所选远端对象。

安全使用

目标为 Tool 名称或精确 NAME:VERSION，版本必须是正整数。fkit 不在本地扫描 Flow 引用：in-place 要求精确版本并至少提供配置或摘要；若该版本仍被 Flow 引用，BioLine 服务端会拒绝，fkit 原样呈现该错误，不重试、不自动切换模式、也不另建版本。若配置和摘要同时更新，配置先写、摘要后写，摘要请求复用已准备好的命令，两个请求不具备原子性；失败会报告部分成功。new-version 复用基线版本已存于服务端的镜像（fkit 自动读取基线的 path，不再上传本地镜像），创建请求本身携带命令与摘要，因此通常只需一次写入，创建后核验恰好新增 max+1 版本并读回比对新版本的命令与摘要；若服务端没有保留请求体中的配置，fkit 只对刚创建的版本补发一次更新的 update，绝不多写或循环。--dry-run 只做本地与只读校验，不提交创建或更新请求。

输出

支持 --json 输出检查或操作结果；新版本结果包含前后版本列表、基线、创建验证、配置核验（configVerified、configSource）与写入次数（remoteWriteCalls）。

读取本页

添加 --docs 可在解析业务必填参数、登录或执行命令前从 BioLine 官方 AI 文档服务读取本页。使用 --docs-lang zh|en 选择语言，使用 --docs-json 返回文档 JSON。索引与 Markdown 均从同一官方 AI 服务读取；索引固定为 https://www.bioline.cloud/ai/commandLineAndFkit/。

fkit update --docs --docs-json --docs-lang zh