curios/README.md

Trove 官方软件源

发现、安装，也创造属于你的 Curio。

这是 Trove 的官方软件源，提供官方维护的 Curio 工具目录与版本索引。在 Trove 中添加此源，即可浏览和安装已发布的工具。

本仓库维护 软件源索引 和发布同步工具。每个 Curio 的源码、构建与 Release 由 trove-curios 组织下的独立仓库维护，具体入口见下方的已收录工具。

添加官方源 · 开发 Curio · 已收录工具 · 完整开发文档

添加官方源

准备好可以运行的 Trove，并确认本机已安装 Git。

1. 打开 Trove，进入 软件源 → 添加软件源。
2. 填写以下信息：

字段	填写内容
显示名称	Trove 官方软件源
唯一 ID	trove-official
源类型	Git 仓库

3. 在仓库地址中粘贴：

https://git.render.ink/trove/curios.git

4. 添加后刷新索引，选择想用的 Curio 并安装。
5. 安装完成后，在 我的 Curios 中打开工具；连接设备或使用系统能力时，按工具提示完成配置与授权。

唯一 ID 必须与索引中的 id 一致。Trove 会读取默认分支的 source/index.json，获取版本和安装包地址；安装时校验包的大小、SHA-256、平台及清单。

开发 Curio

Curio 是运行在 Trove 中的独立工具。你可以从一个静态页面开始，使用 Web SDK 调用底座能力，也可以加入 Rust Backend 实现原生功能。

准备开发环境

在 Trove 的 开发 页面安装或检查命令行工具，然后打开新终端确认：

trove --version

Web 模板需要 Node.js 20.19+ 或 22.12+，以及 npm、pnpm、yarn、bun 中的一种。静态 HTML 模板不需要构建工具；Rust 模板还需要 Rust 工具链。

创建并运行

在你存放项目的目录运行：

trove new my-curio
cd my-curio
trove check
trove dev

向导会询问名称、ID 和模板；选择 Web 模板时还会询问包管理器及依赖安装。my-curio 必须是尚不存在的新目录。如果跳过了依赖安装，先在新项目内运行所选包管理器的安装命令，再执行 check 和 dev。

trove check 检查清单、工具链和依赖；trove dev 连接或启动底座，打开 Curio 开发窗口。Web 模板支持热更新，终端显示本次开发会话的日志。

已有 Web 项目可以在其根目录运行 trove adopt，按向导接入清单、SDK 和开发命令。详见 接入已有 Web 项目。

打包与验证

按 Ctrl-C 停止开发会话，再运行：

trove pack
trove install

安装包生成在 dist/packages/。trove install 会查找当前项目的包；有多个候选时，在终端选择。保持开发服务器停止，在 Trove 中打开已安装的工具，验证生产入口、资源和功能。

开发完成后，在插件自己的仓库发布 .curio 安装包。官方源的新增工具由维护者登记，已登记仓库发布 Release 后由收录流程同步索引。详见 官方软件源的维护与发布 与 版本约定。

继续阅读

你想做什么	文档
完成第一个可运行的工具	快速上手
了解开发会话与 CLI 命令	CLI 与本地开发
调用底座提供的能力	Web SDK
编写清单或加入原生功能	Manifest · Backend
发布安装包与维护软件源	打包与分发

已收录工具

Curio	用途	源码与使用说明
Harmony Assistant · 鸿蒙助手	在 Mac 上浏览互传文件与照片视频、安装卸载和备份应用，并使用开发者工具。	harmony-assistant
Harmony Mirror · 鸿蒙投屏	在 Mac 的独立窗口中呈现鸿蒙屏幕，并操作设备。	harmony-mirror

可安装版本与平台以软件源中的条目为准；设备连接条件和使用方式见各工具的文档。