@allbluecn/shared 0.2.0

package/src/modules/ai-providers/seed-data.ts

@@ -0,0 +1,222 @@
+// 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/>.
+
+// packages/shared/src/modules/ai-providers/seed-data.ts
+import type { AiProviderMeta } from './types'
+
+/** 10 个最受欢迎 AI 服务商的种子数据，admin 可在其基础上增删改 */
+export const SEED_AI_PROVIDERS: AiProviderMeta[] = [
+  {
+    providerId: 'openai',
+    displayName: 'OpenAI',
+    brandName: 'OpenAI',
+    description: 'GPT 系列模型，业界领先的通用对话与推理能力',
+    category: 'recommended',
+    iconSlug: 'openai',
+    brandColor: '#10A37F',
+    badge: '推荐',
+    adapterKind: 'openai',
+    defaultBaseUrl: 'https://api.openai.com/v1',
+    keyUrl: 'https://platform.openai.com/api-keys',
+    docsUrl: 'https://platform.openai.com/docs',
+    keyPlaceholder: 'sk-...',
+    models: [
+      { id: 'gpt-4o', displayName: 'GPT-4o', contextWindow: 128000, capabilities: ['text', 'vision', 'tools'], defaultEnabled: true },
+      { id: 'gpt-4o-mini', displayName: 'GPT-4o mini', contextWindow: 128000, capabilities: ['text', 'vision', 'tools'], defaultEnabled: true },
+      { id: 'o1', displayName: 'o1', contextWindow: 200000, capabilities: ['text', 'reasoning'] },
+      { id: 'o1-mini', displayName: 'o1-mini', contextWindow: 128000, capabilities: ['text', 'reasoning'] },
+      { id: 'o3-mini', displayName: 'o3-mini', contextWindow: 200000, capabilities: ['text', 'reasoning', 'tools'], defaultEnabled: true },
+    ],
+  },
+  {
+    providerId: 'anthropic',
+    displayName: 'Anthropic',
+    brandName: 'Claude',
+    description: 'Claude 系列模型，擅长长文本理解与代码生成',
+    category: 'recommended',
+    iconSlug: 'anthropic',
+    brandColor: '#D97757',
+    badge: '推荐',
+    adapterKind: 'anthropic',
+    defaultBaseUrl: 'https://api.anthropic.com',
+    keyUrl: 'https://console.anthropic.com/settings/keys',
+    docsUrl: 'https://docs.anthropic.com',
+    keyPlaceholder: 'sk-ant-...',
+    models: [
+      { id: 'claude-sonnet-4-5', displayName: 'Claude Sonnet 4.5', contextWindow: 200000, capabilities: ['text', 'vision', 'tools', 'reasoning'], defaultEnabled: true },
+      { id: 'claude-opus-4-1', displayName: 'Claude Opus 4.1', contextWindow: 200000, capabilities: ['text', 'vision', 'tools', 'reasoning'] },
+      { id: 'claude-haiku-4-5', displayName: 'Claude Haiku 4.5', contextWindow: 200000, capabilities: ['text', 'vision', 'tools'], defaultEnabled: true },
+    ],
+  },
+  {
+    providerId: 'gemini',
+    displayName: 'Google Gemini',
+    brandName: 'Gemini',
+    description: 'Google 推出的多模态大模型，支持文本、图像、视频',
+    category: 'recommended',
+    iconSlug: 'googlegemini',
+    brandColor: '#4285F4',
+    badge: '推荐',
+    adapterKind: 'gemini',
+    defaultBaseUrl: 'https://generativelanguage.googleapis.com',
+    keyUrl: 'https://aistudio.google.com/apikey',
+    docsUrl: 'https://ai.google.dev/gemini-api/docs',
+    keyPlaceholder: 'AIza...',
+    models: [
+      { id: 'gemini-2.5-pro', displayName: 'Gemini 2.5 Pro', contextWindow: 2000000, capabilities: ['text', 'vision', 'tools', 'reasoning'], defaultEnabled: true },
+      { id: 'gemini-2.5-flash', displayName: 'Gemini 2.5 Flash', contextWindow: 1000000, capabilities: ['text', 'vision', 'tools'], defaultEnabled: true },
+    ],
+  },
+  {
+    providerId: 'deepseek',
+    displayName: 'DeepSeek',
+    brandName: 'DeepSeek',
+    description: '国产开源模型，性价比极高，支持推理模式',
+    category: 'popular',
+    iconSlug: 'deepseek',
+    brandColor: '#4D6BFE',
+    badge: '热门',
+    adapterKind: 'openai-compatible',
+    defaultBaseUrl: 'https://api.deepseek.com/v1',
+    keyUrl: 'https://platform.deepseek.com/api_keys',
+    docsUrl: 'https://api-docs.deepseek.com',
+    keyPlaceholder: 'sk-...',
+    models: [
+      { id: 'deepseek-chat', displayName: 'DeepSeek Chat (V3)', contextWindow: 64000, capabilities: ['text', 'tools'], defaultEnabled: true },
+      { id: 'deepseek-reasoner', displayName: 'DeepSeek Reasoner (R1)', contextWindow: 64000, capabilities: ['text', 'reasoning'], defaultEnabled: true },
+    ],
+  },
+  {
+    providerId: 'groq',
+    displayName: 'Groq',
+    brandName: 'Groq',
+    description: '基于 LPU 的极速推理引擎，延迟低至毫秒级',
+    category: 'popular',
+    iconSlug: 'groq',
+    brandColor: '#F55036',
+    badge: '热门',
+    adapterKind: 'groq',
+    defaultBaseUrl: 'https://api.groq.com/openai/v1',
+    keyUrl: 'https://console.groq.com/keys',
+    docsUrl: 'https://console.groq.com/docs',
+    keyPlaceholder: 'gsk_...',
+    models: [
+      { id: 'llama-3.3-70b-versatile', displayName: 'Llama 3.3 70B', contextWindow: 128000, capabilities: ['text', 'tools'], defaultEnabled: true },
+      { id: 'llama-3.1-8b-instant', displayName: 'Llama 3.1 8B Instant', contextWindow: 128000, capabilities: ['text'] },
+    ],
+  },
+  {
+    providerId: 'xai',
+    displayName: 'xAI',
+    brandName: 'Grok',
+    description: 'Elon Musk 的 xAI 推出的 Grok 系列模型',
+    category: 'popular',
+    iconSlug: 'x',
+    brandColor: '#000000',
+    badge: '热门',
+    adapterKind: 'grok',
+    defaultBaseUrl: 'https://api.x.ai',
+    keyUrl: 'https://x.ai/api',
+    docsUrl: 'https://docs.x.ai',
+    keyPlaceholder: 'xai-...',
+    models: [
+      { id: 'grok-4', displayName: 'Grok 4', contextWindow: 256000, capabilities: ['text', 'vision', 'tools', 'reasoning'], defaultEnabled: true },
+      { id: 'grok-3', displayName: 'Grok 3', contextWindow: 131072, capabilities: ['text', 'tools'] },
+    ],
+  },
+  {
+    providerId: 'openrouter',
+    displayName: 'OpenRouter',
+    brandName: 'OpenRouter',
+    description: '聚合 200+ 模型的统一路由，一个 Key 访问所有厂商',
+    category: 'recommended',
+    iconSlug: 'openrouter',
+    brandColor: '#6467F2',
+    badge: '推荐',
+    adapterKind: 'openrouter',
+    defaultBaseUrl: 'https://openrouter.ai/api/v1',
+    keyUrl: 'https://openrouter.ai/keys',
+    docsUrl: 'https://openrouter.ai/docs',
+    keyPlaceholder: 'sk-or-...',
+    models: [
+      { id: 'openai/gpt-4o-mini', displayName: 'GPT-4o mini', contextWindow: 128000, capabilities: ['text', 'vision', 'tools'], defaultEnabled: true },
+      { id: 'openai/gpt-4o', displayName: 'GPT-4o', contextWindow: 128000, capabilities: ['text', 'vision', 'tools'] },
+      { id: 'anthropic/claude-sonnet-4.5', displayName: 'Claude Sonnet 4.5', contextWindow: 200000, capabilities: ['text', 'vision', 'tools', 'reasoning'], defaultEnabled: true },
+      { id: 'google/gemini-2.5-flash', displayName: 'Gemini 2.5 Flash', contextWindow: 1000000, capabilities: ['text', 'vision', 'tools'], defaultEnabled: true },
+      { id: 'deepseek/deepseek-chat', displayName: 'DeepSeek V3', contextWindow: 64000, capabilities: ['text', 'tools'] },
+    ],
+  },
+  {
+    providerId: 'mistral',
+    displayName: 'Mistral AI',
+    brandName: 'Mistral',
+    description: '欧洲开源大模型，擅长多语言与代码',
+    category: 'popular',
+    iconSlug: 'mistralai',
+    brandColor: '#FF7000',
+    badge: '热门',
+    adapterKind: 'openai-compatible',
+    defaultBaseUrl: 'https://api.mistral.ai/v1',
+    keyUrl: 'https://console.mistral.ai/api-keys',
+    docsUrl: 'https://docs.mistral.ai',
+    keyPlaceholder: '...',
+    models: [
+      { id: 'mistral-large-latest', displayName: 'Mistral Large', contextWindow: 128000, capabilities: ['text', 'vision', 'tools'], defaultEnabled: true },
+      { id: 'mistral-small-latest', displayName: 'Mistral Small', contextWindow: 32000, capabilities: ['text', 'tools'], defaultEnabled: true },
+    ],
+  },
+  {
+    providerId: 'moonshot',
+    displayName: 'Moonshot AI',
+    brandName: 'Kimi',
+    description: '月之暗面 Kimi，国产长文本之王',
+    category: 'popular',
+    iconSlug: 'moonshot',
+    brandColor: '#16161A',
+    badge: '热门',
+    adapterKind: 'openai-compatible',
+    defaultBaseUrl: 'https://api.moonshot.cn/v1',
+    keyUrl: 'https://platform.moonshot.cn/console/api-keys',
+    docsUrl: 'https://platform.moonshot.cn/docs',
+    keyPlaceholder: 'sk-...',
+    models: [
+      { id: 'moonshot-v1-128k', displayName: 'Moonshot v1 128K', contextWindow: 128000, capabilities: ['text', 'tools'], defaultEnabled: true },
+      { id: 'kimi-k2-0905-preview', displayName: 'Kimi K2', contextWindow: 128000, capabilities: ['text', 'tools'], defaultEnabled: true },
+    ],
+  },
+  {
+    providerId: 'ollama',
+    displayName: 'Ollama',
+    brandName: 'Ollama',
+    description: '本地部署开源模型，零成本零延迟（需先本地安装 Ollama）',
+    category: 'local',
+    iconSlug: 'ollama',
+    brandColor: '#FFFFFF',
+    badge: '本地',
+    adapterKind: 'ollama',
+    defaultBaseUrl: 'http://localhost:11434',
+    keyUrl: 'https://ollama.com/download',
+    docsUrl: 'https://ollama.com/library',
+    keyPlaceholder: '本地部署无需 API Key',
+    isLocal: true,
+    models: [
+      { id: 'llama3.3', displayName: 'Llama 3.3', contextWindow: 128000, capabilities: ['text', 'tools'], defaultEnabled: true },
+      { id: 'qwen2.5', displayName: 'Qwen 2.5', contextWindow: 128000, capabilities: ['text'], defaultEnabled: true },
+      { id: 'deepseek-r1', displayName: 'DeepSeek R1', contextWindow: 128000, capabilities: ['text', 'reasoning'] },
+    ],
+  },
+]

