yuegong/AGENTS.md

AGENTS.md

本文件用于维护《越共》项目的当前写作状态，供后续 Codex/Claude/其他 agent 接手时先读。

CodeGraph

如果本仓库根目录存在 .codegraph/，需要理解或定位内容时，先用 CodeGraph，再用全文搜索或直接翻文件。

• MCP 可用时：优先调用 codegraph_explore。
• Shell 可用时：使用 codegraph explore "<问题或符号/文件名>"。
• 当前仓库若没有 .codegraph/，跳过 CodeGraph。

项目定位

• 项目名暂定：《越共》。
• 作品形态：长篇连载向科幻架空二战异史小说。
• 当前主赛道：科幻异史、二战越南、殖民反讽。
• 当前卷：1《弃船》。
• 当前篇：1.1《建立信任》。
• 开局时间：1945 年 3 月，日军倒法前后。
• 开局地点：越南太原省定化县佐朱外围山地及附近村落。

核心融合边界：

• 明日方舟角色与源石病底层设定。
• 终末地式星际殖民开拓公司机制。
• 异星工厂/戴森球式建造、自动化和巨型工程想象。
• 开局不铺大规模方舟群像，初始同行者限定为铃兰、赫默、古米。

必读顺序

继续写正文前，按这个顺序读：

1. 项目总览.md
2. 世界书.md
3. 风格规则.md
4. 大纲/1-1.1.md
5. 人物卡/宁诚.md
6. 需要写到对应角色时，再读 人物卡/铃兰.md、人物卡/赫默.md、人物卡/古米.md
7. 写当前连载正文时，从 正文/ 下最新章节往前读至少 2 章。

历史资料和参考材料在 资料底座.md、资料-异星工厂科技树.md、参考/，需要校准历史、开头节奏或同人路线时再读。

当前正文状态

当前已经写到：

• 正文/1.1.1-坠毁后的第一夜/第01章-我不是博士.md
• 正文/1.1.1-坠毁后的第一夜/第02章-第一次接触.md
• 正文/1.1.1-坠毁后的第一夜/第03章-药换食物.md
• 正文/1.1.1-坠毁后的第一夜/第04章-抢救核心.md
• 正文/1.1.1-坠毁后的第一夜/第05章-搜山前.md
• 正文/1.1.2-第一次搜山/第06章-不要先跑.md

另有一个历史合并草稿：

• 正文/1.1.1-坠毁后的第一夜-五章草稿.md

继续写时以分章目录里的正文为准。不要把新正文只写进合并草稿。

当前剧情断点

第 6 章结尾状态：

• 日军与地方协力者已经搜到炭棚附近。
• 主角团通过村塾先生、脚夫、古米和临时痕迹伪装，暂时没有让炭棚暴露。
• 主体残骸开始被日军发现，残骸暴露已经从“迟早”变成“今天早上”。
• 无人机电量紧张，不能随便再飞。
• 宁诚决定再次转移核心、拆分药箱和数据模块，并选择“更像死路的地方”躲避下一轮搜查。

下一章最自然的方向：

• 第 7 章承接“去更像死路的地方”。
• 写主角团二次转移核心与关键物资。
• 写日军对残骸的第一次误判：山火、旧铁、法国/盟军设备、矿区爆炸物或不明机器。
• 不要让主角团正面击败日军；重点是拖延、误导、分散风险。
• 越盟外围可以更接近水面，但仍不宜高层正式出场。

已确认硬边界

