# 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` - 越盟：`人物卡/越盟/朱文晋.md` - 村民：`人物卡/村民/脚夫.md`、`人物卡/村民/村塾先生.md` 7. 写当前连载正文时，从 `正文/` 下最新章节往前读至少 2 章。 历史资料和参考材料在 `资料底座.md`、`资料-异星工厂科技树.md`、`参考/`，需要校准历史、开头节奏或同人路线时再读。 ## 当前正文状态 当前已经写到： - `正文/1 弃船/1.1 坠毁后的第一夜/001 我不是博士.md` - `正文/1 弃船/1.1 坠毁后的第一夜/002 第一次接触.md` - `正文/1 弃船/1.1 坠毁后的第一夜/003 那个见不得光的病人.md` 旧稿与合并草稿已清理。当前正文采用 `00X 标题.md` 编号格式，单章约 4000 字起步，继续写时以该格式为准，不要把新正文只写进合并草稿。 ## 当前剧情断点 第 3 章（`003 那个见不得光的病人`）结尾状态： - 古米和村塾先生把朱文晋抬上半山腰藏身处，赫默完成清创、抗感染处理和补液。 - 药箱消耗：抗感染贴片剩十片，退热药剩三份，输液包剩一个。 - 村塾先生仍只称伤员为“病人”，但伤员梦话中提到“日本人”“不要回村子”“他们会找到我”。 - 古米用半块压缩饼干换来妇人信任，妇人拿出最后几把糙米；宁诚以先喝一口粥的方式打破戒备。 - 宁诚与赫默确认：下一批药物必须回主体残骸里的医务室取，但四人无法搬开两吨结构。 - 日军搜山的压力作为村民恐慌背景存在，第一夜不正式登场。 - 主体残骸尚未清理，黎明即将到来。 下一章最自然的方向： - 第 4 章承接“醒来”。 - 写朱文晋退烧后短暂清醒，用简短汉语与宁诚交流。 - 写腕环翻译模块在频繁对话中逐步恢复简单越南语能力。 - 村民和村塾先生第一次被翻译器/技术震撼。 - 不要正式揭示朱文晋的完整身份，只通过只言片语暗示其分量。 ## 已确认硬边界 - 宁诚是开局唯一真正工程主导者。 - 宁诚带有 OTL《明日方舟》玩家记忆，认知限于角色名字、人设与大致背景；游戏知识到 1945 年越南现场严重缩水，不涵盖终末地工程细节、源石病医疗、时代历史与当地情报。 - 主角团开局一穷二白，只有残骸、有限设备、少量急救资源和低功耗核心。 - 博士权限完整，但权限不能跳过能源、材料、人力、地形、保密和时代条件。 - 飞船残骸是终末地核心资产，不是普通垃圾；主体残骸必然暴露，1.1 的成果只是拖延发现和制造误判。 - 药物库存极少，用完就没；当前只能处理外伤感染、高热、脱水、污染伤口等急症。 - 第一笔技术交换是“药换食物”，救治对象是被村民藏匿的越盟中层干部朱文晋（Chu Văn Tấn），当时村民只知其身份敏感。 - 源石病在 1.1 只做暗线，不作为第一笔信任事件。 - 日军压力采用 1945 年越南语境下的局部治安搜捕、征粮搜山、查村搜人、追索怪光与坠落声、调查法国残余和越盟外围交通线，不照搬华北“扫荡”模板。 - 越盟和村民不是主角工具人；他们有自己的风险、饥荒、保密逻辑和政治目标。 ## 叙事风格 - 慢热但紧绷。 - 先写受伤、残骸、饥荒、村落、语言障碍、日军压力和“活下去”。 - 每章只承担一个小动作、一个信息增量或一个转折。 - 单章约 4000 字起步，根据场面完整性可上浮。 - 主视角长期围绕宁诚的判断、误判和决策。 - 可以短切古米、赫默、村民或日军，但信息最终要回到宁诚这里汇总成下一步行动。 - 时代信息通过可见物证和人物接触逐步拼出，不要用大段设定讲解压住开局。 - 科技写法要受限：计算、蓝图、流程、诊断、修复、伪装、药物处理都必须被能源、材料、接口、人员、地形、保密和时代条件约束。 ## 禁止写法 - 不要让主角团开局全知全能。宁诚的玩家记忆只提供“认识干员”和“模糊倾向”，不能替代现场观察、技术验证和时代学习。 - 不要让药物、无人机、核心计算机无限使用。 - 不要一上来大规模解释源石病。 - 不要让其他工程角色抢走宁诚的主导位置。 - 不要把村民、越盟或日本人写成只服务主角的空壳。 - 不要让残骸清理得过于完美。 - 不要把日军写成只会送经验的纸片敌人。 - 不要让越盟高层太早正式出场。 ## 文件维护规则 - 新正文优先放在 `正文/<卷名>/<篇名>/00X 标题.md`，标题根据章节核心动作或判断命名。 - 合并稿只作为阶段性整理产物，不作为唯一正稿来源。 - 中间产物统一放入 `中间文件/`，包括润色输出、diff 对比、脚本和提示词；清理临时文件时只清理这个目录下确认不需要的内容。 - 根目录只保留正文、设定、参考、人物卡、大纲和项目维护文件，避免把临时润色稿误当正稿。 - 修改设定时同步更新对应权威文件： - 世界规则：`世界书.md` - 项目方向：`项目总览.md` - 章节计划：`大纲/` - 角色设定：`人物卡/` - 风格和禁忌：`风格规则.md` - 伏笔兑现：`伏笔与承诺.md` - 不要随意覆盖用户或其他 agent 已经写好的章节；需要重写时，新建版本或先说明改动范围。 ## 修改纪律 - 准备修改任何文本文件（尤其是 `正文/` 下的章节、`人物卡/`、`大纲/`、`世界书.md` 等设定文件）之前，必须先重新读取该文件的最新版本，禁止仅凭记忆或旧上下文直接动手覆盖。 - 如果读取后发现文件内容与你记忆中的版本不一致，先停下来确认：是否有用户或其他 agent 的新改动，是否需要调整你的修改方案。 - 优先做最小修改；必须大改时，先向用户说明改动范围并取得确认，再进行实际操作。 ## 接手检查清单 继续写作前： 1. 看 `git status --short`，确认是否已有未提交改动。 2. 找 `正文/` 下最新章节，至少读前 2 章。 3. 对照 `大纲/1-1.1.md`，确认当前还在 1.1《坠毁后的第一夜》的节奏内。 4. 写完后检查新章是否满足：资源有限、语言障碍、政治风险、残骸暴露倒计时、宁诚主导。 5. 如新增关键设定或伏笔，回填到对应设定文件。