@liujitcn/kratos-admin-system 0.0.50 → 0.0.52

package/dist/package/src/components/tenant-project/tenant-project-manager-data.ts

@@ -1,5 +1,11 @@
 import type { BaseTenantProject } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_tenant_project";
 
+/** 租户项目表格列的最小结构，用于在不依赖表格组件的情况下排列扩展列。 */
+type TenantProjectColumnLike = {
+  prop?: string;
+  type?: string;
+};
+
 /** 租户项目业务数据查询键。 */
 export interface TenantProjectKey {
   /** 租户 ID。 */
@@ -11,13 +17,45 @@ export interface TenantProjectKey {
 /** 租户项目扩展数据，外层键由租户 ID 和项目 ID 组成。 */
 export type TenantProjectExtraData = Record<string, Record<string, unknown>>;
 
+/** 按基础字段位置排列租户项目管理的扩展列。 */
+export function arrangeTenantProjectColumns<T extends TenantProjectColumnLike>(
+  baseColumns: T[],
+  extraColumns: Array<T & { after?: string }>
+): T[] {
+  const baseKeys = new Set(baseColumns.map(column => column.prop ?? column.type));
+  const extrasByAnchor = new Map<string | undefined, T[]>();
+  for (const extraColumn of extraColumns) {
+    const { after, ...column } = extraColumn;
+    const anchor = after && baseKeys.has(after) ? after : "remark";
+    const columns = extrasByAnchor.get(anchor) ?? [];
+    columns.push(column as T);
+    extrasByAnchor.set(anchor, columns);
+  }
+
+  const result: T[] = [];
+  for (const baseColumn of baseColumns) {
+    result.push(baseColumn);
+    const anchor = baseColumn.prop ?? baseColumn.type;
+    const columns = extrasByAnchor.get(anchor);
+    if (!columns) continue;
+    result.push(...columns);
+    extrasByAnchor.delete(anchor);
+  }
+  const remaining: T[] = [];
+  for (const columns of extrasByAnchor.values()) remaining.push(...columns);
+  return [...result, ...remaining];
+}
+
 /** 创建租户项目扩展数据的稳定键。 */
 export function tenantProjectKey(tenantId: number, projectId: number): string {
   return `${tenantId}:${projectId}`;
 }
 
 /** 将外部业务字段合并到项目行，同时保护公共项目字段。 */
-export function mergeTenantProjectExtraData(project: BaseTenantProject, extra?: Record<string, unknown>): BaseTenantProject & Record<string, unknown> {
+export function mergeTenantProjectExtraData(
+  project: BaseTenantProject,
+  extra?: Record<string, unknown>
+): BaseTenantProject & Record<string, unknown> {
   if (!extra) return { ...project } as BaseTenantProject & Record<string, unknown>;
 
   const protectedFields = new Set(["id", "tenant_id", "code", "name", "status", "sort", "remark", "created_at", "updated_at"]);

package/dist/package/src/components/tenant-project/tenant-project-manager.ts

@@ -1,8 +1,17 @@
-import type { BaseTenantProject, PageBaseTenantProjectRequest } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_tenant_project";
+import type {
+  BaseTenantProject,
+  PageBaseTenantProjectRequest
+} from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_tenant_project";
 import type { ColumnProps, TableActionProps } from "@liujitcn/kratos-admin-core/components/ProTable/interface";
 import type { TenantProjectExtraData, TenantProjectKey } from "./tenant-project-manager-data";
 
-export { mergeTenantProjectExtraData, tenantProjectKey, type TenantProjectExtraData, type TenantProjectKey } from "./tenant-project-manager-data";
+export {
+  arrangeTenantProjectColumns,
+  mergeTenantProjectExtraData,
+  tenantProjectKey,
+  type TenantProjectExtraData,
+  type TenantProjectKey
+} from "./tenant-project-manager-data";
 
 /** 租户项目单条业务上下文。 */
 export interface TenantProjectContext<TData extends Record<string, unknown> = Record<string, unknown>> extends TenantProjectKey {
@@ -37,10 +46,16 @@ export type TenantProjectAction = Omit<TableActionProps, "disabled" | "hidden" |
   onClick: (context: TenantProjectContext, params?: Record<string, any>) => void | Promise<void>;
 };
 
+/** 租户项目管理的扩展列配置。 */
+export type TenantProjectExtraColumn = ColumnProps & {
+  /** 插入到指定基础字段后面，未配置时默认插入备注字段后面。 */
+  after?: string;
+};
+
 /** 租户项目管理组件属性。 */
 export interface TenantProjectManagerProps {
-  /** 追加到基础列表的表格列。 */
-  extraColumns?: ColumnProps[];
+  /** 追加到基础列表的表格列，可通过 after 指定插入位置。 */
+  extraColumns?: TenantProjectExtraColumn[];
   /** 追加到基础操作列的业务操作。 */
   extraActions?: TenantProjectAction[];
   /** 加载当前页外部业务字段。 */

package/dist/package/src/index.ts

@@ -3,9 +3,11 @@ export type { AdminAiExtension } from "./ai";
 export { default as TenantProjectManager } from "./components/tenant-project/TenantProjectManager.vue";
 export {
   mergeTenantProjectExtraData,
+  arrangeTenantProjectColumns,
   tenantProjectKey,
   type TenantProjectAction,
   type TenantProjectContext,
+  type TenantProjectExtraColumn,
   type TenantProjectExtraData,
   type TenantProjectExtraDataLoadContext,
   type TenantProjectExtraDataLoader,

package/dist/package/src/locales/en-US.json

@@ -807,6 +807,7 @@
   "system.base.redact_rule.description.fixed_length_mask": "Replace content with a fixed character while preserving its length",
   "system.base.redact_rule.description.hash_digest": "Generate an irreversible result with a digest algorithm",
   "system.base.redact_rule.description.ip_mask": "Keep the IP prefix octets and mask the rest",
+  "system.base.redact_rule.description.string_mask": "Keep configured leading and trailing characters and mask the middle",
   "system.base.redact_rule.description.phone_mask": "Keep the first three and last four digits of a phone number",
   "system.base.redact_rule.description.regex_replace": "Replace matching content with a regular expression",
   "system.base.redact_rule.description.stable_uuid": "Convert text to a stable UUID",
@@ -821,6 +822,7 @@
   "system.base.redact_rule.parameter.char": "Replacement character",
   "system.base.redact_rule.parameter.keep_first": "Leading characters to keep",
   "system.base.redact_rule.parameter.keep_last": "Trailing characters to keep",
+  "system.base.redact_rule.parameter.min_mask": "Minimum masked characters",
   "system.base.redact_rule.parameter.keep_local_first": "Local-part characters to keep",
   "system.base.redact_rule.parameter.keep_octets": "IP octets to keep",
   "system.base.redact_rule.parameter.length": "Kept length",
@@ -834,6 +836,7 @@
   "system.base.redact_rule.template.fixed_length_mask": "Fixed-length mask",
   "system.base.redact_rule.template.hash_digest": "Hash digest",
   "system.base.redact_rule.template.ip_mask": "IP address mask",
+  "system.base.redact_rule.template.string_mask": "Generic string mask",
   "system.base.redact_rule.template.phone_mask": "Phone number mask",
   "system.base.redact_rule.template.regex_replace": "Regular expression replacement",
   "system.base.redact_rule.template.stable_uuid": "Stable UUID",
@@ -841,6 +844,9 @@
   "system.base.redact_rule.template.url_mask": "URL parameter mask",
   "system.base.redact_rule.title": "Redaction rules",
   "system.base.redact_rule.validation.parameters": "Enter the rule parameters",
+  "system.base.redact_rule.validation.code": "Enter the rule code",
+  "system.base.redact_rule.validation.name": "Enter the rule name",
+  "system.base.redact_rule.validation.rule_type": "Select the rule type",
   "system.base.redact_storage_policy.field.column_name": "Field",
   "system.base.redact_storage_policy.field.parameters": "Rule parameters",
   "system.base.redact_storage_policy.field.rule": "Redaction rule",

package/dist/package/src/locales/ja-JP.json

@@ -807,6 +807,7 @@
   "system.base.redact_rule.description.fixed_length_mask": "固定文字で置換し、元の長さを保持します",
   "system.base.redact_rule.description.hash_digest": "ダイジェストアルゴリズムで不可逆な結果を生成します",
   "system.base.redact_rule.description.ip_mask": "IP の先頭オクテットを保持し、残りをマスクします",
+  "system.base.redact_rule.description.string_mask": "設定した先頭と末尾の文字を保持し、中間をマスクします",
   "system.base.redact_rule.description.phone_mask": "電話番号の先頭 3 桁と末尾 4 桁を保持します",
   "system.base.redact_rule.description.regex_replace": "正規表現で一致した内容を置換します",
   "system.base.redact_rule.description.stable_uuid": "テキストを安定 UUID に変換します",
@@ -821,6 +822,7 @@
   "system.base.redact_rule.parameter.char": "置換文字",
   "system.base.redact_rule.parameter.keep_first": "先頭から保持する文字数",
   "system.base.redact_rule.parameter.keep_last": "末尾から保持する文字数",
+  "system.base.redact_rule.parameter.min_mask": "最小マスク文字数",
   "system.base.redact_rule.parameter.keep_local_first": "ローカル部で保持する文字数",
   "system.base.redact_rule.parameter.keep_octets": "保持するオクテット数",
   "system.base.redact_rule.parameter.length": "保持する長さ",
@@ -834,6 +836,7 @@
   "system.base.redact_rule.template.fixed_length_mask": "固定長マスク",
   "system.base.redact_rule.template.hash_digest": "ハッシュダイジェスト",
   "system.base.redact_rule.template.ip_mask": "IP アドレスマスク",
+  "system.base.redact_rule.template.string_mask": "汎用文字列マスク",
   "system.base.redact_rule.template.phone_mask": "電話番号マスク",
   "system.base.redact_rule.template.regex_replace": "正規表現置換",
   "system.base.redact_rule.template.stable_uuid": "安定 UUID",
@@ -841,6 +844,9 @@
   "system.base.redact_rule.template.url_mask": "URL パラメーターマスク",
   "system.base.redact_rule.title": "脱敏ルール",
   "system.base.redact_rule.validation.parameters": "ルールパラメーターを入力してください",
+  "system.base.redact_rule.validation.code": "ルールコードを入力してください",
+  "system.base.redact_rule.validation.name": "ルール名を入力してください",
+  "system.base.redact_rule.validation.rule_type": "ルールタイプを選択してください",
   "system.base.redact_storage_policy.field.column_name": "フィールド",
   "system.base.redact_storage_policy.field.parameters": "ルールパラメーター",
   "system.base.redact_storage_policy.field.rule": "脱敏ルール",

package/dist/package/src/locales/zh-CN.json

@@ -807,6 +807,7 @@
   "system.base.redact_rule.description.fixed_length_mask": "使用固定字符替换为等长文本",
   "system.base.redact_rule.description.hash_digest": "使用摘要算法生成不可逆结果",
   "system.base.redact_rule.description.ip_mask": "保留 IP 前缀网段并隐藏其余部分",
+  "system.base.redact_rule.description.string_mask": "按配置保留字符串首尾字符并掩码中间内容",
   "system.base.redact_rule.description.phone_mask": "保留手机号前三位和后四位",
   "system.base.redact_rule.description.regex_replace": "使用正则表达式替换匹配内容",
   "system.base.redact_rule.description.stable_uuid": "将文本转换为稳定 UUID",
@@ -821,6 +822,7 @@
   "system.base.redact_rule.parameter.char": "替换字符",
   "system.base.redact_rule.parameter.keep_first": "保留开头字符数",
   "system.base.redact_rule.parameter.keep_last": "保留结尾字符数",
+  "system.base.redact_rule.parameter.min_mask": "最少脱敏字符数",
   "system.base.redact_rule.parameter.keep_local_first": "保留本地部分字符数",
   "system.base.redact_rule.parameter.keep_octets": "保留网段数",
   "system.base.redact_rule.parameter.length": "保留长度",
@@ -834,6 +836,7 @@
   "system.base.redact_rule.template.fixed_length_mask": "等长掩码",
   "system.base.redact_rule.template.hash_digest": "哈希摘要",
   "system.base.redact_rule.template.ip_mask": "IP 地址掩码",
+  "system.base.redact_rule.template.string_mask": "通用字符串掩码",
   "system.base.redact_rule.template.phone_mask": "手机号掩码",
   "system.base.redact_rule.template.regex_replace": "正则替换",
   "system.base.redact_rule.template.stable_uuid": "稳定 UUID",
@@ -841,6 +844,9 @@
   "system.base.redact_rule.template.url_mask": "URL 参数掩码",
   "system.base.redact_rule.title": "脱敏规则",
   "system.base.redact_rule.validation.parameters": "请输入规则参数",
+  "system.base.redact_rule.validation.code": "请输入规则编码",
+  "system.base.redact_rule.validation.name": "请输入规则名称",
+  "system.base.redact_rule.validation.rule_type": "请选择规则类型",
   "system.base.redact_storage_policy.field.column_name": "字段",
   "system.base.redact_storage_policy.field.parameters": "规则参数",
   "system.base.redact_storage_policy.field.rule": "脱敏规则",

package/dist/package/src/locales/zh-TW.json

@@ -807,6 +807,7 @@
   "system.base.redact_rule.description.fixed_length_mask": "使用固定字元取代為等長文字",
   "system.base.redact_rule.description.hash_digest": "使用摘要演算法產生不可逆結果",
   "system.base.redact_rule.description.ip_mask": "保留 IP 前綴網段並隱藏其餘部分",
+  "system.base.redact_rule.description.string_mask": "依設定保留字串首尾字元並遮罩中間內容",
   "system.base.redact_rule.description.phone_mask": "保留手機號碼前三碼和後四碼",
   "system.base.redact_rule.description.regex_replace": "使用正規表示式取代符合的內容",
   "system.base.redact_rule.description.stable_uuid": "將文字轉換為穩定 UUID",
@@ -821,6 +822,7 @@
   "system.base.redact_rule.parameter.char": "取代字元",
   "system.base.redact_rule.parameter.keep_first": "保留開頭字元數",
   "system.base.redact_rule.parameter.keep_last": "保留結尾字元數",
+  "system.base.redact_rule.parameter.min_mask": "最少遮罩字元數",
   "system.base.redact_rule.parameter.keep_local_first": "保留本機部分字元數",
   "system.base.redact_rule.parameter.keep_octets": "保留網段數",
   "system.base.redact_rule.parameter.length": "保留長度",
@@ -834,6 +836,7 @@
   "system.base.redact_rule.template.fixed_length_mask": "等長遮罩",
   "system.base.redact_rule.template.hash_digest": "雜湊摘要",
   "system.base.redact_rule.template.ip_mask": "IP 位址遮罩",
+  "system.base.redact_rule.template.string_mask": "通用字串遮罩",
   "system.base.redact_rule.template.phone_mask": "手機號碼遮罩",
   "system.base.redact_rule.template.regex_replace": "正規表示式取代",
   "system.base.redact_rule.template.stable_uuid": "穩定 UUID",
@@ -841,6 +844,9 @@
   "system.base.redact_rule.template.url_mask": "URL 參數遮罩",
   "system.base.redact_rule.title": "脫敏規則",
   "system.base.redact_rule.validation.parameters": "請輸入規則參數",
+  "system.base.redact_rule.validation.code": "請輸入規則編碼",
+  "system.base.redact_rule.validation.name": "請輸入規則名稱",
+  "system.base.redact_rule.validation.rule_type": "請選擇規則類型",
   "system.base.redact_storage_policy.field.column_name": "欄位",
   "system.base.redact_storage_policy.field.parameters": "規則參數",
   "system.base.redact_storage_policy.field.rule": "脫敏規則",

package/dist/package/src/rpc/system/admin/v1/base_redact_output_policy.ts

@@ -7,6 +7,7 @@
 /* eslint-disable */
 import type { Status } from "../../../common/v1/enum";
 import type { Empty } from "../../../google/protobuf/empty";
+import type { BaseApiDoc } from "./base_api";
 
 /** 出库脱敏策略处理模式。 */
 export enum BaseRedactOutputPolicyMode {
@@ -140,6 +141,12 @@ export interface BaseRedactOutputPolicy {
   updated_at: string;
 }
 
+/** 查询可出库脱敏字段请求。 */
+export interface GetBaseRedactOutputFieldDocRequest {
+  /** 接口ID */
+  api_id: number;
+}
+
 /** Admin出库脱敏策略服务。 */
 export interface BaseRedactOutputPolicyService {
   /** 查询出库脱敏策略分页列表。 */
@@ -154,4 +161,6 @@ export interface BaseRedactOutputPolicyService {
   DeleteBaseRedactOutputPolicy(request: DeleteBaseRedactOutputPolicyRequest): Promise<Empty>;
   /** 设置出库脱敏策略状态。 */
   SetBaseRedactOutputPolicyStatus(request: SetBaseRedactOutputPolicyStatusRequest): Promise<Empty>;
+  /** 查询可出库脱敏的响应字段文档。 */
+  GetBaseRedactOutputFieldDoc(request: GetBaseRedactOutputFieldDocRequest): Promise<BaseApiDoc>;
 }

package/dist/package/src/rpc/system/admin/v1/base_redact_storage_policy.ts

@@ -118,6 +118,32 @@ export interface BaseRedactStoragePolicy {
   updated_at: string;
 }
 
+/** 查询可入库脱敏字段请求。 */
+export interface ListBaseRedactStorageColumnRequest {
+  /** 数据源名称 */
+  source_name: string;
+  /** 数据库表名 */
+  table_name: string;
+}
+
+/** 可入库脱敏字段。 */
+export interface BaseRedactStorageColumn {
+  /** 字段名 */
+  name: string;
+  /** 字段注释 */
+  comment: string;
+  /** 数据库类型 */
+  db_type: string;
+  /** 数据库完整类型 */
+  column_type: string;
+}
+
+/** 可入库脱敏字段列表响应。 */
+export interface ListBaseRedactStorageColumnResponse {
+  /** 可脱敏字段列表 */
+  columns: BaseRedactStorageColumn[];
+}
+
 /** Admin入库脱敏策略服务。 */
 export interface BaseRedactStoragePolicyService {
   /** 查询入库脱敏策略分页列表。 */
@@ -134,4 +160,8 @@ export interface BaseRedactStoragePolicyService {
   DeleteBaseRedactStoragePolicy(request: DeleteBaseRedactStoragePolicyRequest): Promise<Empty>;
   /** 设置入库脱敏策略状态。 */
   SetBaseRedactStoragePolicyStatus(request: SetBaseRedactStoragePolicyStatusRequest): Promise<Empty>;
+  /** 查询可入库脱敏的字符串字段列表。 */
+  ListBaseRedactStorageColumn(
+    request: ListBaseRedactStorageColumnRequest,
+  ): Promise<ListBaseRedactStorageColumnResponse>;
 }

package/dist/package/src/views/ai/chat/components/XSender.vue

@@ -101,8 +101,8 @@
 </template>
 
 <script setup lang="ts" name="XSender">
-import { computed, ref, watch } from "vue";
-import { Attachments, useRecord, XSender as BaseXSender } from "vue-element-plus-x";
+import { computed, ref } from "vue";
+import { Attachments, XSender as BaseXSender } from "vue-element-plus-x";
 import type { FilesCardProps } from "vue-element-plus-x/types/FilesCard";
 import { Loading, Microphone, Paperclip, Promotion } from "@element-plus/icons-vue";
 import { ElMessage } from "element-plus";
@@ -111,13 +111,8 @@ import { defFileService } from "@liujitcn/kratos-admin-core/api/base/v1/file";
 import type { AiAttachment } from "@liujitcn/kratos-admin-system/rpc/base/v1/ai_session";
 import type { SubmitPayload } from "../types";
 import { buildAIAttachmentFileCard } from "../attachment";
-
-/** 语音识别错误的最小字段，兼容浏览器事件和不支持错误。 */
-type RecordError = {
-  code?: number;
-  error?: string;
-  message?: string;
-};
+import { useSpeechRecognition } from "./speech-recognition";
+import type { SpeechRecognitionError } from "./speech-recognition";
 
 const props = defineProps<{
   /** 消息发送加载状态。 */
@@ -153,13 +148,17 @@ const acceptedAttachmentExtensions = [
 ];
 const acceptedAttachmentTypes = acceptedAttachmentExtensions.join(",");
 
+const voiceBaseText = ref("");
 const {
   loading: recording,
   start: startRecord,
-  stop: stopRecord,
-  value: recordText
-} = useRecord({
+  stop: stopRecord
+} = useSpeechRecognition({
+  onStart: () => {
+    voiceBaseText.value = inputText.value.trim();
+  },
   onEnd: handleRecordEnd,
+  onResult: setRecordText,
   onError: handleRecordError
 });
 
@@ -217,10 +216,11 @@ function handleToggleRecord() {
 /** 语音识别结束后保留当前识别文本。 */
 function handleRecordEnd(result: string) {
   setRecordText(result);
+  voiceBaseText.value = "";
 }
 
 /** 处理语音识别失败，提示浏览器不支持或麦克风授权异常。 */
-function handleRecordError(error: RecordError) {
+function handleRecordError(error: SpeechRecognitionError) {
   const message = resolveRecordErrorMessage(error);
   ElMessage.warning(message);
 }
@@ -229,52 +229,18 @@ function handleRecordError(error: RecordError) {
 function setRecordText(recordText: string) {
   const normalizedRecordText = normalizeRecordText(recordText);
   if (!normalizedRecordText) return;
-  senderRef.value?.setText(normalizedRecordText);
-  inputText.value = normalizedRecordText;
+  const nextText = [voiceBaseText.value, normalizedRecordText].filter(Boolean).join(" ");
+  senderRef.value?.setText(nextText);
+  inputText.value = nextText;
 }
 
 /** 标准化语音识别文本，压掉多余空白。 */
 function normalizeRecordText(recordText: string) {
-  return collapseCumulativeRecordText(recordText.replace(/\s+/g, " ").trim());
-}
-
-/** 压缩 useRecord 在中文连续识别时返回的前缀累计文本。 */
-function collapseCumulativeRecordText(text: string) {
-  if (text.length < 4) return text;
-  for (let candidateLength = 2; candidateLength <= Math.floor(text.length / 2); candidateLength++) {
-    const candidate = text.slice(-candidateLength);
-    const matchResult = matchCumulativeRecordCandidate(text, candidate);
-    if (matchResult.matched && (matchResult.hasPartial || matchResult.segmentCount >= 3)) {
-      return candidate;
-    }
-  }
-  return text;
-}
-
-/** 判断文本是否由同一识别结果的前缀片段累计组成。 */
-function matchCumulativeRecordCandidate(text: string, candidate: string) {
-  let index = 0;
-  let segmentCount = 0;
-  let hasPartial = false;
-  while (index < text.length) {
-    let matchedLength = 0;
-    const maxLength = Math.min(candidate.length, text.length - index);
-    for (let length = maxLength; length >= 1; length--) {
-      if (candidate.startsWith(text.slice(index, index + length))) {
-        matchedLength = length;
-        break;
-      }
-    }
-    if (!matchedLength) return { matched: false, segmentCount, hasPartial };
-    if (matchedLength < candidate.length) hasPartial = true;
-    segmentCount++;
-    index += matchedLength;
-  }
-  return { matched: true, segmentCount, hasPartial };
+  return recordText.replace(/\s+/g, " ").trim();
 }
 
 /** 根据浏览器语音识别错误类型生成用户可理解的提示。 */
-function resolveRecordErrorMessage(error: RecordError) {
+function resolveRecordErrorMessage(error: SpeechRecognitionError) {
   if (error.code === -1) return t("system.ai.chat.message.voice_unsupported");
   const errorName = error.error ?? "";
   if (["not-allowed", "service-not-allowed", "permission-denied"].includes(errorName)) {
@@ -389,15 +355,6 @@ function handleDeleteCard(item: { uid?: string | number }) {
 function resetFileInput() {
   if (fileInputRef.value) fileInputRef.value.value = "";
 }
-
-/** 按 useRecord 文档监听识别文本，并同步到 XSender。 */
-watch(
-  recordText,
-  value => {
-    setRecordText(value);
-  },
-  { deep: true }
-);
 </script>
 
 <style scoped lang="scss">

package/dist/package/src/views/ai/chat/components/speech-recognition.ts

@@ -0,0 +1,177 @@
+import { getCurrentInstance, onBeforeUnmount, ref } from "vue";
+
+/** 语音识别结果的最小结构，便于在不同浏览器实现间复用。 */
+export type SpeechResultList = ArrayLike<{
+  0?: {
+    transcript: string;
+  };
+  isFinal?: boolean;
+  length: number;
+}>;
+
+/** 语音识别错误的最小结构，兼容浏览器事件和不支持错误。 */
+export type SpeechRecognitionError = {
+  code?: number;
+  error?: string;
+  message?: string;
+};
+
+type SpeechRecognitionResultEvent = {
+  results: SpeechResultList;
+  resultIndex: number;
+};
+
+type SpeechRecognitionInstance = {
+  continuous: boolean;
+  interimResults: boolean;
+  lang: string;
+  onstart: (() => void) | null;
+  onend: (() => void) | null;
+  onerror: ((error: SpeechRecognitionError) => void) | null;
+  onresult: ((event: SpeechRecognitionResultEvent) => void) | null;
+  start: () => void;
+  stop: () => void;
+};
+
+type SpeechRecognitionConstructor = new () => SpeechRecognitionInstance;
+
+type SpeechRecognitionWindow = Window & {
+  SpeechRecognition?: SpeechRecognitionConstructor;
+  webkitSpeechRecognition?: SpeechRecognitionConstructor;
+};
+
+type SpeechRecognitionOptions = {
+  /** 识别错误回调。 */
+  onError?: (error: SpeechRecognitionError) => void;
+  /** 识别开始回调。 */
+  onStart?: () => void;
+  /** 识别结束回调。 */
+  onEnd?: (text: string) => void;
+  /** 识别结果回调。 */
+  onResult?: (text: string) => void;
+};
+
+/** 增量累积语音识别结果，避免连续模式下 interim 结果重复计入已确认文本。 */
+export function accumulateSpeechResultText(
+  results: SpeechResultList,
+  resultIndex: number,
+  previousFinalText: string
+): { finalText: string; text: string } {
+  let finalText = previousFinalText;
+  let interimText = "";
+  for (let index = resultIndex; index < results.length; index++) {
+    const result = results[index];
+    const transcript = result?.[0]?.transcript ?? "";
+    if (result?.isFinal) {
+      finalText += transcript;
+    } else {
+      interimText += transcript;
+    }
+  }
+  // Chrome 连续模式下 interim 结果会累计包含已确认的 final 文本，去除重复前缀。
+  if (interimText && finalText && interimText.startsWith(finalText)) {
+    interimText = interimText.slice(finalText.length);
+  }
+  return { finalText, text: finalText + interimText };
+}
+
+/** 创建浏览器语音识别实例，并统一结果、状态和卸载处理。 */
+export function useSpeechRecognition({ onError, onStart, onEnd, onResult }: SpeechRecognitionOptions = {}) {
+  const loading = ref(false);
+  const value = ref("");
+  let recognition: SpeechRecognitionInstance | null = null;
+  let recognitionSession = 0;
+  let finalText = "";
+
+  /** 获取当前浏览器支持的语音识别构造函数。 */
+  function resolveRecognitionConstructor() {
+    if (typeof window === "undefined") return undefined;
+    const speechWindow = window as SpeechRecognitionWindow;
+    return speechWindow.SpeechRecognition ?? speechWindow.webkitSpeechRecognition;
+  }
+
+  /** 开始一次语音识别。 */
+  function start() {
+    if (loading.value) return;
+    const RecognitionConstructor = resolveRecognitionConstructor();
+    if (!RecognitionConstructor) {
+      onError?.({ code: -1, message: "Speech recognition is not supported by this browser" });
+      return;
+    }
+
+    const nextRecognition = new RecognitionConstructor();
+    const currentSession = ++recognitionSession;
+    recognition = nextRecognition;
+    finalText = "";
+    const isCurrentRecognition = () => recognition === nextRecognition && recognitionSession === currentSession;
+    nextRecognition.continuous = true;
+    nextRecognition.interimResults = true;
+    nextRecognition.lang = "zh-CN";
+    nextRecognition.onstart = () => {
+      if (!isCurrentRecognition()) return;
+      loading.value = true;
+      value.value = "";
+      onStart?.();
+    };
+    nextRecognition.onresult = event => {
+      if (!isCurrentRecognition()) return;
+      const accumulated = accumulateSpeechResultText(event.results, event.resultIndex, finalText);
+      finalText = accumulated.finalText;
+      value.value = accumulated.text;
+      onResult?.(value.value);
+    };
+    nextRecognition.onerror = error => {
+      if (!isCurrentRecognition()) return;
+      loading.value = false;
+      recognition = null;
+      onError?.(error);
+    };
+    nextRecognition.onend = () => {
+      if (!isCurrentRecognition()) return;
+      loading.value = false;
+      recognition = null;
+      onEnd?.(value.value);
+    };
+
+    loading.value = true;
+    try {
+      nextRecognition.start();
+    } catch (error) {
+      if (!isCurrentRecognition()) return;
+      loading.value = false;
+      recognition = null;
+      onError?.({
+        code: -2,
+        message: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+
+  /** 停止当前语音识别。 */
+  function stop() {
+    const currentRecognition = recognition;
+    if (!currentRecognition) return;
+    recognition = null;
+    recognitionSession++;
+    loading.value = false;
+    onEnd?.(value.value);
+    currentRecognition.stop();
+  }
+
+  if (getCurrentInstance()) {
+    onBeforeUnmount(() => {
+      const currentRecognition = recognition;
+      recognition = null;
+      recognitionSession++;
+      loading.value = false;
+      currentRecognition?.stop();
+    });
+  }
+
+  return {
+    loading,
+    start,
+    stop,
+    value
+  };
+}