@allbluecn/web-app 0.12.0 → 0.12.3

package/src/server/ai-gateway/__tests__/prompt-registry.test.ts

@@ -0,0 +1,549 @@
+// @vitest-environment node
+// 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, vi, beforeEach, afterEach } from "vitest"
+
+import { readFileSync } from "node:fs"
+import { dirname, resolve } from "node:path"
+import { fileURLToPath } from "node:url"
+
+const SOURCE_DIR = dirname(fileURLToPath(import.meta.url))
+
+const mocks = vi.hoisted(() => {
+  const templateFindUnique = vi.fn()
+  const userFindUnique = vi.fn()
+  return {
+    templateFindUnique,
+    userFindUnique,
+    prisma: {
+      systemPromptTemplate: { findUnique: templateFindUnique },
+      user: { findUnique: userFindUnique },
+    },
+  }
+})
+
+vi.mock("@allbluecn/database", () => ({ prisma: mocks.prisma }))
+
+import {
+  definePromptKey,
+  getBuiltinPrompt,
+  listBuiltinPrompts,
+  resolveSystemPrompt,
+  invalidatePromptCache,
+  UnknownPromptVariableError,
+  PromptKeyNotFoundError,
+} from "../prompts/registry"
+
+beforeEach(() => {
+  vi.clearAllMocks()
+  invalidatePromptCache()
+  mocks.templateFindUnique.mockResolvedValue(null)
+  mocks.userFindUnique.mockResolvedValue(null)
+})
+
+afterEach(() => {
+  vi.restoreAllMocks()
+})
+
+describe("definePromptKey / getBuiltinPrompt / listBuiltinPrompts", () => {
+  it("注册后可取回，未注册返回 undefined", () => {
+    const def = {
+      key: "test.registered",
+      name: "注册样例",
+      sections: [{ id: "s1", order: 1, template: "body" }],
+      variables: [],
+      isProtected: false,
+    }
+    definePromptKey(def)
+
+    expect(getBuiltinPrompt("test.registered")).toEqual(def)
+    expect(getBuiltinPrompt("test.missing")).toBeUndefined()
+    expect(listBuiltinPrompts().some((p) => p.key === "test.registered")).toBe(true)
+  })
+})
+
+describe("分区组装", () => {
+  it("按 order 升序组装，每个分区一个数组元素", async () => {
+    definePromptKey({
+      key: "test.order",
+      name: "排序",
+      sections: [
+        { id: "c", order: 3, template: "third" },
+        { id: "a", order: 1, template: "first" },
+        { id: "b", order: 2, template: "second" },
+      ],
+      variables: [],
+      isProtected: false,
+    })
+
+    await expect(resolveSystemPrompt("test.order", {})).resolves.toEqual([
+      "first",
+      "second",
+      "third",
+    ])
+  })
+
+  it("空分区忠实保留，不做过滤", async () => {
+    definePromptKey({
+      key: "test.empty-section",
+      name: "空分区",
+      sections: [
+        { id: "a", order: 1, template: "keep" },
+        { id: "b", order: 2, template: "" },
+        { id: "c", order: 3, template: "also keep" },
+      ],
+      variables: [],
+      isProtected: false,
+    })
+
+    await expect(resolveSystemPrompt("test.empty-section", {})).resolves.toEqual([
+      "keep",
+      "",
+      "also keep",
+    ])
+  })
+})
+
+describe("变量严格性", () => {
+  it("未知变量抛 UnknownPromptVariableError", async () => {
+    definePromptKey({
+      key: "test.unknown-var",
+      name: "未知变量",
+      sections: [{ id: "a", order: 1, template: "hi {{ghost}}" }],
+      variables: [],
+      isProtected: false,
+    })
+
+    await expect(resolveSystemPrompt("test.unknown-var", {})).rejects.toThrow(
+      UnknownPromptVariableError,
+    )
+    await expect(resolveSystemPrompt("test.unknown-var", {})).rejects.toThrow(
+      /ghost/,
+    )
+  })
+
+  it("非法变量名（含 . 空格 中文）同样抛错，不逃逸严格性", async () => {
+    definePromptKey({
+      key: "test.bad-var-name",
+      name: "非法变量名",
+      sections: [{ id: "a", order: 1, template: "a {{user.name}} b" }],
+      variables: [],
+      isProtected: false,
+    })
+
+    await expect(resolveSystemPrompt("test.bad-var-name", {})).rejects.toThrow(
+      UnknownPromptVariableError,
+    )
+    await expect(resolveSystemPrompt("test.bad-var-name", {})).rejects.toThrow(/user\.name/)
+
+    definePromptKey({
+      key: "test.bad-var-space",
+      name: "空格变量名",
+      sections: [{ id: "a", order: 1, template: "a {{ my var }} b" }],
+      variables: [],
+      isProtected: false,
+    })
+    await expect(resolveSystemPrompt("test.bad-var-space", {})).rejects.toThrow(
+      UnknownPromptVariableError,
+    )
+
+    definePromptKey({
+      key: "test.bad-var-cjk",
+      name: "中文变量名",
+      sections: [{ id: "a", order: 1, template: "a {{用户}} b" }],
+      variables: [],
+      isProtected: false,
+    })
+    await expect(resolveSystemPrompt("test.bad-var-cjk", {})).rejects.toThrow(
+      UnknownPromptVariableError,
+    )
+  })
+
+  it("空变量名 {{ }} 抛错而非原样忽略", async () => {
+    definePromptKey({
+      key: "test.empty-var",
+      name: "空变量名",
+      sections: [{ id: "a", order: 1, template: "a {{ }} b" }],
+      variables: [],
+      isProtected: false,
+    })
+
+    await expect(resolveSystemPrompt("test.empty-var", {})).rejects.toThrow(
+      UnknownPromptVariableError,
+    )
+  })
+
+  it("已声明但调用方未提供同样抛错（声明不等于注入）", async () => {
+    definePromptKey({
+      key: "test.declared-missing",
+      name: "声明缺值",
+      sections: [{ id: "a", order: 1, template: "topic: {{topic}}" }],
+      variables: [{ name: "topic", description: "话题" }],
+      isProtected: false,
+    })
+
+    await expect(resolveSystemPrompt("test.declared-missing", {})).rejects.toThrow(
+      UnknownPromptVariableError,
+    )
+
+    await expect(resolveSystemPrompt("test.declared-missing", { topic: "RAG" })).resolves.toEqual([
+      "topic: RAG",
+    ])
+  })
+
+  it("workspaceName 未提供且模板引用时抛错", async () => {
+    definePromptKey({
+      key: "test.workspace-strict",
+      name: "工作区严格",
+      sections: [{ id: "a", order: 1, template: "{{workspaceName}}" }],
+      variables: [],
+      isProtected: false,
+    })
+
+    await expect(resolveSystemPrompt("test.workspace-strict", {})).rejects.toThrow(
+      UnknownPromptVariableError,
+    )
+    await expect(
+      resolveSystemPrompt("test.workspace-strict", {}, { workspaceName: "蓝湖" }),
+    ).resolves.toEqual(["蓝湖"])
+  })
+
+  it("插值容忍 {{var}} 与 {{ var }} 空白差异", async () => {
+    definePromptKey({
+      key: "test.ws-trim",
+      name: "空白",
+      sections: [{ id: "a", order: 1, template: "{{a}}|{{  b  }}" }],
+      variables: [],
+      isProtected: false,
+    })
+
+    await expect(resolveSystemPrompt("test.ws-trim", { a: "1", b: "2" })).resolves.toEqual(["1|2"])
+  })
+})
+
+describe("内置变量", () => {
+  it("now / locale / userName 自动注入，无需调用方传值", async () => {
+    definePromptKey({
+      key: "test.builtins",
+      name: "内置变量",
+      sections: [{ id: "a", order: 1, template: "{{now}} / {{locale}} / {{userName}}" }],
+      variables: [],
+      isProtected: false,
+    })
+
+    mocks.userFindUnique.mockImplementation(
+      async (args: { where: { id: string } }) =>
+        args.where.id === "u-1" ? { username: "测试用户" } : null,
+    )
+    const withUser = await resolveSystemPrompt("test.builtins", {}, { userId: "u-1" })
+    expect(withUser).toHaveLength(1)
+    expect(withUser[0]).toMatch(/\d{4}-\d{2}-\d{2} \d{4}年\d{1,2}月\d{1,2}日 \/ zh \/ 测试用户$/)
+
+    const noUser = await resolveSystemPrompt("test.builtins", {}, { userId: "u-ghost" })
+    expect(noUser[0]).toMatch(/\/ zh \/ 用户$/)
+  })
+
+  it("userId 缺失时不注入 userName（模板引用则抛错）", async () => {
+    definePromptKey({
+      key: "test.no-userid",
+      name: "无用户",
+      sections: [{ id: "a", order: 1, template: "hi {{userName}}" }],
+      variables: [],
+      isProtected: false,
+    })
+
+    await expect(resolveSystemPrompt("test.no-userid", {})).rejects.toThrow(
+      UnknownPromptVariableError,
+    )
+    expect(mocks.userFindUnique).not.toHaveBeenCalled()
+  })
+
+  it("DB 查询抖动降级为「用户」，不阻断解析", async () => {
+    definePromptKey({
+      key: "test.user-degrade",
+      name: "降级",
+      sections: [{ id: "a", order: 1, template: "hi {{userName}}" }],
+      variables: [],
+      isProtected: false,
+    })
+
+    mocks.userFindUnique.mockRejectedValue(new Error("db down"))
+    const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => {})
+    await expect(resolveSystemPrompt("test.user-degrade", {}, { userId: "u-1" })).resolves.toEqual([
+      "hi 用户",
+    ])
+    expect(warnSpy).toHaveBeenCalledTimes(1)
+    expect(warnSpy.mock.calls[0]?.join(" ")).toContain("u-1")
+    expect(warnSpy.mock.calls[0]?.join(" ")).toContain("db down")
+  })
+})
+
+describe("DB 优先与兜底", () => {
+  it("DB active 模板优先于内置兜底", async () => {
+    definePromptKey({
+      key: "test.db-wins",
+      name: "DB 优先",
+      sections: [{ id: "b", order: 1, template: "builtin body" }],
+      variables: [],
+      isProtected: false,
+    })
+    mocks.templateFindUnique.mockResolvedValue({
+      isActive: true,
+      sections: [
+        { id: "d2", order: 2, template: "db second" },
+        { id: "d1", order: 1, template: "db first" },
+      ],
+    })
+
+    await expect(resolveSystemPrompt("test.db-wins", {})).resolves.toEqual([
+      "db first",
+      "db second",
+    ])
+  })
+
+  it("DB 行存在但 isActive=false 回落内置", async () => {
+    definePromptKey({
+      key: "test.db-inactive",
+      name: "停用回落",
+      sections: [{ id: "b", order: 1, template: "builtin body" }],
+      variables: [],
+      isProtected: false,
+    })
+    mocks.templateFindUnique.mockResolvedValue({
+      isActive: false,
+      sections: [{ id: "d", order: 1, template: "db body" }],
+    })
+
+    await expect(resolveSystemPrompt("test.db-inactive", {})).resolves.toEqual(["builtin body"])
+  })
+
+  it("key 完全未知抛 PromptKeyNotFoundError 且消息含 key", async () => {
+    await expect(resolveSystemPrompt("test.never-registered", {})).rejects.toThrow(
+      PromptKeyNotFoundError,
+    )
+    await expect(resolveSystemPrompt("test.never-registered", {})).rejects.toThrow(
+      /test\.never-registered/,
+    )
+  })
+
+  it("sections 部分坏行只丢坏行且打 warn，不回落内置", async () => {
+    definePromptKey({
+      key: "test.bad-rows",
+      name: "坏行",
+      sections: [{ id: "b", order: 1, template: "builtin body" }],
+      variables: [],
+      isProtected: false,
+    })
+    mocks.templateFindUnique.mockResolvedValue({
+      isActive: true,
+      sections: [
+        { id: "d1", order: 1, template: "db keep" },
+        { id: "bad", order: "1", template: "db bad order" },
+        { id: "d3", order: 3, template: "db keep 3" },
+      ],
+    })
+    const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => {})
+
+    await expect(resolveSystemPrompt("test.bad-rows", {})).resolves.toEqual([
+      "db keep",
+      "db keep 3",
+    ])
+    expect(warnSpy).toHaveBeenCalledTimes(1)
+    expect(warnSpy.mock.calls[0]?.join(" ")).toContain("test.bad-rows")
+  })
+
+  it("isActive 但 sections 为空数组回落内置（@default([]) 真实创建路径）", async () => {
+    definePromptKey({
+      key: "test.empty-db",
+      name: "空 DB",
+      sections: [{ id: "b", order: 1, template: "builtin body" }],
+      variables: [],
+      isProtected: false,
+    })
+    mocks.templateFindUnique.mockResolvedValue({ isActive: true, sections: [] })
+    const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => {})
+
+    await expect(resolveSystemPrompt("test.empty-db", {})).resolves.toEqual(["builtin body"])
+    expect(warnSpy).not.toHaveBeenCalled()
+  })
+
+  it("sections 为 null 或非数组回落内置，不抛错", async () => {
+    for (const key of ["test.null-db", "test.nonarray-db"]) {
+      definePromptKey({
+        key,
+        name: "空值 DB",
+        sections: [{ id: "b", order: 1, template: "builtin body" }],
+        variables: [],
+        isProtected: false,
+      })
+    }
+    const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => {})
+
+    mocks.templateFindUnique.mockResolvedValue({ isActive: true, sections: null })
+    await expect(resolveSystemPrompt("test.null-db", {})).resolves.toEqual(["builtin body"])
+
+    mocks.templateFindUnique.mockResolvedValue({
+      isActive: true,
+      sections: "not-an-array",
+    })
+    await expect(resolveSystemPrompt("test.nonarray-db", {})).resolves.toEqual(["builtin body"])
+
+    expect(warnSpy).not.toHaveBeenCalled()
+  })
+})
+
+describe("60s LRU 缓存", () => {
+  it("同 key 连续两次只查一次 DB，定向失效后重查", async () => {
+    definePromptKey({
+      key: "test.cache",
+      name: "缓存",
+      sections: [{ id: "a", order: 1, template: "cached body" }],
+      variables: [],
+      isProtected: false,
+    })
+    mocks.templateFindUnique.mockResolvedValue({
+      isActive: true,
+      sections: [{ id: "d", order: 1, template: "db body" }],
+    })
+
+    const first = await resolveSystemPrompt("test.cache", {})
+    const second = await resolveSystemPrompt("test.cache", {})
+    expect(first).toEqual(["db body"])
+    expect(second).toEqual(["db body"])
+    expect(mocks.templateFindUnique).toHaveBeenCalledTimes(1)
+
+    invalidatePromptCache("test.cache")
+    await resolveSystemPrompt("test.cache", {})
+    expect(mocks.templateFindUnique).toHaveBeenCalledTimes(2)
+  })
+
+  it("invalidatePromptCache() 无参清空全部", async () => {
+    definePromptKey({
+      key: "test.cache-all",
+      name: "全清",
+      sections: [{ id: "a", order: 1, template: "body" }],
+      variables: [],
+      isProtected: false,
+    })
+
+    await resolveSystemPrompt("test.cache-all", {})
+    expect(mocks.templateFindUnique).toHaveBeenCalledTimes(1)
+
+    invalidatePromptCache("test.nonexistent")
+    await resolveSystemPrompt("test.cache-all", {})
+    expect(mocks.templateFindUnique).toHaveBeenCalledTimes(1)
+
+    invalidatePromptCache()
+    await resolveSystemPrompt("test.cache-all", {})
+    expect(mocks.templateFindUnique).toHaveBeenCalledTimes(2)
+  })
+})
+
+
+describe("DB 分区清洗与内置回落（默认提示词不能为空）", () => {
+  function register(key: string, body = "builtin body") {
+    definePromptKey({
+      key,
+      name: key,
+      sections: [{ id: "b", order: 1, template: body }],
+      variables: [],
+      isProtected: false,
+    })
+  }
+
+  it("template 为纯空白/空串的分区按非法行丢弃，保留有效分区", async () => {
+    register("test.blank-rows")
+    mocks.templateFindUnique.mockResolvedValue({
+      isActive: true,
+      sections: [
+        { id: "a", order: 1, template: "db keep" },
+        { id: "blank", order: 2, template: "   " },
+        { id: "empty", order: 3, template: "" },
+        { id: "tab", order: 4, template: "\t\n" },
+        { id: "c", order: 5, template: "db keep 5" },
+      ],
+    })
+    const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => {})
+
+    await expect(resolveSystemPrompt("test.blank-rows", {})).resolves.toEqual([
+      "db keep",
+      "db keep 5",
+    ])
+    expect(warnSpy).toHaveBeenCalledTimes(1)
+    expect(warnSpy.mock.calls[0]?.join(" ")).toContain("template 空白")
+  })
+
+  it("DB 分区全为空白 → 回落代码内置默认，绝不返回空数组", async () => {
+    register("test.all-blank", "builtin non-empty")
+    mocks.templateFindUnique.mockResolvedValue({
+      isActive: true,
+      sections: [
+        { id: "a", order: 1, template: "   " },
+        { id: "b", order: 2, template: "" },
+      ],
+    })
+
+    await expect(resolveSystemPrompt("test.all-blank", {})).resolves.toEqual([
+      "builtin non-empty",
+    ])
+    // 回落路径不重复打 warn（parseSections 已打过一次）
+    await expect(resolveSystemPrompt("test.all-blank", {})).resolves.toEqual([
+      "builtin non-empty",
+    ])
+  })
+
+  it("空白分区被丢弃后仍剩有效分区时不回落内置", async () => {
+    register("test.partial-blank")
+    mocks.templateFindUnique.mockResolvedValue({
+      isActive: true,
+      sections: [
+        { id: "a", order: 1, template: "   " },
+        { id: "b", order: 2, template: "db only" },
+      ],
+    })
+
+    await expect(resolveSystemPrompt("test.partial-blank", {})).resolves.toEqual([
+      "db only",
+    ])
+  })
+
+  it("DB 分区 id 为空串的同样按非法行丢弃", async () => {
+    register("test.blank-id", "builtin body 2")
+    mocks.templateFindUnique.mockResolvedValue({
+      isActive: true,
+      sections: [
+        { id: "", order: 1, template: "should be dropped" },
+        { id: "b", order: 2, template: "kept" },
+      ],
+    })
+
+    await expect(resolveSystemPrompt("test.blank-id", {})).resolves.toEqual(["kept"])
+  })
+})
+describe("插值单一来源（DRY 哨兵）", () => {
+  it("registry 不自定义插值正则，直接复用 kernel 的 interpolateTemplate", () => {
+    const source = readFileSync(
+      resolve(SOURCE_DIR, "../prompts/registry.ts"),
+      "utf-8",
+    )
+    expect(source).toContain("interpolateTemplate(")
+    // 若这里再定义 TEMPLATE_VAR_RE / VALID_VAR_NAME_RE，说明插值规则又长出了
+    // 第二份实现（kernel 的 interpolateTemplate 才是单一来源，admin preview 也在用）。
+    expect(source).not.toMatch(/const\s+(TEMPLATE_VAR_RE|VALID_VAR_NAME_RE)\s*=/)
+  })
+})

