Files
curios/README.md
T
render 177c7572c8 docs(readme): clarify official source and add poster
Explain how to add the official source and develop, package, and install Curios.
Use the selected blue-and-white illustration as the README hero and preserve the poster variants and prompts for reference.

Validation: documentation links and anchors checked; CLI static starter creation, check, and pack passed; image dimensions and asset links verified.
2026-09-14 09:40:10 +08:00

4.6 KiB

Trove 官方软件源:工具从软件源来到桌面

Trove 官方软件源

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

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

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

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

添加官方源

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

  1. 打开 Trove,进入 软件源 → 添加软件源。
  2. 填写以下信息:
字段 填写内容
显示名称 Trove 官方软件源
唯一 ID trove-official
源类型 Git 仓库
  1. 在仓库地址中粘贴:
https://git.render.ink/trove/curios.git
  1. 添加后刷新索引,选择想用的 Curio 并安装。
  2. 安装完成后,在 我的 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

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