@ohos-cpf/3rdloop 0.0.8 → 0.0.9

package/vendor/Archive/src/data/stopwords.txt

@@ -0,0 +1,110 @@
+的
+了
+是
+在
+和
+与
+或
+及
+等
+为
+对
+从
+向
+上
+下
+中
+内
+外
+这
+那
+个
+些
+什么
+怎么
+如何
+可以
+需要
+应该
+使用
+通过
+进行
+实现
+a
+an
+the
+of
+to
+in
+on
+at
+by
+for
+with
+from
+into
+onto
+is
+are
+was
+were
+be
+been
+being
+have
+has
+had
+do
+does
+did
+will
+would
+can
+could
+should
+shall
+may
+might
+must
+this
+that
+these
+those
+it
+its
+they
+them
+their
+there
+here
+which
+who
+whom
+whose
+what
+when
+where
+why
+how
+all
+any
+both
+each
+few
+more
+most
+other
+some
+such
+no
+nor
+not
+only
+own
+same
+so
+than
+too
+very
+just
+now

package/vendor/Archive/src/data/synonyms.json

@@ -0,0 +1,25 @@
+[
+  ["弹窗", "dialog", "Dialog", "popup", "Popup", "对话框"],
+  ["路由", "router", "Router", "navigation", "导航", "Navigation"],
+  ["生命周期", "lifecycle", "Lifecycle", "LifeCycle"],
+  ["权限", "permission", "Permission", "授权"],
+  ["动画", "animation", "Animation", "animateTo"],
+  ["状态管理", "state", "State", "状态", "@State"],
+  ["列表", "list", "List", "列表组件"],
+  ["网络", "network", "Network", "http", "HTTP", "请求"],
+  ["存储", "storage", "Storage", "持久化", "Persistent"],
+  ["事件", "event", "Event", "回调", "callback", "Callback"],
+  ["布局", "layout", "Layout", "Flex", "布局容器"],
+  ["手势", "gesture", "Gesture", "触摸"],
+  ["相机", "camera", "Camera", "cameraManager"],
+  ["预览", "preview", "Preview", "预览流"],
+  ["音频", "audio", "Audio", "播放"],
+  ["视频", "video", "Video", "播放器"],
+  ["通知", "notification", "Notification", "推送"],
+  ["后台", "background", "Background", "后台任务"],
+  ["线程", "thread", "Thread", "TaskPool", "Worker"],
+  ["日志", "log", "Log", "hilog"],
+  ["调试", "debug", "Debug", "profiler"],
+  ["打包", "build", "Build", "hap", "打包构建"],
+  ["签名", "sign", "Sign", "证书", "certificate"]
+]

package/vendor/Archive/src/data/terms.txt

@@ -0,0 +1,59 @@
+AbilityStage
+UIAbility
+ExtensionAbility
+ArkUI
+ArkTS
+cameraManager
+Navigation
+NavDestination
+AbilityConstant
+Want
+AbilityContext
+UIContext
+component
+Builder
+Entry
+Component
+State
+Prop
+Link
+Provide
+Consume
+Watch
+Observed
+Track
+Persistent
+LocalStorage
+AppStorage
+Environment
+XComponent
+WebView
+List
+Grid
+Swiper
+Tabs
+Image
+Text
+TextInput
+Button
+Stack
+Flex
+Column
+Row
+RelativeContainer
+Shape
+Path
+Circle
+Rect
+Ellipse
+Polyline
+Polygon
+animateTo
+transition
+geometryTransition
+sharedTransition
+Inspector
+profiler
+hdc
+hilog
+ohpm

package/vendor/Archive/src/db/sqlite-backend.js

