《同福客栈》工具入口统一规范与入口页定义

1. 目标

把 2026-07-01 周内规划里的“工具入口统一”压成一份可直接派发的 first-pass truth source，只覆盖两件事：

1. 项目内 HTML 页统一规范
2. 统一入口页的最小定义

这不是入口页实现任务，也不是页面迁移任务，更不是整站改版任务。

2. 范围边界

• 只收 HTML 页的目录规则、命名规则、标题口径、头部信息结构、返回入口方式、分类标签和最小适配要求。
• 只收统一入口页的最小信息架构与卡片定义。
• 只围绕以下 3 个首批对象：
  • 同福客栈剧情故事.html
  • 同福客栈·说书人.html
  • 闯荡玩法介绍.html
• 不做入口页实现。
• 不做页面迁移。
• 不并入角色属性接线、道具投放接线、第一年主线骨架。

3. 首批对象现状

当前首批对象分散在不同路径，且视觉与结构不统一：

| 当前文件 | 当前 <title> | 当前类型判断 | 现状问题 | | --- | --- | --- | --- | | E:\同福客栈挂机游戏\同福客栈剧情故事.html | 同福客栈 · 主线故事剧本 | 剧情阅读 | 位于项目根目录，长文阅读结构独立，缺统一返回入口 | | E:\同福客栈挂机游戏\同福客栈·说书人.html | 同福客栈 · 说书人 | 工具 | 位于项目根目录，阅读器结构独立，缺统一工具入口关联 | | E:\同福客栈挂机游戏\docs\design\active\闯荡玩法介绍.html | 同福客栈 · 闯荡玩法介绍 | 设计说明 | 位于 docs/design/active/，与项目类 HTML 工具分离 |

4. 统一 HTML 规范

4.1 放置目录

首批项目类 HTML 后续统一收口到 docs/tools/ 这条现有工具根目录下：

