@liujitcn/kratos-admin-rag 0.0.0-stage → 0.0.75

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

@@ -0,0 +1,50 @@
+{
+  "rag.knowledge.action.docs": "Docs",
+  "rag.knowledge.doc.action.retry": "Retry",
+  "rag.knowledge.doc.action.upload_file": "Upload File",
+  "rag.knowledge.doc.action.upload_text": "Add Text",
+  "rag.knowledge.doc.field.chunk_count": "Chunks",
+  "rag.knowledge.doc.field.content": "Content",
+  "rag.knowledge.doc.field.error_message": "Error",
+  "rag.knowledge.doc.field.name": "Document",
+  "rag.knowledge.doc.field.status": "Status",
+  "rag.knowledge.doc.message.confirm_delete": "Delete document \"{name}\"?",
+  "rag.knowledge.doc.message.delete_success": "Document deleted",
+  "rag.knowledge.doc.message.reprocess_success": "Document reprocessed successfully",
+  "rag.knowledge.doc.placeholder.content": "Paste document content",
+  "rag.knowledge.doc.placeholder.name": "Document name",
+  "rag.knowledge.doc.status.failed": "Failed",
+  "rag.knowledge.doc.status.ready": "Ready",
+  "rag.knowledge.doc.title": "Documents",
+  "rag.knowledge.doc.upload.batch_invalid": "Unsupported type or larger than 10MB: {names}",
+  "rag.knowledge.doc.upload.batch_partial": "Upload finished: {success} succeeded, {failed} failed",
+  "rag.knowledge.doc.upload.batch_success": "Uploaded {count} documents",
+  "rag.knowledge.doc.upload.progress": "Uploading {current}/{total}: {name}",
+  "rag.knowledge.doc.upload.read_failed": "Failed to read file",
+  "rag.knowledge.doc.upload.success": "Document uploaded",
+  "rag.knowledge.doc.upload.too_large": "File exceeds 10MB limit",
+  "rag.knowledge.doc.upload.unsupported": "Unsupported file type",
+  "rag.knowledge.doc.validation.content": "Please enter the document content",
+  "rag.knowledge.doc.validation.name": "Please enter the document name",
+  "rag.knowledge.field.description": "Description",
+  "rag.knowledge.field.doc_count": "Docs",
+  "rag.knowledge.field.embedding_dimensions": "Dimensions",
+  "rag.knowledge.field.embedding_dimensions_value": "{dimensions} dims",
+  "rag.knowledge.field.model": "Embedding model",
+  "rag.knowledge.field.name": "Name",
+  "rag.knowledge.field.provider": "Provider",
+  "rag.knowledge.message.confirm_delete": "Delete knowledge base \"{name}\" and all its documents?",
+  "rag.knowledge.message.create_success": "Knowledge base created",
+  "rag.knowledge.message.delete_success": "Knowledge base deleted",
+  "rag.knowledge.message.update_success": "Knowledge base updated",
+  "rag.knowledge.resource": "Knowledge Base",
+  "rag.knowledge.search.action": "Search",
+  "rag.knowledge.search.empty": "No matching chunks",
+  "rag.knowledge.search.hint": "Returns the semantically closest chunks",
+  "rag.knowledge.search.placeholder": "Enter a query",
+  "rag.knowledge.search.score": "Score",
+  "rag.knowledge.search.title": "Retrieval Test",
+  "rag.knowledge.validation.model": "Please select an embedding model",
+  "rag.knowledge.validation.name": "Please enter a name",
+  "rag.knowledge.validation.embedding_dimensions": "Please select the vector dimension"
+}

package/dist/package/src/locales/generated.ts

@@ -0,0 +1,16 @@
+/* 此文件由 scripts/sync_locales.py 生成，请勿手工修改。 */
+import localeZhCn from './zh-CN.json'
+import localeEnUs from './en-US.json'
+import localeJaJp from './ja-JP.json'
+import localeZhTw from './zh-TW.json'
+
+export const LOCALE_MESSAGES = {
+  'zh-CN': localeZhCn,
+  'en-US': localeEnUs,
+  'ja-JP': localeJaJp,
+  'zh-TW': localeZhTw,
+} as const satisfies Record<string, Record<string, string>>
+
+export type GeneratedLocale = keyof typeof LOCALE_MESSAGES
+export const DEFAULT_LOCALE: GeneratedLocale = 'zh-CN'
+export const SUPPORTED_LOCALES = Object.keys(LOCALE_MESSAGES) as GeneratedLocale[]

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

