榕器 · 企业 AI 资源统一管理平台

前言¶

DeepSeek Harness（DSH）倡导「一切皆插件」的架构理念。基于这一架构，01men/ybkk-aios（榕器）构建了一个企业级 AI 资源统一管理平台。它旨在解决多类资源（IAM、模型、应用、技能）分散管理的问题，通过一套身份、一套权限、一套计量、一套审计，实现对 AI 资源的统一接入、调度与管控。

核心功能¶

该平台主要提供以下能力：
* 统一认证与权限：支持 IAM 组织架构、OIDC 登录、场景级授权。
* 资源接入与管理：包含模型接入网关、MCP 服务部署与熔断、Agent 与 AI 应用本体管理。
* 技能市场：提供 Skill 提交、静态扫描、版本化管理与上架流程。
* 计量与审计：用量透明计量、审计与告警、内部成本穿透。
* 流程编排：支持流程编排域，包含 TF 编排、状态机与模板库。
* 模型渠道治理：分级路由、降级链与预算熔断。

安装与启动¶

安装插件¶

通过 DSH 插件命令安装：

dsh plugin --profile web add github:01men/ybkk-AIOS

本地运行¶

安装后需安装依赖并启动。首次启动在空数据目录上会执行基线初始化，生成根组织与管理员账号。

npm install
npm start

启动后访问 http://127.0.0.1:7300 进入控制台。

演示模式¶

若需快速评估或测试功能，可启动演示模式。该模式会自动生成完整演示数据与演示账号。

DEMO_SEED=1 npm start

演示模式下，钉钉免密登录可用（Mock 连接器），演示账号口令均为 Ybk@2026。

架构与配置¶

榕器本身是一棵 Cordis 插件树，每个业务域对应一个插件包，可独立声明依赖与权限。

依赖与存储约束¶

在开发或独立宿主模式下，@deepseek-ai/cordis 必须仅存在于 devDependencies 中。若进入 dependencies，pnpm 会将其 hoist 到宿主，导致插件解析到错误的 cordis 实例，造成服务链失效。

平台服务键已做冲突处理：
* 存储键：必须使用 opsStorage（而非 storage），以避免与宿主自带服务冲突。
* 工具键：tools 为刻意共享接缝，独立宿主下由 ToolRuntimeLite 提供，挂载进 dsh 后即进入原生 ToolRuntime。

配置注意事项¶

• Cordis YAML：本地开发检出源码时，cordis.yml 中的 <PROJECT_ROOT> 必须替换为 file:/// 格式的绝对路径（Windows 下裸盘符路径会导致 ESM 报错）。
• 同实例依赖：本地开发需将 node_modules/@deepseek-ai/cordis 指向 dsh 源码树的 vendor/cordis（Junction），确保插件与宿主加载同一实例。

运维与升级¶

平台自更新¶

平台支持自动检查与手动升级，升级策略由管理员决定。
* 自动检查：默认每 24h 一次，启动 15s 后首查，发现新版本会在控制台显示徽标。
* 手动升级：控制台提供「一键升级」或使用 CLI 命令。

    dshctl update status | check | apply [--dry-run]

商业模式与合规¶

• 定价：按「团队 + 领域资产」定价（如行业图谱包、场景包），制造业客户可走私有化交付项目制。
• M0 合规：平台对外只呈现用量与内部成本穿透，废止按用量计费/转售/分账。钱包/分账子系统已下线封存。
• M1-1 契约：包含 J1-J4 合同与安全加固（如默认开启安全响应头、usage 事件保留策略默认 730 天）。
• IAW 批次：包含流程编排、数据要素域、模型渠道治理、Agent 自治与 A2A 等能力。

适用场景与注意¶

• 适用场景：需要统一管理企业内 AI 模型、MCP 服务、Agent 和技能的开发与运维团队；需要透明计量与审计的企业环境。
• 运行权限：插件以当前 DSH 进程的权限运行。在安装前应检查源码与许可证（MIT）。
• 资料来源：详细设计文档与合约见项目目录下的 docs/ 文件夹。