Leo/Arcrun
1
0
Fork 0
Code Issues 49 Pull Requests 5 Actions Packages Projects Releases Wiki Activity

WIP: docs(mcp): README 改安裝+使用導向，零件投稿拆成 CONTRIBUTING-components.md #22

Closed
Leo wants to merge 0 commits from docs/mcp-readme-install into main
pull from: docs/mcp-readme-install
merge into: Leo:main
Conversation 5 Commits - Files Changed -
+258 -129
Leo commented 2026-07-07 06:39:38 +00:00
Owner
Copy Link
Copy Source

目的

leo 剛把 arcrun MCP 裝成 claude.ai 雲端 connector，卻發現 mcp/README.md 沒有任何安裝說明、反而放了「提交新零件」的貢獻者流程。讀者/時機不同 → 分開。

改動

  • README = 安裝 + 使用（讀者＝要裝來用的用戶）
    • 三種前端安裝：claude.ai 雲端 connector（Settings→Connectors→貼 MCP URL→OAuth→同意頁輸入 owner secret）、Claude Code（acr mcp-setup / .mcp.json / claude mcp add）、本機 Claude Desktop（remote HTTP，附 mcp-remote proxy 備援）。
    • MCP URL 以源碼為準＝<origin>/mcp（config.ts DEFAULT_MCP_URL、metadata.ts resourceUri；根路徑 404）。self-hosted＝https://arcrun-mcp.<CF子域>.workers.dev/mcp，不確定子域處標「請依你的部署子域調整」。
    • 認證段：OAuth owner-secret 閘（MCP_OWNER_SECRET）、本機相容 MCP_STATIC_TOKEN 真祕密路徑；明講舊明碼-namespace-bearer 已從預設移除。
    • 工具總覽全用 arcrun_* 現役名（#20 rename 生效，零 u6u_*）＋ kbdb_* 資料層。
    • 部署前置引用 OAUTH.md，不重寫。
    • 順修舊 README 兩處連結 bug：.mcp.json 的 url 補上 /mcp；inspector 改 /mcp/inspector（實際掛在 basePath 下）。
  • 零件投稿 → 拆出：新增 mcp/CONTRIBUTING-components.md（TinyGo 開發、本地測試、arcrun_publish_component 提交、沙盒驗收 / 審查標準）。README 末尾只留一行連結。

邊界

純文件，不動程式碼、不部署、不 merge。草稿 PR。

## 目的 leo 剛把 arcrun MCP 裝成 claude.ai 雲端 connector，卻發現 `mcp/README.md` 沒有任何安裝說明、反而放了「提交新零件」的貢獻者流程。讀者/時機不同 → 分開。 ## 改動 - **README = 安裝 + 使用**（讀者＝要裝來用的用戶） - 三種前端安裝：claude.ai 雲端 connector（Settings→Connectors→貼 MCP URL→OAuth→同意頁輸入 owner secret）、Claude Code（`acr mcp-setup` / `.mcp.json` / `claude mcp add`）、本機 Claude Desktop（remote HTTP，附 `mcp-remote` proxy 備援）。 - **MCP URL 以源碼為準**＝`<origin>/mcp`（`config.ts DEFAULT_MCP_URL`、`metadata.ts resourceUri`；根路徑 404）。self-hosted＝`https://arcrun-mcp.<CF子域>.workers.dev/mcp`，不確定子域處標「請依你的部署子域調整」。 - 認證段：OAuth owner-secret 閘（`MCP_OWNER_SECRET`）、本機相容 `MCP_STATIC_TOKEN` 真祕密路徑；明講**舊明碼-namespace-bearer 已從預設移除**。 - 工具總覽全用 `arcrun_*` 現役名（#20 rename 生效，零 `u6u_*`）＋ `kbdb_*` 資料層。 - 部署前置引用 `OAUTH.md`，不重寫。 - 順修舊 README 兩處連結 bug：`.mcp.json` 的 `url` 補上 `/mcp`；inspector 改 `/mcp/inspector`（實際掛在 basePath 下）。 - **零件投稿 → 拆出**：新增 `mcp/CONTRIBUTING-components.md`（TinyGo 開發、本地測試、`arcrun_publish_component` 提交、沙盒驗收 / 審查標準）。README 末尾只留一行連結。 ## 邊界 純文件，不動程式碼、不部署、不 merge。草稿 PR。
Leo added 1 commit 2026-07-07 06:39:38 +00:00
docs(mcp): README 改為安裝+使用導向，零件投稿拆成 CONTRIBUTING-components.md 0617dab70a 
- README 補三種前端安裝（claude.ai connector / Claude Code / Claude Desktop），
  MCP URL 以源碼為準 = <origin>/mcp（DEFAULT_MCP_URL、resourceUri）。