@@ -0,0 +1,50 @@
+{
+  "rag.knowledge.action.docs": "ドキュメント",
+  "rag.knowledge.doc.action.retry": "再試行",
+  "rag.knowledge.doc.action.upload_file": "ファイルをアップロード",
+  "rag.knowledge.doc.action.upload_text": "テキストを追加",
+  "rag.knowledge.doc.field.chunk_count": "チャンク数",
+  "rag.knowledge.doc.field.content": "コンテンツ",
+  "rag.knowledge.doc.field.error_message": "エラー内容",
+  "rag.knowledge.doc.field.name": "ドキュメント名",
+  "rag.knowledge.doc.field.status": "ステータス",
+  "rag.knowledge.doc.message.confirm_delete": "ドキュメント「{name}」を削除しますか？",
+  "rag.knowledge.doc.message.delete_success": "ドキュメントを削除しました",
+  "rag.knowledge.doc.message.reprocess_success": "ドキュメントを再処理しました",
+  "rag.knowledge.doc.placeholder.content": "ドキュメントの内容を貼り付け",
+  "rag.knowledge.doc.placeholder.name": "ドキュメント名を入力",
+  "rag.knowledge.doc.status.failed": "処理失敗",
+  "rag.knowledge.doc.status.ready": "準備完了",
+  "rag.knowledge.doc.title": "ドキュメント管理",
+  "rag.knowledge.doc.upload.batch_invalid": "未対応の形式または10MB超過：{names}",
+  "rag.knowledge.doc.upload.batch_partial": "アップロード完了：{success} 件成功、{failed} 件失敗",
+  "rag.knowledge.doc.upload.batch_success": "{count} 件のドキュメントをアップロードしました",
+  "rag.knowledge.doc.upload.progress": "アップロード中 {current}/{total}：{name}",
+  "rag.knowledge.doc.upload.read_failed": "ファイルの読み取りに失敗しました",
+  "rag.knowledge.doc.upload.success": "ドキュメントをアップロードしました",
+  "rag.knowledge.doc.upload.too_large": "ファイルが10MBの上限を超えています",
+  "rag.knowledge.doc.upload.unsupported": "サポートされていないファイル形式です",
+  "rag.knowledge.doc.validation.content": "ドキュメントの内容を入力してください",
+  "rag.knowledge.doc.validation.name": "ドキュメント名を入力してください",
+  "rag.knowledge.field.description": "説明",
+  "rag.knowledge.field.doc_count": "ドキュメント数",
+  "rag.knowledge.field.embedding_dimensions": "ベクトル次元",
+  "rag.knowledge.field.embedding_dimensions_value": "{dimensions} 次元",
+  "rag.knowledge.field.model": "Embedding モデル",
+  "rag.knowledge.field.name": "名称",
+  "rag.knowledge.field.provider": "プロバイダー",
+  "rag.knowledge.message.confirm_delete": "ナレッジベース「{name}」とそのすべてのドキュメントを削除しますか？",
+  "rag.knowledge.message.create_success": "ナレッジベースを作成しました",
+  "rag.knowledge.message.delete_success": "ナレッジベースを削除しました",
+  "rag.knowledge.message.update_success": "ナレッジベースを更新しました",
+  "rag.knowledge.resource": "ナレッジベース",
+  "rag.knowledge.search.action": "検索",
+  "rag.knowledge.search.empty": "該当するチャンクがありません",
+  "rag.knowledge.search.hint": "意味的に最も近いチャンクを返します",
+  "rag.knowledge.search.placeholder": "検索内容を入力",
+  "rag.knowledge.search.score": "類似度",
+  "rag.knowledge.search.title": "検索テスト",
+  "rag.knowledge.validation.model": "Embedding モデルを選択してください",
+  "rag.knowledge.validation.name": "名称を入力してください",
+  "rag.knowledge.validation.embedding_dimensions": "ベクトル次元を選択してください"
+}

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

