@xiaobuyu/nodesign 0.0.6 → 0.0.8

package/server/engine/plugins/nodesign/skills/blackboard-rp/SKILL.md

@@ -0,0 +1,215 @@
+---
+name: blackboard-rp
+version: 0.8.0
+description: 黑板 RP 的**版面协议** —— 在画布上跑角色扮演/跑团时怎么排版面：章节板书连成竖直线程、一拍配一条选项板书、nd:controls 控件面板三档生命周期、状态表（`| 键 | 值 |` 一张表 + set_vars 改格，数字进 git 不进 board.json）、条件触发器（nd:triggers 围栏，条件成立那一拍自动提醒你）、状态板 follow 跟最新章、在场人物栏、明骰表、十几章后的前情归档。台上所有人的台词都由你写（见系统提示词「你一个人演全场」）。文风见 story-voice，剧情技法见 story-craft，酒馆卡/预设导入见 story-import。
+---
+
+# 黑板 RP 是什么
+
+一场完全在画布上进行的角色扮演：正文直接落板书，状态住在板上，用户在板书上标注
+来回应。这套**版面协议**来自一场真实 15 章会话的沉淀，照它跑能省掉一轮轮的试错。
+
+**本 skill 只管版面。**分工按系统提示词的「你一个人演全场」节走：环境、情节、判定、
+状态板、骰表，以及**台上每个人的台词**，全是你的笔（⛔ 这一版不派角色子代理）。
+写谁的话之前先 Read 一遍他的 `角色/<名>/角色卡.md` 找回腔调。
+
+隔壁三个包按需加载：**文风**→`story-voice`，**剧情技法/反公式/骰子判据**→`story-craft`，
+**酒馆卡与预设导入**→`story-import`。
+
+# 版面协议（六条，开场就按这个搭）
+
+## 1. 章节是一条竖直线程
+
+每拍正文一条板书：`write_on_board {text, tag:"章节", chain:true}` —— chain 自动接在
+同 tag 上一条下面并画「接着」线，竖直往下长（纸 = 用户一屏）。**纸写满不会自动翻页** ——
+排不下会被拒收，下一页你自己 `open_sheet` 规划。用户滚轮/翻纸就能回看整条故事。
+⚠️ 串线程唯一正门是 chain（`near` 只画线不定位置，串不了线程）。
+一拍别超过一屏；正文超过一个卡面（约 300 字）就**自己分段**：plan 里给每段开一个
+空位（省掉 at 自动竖排），一段一条 write 填进去 —— 一段超了只拒那一段，不连坐。
+现成长文（导入的文本）懒得手分时才用 `flow:true` 让机器按段落代拆。
+
+## 2. 一拍 = 正文板书 + 选项板书
+
+正文落完，紧跟一条选项板书（`reply_to` 本拍正文，同 tag），正文里用 nd:controls
+围栏落成**真按钮**：
+
+    ```nd:controls
+    supersede: 章节选项
+    - [A] 跟上去 -> 选A：跟上去，但保持距离
+    - [B] 留在原地 -> 选B：留下，观察修女的反应
+    - [继续] send
+    ```
+
+用户点选项是攒着（再点一次是取消，会真撤回队列）、点 [继续] 连同攒的一起进你下一轮
+（消息形如【画布标注】板书「…」：选A…）。自由行动照旧走标注（在板书上写一句），
+两条路都要在选项板书里提一句。选项写短、编号清楚。
+**这不是第一拍的仪式，是每拍的义务**：玩家面前永远要有把手，他打出「接下来该怎么办」
+就是你漏拍了。配方：一枚推进主线、一枚人际/私人、一枚剑走偏锋（合理但意想不到）。
+⛔ 操作指引全走控件 —— 正文里不写「*（轮到谁…可以标注）*」式的括号舞台指令，
+那每拍破一次第四墙。
+`supersede: 章节选项` 那行是死期声明：下一拍的选项板一落，这拍的自动变灰 ——
+每拍都写同一个组名，别的控件（背包/商店）不受影响。
+
+## 2.5 控件不只是选项 —— 面板模式（发挥的地方）
+
+nd:controls 是通用按钮：每枚 = 一条待发提示词。生命周期三档，按面板性质挑：
+
+| 档 | 写法 | 给谁用 |
+|---|---|---|
+| 常设（默认） | 什么都不写 | 背包、商店、快捷动作 —— 全程要活着的 |
+| 同组顶替 | `supersede: <组名>` | 章节选项、限时事件的当前一轮 |
+| 定时 | `until: +30m` 或 ISO 时刻 | 倒计时抉择、限时商店 |
+
+可以造的东西（都验证过语法，放开想）：
+- **背包面板**（常设，进状态板组跟着走）：`- [用药水] -> 使用一瓶治疗药水`
+- **商店**（进城落一张、离城 edit_board remove）：`- [买长剑] 30金 -> 购买长剑`
+- **快捷指令条**（常设）：`- [骰] 我要主动检定 -> 我想对当前局面做一次主动检定，你定技能和DC`、
+  `- [问] OOC提问 -> （OOC）`
+- **限时抉择**：`until: +10m` + 正文写明倒计时后果
+
+更新面板内容用 `edit_board set_text` 改那条板书（板书文件也认 —— 重写正文、
+重算尺寸、线和标注全保留；只能改**自己写的**）。面板要跟着剧情走就归进 状态板 组吃
+follow。**别把十个面板同时铺满** —— 常设面板 2~3 个（背包+快捷条）为宜，
+场景性的（商店）用完就收。
+
+## 3. 状态：数字住一张表，表住一条板书
+
+⚠️ **2026-08-30 改了写法。**以前状态板是 `nodes:[PC卡, 当前场景, 明骰表]` 一组画布
+节点 —— 那条路把字存进 `board.json`，而 `board.json` 在 gitignore 里：**用户回滚
+项目时正文退回旧章、数字却停在新值**，agent 也 Read 不到那些字。现在分两件：
+
+### ① 状态表（数字的家，一条独立板书）
+
+开场落一条**独立的 chalk 板书**，`tag` 就叫 `状态表`，正文里一张两列表：
+
+```
+write_on_board {
+  text: "## 状态\n\n| 键 | 值 |\n| --- | --- |\n| 好感度_苏绵 | 3 |\n| 时间 | 戌时 |\n| 体力 | 8/10 |",
+  tag: "状态表", slot: "aside", staging: false
+}
+```
+
+⛔ **必须用 `text:` 不能用 `nodes:`** —— `text` 才落成 `notes/板书/*.md` 文件
+（进 git、用户能改、agent 能 Read、服务端能解析）；`nodes` 落的是画布原生节点。
+⚠️ 给它划版位时留实数：一张带触发器围栏的状态表**约 500px 高**（真会话里给 460
+被当场拒收）—— 开小了用 `edit_board replan` 调高，别废掉整页。
+
+**这条板书全场只能有一条。**服务端按 `tag: 状态表` 找它，找到两条就拒绝写入并
+点名两个路径 —— 它不猜该改哪一条。
+
+**每拍改数字用 `set_vars`**：
+
+```
+set_vars { vars: { "好感度_苏绵": 5, "时间": "亥时" } }
+```
+
+它**只改表里那一格**，你写的说明文字、别的行、卡的位置一个字节都不动，卡高自动重算。
+⛔ 别用 `edit_board set_text` 改数字 —— 那是重写整篇正文，等于让你把十几行不该变的
+东西重新生成一遍，数字就是这么写丢的。
+
+**数字的过去也是现成的**：`draw_trend {key:"好感度"}` 把这个键随拍数的走势画成
+一条手绘曲线（数据来自工作区 git，每回合一点）——`set_vars` 之后再调一次它原地
+长一格（用户拖过也认位置）。把它归进状态板组跟着走，玩家一眼看见关系怎么变的。
+
+**改完不用记在脑子里**：表里的现值会出现在你**下一轮开头**的工作台状态里。
+表被改坏（重复键、多张表、表没了）也会在那儿报警，不会静默消失。
+
+**用户可以直接改这张表** —— 他在画布上双击就能编辑，改完就是新状态。这是特性不是
+漏洞：状态是他和你共享的东西。
+
+### ② 状态板（给人看的那几张卡，可选）
+
+想在画布上摆得好看，另立一组卡（`tag:"状态板"`，`nodes:` 随意用），把状态表那条
+板书也归进这一组，然后立一次跟随规则（**只立一次**）：
+
+`edit_board { ops:[{ op:"follow", group_tag:"状态板", target_tag:"章节", side:"right" }] }`
+
+从此每拍正文一落，整组自动挪到它右侧、锚线自动重指，你不用手搬。`#章节` 这会儿
+还是空的没关系：规则先立着，第一拍一落自动接线并就位。用户拖过它也照样跟随
+（他摆的**相对格局**会保留），要彻底停跟随用 `unfollow`。
+
+⚠️ 这一组里的卡是**给人看的排版**，不是真相 —— 真相在①那张表里。两边别各存一份
+数字，那是这条线上翻过最多次车的账。
+
+### ③ 条件触发器：让服务端在该提醒你的时候提醒你
+
+状态表那条板书的正文里可以写一段 ```nd:triggers 围栏 —— 挂几个条件，条件成立的
+**那一拍**，服务端把你写的那句话端到你下一轮开头。
+
+    ```nd:triggers
+    - [好感度_苏绵 >= 5] once -> 她开始愿意主动找你说话了，这一拍给她一个开口的机会
+    - [体力 <= 2 && 时间 == 夜] on_cross -> 体力见底又是夜里：这一拍必须有代价
+    - [线索数 >= 3] once -> 线索够了，可以让他自己拼出真相
+    ```
+
+**语法（故意窄）**：`- [条件] 档 -> 要说的话`。`&&` 是唯一的连接词（全都成立才算
+命中），没有 `||` 没有括号。比较符 `>= <= > < == !=`；**大小比较只对数字生效**，
+比文字用 `==` / `!=`（写 `时间 >= 戌时` 会被明确报错，不会按字典序偷偷比）。
+
+**两档，别选错**：
+
+| 档 | 什么时候响 | 用在哪 |
+|---|---|---|
+| `once` | 第一次从不成立变成成立，之后退休 | 一次性的剧情钩子（好感度到了、线索够了） |
+| `on_cross` | **每次**从不成立变成成立 | 会来回摆的（体力见底、天黑、进城） |
+
+⛔ **没有"成立就一直响"这一档**，那会每拍注一遍，当天就变成噪音。
+
+**三条要知道的**：
+
+- **上膛不击发**：一条触发器刚写上去（或者服务重启过）的第一轮，就算条件当场
+  就成立，也**不会**响 —— 它先记下当前状态。想立刻响就把值先落回去再改上来。
+- **写错会被点名**：语法错、比较不了、键在表里不存在，都会在你下一轮开头写明
+  「这条一直不会响」+ 原文。不会静默失效。
+- **删一条就是编辑那一行**（`edit_board set_text` 或用户自己改）。每轮开头也会
+  报「N 条挂着、M 条已退休」，你随时知道现在有几个钩子在等。
+
+**挂触发器的时机**：埋伏笔的时候。你写下"如果她好感度到 5 就会主动开口"这个设计
+的当下，把它挂上去 —— 而不是指望二十拍之后自己还记得。这正是这套东西存在的理由。
+
+### ③ 明骰表分家
+
+明骰表是**另一张表、另一条板书**（表头别用 `| 键 | 值 |`，用
+`| 拍 | 检定 | DC | 骰 | 结果 |`）。⛔ 别跟状态表挤在同一条板书里 —— 一条板书里
+出现两张 `| 键 | 值 |` 表，解析器会拒绝，`set_vars` 当场失败。
+
+**状态是场务的正事，别让它烂在正文里。**数字变了板不变，用户就不信这块板了。
+
+## 4. 在场人物栏
+
+独立组 `tag:"在场人物"`，一个 NPC 一张卡，三行定式：好感 / 警戒 / 状态，用 `●●●○○`
+五格条。人物上下场就 `edit_board` 加删卡；换场换整批时 `erase_group` 重画。
+
+板上这张卡记的是**数值**；这个人的**人设**另有一份档案（`角色/<名>/角色卡.md`，
+`cast_role` 写的那张）。够格（有名字、会再出现、用户会想单独跟他说话）就顺手写一张，
+写他的话之前 Read 那份。两张卡各管一头，别混。
+
+## 5. 明骰表
+
+住在状态板里的一张 markdown 表，逐拍累积：`| 拍 | 检定 | DC | 骰 | 结果 |`。
+骰子用 `roll_dice` **真投**（服务端随机，骰面同时直达用户屏幕）。
+投骰过程写进正文（有仪式感），结果落表（可回溯）。
+**怎么判、失败该换来什么** → `story-craft`。
+
+## 6. 前情归档（十几拍后必然要做，别等画布撑不住）
+
+章节链过 12~15 条：把旧章合并成一张「前情提要」板书（接在链头），全文归档进一个
+`前情/第一卷.md` 文件，旧章节板书 `edit_board remove` 撤下（删除是软删，进回收站
+`.nd/trash/`，捞得回来 —— 但归档文件先写好再撤，顺序别反）。
+
+# 纪律
+
+- **玩家画像持续沉淀**：留意他的口味（节奏快慢、吃哪种梗、雷点、对白密度），写进
+  `记忆/玩家画像.md`，每场开演先扫一眼 —— 画像写「他吃什么」，不写剧情本身。
+- 侧栏只说一句「第 N 拍上板了」，正文全在板上，别两头贴。
+- 板书是 md：对白、分镜留白按文字节奏排，不要塞 sketch 节点（那是画图的）。
+- 画场景小图（营地/圆桌/地形）用 shapes 的词汇表和算子省笔：`stencil` 有
+  person/house/boat/sword 等十六词；**围一圈**用 `ring{n,cx,cy,upright:true}`
+  （侧视图里帐篷/人有重力，不加 upright 会东倒西歪）；阴影面 `fill:'hatch'`。
+- 一拍的板面动作（正文、选项、版面维护）同一回合连着发完，别摊到几拍；
+  每一发看过返回再发下一发（拒收/余量的提示都在返回里）。
+- **短拍别一拍开一张新纸**：接着当前纸往下写（chain:true、省掉 slot 自动接排），
+  写完的返回会报这张纸还剩多少。翻纸=换场景或被拒收，不是每拍的开场动作。
+- 开场先 `read_user_view` 看他的屏幕，版面宽度按他的视口定；顺手
+  `edit_board {ops:[{op:"chalk_edit", on:true}]}` 把「改板书」替用户打开 ——
+  跑团里他随时要拖板书、改状态，别让他跟双击武装较劲。

package/server/engine/plugins/nodesign/skills/deskskill-engine-mini/SKILL.md

@@ -16,6 +16,9 @@ description: NoDesign deck 设计守则 —— 形态和风格都跟用户探索
 命名是把他嘴里的形容词换成一个真实存在的风格名（下面单独一节），它决定了试作
 往哪个方向做；跳过它直接试作，等于拿模型均值去猜他的心思。
 
+开工顺手给产物留地：铺工作纸时切一块 `for:"artifacts"` 的版位（deck 卡、生成的
+配图会自动落进去），旁边留说明区。不留的话到货全堆在暂存架上，回头还得一件件搬。
+
 试作阶段一次只做一页（通常是封面，或者最能代表调性的那页），做真的、可看的，
 不是描述。用户看着实物给反馈，比看你写"暖调克制风"准一个量级。
 方向没定之前不要往后铺页，铺了就是在给自己制造返工。
@@ -51,7 +54,12 @@ brief 里读不出场合就问一句 —— 这一步答错，风格做得再好
 这一步的产出：**一个用户点过头的名字**。
 
 1. 从他的话里抠特征：他提到的东西、举的例子、否掉的东西，以及他做的这件事本身
-   （同人本宣传图 / 歌词视觉页 / 作品集主页各有自己的风格谱系）
+   （同人本宣传图 / 歌词视觉页 / 作品集主页各有自己的风格谱系）。
+   ⭐ 题材自带视觉传统的（一首歌、一个 IP、一个品牌、一个年代），候选从那个
+   传统里来 —— 先搜一眼它的官方视觉再命名：风格词条在你脑子里，题材的视觉
+   事实不在。想到某个真站 / 真刊物正是这个风格的活例子，顺口提议去采它的
+   配色字体版式（`browser_navigate` + `browser_capture`）——**提议主动、展开
+   经他点头**，他说不用就直接做
 2. 翻译成 2-4 个候选名字（词典在下面，那是你的词汇量）
 3. `AskUserQuestion` 给他挑：label 就是名字，`preview` 放一张 240×140 的 HTML
    小样（全 inline style，演示这个风格的字体 / 配色 / 版式关系）。小样比找张照片
@@ -116,10 +124,9 @@ IP、角色、真人、某个具体产品型号、小众品牌 —— 那种情
 用户点头之后，把这一份固化下来，它就是后面所有页的基准：
 
 - `<style id="design-tokens">` 的 `:root` 整组写死（色号、字号、字体链）
-- `record_decision` 落锚：`title` **名字打头**（`风格锚 = 拼贴`），取值写进 `rationale`
-  （"纸纹底 + 微旋转 + 白边 + 手写体标注 + 一点樱桃红"）。⚠️ 入参是 title / rationale
-  （都必填）/ scope / alternatives，**没有 `topic`**
-- 风格锚定之后顺手更新 `agent-memory/brand/memory.md`（风格档案），参照图留在
+- 落锚进长期记忆：写一条 `type: project` 记忆（名字打头，如「风格锚 = 拼贴」，
+  取值写进正文："纸纹底 + 微旋转 + 白边 + 手写体标注 + 一点樱桃红"）；项目级
+  定案还该进根 `CLAUDE.md` 的「风格档案」节（用户点头后）。参照图留在
   `assets/references/` 别删 —— 后面几页跑偏时靠它回锚
 
 锚说不出名字，说明还没定下来，回去再试一轮。
@@ -192,8 +199,8 @@ IP、角色、真人、某个具体产品型号、小众品牌 —— 那种情
 > layout 骨架参考按需 Read `<plugin>/patterns/<role>.md`。
 
 ## 板书（交稿纪律）
-做完这一轮的东西，在它旁边写一条板书（`write_on_board near=那张卡`）：这版是什么 / 为什么这么做 /
+做完这一轮的东西，写一条板书连上它（`write_on_board near=那张卡` —— near 画「说的是它」那条线，字落在当前纸上）：这版是什么 / 为什么这么做 /
 看哪里。改了几处就写几条要点，一条说一件事。同一件东西出了新版本，画一条「改自」线
-（`relate_on_board` derives-from）；有参考来源画「取材」。用户在你的板书上标注了，用
+（`edit_board` add_edge derives-from）；有参考来源画「取材」。用户在你的板书上标注了，用
 `write_on_board reply_to=` 接在那条下面回。多步任务先 TodoWrite 列步骤 —— 步骤清单会自动上板、
 每步的产物自动连过去。

package/server/engine/plugins/nodesign/skills/docx-craft/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: docx-craft
 version: 0.1.0
-description: NoDesign Word 文档设计守则 —— 产出 .docx（真 Word 文件，对方能打开接着改）。先问这份文档给谁看、进什么流程，再把用户嘴里的形容词翻译成一个真实存在的版式名，然后试作、给看、改、锚定、铺开。含中文排版军规（eastAsia 字体槽 / 首行缩进随字号 / 禁则 / 中文无真斜体）、闭合 token 契约、结构真实性（真样式真编号真表格几何）、渲染验收回路。**当用户明确要一份 .docx / Word 文件，或要的东西必须能在 Word 里打开继续编辑，或是有格式硬规定的正式文书（公文、学位论文、合同、投递用简历）时使用。** 反向：要演示 / 幻灯片 / PPT 走 deskskill-engine-mini，要网页 / 站点 / 落地页走 site-craft。⚠️ 用户只说"做个报告 / 写个方案"而没提格式时**不要**用这条 —— 默认仍走 deck 或站点，画布里可看可迭代是主场，Word 是显式出口。
+description: NoDesign Word 文档设计守则 —— 产出 .docx（真 Word 文件，对方能打开接着改）。先问这份文档给谁看、进什么流程，再把用户嘴里的形容词翻译成一个真实存在的版式名，然后试作、给看、改、锚定、铺开。含中英两套排版军规（中文：eastAsia 字体槽 / 首行缩进随字号 / 禁则 / 中文无真斜体；西文：半角标点 / 段间距不缩进 / 真斜体 / 磅值字号，按产物正文主体语言选，拿不准走中文）、闭合 token 契约、结构真实性（真样式真编号真表格几何）、渲染验收回路。**当用户明确要一份 .docx / Word 文件，或要的东西必须能在 Word 里打开继续编辑，或是有格式硬规定的正式文书（公文、学位论文、合同、投递用简历）时使用。** 反向：要演示 / 幻灯片 / PPT 走 deskskill-engine-mini，要网页 / 站点 / 落地页走 site-craft。⚠️ 用户只说"做个报告 / 写个方案"而没提格式时**不要**用这条 —— 默认仍走 deck 或站点，画布里可看可迭代是主场，Word 是显式出口。
 ---
 
 # 核心守则：跟 deck / 站点同一条路
@@ -38,6 +38,13 @@ docx 的版式谱系跟网页不是一套，常用的这些：
 | 简历 / 投递 | **单页履历体** | 窄边距、姓名区大字号、条目左对齐悬挂缩进、零装饰 |
 | 手册 / 说明书 | **技术文档体** | 编号标题、等宽代码块、表格密排 |
 
+⚠️ 公文体的坑（实测反馈，08-21 案）：严格国标的三级标题**同缩进、纯换字体**
+（黑/楷/仿宋），而预览的替身字体会吃掉楷体与仿宋的对比度 —— 三级在预览里几乎
+不可辨，用户大概率抱怨"层级看不出来"。两条路先问一句：a) 严格国标（对方单位
+真按 9704 收文时用）；b) **层级强化变体**（用户没点名国标就默认它）——
+Heading1 加 `spacing.beforePt: 8`、Heading2 加 `indent.leftChars: 200` + `bold: true`，
+层级立刻一眼可辨且不破坏 exact 行距的页数稳定性。
+
 内置词典条目有三个（`build_docx` 的 `preset`）：`办公标准` / `公文` / `学术论文`。
 **它们是起点不是菜单** —— 上表其余的用 preset 起手再覆写 tokens，或者干脆不写
 preset 给完整 token 表。自造词作废（"科技感文档"不是版式名），但凡是真实存在、
@@ -60,7 +67,9 @@ preset 给完整 token 表。自造词作废（"科技感文档"不是版式名
 新旧并排），⛔ 别覆盖旧版 —— 版本是给用户看的，不是给你腾地方的。
 
 起手文件 `文档.template.json` 已经拷进工作区了 —— 照着它改，别从空白开始。
-**字段全集 Read `references/token-schema.md`** —— 键名、值域、单位、块的形状、
+**字段全集 Read `references/token-schema.md`**（⚠️ 相对**本 SKILL 文件所在目录**，
+不相对工作区 —— 用加载本 skill 时给出的 SKILL.md 路径拼出绝对路径去 Read，
+别在工作区里找、更别 find / 全盘扫）—— 键名、值域、单位、块的形状、
 常见错法对照全在那里，别靠猜，也别去读引擎源码。
 
 **schema 是闭合的**：写了没登记过的字段名，`build_docx` 直接报错。这是故意的 ——
@@ -93,7 +102,16 @@ preset 给完整 token 表。自造词作废（"科技感文档"不是版式名
 
 判据很简单：**用户在 Word 里改一处，会不会散架。** 会散架的就是假的。
 
-## 四、中文排版军规（目标用户是中文用户，这节不是可选项）
+## 四、排版军规
+
+**先定这份文档的正文主体是什么语言**，排版规矩跟它走 —— 不跟界面语言走，也不跟
+你们对话用的语言走。一个界面设成英文的人照样会做中文简历，反过来也一样；brief 里
+没说清就问一句。中英混排按**正文主体**那一种算（中文文章里引几句英文，仍是中文文档）。
+
+### 4.1 中文正文（默认路径）
+
+下面六条是硬约束，不是可选项：
+
 
 1. ⭐ **`eastAsia` 槽必须设。** 中文字符走的是 `w:rFonts` 的 `eastAsia` 槽，
    只写 `ascii` 等于没给中文指定字体。token 里 `fonts` 每个槽四件套都要填。
@@ -109,6 +127,27 @@ preset 给完整 token 表。自造词作废（"科技感文档"不是版式名
 
 字号用中文字号名（三号 / 小四 / 五号）比写磅值可靠，token 直接收它们。
 
+### 4.2 西文正文（例外路径）
+
+**只有确认正文主体是西文时才走这一节**，拿不准就走 4.1。逐条对应上面：
+
+1. `eastAsia` 槽照样填 —— 英文文档里也会出现中文（人名、引用、参考文献），
+   槽空着那几个字就掉到系统默认字体。这条不是中文特有的，别关。
+2. 首行缩进**不用**。西文段落靠段间距分段，不靠缩进；两个都上跟中文里两个都上
+   一样难看。`firstLineChars: 0` + 段后距。
+3. 上一条的推论：4.1 第 3 条的"二选一"在这边固定选段间距那一边。
+4. **西文有真斜体，正常用。** 书名、期刊名、外来语、强调都走 `i`，
+   别为了跟中文一致改成加粗。
+5. 标题不缩进这条照旧（`firstLineChars: 0`），理由一样。
+6. 标点用**半角**，后面跟一个空格。中文文档里的全角 `，：` 出现在英文正文里
+   是最扎眼的一种错。引号用 `"…"` / `'…'`，不用 `「」`。
+7. 字号写**磅值**（11pt / 12pt），不用中文字号名 —— "小四"在英文语境里没有意义。
+   正文常用 11pt 或 12pt，行距 1.15 到 1.5。
+8. 编号走 `1. / a. / i.` 这套，不用 `①②③`（4.1 里推荐的圈码是中文文档的习惯）。
+
+⚠️ 这一节是**例外**，不是"另一半"。判断不出正文主体语言时，
+走 4.1 —— 给中文文档套西文排版，比反过来更容易被一眼看出不对。
+
 ## 五、渲染验收：做完必须看
 
 `screenshot_canvas` 对 .docx 会渲成页图（LibreOffice → PDF → PNG），带 `pages` 参数
@@ -162,8 +201,8 @@ screenshot_canvas →  看版式
 Word 里导（域和字体都对）。
 
 ## 板书（交稿纪律）
-做完这一轮的东西，在它旁边写一条板书（`write_on_board near=那张卡`）：这版是什么 / 为什么这么做 /
+做完这一轮的东西，写一条板书连上它（`write_on_board near=那张卡` —— near 画「说的是它」那条线，字落在当前纸上）：这版是什么 / 为什么这么做 /
 看哪里。改了几处就写几条要点，一条说一件事。同一件东西出了新版本，画一条「改自」线
-（`relate_on_board` derives-from）；有参考来源画「取材」。用户在你的板书上标注了，用
+（`edit_board` add_edge derives-from）；有参考来源画「取材」。用户在你的板书上标注了，用
 `write_on_board reply_to=` 接在那条下面回。多步任务先 TodoWrite 列步骤 —— 步骤清单会自动上板、
 每步的产物自动连过去。

package/server/engine/plugins/nodesign/skills/docx-craft/references/token-schema.md

@@ -262,6 +262,22 @@
 写成 `"para": {...}` **会被拒**（2026-08-18 起 content 和页眉页脚都过闭合校验）。
 在那之前它是"不报错也不生效"——最难发现的一类错，起手模板自己教错过一次。
 
+⭐ **对象型键（`spacing` / `indent` / `borders`）与样式里的同名键是属性级深合并**，
+跟 tokens 对 preset 的合并规则一致：引擎只把你写的属性写进这一段的 pPr，
+没写的属性照常从样式继承（OOXML 的属性级联就是这个粒度；2026-08-24 真渲染
+实测证实——样式 `line:10/lineRule:"exact"` 的段，块级只写 `beforePt:30`，
+行距不掉）：
+
+```jsonc
+{ "t": "p", "style": "要点", "spacing": { "beforePt": 3 } }
+// ✅ 只多 3pt 段前距；样式里的 line/lineRule 原样保留，不必重抄
+```
+
+唯一的例外是 `indent`：`firstLine*` 和 `hanging*` 互斥（见上），而深合并抹不掉
+从样式继承来的属性——所以"样式带首行缩进的段想改成悬挂"**不要**靠块级开小灶
+（继承的 firstLine 还在，两个属性并存后哪个生效随渲染器），正路是给这类段落
+单独立一个不带首行缩进的样式。
+
 ### `{"t": "table"}` 表格
 
 ```jsonc

