@xiaobuyu/nodesign 0.0.1

package/server/ops/macos-fonts.conf

@@ -0,0 +1,336 @@
+<?xml version="1.0"?>
+<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
+<!--
+  server/ops/macos-fonts.conf — fontconfig 配置：让 Linux server 端的 generic
+  font family（serif / sans-serif / monospace / system-ui / -apple-system /
+  BlinkMacSystemFont）落到 macOS 字体上。
+
+  ⚠️ 文件加载顺序（关键）：必须装在 /etc/fonts/conf.d/65-macos.conf。
+  - 60-latin.conf：把 sans-serif → DejaVu/Liberation 等 latin alias
+  - 65-macos.conf（本文件）：在 latin 之后强 prepend macOS 字体
+  - 69-language-selector-*.conf：lang-specific 中文/日文 alias
+  - 99-* 顺序最后，如果放 99 反而被 69-language-selector-zh-cn.conf 反 override
+
+  ⚠️ alias 写法：必须用 `<match target="pattern">` + `mode="prepend_first"`。
+  prepend_first 是 fontconfig 文档里 "force strong binding + insert at head"
+  最高优先级写法。`<alias><prefer>` 和 `prepend + binding=strong` 都不够狠，
+  会被 Debian/Ubuntu 默认规则压在后面（实测 fc-match sans-serif:lang=zh-cn
+  仍命中 Helvetica Neue）。
+
+  ⚠️ lang=zh 的 sans-serif/system-ui 必须有显式复合 match——光 prepend
+  PingFang 到 sans-serif 不够，因为 fontconfig 处理 lang=zh 时会用 charset
+  覆盖率重新排序，把没中文 glyph 的 latin 字体（Helvetica Neue）反而排前。
+  显式复合 match (sans-serif AND lang contains zh) 强 prepend，能盖过这条。
+
+  ⚠️ 法律：苹果字体（PingFang / Songti / SF Pro）是 Apple 商业授权字体，
+  仅限内部使用，禁止打包进面向最终用户的产物（baked HTML 不内联这些字体）。
+  这份配置只影响 server 端渲染（PDF/PPT），不会让字体随 deck 外传。
+-->
+<fontconfig>
+
+  <!-- ══════════════════════════════════════════════════════════════════ -->
+  <!-- 第一组：generic family alias（lang 无关，统一 prepend 苹果字体）        -->
+  <!-- ══════════════════════════════════════════════════════════════════ -->
+
+  <!-- generic serif → Songti SC（中文衬线宋体） -->
+  <match target="pattern">
+    <test qual="any" name="family">
+      <string>serif</string>
+    </test>
+    <edit name="family" mode="prepend_first" binding="strong">
+      <string>Songti SC</string>
+      <string>STSong</string>
+    </edit>
+  </match>
+
+  <!-- generic sans-serif → PingFang SC（中文黑体） -->
+  <match target="pattern">
+    <test qual="any" name="family">
+      <string>sans-serif</string>
+    </test>
+    <edit name="family" mode="prepend_first" binding="strong">
+      <string>PingFang SC</string>
+      <string>Heiti SC</string>
+    </edit>
+  </match>
+
+  <!-- system-ui → SF Pro（macOS 系统 UI 字体） -->
+  <match target="pattern">
+    <test qual="any" name="family">
+      <string>system-ui</string>
+    </test>
+    <edit name="family" mode="prepend_first" binding="strong">
+      <string>.SF NS</string>
+      <string>.SF NS Text</string>
+      <string>SF Pro Text</string>
+      <string>SF Pro Display</string>
+      <string>Helvetica Neue</string>
+      <string>PingFang SC</string>
+    </edit>
+  </match>
+
+  <!-- -apple-system / BlinkMacSystemFont → 同 system-ui -->
+  <match target="pattern">
+    <test qual="any" name="family">
+      <string>-apple-system</string>
+    </test>
+    <edit name="family" mode="prepend_first" binding="strong">
+      <string>.SF NS</string>
+      <string>SF Pro Text</string>
+      <string>Helvetica Neue</string>
+      <string>PingFang SC</string>
+    </edit>
+  </match>
+  <match target="pattern">
+    <test qual="any" name="family">
+      <string>BlinkMacSystemFont</string>
+    </test>
+    <edit name="family" mode="prepend_first" binding="strong">
+      <string>.SF NS</string>
+      <string>SF Pro Text</string>
+      <string>Helvetica Neue</string>
+      <string>PingFang SC</string>
+    </edit>
+  </match>
+
+  <!-- monospace → SF Mono / Menlo -->
+  <match target="pattern">
+    <test qual="any" name="family">
+      <string>monospace</string>
+    </test>
+    <edit name="family" mode="prepend_first" binding="strong">
+      <string>.SF NS Mono</string>
+      <string>SF Mono</string>
+      <string>Menlo</string>
+      <string>Monaco</string>
+    </edit>
+  </match>
+
+  <!-- ══════════════════════════════════════════════════════════════════ -->
+  <!-- 第二组：lang=zh 复合 match（强制中文字符走 PingFang/Songti）            -->
+  <!--                                                                      -->
+  <!-- 必要性：第一组 prepend 把 PingFang 放 list 前面，但 fontconfig 处理     -->
+  <!-- lang=zh 时会用"charset 覆盖率"重新排序，没中文 glyph 的 latin 字体     -->
+  <!-- 反而排前。显式复合 match 强 prepend 中文字体，盖过 charset 重排。      -->
+  <!-- ══════════════════════════════════════════════════════════════════ -->
+
+  <!-- sans-serif:lang=zh → 强制 PingFang SC 在最前 -->
+  <match target="pattern">
+    <test name="lang" compare="contains">
+      <string>zh</string>
+    </test>
+    <test qual="any" name="family">
+      <string>sans-serif</string>
+    </test>
+    <edit name="family" mode="prepend_first" binding="strong">
+      <string>PingFang SC</string>
+    </edit>
+  </match>
+
+  <!-- serif:lang=zh → 强制 Songti SC 在最前 -->
+  <match target="pattern">
+    <test name="lang" compare="contains">
+      <string>zh</string>
+    </test>
+    <test qual="any" name="family">
+      <string>serif</string>
+    </test>
+    <edit name="family" mode="prepend_first" binding="strong">
+      <string>Songti SC</string>
+    </edit>
+  </match>
+
+  <!-- system-ui / -apple-system :lang=zh → PingFang SC 在最前 -->
+  <match target="pattern">
+    <test name="lang" compare="contains">
+      <string>zh</string>
+    </test>
+    <test qual="any" name="family">
+      <string>system-ui</string>
+    </test>
+    <edit name="family" mode="prepend_first" binding="strong">
+      <string>PingFang SC</string>
+    </edit>
+  </match>
+  <match target="pattern">
+    <test name="lang" compare="contains">
+      <string>zh</string>
+    </test>
+    <test qual="any" name="family">
+      <string>-apple-system</string>
+    </test>
+    <edit name="family" mode="prepend_first" binding="strong">
+      <string>PingFang SC</string>
+    </edit>
+  </match>
+  <match target="pattern">
+    <test name="lang" compare="contains">
+      <string>zh</string>
+    </test>
+    <test qual="any" name="family">
+      <string>BlinkMacSystemFont</string>
+    </test>
+    <edit name="family" mode="prepend_first" binding="strong">
+      <string>PingFang SC</string>
+    </edit>
+  </match>
+
+  <!-- ══════════════════════════════════════════════════════════════════ -->
+  <!-- 第三组：通用 CJK fallback（任何字体在 zh charset 缺 glyph 时 append）  -->
+  <!-- ══════════════════════════════════════════════════════════════════ -->
+
+  <match target="pattern">
+    <test name="lang" compare="contains">
+      <string>zh</string>
+    </test>
+    <edit name="family" mode="append" binding="strong">
+      <string>PingFang SC</string>
+      <string>Songti SC</string>
+      <string>Heiti SC</string>
+      <string>Noto Sans SC</string>
+    </edit>
+  </match>
+
+  <!-- ══════════════════════════════════════════════════════════════════ -->
+  <!-- 第四组：Helvetica 别名（让 css 写 Helvetica 命中 macOS 自带）           -->
+  <!-- ══════════════════════════════════════════════════════════════════ -->
+
+  <match target="pattern">
+    <test qual="any" name="family">
+      <string>Helvetica</string>
+    </test>
+    <edit name="family" mode="prepend_first" binding="strong">
+      <string>Helvetica Neue</string>
+    </edit>
+  </match>
+
+  <!-- ══════════════════════════════════════════════════════════════════ -->
+  <!-- 第五组：剔除 Helvetica/Helvetica Neue 的 CJK lang 声明                -->
+  <!--                                                                      -->
+  <!-- Helvetica.ttc / HelveticaNeue.ttc 内部声明支持很多语言（macOS 用     -->
+  <!-- "中黑" 这种 style 名让 fontconfig 误识为它支持 zh），fc-match         -->
+  <!-- :lang=zh-cn 命中前 4 位都是 Helvetica Neue 各 style，PingFang 排第 5。-->
+  <!--                                                                      -->
+  <!-- 解法：用 target="font" 改写 Helvetica/Helvetica Neue 的 lang 集合，   -->
+  <!-- assign_replace 为只 latin 语言，剔除 zh/ja/ko。fontconfig 在 query   -->
+  <!-- :lang=zh 时就不会把它们纳入候选，PingFang 自然顶到第 1 位。           -->
+  <!--                                                                      -->
+  <!-- 副作用：css 显式写 font-family: 'Helvetica Neue' 时 latin 字符仍命中  -->
+  <!-- Helvetica Neue（family 优先级 > lang），中文字符 fallback 到 PingFang。-->
+  <!-- ══════════════════════════════════════════════════════════════════ -->
+  <match target="font">
+    <test name="family">
+      <string>Helvetica Neue</string>
+    </test>
+    <edit name="lang" mode="assign_replace" binding="strong">
+      <langset>
+        <string>en</string>
+        <string>fr</string>
+        <string>de</string>
+        <string>es</string>
+        <string>it</string>
+        <string>pt</string>
+        <string>ru</string>
+        <string>nl</string>
+        <string>sv</string>
+        <string>no</string>
+        <string>da</string>
+        <string>fi</string>
+        <string>pl</string>
+        <string>tr</string>
+      </langset>
+    </edit>
+  </match>
+  <match target="font">
+    <test name="family">
+      <string>Helvetica</string>
+    </test>
+    <edit name="lang" mode="assign_replace" binding="strong">
+      <langset>
+        <string>en</string>
+        <string>fr</string>
+        <string>de</string>
+        <string>es</string>
+        <string>it</string>
+        <string>pt</string>
+        <string>ru</string>
+        <string>nl</string>
+        <string>sv</string>
+        <string>no</string>
+        <string>da</string>
+        <string>fi</string>
+        <string>pl</string>
+        <string>tr</string>
+      </langset>
+    </edit>
+  </match>
+
+  <!-- ══════════════════════════════════════════════════════════════════ -->
+  <!-- 第六组：reject Linux 系统字体——server 端只剩苹果字体可选              -->
+  <!--                                                                      -->
+  <!-- 之前现象：fc-match -s sans-serif:lang=zh-cn 输出 list 里 Helvetica   -->
+  <!-- Neue 各 style 占前 4 位，PingFang 在第 5。Chromium 字符级 fallback   -->
+  <!-- 链不一定能走到 PingFang——某些字符就 fallback 到 DejaVu Sans 或方块。 -->
+  <!--                                                                      -->
+  <!-- 干净方案：直接把 Debian/Ubuntu 自带的 latin/CJK 系统字体全 reject，   -->
+  <!-- server 端字体池只剩苹果字体（PingFang/Songti/Helvetica/SF NS/Menlo） -->
+  <!-- + Google Fonts inline 字体。所有 generic family resolve 必然命中     -->
+  <!-- 苹果字体，不再有候选排序混乱。                                       -->
+  <!--                                                                      -->
+  <!-- 保留：Noto Color Emoji（不 reject 否则 emoji 渲染全断）              -->
+  <!--                                                                      -->
+  <!-- ⚠️ 副作用：所有依赖 fontconfig 的应用都看不到这些字体了。NoDesign     -->
+  <!-- server 独占场景 OK；如这台 server 上还跑别的应用要小心。              -->
+  <!-- ══════════════════════════════════════════════════════════════════ -->
+  <selectfont>
+    <rejectfont>
+      <!-- DejaVu 系列（Debian 默认 latin） -->
+      <pattern><patelt name="family"><string>DejaVu Sans</string></patelt></pattern>
+      <pattern><patelt name="family"><string>DejaVu Sans Mono</string></patelt></pattern>
+      <pattern><patelt name="family"><string>DejaVu Serif</string></patelt></pattern>
+      <pattern><patelt name="family"><string>DejaVu Math TeX Gyre</string></patelt></pattern>
+
+      <!-- Liberation 系列（RHEL 系 latin） -->
+      <pattern><patelt name="family"><string>Liberation Sans</string></patelt></pattern>
+      <pattern><patelt name="family"><string>Liberation Serif</string></patelt></pattern>
+      <pattern><patelt name="family"><string>Liberation Mono</string></patelt></pattern>
+      <pattern><patelt name="family"><string>Liberation Sans Narrow</string></patelt></pattern>
+
+      <!-- Noto 系列（latin + CJK 都 reject，让苹果字体接管） -->
+      <pattern><patelt name="family"><string>Noto Sans</string></patelt></pattern>
+      <pattern><patelt name="family"><string>Noto Serif</string></patelt></pattern>
+      <pattern><patelt name="family"><string>Noto Sans Mono</string></patelt></pattern>
+      <pattern><patelt name="family"><string>Noto Sans CJK SC</string></patelt></pattern>
+      <pattern><patelt name="family"><string>Noto Sans CJK TC</string></patelt></pattern>
+      <pattern><patelt name="family"><string>Noto Sans CJK JP</string></patelt></pattern>
+      <pattern><patelt name="family"><string>Noto Sans CJK KR</string></patelt></pattern>
+      <pattern><patelt name="family"><string>Noto Serif CJK SC</string></patelt></pattern>
+      <pattern><patelt name="family"><string>Noto Serif CJK TC</string></patelt></pattern>
+      <pattern><patelt name="family"><string>Noto Serif CJK JP</string></patelt></pattern>
+      <pattern><patelt name="family"><string>Noto Serif CJK KR</string></patelt></pattern>
+      <!-- Noto Color Emoji 故意保留——emoji 渲染必需 -->
+
+      <!-- 文泉驿系列（Debian 中文 fallback） -->
+      <pattern><patelt name="family"><string>WenQuanYi Zen Hei</string></patelt></pattern>
+      <pattern><patelt name="family"><string>WenQuanYi Micro Hei</string></patelt></pattern>
+      <pattern><patelt name="family"><string>WenQuanYi Zen Hei Mono</string></patelt></pattern>
+      <pattern><patelt name="family"><string>WenQuanYi Zen Hei Sharp</string></patelt></pattern>
+
+      <!-- GNU FreeFont 系列 -->
+      <pattern><patelt name="family"><string>FreeSans</string></patelt></pattern>
+      <pattern><patelt name="family"><string>FreeSerif</string></patelt></pattern>
+      <pattern><patelt name="family"><string>FreeMono</string></patelt></pattern>
+
+      <!-- Ubuntu 自带（如果是 Ubuntu server） -->
+      <pattern><patelt name="family"><string>Ubuntu</string></patelt></pattern>
+      <pattern><patelt name="family"><string>Ubuntu Mono</string></patelt></pattern>
+      <pattern><patelt name="family"><string>Ubuntu Condensed</string></patelt></pattern>
+
+      <!-- Bitstream / Vera（X11 老字体） -->
+      <pattern><patelt name="family"><string>Bitstream Vera Sans</string></patelt></pattern>
+      <pattern><patelt name="family"><string>Bitstream Vera Serif</string></patelt></pattern>
+      <pattern><patelt name="family"><string>Bitstream Vera Sans Mono</string></patelt></pattern>
+    </rejectfont>
+  </selectfont>
+
+</fontconfig>

