AI协作经验记录 — 2026年5月7日~7月22日

01 . 03 . 04 . 05 . 06 . 07

州 郡县 功能区 细分区 位置 元素

方法 — 引擎级联加载（5层）：

1. 初始化世界环境+角色状态

2. 读城市骨架判定是否可进入

3. 基于团结参数过滤可交互热区

4. 读NPC/告示元数据渲染内容

5. 基于角色状态选匹配文案

教训 — 地图数据四层拆分：World > Region > City > Scene。占位骨架防拍脑袋——先建地形框架，再解锁具体内容。

教训 — effects/按郡县分文件：逐级新增时只改一个文件，避免多线开发冲突。

2.4 分支设计踩坑（6月中旬）

教训 — 事件节点物理位置优先：在未确定"翻仓库"和"蜈蚣洞碰运气"的物理位置（蜈蚣洞 vs 土城）之前就设计了分叉逻辑，导致分叉爆炸——3×2=6条线，其中一条的来源无法解释。设计多分支结构时，必须先确定每个事件节点的物理位置和触发时机，再进行分支树推算。

方法 — 分叉收束技术：将礼物选择从婚礼阶段移到攻城战与守城战之间，6条路线按道具状态收束为4个镜像节点，每条镜像对应不同的道具组合和可选选项。

第三阶段：6月中旬 装备系统 + 编解码工程

3.1 装备系统（6月中旬）

方法 — 定义域与值域分离：

- 定义域（静态JSON模板：items.json, effects.json, loot.json）— 从不改变

- 值域（运行时数据：gameState）— 唯一可变源

- 两者永不混合

方法 — 跳点系统：special/rare品质装备30%概率触发跳点，最多连续7次。

踩过的坑：

3.2 文件编码与路径工程（6月14日）

踩坑 — 三个技术依赖陷阱：

教训 — 75%解决率上限：连续三次同类失败，直接问用户，不要继续猜。

教训 — 源文件标注缺失是一切前端补丁的根因：当源文件缺乏清晰的节点边界和内容类型标记时，前端代码不可避免地变成补丁堆砌。不应在代码层面打补丁来掩盖素材端的问题。

3.3 文件架构方法论

方法 — 三包体系：

第四阶段：6月下旬 视觉工程 + 内容工程

4.1 配图策略（6月21日）

方法 — 配图跟随阅读流程：每路线前3个节点全覆盖（抓住入口）+ 后续重点节点（深化体验）。

方法 — 图片处理流水线：原图(2-6MB) → PIL WebP压缩(最大500KB，超2560px则resize) → JSON的image字段。

教训 — 优先清空旧任务列表：专注单一任务是保持执行效率的关键。

4.2 首页重构与视觉规范（6月25日）

方法 — 热区坐标交互：场景"规划桌前"使用热区坐标技术实现可点击交互区域（地图、州郡书卷、杯子）。

教训 — "审美要融洽"原则：又冷又硬的内容（制度叙事/规则自生长）不能配Q版萌系视觉。正确方向是"水墨×电路"的碰撞感。

教训 — 框架不重写，内容随便换：每次快要出提示词时，就会发现还有一个"审美融洽"问题没解决。这是探索式创作而非执行式工程。解法：先做最小骨架验证方向，方向对了再扩展。视觉风格必须与内容类型相匹配，不能"先美化再填充内容"。

4.3 md_to_html 转换规范（6月下旬）

方法 — 三类视觉风格决策树：

- 检查清单/任务跟踪 → 秩序感中性

方法 — 7个可复用HTML组件：元信息卡片(.meta)、信息表格(table)、卡片容器(.card)、步骤列表(.step)、树状结构(.tree)、标签(.tag)、折叠面板(details)

4.4 标记位与状态系统（6月下旬）

方法 — 标记位读写系统：存储在story.json的player_state中，控制选项分支和阶段切换。互斥规则防止矛盾状态（如同时携带木牍又选择隐匿进城）。