@@ -0,0 +1,312 @@
+/**
+ * sqlite-backend.js — SQLite 后端（基于 node:sqlite）
+ *
+ * 使用 Node.js 内置的 node:sqlite 模块（DatabaseSync / StatementSync），
+ * 完整支持 FTS5 + bm25，直接操作文件持久化，无需 WASM。
+ *
+ * 对外暴露适配后的 DB 对象，提供与原 WASM 方案一致的 API：
+ *   db.exec(sql)
+ *   db.prepare(sql)        → StmtAdapter
+ *   db.selectValue(sql)
+ *
+ * StatementSync 适配层（StmtAdapter）：
+ *   stmt.bind(params[])    → 缓存参数
+ *   stmt.step()            → 执行一次，返回是否有行
+ *   stmt.get()             → 取当前行（对象形式）
+ *   stmt.reset()           → 重置语句状态
+ *   stmt.finalize()        → 释放语句（node:sqlite 自动管理，此处空操作）
+ *
+ * 读写分离：
+ *   - openWriteDb：打开持久化文件 DB（DatabaseSync），支持增删改查。
+ *   - openReadDb：复用写库连接（node:sqlite 同进程内支持并发读），
+ *     按 mtimeMs 缓存独立只读连接，写入后失效。
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+import { SCHEMA_SQL } from './sqlite-schema.js';
+
+/**
+ * StatementSync 适配器 — 兼容 WASM 风格的 bind/step/get/finalize/reset。
+ *
+ * node:sqlite 的 StatementSync 不支持逐行 step() 游标推进。
+ * get() 每次返回第一行，iterate() 返回迭代器，all() 返回全部行。
+ * 为兼容 WASM 风格的 while(stmt.step()) { stmt.get() } 循环，
+ * 在首次 step() 时用 all() 预取全部行，后续 step() 推进索引。
+ */
+class StmtAdapter {
+  /**
+   * @param {import('node:sqlite').StatementSync} stmt
+   */
+  constructor(stmt) {
+    this._stmt = stmt;
+    /** @type {unknown[]|null} */
+    this._bound = null;
+    /** @type {object[]|null} 预取的全部行 */
+    this._rows = null;
+    /** @type {number} 当前行索引 */
+    this._index = -1;
+  }
+
+  /**
+   * 绑定参数（WASM 风格接受数组）。
+   * @param {unknown[]} params
+   */
+  bind(params) {
+    this._bound = Array.isArray(params) ? params : [params];
+    this._rows = null;
+    this._index = -1;
+  }
+
+  /**
+   * 执行一步，返回是否还有数据行。
+   *
+   * 首次调用：用 all() 预取全部行（SELECT）或 run() 执行（INSERT/UPDATE/DELETE）。
+   * 后续调用：推进行索引。
+   *
+   * @returns {boolean}
+   */
+  step() {
+    if (!this._stmt) return false;
+
+    // 首次 step：执行语句并预取结果
+    if (this._rows === null) {
+      const params = this._bound || [];
+      try {
+        // SELECT 语句：all() 返回全部行
+        this._rows = this._stmt.all(...params);
+      } catch {
+        // 非 SELECT 语句（INSERT/UPDATE/DELETE）：用 run() 执行
+        try {
+          this._stmt.run(...params);
+        } catch {
+          // 忽略执行错误，上层通过返回空结果感知
+        }
+        this._rows = [];
+      }
+      this._index = 0;
+    } else {
+      // 后续 step：推进索引
+      this._index++;
+    }
+
+    return this._index < this._rows.length;
+  }
+
+  /**
+   * 获取当前行数据（对象形式）。
+   * @returns {object}
+   */
+  get() {
+    if (this._rows === null || this._index < 0 || this._index >= this._rows.length) {
+      return {};
+    }
+    return this._rows[this._index];
+  }
+
+  /**
+   * 重置语句（WASM 风格）。
+   * 清空预取结果，下次 step() 会重新执行。
+   */
+  reset() {
+    this._rows = null;
+    this._index = -1;
+  }
+
+  /**
+   * 释放语句（WASM 风格）。
+   * node:sqlite 的 StatementSync 由 GC 管理，此处清空引用。
+   */
+  finalize() {
+    this._stmt = null;
+    this._bound = null;
+    this._rows = null;
+    this._index = -1;
+  }
+}
+
+/**
+ * DatabaseSync 适配器 — 在原 DB 上添加 selectValue 等便捷方法。
+ */
+class DbAdapter {
+  /**
+   * @param {import('node:sqlite').DatabaseSync} db
+   */
+  constructor(db) {
+    this._db = db;
+  }
+
+  /**
+   * 执行 SQL（无参数）。
+   * @param {string} sql
+   */
+  exec(sql) {
+    this._db.exec(sql);
+  }
+
+  /**
+   * 预处理 SQL，返回适配后的语句。
+   * @param {string} sql
+   * @returns {StmtAdapter}
+   */
+  prepare(sql) {
+    const stmt = this._db.prepare(sql);
+    return new StmtAdapter(stmt);
+  }
+
+  /**
+   * 执行查询并返回单个标量值。
+   * @param {string} sql
+   * @param {...unknown} params
+   * @returns {unknown}
+   */
+  selectValue(sql, ...params) {
+    const stmt = this._db.prepare(sql);
+    const row = stmt.get(...params);
+    if (!row) return undefined;
+    const keys = Object.keys(row);
+    if (keys.length === 0) return undefined;
+    return row[keys[0]];
+  }
+
+  /**
+   * 关闭数据库连接。
+   */
+  close() {
+    this._db.close();
+  }
+}
+
+export default class SqliteBackend {
+  constructor() {
+    /** @type {DbAdapter|null} */
+    this.writeDb = null;
+    /** @type {{path:string,mtimeMs:number,db:DbAdapter}|null} */
+    this.readCache = null;
+    /** @type {string|null} */
+    this._dbPath = null;
+  }
+
+  /**
+   * 初始化后端（node:sqlite 无需异步初始化）。
+   * @returns {Promise<void>}
+   */
+  async init() {
+    // node:sqlite 是同步内置模块，无需异步初始化
+  }
+
+  /**
+   * 打开（或复用）持久化读写数据库。
+   * @param {string} dbPath
+   * @returns {Promise<DbAdapter>}
+   */
+  async openWriteDb(dbPath) {
+    if (this.writeDb) return this.writeDb;
+
+    await fs.promises.mkdir(path.dirname(dbPath), { recursive: true });
+
+    const isNew = !fs.existsSync(dbPath);
+    const rawDb = new DatabaseSync(dbPath);
+    // 启用 WAL 模式提升并发读写性能
+    rawDb.exec('PRAGMA journal_mode = WAL;');
+    rawDb.exec('PRAGMA foreign_keys = ON;');
+
+    if (isNew) {
+      rawDb.exec(SCHEMA_SQL);
+    }
+
+    this.writeDb = new DbAdapter(rawDb);
+    this._dbPath = dbPath;
+    return this.writeDb;
+  }
+
+  /**
+   * 打开只读数据库连接（按 mtime 缓存）。
+   * 优先复用写库连接，避免多连接开销。
+   * @param {string} dbPath
+   * @returns {Promise<DbAdapter>}
+   */
+  async openReadDb(dbPath) {
+    // 同路径直接复用写库（node:sqlite 单连接支持读写并发）
+    if (this.writeDb && this._dbPath === dbPath) {
+      return this.writeDb;
+    }
+
+    const stat = await fs.promises.stat(dbPath);
+
+    if (
+      this.readCache &&
+      this.readCache.path === dbPath &&
+      this.readCache.mtimeMs === stat.mtimeMs
+    ) {
+      return this.readCache.db;
+    }
+
+    this.readCache?.db.close();
+    const rawDb = new DatabaseSync(dbPath);
+    rawDb.exec('PRAGMA query_only = ON;');
+    this.readCache = {
+      path: dbPath,
+      mtimeMs: stat.mtimeMs,
+      db: new DbAdapter(rawDb),
+    };
+    return this.readCache.db;
+  }
+
+  /**
+   * 写入后调用，使只读缓存失效。
+   */
+  invalidateReadCache() {
+    this.readCache?.db.close();
+    this.readCache = null;
+  }
+
+  /**
+   * 执行 VACUUM 压缩数据库，回收碎片空间。
+   *
+   * 删除/更新文档会产生空闲页（freelist），VACUUM 重建数据库文件，
+   * 消除碎片，保持文件紧凑。适合在批量删除或 rebuildIndex 后调用。
+   *
+   * @returns {Promise<void>}
+   */
+  async vacuum() {
+    if (!this.writeDb) return;
+    // VACUUM 不能在事务中执行
+    this.writeDb.exec('VACUUM;');
+  }
+
+  /**
+   * 将 WAL 日志合并回主数据库文件（checkpoint）。
+   *
+   * WAL 模式下写入先进入 -wal 文件，checkpoint 后才合并到 .db。
+   * 关闭连接前调用可确保 .db 文件包含最新数据，
+   * 这对 git 提交尤为重要——避免提交的 .db 缺少近期写入。
+   *
+   * @returns {Promise<void>}
+   */
+  async checkpoint() {
+    if (!this.writeDb) return;
+    // TRUNCATE 模式：合并 WAL 到主库并截断 WAL 文件
+    this.writeDb.exec('PRAGMA wal_checkpoint(TRUNCATE);');
+  }
+
+  /**
+   * 关闭所有数据库连接，释放资源。
+   * 关闭前执行 checkpoint 确保 WAL 数据合并到主库文件。
+   * @returns {Promise<void>}
+   */
+  async close() {
+    if (this.writeDb) {
+      try {
+        await this.checkpoint();
+      } catch {
+        // checkpoint 失败不影响关闭
+      }
+    }
+    this.writeDb?.close();
+    this.readCache?.db.close();
+    this.writeDb = null;
+    this.readCache = null;
+  }
+}

