{ "schemaVersion": "1.0", "product": "ukang-health-exam-agent", "name": "优康云体检智能体", "description": "优康云体检软件 AI 安装与配置体系。第一阶段采用轻量交付：官网提供 AI 可读 manifest、CLI、文档、云端 Agent API 和人工下载入口；MySQL、.NET、OpenCode 等通用运行环境由用户或 AI 工具从官方渠道安装；大型历史/完整安装包不作为 AI 自动交付首选。", "implementationPhase": "phase-1", "phaseDescription": "Phase 1: AI 优先下载 CLI 并读取 manifest；MySQL/.NET 由 AI 从官方渠道安装或连接已有环境；体检软件完整包保留为人工/历史下载入口；自动安装、云绑定和网关安装继续升级。", "homepage": "https://www.ukang.cc/ai-install.html", "updatedAt": "2026-05-24", "agentApi": { "status": "internal-test", "defaultBaseUrl": "https://v5.ukang.cc", "productionBaseUrl": "", "internalTestBaseUrl": "https://v5.ukang.cc", "registerOrgEndpoint": "/api/agent/register-org", "registerStatusEndpoint": "/api/agent/register-status", "cloudBindingConfigEndpoint": "/api/agent/cloud-binding-config", "installReportEndpoint": "/api/agent/install-report", "downloadTokenEndpoint": "/api/agent/download-token", "versionEndpoint": "/api/agent/version", "reviewMode": "pending_review", "note": "v5.ukang.cc 为 59 云服务器上的 ukang-cloud-v5 内测 API。机构开户注册必须进入待审核流程，不默认开通正式机构。" }, "components": [ { "id": "mysql84-runtime", "name": "MySQL 8.4 运行环境", "version": "8.4.6", "required": true, "status": "external-managed", "available": false, "description": "MySQL 8.4 或兼容 MySQL 服务由用户或 AI 工具从官方渠道安装，也可连接已有 MySQL、PolarDB 或合规数据库环境。优康 manifest 只声明版本建议、字符集、端口、权限和检查要求，不托管 MySQL 安装包。", "platform": "windows-x64", "downloadUrl": "", "sha256": "", "size": "", "sourceFiles": [ ], "manualInstallGuide": "https://www.ukang.cc/downloads/mysql84-runtime.html", "installCommand": "ukang install mysql84", "installCommandStatus": "external-managed", "checkCommand": "ukang check mysql84", "checkCommandStatus": "phase1", "phase1Behavior": "Only checks whether a compatible MySQL service is reachable, port 3306 state, charset/collation requirements, and required config shape. It does not download MySQL, install MySQL, initialize passwords, create databases, or write config files.", "requiredConfigShape": { "ServiceName": "MySQL84", "Port": 3306, "CharacterSet": "utf8mb4", "Collation": "utf8mb4_general_ci", "RootPassword": "\u003ccollect-or-generate-securely; never place in manifest or docs\u003e", "ApplicationDatabase": "btv10b", "ApplicationUser": "ukang_app", "ApplicationPassword": "\u003ccollect-or-generate-securely\u003e", "DataDirectory": "C:\\ukang\\mysql84\\data", "InstallDirectory": "C:\\ukang\\mysql84" }, "requiredBy": [ "ukang-health-exam" ] }, { "id": "ukang-health-exam", "name": "优康云体检软件主体", "version": "10.1.125-beta", "required": true, "status": "manual-legacy", "available": false, "description": "btv10b 体检管理信息系统 V10 社区版完整包保留为人工/历史下载入口，不作为 AI 自动交付首选。AI 应优先安装 CLI、检查环境、完成开户注册和诊断报告；后续将提供轻量化业务组件或安装协议。", "platform": "windows-x64", "downloadUrl": "", "sha256": "89B59FC7B1254C26E425790192A9992D7B9738DA85C14DE4EBEA6489AC55D411", "size": "774.2 MB", "sourceFiles": [ "downloads/btv10b-社区版完整安装包-10.1.125-beta.zip" ], "manualInstallGuide": "https://www.ukang.cc/downloads/ukang-health-exam.html", "installCommand": "ukang install health-exam", "installCommandStatus": "phase1-preflight", "checkCommand": "ukang check health-exam", "checkCommandStatus": "phase1", "phase1Behavior": "Only checks package presence when a local/manual package already exists, base SQL, install root, port 8001, .NET runtime, and MySQL preflight state. It does not download the 800MB legacy package, unzip packages, create databases, write connection strings, or start services.", "requiredConfigShape": { "InstallRoot": "C:\\ukang\\btv10b", "HttpPort": 8001, "Database": { "Provider": "MySql", "Host": "127.0.0.1", "Port": 3306, "Database": "btv10b", "User": "ukang_app", "Password": "\u003ccollect-securely; never place in manifest or docs\u003e", "CharacterSet": "utf8mb4" }, "Cloud": { "MachineCode": "\u003cukang machine-code\u003e", "ApiBaseUrl": "https://v5.ukang.cc", "OrgId": "\u003cavailable after approval\u003e" } }, "requires": [ "mysql84-runtime" ], "defaultPort": 8001, "defaultAccounts": [ { "username": "BT管理员", "password": "888888" }, { "username": "sqgly", "password": "888888" } ] }, { "id": "ukang-cloud-gateway", "name": "优康云云网关", "version": "5.0", "required": false, "status": "placeholder", "available": false, "description": "连接本地 btv10b 与优康云平台，处理预约同步、报告上传、消息拉取和机构小铃铛提醒。当前未发布独立安装包，需通过申请试用由平台人员协助部署。", "platform": "windows-x64", "downloadUrl": "https://www.ukang.cc/downloads/ukang-cloud-gateway", "sha256": "", "size": "", "sourceFiles": [ ], "manualInstallGuide": "https://www.ukang.cc/downloads/ukang-cloud-gateway.html", "installCommand": "ukang install gateway", "installCommandStatus": "phase1-preflight", "checkCommand": "ukang check gateway", "checkCommandStatus": "phase1", "phase1Behavior": "Only checks cloud binding, expected local path, config path, and Windows service state. It does not download packages, write config, store secrets, or install a service.", "expectedRoot": "C:\\ukang\\gateway", "expectedConfigPath": "C:\\ukang\\gateway\\appsettings.Production.json", "requiredConfigShape": { "ApiBaseUrl": "https://v5.ukang.cc", "OrgId": "\u003capproved-org-id\u003e", "GatewayId": "\u003cmachine-code-or-issued-gateway-id\u003e", "GatewaySecret": "\u003cstore-securely; never place in manifest or docs\u003e", "LocalBtv10b": { "BaseUrl": "http://127.0.0.1:8001", "Database": "\u003clocal connection name or secure reference\u003e" }, "EnabledTasks": [ "appointment_sync", "report_upload", "notification_pull" ] }, "requires": [ "ukang-health-exam" ], "note": "暂不可自动安装。如需云网关服务，请通过 index.html#trial 提交试用申请。" }, { "id": "ukang-cli", "name": "优康云 CLI", "version": "1.0.0", "required": true, "status": "phase1", "available": true, "description": "命令行工具第一阶段内测包，面向 AI 智能体、实施人员和自动化脚本。当前支持 doctor / check-env / status / version / check manifest / check mysql-connection / agent-version / download-token / register-org 待审核申请，并在 doctor 报告中包含 MySQL、MySQL / PolarDB 连接、体检软件主体和云网关预检结果。真实自动安装仍处于升级中。", "platform": "windows-x64", "downloadUrl": "https://www.ukang.cc/downloads/ukang-cli/ukang.exe", "sha256": "5977ACD7799A5E11A28EC31C3662DFCCC90C9D5414E2D24E13C034A3BA95ACCA", "size": "36580661 bytes", "sourceFiles": [ ], "cliDocUrl": "https://www.ukang.cc/docs/cli.html", "installCommand": "ukang doctor", "installCommandStatus": "phase1", "checkCommand": "ukang status", "checkCommandStatus": "phase1", "phase1AvailableCommands": [ "ukang version", "ukang doctor", "ukang doctor --submit", "ukang check-env", "ukang check manifest", "ukang check mysql84", "ukang check mysql-connection", "ukang check health-exam", "ukang check gateway", "ukang status", "ukang agent-version", "ukang download-token", "ukang register-org", "ukang register-status", "ukang bind-cloud", "ukang install mysql84", "ukang install health-exam", "ukang install gateway", "ukang submit-report" ], "phase1AvailableTools": [ "check_environment", "get_manifest", "get_agent_version", "get_download_token", "get_install_report", "check_mysql84", "check_mysql_connection", "install_mysql84_preflight", "check_health_exam", "install_health_exam_preflight", "check_gateway", "register_org_pending_review", "get_registration_status", "get_cloud_binding_config", "install_gateway_preflight", "submit_install_report" ], "note": "CLI 第一阶段内测包可下载。register-org 只提交待审核申请，不会默认开通正式机构。" }, { "id": "ukang-mcp-server", "name": "优康云 MCP Server", "version": "1.0.0", "required": false, "status": "placeholder", "available": false, "description": "MCP (Model Context Protocol) Server（第一阶段规划），供 AI 工具通过标准化协议调用优康云安装检测能力。第一阶段先暴露 check_environment / get_manifest / get_install_report 三个安全工具。", "platform": "windows-x64", "downloadUrl": "https://www.ukang.cc/downloads/ukang-mcp-server", "sha256": "", "size": "", "sourceFiles": [ ], "mcpDocUrl": "https://www.ukang.cc/docs/mcp.html", "installCommand": "ukang mcp install", "installCommandStatus": "planned", "checkCommand": "ukang mcp status", "checkCommandStatus": "planned", "phase1AvailableTools": [ "check_environment", "get_manifest", "get_install_report" ], "note": "MCP Server 为第一阶段规划。当前请通过官网页面手动下载各组件。" }, { "id": "dotnet-runtime", "name": ".NET 8 运行时", "version": "8.0.24", "required": true, "status": "external-managed", "available": false, "description": ".NET 8 运行时由用户或 AI 工具从 Microsoft 官方渠道安装。优康 manifest 只声明运行时要求和检查命令，不托管 .NET 安装包。", "platform": "windows-x64", "downloadUrl": "", "sha256": "", "size": "", "sourceFiles": [ ], "manualInstallGuide": "https://www.ukang.cc/downloads/dotnet-runtime.html", "installCommand": "ukang install dotnet", "installCommandStatus": "external-managed", "checkCommand": "ukang check dotnet", "checkCommandStatus": "phase1", "requiredBy": [ "ukang-health-exam", "ukang-cloud-gateway" ] } ], "prerequisites": { "os": "Windows 10+ / Windows Server 2016+ (仅64位)", "arch": "x64", "memory": "4 GB 或以上", "disk": "至少 10 GB 可用空间", "network": "如需云服务功能需外网访问 ai.bingtai.vip" }, "cli": { "name": "ukang", "status": "phase1", "statusDescription": "CLI 工具第一阶段内测包已开放下载，当前支持检测、读取 manifest、诊断报告和提交开户注册待审核申请。自动安装和云绑定命令为即将支持能力。", "description": "优康云命令行工具。Phase 1 已实现: doctor, check-env, status, version, check manifest, check mysql-connection, agent-version, download-token, register-org。", "commands": [ { "name": "ukang doctor", "status": "phase1", "description": "全面环境诊断，检查 OS、内存、磁盘、端口、运行时等" }, { "name": "ukang check-env", "status": "phase1", "description": "快速环境检查（OS / 内存 / 磁盘 / .NET 运行时）" }, { "name": "ukang status", "status": "phase1", "description": "查看各组件运行状态" }, { "name": "ukang version", "status": "phase1", "description": "查看 CLI 版本和各组件版本信息" }, { "name": "ukang agent-version", "status": "phase1", "description": "读取优康云 Agent API 当前版本、Manifest 地址、内测通道和组件可用状态" }, { "name": "ukang download-token", "status": "phase1", "description": "按组件获取受控下载授权；未发布组件必须返回 unavailable，不返回假下载地址" }, { "name": "ukang check \u003ccomponent\u003e", "status": "phase1", "description": "检查指定组件安装和运行状态" }, { "name": "ukang check mysql-connection", "status": "phase1", "description": "验证已准备好的 MySQL / PolarDB 连接，检查数据库存在性、账号查询能力、utf8mb4 字符集和 utf8mb4_general_ci 排序规则；不回显密码" }, { "name": "ukang install mysql84", "status": "phase1-preflight", "description": "MySQL 8.4 安装前检查；不安装、不初始化密码、不创建数据库、不写配置" }, { "name": "ukang install health-exam", "status": "phase1-preflight", "description": "体检软件主体安装前检查；不解压、不建库、不写连接串、不启动服务" }, { "name": "ukang install dotnet", "status": "planned", "description": "安装 .NET 8 运行时" }, { "name": "ukang install gateway", "status": "phase1-preflight", "description": "云网关安装前检查；不下载、不写配置、不安装服务、不保存密钥" }, { "name": "ukang mcp install", "status": "planned", "description": "安装并注册 MCP Server 到 AI 工具" }, { "name": "ukang register-org", "status": "phase1", "description": "注册体检机构并申请优康云账号（提交后进入待审核，不默认开通正式机构）" }, { "name": "ukang bind-cloud", "status": "phase1", "description": "审批通过后读取云端绑定配置摘要；第一阶段不写入本地配置，不返回云端密钥明文" }, { "name": "ukang backup", "status": "planned", "description": "创建数据库备份" } ] }, "mcp": { "protocolVersion": "2024-11-05", "serverName": "ukang-mcp-server", "status": "planned", "statusDescription": "MCP Server 为第一阶段规划。当前版本尚未发布，以下工具为预留接口定义。Phase 1 优先暴露: check_environment, get_manifest, get_install_report。", "description": "通过 MCP 协议为 AI 工具提供优康云体检软件安装、检测和管理能力。配置方法见 docs/mcp.html。", "tools": [ { "name": "check_environment", "status": "phase1", "description": "检测当前环境的 OS、内存、磁盘、端口、运行时是否满足安装要求" }, { "name": "get_manifest", "status": "phase1", "description": "拉取最新 ukang-agent-manifest.json" }, { "name": "get_install_report", "status": "phase1", "description": "生成当前环境安装状态报告" }, { "name": "install_mysql84", "status": "phase1-preflight", "description": "检查 MySQL84 服务、3306 端口、离线安装包和初始化配置格式；真实静默安装待安全密码流程完成后开放" }, { "name": "check_mysql_connection", "status": "phase1", "description": "验证已准备好的 MySQL / PolarDB 连接，检查数据库存在性、账号查询能力、utf8mb4 字符集和 utf8mb4_general_ci 排序规则；不回显密码" }, { "name": "install_health_exam", "status": "phase1-preflight", "description": "检查主体安装包、SHA256 声明文件、基础 SQL、安装目录、8001 端口、.NET 8 和 MySQL 前置状态；真实安装待安全数据库配置流程完成后开放" }, { "name": "install_dotnet_runtime", "status": "planned", "description": "安装 .NET 8 运行时" }, { "name": "register_org", "status": "planned", "description": "提交机构注册信息申请优康云账号（需保留验证码或人工审核环节）" }, { "name": "bind_cloud", "status": "planned", "description": "绑定本地系统到优康云平台（需先开通云服务）" }, { "name": "install_gateway", "status": "phase1-preflight", "description": "检查云绑定状态、网关目录、配置路径和 Windows 服务状态；真实安装待签名网关包发布后开放" }, { "name": "diagnose", "status": "planned", "description": "全面诊断安装环境，生成问题报告与修复建议" }, { "name": "backup_database", "status": "planned", "description": "创建数据库备份" } ] }, "downloadBaseUrl": "https://www.ukang.cc/downloads/", "contact": { "support": "400-888-7278", "wechat": "扫码见官网底部二维码", "email": "" } }