@xiaobuyu/nodesign 0.0.6 → 0.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiaobuyu/nodesign",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "private": false,
   "type": "module",
   "description": "NoDesign: an infinite canvas workbench for independent creators. An agent builds sites, decks, documents, images and video as real files, on your machine, with your own model key.",

package/server/api/assets/helpers.js

@@ -40,3 +40,21 @@ export function parseNoteFrontmatter(raw) {
   const sm = /(?:^|\n)session:\s*([A-Za-z0-9-]{8,64})\s*(?:\n|$)/.exec(m[1]);
   return { body: raw.slice(m[0].length).replace(/^\n+/, ''), sessionId: sm ? sm[1] : null };
 }
+
+/** 能上预览的文本类文件（08-24：md/json 等文件卡从细条升级成带内容预览的卡） */
+export const PREVIEW_EXTS = new Set(['.md', '.markdown', '.txt', '.json', '.csv', '.yaml', '.yml']);
+
+/**
+ * 文本文件预览上卡（08-24）：截前 1KB 进 `preview` 字段（不是 `text` —— 那是
+ * 便签卡的正文真相，复用会把 NoteFaces 的分面语义漏到文件卡上）。frontmatter
+ * 头藏掉（记忆/ 主题文件的 SDK 头对预览是噪音）。完整内容走 artifact-file。
+ */
+export async function decorateFilePreview(item, absPath) {
+  try {
+    const raw = await fs.readFile(absPath, 'utf8');
+    const head = /^---\n[\s\S]{0,1200}?\n---\n?/.exec(raw)?.[0] || '';
+    const body = raw.slice(head.length).trimStart();
+    item.preview = body.length > 1024 ? body.slice(0, 1024) + '…' : body;
+  } catch { /* 读不到就没有预览，卡退回细条 */ }
+  return item;
+}

package/server/api/assets/notes.js

@@ -14,6 +14,7 @@ import path from 'node:path';
 import { promises as fs } from 'node:fs';
 import { safeSegment, parseNoteFrontmatter } from './helpers.js';
 import { patchBoard } from '../../projects/board-store.js';
