@xiaobuyu/nodesign 0.0.1

package/server/projects/move-entry.js

@@ -0,0 +1,103 @@
+/**
+ * move-entry.js —— 「把一个东西搬到另一个文件夹」的唯一实现（2026-08-14 抽出）。
+ *
+ * 之前它整个住在 `POST /:pid/move` 的路由体里。agent 的整理工具
+ * （organize_board）要同一套语义 —— 按单一真相源纪律抽成一份，两个调用方
+ * （用户拖拽 / agent 归纳）共用，别长出第二套"怎么算搬得动"。
+ *
+ * 语义（见原路由注释，搬运时一字未改）：
+ *   ① fs.rename 先动磁盘，失败画布一个字节不改
+ *   ② renameBoardPaths 同一步改画布身份（物件/文件夹/归属/关系线端点）+ 转发表
+ *   ③ 调用方拿到新 board（前端要用它重写 layoutRef）
+ *   ④ commit 交给调用方（路由在响应后 commit；agent 工具每轮本来就落 commit）
+ *
+ * 失败用 MoveError 抛（带 status），路由映射成 http 状态码，工具映射成文案。
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+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';
+
+export class MoveError extends Error {
+  constructor(status, message) { super(message); this.status = status; }
+}
+
+const norm = (p) => String(p ?? '').replace(/\\/g, '/').replace(/^\/+|\/+$/g, '');
+
+async function exists(p) {
+  try { await fs.access(p); return true; } catch { return false; }
+}
+
+/**
+ * 哪些东西不许搬走：真·基础设施。
+ * `assets/` 2026-08-13 放开；`notes/` 2026-08-14 用户拍板放开 —— 便签也参与
+ * 归纳。搬出 notes/ 的 .md **明码换形态**（便签卡 → 阅读器文件卡，失去分面
+ * 翻页），这是桌面语义的自然结果不是事故；搬回 notes/ 仍被目标目录守卫挡着
+ *（RESERVED_DIRS），"升格回便签"要做的话单独开闸。
+ */
+const NO_MOVE_OUT = new Set(['exports', 'node_modules', 'agent-memory']);
+
+/**
+ * @param {string} pid
+ * @param {string} fromRaw  工作区相对路径（文件或文件夹）
+ * @param {string} toRaw    目标文件夹（'' = 工作区根）
+ * @param {object} [opts]   { createFolder: 目标夹不存在就 mkdir（agent 归纳常配新夹）}
+ * @returns {Promise<{ok:true, from:string, to:string, moved:boolean, board?:object}>}
+ */
+export async function moveEntry(pid, fromRaw, toRaw, { createFolder = false } = {}) {
+  const root = getSharedDir(pid);
+  const from = norm(fromRaw);
+  const to = norm(toRaw);
+  if (!from) throw new MoveError(400, 'from required');
+
+  const absFrom = path.resolve(root, from);
+  const absToDir = to ? path.resolve(root, to) : root;
+  const inside = (p) => p === root || p.startsWith(root + path.sep);
+  if (!inside(absFrom) || absFrom === root || !inside(absToDir)) {
+    throw new MoveError(400, 'path escapes workspace');
+  }
+  const guardSeg = (rel) => rel.split('/')[0];
+  if (NO_MOVE_OUT.has(guardSeg(from)) || guardSeg(from).startsWith('.')) {
+    throw new MoveError(400, '这个位置的东西不参与搬家');
+  }
+  if (to && (RESERVED_DIRS.has(guardSeg(to)) || guardSeg(to).startsWith('.'))) {
+    throw new MoveError(400, '不能搬进这个目录');
+  }
+  // 搬进自己肚子里（文件夹拖到它自己的子文件夹上）—— fs.rename 会报
+  // EINVAL，但那时目录树已经没法自洽了，提前拦住
+  if (to === from || to.startsWith(from + '/')) {
+    throw new MoveError(400, '不能把文件夹搬进它自己里面');
+  }
+
+  const srcStat = await fs.stat(absFrom).catch(() => null);
+  if (!srcStat) throw new MoveError(404, 'source not found');
+  let dirStat = await fs.stat(absToDir).catch(() => null);
+  if (!dirStat?.isDirectory()) {
+    if (!createFolder || !to) throw new MoveError(404, 'target folder not found');
+    await fs.mkdir(absToDir, { recursive: true });
+    dirStat = await fs.stat(absToDir);
+  }
+
+  // 目标目录**本身是一件产物**（整站）时不许搬进去：它的内部结构由
+  // 形态解析器管，塞进去的东西会从产物枚举里彻底消失（既不是页面也不是卡）。
+  // 站点收素材的正路是它的 assets/ 子目录（那一层不是产物根，照常放行）。
+  if (to) {
+    const m = await taskManifest(absToDir);
+    const opaque = (m?.artifacts || []).some(
+      a => a.kind === KIND_SITE && !a.single && !a.root);
+    if (opaque) throw new MoveError(400, '这是一件产物，不是收纳文件夹（站点收素材放它的 assets/ 子目录）');
+  }
+
+  const base = path.basename(from);
+  const nextRel = to ? `${to}/${base}` : base;
+  if (nextRel === from) return { ok: true, from, to: from, moved: false };
+  if (await exists(path.resolve(root, nextRel))) {
+    throw new MoveError(409, `「${base}」在那儿已经有一个了`);
+  }
+
+  await fs.rename(absFrom, path.resolve(root, nextRel));                    // ①
+  const { board } = await renameBoardPaths(pid, [[from, nextRel]]);         // ②
+  return { ok: true, from, to: nextRel, moved: true, board };               // ③
+}

