@xiaobuyu/nodesign 0.0.1 → 0.0.3

package/server/shared/README.md

@@ -1,25 +1,25 @@
-# server/shared/
-
-从小合（[dev/server/bot/](../../../dev/server/bot/)）抠出来的**真正通用、跟工单业务无关**的基建文件。
-
-## 文件清单
-
-| 文件 | 来源 | 改动 |
-|---|---|---|
-| `anthropic-client.js` | `dev/server/bot/anthropic-client.js` | env 名 `MINIMAX_*` → `KIMI_*`；baseURL 默认值切 Moonshot；timeout 600s（长任务） |
-| `agent-loop.js` | `dev/server/bot/agent-loop.js` | 仅改 env 名 `BOT_TOOL_TIMEOUT_MS` → `ENGINE_TOOL_TIMEOUT_MS`，默认 30s → 60s；其余照搬 |
-| `concurrency.js` | `dev/server/bot/concurrency.js` | 注释从"飞书 user open_id"泛化为"key"；env 名加 `ENGINE_` 前缀；`enqueueMessage` 改 `enqueueTask` |
-| `time.js` | `dev/server/utils/time.js` | 零改动 |
-
-## 不该往这里加东西的判断
-
-- 业务（工单 / 钩子 / 飞书卡片）→ 不该来
-- 跟 dev/ 共演化的核心抽象 → 暂时直接复制；如果开始反复同步两边，就提到 monorepo `shared/` 包
-
-## 待验证（动工前必做）
-
-- [ ] `cache_control: { type: 'ephemeral' }` 在 Kimi Anthropic 兼容端点是否生效
-- [ ] `anthropic-beta: interleaved-thinking-2025-05-14` header 是否被 Kimi 接受
-- [ ] 流式 `tool_use` + `input_json_delta` 行为一致性
-
-写一个 `server/_probe-kimi.js`（30 行 JS）跑一遍。`npm run probe:kimi`。
+# server/shared/
+
+从小合（[dev/server/bot/](../../../dev/server/bot/)）抠出来的**真正通用、跟工单业务无关**的基建文件。
+
+## 文件清单
+
+| 文件 | 来源 | 改动 |
+|---|---|---|
+| `anthropic-client.js` | `dev/server/bot/anthropic-client.js` | env 名 `MINIMAX_*` → `KIMI_*`；baseURL 默认值切 Moonshot；timeout 600s（长任务） |
+| `agent-loop.js` | `dev/server/bot/agent-loop.js` | 仅改 env 名 `BOT_TOOL_TIMEOUT_MS` → `ENGINE_TOOL_TIMEOUT_MS`，默认 30s → 60s；其余照搬 |
+| `concurrency.js` | `dev/server/bot/concurrency.js` | 注释从"飞书 user open_id"泛化为"key"；env 名加 `ENGINE_` 前缀；`enqueueMessage` 改 `enqueueTask` |
+| `time.js` | `dev/server/utils/time.js` | 零改动 |
+
+## 不该往这里加东西的判断
+
+- 业务（工单 / 钩子 / 飞书卡片）→ 不该来
+- 跟 dev/ 共演化的核心抽象 → 暂时直接复制；如果开始反复同步两边，就提到 monorepo `shared/` 包
+
+## 待验证（动工前必做）
+
+- [ ] `cache_control: { type: 'ephemeral' }` 在 Kimi Anthropic 兼容端点是否生效
+- [ ] `anthropic-beta: interleaved-thinking-2025-05-14` header 是否被 Kimi 接受
+- [ ] 流式 `tool_use` + `input_json_delta` 行为一致性
+
+写一个 `server/_probe-kimi.js`（30 行 JS）跑一遍。`npm run probe:kimi`。

package/server/shared/deck.js