package/src/modules/ai-providers/types.ts

@@ -0,0 +1,95 @@
+// 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/>.
+
+// packages/shared/src/modules/ai-providers/types.ts
+export type AdapterKind =
+  | 'openai'
+  | 'anthropic'
+  | 'gemini'
+  | 'groq'
+  | 'grok'
+  | 'openrouter'
+  | 'ollama'
+  | 'openai-compatible'
+
+export type ProviderCategory = 'recommended' | 'popular' | 'local'
+
+export type ModelCapability = 'text' | 'vision' | 'tools' | 'reasoning' | 'audio'
+
+export interface AiModelMeta {
+  /** 模型 ID（传给 adapter 的 model 字符串） */
+  id: string
+  /** 显示名 */
+  displayName: string
+  /** 上下文窗口（tokens） */
+  contextWindow?: number
+  /** 能力标签 */
+  capabilities?: ModelCapability[]
+  /** 是否默认勾选 */
+  defaultEnabled?: boolean
+  /** 模型图标 slug（后台配置，@lobehub/icons PascalCase 导出名），未配置时 fallback 到服务商图标 */
+  iconSlug?: string
+  /** 发布日期 YYYY-MM-DD */
+  releaseDate?: string
+  /** 输入价格（$/百万 tokens） */
+  inputPrice?: number
+  /** 输出价格（$/百万 tokens） */
+  outputPrice?: number
+  /** 自定义标签（如「旗舰」「快速」），区别于 capabilities 能力标签 */
+  tags?: string[]
+}
+
+/** 服务商完整元数据（admin 表单 + DB 行 + 前端展示共用） */
+export interface AiProviderMeta {
+  /** 业务标识（"openai" "anthropic" 等），与数据库 providerId 字段对应 */
+  providerId: string
+  displayName: string
+  brandName: string
+  description: string
+  category: ProviderCategory
+  iconSlug: string
+  brandColor: string
+  /** 卡片角标文案（如「推荐」「热门」「NEW」），admin 可配，留空则不显示 */
+  badge?: string
+  adapterKind: AdapterKind
+  defaultBaseUrl?: string
+  keyUrl?: string
+  docsUrl?: string
+  keyPlaceholder?: string
+  isLocal?: boolean
+  models: AiModelMeta[]
+}
+
+/** admin 表格行：DB 行 + 关联用户配置数 */
+export interface AiProviderRow extends AiProviderMeta {
+  /** DB 主键 */
+  id: string
+  enabled: boolean
+  sortOrder: number
+  /** 已配置此服务商的用户数 */
+  configCount: number
+  createdAt: string
+  updatedAt: string
+}
+
+/** 卡片角标的预设颜色（按文案匹配），admin 也可自由输入文案 */
+export const PROVIDER_BADGE_STYLES: Record<string, string> = {
+  推荐: "bg-primary/10 text-primary border-primary/30",
+  热门: "bg-orange-500/10 text-orange-600 dark:text-orange-400 border-orange-500/30",
+  NEW: "bg-emerald-500/10 text-emerald-600 dark:text-emerald-400 border-emerald-500/30",
+  本地: "bg-blue-500/10 text-blue-600 dark:text-blue-400 border-blue-500/30",
+}