package/server/projects/store.js

@@ -0,0 +1,270 @@
+/**
+ * server/projects/store.js — Project DB（SQLite）
+ *
+ * 跟 runs/store.js 共享同一个 better-sqlite3 connection（import 即拿 db 实例）。
+ *
+ * 表 projects：
+ *   id                  proj_<base36-ts>_<rand4>
+ *   name                人类可读
+ *   skill_id            默认 deskskill-engine-mini
+ *   active_session_id   SDK query() 返回的 sessionId（用 query({ resume }) 续 turn）
+ *   created_at / updated_at
+ *
+ * 同时给 runs 表加 project_id 列（ALTER 幂等），追溯 run 归属哪个 project。
+ *
+ * project 删除时由调用层负责级联删 workspace 目录 + 关联 runs。
+ */
+
+import db from '../engine/runs/store.js';
+
+// ── Schema ──
+db.exec(`
+  CREATE TABLE IF NOT EXISTS projects (
+    id                  TEXT PRIMARY KEY,
+    name                TEXT NOT NULL,
+    skill_id            TEXT NOT NULL DEFAULT 'deskskill-engine-mini',
+    description         TEXT,
+    active_session_id   TEXT,
+    created_at          TEXT NOT NULL DEFAULT (datetime('now')),
+    updated_at          TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_projects_updated ON projects(updated_at DESC);
+`);
+
+// ALTER runs 加 project_id（幂等）
+const runsCols = db.prepare('PRAGMA table_info(runs)').all();
+if (!runsCols.some(c => c.name === 'project_id')) {
+  db.exec('ALTER TABLE runs ADD COLUMN project_id TEXT');
+  db.exec('CREATE INDEX IF NOT EXISTS idx_runs_project_created ON runs(project_id, created_at DESC)');
+  console.log('[projects/store] runs.project_id column added');
+}
+
+// 兼容老 DB：projects 表可能创建于 active_session_id 字段加入之前，
+// 缺这列。CREATE TABLE IF NOT EXISTS 不会修改已存在表，需要 ALTER 补。
+const projectsCols = db.prepare('PRAGMA table_info(projects)').all();
+const projectsColNames = new Set(projectsCols.map(c => c.name));
+if (!projectsColNames.has('active_session_id')) {
+  db.exec('ALTER TABLE projects ADD COLUMN active_session_id TEXT');
+  console.log('[projects/store] projects.active_session_id column added (old DB compat)');
+}
+
+// S1：projects 表加 description 列（幂等）+ 一次性清洗老 active_session_id。
+//
+// 旧 active_session_id 全是无效值——之前 session-loop.js persistSession=false 时 SDK
+// 不写 JSONL 但 setActiveSession 依然把 sessionId 写回（写不成功也被 turn.js
+// 的 try/catch 吞掉，列存在时则成功写入幽灵 sid）。S1 切换 persistSession=true
+// 之前必须把这些幽灵 sid 清掉，否则首次 resume 全 fail（兜底有 try/catch retry
+// 但能少踩就少踩）。
+//
+// 清洗跟 description 加列绑定 — if 进过一次后 description 列存在，下次启动
+// 不再进，自然只跑一次。
+if (!projectsColNames.has('description')) {
+  db.exec('ALTER TABLE projects ADD COLUMN description TEXT');
+  db.exec("UPDATE projects SET active_session_id = NULL WHERE active_session_id IS NOT NULL");
+  console.log('[projects/store] projects.description column added; active_session_id cleared');
+}
+
+// 入口流程重构：kind 区分「标准项目（project）」vs「闪聊（quick）」。
+// 默认 'project' 让老数据零行为变化；闪聊由 Home 大输入框隐式建出，标 'quick'。
+// 用户可在 Workspace 顶栏「升级为项目」把 quick → project（PATCH kind）。
+if (!projectsColNames.has('kind')) {
+  db.exec("ALTER TABLE projects ADD COLUMN kind TEXT NOT NULL DEFAULT 'project'");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_projects_kind_updated ON projects(kind, updated_at DESC)");
+  console.log('[projects/store] projects.kind column added (default project)');
+}
+
+// 首页入口重构（2026-07-28）：主页大输入框不再建"闪聊"，直接建真项目，
+// 名字先用用户那句话垫着，第一轮跑完再用 SDK helper 写的会话摘要改名一次。
+// auto_named=1 表示"这名字是系统垫的，可以被摘要覆盖"；用户一改名就清零。
+if (!projectsColNames.has('auto_named')) {
+  db.exec('ALTER TABLE projects ADD COLUMN auto_named INTEGER NOT NULL DEFAULT 0');
+  console.log('[projects/store] projects.auto_named column added');
+}
+
+// 多用户内测（2026-07-30）：项目归属。NULL 的存量行由 bootstrapAuth() 回填 admin
+if (!projectsColNames.has('owner_id')) {
+  db.exec('ALTER TABLE projects ADD COLUMN owner_id TEXT');
+  db.exec('CREATE INDEX IF NOT EXISTS idx_projects_owner_updated ON projects(owner_id, updated_at DESC)');
+  console.log('[projects/store] projects.owner_id column added');
+}
+
+// 多用户内测（2026-07-30）：runs 计量真列 + 归属。原来 usage 全塞 metadata JSON
+// （且值全 0，absorbResult 断链），配额查询要 sum，promote 成真列
+const RUN_METRIC_COLS = [
+  ['user_id', 'TEXT'],
+  ['input_tokens', 'INTEGER'],
+  ['output_tokens', 'INTEGER'],
+  ['cache_read_tokens', 'INTEGER'],
+  ['cache_create_tokens', 'INTEGER'],
+  ['total_cost_usd', 'REAL'],
+];
+{
+  const cols = new Set(db.prepare('PRAGMA table_info(runs)').all().map(c => c.name));
+  let added = false;
+  for (const [name, type] of RUN_METRIC_COLS) {
+    if (!cols.has(name)) {
+      db.exec(`ALTER TABLE runs ADD COLUMN ${name} ${type}`);
+      added = true;
+    }
+  }
+  if (added) {
+    db.exec('CREATE INDEX IF NOT EXISTS idx_runs_user_created ON runs(user_id, created_at DESC)');
+    console.log('[projects/store] runs 计量列 + user_id added');
+  }
+}
+
+// 07-31 定案的欠账：runs 记会话归属 —— 回答"哪个会话最烧钱/最长"不用去数
+// sessions/ 目录。存量行 NULL 不回填（目录里还能对出来，不值得写迁移）。
+{
+  const cols = new Set(db.prepare('PRAGMA table_info(runs)').all().map(c => c.name));
+  if (!cols.has('session_id')) {
+    db.exec('ALTER TABLE runs ADD COLUMN session_id TEXT');
+    db.exec('CREATE INDEX IF NOT EXISTS idx_runs_session ON runs(session_id)');
+    console.log('[projects/store] runs.session_id added');
+  }
+}
+
+// ── ID ──
+
+export function newProjectId() {
+  const ts = Date.now().toString(36);
+  const rand = Math.random().toString(36).slice(2, 6);
+  return `proj_${ts}_${rand}`;
+}
+
+const PROJECT_ID_RE = /^proj_[a-z0-9_]{6,80}$/i;
+
+export function validateProjectId(pid) {
+  if (typeof pid !== 'string' || !PROJECT_ID_RE.test(pid)) {
+    throw Object.assign(new Error(`非法 projectId: ${JSON.stringify(pid)}`), { code: 'INVALID_PROJECT_ID' });
+  }
+}
+
+// ── 行 ↔ 对象 ──
+
+function rowToProject(row) {
+  if (!row) return null;
+  return {
+    id: row.id,
+    name: row.name,
+    skillId: row.skill_id,
+    description: row.description || null,
+    kind: row.kind || 'project',
+    autoNamed: !!row.auto_named,
+    ownerId: row.owner_id || null,
+    activeSessionId: row.active_session_id,
+    createdAt: row.created_at,
+    updatedAt: row.updated_at,
+  };
+}
+
+// ── CRUD ──
+
+/**
+ * 列项目（按 updated_at 倒序）。
+ * @param {object} opts
+ * @param {string|null} opts.owner  **必填**：用户 id 只看自己的；null = 全量
+ *   （admin / 内部调用显式声明）。做成必填是防"漏传就全库泄漏"——kind 的
+ *   默认值语义已经踩过一次这种坑
+ * @param {'project'|'quick'} [opts.kind]
+ */
+export function listProjects({ limit = 100, kind, owner } = {}) {
+  if (owner === undefined) {
+    throw new Error('listProjects: owner 必填（用户 id 或 null=全量）');
+  }
+  const wheres = [];
+  const args = [];
+  if (kind) { wheres.push('kind = ?'); args.push(kind); }
+  if (owner !== null) { wheres.push('owner_id = ?'); args.push(owner); }
+  const whereSql = wheres.length ? `WHERE ${wheres.join(' AND ')}` : '';
+  const rows = db.prepare(
+    `SELECT * FROM projects ${whereSql} ORDER BY updated_at DESC LIMIT ?`,
+  ).all(...args, limit);
+  return rows.map(rowToProject);
+}
+
+/** 读单条 */
+export function getProject(id) {
+  validateProjectId(id);
+  const row = db.prepare('SELECT * FROM projects WHERE id = ?').get(id);
+  return rowToProject(row);
+}
+
+/**
+ * 创建 project。
+ * @param {object} opts
+ * @param {string} opts.name
+ * @param {string} [opts.skillId='deskskill-engine-mini']
+ * @param {string} [opts.description]   人类可读的项目描述（agent 不读，仅 UI 用）
+ * @param {'project'|'quick'} [opts.kind='project']  标准项目 / 闪聊（Home 隐式建）
+ */
+export function createProject({
+  name,
+  skillId = 'deskskill-engine-mini',
+  description = null,
+  kind = 'project',
+  autoNamed = false,
+  ownerId = null,
+}) {
+  if (!name || typeof name !== 'string') throw new Error('createProject: name 必填');
+  if (kind !== 'project' && kind !== 'quick') {
+    throw new Error(`createProject: kind 非法 (${kind})`);
+  }
+  const id = newProjectId();
+  const desc = (typeof description === 'string' && description.trim()) ? description.trim() : null;
+  db.prepare(
+    `INSERT INTO projects (id, name, skill_id, description, kind, auto_named, owner_id) VALUES (?, ?, ?, ?, ?, ?, ?)`,
+  ).run(id, name.trim(), skillId, desc, kind, autoNamed ? 1 : 0, ownerId);
+  return getProject(id);
+}
+
+/** 更新（仅允许 name / skill_id / description / active_session_id / kind / autoNamed） */
+export function updateProject(id, patch) {
+  validateProjectId(id);
+  // 用户显式改名 = 这名字他自己定了，系统不再拿摘要覆盖
+  if ('name' in patch && !('autoNamed' in patch)) patch = { ...patch, autoNamed: false };
+  // kind 只允许枚举值（升级闪聊用 PATCH { kind: 'project' }）
+  if ('kind' in patch && patch.kind !== 'project' && patch.kind !== 'quick') {
+    throw new Error(`updateProject: kind 非法 (${patch.kind})`);
+  }
+  const map = {
+    name: 'name',
+    skillId: 'skill_id',
+    description: 'description',
+    activeSessionId: 'active_session_id',
+    kind: 'kind',
+    autoNamed: 'auto_named',
+  };
+  const sets = [];
+  const args = [];
+  for (const [camelK, sqlK] of Object.entries(map)) {
+    if (camelK in patch) {
+      sets.push(`${sqlK} = ?`);
+      args.push(camelK === 'autoNamed' ? (patch[camelK] ? 1 : 0) : patch[camelK]);
+    }
+  }
+  if (sets.length === 0) return getProject(id);
+  sets.push("updated_at = datetime('now')");
+  args.push(id);
+  db.prepare(`UPDATE projects SET ${sets.join(', ')} WHERE id = ?`).run(...args);
+  return getProject(id);
+}
+
+/** 删除（不级联 — 调用层负责删 workspace 目录 + 关联 runs） */
+export function deleteProject(id) {
+  validateProjectId(id);
+  const row = db.prepare('DELETE FROM projects WHERE id = ? RETURNING *').get(id);
+  return rowToProject(row);
+}
+
+/** 设置 active_session_id（封装常用） */
+export function setActiveSession(projectId, sessionId) {
+  return updateProject(projectId, { activeSessionId: sessionId });
+}
+
+/** 列 project 关联的 runs（用于级联清理） */
+export function listRunsForProject(projectId) {
+  validateProjectId(projectId);
+  return db.prepare('SELECT id FROM runs WHERE project_id = ? ORDER BY created_at DESC').all(projectId);
+}

