Lime

开发者入口接入 Lime 能力

这里把可接入的能力按模块放清楚:Agent App、专家、技能、模型 API、安装器和客户端 SDK。先选当前要接的一层,再看对应文档。

P0 current

Agent App:
像小程序一样安装的应用

APP

Agent App 是完整可安装应用,不是聊天专家或脚本片段。Studio 负责发布工具链;LimeCore 保存目录和版本;Lime Desktop 负责本地安装、校验和运行。

npx agentapp-ref@0.7.0 validate ./my-agent-app --version 0.7 npx agentapp-ref@0.7.0 readiness ./my-agent-app --workspace ./workspace

Studio 发布链路

Studio 是 Agent App 开发者发布工具链。当前按开发中 / 路线图展示,不把未完成的 npm 包写成可立即发布入口。

查看 Studio 路线图进入开发者认证
1

开发者认证

用户中心绑定 developer profile,未通过认证不能上传包或创建 release。

2

权限与成员

Studio UI / CLI 查询 App role、membership 和可发布渠道。

3

Dry-run

校验 appId、version、channel、manifest summary 和权限,不写云端。

4

Package upload

上传 .zip / .lapp,云端静态检查并返回 package URL / hash。

5

Release & audit

创建 release,写发布、撤销、权限和包审计,客户端 bootstrap 发现更新。

Agent App

current

App 开发者 / 企业团队

完整可安装应用,拥有自己的 UI、workflow、storage 和交付物。

Lime Desktop Host 本地运行,LimeCore 只做 catalog、release、license 和 audit。

阅读标准

Expert / 专家模块

current / evolving

专家作者 / 运营团队

可长期复用的专业角色,适合人设、记忆模板、Skill 和 workflow 组合。

LimeCore 做专家云市场控制面;Lime Desktop 专家广场和 Agent Runtime 执行。

看路线图

Skill / Workflow

current / evolving

流程作者 / App 作者

可安装、可复用的执行流程,适合进入当前任务、专家和 Agent App。

skillCatalog / client/skills 下发目录;service skill 不伪装云端代跑。

进入技能市场

Model / Gateway

current / evolving

模型服务商 / 开发者

OpenAI 兼容 API、模型目录、provider 配置、用量和计费。

Lime Gateway / OEM Hub / 客户端 provider 配置共同承接。

查看 LLM API

Content / Template

current / evolving

创作者 / 运营团队

提示词、使用案例、场景模板和内容工厂模板等轻量内容资产。

官网内容系统或 App 模板,不等同于 runtime app。

查看提示词

Tool / Connector

planned

SaaS / API 服务商

MCP、HTTP API、浏览器、OAuth、Webhook 和同步适配器。

未来由 ToolHub / Connector Broker 调用,客户端 readiness 授权。

路线图中

Knowledge Pack

planned

企业知识管理员

知识模板、资料包、检索绑定、freshness 和 provenance。

Knowledge 只作为可信上下文,不执行代码。

路线图中

Client Extension

planned

客户端扩展开发者

命令、面板、Artifact Viewer、站点适配器、终端和浏览器辅助能力。

未来在 Lime Desktop 宿主内运行,必须走 capability handle。

路线图中
CP

LimeCore 控制面

负责 catalog、release、developer profile、license、tenant enablement、ranking、audit 和 bootstrap projection。

HOST

Lime Desktop 宿主

负责应用中心、专家广场、Skills、包校验、本地缓存、capability 注入和 Agent Runtime 绑定。

PKG

包与目录

Agent App、Expert、Skill 各自拥有边界;可以互相引用,但不能互相替代或绕开平台治理。

三条常见路径
基本就够用了

推荐入口

@limecloud/creative-cli

npm install -g @limecloud/creative-cli

先试通 CLI 链路

最适合先把登录、自检和基础调用跑通。别一开始就跳到正式产品接入,先把链路试顺会更省时间。

登录与自检基础调用先跑通再继续
查看 CLI 说明

做安装流程或宿主引导

如果你在做安装器、桌面壳程序或 IDE 宿主,优先看这一层。它更像引导接入,而不是正式产品里的长期运行逻辑。

安装向导IDE 宿主桌面壳程序
查看安装接入

推荐入口

@limecore/creative-installer-sdk

creative-cli client-setup --client-type "ide_host" --host "cursor" --json

推荐入口

@limecore/api-client

creative-cli integration-path --client-type "product_client" --json

接进正式产品客户端

当你已经准备把登录、能力调用和结果读取放进产品代码时,再切到这一路。它更适合稳定接入,而不是一次性试验。

正式产品结果读取稳定接入
查看正式接法

结构化入口

如果你的系统要直接读取接入建议,可以使用这些稳定 URI。它们返回推荐接法、宿主安装信息和正式接入路径。

读取客户端 setup

creative-capability://owner/client-setup?clientType=product_client

返回推荐接法、下一步和可选安装信息。

读取正式接法

creative-capability://owner/integration-path?clientType=product_client

返回推荐包、示例命令和文档入口。

读取宿主安装信息

creative-capability://owner/host-setup?host=cursor

给 IDE 或安装流程直接读取当前宿主该怎么装。