package/server/engine/plugins/nodesign/skills/site-craft/SKILL.md

@@ -15,6 +15,10 @@ description: NoDesign 站点设计方法论 —— 静态站点（手写起步
 的气质八成由正文排版决定，只做个漂亮 hero 给用户看，等铺到正文那天他会说"怎么
 跟我想的不一样"。试作放 `_drafts/<名字>.html`，各自渲成卡并排给用户挑。
 
+开工顺手给产物留地：铺工作纸时切一块 `for:"artifacts"` 的版位（试作卡、截图、
+采回的参考图会自动落进去），旁边留一块说明区写板书。不留的话到货全堆在暂存架上，
+回头还得一件件搬。
+
 并排的那几份是**同一个名字的不同解法**，不是几种不同风格 —— 名字在上一步已经定了，
 再摆三种风格等于推翻他刚点过的锚。例外：命名那轮没收敛（两个候选他都想看），那就
 跳过选名字，每个候选各做一份真试作、文件名带上名字并排给他挑；真稿的判别力比
@@ -52,7 +56,12 @@ description: NoDesign 站点设计方法论 —— 静态站点（手写起步
 这一步的产出：**一个用户点过头的名字**。
 
 1. 从他的话里抠特征：他提到的东西、举的例子、否掉的东西，以及这个站是干嘛的