@@ -0,0 +1,50 @@
+{
+  "rag.knowledge.action.docs": "文档",
+  "rag.knowledge.doc.action.retry": "重试",
+  "rag.knowledge.doc.action.upload_file": "上传文件",
+  "rag.knowledge.doc.action.upload_text": "上传文本",
+  "rag.knowledge.doc.field.chunk_count": "切片数",
+  "rag.knowledge.doc.field.content": "文档内容",
+  "rag.knowledge.doc.field.error_message": "失败原因",
+  "rag.knowledge.doc.field.name": "文档名称",
+  "rag.knowledge.doc.field.status": "状态",
+  "rag.knowledge.doc.message.confirm_delete": "确认删除文档「{name}」？",
+  "rag.knowledge.doc.message.delete_success": "删除文档成功",
+  "rag.knowledge.doc.message.reprocess_success": "文档重新处理成功",
+  "rag.knowledge.doc.placeholder.content": "粘贴文档文本内容",
+  "rag.knowledge.doc.placeholder.name": "请输入文档名称",
+  "rag.knowledge.doc.status.failed": "处理失败",
+  "rag.knowledge.doc.status.ready": "已就绪",
+  "rag.knowledge.doc.title": "文档管理",
+  "rag.knowledge.doc.upload.batch_invalid": "以下文件类型不支持或超过 10MB：{names}",
+  "rag.knowledge.doc.upload.batch_partial": "上传完成：{success} 个成功，{failed} 个失败",
+  "rag.knowledge.doc.upload.batch_success": "成功上传 {count} 个文档",
+  "rag.knowledge.doc.upload.progress": "正在上传 {current}/{total}：{name}",
+  "rag.knowledge.doc.upload.read_failed": "读取文件失败",
+  "rag.knowledge.doc.upload.success": "文档上传成功",
+  "rag.knowledge.doc.upload.too_large": "文件超过 10MB 上限",
+  "rag.knowledge.doc.upload.unsupported": "不支持的文件类型",
+  "rag.knowledge.doc.validation.content": "请输入文档内容",
+  "rag.knowledge.doc.validation.name": "请输入文档名称",
+  "rag.knowledge.field.description": "描述",
+  "rag.knowledge.field.doc_count": "文档数",
+  "rag.knowledge.field.embedding_dimensions": "向量维度",
+  "rag.knowledge.field.embedding_dimensions_value": "{dimensions} 维",
+  "rag.knowledge.field.model": "Embedding 模型",
+  "rag.knowledge.field.name": "知识库名称",
+  "rag.knowledge.field.provider": "供应商",
+  "rag.knowledge.message.confirm_delete": "确认删除知识库「{name}」及其全部文档？",
+  "rag.knowledge.message.create_success": "创建知识库成功",
+  "rag.knowledge.message.delete_success": "删除知识库成功",
+  "rag.knowledge.message.update_success": "更新知识库成功",
+  "rag.knowledge.resource": "知识库",
+  "rag.knowledge.search.action": "检索",
+  "rag.knowledge.search.empty": "暂无命中切片",
+  "rag.knowledge.search.hint": "按语义相似度返回最相近的切片",
+  "rag.knowledge.search.placeholder": "输入检索内容",
+  "rag.knowledge.search.score": "相似度",
+  "rag.knowledge.search.title": "检索测试",
+  "rag.knowledge.validation.model": "请选择 Embedding 模型",
+  "rag.knowledge.validation.name": "请输入知识库名称",
+  "rag.knowledge.validation.embedding_dimensions": "请选择向量维度"
+}

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