package/src/server/ai-gateway/__tests__/prompt-vars-contract.test.ts

@@ -0,0 +1,146 @@
+// @vitest-environment node
+// 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, vi, beforeEach } from "vitest"
+
+vi.mock("@allbluecn/database", () => ({
+  prisma: { systemPromptTemplate: { findUnique: vi.fn() } },
+}))
+vi.mock("../unified-router", () => ({ resolveUnifiedAiRoute: vi.fn() }))
+vi.mock("../provider-router", () => ({
+  resolveAiConfigForModel: vi.fn(),
+  resolveDefaultProviderConfig: vi.fn(),
+}))
+vi.mock("../runtime", () => ({ getPorts: vi.fn(() => ({})) }))
+vi.mock("../provider-tools", () => ({ hasNativeWebSearch: vi.fn(() => false) }))
+vi.mock("@/server/serverFns/web-search", () => ({
+  isSearxngEnabled: vi.fn(() => false),
+}))
+
+import { prisma } from "@allbluecn/database"
+import "../prompts/builtin"
+import { getBuiltinPrompt, resolveSystemPrompt, resolveSystemPromptSections } from "../prompts/registry"
+import { filterWebSearchSections } from "../chat-handler"
+
+beforeEach(() => {
+  vi.mocked(prisma.systemPromptTemplate.findUnique).mockResolvedValue(null as never)
+})
+
+describe("业务收编 key 的 vars 契约（防 UnknownPromptVariableError）", () => {
+  it.each([
+    ["prd.prototype", { catalog: "可用组件库：\n- type: button | 名称: 按钮" }],
+    ["tiptap.improve", { actionInstruction: "提升清晰度", userInstruction: "更简洁" }],
+    ["translation.run", { from: "中文", to: "English" }],
+    ["story.polish", { polishInstruction: "扩写现有需求描述。" }],
+    ["kb.context-fence", { fencedChunks: "<user_data>x</user_data>" }],
+    [
+      "chat.web-search-inject",
+      { date: "2026年9月15日", fencedResults: "<user_data>x</user_data>" },
+    ],
+    ["story.label-suggest", { availableLabels: "性能、安全" }],
+    [
+      "story.generate",
+      {
+        taskTypeInstruction: "基于需求生成。",
+        labelHint: "不要输出 labelNames 字段",
+        parentStoryHint: "",
+        requirement: '<user_data name="需求">x</user_data>',
+      },
+    ],
+  ])("%s 的调用方 vars 与模板变量声明完全匹配", async (key, vars) => {
+    const sections = await resolveSystemPrompt(key, vars)
+    expect(sections).toHaveLength(getBuiltinPrompt(key)!.sections.length)
+    expect(sections.join("\n")).not.toContain("{{")
+  })
+})
+
+describe("可选分区的空串形态（调用方必须 filter(Boolean)）", () => {
+  it("tiptap.improve 空 userInstruction 渲染为空分区", async () => {
+    const sections = await resolveSystemPrompt("tiptap.improve", {
+      actionInstruction: "提升清晰度",
+      userInstruction: "",
+    })
+    expect(sections).toContain("")
+    expect(sections.filter(Boolean)).toHaveLength(2)
+  })
+
+  it("story.generate 空 parentStoryHint 渲染为空分区", async () => {
+    const sections = await resolveSystemPrompt("story.generate", {
+      taskTypeInstruction: "基于需求生成。",
+      labelHint: "不要输出 labelNames 字段",
+      parentStoryHint: "",
+      requirement: "需求围栏",
+    })
+    expect(sections).toContain("")
+    expect(sections.filter(Boolean)).toHaveLength(3)
+  })
+})
+
+describe("chat.web-search-inject 空结果过滤（chat-handler 预搜索注入依赖）", () => {
+  const dateStr = "2026年9月15日"
+
+  it("有结果：4 个分区全部保留", async () => {
+    const sections = await resolveSystemPromptSections("chat.web-search-inject", {
+      date: dateStr,
+      fencedResults: "<user_data>x</user_data>",
+    })
+    expect(sections.map((s) => s.id)).toEqual([
+      "date",
+      "results-header",
+      "results",
+      "date-emphasis",
+    ])
+    expect(filterWebSearchSections(sections, true)).toHaveLength(4)
+  })
+
+  it("无结果：results 分区为空串被剔除，孤儿结果标题按 id 剔除", async () => {
+    const sections = await resolveSystemPromptSections("chat.web-search-inject", {
+      date: dateStr,
+      fencedResults: "",
+    })
+    expect(sections).toHaveLength(4)
+    expect(sections[2].id).toBe("results")
+    expect(sections[2].text).toBe("")
+    const kept = filterWebSearchSections(sections, false)
+    expect(kept).toHaveLength(2)
+    expect(kept.every((s) => s.includes(dateStr))).toBe(true)
+    expect(kept.some((s) => s.includes("联网搜索结果"))).toBe(false)
+  })
+
+  it("admin 改文案（isProtected: false）后按 id 过滤仍生效", () => {
+    const sections = [
+      { id: "date", order: 1, text: "今天是 2026年9月15日" },
+      { id: "results-header", order: 2, text: "这是改过文案的结果标题" },
+      { id: "results", order: 3, text: "<user_data>x</user_data>" },
+      { id: "date-emphasis", order: 4, text: "请基于搜索结果回答" },
+    ]
+    expect(filterWebSearchSections(sections, false)).toEqual([
+      "今天是 2026年9月15日",
+      "请基于搜索结果回答",
+    ])
+  })
+
+  it("结果 id 被改名后过滤失效 —— 已知取舍，需在汇报中标注", () => {
+    const sections = [
+      { id: "date", order: 1, text: "今天是 2026年9月15日" },
+      { id: "search-results", order: 2, text: "结果标题（id 已改名）" },
+      { id: "renamed", order: 3, text: "<user_data>x</user_data>" },
+    ]
+    expect(filterWebSearchSections(sections, false)).toHaveLength(3)
+  })
+})