🐲 Pixiu Agent 3280
IDE AI 效能引擎 — 算力解放 — 專為 Gemini 3.1 Pro (2M Context) 與 Claude Opus 4.6 等具備超大型上下文窗口的大模型量身打造。透過獨家「精準 Prompt 注入」與「Token 智慧壓縮引擎」，完美解決大模型在 IDE 複雜專案中容易發生的「上下文迷航 (Lost in the Middle)」問題。即使未安裝或未配置 Gemini / Opus，Pixiu 核心功能（守護機制、Context 壓縮、規則治理）仍可正常運作；雙模型分數主要代表相容性評估。
IDE AI Performance Engine — Compute Unleashed — Engineered for massive-context models such as Gemini 3.1 Pro and Claude Opus 4.6. Core Pixiu capabilities still run without Gemini/Opus setup; model-specific cloud insights require key configuration.
⚡ TL;DR (核心價值)
- 🔒 確保團隊寫法一致 (治理一致性) — 將專案的 Coding Style 與架構知識寫入
.agent/，任何 AI 都能自動讀取並遵守，大幅減少 Code Review 的修改負擔。
- 🛡️ 預防低級失誤 (主動防禦) — 內建 10 大守護神機制！在你存檔的瞬間主動攔截 API Key 洩漏、提醒同步測試與文件，將 DevOps 安全防線推到寫 Code 當下。
- 💰 提升速度與降低成本 (Token 壓縮) — 透過專利
ContextBuilder 壓縮冗餘的對話上下文，拒絕無腦發送無效歷史紀錄，節省高達 25% Token 消耗，並讓 AI 回答更快。
👉 立即安裝 Pixiu Agent 3280
🎯 Why Pixiu — 為什麼需要 Pixiu？
Pixiu 專注在「治理 + 守護 + 成本優化」，補上一般 AI 生成工具沒有處理好的團隊工程問題：
- 治理一致性：把規範寫進
.agent/ + user_rules.md，讓不同人、不同 AI 都能遵循同一套標準。
- 主動防禦：透過 10 大守護機制在儲存當下檢查風險，提早攔截 Secret、測試落後、文件不同步。
- 能力模組化：用 Skills / Workflows / Hooks 拆分能力，方便重用與共享。
- Token 成本優化：ContextBuilder 依任務深度動態調整上下文，減少無效 token 消耗。
- 多 IDE 通用：規則是純文字結構，適用 VS Code 系編輯器與多種 Agent 流程。
🚀 Quick Start — 快速開始
1️⃣ 安裝
👉 VS Code Marketplace — Pixiu Agent 3280
或在 VS Code 搜尋 Pixiu Agent 3280 安裝。
2️⃣ 初始化
- 開啟您的專案
Cmd+Shift+P（Win: Ctrl+Shift+P）- 輸入
Pixiu: 初始化專案
- 看到 Dashboard 啟動，代表初始化完成
3️⃣ 驗證與首次檢查
- ✅ Status Bar 顯示 🐲 Pixiu
- ✅ 專案根目錄已建立
.agent/、AGENTS.md、user_rules.md
- ✅ 儲存任一
.ts / .js 檔案，可看到守護建議或掃描提示
🏛️ 四大自動化支柱 Four Automation Pillars
🧭 ContextBuilder 智慧壓縮引擎：三檔無感切換
當您在本地 IDE (如 VS Code / Cursor) 中切換大腦的思考模式時，Pixiu 獨家開發的 ContextBuilder 引擎 能夠即刻感知，並在底層切換 「Token 預算水管」 來精準控制給大模型的上下文，達到極致的算力解放：
| IDE 介面模式 |
Pixiu 預算水位 |
Token 天花板限制 |
💡 真實開發場景 (何時發動) |
實際運作邏輯（該省則省，該放則放） |
Fast <br>(快速問答) |
🟢Quick |
~2,000 Tokens |
「幫我寫個信箱的正則表達式」<br>或是問點簡單的語法糖時。 |
引擎自動攔截 80%~90% 的無效歷史對話，保護大腦不失焦，模型回應神速。 |
(預設對話) <br>(普通除錯) |
🟡Normal |
~6,000 Tokens |
「這個 API 為什麼一直報 500 錯誤？」<br>日常寫 Code 或追蹤中型 Bug 時。 |
平衡模式。提供剛好夠用的前後文來推演，捨棄太久遠的紀錄，為您省下約50%+ 的算力。 |
Planning <br>(深度推演) |
🔴Deep |
~12,000 Tokens |
「我要重構整個權限系統，請參考之前的討論」<br>需要 AI 綜觀全局、規劃架構時。 |
預算大門敞開！可容納上萬字的心血與規則，幾乎 100% 全額放行所有的知識與對話歷史給模型分析。 |
💡 防呆優先度機制：當遇到超大型專案且 Token 預算吃緊時，引擎不會「死板地亂砍」。它會自動捨棄低優先權的歷史資訊，並 100% 死守最重要的專案規範 (如 user_rules.md) 。讓您的團隊用最精簡的 Token 成本 得到最精準的 AI 回答！
🐲 Guardian — 守護神機制
Pixiu 會在開啟專案時檢查初始化狀態，儲存檔案時觸發守護偵測（#1-#7 + Regression 快速檢查）。#8 CI/CD 狀態需透過 Dashboard 檢視；#9 完整回歸審計可透過 Dashboard 或 Pixiu: 回歸風險檢查 指令執行。以下 10 項守護機制：
| # |
守護神 |
偵測對象 |
觸發條件 |
建議行動 |
| 0 |
🏁Initialization |
全域 |
缺少 .agent/ |
引導初始化 |
| 1 |
🔑Secret |
所有檔案 |
sk-..., ghp-..., JWT |
警告移至 .env |
| 2 |
📦Dependency |
package.json |
react, firebase... |
推薦安裝 Skills |
| 3 |
🔄Workflow |
package.json |
test, build script |
推薦 Workflows |
| 4 |
📄Doc Watchdog |
程式碼檔案 |
RoadMap > 24h 未更新 |
提醒同步文件 |
| 5 |
🧪Test Watchdog |
程式碼檔案 |
測試檔 > 30min 落後 |
提醒更新測試 |
| 6 |
🤖Agents |
docs/ |
文件 > 3 個 |
推薦 Opus Advanced |
| 7 |
🪝Hooks |
.git/ |
無 pre-commit |
推薦安裝 Hooks |
| 8 |
🛡️CI/CD |
.github/ |
缺少 Actions |
推薦 Agent Guard / CI |
| 9 |
🛡️Regression |
Git diff |
高風險變更無測試 |
回歸風險報告 |
Pixiu 獨家技術: 無論使用 Cursor、Windsurf 或 Copilot，Pixiu 可將 user_rules.md（最高憲法）生成為優化 Prompt，一鍵複製貼到 AI 對話，確保規則優先被讀取。
📊 Power Score & UxSoul — 戰力評估與靈魂萃取
🔥 Power Score 戰力評估
前往 Dashboard 點擊 「🚀 戰力評估」 即可開始：
- 📊 雙模型評分 — Gemini / Opus 相容性評分（本地靜態計分，非模型 API 直連）
- 💡 智能優化建議 — 分析缺少的 Skills、Workflows
- 🔄 規則比對引擎 — 版本 Diff 預覽，一鍵合併
補充說明
- 戰力分數為本地靜態評估，重點是規則覆蓋率與治理成熟度，不是雲端模型即時跑分。
- 即使未安裝或未配置 Gemini / Opus，Guardian、ContextBuilder、Power Score 仍可正常使用。
- Dashboard 主要用途是找出缺漏規則，並協助合併建議配置。
🧪 UxSoul 靈魂萃取（進階能力）
前往 Dashboard 點擊 「UxSoul-醬」 可用於：
- 靈魂萃取：逆向整理 UI 程式碼，輸出 UX 行為規格書。
- 資源庫擴充：補齊 Python/TS Patterns、TDD Flow、Agents/Hooks。
- 強化掃描：整合更完整的安全檢核與 CI 工作流。
🛠️ Commands — 指令表
以下指令可透過 Cmd+Shift+P（Win: Ctrl+Shift+P）執行：
| 指令名稱 |
命令 ID |
說明 |
| Pixiu: 初始化專案 |
pixiu.init |
初始化 .agent/ 並開啟 Dashboard |
| Pixiu: 安全掃描 |
pixiu.scan |
深度程式碼安全掃描（OWASP） |
| Pixiu: 列出可用 Skills |
pixiu.list |
查看已安裝技能列表 |
| Pixiu: 推薦 Skills |
pixiu.suggest |
根據專案自動推薦 Skills |
| Pixiu: 安裝 Git Hooks |
pixiu.installHooks |
部署 pre-commit Hook |
| Pixiu: 同步全域規則 |
pixiu.syncGlobal |
將內建規則範本同步到全域 ~/.gemini/user_rules.md |
| Pixiu: 新增 ADR |
pixiu.createADR |
建立架構決策紀錄 |
| Pixiu: 生成 Skill 模板 |
pixiu.generateSkill |
建立自訂 Skill 骨架 |
| Pixiu: 分析專案 Context |
pixiu.gatherContext |
收集專案上下文資訊 |
| Pixiu: 多帳號算力總覽與切換 |
pixiu.accountQuota |
讀取本機多帳號配額快取並切換使用帳號 |
| Pixiu: 生成 AGENTS.md |
pixiu.generateAgentsMd |
生成 AI 規則索引檔 |
| Pixiu: 顯示狀態 |
pixiu.status |
顯示目前守護狀態 |
| Pixiu: 修復 Activity Bar |
pixiu.fixActivityBar |
修復側邊欄圖示 |
| Pixiu: 回歸風險檢查 |
pixiu.regressionAudit |
執行完整回歸風險偵測 |
📁 Project Structure — 專案結構
必建文件
| 文件 |
說明 |
AI 偵測用途 |
docs/RoadMap.md |
專案規劃藍圖 |
必備！ AI 分析的基礎 |
README.md |
專案介紹 |
技術棧偵測 |
CHANGELOG.md |
版本記錄 |
變更追蹤 |
💡 使用 Dashboard 「📚 入門指南」 可一鍵建立或讓 AI 補齊這些文件
用戶目標專案結構 (Target Project Structure)
當您在自己的專案初始化 Pixiu 後，您的專案將會形成以下結構：
your-project/
├── .agent/ # 🐲 Pixiu Agent（初始化後自動生成）
│ ├── extensions/ # 🧬 基因層 — 跨 Skill 底層能力（DNA）
│ ├── skills/ # 📚 專業層 — 領域知識（教科書）
│ ├── workflows/ # 📋 流程層 — 操作步驟 SOP
│ ├── agents/ # 👨⚕️ 專家層 — Sub-Agent（專科醫生）
│ ├── hooks/ # 🤖 自動層 — Git 提交攔截（守衛機器人）
│ ├── logs/ # 📝 執行日誌
│ ├── reports/ # 📊 掃描報告 + 回歸報告
│ └── config.yaml # ⚙️ Config
├── .github/ # 🛡️ CI/CD 自動化防護
│ └── workflows/ # ⚙️ GitHub Actions
├── docs/ # 📚 專案文件（必建！AI 分析基礎）
│ └── RoadMap.md # 🗺️ 必建！AI 分析基礎
├── AGENTS.md # 🤖 AI 規則索引 — 被動上下文注入
└── user_rules.md # 📜 ⭐ 專案最高憲法
❓ FAQ — 常見問題
Pixiu 是否綁定特定 IDE？
不綁定。Pixiu 支援所有基於 VS Code 的編輯器，包括 VS Code、Cursor、Windsurf、Antigravity。.agent/ 規則是純文字檔案，任何 AI Agent 都能讀取。
Pixiu 會上傳我的程式碼嗎？
不會。 Pixiu 預設不會傳送您的本機程式碼與專案資料。
此外，當 Pixiu 進行雲端更新（拉取最新的 Prompt、Skills、Workflows、Agents、Hooks 等進階工具）時，均為純單向下載，過程中絕對不會夾帶或上傳您的任何本機程式碼與專案資料。
如何停用某個守護機制？
在 VS Code 設定中將 pixiu.enableWatchdog 設為 false 可停用所有守護。個別守護（如 Regression Guardian）可透過 pixiu.regressionGuard.enabled 單獨關閉。
Regression Guardian 會誤報嗎？
MVP 版本刻意採用低誤報策略：不做 AST 深度語意分析，只看檔名規則與行數變化。如果仍遇到誤報，可調整 pixiu.regressionGuard.deletionThreshold（預設 30 行）。
📎 References — 參考資源
📄 License
MIT License — 開源且可商業使用 / Open source, commercial use allowed