@@ -0,0 +1,50 @@
+{
+  "rag.knowledge.action.docs": "文件",
+  "rag.knowledge.doc.action.retry": "重試",
+  "rag.knowledge.doc.action.upload_file": "上傳檔案",
+  "rag.knowledge.doc.action.upload_text": "上傳文字",
+  "rag.knowledge.doc.field.chunk_count": "切片數",
+  "rag.knowledge.doc.field.content": "文件內容",
+  "rag.knowledge.doc.field.error_message": "失敗原因",
+  "rag.knowledge.doc.field.name": "文件名稱",
+  "rag.knowledge.doc.field.status": "狀態",
+  "rag.knowledge.doc.message.confirm_delete": "確認刪除文件「{name}」？",
+  "rag.knowledge.doc.message.delete_success": "刪除文件成功",
+  "rag.knowledge.doc.message.reprocess_success": "文件重新處理成功",
+  "rag.knowledge.doc.placeholder.content": "貼上文件文字內容",
+  "rag.knowledge.doc.placeholder.name": "請輸入文件名稱",
+  "rag.knowledge.doc.status.failed": "處理失敗",
+  "rag.knowledge.doc.status.ready": "已就緒",
+  "rag.knowledge.doc.title": "文件管理",
+  "rag.knowledge.doc.upload.batch_invalid": "以下檔案類型不支援或超過 10MB：{names}",
+  "rag.knowledge.doc.upload.batch_partial": "上傳完成：{success} 個成功，{failed} 個失敗",
+  "rag.knowledge.doc.upload.batch_success": "成功上傳 {count} 個文件",
+  "rag.knowledge.doc.upload.progress": "正在上傳 {current}/{total}：{name}",
+  "rag.knowledge.doc.upload.read_failed": "讀取檔案失敗",
+  "rag.knowledge.doc.upload.success": "文件上傳成功",
+  "rag.knowledge.doc.upload.too_large": "檔案超過 10MB 上限",
+  "rag.knowledge.doc.upload.unsupported": "不支援的檔案類型",
+  "rag.knowledge.doc.validation.content": "請輸入文件內容",
+  "rag.knowledge.doc.validation.name": "請輸入文件名稱",
+  "rag.knowledge.field.description": "描述",
+  "rag.knowledge.field.doc_count": "文件數",
+  "rag.knowledge.field.embedding_dimensions": "向量維度",
+  "rag.knowledge.field.embedding_dimensions_value": "{dimensions} 維",
+  "rag.knowledge.field.model": "Embedding 模型",
+  "rag.knowledge.field.name": "知識庫名稱",
+  "rag.knowledge.field.provider": "供應商",
+  "rag.knowledge.message.confirm_delete": "確認刪除知識庫「{name}」及其全部文件？",
+  "rag.knowledge.message.create_success": "建立知識庫成功",
+  "rag.knowledge.message.delete_success": "刪除知識庫成功",
+  "rag.knowledge.message.update_success": "更新知識庫成功",
+  "rag.knowledge.resource": "知識庫",
+  "rag.knowledge.search.action": "檢索",
+  "rag.knowledge.search.empty": "暫無命中切片",
+  "rag.knowledge.search.hint": "按語義相似度返回最相近的切片",
+  "rag.knowledge.search.placeholder": "輸入檢索內容",
+  "rag.knowledge.search.score": "相似度",
+  "rag.knowledge.search.title": "檢索測試",
+  "rag.knowledge.validation.model": "請選擇 Embedding 模型",
+  "rag.knowledge.validation.name": "請輸入知識庫名稱",
+  "rag.knowledge.validation.embedding_dimensions": "請選擇向量維度"
+}

package/dist/package/src/module.ts

@@ -0,0 +1,14 @@
+import type { Component } from "vue";
+import { defineAdminModule } from "@liujitcn/kratos-admin-core";
+
+// 语言包由同步脚本生成并注册，供 RAG 知识库页面使用。
+import { LOCALE_MESSAGES } from "./locales/generated";
+
+const viewModules = import.meta.glob<{ default: Component }>("./views/**/*.vue");
+
+/** RAG 知识库管理端业务模块。 */
+export const ragAdminModule = defineAdminModule({
+  name: "rag",
+  views: viewModules,
+  messages: LOCALE_MESSAGES
+});

package/dist/package/src/rpc/google/protobuf/empty.ts

@@ -0,0 +1,19 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.12.1
+//   protoc               unknown
+// source: google/protobuf/empty.proto
+
+/* eslint-disable */
+
+/**
+ * A generic empty message that you can re-use to avoid defining duplicated
+ * empty messages in your APIs. A typical example is to use it as the request
+ * or the response type of an API method. For instance:
+ *
+ *     service Foo {
+ *       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+ *     }
+ */
+export interface Empty {
+}

package/dist/package/src/rpc/rag/admin/v1/ai_knowledge.ts