package/src/modules/billing/feature-registry.ts

@@ -0,0 +1,63 @@
+// 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 interface FeatureMeta {
+  /** oss = 开源免费；paid = 付费；enterprise = 企业版专属 */
+  tier: 'oss' | 'paid' | 'enterprise'
+  /** 该功能依赖的 proModule 服务名；null = 开源代码自带（仅权益门控） */
+  module:
+    | 'billing'
+    | 'hostedAi'
+    | 'sso'
+    | 'audit'
+    | 'permissions'
+    | 'license'
+    | 'versionHistory'
+    | 'automation'
+    | 'templates'
+    | 'analytics'
+    | 'globalSearch'
+    | 'compliance'
+    | null
+}
+
+export const FeatureRegistry = {
+  byokAi: { tier: 'oss' as const, module: null },
+  hostedAi: { tier: 'paid' as const, module: 'hostedAi' as const },
+  multiProvider: { tier: 'paid' as const, module: null },
+  largePageSize: { tier: 'paid' as const, module: null },
+  versionHistory: { tier: 'paid' as const, module: 'versionHistory' as const },
+  automation: { tier: 'paid' as const, module: 'automation' as const },
+  templates: { tier: 'paid' as const, module: 'templates' as const },
+  globalSearch: { tier: 'paid' as const, module: 'globalSearch' as const },
+  analytics: { tier: 'enterprise' as const, module: 'analytics' as const },
+  sso: { tier: 'enterprise' as const, module: 'sso' as const },
+  audit: { tier: 'enterprise' as const, module: 'audit' as const },
+  advancedPermissions: { tier: 'enterprise' as const, module: 'permissions' as const },
+  compliance: { tier: 'enterprise' as const, module: 'compliance' as const },
+  customAgents: { tier: 'paid' as const, module: null },
+} as const satisfies Record<string, FeatureMeta>
+
+export type FeatureKey = keyof typeof FeatureRegistry
+export const FEATURE_KEYS = Object.keys(FeatureRegistry) as FeatureKey[]
+
+/** OSS 部署（billing 模块缺失）的基础白名单——唯一允许「无订阅即放行」的集合 */
+export const OSS_BASE_FEATURES: readonly FeatureKey[] = ['byokAi', 'customAgents']
+
+export function isOssFeature(key: FeatureKey): boolean {
+  return FeatureRegistry[key].tier === 'oss'
+}