package/server/projects/ui-config.js

@@ -0,0 +1,54 @@
+/**
+ * 项目级 UI 配置 —— `<工作区根>/ui-config.json`（#25，2026-08-13）。
+ *
+ * 前身叫 session-config.json。扁平化（2026-08-07）之前一个会话一个沙盒，
+ * "会话配置"和"工作区配置"是同一件事；之后工作区全项目共用，这份文件
+ * 实际上早就是**项目级**的了，名字却还挂着 session —— 跟
+ * `.nd/<sid>/session-config.json`（真·会话级，存模型覆盖，session-model.js
+ * 专管，那份**不改名**）同名不同域。两份同名文件各自内部一致，但每个新
+ * 读者都要重新分辨一次"这是哪个 session-config"—— 评审点名的那种暗病。
+ *
+ * 迁移策略：读取认旧名回落（老项目的 tweaks 开关不丢），写入只写新名。
+ * 旧文件留在原地不动 —— 它同时是回滚的退路。
+ *
+ * 字段：
+ *   - tweaks_mode_enabled: bool  是否启用 Tweaks 模式（默认启用）
+ */
+import path from 'path';
+import { promises as fs } from 'fs';
+
+export const UI_CONFIG_NAME = 'ui-config.json';
+const LEGACY_NAME = 'session-config.json';
+
+export const DEFAULT_UI_CONFIG = Object.freeze({
+  tweaks_mode_enabled: true,
+});
+
+/**
+ * 读原始文件（新名 → 旧名回落）。**没有文件返回 null** —— hooks.js 靠
+ * "文件存在与否"决定注不注入提示（没碰过 toggle = 沉默），不能用默认值糊掉。
+ */
+export async function readUiConfigFile(workspaceRoot) {
+  for (const name of [UI_CONFIG_NAME, LEGACY_NAME]) {
+    try {
+      const raw = await fs.readFile(path.join(workspaceRoot, name), 'utf8');
+      const cfg = JSON.parse(raw);
+      if (cfg && typeof cfg === 'object' && !Array.isArray(cfg)) return cfg;
+    } catch { /* 试下一个名字 */ }
+  }
+  return null;
+}
+
+/** 补齐默认字段（API 返回用） */
+export function withUiDefaults(cfg) {
+  return { ...DEFAULT_UI_CONFIG, ...(cfg || {}) };
+}
+
+/** 整份写入。只写新名；旧文件留着当回落/退路，不删不改 */
+export async function writeUiConfig(workspaceRoot, cfg) {
+  await fs.writeFile(
+    path.join(workspaceRoot, UI_CONFIG_NAME),
+    JSON.stringify(cfg, null, 2),
+    'utf8',
+  );
+}

