Metadata-Version: 2.4
Name: invest-buddy-pet
Version: 0.2.0
Summary: 投资陪伴式人格测试 — 通过测试认识自己，用宠物陪伴成长，大师指引方向
Project-URL: Homepage, https://github.com/lj22503/invest-buddy-pet
Author: 燃冰
License: MIT
Keywords: ai-pet,companion,investment,personality-test
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Financial and Insurance Industry
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: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: >=3.10
Requires-Dist: openai>=2.0.0
Requires-Dist: requests>=2.32.0
Provides-Extra: data
Requires-Dist: akshare>=1.12.0; extra == 'data'
Requires-Dist: tushare>=1.4.0; extra == 'data'
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# 🤖 Invest Buddy Pet

投资陪伴式人格测试 — 通过测试认识自己，用宠物陪伴成长，大师指引方向。

## 30 秒上手

```bash
git clone <repo> && cd investbuddy
python run.py demo
```

看到完整 6 步 Demo 就跑通了。

## 5 分钟验证

```bash
# 1. 跑测试（应显示 55 passed）
cd quiz && python -m pytest -p no:superclaude

# 2. 用户入职（生成守护兽 + 初始任务）
cd .. && python run.py onboard user_001

# 3. 每日检查
python run.py daily user_001

# 4. 进化报告
python run.py report user_001 monthly
```

## 命令清单

| 命令 | 作用 |
|------|------|
| `python run.py` | 交互式菜单 |
| `python run.py demo` | 完整 Demo |
| `python run.py onboard <id>` | 用户入职 |
| `python run.py daily <id>` | 每日检查 |
| `python run.py report <id> [period]` | 进化报告（period: daily/weekly/monthly） |

## 项目结构

```
investbuddy/
├── run.py                     ← 入口
├── README.md                  ← 本文件
├── PLAN.md                    ← 实现计划 + 待优化清单
├── quiz/                      ← 核心代码
│   ├── invest_buddy_pet.py    ← 主 Skill（5 个核心流程）
│   ├── models.py              ← 12 种守护兽 + 数据模型
│   ├── database.py            ← SQLite 持久化
│   ├── task_generator.py      ← 任务生成
│   ├── evolution_tracker.py   ← 进化追踪
│   ├── knowledge_base.py      ← 知识库（29 知识点）
│   ├── companion_strategy.py  ← 陪伴话术策略（策略模式）
│   ├── llm_client.py          ← DeepSeek 调用封装
│   ├── skill_registry.py      ← 6 个子 Skill 注册 + 重试降级
│   └── test_*.py              ← 55 个测试
└── .env.example               ← 环境变量模板
```

## 12 种守护兽

| 类型 | 名称 | 风格 |
|------|------|------|
| SRLC | 大象 | 价值守护者 |
| SRCD | 乌龟 | 长期主义者 |
| SRTC | 驯鹿 | 红利收息者 |
| SRTD | 松鼠 | 定投践行者 |
| GRLC | 狼 | 成长猎手 |
| GRCD | 狐狸 | 量化交易员 |
| GRTC | 豹 | 趋势跟踪者 |
| GRTD | 猫鼬 | 波段交易者 |
| GILC | 熊 | 左侧布局者 |
| GICD | 猫头鹰 | 宏观对冲者 |
| GITC | 乌鸦 | 主题投机者 |
| GITD | 变色龙 | 动量交易者 |

## 配置（可选）

如果要启用真实 LLM 署名生成：

```bash
cp .env.example .env
# 编辑 .env，填入 DEEPSEEK_API_KEY
export DEEPSEEK_API_KEY=<your_key>
```

未配置时也能跑，只是署名字段会标记 `source=no_signature`。

## 依赖

```bash
pip install openai  # DeepSeek 兼容 OpenAI SDK
```

## 状态

**版本**: v0.2.0
**阶段**: MVP 实现中
**测试**: 55/55 passed