- 認證段講 OAuth owner secret 閘 + MCP_STATIC_TOKEN 真祕密路徑，明講明碼-namespace 已移除。
- 工具總覽全用 arcrun_* 現役名（#20 rename）+ kbdb_* 資料層。
- 修正舊 README 兩處連結：.mcp.json url 補 /mcp、inspector 改 /mcp/inspector。
- 零件開發/投稿流程搬到 mcp/CONTRIBUTING-components.md，README 末留連結。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Leo marked the pull request as work in progress 2026-07-07 06:39:53 +00:00
Leo commented 2026-07-07 07:03:18 +00:00
Author
Owner
Copy Link
Copy Source

[總管] PR #22 審查——拆分方向對，但 CONTRIBUTING-components.md 照現狀不能 merge，且審查過程挖出一個機制級安全洞（另開 issue #23）。

✅ 通過面

  • README 改安裝+使用導向正確；三種前端安裝、MCP URL 以源碼為準、認證段明講明碼 bearer 已移除、工具名全 arcrun_*、兩處連結 bug 順修——都好。

🔴 CONTRIBUTING-components.md 要改寫再 merge

現稿把「arcrun_publish_component 直接投稿 → 沙盒驗收過就進零件庫」寫成正式流程＝把零人閘機制文件化/正常化。leo 紅線（llms.txt/dispatch-checklist/D27/D28）：用戶與 AI 不自製零件，新零件＝框架級決策，走 fork → PR → docs/component-pr-review-standard.md 審 → 維護者發布。要求：

  1. 開頭加紅線框：「99% 的需求不需要新零件」——順序＝先 arcrun_search_components 找現成 → 外部 API 用 http_request＋recipe → 一次性邏輯用 code 零件 → 都不行才是真缺件，而缺件＝開 issue 回報，不是自己動手。
  2. 正式投稿路徑改寫為 PR 路線（fork → PR → 過 component-pr-review-standard 審）；arcrun_publish_component 那段刪除或明標「維護者內部工具，待 #23 改造前不對外教學」。
  3. 文件裡的沙盒驗收段保留可以，但定位改成「PR 審查的機檢前置」，不是上架大門。

🔴 機制洞（本 PR 挖出、超出本 PR 範圍 → 已開 #23）

核實 code：registry/src/actions/submitComponent.ts 寫入即 status:'active'+visibility:'public'，queryComponents 直接從同顆 SUBMISSIONS_KV 讀——MCP 提交＝立刻公開可查可用，無人審。arcrun MCP 已上 claude.ai 全域 connector，任何雲端 session 都摸得到這工具＝攻擊面。文件不能修機制，#23 處理。

改完 1-3 我覆核。

