# ai-worklog

**Repository Path**: ISPWD/ai-worklog

## Basic Information

- **Project Name**: ai-worklog
- **Description**: 简化每日工作记录，根据零星的工作内容记录创建日报。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-29
- **Last Updated**: 2026-03-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 个人工作日志总结工具

一个基于Python FastAPI + Vue3的个人工作日志记录和AI总结工具，支持火山引擎AI生成不同视角的工作总结。

## 功能特性

- ✅ **随时录入**：随时录入当日零星工作内容，自动按序号保存
- ✅ **AI总结**：支持两种视角生成总结
  - **个人视角**：详细整理，适合个人复盘，包含思考和收获
  - **领导视角**：简洁专业，突出成果，重点体现解决了什么问题、创造了什么价值，适合向上汇报
- ✅ **智能提示**：保存时AI自动分析内容，提示用户补充缺失细节
- ✅ **内容质量检查**：内容过于空洞时拒绝生成低质量总结，引导用户补充
- ✅ **编辑清空**：支持编辑和清空已录入内容
- ✅ **按日期组织**：自动按 `年/月/日` 目录结构存储，分类清晰
  - `originals/` - 原始录入内容（当日所有录入保存在一个markdown文件）
  - `organized/` - AI整理后的内容
  - `summaries/` - 不同视角的总结
- ✅ **本地存储**：所有内容以markdown格式保存在本地，方便查看和管理
- ✅ **美观界面**：基于Vue3 + Element Plus的现代化Web界面

## 项目结构

```
.
├── backend/                # Python FastAPI后端
│   ├── ai_service.py       # AI服务，火山引擎调用
│   ├── storage.py          # 文件存储服务
│   ├── main.py             # FastAPI应用入口
│   └── requirements.txt   # Python依赖
├── frontend/               # Vue3前端
│   ├── src/
│   │   ├── api/            # API调用
│   │   ├── App.vue         # 主应用
│   │   └── ...
│   └── package.json
├── data/                   # 数据存储目录（自动创建）
├── config.toml             # 配置文件
└── README.md
```

## 环境要求

- Python 3.10+
- Node.js 18+
- 火山引擎API密钥（已配置endpoint和模型）

## 快速开始

### 1. 配置API密钥

编辑 `config.toml`，填写你的火山引擎API密钥：

```toml
[storage]
root_path = "./data"

[server]
port = 8000
host = "0.0.0.0"

[ai]
api_key = "你的火山引擎API密钥"
model_name = "ark-code-latest"
endpoint = "https://ark.cn-beijing.volces.com/api/coding/v3"
```

程序会自动拼接完整路径为 `https://ark.cn-beijing.volces.com/api/coding/v3/chat/completions`

### 2. 启动后端

```bash
cd backend
pip install -r requirements.txt
python main.py
```

后端服务将在 `http://localhost:8000` 启动

### 3. 启动前端（开发模式）

打开新终端：

```bash
cd frontend
npm install
npm run dev
```

前端开发服务器将在 `http://localhost:5173` 启动，访问该地址即可使用。

### 4. 构建生产版本

```bash
cd frontend
npm run build
```

构建产物在 `dist` 目录，可以直接部署到静态文件服务器。

## 使用说明

### 录入工作

1. 在左侧输入框输入今日工作内容
2. 点击"保存记录"
3. 如果内容不够详细，AI会提示你补充哪些细节
4. 内容自动按序号保存在当日原始记录中

### 生成总结

- **生成个人总结**：生成适合个人复盘的详细总结
- **生成领导总结**：生成适合向上汇报的简洁总结，突出问题解决和业务价值

### 编辑和清空

- **编辑**：点击"编辑"按钮可以直接修改原始内容，保存后覆盖原文件
- **清空**：点击"清空"按钮，确认后清空当日所有原始记录和总结

### 查看历史

- 左侧侧边栏显示所有有记录的日期
- 点击日期可以切换查看该日期的内容和总结

## 文件存储示例

```
data/
└── 2026/
    └── 03/
        └── 29/
            ├── originals/
            │   └── 20260329_original.md
            │   内容示例：
            │   1. 完成了项目初始化和目录结构创建
            │
            │   ---
            │
            │   2. 实现了文件存储服务和API接口
            ├── organized/
            │   └── 20260329_organized.md
            └── summaries/
                ├── personal.md
                └── leader.md
```

## 技术栈

- **后端**：Python FastAPI + uvicorn
- **前端**：Vue3 + TypeScript + Element Plus + Vite
- **AI**：火山引擎方舟平台（兼容OpenAI接口格式）
- **配置**：toml
- **存储**：本地markdown文件按日期目录组织

## 故障排查

### 404 Not Found

- 检查 `config.toml` 中的 `endpoint` 配置，程序会自动拼接 `/chat/completions`
- 正确配置：`endpoint = "https://ark.cn-beijing.volces.com/api/coding/v3"`

### AuthenticationError

- 检查API密钥是否正确填写在 `config.toml` 中
- 确认API密钥是否有效且有对应模型权限

### AI总结提示内容空洞

- 这是正常的质量检查机制，请补充更详细的工作内容后再试
- 需要描述清楚：完成了什么工作、解决了什么问题、取得了什么成果

## 许可证

MIT