Vibe-Research：把投研流程拆成可審核檔案的本機工作台
Vibe-Research: Your Personal Trading Research Agent · A股/美股/港股 的个人投研 Agent：每日复盘、资讯雷达、个股数据、板块中心、我的持仓、研究记录、回测。Vibe-Research 把数据和功能配齐，由你自己的 Agent 驱动投资研究。基于开源的 Codex Harness 打造。
秒懂
- 它是什麼？
- 這是一套跑在本機瀏覽器的金融研究工作台，用你自己的 Codex、Claude Code 或 WorkBuddy 訂閱當推理來源，六階段研究會留下 evidence.json、calculations.json 等可複核檔案。判斷重點在於：它把可審核性當成硬需求，代價是你得先備好 Node、Python 與一個可用的訂閱。
- 適合誰用？
- 如果你本來就有 Codex、Claude Code 或 WorkBuddy 訂閱，而且在意研究結論能不能被逐條複核，Vibe-Research 值得動手跑一次：先確認 node -p process.features.typescript 輸出 strip 或 transform，再依 scripts/setup 與 scripts/start 走完流程，接著開一輪六階段研究，檢查 evidence.json 與 calculations.json 是否真的留下來源與計算 DAG。反過來說，如果你要的是手機看盤、即時報價或保證回應延遲的雲端服務，這套東西從架構上就不服務你，因為它把推理綁在你本機的 CLI 與瀏覽器埠 5930 上。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 4 天前。
- 用什麼語言寫的？
- 主要是 TypeScript（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月15日）與我們的分析，不構成法律意見。
開源專案深度解析
先講清楚它不解決什麼：不是行情終端，是研究流程的容器
把 Vibe-Research 當成看盤軟體會失望。它的定位寫在 README 裡：本地金融研究工作台。首頁打開就是一個交流框，預設是普通對話，Agent 開關在左上角，預設關閉。這個預設值透露了設計者的判斷，他認為大部分人日常只是問問題、翻譯材料、定位資料，真正需要多步驟查證的時刻是少數。
它要解決的問題比較窄：當你用 LLM 做個股研究，得到的往往是一段無法追溯的文字，數字從哪來、用了哪一版財報、兩個來源衝突時怎麼取捨，全部消失。Vibe-Research 把這些東西拆成檔案落地。六階段研究跑完會產出 report.md、evidence.json、calculations.json、conflicts.json、manifest.json 與 viewer.html。evidence.json 每條證據保留來源、資料期與原文引用；calculations.json 記錄派生數字的輸入、函數與計算 DAG；conflicts.json 保留跨來源衝突而不靜默取捨。
適用對象因此很明確：會自己讀財報、在意引用來源、願意為可複核性付出安裝成本的人。如果你只想問「這檔股票能不能買」然後拿一個答案，這套流程反而礙事。
推理跑在誰的機器上：三個訂閱適配器與一層受控工具
架構上它不自己訓練也不託管模型，而是當一層外殼疊在既有 Agent 執行環境之上。Codex 訂閱由 OpenAI Codex Harness 承載，Claude.ai 訂閱由本機 Claude Code Agent 承載，WorkBuddy 與 CodeBuddy 帳號由騰訊官方 CodeBuddy Code CLI 承載。README 的說法是，Vibe Research 在這些執行環境之上統一疊加金融資料、研究 SOP、確定性計算、證據校驗和合規邊界。
關鍵機制在工具權限。進入六階段研究時，Claude Code 與 WorkBuddy 的內建工具會被關閉，只開放 Vibe Research 的五個受控 MCP 工具，README 明確寫「不會暗中換成 Codex」。這代表研究階段的資料來源是被鎖住的，模型不能自己去翻網頁填空。普通 Agent 對話則相反，開啟後可以聯網搜尋、讀取網頁、取數和計算，回覆會附上實際工具記錄。
兩種模式的分工寫得很清楚：Agent 模式維持上下文與任務狀態、保留進度與證據鏈；普通對話模式保留聊天記錄但不啟動工具研究，也不保留 Agent 任務記憶。這個切分的好處是成本可控，壞處是你得記得自己現在在哪個模式，因為同一句話在兩個模式下得到的東西完全不同。
安裝前先驗 Node：那個會擋住你的 TypeScript 檢查
環境要求寫得很死。Node.js 需大於等於 22.18，建議 24 LTS；Python 需大於等於 3.11，建議且已驗證 3.12；Windows 原生執行，不要求 WSL。Agent 引擎隨依賴安裝，開發分支鎖定並已本機驗證 0.153.4，使用者不需要另外全域安裝 Codex。
最容易踩的坑是 Node 的建置方式。README 要求執行 node -p process.features.typescript，輸出必須是 strip 或 transform。部分 Linux 發行版倉庫打包的 Node 在編譯時關掉了這項，啟動或跑測試會出現 ERR_UNKNOWN_FILE_EXTENSION ".ts" 或 ERR_NO_TYPESCRIPT。npm test 之前會先做這項檢查並給出同樣提示。換句話說，這不是可選的疑難排解步驟，是安裝前的第一道門。
Windows 流程是 git clone 之後執行 scripts\setup-windows.cmd 與 scripts\start.cmd。setup 會建立 .venv、安裝 Node 與 Python 依賴、初始化產品私有目錄並執行體檢；start 啟動本地 API、瀏覽器 UI 並打開 http://127.0.0.1:5930。macOS 與 Linux 對應的是 scripts/setup 與 scripts/start，start 會檢查安裝狀態與埠，同時啟動兩端，確認可用後才開瀏覽器。README 特別註明不需要開兩個終端，這對照的是舊版文件要求分別啟動兩端的做法。
desktop/ 是瀏覽器前端目錄，不是 Mac 客戶端。v1.2.0 原始碼版暫時撤下 Mac 安裝殼，只維護原始碼加本地瀏覽器工作台，目的是方便用開發 Agent 直接改造頁面與功能。舊 Mac 客戶端資料不會自動遷入原始碼工作區，README 提醒不要刪除 ~/.vibe-research-desktop，也不要把它提交到倉庫。
接入 AI 的三條路，以及 API 與訂閱的真實差別
首次開啟會彈出「請接入AI」。已登入的 Codex、Claude Code、WorkBuddy 可以點對應入口測試並儲存；其他接入方式進設定頁，支援 API 配置與登入說明。新連線預設關閉 Agent，之後開首頁不用重複選，左上角顯示已儲存的實際來源。設定頁會即時檢測 CLI、版本與登入狀態。
使用 ChatGPT 訂閱的路徑是：進入接入 AI、訂閱接入、點「登入 Codex」，在自動打開的 OpenAI 官方頁面完成授權，頁面自動識別登入結果後點「測試並保存」。訂閱適配器復用對應登入帳號，研究階段會隔離使用者配置、自動記憶與會話落盤。
訂閱與 API 的差別不只是計費。README 的表格寫明：訂閱或 API 都可作為推理來源，但只有已驗證的 API 走直接請求，其他來源使用無工具的原訂閱或 Responses 通道。Qwen Code 與 DeepSeek CLI 目前仍需各自的 API key，歸入 API 接入。另外，訂閱的普通對話仍需啟動對應客戶端，README 直言不承諾固定回應時間。這點在評估時不該被忽略，因為它意味著回應速度取決於你本機那個 CLI 的狀態。
失敗狀態是設計出來的：incomplete、failed 與停止請求的差別
README 有一句很硬的規則：任何關鍵資料拿不到，狀態都會變成 incomplete 或 failed，不會用舊值或猜測填空。這在投研場景是對的選擇，因為用舊財報數字補新季度是最常見也最難察覺的錯誤。代價是研究常常跑不完，而你得接受這件事。
中止機制也做了區分。研究執行中可以請求中止，重新整理頁面後仍能查看狀態，此前已完成的階段會保留。但發出請求不代表後台已停止，頁面會區分停止請求、停止確認與無法確認的失敗狀態。這種三態處理比一般「已取消」的按鈕誠實，也意味著你不能假設按下停止就省下了算力。
持倉匯入是另一個有明確邊界的設計。截圖或表格只生成草稿，不自動寫入台账，人工核對後才確認儲存。選定的圖片或表格內容會發送給當前 AI 來源，README 要求在提交前移除無關敏感資訊。本次轉寫的暫存檔案會在成功、失敗或取消後清理，但 README 同時註明，這個清理只針對本機暫存件，不代表模型服務商刪除了已收到的內容。這段話值得逐字讀，因為它把責任邊界畫在本地檔案系統，而不是畫在資料離開你機器之後。
六階段研究與回測：入口很少，前置條件很多
個股研究走 A 股六階段：公司畫像、財務、一致預期、估值、風險、報告。這是整個專案最重的功能，也是唯一會產出完整證據鏈的路徑。多空辯論讓多方、空方、反駁與中立主持共用同一份真實資料包，這個設計避免了各方引用不同數據然後各說各話。
回測比較特別，它只提供 Agent 對話入口。資訊不足時補問，齊備後才調用真實回測工具。這表示沒有表單可以填參數，你必須用對話把條件講清楚，否則它會反問你。對熟悉回測框架的人來說這很囉唆，但對不想學 DSL 的人來說是降低門檻。
其餘模組偏資訊聚合：每日復盤匯總市場、熱點、漲停原因與當日線索；資訊雷達處理 Investment News 標題翻譯、公開新聞、A 股公告與事件機率；產業信號涵蓋 GPU 租金、月頻產業資料、原材料、招聘與資料日曆；板塊中心可下鑽到具體產業方向。我的研報支援本地保存 PDF、DOCX、TXT、MD、CSV，並提供抽取、檢索、引用、下載與刪除。這些模組的資料來源與更新頻率，README 沒有逐一說明，評估時應自行確認。
同類工具的差異：雲端投研助手與本機工作台的分歧點
市面上常見的做法是雲端投研助手，你把持倉和問題上傳，平台回你一份報告。差別不在功能清單，在資料流向與可複核性。雲端方案通常不給你 evidence.json 這種東西，你拿到的是成品；Vibe-Research 把中間產物全部留在本機，viewer.html 可以在瀏覽器裡查看證據與報告。
反過來說，雲端方案幫你處理了部署、模型選擇與更新，Vibe-Research 全部丟回給你。你要自己裝 Node 22.18 以上、Python 3.11 以上、跑 setup 與 start、顧好 5930 埠，還要自己維護那個訂閱 CLI 的登入狀態。如果你的團隊沒有人願意碰這些，這套工具會在第一次升級時就停擺。
另一個實際差異是模型綁定。它不提供自己的模型，而是復用你已有的訂閱。好處是你不用再付一份推理費用，壞處是上游 CLI 改版、登入策略調整或配額變動，都會直接影響你的研究能不能跑。v1.0.4 的發布說明就修過一個帶全域 MCP 配置時對話與測試並存全部失敗的問題，v1.0.3 修過連接探針借用 /chat 的問題。這些修復說明整合層本身就是維護負擔所在。
授權、維護成本與該先驗證的事
授權是 MIT，程式碼可讀可改可商用，README 也明確鼓勵用開發 Agent 打開倉庫改造頁面與功能。要注意的是 MIT 只覆蓋這個倉庫的程式碼，不覆蓋你接入的模型服務、資料來源或第三方 CLI，那些各自有條款。截圖與表格轉寫會把內容送到你選定的 AI 來源，這部分的合規責任在使用者身上，README 也是這樣寫的，本文不提供法律意見。
維護成本主要來自三處：Node 與 Python 版本要求偏新；Agent 引擎鎖定在特定版本並隨依賴安裝；三個訂閱適配器各自依賴上游 CLI 的行為。從 CHANGELOG 的節奏看，v1.0.3 到 v1.1.0 之間有多個針對整合層的修補，這是這類外殼專案難以避免的。
動手之前建議依序確認四件事。第一，node -p process.features.typescript 是否輸出 strip 或 transform。第二，scripts/setup 的體檢是否全過。第三，你要用的訂閱在設定頁是否被識別為已登入。第四，跑一輪六階段研究，實際打開 evidence.json 與 calculations.json，看引用與計算 DAG 是否符合你對可複核的要求。這四步都過了，再談把它放進日常工作流。
編輯結論
如果你本來就有 Codex、Claude Code 或 WorkBuddy 訂閱，而且在意研究結論能不能被逐條複核，Vibe-Research 值得動手跑一次：先確認 node -p process.features.typescript 輸出 strip 或 transform，再依 scripts/setup 與 scripts/start 走完流程，接著開一輪六階段研究，檢查 evidence.json 與 calculations.json 是否真的留下來源與計算 DAG。反過來說，如果你要的是手機看盤、即時報價或保證回應延遲的雲端服務，這套東西從架構上就不服務你，因為它把推理綁在你本機的 CLI 與瀏覽器埠 5930 上。
社群筆記