@allbluecn/web-app 0.3.0

package/src/lib/story/__tests__/description-diff.test.ts

@@ -0,0 +1,214 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { describe, it, expect } from "vitest";
+import {
+  parseDescriptionHtml,
+  isBlankHtmlBlock,
+  splitHtmlBlocks,
+  diffDescriptionBlocks,
+} from "../description-diff";
+
+describe("parseDescriptionHtml", () => {
+  it("解析 JSON 包装的 html 字段", () => {
+    const desc = JSON.stringify({ html: "<p>foo</p>", markdown: "foo" });
+    expect(parseDescriptionHtml(desc)).toBe("<p>foo</p>");
+  });
+
+  it("裸 HTML 字符串原样返回", () => {
+    expect(parseDescriptionHtml("<p>foo</p>")).toBe("<p>foo</p>");
+  });
+
+  it("纯文本原样返回", () => {
+    expect(parseDescriptionHtml("hello world")).toBe("hello world");
+  });
+
+  it("JSON 但无 html 字段时返回原字符串", () => {
+    expect(parseDescriptionHtml('{"markdown":"foo"}')).toBe('{"markdown":"foo"}');
+  });
+});
+
+describe("isBlankHtmlBlock", () => {
+  it("空字符串是空白块", () => {
+    expect(isBlankHtmlBlock("")).toBe(true);
+  });
+
+  it("空段落标签是空白块", () => {
+    expect(isBlankHtmlBlock("<p></p>")).toBe(true);
+  });
+
+  it("只含空白的段落是空白块", () => {
+    expect(isBlankHtmlBlock("<p>   \n\t  </p>")).toBe(true);
+  });
+
+  it("只含 &nbsp; 的段落是空白块", () => {
+    expect(isBlankHtmlBlock("<p>&nbsp;&nbsp;</p>")).toBe(true);
+  });
+
+  it("有可见文本不是空白块", () => {
+    expect(isBlankHtmlBlock("<p>foo</p>")).toBe(false);
+  });
+
+  it("只有标签但没有文本的 div 仍是空白块", () => {
+    expect(isBlankHtmlBlock("<div><br/></div>")).toBe(true);
+  });
+});
+
+describe("splitHtmlBlocks", () => {
+  it("空字符串返回空数组", () => {
+    expect(splitHtmlBlocks("")).toEqual([]);
+  });
+
+  it("切分多个块级元素", () => {
+    expect(splitHtmlBlocks("<p>foo</p><p>bar</p>")).toEqual(["<p>foo</p>", "<p>bar</p>"]);
+  });
+
+  it("过滤末尾的空段落（TipTap 副作用）", () => {
+    expect(splitHtmlBlocks("<p>foo</p><p></p>")).toEqual(["<p>foo</p>"]);
+  });
+
+  it("全是空块时返回空数组", () => {
+    expect(splitHtmlBlocks("<p></p><p></p>")).toEqual([]);
+  });
+
+  it("无块级标签的纯文本作为单个块返回", () => {
+    expect(splitHtmlBlocks("hello")).toEqual(["hello"]);
+  });
+
+  it("无块级标签但内容为空白时返回空数组", () => {
+    expect(splitHtmlBlocks("   ")).toEqual([]);
+  });
+});
+
+describe("diffDescriptionBlocks", () => {
+  it("两边都为空时不产生差异", () => {
+    expect(diffDescriptionBlocks(null, "")).toEqual([]);
+  });
+
+  it("两边都为空段落（编辑器初始化副作用）时不产生差异", () => {
+    // 场景：DB 中描述为 null，编辑器加载时自动产出 <p></p>，触发自动保存。
+    // 历史缺陷：会生成一条 oldValue="" newValue="<p></p>" 的无内容修改记录。
+    const oldDesc = null;
+    const newDesc = JSON.stringify({ html: "<p></p>", markdown: "" });
+    expect(diffDescriptionBlocks(oldDesc, newDesc)).toEqual([]);
+  });
+
+  it("TipTap 在真实修改后末尾自动补 <p></p> 时不产生额外差异", () => {
+    // 场景：用户把 foo 改成 bar，编辑器产出 "<p>bar</p><p></p>"，
+    // 历史缺陷：除了真实差异外还会多生成一条 oldValue="" newValue="<p></p>" 的记录。
+    const oldDesc = JSON.stringify({ html: "<p>foo</p>", markdown: "foo" });
+    const newDesc = JSON.stringify({ html: "<p>bar</p><p></p>", markdown: "bar\n" });
+    expect(diffDescriptionBlocks(oldDesc, newDesc)).toEqual([
+      { oldValue: "<p>foo</p>", newValue: "<p>bar</p>" },
+    ]);
+  });
+
+  it("真实修改生成一条差异", () => {
+    const oldDesc = JSON.stringify({ html: "<p>foo</p>", markdown: "foo" });
+    const newDesc = JSON.stringify({ html: "<p>bar</p>", markdown: "bar" });
+    expect(diffDescriptionBlocks(oldDesc, newDesc)).toEqual([
+      { oldValue: "<p>foo</p>", newValue: "<p>bar</p>" },
+    ]);
+  });
+
+  it("清空描述（旧有内容、新空）生成删除差异", () => {
+    const oldDesc = JSON.stringify({ html: "<p>foo</p>", markdown: "foo" });
+    const newDesc = JSON.stringify({ html: "<p></p>", markdown: "" });
+    expect(diffDescriptionBlocks(oldDesc, newDesc)).toEqual([
+      { oldValue: "<p>foo</p>", newValue: "" },
+    ]);
+  });
+
+  it("新增描述（旧空、新有内容）生成新增差异", () => {
+    const oldDesc = "";
+    const newDesc = JSON.stringify({ html: "<p>hello</p>", markdown: "hello" });
+    expect(diffDescriptionBlocks(oldDesc, newDesc)).toEqual([
+      { oldValue: "", newValue: "<p>hello</p>" },
+    ]);
+  });
+
+  it("兼容旧版裸字符串 description", () => {
+    expect(diffDescriptionBlocks("foo", "bar")).toEqual([
+      { oldValue: "foo", newValue: "bar" },
+    ]);
+  });
+
+  it("多块独立变更各自记录", () => {
+    const oldDesc = JSON.stringify({
+      html: "<p>a</p><p>b</p><p>c</p>",
+      markdown: "a\nb\nc",
+    });
+    const newDesc = JSON.stringify({
+      html: "<p>A</p><p>b</p><p>C</p>",
+      markdown: "A\nb\nC",
+    });
+    expect(diffDescriptionBlocks(oldDesc, newDesc)).toEqual([
+      { oldValue: "<p>a</p>", newValue: "<p>A</p>" },
+      { oldValue: "<p>c</p>", newValue: "<p>C</p>" },
+    ]);
+  });
+
+  it("仅文字颜色变化不产生差异", () => {
+    const oldDesc = JSON.stringify({ html: '<p><span style="color: red">foo</span></p>', markdown: "foo" });
+    const newDesc = JSON.stringify({ html: "<p>foo</p>", markdown: "foo" });
+    expect(diffDescriptionBlocks(oldDesc, newDesc)).toEqual([]);
+  });
+
+  it("仅添加下划线不产生差异", () => {
+    const oldDesc = JSON.stringify({ html: "<p>foo</p>", markdown: "foo" });
+    const newDesc = JSON.stringify({ html: "<p><u>foo</u></p>", markdown: "foo" });
+    expect(diffDescriptionBlocks(oldDesc, newDesc)).toEqual([]);
+  });
+
+  it("仅修改背景色不产生差异", () => {
+    const oldDesc = JSON.stringify({ html: "<p>foo</p>", markdown: "foo" });
+    const newDesc = JSON.stringify({
+      html: '<p><span style="background-color: yellow">foo</span></p>',
+      markdown: "foo",
+    });
+    expect(diffDescriptionBlocks(oldDesc, newDesc)).toEqual([]);
+  });
+
+  it("仅修改文字对齐方式不产生差异", () => {
+    const oldDesc = JSON.stringify({ html: "<p>foo</p>", markdown: "foo" });
+    const newDesc = JSON.stringify({ html: '<p style="text-align: center">foo</p>', markdown: "foo" });
+    expect(diffDescriptionBlocks(oldDesc, newDesc)).toEqual([]);
+  });
+
+  it("真实内容修改即使带样式变更也记录", () => {
+    const oldDesc = JSON.stringify({ html: '<p><strong>foo</strong></p>', markdown: "foo" });
+    const newDesc = JSON.stringify({ html: '<p><strong>bar</strong></p>', markdown: "bar" });
+    expect(diffDescriptionBlocks(oldDesc, newDesc)).toEqual([
+      { oldValue: '<p><strong>foo</strong></p>', newValue: '<p><strong>bar</strong></p>' },
+    ]);
+  });
+
+  it("真实场景：仅加背景色 mark 不产生差异", () => {
+    const oldDesc = '<p data-id="a11900c8-49f1-4afe-87e1-0c7fec37f673">大赛塞啊塞</p>';
+    const newDesc =
+      '<p data-id="a11900c8-49f1-4afe-87e1-0c7fec37f673">大<mark data-color="var(--tt-color-highlight-orange)" style="background-color: var(--tt-color-highlight-orange); color: inherit;">赛塞啊塞</mark></p>';
+    expect(diffDescriptionBlocks(oldDesc, newDesc)).toEqual([]);
+  });
+
+  it("真实场景：仅改文字颜色不产生差异", () => {
+    const oldDesc =
+      '<p data-id="5836505a-cd09-4e96-998d-db139f2f6c90">检查所有连续创建的需求是否均成功入库且属性正确滴啊速递哦撒上</p>';
+    const newDesc =
+      '<p data-id="5836505a-cd09-4e96-998d-db139f2f6c90"><span style="color: var(--tt-color-text-brown);">检查所有连续创建的需求是否均成功入库且属性正确滴啊速递哦撒上</span></p>';
+    expect(diffDescriptionBlocks(oldDesc, newDesc)).toEqual([]);
+  });
+});

