docs(spec): artifact-sharing leo 三補點 — deps_summary 搜尋層可見 + author 信譽經濟 + 資料完整性優先於界面

leo review 方向確認後的三個補點(2026-07-07,總管轉達):

1. deps_summary:搜尋結果每項就顯示配套需求(從 dependency_manifest 聚合的輕量摘要,
   submit 時算好存 metadata_json)。low-code 關鍵:判斷「裝不裝」的資訊要在搜尋層,
   不是 pull 之後才發現缺東西。design(R1 模型/端點/R5/驗收)、requirements(US-4/R3)、
   tasks(1.1/1.2/2.2)對應補。
2. author 信譽經濟(market 核心):author= 過濾+作者頁端點(找到 Leo 看到他全部 shares);
   author_reputation=從 per-uuid stat 聚合的衍生視圖、不另立真相源(第一階段查詢時算、
   量大再物化);選版升級為單品+作者信譽複合分(權重待拍板);獎勵層 future 不實作
   (第一階段獎勵=信譽本身;author 綁認證身份列 SaaS/多人市場前置)。design(作者信譽段/
   端點/待拍板 6-8)、requirements(US-9/R3)、tasks(1.3/1.6/5.4/5.5)。
3. 資料完整性優先於界面:新增設計原則段(UI 是未來的皮、record 完整性是現在的責任;
   事件型資料事後不可重建 → pull/submit 事件 day-one append);record 欄位用「未來
   showcase 網站」反推補齊(created_at/updated_at/tags/compat/license,各標必填/自記/可選);
   驗收加可測定義:不看 UI 僅用 record+事件就能重建市場首頁(作者榜/熱門榜/最新發布/配套需求)。

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 10:15:52 +00:00
parent 29ba85e848
commit df62933fa5
3 changed files with 81 additions and 30 deletions
@@ -44,7 +44,7 @@ Arcrun 的可攜開發物有三類存在 KBDB / KV 的**宣告式 record**
### 下載側(我想找別人的來用)
- **US-4(搜公庫)**:我想找「發 Slack 通知」的現成 workflow。對 AI 說一句話 → AI 搜公庫,回幾個候選+各自市場數據(用過幾次、成功率),我挑一個
- **US-4(搜公庫)**:我想找「發 Slack 通知」的現成 workflow。對 AI 說一句話 → AI 搜公庫,回幾個候選+各自市場數據(用過幾次、成功率)**配套需求摘要(deps_summary)**——**搜尋結果每一項就顯示「要配哪些東西才跑得起來」**(例:搜到「把 Facebook post 拉回來儲存」,列表直接顯示=需 1 templatefb_posts)+1 recipefacebook)+1 credential 待填(facebook_token)),我在搜尋層就能判斷裝不裝,不是 pull 之後才發現缺東西
- **US-5pull 導入)**:我看中一個 workflow,說「拉這個來用」→ AI 把它寫進**我自己的 namespace**workflow→push、template→create_template),連同它引用的 recipe / template 依賴一起備妥,立即可用。
- **US-6(丟網址即裝)**:朋友給我一個公庫連結 / canonical_id,我丟給 AIAI 一條龍 pull + 解依賴 + 報告還缺哪些 credential 要我填。
@@ -52,6 +52,7 @@ Arcrun 的可攜開發物有三類存在 KBDB / KV 的**宣告式 record**
- **US-7(多作者並存)**:公庫同一個 `daily_digest` 可以有 Leo 版、John 版,各自 uuid、各自累積市場數據,pull 時預設給市場最佳版本(沿用 recipe §7.5.5)。
- **US-8(落空即創作)**:我搜的東西公庫沒有,AI 不該只回空結果,而是引導「你可以自己做一個成為第一個作者」(沿用 recipe §7.5.6)。
- **US-9(作者頁+信譽可見,market 核心)**Leo 發表了 100 個 recipe、reputation 非常好——我**找到 Leo 就能看到他 share 的這 100 個 recipes**`author=` 過濾/作者頁),且搜尋結果的作者名旁就看得到他的信譽摘要(發布數、彙總成功率)。信譽是排序/信任訊號,也是未來獎勵機制的掛載點(獎勵層本 SDD 不實作,見 design 作者信譽段)。
---
@@ -59,7 +60,7 @@ Arcrun 的可攜開發物有三類存在 KBDB / KV 的**宣告式 record**
- **R1 公庫 record 模型統一**:三型 artifact 在公庫共用一致的身份/歸屬/市場欄位——`uuid`(唯一身份)、`type`recipe/workflow/template)、`canonical_id``author``derived_from``market_stat`per-uuid success/failure)。沿用 recipe UUID 身份模型(kbdb-base §7.5.5)。
- **R2 可攜格式(export**:每型能匯出成自足的 YAML/JSON,含 `dependency_manifest`(引用的 component/recipe/template/credential 清單),**絕不含機密值**。
- **R3 公庫端點**:搜/列(帶市場數據,落空回創作引導)、取全文(pull 用,多作者選最佳)、投稿(submit-p,新增作者版本不覆蓋)。三型都要。
- **R3 公庫端點**:搜/列(帶市場數據**每項附 deps_summary 配套需求摘要**+作者信譽摘要,支援 `author=` 過濾,落空回創作引導)、**作者頁**(信譽聚合+該作者全部發布)、取全文(pull 用,多作者以「單品數據+作者信譽」複合分選最佳;成功即記 pull 事件)、投稿(submit-p,新增作者版本不覆蓋)。三型都要。
- **R4 導入語意(pull)**pull = 把公庫定義寫進自己 namespace——workflow→`push`/webhooks/named)、template→`create_template`、recipe→既有 `installRecipeRecord`
- **R5 依賴解析**:導入一個 workflow 時,遞迴處理它引用的 recipe/template(一起 pull)、驗證引用的 component 是否已具備(缺→引導去 `Leo/arcrun-components` 開 PR(fork→PR→人審),**永不傳輸/安裝零件程式**)、列出需要的 credential(引導 `acr creds push`**不隨 artifact 傳輸**)。
- **R6 三介面對齊**HTTP 端點 → MCP tool → CLI 三層都補齊(沿用 recipe 三層樣板)。
@@ -72,6 +73,7 @@ Arcrun 的可攜開發物有三類存在 KBDB / KV 的**宣告式 record**
- **儲存鐵律(arcrun-primer / 2026-07-06 leo 釘死)**:新增的公庫與可攜 record 都是**長效資料 → KBDB / D1**,禁止為閃避 KBDB 塞 KV;禁止建新表(用 template/slots / entry_type 承載)。機密 → CF Worker Secrets,永不進可攜檔。
- **API-as-WallD6**:全走 KBDB APIMCP/CLI/HTTP),插件層禁 SQL 直寫 D1。
- **不碰 wrangler / 不自建 Worker**:這是 A 類應用邏輯(arcrun-primer 兩類工作表),端點加在既有 cypher-executor / kbdb worker,不新建 standalone worker、不 service binding。
- **資料完整性優先於界面(leo 2026-07-07**:可以沒有 UI,但 record 資訊 day-one 就要留全——公庫 record 欄位用「未來 showcase 網站」反推(created_at/tags/相容性/license/版本沿革,見 design R1);**事件型資料(pull/submit 誰何時做了什麼)事後不可重建,首日就 append 記錄**KBDB append-only),衍生統計(作者信譽、熱門榜)晚算沒關係。
- **回應語言**:面向使用者的提示訊息正體中文。
---
@@ -90,7 +92,8 @@ Arcrun 的可攜開發物有三類存在 KBDB / KV 的**宣告式 record**
- [ ] US-1/US-2`acr workflow submit-p <name>` / `acr template submit-p <name>` 能把私庫 artifact 投進公庫,成為具名作者版本(回 uuid)。
- [ ] US-3`acr workflow export <name>` 產出自足 YAML,含 dependency_manifest、零機密值。
- [ ] US-4`acr workflow search <q>` 回候選 + 各自 market_stat;落空回創作引導。
- [ ] US-4`acr workflow search <q>` 回候選 + 各自 market_stat **+ deps_summary(搜尋結果可見配套需求)**;落空回創作引導。
- [ ] US-5/US-6`acr workflow pull <canonical_id>` 把定義寫進自己 namespace,且遞迴 pull recipe/template 依賴、報告缺的 component 與待填 credential。
- [ ] US-7:公庫同 canonical_id 多作者版本並存,pull 預設回 market_stat 最佳版本。
- [ ] US-8:搜尋/取用落空回 `{ found:false, hint }` 創作引導,非空陣列。
- [ ] US-9`author=` 過濾/作者頁列出該作者跨型別全部發布+信譽摘要(從 per-uuid stat 聚合,非另立真相源)。