145 lines
4.8 KiB
Markdown
145 lines
4.8 KiB
Markdown
# use_vala_skillhub
|
||
|
||
管理 Vala SkillHub 上的技能：推送（上传）和安装。
|
||
|
||
SkillHub 基于 Gitea，每个技能对应一个独立的 Git 仓库。推送时使用 `./tmp` 临时目录，不在 `./skills` 内创建 `.git`，避免影响 workspace 级别的 git 备份。
|
||
|
||
## 命名规则
|
||
|
||
仓库名格式：`{skill_name}.{source_name}`
|
||
|
||
- `skill_name`：技能目录名（如 `cron_job`、`web_scraper`）
|
||
- `source_name`：来源名称，即当前数字员工的 name（如 `xiaoxi`）
|
||
- 如果 `source_name` 为 `vala`，表示公司级别的官方技能
|
||
|
||
示例：
|
||
- `cron_job.xiaoxi` — xiaoxi 的定时任务技能
|
||
- `web_scraper.vala` — 公司官方的爬虫技能
|
||
|
||
## 配置
|
||
|
||
操作前需要确认以下配置（保存到 `~/.vala_skillhub_config`）：
|
||
|
||
| 配置项 | 说明 | 默认值 |
|
||
|--------|------|--------|
|
||
| `GITEA_URL` | Gitea 服务地址 | `https://git.valavala.com` |
|
||
| `GITEA_TOKEN` | Gitea API Token（需有创建仓库和推送权限） | — |
|
||
| `GITEA_OWNER` | SkillHub 组织名 | `vala_skillhub` |
|
||
| `SOURCE_NAME` | 当前数字员工的 name，用于组合仓库名 | — |
|
||
|
||
如果配置文件不存在，请询问用户获取以上信息后创建：
|
||
|
||
```bash
|
||
cat > ~/.vala_skillhub_config <<EOF
|
||
GITEA_URL=https://git.valavala.com
|
||
GITEA_TOKEN=<token>
|
||
GITEA_OWNER=vala_skillhub
|
||
SOURCE_NAME=<name>
|
||
EOF
|
||
```
|
||
|
||
后续操作前先加载配置：
|
||
```bash
|
||
source ~/.vala_skillhub_config
|
||
```
|
||
|
||
---
|
||
|
||
## 操作一：推送技能到 SkillHub
|
||
|
||
将本地 `./skills` 下的技能目录推送到 SkillHub。
|
||
|
||
**核心原则**：使用 `./tmp/skill_push/` 作为临时工作区，不在 `./skills` 内执行任何 git 操作，保持 workspace 干净。
|
||
|
||
### 流程
|
||
|
||
1. **确定仓库名**：`repo_name = {skill_dir_name}.{SOURCE_NAME}`
|
||
|
||
2. **检查远程仓库是否存在**：
|
||
```bash
|
||
curl -s -o /dev/null -w "%{http_code}" \
|
||
"${GITEA_URL}/api/v1/repos/${GITEA_OWNER}/${repo_name}" \
|
||
-H "Authorization: token ${GITEA_TOKEN}"
|
||
```
|
||
- 返回 200 → 仓库已存在，跳到步骤 4
|
||
- 返回 404 → 需要创建，执行步骤 3
|
||
|
||
3. **创建远程仓库**：
|
||
```bash
|
||
curl -s -X POST "${GITEA_URL}/api/v1/orgs/${GITEA_OWNER}/repos" \
|
||
-H "Authorization: token ${GITEA_TOKEN}" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{"name": "'${repo_name}'", "private": false, "description": "技能描述", "auto_init": false}'
|
||
```
|
||
|
||
4. **复制到临时目录并推送**：
|
||
```bash
|
||
# 清理并准备临时目录
|
||
rm -rf ./tmp/skill_push/${repo_name}
|
||
mkdir -p ./tmp/skill_push/${repo_name}
|
||
|
||
# 复制技能内容（不含隐藏文件的 .git 等）
|
||
cp -r ./skills/${skill_dir_name}/* ./tmp/skill_push/${repo_name}/
|
||
cp -r ./skills/${skill_dir_name}/.[!.]* ./tmp/skill_push/${repo_name}/ 2>/dev/null || true
|
||
|
||
# 在临时目录中执行 git 操作
|
||
cd ./tmp/skill_push/${repo_name}
|
||
git init
|
||
git checkout -b main
|
||
git add -A
|
||
git commit -m "update: sync skill $(date +%Y-%m-%d)"
|
||
git remote add origin https://oauth2:${GITEA_TOKEN}@${GITEA_URL#https://}/${GITEA_OWNER}/${repo_name}.git
|
||
git push -u origin main --force
|
||
```
|
||
|
||
5. **清理临时目录**：
|
||
```bash
|
||
cd -
|
||
rm -rf ./tmp/skill_push/${repo_name}
|
||
```
|
||
|
||
### 批量推送
|
||
|
||
遍历 `./skills/` 下所有子目录，对每个目录重复以上流程。注意跳过 `use_vala_skillhub` 目录本身。
|
||
|
||
---
|
||
|
||
## 操作二：安装 / 更新技能
|
||
|
||
从 SkillHub 下载技能到本地 `./skills` 目录。若本地已存在同名目录，则**清空后重新下载**，确保与远程版本一致。
|
||
|
||
**注意**：不使用 `git clone`，而是下载归档解压，避免在 `./skills` 下产生 `.git` 目录。
|
||
|
||
### 流程
|
||
|
||
1. **确定要安装的仓库名**（完整名，如 `cron_job.xiaoxi`）
|
||
|
||
2. **下载并解压**（已存在则先清空再覆盖）：
|
||
```bash
|
||
repo_name="cron_job.xiaoxi"
|
||
target_dir="./skills/${repo_name}"
|
||
|
||
# 如果已存在，清空目录内容以确保与远程一致（删除远程已移除的文件）
|
||
rm -rf "${target_dir}"
|
||
mkdir -p "${target_dir}"
|
||
|
||
# 通过 Gitea API 下载 tar.gz 归档并解压（自动尝试 main/master）
|
||
curl -sL "${GITEA_URL}/api/v1/repos/${GITEA_OWNER}/${repo_name}/archive/main.tar.gz" \
|
||
-H "Authorization: token ${GITEA_TOKEN}" \
|
||
| tar xz --strip-components=1 -C "${target_dir}" 2>/dev/null \
|
||
|| curl -sL "${GITEA_URL}/api/v1/repos/${GITEA_OWNER}/${repo_name}/archive/master.tar.gz" \
|
||
-H "Authorization: token ${GITEA_TOKEN}" \
|
||
| tar xz --strip-components=1 -C "${target_dir}"
|
||
```
|
||
|
||
---
|
||
|
||
## 操作三：列出 SkillHub 上的技能
|
||
|
||
```bash
|
||
curl -s "${GITEA_URL}/api/v1/orgs/${GITEA_OWNER}/repos?page=1&limit=50&sort=updated" \
|
||
-H "Authorization: token ${GITEA_TOKEN}"
|
||
```
|
||
|
||
返回 JSON 数组，每个元素包含 `name`、`description`、`updated_at` 等字段。如结果满 50 条，继续翻页 `page=2`。
|