方法 — 民间互助层状态表：通过老妇/县吏/小孩三个NPC的行为变化反映城镇秩序状态，降级不可逆。

方法 — AI生成审查原则：审核清单顺序是"先看有没有点破，再看有没有振动"。设计师只写框架和种子，AI生成10版，设计师挑1版、改3处、定稿。

4.5 文件检查流程（6月16日）

第五阶段：7月初 项目重组

5.1 工作区重组（7月2日）

6个散落文件夹 → 规范结构。折叠历史文件目录建立，备份区与工作区分离。架构范式开始在项目间复用。

核心基因确立：

> "渲染器管'怎么画'，配置管'画在哪'。"

第六阶段：7月3~5日 美术实验室 + 浑天球面渲染

6.1 experiments 美术实验室（7月3-4日）

取色器 → 天空渲染器 → 道路渲染器 → 地面渲染器 → 透视标定。

踩坑 — 两套系统各管一半然后混合：纵向锚点（7色）+ 横向cells（取1行）50%混合 → 各丢一半对比度，画面发灰。正确做法：一套系统同时管两个方向（双线性插值）。

方法 — 透视标定：从路的收敛参数反推灭点(3.13,8.67)、scaleX=1-0.1154×Y。照片只是找规则的参考，目标是程序化生成不依赖照片。

6.2 浑天·球面渲染器（7月5日）

方法 — C/B/A三层架构：不是三个功能，是三个时间尺度。C层管参数关系，B层管地质尺度的慢变（岁差），A层管人类观测尺度。

方法 — 物理归约到原语：重力(管形) + 光学叠加(管光) + 三原色(管色)。多一样不需要，少一样不够——游戏场景渲染的完备集。

方法 — 滑块对数映射：map滑块0-1000 → 缩放0.05×-3.0×，小值区域占73%行程，优先给外行星留操作精度。

关键设计决策：

- 画布尺寸不改，加缩放（海王星需10400px不现实）

- 月球不加（0.4px不可见，属另一视图）

- 美化拒绝（诚实模拟哲学）

- 用户确认：最有兴奋感的是"搭出一个结构"，不是"算出一个结果"

6.3 主页重构（7月5日）

方法 — 三级空间层级：Hero卡片(视觉权重2×，渐变背景+铜色左边框+SVG装饰) → 分组(label+渐变线) → 紧凑卡片。

第七阶段：7月6~8日 材料光学

7.1 绝对参照系（7月8日）

方法：宝石中心=(0,0,0)一次定义永不重算。法向量只计算一次。避免相对坐标累积误差。

方法 — 三文件分离架构确立：config(JSON) + engine(纯计算) + viewer(纯展示)。这成为后续所有项目的架构范式。

7.2 双吸收峰模型（7月8日）

方法：祖母绿色偏青的根因→单吸收峰只去红光，透射剩蓝+绿=青。真实祖母绿有红+蓝紫双吸收带。新增第二高斯吸收峰解决偏色。

7.3 版本合并回填（7月8日）

第八阶段：7月9日 景格 v0.1→v1.0（单日全栈开发）

8.1 版本演进

v0.1→v0.2→v0.3→v0.4→v1.0，5个版本在一天内完成。

8.2 新增方法

方法 — 三种透视模式分路计算：gradient(1-slope×Y) / flat(1.0恒定) / split(近flat+远gradient)。不同类型用不同公式。

方法 — 布局框替代尺寸数值：绘画AI对"米"无概念，但能理解四角坐标围成的区域。

方法 — 交互模式B：引擎推荐最佳位置（评分系统：避开危险区+不超上限+不遮挡焦点+优先近景）→ 用户确认放置。

方法 — detailHint占位符：导出提示词中每个元素前加"（补充[...]）"，明确告知AI没填的内容。

方法 — 坐标翻转只在导出层：内部保持Y=0底→Y增向上，导出时翻转为标准坐标系。内部一致性优先，适配工作在边界层做。

