@xiaobuyu/nodesign 0.0.1 → 0.0.3

package/server/api/instruction.js

@@ -1,75 +1,75 @@
-/**
- * server/api/instruction.js — 项目 Instruction 文件读写
- *
- * Instruction = workspace/.claude/CLAUDE.md。SDK 启用 settingSources:
- * ['project'] 后 agent 进每次 session 自动读到 system prompt。S1 已经
- * 在 ensureProjectWorkspace 写入模板 starter，本阶段加 GET/PUT 让前端
- * "项目背景" tab 直接编辑该文件。
- *
- * GET /api/projects/:pid/instruction
- *   → { content: string, exists: boolean }
- *
- * PUT /api/projects/:pid/instruction
- *   body: { content: string }
- *   → { ok: true }
- *
- * 长度限制 64KB（agent system prompt 不该太长 → token 浪费）。
- * 文件不存在时返回 exists=false，content 用模板内容（fallback 不报错）。
- */
-
-import express from 'express';
-import path from 'path';
-import { promises as fs } from 'fs';
-import { validateProjectId, getProject } from '../projects/store.js';
-import { guardProject } from './_guard.js';
-import { getSharedDir, ensureProjectWorkspace } from '../projects/workspace.js';
-
-const router = express.Router();
-
-const INSTRUCTION_FILE = 'CLAUDE.md';
-const INSTRUCTION_MAX_BYTES = 64 * 1024;
-
-router.get('/:pid/instruction', async (req, res, next) => {
-  try {
-    const project = guardProject(req, res);
-    if (!project) return;
-
-    // ensureProjectWorkspace 幂等补齐（老 project 第一次进 instruction tab 也能读到）
-    await ensureProjectWorkspace(req.params.pid);
-
-    const filePath = path.join(getSharedDir(req.params.pid), '.claude', INSTRUCTION_FILE);
-    try {
-      const content = await fs.readFile(filePath, 'utf8');
-      res.json({ content, exists: true });
-    } catch (err) {
-      if (err.code === 'ENOENT') {
-        // ensureProjectWorkspace 应该已经写了，这里 fallback 防万一
-        res.json({ content: '', exists: false });
-      } else {
-        throw err;
-      }
-    }
-  } catch (err) { next(err); }
-});
-
-router.put('/:pid/instruction', async (req, res, next) => {
-  try {
-    const project = guardProject(req, res);
-    if (!project) return;
-
-    const { content } = req.body || {};
-    if (typeof content !== 'string') {
-      return res.status(400).json({ error: 'content must be string' });
-    }
-    if (Buffer.byteLength(content, 'utf8') > INSTRUCTION_MAX_BYTES) {
-      return res.status(400).json({ error: `instruction too long (max ${INSTRUCTION_MAX_BYTES} bytes)` });
-    }
-
-    await ensureProjectWorkspace(req.params.pid);
-    const filePath = path.join(getSharedDir(req.params.pid), '.claude', INSTRUCTION_FILE);
-    await fs.writeFile(filePath, content, 'utf8');
-    res.json({ ok: true });
-  } catch (err) { next(err); }
-});
-
-export default router;
+/**
+ * server/api/instruction.js — 项目 Instruction 文件读写
+ *
+ * Instruction = workspace/.claude/CLAUDE.md。SDK 启用 settingSources:
+ * ['project'] 后 agent 进每次 session 自动读到 system prompt。S1 已经
+ * 在 ensureProjectWorkspace 写入模板 starter，本阶段加 GET/PUT 让前端
+ * "项目背景" tab 直接编辑该文件。
+ *
+ * GET /api/projects/:pid/instruction
+ *   → { content: string, exists: boolean }
+ *
+ * PUT /api/projects/:pid/instruction
+ *   body: { content: string }
+ *   → { ok: true }
+ *
+ * 长度限制 64KB（agent system prompt 不该太长 → token 浪费）。
+ * 文件不存在时返回 exists=false，content 用模板内容（fallback 不报错）。
+ */
+
+import express from 'express';
+import path from 'path';
+import { promises as fs } from 'fs';
+import { validateProjectId, getProject } from '../projects/store.js';
+import { guardProject } from './_guard.js';
+import { getSharedDir, ensureProjectWorkspace } from '../projects/workspace.js';
+
+const router = express.Router();
+
+const INSTRUCTION_FILE = 'CLAUDE.md';
+const INSTRUCTION_MAX_BYTES = 64 * 1024;
+
+router.get('/:pid/instruction', async (req, res, next) => {
+  try {
+    const project = guardProject(req, res);
+    if (!project) return;
+
+    // ensureProjectWorkspace 幂等补齐（老 project 第一次进 instruction tab 也能读到）
+    await ensureProjectWorkspace(req.params.pid);
+
+    const filePath = path.join(getSharedDir(req.params.pid), '.claude', INSTRUCTION_FILE);
+    try {
+      const content = await fs.readFile(filePath, 'utf8');
+      res.json({ content, exists: true });
+    } catch (err) {
+      if (err.code === 'ENOENT') {
+        // ensureProjectWorkspace 应该已经写了，这里 fallback 防万一
+        res.json({ content: '', exists: false });
+      } else {
+        throw err;
+      }
+    }
+  } catch (err) { next(err); }
+});
+
+router.put('/:pid/instruction', async (req, res, next) => {
+  try {
+    const project = guardProject(req, res);
+    if (!project) return;
+
+    const { content } = req.body || {};
+    if (typeof content !== 'string') {
+      return res.status(400).json({ error: 'content must be string' });
+    }
+    if (Buffer.byteLength(content, 'utf8') > INSTRUCTION_MAX_BYTES) {
+      return res.status(400).json({ error: `instruction too long (max ${INSTRUCTION_MAX_BYTES} bytes)` });
+    }
+
+    await ensureProjectWorkspace(req.params.pid);
+    const filePath = path.join(getSharedDir(req.params.pid), '.claude', INSTRUCTION_FILE);
+    await fs.writeFile(filePath, content, 'utf8');
+    res.json({ ok: true });
+  } catch (err) { next(err); }
+});
+
+export default router;

