Windsurf

目標:做一個本機優先的 AI 程式碼代理,能讀取專案、回答問題、產生修改並在使用者確認後執行指令。 技術棧建議:VS Code Extension + TypeScript 本機服務,SQLite 儲存索引,tree-sitter 分析程式碼,支援 Ollama 與 OpenAI 相容 API。 需求: - 讓使用者從 VS Code 開啟側邊欄聊天面板,顯示串流回答 - 讀取目前工作區的檔案樹、目前檔案、選取文字與游標位置 - 依 gitignore 排除檔案,支援 glob 設定與檔案大小上限 - 建立本機程式碼索引,可依關鍵字與語意搜尋相關檔案片段 - 使用 tree-sitter 擷取函式、類別、匯入與檔案路徑等符號資訊 - 支援以 @file、@folder、@selection 明確指定上下文 - 讓代理提出多檔案修改計畫,逐檔產生 unified diff 預覽 - 使用者核准後才套用 patch,並提供單次復原功能 - 支援在工作區執行測試、lint、build 等指令,執行前顯示完整指令並要求確認 - 將終端機輸出與錯誤訊息回傳給代理,可依錯誤提出下一步修正 - 支援自訂系統提示、模型、溫度、上下文檔案數與最大輸出長度 - 對每個工作階段保留對話與修改紀錄,可搜尋並刪除紀錄 - 提供快捷鍵將目前錯誤、選取程式碼或檔案內容送進聊天 - 匯出對話、設定、索引 metadata 與 patch 紀錄為 JSON 或 Markdown 明確不做(out of scope):雲端同步、多使用者協作、專有模型訓練、背景自主修改全部檔案、自動部署、未經確認的終端機指令、繞過付費 API 或編輯器授權。 README 要求:說明安裝 VS Code 外掛、啟動本機服務、Ollama 與 OpenAI 相容 API 設定、權限風險、資料位置、匯出與清除方式。