|
|
@@ -127,28 +127,24 @@ AGENT_KB_DRY_RUN=y deploy/scripts/sync_agent_knowledge.sh # 预演
|
|
|
|
|
|
技能源码在本仓库 `deploy/agent-assistant/skills/fwh-assistant/`（SKILL.md、references/、templates/company-template.pptx），不放进 AgentServer 仓库。
|
|
|
|
|
|
-AgentServer 以“自定义技能”导入（AgentServer `docs/design/12-custom-skills.md`），技能 ID 为 `custom-skills:fwh-assistant`。后台入口：**能力 › 技能与插件 › 自定义技能**。两种方式任选其一。
|
|
|
-
|
|
|
-### 4.1 上传 zip（首次推荐）
|
|
|
+用 AgentServer 的推送工具 `agent-skills` 推送，管理员审核通过后生效（用法见后台 `/admin/skill-cli`，设计见 AgentServer `docs/design/19-skill-cli.md`）。仓库根目录的 `.agent-skills.json` 已配置服务器地址和技能目录，不含密钥。需要 Node 18 以上。
|
|
|
|
|
|
```bash
|
|
|
-cd ~/web/FranklinWH-ToolBox/deploy/agent-assistant/skills && zip -r /tmp/fwh-assistant.zip fwh-assistant
|
|
|
-```
|
|
|
-
|
|
|
-在自定义技能列表顶部点“上传 zip 导入”（云朵图标），选择 `/tmp/fwh-assistant.zip`，在审阅框中勾选 `fwh-assistant` 并确认，导入后即发布。以后技能更新需要重新打包上传。
|
|
|
+CLI="npx -y --registry https://agent.zenpower.cc/npm/ @agent-server/skills-cli@latest"
|
|
|
+cd ~/web/FranklinWH-ToolBox
|
|
|
|
|
|
-### 4.2 登记目录技能源（需要经常同步时）
|
|
|
+# 首次：浏览器登录。终端显示验证码和审批地址，管理员在 /admin/skill-login 核对后批准；密钥保存在 ~/.config/agent-skills/
|
|
|
+$CLI login --no-browser
|
|
|
|
|
|
-AgentServer 开启了 `ProtectHome`，看不到 `/home` 下的仓库目录，先拷贝到 home 以外：
|
|
|
-
|
|
|
-```bash
|
|
|
-sudo mkdir -p /srv/agent-skill-sources
|
|
|
-sudo rsync -a --delete ~/web/FranklinWH-ToolBox/deploy/agent-assistant/skills/ /srv/agent-skill-sources/fwh-toolbox/
|
|
|
+# 每次技能更新后：先试运行，看会推送哪些技能、改动几个文件；再正式推送，--wait 等待审核结果
|
|
|
+$CLI push --dry-run
|
|
|
+$CLI push -m "<本次改动说明>" --wait
|
|
|
```
|
|
|
|
|
|
-在“技能源”中添加目录 `/srv/agent-skill-sources/fwh-toolbox`，点“扫描并同步”，勾选 `fwh-assistant` 导入。技能更新后重新执行 rsync，再点“同步”（会显示文件差异，确认后发布）。
|
|
|
-
|
|
|
-导入的技能默认只读，以仓库为准，不要在后台直接修改。
|
|
|
+- 提交说明默认取最近一次 git 提交的标题，最近一次提交与技能无关时用 `-m` 写明本次改动。
|
|
|
+- 推送后在后台“技能与插件 › 自定义技能”审核，批准后覆盖平台上的同名技能；被拒绝时 `--wait` 显示原因（退出码 4）。
|
|
|
+- `$CLI status` 查看最近的提交与审核结果，`$CLI whoami` 查看当前密钥。
|
|
|
+- 技能以仓库为准，不要在后台直接修改，否则下次推送会覆盖。
|
|
|
|
|
|
## 5. AgentServer 后台配置
|
|
|
|
Jerry Liang