@xiaobuyu/nodesign 0.0.5 → 0.0.7

package/server/lib/kinds/site.js

@@ -12,12 +12,16 @@
 
 import path from 'node:path';
 import fs from 'node:fs/promises';
-import { walkTaskFiles, loadIgnore, DRAFTS_DIR, RESERVED_DIRS } from '../task-scan.js';
+import { walkTaskFiles, loadIgnore, readTaskMarker, DRAFTS_DIR, RESERVED_DIRS } from '../task-scan.js';
 
 const ENTRY = 'index.html';
 
-/** 构建产物的约定目录，按序探测（谁有 index.html 认谁）。任务根有 index.html 时不看这些 */
-const OUTPUT_DIRS = ['dist', 'out', 'build', '_site', 'public'];
+/**
+ * 构建产物的约定目录，按序探测（谁有 index.html 认谁）。
+ * export：assets.js 的文件夹递归要用同一张表把构建目录挡在"独立站点/文件夹"之外
+ * （08-24 案：dist/ 被递归成第二张 site 卡）。
+ */
+export const OUTPUT_DIRS = ['dist', 'out', 'build', '_site', 'public'];
 
 /** 站点页面扫描深度（产物根之下；子页 / posts/ / pages/ 够用） */
 const PAGE_DEPTH = 4;
@@ -31,18 +35,36 @@ function normRoot(r) {
   return (!s || s === '.' || s.includes('..')) ? '' : s;
 }
 
+/**
+ * 根 index.html 是不是**构建源**（vite / react / vue 工程的开发入口）：
+ * module script 引用 src/ 目录或 .tsx/.jsx/.ts/.vue 源文件。构建源不是可浏览的
+ * 产物 —— 浏览器直接打开是白屏（脚本路径只有 dev server / 构建器认识）。
+ * 只认强证据；读不动 / 不确定一律按"真产物"处理（老行为）。
+ */
+async function isBuildSourceEntry(dirAbs) {
+  try {
+    const html = await fs.readFile(path.join(dirAbs, ENTRY), 'utf8');
+    return /<script[^>]+src=["'](?:\.?\/)?src\/[^"']+["']/i.test(html)
+      || /<script[^>]+src=["'][^"']+\.(?:tsx|jsx|ts|vue)["']/i.test(html);
+  } catch { return false; }
+}
+
 /**
  * 产物根（相对任务目录，'' = 任务根）。
  * marker.root 是显式声明，最优先 —— 哪怕入口还没构建出来（agent 刚写完源、
  * 还没跑 build 的窗口期），寻址也该指向将要出现的地方而不是源目录。
+ * 任务根的 index.html 是构建源且约定目录里已有构建产物时，优先产物
+ * （08-24 案：vite 工程源码 index.html 引 /src/main.tsx，预览白屏）。
  */
 async function artifactRoot(taskDir, marker) {
   const declared = normRoot(marker?.root);
   if (declared) return declared;
-  if (await exists(path.join(taskDir, ENTRY))) return '';
+  const hasRootEntry = await exists(path.join(taskDir, ENTRY));
+  if (hasRootEntry && !(await isBuildSourceEntry(taskDir))) return '';
   for (const d of OUTPUT_DIRS) {
     if (await exists(path.join(taskDir, d, ENTRY))) return d;
   }
+  // 构建源但还没 build 出产物：退回任务根（至少寻址不落空；build 完自动切换）
   return '';
 }
 