package/server/api/me.js

@@ -1,116 +1,116 @@
-/**
- * server/api/me.js — 当前用户自视图（2026-07-30 内测）
- *
- *   GET    /api/me/usage              → { usedToday, limit, username, role }
- *   GET    /api/me/models             → { options } 这个账号能选的模型（没有会话时问这条）
- *   GET    /api/me/showcase           → 个人作品橱窗（作品 + 它沉淀出来的 skill）
- *   GET    /api/me/showcase/:id/cover → 该作品封面 webp（复用首页那套截图缓存）
- *   DELETE /api/me/showcase/:id       → 移出橱窗（只删卡片，不动作品本体）
- *
- * 橱窗条目目前由 agent 的 crystallize_skill 工具产生；跨用户的"市场"还没开
- * （别人的 SKILL.md 会整段进你的 agent 上下文，得先有审核范围）。
- */
-
-import express from 'express';
-import { checkQuota, usedTodayByFamily, usedTokensToday, familyLabel } from '../lib/quota.js';
-import { getActiveNotice } from '../lib/notice-store.js';
-import { listEntries, getEntry, removeEntry } from '../lib/showcase-store.js';
-import { getArtifactCover } from '../lib/cover.js';
-import { getSharedDir } from '../projects/workspace.js';
-import { getProject } from '../projects/store.js';
-import { selectableModelsFor, defaultModelFor } from '../engine/agent/model-context.js';
-import { tierOf } from '../auth/tier.js';
-
-const router = express.Router();
-
-/**
- * 这个账号能选的模型清单 —— **没有会话时**（首页快速开始 / 项目 Hub）走这条。
- *
- * 有会话的那条在 `GET /:pid/sessions/:sid/model`，它顺带回当前生效值；这里没有
- * 可读的会话配置，所以只回清单，选中值仍由前端的本地偏好决定。
- *
- * 为什么要有这条：前端原来在没有会话时直接吃 `web/src/lib/models.js` 的
- * `FALLBACK_MODELS` 硬编码常量，于是**带闸门的模型（本地 Qwen）在首页永远不出现** ——
- * 会话里能选、首页选不了，同一颗按钮两种清单。兜底清单从此只在这条接口也挂了时用。
- */
-router.get('/models', (req, res) => {
-  res.json({ options: selectableModelsFor(req.user), default: defaultModelFor(req.user) });
-});
-
-/**
- * 今日用量。**单位是美元**（口径见 lib/quota.js 文件头）。
- *
- * 金额对所有人可见（07-31 定案）。先前藏过一版，顾虑是"$1.36 / $15.00"会被读成
- * 账单；但换模型的冷启动提醒必须带一个数才有意义，而同一个东西在一个地方说
- * 美元、另一个地方说百分比，用户没法把两句话对上。统一成钱，顺带让人知道
- * 这些对话背后有真实成本 —— 这本身就是内测该传达的信息。
- */
-router.get('/usage', (req, res) => {
-  const { usedToday, limit, kind, used } = checkQuota(req.user);
-  const byFamily = usedTodayByFamily(req.user.id);
-  // 分模型只报明细不报限额 —— 07-31 起限额是一个总数，模型之间不再分账
-  const models = Object.entries(byFamily)
-    .filter(([, v]) => v.costUsd > 0 || v.tokens > 0)
-    .sort((a, b) => b[1].costUsd - a[1].costUsd)
-    .map(([family, v]) => ({
-      family,
-      label: familyLabel(family),
-      costUsd: v.costUsd,
-      tokens: v.tokens,
-    }));
-  res.json({
-    unit: 'usd',
-    kind,                                    // 'unlimited' | 'daily' | 'lifetime'（试用号）
-    used,                                    // 与 limit 同口径：daily=今天，lifetime=全史
-    usedToday,
-    limit,                                   // admin 是 null（不限额）
-    pct: limit ? Math.min(100, (used / limit) * 100) : 0,
-    capped: limit !== null,
-    tokensToday: usedTokensToday(req.user.id),
-    models,
-    // 站内公告搭这趟车（2026-07-31）：横幅组件本来就在 60s 轮询这个端点，
-    // 单开一个 /notice 就是第二个轮询循环，为一条一天用不到一次的消息不值得。
-    notice: getActiveNotice(),
-    username: req.user.username,
-    role: req.user.role,
-    tier: tierOf(req.user),                  // admin | pro | basic（auth/tier.js）：顶栏朱砂点 / pro 标签 / basic 解锁提示用
-  });
-});
-
-router.get('/showcase', (req, res) => {
-  const entries = listEntries(req.user.id).map((e) => ({
-    ...e,
-    // 项目可能已经被删：卡片还在，但别给一个点进去 404 的链接
-    projectAlive: e.projectId ? !!getProject(e.projectId) : false,
-  }));
-  res.json({ entries });
-});
-
-router.get('/showcase/:id/cover', async (req, res, next) => {
-  try {
-    const entry = getEntry(req.params.id);
-    if (!entry || entry.userId !== req.user.id) return res.status(404).end();
-    if (!entry.projectId || !entry.artifactRel) return res.status(204).end();
-    if (!getProject(entry.projectId)) return res.status(204).end();
-    let result;
-    try {
-      result = await getArtifactCover(entry.projectId, getSharedDir(entry.projectId), entry.artifactRel);
-    } catch (err) {
-      console.warn('[showcase cover] render failed:', err.message);
-      return res.status(204).end();
-    }
-    if (!result) return res.status(204).end();
-    if (req.headers['if-none-match'] === `"${result.etag}"`) return res.status(304).end();
-    res.set('ETag', `"${result.etag}"`);
-    res.set('Cache-Control', 'private, max-age=60');
-    res.type('image/webp').send(result.buffer);
-  } catch (err) { next(err); }
-});
-
-router.delete('/showcase/:id', (req, res) => {
-  const removed = removeEntry(req.params.id, req.user.id);
-  if (!removed) return res.status(404).json({ error: 'not found' });
-  res.status(204).end();
-});
-
-export default router;
+/**
+ * server/api/me.js — 当前用户自视图（2026-07-30 内测）
+ *
+ *   GET    /api/me/usage              → { usedToday, limit, username, role }
+ *   GET    /api/me/models             → { options } 这个账号能选的模型（没有会话时问这条）
+ *   GET    /api/me/showcase           → 个人作品橱窗（作品 + 它沉淀出来的 skill）
+ *   GET    /api/me/showcase/:id/cover → 该作品封面 webp（复用首页那套截图缓存）
+ *   DELETE /api/me/showcase/:id       → 移出橱窗（只删卡片，不动作品本体）
+ *
+ * 橱窗条目目前由 agent 的 crystallize_skill 工具产生；跨用户的"市场"还没开
+ * （别人的 SKILL.md 会整段进你的 agent 上下文，得先有审核范围）。
+ */
+
+import express from 'express';
+import { checkQuota, usedTodayByFamily, usedTokensToday, familyLabel } from '../lib/quota.js';
+import { getActiveNotice } from '../lib/notice-store.js';
+import { listEntries, getEntry, removeEntry } from '../lib/showcase-store.js';
+import { getArtifactCover } from '../lib/cover.js';
+import { getSharedDir } from '../projects/workspace.js';
+import { getProject } from '../projects/store.js';
+import { selectableModelsFor, defaultModelFor } from '../engine/agent/model-context.js';
+import { tierOf } from '../auth/tier.js';
+
+const router = express.Router();
+
+/**
+ * 这个账号能选的模型清单 —— **没有会话时**（首页快速开始 / 项目 Hub）走这条。
+ *
+ * 有会话的那条在 `GET /:pid/sessions/:sid/model`，它顺带回当前生效值；这里没有
+ * 可读的会话配置，所以只回清单，选中值仍由前端的本地偏好决定。
+ *
+ * 为什么要有这条：前端原来在没有会话时直接吃 `web/src/lib/models.js` 的
+ * `FALLBACK_MODELS` 硬编码常量，于是**带闸门的模型（本地 Qwen）在首页永远不出现** ——
+ * 会话里能选、首页选不了，同一颗按钮两种清单。兜底清单从此只在这条接口也挂了时用。
+ */
+router.get('/models', (req, res) => {
+  res.json({ options: selectableModelsFor(req.user), default: defaultModelFor(req.user) });
+});
+
+/**
+ * 今日用量。**单位是美元**（口径见 lib/quota.js 文件头）。
+ *
+ * 金额对所有人可见（07-31 定案）。先前藏过一版，顾虑是"$1.36 / $15.00"会被读成
+ * 账单；但换模型的冷启动提醒必须带一个数才有意义，而同一个东西在一个地方说
+ * 美元、另一个地方说百分比，用户没法把两句话对上。统一成钱，顺带让人知道
+ * 这些对话背后有真实成本 —— 这本身就是内测该传达的信息。
+ */
+router.get('/usage', (req, res) => {
+  const { usedToday, limit, kind, used } = checkQuota(req.user);
+  const byFamily = usedTodayByFamily(req.user.id);
+  // 分模型只报明细不报限额 —— 07-31 起限额是一个总数，模型之间不再分账
+  const models = Object.entries(byFamily)
+    .filter(([, v]) => v.costUsd > 0 || v.tokens > 0)
+    .sort((a, b) => b[1].costUsd - a[1].costUsd)
+    .map(([family, v]) => ({
+      family,
+      label: familyLabel(family),
+      costUsd: v.costUsd,
+      tokens: v.tokens,
+    }));
+  res.json({
+    unit: 'usd',
+    kind,                                    // 'unlimited' | 'daily' | 'lifetime'（试用号）
+    used,                                    // 与 limit 同口径：daily=今天，lifetime=全史
+    usedToday,
+    limit,                                   // admin 是 null（不限额）
+    pct: limit ? Math.min(100, (used / limit) * 100) : 0,
+    capped: limit !== null,
+    tokensToday: usedTokensToday(req.user.id),
+    models,
+    // 站内公告搭这趟车（2026-07-31）：横幅组件本来就在 60s 轮询这个端点，
+    // 单开一个 /notice 就是第二个轮询循环，为一条一天用不到一次的消息不值得。
+    notice: getActiveNotice(),
+    username: req.user.username,
+    role: req.user.role,
+    tier: tierOf(req.user),                  // admin | pro | basic（auth/tier.js）：顶栏朱砂点 / pro 标签 / basic 解锁提示用
+  });
+});
+
+router.get('/showcase', (req, res) => {
+  const entries = listEntries(req.user.id).map((e) => ({
+    ...e,
+    // 项目可能已经被删：卡片还在，但别给一个点进去 404 的链接
+    projectAlive: e.projectId ? !!getProject(e.projectId) : false,
+  }));
+  res.json({ entries });
+});
+
+router.get('/showcase/:id/cover', async (req, res, next) => {
+  try {
+    const entry = getEntry(req.params.id);
+    if (!entry || entry.userId !== req.user.id) return res.status(404).end();
+    if (!entry.projectId || !entry.artifactRel) return res.status(204).end();
+    if (!getProject(entry.projectId)) return res.status(204).end();
+    let result;
+    try {
+      result = await getArtifactCover(entry.projectId, getSharedDir(entry.projectId), entry.artifactRel);
+    } catch (err) {
+      console.warn('[showcase cover] render failed:', err.message);
+      return res.status(204).end();
+    }
+    if (!result) return res.status(204).end();
+    if (req.headers['if-none-match'] === `"${result.etag}"`) return res.status(304).end();
+    res.set('ETag', `"${result.etag}"`);
+    res.set('Cache-Control', 'private, max-age=60');
+    res.type('image/webp').send(result.buffer);
+  } catch (err) { next(err); }
+});
+
+router.delete('/showcase/:id', (req, res) => {
+  const removed = removeEntry(req.params.id, req.user.id);
+  if (!removed) return res.status(404).json({ error: 'not found' });
+  res.status(204).end();
+});
+
+export default router;