adhd-copilot 0.2.10

為高功能 ADHD 工作者設計的全方位智能助手

ADHD Copilot 🧠✨

為高功能 ADHD 工作者設計的全方位智能助手

你是不是也有這些經驗？

早上醒來，腦中有十個想法同時運轉。你知道今天該做什麼，但就是無法開始。

或者相反——你進入心流狀態，一口氣工作八小時，忘記吃飯、喝水、上廁所。然後隔天完全燃燒殆盡，連回個訊息都覺得累。

你的履歷看起來很漂亮：學位、工作、專案。但只有你知道，每一個成就背後，是多少個深夜的焦慮、多少次「為什麼我就是做不到」的自我懷疑。

你不是懶，你不是不夠努力。你只是需要一個懂你大腦運作方式的工作夥伴。

---

🎯 高功能 ADHD 的真實困境

「你看起來很好啊」

這是最傷人的一句話。

是的，你完成了學位。是的，你有工作。是的，你看起來「很正常」。

但沒人看到：

• 雙倍的努力：別人花一小時完成的事，你需要三小時——因為你得先對抗分心、拖延、完美主義
• 補償策略的代價：你用「最後一刻衝刺」、「超時工作」、「犧牲睡眠」來彌補執行功能的缺陷
• 隱形的倦怠：表面上你在工作，實際上你的大腦已經過載到無法思考
• 能量的劇烈波動：今天你可以征服世界，明天你連洗碗都覺得是不可能的任務

「為什麼我就是做不到？」

你知道該做什麼。你真的知道。

但知道和做到之間，有一道無形的牆。

• 專案計畫寫到一半就卡住，因為細節太多讓你焦慮
• 想學新技術，但教學文章看到第三段就分心
• 有十個想法想執行，但不知道從哪個開始，最後一個都沒做
• 低能量的時候，連「決定要做什麼」都是一種負擔

這不是你的錯。這是執行功能障礙，不是意志力問題。

---

✨ ADHD Copilot 能為你做什麼？

這不是另一個「待辦清單 App」。這是一個真正理解你大腦運作方式的 AI 夥伴。

🔋 能量感知模式

高能量模式（電力充足）

當你狀態好的時候，我們不浪費這個黃金時段：

• 主動規劃：幫你補齊那些「之後再說」的細節
• 深度工作：一起處理複雜的決策和架構設計
• 專案掃描：分析你的專案，找出下一步該做什麼
• 積極對話：問你問題，幫你把模糊的想法變成具體的計畫

低能量模式（低耗電）

當你累了，我們就輕鬆點：

• 微任務分解：把大任務拆成「不用動腦」的小步驟
• 溫和引導：不問複雜問題，不增加決策負擔
• 簡單選擇：給你 2-3 個明確的選項，挑一個就好
• 鼓勵為主：認可你的小進展，不批判、不施壓

💬 不只是程式，是你的一切工作

• 寫程式卡住了？我們一起除錯
• 文章寫不出來？我們一起整理大綱
• 想學新東西但不知道怎麼開始？我們一起規劃學習路徑
• 專案太多不知道先做哪個？我們一起評估優先順序

📁 智能專案掃描

不用手動整理，直接掃描你的專案資料夾：

• 自動分析專案結構和進度
• 找出「做到一半」的任務
• 建議具體的下一步

---

🚀 開始使用（超簡單）

一行指令啟動

uvx adhd-copilot

就這樣。

• ✅ 不用 clone 專案
• ✅ 不用安裝 Python
• ✅ 不用設定虛擬環境
• ✅ 不用擔心依賴衝突

執行後會自動：

1. 下載並安裝所有需要的套件
2. 啟動本地服務
3. 開啟瀏覽器到 http://localhost:3001

還沒安裝 uv？
macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
或用 Homebrew: brew install uv
或用 pip: pip install uv

首次使用設定（2 分鐘）

1. 選擇能量狀態
   啟動後會看到兩個大按鈕：

   • 🔋 電力充足 - 我可以處理複雜問題
   • 🪫 低耗電模式 - 我只想做簡單的事

2. 設定 API Key（免費）

   • 點擊右上角 ⚙️ 設定圖示
   • 前往 Google AI Studio 取得免費 API Key
   • 貼上 API Key（格式：AIzaSy...）
   • 設定專案主目錄（例如：/Users/你的名字/Documents/projects）
   • 點擊「儲存」

3. 開始對話
   直接輸入你的想法，按 Enter 送出（Shift+Enter 換行）

使用範例