-   （个人站 / 作品集 / 同人本宣传 / 长文阅读页各有自己的风格谱系）
+   （个人站 / 作品集 / 同人本宣传 / 长文阅读页各有自己的风格谱系）。
+   ⭐ **题材自带视觉传统的，候选从那个传统里来**：站的主题是一首歌、一个 IP、
+   一个品牌、一个年代或地域时，它多半有官方视觉 / 既成的粉丝审美 —— 先搜一眼
+   它的官方视觉再命名（这不算下面禁的"为理解风格搜图"：风格词条在你脑子里，
+   **题材的视觉事实不在**）。真案：SPiCa 站凭词条给的三个候选全跑偏，用户一句
+   "要不要搜搜它的设计风格"，搜完才发现主题色根本是另一组 —— 这句话该由你先说
 2. 翻译成 2-4 个候选名字（词典在下面，那是你的词汇量）
 3. `AskUserQuestion` 给他挑：label 就是名字，`preview` 放一张 240×140 的 HTML
    小样（全 inline style，演示这个风格的字体 / 配色 / 版式关系）。小样比找张照片
@@ -69,6 +78,12 @@ description: NoDesign 站点设计方法论 —— 静态站点（手写起步
 一次真实对比：搜关键词收益为零，直接看三个站十分钟就定位到三个具体缺口。
 **别搜词，去看站**——这跟上面那条不冲突，一条说的是词，一条说的是版面。
 