package/src/modules/billing/plan-features-schema.ts

@@ -0,0 +1,11 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import { z } from 'zod'
+import { FEATURE_KEYS, type FeatureKey } from './feature-registry'
+
+export const PlanFeaturesSchema = z.record(
+  z.enum(FEATURE_KEYS as [FeatureKey, ...FeatureKey[]]),
+  z.boolean(),
+)
+
+export type PlanFeatures = z.infer<typeof PlanFeaturesSchema>

package/src/modules/billing/resource-registry.ts

@@ -0,0 +1,80 @@
+// 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 interface ResourceMeta {
+  tier: 'paid' | 'enterprise'
+  unit: string
+  purchasable: boolean | 'custom'
+  step: number
+  /** 降购下限约束：seats 不允许降到当前活跃成员数以下 */
+  floor?: 'activeMembers'
+}
+
+export const ResourceRegistry = {
+  seats: {
+    /** 成员席位池（billing 加购语义不变）；访客池见 guestSeats */
+    tier: 'paid' as const,
+    unit: 'per-seat',
+    purchasable: true,
+    step: 1,
+    floor: 'activeMembers' as const,
+  },
+  guestSeats: {
+    tier: 'paid' as const,
+    unit: 'guest-seats',
+    purchasable: false,
+    step: 1,
+  },
+  aiQuotaMonthly: {
+    tier: 'paid' as const,
+    unit: 'requests/month',
+    purchasable: false,
+    step: 1,
+  },
+  agentQuota: {
+    tier: 'paid' as const,
+    unit: 'agents',
+    purchasable: false,
+    step: 1,
+  },
+  skillQuota: {
+    tier: 'paid' as const,
+    unit: 'skills',
+    purchasable: false,
+    step: 1,
+  },
+  workspaces: {
+    tier: 'paid' as const,
+    unit: 'workspaces',
+    purchasable: false,
+    step: 1,
+  },
+} as const satisfies Record<string, ResourceMeta>
+
+export type ResourceKey = keyof typeof ResourceRegistry
+export const RESOURCE_KEYS = Object.keys(ResourceRegistry) as ResourceKey[]
+
+export interface ResourceSnapshot {
+  limit: number | 'unlimited'
+  usage: number
+}
+
+export type ResourceSnapshots = Record<ResourceKey, ResourceSnapshot>
+
+export function isResourceDefined(key: string): key is ResourceKey {
+  return key in ResourceRegistry
+}

