Project Hub百科全書風格介紹

Project Hub

本文以百科全書條目的形式,整理 Project Hub 的功能與發展經過,並未投稿至維基百科。內容依據儲存庫中的說明文件與變更紀錄(原始碼版本 4.126.98,2026 年 11 月 15 日當時)。發佈版版本號等資訊為當時本機資料所記載的內容,不保證為最新狀態。文中以[ ]標示的按鈕名稱採用繁體中文語言包的譯名;未收錄於語言包者,附上日文原名供對照。

Project Hub 是一套在本機執行的管理軟體,可將多個專案與作業整理成清單,並在同一個畫面中操作 Claude Code、Codex 等 AI 程式開發用的命令列工具(CLI)。它的設計前提是由一位使用者在自己的 Mac 或 Windows 11 x64 電腦上使用;以 Node.js 執行的主程式只在這台電腦內部(127.0.0.1)接受連線。其特色在於:工作交給 AI 進行,而成果是否整合、是否公開,則由人來判斷,並透過畫面與紀錄機制支援這樣的分工。本軟體以 MIT 授權條款公開。

基本資訊
類型專案與作業管理軟體、AI CLI 操作環境
支援作業系統macOS 13 以上(Apple Silicon)、Windows 11 x64
執行環境Node.js 22 以上、Git、所使用 AI 的 CLI
主要實作Node.js(主程式)、node-pty(畫面內的終端機)、xterm.js(終端機顯示)、Swift 與 WebKit(Mac 專用視窗)、WebView2(Windows 專用視窗)
支援的 AIClaude Code、Codex、Agy CLI(Gemini)、Grok Build、ChatGPT(經由外部軟體,選用)
介面語言日文(內建)、繁體中文與英文(語言包)
原始碼版本4.126.98(2026 年 11 月 15 日,依本機資料)
公開發佈版4.126.98(Mac、Windows;依 2026 年 11 月 15 日的公開發佈資料)
授權條款MIT
儲存庫https://github.com/kieiken/project-hub

概要

Project Hub 以稱為「專案紀錄」(日文:台帳)的一組資料夾,管理使用者手上的多個專案。每個專案都有一份名為 PROJECT.md 的說明檔,其下的每項作業各自保存作業檔與對話紀錄。使用者從畫面左側的樹狀清單選擇專案與作業,在作業的對話畫面寫下委託內容後,所選的 AI 與模型就會負責該項作業。

AI 不直接在專案主資料夾中工作,而是在每項作業自動建立的 Git 作業副本中進行。成果是否整合到主資料夾,由人透過[整合到主資料夾]或[整合…]等操作決定。至於公開、發文、傳送等把作業內容送往外部的操作,也以人每次親自核准為前提。

本軟體不適合作為網路服務或共用伺服器使用。它沒有使用者驗證功能,AI 的費用則依各 CLI 的方案與設定計算。

基本概念

專案、作業與階段

狀態顯示

左側樹狀清單以圓點顏色表示狀態:灰色代表尚未開始,紅色代表 AI 正在作業,淺綠色代表處理已結束,紫色代表已完成(只有人按下[將專案標記為完成]時才會變成紫色),黃色代表需要人回覆。清單中也會以文字顯示「未讀」「等待回覆」「確認完成」,畫面上方的[輪到您]則分別顯示等待回覆與確認完成的件數。AI 畫面停止變化 20 秒後,會顯示「等待輸入」。

從委託到整合的流程

標準流程如下。

  1. 開始:在專案畫面寫下想做的事並按[開始],系統就會建立作業,並在對話畫面中送給 AI。可選擇負責的 AI、模型與思考深度,且每個專案會記住上一次的負責人(第一次為 Claude Code)。
  2. 建立作業副本:有 Git 的專案會為每項作業自動建立作業副本(Git worktree,Work/<專案>/<作業ID>/),AI 在其中作業。沒有 Git 的專案則在每次開始前先儲存,再直接於主資料夾中作業。
  3. 對話與進行:AI 一邊更新作業檔的步驟一邊進行。需要人判斷時,會附上選項按鈕提問,作業則變成等待回覆(黃色)。
  4. 確認完成:步驟全部完成後進入「確認完成」,由人選擇[標記為完成]或[繼續作業]。
  5. 記錄成果:在作業檔的「成果」段落,寫下檔案、已儲存於主資料夾(儲存庫與提交)或「無」(附理由)其中之一。紀錄不完整時,由 AI 調查歸屬與是否重複並整理紀錄,不要求人依檔名挑選。
  6. 整合:一般作業以[整合到主資料夾]把作業副本整合進主資料夾,作業副本隨後移到垃圾桶。整合前會顯示變更量(檔案數、行數)以及是否「可能與主資料夾衝突」;若發生衝突則不整合,並列入[輪到您]。變更為 0 件時不顯示整合按鈕。
  7. 整合子作業:子作業的成果從上層作業的[整合…]接收。可為每個子作業選擇[保留/不保留],再以[整合]、[選擇性整合]或[批次整合]取回。即使子作業尚未完成,也能用[交付成果(中途)]先交出已儲存的成果;中途接收時,子作業的對話、作業副本與剩餘步驟都會保留。只有在已完成子作業的最終整合時,才會進行清理。

