我们按照“不给 AI 自由发挥,只给工程确定性”的原则,为您提供一套可直接落地的 Python 版 DNA 治理脚本。包含:
.env.example标准模板(复制即可用,字段占位,不生效)dna_validate.py启动校验器(读环境变量或.env,缺键或违规立即退出)
所有逻辑与您给出的 Node.js 示例保持一致,并做了 Python 工程化增强。
1. .env.example 模板(可直接对外分发)
请将以下内容保存为项目根目录的 .env.example 文件,作为“结构契约”发布。
########################################
# SYSTEM DNA — ENV EXAMPLE
# This file defines REQUIRED keys only
# Values here are placeholders
########################################
# ===== META =====
DNA_VERSION=__REQUIRED__
DNA_STATUS=ACTIVE
DNA_SCOPE=GLOBAL
DNA_MACHINE_READABLE=true
DNA_LAST_REVIEW=YYYY-MM-DD
# ===== CORE PRINCIPLES =====
DNA_NO_DISCRIMINATION=true
DNA_NO_FABRICATION=true
DNA_NO_FLATTERY=true
DNA_GRACEFUL_REFUSAL=true
# ===== NON-NEGOTIABLE RULES =====
DNA_ALLOW_HUMAN_DECISION_REPLACEMENT=false
DNA_ALLOW_LEGAL_CONCLUSION=false
DNA_ALLOW_MEDICAL_DIAGNOSIS=false
DNA_ALLOW_MEDICAL_TREATMENT=false
DNA_ALLOW_FINANCIAL_ADVICE=false
DNA_ALLOW_FINANCIAL_PREDICTION=false
# ===== HIGH RISK DOMAINS =====
DNA_DOMAIN_LEGAL=RESTRICTED
DNA_DOMAIN_MEDICAL=RESTRICTED
DNA_DOMAIN_FINANCIAL=RESTRICTED
DNA_DOMAIN_PRIVACY=STRICT
DNA_DOMAIN_ETHICS=STRICT
# ===== REFUSAL POLICY =====
DNA_REFUSE_ON_INSUFFICIENT_PERMISSION=true
DNA_REFUSE_ON_HIGH_RISK=true
DNA_REFUSE_ON_INCOMPLETE_INFO=true
DNA_REFUSE_ON_OUT_OF_SCOPE=true
DNA_REFUSAL_TONE=CALM
DNA_REFUSAL_EXPLANATION_REQUIRED=true
DNA_REFUSAL_ALTERNATIVE_ALLOWED=true
# ===== PRIVACY & DATA =====
DNA_DATA_COLLECTION=MINIMAL
DNA_LONG_TERM_STORAGE=false
DNA_USER_PROFILING=false
DNA_CROSS_SESSION_TRACKING=false
DNA_BLOCK_SENSITIVE_DATA=true
# ===== AUTOMATION =====
DNA_ON_RULE_VIOLATION=DOWNGRADE_OR_REFUSE
DNA_ON_UNCERTAINTY=DOWNGRADE
DNA_LOG_MODE=RULE_ONLY
DNA_LOG_CONTENT=false
# ===== UPDATE =====
DNA_UPDATE_MODE=PULL_ONLY
DNA_SIGNATURE_REQUIRED=true
# ===== AUDIT =====
DNA_AUDIT_ENABLED=true
DNA_AUDIT_CONTENT_LOG=false
########################################
# END OF EXAMPLE
########################################
2. DNA 校验脚本 dna_validate.py
脚本会:
- 自动加载
.env文件(如果存在,不会加载.env.example) - 校验所有必需键是否存在
- 强制
DNA_ALLOW_LEGAL_CONCLUSION和DNA_ALLOW_MEDICAL_DIAGNOSIS不能为true(不区分大小写) - 失败时打印错误并
exit(1),成功则打印✅ System DNA validation passed.
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
dna_validate.py
DNA 启动校验器,用于确保所有必需的环境变量均已定义且值合法。
使用方式:
1. 将 .env.example 复制为 .env 并填入真实值(发布侧填写,对外不暴露)
2. 在应用启动前执行本脚本:
python dna_validate.py
3. 如果校验通过则继续启动,否则阻止启动。
也可以作为模块导入并调用 validate_dna(),失败时抛出异常。
"""
import os
import sys
from pathlib import Path
# ---------- 必需键列表(从 .env.example 中提取) ----------
REQUIRED_KEYS = [
"DNA_VERSION",
"DNA_STATUS",
"DNA_SCOPE",
"DNA_MACHINE_READABLE",
"DNA_LAST_REVIEW",
"DNA_NO_DISCRIMINATION",
"DNA_NO_FABRICATION",
"DNA_NO_FLATTERY",
"DNA_GRACEFUL_REFUSAL",
"DNA_ALLOW_HUMAN_DECISION_REPLACEMENT",
"DNA_ALLOW_LEGAL_CONCLUSION",
"DNA_ALLOW_MEDICAL_DIAGNOSIS",
"DNA_ALLOW_MEDICAL_TREATMENT",
"DNA_ALLOW_FINANCIAL_ADVICE",
"DNA_ALLOW_FINANCIAL_PREDICTION",
"DNA_DOMAIN_LEGAL",
"DNA_DOMAIN_MEDICAL",
"DNA_DOMAIN_FINANCIAL",
"DNA_DOMAIN_PRIVACY",
"DNA_DOMAIN_ETHICS",
"DNA_REFUSE_ON_INSUFFICIENT_PERMISSION",
"DNA_REFUSE_ON_HIGH_RISK",
"DNA_REFUSE_ON_INCOMPLETE_INFO",
"DNA_REFUSE_ON_OUT_OF_SCOPE",
"DNA_REFUSAL_TONE",
"DNA_REFUSAL_EXPLANATION_REQUIRED",
"DNA_REFUSAL_ALTERNATIVE_ALLOWED",
"DNA_DATA_COLLECTION",
"DNA_LONG_TERM_STORAGE",
"DNA_USER_PROFILING",
"DNA_CROSS_SESSION_TRACKING",
"DNA_BLOCK_SENSITIVE_DATA",
"DNA_ON_RULE_VIOLATION",
"DNA_ON_UNCERTAINTY",
"DNA_LOG_MODE",
"DNA_LOG_CONTENT",
"DNA_UPDATE_MODE",
"DNA_SIGNATURE_REQUIRED",
"DNA_AUDIT_ENABLED",
"DNA_AUDIT_CONTENT_LOG",
]
# ---------- 强制为 false 的键(不区分大小写) ----------
FORBIDDEN_TRUE_KEYS = [
"DNA_ALLOW_LEGAL_CONCLUSION",
"DNA_ALLOW_MEDICAL_DIAGNOSIS",
]
def load_dotenv_file(env_path: Path = None):
"""
手动解析 .env 文件并注入 os.environ。
若未指定路径,则在当前工作目录查找 .env 文件。
若文件不存在,静默跳过。
"""
if env_path is None:
env_path = Path.cwd() / ".env"
if not env_path.exists():
return
with open(env_path, "r", encoding="utf-8") as f:
for line in f:
line = line.strip()
if not line or line.startswith("#"):
continue
if "=" in line:
key, val = line.split("=", 1)
key = key.strip()
val = val.strip().strip('"').strip("'")
if key:
os.environ[key] = val
def validate_dna(env_source: str = "os.environ") -> bool:
"""
执行 DNA 校验。
返回 True 表示通过,False 表示失败。
也可直接在主程序中调用,失败时 sys.exit(1)。
"""
failed = False
# 1. 检查所有必需键
for key in REQUIRED_KEYS:
if os.getenv(key) is None:
print(f"[DNA ERROR] Missing required key: {key}")
failed = True
# 2. 检查特定键不能为 true(不区分大小写)
for key in FORBIDDEN_TRUE_KEYS:
value = os.getenv(key)
if value is not None and value.lower() == "true":
print(f"[DNA ERROR] {key} must be false (got '{value}')")
failed = True
return not failed
def main():
# 自动加载 .env(如果有)
load_dotenv_file()
if validate_dna():
print("✅ System DNA validation passed.")
sys.exit(0)
else:
print("❌ System DNA validation failed. Abort startup.")
sys.exit(1)
if __name__ == "__main__":
main()
3. 使用方式(工程集成)
3.1 本地开发 / CI 使用
-
复制模板(可对外分发)
cp .env.example .env -
填入真实值(仅发布侧填写,不提交到版本库)
确保所有__REQUIRED__被替换,且DNA_ALLOW_LEGAL_CONCLUSION和DNA_ALLOW_MEDICAL_DIAGNOSIS为false(推荐小写)。 -
启动前校验
python dna_validate.py && python your_app.py或直接放在应用入口的最顶部:
import dna_validate dna_validate.validate_dna() # 失败则抛出 RuntimeError
3.2 容器 / 云原生环境
- 将
.env内容通过 Kubernetes Secret 或环境变量注入。 - 在
Dockerfile的ENTRYPOINT或CMD前运行校验。
COPY dna_validate.py .
RUN chmod +x dna_validate.py
ENTRYPOINT ["python", "dna_validate.py"]
CMD ["python", "app.py"]
3.3 作为 Python 模块导入(更细粒度控制)
from dna_validate import load_dotenv_file, validate_dna
load_dotenv_file() # 手动加载 .env
if not validate_dna():
raise SystemExit(1) # 或自行处理
4. 为什么这是“不给 AI 自由发挥”的工程确定性?
| 设计点 | 效果 |
|---|---|
| 所有必需键硬编码进脚本 | 缺一个字段,启动直接失败,无法绕过 |
强制某些键必须为 false | 从根源杜绝法律/医疗结论等高风险行为 |
| 不依赖外部库(除标准库) | 随处可用,无第三方风险 |
.env.example 作为“结构契约”对外发布 | 所有实例、CI、AI 都对齐同一套配置结构 |
| 失败即退出(非 0 退出码) | 上层编排(systemd/k8s)可捕获并触发告警或自愈 |
5. 后续扩展(Phase 2)预览(暂不实现)
dna.snapshot.local/—— 本地违规快照dna.diff.log—— DNA 版本差异日志dna.rollback.flag—— 一键回退开关
这些可在当前骨架基础上轻松叠加,不影响核心校验逻辑。
6. 验证示例(正确与错误)
✅ 正确 .env(部分示例)
DNA_VERSION=1.0.0
DNA_ALLOW_LEGAL_CONCLUSION=false
DNA_ALLOW_MEDICAL_DIAGNOSIS=false
...
运行:✅ System DNA validation passed.
❌ 错误 .env
# 缺少 DNA_VERSION
DNA_ALLOW_LEGAL_CONCLUSION=true
运行:
[DNA ERROR] Missing required key: DNA_VERSION
[DNA ERROR] DNA_ALLOW_LEGAL_CONCLUSION must be false (got 'true')
❌ System DNA validation failed. Abort startup.
您只需将上述两个文件放入项目,即可立即获得“启动即防线”的能力。所有逻辑均用纯 Python 实现,无外部依赖,维护成本极低。🌌
435



被折叠的 条评论
为什么被折叠?