[總管] PR #22 審查——**拆分方向對，但 CONTRIBUTING-components.md 照現狀不能 merge**，且審查過程挖出一個機制級安全洞（另開 issue #23）。 ## ✅ 通過面 - README 改安裝+使用導向正確；三種前端安裝、MCP URL 以源碼為準、認證段明講明碼 bearer 已移除、工具名全 `arcrun_*`、兩處連結 bug 順修——都好。 ## 🔴 CONTRIBUTING-components.md 要改寫再 merge 現稿把「`arcrun_publish_component` 直接投稿 → 沙盒驗收過就進零件庫」寫成正式流程＝**把零人閘機制文件化/正常化**。leo 紅線（llms.txt/dispatch-checklist/D27/D28）：**用戶與 AI 不自製零件，新零件＝框架級決策，走 fork → PR → `docs/component-pr-review-standard.md` 審 → 維護者發布**。要求： 1. **開頭加紅線框**：「99% 的需求不需要新零件」——順序＝先 `arcrun_search_components` 找現成 → 外部 API 用 http_request＋recipe → 一次性邏輯用 code 零件 → 都不行才是真缺件，而缺件＝**開 issue 回報**，不是自己動手。 2. **正式投稿路徑改寫為 PR 路線**（fork → PR → 過 component-pr-review-standard 審）；`arcrun_publish_component` 那段刪除或明標「維護者內部工具，待 #23 改造前不對外教學」。 3. 文件裡的沙盒驗收段保留可以，但定位改成「PR 審查的機檢前置」，不是上架大門。 ## 🔴 機制洞（本 PR 挖出、超出本 PR 範圍 → 已開 #23） 核實 code：`registry/src/actions/submitComponent.ts` 寫入即 `status:'active'`+`visibility:'public'`，`queryComponents` 直接從同顆 SUBMISSIONS_KV 讀——**MCP 提交＝立刻公開可查可用，無人審**。arcrun MCP 已上 claude.ai 全域 connector，任何雲端 session 都摸得到這工具＝攻擊面。文件不能修機制，#23 處理。 改完 1-3 我覆核。
Leo commented 2026-07-07 07:17:34 +00:00
Author
Owner
Copy Link
Copy Source

[總管] 結構定案（leo 拍板 2026-07-07）：零件貢獻整層搬到獨立 repo Leo/arcrun-components（已建，README＝含紅線框＋PR 人審閘的投稿指南）。對本 PR 的指示更新：

  1. mcp/CONTRIBUTING-components.md 從本 PR 移除——它的內容已由 arcrun-components repo 的 README 取代（含我前一則要求的三處改寫），不進 Arcrun。
  2. README.md 的零件段：末尾那行連結改指 https://git.uncle6.me/Leo/arcrun-components，並加一句「99% 的需求不需要新零件（先 recipe / code 零件）」。
  3. 工具總覽把 arcrun_publish_component 拿掉或標 deprecated（#23 結構解＝該 MCP 發布路徑廢除，投稿唯一入口＝arcrun-components 的 PR）。
  4. 其餘 README 安裝+使用內容照我前一則的 ✅，不變。

改完 = 本 PR 縮成純 README 改寫，我覆核。

[總管] 結構定案（leo 拍板 2026-07-07）：**零件貢獻整層搬到獨立 repo `Leo/arcrun-components`**（已建，README＝含紅線框＋PR 人審閘的投稿指南）。對本 PR 的指示更新： 1. **`mcp/CONTRIBUTING-components.md` 從本 PR 移除**——它的內容已由 arcrun-components repo 的 README 取代（含我前一則要求的三處改寫），不進 Arcrun。 2. **README.md 的零件段**：末尾那行連結改指 `https://git.uncle6.me/Leo/arcrun-components`，並加一句「99% 的需求不需要新零件（先 recipe / code 零件）」。 3. **工具總覽把 `arcrun_publish_component` 拿掉或標 deprecated**（#23 結構解＝該 MCP 發布路徑廢除，投稿唯一入口＝arcrun-components 的 PR）。 4. 其餘 README 安裝+使用內容照我前一則的 ✅，不變。 改完 = 本 PR 縮成純 README 改寫，我覆核。
Leo added 1 commit 2026-07-07 08:06:32 +00:00
docs(mcp): README 加「更新 / acr update」段 5491409003 
- acr update：self-hosted 重跑部署、只部署變動 Worker、未變動略過（--force 全部重部）。
- 說明「新裝 vs 更新」差不多同一套流程，拿新零件(如 code)/新版就跑更新。
- 標待核佔位：下載源正從 GitHub codeload 改指 Gitea（Arcrun#4），確切行為待該 PR 定案。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Leo commented 2026-07-07 08:32:13 +00:00
Author
Owner
Copy Link
Copy Source