8.3 新增踩坑

九、多坐标系变化导致的变量名歧义问题（专项梳理）

问题链

在三个不同项目中反复出现同一个bug模式：

深层机制

不是"忘记翻转"的简单疏忽，而是系统性问题：

1. 隐式坐标系假设：每段代码默默假设Y的起点但从不显式声明

2. 单坐标系传值：跨层只传一个数（如y=12），接收方不知道是哪个坐标系

3. 翻转替换：接收方对数值做翻转，但若拿到的已经是翻转后的值→双重翻转

解决方案（三项目验证有效）

规则3：用冗余换确定性。算好的有限参数组不会带来传输问题，但用错定义域的值才是真正的麻烦源。

十、跨项目可复用模式

10.1 架构基因进化

取色器(数据) → 天空渲染器(渲染器) → JSON配置(分离) → 三文件架构(范式)

任何新工具启动时首先确定：数据在哪、算法在哪、展示在哪。三个文件，三种职责，互不僭越。

10.2 问题→方法→规则的升级路径

10.3 展示不承诺模式

材料光学和景格都用此定位：放在rugoi.com公开，不承诺迭代/服务/商业化。核心目标是概念验证——"这条路径是否可行？"

10.4 单日全栈开发模式

景格一天内从立项到部署，效率要素：

1. 架构范式已成熟（直接复制材料光学的三文件结构）

2. 数据已有（透视标定来自experiments，参考尺寸是共识）

3. 交互简化（B模式替代自定义布局）

4. 不追求完善只追求可用

10.5 人定规则·AI填肉

设计师定义骨架、情绪、节奏。AI负责批量生成、替换、迭代。设计师只写框架和种子，AI生成10版，设计师挑1版、改3处、定稿。

10.6 活文档机制

十一、核心原则集（按建立时间排列）

十二、文档来源索引

第九阶段：7月10~15日 基础方法·完整提炼

9.1 协作基本法七条（7月15日）

方法：从五个月的全部踩坑中提炼出最基础的七条规则：

① 人清楚要做什么 — 人定义规则层，AI填充内容层。"不清楚怎么实现"不是短板，是正确位置。

② 人判断可用/需调 — 人有权决定AI的产出是否能用、是否需调整。AI不能替人做判断。

③ 数据源/算法/输出单列 — 三者不混在同一步骤中。数据从哪来、怎么算、结果放哪——每一步只做一件事。

④ 变量名对齐 — 跨模块传递时变量名保持一致。换名意味着隐式翻转——接收方不知道新旧名的对应关系。

⑤ 过程中不断检查 — 每一步执行后都验证。不是"做完再查"——是"做完一步就查一步"。

⑥ 安全边界 — 命令和资料分离防间接注入。凭据不进对话框。越权操作先批准。

⑦ 交付触达 — 产出物放在用户触手可及的位置。PWA/微信收藏/书签/二维码——用户不需要"找到"，用户需要"就在那"。

教训：基本法不是一次性写出来的——是从"环境叙事要间接"→"源文件标注不足导致前端补丁"→"跨坐标系传值要双份"这条踩坑链中，一层一层反向提取出来的。每一条背后都有至少一个项目崩溃的代价。

9.2 排除法（7月21-22日）

方法：不是找正确答案——是先剔除不可能的。

实际应用链：

- 服务器限流 5→100 不是 1000 → 划掉过剩

- DDR4 200 球不追求 377 球 → 划掉不需要的

- 节点自检卡 → 划掉"不确定该不该停"

- 四要素规则 → 划掉"祈使句被当输出"

- "谁最不应该是帅" → 划掉不可能的答案

深层机制：划掉之后，概率的微弱优势已经在了。剩下的不是精确计算——是时间本身会把 40%、35%、25% 的概率压成 100% 的事实。排除法不是在找对——是在移除错。

9.3 刚好够原则（7月21-22日）

