@xiaobuyu/nodesign 0.0.1 → 0.0.3

package/server/lib/notice-store.js

@@ -1,103 +1,103 @@
-/**
- * server/lib/notice-store.js — 站内公告（2026-07-31）
- *
- * 起因很具体：内测有人在用的时候要重启，但没有任何办法告诉他们。用户视角是
- * 「我发的消息突然没了」，运维视角是「等到没人再动手」，两边都在猜。
- *
- * 形态刻意做小：一次只有一条生效的公告（取最新未过期的那条），不做多条队列
- * 也不做分人群投放 —— 内测阶段要说的话就那么几句（要重启了 / 回来了 / 出了什么
- * 事），排队和定向都是给不存在的问题写的代码。
- *
- * 历史保留不删：`active=0` 是软下架，翻记录能看到当时到底跟大家说过什么。
- *
- * 前端的「已读」不在这里 —— 记 localStorage，键带 notice id。服务端记已读要么
- * 加一张按用户的表，要么就是错的（同一个人换浏览器就重看一遍）。公告本来就
- * 允许多看一次，不值得为它建表。
- */
-
-import db from '../engine/runs/store.js';
-
-db.exec(`
-  CREATE TABLE IF NOT EXISTS notices (
-    id TEXT PRIMARY KEY,
-    body TEXT NOT NULL,
-    level TEXT NOT NULL DEFAULT 'info',
-    active INTEGER NOT NULL DEFAULT 1,
-    expires_at TEXT,
-    created_at TEXT NOT NULL DEFAULT (datetime('now'))
-  );
-`);
-
-/** info = 中性告知（蓝）、warn = 要留意（黄）、alert = 影响使用（红） */
-export const LEVELS = ['info', 'warn', 'alert'];
-
-function rowToNotice(row) {
-  if (!row) return null;
-  return {
-    id: row.id,
-    body: row.body,
-    level: row.level,
-    active: !!row.active,
-    expiresAt: row.expires_at || null,
-    createdAt: row.created_at,
-  };
-}
-
-function newNoticeId() {
-  return `nt_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 6)}`;
-}
-
-/**
- * @param {object} p
- * @param {string} p.body            正文（前端整段显示，不解析 markdown）
- * @param {string} [p.level]         info | warn | alert
- * @param {number} [p.expiresInHours] 到点自动消失；不给就一直挂到手动下架
- */
-export function createNotice({ body, level = 'info', expiresInHours = null } = {}) {
-  const text = String(body || '').trim();
-  if (!text) throw new Error('notice body 不能为空');
-  if (!LEVELS.includes(level)) throw new Error(`level 只能是 ${LEVELS.join(' / ')}`);
-  const hours = Number(expiresInHours);
-  const expiresAt = Number.isFinite(hours) && hours > 0
-    ? new Date(Date.now() + hours * 3600_000).toISOString().slice(0, 19).replace('T', ' ')
-    : null;
-  const id = newNoticeId();
-  db.prepare('INSERT INTO notices (id, body, level, expires_at) VALUES (?, ?, ?, ?)')
-    .run(id, text.slice(0, 500), level, expiresAt);
-  return getNotice(id);
-}
-
-export function getNotice(id) {
-  return rowToNotice(db.prepare('SELECT * FROM notices WHERE id = ?').get(id));
-}
-
-/**
- * 当前该给用户看的那一条：最新的、active、未过期。没有就 null。
- *
- * `rowid DESC` 不是装饰：created_at 是 datetime('now')，只到秒。发完一条马上改词
- * 再发一条（正是「写错了重发」的常见操作）会撞同一秒，只按 created_at 排的话
- * 谁在前是不确定的，用户可能看到被你替换掉的那一版。rowid 单调递增，能定序。
- */
-export function getActiveNotice() {
-  return rowToNotice(db.prepare(`
-    SELECT * FROM notices
-    WHERE active = 1 AND (expires_at IS NULL OR expires_at > datetime('now'))
-    ORDER BY created_at DESC, rowid DESC LIMIT 1
-  `).get());
-}
-
-export function listNotices(limit = 50) {
-  return db.prepare('SELECT * FROM notices ORDER BY created_at DESC, rowid DESC LIMIT ?')
-    .all(Math.min(200, limit)).map(rowToNotice);
-}
-
-/** 软下架：留着记录，只是不再投放 */
-export function retireNotice(id) {
-  const r = db.prepare('UPDATE notices SET active = 0 WHERE id = ?').run(id);
-  return r.changes > 0;
-}
-
-/** 全部下架（"说完了，清屏"）@returns 下架条数 */
-export function retireAllNotices() {
-  return db.prepare('UPDATE notices SET active = 0 WHERE active = 1').run().changes;
-}
+/**
+ * server/lib/notice-store.js — 站内公告（2026-07-31）
+ *
+ * 起因很具体：内测有人在用的时候要重启，但没有任何办法告诉他们。用户视角是
+ * 「我发的消息突然没了」，运维视角是「等到没人再动手」，两边都在猜。
+ *
+ * 形态刻意做小：一次只有一条生效的公告（取最新未过期的那条），不做多条队列
+ * 也不做分人群投放 —— 内测阶段要说的话就那么几句（要重启了 / 回来了 / 出了什么
+ * 事），排队和定向都是给不存在的问题写的代码。
+ *
+ * 历史保留不删：`active=0` 是软下架，翻记录能看到当时到底跟大家说过什么。
+ *
+ * 前端的「已读」不在这里 —— 记 localStorage，键带 notice id。服务端记已读要么
+ * 加一张按用户的表，要么就是错的（同一个人换浏览器就重看一遍）。公告本来就
+ * 允许多看一次，不值得为它建表。
+ */
+
+import db from '../engine/runs/store.js';
+
+db.exec(`
+  CREATE TABLE IF NOT EXISTS notices (
+    id TEXT PRIMARY KEY,
+    body TEXT NOT NULL,
+    level TEXT NOT NULL DEFAULT 'info',
+    active INTEGER NOT NULL DEFAULT 1,
+    expires_at TEXT,
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+`);
+
+/** info = 中性告知（蓝）、warn = 要留意（黄）、alert = 影响使用（红） */
+export const LEVELS = ['info', 'warn', 'alert'];
+
+function rowToNotice(row) {
+  if (!row) return null;
+  return {
+    id: row.id,
+    body: row.body,
+    level: row.level,
+    active: !!row.active,
+    expiresAt: row.expires_at || null,
+    createdAt: row.created_at,
+  };
+}
+
+function newNoticeId() {
+  return `nt_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 6)}`;
+}
+
+/**
+ * @param {object} p
+ * @param {string} p.body            正文（前端整段显示，不解析 markdown）
+ * @param {string} [p.level]         info | warn | alert
+ * @param {number} [p.expiresInHours] 到点自动消失；不给就一直挂到手动下架
+ */
+export function createNotice({ body, level = 'info', expiresInHours = null } = {}) {
+  const text = String(body || '').trim();
+  if (!text) throw new Error('notice body 不能为空');
+  if (!LEVELS.includes(level)) throw new Error(`level 只能是 ${LEVELS.join(' / ')}`);
+  const hours = Number(expiresInHours);
+  const expiresAt = Number.isFinite(hours) && hours > 0
+    ? new Date(Date.now() + hours * 3600_000).toISOString().slice(0, 19).replace('T', ' ')
+    : null;
+  const id = newNoticeId();
+  db.prepare('INSERT INTO notices (id, body, level, expires_at) VALUES (?, ?, ?, ?)')
+    .run(id, text.slice(0, 500), level, expiresAt);
+  return getNotice(id);
+}
+
+export function getNotice(id) {
+  return rowToNotice(db.prepare('SELECT * FROM notices WHERE id = ?').get(id));
+}
+
+/**
+ * 当前该给用户看的那一条：最新的、active、未过期。没有就 null。
+ *
+ * `rowid DESC` 不是装饰：created_at 是 datetime('now')，只到秒。发完一条马上改词
+ * 再发一条（正是「写错了重发」的常见操作）会撞同一秒，只按 created_at 排的话
+ * 谁在前是不确定的，用户可能看到被你替换掉的那一版。rowid 单调递增，能定序。
+ */
+export function getActiveNotice() {
+  return rowToNotice(db.prepare(`
+    SELECT * FROM notices
+    WHERE active = 1 AND (expires_at IS NULL OR expires_at > datetime('now'))
+    ORDER BY created_at DESC, rowid DESC LIMIT 1
+  `).get());
+}
+
+export function listNotices(limit = 50) {
+  return db.prepare('SELECT * FROM notices ORDER BY created_at DESC, rowid DESC LIMIT ?')
+    .all(Math.min(200, limit)).map(rowToNotice);
+}
+
+/** 软下架：留着记录，只是不再投放 */
+export function retireNotice(id) {
+  const r = db.prepare('UPDATE notices SET active = 0 WHERE id = ?').run(id);
+  return r.changes > 0;
+}
+
+/** 全部下架（"说完了，清屏"）@returns 下架条数 */
+export function retireAllNotices() {
+  return db.prepare('UPDATE notices SET active = 0 WHERE active = 1').run().changes;
+}

