|
Download agy2api/AGENTS.md from a3216/ds2api: direct link, hf CLI and curl.
- Browser
- Download file 1.29 kB
-
https://huggingface.co/spaces/a3216/ds2api/resolve/main/agy2api/AGENTS.md
- Command line
-
hf download hf://spaces/a3216/ds2api/agy2api/AGENTS.md
-
curl -L -o AGENTS.md https://huggingface.co/spaces/a3216/ds2api/resolve/main/agy2api/AGENTS.md
1.29 kB
AGENTS.md
本仓库使用 uv 管理依赖(pyproject.toml / uv.lock)。
Python 环境(重要)
在执行任何 Python 相关命令(运行、测试、安装依赖等)时,请始终使用 backend 目录下的虚拟环境解释器:
.venv\Scripts\python.exe
例如:
# 运行后端
.venv\Scripts\python.exe web.py
# 安装依赖(优先使用 uv)
.venv\Scripts\python.exe -m pip install -r requirements.txt
# 查看已安装的包
.venv\Scripts\python.exe -m pip list
不要使用系统全局的 python / python3,也不要自行新建虚拟环境。
前端构建
前端位于 frontend/ 目录,使用 pnpm 作为包管理器:
cd frontend
pnpm install
pnpm build
不要使用 npm / yarn 或创建 package-lock.json / yarn.lock。
依赖导入规范
所有依赖导入(import / from ... import ...)必须统一放在文件顶部(module docstring、__future__ 导入和 __all__ 之后)。
唯一的例外:存在循环依赖时,可以在函数/方法内部延迟导入,并在导入语句旁注释说明原因,例如:
def some_func():
# 循环依赖,延迟导入
from src.auth import verify_token
除上述例外,禁止在函数内部、条件分支中随意散落导入语句。