@@ -1,54 +1,54 @@
-/**
- * server/shared/deck.js — deck 设计坐标系常量（single source of truth）
- *
- * 默认 1920×1080（16:9 PPT 标准）；4 档预设 ASPECT_PRESETS 可选。所有需要
- * playwright headless 渲染 deck 的代码（exports / mcp tools / probe scripts）
- * 都从这里读，将来再调只改一处。
- *
- * deck 比例由 wrap.dataset.deckAspect 决定（agent 在 canvas.html 里声明）：
- *   "16:9"   默认横屏（1920×1080）演讲 / 文档 / scrollytelling
- *   "16:10"  宽屏笔电 / Mac 屏（1920×1200）介于 16:9 和 4:3 之间
- *   "9:16"   竖屏（1080×1920）手机宣发 / 短故事 / 直播 cover
- *   "4:3"    老投影 / 经典 PPT 投影仪适配（1440×1080）
- *
- * 用户面（浏览器自适应 / iframe 预览）通过 CSS 自适应 scale 让任意视口都满铺；
- * Playwright 渲染按 deck 比例设 viewport，scale=1 自然渲染。
- */
-
-export const ASPECT_PRESETS = Object.freeze({
-  '16:9':  Object.freeze({ width: 1920, height: 1080 }),
-  '16:10': Object.freeze({ width: 1920, height: 1200 }),
-  '9:16':  Object.freeze({ width: 1080, height: 1920 }),
-  '4:3':   Object.freeze({ width: 1440, height: 1080 }),
-});
-
-export const DEFAULT_ASPECT = '16:9';
-
-export const DECK = ASPECT_PRESETS[DEFAULT_ASPECT];
-
-/**
- * 解析 aspect 字符串到 { width, height }，未知值 fallback 默认 16:9。
- *
- * @param {string|null|undefined} aspect
- * @returns {{ width: number, height: number, key: string }}
- */
-export function resolveDeckSize(aspect) {
-  const key = ASPECT_PRESETS[aspect] ? aspect : DEFAULT_ASPECT;
-  const dims = ASPECT_PRESETS[key];
-  return { width: dims.width, height: dims.height, key };
-}
-
-/**
- * 从 canvas.html 内容里抽 wrap data-deck-aspect 值。
- * 找不到 / 无效值 → 返回 DEFAULT_ASPECT。仅做轻量 grep，不上 cheerio。
- *
- * @param {string} html
- * @returns {string} aspect key (ASPECT_PRESETS 的键)
- */
-export function extractDeckAspect(html) {
-  if (!html || typeof html !== 'string') return DEFAULT_ASPECT;
-  const m = html.match(/<div\b[^>]*class\s*=\s*['"][^'"]*__nd-deck-wrap[^'"]*['"][^>]*data-deck-aspect\s*=\s*['"]([^'"]+)['"]/i)
-        || html.match(/<div\b[^>]*data-deck-aspect\s*=\s*['"]([^'"]+)['"][^>]*class\s*=\s*['"][^'"]*__nd-deck-wrap[^'"]*['"]/i);
-  if (!m) return DEFAULT_ASPECT;
-  return ASPECT_PRESETS[m[1]] ? m[1] : DEFAULT_ASPECT;
-}
+/**
+ * server/shared/deck.js — deck 设计坐标系常量（single source of truth）
+ *
+ * 默认 1920×1080（16:9 PPT 标准）；4 档预设 ASPECT_PRESETS 可选。所有需要
+ * playwright headless 渲染 deck 的代码（exports / mcp tools / probe scripts）
+ * 都从这里读，将来再调只改一处。
+ *
+ * deck 比例由 wrap.dataset.deckAspect 决定（agent 在 canvas.html 里声明）：
+ *   "16:9"   默认横屏（1920×1080）演讲 / 文档 / scrollytelling
+ *   "16:10"  宽屏笔电 / Mac 屏（1920×1200）介于 16:9 和 4:3 之间
+ *   "9:16"   竖屏（1080×1920）手机宣发 / 短故事 / 直播 cover
+ *   "4:3"    老投影 / 经典 PPT 投影仪适配（1440×1080）
+ *
+ * 用户面（浏览器自适应 / iframe 预览）通过 CSS 自适应 scale 让任意视口都满铺；
+ * Playwright 渲染按 deck 比例设 viewport，scale=1 自然渲染。
+ */
+
+export const ASPECT_PRESETS = Object.freeze({
+  '16:9':  Object.freeze({ width: 1920, height: 1080 }),
+  '16:10': Object.freeze({ width: 1920, height: 1200 }),
+  '9:16':  Object.freeze({ width: 1080, height: 1920 }),
+  '4:3':   Object.freeze({ width: 1440, height: 1080 }),
+});
+
+export const DEFAULT_ASPECT = '16:9';
+
+export const DECK = ASPECT_PRESETS[DEFAULT_ASPECT];
+
+/**
+ * 解析 aspect 字符串到 { width, height }，未知值 fallback 默认 16:9。
+ *
+ * @param {string|null|undefined} aspect
+ * @returns {{ width: number, height: number, key: string }}
+ */
+export function resolveDeckSize(aspect) {
+  const key = ASPECT_PRESETS[aspect] ? aspect : DEFAULT_ASPECT;
+  const dims = ASPECT_PRESETS[key];
+  return { width: dims.width, height: dims.height, key };
+}
+
+/**
+ * 从 canvas.html 内容里抽 wrap data-deck-aspect 值。
+ * 找不到 / 无效值 → 返回 DEFAULT_ASPECT。仅做轻量 grep，不上 cheerio。
+ *
+ * @param {string} html
+ * @returns {string} aspect key (ASPECT_PRESETS 的键)
+ */
+export function extractDeckAspect(html) {
+  if (!html || typeof html !== 'string') return DEFAULT_ASPECT;
+  const m = html.match(/<div\b[^>]*class\s*=\s*['"][^'"]*__nd-deck-wrap[^'"]*['"][^>]*data-deck-aspect\s*=\s*['"]([^'"]+)['"]/i)
+        || html.match(/<div\b[^>]*data-deck-aspect\s*=\s*['"]([^'"]+)['"][^>]*class\s*=\s*['"][^'"]*__nd-deck-wrap[^'"]*['"]/i);
+  if (!m) return DEFAULT_ASPECT;
+  return ASPECT_PRESETS[m[1]] ? m[1] : DEFAULT_ASPECT;
+}

package/server/shared/time.js

@@ -1,49 +1,49 @@
-/**
- * 北京时间工具
- *
- * 来源：从 dev/server/utils/time.js 复制（零改动）
- *
- * toISOString 是 UTC，直接用会在东八区凌晨误差 8 小时。
- * 所有注入 LLM 的"当前时间"应该走这个 util，输出北京时间 + 星期。
- */
-
-const WEEKDAY_CN = ['周日', '周一', '周二', '周三', '周四', '周五', '周六'];
-
-/**
- * 返回北京时间的多种呈现，供不同 prompt 复用
- * @returns {{ today: string, dateTime: string, weekday: string, nowMs: number, iso: string }}
- *   today:     "2026-04-22"
- *   dateTime:  "2026-04-22 14:32:05"
- *   weekday:   "周三"
- *   nowMs:     毫秒时间戳（给 LLM 做差值用）
- *   iso:       "2026-04-22T14:32:05+08:00"
- */
-export function formatBeijingNow() {
-  const now = new Date();
-  const nowMs = now.getTime();
-
-  // 转北京时间（东八区偏移）
-  const bj = new Date(nowMs + 8 * 3600 * 1000);
-  const y = bj.getUTCFullYear();
-  const m = String(bj.getUTCMonth() + 1).padStart(2, '0');
-  const d = String(bj.getUTCDate()).padStart(2, '0');
-  const hh = String(bj.getUTCHours()).padStart(2, '0');
-  const mm = String(bj.getUTCMinutes()).padStart(2, '0');
-  const ss = String(bj.getUTCSeconds()).padStart(2, '0');
-  const weekday = WEEKDAY_CN[bj.getUTCDay()];
-
-  const today = `${y}-${m}-${d}`;
-  const dateTime = `${today} ${hh}:${mm}:${ss}`;
-  const iso = `${today}T${hh}:${mm}:${ss}+08:00`;
-
-  return { today, dateTime, weekday, nowMs, iso };
-}
-
-/**
- * 返回适合塞进 prompt 的一行文本
- * "当前时间：2026-04-22 周三 14:32:05（北京时间，毫秒时间戳 1745...）"
- */
-export function beijingNowLine() {
-  const { today, weekday, dateTime, nowMs } = formatBeijingNow();
-  return `当前时间：${dateTime} ${weekday}（北京时间，毫秒时间戳 ${nowMs}）`;
-}
+/**
+ * 北京时间工具
+ *
+ * 来源：从 dev/server/utils/time.js 复制（零改动）
+ *
+ * toISOString 是 UTC，直接用会在东八区凌晨误差 8 小时。
+ * 所有注入 LLM 的"当前时间"应该走这个 util，输出北京时间 + 星期。
+ */
+
+const WEEKDAY_CN = ['周日', '周一', '周二', '周三', '周四', '周五', '周六'];
+
+/**
+ * 返回北京时间的多种呈现，供不同 prompt 复用
+ * @returns {{ today: string, dateTime: string, weekday: string, nowMs: number, iso: string }}
+ *   today:     "2026-04-22"
+ *   dateTime:  "2026-04-22 14:32:05"
+ *   weekday:   "周三"
+ *   nowMs:     毫秒时间戳（给 LLM 做差值用）
+ *   iso:       "2026-04-22T14:32:05+08:00"
+ */
+export function formatBeijingNow() {
+  const now = new Date();
+  const nowMs = now.getTime();
+
+  // 转北京时间（东八区偏移）
+  const bj = new Date(nowMs + 8 * 3600 * 1000);
+  const y = bj.getUTCFullYear();
+  const m = String(bj.getUTCMonth() + 1).padStart(2, '0');
+  const d = String(bj.getUTCDate()).padStart(2, '0');
+  const hh = String(bj.getUTCHours()).padStart(2, '0');
+  const mm = String(bj.getUTCMinutes()).padStart(2, '0');
+  const ss = String(bj.getUTCSeconds()).padStart(2, '0');
+  const weekday = WEEKDAY_CN[bj.getUTCDay()];
+
+  const today = `${y}-${m}-${d}`;
+  const dateTime = `${today} ${hh}:${mm}:${ss}`;
+  const iso = `${today}T${hh}:${mm}:${ss}+08:00`;
+
+  return { today, dateTime, weekday, nowMs, iso };
+}
+
+/**
+ * 返回适合塞进 prompt 的一行文本
+ * "当前时间：2026-04-22 周三 14:32:05（北京时间，毫秒时间戳 1745...）"
+ */
+export function beijingNowLine() {
+  const { today, weekday, dateTime, nowMs } = formatBeijingNow();
+  return `当前时间：${dateTime} ${weekday}（北京时间，毫秒时间戳 ${nowMs}）`;
+}

package/server/style-pipeline/README.md

@@ -1,53 +1,53 @@
-# server/style-pipeline/ — 风格提取流水线
-
-**Nodesign 第二条核心通路**：用户上传参考素材（PPT / PDF / HTML）→ 提取结构化 style tokens → 喂给 engine 下游。
-
-## 为什么这个模块独立于 engine
-
-组长释放的产品意图：当前 deskskill-engine 是"brief → metaphor 推导 → deck"单管道，但真实需求是"风格参考"——用户上传已有 deck，想保留其视觉语言做新内容。
-
-**这事儿是后端工程问题，不是 skill 问题**：色板抽样、字体识别、spacing 测量、layout grid 推断——按训练分布让 LLM 用 declarative 路径描述风格会丢精度（procedural / declarative 能力诊断已知）。所以做工程化提取，输出结构化 tokens 喂 skill 下游。
-
-## 输入 / 输出契约（待设计）
-
-**输入**：
-- `application/pdf` — PDF 演示稿
-- `.pptx` — PowerPoint
-- `.html` — 已有 HTML deck（最干净，可能首推 MVP）
-
-**输出**：`StyleTokens` 结构化 JSON（schema 待定），大致：
-```json
-{
-  "palette": {
-    "background": ["#fffaf0", "#f0e8d8"],
-    "foreground": ["#1a1a1a", "#666"],
-    "accent": ["#c83e3e"]
-  },
-  "typography": {
-    "display": { "family": "...", "weight": 800, "tracking": "-0.02em" },
-    "body":    { "family": "...", "weight": 400, "size_clamp": "..." }
-  },
-  "spacing": { "rhythm": [4, 8, 16, 32, 64], "page_padding": "..." },
-  "layout": { "grid": "12-col" | "asymmetric" | ..., "alignment": "..." },
-  "motion_signals": [...],   // 如果是 HTML，可静态扫到 transition / animation
-  "metaphor_hints": "..."    // 可选：让 LLM 看一眼后给一句话直觉总结
-}
-```
-
-## 技术路线候选（动工前需先做根因诊断）
-
-⚠️ **先别选实现方式**。组长说之前用模版 skill 试过风格参考路径效果不好——根因待诊断（参 [HANDOVER.md](../../HANDOVER.md) §六）。
-
-提取技术几条候选路线：
-- **PDF / PPTX**：`pdf2htmlEX` / `python-pptx` / `LibreOffice headless` 转中间格式后扫
-- **HTML**：DOM + computed style 直接读
-- **视觉路径**：截图 → vision model（Kimi K2.6 / Claude Opus）描述 + 关键元素裁切
-- **混合**：DOM 提骨架 + vision 提语义（推荐）
-
-## 与 engine 的接口
-
-style-pipeline 输出的 `StyleTokens` 作为 engine `runs` 的 `inputs.style_reference` 传入，engine 在加载 deskskill-engine 时把 tokens 注入 system prompt 一段，让 metaphor 推导跟 reference 对话（不是替代 metaphor）。
-
-## 责任划分
-
-负责人：你。新东西。
+# server/style-pipeline/ — 风格提取流水线
+
+**Nodesign 第二条核心通路**：用户上传参考素材（PPT / PDF / HTML）→ 提取结构化 style tokens → 喂给 engine 下游。
+
+## 为什么这个模块独立于 engine
+
+组长释放的产品意图：当前 deskskill-engine 是"brief → metaphor 推导 → deck"单管道，但真实需求是"风格参考"——用户上传已有 deck，想保留其视觉语言做新内容。
+
+**这事儿是后端工程问题，不是 skill 问题**：色板抽样、字体识别、spacing 测量、layout grid 推断——按训练分布让 LLM 用 declarative 路径描述风格会丢精度（procedural / declarative 能力诊断已知）。所以做工程化提取，输出结构化 tokens 喂 skill 下游。
+
+## 输入 / 输出契约（待设计）
+
+**输入**：
+- `application/pdf` — PDF 演示稿
+- `.pptx` — PowerPoint
+- `.html` — 已有 HTML deck（最干净，可能首推 MVP）
+
+**输出**：`StyleTokens` 结构化 JSON（schema 待定），大致：
+```json
+{
+  "palette": {
+    "background": ["#fffaf0", "#f0e8d8"],
+    "foreground": ["#1a1a1a", "#666"],
+    "accent": ["#c83e3e"]
+  },
+  "typography": {
+    "display": { "family": "...", "weight": 800, "tracking": "-0.02em" },
+    "body":    { "family": "...", "weight": 400, "size_clamp": "..." }
+  },
+  "spacing": { "rhythm": [4, 8, 16, 32, 64], "page_padding": "..." },
+  "layout": { "grid": "12-col" | "asymmetric" | ..., "alignment": "..." },
+  "motion_signals": [...],   // 如果是 HTML，可静态扫到 transition / animation
+  "metaphor_hints": "..."    // 可选：让 LLM 看一眼后给一句话直觉总结
+}
+```
+
+## 技术路线候选（动工前需先做根因诊断）
+
+⚠️ **先别选实现方式**。组长说之前用模版 skill 试过风格参考路径效果不好——根因待诊断（参 [HANDOVER.md](../../HANDOVER.md) §六）。
+
+提取技术几条候选路线：
+- **PDF / PPTX**：`pdf2htmlEX` / `python-pptx` / `LibreOffice headless` 转中间格式后扫
+- **HTML**：DOM + computed style 直接读
+- **视觉路径**：截图 → vision model（Kimi K2.6 / Claude Opus）描述 + 关键元素裁切
+- **混合**：DOM 提骨架 + vision 提语义（推荐）
+
+## 与 engine 的接口
+
+style-pipeline 输出的 `StyleTokens` 作为 engine `runs` 的 `inputs.style_reference` 传入，engine 在加载 deskskill-engine 时把 tokens 注入 system prompt 一段，让 metaphor 推导跟 reference 对话（不是替代 metaphor）。
+
+## 责任划分
+
+负责人：你。新东西。

package/server/ws/broker.js

@@ -1,36 +1,39 @@
-/**
- * server/ws/broker.js — Per-project EventBus 注册表
- *
- * 每个 project 一个 EventBus 实例，agent runAgent 跑 turn 时通过 ctx.eventBus.publish
- * 推事件，WS 客户端订阅同一个 bus 收 stream。
- *
- * Bus 是 in-memory pub/sub，不持久化。重启 server 后所有订阅断开，新事件从零开始；
- * 前端要能容忍这个（重连后通过 hydrate 重新拉项目状态，丢的事件不补）。
- */
-
-import { EventBus } from '../engine/agent/events.js';
-import { attachLiveTurnTracker } from '../engine/runs/live-turn.js';
-
-/** @type {Map<string, EventBus>} */
-const projectBuses = new Map();
-
-/** 拿 project 的 EventBus（懒创建） */
-export function getProjectBus(projectId) {
-  let bus = projectBuses.get(projectId);
-  if (!bus) {
-    bus = new EventBus();
-    // live-turn 快照折叠器：进行中 turn 的事件物化成可恢复状态，
-    // WS 重连走"hydrate + ws.live_turn 快照 + 尾随"三段协议。见 live-turn.js
-    attachLiveTurnTracker(bus);
-    projectBuses.set(projectId, bus);
-  }
-  return bus;
-}
-
-/**
- * project 删除时清理 bus（释放内存）。
- * 不影响已建立的 ws 连接 — 它们还能 publish 但不再有订阅者。
- */
-export function disposeProjectBus(projectId) {
-  projectBuses.delete(projectId);
-}
+/**
+ * server/ws/broker.js — Per-project EventBus 注册表
+ *
+ * 每个 project 一个 EventBus 实例，agent runAgent 跑 turn 时通过 ctx.eventBus.publish
+ * 推事件，WS 客户端订阅同一个 bus 收 stream。
+ *
+ * Bus 是 in-memory pub/sub，不持久化。重启 server 后所有订阅断开，新事件从零开始；
+ * 前端要能容忍这个（重连后通过 hydrate 重新拉项目状态，丢的事件不补）。
+ */
+
+import { EventBus } from '../engine/agent/events.js';
+import { attachLiveTurnTracker } from '../engine/runs/live-turn.js';
+import { attachBoardTasklist } from '../engine/runs/board-tasklist.js';
+
+/** @type {Map<string, EventBus>} */
+const projectBuses = new Map();
+
+/** 拿 project 的 EventBus（懒创建） */
+export function getProjectBus(projectId) {
+  let bus = projectBuses.get(projectId);
+  if (!bus) {
+    bus = new EventBus();
+    // live-turn 快照折叠器：进行中 turn 的事件物化成可恢复状态，
+    // WS 重连走"hydrate + ws.live_turn 快照 + 尾随"三段协议。见 live-turn.js
+    attachLiveTurnTracker(bus);
+    // 步骤清单镜像成板书 + 每步产物连线（2026-08-23 黑板文化，harness 做不靠 agent 记得）
+    attachBoardTasklist(bus, projectId);
+    projectBuses.set(projectId, bus);
+  }
+  return bus;
+}
+
+/**
+ * project 删除时清理 bus（释放内存）。
+ * 不影响已建立的 ws 连接 — 它们还能 publish 但不再有订阅者。
+ */
+export function disposeProjectBus(projectId) {
+  projectBuses.delete(projectId);
+}