@xiaobuyu/nodesign 0.0.1

package/server/api/standalone-fit.js

@@ -0,0 +1,168 @@
+/**
+ * server/api/standalone-fit.js — 唯一权威 fit script source
+ *
+ * 范式（2026-05-08）：每个 <section data-page> 写设计稿原坐标，系统自动给每
+ * section 包 100vw×100vh `__nd-page-frame` + scroll-snap-y mandatory，单页
+ * 铺满 viewport，滚轮 / 键盘按页切。CSS min(100vw/W, 100vh/H) 缩放 letterbox
+ * 居中，纯 CSS 自适应不用 JS resize handler。
+ *
+ * 多比例支持（2026-05-08 增）：deck 比例由 wrap data-deck-aspect 声明，3 档：
+ *   "16:9"  1920×1080（默认，PPT 标准）
+ *   "9:16"  1080×1920（竖屏 / 手机 / 短故事）
+ *   "4:3"   1440×1080（老投影 / 经典 PPT）
+ * CSS 通过 attribute selector 直接派发 --deck-w / --deck-h，无需 JS 设。
+ *
+ * iframe + standalone 行为一致（不再 window!==top 早退）：
+ *   - frame 包装在 iframe 内也跑，preview 跟离线打开渲染一致
+ *   - parent CanvasFrame 把 iframe 元素本身固定为 deck 比例 logical viewport，
+ *     再用 CSS transform 缩放 iframe 元素到 wrap 大小
+ *
+ * 三个调用方共享：
+ *   - exports.js `injectViewportFit`（非 hybrid 导出薄包装）
+ *   - exports/build-standalone.js（hybrid 导出主路径）
+ *   - canvas.js GET /canvas（preview iframe 路径）
+ */
+
+import { ASPECT_PRESETS, DEFAULT_ASPECT } from '../shared/deck.js';
+
+/**
+ * 返回 fit script 内容（不含 <script> tag）
+ * 只做 frame 包装，CSS var 派发由 fitStyleTag 的 attribute selector 直接处理
+ *
+ * @returns {string}
+ */
+export function fitScriptCode() {
+  return `(function(){
+  var body = document.body;
+  if (!body) return;
+
+  var wrap = body.querySelector(':scope > .__nd-deck-wrap');
+  if (!wrap) {
+    wrap = document.createElement('div');
+    wrap.className = '__nd-deck-wrap';
+    while (body.firstChild && body.firstChild !== wrap) wrap.appendChild(body.firstChild);
+    body.appendChild(wrap);
+  }
+  body.classList.add('__nd-fit-active');
+
+  // 给每个 section[data-page] 包 100vw × 100vh frame（idempotent）
+  // 滚轮 / 键盘按 frame 边界 snap 切页；CSS scale 单独处理 letterbox 居中
+  var sections = Array.prototype.slice.call(wrap.querySelectorAll(':scope > section[data-page]'));
+  for (var i = 0; i < sections.length; i++) {
+    var s = sections[i];
+    if (s.parentElement && s.parentElement.classList.contains('__nd-page-frame')) continue;
+    var frame = document.createElement('div');
+    frame.className = '__nd-page-frame';
+    s.parentNode.insertBefore(frame, s);
+    frame.appendChild(s);
+  }
+
+  // 演讲模式 — F 键切换浏览器 fullscreen
+  // 16:9 显示器进 fullscreen 后浏览器 chrome 退场，可视区 = 物理屏 = 画布比例 → 黑边消失
+  // ESC 退出由 Fullscreen API 自带，不重复绑（避免干扰其他用 ESC 的内容）
+  // input guard 跟 navigation script 一致，防输入框冲突
+  document.addEventListener('keydown', function(e){
+    var t = e.target;
+    if (t && (t.isContentEditable || /^(INPUT|TEXTAREA|SELECT)$/.test(t.tagName))) return;
+    if (e.key === 'f' || e.key === 'F') {
+      e.preventDefault();
+      if (document.fullscreenElement) {
+        document.exitFullscreen();
+      } else if (document.documentElement.requestFullscreen) {
+        document.documentElement.requestFullscreen();
+      }
+    }
+  });
+})();`;
+}
+
+/**
+ * 返回 fit 配套 <style> tag（含 wrapping tag）
+ *
+ * 多比例 attribute selectors：wrap data-deck-aspect 决定 --deck-w / --deck-h
+ * 不声明 = 默认 16:9 (1920×1080)
+ *
+ * !important 用在 layout reset 三条上：兼容老 canvas.html 自带的 wrap-level fit
+ * CSS（body.__nd-fit-active flex+align-items:center / wrap width:1920px+transform 等），
+ * 否则老 deck 在新 frame 范式下会被偏左渲染。新 deck 模板已不含老 CSS，无害。
+ *
+ * @returns {string}
+ */
+export function fitStyleTag() {
+  // 把 ASPECT_PRESETS 编译成 attribute selector CSS（写死避免 JS 跑前 flash）
+  const aspectRules = Object.entries(ASPECT_PRESETS).map(([key, dims]) =>
+    `.__nd-deck-wrap[data-deck-aspect="${key}"] { --deck-w: ${dims.width}px; --deck-h: ${dims.height}px; }`
+  ).join('\n');
+  const def = ASPECT_PRESETS[DEFAULT_ASPECT];
+  return `<style id="__nd-standard-fit-style">
+:root {
+  --deck-w: ${def.width}px;
+  --deck-h: ${def.height}px;
+  --nd-page-scale: min(calc(100vw / var(--deck-w)), calc(100vh / var(--deck-h)));
+}
+${aspectRules}
+html, body { margin: 0; padding: 0; }
+body.__nd-fit-active {
+  display: block !important;
+  /* letterbox 填充色：agent 可在 deck CSS 里覆盖 --nd-letterbox-bg
+     默认继承 deck 主背景 var(--bg)，无 --bg 时兜底黑色（演讲投影标准） */
+  background: var(--nd-letterbox-bg, var(--bg, #000));
+  scroll-snap-type: y mandatory;
+  overflow-x: hidden;
+}
+body.__nd-fit-active > .__nd-deck-wrap {
+  display: block !important;
+  width: auto !important;
+  margin: 0 !important;
+  transform: none !important;
+  transform-origin: 0 0 !important;
+}
+.__nd-page-frame {
+  width: 100vw;
+  height: 100vh;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  overflow: hidden;
+  scroll-snap-align: start;
+  /* 跟 body 同源 letterbox 色（inherit 在 background 上不会跨级，必须显式重写） */
+  background: var(--nd-letterbox-bg, var(--bg, #000));
+}
+.__nd-page-frame > section[data-page] {
+  flex-shrink: 0;
+  width: var(--deck-w);
+  height: var(--deck-h);
+  transform-origin: center center;
+  transform: scale(var(--nd-page-scale));
+  position: relative;
+}
+
+/* 演讲模式 — 隐藏视口滚动条（root + body 双挂以覆盖渲染差异）
+   N×100vh 的 page frame 总高度让 root element 自然出滚动条；
+   :has() 把规则挂到 <html> 是关键（滚动条真正所在的元素）。
+   兼容：Chrome 105+ / Safari 15.4+ / Firefox 121+，零 fallback 代价。 */
+html:has(body.__nd-fit-active),
+body.__nd-fit-active {
+  scrollbar-width: none;
+  -ms-overflow-style: none;
+}
+html:has(body.__nd-fit-active)::-webkit-scrollbar,
+body.__nd-fit-active::-webkit-scrollbar {
+  display: none;
+  width: 0;
+  height: 0;
+}
+</style>`;
+}
+
+/**
+ * 返回完整 <script>+<style> 注入块（最常用形态）
+ *
+ * @returns {string}
+ */
+export function fitInjectionBlock() {
+  return `<script id="__nd-standard-fit" data-nodesign-keep="fit">
+${fitScriptCode()}
+</script>
+${fitStyleTag()}`;
+}