package/server/ops/sandbox-shim/bwrap

@@ -0,0 +1,57 @@
+#!/bin/bash
+# bwrap 垫片 —— 绕开 apply-seccomp 的 unshare 竞态（2026-08-15）
+#
+# 📮 上游 issue：https://github.com/anthropics/claude-code/issues/86928
+#    （含 strace 时序、内核源码引用、49 行 C 最小复现、三条修法建议）
+#    ⏳ **这是临时设施**：上游修掉之后把整个目录连同 isolation.js 里的
+#    sandboxShimEnv() 一起摘掉，别让它变成永久的一层。
+#
+# 病：SDK 沙盒每条命令都以 `ARGV0=apply-seccomp /proc/self/fd/3 <命令>` 起手 ——
+# 那是那个 306MB bun 二进制**自我重执行**成 seccomp helper。bun 启动时 mimalloc
+# 会先起一根 `mi-scavenger` 线程，helper 随即把它关掉并 join；但内核在
+# `mm_release()` 里唤醒 joiner 的时机**早于** `release_task` 把死线程从
+# thread group 摘除，于是紧接着那句 `unshare(CLONE_NEWUSER)` 撞上
+# `!thread_group_empty` → EINVAL。（kernel/fork.c：CLONE_NEWUSER 会被隐式加上
+# CLONE_THREAD，而 check_unshare_flags 对 CLONE_THREAD 要求 thread group 为空。）
+#
+# 所以它是**内核级竞态**，不是配置问题：40 行 C 能脱离 claude 复现，1 vCPU 空载
+# 200/200 必炸，join 后加 50µs 睡眠就 0/200。机器越闲越容易炸（joiner 抢占了
+# 垂死线程），多核几乎见不到 —— 这是这台单核机特有的。
+#
+# 治：把那句 racy 的 syscall 从执行路径上拿掉。`unshare -U --map-current-user
+# --keep-caps` 由 util-linux **单线程**先把 user namespace 建好并把能力放进
+# ambient set，helper 进去后第一步 `unshare(NEWNS|NEWPID)` 直接成功，**根本不会
+# 走到那句 CLONE_NEWUSER**。helper 在 exec 载荷之前自带 PR_CAP_AMBIENT_CLEAR_ALL，
+# 能力不外泄。
+#
+# 安全不变量（每条都在真会话里验过，改这个文件前重验）：
+#   Seccomp: 2（filter 仍在）· AF_UNIX socket() 仍被拒（pm2 rpc.sock 逃逸路照旧关着）
+#   · uid 仍是 1000 · userns 嵌套层数不变 · ambient caps 在载荷 exec 前清空
+#
+# ⚠️ 这是垫在 SDK 内部实现上的补丁，**pattern 变了就自动失效**（原样透传 = 退回
+# 现状的偶发，不会退成"没有沙盒"）。升 SDK 之后查 $NODESIGN_SHIM_LOG 里
+# rewrote=1 的计数还在不在涨。
+#
+# 上游修法（issue 里提的三条）：对 EINVAL 做有界重试 + sched_yield（最简单，
+# 实测 50µs 退避就闭合窗口）／改成轮询 /proc/self/status 的 Threads: 到 1
+# 再 unshare／让 helper 在运行时起线程之前就把 namespace 建好。
+
+PAT='ARGV0=apply-seccomp /proc/self/fd/3 '
+REP='/usr/bin/unshare -U --map-current-user --keep-caps /usr/bin/env ARGV0=apply-seccomp /proc/self/fd/3 '
+REAL=${NODESIGN_REAL_BWRAP:-/usr/bin/bwrap}
+
+# 兜底：unshare 不在（非 util-linux 系统）→ 原样透传，退回现状
+[ -x /usr/bin/unshare ] || exec "$REAL" "$@"
+
+args=()
+hit=0
+for a in "$@"; do
+  case "$a" in
+    *"$PAT"*) hit=1; a=${a//"$PAT"/"$REP"} ;;
+  esac
+  args+=("$a")
+done
+
+[ -n "$NODESIGN_SHIM_LOG" ] && printf '%s rewrote=%d nargs=%d\n' "$(date +%s)" "$hit" "$#" >>"$NODESIGN_SHIM_LOG" 2>/dev/null
+
+exec "$REAL" "${args[@]}"

package/server/projects/assets-summary.js

@@ -0,0 +1,119 @@
+/**
+ * server/projects/assets-summary.js — 工作区素材摘要（2026-08-18 从 workspace.js 拆出）
+ *
+ * 这条摘要进每个会话的 system 提示：告诉 agent 工作区里已经有什么素材。
+ * 拆出来的理由是它跟"工作区生命周期"没关系 —— 它是个格式化器。
+ *
+ * ⚠️ 存在的意义在于：**跨会话可见的东西如果没人提，等于不存在**。
+ * `assets/` 不随 sessionId 分桶，下个会话 Read 得到；但 agent 不会去猜有什么，
+ * 它会重新搜一遍、重新逛一遍那个站。
+ */
+
+import path from 'node:path';
+import fs from 'node:fs/promises';
+
+const IMAGE_EXT = new Set(['.png', '.jpg', '.jpeg', '.webp', '.gif', '.svg']);
+const TEXT_DOC_EXT = new Set(['.md', '.txt', '.json']);
+const BINARY_DOC_EXT = new Set(['.pdf', '.pptx', '.ppt', '.docx', '.doc', '.xlsx', '.xls']);
+
+/**
+ * @param {string} sessionRoot - sessions/<sid>/ 绝对路径
+ * @returns {Promise<{ count: number, summary: string, hasBinaryDocs: boolean }>}
+ *   count=0 时 summary 为空字符串，调用方据此判断是否注入提示。
+ *   hasBinaryDocs=true 时调用方追加 python 处理提醒（Read 拿不到这些的内容）。
+ */
+export async function readAssetsSummary(sessionRoot) {
+  try {
+    const assetsLink = path.join(sessionRoot, 'assets');
+    const stat = await fs.stat(assetsLink).catch(() => null);
+    if (!stat) return { count: 0, summary: '', hasBinaryDocs: false };
+
+    const entries = await fs.readdir(assetsLink, { withFileTypes: true }).catch(() => []);
+    const files = entries.filter((e) => !e.name.startsWith('.') && (e.isFile() || e.isSymbolicLink()));
+    // ⚠️ 别在这儿提前 return：顶层一个文件都没有、但 assets/references/ 下有一堆
+    // 采集素材是**常见情形**（agent 逛过站但用户没上传过东西）。提前 return 会让
+    // 那些素材对 agent 彻底隐形。
+
+    const images = [];
+    const textDocs = [];
+    const binaryDocs = [];
+    const others = [];
+    for (const f of files) {
+      const ext = path.extname(f.name).toLowerCase();
+      if (IMAGE_EXT.has(ext)) images.push(f.name);
+      else if (TEXT_DOC_EXT.has(ext)) textDocs.push(f.name);
+      else if (BINARY_DOC_EXT.has(ext)) binaryDocs.push(f.name);
+      else others.push(f.name);
+    }
+
+    // 摘要：种类 + 头几个文件名（避免太长）
+    const parts = [];
+    if (images.length > 0) {
+      const sample = images.slice(0, 3).join('、');
+      parts.push(`${images.length} 张图（${sample}${images.length > 3 ? ` 等` : ''}）`);
+    }
+    if (textDocs.length > 0) {
+      const sample = textDocs.slice(0, 3).join('、');
+      parts.push(`${textDocs.length} 个文本文档（${sample}${textDocs.length > 3 ? ` 等` : ''}）`);
+    }
+    if (binaryDocs.length > 0) {
+      const sample = binaryDocs.slice(0, 3).join('、');
+      parts.push(`${binaryDocs.length} 个 PDF/Office 文档（${sample}${binaryDocs.length > 3 ? ` 等` : ''}）`);
+    }
+    if (others.length > 0) {
+      parts.push(`${others.length} 个其他文件`);
+    }
+
+    // 完整文件清单（按路径列）—— 让 agent 不用再 Glob/LS 探。
+    // （08-07 扁平化后 assets/ 是真目录，Glob 也能用；08-21 前这里还写着"symlink 别用 Glob"，删了。）
+    const allNames = [...images, ...textDocs, ...binaryDocs, ...others];
+
+    // 参考素材（2026-08-18）：`assets/references/**` 也要报，否则**没有任何机制
+    // 告诉 agent 它们存在** —— 上面这遍只列顶层文件，而参考图和 browser_capture
+    // 的采集都在子目录里。跨会话可见的东西如果没人提，等于不存在：agent 会重新
+    // 去搜一遍、重新逛一遍那个站。
+    // 只报数量和头几个名字（几十个文件全列会把这条 system 撑爆）。
+    const refs = [];
+    try {
+      const refRoot = path.join(assetsLink, 'references');
+      const walk = async (dir, rel, depth) => {
+        for (const e of await fs.readdir(dir, { withFileTypes: true })) {
+          if (e.name === '.meta' || e.name.startsWith('.')) continue;
+          if (e.isDirectory()) { if (depth > 0) await walk(path.join(dir, e.name), `${rel}/${e.name}`, depth - 1); continue; }
+          refs.push(`${rel}/${e.name}`);
+        }
+      };
+      await walk(refRoot, 'assets/references', 2);
+    } catch { /* 没有这个目录就没有 */ }
+
+    const refLine = refs.length
+      ? `另有 ${refs.length} 件参考素材在 assets/references/ 下（${refs.slice(0, 3).map(r => r.split('/').pop()).join('、')}`
+        + `${refs.length > 3 ? ' 等' : ''}）—— 逛站采回来的调色板/字体/结构/动效清单 json 就在这儿，`
+        + '出处记在同目录的 .meta/<同名>.json 里。**先看有没有现成的，别重复去搜。**'
+      : '';
+
+    // ⚠️ `paths` 会被 UserPromptSubmit 首轮全量打进状态块（之后只报变化，见
+    // hooks/user-prompt-submit.js）。refs 随每次 browser_capture 单调增长，首轮也要封顶；
+    // `allPaths` 不封顶，给按项算变化用（不直接打进文案）。
+    const REF_CAP = 12;
+    const TOP_CAP = 60;
+    const refPaths = refs.slice(0, REF_CAP);
+    const overflow = refs.length - refPaths.length;
+    if (overflow > 0) {
+      // 别只是截断了不说 —— 「静默截断」读起来就是"全都在这儿了"
+      refPaths.push(`（另有 ${overflow} 件在 assets/references/ 下，名字和出处见同目录 .meta/）`);
+    }
+    return {
+      count: files.length + refs.length,
+      summary: [
+        files.length ? `workspace 里已有 ${files.length} 个参考素材：${parts.join('、')}` : '',
+        refLine,
+      ].filter(Boolean).join('\n'),
+      hasBinaryDocs: binaryDocs.length > 0,
+      paths: [...allNames.slice(0, TOP_CAP).map((n) => `assets/${n}`), ...refPaths],
+      allPaths: [...allNames.map((n) => `assets/${n}`), ...refs],
+    };
+  } catch {
+    return { count: 0, summary: '', hasBinaryDocs: false, paths: [], allPaths: [] };
+  }
+}

package/server/projects/auto-name.js

@@ -0,0 +1,53 @@
+/**
+ * server/projects/auto-name.js — 用会话摘要给项目起名（2026-07-28）
+ *
+ * 首页那个大输入框以前建的是"闪聊"（kind=quick），名字硬切用户第一句话前 30 字，
+ * 而且不算正经项目。现在它直接建真项目，名字先用那句话垫着（auto_named=1），
+ * 第一轮跑完就用 **SDK helper 写的会话摘要** 改一次名 —— 那是它本来就在写的东西
+ * （incrementally 落进 jsonl，我们列会话时读的就是它），不额外花一次模型调用。
+ *
+ * 只改一次：改完清 auto_named。用户自己改过名的项目（updateProject 带 name 会
+ * 自动清零）永远不动。
+ */
+
+import path from 'node:path';
+import { getSessionInfo } from '@anthropic-ai/claude-agent-sdk';
+import { getProject, updateProject } from './store.js';
+import { getProjectWorkspace } from './workspace.js';
+import { withConfigDir } from '../lib/sdk-session.js';
+import { platform } from '../runtime/platform.js';
+
+const MAX_NAME = 40;
+
+/**
+ * @param {string} projectId
+ * @param {string} sessionId
+ * @returns {Promise<string|null>} 改成了什么名字；没改返 null
+ */
+export async function autoNameProjectFromSession(projectId, sessionId) {
+  if (!projectId || !sessionId) return null;
+  let project;
+  try { project = getProject(projectId); } catch { return null; }
+  if (!project || !project.autoNamed) return null;
+
+  const sessionRoot = path.join(getProjectWorkspace(projectId), 'sessions', sessionId);
+  let info;
+  try {
+    info = await withConfigDir(platform.claudeConfigDir, () =>
+      getSessionInfo(sessionId, { dir: sessionRoot }),
+    );
+  } catch {
+    return null;   // 读不到就下轮再说，auto_named 还留着
+  }
+
+  const summary = String(info?.customTitle || info?.summary || '').trim();
+  if (!summary) return null;
+  const name = summary.length > MAX_NAME ? summary.slice(0, MAX_NAME) + '…' : summary;
+  if (name === project.name) {
+    updateProject(projectId, { autoNamed: false });   // 同名也算定了，别每轮再问
+    return null;
+  }
+
+  updateProject(projectId, { name, autoNamed: false });
+  return name;
+}