Skip to content

Latest commit

 

History

History
26 lines (20 loc) · 1.1 KB

File metadata and controls

26 lines (20 loc) · 1.1 KB

GEMINI规范

1 语言

  • 注释、提示信息、日志、报错一律中文。
  • README等任何形式的md文档,除非我额外要求,否贼也一律使用中文。
  • 代码字符串里不出现英文提示。
  • 永远使用中文与我交流

2 配置与日志

  • 整个项目只保留一套配置注入(config.env + set -a; source config.env; set +a)和一套日志系统。
  • 禁止每个脚本自己写一套 echo 或 log()。

3 脚本粒度

  • 能用 bash 单行解决就不写脚本;必须写时,一个脚本只干一件事。
  • 不出现“工具链”式层层包装或多个微脚本。

4 错误处理

  • 不捕获、不兜底、不静默重试。出错立即退出,返回非零,保留原始错误信息。
  • 禁用 || true、2>/dev/null、set +e 等掩盖错误的做法。

5 输出留痕

  • 默认把 stdout 和 stderr 重定向到 log/$(date +%Y%m%d-%H%M%S).log。
  • 屏幕仅输出必要日志(如 ERROR 级别简短提示)。

6 开发环境

  • 永远优先尝试使用venv/或者.venv/内的虚拟解释器,严禁在全局解释器下pip安装任何包