@xiaobuyu/nodesign 0.0.1 → 0.0.3

package/server/projects/viewpoint-store.js

@@ -0,0 +1,78 @@
+/**
+ * server/projects/viewpoint-store.js —— 用户视点（2026-08-23 黑板）
+ *
+ * 服务端在这之前对「用户此刻看着哪里」一无所知：相机在哪、哪扇窗开着、选中了
+ * 谁，全在前端。agent 于是只能猜「这个」「这里」指什么。前端按节流上报一份
+ * 视点，这里存**每个项目最近一份**（进程内存，不落盘 —— 它是"此刻"，重启即作废）。
+ *
+ * 读者：read_board（小地图画视口框 + 列视口里有什么）、UserPromptSubmit 注入
+ * （只报变化）、read_user_view 工具。
+ *
+ * 只存最近一份而不是按用户存：一个项目同时几个人看是例外不是常态，而 agent
+ * 要的是"跟它说话的那个人在看哪"——发消息的人上一拍上报的视点就是它。
+ * 写入带 userId，以后要拆按用户拆读法就行。
+ */
+
+const TTL_MS = 10 * 60 * 1000;   // 十分钟没上报就当离开了
+const store = new Map();          // pid → viewpoint
+
+function num(v, min, max) {
+  const n = Number(v);
+  return Number.isFinite(n) ? Math.min(max, Math.max(min, n)) : null;
+}
+
+function sanitizeViewpoint(raw, userId) {
+  if (!raw || typeof raw !== 'object') return null;
+  const cam = raw.camera && typeof raw.camera === 'object' ? raw.camera : null;
+  const camera = cam ? {
+    x: num(cam.x, -1e6, 1e6), y: num(cam.y, -1e6, 1e6),
+    w: num(cam.w, 1, 1e5), h: num(cam.h, 1, 1e5),
+  } : null;
+  if (camera && Object.values(camera).some(v => v === null)) return null;
+  const str = (v, n) => (typeof v === 'string' && v.length <= n ? v : null);
+  return {
+    userId: userId || null,
+    camera,
+    zoom: num(raw.zoom, 0.01, 100),
+    layer: str(raw.layer, 300) || '',
+    openWindow: str(raw.openWindow, 300),
+    openPage: str(raw.openPage, 120),
+    selected: Array.isArray(raw.selected) ? raw.selected.filter(s => typeof s === 'string' && s.length <= 300).slice(0, 24) : [],
+    at: Date.now(),
+  };
+}
+
+export function setViewpoint(pid, raw, userId = null) {
+  const v = sanitizeViewpoint(raw, userId);
+  if (!v) return null;
+  store.set(pid, v);
+  return v;
+}
+
+export function getViewpoint(pid) {
+  const v = store.get(pid);
+  if (!v) return null;
+  if (Date.now() - v.at > TTL_MS) { store.delete(pid); return null; }
+  return v;
+}
+
+/** 一行人话（注入/工具共用一份措辞）。rects 可选：给了就报视口里有什么 */
+export function describeViewpoint(v, rects = null) {
+  if (!v) return null;
+  const bits = [];
+  if (v.layer) bits.push(`在文件夹「${v.layer}」里`);
+  if (v.camera) {
+    bits.push(`视口 (${Math.round(v.camera.x)},${Math.round(v.camera.y)}) ${Math.round(v.camera.w)}x${Math.round(v.camera.h)}${v.zoom ? ` 缩放 ${Number(v.zoom).toFixed(2)}` : ''}`);
+    if (rects) {
+      const c = v.camera;
+      const inside = rects.filter(r => !(r.x + r.w < c.x || r.x > c.x + c.w || r.y + r.h < c.y || r.y > c.y + c.h)).map(r => r.id);
+      if (inside.length) bits.push(`视口里有 ${inside.length} 件：${inside.slice(0, 10).join('、')}${inside.length > 10 ? ' 等' : ''}`);
+      else bits.push('视口里是空地');
+    }
+  }
+  if (v.openWindow) bits.push(`开着窗：${v.openWindow}${v.openPage ? `（${v.openPage}）` : ''}`);
+  if (v.selected?.length) bits.push(`选中：${v.selected.slice(0, 8).join('、')}${v.selected.length > 8 ? ' 等' : ''}`);
+  return bits.join('；') || null;
+}
+
+export function _resetViewpoints() { store.clear(); }

package/server/projects/workspace-templates.js

@@ -1,53 +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.)
-`;
+/**
+ * 新工作区的起手模板（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.)
+`;