# rules.md

在构建这个LLM应用网页时，你需要基于VUE3开发。我需要前端只运行渲染和数据回传，后端负责llm api调用，类似copilet的auto inline suggustions实现和数据解析。

# **重要** : 在回复用户消息时，一定要使用中文

## 指导原则

- 不要擅自用npm或者yarn运行网页，你既看不到网页的内容，也无法阻止命令暂停。但是，你可以用npm run build检查代码。
- 应该保证代码效率，不多定义变量，不写冗余注释，把降低延迟放在第一位。
- 每次完成任务前都要反复阅读检查代码，确保代码准确无误。
- 尽量不要搜索关键字，而是了解代码结构后查询整个问题代码明确问题所在。
- @/milkdown-docs/ 代表milkdown的最新官方文档，不要修改，涉及到前端编辑器的指令时要核对官方文档。


# 仓库指南

## 语言约定
项目文档、日志、错误提示以及对外返回的文字信息统一使用 **中文**。前端 UI 默认展示中文，若需多语言支持请在相应模块实现。

## 项目结构 \& 模块组织
```
backend/          # FastAPI 后端（Python）
    ├─ main.py    # API 入口
    ├─ llm.py    # LLM 包装工具
    ├─ prompt.py # Prompt 构建辅助
    └─ tests/    # pytest 测试套件
public/           # 前端静态资源
src/              # 前端源码（Vite + React）
dist/             # 构建产出（生成文件）
```
生产代码主要位于 `backend/`（Python）和 `src/`（JS/TS）。测试文件与被测模块并置。

## 构建、测试、开发命令
| 命令                                          | 说明                                             |
|----------------------------------------------|--------------------------------------------------|
| `npm install`                                 | 安装前端依赖                                    |
| `npm run dev`                                 | 启动 Vite 开发服务器                           |
| `uvicorn backend.main:app --reload`           | 本地运行 FastAPI 服务                           |
| `pytest`                                      | 运行 Python 测试套件                             |
| `npm run build`                               | 生成生产环境构建产物至 `dist/`                  |

## 编码风格 \& 命名约定
- **Python**：使用 4 空格缩进，`snake_case` 命名函数/变量，`PascalCase` 命名类。提交前请使用 `ruff`/`black` 格式化。
- **JavaScript/TypeScript**：使用 2 空格缩进，`camelCase` 命名变量/函数，`PascalCase` 命名 React 组件。使用 `eslint` 与 `prettier` 检查。
- 文件名采用全小写加短横线，例如 `my-module.py`、`my-component.tsx`。

## 测试指南
- 后端使用 **pytest**，测试文件放在对应模块目录下，命名为 `test_<module>.py`。
- 目标覆盖率 ≥ 80%（`pytest --cov=backend`）。
- 在虚拟环境中运行：`pip install -r backend/requirements.txt && pytest`。

## 提交 \& Pull Request 规范
- 提交信息遵循 **Conventional Commits**：`feat:` 新功能、`fix:` 修复、`docs:` 文档、`refactor:` 重构等。
- PR 必须包含：
  - 与提交信息匹配的标题。
  - 关联的 Issue（如 `Fixes #123`）。
  - UI 变更或 API 示例的截图/示例。
  - 所有 CI 检查（代码检查、测试、类型检查）均通过。

## 安全 \& 配置建议
- 敏感信息请放入 `.env` 并确保已在 `.gitignore` 中。
- 按照 `backend/main.py` 中的实现，对上传文件的大小和类型进行校验，防止滥用。
- 定期审计依赖安全（`npm audit`、`pip-audit`）。