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.
This commit is contained in:
@@ -1,27 +1,98 @@
|
||||
# Trove Curios
|
||||

|
||||
|
||||
**让桌面,多一些可能。**
|
||||
# Trove 官方软件源
|
||||
|
||||
发现专注、轻巧的桌面工具,把常用能力带到手边。
|
||||
**发现、安装,也创造属于你的 Curio。**
|
||||
|
||||
## Harmony Mirror
|
||||
这是 [Trove](https://trove.render.ink/zh) 的官方软件源,提供官方维护的 Curio 工具目录与版本索引。在 Trove 中添加此源,即可浏览和安装已发布的工具。
|
||||
|
||||
让鸿蒙,来到桌面。独立投屏窗口,鼠标与键盘直接操作手机。
|
||||
本仓库维护 [软件源索引](source/index.json) 和发布同步工具。每个 Curio 的源码、构建与 Release 由 `trove-curios` 组织下的独立仓库维护,具体入口见下方的[已收录工具](#已收录工具)。
|
||||
|
||||
[探索 Harmony Mirror →](https://git.render.ink/trove-curios/harmony-mirror)
|
||||
[添加官方源](#添加官方源) · [开发 Curio](#开发-curio) · [已收录工具](#已收录工具) · [完整开发文档](https://trove.render.ink/zh/docs)
|
||||
|
||||
## Harmony Assistant
|
||||
## 添加官方源
|
||||
|
||||
鸿蒙随行,资料有序。收发完整文件夹,管理应用,让重要资料留在身边。
|
||||
准备好可以运行的 Trove,并确认本机已安装 Git。
|
||||
|
||||
[探索 Harmony Assistant →](https://git.render.ink/trove-curios/harmony-assistant)
|
||||
1. 打开 Trove,进入 **软件源 → 添加软件源**。
|
||||
2. 填写以下信息:
|
||||
|
||||
## 带到你的桌面
|
||||
| 字段 | 填写内容 |
|
||||
| --- | --- |
|
||||
| 显示名称 | `Trove 官方软件源` |
|
||||
| 唯一 ID | `trove-official` |
|
||||
| 源类型 | `Git 仓库` |
|
||||
|
||||
在 Trove 的「软件源」中添加 Git 仓库:
|
||||
3. 在仓库地址中粘贴:
|
||||
|
||||
```text
|
||||
https://git.render.ink/trove/curios.git
|
||||
```
|
||||
|
||||
选择喜欢的 Curio,安装,即刻使用。
|
||||
4. 添加后**刷新索引**,选择想用的 Curio 并安装。
|
||||
5. 安装完成后,在 **我的 Curios** 中打开工具;连接设备或使用系统能力时,按工具提示完成配置与授权。
|
||||
|
||||
唯一 ID 必须与索引中的 `id` 一致。Trove 会读取默认分支的 `source/index.json`,获取版本和安装包地址;安装时校验包的大小、SHA-256、平台及清单。
|
||||
|
||||
## 开发 Curio
|
||||
|
||||
Curio 是运行在 Trove 中的独立工具。你可以从一个静态页面开始,使用 Web SDK 调用底座能力,也可以加入 Rust Backend 实现原生功能。
|
||||
|
||||
### 准备开发环境
|
||||
|
||||
在 Trove 的 **开发** 页面安装或检查命令行工具,然后打开新终端确认:
|
||||
|
||||
```sh
|
||||
trove --version
|
||||
```
|
||||
|
||||
Web 模板需要 Node.js 20.19+ 或 22.12+,以及 npm、pnpm、yarn、bun 中的一种。静态 HTML 模板不需要构建工具;Rust 模板还需要 Rust 工具链。
|
||||
|
||||
### 创建并运行
|
||||
|
||||
在你存放项目的目录运行:
|
||||
|
||||
```sh
|
||||
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 项目](https://trove.render.ink/zh/docs/integrate-web-app)。
|
||||
|
||||
### 打包与验证
|
||||
|
||||
按 `Ctrl-C` 停止开发会话,再运行:
|
||||
|
||||
```sh
|
||||
trove pack
|
||||
trove install
|
||||
```
|
||||
|
||||
安装包生成在 `dist/packages/`。`trove install` 会查找当前项目的包;有多个候选时,在终端选择。保持开发服务器停止,在 Trove 中打开已安装的工具,验证生产入口、资源和功能。
|
||||
|
||||
开发完成后,在插件自己的仓库发布 `.curio` 安装包。官方源的新增工具由维护者登记,已登记仓库发布 Release 后由收录流程同步索引。详见 [官方软件源的维护与发布](docs/development.md) 与 [版本约定](docs/versioning.md)。
|
||||
|
||||
### 继续阅读
|
||||
|
||||
| 你想做什么 | 文档 |
|
||||
| --- | --- |
|
||||
| 完成第一个可运行的工具 | [快速上手](https://trove.render.ink/zh/docs/quick-start) |
|
||||
| 了解开发会话与 CLI 命令 | [CLI 与本地开发](https://trove.render.ink/zh/docs/development) |
|
||||
| 调用底座提供的能力 | [Web SDK](https://trove.render.ink/zh/docs/sdk) |
|
||||
| 编写清单或加入原生功能 | [Manifest](https://trove.render.ink/zh/docs/manifest) · [Backend](https://trove.render.ink/zh/docs/backend) |
|
||||
| 发布安装包与维护软件源 | [打包与分发](https://trove.render.ink/zh/docs/distribution) |
|
||||
|
||||
## 已收录工具
|
||||
|
||||
| Curio | 用途 | 源码与使用说明 |
|
||||
| --- | --- | --- |
|
||||
| Harmony Assistant · 鸿蒙助手 | 在 Mac 上收发鸿蒙设备文件与文件夹、管理应用、保存资料备份。 | [harmony-assistant](https://git.render.ink/trove-curios/harmony-assistant) |
|
||||
| Harmony Mirror · 鸿蒙投屏 | 在 Mac 的独立窗口中呈现鸿蒙屏幕,并操作设备。 | [harmony-mirror](https://git.render.ink/trove-curios/harmony-mirror) |
|
||||
|
||||
可安装版本与平台以软件源中的条目为准;设备连接条件和使用方式见各工具的文档。
|
||||
|
||||
Reference in New Issue
Block a user