# 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. 如新增关键设定或伏笔，回填到对应设定文件。