交付规范 (Delivery Standards)
文件格式
- 首选: Markdown (
.md) —— 兼顾人类阅读与 AI 理解。 - 慎用: YAML/JSON —— 仅用于机器接口配置。
安全规范
- 安全删除: 必须使用
send2trash,严禁del/rm。 - 文本追加: 严禁 Shell 的
>>重定向,必须用 Python 脚本或Write工具。 - 命令连接: PowerShell 5 不支持
&&,使用;分隔或拆分调用。 - 路径校验: 文件路径引用(尤其硬编码路径)需定期校验有效性,迁移文件后必须同步更新所有引用。
- 目录命名: 项目目录一律使用小写,避免 Windows/Git 大小写歧义问题(如
Memory/→memory/)。
.bat 脚本规范
chcp 65001
set PYTHONPATH=%~dp0
.venv\Scripts\python.exe script.py