package/vendor/Archive/src/db/sqlite-schema.js

@@ -0,0 +1,64 @@
+/**
+ * sqlite-schema.js — SQLite FTS5 DDL
+ *
+ * 定义 documents / segments / segments_fts 虚拟表及同步触发器。
+ * 通过外部内容表模式（content='segments'）保持 FTS 与段表一致。
+ */
+
+export const SCHEMA_SQL = `
+-- 文档表: 记录文档元信息
+CREATE TABLE IF NOT EXISTS documents (
+  id            INTEGER PRIMARY KEY,
+  document_id   TEXT NOT NULL UNIQUE,
+  catalog_id    INTEGER NOT NULL,
+  doc_title     TEXT NOT NULL,
+  metadata      TEXT DEFAULT '{}',
+  created_at    INTEGER NOT NULL,
+  updated_at    INTEGER NOT NULL
+);
+
+-- 段表: 文档拆分后的索引单元
+CREATE TABLE IF NOT EXISTS segments (
+  id                 INTEGER PRIMARY KEY,
+  doc_id             INTEGER NOT NULL REFERENCES documents(id) ON DELETE CASCADE,
+  section_title      TEXT NOT NULL DEFAULT '',
+  lead_text          TEXT NOT NULL DEFAULT '',
+  search_text        TEXT NOT NULL,
+  excerpt_truncated  INTEGER NOT NULL DEFAULT 0
+);
+
+-- FTS5 全文索引虚拟表（外部内容表模式）
+CREATE VIRTUAL TABLE IF NOT EXISTS segments_fts USING fts5(
+  search_text,
+  content='segments',
+  content_rowid='id',
+  tokenize='unicode61'
+);
+
+-- 同步触发器: segments 增删改自动同步 FTS
+CREATE TRIGGER IF NOT EXISTS segments_ai AFTER INSERT ON segments BEGIN
+  INSERT INTO segments_fts(rowid, search_text) VALUES (new.id, new.search_text);
+END;
+
+CREATE TRIGGER IF NOT EXISTS segments_ad AFTER DELETE ON segments BEGIN
+  INSERT INTO segments_fts(segments_fts, rowid, search_text)
+    VALUES ('delete', old.id, old.search_text);
+END;
+
+CREATE TRIGGER IF NOT EXISTS segments_au AFTER UPDATE ON segments BEGIN
+  INSERT INTO segments_fts(segments_fts, rowid, search_text)
+    VALUES ('delete', old.id, old.search_text);
+  INSERT INTO segments_fts(rowid, search_text)
+    VALUES (new.id, new.search_text);
+END;
+
+-- 辅助索引
+CREATE INDEX IF NOT EXISTS segments_doc_id_idx ON segments(doc_id);
+CREATE INDEX IF NOT EXISTS documents_catalog_idx ON documents(catalog_id);
+
+-- 索引元数据表
+CREATE TABLE IF NOT EXISTS index_meta (
+  key   TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
+`;