@cloud411716/fancy-webnovel 1.0.46 → 2.2.0

package/plugins/fancy-bootstrap/index.js

@@ -0,0 +1,168 @@
+/**
+ * fancy-bootstrap plugin entry
+ */
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { askUserQuestion, notify, spawnScript } from '#infra';
+import { readDeployedState, deployedStateProblemText } from '#deployed-state';
+import { bootstrap } from './templates.js';
+
+export const inject = ['commands', 'userQuestions'];
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const SCRIPTS_DIR = join(__dirname, 'scripts');
+
+// ---------------------------------------------------------------------------
+// 路径工具
+// ---------------------------------------------------------------------------
+
+// 敏感系统路径前缀（黑名单）：防止用户输入这些路径作为项目根
+const SENSITIVE_PATH_PREFIXES = [
+  '/etc', '/proc', '/sys', '/dev',
+  '/root/.ssh', '/root/.gnupg', '/root/.aws', '/root/.config',
+  '/var/log', '/var/lib', '/boot',
+  'C:\\Windows', 'C:\\Program Files',
+];
+
+function isValidPath(p) {
+  if (!p || typeof p !== 'string') return false;
+  if (p.includes('..')) return false;
+  if (/[<>:"'|?*[\x00-\x1f]/.test(p)) return false;
+  if (/\s/.test(p)) return false;
+  // 拒绝以敏感路径前缀开头的绝对路径
+  const normalized = p.replace(/\\/g, '/');
+  for (const prefix of SENSITIVE_PATH_PREFIXES) {
+    if (normalized === prefix || normalized.startsWith(prefix + '/')) return false;
+  }
+  return true;
+}
+
+// ---------------------------------------------------------------------------
+// 注册
+// ---------------------------------------------------------------------------
+
+export async function apply(ctx) {
+  ctx.commands.register({
+    name: 'fancy-bootstrap',
+    description: '📁 初始化项目根 ( usage: /fancy-bootstrap [项目根] )',
+    input: {
+      hint: '[项目根]',
+    },
+    handler: async (invocation) => {
+      const session = invocation.agent.session;
+      const rawInput = invocation.rawInput ? invocation.rawInput.trim() : '';
+      const { signal } = invocation;
+
+      let projectRoot = rawInput;
+
+      // 无参数 → 弹窗
+      if (!projectRoot) {
+        // Check if signal is already aborted before asking
+        if (signal?.aborted) {
+          return notify(session, 'error', bootstrap.notify({ type: 'cancelled' }));
+        }
+        // askUserQuestion 统一兜住 DSH 的错误码，永不抛异常
+        const asked = await askUserQuestion(ctx, invocation, [bootstrap.askPath()]);
+        if (!asked.ok) {
+          return notify(session, 'error', bootstrap.notify({
+            type: asked.failure.type,
+            err: asked.failure.message
+          }));
+        }
+        const result = asked.answer;
+        // Handle case where user skipped or X'd the question
+        if (!result?.answers?.[0]) {
+          return notify(session, 'error', bootstrap.notify({ type: 'cancelled' }));
+        }
+        projectRoot = result.answers[0]?.custom?.trim() || '';
+      }
+
+      if (!projectRoot) {
+        return notify(session, 'error', bootstrap.notify({ type: 'no_path' }));
+      }
+
+      if (projectRoot === '.') {
+        // 不能回退到 process.cwd()：那是宿主进程的工作目录，不是用户项目目录。
+        // 宿主若恰好在某个含 .fancy-deployed 的目录里启动，会对错误的项目初始化。
+        projectRoot = session.header?.cwd ?? null;
+        if (!projectRoot) {
+          return notify(session, 'error', bootstrap.notify({
+            type: 'no_project_root',
+            err: '无法确定项目目录（会话未提供 cwd）。请在项目目录下运行该命令。'
+          }));
+        }
+        // Show notification but do NOT return - continue to confirmation step
+        // （确认框里会带上完整路径，用户能看到）
+        notify(session, 'success', bootstrap.notify({ type: 'using_cwd', projectRoot }));
+      }
+
+      if (!isValidPath(projectRoot)) {
+        return notify(session, 'error', bootstrap.notify({ type: 'invalid_path' }));
+      }
+
+      // 文件**存在**不等于"已初始化"。
+      // 之前只看存在性，于是文件损坏时也报"该目录已初始化"并拒绝执行 ——
+      // 而别处（fancy-topic / fancy-scan）会告诉你"重新运行 /fancy-bootstrap 初始化"，
+      // 两条指引互相打架，用户被卡在死循环里出不来。
+      const existingState = readDeployedState(projectRoot);
+      if (existingState.status === 'ok') {
+        return notify(session, 'error', bootstrap.notify({ type: 'already_initialized' }));
+      }
+      if (existingState.status !== 'missing') {
+        // 存在但坏了 / phase 不认识 → 明确说清并给出修复办法，
+        // 而不是笼统地说"已初始化"（那会让用户以为一切正常）。
+        return notify(session, 'error',
+          deployedStateProblemText(existingState, { projectRoot })
+          || bootstrap.notify({ type: 'already_initialized' }));
+      }
+
+      // Check if signal is already aborted before asking confirm
+      if (signal?.aborted) {
+        return notify(session, 'error', bootstrap.notify({ type: 'cancelled' }));
+      }
+      // 注意：不要传 hideCustomInput —— DSH 的 AskUserQuestionItem 没有这个字段
+      // （合法字段只有 id / question / detail / header / options / multiSelect / intent），
+      // 传了会被运行时静默忽略，"只让点选项"的意图根本不生效。
+      const asked = await askUserQuestion(ctx, invocation, [{
+        id: 'confirm',
+        question: bootstrap.notify({ type: 'confirm', projectRoot }),
+        options: bootstrap.confirmOptions(),
+      }]);
+      if (!asked.ok) {
+        return notify(session, 'error', bootstrap.notify({
+          type: asked.failure.type,
+          err: asked.failure.message
+        }));
+      }
+      const confirm = asked.answer;
+      // Handle case where user skipped or X'd the question
+      if (!confirm?.answers?.[0]) {
+        return notify(session, 'error', bootstrap.notify({ type: 'cancelled' }));
+      }
+      const ans = confirm.answers[0];
+      const chosen = ans?.selected?.[0] ?? ans?.custom;
+      if (chosen !== '确认创建') {
+        // 区分"点了取消"与"自己输入了别的东西"：
+        // 后者此前会被静默当成取消，用户不知道自己输入的内容被丢掉了。
+        if (ans?.custom && !ans?.selected?.length) {
+          return notify(session, 'error', bootstrap.notify({
+            type: 'confirm_invalid',
+            custom: ans.custom
+          }));
+        }
+        return notify(session, 'error', bootstrap.notify({ type: 'cancelled' }));
+      }
+
+      const initResult = await spawnScript('node', [join(SCRIPTS_DIR, 'init.js'), projectRoot], { timeout: 30000 });
+
+      if (initResult.ok) {
+        return notify(session, 'success', bootstrap.notify({ type: 'success' }));
+      } else {
+        const err = (typeof initResult.error === 'object' && initResult.error !== null)
+          ? (initResult.error.message || JSON.stringify(initResult.error))
+          : String(initResult.error || '未知错误');
+        return notify(session, 'error', bootstrap.notify({ type: 'error', err }));
+      }
+    }
+  });
+}

package/plugins/fancy-bootstrap/scripts/init.js

@@ -0,0 +1,143 @@
+/**
+ * fancy-bootstrap init — 项目初始化（精简版）
+ *
+ * 只做一件事：在项目根写一个 `.fancy-deployed` 标记文件。
+ * 该文件只含 3 个字段：
+ *   - deployed_at:     初始化时间戳
+ *   - project_root_abs: 项目根绝对路径
+ *   - phase:           'initialized'（后续阶段由 fancy-scan / fancy-topic 推进）
+ *
+ * 任何子目录、子文件都由对应阶段的插件自己创建：
+ *   - fancy-scan  → 扫榜结果/
+ *   - fancy-topic → _story_state.json, _author_intent.md 等
+ *
+ * 阶段演进（写在 .fancy-deployed 的 phase 字段）：
+ *   bootstrap  → 'initialized'
+ *   scan 完成  → 'scanned'
+ *   topic 完成 → 'topic_done'
+ *
+ * 注：fancy-topic 不要求 phase='analyzed'（这个状态不存在）。fancy-topic
+ *     启动时检查 topic_decision_<date>.md 文件是否存在；不存在则报错让用户
+ *     先跑 fancy-scan 并等待 LLM 完成分析写入该文件。
+ */
+import { writeFileSync, existsSync, mkdirSync, realpathSync, statSync, unlinkSync } from 'fs';
+import { expandHome, resolvePath, joinPath } from './path-utils.js';
+import { EC, errorResponse } from '#error-codes';
+
+function nowIso() {
+  return new Date().toISOString().replace('.000Z', 'Z');
+}
+
+/** 取真实路径（解开符号链接）；取不到就退回原路径 */
+function realPathOf(p) {
+  try {
+    return realpathSync(p);
+  } catch {
+    return p;
+  }
+}
+
+/** 是不是目录 */
+function isDirectory(p) {
+  try {
+    return statSync(p).isDirectory();
+  } catch {
+    return false;
+  }
+}
+
+function fail(ec, extra = {}) {
+  // 兼容旧调用方式：fail(EC.XXX) 或 fail(EC.XXX, { exitCode, message })
+  const exitCode = extra.exitCode ?? ec.code;
+  console.log(JSON.stringify(errorResponse(ec, extra)));
+  process.exit(exitCode);
+}
+
+function main() {
+  const projectRootRaw = process.argv[2] ?? '';
+
+  if (!projectRootRaw || projectRootRaw.includes('..') || /[<>:"'|?*]/.test(projectRootRaw) || /[\x00-\x1f]/.test(projectRootRaw)) {
+    fail(EC.EC001_INVALID_PATH);
+  }
+
+  // 二次校验：拒绝敏感系统路径
+  const SENSITIVE_PREFIXES = ['/etc', '/proc', '/sys', '/dev', '/root/.ssh', '/root/.gnupg', '/var/log', '/var/lib', '/boot'];
+  const normalized = projectRootRaw.replace(/\\/g, '/');
+  for (const prefix of SENSITIVE_PREFIXES) {
+    if (normalized === prefix || normalized.startsWith(prefix + '/')) {
+      fail(EC.EC019_SENSITIVE_PATH);
+    }
+  }
+
+  const projectRoot = resolvePath(expandHome(projectRootRaw));
+
+  // 2026-10-27：路径校验补三处（审计 P2-10）
+  //  1. `~` 展开后、符号链接都可能绕开上面的字符串检查
+  //     （比如 /tmp/link -> /etc，字符串里没有 .. 也没有 /etc）
+  //     → 用 realpath 拿到真实路径再校验一遍敏感前缀；
+  //  2. existsSync 不区分文件/目录，传一个文件进来时
+  //     writeFileSync(join(file, '.fancy-deployed')) 抛 ENOTDIR，报错不友好；
+  //  3. 目录不存在要单独报错。
+  const projectRootReal = realPathOf(projectRoot);
+  const deployed = joinPath(projectRootReal, '.fancy-deployed');
+
+  if (existsSync(deployed)) {
+    fail(EC.EC002_ALREADY_INITIALIZED);
+  }
+  if (!existsSync(projectRootReal)) {
+    fail(EC.EC018_DIR_NOT_FOUND, { message: `目录不存在: ${projectRoot}` });
+  }
+  if (!isDirectory(projectRootReal)) {
+    fail(EC.EC018_DIR_NOT_FOUND, { message: `不是一个目录: ${projectRoot}` });
+  }
+  // 真实路径再查一遍敏感前缀（符号链接已经解开）
+  const realNormalized = projectRootReal.replace(/\\/g, '/');
+  for (const prefix of SENSITIVE_PREFIXES) {
+    if (realNormalized === prefix || realNormalized.startsWith(prefix + '/')) {
+      fail(EC.EC019_SENSITIVE_PATH);
+    }
+  }
+
+  const now = nowIso();
+
+  try {
+    // 先建目录，再写标记文件。
+    // 旧实现顺序反了：先写 .fancy-deployed 再 mkdir，
+    // mkdir 失败时标记文件已经在了 —— 下次运行会报"已初始化"，
+    // 而项目其实是个半初始化状态（这次失败、那次也失败）。
+    // 现在标记文件是"最后一步"，失败就不会留下误导性的标记。
+    //
+    // 预创建工具目录，方便 fancy-analyze 等插件直接使用
+    mkdirSync(joinPath(projectRootReal, '参考资料'), { recursive: true });
+    mkdirSync(joinPath(projectRootReal, '对标'), { recursive: true });
+
+    // 写 .fancy-deployed 标记文件
+    writeFileSync(deployed, JSON.stringify({
+      deployed_at: now,
+      project_root_abs: projectRootReal,
+      phase: 'initialized',
+      llm_wiki_url: 'http://localhost:19828/api/v1',
+      llm_wiki_token: '',
+      reference_id: '',
+      novel_id: '',
+      provider: 'custom',
+    }, null, 2), 'utf-8');
+  } catch (e) {
+    const errMsg = e instanceof Error ? e.message : String(e);
+    // 失败时把标记文件删掉，别留半初始化状态
+    try {
+      if (existsSync(deployed)) unlinkSync(deployed);
+    } catch {
+      // 删不掉就算了，至少别把错误吞了
+    }
+    fail(EC.EC017_INIT_FAILED, { message: `初始化失败: ${errMsg}` });
+  }
+
+  console.log(JSON.stringify({
+    ok: true, operation: 'init', project_root: projectRoot, phase: 'initialized',
+    files_created: ['.fancy-deployed', '参考资料/', '对标/'],
+    note: '参考资料/ 用于存放爆款小说原文，对标/ 用于存拆解结果',
+  }));
+}
+
+main();

package/plugins/fancy-bootstrap/scripts/path-utils.js

@@ -0,0 +1,21 @@
+/**
+ * path-utils.js — init.js 专用路径工具
+ */
+import { existsSync } from 'fs';
+import { homedir } from 'os';
+import { resolve, join } from 'path';
+
+export function expandHome(p) {
+  if (p === '~' || p.startsWith('~/')) {
+    return join(homedir(), p.slice(1));
+  }
+  return p;
+}
+
+export function resolvePath(p) {
+  return resolve(p);
+}
+
+export function joinPath(base, ...parts) {
+  return join(base, ...parts);
+}

package/plugins/fancy-bootstrap/templates.js

@@ -0,0 +1,54 @@
+/**
+ * bootstrap 模板 — 仅 fancy-bootstrap 使用
+ */
+
+export const bootstrap = {
+  askPath(question = '📂 请输入项目根路径 ( 或者输入 . 代表当前路径 )') {
+    return { id: 'path', question };
+  },
+
+  notify({ type, projectRoot, err, custom }) {
+    switch (type) {
+      case 'no_path':
+        return '⚠️ 未提供路径，已取消';
+      case 'using_cwd':
+        return `📂 使用当前目录：${projectRoot}`;
+      case 'invalid_path':
+        return '❌ 路径不合法（不能含空格、.. 或特殊字符）';
+      case 'already_initialized':
+        return '⚠️ 该目录已初始化（.fancy-deployed 已存在）';
+      case 'confirm':
+        return `❓ 确认将以下路径作为项目根？\n${projectRoot}`;
+      case 'cancelled':
+        return '🚫 已取消';
+      case 'no_provider':
+        return '⚠️ 当前环境不支持交互式提问。请在 dsh-tui 中运行此命令，或确保 web UI 已正确加载交互组件。';
+      case 'no_project_root':
+        return '❌ 无法确定项目目录：' + (err || '会话未提供 cwd') + '。请在项目目录下运行该命令。';
+      case 'ask_failed':
+        return '❌ 提问失败：' + (err || '未知错误');
+      case 'confirm_invalid':
+        return '❌ 收到无法识别的回复：' + (custom || '') + '。请点「确认创建」，或输入「确认创建」这四个字。';
+      case 'success':
+        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 扫榜`;
+      case 'error':
+        return '❌ 初始化失败：' + (typeof err === 'function' ? err() : err);
+      default:
+        return String(type);
+    }
+  },
+
+  confirmOptions() {
+    return [
+      { label: '确认创建', description: '开始在此目录初始化项目' },
+      { label: '取消',     description: '取消本次操作' },
+    ];
+  },
+};