docs(spec): artifact-sharing 審查對齊 ×2 — K2 改 KBDB 唯一公庫後端(對齊 #16)+ 零件界線照 #23/D29

審查意見兩處(總管 2026-07-07):
1. K2 原「recipe 維持 KV 公庫、泛化端點 front 兩後端」與 #16(RECIPES KV→KBDB)衝突
   → 改為 KBDB 是唯一公庫後端;#16 落地前對 type=recipe 的 KV 轉接明定為過渡碼、
   #16 完成即拆(1.5/5.2 對應改);KV 公庫不得寫成穩態。遷移本體=#16 負責,不重工。
2. component 界線照 #23/D29 定案改:零件貢獻整層搬到獨立 repo Leo/arcrun-components
   (fork→PR→人審);市場只偵測缺件→引導去該 repo 開 PR,永不傳輸/安裝零件程式;
   arcrun_publish_component 路徑廢除。design/requirements/tasks 凡提零件發布處照此改。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015d5jDbuqT5Htwv3Q88XXKk
This commit is contained in:
Leo
2026-07-07 09:09:37 +00:00
parent 7777414b70
commit 1d7f69215a
3 changed files with 20 additions and 20 deletions
@@ -30,9 +30,9 @@
- 驗收:投稿領新 uuid、不覆蓋同 canonical;寫一筆 `artifact_submission` entry;自報 stat 不進真實計數。
- 注意:沿用 recipe submit 的「新 uuid=新作者版本」與 fire-and-forget 存證。
- [ ] 1.5 recipe 相容轉接:泛化端點對 `type=recipe` 轉呼既有 KV 公庫路徑
- [ ] 1.5 recipe 相容轉接**過渡碼**#16 落地前):泛化端點對 `type=recipe` 暫時轉呼既有 KV 公庫路徑
- 驗收:`GET /public-artifacts?type=recipe` 結果與既有 `/public-recipes` 一致(不破現況)。
- 注意:K2——對外一套 API、對內兩後端;**不改** recipe 既有 `/public-recipes*` 與 KV 儲存。可延後(先只上 workflow/template,見 §狀態)。
- 注意:K2——**KBDB 是唯一公庫後端**,KV 轉接非穩態:#16RECIPES KV→KBDB)完成後 `type=recipe` 改走 KBDB、本轉接即拆(見 5.2)。**不改** recipe 既有 `/public-recipes*` 與 KV 儲存(遷移本體=#16 的事)。可延後(先只上 workflow/template,見 §狀態)。
---
@@ -66,8 +66,8 @@
- 注意:K4——recipe/template co-pullcomponent 只偵測(對照 `acr parts`)缺則引導 PR、**不抓程式**credential 只彙總 key 名引導 `acr creds push`
- [ ] 3.3 component 缺口偵測 + 引導(界線落點)
- 驗收:pull 一個引用「本部署沒有的零件」的 workflow → 停在引導(不落地、不抓程式),訊息指向 PR/`arcrun-components`
- 注意:這道牆=防「workflow 當殼夾帶惡意零件」(#23)。缺零件必須是硬停,不是警告後照裝。
- 驗收:pull 一個引用「本部署沒有的零件」的 workflow → 停在引導(不落地、**永不傳輸/安裝零件程式**),訊息指向獨立 repo `Leo/arcrun-components` 開 PRfork→PR→人審,#23/D29
- 注意:這道牆=防「workflow 當殼夾帶惡意零件」(#23`arcrun_publish_component` 已廢除,勿在引導文案提它)。缺零件必須是硬停,不是警告後照裝。
- [ ] 3.4 credential 清單引導
- 驗收:pull 後回報彙總的待填 key 清單 + `acr creds push` 指引;artifact 內無任何機密值。
@@ -95,8 +95,8 @@
- [ ] 5.1 import 端 `data-exfil-warning` 外呼檢查接線(pull 的 recipe 依賴過同層警示)
- 驗收:pull 一個 endpoint 域名異常的 recipe → import 端出警示(非硬擋)。
- [ ] 5.2待 leo 拍板 K2recipe 公庫是否從 KV 收斂到 KBDB `public_artifact`
- 注意:非阻塞,列未來選項;現況「不動 recipe」已能運作。
- [ ] 5.2已定案,跟 #16 進度走recipe 公庫收斂到 KBDB `public_artifact` 拆 1.5 的 KV 過渡轉接
- 注意:K2 已定(KBDB 唯一公庫後端,審查 2026-07-07 對齊 #16);遷移本體由 #16 執行,本項=#16 落地後把 `type=recipe` 切到 KBDB 路徑並移除轉接碼。非阻塞(過渡期 1.5 已能運作
- [ ] 5.3(待 leo 拍板 K5)公開公庫場景的 import 軟提示(首次 pull 陌生作者→AI 摘要依賴給人看)
---