Metadata-Version: 2.4
Name: adhd-copilot
Version: 0.1.0
Summary: 為高功能 ADHD 工作者設計的全方位智能助手
Author-email: Your Name <your.email@example.com>
License: MIT
Project-URL: Homepage, https://github.com/richblack/ADHD-copilot
Project-URL: Repository, https://github.com/richblack/ADHD-copilot
Project-URL: Issues, https://github.com/richblack/ADHD-copilot/issues
Keywords: adhd,productivity,ai,copilot,assistant
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: reflex>=0.8.20
Requires-Dist: google-generativeai>=0.8.0
Dynamic: license-file

# ADHD Copilot 🧠✨

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

## 你是不是也有這些經驗？

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

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

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

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

---

## 🎯 高功能 ADHD 的真實困境

### 「你看起來很好啊」

這是最傷人的一句話。

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

但沒人看到：

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

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

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

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

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

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

---

## ✨ ADHD Copilot 能為你做什麼？

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

### 🔋 能量感知模式

#### 高能量模式（電力充足）
當你狀態好的時候，我們不浪費這個黃金時段：
- **主動規劃**：幫你補齊那些「之後再說」的細節
- **深度工作**：一起處理複雜的決策和架構設計
- **專案掃描**：分析你的專案，找出下一步該做什麼
- **積極對話**：問你問題，幫你把模糊的想法變成具體的計畫

#### 低能量模式（低耗電）
當你累了，我們就輕鬆點：
- **微任務分解**：把大任務拆成「不用動腦」的小步驟
- **溫和引導**：不問複雜問題，不增加決策負擔
- **簡單選擇**：給你 2-3 個明確的選項，挑一個就好
- **鼓勵為主**：認可你的小進展，不批判、不施壓

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

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

### 📁 智能專案掃描

不用手動整理，直接掃描你的專案資料夾：
- 自動分析專案結構和進度
- 找出「做到一半」的任務
- 建議具體的下一步

---

## 🚀 開始使用（超簡單）

### 一行指令安裝

```bash
uvx adhd-copilot
```

就這樣。不用 clone、不用設定環境、不用擔心依賴。

> 還沒安裝 `uv`？執行：`pip install uv` 或 `brew install uv`  
> 詳細安裝說明請看 [INSTALL.md](INSTALL.md)

### 首次使用

1. 開啟瀏覽器 → `http://localhost:3001`
2. 選擇你現在的能量狀態
3. 設定 [Gemini API Key](https://makersuite.google.com/app/apikey)（免費）
4. 開始對話

---

## 💡 實際使用場景

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

```
你：我想寫一篇關於 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](https://github.com/richblack/ADHD-copilot/issues)
- [GitHub Discussions](https://github.com/richblack/ADHD-copilot/discussions)

---

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