@cyber-dash-tech/revela 0.15.2 → 0.15.4

package/README.zh-CN.md

@@ -17,8 +17,8 @@ Revela 是一个 [OpenCode](https://opencode.ai) 插件，用来把工作区来
 
 ## 它能做什么
 
-- 为 `/revela init`、`/revela story`、`/revela make deck` 等显式命令注入一次性 workflow instructions
-- 只有在显式运行 `/revela make deck` 时，才切换到 deck-render prompt mode
+- 为 `/revela init`、`/revela story`、`/revela make --deck` 等显式命令注入一次性 workflow instructions
+- 只有在显式运行 `/revela make --deck` 时，才切换到 deck-render prompt mode
 - 支持工作区文档扫描，以及 `.pdf`、`.docx`、`.pptx`、`.xlsx` 的透明文本提取和嵌入素材缓存提取
 - 将 `DECKS.json` 作为当前 workspace state engine，持续记录来源材料、调研动作、findings、claims、证据、叙事意图、render targets 和 readiness
 - 先检查 narrative readiness，再用独立 deck/artifact gate 保护 deck HTML 写入
@@ -94,8 +94,8 @@ export { default } from "/absolute/path/to/revela/index.ts";
 
 ```text
 /revela design
-/revela design use summit
-/revela domains deeptech-investment
+/revela design --use summit
+/revela domain --use deeptech-investment
 ```
 
 然后先打磨、调研或检查 story。叙事 ready 并获得批准后，再生成 deck：
@@ -103,32 +103,14 @@ export { default } from "/absolute/path/to/revela/index.ts";
 ```text
 /revela story
 /revela research
-/revela make deck
-```
-
-如果只需要检查写 HTML 前的 deck/artifact gate，使用：
-
-```text
-/revela make deck --review
+/revela make --deck
 ```
 
 需要导出时，可以手动调用，也可以让 agent 直接导出：
 
 ```text
-/revela pdf decks/humanoid-robotics.html
-/revela pptx decks/humanoid-robotics.html
-```
-
-如果希望普通聊天消息在显式命令之间也保持 Revela narrative mode，可以启用可选 ambient mode：
-
-```text
-/revela enable
-```
-
-完成后关闭 ambient mode：
-
-```text
-/revela disable
+/revela export --deck pdf decks/humanoid-robotics.html
+/revela export --deck pptx decks/humanoid-robotics.html
 ```
 
 ---
@@ -136,67 +118,51 @@ export { default } from "/absolute/path/to/revela/index.ts";
 ## 命令
 
 ```text
-/revela                          显示当前状态与帮助
-/revela enable                   可选：让普通聊天保持 ambient narrative mode
-/revela disable                  关闭 ambient Revela mode
+/revela                          show REVELA help
 
 /revela init                     初始化或刷新 narrative workspace state
 /revela research                 调研、绑定证据，并减少 story gaps/caveats
 /revela story                    打开只读 story workspace UI
-/revela make deck                从已批准 story 生成 deck
-/revela make deck --review       写 HTML 前检查 deck/artifact readiness
-/revela make brief [file.md]     从已批准 story 渲染 executive brief
-/revela remember <text>          保存明确的用户/工作流偏好
-/revela refine                   打开统一的阅读、检查和编辑 workspace
-/revela inspect                  deprecated，兼容到 /revela refine Inspect mode
-
-/revela review                   legacy story readiness report
-/revela narrative                兼容别名，等同 /revela story
-/revela deck                     兼容别名，等同 /revela make deck
-/revela brief [file.md]          兼容别名，等同 /revela make brief
+/revela make --deck              从已批准 story 生成 deck
+/revela make --brief [file.md]   从已批准 story 渲染 executive brief
+/revela review --deck            打开统一的 deck 阅读、洞察和评论 workspace
+/revela export --deck pdf [file] 将 HTML deck 导出为同目录 PDF
+/revela export --deck pptx [file] [--notes] 将 HTML deck 导出为可编辑 PPTX
 
 /revela design                   列出已安装 design
-/revela design use <name>        激活某个 design
-/revela design new <name>        通过 AI 创建一个自定义 design
-/revela design edit <name>       通过 AI 调整已有自定义 design
-/revela design preview [name]    在浏览器中打开 design preview
-/revela design add <source>      从 URL、本地路径或 github:user/repo 安装 design
-/revela design rm <name>         删除已安装 design
-/revela designs                  列出已安装 design
-/revela designs <name>           激活某个 design
-/revela designs-new <name>       通过 AI 创建一个自定义 design
-/revela designs-edit <name>      通过 AI 调整已有自定义 design
-/revela designs-preview [name]   在浏览器中打开 design preview
-/revela designs-add <source>     从 URL、本地路径或 github:user/repo 安装 design
-/revela designs-rm <name>        删除已安装 design
-
-/revela domains                  列出已安装 domain
-/revela domains <name>           激活某个 domain
-/revela domains-add <source>     从 URL、本地路径或 github:user/repo 安装 domain
-/revela domains-rm <name>        删除已安装 domain
-
-/revela pdf <file>               将 HTML deck 导出为同目录 PDF
-/revela pptx <file>              将 HTML deck 导出为同目录可编辑 PPTX
+/revela design --use <name>      激活某个 design
+/revela design --new <name>      通过 AI 创建一个自定义 design
+/revela design --edit <name>     通过 AI 调整已有自定义 design
+/revela design --preview [name]  在浏览器中打开 design preview
+/revela design --add <source>    从 URL、本地路径或 github:user/repo 安装 design
+/revela design --rm <name>       删除已安装 design
+
+/revela domain                   列出已安装 domain
+/revela domain --use <name>      激活某个 domain
+/revela domain --add <source>    从 URL、本地路径或 github:user/repo 安装 domain
+/revela domain --rm <name>       删除已安装 domain
 ```
 
-大多数 `/revela` 命令都在本地执行，不消耗 LLM token。`/revela init`、`/revela research`、`/revela story`、`/revela review`、`/revela make deck`、`/revela remember`、`/revela design new` 和 `/revela design edit` 会启动 AI 辅助流程，因为它们需要读取或更新项目状态。这些 workflow command 只在可见聊天里显示短意图，详细内部说明通过一次性的 system-prompt command intent 注入。`/revela refine` 是统一的 post-artifact workspace，会打开一个本地浏览器 workspace，里面有 Edit 和 Inspect 两个 tab，并共享同一套 Cmd/Ctrl-click 元素引用。Edit 会把精准修改评论发回当前 OpenCode 会话；Inspect 会把 grounded selection context 发给当前 OpenCode 会话，并渲染本地化的 Narrative Reading、Exploratory Reading、Source、Purpose 卡片。确定性预处理保留为 fallback context，而不是默认先展示的 UI。如果生成结果缺少较新的 reading 卡片，Refine 会保留确定性 Narrative Reading 和 Exploratory Reading，而不是丢掉这些上下文。Narrative Reading 还会显示所选 canonical claim 的 artifact coverage，包括每个已记录 artifact 是否包含该 claim，以及 coverage 是 current、stale、partial 还是 missing。Exploratory Reading 明确是非官方阅读辅助，只能基于已记录 claim、evidence、caveat、objection、risk 和 artifact coverage。它没有聊天框，也不会修改 deck。`/revela edit` 已移除；请使用 `/revela refine`。`/revela inspect` 仅作为 deprecated 兼容入口保留。
+大多数 `/revela` 命令都在本地执行，不消耗 LLM token。`/revela init`、`/revela research`、`/revela story`、`/revela make --deck`、`/revela design --new`、`/revela design --edit` 和 `/revela export --deck pptx --notes` 会启动 AI 辅助流程，因为它们需要读取或更新项目状态。这些 workflow command 只在可见聊天里显示短意图，详细内部说明通过一次性的 system-prompt command intent 注入。`/revela review --deck` 是统一的 post-artifact workspace，会打开一个本地浏览器 workspace，里面有 Comment 和 Insight 两个 tab，并共享同一套 Cmd/Ctrl-click 元素引用。Comment 会把精准修改评论发回当前 OpenCode 会话；Insight 会把 grounded selection context 发给当前 OpenCode 会话，并渲染本地化的 Narrative Reading、Exploratory Reading、Source、Purpose 卡片。确定性预处理保留为 fallback context，而不是默认先展示的 UI。如果生成结果缺少较新的 reading 卡片，Review 会保留确定性 Narrative Reading 和 Exploratory Reading，而不是丢掉这些上下文。Narrative Reading 还会显示所选 canonical claim 的 artifact coverage，包括每个已记录 artifact 是否包含该 claim，以及 coverage 是 current、stale、partial 还是 missing。Exploratory Reading 明确是非官方阅读辅助，只能基于已记录 claim、evidence、caveat、objection、risk 和 artifact coverage。它没有聊天框，也不会修改 deck。`/revela edit` 和 `/revela inspect` 不再是公开命令；请使用 `/revela review --deck`。`/revela refine --deck` 仍作为兼容 alias 保留。
 
 ---
 
 ## 工作原理
 
-显式 Revela workflow command 会把一次性 command instructions 追加到当前 agent 的 system prompt 中。`/revela enable` 是可选 ambient mode，用于让显式命令之间的普通聊天也保持 Revela narrative mode。
+显式 Revela workflow command 会把一次性 command instructions 追加到当前 agent 的 system prompt 中。你不需要先运行 ambient enable/disable；公开入口都在 `/revela` help 中列出。
 
-默认 prompt 是 narrative-first：它遵循 `Init -> Research -> Story -> Make -> Refine`，关注受众信念变化、decision/action、thesis、claims、证据边界、objections、risks、research gaps 和 approval。Active design CSS、layout catalog、component index、chart rules 和 deck HTML skeleton 在 `/revela make deck` 切换到 deck-render mode 或 `/revela design` 进入显式设计工作流前不会注入。
+默认 prompt 是 narrative-first：它遵循 `Init -> Research -> Story -> Make -> Review -> Export`，关注受众信念变化、decision/action、thesis、claims、证据边界、objections、risks、research gaps 和 approval。Active design CSS、layout catalog、component index、chart rules 和 deck HTML skeleton 在 `/revela make --deck` 切换到 deck-render mode 或 `/revela design` 进入显式设计工作流前不会注入。
 
-Deck-render mode 由 3 层组成：
+Deck-render mode 由 2 层组成：
 
 1. `skill/SKILL.md` - 核心 deck-render 流程
-2. 当前 active domain - 行业结构与术语
-3. 当前 active design - 视觉系统、layout、component 和图表规则
+2. 当前 active design - 视觉系统、layout、component 和图表规则
+
+Active domain 只进入 narrative pipeline。它帮助 `init`、`research`、`story`
+形成 canonical narrative；`make --deck` 只渲染已批准的 narrative，不再重复注入完整 domain prompt。
 
 持久化配置保存在 `~/.config/revela/config.json`。
-ambient enable/disable 状态只在当前会话生效。
+显式 workflow command 会自动选择 narrative 或 deck-render prompt mode。
 
 ### Workspace State
 
@@ -210,7 +176,7 @@ ambient enable/disable 状态只在当前会话生效。
 - active HTML deck 以及派生 PDF、PPTX 等 render targets
 - 带 input hash 的 review snapshots，使重要状态变化后旧的 readiness 自动变 stale
 
-已有的根目录 `DECKS.json` 工作区继续兼容。对旧项目运行 `/revela init` 或 `/revela review` 时，可以安全 normalize canonical narrative state 并刷新 projection 字段；用户不需要手动迁移、不需要移动文件，也不需要把 `DECKS.json` 换成数据库。`writeReadiness.status: "ready"` 只代表 deck/artifact readiness，永远不等于 narrative approval。
+已有的根目录 `DECKS.json` 工作区继续兼容。对旧项目运行 `/revela init` 或 `/revela story` 时，可以安全 normalize canonical narrative state 并刷新 projection 字段；用户不需要手动迁移、不需要移动文件，也不需要把 `DECKS.json` 换成数据库。`writeReadiness.status: "ready"` 只代表 deck/artifact readiness，永远不等于 narrative approval。
 
 Deck 仍然是主要 authored artifact，但现在它是从同一份 workspace state 渲染出来的目标之一。后续 briefs、appendix material、Evidence Inspector views、Q&A 和 interactive reading layers 都可以复用同一套来源/证据逻辑，而不是各自生成孤立内容。
 
@@ -224,26 +190,18 @@ Deck 仍然是主要 authored artifact，但现在它是从同一份 workspace s
 2. 如果 story gaps 或 unsupported central claims 需要外部证据，用 `/revela research` 定向调研；它应循环执行 research、证据绑定、claim/relation 收窄和 re-review，直到公开调研无法继续改善状态。
 3. 用 `/revela story` 打开 story workspace UI，查看 claim flow、证据、caveats、research gaps、approval state 和 artifact coverage。
 4. 批准 narrative 或要求修改。如果需要在完整战略批准前渲染，必须记录 explicit render override。
-5. 运行 `/revela make deck`，把已批准 narrative 编译成 deck slide specs 并进入 deck-render mode，或运行 `/revela make brief` 渲染 executive brief。
-6. 只在 deck handoff 阶段选择或确认 design，然后通过 handoff workflow 或 `/revela make deck --review` 运行 deck/artifact gate。
+5. 运行 `/revela make --deck`，把已批准 narrative 编译成 deck slide specs 并进入 deck-render mode，或运行 `/revela make --brief` 渲染 executive brief。
+6. 只在 deck handoff 阶段选择或确认 design；`/revela make --deck` 会在 deck plan 确认后运行 deck/artifact gate。
 7. 只有 artifact gate ready 后，才让 agent 把 HTML deck 写到 `decks/` 下。
-8. 用 `/revela refine` 对选中 deck 元素做可视化评论、精准修改、只读 Narrative Reading、有边界的 Exploratory Reading、Source、Purpose 检查，以及 claim-to-artifact coverage 查看。
-9. post-artifact 修改统一使用 `/revela refine`；`/revela edit` 已移除，`/revela inspect` 仅保留给旧脚本或旧习惯。
-10. 用 `/revela pdf <file>` 或 `/revela pptx <file>` 导出。
-
-只有当你希望普通聊天消息，而不只是显式 `/revela ...` 命令，也保持 Revela narrative mode 时，才需要使用 `/revela enable`。
+8. 用 `/revela review --deck` 对选中 deck 元素做可视化评论、精准修改、只读 Narrative Reading、有边界的 Exploratory Reading、Source、Purpose 洞察，以及 claim-to-artifact coverage 查看。
+9. post-artifact 修改统一使用 `/revela review --deck`；`/revela edit` 和 `/revela inspect` 不再是公开命令。
+10. 用 `/revela export --deck pdf <file>` 或 `/revela export --deck pptx <file>` 导出。
 
-`/revela story` 打开只读 story workspace UI。`/revela review` 生成 legacy readiness report，用于检查受众不清、缺信念变化、缺 decision/action、thesis 弱、central claims 无证据、evidence 弱、unsupported scope、objection 未处理、缺风险/假设处理、approval stale 或缺 approval。两者都不检查 design/layout readiness，也不会写最终 deck。
+普通聊天不需要 ambient command。需要 Revela 工作流时，直接运行对应的 `/revela ...` 显式命令。
 
-如果 Revela 阻止写入 deck，直接让 agent 运行 `/revela make deck --review`，根据报告补齐 artifact 缺口后再写。这样可以避免在 slide specs、evidence projection、design/layout readiness、review snapshot 和 deck HTML contract 还不完整时覆盖真实 deck 文件。
-
-记住长期偏好请使用：
-
-```text
-/revela remember 我偏好中文、咨询风格、每页只表达一个核心观点。
-```
+`/revela story` 打开只读 story workspace UI，用于检查受众不清、缺信念变化、缺 decision/action、thesis 弱、central claims 无证据、evidence 弱、unsupported scope、objection 未处理、缺风险/假设处理、approval stale 或缺 approval。它不检查 design/layout readiness，也不会写最终 deck。
 
-不要用 `remember` 保存临时 checklist 状态；它只适合保存长期用户偏好或工作流偏好。
+如果 Revela 阻止写入 deck，直接让 agent 继续 `/revela make --deck`，根据报告补齐 artifact 缺口后再写。这样可以避免在 slide specs、evidence projection、design/layout readiness、review snapshot 和 deck HTML contract 还不完整时覆盖真实 deck 文件。
 
 ---
 
@@ -295,7 +253,7 @@ Deck 仍然是主要 authored artifact，但现在它是从同一份 workspace s
 
 ## Designs 与 Domains
 
-用 `/revela design` 和 `/revela domains` 查看你当前环境里实际安装的内容。旧的 `/revela designs*` 命令仍作为兼容别名保留。
+用 `/revela design` 和 `/revela domain` 查看你当前环境里实际安装的内容。旧的 `/revela designs*` 和 `/revela domains*` 命令只显示迁移帮助，不再执行旧行为。
 
 仓库内置的 domains：
 
@@ -322,8 +280,7 @@ Deck 仍然是主要 authored artifact，但现在它是从同一份 workspace s
 你也可以让 Revela 交互式创建一个新的本地 design：
 
 ```text
-/revela designs-new my-design
-/revela design new my-design
+/revela design --new my-design
 ```
 
 Agent 会先询问你的审美参考，整理设计 brief 并等待确认，然后把 `DESIGN.md` 和 `preview.html` 保存到本地 Revela designs 目录。对 AI 生成的 design，`preview.html` 是必需验收面：它必须包含 cover 和 closing 页，并且必须展示所有 `@component:*`，否则 `revela-designs-author` 不会接受这个包。默认结构底座是内部中性 `starter` design，它不会出现在普通 design 列表中。只有当你明确想从 `summit` 或 `monet` 的具体风格派生时，才建议使用 `--base summit` 或 `--base monet`。
@@ -331,8 +288,7 @@ Agent 会先询问你的审美参考，整理设计 brief 并等待确认，然
 调整已有本地 design：
 
 ```text
-/revela designs-edit my-design
-/revela design edit my-design
+/revela design --edit my-design
 ```
 
 Agent 会询问你想修改什么，读取当前 design，整理 edit brief 并等待确认，然后通过受控 authoring tool 覆盖保存本地 design 包。
@@ -340,8 +296,7 @@ Agent 会询问你想修改什么，读取当前 design，整理 edit brief 并
 在浏览器中打开某个 design 的 preview：
 
 ```text
-/revela designs-preview my-design
-/revela design preview my-design
+/revela design --preview my-design
 ```
 
 省略 name 时会打开当前 active design 的 preview。如果该 design 没有 `preview.html`，Revela 会提示没有可用 preview。
@@ -548,9 +503,9 @@ Prompt 注入规则：
 安装自定义 design：
 
 ```text
-/revela design add github:your-org/your-design
-/revela design add https://example.com/my-design.zip
-/revela design add ./path/to/local/design-folder
+/revela design --add github:your-org/your-design
+/revela design --add https://example.com/my-design.zip
+/revela design --add ./path/to/local/design-folder
 ```
 
 ---
@@ -560,7 +515,7 @@ Prompt 注入规则：
 自定义 domain 是一个包含 `INDUSTRY.md` 的文件夹。
 
 ```text
-/revela domains-add github:your-org/your-domain
+/revela domain --add github:your-org/your-domain
 ```
 
 `INDUSTRY.md` 是为兼容历史版本保留的文件名。
@@ -572,10 +527,10 @@ Prompt 注入规则：
 正常的写后 review 和修改建议使用统一 refinement workspace：
 
 ```text
-/revela refine
+/revela review --deck
 ```
 
-`/revela refine` 会打开 active HTML deck，并提供两个 tab。使用 `Ctrl`/`Cmd` + click 先引用 deck 元素，然后在 Edit 里快速写自然语言修改评论，或在 Inspect 里做只读 Narrative Reading、有边界的 Exploratory Reading、Source、Purpose 和 artifact coverage 检查。Inspect 不会修改 deck；真正的 mutation 仍然只走 Edit。这是 post-artifact 阅读、检查和编辑的推荐入口。
+`/revela review --deck` 会打开 active HTML deck，并提供两个 tab。使用 `Ctrl`/`Cmd` + click 先引用 deck 元素，然后在 Comment 里快速写自然语言修改评论，或在 Insight 里做只读 Narrative Reading、有边界的 Exploratory Reading、Source、Purpose 和 artifact coverage 检查。Insight 不会修改 deck；真正的 mutation 仍然只走 Comment。这是 post-artifact 阅读、洞察和评论的推荐入口。
 
 已移除命令：
 
@@ -583,29 +538,29 @@ Prompt 注入规则：
 /revela edit
 ```
 
-`/revela edit` 已移除。请使用 `/revela refine` 打开统一的阅读、检查和编辑 workspace。
+`/revela edit` 已移除。请使用 `/revela review --deck` 打开统一的阅读、洞察和评论 workspace。
 
-使用 `Ctrl`/`Cmd` + 点击 deck 元素来引用它们，在 Edit tab 写一段自然语言评论，然后发送回 OpenCode。Revela 会把 deck 文件、slide 上下文、选中元素 metadata 和你的评论整理成结构化 edit prompt。
+使用 `Ctrl`/`Cmd` + 点击 deck 元素来引用它们，在 Comment tab 写一段自然语言评论，然后发送回 OpenCode。Revela 会把 deck 文件、slide 上下文、选中元素 metadata 和你的评论整理成结构化 edit prompt。
 
-对应的 LLM tool：`revela-edit`，不需要 target。这个 tool 仍作为兼容入口保留，当你说“我要编辑这个 deck”时，agent 会打开 Refine 的 Edit mode。
+对应的 LLM tool：`revela-edit`，不需要 target。这个 tool 仍作为兼容入口保留，当你说“我要编辑这个 deck”时，agent 会打开 Review 的 Comment mode。
 
-对于已有 HTML deck，`/revela refine` 会自动准备必要的最小项目上下文，让后续精准修改仍然经过正常安全检查。
+对于已有 HTML deck，`/revela review --deck` 会自动准备必要的最小项目上下文，让后续精准修改仍然经过正常安全检查。
 
 ---
 
 ## Evidence Inspector
 
-用 `/revela refine` 做 evidence inspection 和 narrative reading。Deprecated 兼容命令：
+用 `/revela review --deck` 做 evidence insight 和 narrative reading。已移除的兼容命令：
 
 ```text
 /revela inspect
 ```
 
-`/revela inspect` 不再打开独立 inspector shell。它会打开 `/revela refine` 的 Inspect mode。Inspect tab 会在固定 Source 和 Purpose 卡片之外显示 Narrative Reading 和 Exploratory Reading 卡片。当选中元素能映射到 canonical narrative state 时，Narrative Reading 会保留 canonical claim id、evidence binding id、supported scope、unsupported scope、caveat、objection、risk 和 artifact coverage。Coverage 会显示所选 claim 是否出现在已记录的 deck/brief/export artifact 中，以及这些 artifact 相对当前 narrative hash 是 current、stale、partial 还是 missing。Exploratory Reading 提供非官方的 objection prep、audience reframing 边界、appendix leads 和 meeting-prep cues，并且只能使用同一份已记录 context。使用 `Ctrl`/`Cmd` + click 引用 deck 元素，然后点击 `Inspect Selection`。请求处理期间，deck 选择会被锁定。
+`/revela inspect` 不再打开独立 inspector shell。请使用 `/revela review --deck` 的 Insight tab。Insight tab 会在固定 Source 和 Purpose 卡片之外显示 Narrative Reading 和 Exploratory Reading 卡片。当选中元素能映射到 canonical narrative state 时，Narrative Reading 会保留 canonical claim id、evidence binding id、supported scope、unsupported scope、caveat、objection、risk 和 artifact coverage。Coverage 会显示所选 claim 是否出现在已记录的 deck/brief/export artifact 中，以及这些 artifact 相对当前 narrative hash 是 current、stale、partial 还是 missing。Exploratory Reading 提供非官方的 objection prep、audience reframing 边界、appendix leads 和 meeting-prep cues，并且只能使用同一份已记录 context。使用 `Ctrl`/`Cmd` + click 引用 deck 元素，然后点击 `Get Insight`。请求处理期间，deck 选择会被锁定。
 
-Inspector 不是聊天，也没有自由输入框。它不会修改 `DECKS.json` 或 deck HTML。它使用已记录的 slide spec、narrative state 和 slide-level evidence trace 作为 grounded context。Inspect 的用户界面是 LLM-first：先显示 reading/loading 状态，再渲染结构化生成卡片。确定性预处理仍作为内部 fallback context，仅在生成失败或超时时显示。Inspect tab 提供固定 display-language 下拉选项；语言只影响卡片文案，不会改变 claim id、evidence id、source path、URL、数字、引用或 canonical facts。如果旧版或不完整的生成结果只返回 Source/Purpose，Refine 会保留确定性 reading 卡片，避免 generated inspection 静默移除 claim、evidence boundary、artifact coverage 或 exploratory context。
+Insight 不是聊天，也没有自由输入框。它不会修改 `DECKS.json` 或 deck HTML。它使用已记录的 slide spec、narrative state 和 slide-level evidence trace 作为 grounded context。Insight 的用户界面是 LLM-first：先显示 reading/loading 状态，再渲染结构化生成卡片。确定性预处理仍作为内部 fallback context，仅在生成失败或超时时显示。Insight tab 提供固定 display-language 下拉选项；语言只影响卡片文案，不会改变 claim id、evidence id、source path、URL、数字、引用或 canonical facts。如果旧版或不完整的生成结果只返回 Source/Purpose，Review 会保留确定性 reading 卡片，避免 generated insight 静默移除 claim、evidence boundary、artifact coverage 或 exploratory context。
 
-Refine 会使用 workspace state 中记录的 active HTML deck render target。Deck HTML 必须满足 Revela 的 slide identity contract：active artifact 中每个 `<section class="slide">` 都需要有正数、1-based 的 `data-slide-index`，并且要匹配当前 slide specs。无效的 active artifact 会在 refine/export 工作流信任它之前被拒绝或报告。
+Review 会使用 workspace state 中记录的 active HTML deck render target。Deck HTML 必须满足 Revela 的 slide identity contract：active artifact 中每个 `<section class="slide">` 都需要有正数、1-based 的 `data-slide-index`，并且要匹配当前 slide specs。无效的 active artifact 会在 review/export 工作流信任它之前被拒绝或报告。
 
 ---
 
@@ -614,7 +569,7 @@ Refine 会使用 workspace state 中记录的 active HTML deck render target。D
 PDF 导出：
 
 ```text
-/revela pdf decks/my-deck.html
+/revela export --deck pdf decks/my-deck.html
 ```
 
 对应的 LLM tool：`revela-pdf`，参数为 `{ "file": "decks/my-deck.html" }`。
@@ -622,12 +577,12 @@ PDF 导出：
 可编辑 PPTX 导出：
 
 ```text
-/revela pptx decks/my-deck.html
+/revela export --deck pptx decks/my-deck.html
 ```
 
 对应的 LLM tool：`revela-pptx`，参数为 `{ "file": "decks/my-deck.html" }`。
 
-命令和 tool 都会把结果写到源 HTML deck 同目录。如果希望 agent 在 deck 工作流中自动完成导出，可以让它调用 tool，而不需要用户手动执行 `/revela pdf` 或 `/revela pptx`。
+命令和 tool 都会把结果写到源 HTML deck 同目录。如果希望 agent 在 deck 工作流中自动完成导出，可以让它调用 tool，而不需要用户手动执行 `/revela export --deck pdf` 或 `/revela export --deck pptx`。
 
 ---
 

package/designs/starter/DESIGN.md

@@ -32,8 +32,8 @@ Starter is the neutral structural base for generating new Revela designs. It sho
     --accent-soft: #dbeafe;
     --accent-danger: #dc2626;
     --shadow-soft: rgba(15, 23, 42, 0.16);
-    --font-display: 'Inter', ui-sans-serif, sans-serif;
-    --font-body: 'Inter', ui-sans-serif, sans-serif;
+    --font-display: 'Montserrat', ui-sans-serif, sans-serif;
+    --font-body: 'Montserrat', ui-sans-serif, sans-serif;
     --font-size-body: 17px;
     --font-size-meta: 12px;
     --font-size-body-strong: 20px;
@@ -48,13 +48,13 @@ Accent usage guidance:
 
 ### Typography
 
-- **Display / heading font**: `Inter` — neutral sans-serif base for all headings and display text
-- **Body font**: `Inter` — neutral sans-serif base for copy, captions, labels, and UI text
+- **Display / heading font**: `Montserrat` — geometric sans-serif base for all headings and display text
+- **Body font**: `Montserrat` — geometric sans-serif base for copy, captions, labels, and UI text
 - Font link tag:
   ```html
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap" rel="stylesheet">
+  <link href="https://fonts.googleapis.com/css2?family=Montserrat:wght@300;400;500;600;700;800&display=swap" rel="stylesheet">
   ```
 - cover h1: `88px` to `116px`, weight `700` to `800`, line-height `0.92` to `1.0`
 - inner-layout h2: `34px` to `56px`, weight `650` to `800`, line-height `1.02` to `1.12`
@@ -114,7 +114,7 @@ Every generated presentation must use this exact HTML skeleton:
     <title>{Presentation Title}</title>
     <link rel="preconnect" href="https://fonts.googleapis.com">
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap" rel="stylesheet">
+    <link href="https://fonts.googleapis.com/css2?family=Montserrat:wght@300;400;500;600;700;800&display=swap" rel="stylesheet">
     <!-- <script src="https://cdn.jsdelivr.net/npm/echarts@5/dist/echarts.min.js"></script> only if charts are needed -->
     <style>/* all CSS here */</style>
 </head>
@@ -655,17 +655,36 @@ Full-bleed cover, section divider, closing, or strong visual statement with opti
 Table of contents or section index.
 
 ```html
-<div class="toc-panel"><div class="toc-panel-inner"><div class="toc-header"><p class="eyebrow">Contents</p><h2>Agenda</h2></div><div class="toc-list"><div class="toc-item"><span>01</span><strong>Section title</strong><em>03</em></div></div></div></div>
+<div class="toc-panel">
+  <div class="toc-panel-inner">
+    <div class="toc-header">
+      <h2>Table of<br>Contents</h2>
+      <p class="toc-note">Brief context note describing the scope of the sections that follow.</p>
+      <p class="toc-footer">Creative-Curious-Cooperation</p>
+    </div>
+    <ol class="toc-list">
+      <li class="toc-item"><span>01</span><strong>The vision of a changing world</strong></li>
+      <li class="toc-item"><span>02</span><strong>Smart home solutions</strong></li>
+      <li class="toc-item"><span>03</span><strong>Smart city innovations</strong></li>
+      <li class="toc-item"><span>04</span><strong>Smart office revolution</strong></li>
+      <li class="toc-item"><span>05</span><strong>Wearable technology</strong></li>
+      <li class="toc-item"><span>06</span><strong>The future of connected work</strong></li>
+    </ol>
+  </div>
+</div>
 ```
 
 ```css
-.toc-panel { height: 100%; padding: 54px 52px 42px; display: flex; overflow: hidden; background: var(--bg-page); }
-.toc-panel-inner { display: flex; flex-direction: column; justify-content: space-between; width: 100%; gap: 32px; }
-.toc-header { max-width: 620px; display: flex; flex-direction: column; gap: 18px; }
-.toc-list { display: flex; flex-direction: column; border-top: 1px solid var(--line-strong); }
-.toc-item { display: grid; grid-template-columns: 70px 1fr 60px; gap: 24px; align-items: baseline; padding: 22px 0; border-bottom: 1px solid var(--line); }
-.toc-item span, .toc-item em { font-style: normal; color: var(--text-muted); font-size: 12px; letter-spacing: 0.14em; text-transform: uppercase; }
-.toc-item strong { font-size: 28px; line-height: 1.08; color: var(--text-primary); }
+.toc-panel { height: 100%; padding: 86px 118px 58px; display: flex; overflow: hidden; background: var(--bg-page); }
+.toc-panel-inner { width: 100%; display: grid; grid-template-columns: 37% 1fr; align-items: stretch; gap: 76px; }
+.toc-header { display: flex; flex-direction: column; min-height: 100%; }
+.toc-header h2 { margin-top: 32px; max-width: 360px; font-size: 46px; line-height: 1.04; letter-spacing: 0.02em; text-transform: uppercase; font-weight: 650; }
+.toc-note { margin-top: 230px; margin-bottom: 0; max-width: 300px; font-size: 14px; line-height: 1.7; letter-spacing: 0.02em; color: var(--text-muted); }
+.toc-footer { margin-top: auto; font-size: 11px; line-height: 1.4; letter-spacing: 0.08em; text-transform: uppercase; font-weight: 750; color: var(--text-primary); }
+.toc-list { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; justify-content: center; gap: 42px; height: 100%; }
+.toc-item { display: grid; grid-template-columns: 80px 1fr; gap: 44px; align-items: center; }
+.toc-item span { font-style: normal; font-family: var(--font-display); font-size: 42px; line-height: 1; letter-spacing: 0.03em; color: var(--text-primary); font-variant-numeric: tabular-nums; }
+.toc-item strong { font-size: 17px; line-height: 1.35; letter-spacing: 0.12em; text-transform: uppercase; font-weight: 500; color: var(--text-primary); }
 ```
 <!-- @component:toc:end -->
 

package/designs/starter/preview.html

@@ -6,7 +6,7 @@
   <title>Starter Design System — Preview</title>
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap" rel="stylesheet">
+  <link href="https://fonts.googleapis.com/css2?family=Montserrat:wght@300;400;500;600;700;800&display=swap" rel="stylesheet">
   <script src="https://cdn.jsdelivr.net/npm/echarts@5/dist/echarts.min.js"></script>
   <style>
     :root {
@@ -25,8 +25,8 @@
       --accent-soft: #dbeafe;
       --accent-danger: #dc2626;
       --shadow-soft: rgba(15, 23, 42, 0.16);
-      --font-display: 'Inter', ui-sans-serif, sans-serif;
-      --font-body: 'Inter', ui-sans-serif, sans-serif;
+      --font-display: 'Montserrat', ui-sans-serif, sans-serif;
+      --font-body: 'Montserrat', ui-sans-serif, sans-serif;
       --font-size-body: 17px;
       --font-size-meta: 12px;
     }
@@ -124,13 +124,16 @@
     .image-title h1 { color: #f8fafc; font-size: 104px; line-height: 0.92; letter-spacing: -0.055em; }
     .image-title-eyebrow { font-size: 12px; font-weight: 800; letter-spacing: 0.18em; text-transform: uppercase; color: rgba(248,250,252,0.62); margin-bottom: 20px; }
     .image-title-subtitle { margin-top: 24px; font-size: 18px; line-height: 1.56; color: rgba(248,250,252,0.78); max-width: 520px; }
-    .toc-panel { height: 100%; padding: 54px 52px 42px; display: flex; overflow: hidden; background: var(--bg-page); }
-    .toc-panel-inner { display: flex; flex-direction: column; justify-content: space-between; width: 100%; gap: 32px; }
-    .toc-header { max-width: 620px; display: flex; flex-direction: column; gap: 18px; }
-    .toc-list { display: flex; flex-direction: column; border-top: 1px solid var(--line-strong); }
-    .toc-item { display: grid; grid-template-columns: 70px 1fr 60px; gap: 24px; align-items: baseline; padding: 22px 0; border-bottom: 1px solid var(--line); }
-    .toc-item span, .toc-item em { font-style: normal; color: var(--text-muted); font-size: 12px; letter-spacing: 0.14em; text-transform: uppercase; }
-    .toc-item strong { font-size: 28px; line-height: 1.08; color: var(--text-primary); }
+    .toc-panel { height: 100%; padding: 86px 118px 58px; display: flex; overflow: hidden; background: var(--bg-page); }
+    .toc-panel-inner { width: 100%; display: grid; grid-template-columns: 37% 1fr; align-items: stretch; gap: 76px; }
+    .toc-header { display: flex; flex-direction: column; min-height: 100%; }
+    .toc-header h2 { margin-top: 32px; max-width: 360px; font-size: 46px; line-height: 1.04; letter-spacing: 0.02em; text-transform: uppercase; font-weight: 650; }
+    .toc-note { margin-top: 230px; margin-bottom: 0; max-width: 300px; font-size: 14px; line-height: 1.7; letter-spacing: 0.02em; color: var(--text-muted); }
+    .toc-footer { margin-top: auto; font-size: 11px; line-height: 1.4; letter-spacing: 0.08em; text-transform: uppercase; font-weight: 750; color: var(--text-primary); }
+    .toc-list { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; justify-content: center; gap: 42px; height: 100%; }
+    .toc-item { display: grid; grid-template-columns: 80px 1fr; gap: 44px; align-items: center; }
+    .toc-item span { font-style: normal; font-family: var(--font-display); font-size: 42px; line-height: 1; letter-spacing: 0.03em; color: var(--text-primary); font-variant-numeric: tabular-nums; }
+    .toc-item strong { font-size: 17px; line-height: 1.35; letter-spacing: 0.12em; text-transform: uppercase; font-weight: 500; color: var(--text-primary); }
     .quote-block { height: 100%; display: flex; flex-direction: column; justify-content: center; gap: 24px; max-width: 980px; }
     .quote-mark { font-size: 96px; line-height: 0.7; color: var(--accent-primary); }
     .quote-block blockquote { font-family: var(--font-display); font-size: 54px; line-height: 1.06; letter-spacing: -0.04em; color: var(--text-primary); }
@@ -204,13 +207,17 @@
       <div class="page" style="padding:0;">
         <div class="toc-panel">
           <div class="toc-panel-inner">
-            <div class="toc-header reveal"><p class="eyebrow">Contents</p><h2>Core primitives for derived themes</h2><p>Starter preview demonstrates structure, not a fixed aesthetic.</p></div>
-            <div class="toc-list reveal">
-              <div class="toc-item"><span>01</span><strong>Foundation and visual schema</strong><em>03</em></div>
-              <div class="toc-item"><span>02</span><strong>Layouts and content modules</strong><em>04</em></div>
-              <div class="toc-item"><span>03</span><strong>Data, flow, and evidence</strong><em>05</em></div>
-              <div class="toc-item"><span>04</span><strong>Motifs and closing states</strong><em>06</em></div>
+            <div class="toc-header reveal">
+              <h2>Table of<br>Contents</h2>
+              <p class="toc-note">Starter preview demonstrates the core structure available to derived themes.</p>
+              <p class="toc-footer">Structure-First-Design</p>
             </div>
+            <ol class="toc-list reveal">
+              <li class="toc-item"><span>01</span><strong>Foundation and visual schema</strong></li>
+              <li class="toc-item"><span>02</span><strong>Layouts and content modules</strong></li>
+              <li class="toc-item"><span>03</span><strong>Data flow and evidence</strong></li>
+              <li class="toc-item"><span>04</span><strong>Motifs and closing states</strong></li>
+            </ol>
           </div>
           <div class="page-number">02</div>
         </div>