@xiaobuyu/nodesign 0.0.1

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

@@ -0,0 +1,228 @@
+---
+name: rp-craft
+version: 0.1.1
+description: NoDesign 互动演出（RP）方法论 —— 搭一场角色扮演：编排上下文（编排.yaml 三区模型）、写角色与世界、造演出页前端、串起 chatai 通路。只要用户想角色扮演就用本 skill —— 包括直接说「开一场RP」「我们来玩角色扮演」并当场给出人物设定的情况：你是搭台的场务，不是台上的演员，绝不在设计对话里亲自扮演角色，而是按本 skill 把演出搭成能反复进场的作品（角色在专门的演出页里开口，那条通路便宜得多、也不占设计会话）。也用于把酒馆（SillyTavern）角色卡搬进来。不要用于写小说（那是另一回事，别拿这套硬套）。
+---
+
+# 一场演出是什么
+
+三样东西住在**一个文件夹**里，缺一不可：
+
+1. `编排.yaml` —— 上下文的播放单（进模型的一切按它拼）
+2. 设定文件 —— 角色、世界、文风，自由组织，被播放单引用
+3. `index.html` —— 演出页。有它这个文件夹就会被认成站点，用通用站点窗打开
+
+对话记录 `对话.jsonl` 和摘要 `摘要.json` 演出中自动生成。**摘要是派生态，永远别手写。**
+
+台上说话的是 **chatai**：一次纯补全调用，没有工具、没有会话、改不了任何文件。
+你（agent）只负责搭台和调台，不在台上。演出的每一轮花费按平台单价表记入用户额度。
+
+# 机制契约（这一节照抄不走样）
+
+## 编排.yaml 全貌
+
+```yaml
+模型: gemini-3.7-flash   # 可省 = 平台默认。摘要可单配便宜的（摘要.模型）
+思考: 低                 # 思考档，可省 = 该模型最省的那档。gemini 系 低/中/高、
+                         # claude 系 关/高（开扩展思考）；写了模型没有的档不报错，
+                         # 按默认档跑并在回包里说明。摘要另有 摘要.思考，不写就走
+                         # 默认档（压缩不是创作，别给摘要开高思考烧钱）
+最大输出: 400            # RP 短回合是质量旋钮：300–600 合适，放大了戏会水
+上下文预算: 60000        # 输入侧预算：系统层和尾部照给，历史是弹性区被从最旧挤压
+
+系统层:                  # → system 参数。整区冻结，是缓存的本体
+  - 名字: 身份与规则
+    文件: 设定/老芦.md
+  - 名字: 世界观
+    文件: 设定/夜行集市.md
+  - 名字: 文风
+    内容: |
+      第二人称现在时，只写可感知的事，结尾留一个能接的动作或问题。
+
+历史:
+  保留轮数: 40           # 硬上限；预算不够时还会再被挤
+
+摘要:                    # 滚动前情提要：活历史攒到触发轮数就折叠一次
+  保留轮数: 12
+  触发轮数: 24           # 必须 > 保留轮数，差值是滞回区间
+  长度: 500
+
+尾部:                    # → 拼进当轮 user 消息前部。唯一允许每轮变的区
+  - 名字: 当前场景
+    文件: 状态/场景.md    # 谁改这个文件，下一轮就生效
+  - 名字: 交易提醒
+    内容: 涉及买卖时报价要具体到铜币数目。
+    触发: [买, 卖, 价钱]  # 触发词命中最近几轮或当轮输入才插入
+    # 停用: true          # 播放单开关
+```
+
+铁律三条：条目 `文件`/`内容` 二选一；**触发条目只能住尾部**（住系统层直接拒开演）；
+文件引用不许跑出演出文件夹。配置错了端点会拒演并报人话，照改就是。
+
+## 两条 API（演出页用，cookie 同源自动带）
+
+- `GET /api/projects/<pid>/chatai/log?dir=<文件夹>` → `{records, 摘要, 配置}`，开场铺台用
+- `POST /api/projects/<pid>/chatai/turn` body `{dir, input}` → SSE 流：
+  `data:{delta}`… 最后 `data:{done, text, usage, costUsd}`；错误 `data:{error}`。
+  拒绝码：429 太快或额度尽、409 上一轮没回完、403 账号未开通演出通路
+
+## 开场白（角色先开口）
+
+往 `对话.jsonl` 种第一条记录：
+
+```
+{"seq":1,"role":"assistant","text":"<开场白>","at":"<ISO时间>"}
+```
+
+它不算轮数，够老了会随摘要折叠。用户视角：一进场角色已经在说话。
+
+# 三区纪律 —— 为什么这么摆
+
+顺序即上下文：**稳定的在前吃缓存，易变的在后换自由。** 缓存按字节精确匹配前缀，
+前缀里任何一个字变了，它后面的一切全部重算。
+
+反面教材是酒馆的世界书：几百个词条按关键词触发、插在前缀中段，每轮触发集一变
+后面全废 —— 实测 573 条词库缓存命中率 **0%，一轮一美元**。所以这里触发条目被
+结构性关进尾部：尾部本来就在最新对话之后、缓存必然失效的位置，触发集怎么变都
+伤不到前缀。
+
+「每轮允许多大范围变化」是用户的取舍旋钮，空间化了：一段内容放系统层 = 冻住换
+缓存，挪尾部 = 放开换灵活。用户要"自由一点"，就是把东西往尾部挪。
+
+# 特化菜谱（参考，不当分类）
+
+**身份与规则**（系统层第一条）：演谁、对用户用什么人称、回合怎么接（只推进一拍，
+别替用户行动）、回复长度、这场戏的禁区。这一条的质量决定八成体验。
+
+**世界观：整本冻结，别切条。** 这条路是 1M 窗口 + 便宜的 flash，几万字设定冻在
+系统层一次写进缓存，比切几百条按关键词捞又稳又便宜。酒馆玩家的切条肌肉记忆是
+8k 窗口时代逼出来的，别带过来。
+
+**文风锚**：三五条"怎么写"的约束 + 一小段范文，比一堆形容词管用。范文是最强的锚。
+
+**状态文件当活道具**：`状态/场景.md` 这类尾部条目，演出中你或用户改文件就等于
+改状态，不需要任何变量系统。要推进剧情就改状态文件——**不要去读 `对话.jsonl`**
+（见下方隐私纪律；平台也会拦）。用户想跟你讨论某段戏，会自己粘贴过来。
+
+**触发条目 = 导演小纸条**，一场十条以内：战斗时收紧节奏、某个名字出现时提醒一段
+旧怨。它是"到了这一幕才递的条子"，不是知识检索。
+
+# 从酒馆搬东西进来
+
+⚠️ **任何酒馆导出的 JSON 都先用 `read_tavern_json`，不要用 Read。** 真样本
+（一份社区预设）464KB、210 条提示词而启用的只有 56 条 —— Read 一次就是十几万
+token 进上下文，换回来的绝大部分是停用的备选。工具两步走：`mode="digest"` 看结构
+（名字/角色/字数/一句引子），挑好了再 `mode="fetch"` + `entries=[…]` 拿正文。它只读不写，怎么分组
+是你的判断。
+
+酒馆导出的 JSON 有三种，别搞混：
+
+## ① 预设（Chat Completion preset）—— `prompts[]` + `prompt_order[]`
+
+**它跟 `编排.yaml` 是同一类东西**：管的是"每次请求怎么拼上下文 + 采样参数"，
+里面没有角色也没有剧情。搬法：
+
+1. `read_tavern_json` 摘要 → 看清启用了哪些、顺序如何。
+2. 跟用户过一遍**分歧点**（预设通常把同一功能备了好几版只开一个）：文风、
+   思维链、人称、对白量、NSFW 档。问"这几个开关你要哪一档"，不要自己替他选。
+3. `mode="fetch"` 拿选中条目的正文，按功能并成两三份设定文件（例：
+   `设定/规则.md`、`设定/文风.md`、`设定/思维链.md`），**顺序照抄原顺序**，
+   全部进**系统层**（它们每轮不变，正是缓存本体）。
+4. **丢掉**：marker 占位条（角色描述/性格/场景/Chat History —— 我们由
+   编排.yaml 自己管历史和角色）、0 字的分节标题、以及针对特定平台的破甲话术
+   （这条通路不过内容审查，尺度由账号档位定，那些绕过话术在这儿没有意义，
+   还白占前缀）。
+5. 采样参数（temperature / top_p / 各种惩罚）**我们没有这些旋钮**，照实告诉
+   用户：这边能调的是 模型 / 思考档 / 最大输出 / 上下文预算。预设里的
+   `openai_max_tokens` 可以参考着填 `最大输出`，但 RP 短回合 300–600 更好。
+
+一个真数字供你估：那份 56 条的预设，正文合计约 9.8k 字符 ≈ 4–5k token 常驻前缀。
+搬进系统层没问题，但要跟用户说清这是每轮都在的开销。
+
+## ② 角色卡（V2/V3）—— `spec: chara_card_v2` 或有 `first_mes`
+
+`description/personality/scenario` 并成一份角色文件进系统层；`first_mes` 种成
+开场白（往 `对话.jsonl` 写 assistant seq 1）；`mes_example` 提炼进文风锚；
+`alternate_greetings` 问用户要哪一条。`character_book` 见下。
+
+## ③ 世界书（lorebook）—— `entries`
+
+constant 的并进世界观正文（系统层）；带 keys 的挑**十条以内**做成尾部触发条目
+（`触发: [关键词…]`），其余并进世界观。别把整本世界书搬成触发条目 —— 触发条目
+住尾部是为了缓存稳定，几十条一起塞进去就把尾部撑成第二个前缀了。
+
+# 建场流程
+
+1. **先问再动手**：题材与基调、角色是谁跟用户什么关系、文风参照（有没有喜欢的
+   作品口吻）、回复长短、禁区、谁先开口。两三个问题一起问，别拷问。
+2. 落设定文件和 `编排.yaml`，要开场白就种上。
+3. 造前端，两件事分开做：
+   - **管线不用自己写，也不用去找**：加载本 skill 时平台已经把 `演出.template.js`
+     拷进工作区根，直接 `cp 演出.template.js <演出文件夹>/演出.js`，**一个字都别改**。
+     URL 自省、铺场、SSE 跨分片解析、错误话术、中断、输入法回车、滚动锚定、
+     摘要提示、隐私声明自检、探针模式全在里面 —— 这些是协议不是设计，现写必错
+     （真页面统计：三张手写的里两张漏了隐私声明和探针分支，还有一张每来一片就
+     抢滚动，用户往上翻看前情会被拽回底部）。
+   - **皮肤自己长**：`index.html` 按题材重设计 —— 字体、色纸、气泡形态、台面装饰
+     都是戏的一部分，手机窄屏必须能玩。接管线只需要回答"一条消息长什么样"：
+
+     ```html
+     <!-- ⚠️ classic script，**不许写 type="module"**：你自检截图走 file://，
+          ES module 在那儿被当跨源拦掉，整页脚本一起死 -->
+     <script src="演出.js"></script>
+     <script>
+       const 台 = document.getElementById('台');
+       const 条 = (cls, 文) => { const el = document.createElement('div');
+         el.className = cls; el.textContent = 文; 台.appendChild(el); return el; };
+       ND演出.挂载({
+         台,
+         输入: document.getElementById('输入'),
+         发送钮: document.getElementById('发送'),
+         画: {
+           用户: (文) => 条('回合 用户', 文),
+           演出: () => { const el = 条('回合 演出 等', '');
+             return { 写: (全) => { el.classList.remove('等'); el.textContent = 全; },
+                      完成: (全) => { el.classList.remove('等'); el.textContent = 全; },
+                      撤: () => el.remove() }; },
+           提示: (文) => 条('提示', 文),
+           出错: (文) => 条('出错', 文),
+         },
+       });
+     </script>
+     ```
+
+     `写(全文)` 每来一片调一次，给的是**到目前为止的全文**不是增量，直接
+     `textContent = 全文` 最省事。想看一整张能跑的皮肤范例：
+     `patterns/演出页-最小实现.html`（找不到就算了，上面这段就够接）。
+
+4. 自检：screenshot 演出页，确认铺场正常、开场白在台上。第一轮留给用户开。
+5. 告诉用户：点开这个文件夹的站点窗就能进场；想调口味（换文风、改场景、挪冻结
+   范围）随时叫你改 —— 你就是这场戏的场务。
+
+# 价钱小抄（跟用户聊配置时用）
+
+gemini-3.7-flash：$0.75/M 入、$3.75/M 出（促销价，思考 token 计入输出且关不掉，
+实测约为正文的三倍半）；claude-sonnet：$3/$15。一轮典型 RP（几千字上下文、几百字
+回复）flash 约 $0.003–0.008。预算紧就守住：最大输出别超 600、上下文预算 4–6 万。
+
+思考档不是免费的旋钮：思考 token 一律按输出价计。gemini 三档实测差异有限（别拿它
+当质量保证），claude 的「高」是真开扩展思考、一轮更贵。用户没提就别自作主张往上调。
+
+# 隐私纪律（跟机制契约同级，照办）
+
+演出记录是用户的隐私：**台词只活在 chatai 通路里，永远不进你的上下文。**
+
+- **不读 `对话.jsonl` / `摘要.json`**（Read/Grep 会被平台拦下）。调度剧情的接口
+  是 状态/ 文件；用户想给你看片段会自己粘贴——主动粘贴即知情同意。
+- 这两道保险住在 `演出.js` 里，改皮时**不许删也不许改**：`<meta name="nd-privacy">`
+  （用户在演出页上标注元素时，平台据此剥文本只发结构给你；模块发现页面没有会
+  自己补一条）；探针分支（显式带 `?nd_probe=1` 打开时渲样例台账——⚠️ 你的自检截图走 http、跟用户预览同源，**不会**自动进这个分支；你看到的就是用户看到的，别把真问题当样例——
+  screenshot 走的就是 file://，所以你看到的是样例，那是**正常的**，不是页面坏了，
+  别去"修"）。
+- 自检截图想看特定版面状态：`artifact_open` 开进会话真的点到那一步再量（量具带 `live:true`），或 `beforeShot` 塞假台账 —— 两条都行，别想办法弄真记录。
+
+# 边界
+
+- 页面里永远不出现任何密钥（不需要：端点靠 cookie）。
+- 页面不做定时轮询、自动重发 —— 限频闸会拦，但根上就别写。
+- 演出内容平台不审（chatai 无工具无副作用），尺度是用户和角色设定之间的事。

