---
description: 项目通用约定（中文回复、conda 环境）
alwaysApply: true
---

# 项目约定

## 语言

- 与用户的所有对话、说明、总结、PR/提交说明草稿均使用**简体中文**。
- 代码标识符、路径、命令、日志原文可保持英文；技术术语首次出现时可附简短中文说明。

## Python / Shell 环境

本项目使用 Conda 环境 **`mineru`**。执行 Python、pip、pytest 或依赖项目依赖的命令前，必须先激活该环境。

### 交互式终端

```bash
conda activate mineru
```

### 非交互式命令（推荐，避免 activate 未生效）

```bash
conda run -n mineru python ...
conda run -n mineru pip ...
conda run -n mineru pytest ...
```

### 要求

- 不要假设系统默认 `python3` 已安装项目依赖（如 `bs4`、`torch` 等）。
- 若命令失败且提示缺少模块，先确认是否在 `mineru` 环境中再排查代码问题。
- 新建脚本或文档中的示例命令，应体现 `conda activate mineru` 或 `conda run -n mineru`。