package/server/projects/workspace-templates.js

@@ -0,0 +1,53 @@
+/**
+ * 新工作区的起手模板（2026-08-15 从 workspace.js 拆出 —— 行数棘轮；
+ * 这几坨是纯数据，跟工作区的逻辑没有耦合）。
+ *
+ * ⚠️ DEFAULT_GITIGNORE 是**按行合并**进已有项目的（workspace.js 的
+ * ensureGitignore），所以往里加一行，全站老项目下次开会话都会补上。
+ */
+
+export const DEFAULT_GITIGNORE = `node_modules/
+.DS_Store
+*.log
+.tmp/
+# SDK 转录：一个会话一个 jsonl，一轮几百 KB，不进项目历史
+.claude/projects/
+# 会话私档（压缩摘要 / plan 弧）——属于对话不属于产物
+.nd/
+# generate_image 产物 — 通常很大且能从 spec.json 的 prompt 重生
+assets/generated/
+# 参考素材（web-search 下载的图 + browser_capture 从参照站带回来的）—— 同理：
+# 大、可再取、而且不是"你做出了什么"。⚠️ 2026-08-18 加这条时线上已有 8 个项目
+# 共 205 文件 / 76MB references 全被 track 进了 per-project git（.git 最大 95M）。
+# 这条只管新写入；存量要清得手动 git rm --cached（没做，列进欠账）。
+assets/references/
+# 画布布局 —— 属于"你怎么摆的"，不属于"你做出了什么"。
+# 进历史的坏处是具体的：每拖一次卡就弄脏工作区，而且 revertWorkspace
+# 会连着把画布布局一起回退（卡片弹回旧位置、清掉的死 id 复活）。
+board.json
+# 演出记录（RP）—— 用户的台词是隐私不是产物：不进项目历史，回滚也不该动它。
+# 顺带一层防误食：Grep 走 ripgrep，默认跳过被 gitignore 的文件。
+对话.jsonl
+摘要.json
+`;
+
+export const DEFAULT_SPEC_JSON = JSON.stringify(
+  { version: '0.1', meta: {}, designTokens: {}, outline: [] },
+  null, 2,
+) + '\n';
+
+export const 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.)
+`;