From 9bc77924645e2187a1ced1896d76d8875de286b9 Mon Sep 17 00:00:00 2001 From: admin9webs Date: Sun, 4 Oct 2026 11:39:05 +0800 Subject: [PATCH] =?UTF-8?q?docs(README):=20=E6=94=B9=E6=AD=A3=E6=8A=80?= =?UTF-8?q?=E8=83=BD=E5=AE=9E=E4=BD=93=E5=BD=92=E5=B1=9E=20=E2=80=94?= =?UTF-8?q?=E2=80=94=20=E5=AE=9E=E4=BD=93=E5=9C=A8=20atomk-hermes-skills?= =?UTF-8?q?=EF=BC=8C=E6=9C=AC=E4=BB=93=E5=BA=93=E5=8F=AA=E5=AD=98=E5=BF=AB?= =?UTF-8?q?=E7=85=A7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 上一版（f01d3ba/1624491）基于错误判断写成「本仓库 skill/SKILL.md 是实体、部署用软链」， 实际上： - 实体在技能注册表 admin9webs/atomk-hermes-skills（改技能在那里改）； - KVM-2 由 skills-repo/deploy-fleet.sh --dsh 用 tar 分发到各机 ~/.dsh/skills 与 ~/.hermes/skills； - 软链会被下次分发抹掉，已撤销，现场恢复成注册表下发的普通副本。 现三者 md5 一致（09ff552e…）。 --- README.md | 40 ++++++++++++++++++++++++++++++---------- 1 file changed, 30 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 4acfaf3..89e5c65 100644 --- a/README.md +++ b/README.md @@ -161,15 +161,35 @@ function wrap(o, n, l) { 3449 与 3450）是**两次真实消耗**，两个号都已作废，不能当成修正丢掉前一个 - 说明书 §1 的例子 `pc 1000 → 6980309310004` **是错的**，正确是 `6980309310007` -## 维护约定：`skill/SKILL.md` 是 KVM-2 上那份技能的唯一实体（2026-10-04 起） +## 技能实体在哪：本仓库的 `skill/SKILL.md` 只是快照（2026-10-04 查明） -KVM-2 的 `~/.dsh/skills/dianxiaomi-multiplatform-listing/SKILL.md` 现在是指向本仓库 -`skill/SKILL.md` 的**软链**（原来是一份会各自漂移的拷贝）。 +本仓库的 `skill/SKILL.md` **不是**技能实体，而是 2026-09-20（提交 `faeb95c`）放进来的一份**一次性快照**。 +技能的实体在**技能注册表**：`admin9webs/atomk-hermes-skills` → +`skills/cross-border-ecommerce/dianxiaomi-multiplatform-listing/SKILL.md`。 -* 改技能 = 改这里的 `skill/SKILL.md`，改完**必须 commit + push**。 - 否则现场改动只是"未提交状态"：DSH 下一次会话立刻就读得到，看起来已经生效，而仓库里没有 —— 这正是漂移的成因。 -* **不要**再把部署文件当独立副本去改。 -* 软链目标依赖本机 clone 路径 `~/gitea-push/dianxiaomi-crossborder-playbook/`；若要把 clone 挪走或重建， - 记得同步更新软链，否则技能会从 DSH 目录里消失（已实测：提供器**会**跟随软链）。 -* 历史漂移：2026-09-21~09-30 期间现场 172 行、仓库 113 行，差了两节 - （`§2.1 建 listing 前的 0 号自检`、`§8 Ozon 保存被拦的错误链`），已由提交 `428255a` 以现场版为准回填。 +KVM-2 上的分发链是： + +``` +atomk-hermes-skills（注册表，改技能在这里改） + └─ KVM-2 clone: ~/dsh-dingtalk-workspace/skills-repo/ + └─ deploy-fleet.sh --dsh <技能名> + ├─→ 各机 ~/.dsh/skills/<技能>/SKILL.md （DSH agent 读这里） + └─→ 各机 ~/.hermes/skills/<技能>/SKILL.md （Hermes agent 读这里） +``` + +目标机：`kvm2(.122) / a1(.152) / s01(.231) / s02(.232) / s03(.217)`。 + +### 所以改技能的正确姿势 + +1. 改注册表：`~/dsh-dingtalk-workspace/skills-repo/skills/cross-border-ecommerce/dianxiaomi-multiplatform-listing/SKILL.md`，提交并推送； +2. 分发：`cd ~/dsh-dingtalk-workspace/skills-repo && ./deploy-fleet.sh --dsh dianxiaomi-multiplatform-listing`； +3. 若要让本仓库这份快照跟上（**没有自动同步**）： + `cp <注册表路径> skill/SKILL.md` 然后提交。 + +⚠️ **不要**把 `~/.dsh/skills/` 下的文件改成指向别处的软链 —— `deploy-fleet.sh` 用 `tar xz` 覆盖那个目录， +软链会被下次分发直接抹掉，看起来"改了"其实无效。 + +### 漂移历史 + +2026-09-21~09-30 期间注册表更新到 172 行（新增 `§2.1 建 listing 前的 0 号自检`、`§8 Ozon 保存被拦的错误链`）， +而本仓库这份快照停在 113 行、9 天没动。已由提交 `428255a` 以注册表版为准补齐，三者（注册表 / 现场 / 本仓库）md5 现已一致。