产品蓝图

为本地开发生成精确且具备产品形态的应用组合。

产品蓝图是从产品想法到可运行 Lenso System 的最短路径。蓝图创建应用源码形态，以及选择 Module 的唯一 lenso.app.json 组合锁。

使用持续维护的蓝图

Support Desk 是持续维护的产品级基础。请直接按名称组合它，不要依赖仅供仓库开发使用的隐藏检查命令。蓝图本身只选择 auth、notification-worker 与 support-api。

产品验收通过仓库内的 Capability Pack 加入 Support Ticket 与 Story Module 选择。Runner 从 lenso-examples 中由 Module 持有的示例包构建精确的 Support Ticket Console Surface，再通过 Console 协调该 Artifact。

Compose 基础

lenso app compose ./support-desk --blueprint support-desk --apply

组合会写入 support-desk/lenso.app.json。该文件记录：

应用协议、身份和单调递增修订；
选定的 Blueprint 与 Capability Pack；
每个不可变 Module Release 的身份、版本、Owner、内容摘要与 Business Contribution；
已解析依赖的身份、版本与内容摘要；
Linked 或 Service-backed Implementation Binding；
Blueprint 与 Capability Pack Provenance。

组合文件不是进程启动器、凭据文件或生产交付记录。lenso dev up 会为本地开发实现其中选择的 Host 与 Provider。更底层的 lenso system dev 仍是用于隔离 Topology 与 Adapter 检查的 System Sandbox。

Compose 产品验收

lenso app compose ./support-desk \
  --blueprint support-desk \
  --pack ./fixtures/acceptance/support-desk/capability \
  --implementation support-api=linked \
  --implementation notification-worker=linked \
  --implementation lenso/platform-story=linked \
  --apply

请从 lenso-examples 仓库根目录运行该命令。Capability Pack 提供 support/tickets Service Delivery 与 lenso/platform-story；Implementation Flag 明确本地验收使用的 Binding。启动前，Runner 使用公开的 lenso service workspace init --force 与 lenso service workspace add support-ticket，把带有 lenso.service.json 的唯一 Service-backed Provider 注册到 App Workspace。

请运行受支持的黑盒路径，不要在缺少该 Workspace Entry 时直接启动这份 Pack-backed 组合：

pnpm acceptance:support-desk

在本地运行并连接基础组合

cd support-desk
lenso dev up --console-root ../lenso-console

该命令在同一个前台 Session 中启动 Host、auto-start Provider Service 和现有 Console Checkout，创建已签名的本地连接材料、协调 Module 自有 UI Artifact，并连接精确拓扑。Ctrl-C 只停止本次调用启动的进程。

只有需要在已连接 Host、Provider 与 Console 路径之外单独校验或运行隔离的 System Shape 时，才使用更底层的 Sandbox：

lenso system dev --system-file lenso.app.json --dry-run --json
lenso system dev --system-file lenso.app.json

使用 --cleanup 停止该次 Sandbox Run 持有的资源。

使用能力包扩展

能力包是可复用的本地组合输入，可携带 Module、Service、文档与 Agent 上下文：

lenso capability init support-sla \
  --dir ./capabilities/support-sla \
  --lang ts \
  --for-blueprint support-desk
lenso capability library add ./capabilities/support-sla
lenso capability fit support-sla --repo-root .
lenso app compose --repo-root . --pack support-sla --apply

能力包不会安装 Module Release、发布 Service 或变更生产基础设施。重新组合应用，让每个已接受选择进入新的 lenso.app.json 修订。

连接并检查状态

Console Service 接收从已组合应用派生的精确 lenso.system.v2 拓扑和 Management Binding。连接后，它只加载回执绑定的 Surface，并报告直接对象状态。Console 不会扩大组合，也不会选择部署目标。

完整四步生命周期参见 Host 快速开始；Support Desk 产品级验收参见示例。

边界

蓝图创建源码与本地组合，不执行部署。
lenso.app.json 是精确的应用组合与锁。
Module 在 Linked 和 Service-backed 交付间保持稳定业务身份。
Provider Service 仍由 Host 管理；Autonomous Service 使用独立的 Rust lenso.service.v2 运行时。
生产发布、提升、回滚和基础设施仍由外部交付系统负责。