不打算整合到主資料夾的作業,可用[排除整合]隱藏整合按鈕,之後再以[重新列入整合]恢復。

對話畫面與作業畫面

對話畫面

平時使用的畫面。在同一串對話中,每次傳送都能選擇由哪個 AI、模型與思考深度回答,回覆上會標示由誰回答。更換 AI 時,系統會把新 AI 尚未看過的對話內容(僅限人與 AI 的文字)作為交接資料一併傳送;由同一個 AI 繼續時,則恢復該 AI 自己的對話。

AI 作業期間寫下的指示,可從以下三種處理方式中選擇:

等待中的指示也可以用[暫存到專案紀錄]只記錄到點子紀錄中並從佇列移除。對話中的程式碼區塊附有[⧉ 複製],可直接複製要交給其他 AI 的文字。表格會以 Markdown 表格呈現。

討論

在對話畫面的討論功能(日文:話し合い)中,2~4 組 AI 與模型會先各自獨立提出意見,再經過 1~2 輪意見交換,最後由彙整者整理。第一輪意見不會提供其他參與者的回答。每一輪都在新的唯讀工作階段中執行,發言會附上名稱保存在同一項作業中。若參與者達到用量上限,系統不會更換模型,而是讓其退出並以其餘參與者繼續。初版可參與的是 Claude Code 與 Codex。

作業畫面

以整個視窗開啟 AI 終端機的畫面。以[用 Claude Code 開始][用 Codex 開始](日文:Claude Code で始める/Codex で始める)啟動,並可用[並排顯示]左右並排、同時作業。變更標題列上的模型或思考深度時,系統會對正在執行的 AI 送出 /model、/effort 進行切換。按下[接手 →]時,會把前一個 AI 的對話整理成 .ai/handoff/ 中的交接資料,讓接手的 AI 閱讀後繼續。把檔案或螢幕截圖拖進終端機,會儲存到 AI-Workspace/Inbox/hub/<日期>/,並把位置填入該 AI 的輸入欄。關閉視窗後,主程式與 AI 仍會在背景繼續執行。

角色分工、委派與用量上限

角色分工

可為指揮、研究、設計、圖片生成、程式設計、檢查、文字等角色,分別設定負責的 AI、模型與思考深度。依說明文件記載,初始設定為:指揮與檢查使用 Fable 5.2,研究、設計與文字使用 Opus 5.5,圖片生成與程式設計使用 GPT-6.1-Sol。另有依工作難度分配負責人的設定,但在人啟用之前,仍沿用原本的負責人。角色分工也可以透過重新檢視功能(日文:見直し)諮詢其他 AI。

模型選單只會列出已登入的 CLI 回答「目前可用」的模型。Hub 執行期間每天會確認 CLI 的版本與模型清單,也可以用[全部更新]手動更新。即使發現新模型,正在使用的負責人也不會自動變更。

AI 之間的委派

AI 透過 Hub 指定的窗口(/api/delegate),在同一項作業的對話中把工作交給另一個 AI。這不會增加子作業;若已有 AI 正在執行,則排在其結束之後。排隊順序、執行中的 AI 與模型及結果,都可以在畫面上確認。

用量上限的自動切換

啟用上限自動切換時,若從 CLI 的正式訊息偵測到 AI 已達用量上限,系統會停止該 CLI 的重試,確認其結束後,再把同一項作業交給設定中「main/backup」所保存的替代負責人。初始設定為 Fable 5.2 交給 Astra、Opus 5.5 交給 Sol 6.1。上限狀態會保持到期限或手動解除為止;兩邊都達到上限時則等待。對話內文或引用中只是出現「上限」字樣,不會觸發切換。

此外,啟用設定[AI]中的[特殊模式],可讓作業集中由選定的一個 AI 處理。此時即使達到上限,也不會改由其他 AI 接手,而是等待解除。

AI 帳號與用量狀況

Claude Code、Codex 與 Grok 可在設定的「AI 帳號」中命名並新增多個帳號。新增帳號的設定會另外存放在文件資料夾之外,並可依作業與 AI 的組合選擇帳號。不需要在 Hub 中輸入密碼或權杖,登入由使用者本人在終端機中進行。對於 Codex 與 Claude,系統會從 CLI 取得所選帳號的訂閱用量比例並顯示。也可以統計這台電腦的 Token 用量,並監看明細與消耗情形(只讀取數值,不保存對話內文或驗證資訊,也不會自動停止或對外通知)。

搜尋、紀錄與點子

對話搜尋