+⭐ **想到活例子就提出来，深逛之前先征询一句**。命名或试作时想到某个真站 / 某类站
+正是这个风格的活例子，别憋着 —— 顺口提议："要不要我去逛逛 XX 那类站，把它的
+配色、字体、动效采回来照着做？"（聊天里一句话就行，不用开卡片）。深逛要花几分钟，
+先问再展开；他说不用就直接做，他丢了链接或参考图就直接用不再问。**提议是主动的，
+展开是经他点头的** —— 一次都不提，等于把"找参照"这条路藏起来让他自己想。
+
 **怎么看**（2026-08-18 起有了真浏览器，不再只能截一张）：
 
 ⭐ **搜索和浏览器是一套动作，不是两条路**。`web_search` 回答"哪些站值得看"，
@@ -125,10 +140,10 @@ IP、角色、真人、某个具体产品型号、小众品牌 —— 那种情
   2-4 个带小样的候选，不是一张风格大全。摊开菜单就退回模板思维了。
 
 他已经点了名字（"我要拼贴风"）的，跳过前两步直接进试作；直接甩了参考图的，
-读图读出那是什么风格、跟他确认一下名字，再进试作。名字定下来之后调 `record_decision` 落锚：`title` 名字打头
-（`风格锚 = 拼贴`），取值写进 `rationale`；⚠️ 入参是 title / rationale（都必填）/
-scope / alternatives，**没有 `topic`**。参照图留在 `assets/references/` 别删 ——
-铺到第五页跑偏时靠它回锚。
+读图读出那是什么风格、跟他确认一下名字，再进试作。名字定下来之后落锚进长期
+记忆（一条 `type: project` 记忆，名字打头如「风格锚 = 拼贴」，取值写进正文）；
+项目级定案经用户点头后进根 `CLAUDE.md` 的「风格档案」节。参照图留在
+`assets/references/` 别删 —— 铺到第五页跑偏时靠它回锚。
 
 ### 翻译词典 —— 你的词汇量，不是给用户的菜单
 
