@liujitcn/kratos-admin-system 0.0.1

package/dist/package/declarations/src/views/tool/code-gen/columns/option-copy.d.ts

@@ -0,0 +1,25 @@
+import type { CodeGenColumnOptionConfig } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/code_gen_column";
+/** 字段选项配置所属范围。 */
+export type CodeGenOptionScope = "query" | "list" | "form";
+/** 单个范围内参与选项复刻的配置。 */
+export interface CodeGenOptionContainer {
+    enabled: boolean;
+    component: string;
+    option: CodeGenColumnOptionConfig;
+}
+/** 查询、列表和表单三范围的选项配置集合。 */
+export interface CodeGenOptionCopyColumn {
+    query_config: CodeGenOptionContainer;
+    list_config: CodeGenOptionContainer;
+    form_config: CodeGenOptionContainer;
+}
+/** 返回指定范围的选项配置容器。 */
+export declare function getCodeGenOptionContainer(column: CodeGenOptionCopyColumn, scope: CodeGenOptionScope): CodeGenOptionContainer;
+/** 判断选项配置是否满足当前保存规则并可作为复刻来源。 */
+export declare function isCompleteCodeGenOptionConfig(option: CodeGenColumnOptionConfig): boolean;
+/** 从第一个相同组件的完整范围复刻选项配置。 */
+export declare function copyFirstMatchingCodeGenOption(column: CodeGenOptionCopyColumn, targetScope: CodeGenOptionScope): boolean;
+/** 用当前范围补齐相同组件中尚未完整配置的其他范围。 */
+export declare function copyCodeGenOptionToEmptyMatches(column: CodeGenOptionCopyColumn, sourceScope: CodeGenOptionScope): CodeGenOptionScope[];
+/** 页面加载时按固定优先级补齐相同组件的空配置。 */
+export declare function fillMissingCodeGenOptionConfigs(column: CodeGenOptionCopyColumn): CodeGenOptionScope[];

package/dist/package/declarations/src/views/tool/code-gen/components/CodeGenProgressDialog.vue.d.ts

@@ -0,0 +1,16 @@
+/** 代码生成进度弹窗属性。 */
+type __VLS_Props = {
+    modelValue: boolean;
+    taskId: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: boolean) => any;
+    completed: () => any;
+    unavailable: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+    onCompleted?: (() => any) | undefined;
+    onUnavailable?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/package/declarations/src/views/tool/code-gen/components/CodePreviewPane.vue.d.ts

