🏮 知识库导览 · 客官请进
武林周报 · 卷首语 · 七侠镇刊印 刊印时间:丙午年 · 第 31 周 适用版本:v1.19.0 起 阅读时长:5 分钟
各位客官,这里是什么地方?
「从七侠镇东街走过,同福客栈的招牌底下挂着一块木牌,上头写着四个字:武林周报。不是酒楼,不是客栈,是给江湖里想读点东西的人准备的一份小报。」
本卷是同福客栈挂机游戏对外公开的知识库 / 美术资产库 / 经营档案 / 故事蓝本的集合入口。它不是给开发团队看的工作文档(那份在别处),而是给所有愿意读一读同福客栈这家小店里外故事的人。
你不需要懂代码,也不需要先玩过游戏 — 你可以从这里开始,读一段对白,看一张插画,或者翻一翻掌柜的账本,再决定要不要进去开一局。
一、整本周报怎么读
知识库按"卷 · 章 · 篇"组织,跟真实报纸差不多:
| 层级 | 类比 | 入口 | | --- | --- | --- | | 卷(主题) | 报纸的版面 | 主页的 6 大分类导航 | | 章(文档) | 报纸的具体文章 | 分类页的 235 篇文档 | | 篇(章节) | 文章内部的小节 | 文档右侧的目录 |
整本周报目前收录:
- 235 篇公开文档(本卷:截至 v1.19.0)
- 19 个 HTML 工具页(剧情编辑器、Buff 编辑器、道具编辑器等)
- 21 个标签(剧情、装备、Buff、终局、联机…)
- 165 MB 美术资产(主图、立绘、图标、场景、语音、视频)
- 262 段 Year 1 对白语音(共约 27 分钟)
二、6 大版面 · 想读哪一卷就从哪里进
🎬 卷一 · 剧情角色
想知道同福客栈一年 12 个月里发生了什么?这一卷是剧本原本。
- 主线剧情 · 12 份月度对白稿 + 8 份节气增强版,从月 1 开张适应到月 12 岁末收束
- 角色分支 · 6 位主角 × 5 条人物支线(白展堂官府 / 江湖 / 日常 / 终局 / 黑市;郭芙蓉 / 李大嘴 / 吕秀才 / 莫小贝 / 佟湘玉 / 朱无双各 2-4 条)
- 剧情模拟器 · 2 个 HTML 工具,可按月份与节点浏览剧本
🎯 卷二 · 玩法设计
想知道这游戏怎么玩?这一卷是产品经理留给你的说明书。
- 活跃设计 · 当前正在迭代的玩法(本卷 v1.19.0 起包括:七侠骰坊、后院 M1、Year 1 收束链、关系系统 R-1)
- 完成设计 · 已经收口的设计(联机 P2P 房间骨架、跨周目 v1.1、胜利终局 v1.1、Phase 1 装备系统、Buff 系统)
- 设计 Backlog · 未来可能上、但本卷没拍板的设计(角色羁绊与好感度系统 v1)
- Buff 系统 · 全部 Buff 的设计、配置、优先级与未完成清单
- 技术设计 · 给开发者看的实现细节(玩家可跳)
🎨 卷三 · 美术资源
想看画?这一卷把店里的图、字、音、影全部摊开。
- 美术资产库 v1(本卷新出) · 全部公开美术资源的总览,含启动封面、角色立绘、图标、月度场景、对白语音、启动视频
- 风格指南 · 母场景、母色调、笔触统一规范
- AI 生图 Prompt 库 · 全部 50+ 可直接复制的生图 prompt
📜 卷四 · 发布公告
想看版本号与本期看点?这一卷是历次刊印的发刊词。
- v1.18.0 · 第 22 卷(7/18 刊印) · 联机竞标、装备系统、胜利终局
- v1.19.0 · 第 23 卷(7/28 刊印) · Year 1 收束、厨房 / 骰坊 / 后院 / 剧情语音
- WIKI 部署指南 · 如何把整本周报搬回自家部署
- 知识库增量盘点 v1 / v2 · 周度盘点(本卷新出)
📏 卷五 · 规范
想自己写点什么?这一卷是给作者 / 美术 / 程序的工作守则。
- UI 规范 · 横版 + 竖版 UI 迭代、组件索引、按钮总览
- 数据规范 · 同福数据结构与表
- 工程规范 · bugfix 剧本、代码结构拆分规则
- 工作流规范 · PM Agent 效率、版本计划启动
🛠️ 卷六 · 工具
想动手做点什么?这一卷是开发组用得顺手的工具页。
- 剧情编辑器 / Buff 编辑器 / 道具编辑器 / 任务编辑器
- 剧情故事浏览 / 说书人(剧情朗读)
- Agent 日常流编辑器
三、第一次来同福客栈的人怎么读
如果你只来过一两次,可以按下面的路线读:
- 先看「剧情角色 · 主线剧情 · 第一年主线剧情对白总纲」 — 5 分钟读完,知道 12 个月发生什么
- 再看「美术资源 · 美术资产库 v1」 — 看图听音,看同福客栈长什么样
- 最后翻「玩法设计 · 活跃设计」 — 看现在正在做什么,下一阶段会怎样
如果你是设计同行 / 玩法研究:
- 直接看「产品需求总览 v1」 — 一张表看完全部玩法
- 再翻「胜利终局 v1.1 数值拍板 + 跨周目 v1.1 锚点」 — 看本卷收口的两条主链
- 最后看「Year 1 关键节点体验评分 / 因果矩阵 / 模块打磨总纲」 — 看 7/27 出的三张切片
如果你是开发者 / 想贡献代码:
- 先看仓库根
AGENTS.md— 项目级 AI 协作者守则 - 再看「specs / engineering · 代码结构拆分规则」 — 三层架构原则
- 最后翻「v1.19.0 发布说明 · 工程收口」 — 本卷改了什么
四、本周报怎么"刊印"
整本周报由 scripts/docs-to-html/build.py 自动生成。每篇文档在 docs/ 写好,跑一次脚本就变成 HTML 静态站。无需后端,无需数据库,丢到任何静态托管(Cloudflare Pages、GitHub Pages、Nginx)就上线。
当前已上线地址:https://tongfu-inn-wiki.pages.dev/
离线部署方式见卷四的「WIKI 部署指南」。
五、客官须知
- 本卷记录的是「已经实装 / 已经发布 / 已经画完」的内容。Backlog 与计划中提到的玩法不一定都能在下一版上线,以当期发刊词为准。
- 剧情对白、人物关系、道具数据均已与 v1.19.0 运行时对齐,但语音听感验收未完成(技术验证已通过)。听感未通过期间,部分细节可能与最终版本略有出入。
- 代码 / 资源细节不公开。本卷不收录内部 handoff / 任务调度 / owner 协作记录,那些文档在仓库内部,不在公开站。
- 客官请提意见。发现错误或想加新卷,可在游戏内"系统门厅 → 江湖简报"反馈。
六、下一期预告
- 📅 Year 2 月 20 真值建立(7/27 派工中)
- 📅 听感验收逐条试听(技术验证 100% 通过,听感待人工)
- 📅 关系系统 R-1 玩法层(本卷只交付数据契约 + 静态表)
- 📅 主入口 JS 体积拆包(当前 ~2.48 MB,按功能域拆)
武林周报 · 卷首语 · 完
七侠镇东街 · 同福客栈门口 · 客官请进