package/src/lib/story/activity-grouper.ts

@@ -0,0 +1,173 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import type { ActivityItem } from "@/components/story/types";
+
+/**
+ * 活动记录合并窗口：3 分钟内同 user + 同 action 视为「同一次操作的连续行为」。
+ *
+ * 来源：用户在编辑器内一次会话通常包含多次输入停顿（思考 1-3s），即使已经做了
+ * 编辑会话级合并（失焦时一次性 flush），同一次会话仍可能因为多块内容、或同一字段
+ * 反复调整产生多条记录。在显示层把它们合并为一条，避免活动时间线被噪声淹没。
+ */
+export const ACTIVITY_MERGE_WINDOW_MS = 3 * 60 * 1000;
+
+/**
+ * 参与合并的 action 类型。字段变更类（修改了某字段）合并展示更合理；
+ * 「发表了评论」每条都是独立内容，不合并（避免丢评论原文）。
+ * 「创建了需求」「更新了需求」是泛化动作，单独保留。
+ */
+const MERGEABLE_ACTIONS = new Set([
+  "description_changed",
+  "name_changed",
+  "state_changed",
+  "priority_changed",
+  "assignee_changed",
+  "startDate_changed",
+  "targetDate_changed",
+  "label_changed",
+]);
+
+export interface ActivityGroup {
+  /** 用于渲染主体（user/action/field/isAI/createdAt）的代表条目 */
+  representative: ActivityItem;
+  /** 此组包含的所有原始条目，按时间升序（旧在前），用于「合并了 N 次」徽章和详情展开 */
+  items: ActivityItem[];
+  /** 用于 DiffCompare 显示的旧值（合并策略决定首尾/末条） */
+  displayOldValue: string | null;
+  /** 用于 DiffCompare 显示的新值 */
+  displayNewValue: string | null;
+}
+
+/**
+ * 判定单条活动是否为「添加」行为：oldValue 为空（含纯空白）视为添加，否则视为修改。
+ * 与 describeActivity 内的 isAdd 判定保持一致，确保合并组与单条描述用同一标准。
+ */
+function isAddActivity(a: ActivityItem): boolean {
+  return !a.oldValue || a.oldValue.trim() === "";
+}
+
+/**
+ * 把活动记录按 (userId, action, 添加/修改, 时间窗) 合并为组。返回顺序为降序（最新组在前），
+ * 与时间线展示习惯一致。不在 MERGEABLE_ACTIONS 中的 action 每条独立成组（items.length === 1）。
+ *
+ * 添加与修改不合并：避免「添加了标签」和「修改了标签」混在一组导致语义混乱。
+ *
+ * 例外：description_changed 无视 add/modify 区分。原因：一次编辑会话会按块切产生多条
+ * 记录（混合新增块 oldValue="" 和修改块 oldValue=旧内容），它们语义上属于同一次编辑，
+ * 拆开显示会让时间线被同一次编辑的碎片淹没。合并后用首尾 diff 体现整体变化。
+ */
+export function groupActivities(
+  activities: ActivityItem[],
+  windowMs: number = ACTIVITY_MERGE_WINDOW_MS,
+): ActivityGroup[] {
+  if (activities.length === 0) return [];
+  // 升序扫描（旧在前），便于检测时间窗
+  const sorted = [...activities].sort(
+    (a, b) => new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime(),
+  );
+
+  const groups: ActivityGroup[] = [];
+  let bucket: ActivityItem[] = [sorted[0]];
+
+  const flush = () => {
+    groups.push(buildGroup(bucket));
+    bucket = [];
+  };
+
+  for (let i = 1; i < sorted.length; i++) {
+    const cur = sorted[i];
+    // 时间窗判定：从当前组首条起到本条的总跨度 ≤ windowMs（语义：3 分钟内的操作合并）。
+    // 不用相邻间隔，否则链式合并可能让组跨度无限增长。
+    const groupStart = bucket[0];
+    const withinWindow =
+      new Date(cur.createdAt).getTime() - new Date(groupStart.createdAt).getTime() <= windowMs;
+    const last = bucket[bucket.length - 1];
+    // 描述变更跳过 add/modify 区分（见函数 JSDoc）
+    const sameBehavior =
+      cur.action === "description_changed" ||
+      isAddActivity(cur) === isAddActivity(last);
+    const sameGroup =
+      MERGEABLE_ACTIONS.has(cur.action) &&
+      cur.action === last.action &&
+      cur.user.id === last.user.id &&
+      sameBehavior &&
+      withinWindow;
+    if (sameGroup) {
+      bucket.push(cur);
+    } else {
+      flush();
+      bucket = [cur];
+    }
+  }
+  flush();
+
+  // 翻回降序，最新组在前
+  return groups.reverse();
+}
+
+function buildGroup(items: ActivityItem[]): ActivityGroup {
+  const action = items[0].action;
+  const first = items[0]; // 最旧
+  const last = items[items.length - 1]; // 最新
+
+  // 状态/优先级：用户原话「只保留最后一次的操作」—— 用末条原样（oldValue/newValue/createdAt 都是末条）
+  if (action === "state_changed" || action === "priority_changed") {
+    return {
+      representative: last,
+      items,
+      displayOldValue: last.oldValue,
+      displayNewValue: last.newValue,
+    };
+  }
+
+  // 描述变更：拼接所有块的 oldValue / newValue。
+  // 原因：服务端 diffDescriptionBlocks 按块切，每条记录对应一个块（<p>/<h*>/<ul>...）。
+  // 若用首尾 diff（first.oldValue → last.newValue），中间块的变更会丢失，用户看到的
+  // 对比只剩第一个块的旧值和最后一个块的新值。拼接后 DiffCompare 能展示整段编辑的全部变化。
+  // 用 "\n" 分隔便于 word diff 按行识别块边界；filter(Boolean) 过滤新增块的空 oldValue
+  // 和删除块的空 newValue，避免出现连续分隔符。
+  if (action === "description_changed") {
+    const oldValue = items.map((it) => it.oldValue ?? "").filter(Boolean).join("\n");
+    const newValue = items.map((it) => it.newValue ?? "").filter(Boolean).join("\n");
+    return {
+      representative: { ...last, oldValue, newValue },
+      items,
+      displayOldValue: oldValue,
+      displayNewValue: newValue,
+    };
+  }
+
+  // 其他字段变更（name/assignee/...）：用首尾 diff，体现整体变化（最初值 → 最终值）
+  // 中间过渡（如 foo → bar → baz）被折叠，只显示 foo → baz
+  if (MERGEABLE_ACTIONS.has(action)) {
+    return {
+      representative: { ...last, oldValue: first.oldValue, newValue: last.newValue },
+      items,
+      displayOldValue: first.oldValue,
+      displayNewValue: last.newValue,
+    };
+  }
+
+  // 非字段变更（commented/created/updated）：末条原样
+  return {
+    representative: last,
+    items,
+    displayOldValue: last.oldValue,
+    displayNewValue: last.newValue,
+  };
+}

