@cloud411716/fancy-webnovel 2.2.0 → 3.0.0

package/plugins/fancy-bootstrap/templates.js

@@ -3,41 +3,58 @@
  */
 
 export const bootstrap = {
-  askPath(question = '📂 请输入项目根路径 ( 或者输入 . 代表当前路径 )') {
+  askPath(question = '📂 请输入工作区目录（或输入 . 表示当前目录）') {
     return { id: 'path', question };
   },
 
-  notify({ type, projectRoot, err, custom }) {
+  notify({ type, projectRoot, err, custom, arg }) {
     switch (type) {
+      case 'help':
+        return `📁 工作区初始化 用法
+
+/fancy-bootstrap             交互式选择工作区目录
+/fancy-bootstrap <工作区目录> 在指定目录初始化工作区
+/fancy-bootstrap help        显示本帮助
+
+作用：初始化工作区目录、SurrealDB、素材库和共享目录，是其他 fancy-webnovel 插件的前置步骤。`;
+
       case 'no_path':
-        return '⚠️ 未提供路径，已取消';
+        return '⚠️ 未提供工作区路径，操作已取消。';
       case 'using_cwd':
         return `📂 使用当前目录：${projectRoot}`;
       case 'invalid_path':
-        return '❌ 路径不合法（不能含空格、.. 或特殊字符）';
+        // 原因由调用方拼进来（路径校验的规则不止一条，说清楚是哪条）
+        return '❌ 路径不合法：' + (arg || '路径中不能包含 .. 或 shell 特殊字符') +
+          (projectRoot ? `\n路径：${projectRoot}` : '');
+      case 'dir_not_found':
+        return `❌ 工作区目录不存在：${projectRoot || ''}\n` +
+          '请先创建该目录，或选择一个已存在的目录。';
+      case 'not_a_directory':
+        return `❌ 工作区路径不是目录：${projectRoot || ''}\n` +
+          '请选择一个目录路径。';
       case 'already_initialized':
-        return '⚠️ 该目录已初始化（.fancy-deployed 已存在）';
+        return '⚠️ 该目录已完成初始化（.fancy-deployed 已存在）。';
       case 'confirm':
-        return `❓ 确认将以下路径作为项目根？\n${projectRoot}`;
+        return `❓ 确认将以下路径作为工作区目录？\n${projectRoot}`;
       case 'cancelled':
-        return '🚫 已取消';
+        return '🚫 操作已取消。';
       case 'no_provider':
-        return '⚠️ 当前环境不支持交互式提问。请在 dsh-tui 中运行此命令，或确保 web UI 已正确加载交互组件。';
+        return '⚠️ 当前运行环境不支持交互式提问。请在 dsh-tui 中运行该命令，或确认 Web UI 已正确加载交互组件。';
       case 'no_project_root':
-        return '❌ 无法确定项目目录：' + (err || '会话未提供 cwd') + '。请在项目目录下运行该命令。';
+        return '❌ 无法确定工作区：' + (err || '会话未提供当前工作目录') + '。请在工作区目录下运行该命令。';
       case 'ask_failed':
-        return '❌ 提问失败：' + (err || '未知错误');
+        return '❌ 交互提问失败：' + (err || '未知错误');
       case 'confirm_invalid':
-        return '❌ 收到无法识别的回复：' + (custom || '') + '。请点「确认创建」，或输入「确认创建」这四个字。';
+        return '❌ 无法识别回复：' + (custom || '') + '。请选择「确认创建」，或输入「确认创建」。';
       case 'success':
-        return `✅ 项目初始化完成！
+        return `✅ 工作区初始化完成。
 下一步：
-1. 启动 llm_wiki ,在使用本插件过程中保持 llm_wiki 运行
-2. 在 llm_wiki 设置中配置 LLM 模型信息,合理设置上下文窗口大小
-3. 在 llm_wiki 设置中关闭"资料文件夹自动监控"
-4. 在 llm_wiki 设置中启用本地 HTTP API 并设置访问令牌
-5. 将 API 地址与访问令牌信息写入 .fancy-deployed 文件中
-6. 运行 /fancy-scan 扫榜`;
+1. 启动 llm-wiki，并在使用本插件期间保持其运行；
+2. 在 llm-wiki 设置中配置 LLM 模型信息，并合理设置上下文窗口大小；
+3. 在 llm-wiki 设置中关闭“资料文件夹自动监控”；
+4. 在 llm-wiki 设置中启用本地 HTTP API 并设置访问令牌；
+5. 将 API 地址与访问令牌写入 .fancy-deployed 文件；
+6. 运行 /fancy-scan 扫榜。`;
       case 'error':
         return '❌ 初始化失败：' + (typeof err === 'function' ? err() : err);
       default:

package/plugins/fancy-db/index.js

@@ -0,0 +1,172 @@
+/**
+ * fancy-db — workspace SurrealDB server and project database management.
+ *
+ * Usage:
+ *   /fancy-db status
+ *   /fancy-db install
+ *   /fancy-db start | stop
+ *   /fancy-db init [all|project <名字|UUID>]
+ *   /fancy-db list
+ *   /fancy-db remove <名字|UUID> [--purge]
+ */
+
+import { askUserQuestion, notify } from '#infra';
+import { readWorkspace, resolveWorkspace } from '#workspace';
+import { deleteProject, listProjects, getProject } from '#projects';
+import { initDatabases, initProjectDatabase, initWorkspaceDatabase } from '#db-init';
+import { installSurreal, serverStatus, startServer, stopServer } from '#surreal-server';
+
+export const inject = ['commands', 'userQuestions'];
+
+function helpText() {
+  return `🗄️ 数据库管理 用法
+
+/fancy-db status                    查看服务与项目库状态
+/fancy-db install                   下载工作区专用 surreal 二进制
+/fancy-db start                     启动 SurrealDB 服务
+/fancy-db stop                      停止 SurrealDB 服务
+/fancy-db init [all]                初始化工作区、注册表、素材库、全部项目库（schema + 校验函数）
+/fancy-db init project <名字|UUID>  只初始化指定项目库
+/fancy-db list                      列出所有项目库
+/fancy-db remove <名字|UUID> [--purge]
+                                    删除项目库（默认把项目目录移到 .fancy/trash）
+/fancy-db help                      显示本帮助`;
+}
+
+function workspaceOf(session) {
+  return resolveWorkspace({ cwd: session?.header?.cwd, required: true });
+}
+
+function formatStatus(status) {
+  const lines = [
+    '🗄️ SurrealDB 状态',
+    '工作区：' + status.workspace,
+    '服务：' + (status.running ? '运行中' : '未运行'),
+    '端点：' + status.endpoint,
+    'PID：' + (status.pid || '—'),
+    '二进制：' + (status.binary || '未安装（运行 /fancy-db install）'),
+    '数据目录：' + status.data_dir,
+  ];
+  try {
+    const workspace = readWorkspace(status.workspace);
+    lines.push('素材库：' + (workspace.surreal?.material_database || 'material_library'));
+  } catch { /* older/lightweight workspace */ }
+  if (status.health?.version) lines.push('版本：' + status.health.version);
+  if (status.running && status.credentials_ok === false) {
+    lines.push('⚠️ 服务正在运行，但当前工作区的 root 凭据无法通过认证；该端口可能被其他工作区的 SurrealDB 占用。');
+    lines.push('   运行 /fancy-db start 可自动切换到空闲端口，或先停止占用该端口的进程。');
+  }
+  if (status.stale_pid) lines.push('⚠️ 检测到失效的 PID 文件：' + status.stale_pid);
+  if (status.health?.error) lines.push('健康检查：' + status.health.error);
+  return lines.join('\n');
+}
+
+function formatProjects(projects) {
+  if (!projects.length) return '当前工作区尚未创建任何项目。请运行 /fancy-topic setup 创建项目。';
+  const lines = ['📚 项目库', ''];
+  for (const p of projects) {
+    lines.push('- ' + p.name + '  `' + p.project_id + '`');
+    lines.push('  库：' + p.db_name + '　用户：' + p.db_user + '　状态：' + p.status);
+    lines.push('  目录：' + p.dir);
+  }
+  return lines.join('\n');
+}
+
+export async function apply(ctx) {
+  ctx.commands.register({
+    name: 'fancy-db',
+    description: '🗄️ 数据库管理 ( usage: /fancy-db status|install|start|stop|init|list|remove | 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] || 'status').toLowerCase();
+
+      if (command === 'help' || command === '?') return notify(session, 'success', helpText());
+
+      let root;
+      try {
+        root = workspaceOf(session);
+      } catch (err) {
+        return notify(session, 'error', '❌ ' + (err && err.message ? err.message : String(err)));
+      }
+
+      try {
+        if (command === 'status') {
+          return notify(session, 'success', formatStatus(await serverStatus(root)));
+        }
+
+        if (command === 'install') {
+          const result = await installSurreal(root);
+          return notify(session, 'success', '✅ surreal 已就绪：' + result.path + '\n' + result.version);
+        }
+
+        if (command === 'start') {
+          const result = await startServer(root);
+          return notify(session, 'success', (result.started ? '✅ 已启动' : 'ℹ️ 已在运行') + '\n' + formatStatus(await serverStatus(root)));
+        }
+
+        if (command === 'stop') {
+          const result = await stopServer(root);
+          return notify(session, 'success', result.stopped ? '✅ 已停止 SurrealDB。' : 'ℹ️ SurrealDB 当前未运行，无需停止。');
+        }
+
+        if (command === 'init') {
+          const target = tokens[1] && tokens[1].toLowerCase();
+          if (target === 'project') {
+            const name = tokens.slice(2).join(' ').trim();
+            if (!name) return notify(session, 'error', '用法：/fancy-db init project <名字|UUID>');
+            const result = await initProjectDatabase(root, name);
+            return notify(session, 'success', '✅ 已初始化项目库：' + result.project.name + '\n库：' + result.project.database + '\nschema ' + result.schema_version + ' / validation ' + result.validation_version);
+          }
+          const result = await initDatabases(root, { all: true });
+          const failed = result.projects.filter((p) => !p.ok);
+          return notify(session, failed.length ? 'error' : 'success', [
+            '✅ 工作区数据库初始化完成',
+            '服务：' + (result.server.running ? '运行中' : '未运行'),
+            'schema：' + result.schema_version + '　validation：' + result.validation_version,
+            '素材库：' + (result.material?.database || 'material_library') + '（schema ' + (result.material?.schema_version || 6) + '）',
+            '项目库：' + result.projects.length + ' 个' + (failed.length ? '，失败 ' + failed.length + ' 个' : ''),
+            ...failed.map((f) => '❌ ' + f.project.name + '：' + f.error),
+          ].join('\n'));
+        }
+
+        if (command === 'list') {
+          return notify(session, 'success', formatProjects(await listProjects(root)));
+        }
+
+        if (command === 'remove') {
+          const target = tokens.slice(1).filter((t) => !t.startsWith('--')).join(' ').trim();
+          if (!target) return notify(session, 'error', '用法：/fancy-db remove <名字|UUID> [--purge]');
+          const project = await getProject(root, target);
+          if (!project) return notify(session, 'error', '未找到匹配的项目：' + target + '。可运行 /fancy-project list 查看当前工作区的项目。');
+          const asked = await askUserQuestion(ctx, invocation, [{
+            id: 'confirm_remove',
+            header: '删除项目库',
+            question: '确定删除《' + project.name + '》的数据库吗？\n项目：' + project.project_id + '\n库：' + project.db_name,
+            options: [
+              { label: '取消', description: '不删除任何东西' },
+              { label: '删除数据库', description: '删除数据库，项目目录移到 .fancy/trash' },
+              { label: '删除数据库并清除目录', description: '不可恢复：同时删除项目目录' },
+            ],
+          }]);
+          if (!asked.ok) return notify(session, 'error', asked.failure.message);
+          const selected = asked.answer?.answers?.[0]?.selected?.[0];
+          if (selected !== '删除数据库' && selected !== '删除数据库并清除目录') {
+            return notify(session, 'success', '操作已取消。');
+          }
+          const result = await deleteProject(root, project.project_id, {
+            confirm: true,
+            purge: selected === '删除数据库并清除目录',
+          });
+          return notify(session, 'success', '✅ 已删除《' + result.project.name + '》的数据库' + (result.purged ? '和项目目录' : '，项目目录已移入 .fancy/trash'));
+        }
+
+        return notify(session, 'error', '不支持子命令：' + command + '\n\n' + helpText());
+      } catch (err) {
+        return notify(session, 'error', '❌ ' + (err && err.message ? err.message : String(err)));
+      }
+    },
+  });
+}

package/plugins/fancy-douyin/deploy.js

@@ -0,0 +1,134 @@
+/**
+ * Deploy the Douyin browser scripts into the workspace.
+ *
+ * The plugin package lives under node_modules and its scripts must be runnable
+ * with a stable workspace-local path. Scripts are CommonJS and resolve
+ * playwright-core through NODE_PATH, which the plugin passes when spawning.
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { createRequire } from 'module';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const HERE = __dirname;
+const requireHere = createRequire(import.meta.url);
+
+export const DOUYIN_TOOL_DIR = path.join('.fancy-tools', 'fancy-douyin');
+export const TOOL_FILES = ['lib.cjs', 'start-chrome.cjs', 'scan-account.cjs', 'crawl-note.cjs'];
+
+export function playwrightNodePath() {
+  try {
+    const entry = requireHere.resolve('playwright-core');
+    return path.dirname(path.dirname(entry));
+  } catch {
+    return '';
+  }
+}
+
+function ensureRealDir(dir, label, problems) {
+  try {
+    const stat = fs.lstatSync(dir);
+    if (stat.isSymbolicLink()) {
+      problems.push(label + ' 不能是符号链接：' + dir);
+      return false;
+    }
+    if (!stat.isDirectory()) {
+      problems.push(label + ' 不是目录：' + dir);
+      return false;
+    }
+    return true;
+  } catch (err) {
+    if (!err || err.code !== 'ENOENT') {
+      problems.push(label + ' 无法检查：' + (err && err.message ? err.message : String(err)));
+      return false;
+    }
+  }
+  try {
+    fs.mkdirSync(dir);
+    return true;
+  } catch (err) {
+    problems.push('创建目录失败 ' + dir + '：' + (err && err.message ? err.message : String(err)));
+    return false;
+  }
+}
+
+function writeToolFile(file, content, problems) {
+  try {
+    try {
+      const stat = fs.lstatSync(file);
+      if (stat.isSymbolicLink() || !stat.isFile()) {
+        problems.push('拒绝覆盖非普通文件：' + file);
+        return false;
+      }
+    } catch (err) {
+      if (!err || err.code !== 'ENOENT') throw err;
+    }
+    const tmp = file + '.' + process.pid + '.' + Date.now() + '.tmp';
+    fs.writeFileSync(tmp, content, { encoding: 'utf8', mode: 0o644 });
+    fs.renameSync(tmp, file);
+    return true;
+  } catch (err) {
+    problems.push('写入失败 ' + file + '：' + (err && err.message ? err.message : String(err)));
+    return false;
+  }
+}
+
+/**
+ * @param {string} root workspace directory
+ * @returns {{ok: boolean, dir: string, nodePath: string, scripts: {start: string, scan: string, note: string}, problems: string[]}}
+ */
+export function deployDouyinTools(root) {
+  const problems = [];
+  const workspace = path.resolve(root);
+  const fancyTools = path.join(workspace, '.fancy-tools');
+  const target = path.join(workspace, DOUYIN_TOOL_DIR);
+
+  if (!ensureRealDir(fancyTools, '.fancy-tools', problems)
+    || !ensureRealDir(target, '.fancy-tools/fancy-douyin', problems)) {
+    return { ok: false, dir: target, nodePath: '', scripts: { start: '', scan: '', note: '' }, problems };
+  }
+
+  for (const name of TOOL_FILES) {
+    let source;
+    try {
+      source = fs.readFileSync(path.join(HERE, 'scripts', name), 'utf8');
+    } catch (err) {
+      problems.push('读取脚本失败 ' + name + '：' + (err && err.message ? err.message : String(err)));
+      continue;
+    }
+    writeToolFile(path.join(target, name), source, problems);
+  }
+
+  writeToolFile(path.join(target, 'package.json'), JSON.stringify({
+    name: 'fancy-tools-fancy-douyin',
+    private: true,
+    type: 'commonjs',
+  }, null, 2) + '\n', problems);
+
+  const nodePath = playwrightNodePath();
+  if (!nodePath) {
+    problems.push('找不到 playwright-core。请确认 fancy-webnovel 依赖完整。');
+  }
+
+  writeToolFile(path.join(target, 'README.txt'), [
+    '本目录由 fancy-douyin 自动部署。',
+    '浏览器脚本：start-chrome.cjs / scan-account.cjs / crawl-note.cjs',
+    '登录态与采集记录在 <工作区>/.fancy/douyin/ 下。',
+    '不要手工修改本目录脚本；重新运行 /fancy-douyin 会刷新。',
+    '',
+  ].join('\n'), problems);
+
+  return {
+    ok: problems.length === 0,
+    dir: target,
+    nodePath,
+    scripts: {
+      start: path.join(target, 'start-chrome.cjs'),
+      scan: path.join(target, 'scan-account.cjs'),
+      note: path.join(target, 'crawl-note.cjs'),
+    },
+    problems,
+  };
+}