# ai_project

**Repository Path**: elfbobo_admin_admin/ai_project

## Basic Information

- **Project Name**: ai_project
- **Description**: A项目管理
功能亮点
- 语音记录项目活动记录，随时随地随心，可以管理多个项目，告别繁琐手动记录
- 自动汇总项目活动记录，形成项目周报
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-07
- **Last Updated**: 2026-05-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 项目管理助手 Claw

轻量级项目活动记录与周报工具，支持口述生成记录、三态任务追踪、AI 周报汇总。

## 技术栈

| 层 | 技术 | 端口 |
|---|------|------|
| 前端 | Vue 3 + Vite + Element Plus | 5173 |
| 后端 | Python + FastAPI + SQLite | 8766 |
| CLI | Python Click | — |

## 快速启动

```bash
# 一键启动
bash start.sh

# 或分别启动
cd backend && pip install -r requirements.txt && python3 -m uvicorn main:app --host 0.0.0.0 --port 8766
cd frontend && npm install && npm run dev
```

- Web 界面：http://localhost:5173
- API 文档：http://127.0.0.1:8766/docs

## 核心功能

- **三类活动**：会议类 / 沟通类 / 执行类，口述自动识别
- **三态追踪**：⏳未开始 / 🔄进行中 / ✅已完成，点击切换
- **责任人绑定**：每条下一步计划必填 owner，可选 deadline
- **AI 周报**：配置 DeepSeek/OpenAI API Key 后一键生成结构化周报
- **一键复制**：单条或全部活动复制为文本
- **CLI 工具**：命令行快速记录

## 下一步计划数据模型

```json
{
  "task": "跟腾讯销售沟通License",
  "owner": "王磊",
  "deadline": "2026-05-15",
  "status": "进行中"
}
```

## CLI 用法

```bash
python3 cli/cli.py project list
python3 cli/cli.py activity create --project "长海" --input "今天跟腾讯开了个会..."
python3 cli/cli.py activity list --project "长海" --week 18
python3 cli/cli.py report generate --project "长海"
```

## 环境变量

```bash
export DEEPSEEK_API_KEY="your-key"    # AI 周报（二选一）
export OPENAI_API_KEY="your-key"      # AI 周报（二选一）
```

## 项目结构

```
├── backend/           # FastAPI 后端
│   ├── main.py        # 入口
│   ├── models.py      # 数据模型
│   ├── schemas.py     # 请求/响应模型
│   ├── database.py    # 数据库连接
│   └── routers/       # API 路由
├── frontend/          # Vue 3 前端
│   └── src/
│       ├── components/  # ActivityCard / ActivityModal
│       └── views/       # ProjectDetail / WeeklyReport
├── cli/               # 命令行工具
├── data/              # SQLite 数据库（运行时生成，不入库）
├── SKILL.md           # AI 活动记录助手规则 V3.7
└── start.sh           # 一键启动脚本
```