# 上下文片段 · 槽位 · 投影排序（产物与拼装规范）

> 作者与实现共用。用户侧术语见 `ui-glossary.md` §0。  
> 技能撰写契约见 `briefs/capability-authoring-brief.md` §4.7 / §4.9。  
> 真值门控见 `progressive-data-design.md`；拼装见 `context-assembly.md`。

## 1. 问题与分工

创作期不再「发明执行单元清单」，而是产出**可挂载的上下文片段**，再收成固定槽上的运行规格。

| 何时 | 钉什么 | 权威产物 |
|------|--------|----------|
| 中段各技能 | 片段正文 + **挂谁**（mount）+ 可选稳/变 | `设计.*`（`context-fragment.v1`） |
| 游玩拓扑 | **启用哪些固定槽** | `设计.worker规格` → `play_slots` |
| 上下文投影排序（晚） | **扁平投影序**（含「对话.历史」标签） | `设计.上下文投影排序`（`context-order.v1`） |
| 细化终稿 | 合并进运行规格 | `设计.worker集`（含 `play_slots` + `context_order`） |

**挂谁可早、排第几须晚。** 中段禁止写死最终 `order`。

## 2. 固定槽（play_slots）

| 槽键 | 默认 ref | 用户可见 | 默认 |
|------|----------|----------|------|
| `gm` | `world-simulator` | 主世界层 | 开 |
| `narrator` | `narrator` | 叙事转述 | 开 |
| `perspective` | `role-decide` | 角色视角 | 关 |

推荐游玩调度：`perspective? → gm → narrator`。

## 3. 上下文片段：`context-fragment.v1`

公共外壳（**所有上下文创作技能相同**）：

| 段 | 含义 |
|----|------|
| `schema` / `技能` / `brief` / `mount` / `稳变` | 索引与挂载；不写 `order` |
| `正文` | **产物主体**（技能自定内部维度，但必须有「各个方面」） |
| `自评` | **自评评分**（`维度[]` + 可选薄弱点；维度名按技能） |
| `追问` | **导语 + 题目**（建议选项 / 示例）；可无题则 `题目: []` |
| `开放问题` | 未结构化的残项（可选） |

美学步正文：`设定逻辑` + `交互范式` + `美学纲领`（见 `aesthetics-interaction`）。  
实现机制正文：`依据的核心体验` + `支撑点[]` + `支撑点关系[]` + `覆盖检验`（见 `mechanism`）。  
舞台骨架正文：尺度 / 基底与变造 / **社会结构** / **世界状况** / 关键舞台区 / 未展开范围（见 `world-blueprint`）。  
生成规则正文：必要性判断 + `rules[]`（生成与描写 + **单层**产物格式 + 可选多池绑顶层字段）；自评＝必要性/属性妥当/格式准确。  
美学纲领自评仍为：交互范式 / 美学纲领 / 整体协调（勿与生成规则三维混用）。  
叙事指南与故事推进正文：纲领 / 风格与遣词(+示范) / 笔墨焦点 / 禁忌与不偏好 / 情境备用 / 推进与决策 / 内容与表达；自评＝写法可执行/推进可执行/与美学对齐；artifact=`设计.叙事指南与故事推进`。  
正文组成：用户可见块序 + 监控栏锚点 + 隐藏变量段 + 前端拆分意图（非程序报文）；artifact=`设计.正文组成`。  
设计监控栏：只监控会变字段（可含攻略目标/场景交互物）；artifact=`设计.监控栏`（旧称状态栏）。  
变量设计：真值 + **维护语句** + **Data映射索引**（指向具体实例）+ side_effects。  
变量控制上下文：各槽视野 + **旁观汇总**（当前档摘要）。  
开场白与开场变量：开场正文（守正文组成）+ 开场初值；可经 opening-generator 落库。  


具体实例正文：`rule_id` + `records[]`（单层，键随规则）；自评＝合规模（只按规则执行）。  
其它技能换掉正文内块名与自评维度名即可，三段外壳不要拆。
## 4. 投影排序：`context-order.v1`（扁平序）

**不要**再把上下文硬拆成「历史前区 / 历史后区」。排序表就是一条投影流水线：

```text
order 0: worker.persona（fixed）
order 1: 设计.实现机制（summary）
order 2: 对话.历史（summary）     ← 历史本身也是标签
order 3: 变量.当前（fields）
order 4: 用户.最新输入（full）
```

```json
{
  "schema": "context-order.v1",
  "brief": "扁平投影序",
  "play_slots": { "gm": true, "narrator": true, "perspective": false },
  "slots": [
    {
      "ref": "world-simulator",
      "inserts": [
        { "order": 0, "ref": "worker.persona", "projection": "fixed" },
        { "order": 1, "ref": "设计.实现机制", "projection": "summary" },
        { "order": 2, "ref": "对话.历史", "projection": "summary", "note": "按投影裁剪" },
        { "order": 3, "ref": "变量.当前", "projection": "fields" },
        { "order": 4, "ref": "用户.最新输入", "projection": "full" }
      ]
    }
  ]
}
```

| 字段 | 说明 |
|------|------|
| `order` | 每槽独立扁平数字序；**0 建议为人设** |
| `ref` | 黑板 tag、`worker.persona`、或 **`对话.历史`** |
| `projection` | `fixed` \| `full` \| `summary` \| `fields`——对历史标签也生效 |
| `anchor` | **已废弃**；旧表可读，编排 API 的 `set_anchor` 现表示「移到历史标签前/后」 |

### 4.1 `对话.历史` 标签

- 程序在游玩期维护黑板 tag `对话.历史`（用户输入 + 助手可见输出追加）。
- 排序表里出现该 ref 时，按 **projection** 动态裁剪后注入（不是整段永远塞满）。
- 若尚未写入历史，可用 `运行.事件流` + `用户.最新输入` 拼兜底。
- 投影建议：`summary`（默认）/ `fields`（更短）/ `full`（更长）/ `fixed`（几乎不注入）。

### 4.2 拼装

Runtime 按 inserts 数组顺序拼进单条 user 上下文（`assembleWorkerContext` **不再**按 static/dynamic 重排）。  
`tier` 仅作缓存提示（历史标签之前偏 static，之后偏 dynamic）。

### 4.3 可编排

检查器「上下文投影排序 · 可编排」：

- ↑↓ 调整扁平位置  
- 改 projection  
- 「史前 / 史后」：把该项移到 `对话.历史` 之前或之后  

API：`POST /api/sessions/:id/context-order`（`move` / `set_projection` / `set_anchor` / `replace`）。

## 5. 运行规格落点

`设计.worker集` 含 `play_slots` + `context_order`；无表时可由声明合成（含历史标签）。

## 6. UI 渲染

| schema | 友好渲染 |
|--------|----------|
| `context-fragment.v1` | 概要 / 挂载 / 正文 |
| `context-order.v1` | 扁平序表；历史行高亮 |

## 7. 配方链路

```text
体验契约 → 确认槽 → 中段片段（mount）→ 投影排序（含对话.历史）→ 细化终稿
```