Metadata-Version: 2.4
Name: adhd-copilot
Version: 0.2.11
Summary: 為高功能 ADHD 工作者設計的全方位智能助手
Author-email: Your Name <your.email@example.com>
License-Expression: 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: 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 專案
- ✅ 不用安裝 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](https://makersuite.google.com/app/apikey) 取得免費 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](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
