1.3 KiB
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。不要为了绕过依赖问题临时新建环境。 - 验证结果必须如实记录;缺少依赖导致未运行的检查,不得声称通过。
- 保留用户已有修改和实验产物,不覆盖旧实验输出。