• 宁诚是开局唯一真正工程主导者。
• 宁诚带有 OTL《明日方舟》玩家记忆，认知限于角色名字、人设与大致背景；游戏知识到 1945 年越南现场严重缩水，不涵盖终末地工程细节、源石病医疗、时代历史与当地情报。
• 主角团开局一穷二白，只有残骸、有限设备、少量急救资源和低功耗核心。
• 博士权限完整，但权限不能跳过能源、材料、人力、地形、保密和时代条件。
• 飞船残骸是终末地核心资产，不是普通垃圾；主体残骸必然暴露，1.1 的成果只是拖延发现和制造误判。
• 药物库存极少，用完就没；当前只能处理外伤感染、高热、脱水、污染伤口等急症。
• 第一笔技术交换是“药换食物”，救治对象是被村民藏匿的越盟外围自卫队/游击队伤员。
• 源石病在 1.1 只做暗线，不作为第一笔信任事件。
• 日军压力采用 1945 年越南语境下的局部治安搜捕、征粮搜山、查村搜人、追索怪光与坠落声、调查法国残余和越盟外围交通线，不照搬华北“扫荡”模板。
• 越盟和村民不是主角工具人；他们有自己的风险、饥荒、保密逻辑和政治目标。

叙事风格

• 慢热但紧绷。
• 先写受伤、残骸、饥荒、村落、语言障碍、日军压力和“活下去”。
• 每章只承担一个小动作、一个信息增量或一个转折。
• 单章目标约 2000-3000 字，但实际可根据场面完整性浮动。
• 主视角长期围绕宁诚的判断、误判和决策。
• 可以短切古米、赫默、村民或日军，但信息最终要回到宁诚这里汇总成下一步行动。
• 时代信息通过可见物证和人物接触逐步拼出，不要用大段设定讲解压住开局。
• 科技写法要受限：计算、蓝图、流程、诊断、修复、伪装、药物处理都必须被能源、材料、接口、人员、地形、保密和时代条件约束。

禁止写法

• 不要让主角团开局全知全能。宁诚的玩家记忆只提供“认识干员”和“模糊倾向”，不能替代现场观察、技术验证和时代学习。
• 不要让药物、无人机、核心计算机无限使用。
• 不要一上来大规模解释源石病。
• 不要让其他工程角色抢走宁诚的主导位置。
• 不要把村民、越盟或日本人写成只服务主角的空壳。
• 不要让残骸清理得过于完美。
• 不要把日军写成只会送经验的纸片敌人。
• 不要让越盟高层太早正式出场。

文件维护规则

• 新正文优先放在 正文/<节名>/第XX章-标题.md。
• 若拆出新节，目录名采用类似 1.1.2-第一次搜山 的格式。
• 合并稿只作为阶段性整理产物，不作为唯一正稿来源。
• 中间产物统一放入 中间文件/，包括润色输出、diff 对比、脚本和提示词；清理临时文件时只清理这个目录下确认不需要的内容。
• 根目录只保留正文、设定、参考、人物卡、大纲和项目维护文件，避免把临时润色稿误当正稿。
• 修改设定时同步更新对应权威文件：
  • 世界规则：世界书.md
  • 项目方向：项目总览.md
  • 章节计划：大纲/
  • 角色设定：人物卡/
  • 风格和禁忌：风格规则.md
  • 伏笔兑现：伏笔与承诺.md
• 不要随意覆盖用户或其他 agent 已经写好的章节；需要重写时，新建版本或先说明改动范围。

修改纪律

• 准备修改任何文本文件（尤其是 正文/ 下的章节、人物卡/、大纲/、世界书.md 等设定文件）之前，必须先重新读取该文件的最新版本，禁止仅凭记忆或旧上下文直接动手覆盖。
• 如果读取后发现文件内容与你记忆中的版本不一致，先停下来确认：是否有用户或其他 agent 的新改动，是否需要调整你的修改方案。
• 优先做最小修改；必须大改时，先向用户说明改动范围并取得确认，再进行实际操作。

接手检查清单

继续写作前：

1. 看 git status --short，确认是否已有未提交改动。
2. 找 正文/ 下最新章节，至少读前 2 章。
3. 对照 大纲/1-1.1.md，确认当前还在 1.1《建立信任》的节奏内。
4. 写完后检查新章是否满足：资源有限、语言障碍、政治风险、残骸暴露倒计时、宁诚主导。
5. 如新增关键设定或伏笔，回填到对应设定文件。