同福客栈专栏 · 编辑地图
这份地图把本地项目中分散的剧情、人物、经营机制、美术与工程资料整理为一个读者可进入的专栏。专栏成品位于
docs-site/column/index.html，本文件负责记录素材来源与维护边界。
一、专栏定位
- 对外主题：从一间客栈出发，写七侠镇的烟火、人情、经营选择与游戏制作。
- 读者入口：不要求先懂代码或项目管理，先读故事，再按兴趣进入人物、经营、美术和幕后资料。
- 内容边界：专栏只引用已经存在的项目事实，不把计划、草稿或 handoff 状态包装成已上线功能。
- 发布单元：
docs-site/是完整静态站点；专栏图片必须位于docs-site/assets/images/column/，不能依赖站点外路径。
二、五条栏目
| 栏目 | 面向读者的问题 | 主要素材来源 |
| --- | --- | --- |
| 客栈日常 | 同福客栈的一年如何展开？ | docs/story/主线故事/ |
| 人物志 | 每个人留下来，是因为怎样的选择？ | docs/story/characters/ |
| 掌柜账簿 | 经营、时间和抉择如何彼此影响？ | docs/design/active/产品需求总览-v1.md、经济与事件设计 |
| 江湖图鉴 | 客人、道具、Buff 和突发事件如何形成江湖感？ | src/data/、docs/design/ |
| 后厨手记 | 剧情、美术与代码怎样变成可玩的客栈？ | docs/art/、AGENTS.md、本项目地图 |
三、本地项目地图
| 区域 | 作用 | 整理规则 |
| --- | --- | --- |
| src/ | React 游戏源码 | 遵守数据、逻辑、UI 三层边界；专栏工作不修改这里 |
| public/ | 游戏运行时正式素材 | 专栏只复制需要的发布副本，不移动原文件 |
| docs/ | 设计、剧情、规范和协作资料 | 专栏文章应回链到这里的真实来源 |
| docs-site/ | 可独立部署的静态知识库 | column/ 是读者专栏；docs/ 是工程资料镜像 |
| scripts/docs-to-html/ | 知识库生成器 | 顶部导航由生成器维护，避免重建后丢失专栏入口 |
| tools/ | 编辑器与本地辅助工具 | 作为制作资料，不作为专栏主入口 |
| generated/、outputs/、preview/、tmp/ | 生成物与试验输出 | 当前只标记边界，不在有脏工作树时批量删除 |
| 根目录 args-*、tmp-*、日志与截图 | 历史调试证据 | 待确认保留期后统一归档；本轮不做破坏性清理 |
四、第一期内容索引
- 开业元年：从开张适应到岁末收束，12 个月形成一个完整经营与情感弧线。
- 白展堂人物志：官府盘查、江湖恩怨、隐匿日常、过往羁绊与终局抉择五条线。
- 经营不是点点点：时间、铜钱、声望、卫生与关系共同塑造选择成本。
- 一盏灯的制作账：从市井轻喜剧基调到角色头像、横幅和事件图的统一。
- 项目后厨：读者内容与工程真值分开，专栏负责讲故事，知识库负责查依据。
五、维护约定
- 新文章先确定归属栏目，再链接到一份可核对的源文档。
- 未实现内容使用“设计中”“待续”等准确措辞，不能写成现有玩法。
- 专栏首页保持轻量，无构建依赖；修改后用本地静态服务器检查桌面与移动端。
- 执行
scripts/docs-to-html/build.py后，重新检查docs-site/column/index.html和顶部“专栏”链接。 - 本地调试产物的移动或删除必须另开清理任务，先确认是否仍被脚本、文档或验收记录引用。
当前状态：专栏入口与第一期选题已建立；后续可按五条栏目逐篇扩写，而不必再次重做信息架构。