dev3000

dev3000 概覽

這是什麼

d3k (dev3000) 是一個以代理程式為優先的本地網頁除錯執行環境。它會啟動開發伺服器、開啟一個帶有專案穩定 Chrome 設定檔的受監控瀏覽器，並提供統一的時間軸，包含伺服器日誌、瀏覽器錯誤、網路活動、互動記錄與螢幕截圖。主要介面是供編碼代理程式使用的 d3k 技能；獨立 TUI 也可用，但非代理程式工作流程所必需。每個應用程式預設會獲得一個穩定的 Portless URL，因此當底層開發埠變更時，瀏覽器狀態與回呼不會移動。

主要功能

• 擷取開發伺服器輸出、瀏覽器主控台訊息與例外、網路請求與回應、使用者互動、導航與錯誤螢幕截圖，以及 Chrome DevTools Protocol 事件。
• 為每個專案提供位於 ~/.d3k//chrome-profile/ 的持久性 Chrome 設定檔，可在除錯工作階段之間保留登入狀態、Cookie 與本地儲存。
• 提供 Portless URL 功能，為每個應用程式提供穩定的無埠 HTTPS URL（例如 https://my-app.localhost），使開發埠變更時瀏覽器狀態保持不變。
• 包含代理程式指令，如 d3k status --json、d3k errors --context、d3k logs 以及 d3k agent-browser，用於驅動受管理的瀏覽器。
• 支援自動偵測常見網頁專案，包括 Next.js、Vite、React、Vue、Svelte、Astro、Django、Flask、FastAPI 與 Rails。
• 每個專案儲存以下成品：活躍工作階段、合併日誌、螢幕截圖、Chrome 設定檔與當機日誌。

使用情境

• 透過讓編碼代理程式檢查伺服器與瀏覽器事件的統一時間軸來除錯網頁應用程式。
• 使用能跨工作階段保留登入狀態與 Cookie 的受管理瀏覽器重現錯誤。
• 測試 OAuth 及其他對驗證敏感的流程，避免因不同瀏覽器身份而中斷登入。
• 在 CI 中使用無頭 Chrome（--headless）執行自動化除錯或測試。

快速開始

需要 Node.js 24 或更新版本。全域安裝執行環境：bashbun install -g dev3000或使用 npm：bashnpm install -g dev3000為編碼代理程式安裝 d3k 技能：bashbunx skills add vercel-labs/dev3000 --skill d3k --agent '*' -g -y安裝後，執行 d3k portless setup 進行一次性管理員授權，以產生/信任本地 HTTPS CA 並在連接埠 443 上安裝由 root 擁有的啟動服務。然後使用 d3k -t 以代理程式安全模式啟動執行環境。

授權與價格

本專案採用 MIT 授權。它是開放原始碼且免費使用。

內容整理自該專案公開的 README 與儲存庫資訊。