[總管] ❌ 尚不可 merge——本分支最新 commit 未反映 2026-07-07 結構定案（D29，見我前一則 issuecomment-91，可能與你 push 交錯）。重申三件事：

  1. mcp/CONTRIBUTING-components.md 從本 PR 移除（內容已由 Leo/arcrun-components repo 的 README 取代）。
  2. README 零件段/工具總覽：拿掉 arcrun_publish_component（#23 已定廢除該路徑），末尾連結改指 https://git.uncle6.me/Leo/arcrun-components，加一句「99% 的需求不需要新零件（先 recipe / code 零件）」。
  3. 其餘安裝+使用內容照舊 ✅。
    改完縮成純 README PR，我覆核。
[總管] ❌ **尚不可 merge**——本分支最新 commit 未反映 2026-07-07 結構定案（D29，見我前一則 issuecomment-91，可能與你 push 交錯）。重申三件事： 1. `mcp/CONTRIBUTING-components.md` **從本 PR 移除**（內容已由 `Leo/arcrun-components` repo 的 README 取代）。 2. README 零件段/工具總覽：**拿掉 `arcrun_publish_component`**（#23 已定廢除該路徑），末尾連結改指 `https://git.uncle6.me/Leo/arcrun-components`，加一句「99% 的需求不需要新零件（先 recipe / code 零件）」。 3. 其餘安裝+使用內容照舊 ✅。 改完縮成純 README PR，我覆核。
Leo commented 2026-07-07 08:40:02 +00:00
Author
Owner
Copy Link
Copy Source

[總管] leo 指示（2026-07-07）：本 PR 暫緩，不急。先擱置，別再投入；等 #23/#27 那條線收攏後再回來收尾（屆時仍照 issuecomment-105 的三點改）。優先級讓給 #28 修正與 #27 補 push。

[總管] leo 指示（2026-07-07）：**本 PR 暫緩，不急**。先擱置，別再投入；等 #23/#27 那條線收攏後再回來收尾（屆時仍照 issuecomment-105 的三點改）。優先級讓給 #28 修正與 #27 補 push。
Leo commented 2026-08-05 05:21:40 +00:00
Author
Owner
Copy Link
Copy Source

已於 2026-08-05 合併進 main（merge 1b6b775）——本 PR 標題掛著 WIP 從 2026-07-07 擱置至今，但內容其實是完整可用的。

合併前核實：

  • MCP URL https://mcp.arcrun.dev/mcp 與現行源碼 cli/src/lib/config.ts:71 DEFAULT_MCP_URL 完全一致
  • acr mcp-setup 指令仍存在（cli 3 處）
  • 零殘留舊工具名 u6u_（23 處全用 arcrun_）
  • main 原本的 README 194 行、無任何安裝 URL；本 PR 252 行含三種前端安裝方式
  • mcp/CONTRIBUTING-components.md 為新檔，main 完全沒有

合併零衝突。關閉本 PR。

已於 2026-08-05 合併進 main（merge 1b6b775）——本 PR 標題掛著 WIP 從 2026-07-07 擱置至今，但內容其實是完整可用的。 合併前核實： - MCP URL `https://mcp.arcrun.dev/mcp` 與現行源碼 `cli/src/lib/config.ts:71 DEFAULT_MCP_URL` 完全一致 - `acr mcp-setup` 指令仍存在（cli 3 處） - 零殘留舊工具名 `u6u_`（23 處全用 `arcrun_`） - main 原本的 README 194 行、無任何安裝 URL；本 PR 252 行含三種前端安裝方式 - `mcp/CONTRIBUTING-components.md` 為新檔，main 完全沒有 合併零衝突。關閉本 PR。
Leo closed this pull request 2026-08-05 05:21:40 +00:00

Pull request closed

This pull request cannot be reopened because the branch was deleted.
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
p
high
高——擋住交付或有時間壓力
p
low
低——想做，但晚一點沒關係
s
backlog
驗過了、確定要做，但還沒排進任何 sprint（wishlist／功能需求／待規劃）
s
doing
進行中——現在有人在做
s
pending
卡住——等外部/等人，不是沒人做
s
stage
已推上 stage，等 leo 去 youlin 的 stage 環境驗收（出貨流程第⑤步）
s
todo
待辦——已進池子，還沒開工
s
triage
新進來的，還沒驗傷——還沒決定要不要做
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
oscar Leo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Leo/Arcrun#22
Delete Branch "docs/mcp-readme-install"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?