數據工作室

🟢 適合入門。 數據工作室（Data Studio）只構建唯讀儀表板。它不會下單、轉帳、連接錢包，也不會索取私鑰。

數據工作室會把自然語言需求變成帶即時或單次載入金融數據的 React 儀表板。項目包含方案、原始碼、經過驗證的構建；選擇發佈後，還會生成可分享的本機站點。

它適用於行情監控、自選清單、排行榜、財報表格、投資組合視圖、熱力圖、K 線、風險視圖、殖利率曲線、訂單簿深度等需要重複使用和互動的頁面。

目前工作流程

1. 開啟 數據工作室，描述想要的儀表板，也可以附上參考圖片。
2. 在輸入框中選擇 計畫 或 自動。
3. Agent 會建立項目方案、解析數據與組件契約、編寫原始碼，並執行確定性的構建和預覽檢查。
4. 在 預覽、Code、方案、數據與統計 和 設定 中檢查結果。繼續聊天即可修改同一個項目。
5. 預覽就緒後，可把某個固定版本發佈到可自訂的本機連結。

這裡的聊天使用與主 Chat 模組相同的工作日誌和工具顯示。執行成功後，儀表板交付卡片會顯示在 Agent 輸出末尾。卡片可以開啟預覽，也提供項目根目錄入口。

計畫與自動模式

計畫 會先生成完整方案。方案儲存後，數據工作室會立即開啟 方案 標籤頁。批准執行前，你可以查看方案、預覽交付物並提出修改意見。批准後會開啟新的 Agent turn，並允許使用正常的數據工作室工具。

自動 會立即開始實作。Agent 仍會在項目中儲存 plan.md，並執行相同的數據、組件、構建和預覽檢查。後續需求可以隨時切換模式，計畫模式不是永久預設值。

項目檔案與版本

每個項目都存放在 Minara 的穩定 workspace 中，不依賴臨時 Git worktree 或運行目錄。項目會保留：

• 目前的 plan.md；
• src/ 下的生成原始碼；
• 不可變的成功構建版本和最新預覽產物。

工作階段中上傳的檔案使用獨立的持久化恢復儲存，因此程序重啟後，圖片與檔案引用仍然可用。

透過 Code → 項目根目錄 可以定位項目目錄。只有組件契約、編譯和必要的運行時檢查全部通過後，構建才會成為正式版本。失敗的修改不會覆蓋最後一個可用預覽。

重新進入項目時預設開啟 預覽。如果重啟後仍有原始碼但預覽產物遺失，系統會在統一的預覽 loading 狀態下自動嘗試構建一次。自動嘗試失敗後，空狀態會提供 恢復 按鈕。若項目只有方案還沒有構建，預覽空狀態會引導開啟 方案 標籤頁。

數據存取與重新整理規則

生成程式碼透過數據工作室 SDK 請求白名單內的數據。Provider 憑證只保留在本機 gateway 或 publisher，不會寫入生成原始碼。

數據工作室會根據使用者需要選擇數據通路：

• 使用者要求即時數據時，優先使用能涵蓋全部必要欄位、無需 Key 的已登記公共 WebSocket。
• 無 Key Public API 可以單次載入，也可以按數據源允許的間隔輪詢。
• 使用你自己已設定 Key 的 API 可以單次載入或輪詢。
• 如果支援轉發的 Provider 缺少本機 Key，Minara 數據轉發可以提供單次載入結果。設定 中會標記為 正在使用 Minara 數據轉發。
• Minara 數據轉發不允許輪詢。需要輪詢時必須使用 Public API 或自己的 Key。

HTTP 數據預設只在頁面載入時請求一次。重新整理頻率較高時，數據工作室會顯示更新間隔和用量提示。更新期間會保留已有的有效數據，只更新發生變化的圖表與數值，不會重新掛載整張圖或重複顯示全頁 loading。

在 數據與統計 中可以查看呼叫次數、錯誤和延遲。在 設定 中可以確認每個數據源是公共數據、使用本機 Key、使用 Minara 轉發，還是目前不可用。API Key 統一在 設定 → API Keys 管理。

金融 UI 與圖表規則

生成的儀表板使用固定的 @minara/studio primitives 和統一圖表主題。編寫程式碼前，Agent 會讀取目前組件 Schema 與 Types。生成後，自動契約審查會阻止未知 Prop、缺少必填欄位、錯誤 import 和不支援的 JSX spread。

組件涵蓋常見金融問題：

• MetricCard、SignedValue、SparklineChart 用於單點數值和小趨勢；
• LineChart、AreaChart、KLineChart、MixedLineBarChart、PerformanceChart 用於時間序列、價量、淨值和回撤；
• HorizontalBarChart、DataTable、AssetHeatmapChart、MatrixHeatmapChart、HistogramChart 用於排名、明細、市場熱力圖、相關性和分佈；
• OrderBookDepthChart、VolumeProfileChart、YieldCurveChart、RangeBandChart、VolatilitySurfaceChart 用於專業金融視圖。

PnL、change、return 等帶方向的數值會同時顯示正負號和金融漲跌色。數據變化時使用短暫顏色過渡，不閃動整張卡片。貨幣和其他度量值必須顯示單位，熱力圖中的金額也必須帶貨幣符號。顏色不會成為唯一的資訊表達方式。

統一主題負責座標軸、網格、Tooltip、Legend、字體、間距、漲跌色和動效。生成項目可以在全域 CSS 中覆寫公開的 --studio-chart-* 變數，無需逐個重寫圖表 option。每個完成的儀表板都會檢查桌面端和 390 px 行動端，並涵蓋 loading、空數據、部分失敗和更新狀態。

發佈與分享

發佈表單會根據項目生成短站點 ID，發佈前可以修改。任何取得連結的人都能開啟站點，無需登入。

以下兩個選項預設開啟，發佈後仍可修改：

• 允許區域網路存取 會把 publisher 綁定到區域網路，並顯示使用本機區域網路 IP 和 publisher 連接埠的連結。
• Minara 關閉後保持存取 會讓本機 publisher 繼續運行，並在登入這台電腦時恢復已發佈站點。

關閉區域網路存取後，連結僅限本機。關閉背景存取後，站點依賴正在運行的 Minara 客戶端。點擊 取消發佈 會撤銷該項目的所有存取連結並停止站點服務。

發佈站點託管在本機或區域網路。允許區域網路存取不會把站點暴露到公共網際網路，主機也必須保持開機並可存取。

安全邊界

數據工作室只能請求白名單內的唯讀數據，並在自己的項目目錄中寫入檔案。它不能：

• 呼叫錢包、交易、swap、withdraw 或 order 工具；
• 連接 MetaMask、WalletConnect 或其他瀏覽器錢包；
• 在生成檔案中寫入 API Key 或其他 secret；
• 從預覽頁面請求任意第三方 URL；
• 在發佈的儀表板中加入交易或資金操作控制項。

如需執行交易，請使用 Chat、Portfolio、Trading、Strategy Studio 或 Autopilot。這些模組會套用各自的預覽與確認門檻。