@xiaobuyu/nodesign 0.0.1 → 0.0.2

package/server/api/turn-compose.js

@@ -1,180 +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'),
-    },
-  };
-}
+/**
+ * 一条 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

@@ -1,44 +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() });
-}
-
+/**
+ * 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() });
+}
+

package/server/auth/README.md

@@ -1,17 +1,17 @@
-# server/auth/ — 鉴权（占位）
-
-⚠️ **暂不实现**。组长说"账号/鉴权/部署 复用已有平台基础设施"——但**"已有平台"具体指什么尚未确认**（[HANDOVER.md](../../HANDOVER.md) §五 Q1）。
-
-## 三种可能形态
-
-| 形态 | 对接方式 | 复杂度 |
-|---|---|---|
-| **A. 平台 SSO**（最可能） | 接平台的 OAuth/OIDC，验 platform issued token | 看平台文档 |
-| **B. 自建** | JWT + bcrypt，复用 [dev/server/middleware/auth.js](../../../dev/server/middleware/auth.js) 模式 | 中 |
-| **C. 内部测试期** | 单一 `INTERNAL_API_TOKEN` Bearer，绕过用户系统 | 极低（MVP 用） |
-
-## 决策点
-
-跟组长对齐前先用 **C**——MVP 阶段只对内部测试者开放，避免锁错鉴权架构后期重构。
-
-对齐到具体平台后再写 `auth/middleware.js` + `auth/session.js`。
+# server/auth/ — 鉴权（占位）
+
+⚠️ **暂不实现**。组长说"账号/鉴权/部署 复用已有平台基础设施"——但**"已有平台"具体指什么尚未确认**（[HANDOVER.md](../../HANDOVER.md) §五 Q1）。
+
+## 三种可能形态
+
+| 形态 | 对接方式 | 复杂度 |
+|---|---|---|
+| **A. 平台 SSO**（最可能） | 接平台的 OAuth/OIDC，验 platform issued token | 看平台文档 |
+| **B. 自建** | JWT + bcrypt，复用 [dev/server/middleware/auth.js](../../../dev/server/middleware/auth.js) 模式 | 中 |
+| **C. 内部测试期** | 单一 `INTERNAL_API_TOKEN` Bearer，绕过用户系统 | 极低（MVP 用） |
+
+## 决策点
+
+跟组长对齐前先用 **C**——MVP 阶段只对内部测试者开放，避免锁错鉴权架构后期重构。
+
+对齐到具体平台后再写 `auth/middleware.js` + `auth/session.js`。