vala_skillhub/use_vala_skillhub.vala
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

配置放置在相对目录

Browse Source
This commit is contained in:
crislee 2026-04-01 23:22:47 +08:00
parent 37c06abdce
commit b8a3f06030
3 changed files with 21 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
README.md
View File

@ -14,13 +14,13 @@ Vala SkillHub 技能管理 —— 让数字员工推送、安装和自动同步
推送和安装均不在 `./skills` 目录内产生 `.git`，确保不影响 workspace 级别的 git 备份： 推送和安装均不在 `./skills` 目录内产生 `.git`，确保不影响 workspace 级别的 git 备份：
- **推送 / 自动同步**：复制到 `./tmp/skill_push/` 临时目录，完成 git 推送后清理 - **推送 / 自动同步**：复制到 `./tmp/skill_push/` 临时目录，完成 git 推送后清理
- **安装**：通过 Gitea API 下载归档解压，不使用 git clone - **安装**：通过 Gitea API 下载归档解压，不使用 git clone
- **变更检测**：通过 `~/.vala_skill_hashes` 记录每个 skill 的内容哈希，对比检测变更 - **变更检测**：通过 `./.vala_skill_hashes` 记录每个 skill 的内容哈希，对比检测变更
## 自动同步机制 ## 自动同步机制
数字员工在新增或修改 skill 后，**必须自动执行 check_and_push**： 数字员工在新增或修改 skill 后，**必须自动执行 check_and_push**：
1. 计算 skill 目录的综合哈希（含文件路径 + 内容） 1. 计算 skill 目录的综合哈希（含文件路径 + 内容）
2. 与 `~/.vala_skill_hashes` 中的历史哈希对比 2. 与 `./.vala_skill_hashes` 中的历史哈希对比
3. 仅推送有变更的 skill，推送成功后更新哈希记录 3. 仅推送有变更的 skill，推送成功后更新哈希记录
可选配合 `cron_job` 技能设置定时全量同步作为安全网。 可选配合 `cron_job` 技能设置定时全量同步作为安全网。
@ -38,7 +38,7 @@ Vala SkillHub 技能管理 —— 让数字员工推送、安装和自动同步
## 配置 ## 配置
首次使用需提供配置，保存在 `~/.vala_skillhub_config`： 首次使用需提供配置，保存在 `./.vala_skillhub_config`（当前 workspace 根目录下，各数字员工独立）：
- `GITEA_URL` — Gitea 服务地址（默认 `https://git.valavala.com`） - `GITEA_URL` — Gitea 服务地址（默认 `https://git.valavala.com`）
- `GITEA_TOKEN` — API Token（需有组织仓库的创建和推送权限） - `GITEA_TOKEN` — API Token（需有组织仓库的创建和推送权限）

12
SKILL.md
View File

@ -18,7 +18,7 @@ SkillHub 基于 Gitea，每个技能对应一个独立的 Git 仓库。推送时
## 配置 ## 配置
操作前需要确认以下配置（保存到 `~/.vala_skillhub_config`）： 操作前需要确认以下配置（保存到 `./.vala_skillhub_config`，即当前 workspace 根目录下）：
| 配置项 | 说明 | 默认值 | | 配置项 | 说明 | 默认值 |
|--------|------|--------| |--------|------|--------|
@ -30,7 +30,7 @@ SkillHub 基于 Gitea，每个技能对应一个独立的 Git 仓库。推送时
如果配置文件不存在，请询问用户获取以上信息后创建： 如果配置文件不存在，请询问用户获取以上信息后创建：
```bash ```bash
cat > ~/.vala_skillhub_config <<EOF cat > ./.vala_skillhub_config <<EOF
GITEA_URL=https://git.valavala.com GITEA_URL=https://git.valavala.com
GITEA_TOKEN=<token> GITEA_TOKEN=<token>
GITEA_OWNER=vala_skillhub GITEA_OWNER=vala_skillhub
@ -40,7 +40,7 @@ EOF
后续操作前先加载配置： 后续操作前先加载配置：
```bash ```bash
source ~/.vala_skillhub_config source ./.vala_skillhub_config
``` ```
--- ---
@ -151,7 +151,7 @@ curl -s "${GITEA_URL}/api/v1/orgs/${GITEA_OWNER}/repos?page=1&limit=50&sort=upda
### 哈希状态文件 ### 哈希状态文件
使用 `~/.vala_skill_hashes` 记录每个 skill 上次推送时的内容哈希，格式为每行一条记录： 使用 `./.vala_skill_hashes`（workspace 根目录下）记录每个 skill 上次推送时的内容哈希，格式为每行一条记录：
``` ```
skill_dir_name hash skill_dir_name hash
@ -178,8 +178,8 @@ compute_skill_hash() {
1. **加载配置和哈希状态**： 1. **加载配置和哈希状态**：
```bash ```bash
source ~/.vala_skillhub_config source ./.vala_skillhub_config
HASH_FILE=~/.vala_skill_hashes HASH_FILE=./.vala_skill_hashes
touch "${HASH_FILE}" touch "${HASH_FILE}"
``` ```

18
skill.json
View File

@ -1,8 +1,14 @@
{ {
"name": "use_vala_skillhub", "name": "use_vala_skillhub",
"version": "4.0.0", "version": "4.0.0",
"description": "管理 Vala SkillHub 上的技能：推送、安装、自动同步（变更检测 + 自动推送，不影响 workspace git 备份）", "description": "管理 Vala SkillHub 上的技能：推送、安装、自动同步（变更检测 + 自动推送，不影响 workspace git 备份）",
"author": "vala", "author": "vala",
"tags": ["skillhub", "git", "管理", "备份", "自动同步"], "tags": [
"config_file": "~/.vala_skillhub_config" "skillhub",
"git",
"管理",
"备份",
"自动同步"
],
"config_file": "./.vala_skillhub_config"
} }