package/server/lib/plugin-install.js

@@ -1,104 +1,104 @@
-/**
- * server/lib/plugin-install.js — plugin 安装 / 卸载核心（2026-07-30 从 api/plugins.js 抽出）
- *
- * 抽出来的原因：crystallize_skill 工具也要往用户的 plugin 根写东西。如果它自己写盘，
- * 就会有第二条不走 validator 的落盘路径——name 合规、保留名、frontmatter 校验、
- * staging 原子 rename 这些全得再实现一遍，且迟早跟上传路径漂移。现在两边同一条。
- *
- * 返回 { status, body } 而不是抛异常：HTTP 路由直接透传，MCP 工具按 status 分支。
- */
-
-import { promises as fs } from 'node:fs';
-import path from 'node:path';
-
-import { validateSkillUpload, extractToStaging } from './plugin-validator.js';
-
-// plugin name 合规检查（同 validator，但卸载路径需独立查）
-const PLUGIN_NAME_RE = /^[a-z0-9][a-z0-9-]{0,39}$/;
-const RESERVED_PLUGIN_NAMES = new Set([
-  'nodesign', 'claude', 'anthropic', 'system', 'builtin', 'default',
-]);
-
-export function isValidPluginName(name) {
-  return typeof name === 'string'
-    && PLUGIN_NAME_RE.test(name)
-    && !RESERVED_PLUGIN_NAMES.has(name);
-}
-
-export async function installPluginToRoot(buffer, targetRoot, { force } = {}) {
-  const validation = await validateSkillUpload(buffer);
-  if (!validation.ok) {
-    return { status: 400, body: { error: 'validation failed', errors: validation.errors } };
-  }
-  const { manifest, skills, warnings, mode } = validation;
-  const targetDir = path.join(targetRoot, manifest.name);
-
-  let existingManifest = null;
-  try {
-    const raw = await fs.readFile(path.join(targetDir, '.claude-plugin', 'plugin.json'), 'utf8');
-    existingManifest = JSON.parse(raw);
-  } catch { /* not installed */ }
-
-  if (existingManifest && !force) {
-    return {
-      status: 409,
-      body: {
-        error: 'plugin already installed',
-        existing: {
-          name: existingManifest.name,
-          version: existingManifest.version || '0.0.0',
-          description: existingManifest.description || '',
-        },
-        incoming: manifest,
-        hint: '加 ?force=true 强制覆盖（旧 plugin 目录会被删除）',
-      },
-    };
-  }
-
-  // staging：装到目标 root 下的 .staging/<tmpId>/，方便 atomic rename 同设备
-  await fs.mkdir(targetRoot, { recursive: true });
-  const stagingRoot = path.join(targetRoot, '.staging');
-  await fs.mkdir(stagingRoot, { recursive: true });
-  const tmpDir = path.join(stagingRoot, `${manifest.name}-${Date.now().toString(36)}`);
-  await fs.mkdir(tmpDir);
-
-  try {
-    await extractToStaging({ buffer, validation, stagingDir: tmpDir });
-    if (existingManifest) {
-      await fs.rm(targetDir, { recursive: true, force: true });
-    }
-    await fs.rename(tmpDir, targetDir);
-  } catch (err) {
-    try { await fs.rm(tmpDir, { recursive: true, force: true }); } catch { /* ignore */ }
-    throw err;
-  }
-
-  return {
-    status: existingManifest ? 200 : 201,
-    body: {
-      installed: { ...manifest, path: targetDir, skills },
-      replaced: existingManifest || null,
-      warnings,
-      uploadMode: mode,  // 'single-md' / 'single-skill-zip' / 'plugin-zip' — UI 用 toast
-    },
-  };
-}
-
-export async function uninstallFromRoot(rootDir, name) {
-  if (!isValidPluginName(name)) {
-    return { status: 400, body: { error: `plugin name \`${name}\` 不合规或是保留名` } };
-  }
-  const targetDir = path.join(rootDir, name);
-  const resolved = path.resolve(targetDir);
-  const resolvedRoot = path.resolve(rootDir);
-  if (!resolved.startsWith(resolvedRoot + path.sep)) {
-    return { status: 400, body: { error: 'invalid target path' } };
-  }
-  try {
-    await fs.access(targetDir);
-  } catch {
-    return { status: 404, body: { error: `plugin \`${name}\` not installed` } };
-  }
-  await fs.rm(targetDir, { recursive: true, force: true });
-  return { status: 200, body: { uninstalled: name } };
-}
+/**
+ * server/lib/plugin-install.js — plugin 安装 / 卸载核心（2026-07-30 从 api/plugins.js 抽出）
+ *
+ * 抽出来的原因：crystallize_skill 工具也要往用户的 plugin 根写东西。如果它自己写盘，
+ * 就会有第二条不走 validator 的落盘路径——name 合规、保留名、frontmatter 校验、
+ * staging 原子 rename 这些全得再实现一遍，且迟早跟上传路径漂移。现在两边同一条。
+ *
+ * 返回 { status, body } 而不是抛异常：HTTP 路由直接透传，MCP 工具按 status 分支。
+ */
+
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+
+import { validateSkillUpload, extractToStaging } from './plugin-validator.js';
+
+// plugin name 合规检查（同 validator，但卸载路径需独立查）
+const PLUGIN_NAME_RE = /^[a-z0-9][a-z0-9-]{0,39}$/;
+const RESERVED_PLUGIN_NAMES = new Set([
+  'nodesign', 'claude', 'anthropic', 'system', 'builtin', 'default',
+]);
+
+export function isValidPluginName(name) {
+  return typeof name === 'string'
+    && PLUGIN_NAME_RE.test(name)
+    && !RESERVED_PLUGIN_NAMES.has(name);
+}
+
+export async function installPluginToRoot(buffer, targetRoot, { force } = {}) {
+  const validation = await validateSkillUpload(buffer);
+  if (!validation.ok) {
+    return { status: 400, body: { error: 'validation failed', errors: validation.errors } };
+  }
+  const { manifest, skills, warnings, mode } = validation;
+  const targetDir = path.join(targetRoot, manifest.name);
+
+  let existingManifest = null;
+  try {
+    const raw = await fs.readFile(path.join(targetDir, '.claude-plugin', 'plugin.json'), 'utf8');
+    existingManifest = JSON.parse(raw);
+  } catch { /* not installed */ }
+
+  if (existingManifest && !force) {
+    return {
+      status: 409,
+      body: {
+        error: 'plugin already installed',
+        existing: {
+          name: existingManifest.name,
+          version: existingManifest.version || '0.0.0',
+          description: existingManifest.description || '',
+        },
+        incoming: manifest,
+        hint: '加 ?force=true 强制覆盖（旧 plugin 目录会被删除）',
+      },
+    };
+  }
+
+  // staging：装到目标 root 下的 .staging/<tmpId>/，方便 atomic rename 同设备
+  await fs.mkdir(targetRoot, { recursive: true });
+  const stagingRoot = path.join(targetRoot, '.staging');
+  await fs.mkdir(stagingRoot, { recursive: true });
+  const tmpDir = path.join(stagingRoot, `${manifest.name}-${Date.now().toString(36)}`);
+  await fs.mkdir(tmpDir);
+
+  try {
+    await extractToStaging({ buffer, validation, stagingDir: tmpDir });
+    if (existingManifest) {
+      await fs.rm(targetDir, { recursive: true, force: true });
+    }
+    await fs.rename(tmpDir, targetDir);
+  } catch (err) {
+    try { await fs.rm(tmpDir, { recursive: true, force: true }); } catch { /* ignore */ }
+    throw err;
+  }
+
+  return {
+    status: existingManifest ? 200 : 201,
+    body: {
+      installed: { ...manifest, path: targetDir, skills },
+      replaced: existingManifest || null,
+      warnings,
+      uploadMode: mode,  // 'single-md' / 'single-skill-zip' / 'plugin-zip' — UI 用 toast
+    },
+  };
+}
+
+export async function uninstallFromRoot(rootDir, name) {
+  if (!isValidPluginName(name)) {
+    return { status: 400, body: { error: `plugin name \`${name}\` 不合规或是保留名` } };
+  }
+  const targetDir = path.join(rootDir, name);
+  const resolved = path.resolve(targetDir);
+  const resolvedRoot = path.resolve(rootDir);
+  if (!resolved.startsWith(resolvedRoot + path.sep)) {
+    return { status: 400, body: { error: 'invalid target path' } };
+  }
+  try {
+    await fs.access(targetDir);
+  } catch {
+    return { status: 404, body: { error: `plugin \`${name}\` not installed` } };
+  }
+  await fs.rm(targetDir, { recursive: true, force: true });
+  return { status: 200, body: { uninstalled: name } };
+}