@@ -67,7 +89,10 @@ async function discoverInstances(taskDir, marker) {
   if (rootSite) {
     out.push({ srcRoot: '', root, single: false });
   } else {
-    // 无根站：一级子目录各自为站
+    // 无根站：一级子目录各自为站。每个子目录按自己的 marker + 构建证据算产物根
+    // （08-24 案：jet-engine/ 里的 .nd-project.json 以前读不到、dist/ 轮不上，
+    //  构建型子目录站没有干净路径）。root 是**任务根相对**（jet-engine/dist），
+    //  srcRoot 是子目录名 —— 卡片身份挂 srcRoot 那个文件夹，寻址走 root。
     let entries = [];
     try { entries = await fs.readdir(taskDir, { withFileTypes: true }); } catch { /* */ }
     const ignore = await loadIgnore(taskDir);
@@ -75,8 +100,16 @@ async function discoverInstances(taskDir, marker) {
       if (!e.isDirectory() || e.name.startsWith('.') || e.name === DRAFTS_DIR) continue;
       if (RESERVED_DIRS.has(e.name)) continue;
       if (ignore(e.name, true)) continue;
-      if (await exists(path.join(taskDir, e.name, ENTRY))) {
-        out.push({ srcRoot: e.name, root: e.name, single: false });
+      const subDir = path.join(taskDir, e.name);
+      const subMarker = await readTaskMarker(subDir);
+      const subRoot = await artifactRoot(subDir, subMarker);
+      const subDeclared = normRoot(subMarker?.root);
+      if (subDeclared || await exists(path.join(subDir, subRoot || '.', ENTRY))) {
+        out.push({
+          srcRoot: e.name,
+          root: subRoot ? `${e.name}/${subRoot}` : e.name,
+          single: false,
+        });
       }
     }
   }

package/server/lib/rewrite-refs.js

@@ -0,0 +1,110 @@
+/**
+ * rewrite-refs.js —— 搬文件后把全工作区的引用改写到新路径（2026-08-24，iss_mt38uih6）
+ *
+ * 用户的方法论原话：「新建一个文件夹然后改个索引」。organize_board 归纳素材时
+ * 磁盘和画布身份跟着走了，但 HTML/MD 里的 src/href 还指旧路径 —— 裂图。这里把
+ * "改索引"那半补上：对每个文本文件，把指向被搬条目的引用按**相对该文件目录**
+ * 的写法换算后替换。
+ *
+ * 设计取舍：
+ *   - 引用是相对路径（站点路径铁律），所以同一个目标在不同文件里的写法不同
+ *     （根上的 deck 写 `assets/x.png`，子页写 `../assets/x.png`）——逐文件换算。
+ *   - 被搬的文件**自己**也可能引用别人：它落了新家后自己的相对引用基准变了，
+ *     按"旧目录里的写法 → 新目录里的写法"改（哪怕目标没动）。
+ *   - 边界字符防误伤：只有前后都像"引用上下文"（引号/括号/=/空白/行首尾/`/`
+ *     延续）才替换。改了多少处如实报给调用方 —— 自动改写用户内容，必须可核对。
+ *   - 搬的是文件夹时按前缀匹配（`素材/x.png` 里的 `素材` 段）。
+ */
+
+import path from 'node:path';
+import { promises as fs } from 'node:fs';
+import { walkTaskFiles, loadIgnore } from './task-scan.js';
+
+const TEXT_EXTS = /\.(html?|css|md|markdown|js|mjs|json|svg|ya?ml|txt)$/i;
+const MAX_BYTES = 2 * 1024 * 1024;
+
+const relFrom = (dirRel, targetRel) => path.posix.relative(dirRel || '.', targetRel);
+const escRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+
+/**
+ * 纯函数：一段文本里把 pairs（[旧工作区相对路径, 新路径]）的引用改写掉。
+ * @param {string} text
+ * @param {string} oldDirRel  这段文本**写下时**所在目录（工作区相对，'' = 根）
+ * @param {string} newDirRel  这段文本现在所在目录（自己没被搬则与 oldDirRel 相同）
+ * @param {Array<[string,string]>} pairs
+ * @returns {{ text: string, hits: number }}
+ */
+export function rewriteTextRefs(text, oldDirRel, newDirRel, pairs) {
+  let out = text; let hits = 0;
+  const variants = [];
+  for (const [oldRel, newRel] of pairs) {
+    const oldRef = relFrom(oldDirRel, oldRel);
+    const newRef = relFrom(newDirRel, newRel);
+    if (!oldRef || oldRef === newRef) continue;
+    variants.push([oldRef, newRef]);
+    const encOld = encodeURI(oldRef); const encNew = encodeURI(newRef);
+    if (encOld !== oldRef) variants.push([encOld, encNew]);
+  }
+  // 长的先替：`素材` 与 `素材/子` 并存时避免前缀误吞
+  variants.sort((a, b) => b[0].length - a[0].length);
+  for (const [o, n] of variants) {
+    const re = new RegExp(`(^|["'\\(=,\\s])${escRe(o)}(?=["'\\)\\s#?,]|/|$)`, 'gm');
+    out = out.replace(re, (m, p1) => { hits += 1; return `${p1}${n}`; });
+  }
+  return { text: out, hits };
+}
+
+/**
+ * 自己被搬过的文本文件：**所有**相对引用的基准都变了（不只指向被搬条目的）。
+ * 把每个像相对路径的 token 按旧目录解析、按新目录重写；目标自己也搬了就再查
+ * moves 表。只认引号/括号里带扩展名的 token，http/data//#/绝对路径不碰。
+ */
+export function rebaseSelfRefs(text, oldDirRel, newDirRel, movesMap) {
+  let hits = 0;
+  const out = text.replace(
+    /(["'(=])((?:\.\.\/|\.\/)?[^"'\s()#?]*\.[A-Za-z0-9]{1,8})(?=["')\s#?]|$)/gm,
+    (m, pre, ref) => {
+      if (/^(?:[a-z][a-z0-9+.-]*:|\/\/|\/|#)/i.test(ref)) return m;
+      const target = path.posix.normalize(path.posix.join(oldDirRel || '.', decodeURI(ref)));
+      if (target.startsWith('..')) return m;   // 出工作区的不碰
+      const finalTarget = movesMap.get(target) || target;
+      const next = relFrom(newDirRel, finalTarget);
+      if (next === ref) return m;
+      hits += 1;
+      return `${pre}${next}`;
+    },
+  );
+  return { text: out, hits };
+}
+
+/**
+ * 扫全工作区文本文件，改写指向 pairs 的引用。
+ * @param {string} root   工作区根（绝对路径）
+ * @param {Array<{from: string, to: string}>} moves  已完成的搬家（工作区相对）
+ * @returns {Promise<{files: number, hits: number, lines: string[]}>}
+ */
+export async function rewriteWorkspaceRefs(root, moves) {
+  const pairs = moves.map((m) => [m.from, m.to]);
+  const movesMap = new Map(pairs);
+  const movedTo = new Map(moves.map((m) => [m.to, m.from]));
+  const ignore = await loadIgnore(root);
+  const all = await walkTaskFiles(root, { maxDepth: 6, ignore, includeDrafts: true });
+  let files = 0; let hits = 0; const lines = [];
+  for (const f of all) {
+    if (!TEXT_EXTS.test(f.name) || f.size > MAX_BYTES) continue;
+    const newDir = path.posix.dirname(f.rel) === '.' ? '' : path.posix.dirname(f.rel);
+    const selfOld = movedTo.get(f.rel);
+    let raw;
+    try { raw = await fs.readFile(f.abs, 'utf8'); } catch { continue; }
+    // 自己被搬过 → 整体换基准（含指向没搬目标的引用）；没搬 → 只改指向被搬条目的
+    const r = selfOld
+      ? rebaseSelfRefs(raw, path.posix.dirname(selfOld) === '.' ? '' : path.posix.dirname(selfOld), newDir, movesMap)
+      : rewriteTextRefs(raw, newDir, newDir, pairs);
+    if (r.hits > 0 && r.text !== raw) {
+      try { await fs.writeFile(f.abs, r.text, 'utf8'); } catch { continue; }
+      files += 1; hits += r.hits;
+      lines.push(`  ↻ ${f.rel}：${r.hits} 处`);
+    }
+  }
+  return { files, hits, lines };
+}

package/server/lib/ssrf-guard.js

@@ -267,6 +267,14 @@ export function blockReason(rawIp) {
 /** 只允许这两个 scheme 发起网络请求；data:/blob: 不出网所以另算 */
 const NET_SCHEMES = new Set(['http:', 'https:']);
 const OFFLINE_SCHEMES = new Set(['data:', 'blob:', 'about:']);
+/**
+ * Chromium 内置 PDF viewer（component extension，id 硬编码在 Chromium 源里）。
+ * 它渲染 PDF 时会加载自己的静态资源（pdf_embedder.css 等）——不出网、出不了扩展
+ * 包目录，跟 file:// 不是一个量级。不放行的话浏览器里所有 PDF 都渲染不出来
+ * （08-24 案）。⚠️ 只放这个 id：别的 chrome-extension:// 照旧拒 + 记账，
+ * 将来谁 --load-extension 也不会自动继承放行。
+ */
+const PDF_VIEWER_ORIGIN = 'chrome-extension://mhjfbmdgcfjbbpaeojofohoefgiehjai/';
 
 /**
  * 一个 URL 能不能让浏览器去。**解析 DNS 后逐个 IP 判**。
@@ -297,6 +305,7 @@ export async function checkUrl(raw, { timeoutMs = 4000 } = {}) {
   try { u = new URL(String(raw)); } catch { return { ok: false, reason: `not a valid URL: ${raw}` }; }
 
   if (OFFLINE_SCHEMES.has(u.protocol)) return { ok: true, ips: [] };   // 不出网
+  if (String(raw).startsWith(PDF_VIEWER_ORIGIN)) return { ok: true, ips: [] };  // 内置 PDF viewer 自身资源，不出网
   if (!NET_SCHEMES.has(u.protocol)) {
     return { ok: false, reason: `scheme ${u.protocol} is not allowed (only http/https; file:// would read local files)` };
   }

package/server/lib/task-scan.js

@@ -54,6 +54,11 @@ export const RESERVED_FILES = new Set([
   '.nd-project.json',  // 产物标记（形态兜底）
   '.gitignore',
   '.ndignore',
+  // 下面三个是基础设施不是用户产物，上墙就是「画布把自己的存档画在自己身上」
+  // 家族（08-24 清账补齐；ui-config.json 是黑板模式开关，曾以 .json 卡上墙）
+  'ui-config.json',
+  'spec.json',
+  'pending-changes.json',
 ]);
 
 /** 永远不扫的目录名（任何深度命中即剪枝） */
@@ -68,6 +73,19 @@ export const DRAFTS_DIR = '_drafts';
 
 export const NDIGNORE_FILE = '.ndignore';
 
+/**
+ * 读产物标记（`.nd-project.json`）。没有 / 读不动 → null。
+ * 2026-08-24 从 kinds/index.js 迁来：site.js 现在要按子目录读 marker（构建型
+ * 子目录站），住 kinds/index.js 会循环 import。kinds/index.js 原样 re-export。
+ */
+export async function readTaskMarker(root) {
+  try {
+    const raw = await fs.readFile(path.join(root, '.nd-project.json'), 'utf8');
+    const parsed = JSON.parse(raw);
+    return (parsed && typeof parsed === 'object') ? parsed : null;
+  } catch { return null; }
+}
+
 /** gitignore 子集 → RegExp。认不出的行按字面量处理（转义后精确匹配）。 */
 function compilePattern(line) {
   let pat = line.trim();

package/server/projects/board-store.js

@@ -473,7 +473,7 @@ export function pinToZone(pid, { objectId, zoneId = '' }) {
      */
     const CELL_W = 320; const CELL_H = 220; const PAD = 10;
     const dirOf = (id) => {
-      if (typeof id !== 'string' || id.startsWith('doc:')) return '';
+      if (typeof id !== 'string') return '';
       const c = id.indexOf(':');
       const path = (c > 0 && /^[a-z]+$/.test(id.slice(0, c))) ? id.slice(c + 1) : id;
       const i = path.lastIndexOf('/');
@@ -505,3 +505,44 @@ export function pinToZone(pid, { objectId, zoneId = '' }) {
     return { board, zone: zid ? { id: zid } : null, placed: board.objects[oid] };
   });
 }
+
+/**
+ * 悬空关系线清扫（2026-08-24，iss_mszz20zn）：删掉产物后 board.json 里会留下
+ * 端点指向已不存在文件的 binding —— 关系线只能画不能删，agent 收尾时"我制造的
+ * 东西我清不掉"。关系线依附于产物存在：产物没了线自然该没。
+ *
+ * 端点合法 = 板上有座位（board.objects）或磁盘上真有这个路径（kind 前缀剥掉后）。
+ * 两条都不满足才剪 —— 宁可留一条可疑的，不错杀一条活的。30s 节流：挂在
+ * /artifacts 热路径上，每张板最多半分钟对账一次。
+ */
+const pruneStamp = new Map();   // pid → last run ms
+const PRUNE_INTERVAL_MS = 30_000;
+
+export function pruneDanglingBindings(pid) {
+  const now = Date.now();
+  if ((pruneStamp.get(pid) || 0) + PRUNE_INTERVAL_MS > now) return Promise.resolve({ pruned: 0 });
+  pruneStamp.set(pid, now);
+  return withBoardLock(pid, async () => {
+    const board = await readBoard(pid);
+    const entries = Object.entries(board.bindings || {});
+    if (!entries.length) return { pruned: 0 };
+    const root = getSharedDir(pid);
+    const alive = async (ep) => {
+      const id = String(ep || '');
+      if (!id) return false;
+      if (board.objects?.[id]) return true;
+      const bare = id.replace(/^(deck|site|docx|text|scribble):/, '');
+      if (!bare || bare.includes('..')) return false;
+      try { await fs.access(path.resolve(root, bare)); return true; } catch { return false; }
+    };
+    const dead = [];
+    for (const [bid, b] of entries) {
+      if (!(await alive(b?.from)) || !(await alive(b?.to))) dead.push(bid);
+    }
+    if (!dead.length) return { pruned: 0 };
+    for (const bid of dead) delete board.bindings[bid];
+    await writeBoard(pid, board);
+    console.log(`[board] ${pid} 清掉 ${dead.length} 条悬空关系线`);
+    return { pruned: dead.length };
+  });
+}

package/server/projects/memory-migration.js

@@ -0,0 +1,85 @@
+/**
+ * projects/memory-migration.js — 记忆体系改版迁移（2026-08-24，幂等）
+ *
+ * ensureProjectWorkspace 每次调用（源不在了就什么都不做）：
+ *   ① .claude/CLAUDE.md → <root>/CLAUDE.md（根上已有就把旧文件并进末尾再删）
+ *   ② .claude/agent-memory/memory.md、brand/memory.md → 并进根 CLAUDE.md 的
+ *      「用户习惯」/「风格档案」节末尾，源删除
+ *   ③ .claude/agent-memory/auto/* → 记忆/（SDK auto-memory 新家，画布可见）
+ * 三步全是"搬走后源删除"，跑几遍结果一样。
+ */
+
+import path from 'node:path';
+import { promises as fs } from 'node:fs';
+import { MEMORY_DIR_NAME } from '../engine/agent/memory-config.js';
+import { DEFAULT_CLAUDE_MD } from './workspace-templates.js';
+
+/** 改版前的默认模板原文（迁移判据用：全文相等 = 用户没写过一个字，不搬） */
+const OLD_DEFAULT_CLAUDE_MD = `# Project Instructions
+
+This file is read by the AI agent at the start of every session as part of its
+system prompt. Write project-specific guidance here — design intent,
+constraints, vocabulary, must-do / must-not-do.
+
+The agent will see this verbatim. Keep it concise and actionable.
+
+## Examples
+- Design tone: minimal, editorial, generous whitespace
+- Hard constraints: never use red as a primary color
+- Vocabulary: refer to the user as "the team"
+
+(Edit this file from the NoDesign UI — the agent picks up changes on next session.)
+`;
+
+export async function migrateMemoryLayout(root, { fileExists }) {
+  const rootMd = path.join(root, 'CLAUDE.md');
+  const appendTo = async (heading, text, label) => {
+    const body = String(text || '').trim();
+    if (!body) return;
+    let cur = '';
+    try { cur = await fs.readFile(rootMd, 'utf8'); } catch { /* 还没有 */ }
+    if (!cur.trim()) cur = DEFAULT_CLAUDE_MD;   // 起新文件时以「项目档案」模板打底
+    await fs.writeFile(rootMd, `${cur ? `${cur.replace(/\n+$/, '')}\n\n` : ''}${heading}\n（${label}，2026-08-24 自动迁入）\n\n${body}\n`, 'utf8');
+  };
+  const oldMd = path.join(root, '.claude', 'CLAUDE.md');
+  try {
+    const t = await fs.readFile(oldMd, 'utf8');
+    // 旧英文默认模板（用户一个字没改，**全文精确比对**才算）没有搬运价值 ——
+    // 删掉让 ensure 落新版「项目档案」模板。差一个字都按用户内容原样搬，宁可
+    // 多搬不可误删（判据宽了会吃掉用户在模板上的增改）。
+    if (t.trim() === OLD_DEFAULT_CLAUDE_MD.trim()) {
+      await fs.rm(oldMd, { force: true });
+    } else {
+      if (await fileExists(rootMd)) await appendTo('## 项目指引', t, '原 .claude/CLAUDE.md');
+      else await fs.writeFile(rootMd, t, 'utf8');
+      await fs.rm(oldMd, { force: true });
+    }
+  } catch { /* 没有旧文件：新项目 */ }
+  const memRoot = path.join(root, '.claude', 'agent-memory');
+  try {
+    const t = await fs.readFile(path.join(memRoot, 'memory.md'), 'utf8');
+    await appendTo('## 用户习惯', t, '原用户偏好记忆');
+    await fs.rm(path.join(memRoot, 'memory.md'), { force: true });
+  } catch { /* */ }
+  try {
+    const t = await fs.readFile(path.join(memRoot, 'brand', 'memory.md'), 'utf8');
+    await appendTo('## 风格档案', t, '原风格档案');
+    await fs.rm(path.join(memRoot, 'brand'), { recursive: true, force: true });
+  } catch { /* */ }
+  // auto/ 的存量记忆搬去 记忆/（同名不覆盖：目标已有的跳过，宁可留双份可见）
+  const autoDir = path.join(memRoot, 'auto');
+  try {
+    const entries = await fs.readdir(autoDir, { withFileTypes: true });
+    const dest = path.join(root, MEMORY_DIR_NAME);
+    await fs.mkdir(dest, { recursive: true });
+    for (const e of entries) {
+      const from = path.join(autoDir, e.name);
+      const to = path.join(dest, e.name);
+      if (await fileExists(to)) continue;
+      await fs.rename(from, to).catch(() => {});
+    }
+    const left = await fs.readdir(autoDir).catch(() => []);
+    if (left.length === 0) await fs.rm(autoDir, { recursive: true, force: true });
+  } catch { /* 没有 auto/：多数项目 */ }
+}
+

package/server/projects/move-entry.js

@@ -19,6 +19,7 @@ import { getSharedDir } from './workspace.js';
 import { renameBoardPaths } from './board-store.js';
 import { taskManifest, KIND_SITE } from '../lib/artifact-target.js';
 import { RESERVED_DIRS } from '../lib/task-scan.js';
+import { CHALK_DIR } from '../lib/chalk.js';
 
 export class MoveError extends Error {
   constructor(status, message) { super(message); this.status = status; }
@@ -62,8 +63,17 @@ export async function moveEntry(pid, fromRaw, toRaw, { createFolder = false } =
   if (NO_MOVE_OUT.has(guardSeg(from)) || guardSeg(from).startsWith('.')) {
     throw new MoveError(400, '这个位置的东西不参与搬家');
   }
+  // 板书不参与搬家（08-24，上报 iss_mt5qujy1）：它是画布上的**话**，不是文件产物。
+  // 拖拽误触把它挪出 notes/板书/ 会丢 chalk 身份渲染成普通细条卡，且没有正规
+  // 归位通道。搬出一律拒；搬回（下面目标守卫的例外）留给误逃文件的恢复。
+  if (from === CHALK_DIR || from.startsWith(`${CHALK_DIR}/`)) {
+    throw new MoveError(400, '板书是画布上的话，不参与搬家');
+  }
   if (to && (RESERVED_DIRS.has(guardSeg(to)) || guardSeg(to).startsWith('.'))) {
-    throw new MoveError(400, '不能搬进这个目录');
+    // 唯一例外：把误逃的 .md 送**回**板书目录（恢复通道；organize_board 同享。
+    // 不限根层 —— groupInto 误触会把板书埋进"新建文件夹/"里，也得捞得回来）
+    const isChalkReturn = to === CHALK_DIR && /\.md$/i.test(from);
+    if (!isChalkReturn) throw new MoveError(400, '不能搬进这个目录');
   }
   // 搬进自己肚子里（文件夹拖到它自己的子文件夹上）—— fs.rename 会报
   // EINVAL，但那时目录树已经没法自洽了，提前拦住

package/server/projects/ui-config.js

@@ -26,8 +26,9 @@ export const DEFAULT_UI_CONFIG = Object.freeze({
    * 黑板模式（2026-08-23）：用户专注头脑风暴时，画布取代侧栏成为主交互窗口 ——
    * agent 每轮的主体内容落画布（sketch_on_board / edit_sketch），聊天里只留一两句；
    * 草图落定时服务端广播 board.focus，前端把镜头带过去。
+   * 2026-08-24 用户拍板默认开（老项目没写过这个键的也按开算；关过的尊重文件里的 false）。
    */
-  blackboard_mode: false,
+  blackboard_mode: true,
 });
 
 /**

package/server/projects/workspace-templates.js

@@ -36,18 +36,21 @@ export const DEFAULT_SPEC_JSON = JSON.stringify(
   null, 2,
 ) + '\n';
 
-export const DEFAULT_CLAUDE_MD = `# Project Instructions
+// 2026-08-24 记忆体系改版：CLAUDE.md 挪到工作区根（画布可见），承载三类
+// **人工筛选过的**长期事实——项目指引 / 风格档案 / 用户习惯。每会话被 SDK
+// 确定性全量注入（settingSources 'project' 原生行为，二进制实证根目录也读）。
+// 生长中的记忆（agent 自动记）住 记忆/，两层各干各的。
+export const DEFAULT_CLAUDE_MD = `# 项目档案
 
-This file is read by the AI agent at the start of every session as part of its
-system prompt. Write project-specific guidance here — design intent,
-constraints, vocabulary, must-do / must-not-do.
+这份文件每次会话都会完整进入 agent 的上下文。放**定了就不常变**的东西；
+会生长的记忆 agent 自己记在 记忆/ 里。改这份文件里的硬约束要经用户点头。
 
-The agent will see this verbatim. Keep it concise and actionable.
+## 项目指引
+（设计意图、硬约束、必须做/不许做。例：主色永远不用红色。）
 
-## Examples
-- Design tone: minimal, editorial, generous whitespace
-- Hard constraints: never use red as a primary color
-- Vocabulary: refer to the user as "the team"
+## 风格档案
+（定案的视觉锚：调色板 / 字体 / 材质 / 艺术方向。）
 
-(Edit this file from the NoDesign UI — the agent picks up changes on next session.)
+## 用户习惯
+（称呼、语气、工作方式偏好。）
 `;

package/server/projects/workspace.js

@@ -6,12 +6,9 @@
  * 结构：
  *   <PROJECTS_DATA_ROOT>/<projectId>/
  *     ├── shared/                    ← **项目工作区**：agent 的 cwd，产物的家
- *     │   ├── .claude/
- *     │   │   ├── CLAUDE.md          项目指引（用户写）
- *     │   │   ├── settings.json      项目 SDK config
- *     │   │   ├── skills/ agents/    项目级 skill / 子代理
- *     │   │   ├── agent-memory/      长期记忆（agent 写）
- *     │   │   └── projects/          SDK 转录落点（.gitignore）
+ *     │   ├── CLAUDE.md              项目档案（指引/风格/习惯；08-24 挪到根，画布可见）
+ *     │   ├── 记忆/                   SDK auto-memory（08-24 起，画布可见）
+ *     │   ├── .claude/               settings.json · skills/ agents/ · projects/（SDK 转录）
  *     │   ├── assets/                上传素材 + 生成图
  *     │   ├── .nd/<sid>/             会话私档（spec.json / design-plan.md）
  *     │   ├── .git/                  项目历史
@@ -51,12 +48,9 @@ import { resolveModelContextWindow } from '../engine/agent/model-context.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 /**
- * Per-sessionRoot read-modify-write 串行 utility。
- *
- * 解决：record_decision / expose_tweaks / PostCompact 3 处都 readFile→mutate→writeFile
- * 同 spec.json，无锁 → 后写者 silent 覆盖前写者全量内容（"刚 record 的 decision 没了"
- * 类 bug）。三处统一通过本 helper 写，async-mutex-lite 是 module-singleton，所有
- * import 共享 lock map，按 key 串行。
+ * Per-sessionRoot read-modify-write 串行 utility（spec.json）。
+ * 08-24 起唯一写入方 = 暂退役的 expose_tweaks（决策贴/PostCompact 摘要已拆）；
+ * 锁留着 —— tweaks 升级回归时并发结构不变。
  *
  * @param {string} workspaceRoot - sessions/<sid>/ 路径
  * @param {(spec: object) => (object|void|Promise<object|void>)} mutator
@@ -93,8 +87,9 @@ export function validateSessionId(sid) {
 }
 
 import {
-  DEFAULT_GITIGNORE, DEFAULT_SPEC_JSON, DEFAULT_CLAUDE_MD,
+  DEFAULT_GITIGNORE, DEFAULT_CLAUDE_MD,
 } from './workspace-templates.js';
+import { migrateMemoryLayout } from './memory-migration.js';
 
 /**
  * NoDesign 全局默认 settings.json — 代码是 source of truth。
@@ -247,8 +242,13 @@ export async function ensureProjectWorkspace(projectId) {
   // .gitignore 每次比对而不是"不存在才写"：扁平化新增了 .claude/projects/ 和
   // .nd/ 两条，老项目的文件里没有，不补的话 SDK 转录会被 commit 进项目历史。
   await ensureGitignore(path.join(root, '.gitignore'));
-  if (!(await fileExists(path.join(root, '.claude', 'CLAUDE.md')))) {
-    await fs.writeFile(path.join(root, '.claude', 'CLAUDE.md'), DEFAULT_CLAUDE_MD, 'utf8');
+  // 记忆体系改版迁移（2026-08-24，幂等：源不在了就什么都不做）——
+  // CLAUDE.md 从 .claude/ 挪到工作区根（画布可见，SDK 两处都读、根优先级同级），
+  // 老的偏好/风格档案并进去，SDK auto-memory 的存量从 .claude/agent-memory/auto
+  // 搬到画布可见的 记忆/。三步全是"搬走后源删除"，跑几遍结果一样。
+  await migrateMemoryLayout(root, { fileExists });
+  if (!(await fileExists(path.join(root, 'CLAUDE.md')))) {
+    await fs.writeFile(path.join(root, 'CLAUDE.md'), DEFAULT_CLAUDE_MD, 'utf8');
   }
   // settings.json：每次 merge defaults 让代码层 default 升级时现存 project 自动跟上
   // （用户字段优先，缺失的 NoDesign default 字段补进去）

package/server/services/rembg-launcher.js

@@ -32,7 +32,7 @@ import { fileURLToPath } from 'node:url';
 import path from 'node:path';
 import http from 'node:http';
 import { promises as fs, readFileSync, writeFileSync } from 'node:fs';
-import { REMBG_VENV_PYTHON, REMBG_SETUP_HINT } from '../engine/mcp/tools/helpers/rembg.js';
+import { REMBG_VENV_PYTHON, REMBG_SETUP_HINT, resolveRembgSocket } from '../engine/mcp/tools/helpers/rembg.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 // services/ 在 server/services/，server root 上溯 1 层
@@ -46,7 +46,10 @@ const DEFAULT_SERVICE = path.join(__dirname, 'rembg-service.py');
 // 改回多模型预热：env NODESIGN_REMBG_PRELOAD=isnet-general-use,birefnet-general-lite
 const DEFAULT_PRELOAD = 'isnet-general-use';
 
-const DEFAULT_SOCKET = '/tmp/nodesign-rembg.sock';
+// 按端口派生的实例私有 socket（真相源在 helpers/rembg.js 的 resolveRembgSocket；
+// 08-24 案：prod/exp 共用一个默认路径时，killStaleServices 按 socket 判"自己人"
+// 形同虚设，exp 一启动就把生产的抠图服务当 stale 杀掉再自己占坑）
+const DEFAULT_SOCKET = resolveRembgSocket();
 const MAX_RSS_MB = Number(process.env.NODESIGN_REMBG_MAX_RSS_MB ?? 900);
 const WATCH_MS = Number(process.env.NODESIGN_REMBG_WATCH_MS ?? 60_000);
 

package/web/dist/assets/{BrowserWindow-P_vIdh-G.js → BrowserWindow-BoOBaIyz.js}

@@ -1,4 +1,4 @@
-import{c as G,r as i,B as z,H as ee,j as t,I as te,F as y,a as $,G as u,b as ne,A as ie,C as N,d as c,e as j,L as W,f as se,g as re,h as oe}from"./index-GAamh1p4.js";import{A as ae,R as le}from"./rotate-cw-KAfChbGV.js";/**
+import{c as G,r as i,B as z,H as ee,j as t,I as te,F as y,a as $,G as u,b as ne,A as ie,C as N,d as c,e as j,L as W,f as se,g as re,h as oe}from"./index-DGG5wIZs.js";import{A as ae,R as le}from"./rotate-cw-CXJcyHWk.js";/**
  * @license lucide-react v0.468.0 - ISC
  *
  * This source code is licensed under the ISC license.