package/src/lib/story/description-diff.ts

@@ -0,0 +1,140 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+/**
+ * 需求描述（description）字段差异比较工具。
+ *
+ * 背景：需求描述以 JSON 字符串 `{ html, markdown }` 形式存入 DB（旧数据可能是裸
+ * HTML/markdown）。编辑器（TipTap）在加载或保存时可能给 HTML 末尾自动补 `<p></p>`
+ * 等空段落，导致字符串层面与 DB 中现存值不相等，进而被 `updateStoryFn` 当作真实
+ * 变更记录到活动时间线。本模块负责把两端描述切成「语义块」并过滤空白块后再对比，
+ * 避免无内容变更产生噪声活动记录。
+ */
+
+export interface DescriptionDiffEntry {
+  /** 旧值（块级 HTML 片段；新增时为空字符串） */
+  oldValue: string;
+  /** 新值（块级 HTML 片段；删除时为空字符串） */
+  newValue: string;
+}
+
+/**
+ * 从 description 字段中解析出 HTML 字符串。
+ *
+ * 兼容三种历史格式：
+ * 1. `JSON.stringify({ html, markdown })` —— 当前主格式，取 html 字段
+ * 2. 裸 HTML 字符串 —— 直接返回
+ * 3. 纯文本/markdown —— 直接返回
+ */
+export function parseDescriptionHtml(desc: string): string {
+  try {
+    const parsed = JSON.parse(desc) as { html?: string };
+    if (typeof parsed.html === "string") return parsed.html;
+  } catch {}
+  return desc;
+}
+
+/**
+ * 判断一个 HTML 片段是否是「视觉空白」—— 去掉所有标签、HTML 实体和空白字符后
+ * 没有任何可见字符。例如 `<p></p>`、`<p>  &nbsp;  </p>`、`<div>\n</div>` 都会被
+ * 判定为空白。
+ */
+export function isBlankHtmlBlock(html: string): boolean {
+  if (!html) return true;
+  const text = html
+    .replace(/<[^>]*>/g, "")
+    .replace(/&nbsp;/gi, " ")
+    .replace(/\s/g, "");
+  return text.length === 0;
+}
+
+/**
+ * 将一段 HTML 切分为块级元素数组（`<p>`/`<h1-6>`/`<ul>`/`<ol>`/`<pre>`/
+ * `<blockquote>`/`<div>`/`<table>`），并**过滤掉视觉空白的块**。
+ *
+ * 若整段 HTML 不含任何块级元素（例如纯文本/markdown），则把整段当作一个块
+ * 返回（再走空白过滤）。
+ *
+ * 过滤空白块的目的：TipTap 等编辑器在加载空描述或保存时常常在末尾补一个
+ * `<p></p>`，这不应被记为「描述变更」。
+ */
+export function splitHtmlBlocks(html: string): string[] {
+  if (!html) return [];
+  const blocks: string[] = [];
+  const regex = /<(p|h[1-6]|ul|ol|pre|blockquote|div|table)[^>]*>[\s\S]*?<\/\1>/gi;
+  let match: RegExpExecArray | null;
+  while ((match = regex.exec(html)) !== null) {
+    blocks.push(match[0]);
+  }
+  const raw = blocks.length > 0 ? blocks : [html];
+  return raw.filter((b) => !isBlankHtmlBlock(b));
+}
+
+/**
+ * 对比新旧 description 字段（DB 原始字符串），返回需要写入活动时间线的差异列表。
+ *
+ * 算法：
+ * 1. 解析两端 HTML
+ * 2. 切成块级元素数组（过滤空白块）
+ * 3. 按索引逐块对比，长度不等时短的一侧用空字符串补齐
+ *
+ * 这个算法是「按顺序对位」的简单 diff，不识别块的移动/插入/删除，与历史实现保持
+ * 一致。本函数的修复点仅在于过滤空白块，避免编辑器副作用产生噪声记录。
+ */
+/**
+ * 提取一段 HTML 的纯文本内容（去掉标签、解码实体、折叠空白）。
+ *
+ * 用于判断两次块变更是否「仅样式不同、内容一致」——例如只改了文字颜色、
+ * 下划线、背景色或对齐方式，此时条的纯文本内容相同，不应记为内容变更。
+ */
+export function normalizeBlockText(html: string): string {
+  return html
+    .replace(/<[^>]*>/g, "")
+    .replace(/&nbsp;/gi, " ")
+    .replace(/&amp;/gi, "&")
+    .replace(/&lt;/gi, "<")
+    .replace(/&gt;/gi, ">")
+    .replace(/&quot;/gi, '"')
+    .replace(/&#39;/gi, "'")
+    .replace(/[\s\u00a0]+/g, " ")
+    .trim();
+}
+
+export function diffDescriptionBlocks(
+  oldDesc: string | null | undefined,
+  newDesc: string,
+): DescriptionDiffEntry[] {
+  const oldHtml = parseDescriptionHtml(oldDesc ?? "");
+  const newHtml = parseDescriptionHtml(newDesc);
+  const oldBlocks = splitHtmlBlocks(oldHtml);
+  const newBlocks = splitHtmlBlocks(newHtml);
+  const maxLen = Math.max(oldBlocks.length, newBlocks.length);
+  const result: DescriptionDiffEntry[] = [];
+  for (let i = 0; i < maxLen; i++) {
+    const oldBlock = oldBlocks[i] ?? "";
+    const newBlock = newBlocks[i] ?? "";
+    if (oldBlock !== newBlock) {
+      const onlyStyle =
+        normalizeBlockText(oldBlock) !== "" &&
+        normalizeBlockText(oldBlock) === normalizeBlockText(newBlock);
+      if (!onlyStyle) {
+        result.push({ oldValue: oldBlock, newValue: newBlock });
+      }
+    }
+  }
+  return result;
+}

package/src/lib/tag-colors.ts

@@ -0,0 +1 @@
+export * from '@allbluecn/shared/lib/tag-colors'

package/src/lib/time-format.ts

@@ -0,0 +1 @@
+export * from '@allbluecn/shared/lib/time-format'

package/src/lib/utils.ts

@@ -0,0 +1,18 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+export { cn } from '@allbluecn/ui/utils'

package/src/lib/vector-store/__tests__/factory.test.ts

@@ -0,0 +1,59 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { getVectorStore, _setVectorStoreForTest } from "../index";
+import { pgVectorStore } from "../pg-vector-store";
+import { sqliteVecStore } from "../sqlite-vec-store";
+
+describe("getVectorStore 工厂", () => {
+  beforeEach(() => {
+    _setVectorStoreForTest(null);
+    delete process.env.VECTOR_BACKEND;
+  });
+  afterEach(() => {
+    _setVectorStoreForTest(null);
+    delete process.env.VECTOR_BACKEND;
+  });
+
+  it("默认（未设 VECTOR_BACKEND）返回 pgVectorStore", async () => {
+    const store = await getVectorStore();
+    expect(store).toBe(pgVectorStore);
+  });
+
+  it("VECTOR_BACKEND=pgvector 返回 pgVectorStore", async () => {
+    process.env.VECTOR_BACKEND = "pgvector";
+    expect(await getVectorStore()).toBe(pgVectorStore);
+  });
+
+  it("VECTOR_BACKEND=sqlite_vec 动态 import 并返回 sqliteVecStore", async () => {
+    process.env.VECTOR_BACKEND = "sqlite_vec";
+    const store = await getVectorStore();
+    expect(store).toBe(sqliteVecStore);
+  });
+
+  it("缓存实例（第二次返回同一引用）", async () => {
+    const a = await getVectorStore();
+    const b = await getVectorStore();
+    expect(a).toBe(b);
+  });
+
+  it("未知 VECTOR_BACKEND 抛错", async () => {
+    process.env.VECTOR_BACKEND = "unknown_backend";
+    await expect(getVectorStore()).rejects.toMatchObject({ message: expect.stringContaining("未知 VECTOR_BACKEND") });
+  });
+});