从一个想法，到一个 Curio。
把熟悉的 Web 界面变成桌面工具。接入 Trove、调用原生服务，再把你的作品分享出去。
核对日期：2026 年 9 月 11 日
这些指南对应 SDK 0.3 和短命令 CLI。运行 Host 示例需要包含这些能力的最新构建；公开下载状态见发布页面。 查看发布状态 →
从可运行的模板出发，完成第一次 Host 调用，并构建可安装的插件包。
02Host 服务发现当前 Host 实际提供的 API，查阅常用能力的参数、返回值和完整示例。
03Backend 与架构创建类型化 Rust Backend、生成客户端，并理解底层 Wire Protocol v1。
04打包与分发构建经过校验的 .curio 包，在本机安装，并通过软件源分发版本。
本页目录
选择你的起点#
第一次使用 Trove？从创建第一个 Curio开始，运行模板、调用 Host，再安装自己的作品。已经有前端工程？接入已有 Web 项目会带你配置 Manifest、本地 SDK 和开发服务。
| 你想完成什么 | 接下来阅读 |
|---|---|
| 不写原生进程，先做一个界面工具 | 快速上手 |
| 使用存储、文件、剪贴板或窗口 | Host 服务 |
| 运行自己的原生代码 | Backend 与架构 |
| 把能力提供给其他 Curio | 服务与 Contract |
| 排查错误或发布版本 | 常见问题 · 打包与分发 |
理解几个组成部分#
Curio 是安装在 Trove 中的工具，curio.json 描述 UI、Backend 或两者。Host 负责窗口、进程生命周期、服务路由和安装。Contract 描述私有 Backend 或公开服务的方法、参数、结果与事件，生成客户端的类型来自它。
底座能力直接调用 host.xxx；跨插件先用 host.curios.get(id) 获取公开能力引用，再调用 Curio.xxx。Host 按需启动 Backend 并等待就绪，不拉起 UI。私有生成客户端只是可选便利层，内部通信及命名由作者决定。只有需要原生运算或提供服务时，才需要 Backend。
一次 Run 表示插件的本次运行，带有唯一 ID、开发或安装来源及对应版本。日志属于本次 Run，仅存于内存。安装产物按内容哈希标识，版本号相同也不会混用不同的文件。
当前可用范围#
本文档对应当前 Trove Host、Web SDK 和 Rust Backend Kit 0.0.1-alpha.1 的 macOS 实现。Manifest 与 Wire Protocol 仍为 v1。CLI 提供 Web、静态 HTML 和 Rust Backend 三种模板，以及短命令和现有工程接入向导。请使用包含这些能力的最新本地构建。
SDK 由 CLI 以本地 vendor/*.tgz 提供，原生库以 vendor 源码提供，不依赖公共 npm 包或公开源码仓库。公开安装包的状态见下载页。插件库中已有工具的适配状态与底座版本独立，不能据此推断它们已迁移到当前 SDK。
Host 注册的 Contract 是能力可用性的依据。系统权限由底座管理，Curio 通过底座权限页引导用户处理；专门的屏幕捕获、输入、进程和钥匙串接口仍未注册。见可用性表。
一次完整的开发循环#
- 用
trove new创建工程，或在已有工程中运行trove adopt。 - 用
trove dev生成客户端、连接 Host 并启动开发会话。 - 调用
host.xxx或生成客户端的方法。 - 验证成功、错误、取消与事件释放，在终端或底座调试区查看实时日志。
- 用
trove pack打包，结束开发会话后用trove install安装验证。