17 lines
978 B
Markdown
17 lines
978 B
Markdown
---
|
||
inclusion: always
|
||
---
|
||
|
||
# 输出路径规范（强制）
|
||
|
||
## 核心原则
|
||
所有文件输出必须写入 `export/` 统一目录结构，通过 `.env` 环境变量控制路径。禁止在 `export/` 体系外自行创建输出目录。
|
||
|
||
## 编码规则
|
||
1. 路径必须从 `.env` 读取，禁止硬编码任何目录结构（含绝对路径和相对路径）
|
||
2. 环境变量缺失时必须报错（`KeyError` / `RuntimeError`），禁止静默回退
|
||
3. 路径读取方式：`scripts/ops/` 用 `_env_paths.get_output_path()`；ETL 核心用 `AppConfig.io.*`；独立脚本用 `os.environ.get()` + 显式报错
|
||
4. 新增输出类型：先在根 `.env` + `.env.template` 新增变量，再在代码中引用，同步更新 `docs/deployment/EXPORT-PATHS.md`
|
||
|
||
> 完整目录结构、环境变量映射表、新增场景检查清单见 `export-paths-full.md`（fileMatch：读到 `.env*` / `scripts/` / `export/` 文件时自动加载，也可 `#export-paths-full` 手动加载）。
|