在左側搜尋欄輸入關鍵字,就會從所有專案、子專案、已完成作業及自由對話中,人與 AI 的發言列出候選結果。預設的簡易搜尋(日文:簡易検索(現在のみ))只查詢目前的對話;詳細搜尋(日文:詳細検索(過去も含む))則會一併查詢已正式封存的過去對話。搜尋採部分比對,並統一全形與半形、英文大小寫,但不會推測語意或同義詞。搜尋只在這台電腦內進行,不會對外傳送或詢問 AI。結果每次顯示 50 筆,最多 1,000 筆。

摘要後繼續

對話變長時,按一次[摘要後繼續]即可完成摘要、原文封存與對話切換。整理結果的開頭會顯示「下一個作業」,原本的對話可從[過去的對話]閱讀。

操作紀錄

開始、停止、交付、整合等操作會記錄在 _hub/log.jsonl,可在設定畫面的「最近操作(紀錄)」中查看。

點子紀錄

每個專案各有一份點子紀錄,可保存想到的文字或圖片。保存方式分為「僅記錄」(初始值)與「列入製作預定」兩種,只有以後者保存的項目才會成為製作對象。也可以用對話中的[存入點子紀錄]一次保存發言原文。圖片支援 PNG、JPEG、GIF、WebP,每張 20MB、每次最多 10 張。另有自動推進具製作許可項目的功能,但預設為停用,必須由人設定既有的作業副本與確認方式後才會開始。

刪除與還原

以右鍵的[刪除…]刪除時,會先確認哪些要移到垃圾桶、哪些因共用而保留。若仍有 AI、排隊指示、子作業或作業副本,則無法移除。可從[整理與確認]的紀錄還原。

附件、檢視與語音輸入

設定與附加功能

運作機制

主程式以 server.js 為核心,是一支 Node.js 程式,只在 127.0.0.1:4545 接受連線,不接受其他網站的操作。介面以瀏覽器技術製作;在 Mac 上,由以 Swift 撰寫的專用應用程式啟動主程式,並以 WebKit 顯示。Windows 則可用瀏覽器開啟,或使用以 WebView2 製作的專用視窗。主要元件如下。

元件用途
lib/store.js、lib/frontmatter.js讀寫專案紀錄與作業檔
lib/launch.js組合 AI 的啟動指令(把畫面上的模型名稱轉成 CLI 參數)
lib/sessions.js畫面內的終端機(node-pty)
lib/roles.js讀寫角色分工
lib/git.js建立、整合與清理作業副本
public/介面(內含 xterm.js)

所有資料都存放在本機資料夾中。預設位置是文件資料夾下的 AI-Workspace/,分為以下幾部分。

位置內容
_hub/角色分工(roles.yaml)、操作紀錄,以及語言、帳號、更新等設定
Product/<專案>/專案紀錄(PROJECT.md、作業檔、.ai/chat/ 的對話、.ai/handoff/ 的交接資料)
Work/<專案>/<作業ID>/每項作業的作業副本
Inbox/hub/交給終端機的檔案

版本管理上,規定 package.json 的版本號必須與 CHANGELOG.md 開頭的編號一致,不一致時測試會失敗。新增功能時提高第二個數字,僅修正時提高第三個數字。

Project Hub 運作機制圖
簡化呈現委託經過 Hub 與 AI,最後由人決定整合與公開的流程圖(開發中的原始碼,2026 年 11 月當時)。並未涵蓋所有功能。

安裝與執行條件

在 Mac 上,於取得的資料夾最上層執行 bash hub/setup.sh。這會在 AI-Workspace/ 下建立 _hub/、Product/、Work/(位置可用 HUB_ROOT 變更),複製虛構的範例專案紀錄,並在桌面建立 Project Hub.app。重複執行也不會變更既有的角色分工與專案紀錄。雙擊應用程式即可在專用視窗中開啟,不需要終端機。

在 Windows 11 x64 上,以 hub/start-window.cmd 開啟專用視窗,或以 hub/start.cmd 開啟瀏覽器版。請以一般權限使用,不要以系統管理員身分啟動。MetaMuse 整合等部分功能僅限 Mac。

兩者都需要 Node.js 22 以上、Git,以及已安裝並登入的 AI CLI。測試以 HUB_SKIP_NPM=1 npm --prefix hub test 執行。

安全性與限制

說明文件列出了使用前應了解的事項如下。

沿革

依變更紀錄可確認的主要事件如下。日期為紀錄上的日期。

此儲存庫最初是從 Discord Bot 範本「discordpy-startup」(MIT)開始建立的。公開版本不含 Bot 相關部分,但仍保留其著作權聲明與授權條文以表明來源。設計時參考了 teddashh/bat-agent-connector(等待輸入的監看、整合前確認、操作紀錄)與 arumwu/goose-acp-handoff(更換 AI 時的交接資料)的構想。兩者的原始碼皆未隨附,也沒有相依關係。

參考資料