跳转至

交付规范 (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