Lime Desktop Platform

lime-desktop-platform 是 Lime 组织桌面产品线的公共底座，不是单一业务 App。 它负责承接 Agent App 宿主、应用中心、模型设置、OAuth、OEM、充值、更新和跨 App 复用协议， 并为后续 content-studio、zhongcao 和其他 OEM Electron App 提供统一宿主能力。这些 Product App 都在各自仓库独立运行，不是平台 App 的子 App，也不会作为平台仓库内置同名 App 出现在应用中心。

平台核心目录不 hard code 任何具体业务 App。开发态内置 catalog 只加载 catalogScope: platform-conformance 的中性 fixture；真实 Product App 的接入说明可以保留在 docs/reference 中， 但不能进入平台 App 的运行时应用中心，也不能进入 src/main、src/shared 或 contracts 的通用运行时逻辑。

开发

npm install
npm run dev

构建

npm run build

文档

• v1 路线图索引
• Agent Runtime 策略
• 平台方法论
• 宿主运行手册
• zhongcao 独立产品接入提示词
• 发布说明

当前实现切片

v1 第一刀已经落到 src/：

• src/shared/types.ts：Manifest、projection、readiness、Host Bridge、runtime bridge、release artifact、IPC、设置和诊断契约。
• src/main/services/：本地状态存储、中性 conformance fixture 加载、limecore catalog 适配、release artifact 下载校验、projection/readiness/snapshot、reference runtime fixture 和 runtime bridge 服务。
• src/main/ipc.ts：平台公共 IPC 面和 platform:changed 状态变化事件。
• src/preload/index.ts：window.limeDesktop 安全桥，含 platform.onChanged(...) 订阅。
• src/renderer/src/App.tsx：应用中心、设置中心、运行页、卸载生命周期和开发者诊断页。
• packages/contracts/：业务 App 可消费的公开协议类型包。
• samples/platform-conformance/：平台自用中性 conformance fixture。其他真实产品名样板只允许作为 external-product-reference 文档参照，不进入平台运行时 catalog。

Claude SDK、Pi 和 MCP session tools 的参考策略已落在 docs/v1/agent-runtime-strategy.md。它们后续只能作为平台 AgentExecutionService 后面的 backend adapter / sidecar，不是 Product App 的直接依赖。

当前仓库事实锁文件是 package-lock.json。首次开发先执行：

npm install
npm run typecheck
npm run governance:hardcode-scan
npm run build
npm run smoke:electron

当前本仓库已通过正式验证：

npm run verify:local