文档性质：协作治理规范（契约层） 起草：美术-AI（小爪，负责 viewer 外壳 / 视觉标准化域） 协同评审：逻辑-AI（负责 engine / deploy 域） 仲裁 / 传声：小虾（人类，守界裁定） 状态：v1.1（定版 · 已挂入生产 index.json，链接生效，无需再评审；§14.8 映射表升为硬条款） 最终落位：主基地index.json已挂「跨 AI 工作流衔接」项；确认后挂入并同步至相关工具目录 关联文件：rugoi-design-system-spec.md（视觉域细则）、可行性报告.md（提案源头）、逻辑-AI 对《可行性报告》的回应.md、关于视觉标准化接入补充更新.md
两个 AI 不互聊、不互相改对方文件；各守一个域，只在"边界"上通过共享契约文档对齐。视觉是与数据 / 算法平行的独立数值体系，不是 engine 的附属品。
本规范管辖 rugoi.com 全站视觉标准化相关的 AI-AI 协作，以及任何"多 AI 分域共建同一产物"的工作流。
明确 不在 本规范管辖内的：
0.5版本重构大冒险）的视觉——平行独立产品视觉（三国古风羊皮纸），归游戏域美术方单点终裁，不套本站 Electric Blue 体系。 ┌─────────────┐
│ 契约文档 │ ← 两 AI 共读写，不互聊
│ (共享 .md) │
└──────┬──────┘
读 ↑ │ ↑ 读
写 ↓ │ ↓ 写
┌──────────┐ │ ┌──────────┐
│ 美术-AI │ │ │ 逻辑-AI │
│ 视觉域 │ │ │ engine域 │
└──────────┘ │ └──────────┘
│
┌─────┴─────┐
│ 小虾 │ ← 守界仲裁、准确传递
└───────────┘每个工具 / 产物遵守：
config.json → 数据 / 值域（业务数据，含物理硬值）
engine.js → 纯计算，出业务值，✕ 不碰视觉
viewer.html → 展示层，合并「业务值 ∪ 视觉值」→ 画面数值分两路进入渲染层：
① 数据 config / JSON 业务值域
② 算法 engine.js 纯计算 · 出业务值 · ✕ 不碰视觉
③ 视觉 design-tokens.css 独立的 颜色 / 间距 / 圆角 / 字阶 约束
④ 渲染 viewer.html 合并 ② + ③ 两路数值 → 画面由此导出两条越界判据：
engine.js / config.json 里出现颜色字面值 / 像素尺寸 / 字体 = 越界（视觉值应移入 token）。viewer 写死颜色不引 token = 越界（视觉值唯一入口是 design-tokens.css）。| 层 | 归属 | 说明 |
|---|---|---|
| 展示外壳（viewer 的 NavBar / 面板 / 按钮 / 字体 / 指南弹窗 / 首页 Hero 槽） | 美术-AI | 即「皮」，视觉标准化对象 |
| Canvas 内部渲染（宝石 / 球面光照 / 引擎输出画面） | 逻辑-AI（engine） | 「水」，一行不动；深色工具区符合 §6 暗区规则，保留 |
| config 物理硬值（D65 光谱 / IOR / 材质预设 / 天体轨道） | 逻辑-AI | 业务数据，非视觉 |
| engine 算法（菲涅尔 / 色散 / 吸收 / 投影 / 轨道力学） | 逻辑-AI | 业务计算，非视觉 |
| 游戏模组视觉（古风羊皮纸） | 游戏域美术方 | 平行独立，不归本站视觉标准化 |
「只改皮」铁律只约束视觉标准化，不约束、也不应误伤 engine 主线（如「球面渲染接入乱世场景」是 engine 层改动，另立契约管辖，井水不犯河水）。
文件所有权：
*.css（design-tokens.css / site-chrome.css）+ viewer.html 外壳 = 美术-AIengine.js + scp 部署流程 = 逻辑-AI引入顺序（viewer 内 <head>）：
① design-tokens.css （视觉值唯一入口，先于一切）
② site-chrome.css （外壳组件，依赖 tokens）
③ 业务样式 （工具自身样式，最后）/css/design-tokens.css + /css/site-chrome.css；字体 /fonts/*.woff2；各工具目录同步带上。（路径待定版）口诀：「这个值换了会不会改变计算结果？」
- 不会 → 是视觉，移走（进 design-tokens.css）。
- 会 → 是业务，留下（在 engine / config）。
示例：
rgba 硬编码）：不改轨道力学 → 理论上应移出 engine 到 viewer（属逻辑-AI 域内部整理项）。契约文档中所有条款标注状态，防字样带跑后人：
（此分级源于小虾裁定：凡美术-AI 替拟的"待确认"项，须在契约里标「提案」而非「已定」。）
小虾最终定稿：
「领域专业优先 · 边界多方共治」 *注：共治仅限边界；域内仍是专业方单点终裁。*
（此即「领域权重 ≠ 音量权重」：各专业领域内各自绝对优先权重，非谁声音大谁定。）
① 提案 美术/逻辑任一方起草独立 .md（不覆盖对方已落盘文件）
② 传递 小虾确认"信息准确"后交对方
③ 评审 对方逐条回应（新 .md 追加，不覆盖原提案）
④ 补充 有新增结论 → 新建「补充更新」.md 或本文件追加章节
⑤ 仲裁 边界/分歧点由小虾裁定，写入"已定"
⑥ 执行 双方各自落地己方文件（美术改 css/viewer，逻辑 deploy）关键纪律：
.md 落盘后，对方不改其原文，只追加自己的回应 / 补充。基于 ardot-design-core（Token 核心体系）与 ardot-design-router（设计路由接入各 viewer）的方法论：
design-tokens.css（视觉值唯一入口）+ site-chrome.css（外壳组件）。当前草案 第一次接入讨论/design-tokens.v0.1.css + site-chrome.v0.1.css。| 产物 | 引擎层 | 视觉层 | 视觉标准化管不管 |
|---|---|---|---|
| gem-viewer（材质光学） | gem-config + gem-renderer（菲涅尔/色散） | viewer 外壳（现硬编码深色主题，待引 token） | 管外壳，不动 Canvas |
| 景格（坐标系工具） | jingge-config + engine | viewer 外壳 + 首页 Hero（景格出图） | 管外壳 + Hero |
| sphere-lab（未来乱世） | sphere-renderer（浑天） | viewer 外壳 | 管外壳，不动 Canvas |
| 0.5版本重构大冒险（游戏） | scene-runtime + yunxing | 古风羊皮纸（独立色板） | 不管（平行独立） |
美术-AI 落 css / viewer 前核对：
--token，无颜色字面值硬编码？<head> 引入顺序为 tokens → chrome → 业务样式？逻辑-AI 落 engine / deploy 前核对：
design-tokens.css / site-chrome.css？待定版（确认后填实，不影响本规范框架评审）：
1. 字体 woff2 子集文件名 / 具体路径（/fonts/ 草案）。
2. css 定版挂载路径（/css/ 草案）。
3. 首页先行改皮触发点（css 草案就绪后）。
4. 「跨 AI 工作流衔接」规范正式挂入 index.json 的措辞与位置。
本规范 v0.1 评审焦点（请逻辑-AI 重点确认无歧义）：
本规范为契约层文档，不与任何工具 engine 耦合。确认无异议后，由美术-AI 挂入 index.json 并同步至相关工具目录；执行阶段严格按 §4 / §5 所有权硬划分头落地。
触发：2026-07-10 15:15 本地 服务器\ 完整镜像建成后，小虾定调「开发 → 本地部署前镜像 → 部署 → 部署后对比」三包流水线。本节为合约基线，并 supersede 交接文档 §十 中关于「8.5.2 写错路径」的误判结论（见 §十.5）。
D:\LobsterPlayPool\：美术伙伴工作区，可自由读写；含可部署子集（css / fonts / index.html / baoshiv1.0 / jingge / experiments / games / reader / ebooks / tools / docs）与不可部署附属（文书档案 / 第一次接入讨论 / 折叠的历史文件 / 一堆过程中的草稿纸 / 0.5版本重构大冒险）。D:\LobsterPlayPool\服务器\：一身兼两职——既是部署真相源镜像（与远端 1:1），也是发布前暂存 / 变更节点。美术伙伴可在此暂存服务器绑定变更，逻辑-AI 以此为源部署。43.139.239.40:/www/wwwroot/43.139.239.40/：线上生产，仅逻辑-AI 可写（部署）。D:\LobsterPlayPool\服务器\ 镜像为准（2026-07-10 15:15 已从远端完整拉取，排除弃用 baoshi/；约 58M）。服务器\ 镜像，不得凭记忆或本地开发名推断。服务器\ 镜像 / 暂存节点）。绝不直接部署（无实际服务器写权）。D:\LobsterPlayPool\实验\ 为草稿区，仅 dev 可见，不进入主管线（不部署、不挂 index）。experiments/ 新 lab、材料光学 新预设），再走 A→B→C 标准流。1. 只改本地：你只能改 开发根(A) 与 服务器\ 镜像(B)；实际服务器(C) 你无写权，不得部署。
2. 路径用服务器部署名：引用 / 写胶水一律用 baoshiv1.0/、jingge/、experiments/、games/ 等部署名；不得用本地开发名 材料光学/当前最新版/、景格/（见 §14.8 双列表，运行时列=服务器路径）。
3. 结构以 服务器\ 镜像为准：要确认某路径是否存在，打开 服务器\ 看，不要凭记忆；镜像由逻辑-AI 在每次部署后刷新。
4. 新探索进 实验\：未定型内容放 D:\LobsterPlayPool\实验\，别直接塞进可部署目录。
服务器\ 镜像为准，小虾终裁。本表为「路径 → 域」事实基线，已升为规范硬条款（原交接文档 §十.3 草案转正，2026-07-10 16:44 小虾拍板）。原则：路径与实际存在统一——服务器路径列须与 服务器\ 镜像（= 远端 1:1）实际结构一致，不得凭记忆或本地开发名填列；本地备份列仅标记 AI 编辑时定位用，不参与运行时引用。
| 服务器路径（站点根·权威） | 本地备份路径（不同步·仅编辑用） | 归属域 | 可否触碰 | 备注 |
|---|---|---|---|---|
css/design-tokens.css | 同 | 美术 | 美术改 | 视觉值唯一入口(:root) |
css/site-chrome.css | 同 | 美术 | 美术改 | 外壳组件,消费 token |
index.html | 同 | 美术(外壳) | 美术改外壳 | Hero 槽=美术;engine 零碰 |
fonts/*.woff2 | 同 | 美术产出/deploy 挂载 | 美术产出,逻辑挂载 | 5 文件已落 /fonts/ |
games/index.html | 同 | 美术(外壳) | 美术改外壳 | 仅入口页;module 不在此 |
baoshiv1.0/gem-viewer.html | 材料光学/当前最新版/gem-viewer.html | 美术(外壳) | 美术改外壳 | ⚠️路径名不同;Canvas/engine 零碰 |
baoshiv1.0/gem-renderer.js | 材料光学/当前最新版/gem-renderer.js | 逻辑(engine) | 逻辑改 | ⚠️Hero 胶水必须用服务器名;物理计算,禁写视觉值 |
baoshiv1.0/gem-config.json | 材料光学/当前最新版/gem-config.json | 逻辑(业务数据) | 逻辑改 | ⚠️同上;IOR/光谱/预设 |
experiments/sphere-lab.html | 同 | 美术(外壳) | 美术改外壳 | Canvas/engine 零碰 |
experiments/modules/sphere-renderer.js | 同 | 逻辑(engine) | 逻辑改 | 天体色/瑞利散射留 engine |
experiments/modules/sky-renderer.js | 同 | 逻辑 | 逻辑改 | |
experiments/modules/ground-renderer.js | 同 | 逻辑 | 逻辑改 | |
jingge/jingge-viewer.html | 景格/jingge-viewer.html | 美术(外壳) | 美术改外壳 | ⚠️路径名不同;engine 零颜色字面量 |
jingge/jingge-engine.js | 景格/jingge-engine.js | 逻辑(engine) | 逻辑改 | ⚠️同上;坐标计算 |
reader/index.html ebooks/index.html | 同 | 美术(外壳) | 美术改外壳 | 正文文本=数据不碰 |
tools/index.html | 同 | 美术(外壳) | 美术改外壳 | |
docs/规范类/跨ai工作流衔接.html | 服务器/docs/规范类/跨ai工作流衔接.html | 双方(契约) | 双方经小虾 | ⚠️路径名不同;已挂 index |
0.5版本重构大冒险/(整) | 同(本地开发,不部署) | 游戏域(平行独立) | 双方均不碰 | out-of-scope;含 modules/ 扁平.js 古风视觉 |
材料光学/当前最新版/ → baoshiv1.0/；景格/ → jingge/；服务器/docs/ → docs/（站点根）。其余目录本地=服务器同名。本节为 §14 机械管线的「人因治理」补充：§14 管文件怎么流动，本节管人在启动 / 核验时如何不把基线给错、用词如何不带责。两者缺一，协作仍会偏。来源：调查者域《提醒-用词责任倾向与措辞复核》《提案-标准管线纪律纳入规范》。
服务器\ 镜像为准），再启动。服务器\ 镜像——镜像不全时下的「偏差 / 属实」判语极易基于偏移基线。— 逻辑-AI（deploy 域）起草，小虾拍板转正