+import { MEMORY_DIR_NAME } from '../../engine/agent/memory-config.js';
 
 /**
  * @param {object} deps
@@ -173,6 +174,55 @@ export function mountNotesRoutes({ router, guardProject, getSharedDir, ensurePro
     } catch (err) { next(err); }
   });
 
+  /**
+   * 记忆（记忆/<name>.md，2026-08-24 记忆体系改版）：用户侧改 / 删。
+   * 记忆是 agent 的长期状态，画布可见的设计承诺是"用户看得到也**能改**、
+   * 改了算数"——这两条路由就是"能改"的那半。frontmatter（SDK 的
+   * name/description/metadata 头）与板书同一套保头逻辑：正文只收正文。
+   * ⚠️ MEMORY.md 是索引不在这条路上编辑（索引由 agent 按 SDK 合同维护）。
+   */
+  const resolveMemoryNote = (pid, name) => {
+    const base = path.join(getSharedDir(pid), MEMORY_DIR_NAME);
+    const file = path.resolve(base, name);
+    return file.startsWith(base + path.sep) ? file : null;
+  };
+  router.put('/:pid/memory-notes/:name', express.json(), async (req, res, next) => {
+    try {
+      if (!guardProject(req, res)) return;
+      const { name } = req.params;
+      if (!safeNoteSegment(name, { md: true })) return res.status(400).json({ error: 'invalid filename' });
+      if (name === 'MEMORY.md') return res.status(400).json({ error: 'MEMORY.md is the index — edit topic files instead' });
+      const text = String(req.body?.text ?? '');
+      if (!text.trim()) return res.status(400).json({ error: 'text required' });
+      if (text.length > 40_000) return res.status(400).json({ error: 'too long (max 40k chars)' });
+      const file = resolveMemoryNote(req.params.pid, name);
+      if (!file) return res.status(400).json({ error: 'invalid path' });
+      let head = '';
+      try { head = /^---\n[\s\S]{0,1200}?\n---\n?/.exec(await fs.readFile(file, 'utf8'))?.[0] || ''; } catch { /* 新文件 */ }
+      const incomingHead = /^---\n[\s\S]{0,1200}?\n---\n?/.exec(text)?.[0] || '';
+      const body = text.slice(incomingHead.length).replace(/^\n+/, '');
+      if (!body.trim()) return res.status(400).json({ error: 'text required' });
+      await fs.mkdir(path.dirname(file), { recursive: true });
+      await fs.writeFile(file, `${head || incomingHead}${head || incomingHead ? '\n' : ''}${body.replace(/\n+$/, '')}\n`, 'utf8');
+      res.json({ ok: true, path: `${MEMORY_DIR_NAME}/${name}` });
+    } catch (err) { next(err); }
+  });
+  router.delete('/:pid/memory-notes/:name', async (req, res, next) => {
+    try {
+      if (!guardProject(req, res)) return;
+      const { name } = req.params;
+      if (!safeNoteSegment(name, { md: true })) return res.status(400).json({ error: 'invalid filename' });
+      const file = resolveMemoryNote(req.params.pid, name);
+      if (!file) return res.status(400).json({ error: 'invalid path' });
+      try { await fs.unlink(file); } catch (err) {
+        if (err.code === 'ENOENT') return res.status(404).json({ error: 'not found' });
+        throw err;
+      }
+      try { await patchBoard(req.params.pid, { objects: { [`${MEMORY_DIR_NAME}/${name}`]: null } }); } catch { /* 清不掉不挡删除 */ }
+      res.status(204).end();
+    } catch (err) { next(err); }
+  });
+
   /** DELETE /:pid/task-notes/:filename — 删便利贴 */
   router.delete('/:pid/task-notes/:filename', async (req, res, next) => {
     try {

package/server/api/assets.js

@@ -18,17 +18,18 @@ import { guardProject } from './_guard.js';
 import {
   getSharedDir, ensureProjectWorkspace, removeSessionWorkspace, commitWorkspace,
 } from '../projects/workspace.js';
-import { patchBoard, readBoard, reconcileBoardRenames, forwardId, forwardPath, renameBoardPaths } from '../projects/board-store.js';
+import { patchBoard, readBoard, reconcileBoardRenames, pruneDanglingBindings, forwardId, forwardPath, renameBoardPaths } from '../projects/board-store.js';
 import { moveEntry, MoveError } from '../projects/move-entry.js';
 import { reconcileAutoRefsThrottled } from '../lib/auto-relations.js';
 import { taskManifest, ENTRY_FILE, KIND_SITE, docxClaimedFiles, isDirArtifact } from '../lib/artifact-target.js';
-import { RESERVED_DIRS, HARD_IGNORE_DIRS, DRAFTS_DIR, isReservedFile } from '../lib/task-scan.js';
+import { RESERVED_DIRS, HARD_IGNORE_DIRS, DRAFTS_DIR, isReservedFile, loadIgnore } from '../lib/task-scan.js';
+import { OUTPUT_DIRS } from '../lib/kinds/site.js';
 import { listReferences } from '../lib/reference-assets.js';
 import { resolveArtifactFile, isServablePath } from '../lib/artifact-file-path.js';
 import { getProjectCover } from '../lib/cover.js';
 import { makeDocxPageHandler, makeDocxPdfHandler } from './assets/docx-page.js';
 import { mountNotesRoutes } from './assets/notes.js';
-import { safeSegment, decorateNoteText } from './assets/helpers.js';
+import { safeSegment, decorateNoteText, decorateFilePreview, PREVIEW_EXTS } from './assets/helpers.js';
 import { CHALK_DIR } from '../lib/chalk.js';
 import {
   sendImage, isThumbPath, findOriginalForThumbnail, imageCacheControl,
@@ -254,10 +255,10 @@ router.get('/:pid/artifacts', async (req, res, next) => {
     // 那个接口，而迁移一旦晚于第一次渲染，用户会先看到一个叫 `tasks` 的文件夹
     // 套着他的文件夹。跑过之后是三次 stat 的事（幂等早退），不值得省。
     await ensureProjectWorkspace(req.params.pid);
-    // 跟上 agent 在画布背后做的改名（`mv` 之后卡片 id 就变了）。同上：挂在这里
-    // 是为了让用户看到的第一帧就是对齐过的。没有新 commit 时是一次 rev-parse。
+    // 跟上 agent 在画布背后做的改名（挂在这让第一帧就对齐；无新 commit 时只一次 rev-parse）
     await reconcileBoardRenames(req.params.pid).catch(
       (err) => console.warn('[board] 改名对账失败:', err.message));
+    await pruneDanglingBindings(req.params.pid).catch(() => {});   // 悬空线 30s 节流清扫（理由见 board-store）
 
     const assetsDir = path.join(getSharedDir(req.params.pid), 'assets');
     const artifacts = [];
@@ -349,8 +350,9 @@ router.get('/:pid/artifacts', async (req, res, next) => {
             item.meta = JSON.parse(metaRaw);
           } catch { /* 无 sidecar（旧图）→ 无 meta */ }
         }
-        // 便签/板书把正文带给前端渲卡片（≤4KB 截断，完整内容走 artifact-file；见 helpers.decorateNoteText）
+        // 便签/板书带正文、文本文件带 1KB 预览（完整内容都走 artifact-file；见 helpers）
         if (kind === 'note' && ext === '.md') await decorateNoteText(item, path.join(dir, e.name));
+        else if (kind === 'task-file' && PREVIEW_EXTS.has(ext)) await decorateFilePreview(item, path.join(dir, e.name));
         artifacts.push(item);
       }
     };
@@ -376,6 +378,7 @@ router.get('/:pid/artifacts', async (req, res, next) => {
     // 磁盘上的位置是同一个字符串 —— 这样 agent `mv` 一个文件之后，git 的改名
     // 检测能直接翻译成画布 id 的改名（见 board-store 的 reconcileBoardRenames）。
     const workspaceRoot = getSharedDir(req.params.pid);
+    const rootIgnore = await loadIgnore(workspaceRoot);
     const tasks = [];
     let hasRootSite = false;
     // 根站认领的一级子目录（pages 顶层段）—— 散文件过滤要用同一口径
@@ -474,6 +477,8 @@ router.get('/:pid/artifacts', async (req, res, next) => {
         if (!e.isDirectory() || e.name.startsWith('.')) continue;
         if (RESERVED_DIRS.has(e.name) || HARD_IGNORE_DIRS.has(e.name)) continue;
         if (e.name === DRAFTS_DIR) continue;      // 站点试作，由 site 解析器管
+        // 构建目录不当独立站/收纳夹（site:dist 案）；递归也吃根 .ndignore（与页面清单同规则）
+        if (OUTPUT_DIRS.includes(e.name) || rootIgnore(under(rel, e.name), true)) continue;
         if (claimed.has(e.name)) continue;        // 已经是一件产物了
         folders.push(under(rel, e.name));
         await collect(path.join(dir, e.name), under(rel, e.name), depth + 1);

package/server/api/instruction.js

@@ -1,7 +1,7 @@
 /**
  * server/api/instruction.js — 项目 Instruction 文件读写
  *
- * Instruction = workspace/.claude/CLAUDE.md。SDK 启用 settingSources:
+ * Instruction = workspace/CLAUDE.md（2026-08-24 挪到工作区根：画布可见 + SDK 根目录也原生注入）。SDK 启用 settingSources:
  * ['project'] 后 agent 进每次 session 自动读到 system prompt。S1 已经
  * 在 ensureProjectWorkspace 写入模板 starter，本阶段加 GET/PUT 让前端
  * "项目背景" tab 直接编辑该文件。
@@ -37,7 +37,7 @@ router.get('/:pid/instruction', async (req, res, next) => {
     // ensureProjectWorkspace 幂等补齐（老 project 第一次进 instruction tab 也能读到）
     await ensureProjectWorkspace(req.params.pid);
 
-    const filePath = path.join(getSharedDir(req.params.pid), '.claude', INSTRUCTION_FILE);
+    const filePath = path.join(getSharedDir(req.params.pid), INSTRUCTION_FILE);
     try {
       const content = await fs.readFile(filePath, 'utf8');
       res.json({ content, exists: true });
@@ -66,7 +66,7 @@ router.put('/:pid/instruction', async (req, res, next) => {
     }
 
     await ensureProjectWorkspace(req.params.pid);
-    const filePath = path.join(getSharedDir(req.params.pid), '.claude', INSTRUCTION_FILE);
+    const filePath = path.join(getSharedDir(req.params.pid), INSTRUCTION_FILE);
     await fs.writeFile(filePath, content, 'utf8');
     res.json({ ok: true });
   } catch (err) { next(err); }

package/server/engine/agent/events.js

@@ -41,7 +41,7 @@
  *   run.rate_limit             { info }                                    rate limit 变化
  *   run.image_generated        { path, sizeBytes, prompt, assetRole, ... } generate_image 完成（Phase A）
  *   board.updated              { objectId, zoneId, summary }               pin_to_board 改画布布局（sessionId:null 广播，前端整份重拉 board.json）
- *   board.focus                { rect, tag, layer }                        agent 落了一张草图（sessionId:null 广播；前端只在黑板模式跟镜头）
+ *   board.focus                { rect, tag, layer, soft, chalk }           agent 落了草图/板书（sessionId:null 广播；黑板模式跟镜头，chalk 进精灵追踪）
  *   project.active_session     { activeSessionId }                         项目级会话指针变更（故意不带 sessionId —— 见构造器注释）
  *
  * 外层把 EventBus 桥接到：
@@ -271,6 +271,16 @@ export const Events = {
   // C4 FileChanged hook → 前端 reload iframe
   fileChanged: (filePath, event) => ({ type: 'run.file_changed', filePath, event }),
 
+  /**
+   * 板书/草图落定广播（sessionId:null）。原是 write-on-board / sketch-on-board
+   * 里两份内联对象 —— 08-24 板书进精灵追踪链后它有了第三个读者（在场 reducer
+   * 认 chalk 字段），形状收进构造器钉住（前端 parity 测试对着这里逐字校）。
+   * chalk = 板书文件的工作区相对路径（就是它的画布 id）；草图不传。
+   */
+  boardFocus: (rect, { tag = null, layer = '', soft = false, chalk = null } = {}) => (
+    { type: 'board.focus', sessionId: null, rect, tag, layer, soft, chalk }
+  ),
+
   // ── Phase 1 翻译补全 ──
 
   // SDKAPIRetryMessage（sdk.d.ts:2322）：API 请求失败可重试。

package/server/engine/agent/hooks/failure.js

@@ -34,11 +34,14 @@ export function makePostToolUseFailureHandler({ ctx, projectId, sessionId }) {
     // 表面上活儿还是干完的，于是"某个工具本周失败 40 次"没人知道。
     // fail-soft：记录本身绝不能变成新的故障源。
     try {
+      // Bash 把命令带进 detail（不进指纹）：exit 144 那类静默死的命令，detail 里
+      // 只有一句 "Exit code N"，事后连是谁死的都考证不了（08-24 案，转录已清）
+      const cmd = tool === 'Bash' ? String(input?.tool_input?.command || '').slice(0, 300) : '';
       recordIssue({
         source: 'auto',
         toolName: tool,
         summary: `${tool} 失败：${error.slice(0, 120)}`,
-        detail: error,
+        detail: cmd ? `${error}\n[cmd] ${cmd}` : error,
         projectId,
         sessionId,
         signature: signatureOf(`${tool}|${error}`),
@@ -70,6 +73,13 @@ export function makePostToolUseFailureHandler({ ctx, projectId, sessionId }) {
         + '  1. sandbox 拦截（命令访问越界文件 / 不允许的网络）→ 换 Read / Glob / Grep / MCP 工具\n'
         + '  2. cwd 越界 → 路径相对 workspace\n'
         + '  3. 命令本身错（参数 / 文件不存在）→ 检查 stderr';
+    } else if (/_batch$/.test(tool)) {
+      // batch 一步失败整批标错，但失败步之前的动作（click / type 这类非幂等的）
+      // **已经执行过了** —— 兜底那句"先重试 1 次"对 batch 是错的，会重放前面的步骤。
+      advice =
+        `${tool} 失败：${error.slice(0, 200)}\n`
+        + '返回文本第一行标了失败在第几步。**不要整批重跑** —— 失败步之前的动作已经执行过了；\n'
+        + '看当前状态（返回末尾的截图），只从失败那一步起继续（单独调用或开一个新 batch）。';
     } else if (tool === 'Write' || tool === 'Edit') {
       advice =
         `${tool} 失败。检查：\n`

package/server/engine/agent/hooks/lifecycle.js

@@ -4,7 +4,6 @@
  */
 import { Events } from '../events.js';
 import { getQuery } from '../../runs/active-runs.js';
-import { mutateSpecJson } from '../../../projects/workspace.js';
 import { listWorkspaceArtifacts } from '../../../lib/artifact-target.js';
 import { resetTurnMemory } from './turn-state-memory.js';
 
@@ -104,11 +103,11 @@ export function makeStopReflectionHandler({ ctx, workspaceRoot }) {
                 const remain = Math.max(0, realMax - used).toLocaleString();
                 let body;
                 if (hit.tone === 'soft') {
-                  body = `上下文已用 ${percent}%（${usedStr}/${maxStr} tokens），还能再写一阵；下一个段落收尾时把当前进度落一张便利贴（record_decision 或 Write notes/<slug>.md），避免后续 compact 丢上下文。`;
+                  body = `上下文已用 ${percent}%（${usedStr}/${maxStr} tokens），还能再写一阵；下一个段落收尾时把当前进度记进记忆（记忆/ 主题文件+MEMORY.md 一行）或落一张便利贴（Write notes/<slug>.md），避免后续 compact 丢上下文。`;
                 } else if (hit.tone === 'firm') {
                   body = `上下文已用 ${percent}%（${usedStr}/${maxStr}，剩 ~${remain}）。从下一轮开始整理结论 / 落档，避免被自动 compact 硬切。`;
                 } else {
-                  body = `上下文已用 ${percent}%（${usedStr}/${maxStr}）。已逼近 SDK auto-compact 触发线（90%）；立即收尾或把结论落进便利贴（record_decision / notes/），否则下一轮可能被压缩中断当前思路。`;
+                  body = `上下文已用 ${percent}%（${usedStr}/${maxStr}）。已逼近 SDK auto-compact 触发线（90%）；立即收尾并把结论存进记忆（记忆/）或便利贴（notes/），否则下一轮可能被压缩中断当前思路。`;
                 }
                 warnContextUsage = `<system-reminder>\n[context-usage] ${body}\n</system-reminder>`;
               }
@@ -129,46 +128,18 @@ export function makeStopReflectionHandler({ ctx, workspaceRoot }) {
 }
 
 /**
- * PostCompact handler（P0+ s1 C7）—— SDK 自动 compact 后把 summary 持久化到 spec.json。
+ * PostCompact handler —— compact 后重置每轮注入的状态指纹（摘要把上一轮状态吞了，
+ * "同上轮"没有所指，下一轮要重新全量）。
  *
- * input: PostCompactHookInput (sdk.d.ts:1879)
- *   - trigger: 'manual' | 'auto'
- *   - compact_summary: string
- *
- * 失败 fail-soft：spec.json 写不进去 console.warn 但不抛错（不阻塞 query）。
+ * 历史：这里曾把 compact_summary 持久化进 spec.history[]（auto-memory 启用前的
+ * 平行记忆方案）。2026-08-24 记忆体系改版拆除 —— 压缩前的要点保存交给 SDK 的
+ * auto-memory（系统提示明写"存记忆要在本轮回复里完成"），spec.json 不再当记忆载体。
+ * run.compact_persisted 事件随之停发（前端消费已同批拆）。
  */
-export function makePostCompactHandler({ ctx, workspaceRoot, sessionId }) {
-  return async (input, _toolUseId, _options) => {
+export function makePostCompactHandler({ ctx: _ctx, workspaceRoot: _ws, sessionId }) {
+  return async (_input, _toolUseId, _options) => {
     try {
-      // 压缩后上一轮的状态块已经被摘要吞了，"同上轮"没有所指 —— 让下一轮重新全量
       resetTurnMemory(sessionId);
-      if (!workspaceRoot) return {};
-      const summary = input?.compact_summary;
-      if (!summary || typeof summary !== 'string') return {};
-
-      // 串行 read-modify-write 防 spec.json 三路并发覆盖（详见 workspace.js mutateSpecJson）
-      // historyCount 在回调内 capture 出去 —— 之前 emit 里直接引用 spec 是 ReferenceError，
-      // 整段被 try 静默吞，导致 run.compact_persisted 事件永远不发。
-      let historyCount = 0;
-      await mutateSpecJson(workspaceRoot, (spec) => {
-        if (!Array.isArray(spec.history)) spec.history = [];
-        spec.history.push({
-          ts: new Date().toISOString(),
-          source: 'compact',
-          trigger: input.trigger || 'auto',
-          summary,
-        });
-        historyCount = spec.history.length;
-      });
-
-      try {
-        ctx.emit({
-          type: 'run.compact_persisted',
-          trigger: input.trigger || 'auto',
-          summaryLength: summary.length,
-          historyCount,
-        });
-      } catch { /* emit fail-safe */ }
     } catch (err) {
       console.warn(`[hooks/PostCompact] handler threw:`, err.message);
     }

package/server/engine/agent/hooks/post-guidance.js

@@ -9,7 +9,6 @@
  * SDK 默认行为。如未来观察到 agent 反复 record_decision 信号稀释，再考虑
  * 加回（那时改成更精准的 anti-loop 检测，不是无脑注引导）。
  */
-import path from 'node:path';
 
 /**
  * PostToolUse(screenshot_canvas) handler — agent 截图后引导它做视觉自检。
@@ -167,40 +166,7 @@ export function makePostToolUseGenerateImageRegenWatchdog() {
   };
 }
 
-/**
- * PostToolUse(record_decision) —— 锚定风格那一笔之后提醒落两处长期资产
- * （2026-07-28，配合"记忆归 SDK / 品牌归我们 / 指引归用户"的分工）
- *
- * 只在这一笔上注、每 session 一次：
- *   - 品牌档案 `agent-memory/brand/memory.md` —— 前端 BrandCard 会把色板 /
- *     字体渲染出来，是结构化资产，agent 不写就永远空着
- *   - 项目指引 `.claude/CLAUDE.md` —— SDK 每次 session 自动读进 system prompt，
- *     但只有用户能决定要不要固化，所以是"问一句"不是"直接写"
- *
- * 通用偏好不在这儿管：那是 SDK 自动记忆的活（autoMemoryDirectory 已指到
- * .claude/agent-memory/auto，前端记忆卡直接显示）。
- */
-export function makePostToolUseStyleAnchorNudge({ sharedRoot }) {
-  let nudged = false;
-  const ANCHOR_RE = /(style-anchor|风格锚|锚定|视觉基调|palette|配色方案)/i;
-  return async (input, _toolUseId, _options) => {
-    if (nudged) return {};
-    const t = input?.tool_input || {};
-    const blob = `${t.topic || ''} ${t.title || ''} ${t.decision || ''} ${t.rationale || ''}`;
-    if (!ANCHOR_RE.test(blob)) return {};
-    nudged = true;
-    const guidePath = sharedRoot ? path.join(sharedRoot, '.claude', 'CLAUDE.md') : '.claude/CLAUDE.md';
-    return {
-      hookSpecificOutput: {
-        hookEventName: 'PostToolUse',
-        additionalContext:
-          '这一笔看起来是在锚定这个项目的视觉方向。顺手做两件事（都只做一次）：\n'
-        + '1. 把这版风格写进 `.claude/agent-memory/brand/memory.md`（色号 / 字体链 / 版式语言 / 动效预算；⚠️ 带 .claude/ 前缀，写错位置 BrandCard 读不到），'
-        + '前端品牌档案卡会把色板和字体渲染出来给用户看，不写就一直空着。\n'
-        + `2. 如果这次定下来的还包含**项目级约束**（不只这一个 deck 适用，比如"这个项目一律不用 emoji"），`
-        + `在收尾时问用户一句要不要写进项目指引（${guidePath}，SDK 每次 session 自动读它）。用户点头你再写。\n`
-        + '用户的通用偏好不用你手动记，系统的自动记忆会管。',
-      },
-    };
-  };
-}
+// （makePostToolUseStyleAnchorNudge 2026-08-24 随 record_decision 一起拆除：
+//  风格落盘提醒并进 auto-memory 追加指导；品牌档案文件本身已并入工作区根
+//  CLAUDE.md 的「风格档案」节，BrandCard 同批退役。）
+

package/server/engine/agent/hooks/user-prompt-submit.js

@@ -1,7 +1,7 @@
 /**
  * UserPromptSubmit handler — 每次用户输入前注入工作区**状态**（2026-08-21 重做）
  *
- * 注的是状态不是指令：cwd、素材清单、旧决策、便利贴、画布关系线、产物清单、tweaks 开关。
+ * 注的是状态不是指令：cwd、素材清单、便利贴、画布关系线、产物清单。
  * 怎么用这些东西（路径表、"先看有没有现成的素材"、工具怎么选）住 prelude，那是缓存的
  * system prompt；每轮再说一遍是上下文里的 N 倍重复。
  *
@@ -23,7 +23,7 @@
  */
 import fs from 'node:fs/promises';
 import path from 'node:path';
-import { readUiConfigFile } from '../../../projects/ui-config.js';
+import { readUiConfigFile, withUiDefaults } from '../../../projects/ui-config.js';
 import { readAssetsSummary } from '../../../projects/assets-summary.js';
 import { relationsDigest } from '../../../lib/board-relations.js';
 import { getViewpoint, describeViewpoint } from '../../../projects/viewpoint-store.js';
@@ -37,11 +37,6 @@ import {
 } from '../../../lib/artifact-target.js';
 import { getTurnMemory, setTurnMemory, fingerprint, diffItems } from './turn-state-memory.js';
 
-/** UserPromptSubmit hook 读取 spec.json 时的最大字节数 */
-const SPEC_JSON_MAX_BYTES = 200 * 1024;
-/** spec.json.decisions 注入摘要时取最近 N 条 */
-const SPEC_DECISIONS_TAIL = 5;
-
 /** PDF/Office 文档的解法（系统自带工具；python 包没装且装不上 —— 08-19 上报实锤）。只在首次出现二进制文档时说一遍。 */
 const BINARY_DOC_HINT = 'PDF / PPTX / DOCX / XLSX 直接 Read 拿不到结构化内容（二进制或 zip 包）。用系统自带的工具解'
   + '（pdfplumber/PyPDF2/python-docx/openpyxl 这些 python 包**没装且装不上**，别试）：'
@@ -72,25 +67,7 @@ async function collectSections({ workspaceRoot, sessionId, projectId }) {
     }
   } catch { /* 素材读不到就沉默 */ }
 
-  // spec.json 遗产决策：取最近 N 条
-  try {
-    const specPath = path.join(workspaceRoot, 'spec.json');
-    const stat = await fs.stat(specPath);
-    if (stat.size <= SPEC_JSON_MAX_BYTES) {
-      const spec = JSON.parse(await fs.readFile(specPath, 'utf8'));
-      const decisions = Array.isArray(spec?.decisions) ? spec.decisions : [];
-      if (decisions.length > 0) {
-        const recent = decisions.slice(-SPEC_DECISIONS_TAIL);
-        const lines = recent.map((d, i) => {
-          const idx = decisions.length - recent.length + i + 1;
-          const title = (d?.title || '(无标题)').slice(0, 80);
-          const rationale = (d?.rationale || '').slice(0, 200);
-          return `  ${idx}. ${title}${rationale ? ` — ${rationale}` : ''}`;
-        }).join('\n');
-        sections.push({ key: 'decisions', title: '旧决策档案', text: `旧决策档案（spec.json 遗产，共 ${decisions.length} 条，最近 ${recent.length} 条；新决策一律走 record_decision → 任务便利贴）：\n${lines}` });
-      }
-    }
-  } catch { /* spec.json 不存在 / 解析失败：noop */ }
+  // （spec.json 决策档案注入 2026-08-24 拆除：决策体系退役，长期事实走 CLAUDE.md/记忆）
 
   // 便利贴：metadata-not-content，只列文件和首行标题
   try {
@@ -160,8 +137,8 @@ async function collectSections({ workspaceRoot, sessionId, projectId }) {
     }
   } catch { /* 扫不动就不说 */ }
 
-  // tweaks 开关：文件不存在 = 用户没碰过 = 沉默
-  // 最近板书（2026-08-23）：你/用户在画布上说过的最近几句 —— 对话在板上，得记得板上说了什么
+  // 最近板书（2026-08-23；08-24 记忆改版时被误删，同日修回）：你/用户在画布上
+  // 说过的最近几句 —— 对话在板上，得记得板上说了什么
   try {
     const recent = await recentChalk(workspaceRoot, { limit: 8 });
     if (recent.length) {
@@ -169,10 +146,11 @@ async function collectSections({ workspaceRoot, sessionId, projectId }) {
       sections.push({ key: 'chalk', title: '最近板书', text: `画布上最近的板书（${CHALK_DIR}/，新在前；正文 Read 文件）：\n${lines.join('\n')}`, items: recent.map(c => c.path) });
     }
   } catch { /* 板书读不到就沉默 */ }
-  // 黑板模式（2026-08-23）：用户在画布上专注思考时开。这一节只在开着时注入，关着不提。
+
+  // 黑板模式（2026-08-23；08-24 起默认开 —— 没写过这个键的按开算，显式 false 才算关）
   try {
-    const cfg = await readUiConfigFile(workspaceRoot);
-    if (cfg?.blackboard_mode === true) {
+    const cfg = withUiDefaults(await readUiConfigFile(workspaceRoot));
+    if (cfg.blackboard_mode === true) {
       sections.push({ key: 'blackboard', title: '黑板模式', text:
         '【黑板模式：开】用户此刻在画布上专注思考。这一轮默认这么做：想事情就画成图（sketch_on_board，'
         + '小改动用 edit_sketch 原地改别重画）；做完一件东西在它旁边写一条板书（write_on_board near=）；'
@@ -180,15 +158,8 @@ async function collectSections({ workspaceRoot, sessionId, projectId }) {
         + '尺寸守规范（0.8 倍一屏可读、正文 md 起、一条板书说一件事）；画完 look_at_board 看一眼再收。' });
     }
   } catch { /* 读失败：不注入 */ }
-  try {
-    const cfg = await readUiConfigFile(workspaceRoot);
-    if (cfg) {
-      const on = cfg?.tweaks_mode_enabled !== false;
-      sections.push({ key: 'tweaks', title: 'Tweaks 开关', text: on
-        ? '【Tweaks 模式：启用】用户偏好"可调产品"——deck 形态稳定后，建议调 expose_tweaks 暴露核心微调参数（颜色 / 字号 / 排版密度等）让用户拖滑杆即时改样式。'
-        : '【Tweaks 模式：禁用】用户在 toolbar 关闭了 Tweaks——这次跳过 expose_tweaks，按对话方式让用户提需求你来 Edit。已暴露的 controls 保留不动，不新增 / 不重 expose。' });
-    }
-  } catch { /* 读失败：默认行为，不注入 */ }
+
+  // （tweaks 开关注入 2026-08-24 随 expose_tweaks 暂退役一起摘除；工具升级后再回来）
 
   return sections;
 }

package/server/engine/agent/hooks.js

@@ -84,7 +84,6 @@ import {
   makePostToolUseScreenshotHandler,
   makePostToolUseExportHandler,
   makePostToolUseGenerateImageRegenWatchdog,
-  makePostToolUseStyleAnchorNudge,
 } from './hooks/post-guidance.js';
 import { makePostToolUseCanvasValidationHandler } from './hooks/canvas-validate.js';
 import { makePostToolUseSiteValidationHandler } from './hooks/site-validate.js';
@@ -294,13 +293,10 @@ export function createHooks({ ctx, workspaceRoot, sharedRoot, sessionId, project
           makePostToolUseSiteValidationHandler({ workspaceRoot }),
         ],
       },
-      // record_decision 一般**不注** additionalContext（"继续主任务"那种跟 SDK
-      // preset 重复，agent 自己懂）。唯一例外是"锚定风格"这一笔：那是项目级
-      // 长期资产该落盘的时刻，而品牌档案 / 项目指引这两处 SDK 不知道。
-      {
-        matcher: 'mcp__nodesign__record_decision',
-        hooks: [makePostToolUseStyleAnchorNudge({ sharedRoot })],
-      },
+      // （record_decision 及其 style-anchor nudge 2026-08-24 整条目拆除 ——
+      //  风格落盘的提醒并进 auto-memory 的追加指导（session-loop 的
+      //  CLAUDE_COWORK_MEMORY_EXTRA_GUIDELINES）。删的是**整个 {matcher, hooks}
+      //  条目**，空壳条目会让 SDK initialize 静默灭门，见 assertHooksWellFormed。）
     ],
 
     // PostToolUseFailure —— 任意工具失败时统一处理：emit 事件 + 给 agent

package/server/engine/agent/memory-config.js

@@ -0,0 +1,61 @@
+/**
+ * agent/memory-config.js — auto-memory 的产品化配置（2026-08-24 记忆体系改版）
+ *
+ * 记忆两层的分工（用户拍板）：
+ *   - `记忆/`（工作区根下，画布可见）：SDK auto-memory 的家。提示词、写入、
+ *     MEMORY.md 索引加载、权限放行全跟 autoMemoryDirectory 一个值走（二进制 yh()，
+ *     08-24 探明）。用户看得到每一条、也可能直接改。
+ *   - 根 `CLAUDE.md`：人工筛选的项目档案（指引/风格/习惯），SDK 每会话
+ *     确定性全量注入（settingSources 'project' 原生行为，根目录与 .claude/ 两处都读）。
+ *
+ * ⚠️ EXTRA_GUIDELINES 是**追加**不是替换：SDK 自己的记忆合同（frontmatter 契约、
+ * 两步写入、200 行索引上限与截断提醒）原样保留。别换成 CLAUDE_COWORK_MEMORY_GUIDELINES
+ * 整段替换 —— 那会把截断提醒一起抹掉，而截断逻辑仍在跑，索引爆了没人说话。
+ */
+
+import path from 'node:path';
+
+/** 记忆目录名（工作区根相对）。画布可见是设计要求，不是巧合。 */
+export const MEMORY_DIR_NAME = '记忆';
+
+export function memoryDirFor(sharedRoot) {
+  return path.join(sharedRoot, MEMORY_DIR_NAME);
+}
+
+/** 追加进 SDK 记忆提示末尾的产品口径（env CLAUDE_COWORK_MEMORY_EXTRA_GUIDELINES） */
+export const MEMORY_EXTRA_GUIDELINES = [
+  'This memory directory (记忆/) is VISIBLE on the user\'s canvas — they can read',
+  'every file and may edit them between sessions; treat edits as ground truth.',
+  'Keep file names as short English kebab-case slugs (the SDK contract), but write',
+  'descriptions and content in the user\'s language (中文 for this product).',
+  'When a style decision is settled (palette / fonts / materials / art direction),',
+  'record it as a `type: project` memory right away — style anchors are the most',
+  'expensive thing to lose between sessions.',
+  'Hard constraints and curated project guidance live in the workspace-root',
+  'CLAUDE.md (deterministically injected every session) — put lasting rules there',
+  '(with the user\'s consent), and put evolving facts here.',
+].join(' ');
+
+/**
+ * 把我们的 settings 跟 isolationOptions.settings **深合并**成 SDK 的最终 settings。
+ *
+ * ⛔ 存在的理由（08-24 案）：08-15 起 buildIsolationOptions 的返回值里也有
+ * settings 键，query options 里对象展开写在后面，把独立写的 settings 整个覆盖 ——
+ * autoMemoryEnabled / autoMemoryDirectory / skipWebFetchPreflight 八天没送到
+ * SDK 手里（agent 照 SDK 默认路径写记忆被沙盒拒、~/.claude 下堆了 187 个空目录）。
+ * 「两处同名键静默互吞」没有任何报错，出口断言在这里兜。
+ */
+export function mergeAgentSettings(isolationSettings, { skipWebFetchPreflight, sharedRoot }) {
+  const settings = {
+    ...isolationSettings,
+    skipWebFetchPreflight,
+    ...(sharedRoot ? {
+      autoMemoryEnabled: true,
+      autoMemoryDirectory: memoryDirFor(sharedRoot),
+    } : {}),
+  };
+  if (sharedRoot && !settings.autoMemoryDirectory) {
+    throw new Error('[memory-config] settings.autoMemoryDirectory 被吞了 —— 检查 settings 合并处');
+  }
+  return settings;
+}