什么是 Agent App？

Agent App 是面向 Agent 宿主的完整可安装应用包标准。它可以包含真实 UI、业务流程、数据存储、后台任务、Agent 入口、Runtime 意图、Context 需求、Knowledge 绑定、Skill 引用、Tool / Connector 需求、Artifacts、Evidence、Policies 和 QC / Evals。

一句话：Agent App 是运行在 Lime Runtime 能力之上的智能应用，不是一个 Markdown 文件，不是一个聊天专家，也不一定要求用户先打开 Lime Desktop。

APP.md 只是发现入口和 manifest 载体；真正的业务能力来自 App runtime package，并通过 Lime Capability SDK 调用平台能力。

业务工作台，不是 Chat 外壳

产品边界是：

业务不出 App 上下文，Agent 不出 Lime 能力治理边界。

Agent App 应该是用户完成工作的地方：看板、表格、表单、人工确认队列、交付物、设置和内嵌助手都可以在 App 内出现。App 可以声明 Context 需求，并调用 lime.agent、lime.knowledge、lime.tools、lime.connectors、lime.storage、lime.artifacts 和 lime.evidence，但用户不应该为了完成 App 核心流程再跳回 Lime 通用聊天框。

这也防止另一个错误方向：App 不应该为了绕开 Lime 而自建模型网关、凭证系统、权限系统、证据系统或工具调度器。那会让 Lime 退化成独立 SaaS 的分发壳。Agent App 要走中间路线：App 拥有业务形态和业务状态；Lime 拥有 Agent 运行时和受治理的平台能力。

一等可安装产品

宿主模型把 Lime Desktop 和 Lime Runtime 拆开。Lime Desktop 是多 App 工作台和应用管理器；Lime Runtime 是受治理的能力底座；Lime App Shell 是能把单个 Agent App 包装成独立品牌应用的最小宿主。

这意味着用户可以直接安装“内容工厂”这样的业务 App，而不必先下载或理解 Lime Desktop。App 仍然通过同一套 SDK 调用 lime.agent、lime.storage、lime.secrets、lime.policy、lime.evidence，所以独立分发不是绕过治理的理由。

和 Lime 专家模块的区别

Lime 专家模块更像“可直接对话的专业助手”，适合快速回答、咨询、分析和轻量任务。Agent App 更像“可安装的业务工作台”，适合把页面、流程、数据、交付物和后台任务组织成一个完整产品。

对比点	Lime 专家模块	Agent App
用户入口	以对话为主。	页面、面板、命令、workflow、artifact、设置页都可以是入口。
适合场景	问答、咨询、临时分析、轻量执行。	内容工厂、客服工作台、合同审查、投研工作台等完整业务流程。
状态管理	主要依赖会话上下文和绑定资料。	有自己的 App storage、workflow state、artifact 和 evidence。
交付结果	常见是回答、建议、草稿。	常见是可保存、可复用、可审计的业务对象和交付物。
扩展方式	配置 persona、context、Knowledge、Skills、Tools。	打包 UI、worker、storage schema、workflow、权限、runtime contract 和交付边界。

简单判断：如果用户只是“问一个专家”，用专家模块；如果用户要“在一个产品里完成一套业务流程”，用 Agent App。Agent App 里也可以包含专家入口，但专家只是其中一种交互方式，不是 App 的全部。

小程序平台类比

可以把 Agent App 理解成 AI Agent 时代的小程序，但它不复刻微信小程序框架。

微信小程序心智	Agent App 对应物
微信是宿主平台。	Lime / IDE / AI Client 是宿主平台。
小程序声明页面、组件、权限、存储。	Agent App 声明 UI、entries、capabilities、storage、permissions。
小程序调用 wx.* 能力。	Agent App 通过 @lime/app-sdk 调用 lime.ui、lime.storage、lime.agent 等能力。
平台管理审核、发布和权限。	Cloud / Registry 管 release、tenant enablement、license、policy。
客户端运行小程序。	Lime Desktop、Lime App Shell、runtime-backed shell 或兼容 Web Host 安装并运行 App package。

关键不是“像小程序一样长什么样”，而是“宿主开放能力，App 通过稳定 SDK 调用能力”。

普通用户怎么看

对普通用户来说，Agent App 不需要理解 manifest、SDK 或运行时。它更像一个“带智能助手的业务应用”：打开应用、按提示完成设置、选择一个任务、确认关键动作、最后拿到可保存和可追溯的结果。

从安装到完成任务