當你電力充足時 🔋

你：我想寫一篇關於 ADHD 的文章，但思緒很亂

AI：很好的主題！讓我們一起整理：
    1. 你想傳達的核心訊息是什麼？
    2. 目標讀者是誰？
    3. 你希望讀者看完後有什麼感受？
    
    我會幫你建立大綱，把想法組織成清晰的結構。

當你累了的時候 🪫

你：我卡住了，不知道該做什麼

AI：沒問題，那我們就輕鬆點。這裡有幾個不用動腦的小任務：
    □ 整理一下桌面檔案（5 分鐘）
    □ 把筆記裡的待辦事項複製到清單
    □ 讀這篇文章的前 3 段
    
    做完任何一個都很棒！不用全部做完。

專案掃描功能 📁

點擊右上角 📁 圖示，選擇你的專案資料夾：

AI：我看了一下你的專案資料夾：
    
    - React 教學網站：80% 完成，只差部署
    - 個人部落格：有 12 篇草稿，但都沒發布
    - Python 爬蟲：剛開始，還在研究階段
    
    建議：先把 React 網站部署完，給自己一個「完成」的成就感。

停止服務

在終端機按 Ctrl+C 即可停止。

下次使用

直接執行 uvx adhd-copilot 就會啟動（更快，因為已經下載過了）。

---

💡 實際使用場景

「我想做，但不知道怎麼開始」

你：我想寫一篇關於 ADHD 的文章，但思緒很亂
AI：很好的主題！讓我們一起整理：
    1. 你想傳達的核心訊息是什麼？
    2. 目標讀者是誰？
    3. 你希望讀者看完後有什麼感受？
    
    我會幫你建立大綱，把想法組織成清晰的結構。

「我累了，什麼都不想做」

你：我卡住了，不知道該做什麼
AI：沒問題，那我們就輕鬆點。這裡有幾個不用動腦的小任務：
    □ 整理一下桌面檔案（5 分鐘）
    □ 把筆記裡的待辦事項複製到清單
    □ 讀這篇文章的前 3 段
    
    做完任何一個都很棒！不用全部做完。

「專案太多，不知道先做哪個」

你：[點擊「掃描專案」]
AI：我看了一下你的專案資料夾：
    
    - **React 教學網站**：80% 完成，只差部署
    - **個人部落格**：有 12 篇草稿，但都沒發布
    - **Python 爬蟲**：剛開始，還在研究階段
    
    建議：先把 React 網站部署完，給自己一個「完成」的成就感。
    部落格可以挑一篇最接近完成的，花 30 分鐘潤飾後發布。

---

🎨 為什麼設計成這樣？

ADHD 友善設計原則

• 視覺清晰：大字體、高對比、充足留白（減少視覺過載）
• 減少選擇：每次最多 2-3 個選項（降低決策疲勞）
• 即時回饋：每個操作都有明確反應（滿足多巴胺需求）
• 能量感知：根據狀態調整互動方式（尊重你的真實狀態）
• 溫和鼓勵：認可進展，避免批判（對抗 RSD 拒絕敏感）

---

🤝 這個專案是為你而做的

如果你：

• 覺得自己「應該」可以做得更好
• 常常在「我很棒」和「我很廢」之間擺盪
• 成功了也覺得是僥倖，失敗了就覺得是本質
• 羨慕那些「就是做得到」的人

你不孤單。你值得擁有適合你的工具。

這個專案還在早期階段，但它是用同理心打造的。因為我懂那種「知道該做什麼，但就是做不到」的感覺。

---

📄 授權與貢獻

MIT License - 自由使用、修改、分享

歡迎所有形式的貢獻：Bug 回報、功能建議、文件改進、UI 優化。

---

記住：你的 ADHD 不定義你的成功，你的成功也不否定你的 ADHD。

這個工具是為了讓你的旅程輕鬆一點。就這樣。 💙

🔮 未來規劃

• VS Code 擴充套件整合
• 任務完成慶祝動畫
• 番茄鐘計時器（ADHD 優化版）
• 離線模式支援
• 自定義能量狀態

🏗️ 技術細節（給開發者）

• 框架：Reflex (Python 全棧)
• AI：Google Gemini 2.5 Flash
• 設計：Zen 風格系統（柔和色調、大間距、圓角）

💬 問題回報

• GitHub Issues
• GitHub Discussions

---

"I prefer to distinguish ADD as attention abundance disorder. Everything is just so interesting... remarkably at the same time." - Frank Coppola, ADHD Coach