@@ -0,0 +1,9 @@
+import type { CodeGenPreviewFile } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/code_gen";
+/** 代码预览面板属性。 */
+type __VLS_Props = {
+    files: CodeGenPreviewFile[];
+    loading: boolean;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/package/declarations/src/views/tool/code-gen/config.d.ts

@@ -0,0 +1,32 @@
+import type { FormRules } from "element-plus";
+import type { ProFormOption } from "@liujitcn/kratos-admin-core/components/ProForm/interface";
+import type { CodeGenColumnFormConfig, CodeGenColumnListConfig, CodeGenColumnOptionConfig, CodeGenColumnQueryConfig } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/code_gen_column";
+import type { CodeGenLeftTreeConfig, CodeGenTableForm } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/code_gen_table";
+/** 代码生成表配置页面类型选项。 */
+export declare const codeGenPageTypeOptions: ProFormOption[];
+/** 判断页面类型是否使用树形表格配置。 */
+export declare function isCodeGenTreePageType(pageType?: string): pageType is "tree" | "tree_lazy";
+/** 左树数据源类型选项。 */
+export declare const codeGenSourceTypeOptions: ProFormOption[];
+/** 查询操作符选项。 */
+export declare const codeGenQueryOperatorOptions: ProFormOption[];
+/** 查询组件选项。 */
+export declare const codeGenQueryComponentOptions: ProFormOption[];
+/** 列表展示组件选项。 */
+export declare const codeGenListComponentOptions: ProFormOption[];
+/** 表单录入组件选项，保持与 ProForm 支持类型完整一致。 */
+export declare const codeGenFormComponentOptions: ProFormOption[];
+/** 代码生成表配置校验规则。 */
+export declare const codeGenTableRules: FormRules;
+/** 创建默认左树右表页面配置。 */
+export declare function createDefaultCodeGenLeftTreeConfig(): CodeGenLeftTreeConfig;
+/** 创建代码生成表配置默认表单。 */
+export declare function createDefaultCodeGenTableForm(): CodeGenTableForm;
+/** 创建默认字段查询配置。 */
+export declare function createDefaultCodeGenQueryConfig(): CodeGenColumnQueryConfig;
+/** 创建默认字段列表配置。 */
+export declare function createDefaultCodeGenListConfig(): CodeGenColumnListConfig;
+/** 创建默认字段表单配置。 */
+export declare function createDefaultCodeGenFormConfig(): CodeGenColumnFormConfig;
+/** 创建一份独立的字段选项配置。 */
+export declare function createDefaultCodeGenOptionConfig(): CodeGenColumnOptionConfig;

package/dist/package/declarations/src/views/tool/code-gen/preview/capabilities.d.ts

@@ -0,0 +1,20 @@
+/** 预览能力判断所需的 Proto 检查项。 */
+export interface CodeGenPreviewProtoCheck {
+    /** Proto 方法名。 */
+    method_name: string;
+    /** 接口是否已经存在。 */
+    exists: boolean;
+    /** 接口缺失时是否已选择生成。 */
+    generate_when_missing: boolean;
+}
+/** 代码生成页面预览支持的维护能力。 */
+export interface CodeGenPreviewCapabilities {
+    /** 是否支持新增。 */
+    create: boolean;
+    /** 是否支持更新。 */
+    update: boolean;
+    /** 是否支持删除。 */
+    delete: boolean;
+}
+/** 根据当前实体可用的 Proto 方法解析预览维护能力。 */
+export declare function resolveCodeGenPreviewCapabilities(entityName: string, protoChecks: CodeGenPreviewProtoCheck[]): CodeGenPreviewCapabilities;

package/dist/package/declarations/src/views/tool/code-gen/preview/data.d.ts

@@ -0,0 +1,42 @@
+import type { ProFormOption } from "@liujitcn/kratos-admin-core/components/ProForm/interface";
+import type { OptionBaseDictResponse_BaseDict } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_dict";
+import type { CodeGenColumn } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/code_gen_column";
+import type { CodeGenLeftTreeConfig, CodeGenTableForm } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/code_gen_table";
+/** 页面预览中的字段配置范围。 */
+export type CodeGenPreviewScope = "query" | "list" | "form";
+/** 页面预览模拟记录。 */
+export type CodeGenPreviewRow = Record<string, any> & {
+    /** 树形表格子记录。 */
+    children?: CodeGenPreviewRow[];
+    /** 树形懒加载表格是否存在子记录。 */
+    has_children?: boolean;
+};
+/** 代码生成页面预览快照。 */
+export interface CodeGenPagePreviewSnapshot {
+    /** 当前代码生成表配置。 */
+    table: CodeGenTableForm;
+    /** 当前已经保存的字段配置。 */
+    columns: CodeGenColumn[];
+}
+/** 页面预览中按字段和范围隔离的模拟选项。 */
+export type CodeGenPreviewOptionMap = Record<string, ProFormOption[]>;
+/** 创建字段指定配置范围的预览选项缓存键。 */
+export declare function createCodeGenPreviewOptionKey(columnName: string, scope: CodeGenPreviewScope): string;
+/** 根据当前字段配置和字典数据创建查询、列表和表单各自的模拟选项。 */
+export declare function createCodeGenPreviewOptionMap(columns: CodeGenColumn[], dictionaries: OptionBaseDictResponse_BaseDict[]): CodeGenPreviewOptionMap;
+/** 根据左树配置创建结构相符的模拟树节点。 */
+export declare function createCodeGenLeftTreeOptions(config?: CodeGenLeftTreeConfig): ProFormOption[];
+/** 创建页面列表所需的模拟业务记录。 */
+export declare function createCodeGenPreviewRows(snapshot: CodeGenPagePreviewSnapshot, optionMap: CodeGenPreviewOptionMap, leftTreeOptions: ProFormOption[]): CodeGenPreviewRow[];
+/** 按查询配置过滤页面模拟记录。 */
+export declare function filterCodeGenPreviewRows(rows: CodeGenPreviewRow[], columns: CodeGenColumn[], params: Record<string, any>): CodeGenPreviewRow[];
+/** 将扁平模拟记录转换成 Element Plus 表格树。 */
+export declare function buildCodeGenPreviewTree(rows: CodeGenPreviewRow[], primaryColumn: string, parentColumn: string): CodeGenPreviewRow[];
+/** 将树形选项扁平化，供模拟记录赋值和标签匹配使用。 */
+export declare function flattenCodeGenPreviewOptions(options: ProFormOption[]): ProFormOption[];
+/** 返回当前表的真实主键字段，缺少主键时使用预览内部编号。 */
+export declare function resolveCodeGenPrimaryColumn(columns: CodeGenColumn[]): string;
+/** 返回指定字段范围的模拟选项。 */
+export declare function resolveCodeGenPreviewOptions(optionMap: CodeGenPreviewOptionMap, columnName: string, scope: CodeGenPreviewScope): ProFormOption[];
+/** 判断字段是否为数值类型。 */
+export declare function isNumericColumn(column: CodeGenColumn): boolean;

package/dist/package/declarations/src/views/tool/code-gen/preview/index.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/package/declarations/src/views/tool/code-gen/proto/index.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/package/declarations/src/views/tool/code-gen/table/index.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/package/declarations/src/views/tool/project-doc/index.vue.d.ts

@@ -0,0 +1,4 @@
+import "x-markdown-vue/style";
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/package/src/ai.ts

@@ -0,0 +1,16 @@
+import type { Component } from "vue";
+import { getAdminModuleExtension } from "@liujitcn/kratos-admin-core";
+
+/** ADMIN_AI_EXTENSION AI 助手扩展名称。 */
+export const ADMIN_AI_EXTENSION = "admin.ai";
+
+/** AdminAiExtension AI 助手可扩展能力。 */
+export interface AdminAiExtension {
+  /** 结构化流程卡片组件。 */
+  flowBlocks?: Component;
+}
+
+/** getAdminAiExtension 获取当前宿主注册的 AI 助手扩展。 */
+export function getAdminAiExtension(): AdminAiExtension {
+  return getAdminModuleExtension<AdminAiExtension>(ADMIN_AI_EXTENSION) ?? {};
+}

package/dist/package/src/api/base/ai_message.ts

@@ -0,0 +1,139 @@
+import service, {
+  getRequestAccessToken,
+  handleAuthExpired,
+  requestBaseURL
+} from "@liujitcn/kratos-admin-core/request";
+import type {
+  ListAiMessageRequest,
+  ListAiMessageResponse
+} from "@liujitcn/kratos-admin-system/rpc/base/v1/ai_session";
+import type {
+  AiMessageService,
+  DeleteAiMessageRequest,
+  DeleteAiMessageResponse,
+  RegenerateAiMessageRequest,
+  RetryAiUserMessageRequest,
+  SendAiMessageRequest,
+  SendAiMessageResponse,
+  UpdateAiMessageRequest
+} from "@liujitcn/kratos-admin-system/rpc/base/v1/ai_message";
+
+const AI_SESSION_URL = "/v1/base/ai/session";
+
+/** direct stream 请求控制选项。 */
+export type AiMessageStreamOptions = {
+  /** 外部取消信号，用于页面卸载或会话删除时终止流式请求。 */
+  signal?: AbortSignal;
+};
+
+/** 从 direct stream 错误响应中提取后端业务提示。 */
+async function resolveStreamErrorMessage(response: Response): Promise<string> {
+  const fallbackMessage = `AI 助手请求失败（${response.status}）`;
+  const contentType = response.headers.get("Content-Type") ?? "";
+  if (contentType.includes("application/json")) {
+    try {
+      const payload = await response.json();
+      return String(payload?.message || payload?.error || fallbackMessage);
+    } catch {
+      return fallbackMessage;
+    }
+  }
+  try {
+    const text = (await response.text()).trim();
+    return text || fallbackMessage;
+  } catch {
+    return fallbackMessage;
+  }
+}
+
+/** 使用 direct stream 发送 AI 助手消息，并返回原始 Fetch Response 供调用方消费。 */
+export async function SendAiMessageStream(request: SendAiMessageRequest, options?: AiMessageStreamOptions): Promise<Response> {
+  const accessToken = await getRequestAccessToken();
+  const headers: Record<string, string> = {
+    Accept: "text/event-stream",
+    "Content-Type": "application/json;charset=utf-8"
+  };
+  if (accessToken) headers.Authorization = accessToken;
+
+  const response = await fetch(`${requestBaseURL}${AI_SESSION_URL}/${request.session_id}/message`, {
+    method: "POST",
+    headers,
+    body: JSON.stringify(request),
+    signal: options?.signal
+  });
+
+  // direct stream 不经过 axios 响应拦截器，需要在这里补齐登录失效处理。
+  if (response.status === 401 || response.status === 403) {
+    handleAuthExpired();
+    throw new Error("登录状态已失效，请重新登录");
+  }
+  if (!response.ok) {
+    throw new Error(await resolveStreamErrorMessage(response));
+  }
+
+  return response;
+}
+
+/** AI 助手消息服务。 */
+export class AiMessageServiceImpl implements AiMessageService {
+  /** 查询 AI 助手消息列表。 */
+  ListAiMessage(request: ListAiMessageRequest): Promise<ListAiMessageResponse> {
+    return service<ListAiMessageRequest, ListAiMessageResponse>({
+      url: `${AI_SESSION_URL}/${request.session_id}/message`,
+      method: "get",
+      params: request
+    });
+  }
+
+  /** 发送 AI 助手消息并等待完整响应。 */
+  SendAiMessage(request: SendAiMessageRequest): Promise<SendAiMessageResponse> {
+    return service<SendAiMessageRequest, SendAiMessageResponse>({
+      url: `${AI_SESSION_URL}/${request.session_id}/message`,
+      method: "post",
+      data: request
+    });
+  }
+
+  /** 删除 AI 助手消息。 */
+  DeleteAiMessage(request: DeleteAiMessageRequest): Promise<DeleteAiMessageResponse> {
+    return service<DeleteAiMessageRequest, DeleteAiMessageResponse>({
+      url: `${AI_SESSION_URL}/${request.session_id}/message/${request.message_id}`,
+      method: "delete",
+      params: request
+    });
+  }
+
+  /** 更新 AI 助手消息文本并重新生成输出。 */
+  UpdateAiMessage(request: UpdateAiMessageRequest): Promise<SendAiMessageResponse> {
+    return service<UpdateAiMessageRequest, SendAiMessageResponse>({
+      url: `${AI_SESSION_URL}/${request.session_id}/message/${request.message_id}`,
+      method: "put",
+      data: request
+    });
+  }
+
+  /** 重试失败的 AI 助手消息。 */
+  RetryAiUserMessage(request: RetryAiUserMessageRequest): Promise<SendAiMessageResponse> {
+    return service<RetryAiUserMessageRequest, SendAiMessageResponse>({
+      url: `${AI_SESSION_URL}/${request.session_id}/message/${request.message_id}/retry`,
+      method: "post",
+      data: request
+    });
+  }
+
+  /** 重新生成 AI 助手输出。 */
+  RegenerateAiMessage(request: RegenerateAiMessageRequest): Promise<SendAiMessageResponse> {
+    return service<RegenerateAiMessageRequest, SendAiMessageResponse>({
+      url: `${AI_SESSION_URL}/${request.session_id}/message/${request.message_id}/regeneration`,
+      method: "post",
+      data: request
+    });
+  }
+
+  /** 使用 direct stream 发送 AI 助手消息，并返回原始 Fetch Response 供调用方消费。 */
+  async StreamAiMessage(request: SendAiMessageRequest, options?: AiMessageStreamOptions): Promise<Response> {
+    return SendAiMessageStream(request, options);
+  }
+}
+
+export const defAiMessageService = new AiMessageServiceImpl();

package/dist/package/src/api/base/ai_session.ts

@@ -0,0 +1,77 @@
+import service from "@liujitcn/kratos-admin-core/request";
+import type {
+  AiSessionService,
+  CreateAiSessionBranchRequest,
+  CreateAiSessionBranchResponse,
+  CreateAiSessionRequest,
+  CreateAiSessionResponse,
+  DeleteAiSessionRequest,
+  DeleteAiSessionResponse,
+  ListAiMessageRequest,
+  ListAiMessageResponse,
+  ListAiSessionRequest,
+  ListAiSessionResponse,
+  UpdateAiSessionRequest,
+  UpdateAiSessionResponse
+} from "@liujitcn/kratos-admin-system/rpc/base/v1/ai_session";
+
+const AI_SESSION_URL = "/v1/base/ai/session";
+
+/** AI 助手会话服务。 */
+export class AiSessionServiceImpl implements AiSessionService {
+  /** 查询 AI 助手会话列表。 */
+  ListAiSession(request: ListAiSessionRequest): Promise<ListAiSessionResponse> {
+    return service<ListAiSessionRequest, ListAiSessionResponse>({
+      url: `${AI_SESSION_URL}`,
+      method: "get",
+      params: request
+    });
+  }
+
+  /** 创建 AI 助手会话。 */
+  CreateAiSession(request: CreateAiSessionRequest): Promise<CreateAiSessionResponse> {
+    return service<CreateAiSessionRequest, CreateAiSessionResponse>({
+      url: `${AI_SESSION_URL}`,
+      method: "post",
+      data: request
+    });
+  }
+
+  /** 更新 AI 助手会话。 */
+  UpdateAiSession(request: UpdateAiSessionRequest): Promise<UpdateAiSessionResponse> {
+    return service<UpdateAiSessionRequest, UpdateAiSessionResponse>({
+      url: `${AI_SESSION_URL}/${request.id}`,
+      method: "put",
+      data: request
+    });
+  }
+
+  /** 删除 AI 助手会话。 */
+  DeleteAiSession(request: DeleteAiSessionRequest): Promise<DeleteAiSessionResponse> {
+    return service<DeleteAiSessionRequest, DeleteAiSessionResponse>({
+      url: `${AI_SESSION_URL}/${request.id}`,
+      method: "delete",
+      params: request
+    });
+  }
+
+  /** 查询 AI 助手消息列表。 */
+  ListAiMessage(request: ListAiMessageRequest): Promise<ListAiMessageResponse> {
+    return service<ListAiMessageRequest, ListAiMessageResponse>({
+      url: `${AI_SESSION_URL}/${request.session_id}/message`,
+      method: "get",
+      params: request
+    });
+  }
+
+  /** 从指定消息创建 AI 助手分支会话。 */
+  CreateAiSessionBranch(request: CreateAiSessionBranchRequest): Promise<CreateAiSessionBranchResponse> {
+    return service<CreateAiSessionBranchRequest, CreateAiSessionBranchResponse>({
+      url: `${AI_SESSION_URL}/${request.source_session_id}/branch`,
+      method: "post",
+      data: request
+    });
+  }
+}
+
+export const defAiSessionService = new AiSessionServiceImpl();

package/dist/package/src/api/base/ai_tool.ts

@@ -0,0 +1,22 @@
+import service from "@liujitcn/kratos-admin-core/request";
+import type {
+  AiToolService,
+  ListAiShortcutRequest,
+  ListAiShortcutResponse
+} from "@liujitcn/kratos-admin-system/rpc/base/v1/ai_tool";
+
+const AI_SHORTCUT_URL = "/v1/base/ai/shortcut";
+
+/** AI 助手工具服务。 */
+export class AiToolServiceImpl implements AiToolService {
+  /** 查询 AI 助手快捷入口列表。 */
+  ListAiShortcut(request: ListAiShortcutRequest): Promise<ListAiShortcutResponse> {
+    return service<ListAiShortcutRequest, ListAiShortcutResponse>({
+      url: AI_SHORTCUT_URL,
+      method: "get",
+      params: request
+    });
+  }
+}
+
+export const defAiToolService = new AiToolServiceImpl();

package/dist/package/src/api/base/oauth.ts

@@ -0,0 +1,47 @@
+import service from "@liujitcn/kratos-admin-core/request";
+import type {
+  CreateOauthBindingAuthorizationRequest,
+  CreateOauthBindingAuthorizationResponse,
+  ListOauthBindingRequest,
+  ListOauthBindingResponse,
+  UnbindOauthAccountRequest
+} from "@liujitcn/kratos-admin-system/rpc/base/v1/oauth";
+import type { Empty } from "@liujitcn/kratos-admin-system/rpc/google/protobuf/empty";
+
+const OAUTH_BINDING_URL = "/v1/base/oauth/binding";
+const OAUTH_BINDING_AUTHORIZATION_URL = "/v1/base/oauth/binding/authorization";
+
+/** ProfileOauthServiceImpl 个人中心三方账号服务。 */
+export class ProfileOauthServiceImpl {
+  /** 查询个人中心三方账号绑定列表。 */
+  ListOauthBinding(request: ListOauthBindingRequest): Promise<ListOauthBindingResponse> {
+    return service<ListOauthBindingRequest, ListOauthBindingResponse>({
+      url: OAUTH_BINDING_URL,
+      method: "get",
+      params: request
+    });
+  }
+
+  /** 创建个人中心三方账号绑定授权地址。 */
+  CreateOauthBindingAuthorization(
+    request: CreateOauthBindingAuthorizationRequest
+  ): Promise<CreateOauthBindingAuthorizationResponse> {
+    return service<CreateOauthBindingAuthorizationRequest, CreateOauthBindingAuthorizationResponse>({
+      url: OAUTH_BINDING_AUTHORIZATION_URL,
+      method: "post",
+      data: request
+    });
+  }
+
+  /** 解绑个人中心三方账号。 */
+  UnbindOauthAccount(request: UnbindOauthAccountRequest): Promise<Empty> {
+    return service<UnbindOauthAccountRequest, Empty>({
+      url: `${OAUTH_BINDING_URL}/${request.provider}`,
+      method: "delete",
+      params: request
+    });
+  }
+}
+
+/** defProfileOauthService 个人中心三方账号服务实例。 */
+export const defProfileOauthService = new ProfileOauthServiceImpl();

package/dist/package/src/api/base/sse.ts

@@ -0,0 +1,192 @@
+import { EventStreamContentType, fetchEventSource, type EventSourceMessage } from "@microsoft/fetch-event-source";
+import type { SubscribeSseRequest } from "@liujitcn/kratos-admin-system/rpc/base/v1/sse";
+import { getRequestAccessToken, handleAuthExpired } from "@liujitcn/kratos-admin-core/request";
+
+const SSE_URL = "/events";
+
+/** SSE 取消订阅函数。 */
+export type SseStop = () => void;
+
+/** 同一条 SSE 流的共享连接记录。 */
+interface SharedSseConnection {
+  /** 关闭当前 SSE 连接。 */
+  close: () => void;
+  /** 已注册的事件监听器。 */
+  listeners: Map<string, Set<(message: EventSourceMessage) => void>>;
+  /** 当前流上已绑定的事件监听器数量。 */
+  refCount: number;
+}
+
+/** SSE 不可恢复异常。 */
+class SseFatalError extends Error {}
+
+/** SSE 可重试异常。 */
+class SseRetriableError extends Error {}
+
+/** Base SSE 服务。 */
+export class SseServiceImpl {
+  private readonly sharedConnections = new Map<string, SharedSseConnection>();
+
+  /** 创建或复用 SSE 订阅连接。 */
+  SubscribeSse(request: SubscribeSseRequest): SharedSseConnection | null {
+    if (typeof window === "undefined" || typeof AbortController === "undefined") {
+      return null;
+    }
+
+    const url = this.buildSubscribeURL(request);
+    if (!url) {
+      return null;
+    }
+
+    const connectionKey = this.buildConnectionKey(request);
+    const cachedConnection = this.sharedConnections.get(connectionKey);
+    if (cachedConnection) {
+      return cachedConnection;
+    }
+
+    const controller = new AbortController();
+    const listeners = new Map<string, Set<(message: EventSourceMessage) => void>>();
+    const connection: SharedSseConnection = {
+      close: () => controller.abort(),
+      listeners,
+      refCount: 0
+    };
+    this.sharedConnections.set(connectionKey, connection);
+    void this.openFetchEventSource(connectionKey, url, controller, connection);
+    return connection;
+  }
+
+  /** 释放 SSE 共享连接。 */
+  ReleaseSse(request: SubscribeSseRequest) {
+    const connectionKey = this.buildConnectionKey(request);
+    const cachedConnection = this.sharedConnections.get(connectionKey);
+    if (!cachedConnection) {
+      return;
+    }
+    cachedConnection.refCount -= 1;
+    if (cachedConnection.refCount > 0) {
+      return;
+    }
+    cachedConnection.close();
+    this.sharedConnections.delete(connectionKey);
+  }
+
+  /** 构建 SSE 订阅地址。 */
+  private buildSubscribeURL(request: SubscribeSseRequest) {
+    const url = new URL(`${SSE_URL}/${request.stream}`, window.location.origin);
+    if (request.channel_id) {
+      url.searchParams.set("channel_id", request.channel_id);
+    }
+    return url.toString();
+  }
+
+  /** 构建 SSE 共享连接键。 */
+  private buildConnectionKey(request: SubscribeSseRequest) {
+    return `${request.stream}:${request.channel_id ?? ""}`;
+  }
+
+  /** 打开基于 fetch 的 SSE 长连接。 */
+  private async openFetchEventSource(
+    connectionKey: string,
+    url: string,
+    controller: AbortController,
+    connection: SharedSseConnection
+  ) {
+    try {
+      const accessToken = await getRequestAccessToken();
+      if (!accessToken) {
+        this.sharedConnections.delete(connectionKey);
+        return;
+      }
+
+      await fetchEventSource(url, {
+        method: "GET",
+        signal: controller.signal,
+        openWhenHidden: true,
+        headers: {
+          Accept: EventStreamContentType,
+          Authorization: accessToken
+        },
+        async onopen(response) {
+          const contentType = response.headers.get("content-type") ?? "";
+          if (response.ok && contentType.startsWith(EventStreamContentType)) {
+            return;
+          }
+          if (response.status === 401 || response.status === 403) {
+            throw new SseFatalError("SSE 认证已失效");
+          }
+          throw new SseRetriableError(`SSE 连接失败: ${response.status}`);
+        },
+        onmessage: message => {
+          const eventName = message.event || "";
+          if (!eventName) {
+            return;
+          }
+          const eventListeners = connection.listeners.get(eventName);
+          if (!eventListeners || eventListeners.size === 0) {
+            return;
+          }
+          eventListeners.forEach(listener => listener(message));
+        },
+        onclose: () => {
+          throw new SseRetriableError("SSE 连接已关闭");
+        },
+        onerror: error => {
+          if (controller.signal.aborted) {
+            return;
+          }
+          if (error instanceof SseFatalError) {
+            throw error;
+          }
+          return 1000;
+        }
+      });
+    } catch (error) {
+      if (controller.signal.aborted) {
+        return;
+      }
+      // SSE 与常规请求复用同一套登录失效处理，避免页面静默断流后用户无感知。
+      if (error instanceof SseFatalError) {
+        handleAuthExpired();
+      }
+      this.sharedConnections.delete(connectionKey);
+    }
+  }
+}
+
+export const defSseService = new SseServiceImpl();
+
+/** 订阅指定 SSE 事件。 */
+export function subscribeSseEvent<T>(
+  request: SubscribeSseRequest,
+  event: string,
+  parser: (raw: string) => T | null,
+  handler: (payload: T) => void
+): SseStop {
+  const connection = defSseService.SubscribeSse(request);
+  if (!connection) return () => undefined;
+
+  connection.refCount += 1;
+  const eventName = event;
+  let eventListeners = connection.listeners.get(eventName);
+  if (!eventListeners) {
+    eventListeners = new Set();
+    connection.listeners.set(eventName, eventListeners);
+  }
+
+  const listener = (message: EventSourceMessage) => {
+    const payload = parser(message.data);
+    if (!payload) return;
+    handler(payload);
+  };
+  eventListeners.add(listener);
+
+  return () => {
+    const currentListeners = connection.listeners.get(eventName);
+    currentListeners?.delete(listener);
+    if (currentListeners && currentListeners.size === 0) {
+      connection.listeners.delete(eventName);
+    }
+    defSseService.ReleaseSse(request);
+  };
+}