@cloud411716/fancy-webnovel 2.2.0 → 3.0.3

package/plugins/fancy-material/validate.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+/**
+ * Validate an atomic material JSONL file before importing.
+ *
+ * Deployed as read-only to <workspace>/.fancy-tools/fancy-material/validate.js
+ * together with kinds.js. It uses only Node built-ins + the local kind list.
+ *
+ * Usage: node validate.js <file.jsonl>
+ */
+
+import fs from 'node:fs';
+import { MATERIAL_KINDS } from './kinds.js';
+
+const ALLOWED = new Set(['id', 'kind', 'name', 'tags', 'genres', 'note', 'source']);
+const ID_RE = /^[a-z][a-z0-9_]*$/;
+
+function usage() {
+  return `素材库 JSONL 格式校验
+
+用法：
+  node validate.js <file.jsonl>
+
+检查：
+  - 一行一个合法 JSON 对象
+  - 字段只能是 id / kind / name / tags / genres / note / source
+  - source 只能是 builtin / other
+  - builtin 的 kind 必须在允许列表内，id 以 kind 开头
+  - other 的 kind 不受限制
+  - tags 3–8 个，genres 1–3 个
+  - 同文件内 kind + name 不重复
+
+退出码：0=通过，1=有错误，2=用法错误`;
+}
+
+function isPlainObject(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+
+function validate(raw, line) {
+  const errors = [];
+  if (!isPlainObject(raw)) return ['第 ' + line + ' 行：不是 JSON 对象'];
+
+  for (const key of Object.keys(raw)) {
+    if (!ALLOWED.has(key)) errors.push('第 ' + line + ' 行：不允许的字段 ' + key);
+  }
+  if (typeof raw.id !== 'string' || !raw.id.trim()) errors.push('第 ' + line + ' 行：id 必须是非空字符串');
+  if (typeof raw.kind !== 'string' || !raw.kind.trim()) errors.push('第 ' + line + ' 行：kind 必须是非空字符串');
+  if (typeof raw.name !== 'string' || !raw.name.trim()) errors.push('第 ' + line + ' 行：name 必须是非空字符串');
+  if (!Array.isArray(raw.tags) || raw.tags.length < 3 || raw.tags.length > 8) {
+    errors.push('第 ' + line + ' 行：tags 需要 3–8 项');
+  } else {
+    for (const tag of raw.tags) {
+      if (typeof tag !== 'string' || !tag.trim()) errors.push('第 ' + line + ' 行：tags 元素必须是非空字符串');
+    }
+  }
+  if (!Array.isArray(raw.genres) || raw.genres.length < 1 || raw.genres.length > 3) {
+    errors.push('第 ' + line + ' 行：genres 需要 1–3 项');
+  } else {
+    for (const genre of raw.genres) {
+      if (typeof genre !== 'string' || !genre.trim()) errors.push('第 ' + line + ' 行：genres 元素必须是非空字符串');
+    }
+  }
+  if (raw.note !== undefined && typeof raw.note !== 'string') {
+    errors.push('第 ' + line + ' 行：note 必须是字符串');
+  }
+  const source = raw.source === undefined ? 'builtin' : raw.source;
+  if (source !== 'builtin' && source !== 'other') {
+    errors.push('第 ' + line + ' 行：source 只能是 builtin 或 other');
+  }
+  if (typeof raw.id === 'string' && typeof raw.kind === 'string') {
+    if (!ID_RE.test(raw.id) || raw.id.length > 120) {
+      errors.push('第 ' + line + ' 行：id 只能用小写字母、数字、下划线，且不超过 120 字符');
+    }
+    if (source === 'builtin') {
+      if (!MATERIAL_KINDS.includes(raw.kind)) {
+        errors.push('第 ' + line + ' 行：builtin 素材的 kind 不在允许列表：' + raw.kind);
+      } else if (!raw.id.startsWith(raw.kind + '_')) {
+        errors.push('第 ' + line + ' 行：builtin 素材的 id 必须以 kind 开头：' + raw.kind + '_...');
+      }
+    }
+  }
+  return errors;
+}
+
+function main() {
+  const argv = process.argv.slice(2);
+  if (argv.length === 1 && (argv[0] === '--help' || argv[0] === '-h')) {
+    process.stdout.write(usage() + '\n');
+    return;
+  }
+  if (argv.length !== 1) {
+    process.stderr.write(usage() + '\n');
+    process.exitCode = 2;
+    return;
+  }
+
+  let text;
+  try {
+    text = fs.readFileSync(argv[0], 'utf8').replace(/^\uFEFF/, '');
+  } catch (err) {
+    process.stderr.write('❌ 无法读取文件：' + (err && err.message ? err.message : String(err)) + '\n');
+    process.exitCode = 1;
+    return;
+  }
+
+  const errors = [];
+  const ids = new Set();
+  const names = new Set();
+  const kinds = new Set();
+  let count = 0;
+  const lines = text.split(/\r?\n/);
+  for (let i = 0; i < lines.length; i += 1) {
+    const line = lines[i].trim();
+    if (!line) continue;
+    let raw;
+    try {
+      raw = JSON.parse(line);
+    } catch (err) {
+      errors.push('第 ' + (i + 1) + ' 行：JSON 解析失败：' + err.message);
+      continue;
+    }
+    const rowErrors = validate(raw, i + 1);
+    errors.push(...rowErrors);
+    if (rowErrors.length) continue;
+    count += 1;
+    kinds.add(raw.kind);
+    if (ids.has(raw.id)) errors.push('第 ' + (i + 1) + ' 行：id 重复：' + raw.id);
+    ids.add(raw.id);
+    const pair = raw.kind + '\u0000' + raw.name;
+    if (names.has(pair)) errors.push('第 ' + (i + 1) + ' 行：同 kind 同 name 重复：' + raw.kind + ' / ' + raw.name);
+    names.add(pair);
+  }
+
+  if (errors.length) {
+    process.stderr.write('❌ 校验失败：' + errors.length + ' 个错误\n');
+    for (const error of errors.slice(0, 80)) process.stderr.write('- ' + error + '\n');
+    if (errors.length > 80) process.stderr.write('- ……其余 ' + (errors.length - 80) + ' 个省略\n');
+    process.exitCode = 1;
+    return;
+  }
+  if (!count) {
+    process.stderr.write('❌ 校验失败：文件里没有素材记录\n');
+    process.exitCode = 1;
+    return;
+  }
+  process.stdout.write(`✅ 校验通过：${count} 条素材，${kinds.size} 个 kind\n`);
+}
+
+main();

package/plugins/fancy-project/index.js

@@ -0,0 +1,133 @@
+/**
+ * fancy-project — novel-name ↔ UUID lookup and project selection.
+ *
+ * Usage:
+ *   /fancy-project list
+ *   /fancy-project find <关键词>
+ *   /fancy-project id <小说名>
+ *   /fancy-project name <UUID>
+ *   /fancy-project info <小说名|UUID>
+ *   /fancy-project use <小说名|UUID>
+ *   /fancy-project rename <小说名|UUID> <新小说名>
+ */
+
+import { notify } from '#infra';
+import { resolveWorkspace } from '#workspace';
+import {
+  findProjects,
+  getProject,
+  listProjects,
+  renameProject,
+  setProjectActive,
+} from '#projects';
+
+export const inject = ['commands'];
+
+function helpText() {
+  return `📚 项目管理 用法
+
+/fancy-project list                      列出所有项目（小说名 + UUID）
+/fancy-project find <关键词>             按小说名/UUID 查找
+/fancy-project id <小说名>               查小说名对应的 UUID
+/fancy-project name <UUID>               查 UUID 对应的小说名
+/fancy-project info <小说名|UUID>        查看项目库、目录等信息
+/fancy-project use <小说名|UUID>         设为当前项目
+/fancy-project rename <小说名|UUID> <新小说名>
+                                         只改数据库里的书名，UUID 和目录不变
+/fancy-project help                      显示本帮助`;
+}
+
+function formatProject(project) {
+  return [
+    '📖 ' + project.name,
+    'UUID：' + project.project_id,
+    '数据库：' + project.db_name,
+    '用户：' + project.db_user,
+    '目录：' + project.dir,
+    '状态：' + project.status,
+  ].join('\n');
+}
+
+export async function apply(ctx) {
+  ctx.commands.register({
+    name: 'fancy-project',
+    description: '📚 项目管理与小说名↔UUID 查询 ( usage: /fancy-project list|find|id|name|info|use|rename | help )',
+    input: { hint: '.' },
+    handler: async (invocation) => {
+      const session = invocation.agent.session;
+      const raw = String(invocation.rawInput || '').trim();
+      const tokens = raw.split(/\s+/).filter(Boolean);
+      const command = (tokens[0] || 'list').toLowerCase();
+
+      if (command === 'help' || command === '?') return notify(session, 'success', helpText());
+
+      let root;
+      try {
+        root = resolveWorkspace({ cwd: session?.header?.cwd, required: true });
+      } catch (err) {
+        return notify(session, 'error', '❌ ' + (err && err.message ? err.message : String(err)));
+      }
+
+      try {
+        if (command === 'list') {
+          const projects = await listProjects(root);
+          if (!projects.length) return notify(session, 'success', '当前工作区尚未创建任何项目。请运行 /fancy-topic setup 创建项目。');
+          return notify(session, 'success', '📚 项目\n\n' + projects.map((p) => '- ' + p.name + '  `' + p.project_id + '`').join('\n'));
+        }
+
+        if (command === 'find') {
+          const query = tokens.slice(1).join(' ').trim();
+          const projects = await findProjects(root, query);
+          if (!projects.length) return notify(session, 'error', '未找到匹配的项目：' + query + '。可运行 /fancy-project list 查看当前工作区的项目。');
+          return notify(session, 'success', projects.map((p) => '- ' + p.name + '  `' + p.project_id + '`').join('\n'));
+        }
+
+        if (command === 'id') {
+          const name = tokens.slice(1).join(' ').trim();
+          if (!name) return notify(session, 'error', '用法：/fancy-project id <小说名>');
+          const projects = await findProjects(root, name);
+          if (!projects.length) return notify(session, 'error', '未找到匹配的小说：' + name + '。可运行 /fancy-project list 查看当前工作区的项目。');
+          return notify(session, 'success', projects.map((p) => p.name + ' → ' + p.project_id).join('\n'));
+        }
+
+        if (command === 'name') {
+          const id = tokens.slice(1).join(' ').trim();
+          if (!id) return notify(session, 'error', '用法：/fancy-project name <UUID>');
+          const project = await getProject(root, id);
+          if (!project) return notify(session, 'error', '未找到匹配的项目：' + id + '。可运行 /fancy-project list 查看当前工作区的项目。');
+          return notify(session, 'success', project.project_id + ' → ' + project.name);
+        }
+
+        if (command === 'info') {
+          const key = tokens.slice(1).join(' ').trim();
+          if (!key) return notify(session, 'error', '用法：/fancy-project info <小说名|UUID>');
+          const project = await getProject(root, key);
+          if (!project) return notify(session, 'error', '未找到匹配的项目：' + key + '。可运行 /fancy-project list 查看当前工作区的项目。');
+          return notify(session, 'success', formatProject(project));
+        }
+
+        if (command === 'use') {
+          const key = tokens.slice(1).join(' ').trim();
+          if (!key) return notify(session, 'error', '用法：/fancy-project use <小说名|UUID>');
+          const project = await setProjectActive(root, key);
+          return notify(session, 'success', '✅ 当前项目：《' + project.name + '》\n' + project.project_id);
+        }
+
+        if (command === 'rename') {
+          const rest = tokens.slice(1);
+          if (rest.length < 2) return notify(session, 'error', '用法：/fancy-project rename <小说名|UUID> <新小说名>');
+          // The first token is the selector (UUID or one-word name); the rest is
+          // the new title. Names with spaces should be quoted or use the UUID.
+          const selector = rest.shift();
+          const newTitle = rest.join(' ').trim();
+          const project = await renameProject(root, selector, newTitle);
+          return notify(session, 'success', '✅ 项目已重命名：《' + project.name + '》\n项目 UUID 保持不变：' + project.project_id);
+        }
+
+        return notify(session, 'error', '不支持子命令：' + command + '\n\n' + helpText());
+      } catch (err) {
+        return notify(session, 'error', '❌ ' + (err && err.message ? err.message : String(err)));
+      }
+    },
+  });
+}

package/plugins/fancy-scan/existing-block.js

@@ -0,0 +1,100 @@
+/**
+ * existing-block.js —— 采集前的“本次块是否已经存在”检查
+ *
+ * ## 为什么要在扫榜前查
+ *
+ * 之前的重复块检查在**采集之后**：
+ *   采集（可能几十分钟）→ 备份/修复 → 投递提示词 → LLM 执行预检 →
+ *   `append-block.js --preflight` 发现块已存在 → 退出码 2。
+ *
+ * 结果：用户等了半小时，LLM 才开始分析，最后只得到“目标文件里已经有本次
+ * 的标记”。这完全没有必要 —— 平台、榜单、日期在采集前就已经确定，插件
+ * 自己就能算出块 ID，直接读文件判断。
+ *
+ * 所以这里提供**纯函数**：读目标文件 → 解析标记块 → 比较块 ID。
+ * 插件在启动采集脚本之前调用；命中就不跑采集，只发一条通知。
+ *
+ * ## 为什么不用字符串 includes
+ *
+ * `# 起点-全选-20261029-start` 可能出现在正文、代码块或注释里。
+ * `listMarkerBlocks` 只认**独占一行的标题行**，并且 end 必须与 start
+ * 的 key 一致 —— 和写入脚本、topic 侧解析用的是同一套规则。
+ */
+import { existsSync, lstatSync, readFileSync } from 'fs';
+import { listMarkerBlocks } from '#topic-decision';
+
+/** 检查结果状态（封闭枚举） */
+export const EXISTING_BLOCK_STATUS = {
+  /** 文件不存在，或没有本次块 */
+  NONE: 'none',
+  /** 文件里有本次块（闭合或未闭合都算） */
+  FOUND: 'found',
+  /** 文件存在但读不了 / 是符号链接 —— 不能当成“没有” */
+  UNREADABLE: 'unreadable',
+};
+
+/**
+ * 检查目标文件里是否已经有指定块。
+ *
+ * @param {string} topicFile 目标文件绝对路径
+ * @param {string} blockId 块 ID（平台-榜单-日期）
+ * @returns {{
+ *   status: 'none'|'found'|'unreadable',
+ *   error?: string,
+ *   blocks?: Array<{key: string, startTitle: string, endTitle: string|null, closed: boolean}>,
+ * }}
+ */
+export function inspectExistingBlock(topicFile, blockId) {
+  if (!topicFile || typeof topicFile !== 'string') {
+    return { status: EXISTING_BLOCK_STATUS.UNREADABLE, error: '缺少目标文件路径', blocks: [] };
+  }
+  if (!blockId || typeof blockId !== 'string') {
+    return { status: EXISTING_BLOCK_STATUS.UNREADABLE, error: '缺少块 ID', blocks: [] };
+  }
+  if (!existsSync(topicFile)) {
+    return { status: EXISTING_BLOCK_STATUS.NONE, blocks: [] };
+  }
+
+  // 目标文件是符号链接时，读到的可能是项目外内容；后续写入也会被拒绝。
+  // 这里直接判“读不了”，让插件停下来，而不是把外部内容当成“已有块”。
+  try {
+    const st = lstatSync(topicFile);
+    if (st.isSymbolicLink()) {
+      return {
+        status: EXISTING_BLOCK_STATUS.UNREADABLE,
+        error: '目标文件是符号链接，拒绝读取',
+        blocks: [],
+      };
+    }
+    if (!st.isFile()) {
+      return {
+        status: EXISTING_BLOCK_STATUS.UNREADABLE,
+        error: '目标路径不是普通文件',
+        blocks: [],
+      };
+    }
+  } catch (e) {
+    return {
+      status: EXISTING_BLOCK_STATUS.UNREADABLE,
+      error: `目标文件状态检查失败：${e.message}`,
+      blocks: [],
+    };
+  }
+
+  let content = '';
+  try {
+    content = readFileSync(topicFile, 'utf-8');
+  } catch (e) {
+    return {
+      status: EXISTING_BLOCK_STATUS.UNREADABLE,
+      error: `无法读取目标文件：${e.message}`,
+      blocks: [],
+    };
+  }
+
+  const blocks = listMarkerBlocks(content).filter(b => b.key === blockId);
+  if (blocks.length) {
+    return { status: EXISTING_BLOCK_STATUS.FOUND, blocks };
+  }
+  return { status: EXISTING_BLOCK_STATUS.NONE, blocks: [] };
+}