sequenceDiagram
  autonumber
  participant User as 用户
  participant Lime as 应用中心或独立安装器
  participant App as Agent App
  participant Assistant as 智能助手
  participant Result as 结果与记录

  User->>Lime: 搜索、下载或打开一个应用
  Lime-->>User: 展示用途、需要的权限和示例结果
  User->>Lime: 点击安装
  Lime->>App: 安装应用并准备工作区
  App-->>User: 显示首页和首次设置清单
  User->>App: 绑定资料、选择入口、输入目标
  App->>Assistant: 请求生成、分析或检查
  Assistant-->>App: 返回进度、需要确认的问题和草稿
  App-->>User: 展示草稿、引用来源和风险提示
  User->>App: 修改、批准或拒绝
  App->>Result: 保存最终交付物、证据和历史记录
  Result-->>User: 可下载、复用、审计或继续下一步

使用时的决策流程

flowchart TD
  Start([我想完成一个业务任务]) --> Find[找到合适的 Agent App]
  Find --> Understand{看得懂用途和结果吗?}
  Understand -- 否 --> Stop[先不要安装<br/>换一个更清楚的应用]
  Understand -- 是 --> Permission{权限和数据范围能接受吗?}
  Permission -- 否 --> Stop
  Permission -- 是 --> Setup[完成首次设置<br/>绑定资料 / 选择工具 / 配置账号]
  Setup --> Ready{设置检查通过吗?}
  Ready -- 否 --> Fix[按提示补资料或找管理员授权]
  Fix --> Ready
  Ready -- 是 --> Run[开始任务]
  Run --> Review{结果需要人工确认吗?}
  Review -- 是 --> Approve[查看引用、风险和草稿<br/>修改或批准]
  Review -- 否 --> Save[保存结果]
  Approve --> Save
  Save --> Next[下载、分享、继续下一步或查看历史]

普通用户只需要记住三点：

• 安装前看清“这个应用做什么、要哪些权限、会产生什么结果”。
• 运行中遇到确认提示时，先看引用、风险和将要执行的动作。
• 完成后结果应该留在 App 里，可追溯、可修改、可继续使用。

在 Lime 里的位置

flowchart TD
  Cloud[Lime Cloud
Catalog / Release / License / Tenant Enablement] --> Desktop[Lime Desktop
多 App 宿主]
  Cloud --> Shell[Lime App Shell
独立宿主]
  Cloud --> RuntimeBacked[Runtime-backed shell
系统 lime-runtime]
  Desktop --> Bridge[Capability Bridge]
  Shell --> Bridge
  RuntimeBacked --> Bridge
  Bridge --> SDK["@lime/app-sdk"]
  SDK --> App[Agent App Runtime Package
UI / Worker / Workflow / Storage]
  Bridge --> UI[Lime UI]
  Bridge --> Storage[Lime Storage]
  Bridge --> Runtime[Local Agent Runtime]
  Bridge --> Context[Agent Context]
  Bridge --> Knowledge[Agent Knowledge]
  Bridge --> Tools[Tool / Connector Broker]
  Bridge --> Artifact[Agent Artifact]
  Bridge --> Evidence[Agent Evidence]
  Bridge --> Policy[Policy / Secrets]
  Bridge --> QC[Agent QC]

Lime Cloud 可以分发、授权和启用 Agent App。Lime Desktop、Lime App Shell 和 runtime-backed shell 负责安装、权限、能力注入，并通过 Lime Runtime 本地运行。Cloud 不应该在默认链路里变成隐藏 Agent Runtime。

Agent App 适合什么

• 内容工厂系统。
• 客服知识库工作台。
• 销售 SOP 应用。
• 法务合同审查产品。
• 投研报告工作台。
• 企业内部流程应用。
• 某个客户的私有业务系统。

这些场景不应该通过修改 Lime Core 实现。新场景应优先成为新的 Agent App，调用 Lime 平台能力。

Agent App 不是什么

• 不是 APP.md 文档集合。
• 不是单个 Expert / Persona。
• 不是 SKILL.md 的替代品。
• 不是知识库格式。
• 不是工具协议。
• 不是云端 Agent Runtime。
• 不是把客户资料打包进官方包。

为什么需要它

只有可复用 Agent 资产还不够。真实业务应用还需要：

• 自己的 UI 页面、面板和设置。
• 自己的数据模型、索引、迁移和缓存。
• 自己的业务 workflow、后台任务和人工确认节点。
• 多个对话专家或非对话入口。
• 明确的 Runtime、Context、Tool / Connector、Artifact、Evidence、Policy 和 QC 边界。
• 权限、成本、凭证、租户 overlay 和升级策略。
• 与 Lime 底层能力解耦的 SDK 边界。

Agent App 就是补齐这些应用级关系的标准层。