37 lines
1.5 KiB
Markdown
37 lines
1.5 KiB
Markdown
# skill-catalog
|
||
|
||
技能目录站：把对外发布的技能发布成一个自托管目录站（动态服务从 catalog.json 现渲染，附同源静态快照；能干什么 / 先装什么 / 要配什么 / 依赖谁 / 一条安装命令）。
|
||
|
||
以 Pi package（技能形态）发布。技能本体在 `skills/skill-catalog/`。
|
||
|
||
- 平台：macOS / Linux
|
||
- 许可：GPL-3.0-or-later（全文见 [LICENSE](LICENSE)）
|
||
|
||
## 安装
|
||
|
||
```sh
|
||
pi install git:gitea.vhkd.top/pi-hub/skill-catalog.git@v0.2.0
|
||
```
|
||
|
||
装完 `pi-skill list` 能看到 `skill-catalog`，`pi-skill skill-catalog check` 会告诉还缺什么。
|
||
|
||
## 先准备什么
|
||
|
||
- `node`（运行环境），生成器与动态服务（serve.mjs）；零 npm 依赖
|
||
- `ssh`（命令），部署两跳（relay→host）
|
||
- `tar`（命令），部署打包（tar -czf）
|
||
- `curl`（命令），字体下载与上线自检
|
||
|
||
## 常用命令
|
||
|
||
| 命令 | 说明 |
|
||
|---|---|
|
||
| `build` | 生成 dist：catalog.json + assets + serve.mjs + 静态快照（只收录声明了 publish 的技能） |
|
||
| `serve` | 本地跑动态服务：从 catalog.json 现渲染，带 /api/skills 与 /healthz |
|
||
| `preview` | 生成并本地动态预览目录站 |
|
||
| `deploy` | 把 dist 发布到部署目标（relay→host，release + current 切换，systemd 服务自动重启） |
|
||
| `list` | 收录清单与依赖闭包状态 |
|
||
| `check` | 只读自检：收录规则、部署目标与线上健康 |
|
||
|
||
用法与对外契约见技能内的 `SKILL.md` 与 `REFERENCE.md`。
|