package/src/modules/definitions/plugin.module.ts

@@ -0,0 +1,38 @@
+// 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 { AllBlueModule } from "../../interfaces/module"
+
+export const pluginModule: AllBlueModule = {
+  id: "anyhub",
+  name: "应用市场",
+  icon: "blocks",
+  workspaceRoute: "/apps/anyhub",
+  entities: [
+    {
+      type: "anyhubApp",
+      table: "anyhub_apps",
+      searchFields: ["name", "displayName", "description"],
+      displayFields: ["displayName"],
+    },
+  ],
+  aiCommands: [],
+  referenceDisplay: (type, data) => ({
+    title: (data.displayName as string) || (data.name as string) || "Untitled App",
+    url: `/apps/anyhub`,
+  }),
+}

package/src/modules/definitions/prd.module.ts

@@ -0,0 +1,45 @@
+// 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 { AllBlueModule } from "../../interfaces/module"
+
+export const prdModule: AllBlueModule = {
+  id: "prd",
+  name: "PRD",
+  icon: "file-text",
+  workspaceRoute: "/prd",
+  entities: [
+    {
+      type: "prd_document",
+      table: "prd_documents",
+      searchFields: ["title", "description"],
+      displayFields: ["title", "status"],
+    },
+    {
+      type: "prd_page",
+      table: "prd_pages",
+      searchFields: ["title", "content"],
+      displayFields: ["title"],
+    },
+  ],
+  aiCommands: [],
+  referenceDisplay: (type, data) => ({
+    title: (data.title as string) || "Untitled PRD",
+    status: data.status as string,
+    url: `/prd/${data.id}`,
+  }),
+}

package/src/modules/definitions/prototype.module.ts

@@ -0,0 +1,38 @@
+// 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 { AllBlueModule } from "../../interfaces/module"
+
+export const prototypeModule: AllBlueModule = {
+  id: "prototype",
+  name: "原型",
+  icon: "pen-tool",
+  workspaceRoute: "/plugin-anything",
+  entities: [
+    {
+      type: "prototype_component",
+      table: "plugin_installations",
+      searchFields: ["name", "description"],
+      displayFields: ["name"],
+    },
+  ],
+  aiCommands: [],
+  referenceDisplay: (type, data) => ({
+    title: (data.name as string) || "Untitled Prototype",
+    url: `/plugin-anything`,
+  }),
+}