别等 AI 写了 200 行才发现跑偏——方向偏差的五个早期信号

# AI 写的第一个类名
class DistributedCacheClusterManager:
    def __init__(self, nodes: list, replication_factor: int = 3):
        ...

# 信号：类名里有 "Distributed"、"Cluster"、"Manager"、replication_factor
# 但你的需求里没有一个字提到"分布式"
# AI 过度推断了一个完全不存在的复杂度层级

# 你说的是                        AI 写的是
"缓存"                            "分布式缓存集群"  ← 升了一级
"用户登录"                        "OAuth2 认证系统" ← 升了两级
"定时清理日志"                    "日志采集+聚合+告警平台" ← 升了三级

# AI 给你的架构方案
# 第 1 层：定义数据模型          ← 正确
# 第 2 层：实现缓存读写          ← 正确
# 第 3 层：实现分布式一致性协议   ← 跳了两层！你还没到这一步
# 第 4 层：实现故障转移和高可用   ← 又跳了一层

你：等一下。回到第 2 层。先实现基于 dict 的内存缓存。不要考虑分布式。
   现在的目标不是"完美的缓存系统"，是"能跑的缓存层"。

# AI 在回复中自己构建了一个你没提过的场景
AI：考虑到未来可能有多个服务实例同时访问缓存，
   我设计了一个基于 Redis 的分布式锁方案。
   ...
   另外，为了防止缓存雪崩，我加入了随机过期时间。

# 问题：AI 在"考虑"你根本没有提到的场景
# "未来可能有" = 它自己编的
# "为了防止" = 它自己加的

你：关于"多个服务实例"和"缓存雪崩"——
   1. 当前只有单实例，不需要分布式锁
   2. 缓存雪崩是未来的事，当前版本不考虑
   请去掉这两个部分，只保留基础缓存读写。

# 你要求：一个简单的配置文件读取器
# AI 给了：
class ConfigManager:
    def __init__(self):
        self._cache = {}
        self._watchers = []
        self._version = 0

    def load(self, path):
        # 支持 YAML、JSON、TOML、INI、ENV
        ...

    def watch(self, path, callback):
        # 文件变更监听
        ...

    def validate(self, schema):
        # JSON Schema 校验
        ...

    def merge(self, *configs):
        # 深度合并
        ...

# 你要求的功能         AI 给了
读取配置文件           读取 + 监听 + 校验 + 合并 + 多格式支持
发送邮件              发送 + 模板引擎 + 队列 + 重试 + 追踪
生成报表              生成 + 调度器 + 多格式导出 + 数据源抽象层

# 你的需求：用 SQLite 存储用户数据（明确说了"不要用 MySQL，环境不支持"）
# AI 的方案：
class UserRepository:
    def __init__(self, db_url: str = "mysql://..."):   # ← 默认 MySQL
        if "mysql" in db_url:
            self.db = MySQLConnection(db_url)
        else:
            self.db = SQLiteConnection(db_url)          # ← SQLite 是备选

# 重新声明约束，用"硬边界"词汇
你：SQLite 不是"备选"，是"唯一选项"。不要写 MySQL 分支代码。
   规范：如果只能用 SQLite 跑不通的功能，告诉我跑不通，不要自己切换数据库。

| 信号 | 检测方法 | 干预动作 |
|------|---------|---------|
| 命名暴露错误假设 | 类名/函数名里有你没提过的词 → 停 | "这个词不在需求里，请澄清含义" |
| 抽象层级跳跃 | 方案出现了你还没决定的下层细节 → 停 | "回到第 X 层，当前目标不是 Y" |
| 开始自问自答 | 出现"考虑到""万一""为了防止" → 停 | "去��� X 和 Y 部分，只保留 Z" |
| 注入未要求复杂度 | 功能数 N → 变成了 N×3+ → 停 | "只实现 A/B/C，其余全部移除" |
| 回避核心约束 | 你的"必须"变成了 AI 的"备选" → 停 | "X 是硬约束，不是建议。按此重新生成" |