@@ -211,7 +226,8 @@ CDN 库随便拉（gsap / lenis / three / alpine / htmx），但动效是调味
 
 ## 中文排版基线
 
-- 标点用**全角**（，。：；？！……），半角逗号冒号在中文里很扎眼
+- 标点跟**正文主体语言**走：中文正文用全角（，。：；？！……），半角逗号冒号在中文里很扎眼；
+  英文正文用半角加一个空格，全角标点混进英文句子里同样扎眼。混排按主体那一种算
 - 字体链每段 latin family 后面必须跟 CJK family：
   `'Inter', 'PingFang SC', 'Noto Sans SC', system-ui, sans-serif`
   少了 CJK 那段，换台机器中文就掉到系统默认字体
@@ -323,8 +339,8 @@ Read `patterns/page-transitions.md` —— **动手写第一个转场之前先
 > 构建道（React / vite / Tailwind / 组件库）配方 Read `patterns/build-lane.md`。
 
 ## 板书（交稿纪律）
-做完这一轮的东西，在它旁边写一条板书（`write_on_board near=那张卡`）：这版是什么 / 为什么这么做 /
+做完这一轮的东西，写一条板书连上它（`write_on_board near=那张卡` —— near 画「说的是它」那条线，字落在当前纸上）：这版是什么 / 为什么这么做 /
 看哪里。改了几处就写几条要点，一条说一件事。同一件东西出了新版本，画一条「改自」线
