1 line
2.6 KiB
JSON
1 line
2.6 KiB
JSON
{"repo": "appleson1993/lucy-a-powerful-ai-helper", "files": {"DEV_NOTES.md": {"d99b44f9e785b02d5d1e0e653dd2e1fd0b943a89": {"t": 1785846894.952216, "n": 1643, "h": "8cd4e58e88ba3464", "c": "# 專案開發注意事項\n\n## Windows Native Modules 安裝\n\n本專案使用以下 native modules，需要編譯環境:\n\n### 安裝 Visual Studio Build Tools\n\n```bash\nnpm install --global windows-build-tools\n```\n\n或手動安裝 [Visual Studio Build Tools](https://visualstudio.microsoft.com/downloads/)\n\n### 問題排解\n\n如果 `keysender` 安裝失敗:\n```bash\nnpm install --save keysender --build-from-source\n```\n\n如果 `better-sqlite3` 安裝失敗:\n```bash\nnpm rebuild better-sqlite3\n```\n\n## API 配置\n\n### OpenAI API\n\n1. 前往 https://platform.openai.com/api-keys\n2. 創建 API Key\n3. 填入 `config.local.json`:\n ```json\n {\n \"ai\": {\n \"apiUrl\": \"https://api.openai.com/v1/chat/completions\",\n \"apiKey\": \"sk-xxx...\"\n }\n }\n ```\n\n### Claude API\n\n```json\n{\n \"ai\": {\n \"apiUrl\": \"https://api.anthropic.com/v1/messages\",\n \"apiKey\": \"sk-ant-xxx...\",\n \"model\": \"claude-3-opus\"\n }\n}\n```\n\n### Gemini API\n\n```json\n{\n \"ai\": {\n \"apiUrl\": \"https://generativelanguage.googleapis.com/v1beta/models/gemini-pro-vision:generateContent\",\n \"apiKey\": \"AIza...\",\n \"model\": \"gemini-pro\"\n }\n}\n```\n\n## 開發模式\n\n啟用 DevTools:\n```bash\nnpm run dev\n```\n\n## 打包注意事項\n\n1. 確保所有 native modules 已正確編譯\n2. 檢查 `package.json` 中的 `build.files` 排除不必要的檔案\n3. 準備應用程式圖示 (`build/icon.ico`)\n\n## 測試清單\n\n- [ ] 快捷鍵註冊成功\n- [ ] 截圖功能正常\n- [ ] 視窗彈出並置頂\n- [ ] AI API 調用成功\n- [ ] 文字回填到目標應用\n- [ ] 歷史記錄儲存與讀取\n- [ ] 應用關閉時清理資源\n- [ ] 多次觸發快捷鍵穩定性\n\n## 效能優化\n\n1. 截圖壓縮: 調整 `quality` 參數平衡品質與檔案大小\n2. API 請求快取: 相同截圖+指令可快取結果\n3. 資料庫索引: 為 timestamp 建立索引加速查詢\n4. 記憶體管理: 限制歷史記錄數量避免資料庫過大\n\n## 安全性考量\n\n1. API Key 不應提交到版本控制\n2. 使用 `config.local.json` 儲存敏感資訊\n3. 截圖資料不應傳送到非必要的第三方服務\n4. 考慮加密本地資料庫（可選）\n\n## 已知限制\n\n1. 目前僅支援 Windows\n2. 某些應用程式（遊戲、管理員權限）可能無法回填\n3. 多顯示器環境預設只截取主螢幕\n4. 大尺寸截圖可能超過 API 限制\n"}}}} |