package/server/engine/plugins/nodesign/skills/rp-craft/patterns//346/274/224/345/207/272/351/241/265-/346/234/200/345/260/217/345/256/236/347/216/260.html

@@ -0,0 +1,78 @@
+<!doctype html>
+<html lang="zh">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<!-- 隐私声明：平台据它把标注里的文本剥成占位符再发给 agent。
+     演出.js 发现没有会自己补一条，但**自己写上更好**（不依赖脚本跑起来） -->
+<meta name="nd-privacy" content="演出">
+<title>演出</title>
+<style>
+  /* ── 这一整块是"皮肤"，按题材整个重画：字体、色纸、气泡形态都是戏的一部分 ── */
+  :root { --纸: #F4EFE4; --墨: #2B2117; --淡: #8A7A62; }
+  * { box-sizing: border-box; }
+  body { margin: 0; height: 100dvh; display: flex; flex-direction: column;
+    background: var(--纸); color: var(--墨);
+    font: 16px/1.85 "Songti SC", "Noto Serif CJK SC", serif; }
+  #台 { flex: 1; overflow-y: auto; padding: 24px 18px 8px; max-width: 720px; width: 100%; margin: 0 auto; }
+  .回合 { margin: 0 0 18px; white-space: pre-wrap; }
+  .回合.用户 { color: var(--淡); }
+  .回合.用户::before { content: "› "; }
+  .等::after { content: "…"; opacity: .5; }
+  .提示, .出错 { font-size: 13px; margin: 10px 0; }
+  .提示 { color: var(--淡); }
+  .出错 { color: #A8362B; }
+  form { display: flex; gap: 10px; padding: 12px 18px 18px; max-width: 720px; width: 100%; margin: 0 auto; }
+  textarea { flex: 1; resize: none; height: 44px; padding: 10px 12px; font: inherit; font-size: 15px;
+    background: #fff8; border: 1px solid #0002; border-radius: 2px; outline: none; color: inherit; }
+  button { padding: 0 18px; font: inherit; font-size: 14px; letter-spacing: .2em;
+    background: var(--墨); color: var(--纸); border: 0; border-radius: 2px; cursor: pointer; }
+  button:disabled { background: var(--淡); cursor: default; }
+</style>
+</head>
+<body>
+  <div id="台"></div>
+  <form id="条" autocomplete="off">
+    <textarea id="输入" rows="1" placeholder="你做什么、说什么…"></textarea>
+    <button id="发送" type="submit">进</button>
+  </form>
+
+<!-- ⚠️ classic script，**不要写 type="module"**：agent 自检截图走 file://，
+     ES module 在 file: 下会被当跨源拦掉，整页脚本一起死 -->
+<script src="演出.js"></script>
+<script>
+  const 台 = document.getElementById('台');
+
+  /** 皮肤只需要回答"一条消息长什么样"，管线的事一件都不用管 */
+  function 条(cls, 文) {
+    const el = document.createElement('div');
+    el.className = cls;
+    el.textContent = 文;
+    台.appendChild(el);
+    return el;
+  }
+
+  const 场 = ND演出.挂载({
+    台,
+    输入: document.getElementById('输入'),
+    发送钮: document.getElementById('发送'),
+    画: {
+      用户: (文) => 条('回合 用户', 文),
+      演出: () => {
+        const el = 条('回合 演出 等', '');
+        return {
+          写: (全文) => { el.classList.remove('等'); el.textContent = 全文; },
+          完成: (全文) => { el.classList.remove('等'); el.textContent = 全文; },
+          撤: () => el.remove(),
+        };
+      },
+      提示: (文) => 条('提示', 文),
+      出错: (文) => 条('出错', 文),
+    },
+  });
+
+  // 表单提交也走同一个口（回车已由 演出.js 接管，含输入法判定）
+  document.getElementById('条').addEventListener('submit', (e) => { e.preventDefault(); 场.发送(); });
+</script>
+</body>
+</html>

package/server/engine/plugins/nodesign/skills/rp-craft//346/274/224/345/207/272.template.js

@@ -0,0 +1,268 @@
+/**
+ * 演出.js —— 演出页的管线（NoDesign RP，2026-08-15）
+ *
+ * ⭐ **起手文件**：加载 rp-craft skill 时平台自动把它拷进工作区根，
+ * agent 只需 `cp 演出.template.js <演出文件夹>/演出.js`。**一个字都别改** ——
+ * 这里面全是协议和踩过的坑，不是设计。
+ * （为什么不放 patterns/ 让 agent 自己读：真跑实测它会 `find /` 全盘搜，
+ * 搜出生产仓和开发 worktree 两份再自己猜哪份对 —— 今天字节相同侥幸没事，
+ * 哪天两边不同步就会静默抄错版本。起手文件由平台投递，没有猜的余地。）
+ * 页面负责长什么样（`画` 里那几个函数随便写），这个文件负责让它能玩：
+ *
+ *   URL 自省 · 铺场 · SSE 跨分片解析 · 错误话术 · 中断 · 输入法回车 ·
+ *   滚动锚定 · 摘要折叠提示 · 隐私声明 · 探针模式
+ *
+ * ⚠️ **必须用 classic script 引**：`<script src="演出.js"></script>`，
+ * **不能写 type="module"**。
+ *
+ * 理由更新（2026-08-18）：原来的理由是"agent 自检走 file://，module 在 file: 下
+ * 被当跨源拦掉"—— 感知层今天改走 http 了，这个理由**已经不成立**。规则本身仍然
+ * 保留，因为它保护的是另一个真场景：**用户把演出页导出成 zip、在本地双击打开**，
+ * 那才是 file://，module 在那里照样整页死。
+ * （规则对但理由死了的注释，比没有注释更危险 —— 下一个人会按死理由去推翻规则。）
+ *
+ * ## 怎么用
+ *
+ *   const 场 = ND演出.挂载({
+ *     台: document.getElementById('台'),        // 滚动容器
+ *     输入: document.getElementById('输入'),     // 可选，给了就接管回车
+ *     发送钮: document.getElementById('发送'),   // 可选，给了就接管点击与禁用态
+ *     画: {
+ *       用户: (文) => {…; return 节点},          // 画一条用户消息
+ *       演出: () => ({ 写(全文), 完成(全文), 撤() }),  // 画一条演出气泡，返回把手
+ *       提示: (文) => {…},                       // 灰字提示（摘要折叠、探针说明）
+ *       出错: (文) => {…},                       // 错误条
+ *     },
+ *   });
+ *   // 想自己接管发送按钮就调 场.发送(文本)；想中断当前这轮调 场.中断()
+ *
+ * `画.演出()` 返回的把手：`写(全文)` 每来一片调一次（给的是**到目前为止的全文**，
+ * 不是增量，页面直接 textContent = 全文 最省事）；`完成(全文)` 收尾调一次；
+ * `撤()` 出错时把这条气泡拿掉。
+ */
+(function (global) {
+  'use strict';
+
+  /** 端点上限，跟服务端 MAX_INPUT_CHARS 对齐 */
+  var 输入上限 = 8000;
+
+  /** 样例台账：探针模式下渲这个，真台账一个字都不取 */
+  var 样例 = [
+    { role: 'assistant', text: '〔样例〕雾夜里，摊子上的豆油灯亮着。' },
+    { role: 'user', text: '〔样例〕我走近摊子。' },
+  ];
+
+  /**
+   * 从页面 URL 认出项目和演出文件夹。
+   * 线上是 `/api/projects/<pid>/artifact-file/<dir>/index.html`；
+   * file:// 打开时认不出来（导出的 zip 在本地双击就是这种）—— 那是探针模式，
+   * 不是坏了。
+   */
+  function 自省() {
+    var m = location.pathname.match(/^\/api\/projects\/([^/]+)\/artifact-file\/(.+)$/);
+    if (!m) return { pid: null, dir: null };
+    // ⚠️ pathname 是**已经百分号编码**的：中文文件夹名在这儿长成 %E6%A8%A1…，
+    // 不解码就会在 encodeURIComponent 时二次编码，服务端收到 %25E6… 直接 404。
+    // 逐段解码（'/' 是分隔符，不能整串解）。这个产品的文件夹名默认就是中文，
+    // 所以这一步不是边角情况，是主路径。
+    var dir = m[2].split('/').slice(0, -1).map(decodeURIComponent).join('/');
+    return { pid: m[1], dir: dir };
+  }
+
+  /**
+   * 隐私声明自检：页面上没有 `<meta name="nd-privacy">` 就现补一条。
+   *
+   * 这道防线不能指望"皮肤作者记得写"—— 平台据它把标注里的文本剥成占位符再发给
+   * agent。三张真页面里只有一张带着它（2026-08-15 查实），所以责任内建在管线里。
+   */
+  function 保证隐私声明() {
+    if (document.querySelector('meta[name="nd-privacy"]')) return;
+    var meta = document.createElement('meta');
+    meta.setAttribute('name', 'nd-privacy');
+    meta.setAttribute('content', '演出');
+    (document.head || document.documentElement).appendChild(meta);
+  }
+
+  /** 用户是不是本来就贴着底：只有贴着底才跟随滚动，不然会把正在往上翻的人拽回来 */
+  function 贴底(台) {
+    if (!台) return false;
+    return 台.scrollHeight - 台.scrollTop - 台.clientHeight < 40;
+  }
+  function 跟随(台, 要跟) {
+    if (台 && 要跟) 台.scrollTop = 台.scrollHeight;
+  }
+
+  /** 输入法回车判定：组字中的回车不是发送（10 处踩过的同一个坑） */
+  function 是输入法回车(e) {
+    return e.isComposing || e.keyCode === 229 || e.which === 229;
+  }
+
+  function 话术(status, 服务端说的) {
+    if (服务端说的) return 服务端说的;                 // 服务端的话最准，优先用
+    if (status === 409) return '这场演出正有一轮在跑，等它回完';
+    if (status === 429) return '太快了，或者额度用完了，歇一会儿';
+    if (status === 403) return '这个账号还没开通演出通路';
+    if (status === 404) return '找不到这场演出的文件夹';
+    if (status === 422) return '这一轮没被接受（输入是空的或者太长）';
+    return '出错了（' + status + '）';
+  }
+
+  function 挂载(选项) {
+    var 台 = 选项.台 || null;
+    var 输入 = 选项.输入 || null;
+    var 发送钮 = 选项.发送钮 || null;
+    var 画 = 选项.画 || {};
+    var 当摘要 = 选项.当摘要 || function () {};
+    var 当状态 = 选项.当状态 || function () {};
+
+    保证隐私声明();
+
+    var 址 = 自省();
+    var 探针 = location.protocol === 'file:'
+      || new URLSearchParams(location.search).has('nd_probe')
+      || !址.pid;
+    var 跑着 = false;
+    var 控制器 = null;
+
+    function api(路) {
+      return '/api/projects/' + 址.pid + '/chatai/' + 路;
+    }
+    function 忙(值) {
+      跑着 = 值;
+      if (发送钮) 发送钮.disabled = 值;
+      当状态(值 ? '跑着' : '闲着');
+    }
+
+    /** 开场铺台账。探针模式渲样例，绝不打网络。 */
+    async function 铺场() {
+      if (探针) {
+        样例.forEach(function (r) {
+          if (r.role === 'user') 画.用户(r.text);
+          else { var h = 画.演出(); h.完成(r.text); }
+        });
+        if (画.提示) 画.提示('（探针模式：样例台账，没有读真实记录）');
+        跟随(台, true);
+        return;
+      }
+      try {
+        var r = await fetch(api('log') + '?dir=' + encodeURIComponent(址.dir));
+        var j = await r.json().catch(function () { return {}; });
+        if (!r.ok) { if (画.出错) 画.出错(话术(r.status, j.error)); return; }
+        (j.records || []).forEach(function (rec) {   // 端点给的就叫 records
+          if (rec.role === 'user') 画.用户(rec.text);
+          else { var h = 画.演出(); h.完成(rec.text); }
+        });
+        跟随(台, true);
+      } catch (e) {
+        if (画.出错) 画.出错('读不到台账：' + (e && e.message ? e.message : '网络断了'));
+      }
+    }
+
+    /** 发一轮。文本从参数来（没给就从输入框取），走 SSE。 */
+    async function 发送(文本) {
+      var text = String(文本 != null ? 文本 : (输入 ? 输入.value : '')).trim();
+      if (!text || 跑着) return;
+      if (text.length > 输入上限) {
+        if (画.出错) 画.出错('这段太长了（上限 ' + 输入上限 + ' 字）');
+        return;
+      }
+      忙(true);
+      var 要跟 = 贴底(台);
+      画.用户(text);
+      跟随(台, 要跟);
+      if (输入) 输入.value = '';
+
+      if (探针) {                                   // 探针模式不打网络，回一句样例
+        var 样 = 画.演出();
+        样.完成('〔样例〕摊主抬头看了你一眼，没说话。');
+        跟随(台, 要跟);
+        忙(false);
+        return;
+      }
+
+      var 手 = 画.演出();
+      var 还回去 = function (话) {
+        if (手.撤) 手.撤();
+        if (画.出错) 画.出错(话);
+        if (输入 && !输入.value) 输入.value = text;   // 失败把话还给用户，别让他重打
+        忙(false);
+      };
+
+      控制器 = new AbortController();
+      var res;
+      try {
+        res = await fetch(api('turn'), {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ dir: 址.dir, input: text }),
+          signal: 控制器.signal,
+        });
+      } catch (e) {
+        return 还回去(e && e.name === 'AbortError' ? '这一轮中断了' : '网络断了，稍后重发');
+      }
+      if (!res.ok) {
+        var j2 = await res.json().catch(function () { return {}; });
+        return 还回去(话术(res.status, j2.error));
+      }
+
+      // SSE：`data: {...}\n\n`。⚠️ 一个事件会跨 chunk 到（中转站分片很粗），
+      // 所以必须按 '\n\n' 切、把最后半截留在缓冲里，不能逐 chunk 解析。
+      var reader = res.body.getReader();
+      var dec = new TextDecoder();
+      var buf = '';
+      var 全文 = '';
+      var 出过错 = false;
+      try {
+        while (true) {
+          var 步 = await reader.read();
+          if (步.done) break;
+          buf += dec.decode(步.value, { stream: true });
+          var 块 = buf.split('\n\n');
+          buf = 块.pop();
+          for (var i = 0; i < 块.length; i++) {
+            var 行 = 块[i].split('\n').filter(function (l) { return l.indexOf('data:') === 0; })[0];
+            if (!行) continue;
+            var ev;
+            try { ev = JSON.parse(行.slice(5)); } catch (e) { continue; }
+            if (ev.delta) { 全文 += ev.delta; 手.写(全文); 跟随(台, 要跟); }
+            if (ev.error) { 出过错 = true; 还回去(ev.error); }
+            if (ev.done) {
+              if (!全文 && ev.text) 全文 = ev.text;
+              手.完成(全文);
+              跟随(台, 要跟);
+              if (ev.摘要 && 画.提示) {
+                画.提示(ev.摘要.失败 ? '（前情提要没写成，下一轮再试）' : '（已把旧的对话折进前情提要）');
+              }
+              当摘要(ev.摘要 || null);
+            }
+          }
+        }
+      } catch (e) {
+        if (!出过错) return 还回去(e && e.name === 'AbortError' ? '这一轮中断了' : '流断了，刚才那段可能没说完');
+      }
+      控制器 = null;
+      if (!出过错) 忙(false);
+      if (输入 && 输入.focus) 输入.focus();
+    }
+
+    /** 掐掉正在跑的那一轮（服务端会一起掐上游，不留半条记录） */
+    function 中断() {
+      if (控制器) { 控制器.abort(); 控制器 = null; }
+    }
+
+    if (输入) {
+      输入.addEventListener('keydown', function (e) {
+        if (e.key === 'Enter' && !e.shiftKey && !是输入法回车(e)) {
+          e.preventDefault();
+          发送();
+        }
+      });
+    }
+    if (发送钮) 发送钮.addEventListener('click', function () { 发送(); });
+
+    铺场();
+    return { 发送: 发送, 中断: 中断, 铺场: 铺场, 探针: 探针, 址: 址 };
+  }
+
+  global.ND演出 = { 挂载: 挂载, 版本: '1.0' };
+}(window));