Files
AI_spine/AGENTS.md
T
2026-09-17 18:50:43 +08:00

1.3 KiB

项目修改约定

本文件适用于 AI_spine/ 及其所有子目录。每次修改代码、文档、依赖或运行测试前,都必须阅读并遵守。

Python 环境

  • 本项目固定使用名为 ai-spine 的 Conda 环境。
  • 不创建、不使用 .venv、venv 或其他 Python 虚拟环境;不把依赖安装到 Conda base 或系统 Python。
  • 交互式终端先执行 conda activate ai-spine;自动化命令使用 conda run -n ai-spine ...。
  • Python 依赖统一记录在 requirements.txt。安装命令使用 conda run -n ai-spine python -m pip install -r requirements.txt,避免裸 pip 指向错误环境。
  • Node 管线调用 Python 时也必须使用此 Conda 环境。--python 只能指向 ai-spine 环境中的解释器。
  • 不在代码中硬编码本机 Conda 安装路径,不自动创建环境或自动安装依赖。缺少环境或依赖时给出明确的安装/激活命令。

修改与验证

  • 修改环境选择、依赖或启动方式时,同步更新 README、相关文档和 CLI 帮助,保持一致。
  • 测试在 ai-spine 环境下执行:conda run -n ai-spine npm test。不要为了绕过依赖问题临时新建环境。
  • 验证结果必须如实记录;缺少依赖导致未运行的检查,不得声称通过。
  • 保留用户已有修改和实验产物,不覆盖旧实验输出。