FlexPlan — AI智能计划系统

AI帮你制定计划，更帮你实时调整计划。

安装

cd flexplan
pip install -e .

配置 API Key

FlexPlan 兼容所有 OpenAI 格式的 API（DeepSeek / 小米 / OpenAI）。

方式一：环境变量（推荐）

export FLEXPLAN_API_KEY=sk-xxxx
export FLEXPLAN_BASE_URL=https://api.deepseek.com/v1  # 可选，默认小米
export FLEXPLAN_MODEL=deepseek-chat                     # 可选

方式二：命令行

flexplan init yourname --api-key sk-xxxx

方式三：Windows 系统环境变量

系统设置 → 环境变量 → 添加 FLEXPLAN_API_KEY

使用

# 1. 初始化用户空间
flexplan init your name

# 2. 添加学习目标
flexplan goal add "your goal" -d 2026-12-20 -p high -s "task"

# 3. 查看目标列表
flexplan goal list

# 4. AI 生成学习计划
flexplan plan generate goal_29ffcd43

# 5. 查看今日计划
flexplan plan today

# 6. 查看本周计划
flexplan plan week

# 7. 完成/跳过任务
flexplan done task_xxxx
flexplan skip task_xxxx

# 8. 查看进度
flexplan progress

# 9. 删除目标
flexplan goal remove goal_xxxx

技术栈

• Python 3.12 + Typer CLI + Rich 终端美化
• Pydantic 数据模型
• httpx HTTP 客户端
• JSON 本地存储（data/{username}/）

项目结构

flexplan/
├── pyproject.toml           # 包配置
├── README.md                # 本文件
├── AI计划系统-企划书.md     # 项目企划书
├── src/flexplan/
│   ├── __init__.py          # 版本号
│   ├── cli.py               # CLI 入口（Typer + Rich）
│   ├── config.py            # 配置管理
│   ├── models.py            # Pydantic 数据模型
│   ├── storage.py           # JSON 文件存储层
│   ├── ai_client.py         # AI API 封装
│   ├── planner.py           # 计划生成引擎
│   └── tracker.py           # 执行追踪
└── data/
    └── {username}/          # 用户数据目录
        ├── goals.json
        ├── plans.json
        └── stats.json

版本

• v0.1.0 — Phase 1 MVP（本地 CLI 版）