-（`relate_on_board` derives-from）；有参考来源画「取材」。用户在你的板书上标注了，用
+（`edit_board` add_edge derives-from）；有参考来源画「取材」。用户在你的板书上标注了，用
 `write_on_board reply_to=` 接在那条下面回。多步任务先 TodoWrite 列步骤 —— 步骤清单会自动上板、
 每步的产物自动连过去。

package/server/engine/plugins/nodesign/skills/story-craft/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: story-craft
+version: 0.1.0
+description: 叙事技法包 —— 剧情卡住、连着几拍在平推、写出来的东西"没味儿"、或者用户说"太套路了"的时候用本 skill。含反公式清单（点名十几种一眼假的桥段和它们的替代路数）、信息差设计、失败骰判据、上钟与代价、把配角写活的办法。不管文风（那是 story-voice），只管这一拍该发生什么。
+---
+
+# 这个 skill 管什么
+
+`story-voice` 管**写成什么调子**，这一份管**该发生什么事**。两件事分开：
+文笔再好，一拍下来没人失去什么、没人知道了什么，那就是水。
+
+# 一、反公式
+
+## 铁律：想到的头两个走向先毙掉
+
+第一反应几乎总是公式。这不是你的问题，是"最可能的下一句"这件事本身的性质 ——
+最可能的，就是最多人写过的。
+
+**做法**：想到 A 和 B 之后，别急着写，**明确问自己第三条是什么**，判据是
+「合理，但读者想不到」。想不出第三条就退回去问「这一拍如果什么都不发生会怎样」，
+往往能挖出真正该发生的事。
+
+## 一眼假的桥段清单（撞到就换）
+
+| 公式 | 为什么假 | 换成 |
+|---|---|---|
+| 酒馆里遇险开局 | 它是"该有事发生了"的偷懒解 | 让麻烦是**主动找上门的旧账**，带名字 |
+| 神秘老人给任务 | 信息从天上掉下来 | 信息要有人**不想给**，得换 |
+| 及时救场 | 取消了刚建立的代价 | 救得成但**救错了人**，或者晚一步 |
+| 公式傲娇／口是心非 | 用一个标签替代一个人 | 让他嘴上服软、行动上更狠 |
+| 反派临死前解释动机 | 为了读者方便而破坏人物 | 动机让**第三个人**在别处说出来，说得还不准 |
+| 失忆／身世反转 | 把已建立的东西一笔勾销 | 让秘密**早就摆在桌上**，只是没人当回事 |
+| 大家一起感慨主题 | 角色替作者说话 | 让他们**为这件事吵起来**，谁都不总结 |
+| 梦境／回忆闪回填设定 | 停下故事去讲课 | 把那段设定拆成三句台词，散在三拍里 |
+| 巧合解决困境 | 玩家的选择变得不重要 | 巧合只许**制造**麻烦，不许**解决**麻烦 |
+
+## 一条正向的
+
+**允许剧情语出惊人。**觉得无聊的时候，往"合理又好玩"的方向多走一步，别缩回安全区。
+读者对平庸的容忍度远低于对冒险的。
+
+# 二、信息差是燃料
+
+每一拍动笔前问：**在场的每个人各知道什么？从哪知道的？不该知道什么？**
+
+这一条值得比别的多花心思。戏的张力几乎全部来自"有人不知道"：
+
+- **谁蒙在鼓里** —— 读者知道而他不知道，每句话都有第二层意思。
+- **谁的误会还没拆** —— 拆误会的时机是可调度的资源，别急着用掉。
+- **这一拍能不能让某人多知道一点** —— 信息应该是**分次**给的，一次给完戏就散了。
+
+⛔ **别为了省事让谁全知。**一个知道所有事的角色是剧情的黑洞。
+
+# 三、失败骰判据（跑团的心脏）
+
+**失败换信息或代价，成功换新麻烦，两者都不许原地踏步。**
+
+失败**别写成"没成功"**，那是最浪费的一种写法。换成：
+
+- 他把一个**错误结论说得很自信**（然后别人看穿它）
+- 失败落在**表达**上而不是结果上：最该先说的那句没说成
+- 代价是**暴露了帮过他的人**
+- 账**要到后面几章才结**（现在只留一个记号）
+
+成功配一个新麻烦：拿到蜡烛 → 蜡烛开始倒计时；救下人 → 被救的说「你们不该救我」。
+
+**给对手也投一次骰。**一边的失败有了具体来源，场面就从"判罚"变成"博弈"。
+
+⛔ 骰子永远用 `roll_dice` 真投。编的点数玩家迟早看穿，整桌的信任一次塌完。
+「自然 1 / 自然 20」值得在正文里给一个镜头。
+
+# 四、节奏：上钟和跳时间
+
+- **连着两拍没有判定、代价或资源变化，就该有东西上桌**：一口钟（时限）、
+  一次检定、一个不速之客。沉浸来自"决定有后果"，不是文笔。
+- **无聊的过场直接跳时间**：「半天路，日头偏西时望见了村口」一句带过。
+  细写留给有戏的地方。**不写无聊剧情是权利，不是偷懒。**
+- **镜头可以切走**：用户的角色这一拍没事干、或者他这边的事不要紧，就切到有事
+  发生的那边写，别围着他一个人凑字数。
+
+# 五、把配角写活的三条
+
+1. **每个人都在忙自己的事**。他出现在这一拍，是因为他自己有理由在这儿，不是因为
+   主角需要他。
+2. **别猜人设**：设定里没写到的性格不要现编，默认他是个正常人。反过来，
+   **他的反应要显得"他就是自然而然这么想的"**，不刻意突出他的异人之处。
+3. **给他一个跟主线无关的执念**（一双鞋、一笔旧账、一个称呼）。人物的立体感来自
+   不服务于剧情的那部分。
+
+# 自检（每拍收尾过一遍）
+
+- 这一拍**谁失去了什么、谁知道了什么**？两个都没有就是水拍。
+- 我写的走向，是不是我想到的头两个之一？
+- 玩家面前**有没有可按的东西**？（没有就还没写完）