• 统一入口页：docs/tools/index.html
• 首批内容页：docs/tools/pages/*.html
• 现有编辑器类工具继续保留在 docs/tools/ 根目录，不在本轮强制迁移

这样处理的原因只有一个：docs/tools/ 已经是仓库内现有 HTML 工具目录，后续接线成本最低。

4.2 页面命名规则

• 文件名统一使用小写 kebab-case 英文，不再继续扩散中文文件名。
• 规则：<domain>-<module>.html
• 首批建议命名：
  • 同福客栈剧情故事.html -> docs/tools/pages/story-overview.html
  • 同福客栈·说书人.html -> docs/tools/pages/storyteller.html
  • 闯荡玩法介绍.html -> docs/tools/pages/adventure-guide.html

命名目标是稳定 URL 与目录组织，不要求本轮立即迁移。

4.3 <title> 口径

统一格式：

同福客栈 · 模块名

首批对应：

• 同福客栈 · 剧情故事
• 同福客栈 · 说书人
• 同福客栈 · 闯荡玩法介绍

页面显示标题允许更完整，但 <title> 统一保持短格式，避免入口页、浏览器标签和分享标题继续分叉。

4.4 页面头部信息结构

每个项目类 HTML 页统一包含以下头部骨架，顺序固定：

1. 返回统一入口的显式按钮/链接
2. 页面分类标签
3. 页面标题
4. 一句用途说明
5. 元信息行

元信息行至少包含：

• 页面类型
• 最后更新时间或版本号
• 当前状态（如 active / reference / archived）

推荐最小示意：

[返回工具入口]
[剧情阅读]
同福客栈 · 剧情故事
用于按月份与节点浏览当前主线故事骨架。
更新：2026-06-29 | 状态：reference

4.5 返回入口方式

• 每个页面顶部必须有显式“返回工具入口”按钮或文本链接。
• 移动端与桌面端都必须在首屏可见，不允许只藏在页尾。
• 返回链接统一指向 docs/tools/index.html。
• 不依赖浏览器后退作为唯一返回方式。

4.6 页面分类标签

首批统一只认 3 个一级分类标签：

• 工具
• 设计说明
• 剧情阅读

首批对象的归类固定为：

| 页面 | 一级分类 | 一句话定位 | | --- | --- | --- | | 同福客栈剧情故事 | 剧情阅读 | 主线剧情总览与节点阅读页 | | 同福客栈·说书人 | 工具 | 面向演出/阅读的剧情展示工具 | | 闯荡玩法介绍 | 设计说明 | 面向玩法理解的说明页 |

如果后续需要更细分，只允许在一级分类下追加一句副描述，不新增第二套标签系统。

4.7 移动端与桌面端最小适配要求

移动端

• 以 360px 宽度为最低可用基线
• 顶部头部信息单列堆叠
• 不允许横向滚动
• 返回入口按钮必须常驻首屏
• 长目录/侧栏必须折叠成顶部抽屉或下拉，不允许保留占宽侧栏

桌面端

• 以 1280px 宽度为桌面基线
• 内容区最大宽度建议控制在 1200px 左右
• 允许侧栏目录，但不能压缩正文到难以阅读
• 统一入口按钮与页面元信息必须在首屏可见

共通要求

• 不因为页面类型不同就放弃统一头部骨架
• 不要求三页视觉完全同肤，但要求结构统一、返回路径统一、分类口径统一

5. 统一入口页最小定义

5.1 路径与角色

• 统一入口页路径：docs/tools/index.html
• 角色：项目内 HTML 工具与内容页的总入口，不承担内容实现

5.2 最小能力

入口页首版只做以下能力：

• 分类浏览
• 卡片式入口
• 每个页面一句说明
• 明确区分 工具 / 设计说明 / 剧情阅读

不做搜索、不做复杂筛选、不做站点化导航树。

5.3 页面信息架构

入口页首版固定为 3 个区块：

1. 工具
2. 设计说明
3. 剧情阅读

每个区块下使用卡片列出页面，卡片最少包含：

• 页面名
• 一级分类标签
• 一句话说明
• 当前状态
• 进入按钮

5.4 首批卡片清单

| 区块 | 页面名 | 一句话说明 | 目标链接 | | --- | --- | --- | --- | | 剧情阅读 | 同福客栈剧情故事 | 浏览主线故事月份、节点与分支骨架 | docs/tools/pages/story-overview.html | | 工具 | 同福客栈·说书人 | 进入剧情演出/朗读工具 | docs/tools/pages/storyteller.html | | 设计说明 | 闯荡玩法介绍 | 阅读闯荡玩法的结构化说明 | docs/tools/pages/adventure-guide.html |

5.5 入口页首屏要求

• 首屏就能看见 3 个分类
• 首屏就能看见至少 3 张首批卡片
• 不做营销式 hero
• 不用解释“这个入口页能做什么”的大段说明，只保留一句项目用途说明

6. 后续派发切分建议

在这份 truth source 之后，PM 可以按下面顺序继续派发，而不用重复分析：

1. 工具入口统一规范
   • 已由本文件收口
2. 统一入口页定义 / 实现
   • 只做 docs/tools/index.html
3. 首批页面迁移
   • 只迁 3 个首批对象
4. 页面统一骨架
   • 给 3 页补统一头部、返回入口与分类口径

7. 明确不做什么

• 不在本轮实现 docs/tools/index.html
• 不在本轮移动现有 3 个 HTML 文件
• 不在本轮统一三页视觉风格
• 不把所有 docs 页面都并入入口页
• 不把剧情编辑器、终局说明、登录流程说明提前并入首批接入

8. 验收口径

完成这份 first-pass 后，应满足：

1. 有一份统一 HTML 规范 truth source
2. 有一份统一入口页的最小定义
3. 首批 3 个对象的分类、命名与目标目录清楚
4. 后续可以直接按“入口页实现 / 页面迁移 / 页面统一骨架”拆 lane