SuperPortia 專案全景 — 29 個專案，3 個維度
SuperPortia 已成長至 29 個專案。沒有地圖，連建設者自己都會迷路。這篇文章就是那張地圖——一個完整的登錄表，以三個分類維度讓全景一目了然。
三個維度
每個專案都沿三個軸分類：
1. Port（在哪裡找到它）
本地 port 號是專案在 SS1 上的地址。Command Center 透過這些 port 監控健康狀態。沒有 port = 純雲端服務或沒有執行中的進程。
Port 範圍遵循慣例：
| 範圍 | 用途 |
|---|---|
| 3000–3999 | 前端開發伺服器 |
| 4000–4999 | 後端服務 + API |
| 6000–6999 | 資料庫 + Docker 基礎設施 |
| 8000–8999 | API 伺服器 + MCP |
2. 部署類型（如何更新）
這是最容易搞混的維度，因為有九種截然不同的模式。知道一個專案使用哪種模式，決定了程式碼變更時你該做什麼。
cloud-serverless — 推送程式碼、wrangler deploy，完成。無需本地建置步驟。程式碼直接在 Cloudflare Workers 上執行。Serverless = 沒有伺服器要管理。
- 範例：Cloud UB Worker、Email Intake、Scout Worker
local-build-cloud — 必須先在本地建置（例如執行 npm run deploy，裡面包含 opennext/astro build），再將建置產物部署到 Cloudflare Workers。跳過本地建置 = 部署舊程式碼。
- 範例：Bridge（OpenNext → CF Workers）、Reading（Astro → CF Workers）
cloud-static — 推送到 GitHub，Cloudflare Pages 自動建置並部署。git push 後零手動步驟。
- 範例：Docs Site、Catmints Cafe、Blog
factory-storefront — 最複雜的模式。本地 pipeline（Python/LangGraph）每日執行以產出內容（JSON、MDX），Astro 再以這些內容建置網站並部署到 Cloudflare Pages。程式碼很少變動；內容每日更新。
- 範例：NQIO（KOL pipeline → 每週報告 → Astro → CF Pages）
local-only — 透過 launchd 在 SS1 上執行。無雲端部署。僅能透過 localhost 存取（或透過 Cloudflare Access 遠端存取）。
- 範例：Command Center、SPM、Agentic
local-tunnel — 透過 Docker 或 launchd 在本地執行，透過 Cloudflare Tunnel（cloudflared）暴露到網際網路。服務本身留在 SS1。
- 範例：SiYuan Notes（Docker + tunnel → note.superportia.dev）
local-daemon — 在 SS1 以背景進程運行（launchd 或 cron）。無網頁 UI。靜默地執行工作——監控、輪詢、分類。
- 範例：SRE、KOL Narratives、MCP Server、MTAAA Pipeline
docker — 在 SS1 的 Docker 容器中執行。可能有或沒有網頁 UI。以 docker start 或 Docker Compose 啟動。
- 範例：Open WebUI、LiteLLM、Qdrant
config-only — 不是執行中的服務。包含設定檔、規則、腳本或文件，供其他專案使用。
- 範例：Ops（.claude/ 設定）、Vault（Obsidian 知識庫）、SuperPortia Monorepo
3. 角色（在生態中做什麼）
platform-hub — 本身是一個應用程式，同時管理子專案或模組。有自己的登錄/索引頁面。
- Command Center → 在
/projects管理所有 29 個專案 - SPM → 在
/modules管理 62 個模組 - NQIO → 管理 KOL 頻道 + pipeline 執行記錄
- Agentic → 管理學習板 + 閱讀來源
standalone — 單一目的應用程式，專注做好一件事。
- Bridge → CEO 每日儀表板 + agent 對話
- Reading → RSS 閱讀 + AI 問答
- SiYuan → 筆記
infrastructure — 其他專案依賴它。它一旦停機，多個東西會跟著壞。
- Cloud UB Worker → 大腦，所有系統都查詢它
- MCP Server → Claude Code 連接 UB 的橋接
- Qdrant → 本地嵌入的向量搜尋
- SRE → 監控 + 告警
pipeline — 按排程處理資料。沒有互動 UI。輸入 → 轉換 → 輸出。
- Email Intake → Gmail → 分類 → email_intel 表
- Scout Worker → RSS → 解析 → UB 條目
- KOL Narratives → YouTube → NotebookLM → 交易情報
static-site — 純 HTML/CSS/JS，無伺服器端邏輯。內容透過 git push 更新。
- Docs Site、Catmints Cafe、Blog
config-ops — 不是服務。提供其他系統使用的規則、腳本和設定。
- Ops、Vault、SuperPortia Monorepo
完整登錄表
| # | Port | 專案 | URL | 部署 | 角色 | 狀態 |
|---|---|---|---|---|---|---|
| 1 | 3000 | NQ 2026 Alpha | — | local-only | standalone | dev |
| 2 | 3000 | Weekly Ops | week.nqio.dev | local-only | standalone | dev |
| 3 | 3001 | Open WebUI | — | docker | standalone | standby |
| 4 | 3002 | Bridge | bridge.superportia.dev | local-build-cloud | standalone | active |
| 5 | 3333 | Docs Site | docs.superportia.dev | cloud-static | static-site | active |
| 6 | 3900 | Command Center | — | local-only | platform-hub | active |
| 7 | 3991 | SPM | spm.superportia.dev | local-only | platform-hub | dev |
| 8 | 3994 | NQIO | nqio.dev | factory-storefront | platform-hub | dev |
| 9 | 4000 | LiteLLM | — | docker | infrastructure | standby |
| 10 | 4010 | Agentic | agentic.superportia.dev | local-only | platform-hub | dev |
| 11 | 4321 | Reading | read.superportia.dev | local-build-cloud | standalone | active |
| 12 | 6333 | Qdrant | — | docker | infrastructure | active |
| 13 | 6806 | SiYuan | note.superportia.dev | local-tunnel | standalone | active |
| 14 | 8787 | MCP Server | — | local-daemon | infrastructure | active |
| 15 | — | Cloud UB | ub.superportia.dev | cloud-serverless | infrastructure | active |
| 16 | — | Email Intake | — | cloud-serverless | pipeline | active |
| 17 | — | Scout Worker | scout.superportia.dev | cloud-serverless | pipeline | active |
| 18 | — | KOL Narratives | — | local-daemon | pipeline | active |
| 19 | — | MTAAA Pipeline | — | local-daemon | pipeline | dev |
| 20 | — | NQ ICT Scout | — | local-daemon | pipeline | dev |
| 21 | — | Ops | — | config-only | config-ops | active |
| 22 | — | SRE | — | local-daemon | infrastructure | active |
| 23 | — | Vault | — | config-only | config-ops | active |
| 24 | — | Catmints Cafe | cafe.superportia.dev | cloud-static | static-site | active |
| 25 | — | Blog | blog.superportia.dev | cloud-static | static-site | dev |
| 26 | — | SuperPortia | — | config-only | config-ops | active |
| 27 | — | UB Dashboard | ub.superportia.dev | cloud-serverless | standalone | planned |
| 28 | — | Nyam | nyam.superportia.dev | planned | standalone | planned |
| 29 | — | Prop Firms | propfirms.superportia.dev | planned | standalone | planned |
如何讀這張表
按部署類型 — 當你需要更新某個東西時：
- cloud-serverless / cloud-static →
git push或wrangler deploy - local-build-cloud → 先本地建置，再部署
- factory-storefront → 先跑 pipeline，再建置 + 部署
- local-only / local-daemon →
launchctl kickstart - docker →
docker restart
按角色 — 當某個東西壞掉時：
- infrastructure 停機 → 多個專案受影響，優先修復
- platform-hub 停機 → 管理能見度喪失，但應用程式仍能運作
- pipeline 停機 → 資料停止流動，但現有資料仍在服務
- standalone 停機 → 只有那個應用程式受影響
按狀態 — 哪些需要關注：
- active（17 個）→ 正式運行中
- development（7 個）→ 開發中，可能不穩定
- standby（2 個）→ 已安裝但未運行
- planned（3 個）→ 僅登錄佔位
Port 衝突
截至 2026-03-15，存在一個未解決衝突：
- 3000：NQ 2026 Alpha + Weekly Ops（Weekly Ops 是子專案，將合併入 NQIO）
Port 3001 衝突已解決：Open WebUI 維持 3001（待機狀態），Bridge 已移至 3002，兩者不再同時運行。
這張地圖能做什麼
有了登錄表的三個維度，Command Center 可以：
- 按角色篩選 — 只顯示 infrastructure，或只顯示 pipeline
- 按部署類型分組 — 「哪些需要手動部署」vs「推送自動部署」
- 按 port 監控 — 對所有有 port 的專案做健康檢查
- 合規稽核 — 哪些專案通過
/createscaffold 驗證
登錄表存於 command-center/src/data/registry.json，是所有專案元資料的唯一真實來源。
代理工具的技術比較請參考 AI Agent Orchestration Tools Comparison 和 AI Agent Browser Control — Who Can See Your localhost?
...結，Astro Modular 會自動解析並生成正確的 URL： - [[Obsidian 整合功能展示]] — Obsidian 功能的完整展示文章 - [[SuperPortia 專案全景]] — SuperPortia 整體架構概覽 Wikilink 解析規則 Astro Modular...
...而是長期的架構選擇。 小結 Pages 是起點，Workers 是方向。這個轉變不是為了趕上新技術，而是因為 Cloudflare 把它的整個儲存 + 計算生態都綁在 Workers 上。 SuperPortia 的部署現況： - 3 個 Workers 提供後端 API 和排程工作 - 4 個 Pages 站點提供靜態前端 - D1 + Vectorize 提供持久儲存，全部在免費層內 - 新...
...的事情 - 它提出已經被否決的方案 - 它詢問已經被回答的問題 - 它忽略來之不易的約束條件 每一個都在浪費時間和 token 預算。Context Hub 就是防禦。 實際意涵 上下文不是免費的。寫好的 UB 條目、維護準確的 MEMORY.md、保持 Vault 筆記更新——這些都需要真實的工作。但回報是複利的：每個記錄良好的決策都可以在未來的...
...ent-browser-control-comparison|AI 代理瀏覽器控制]] 這篇文章探討了 agent 如何看見瀏覽器畫面的問題。 你也可以為 wikilink 加上自訂顯示文字，例如 [[SuperPortia 專案全景]] ，讓連結文字更具可讀性。 3. 程式碼區塊 展示多語言語法高亮。程式碼區塊支援行號顯示與複製按鈕。...