@@ -0,0 +1,133 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.12.1
+//   protoc               unknown
+// source: rag/admin/v1/ai_knowledge.proto
+
+/* eslint-disable */
+import type { Empty } from "../../../google/protobuf/empty";
+
+/** AI知识库分页查询条件。 */
+export interface PageAiKnowledgeRequest {
+  /** 知识库名称 */
+  name: string;
+  /** 当前页码 */
+  page_num: number;
+  /** 每页行数 */
+  page_size: number;
+}
+
+/** AI知识库分页响应。 */
+export interface PageAiKnowledgeResponse {
+  /** 知识库列表 */
+  knowledges: AiKnowledge[];
+  /** 总数 */
+  total: number;
+}
+
+/** 查询AI知识库请求。 */
+export interface GetAiKnowledgeRequest {
+  /** 知识库ID */
+  id: number;
+}
+
+/** AI知识库维护表单。 */
+export interface AiKnowledgeForm {
+  /** 知识库ID */
+  id: number;
+  /** 知识库名称 */
+  name: string;
+  /** 描述 */
+  description: string;
+  /** 向量维度；0表示按所选模型配置或系统默认 */
+  embedding_dimensions: number;
+  /** 向量化使用的embedding模型ID */
+  model_id: number;
+}
+
+/** 创建AI知识库请求。 */
+export interface CreateAiKnowledgeRequest {
+  /** AI知识库表单 */
+  ai_knowledge: AiKnowledgeForm | undefined;
+}
+
+/** 更新AI知识库请求。 */
+export interface UpdateAiKnowledgeRequest {
+  /** AI知识库表单 */
+  ai_knowledge: AiKnowledgeForm | undefined;
+}
+
+/** 删除AI知识库请求。 */
+export interface DeleteAiKnowledgeRequest {
+  /** 知识库ID */
+  id: number;
+}
+
+/** AI知识库分页记录。 */
+export interface AiKnowledge {
+  /** 知识库ID */
+  id: number;
+  /** 知识库名称 */
+  name: string;
+  /** 描述 */
+  description: string;
+  /** embedding模型所属供应商名称 */
+  provider_name: string;
+  /** embedding向量维度 */
+  embedding_dimensions: number;
+  /** 向量化使用的embedding模型ID */
+  model_id: number;
+  /** embedding模型名称 */
+  model_name: string;
+  /** 文档数量 */
+  doc_count: number;
+  /** 创建时间 */
+  created_at: string;
+  /** 更新时间 */
+  updated_at: string;
+}
+
+/** 查询embedding模型选项请求。 */
+export interface ListAiKnowledgeModelsRequest {
+}
+
+/** 查询embedding模型选项响应。 */
+export interface ListAiKnowledgeModelsResponse {
+  /** 已启用的embedding模型列表 */
+  models: AiKnowledgeModel[];
+}
+
+/** 知识库可用的embedding模型选项。 */
+export interface AiKnowledgeModel {
+  /** 模型ID */
+  id: number;
+  /** 模型所属供应商名称 */
+  provider_name: string;
+  /** 模型名称 */
+  model_name: string;
+  /** 显示名称 */
+  display_name: string;
+  /** 模型声明的输出向量维度；0表示未声明 */
+  dimensions: number;
+  /** 可选向量维度列表 */
+  dimension_options: number[];
+}
+
+/** AI知识库管理服务。 */
+export interface AiKnowledgeService {
+  /** 分页查询AI知识库。 */
+  PageAiKnowledge(request: PageAiKnowledgeRequest): Promise<PageAiKnowledgeResponse>;
+  /**
+   * 查询已启用的embedding模型选项（知识库向量化模型下拉）。
+   * 字面路径必须先于 /{id} 声明：gorilla mux 按注册顺序匹配，否则会被 {id} 路由抢占。
+   */
+  ListAiKnowledgeModels(request: ListAiKnowledgeModelsRequest): Promise<ListAiKnowledgeModelsResponse>;
+  /** 查询AI知识库表单。 */
+  GetAiKnowledge(request: GetAiKnowledgeRequest): Promise<AiKnowledgeForm>;
+  /** 创建AI知识库。 */
+  CreateAiKnowledge(request: CreateAiKnowledgeRequest): Promise<Empty>;
+  /** 更新AI知识库。 */
+  UpdateAiKnowledge(request: UpdateAiKnowledgeRequest): Promise<Empty>;
+  /** 删除AI知识库（级联删除文档与切片）。 */
+  DeleteAiKnowledge(request: DeleteAiKnowledgeRequest): Promise<Empty>;
+}

package/dist/package/src/rpc/rag/admin/v1/ai_knowledge_chunk.ts

@@ -0,0 +1,43 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.12.1
+//   protoc               unknown
+// source: rag/admin/v1/ai_knowledge_chunk.proto
+
+/* eslint-disable */
+
+/** 检索测试请求。 */
+export interface SearchAiKnowledgeRequest {
+  /** 知识库ID */
+  id: number;
+  /** 检索关键词 */
+  query: string;
+  /** 返回切片数量 */
+  top_k: number;
+}
+
+/** 检索测试响应。 */
+export interface SearchAiKnowledgeResponse {
+  /** 语义最相近的切片 */
+  hits: AiKnowledgeChunkHit[];
+}
+
+/** 检索命中的切片。 */
+export interface AiKnowledgeChunkHit {
+  /** 切片ID */
+  chunk_id: number;
+  /** 文档ID */
+  doc_id: number;
+  /** 文档名称 */
+  doc_name: string;
+  /** 切片文本 */
+  content: string;
+  /** 余弦相似度 */
+  score: number;
+}
+
+/** AI知识库切片检索服务。 */
+export interface AiKnowledgeChunkService {
+  /** 检索测试：返回与query语义最相近的切片。 */
+  SearchAiKnowledge(request: SearchAiKnowledgeRequest): Promise<SearchAiKnowledgeResponse>;
+}

