游玩呈现壳 · 可微调前端模板

阶段：P1 = 定类与契约；P2 = 程序/样式适配与灌数。
上游：游玩管线 auditor → gm → narrator。
创作挂钩：设计.正文组成 / 设计.监控栏；终稿 tag 通常 输出.用户展示。
创作定位：基于固定壳做适配微调，不是从零设计前端。
预览：/shells.html

1. 创作怎么做（权威口径）

固定壳（本仓库预置，七种）
  → 创作期：选一个 shell_id
  → 只改允许的微调轴（字段、显示名、开关、tone_chrome…）
  → 禁止改分区骨架、禁止发明第八种布局
游玩期：往壳的区域里灌数（present.v1 / 投影 / settlement）

「正文组成」= 壳适配单，不是 UI 创意稿。
用户看见的差异应来自同壳不同绑定，而不是每局一套新布局。

2. 信息层级与长文容量

所有壳共用同一优先级——改壳只是改谁占主面积：

优先级	区域	视觉待遇
P0	`body`	阅读主轴；随字数撑高（单轮按 600~3000 字设计），由页面/消息区滚动
P1	建议行动	要决策时醒目；`choice_dock` 坞 sticky 贴底
P2	`monitor`	芯片密排，高度固定矮
P3	`header` / `footer` / `aside`	辅助；双栏 aside sticky，长文仍可对照

不要把正文塞进固定高度小框再内部硬滚（除非外层消息流另有约束）。
选壳时问：用户 80% 时间是在「读长场面」还是「做选择」还是「对线索」？

3. 七种常用壳

id	中文	主面积给谁	主场景
`prose`	纯散文	正文 ≈ 全屏	只要沉浸、不要 HUD
`chat_monitor`	对话 + 监控	正文（聊天气泡区）	网恋 / 日常 / 轻 AIRP
`spotlight`	场面主视	正文极大（追光）	电影感一幕、少机制
`turn_panel`	回合面板	中栏场面 + 侧栏交互	资源/检定/跑团
`split_board`	双栏看板	左正文 · 右线索	调查、推理
`choice_dock`	选择坞	正文 + 底部大行动坞	选项驱动 / AVG 关口
`chapter_reader`	章节阅读	阅读柱 + 窄进度侧栏	长文 / 爽文

旧规格未写 shell_id → 运行时视为 prose。

3.1 各壳固定槽位

区域 id	prose	chat_monitor	spotlight	turn_panel	split_board	choice_dock	chapter_reader
`monitor`	—	顶栏芯片	顶栏芯片	顶栏	—	可选顶栏	—
`header`	—	—	—	回合号	场景抬头	—	章题
`body`	主	主聊	主舞台	场面	主读	局面	章正文
`footer`	可选弱	可选	可选	检定摘要	可选	可选	作者注
`aside`	—	—	—	交互物	线索栏	—	进度
`hidden`	变量段	变量段	变量段	变量段	变量段	变量段	变量段

3.2 微调轴

轴	说明
`monitor_fields`	监控栏字段子集
`block_labels`	可见块显示名（如 body→「短信」）
`show_suggested_actions`	是否渲染建议行动；`turn_panel` / `choice_dock` 默认开
`tone_chrome`	`default` / `messenger` / `book` / `terminal`
`empty_states`	空态文案

禁止创作期输出完整 CSS；禁止自造 shell_id（要新壳改仓库模板）。

4. 与创作产物的映射

设计.正文组成
  正文.呈现壳.shell_id     → 七选一
  正文.呈现壳.微调         → 只填允许轴
  正文.可见块[]            → 挂到壳已有区域

设计.监控栏 → monitor 字段表
运行.本轮.裁决 → body 事实；suggested_actions → 行动区
输出.用户展示 → present.v1 或纯 Markdown（→ body）

5. 游玩灌数契约

{
  "schema": "present.v1",
  "shell": "spotlight",
  "blocks": {
    "monitor": { "地点": "天桥下", "张力": "紧" },
    "body": "……用户可读正文……"
  },
  "meta": { "suggested_actions": ["先开口", "递伞"] }
}

monitor 宜为 短键值对象（程序渲染成芯片），不要长文。
prose：只需 body 字符串或 Markdown。

6. 创作期只做适配

选壳：按「主面积给谁」（§2）七选一。
微调：字段、显示名、行动开关、tone、空态。
不要：重画分区、发明区域 id、写 CSS。

7. P2 适配清单

序	项	状态
1	`web/` 壳渲染器 + 层级样式	已接 `present-shells.js` + `styles.css`
1b	壳预览页	已接 `/shells.html`
2	正文组成微调进 SessionView	已接
3	present.v1 解析	已接 `present-packet.ts`
4	narrator 按壳输出	已接
5	正文组成产出壳适配单	已接

修订：2026-08-13 · 七壳；明确信息层级与主面积。

5.0 KiB Raw Blame History Unescape Escape