@cloud411716/fancy-webnovel 1.0.14 → 1.0.16

package/commands/scan/index.js

@@ -7,7 +7,7 @@
 
 import { existsSync } from 'fs';
 import { join } from 'path';
-import { notify, llmFollowup } from '../../infra.js';
+import { notify, llmFollowup, StatusLine } from '../../infra.js';
 import { runScans } from './scraper.js';
 import * as qidian from './platforms/qidian.js';
 import * as fanqie from './platforms/fanqie.js';
@@ -196,18 +196,19 @@ export function apply(ctx) {
       // ---------- in-process scraping (no subprocess) ----------
 
       // Register scan-progress listeners before scraping starts, clean up after.
-      // Each fired event sends an ASCII spinner followup so the user sees live
-      // progress instead of a blank screen while the scraper runs.
+      // StatusLine.update() uses session surfaceOp replace so the status stays
+      // at the same log position and doesn't accumulate or scroll away.
       const disposers = [];
+      const statusLine = new StatusLine(session);
       let currentRankLabel = '';
 
       disposers.push(ctx.events.on('fancy/scan:start', (_ctx, platform, _channel, _type, label) => {
         currentRankLabel = label;
-        notify(session, `[${SPINNER[_spinnerIdx++ % 4]}] 正在采集：${platformLabel(platform)} ${label} …`);
+        statusLine.update(`[${SPINNER[_spinnerIdx++ % 4]}] 正在采集：${platformLabel(platform)} ${label} …`);
       }));
 
       disposers.push(ctx.events.on('fancy/scan:rank-done', (_ctx, _platform, _channel, _type, ok, written) => {
-        notify(session, `[${SPINNER[_spinnerIdx++ % 4]}] ${currentRankLabel} ${ok ? `✓ 写入 ${written} 条` : '✗ 失败'}`);
+        statusLine.update(`[${SPINNER[_spinnerIdx++ % 4]}] ${currentRankLabel} ${ok ? `✓ 写入 ${written} 条` : '✗ 失败'}`);
       }));
 
       const { totalBooks, totalFiles, failedRanks, lastReceipt } = await runScans(
@@ -217,8 +218,9 @@ export function apply(ctx) {
         signal,
       );
 
-      // Clean up progress listeners; runScans is done.
+      // Clean up progress listeners and clear the status bar.
       for (const d of disposers) d();
+      statusLine.clear();
 
       // ---------- output results ----------
       if (lastReceipt && totalFiles > 0) {

package/infra.js

@@ -2,10 +2,11 @@
  * infra.js — DSH Plugin Core Infrastructure
  *
  * Provides:
- *   notify(session, text)        — append a user-facing message to the session log
+ *   notify(session, text)         — append a user-facing message to the session log
  *   llmFollowup(invocation,prompt)— hand a prompt to the LLM as a user message
+ *   StatusLine(session)            — in-place updatable status bar via surfaceOp replace
  *   scanProgress(ctx, phase, data)— emit structured scan progress events
- *   sleep(ctx, ms)               — DSH-native promise delay via ctx.timeout()
+ *   sleep(ctx, ms)                — DSH-native promise delay via ctx.timeout()
  *
  * All fancy-* plugins import from this file.
  */
@@ -31,6 +32,45 @@ export function notify(session, text) {
   );
 }
 
+// --------------------------------------------------------------------------
+// StatusLine — in-place updatable status bar using session surfaceOp replace
+// --------------------------------------------------------------------------
+
+/**
+ * Appends a single session event and updates it in-place on subsequent calls
+ * using session's surfaceOp replace mechanism. The event always stays at the
+ * same log position; only its content changes — visually a terminal status bar.
+ *
+ * Usage:
+ *   const status = new StatusLine(session);
+ *   status.update('Working…');
+ *   status.update('Done ✓');
+ *   status.clear();
+ */
+export class StatusLine {
+  #session;
+  #seq;
+
+  constructor(session) { this.#session = session; }
+
+  update(text) {
+    const event = this.#seq
+      ? this.#session.append(
+          'fancy/status',
+          { content: [{ type: 'text', text }], source: { kind: 'user' } },
+          { surfaceOp: { op: 'replace', start: this.#seq, end: this.#seq } }
+        )
+      : this.#session.append(
+          'fancy/status',
+          { content: [{ type: 'text', text }], source: { kind: 'user' } },
+          { surfaceOp: 'append' }
+        );
+    this.#seq ??= event.seq;
+  }
+
+  clear() { this.update(''); }
+}
+
 // --------------------------------------------------------------------------
 // llmFollowup — hand a prompt to the LLM as a user message
 // --------------------------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloud411716/fancy-webnovel",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "type": "module",
   "main": "index.js",
   "exports": {