feat: auto-update pouch and catalog sources during normal use
Add taste-skill to catalog.yaml, and refresh pouch plus cloned catalog or custom Git sources on a 24h interval so users do not need a separate update command.
This commit is contained in:
+32
-2
@@ -65,7 +65,7 @@ pouch bootstrap
|
||||
| 命令 | 说明 |
|
||||
|------|------|
|
||||
| `pouch bootstrap` | 将本项目的 `pouch` skill 全局安装到所有 Agent |
|
||||
| `pouch update` | 在 `~/.pouch` 执行 `git pull`,更新 pouch 自身 |
|
||||
| `pouch update` | 更新 pouch 自身,以及已拉取的 catalog / custom source |
|
||||
| `pouch init <name> [--project DIR]` | 使用 builtin skill 自带模板初始化项目状态(目前用于 ack) |
|
||||
|
||||
### Skill 安装
|
||||
@@ -105,6 +105,33 @@ collection 会自动发现下一层所有含 `SKILL.md` 的目录;`pouch add <
|
||||
安装全部,`pouch select` 则展开为 `<name>/<skill>` 供分别勾选。同一
|
||||
`repo` 与 `ref` 共享一份 Git checkout。
|
||||
|
||||
预置 collection 示例:
|
||||
|
||||
```bash
|
||||
pouch add waza/think -g
|
||||
pouch add taste-skill/taste-skill -g
|
||||
pouch add taste-skill -g # 安装 Taste Skill 全部子 skill
|
||||
```
|
||||
|
||||
### 自动更新
|
||||
|
||||
日常执行 `pouch list`、`pouch add`、`pouch status` 等命令时,pouch 会按间隔
|
||||
顺带更新自身和已经 clone 过的 catalog / custom Git source,不必单独跑
|
||||
`pouch fetch` 或 `pouch update`。默认每 24 小时最多自动更新一次;网络失败或
|
||||
工作区不干净时跳过,不打断当前命令。`pouch add <catalog>` 在安装前会再刷新
|
||||
该来源,以便拿到最新子 skill。
|
||||
|
||||
在 `~/.config/pouch/config.yaml` 里关闭或改间隔:
|
||||
|
||||
```yaml
|
||||
auto_update:
|
||||
enabled: true
|
||||
interval: 24h # 也可用 1d、60m、3600
|
||||
```
|
||||
|
||||
本次跳过:`pouch --no-auto-update list`,或设置环境变量 `POUCH_NO_AUTO_UPDATE=1`。
|
||||
立刻更新全部:`pouch update`。
|
||||
|
||||
### 交互式批量安装
|
||||
|
||||
```bash
|
||||
@@ -222,6 +249,8 @@ pouch/
|
||||
├── paths.py # 路径常量与 Agent 目标
|
||||
├── skills.py # builtin/catalog/custom 统一解析
|
||||
├── catalog.py # catalog.yaml 读写与 Skill 发现
|
||||
├── config.py # 用户配置与自动更新设定
|
||||
├── auto_update.py # 命令执行时顺带更新 pouch 与已拉取 source
|
||||
├── sources.py # custom source 配置、发现与 Git 管理
|
||||
├── project.py # .pouch.yaml 管理
|
||||
├── symlinks.py # 软链创建/检查/修复
|
||||
@@ -238,7 +267,8 @@ pouch/
|
||||
| `SKILLS_DIR` | `~/.pouch/skills/` | builtin skill 目录 |
|
||||
| `CATALOG_FILE` | `~/.pouch/catalog.yaml` | 预置 Skill 来源目录 |
|
||||
| `CATALOG_CACHE_DIR` | `~/.local/share/pouch/externals/` | catalog checkout 缓存;按 repo/ref 共享 |
|
||||
| `CONFIG_FILE` | `~/.config/pouch/config.yaml` | custom source 配置 |
|
||||
| `CONFIG_FILE` | `~/.config/pouch/config.yaml` | custom source 与 auto_update 配置 |
|
||||
| `STATE_FILE` | `~/.local/share/pouch/state.yaml` | 自动更新时间戳 |
|
||||
| `SOURCES_DIR` | `~/.local/share/pouch/sources/` | custom Git source 默认 checkout |
|
||||
|
||||
## 注意事项
|
||||
|
||||
Reference in New Issue
Block a user