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 專用視窗) |
| 支援的 AI | Claude 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 的方案與設定計算。
基本概念
專案、作業與階段
- 專案:具有共同目的的工作單位。以專案紀錄資料夾與
PROJECT.md表示,包含說明、階段、問題點、相關專案以及主資料夾的位置。也可以指定上層專案,形成巢狀結構。 - 作業:專案中的個別工作。作業檔中有「步驟」「做過的事」「下一步」「成果」等段落,由 AI 與人在每個段落結束時補充。畫面會依已完成的步驟數顯示進度條,全部完成後進入完成確認。
- 階段:專案的進行路線(例如:設計 → 第 1 版 → 試用)。顯示在概要畫面上方;目前階段的作業全部完成時,會出現 COMPLETE 標示與進入下一階段的按鈕(日文:次のフェーズへ進む)。作業清單只顯示目前階段的部分,其餘會收合。
- 子作業與子專案:可用[拆成子專案]把作業分開並同時進行。分支出來的作業在左側樹狀清單中會往下一層顯示並加上「↳」,並以「⑂2」之類的標示表示分支數量。
- 自由對話(日文:フリートーク):不屬於特定專案的對話。固定顯示在清單最上方,並依話題分開保存。
狀態顯示
左側樹狀清單以圓點顏色表示狀態:灰色代表尚未開始,紅色代表 AI 正在作業,淺綠色代表處理已結束,紫色代表已完成(只有人按下[將專案標記為完成]時才會變成紫色),黃色代表需要人回覆。清單中也會以文字顯示「未讀」「等待回覆」「確認完成」,畫面上方的[輪到您]則分別顯示等待回覆與確認完成的件數。AI 畫面停止變化 20 秒後,會顯示「等待輸入」。
從委託到整合的流程
標準流程如下。
- 開始:在專案畫面寫下想做的事並按[開始],系統就會建立作業,並在對話畫面中送給 AI。可選擇負責的 AI、模型與思考深度,且每個專案會記住上一次的負責人(第一次為 Claude Code)。
- 建立作業副本:有 Git 的專案會為每項作業自動建立作業副本(Git worktree,
Work/<專案>/<作業ID>/),AI 在其中作業。沒有 Git 的專案則在每次開始前先儲存,再直接於主資料夾中作業。 - 對話與進行:AI 一邊更新作業檔的步驟一邊進行。需要人判斷時,會附上選項按鈕提問,作業則變成等待回覆(黃色)。
- 確認完成:步驟全部完成後進入「確認完成」,由人選擇[標記為完成]或[繼續作業]。
- 記錄成果:在作業檔的「成果」段落,寫下檔案、已儲存於主資料夾(儲存庫與提交)或「無」(附理由)其中之一。紀錄不完整時,由 AI 調查歸屬與是否重複並整理紀錄,不要求人依檔名挑選。
- 整合:一般作業以[整合到主資料夾]把作業副本整合進主資料夾,作業副本隨後移到垃圾桶。整合前會顯示變更量(檔案數、行數)以及是否「可能與主資料夾衝突」;若發生衝突則不整合,並列入[輪到您]。變更為 0 件時不顯示整合按鈕。
- 整合子作業:子作業的成果從上層作業的[整合…]接收。可為每個子作業選擇[保留/不保留],再以[整合]、[選擇性整合]或[批次整合]取回。即使子作業尚未完成,也能用[交付成果(中途)]先交出已儲存的成果;中途接收時,子作業的對話、作業副本與剩餘步驟都會保留。只有在已完成子作業的最終整合時,才會進行清理。
不打算整合到主資料夾的作業,可用[排除整合]隱藏整合按鈕,之後再以[重新列入整合]恢復。
對話畫面與作業畫面
對話畫面
平時使用的畫面。在同一串對話中,每次傳送都能選擇由哪個 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、排隊指示、子作業或作業副本,則無法移除。可從[整理與確認]的紀錄還原。
附件、檢視與語音輸入
- 附加圖片:把圖片拖曳或貼上到對話欄,會在委託內容上方顯示縮圖。可以只傳送圖片;即使傳送失敗,附件也會保留。
- 附加影片:可加入 MP4、MOV、M4V、WebM,每件 50MB、10 分鐘以內。系統以本機的 ffmpeg 擷取 4~16 張附時間的圖片;若另外安裝選用的專用環境,也能把語音轉成附時間的文字。辨識在本機進行,不會對外傳送。
- 檢視畫面:可在對話上方的檢視畫面顯示圖片、PDF、文字檔、Word 等文件,按[關閉]或 Esc 回到對話。
- 位置與網址:點選對話中帶有 📁 的位置時,資料夾會在畫面中列出內容,檔案則以對應的應用程式開啟。網址會在瀏覽器中開啟。
- 語音輸入:在對話與點子的輸入欄中,可用語音輸入把日語轉成文字。結果只會加入輸入欄,傳送仍由人操作。語音可能由瀏覽器提供者等服務處理,部分環境無法使用。
設定與附加功能
- 介面語言:在設定的「基本」→「語言」中選擇。日文內建於主程式,並附有繁體中文與英文語言包。切換語言時,使用者的文字、路徑、已保存的狀態與角色都不會改變。
- 自動更新:預設關閉。只有在 Mac 上備齊以 Git 取得的原始碼、更新目標應用程式與磁碟檢查設定時才能使用,向上游確認的頻率限制為每 24 小時一次。若仍有 AI 或排隊中的指示,會等到結束後才套用。
- Storage Guard:指定使用者自備的磁碟檢查程式後,會在啟動、設定、建立應用程式與更新之前進行檢查,失敗即停止。未設定時照常運作。
- 遠端使用(iPhone):在設定中啟用並設定通關密語後,可透過 Tailscale 從 iPhone 連線。處理工作在連線目標的 Mac 上執行。
- ChatGPT(Chat/Pro):設定另外安裝的外部軟體後,可由 Hub 自動傳送,並把回覆保存在同一串對話中。預設停用,不會變更檔案或執行指令。
- Agy CLI、Grok Build:安裝 CLI 並登入後,即可在對話或終端機中選用。Hub 只顯示、複製安裝指令,不會自行執行。
- 連接 GitHub:以[連接既有的 GitHub]選擇已登入帳號的私人儲存庫,登記為傳送目的地。僅登記與顯示,不會同步內容或歷史。
- MetaMuse 整合:僅限 Mac。使用已安裝的固定版本工具,只傳送使用者本人核准的問題與資料。
運作機制
主程式以 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 開頭的編號一致,不一致時測試會失敗。新增功能時提高第二個數字,僅修正時提高第三個數字。
安裝與執行條件
在 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 執行。
安全性與限制
說明文件列出了使用前應了解的事項如下。
- 預設情況下,Claude Code 會略過權限確認,Codex 則略過權限確認與沙箱。AI 能以使用者的權限修改檔案或執行指令。啟動方式可在
_hub/roles.yaml的permissions中變更。 - 建立作業副本時,也會複製未納入 Git 的本機設定檔(如
.env)。自動 Git 儲存會排除新加入、具代表性名稱的機密檔案,但不保證機密不會被納入。 - 自動 Git 儲存在提交時不會執行 hook(如 pre-commit)。
- 對話、交接資料與操作紀錄都以未加密的形式保存在本機。
- Windows 版的隔離執行限制比 Mac 弱,可能讀取到作業資料夾以外的內容。
- Mac 應用程式為自我簽署,未經 Apple 公證;Windows 版也沒有發行者簽章。
- 說明文件中註明「未驗證」或「未實施」的功能包括:以實際帳號同時運作多個帳號、Grok 的實際安裝與執行、部分流程在 Windows 實機上的驗證等。
沿革
依變更紀錄可確認的主要事件如下。日期為紀錄上的日期。
- 2026 年 9 月 26 日:1.0.0。最初版本,具備專案與作業清單、啟動 Claude Code 與 Codex 的功能。同一天內陸續加入畫面內作業畫面(2.0.0)、左側樹狀清單與 Claude Code/Codex 並排顯示(3.0.0)、每項作業的作業副本(3.2.0),以及可在同一串對話中選擇 AI 的對話畫面(4.0.0)。
- 2026 年 10 月 2 日:4.20.0。把儲存庫根目錄的說明改寫為 Project Hub 的說明。公開版的變更紀錄從此版開始。
- 2026 年 10 月 8 日:4.88.0 加入自動更新(預設關閉)與 Storage Guard;4.89.0 支援繁體中文顯示。
- 2026 年 10 月 10 日:4.100.0 加入圖片、PDF 與文件的檢視畫面。
- 2026 年 10 月 15 日:4.115.0 加入討論功能,4.117.0 加入點子帳(後來的點子紀錄)。
- 2026 年 10 月 18 日:4.124.2 加入 Windows 以一般權限儲存的方式與 WebView2 專用視窗。
- 2026 年 10 月 24 日:4.126.0 加入僅限 Mac 的 MetaMuse 整合。
- 2026 年 11 月 8 日~15 日:4.126.96~4.126.98 加入 Token 用量統計與監看,以及依各角色工作難度分配負責人的功能。
此儲存庫最初是從 Discord Bot 範本「discordpy-startup」(MIT)開始建立的。公開版本不含 Bot 相關部分,但仍保留其著作權聲明與授權條文以表明來源。設計時參考了 teddashh/bat-agent-connector(等待輸入的監看、整合前確認、操作紀錄)與 arumwu/goose-acp-handoff(更換 AI 時的交接資料)的構想。兩者的原始碼皆未隨附,也沒有相依關係。
參考資料
- README.zh-TW.md:概要、前提、注意事項、主要功能(日文・English)
- hub/README.zh-TW.md:使用方式、功能、運作機制、使用前須知(日文)
- hub/CHANGELOG.md:變更紀錄(日文)
- hub/package.json:版本與執行環境
- Windows 專用視窗說明(日文)
- 點子帳說明(日文)
- MetaMuse 整合說明(日文)(非公開資料,不提供連結)
- LICENSE
- 介紹頁面:https://k-onedot.com/ai/project-hub/
- 發佈頁面:https://github.com/kieiken/project-hub/releases