docs: align host placements (row/batch), Gitea clone, developer_ids QA
All checks were successful
技能自动化发布 / release (push) Successful in 16s

This commit is contained in:
2026-07-20 09:54:44 +08:00
parent 8570d5803d
commit c15854c20d
14 changed files with 160 additions and 161 deletions

View File

@@ -52,7 +52,7 @@
| `health` / `version` / `config-path` / 纯统计 / 秒级查询 | `sync` |
| 任意 placement含 toolbar | 允许 sync 或 async以 manifest 为准 |
合法:`sync|async` × `toolbar|cron|agent|skill-detail`
合法:`sync|async` × `toolbar|row|batch|cron|agent|skill-detail`
历史说明:旧文档曾错误地把数据管理按钮入口与异步执行方式绑死。该约束**已废止**;模板测试与 Schema **不得**再建立「入口位置决定 sync/async」一类硬耦合。旧版宿主曾「省略 → async」**当前宿主为「省略 → sync」**。新技能仍须显式声明,不得依赖省略行为。
@@ -64,14 +64,16 @@
| 入口(匠厂侧栏 / 界面) | 常见 `source.kind` | 技能侧 | 开发者怎么测 |
|-------------------------|-------------------|--------|--------------|
| **新建任务**(对话 Agent | `agent` | `placements``agent``run_skill_action` | 侧栏「新建任务」→ 对话触发;按 manifest 的 executionProfile 执行 |
| **数据管理** | `data-management` | `placements``toolbar`;须 `bind.tables` | 侧栏「数据管理」→ 打开本技能表 → 点表顶栏技能按钮 |
| **定时任务** | `cron` | `placements` `cron` | 侧栏「定时任务」→ 新建「技能直调」并选本 Action |
| **新建任务**(对话 Agent | `agent` | `placements``agent``run_skill_action` | 侧栏「新建任务」→ 对话触发 |
| **数据管理 · 顶栏** | `data-management` | `toolbar` + 必填 `bind.tables` | 侧栏「数据管理」→ 表顶栏按钮 |
| **数据管理 · 行内** | `data-management` | `row`(建议 `bind.tables` + `inputMapping` | 同行操作链接(需主键) |
| **数据管理 · 批量** | `data-management` | `batch` | 勾选行后点批量按钮 |
| **定时任务** | `cron` | `placements``cron` | 侧栏「定时任务」→「技能直调」 |
| **任务中心** | (各入口触发的 Job | `executionProfile: "async"` | 侧栏「任务中心」查看进度 / 取消;**不是** placement |
| **技能详情** | `skill-detail`(预留) | `placements` `skill-detail` | 市场详情四 Tab / 安装必验;详情直调按钮宿主 UI **尚未落地**,主验收勿只靠此入口 |
| **技能详情** | `skill-detail` | `placements``skill-detail` | 市场详情安装/四 Tab详情直调按钮宿主上线后**同等自测** |
技能 **不要** 在 Python 里按 `source` / placement 写业务分叉;宿主读 manifest 分流展示与等待策略。
发布后按入口逐项验收的操作清单见 [`DEVELOPMENT.md`](DEVELOPMENT.md) §15 第七步。
**已声明的入口都要自测**,不要只测对话。操作清单见 [`DEVELOPMENT.md`](DEVELOPMENT.md) §15 第七步。
---
@@ -83,7 +85,8 @@
|-------------|-------------------------|-----------------|----------------|
| 运行检查 / 版本 / 配置路径 | `sync` | `skill-detail`, `agent` | 无 |
| 库 / 队列统计 | `sync` | `skill-detail`, `agent` | 无 |
| 外源 → 本地库同步 | `sync``async` | 可含 `toolbar`(须 `bind.tables`)、`cron``agent` | 可选 |
| 外源 → 本地库同步 | `sync``async` | 可含 `toolbar`(须 `bind.tables`)、`cron``agent``skill-detail` | 可选 |
| 单行 / 批量数据管理动作 | `sync``async` | `row` / `batch`(建议 `bind.tables`;行内常用 `inputMapping` | 可选 |
| 数据导入 / 失败重置 | `sync``async` | `skill-detail`, `agent` | 可选 |
| **单条**副作用 RPA | `async`(建议) | `agent`, `skill-detail` | **建议** |
| **批量顺序** RPApick | `async`(建议) | `toolbar`, `cron`, `agent` | **建议** |