package/server/api/turn-compose.js

@@ -0,0 +1,180 @@
+/**
+ * 一条 user message 的组装（2026-08-17 从 turn.js 拆出 —— 行数棘轮，
+ * turn.js 是路由层，"chat + 附件怎么变成 SDK content blocks"是独立的一件事，
+ * 拆之前它占了那个文件的六分之一）。
+ *
+ * 对外只有 composeUserMessage 一个出口；inline 图那段是它的私事。
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import { safeResolveRead } from '../lib/safe-path.js';
+import { isExtractable } from '../lib/doc-extract.js';
+
+/** 直接 image input 阈值：> 1MB 走 path 让 agent Read，< 1MB inline base64 */
+const IMAGE_INLINE_MAX_BYTES = 1 * 1024 * 1024;
+/** Anthropic API 支持的 image media types（sdk-tools.d.ts:150 + API doc） */
+const IMAGE_MEDIA_TYPES = new Set(['image/jpeg', 'image/png', 'image/gif', 'image/webp']);
+
+/**
+ * 把 chat 文本 + attachments 拼成 SDK content blocks 数组。
+ *
+ * 返回：
+ *   - displayText: 用于 createRun 审计 + run.error 时前端显示 fallback
+ *   - blocks: BetaContentBlockParam[]（喂 SDK 的 user message content）
+ *
+ * 策略：
+ *   - **小图（< 1MB） inline base64** → user message 顶层 image content block，
+ *     agent 一上来就能 vision 看见参考图，不用先 Read。Kimi vision 通过
+ *     binary-fixup-proxy 已验证（lift transform 仅处理 tool_result 嵌套；
+ *     user message 顶层 image 直接走标准路径，无需 lift）。
+ *   - **大图（>= 1MB）/ 非 image / 文档** → 文本路径让 agent Read（避免大文件
+ *     爆 user message token，配合 prelude 的"开工前必看 ./assets/"硬规则）
+ *   - **anchor / comment 类型** → 文本描述
+ *
+ * Anthropic image content block 仅支持 jpeg/png/gif/webp，不支持 svg/heic 等。
+ * 不在白名单的 image mime → 按文本路径降级。
+ */
+export async function composeUserMessage(chat, attachments, pendingSummary, sessionRoot) {
+  const blocks = [];
+
+  // C4：用户在过去时段做的 direct edit + comment → prepend system 提示
+  // 不灌详情（让 agent 主动调 mcp__nodesign__get_pending_changes 拉），省 token
+  if (pendingSummary && pendingSummary.count > 0) {
+    blocks.push({
+      type: 'text',
+      text: `<system>${pendingSummary.summary}。可调 mcp__nodesign__get_pending_changes 查看详情；处理完调 mcp__nodesign__clear_pending_changes 清 buffer。</system>`,
+    });
+  }
+
+  // （素材摘要 08-21 搬去 hooks/user-prompt-submit.js 的状态块：首轮全量、之后只报变化；
+  //   这里不再拼进用户消息 —— 两条线两个真相源的病，顺手把"assets 是 symlink"那句假话删了。）
+
+  // 空文字块会被 API 直接判 400（text content block 不许为空），所以只发附件的
+  // 那条消息这里不能盲推。改成一句交代处境的话 —— agent 得知道"用户没说话"是
+  // 事实本身，而不是以为上下文丢了。
+  if (chat && chat.trim()) {
+    blocks.push({ type: 'text', text: chat });
+  } else {
+    blocks.push({ type: 'text', text: '[用户只发了附件，没有附带文字。先看附件再问他想拿它做什么]' });
+  }
+
+  if (Array.isArray(attachments) && attachments.length > 0) {
+    // 先尝试给 image attachment inline base64；inline 失败的当 path 走文本路径
+    const inlineImageNames = [];
+    const fallbackLines = [];
+    // Office 三件套单独一队：**普通 Read 读它们只会拿到二进制乱码而且不报错**，
+    // 底下那句"用 Read 读取"对这几种是错的指路，agent 会拿着空气往下干
+    const docLines = [];
+
+    for (const a of attachments) {
+      if (!a || typeof a !== 'object') continue;
+      if (a.type === 'anchor') {
+        fallbackLines.push(`- 选中元素: page=${a.pageIndex} ${a.tag || 'element'} ${a.text ? `"${a.text}"` : ''}`);
+        continue;
+      }
+      if (a.type === 'comment') {
+        fallbackLines.push(`- 评论: ${a.text} (anchor: ${JSON.stringify(a.anchor || {})})`);
+        continue;
+      }
+      // asset 路径分支（assets API 返回 path 形如 '../../shared/assets/<name>'）
+      if (!a.path) continue;
+      const inline = await tryInlineImageAttachment(a, sessionRoot);
+      if (inline) {
+        blocks.push(inline);
+        inlineImageNames.push(a.name || path.basename(a.path));
+      } else if (isExtractable(a.path)) {
+        docLines.push(`- ${a.path}${a.name ? `（${a.name}）` : ''}`);
+      } else {
+        fallbackLines.push(`- ${a.path}${a.name ? `（${a.name}）` : ''}`);
+      }
+    }
+
+    if (inlineImageNames.length > 0) {
+      blocks.push({
+        type: 'text',
+        text: `[已直接附上 ${inlineImageNames.length} 张参考图：${inlineImageNames.join('、')} —— 你可以直接 vision 看，不需要再 Read]`,
+      });
+    }
+    if (fallbackLines.length > 0) {
+      blocks.push({
+        type: 'text',
+        text: `可用素材（用 Read 工具读取，路径相对 workspace）：\n${fallbackLines.join('\n')}`,
+      });
+    }
+    if (docLines.length > 0) {
+      blocks.push({
+        type: 'text',
+        text: `Office 文档（**用 mcp__nodesign__read_document 读，不要用 Read** ——`
+          + ` 这几种是 zip 包，Read 会返回二进制且不报错）：\n${docLines.join('\n')}`,
+      });
+    }
+  }
+
+  // （comment 附件的「改前回看 design-plan / spec.json」提醒 08-21 删：plan 模式整体移除，两个文件都没人再写；评论怎么处理 prelude § DirectEdit 已讲）
+
+  // displayText：合并 blocks 用 \n\n，给 DB 审计 / fallback 显示用
+  // image block 用占位文本而非 base64（base64 进 DB / 前端 fallback 都没意义）
+  const displayText = blocks.map((b) => {
+    if (b.type === 'image') return '[image]';
+    return b.text || `[${b.type}]`;
+  }).join('\n\n');
+
+  return { displayText, blocks };
+}
+
+/**
+ * 尝试把 attachment 直接读成 image content block。
+ * 失败（不是 image / 太大 / 读取失败 / mime 不在白名单）返 null，让调用方
+ * 走 path 字符串 fallback。
+ *
+ * @param {object} attachment - { path, name?, mime?, size? }
+ * @param {string} sessionRoot - 绝对路径，sessions/<sid>/
+ * @returns {Promise<null | { type: 'image', source: { type: 'base64', media_type, data } }>}
+ */
+async function tryInlineImageAttachment(attachment, sessionRoot) {
+  const mime = attachment.mime;
+  if (!mime || !IMAGE_MEDIA_TYPES.has(mime)) return null;
+
+  // ⛔ 上面这段注释原来写着"并校验解析后仍在 project workspace 内（防 path traversal）"
+  // —— **代码里根本没有这个校验**。真攻过（2026-08-18）：
+  //   path: '../../<别人的 pid>/shared/.../x.png' → 别的用户的图被 base64 塞进
+  //   我这轮的 context（多租户隔离直接破）；
+  //   path: '../../../../.env'                   → 服务端 .env 原文进 context
+  //   （解出来第一行就是 "# === Nodesign 服务端环境变量 ==="）。
+  // 判据用仓库里已有的那一份 safeResolveRead（realpath 复核，软链也拦）。
+  //
+  // ⚠️ 顺带修一个**静默坏了很久**的东西：assets API 至今返回
+  // `../../shared/assets/<name>`，那是扁平化之前 `sessions/<sid>/` 时代的相对路径。
+  // 扁平化后 sessionRoot 就是 `<pid>/shared`，它解析到 `projects-data/shared/...`
+  // （不存在）→ stat 失败 → **静默不内联**，agent 只拿到一行文字而不是图。
+  // 实测：`../../shared/assets/x.png` MISSING、`assets/x.png` INLINED。
+  // 在这儿把老前缀剥掉（跟 artifact-file 那条 `tasks/` 兼容同一个思路）。
+  const relRaw = String(attachment.path || '').replace(/^(?:\.\.\/)+shared\//, '');
+  const absPath = await safeResolveRead(sessionRoot, relRaw);
+  if (!absPath) return null;
+
+  let stat;
+  try {
+    stat = await fs.stat(absPath);
+  } catch {
+    return null;
+  }
+  if (!stat.isFile()) return null;
+  if (stat.size > IMAGE_INLINE_MAX_BYTES) return null;
+
+  let buf;
+  try {
+    buf = await fs.readFile(absPath);
+  } catch {
+    return null;
+  }
+
+  return {
+    type: 'image',
+    source: {
+      type: 'base64',
+      media_type: mime,
+      data: buf.toString('base64'),
+    },
+  };
+}

package/server/api/turn-inflight.js

@@ -0,0 +1,44 @@
+/**
+ * server/api/turn-inflight.js — POST /turn 的 requestId 去重（2026-08-20 从 turn.js 拆出，
+ * 行数棘轮；逻辑原样）。
+ */
+
+/**
+ * Phase A.6（2026-05-07）：requestId LRU dedup —— 弱网下用户重发 / fetch retry
+ * 同 requestId 直接返已存在的 { runId, sessionId }，不重复 createRun / startNewRunSession。
+ *
+ * 数据：Map<requestId, { pid, runId, sessionId, ts }>，简单 5 分钟 TTL + 1024 容量上限
+ * （超过先驱逐最旧）。同进程内存，重启清空（此时活 run 也都死了，一致）。
+ *
+ * race 修复（2026-05-08）：原版 lruGet → createRun → lruPut 之间无并发保护。两个
+ * 并发 POST 同 requestId 都通过 lruGet 返 null → 各自 createRun → 双 run 同 sid
+ * 推进同 inputQueue → agent 收两条同 chat 处理两轮（双倍 token / canvas 双写）。
+ *
+ * 加 inflightTurns Map<requestId, Promise<result>>：第一 POST 进来注册 in-flight
+ * Promise；第二 POST 看到 in-flight 就 await 拿第一个的 result 返 deduped。
+ * 第一个 POST 拿到 res 写完 lruPut + resolveInflight，5s 后 delete in-flight（让
+ * LRU 接管后续幂等查询）。
+ */
+const REQUEST_LRU_TTL_MS = 5 * 60 * 1000;
+const REQUEST_LRU_MAX = 1024;
+const requestLru = new Map();
+export const inflightTurns = new Map();  // requestId → Promise<{ pid, runId, sessionId }>
+export const INFLIGHT_RETENTION_MS = 5_000;
+export function lruGet(requestId) {
+  const rec = requestLru.get(requestId);
+  if (!rec) return null;
+  if (Date.now() - rec.ts > REQUEST_LRU_TTL_MS) {
+    requestLru.delete(requestId);
+    return null;
+  }
+  return rec;
+}
+export function lruPut(requestId, rec) {
+  if (requestLru.size >= REQUEST_LRU_MAX) {
+    // 驱逐最早（Map 保留插入顺序）
+    const firstKey = requestLru.keys().next().value;
+    if (firstKey) requestLru.delete(firstKey);
+  }
+  requestLru.set(requestId, { ...rec, ts: Date.now() });
+}
+