方法：最小权限不是安全域特有的——是全域的。

在不同层的同构投影：

- 安全层：Claude Code 关文件隔离但保留网络——关该关的，不多关

- 硬件层：DDR4 200 球刚好——DDR5 377 球在消费级是过剩的

- 显示层：480×720 在电脑尺寸上已完备

- 执行层：节点扫描只能 Read+WebSearch，不能 scp——节点级最小权限

教训："刚好够"不是"最便宜"。最便宜意味着将就。刚好够意味着所有多余的东西都不在账单里。

9.4 信息塌缩（7月21-22日）

方法：三条线同时跑——政策验证、技术验证、社区发现——各自独立出发，在同一个点上交汇。不是算出来的，是线撞在一起自己亮的。

应用：

三大厂停产 DDR4 →

IoT 需求还在增长 → 三根线在同一个点上交汇：不减仓

产能 18 个月补不上 →

教训：最好的分析不需要"公式推出来"。只需要把分开的线拉回来——它们自己会告诉你交叉点在哪。

第十阶段：7月16~22日 自动化生产系统

10.1 .md 工作流工厂（7月16-19日）

方法 — 黄金五段结构：每条可粘进 AI 对话框的指令必须包含五段：

① 角色定义 — "你是XX助手"

② 输入说明 — "请提供：〔参数1〕〔参数2〕"

③ 执行方法 — "按以下步骤：①...②...③..."

④ 输出格式 — "输出格式：... 列1 列2 ..."

⑤ 约束条件 — "不要/禁止/不允许..."

方法 — 四要素动作指令：每条动作指令必须包含 动作词（分析/检查/输出）+ 对象（分析什么）+ 方法（按什么维度）+ 位置（输出到哪里）。缺任一个 = 歧义。

方法 — 每日内容引擎：7维市场扫描（AI热点/商学院/GitHub/大众层/非技术学习/大学生/评论）→ 对照去重 → 自动建文件 → 自动部署 → 自动日志。从手工生产到全自动闭环。

方法 — 蛮荒社区发现：五轮全社区扫描发现——真正的大规模提示词工程师不在技术社区，在游戏/乙女/跑团/QQ群/卡片圈。他们管它叫"咒语""人设卡""攻略""调教"，做的事跟工作流 .md 完全同构。

10.2 SEO/GEO 全站诊断（7月16日）

方法 — 13层扫描修复链：Meta Description → OG → canonical → Schema → bytedance时间因子 → sitemap。不是"先列清单再逐一修"——是每修一层、验证一层、再修下一层。发现一个修一个会遗漏；一次性全列再修会混乱。分层递进是唯一稳定路径。

教训 — "描述"vs"执行"的区别：自动化计划中用祈使句描述操作（"注册到注册表""嵌入标签"），AI 会写进报告而非执行文件修改。必须用精确的工具调用模板（工具名 + 目标文件绝对路径 + old_string + new_string）。

10.3 文件系统作为消息总线（7月21-22日）

方法 — slot 通信机制：节点之间传递结果不依赖 API、不依赖消息队列、不依赖数据库。一个文件夹里的 JSON 文件——节点 A 写完，节点 B 等着读。这个文件就是 slot（槽位）。

优势：松耦合。节点 A 不需要知道节点 B 的存在。只需要知道"我的输出写在这个位置"。路由检查器负责发现"这里有个完成的结果，该轮到谁了"。

方法 — 巴别塔协议对齐：同时产出两份文件——原生 JSON（内部路由使用）+ 巴别塔 JSONL（外部 Agent 读取）。不需要 SDK，不需要注册中心——能读写文件就能参与这条链路。

10.4 事件驱动替代轮询（7月22日）

验证 — sleep 不可靠：自动化计划环境中 sleep 接力失效——08:56 检查→sleep 15m→09:11 未恢复。轮询模式在跨步骤接力中被截断。

10.5 R/W 模式发现（7月22日）