package/dist/package/src/rpc/rag/admin/v1/ai_knowledge_doc.ts

@@ -0,0 +1,102 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.12.1
+//   protoc               unknown
+// source: rag/admin/v1/ai_knowledge_doc.proto
+
+/* eslint-disable */
+import type { Empty } from "../../../google/protobuf/empty";
+
+/** AI知识库文档处理状态枚举。 */
+export enum AiKnowledgeDocStatus {
+  /** AI_KNOWLEDGE_DOC_STATUS_UNSPECIFIED - 未指定文档处理状态。 */
+  AI_KNOWLEDGE_DOC_STATUS_UNSPECIFIED = 0,
+  /** AI_KNOWLEDGE_DOC_STATUS_READY - 处理完成。 */
+  AI_KNOWLEDGE_DOC_STATUS_READY = 1,
+  /** AI_KNOWLEDGE_DOC_STATUS_FAILED - 处理失败。 */
+  AI_KNOWLEDGE_DOC_STATUS_FAILED = 2,
+}
+
+/** 分页查询知识库文档请求。 */
+export interface PageAiKnowledgeDocRequest {
+  /** 知识库ID */
+  id: number;
+  /** 当前页码 */
+  page_num: number;
+  /** 每页行数 */
+  page_size: number;
+}
+
+/** 分页查询知识库文档响应。 */
+export interface PageAiKnowledgeDocResponse {
+  /** 文档列表 */
+  docs: AiKnowledgeDoc[];
+  /** 总数 */
+  total: number;
+}
+
+/** AI知识库文档。 */
+export interface AiKnowledgeDoc {
+  /** 文档ID */
+  id: number;
+  /** 知识库ID */
+  knowledge_base_id: number;
+  /** 文档名称 */
+  name: string;
+  /** 切片数 */
+  chunk_count: number;
+  /** 处理状态：枚举【AiKnowledgeDocStatus】 */
+  status: AiKnowledgeDocStatus;
+  /** 失败原因 */
+  error_message: string;
+  /** 创建时间 */
+  created_at: string;
+}
+
+/** 上传纯文本文档请求。 */
+export interface UploadAiKnowledgeDocTextRequest {
+  /** 知识库ID */
+  id: number;
+  /** 文档名称 */
+  name: string;
+  /** 文档文本内容 */
+  content: string;
+}
+
+/** 上传文档文件请求。 */
+export interface UploadAiKnowledgeDocFileRequest {
+  /** 知识库ID */
+  id: number;
+  /** 原始文件名 */
+  file_name: string;
+  /** 文件内容（≤10MB） */
+  content_base64: Uint8Array;
+  /** 文档显示名 */
+  doc_name: string;
+}
+
+/** 删除文档请求。 */
+export interface DeleteAiKnowledgeDocRequest {
+  /** 文档ID */
+  doc_id: number;
+}
+
+/** 重新处理文档请求。 */
+export interface ReprocessAiKnowledgeDocRequest {
+  /** 文档ID */
+  doc_id: number;
+}
+
+/** AI知识库文档管理服务。 */
+export interface AiKnowledgeDocService {
+  /** 分页查询知识库下的文档。 */
+  PageAiKnowledgeDoc(request: PageAiKnowledgeDocRequest): Promise<PageAiKnowledgeDocResponse>;
+  /** 上传纯文本文档（切片 → 向量化 → 落库）。 */
+  UploadAiKnowledgeDocText(request: UploadAiKnowledgeDocTextRequest): Promise<Empty>;
+  /** 上传文档文件（txt/md/docx/pdf：抽取文本后走同一入库链）。 */
+  UploadAiKnowledgeDocFile(request: UploadAiKnowledgeDocFileRequest): Promise<Empty>;
+  /** 删除文档（级联删除切片）。 */
+  DeleteAiKnowledgeDoc(request: DeleteAiKnowledgeDocRequest): Promise<Empty>;
+  /** 重新处理失败的文档（按保存的原文重切片、重向量化）。 */
+  ReprocessAiKnowledgeDoc(request: ReprocessAiKnowledgeDocRequest): Promise<Empty>;
+}