优康云 CLI 命令文档

优康云 CLI（ukang）面向体检机构实施人员、自动化脚本和 AI 工具。对 AI 说一句：帮我安装优康云体检软件。AI 可根据优康云安装清单，自动下载组件、执行安装、检查环境、申请账号并生成实施报告。第一阶段已开放环境检测、Manifest 读取和诊断报告能力，自动安装、开户注册和云绑定能力正在升级。

产品定位：优康云体检智能体，让体检软件从人工实施进入 AI 自动交付。
当前状态：doctor、check-env、status、version、check manifest、register-org 为第一阶段开放能力。安装、绑定云端和安装网关命令为即将支持能力，页面保留命令协议和安全要求，不表示当前已可自动完成正式开通。

全局约定

项目说明
默认输出--json，便于 AI 工具解析。
人工查看--text，输出便于实施人员阅读的诊断信息。
安装清单--manifest <url-or-path>，默认读取 https://www.ukang.cc/manifest/ukang-agent-manifest.json。
云端 APIregister-org 默认读取 Manifest 中的 agentApi.defaultBaseUrl，也可用 --api-base <url> 指定本地或 117 内测 API。
失败处理命令失败必须返回非 0 退出码、明确错误码和原因，不允许静默吞错或失败后假成功。
敏感信息不得在前端、Manifest 或示例中写死 MySQL 密码、云端密钥、机构密钥。

命令清单

命令示例作用状态
ukang doctor完整环境诊断，生成实施诊断报告。第一阶段开放
ukang check-env检查操作系统、端口、运行库、MySQL、权限。第一阶段开放
ukang install mysql84安装 MySQL 8.4，注册服务并初始化字符集。即将支持
ukang install health-exam安装优康云体检软件主体。即将支持
ukang register-org --name "某某体检中心" --phone "13800000000"申请优康云机构账号，提交后进入待审核流程，不默认开通正式机构。第一阶段开放
ukang bind-cloud --org-code "YK202605240001"绑定本地系统到已审核通过的云端机构。即将支持
ukang install gateway安装云网关，启用预约同步、报告上传和消息拉取。即将支持
ukang status查看当前安装状态和组件运行状态。第一阶段开放

推荐执行顺序

ukang doctor
ukang check-env
ukang install mysql84
ukang install health-exam
ukang register-org --name "某某体检中心" --phone "13800000000"
ukang bind-cloud --org-code "YK202605240001"
ukang install gateway
ukang status

诊断命令

ukang doctor 用于完整环境诊断，输出操作系统、内存、磁盘、端口、.NET Runtime、MySQL、体检软件主体、云网关和 Manifest 可达性等信息，并生成实施报告。

ukang doctor --json
ukang doctor --text

ukang check-env 用于快速检查安装前置条件，重点覆盖操作系统、端口、运行库、MySQL、权限。

ukang check-env --json

安装命令

ukang install mysql84 用于安装 MySQL 8.4。该能力即将支持，正式开放后应校验安装包 SHA256，不得将数据库密码写入网页或 Manifest。

ukang install mysql84

ukang install health-exam 用于安装体检软件主体。该能力即将支持，正式开放后应从本机安全配置或交互输入获取数据库连接信息。

ukang install health-exam

云端开通命令

register-org 用于申请优康云机构账号。机构开户注册必须进入待审核或验证码确认流程，不得默认放行。未指定 --api-base 时，CLI 会先读取 Manifest 中的 agentApi.defaultBaseUrl；117 内测 API 上线后，只需要更新 Manifest 即可让 AI 工具指向内测环境。

ukang register-org --name "某某体检中心" --phone "13800000000"
ukang register-org --name "某某体检中心" --phone "13800000000" --api-base http://localhost:5048

bind-cloud 用于绑定已审核通过的云端机构。绑定所需密钥应由云端下发或本机安全输入，不得硬编码。

ukang bind-cloud --org-code "YK202605240001"

install gateway 用于安装云网关，后续承载预约同步、报告上传、报告推送和云端规则下发。

ukang install gateway

状态命令

ukang status 用于查看当前安装状态，适合 AI 在每一步执行后判断是否继续。

ukang status --json

返回 AI 安装页面