diff --git a/src/api/kb/category.ts b/src/api/kb/category.ts
index 6dd013d..cabeee7 100644
--- a/src/api/kb/category.ts
+++ b/src/api/kb/category.ts
@@ -1,93 +1,73 @@
 import { request } from '@/api/request'
+import type { KbReply } from './faq'
 
-/** 分类类型 */
+/** 公共分类状态。 */
+export type CategoryStatus = 'active' | 'inactive'
+
+/** 公共分类。 */
 export interface Category {
   id: number
   created_at: string
   updated_at: string
   name: string
   description: string
-  type: string
+  type: 'general'
   icon: string
   color: string
   parent_id: number
-  level: number
+  level: 1 | 2 | 3
   path: string
   sort_order: number
-  status: string
+  status: CategoryStatus
   creator_id: number
   creator_name: string
   doc_count: number
   faq_count: number
-  metadata: string | null
+  metadata: string
   remarks: string
 }
 
-/** API响应包装类型 */
-export interface ApiResponse<T = any> {
-  code: number
-  message: string
-  data: T
+/** 公共分类树节点。 */
+export interface CategoryTreeNode extends Category {
+  children: CategoryTreeNode[]
 }
 
-/** 创建分类请求参数 */
+/** 创建分类参数。 */
 export interface CreateCategoryParams {
   name: string
-  description?: string
-  type?: string
-  icon?: string
-  color?: string
-  parent_id?: number
-  sort_order?: number
-  remarks?: string
+  description: string
+  icon: string
+  color: string
+  parent_id: number
+  sort_order: number
+  status: CategoryStatus
+  remarks: string
 }
 
-/** 更新分类请求参数 */
-export interface UpdateCategoryParams {
+/** 更新分类参数。 */
+export interface UpdateCategoryParams extends CreateCategoryParams {
   id: number
-  name?: string
-  description?: string
-  icon?: string
-  color?: string
-  sort_order?: number
-  status?: string
-  remarks?: string
 }
 
-/** 获取分类列表参数 */
+/** 分类列表参数。 */
 export interface FetchCategoryListParams {
-  type?: string
   parent_id?: number
 }
 
-/** 创建分类 */
-export const createCategory = (data: CreateCategoryParams) => {
-  return request.post<ApiResponse<Category>>('/Kb/v1/category/create', data)
-}
+/** 创建公共分类。 */
+export const createCategory = (data: CreateCategoryParams) => request.post<KbReply<Category>>('/Kb/v1/category/create', data)
 
-/** 更新分类 */
-export const updateCategory = (data: UpdateCategoryParams) => {
-  return request.post<ApiResponse<Category>>('/Kb/v1/category/update', data)
-}
+/** 更新公共分类。 */
+export const updateCategory = (data: UpdateCategoryParams) => request.post<KbReply<Category>>('/Kb/v1/category/update', data)
 
-/** 删除分类 */
-export const deleteCategory = (id: number) => {
-  return request.delete<ApiResponse<string>>(`/Kb/v1/category/${id}`)
-}
+/** 删除公共分类。 */
+export const deleteCategory = (id: number) => request.delete<KbReply<string>>(`/Kb/v1/category/${id}`)
 
-/** 获取分类详情 */
-export const fetchCategoryDetail = (id: number) => {
-  return request.get<ApiResponse<Category>>(`/Kb/v1/category/${id}`)
-}
+/** 获取公共分类详情。 */
+export const fetchCategoryDetail = (id: number) => request.get<KbReply<Category>>(`/Kb/v1/category/${id}`)
 
-/** 获取分类列表 */
-export const fetchCategoryList = (params?: FetchCategoryListParams) => {
-  return request.get<ApiResponse<Category[]>>('/Kb/v1/category/list', { params })
-}
+/** 获取公共分类列表。 */
+export const fetchCategoryList = (params?: FetchCategoryListParams) => request.get<KbReply<Category[]>>('/Kb/v1/category/list', { params })
 
-/** 获取分类树 */
-export const fetchCategoryTree = (type?: string) => {
-  return request.get<ApiResponse<Category[]>>('/Kb/v1/category/tree', {
-    params: type ? { type } : undefined,
-  })
-}
+/** 获取完整公共分类树，包含停用节点。 */
+export const fetchCategoryTree = () => request.get<KbReply<CategoryTreeNode[]>>('/Kb/v1/category/tree')
diff --git a/src/api/kb/document.ts b/src/api/kb/document.ts
index 0ad9410..103b652 100644
--- a/src/api/kb/document.ts
+++ b/src/api/kb/document.ts
@@ -1,12 +1,14 @@
 import { request } from '@/api/request'
+import type { KbReply } from './faq'
 
-/** 文档状态 */
+/** 文档状态。 */
 export type DocumentStatus = 'draft' | 'published' | 'reviewed' | 'rejected'
-
-/** 文档类型 */
+/** 文档类型。 */
 export type DocumentType = 'common' | 'guide' | 'solution' | 'troubleshoot' | 'process' | 'technical'
+/** 文档列表范围。 */
+export type DocumentScope = 'my' | 'all'
 
-/** 文档接口类型 */
+/** 文档资源。 */
 export interface Document {
   id: number
   created_at: string
@@ -33,71 +35,54 @@ export interface Document {
   version: string
   version_notes: string
   tags: string
-  attachments: string | null
-  related_docs: string | null
-  detection_point_ids: string | null
-  metadata: string | null
+  attachments: string
+  related_docs: string
+  detection_point_ids: string
+  metadata: string
   keywords: string
   remarks: string
-  is_favorited?: boolean
+  is_favorited: boolean
 }
 
-/** API响应包装类型 */
-export interface ApiResponse<T = any> {
-  code: number
-  message: string
-  data: T
-}
-
-/** 分页响应类型 */
-export interface PaginatedResponse<T> {
+/** 文档分页结果。 */
+export interface DocumentPage {
   total: number
   page: number
   page_size: number
-  data: T[]
+  data: Document[]
 }
 
-/** 创建文档请求参数 */
+/** 文档创建字段。 */
 export interface CreateDocumentParams {
   title: string
-  description?: string
+  description: string
   content: string
-  type?: DocumentType
-  category_id?: number
-  sub_category?: string
-  keywords?: string
-  tags?: string
-  detection_point_ids?: string
-  remarks?: string
+  type: DocumentType
+  category_id: number
+  sub_category: string
+  keywords: string
+  tags: string
+  detection_point_ids: string
+  remarks: string
 }
 
-/** 更新文档请求参数 */
-export interface UpdateDocumentParams {
+/** 文档编辑字段。 */
+export interface UpdateDocumentParams extends CreateDocumentParams {
   id: number
-  title?: string
-  description?: string
-  content?: string
-  type?: DocumentType
-  category_id?: number
-  sub_category?: string
-  keywords?: string
-  tags?: string
-  detection_point_ids?: string
-  remarks?: string
 }
 
-/** 获取文档列表参数 */
+/** 文档列表参数。 */
 export interface FetchDocumentListParams {
   page?: number
   page_size?: number
+  scope?: DocumentScope
   keyword?: string
   type?: DocumentType
   status?: DocumentStatus
   category_id?: number
 }
 
-/** 文档类型选项 */
-export const documentTypeOptions = [
+export const documentTypeOptions: Array<{ label: string; value: DocumentType }> = [
   { label: '通用文档', value: 'common' },
   { label: '操作指南', value: 'guide' },
   { label: '解决方案', value: 'solution' },
@@ -106,115 +91,28 @@ export const documentTypeOptions = [
   { label: '技术文档', value: 'technical' },
 ]
 
-/** 文档状态选项 */
-export const documentStatusOptions = [
-  { label: '草稿', value: 'draft' },
-  { label: '已发布', value: 'published' },
-  { label: '已审核', value: 'reviewed' },
-  { label: '未通过审核', value: 'rejected' },
-]
+/** 创建文档草稿。 */
+export const createDocument = (data: CreateDocumentParams) => request.post<KbReply<Document>>('/Kb/v1/document/create', data)
 
-/** 获取文档状态文本 */
-export const getDocumentStatusText = (status: DocumentStatus): string => {
-  const statusMap: Record<DocumentStatus, string> = {
-    draft: '草稿',
-    published: '已发布',
-    reviewed: '已审核',
-    rejected: '未通过审核',
-  }
-  return statusMap[status] || status
-}
+/** 更新文档。 */
+export const updateDocument = (data: UpdateDocumentParams) => request.post<KbReply<Document>>('/Kb/v1/document/update', data)
 
-/** 获取文档状态颜色 */
-export const getDocumentStatusColor = (status: DocumentStatus): string => {
-  const colorMap: Record<DocumentStatus, string> = {
-    draft: 'gray',
-    published: 'blue',
-    reviewed: 'green',
-    rejected: 'red',
-  }
-  return colorMap[status] || 'gray'
-}
+/** 删除文档并移入回收站。 */
+export const deleteDocument = (id: number) => request.delete<KbReply<string>>(`/Kb/v1/document/${id}`)
 
-/** 获取文档类型文本 */
-export const getDocumentTypeText = (type: DocumentType): string => {
-  const typeMap: Record<DocumentType, string> = {
-    common: '通用文档',
-    guide: '操作指南',
-    solution: '解决方案',
-    troubleshoot: '故障排查',
-    process: '流程规范',
-    technical: '技术文档',
-  }
-  return typeMap[type] || type
-}
+/** 获取文档详情。 */
+export const fetchDocumentDetail = (id: number) => request.get<KbReply<Document>>(`/Kb/v1/document/${id}`)
 
-/** 创建文档 */
-export const createDocument = (data: CreateDocumentParams) => {
-  return request.post<ApiResponse<Document>>('/Kb/v1/document/create', data)
-}
+/** 获取指定可见范围的文档列表。 */
+export const fetchDocumentList = (params: FetchDocumentListParams) => request.get<KbReply<DocumentPage>>('/Kb/v1/document/list', { params })
 
-/** 更新文档 */
-export const updateDocument = (data: UpdateDocumentParams) => {
-  return request.post<ApiResponse<Document>>('/Kb/v1/document/update', data)
-}
+/** 提交文档审核。 */
+export const publishDocument = (id: number) => request.post<KbReply<string>>('/Kb/v1/document/publish', { id })
 
-/** 删除文档（移入回收站） */
-export const deleteDocument = (id: number) => {
-  return request.delete<ApiResponse<string>>(`/Kb/v1/document/${id}`)
-}
+/** 收藏文档。 */
+export const favoriteDocument = (id: number) =>
+  request.post<KbReply<unknown>>('/Kb/v1/favorite/collect', { resource_type: 'document', resource_id: id })
 
-/** 获取文档详情 */
-export const fetchDocumentDetail = (id: number) => {
-  return request.get<ApiResponse<Document>>(`/Kb/v1/document/${id}`)
-}
-
-/** 获取文档列表 */
-export const fetchDocumentList = (params?: FetchDocumentListParams) => {
-  return request.get<ApiResponse<PaginatedResponse<Document>>>('/Kb/v1/document/list', { params })
-}
-
-/** 发布文档 */
-export const publishDocument = (id: number) => {
-  return request.post<ApiResponse<string>>('/Kb/v1/document/publish', { id })
-}
-
-/** 移入回收站 */
-export const moveToTrash = (resourceId: number, resourceType: string) => {
-  return request.post<ApiResponse<string>>('/Kb/v1/trash/move', {
-    resource_id: resourceId,
-    resource_type: resourceType,
-  })
-}
-
-/** 获取我的文档列表（由我创建的所有文档） */
-export const fetchMyDocumentList = (params?: FetchDocumentListParams) => {
-  return request.get<ApiResponse<PaginatedResponse<Document>>>('/Kb/v1/review/publish/list', { params })
-}
-
-/** 获取已审核通过的文档列表 */
-export const fetchApprovedDocumentList = (params?: FetchDocumentListParams) => {
-  return request.get<ApiResponse<PaginatedResponse<Document>>>('/Kb/v1/review/approved/list', { params })
-}
-
-/** 收藏文档 */
-export const favoriteDocument = (id: number, remarks?: string) => {
-  return request.post<ApiResponse<string>>('/Kb/v1/favorite/collect', {
-    resource_type: 'document',
-    resource_id: id,
-    remarks,
-  })
-}
-
-/** 取消收藏文档 */
-export const unfavoriteDocument = (id: number) => {
-  return request.post<ApiResponse<string>>('/Kb/v1/favorite/uncollect', {
-    resource_type: 'document',
-    resource_id: id,
-  })
-}
-
-/** 下载文档 */
-export const downloadDocument = (id: number) => {
-  return request.get<Blob>(`/Kb/v1/document/${id}/download`, { responseType: 'blob' })
-}
+/** 取消收藏文档。 */
+export const unfavoriteDocument = (id: number) =>
+  request.post<KbReply<string>>('/Kb/v1/favorite/uncollect', { resource_type: 'document', resource_id: id })
diff --git a/src/api/kb/favorite.ts b/src/api/kb/favorite.ts
index df31e71..53dd85c 100644
--- a/src/api/kb/favorite.ts
+++ b/src/api/kb/favorite.ts
@@ -1,9 +1,10 @@
 import { request } from '@/api/request'
+import type { Document } from './document'
+import type { Faq, KbReply } from './faq'
 
-/** 资源类型 */
 export type ResourceType = 'document' | 'faq'
 
-/** 收藏记录接口 */
+/** 收藏记录。 */
 export interface Favorite {
   id: number
   created_at: string
@@ -12,69 +13,36 @@ export interface Favorite {
   resource_name: string
   remarks: string
   is_deleted: boolean
-  resource_data?: any
+  resource_data?: Document | Faq
 }
 
-/** 收藏列表响应 */
-export interface FavoriteListResponse {
+export interface FavoritePage {
   total: number
   page: number
   page_size: number
   data: Favorite[]
 }
 
-/** 获取收藏列表参数 */
 export interface FetchFavoriteListParams {
   page?: number
   page_size?: number
   resource_type?: ResourceType
 }
 
-/** 收藏请求参数 */
 export interface CollectParams {
   resource_type: ResourceType
   resource_id: number
   remarks?: string
 }
 
-/** 取消收藏参数 */
-export interface UncollectParams {
-  resource_type: ResourceType
-  resource_id: number
-}
+export type UncollectParams = Omit<CollectParams, 'remarks'>
 
-/** API响应包装类型 */
-export interface ApiResponse<T = any> {
-  code: number
-  message: string
-  data: T
-}
+/** 获取收藏列表。 */
+export const fetchFavoriteList = (params: FetchFavoriteListParams = {}) =>
+  request.get<KbReply<FavoritePage>>('/Kb/v1/favorite/list', { params })
 
-/**
- * 获取收藏列表
- */
-export async function fetchFavoriteList(params: FetchFavoriteListParams = {}): Promise<ApiResponse<FavoriteListResponse>> {
-  return request.get<ApiResponse<FavoriteListResponse>>('/Kb/v1/favorite/list', {
-    params,
-  })
-}
+/** 收藏资源。 */
+export const collectResource = (data: CollectParams) => request.post<KbReply<Favorite>>('/Kb/v1/favorite/collect', data)
 
-/**
- * 收藏资源
- */
-export async function collectResource(data: CollectParams): Promise<ApiResponse<Favorite>> {
-  return request.post<ApiResponse<Favorite>>('/Kb/v1/favorite/collect', data)
-}
-
-/**
- * 取消收藏
- */
-export async function uncollectResource(data: UncollectParams): Promise<ApiResponse<string>> {
-  return request.post<ApiResponse<string>>('/Kb/v1/favorite/uncollect', data)
-}
-
-/** 资源类型选项 */
-export const resourceTypeOptions = [
-  { label: '文档', value: 'document' },
-  { label: 'FAQ', value: 'faq' },
-]
+/** 取消收藏。 */
+export const uncollectResource = (data: UncollectParams) => request.post<KbReply<string>>('/Kb/v1/favorite/uncollect', data)
diff --git a/src/api/kb/review.ts b/src/api/kb/review.ts
index c0073f0..9bf1a21 100644
--- a/src/api/kb/review.ts
+++ b/src/api/kb/review.ts
@@ -1,169 +1,70 @@
 import { request } from '@/api/request'
+import type { Document } from './document'
+import type { Faq, KbReply } from './faq'
 
-export type ReviewStatsResourceType = 'all' | 'document' | 'faq'
+export type ReviewResourceType = 'all' | 'document' | 'faq'
 
-/** 审核统计接口返回的 data 字段 */
-export interface ReviewStatsPayload {
-  need_my_review_document?: number
-  need_my_review_faq?: number
-  need_my_review_total?: number
-  need_my_review_unreviewed_document?: number
-  need_my_review_unreviewed_faq?: number
-  need_my_review_unreviewed_total?: number
-}
-
-/** 文档资源类型 */
-export interface DocumentResource {
-  id: number
-  created_at: string
-  updated_at: string
-  doc_no: string
-  title: string
-  description: string
-  content: string
-  type: string
-  status: string
-  category_id: number
-  sub_category: string
-  author_id: number
-  author_name: string
-  reviewer_id: number
-  reviewer_name: string
-  reviewed_at: string | null
-  published_at: string | null
-  publisher_id: number
-  view_count: number
-  like_count: number
-  comment_count: number
-  download_count: number
-  version: string
-  version_notes: string
-  tags: string
-  attachments: string | null
-  related_docs: string | null
-  metadata: string | null
-  keywords: string
-  remarks: string
-}
-
-/** FAQ资源类型 */
-export interface FaqResource {
-  id: number
-  created_at: string
-  updated_at: string
-  faq_no: string
-  question: string
-  answer: string
-  status: string
-  priority: string
-  category_id: number
-  sub_category: string
-  problem_type: string
-  solution: string
-  process_steps: string
-  prerequisites: string
-  author_id: number
-  author_name: string
-  reviewer_id: number
-  reviewer_name: string
-  reviewed_at: string | null
-  published_at: string | null
-  view_count: number
-  use_count: number
-  helpful_count: number
-  useless_count: number
-  tags: string
-  related_faqs: string | null
-  related_docs: string | null
-  related_links: string | null
-  attachments: string | null
-  keywords: string
-  applicable_scope: string
-  remarks: string
-}
-
-/** 审核列表项（resource_type 为 all 时） */
+/** 统一审核列表项。 */
 export interface ReviewListItem {
   type: 'document' | 'faq'
-  resource: DocumentResource | FaqResource
+  resource: Document | Faq
 }
 
-/** 分页响应类型 */
-export interface PaginatedResponse<T> {
+/** 审核分页结果。 */
+export interface ReviewPage {
   total: number
   page: number
   page_size: number
-  data: T[]
+  data: ReviewListItem[]
 }
 
-/** API响应包装类型 */
-export interface ApiResponse<T = any> {
-  code: number
-  message: string
-  data: T
+/** 当前审核人的待审数量。 */
+export interface ReviewStats {
+  need_my_review_document: number
+  need_my_review_faq: number
+  need_my_review_total: number
+  need_my_review_unreviewed_document: number
+  need_my_review_unreviewed_faq: number
+  need_my_review_unreviewed_total: number
 }
 
-/** 获取审核列表参数 */
+/** 审核列表参数。 */
 export interface FetchReviewListParams {
   page?: number
   page_size?: number
-  resource_type?: ReviewStatsResourceType
+  resource_type?: ReviewResourceType
 }
 
-/** 审核通过参数 */
 export interface ApproveParams {
   resource_type: 'document' | 'faq'
   id: number
 }
 
-/** 审核拒绝参数 */
-export interface RejectParams {
-  resource_type: 'document' | 'faq'
-  id: number
-  reason?: string
+export interface RejectParams extends ApproveParams {
+  reason: string
 }
 
-/** 按当前登录用户统计需要本人审核的数量（不含本人为作者的稿件） */
-export const fetchReviewStats = (params?: { resource_type?: ReviewStatsResourceType }) =>
-  request.get('/Kb/v1/review/stats', params ? { params } : undefined)
+/** 获取当前用户可审核的待审资源。 */
+export const fetchReviewList = (params: FetchReviewListParams) => request.get<KbReply<ReviewPage>>('/Kb/v1/review/list', { params })
 
-/** 获取待审核列表 */
-export const fetchReviewList = (params?: FetchReviewListParams) =>
-  request.get<ApiResponse<PaginatedResponse<ReviewListItem | DocumentResource | FaqResource>>>('/Kb/v1/review/list', { params })
+/** 获取当前审核人的待审统计。 */
+export const fetchReviewStats = (params: { resource_type?: ReviewResourceType } = {}) =>
+  request.get<KbReply<ReviewStats>>('/Kb/v1/review/stats', { params })
 
-/** 审核通过 */
-export const approveReview = (data: ApproveParams) => request.post<ApiResponse<string>>('/Kb/v1/review/approve', data)
+/** 审核通过。 */
+export const approveReview = (data: ApproveParams) => request.post<KbReply<string>>('/Kb/v1/review/approve', data)
 
-/** 审核拒绝 */
-export const rejectReview = (data: RejectParams) => request.post<ApiResponse<string>>('/Kb/v1/review/reject', data)
+/** 审核拒绝。 */
+export const rejectReview = (data: RejectParams) => request.post<KbReply<string>>('/Kb/v1/review/reject', data)
 
-/** 获取文档详情 */
-export const fetchDocumentDetail = (id: number) => request.get<ApiResponse<DocumentResource>>(`/Kb/v1/document/${id}`)
-
-/** 获取FAQ详情 */
-export const fetchFaqDetail = (id: number) => request.get<ApiResponse<FaqResource>>(`/Kb/v1/faq/${id}`)
-
-/** 资源类型选项 */
-export const resourceTypeOptions = [
+export const resourceTypeOptions: Array<{ label: string; value: ReviewResourceType }> = [
   { label: '全部', value: 'all' },
   { label: '文档', value: 'document' },
   { label: 'FAQ', value: 'faq' },
 ]
 
-/** 获取资源类型文本 */
-export const getResourceTypeText = (type: string): string => {
-  const typeMap: Record<string, string> = {
-    document: '文档',
-    faq: 'FAQ',
-  }
-  return typeMap[type] || type
-}
+/** 获取审核资源类型文案。 */
+export const getResourceTypeText = (type: string) => ({ document: '文档', faq: 'FAQ' })[type] || type
 
-/** 获取资源类型颜色 */
-export const getResourceTypeColor = (type: string): string => {
-  const colorMap: Record<string, string> = {
-    document: 'arcoblue',
-    faq: 'green',
-  }
-  return colorMap[type] || 'gray'
-}
+/** 获取审核资源类型颜色。 */
+export const getResourceTypeColor = (type: string) => ({ document: 'arcoblue', faq: 'green' })[type] || 'gray'
diff --git a/src/api/kb/trash.ts b/src/api/kb/trash.ts
index fae2522..263f6a4 100644
--- a/src/api/kb/trash.ts
+++ b/src/api/kb/trash.ts
@@ -1,26 +1,14 @@
 import { request } from '@/api/request'
+import type { KbReply } from './faq'
 
-/** API响应包装类型 */
-export interface ApiResponse<T = any> {
-  code: number
-  message: string
-  data: T
-}
+export type TrashResourceType = 'document' | 'faq'
 
-/** 分页响应类型 */
-export interface PaginatedResponse<T> {
-  total: number
-  page: number
-  page_size: number
-  data: T[]
-}
-
-/** 回收站记录 */
+/** 回收站记录。 */
 export interface TrashRecord {
   id: number
   created_at: string
   updated_at: string
-  resource_type: 'document' | 'faq'
+  resource_type: TrashResourceType
   resource_id: number
   resource_name: string
   deleted_by: number
@@ -31,58 +19,35 @@ export interface TrashRecord {
   remarks: string
 }
 
-/** 获取回收站列表参数 */
+export interface TrashPage {
+  total: number
+  page: number
+  page_size: number
+  data: TrashRecord[]
+}
+
 export interface FetchTrashListParams {
   page?: number
   page_size?: number
-  resource_type?: 'document' | 'faq'
+  resource_type?: TrashResourceType
 }
 
-/** 恢复资源请求参数 */
-export interface RestoreTrashParams {
-  id: number
-}
-
-/** 彻底删除请求参数 */
-export interface DeleteTrashParams {
-  id: number
-}
-
-/** 资源类型选项 */
-export const resourceTypeOptions = [
+export const resourceTypeOptions: Array<{ label: string; value: TrashResourceType }> = [
   { label: '文档', value: 'document' },
-  { label: '常见问题', value: 'faq' },
+  { label: 'FAQ', value: 'faq' },
 ]
 
-/** 获取资源类型文本 */
-export const getResourceTypeText = (type: string): string => {
-  const typeMap: Record<string, string> = {
-    document: '文档',
-    faq: '常见问题',
-  }
-  return typeMap[type] || type
-}
+/** 获取回收站资源类型文案。 */
+export const getResourceTypeText = (type: string) => ({ document: '文档', faq: 'FAQ' })[type] || type
 
-/** 获取资源类型颜色 */
-export const getResourceTypeColor = (type: string): string => {
-  const colorMap: Record<string, string> = {
-    document: 'blue',
-    faq: 'green',
-  }
-  return colorMap[type] || 'gray'
-}
+/** 获取回收站资源类型颜色。 */
+export const getResourceTypeColor = (type: string) => ({ document: 'blue', faq: 'green' })[type] || 'gray'
 
-/** 获取回收站列表 */
-export const fetchTrashList = (params?: FetchTrashListParams) => {
-  return request.get<ApiResponse<PaginatedResponse<TrashRecord>>>('/Kb/v1/trash/list', { params })
-}
+/** 获取回收站列表。 */
+export const fetchTrashList = (params: FetchTrashListParams) => request.get<KbReply<TrashPage>>('/Kb/v1/trash/list', { params })
 
-/** 恢复资源 */
-export const restoreTrash = (data: RestoreTrashParams) => {
-  return request.post<ApiResponse<string>>('/Kb/v1/trash/restore', data)
-}
+/** 恢复资源。 */
+export const restoreTrash = (id: number) => request.post<KbReply<string>>('/Kb/v1/trash/restore', { id })
 
-/** 彻底删除 */
-export const deleteTrash = (data: DeleteTrashParams) => {
-  return request.post<ApiResponse<string>>('/Kb/v1/trash/delete', data)
-}
+/** 彻底删除资源。 */
+export const deleteTrash = (id: number) => request.post<KbReply<string>>('/Kb/v1/trash/delete', { id })
diff --git a/src/router/local-menu-flat.ts b/src/router/local-menu-flat.ts
index c90623f..f38ca81 100644
--- a/src/router/local-menu-flat.ts
+++ b/src/router/local-menu-flat.ts
@@ -953,13 +953,13 @@ export const localMenuFlatItems: MenuItem[] = [
   {
     id: 64,
     identity: '019b591d-03e8-7d4b-b8cf-7a5142320c61',
-    title: '标签管理',
-    title_en: 'Tag Management',
-    code: 'ops:知识库管理:标签管理',
-    description: '知识库管理 - 标签管理',
+    title: '公共分类',
+    title_en: 'Category Management',
+    code: 'ops:知识库管理:公共分类',
+    description: '知识库管理 - 公共分类',
     app_id: 2,
     parent_id: 63,
-    menu_path: '/kb/tags',
+    menu_path: '/kb/categories',
     menu_icon: 'appstore',
     type: 1,
     sort_key: 46,
diff --git a/src/router/local-menu-items.ts b/src/router/local-menu-items.ts
index b0a99c8..4da361b 100644
--- a/src/router/local-menu-items.ts
+++ b/src/router/local-menu-items.ts
@@ -1125,13 +1125,13 @@ export const localMenuItems: MenuItem[] = [
       {
         id: 64,
         identity: '019b591d-03e8-7d4b-b8cf-7a5142320c61',
-        title: '标签管理',
-        title_en: 'Tag Management',
-        code: 'ops:知识库管理:标签管理',
-        description: '知识库管理 - 标签管理',
+        title: '公共分类',
+        title_en: 'Category Management',
+        code: 'ops:知识库管理:公共分类',
+        description: '知识库管理 - 公共分类',
         app_id: 2,
         parent_id: 63,
-        menu_path: '/kb/tags',
+        menu_path: '/kb/categories',
         menu_icon: 'appstore',
         type: 1,
         sort_key: 11,
diff --git a/src/views/ops/pages/kb/categories/index.vue b/src/views/ops/pages/kb/categories/index.vue
new file mode 100644
index 0000000..f9323b9
--- /dev/null
+++ b/src/views/ops/pages/kb/categories/index.vue
@@ -0,0 +1,363 @@
+<template>
+  <div class="category-page">
+    <Breadcrumb :items="['知识管理', '公共分类']" />
+    <div class="category-layout">
+      <a-card class="tree-card" title="分类树" :bordered="false">
+        <template #extra>
+          <a-space>
+            <a-button v-if="canManage" type="primary" size="small" @click="openCreate(0)">新增一级分类</a-button>
+            <a-button size="small" :loading="loading" @click="loadTree">刷新</a-button>
+          </a-space>
+        </template>
+        <a-spin :loading="loading" class="tree-loading">
+          <a-tree
+            v-if="treeData.length"
+            v-model:selected-keys="selectedKeys"
+            :data="treeData"
+            block-node
+            default-expand-all
+            @select="handleSelect"
+          >
+            <template #title="nodeData">
+              <span>{{ nodeData.title }}</span>
+              <a-tag v-if="nodeData.category.status === 'inactive'" color="gray" size="small">停用</a-tag>
+            </template>
+          </a-tree>
+          <a-empty v-else description="暂无公共分类" />
+        </a-spin>
+      </a-card>
+
+      <a-card class="detail-card" :bordered="false">
+        <template #title>{{ selectedCategory?.name || '分类详情' }}</template>
+        <template #extra>
+          <a-space v-if="selectedCategory && canManage">
+            <a-button v-if="selectedCategory.level < 3" type="primary" size="small" @click="openCreate(selectedCategory.id)">
+              新增子分类
+            </a-button>
+            <a-button size="small" @click="openEdit">编辑</a-button>
+            <a-button size="small" status="danger" @click="confirmDelete">删除</a-button>
+          </a-space>
+        </template>
+
+        <a-descriptions v-if="selectedCategory" :column="2" bordered>
+          <a-descriptions-item label="分类名称">{{ selectedCategory.name }}</a-descriptions-item>
+          <a-descriptions-item label="状态">
+            <a-tag :color="selectedCategory.status === 'active' ? 'green' : 'gray'">
+              {{ selectedCategory.status === 'active' ? '启用' : '停用' }}
+            </a-tag>
+          </a-descriptions-item>
+          <a-descriptions-item label="层级">第 {{ selectedCategory.level }} 级</a-descriptions-item>
+          <a-descriptions-item label="排序">{{ selectedCategory.sort_order }}</a-descriptions-item>
+          <a-descriptions-item label="文档数">{{ selectedCategory.doc_count }}</a-descriptions-item>
+          <a-descriptions-item label="FAQ 数">{{ selectedCategory.faq_count }}</a-descriptions-item>
+          <a-descriptions-item label="创建人">{{ selectedCategory.creator_name || '-' }}</a-descriptions-item>
+          <a-descriptions-item label="更新时间">{{ formatTime(selectedCategory.updated_at) }}</a-descriptions-item>
+          <a-descriptions-item label="描述" :span="2">{{ selectedCategory.description || '-' }}</a-descriptions-item>
+          <a-descriptions-item label="备注" :span="2">{{ selectedCategory.remarks || '-' }}</a-descriptions-item>
+        </a-descriptions>
+        <a-empty v-else description="请从左侧选择分类" />
+      </a-card>
+    </div>
+
+    <a-modal
+      v-model:visible="formVisible"
+      :title="editingCategory ? '编辑分类' : '新增分类'"
+      :ok-loading="submitting"
+      width="640px"
+      @ok="submitForm"
+      @cancel="closeForm"
+    >
+      <a-form ref="formRef" :model="form" layout="vertical">
+        <a-form-item label="分类名称" field="name" :rules="[{ required: true, message: '请输入分类名称' }]">
+          <a-input v-model="form.name" :max-length="100" placeholder="请输入分类名称" />
+        </a-form-item>
+        <a-row :gutter="16">
+          <a-col :span="12">
+            <a-form-item label="父分类" field="parent_id">
+              <a-select v-model="form.parent_id" placeholder="请选择父分类">
+                <a-option :value="0">无（一级分类）</a-option>
+                <a-option v-for="option in parentOptions" :key="option.id" :value="option.id">
+                  {{ option.label }}{{ option.status === 'inactive' ? '（停用）' : '' }}
+                </a-option>
+              </a-select>
+            </a-form-item>
+          </a-col>
+          <a-col :span="6">
+            <a-form-item label="排序" field="sort_order">
+              <a-input-number v-model="form.sort_order" :min="0" style="width: 100%" />
+            </a-form-item>
+          </a-col>
+          <a-col :span="6">
+            <a-form-item label="状态" field="status">
+              <a-select v-model="form.status">
+                <a-option value="active">启用</a-option>
+                <a-option value="inactive">停用</a-option>
+              </a-select>
+            </a-form-item>
+          </a-col>
+        </a-row>
+        <a-form-item label="描述" field="description">
+          <a-textarea v-model="form.description" :max-length="500" :auto-size="{ minRows: 3, maxRows: 6 }" />
+        </a-form-item>
+        <a-form-item label="备注" field="remarks">
+          <a-textarea v-model="form.remarks" :max-length="500" :auto-size="{ minRows: 2, maxRows: 4 }" />
+        </a-form-item>
+      </a-form>
+    </a-modal>
+  </div>
+</template>
+
+<script lang="ts" setup>
+import { computed, onMounted, reactive, ref } from 'vue'
+import axios from 'axios'
+import dayjs from 'dayjs'
+import { Message, Modal } from '@arco-design/web-vue'
+import type { FormInstance } from '@arco-design/web-vue'
+import {
+  createCategory,
+  deleteCategory,
+  fetchCategoryTree,
+  updateCategory,
+  type Category,
+  type CategoryStatus,
+  type CategoryTreeNode,
+} from '@/api/kb/category'
+import usePermissionCodes from '@/hooks/usePermissionCodes'
+
+interface TreeViewNode {
+  key: string
+  title: string
+  category: Category
+  children: TreeViewNode[]
+}
+
+interface ParentOption {
+  id: number
+  label: string
+  level: number
+  status: CategoryStatus
+}
+
+const { hasPermission } = usePermissionCodes()
+const canManage = computed(() => hasPermission('kb:content:manage'))
+const loading = ref(false)
+const tree = ref<CategoryTreeNode[]>([])
+const selectedKeys = ref<string[]>([])
+const selectedCategory = ref<Category | null>(null)
+let requestSequence = 0
+
+const treeData = computed<TreeViewNode[]>(() => tree.value.map((node) => toViewNode(node)))
+
+const formVisible = ref(false)
+const submitting = ref(false)
+const formRef = ref<FormInstance>()
+const editingCategory = ref<Category | null>(null)
+const form = reactive({
+  name: '',
+  description: '',
+  parent_id: 0,
+  sort_order: 0,
+  status: 'active' as CategoryStatus,
+  remarks: '',
+})
+
+const parentOptions = computed<ParentOption[]>(() => {
+  const excluded = editingCategory.value ? descendantIds(editingCategory.value.id) : new Set<number>()
+  if (editingCategory.value) excluded.add(editingCategory.value.id)
+  const subtreeHeight = editingCategory.value ? categorySubtreeHeight(editingCategory.value.id) : 1
+  return flattenTree(tree.value).filter((item) => !excluded.has(item.id) && item.level + subtreeHeight <= 3)
+})
+
+function toViewNode(node: CategoryTreeNode): TreeViewNode {
+  return {
+    key: String(node.id),
+    title: node.name,
+    category: node,
+    children: (node.children || []).map(toViewNode),
+  }
+}
+
+function flattenTree(nodes: CategoryTreeNode[], prefix = ''): ParentOption[] {
+  return nodes.flatMap((node) => {
+    const label = prefix ? `${prefix} / ${node.name}` : node.name
+    return [{ id: node.id, label, level: node.level, status: node.status }, ...flattenTree(node.children || [], label)]
+  })
+}
+
+function findCategory(nodes: CategoryTreeNode[], id: number): CategoryTreeNode | undefined {
+  for (const node of nodes) {
+    if (node.id === id) return node
+    const child = findCategory(node.children || [], id)
+    if (child) return child
+  }
+  return undefined
+}
+
+function descendantIds(id: number): Set<number> {
+  const result = new Set<number>()
+  const root = findCategory(tree.value, id)
+  const visit = (nodes: CategoryTreeNode[]) => {
+    nodes.forEach((node) => {
+      result.add(node.id)
+      visit(node.children || [])
+    })
+  }
+  if (root) visit(root.children || [])
+  return result
+}
+
+function categorySubtreeHeight(id: number): number {
+  const root = findCategory(tree.value, id)
+  if (!root?.children?.length) return 1
+  return 1 + Math.max(...root.children.map((child) => categorySubtreeHeight(child.id)))
+}
+
+/** 加载最新分类树，并保留仍存在的选中项。 */
+async function loadTree() {
+  const sequence = ++requestSequence
+  loading.value = true
+  try {
+    const reply = await fetchCategoryTree()
+    if (sequence !== requestSequence) return
+    if (reply.code !== 0) throw new Error(reply.message || '获取分类树失败')
+    tree.value = reply.details || []
+    const selectedID = selectedCategory.value?.id
+    const selected = selectedID ? findCategory(tree.value, selectedID) : tree.value[0]
+    selectedCategory.value = selected || null
+    selectedKeys.value = selected ? [String(selected.id)] : []
+  } catch (error) {
+    if (sequence === requestSequence) {
+      tree.value = []
+      selectedCategory.value = null
+      selectedKeys.value = []
+      showRequestError(error, '获取分类树失败')
+    }
+  } finally {
+    if (sequence === requestSequence) loading.value = false
+  }
+}
+
+function handleSelect(keys: Array<string | number>) {
+  const id = Number(keys[0])
+  selectedCategory.value = Number.isFinite(id) ? findCategory(tree.value, id) || null : null
+}
+
+function openCreate(parentID: number) {
+  editingCategory.value = null
+  Object.assign(form, { name: '', description: '', parent_id: parentID, sort_order: 0, status: 'active', remarks: '' })
+  formVisible.value = true
+}
+
+function openEdit() {
+  if (!selectedCategory.value) return
+  editingCategory.value = selectedCategory.value
+  Object.assign(form, {
+    name: selectedCategory.value.name,
+    description: selectedCategory.value.description,
+    parent_id: selectedCategory.value.parent_id,
+    sort_order: selectedCategory.value.sort_order,
+    status: selectedCategory.value.status,
+    remarks: selectedCategory.value.remarks,
+  })
+  formVisible.value = true
+}
+
+function closeForm() {
+  formVisible.value = false
+  editingCategory.value = null
+  formRef.value?.clearValidate()
+}
+
+async function submitForm() {
+  if (await formRef.value?.validate()) return false
+  submitting.value = true
+  try {
+    const payload = {
+      name: form.name.trim(),
+      description: form.description.trim(),
+      icon: editingCategory.value?.icon || '',
+      color: editingCategory.value?.color || '',
+      parent_id: form.parent_id,
+      sort_order: form.sort_order,
+      status: form.status,
+      remarks: form.remarks.trim(),
+    }
+    const reply = editingCategory.value ? await updateCategory({ ...payload, id: editingCategory.value.id }) : await createCategory(payload)
+    if (reply.code !== 0) throw new Error(reply.message || '保存分类失败')
+    Message.success(editingCategory.value ? '分类已更新' : '分类已创建')
+    closeForm()
+    await loadTree()
+    return true
+  } catch (error) {
+    showRequestError(error, '保存分类失败')
+    return false
+  } finally {
+    submitting.value = false
+  }
+}
+
+function confirmDelete() {
+  if (!selectedCategory.value) return
+  const category = selectedCategory.value
+  Modal.confirm({
+    title: '确认删除分类',
+    content: `确认删除「${category.name}」吗？存在子分类或内容时服务端将拒绝删除。`,
+    onOk: async () => {
+      try {
+        const reply = await deleteCategory(category.id)
+        if (reply.code !== 0) throw new Error(reply.message || '删除分类失败')
+        Message.success('分类已删除')
+        selectedCategory.value = null
+        await loadTree()
+      } catch (error) {
+        showRequestError(error, '删除分类失败')
+      }
+    },
+  })
+}
+
+function showRequestError(error: unknown, fallback: string) {
+  if (axios.isAxiosError(error)) {
+    const status = error.response?.status
+    const message = (error.response?.data as { message?: string } | undefined)?.message
+    if (status === 403) return Message.error('无操作权限')
+    if (status === 400 || status === 409) return Message.error(message || fallback)
+  }
+  Message.error(error instanceof Error && error.message ? error.message : fallback)
+}
+
+function formatTime(value: string) {
+  return value ? dayjs(value).format('YYYY-MM-DD HH:mm') : '-'
+}
+
+onMounted(loadTree)
+</script>
+
+<style scoped lang="less">
+.category-page {
+  padding: 0 20px 20px;
+}
+.category-layout {
+  display: grid;
+  grid-template-columns: 360px minmax(0, 1fr);
+  gap: 16px;
+  margin-top: 16px;
+}
+.tree-card,
+.detail-card {
+  min-height: 560px;
+}
+.tree-loading {
+  width: 100%;
+}
+:deep(.arco-tree-node-title) {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+}
+@media (max-width: 960px) {
+  .category-layout {
+    grid-template-columns: 1fr;
+  }
+}
+</style>
diff --git a/src/views/ops/pages/kb/favorite/index.vue b/src/views/ops/pages/kb/favorite/index.vue
index 2070577..e55bdf2 100644
--- a/src/views/ops/pages/kb/favorite/index.vue
+++ b/src/views/ops/pages/kb/favorite/index.vue
@@ -1,392 +1,259 @@
 <template>
-  <div class="container">
-    <a-card class="general-card" title="收藏管理">
-      <!-- 数据表格 -->
+  <div class="favorite-page">
+    <Breadcrumb :items="['知识管理', '我的收藏']" />
+    <a-card class="general-card" :bordered="false">
+      <template #title>我的收藏</template>
+      <template #extra><a-button :loading="loading" @click="loadFavorites">刷新</a-button></template>
+
+      <a-form :model="filters" layout="inline" class="filters" @submit-success="search">
+        <a-form-item label="资源类型">
+          <a-select v-model="filters.resource_type" placeholder="全部类型" allow-clear style="width: 160px">
+            <a-option value="document">文档</a-option>
+            <a-option value="faq">FAQ</a-option>
+          </a-select>
+        </a-form-item>
+        <a-form-item><a-button type="primary" html-type="submit">查询</a-button></a-form-item>
+      </a-form>
+
       <a-table
-        :data="tableData"
+        row-key="id"
+        :data="favorites"
         :columns="columns"
         :loading="loading"
         :pagination="pagination"
-        row-key="id"
-        @page-change="handlePageChange"
+        @page-change="changePage"
+        @page-size-change="changePageSize"
       >
-        <!-- 序号 -->
-        <template #index="{ rowIndex }">
-          {{ rowIndex + 1 + (pagination.current - 1) * pagination.pageSize }}
-        </template>
-
-        <!-- 资源类型 -->
         <template #resource_type="{ record }">
-          <a-tag :color="record.resource_type === 'document' ? 'blue' : 'green'">
-            {{ record.resource_type === 'document' ? '文档' : 'FAQ' }}
-          </a-tag>
-        </template>
-
-        <!-- 收藏时间 -->
-        <template #created_at="{ record }">
-          {{ formatDateTime(record.created_at) }}
-        </template>
-
-        <!-- 操作 -->
-        <template #actions="{ record }">
           <a-space>
-            <a-button type="text" size="small" :disabled="record.is_deleted" @click="handleView(record)">查看</a-button>
-            <a-button type="text" size="small" :disabled="record.is_deleted" @click="handleDownload(record)">下载</a-button>
-            <a-button type="text" size="small" status="danger" @click="handleUncollect(record)">取消收藏</a-button>
+            <a-tag :color="record.resource_type === 'document' ? 'blue' : 'green'">
+              {{ record.resource_type === 'document' ? '文档' : 'FAQ' }}
+            </a-tag>
+            <a-tag v-if="record.is_deleted" color="red">已删除</a-tag>
           </a-space>
         </template>
+        <template #created_at="{ record }">{{ formatTime(record.created_at) }}</template>
+        <template #actions="{ record }">
+          <a-space>
+            <a-button type="text" size="small" :disabled="record.is_deleted" @click="openDetail(record)">查看</a-button>
+            <a-button type="text" size="small" status="danger" :loading="actionID === record.id" @click="confirmUncollect(record)">
+              取消收藏
+            </a-button>
+          </a-space>
+        </template>
+        <template #empty><a-empty description="暂无收藏" /></template>
       </a-table>
     </a-card>
 
-    <!-- 文档详情对话框 -->
-    <a-modal v-model:visible="detailVisible" title="文档详情" :width="800" :footer="false" unmount-on-close>
-      <div v-if="currentResource" class="detail-content">
-        <a-descriptions :column="2" bordered>
-          <a-descriptions-item label="资源名称">
-            {{ currentResource.title || '-' }}
-          </a-descriptions-item>
-          <a-descriptions-item label="资源类型">
-            <a-tag color="blue">文档</a-tag>
-          </a-descriptions-item>
-          <a-descriptions-item label="作者">
-            {{ currentResource.author_name || '-' }}
-          </a-descriptions-item>
-          <a-descriptions-item label="状态">
-            <a-tag :color="getDocStatusColor(currentResource.status)">
-              {{ getDocStatusText(currentResource.status) }}
-            </a-tag>
-          </a-descriptions-item>
-          <a-descriptions-item label="发布时间">
-            {{ formatDateTime(currentResource.published_at) }}
-          </a-descriptions-item>
-          <a-descriptions-item label="浏览次数">
-            {{ currentResource.view_count || 0 }}
-          </a-descriptions-item>
-          <a-descriptions-item label="描述" :span="2">
-            {{ currentResource.description || '-' }}
-          </a-descriptions-item>
-          <a-descriptions-item label="内容" :span="2">
-            <div class="content-preview" v-html="currentResource.content || '-'"></div>
+    <a-drawer v-model:visible="detailVisible" :title="detailType === 'document' ? '文档详情' : 'FAQ 详情'" :width="720" :footer="false">
+      <a-spin :loading="detailLoading" class="detail-spin">
+        <a-descriptions v-if="detailType === 'document' && detailDocument" :column="2" bordered>
+          <a-descriptions-item label="标题" :span="2">{{ detailDocument.title }}</a-descriptions-item>
+          <a-descriptions-item label="作者">{{ detailDocument.author_name || `用户 ${detailDocument.author_id}` }}</a-descriptions-item>
+          <a-descriptions-item label="状态">{{ statusText(detailDocument.status) }}</a-descriptions-item>
+          <a-descriptions-item label="描述" :span="2">{{ detailDocument.description || '-' }}</a-descriptions-item>
+          <a-descriptions-item label="正文" :span="2">
+            <pre class="content-preview">{{ detailDocument.content }}</pre>
           </a-descriptions-item>
         </a-descriptions>
-      </div>
-    </a-modal>
-
-    <!-- FAQ详情对话框 -->
-    <a-modal v-model:visible="faqDetailVisible" title="FAQ详情" :width="800" :footer="false" unmount-on-close>
-      <div v-if="currentFaq" class="detail-content">
-        <a-descriptions :column="2" bordered>
-          <a-descriptions-item label="资源名称">
-            {{ currentFaq.question || '-' }}
-          </a-descriptions-item>
-          <a-descriptions-item label="资源类型">
-            <a-tag color="green">FAQ</a-tag>
-          </a-descriptions-item>
-          <a-descriptions-item label="状态">
-            <a-tag color="green">{{ currentFaq.status || '已发布' }}</a-tag>
-          </a-descriptions-item>
-          <a-descriptions-item label="浏览次数">
-            {{ currentFaq.view_count || 0 }}
-          </a-descriptions-item>
+        <a-descriptions v-else-if="detailType === 'faq' && detailFaq" :column="2" bordered>
+          <a-descriptions-item label="问题" :span="2">{{ detailFaq.question }}</a-descriptions-item>
+          <a-descriptions-item label="作者">{{ detailFaq.author_name || `用户 ${detailFaq.author_id}` }}</a-descriptions-item>
+          <a-descriptions-item label="状态">{{ statusText(detailFaq.status) }}</a-descriptions-item>
           <a-descriptions-item label="答案" :span="2">
-            <div class="content-preview" v-html="currentFaq.answer || '-'"></div>
+            <pre class="content-preview">{{ detailFaq.answer }}</pre>
           </a-descriptions-item>
+          <a-descriptions-item label="解决方案" :span="2">
+            <pre class="content-preview">{{ detailFaq.solution || '-' }}</pre>
+          </a-descriptions-item>
+          <a-descriptions-item label="处理步骤" :span="2">
+            <pre class="content-preview">{{ detailFaq.process_steps || '-' }}</pre>
+          </a-descriptions-item>
+          <a-descriptions-item label="适用范围" :span="2">{{ detailFaq.applicable_scope || '-' }}</a-descriptions-item>
         </a-descriptions>
-      </div>
-    </a-modal>
+      </a-spin>
+    </a-drawer>
   </div>
 </template>
 
 <script lang="ts" setup>
-import { ref, reactive, computed, onMounted } from 'vue'
+import { onMounted, reactive, ref } from 'vue'
+import axios from 'axios'
+import dayjs from 'dayjs'
 import { Message, Modal } from '@arco-design/web-vue'
 import type { TableColumnData } from '@arco-design/web-vue/es/table/interface'
 import { fetchFavoriteList, uncollectResource, type Favorite, type ResourceType } from '@/api/kb/favorite'
-import { request } from '@/api/request'
+import { fetchDocumentDetail, type Document, type DocumentStatus } from '@/api/kb/document'
+import { fetchFaqDetail, type Faq } from '@/api/kb/faq'
 
-// 状态管理
+const columns: TableColumnData[] = [
+  { title: '资源名称', dataIndex: 'resource_name', ellipsis: true, tooltip: true },
+  { title: '资源类型', dataIndex: 'resource_type', slotName: 'resource_type', width: 170, align: 'center' },
+  { title: '收藏备注', dataIndex: 'remarks', ellipsis: true, tooltip: true },
+  { title: '收藏时间', dataIndex: 'created_at', slotName: 'created_at', width: 180, align: 'center' },
+  { title: '操作', slotName: 'actions', width: 180, fixed: 'right', align: 'center' },
+]
+
+const filters = reactive<{ resource_type?: ResourceType }>({ resource_type: undefined })
+const favorites = ref<Favorite[]>([])
 const loading = ref(false)
-const tableData = ref<Favorite[]>([])
+const pagination = reactive({ current: 1, pageSize: 20, total: 0, showTotal: true, showPageSize: true })
+let listSequence = 0
+const actionID = ref(0)
 
-const pagination = reactive({
-  current: 1,
-  pageSize: 20,
-  total: 0,
-})
-
-// 表格列配置
-const columns = computed<TableColumnData[]>(() => [
-  {
-    title: '序号',
-    dataIndex: 'index',
-    slotName: 'index',
-    width: 70,
-    align: 'center',
-  },
-  {
-    title: '资源名称',
-    dataIndex: 'resource_name',
-    ellipsis: true,
-    tooltip: true,
-    width: 250,
-  },
-  {
-    title: '资源类型',
-    dataIndex: 'resource_type',
-    slotName: 'resource_type',
-    width: 100,
-    align: 'center',
-  },
-  {
-    title: '收藏时间',
-    dataIndex: 'created_at',
-    slotName: 'created_at',
-    width: 180,
-    align: 'center',
-  },
-  {
-    title: '操作',
-    slotName: 'actions',
-    width: 200,
-    fixed: 'right',
-  },
-])
-
-// 当前选中的资源
-const currentResource = ref<any>(null)
-const currentFaq = ref<any>(null)
-
-// 对话框可见性
 const detailVisible = ref(false)
-const faqDetailVisible = ref(false)
+const detailLoading = ref(false)
+const detailType = ref<ResourceType>('document')
+const detailDocument = ref<Document | null>(null)
+const detailFaq = ref<Faq | null>(null)
+let detailSequence = 0
 
-// 获取收藏列表
-const fetchFavorites = async () => {
+/** 加载当前用户收藏，忽略过期请求。 */
+async function loadFavorites() {
+  const sequence = ++listSequence
   loading.value = true
-
   try {
-    const params = {
+    const reply = await fetchFavoriteList({
       page: pagination.current,
       page_size: pagination.pageSize,
-    }
-
-    const res: any = await fetchFavoriteList(params)
-
-    if (res.code === 0) {
-      tableData.value = res.details?.data || []
-      pagination.total = res.details?.total || 0
-    } else {
-      Message.error(res.message || '获取收藏列表失败')
-      tableData.value = []
+      resource_type: filters.resource_type,
+    })
+    if (sequence !== listSequence) return
+    if (reply.code !== 0) throw new Error(reply.message || '获取收藏列表失败')
+    favorites.value = reply.details?.data || []
+    pagination.total = reply.details?.total || 0
+  } catch (error) {
+    if (sequence === listSequence) {
+      favorites.value = []
       pagination.total = 0
+      showRequestError(error, '获取收藏列表失败')
     }
-  } catch (error) {
-    console.error('获取收藏列表失败:', error)
-    Message.error('获取收藏列表失败')
-    tableData.value = []
-    pagination.total = 0
   } finally {
-    loading.value = false
+    if (sequence === listSequence) loading.value = false
   }
 }
 
-// 分页变化
-const handlePageChange = (current: number) => {
-  pagination.current = current
-  fetchFavorites()
+function search() {
+  pagination.current = 1
+  loadFavorites()
 }
 
-// 查看详情
-const handleView = async (record: Favorite) => {
+function changePage(page: number) {
+  pagination.current = page
+  loadFavorites()
+}
+
+function changePageSize(pageSize: number) {
+  pagination.current = 1
+  pagination.pageSize = pageSize
+  loadFavorites()
+}
+
+async function openDetail(record: Favorite) {
   if (record.is_deleted) {
-    Message.warning('该资源已被删除，无法查看')
+    Message.warning('资源已删除，无法查看详情')
     return
   }
-
+  const sequence = ++detailSequence
+  detailType.value = record.resource_type
+  detailDocument.value = null
+  detailFaq.value = null
+  detailVisible.value = true
+  detailLoading.value = true
   try {
     if (record.resource_type === 'document') {
-      // 如果有resource_data直接使用，否则请求详情
-      if (record.resource_data) {
-        currentResource.value = record.resource_data
-        detailVisible.value = true
-      } else {
-        const res = await request.get<any>(`/Kb/v1/document/${record.resource_id}`)
-        if (res.code === 0) {
-          currentResource.value = res.details
-          detailVisible.value = true
-        } else {
-          Message.error(res.message || '获取文档详情失败')
-        }
+      const cached = asDocument(record)
+      if (cached) detailDocument.value = cached
+      else {
+        const reply = await fetchDocumentDetail(record.resource_id)
+        if (sequence !== detailSequence) return
+        if (reply.code !== 0) throw new Error(reply.message || '获取文档详情失败')
+        detailDocument.value = reply.details
       }
-    } else if (record.resource_type === 'faq') {
-      // FAQ详情
-      if (record.resource_data) {
-        currentFaq.value = record.resource_data
-        faqDetailVisible.value = true
-      } else {
-        const res = await request.get<any>(`/Kb/v1/faq/${record.resource_id}`)
-        if (res.code === 0) {
-          currentFaq.value = res.details
-          faqDetailVisible.value = true
-        } else {
-          Message.error(res.message || '获取FAQ详情失败')
-        }
+    } else {
+      const cached = asFaq(record)
+      if (cached) detailFaq.value = cached
+      else {
+        const reply = await fetchFaqDetail(record.resource_id)
+        if (sequence !== detailSequence) return
+        if (reply.code !== 0) throw new Error(reply.message || '获取 FAQ 详情失败')
+        detailFaq.value = reply.details
       }
     }
   } catch (error) {
-    console.error('获取详情失败:', error)
-    Message.error('获取详情失败')
+    if (sequence === detailSequence) showRequestError(error, '获取收藏详情失败')
+  } finally {
+    if (sequence === detailSequence) detailLoading.value = false
   }
 }
 
-// 下载文档
-const handleDownload = async (record: Favorite) => {
-  if (record.is_deleted) {
-    Message.warning('该资源已被删除，无法下载')
-    return
-  }
-
-  try {
-    if (record.resource_type === 'document') {
-      // 调用文档下载接口
-      const res: any = await request.get<any>(`/Kb/v1/document/${record.resource_id}`)
-      if (res.code === 0) {
-        const doc = res.details
-        // 创建下载内容
-        const content = `# ${doc.title || '无标题'}\n\n## 描述\n${doc.description || '无描述'}\n\n## 内容\n${doc.content || '无内容'}`
-        const blob = new Blob([content], { type: 'text/markdown;charset=utf-8' })
-        const url = URL.createObjectURL(blob)
-        const link = document.createElement('a')
-        link.href = url
-        link.download = `${doc.title || 'document'}.md`
-        link.click()
-        URL.revokeObjectURL(url)
-        Message.success('下载成功')
-      } else {
-        Message.error(res.message || '获取文档失败')
-      }
-    } else if (record.resource_type === 'faq') {
-      // FAQ下载
-      const res = await request.get<any>(`/Kb/v1/faq/${record.resource_id}`)
-      if (res.code === 0) {
-        const faq = res.details
-        const content = `# ${faq.question || 'FAQ'}\n\n## 答案\n${faq.answer || '无答案'}`
-        const blob = new Blob([content], { type: 'text/markdown;charset=utf-8' })
-        const url = URL.createObjectURL(blob)
-        const link = document.createElement('a')
-        link.href = url
-        link.download = `FAQ-${faq.faq_no || 'unknown'}.md`
-        link.click()
-        URL.revokeObjectURL(url)
-        Message.success('下载成功')
-      } else {
-        Message.error(res.message || '获取FAQ失败')
-      }
-    }
-  } catch (error) {
-    console.error('下载失败:', error)
-    Message.error('下载失败')
-  }
+function asDocument(record: Favorite): Document | null {
+  if (record.resource_type !== 'document' || !record.resource_data) return null
+  return record.resource_data as Document
 }
 
-// 取消收藏
-const handleUncollect = (record: Favorite) => {
+function asFaq(record: Favorite): Faq | null {
+  if (record.resource_type !== 'faq' || !record.resource_data) return null
+  return record.resource_data as Faq
+}
+
+function confirmUncollect(record: Favorite) {
   Modal.confirm({
     title: '确认取消收藏',
     content: `确认取消收藏「${record.resource_name}」吗？`,
     onOk: async () => {
+      actionID.value = record.id
       try {
-        const res = await uncollectResource({
-          resource_type: record.resource_type,
-          resource_id: record.resource_id,
-        })
-
-        if (res.code === 0) {
-          Message.success('取消收藏成功')
-          fetchFavorites()
-        } else {
-          Message.error(res.message || '取消收藏失败')
-        }
+        const reply = await uncollectResource({ resource_type: record.resource_type, resource_id: record.resource_id })
+        if (reply.code !== 0) throw new Error(reply.message || '取消收藏失败')
+        Message.success('已取消收藏')
+        await loadFavorites()
       } catch (error) {
-        console.error('取消收藏失败:', error)
-        Message.error('取消收藏失败')
+        showRequestError(error, '取消收藏失败')
+      } finally {
+        actionID.value = 0
       }
     },
   })
 }
 
-// 格式化日期时间
-const formatDateTime = (dateStr?: string) => {
-  if (!dateStr) return '-'
-  // 处理多种日期格式
-  let date: Date
-  if (dateStr.includes('T')) {
-    date = new Date(dateStr)
-  } else {
-    // 格式: YYYY-MM-DD HH:mm:ss
-    date = new Date(dateStr.replace(' ', 'T'))
+function showRequestError(error: unknown, fallback: string) {
+  if (axios.isAxiosError(error)) {
+    const status = error.response?.status
+    const message = (error.response?.data as { message?: string } | undefined)?.message
+    if (status === 403) return Message.error('无操作权限')
+    if (status === 400 || status === 409) return Message.error(message || fallback)
   }
-
-  if (isNaN(date.getTime())) return dateStr
-
-  const year = date.getFullYear()
-  const month = String(date.getMonth() + 1).padStart(2, '0')
-  const day = String(date.getDate()).padStart(2, '0')
-  const hours = String(date.getHours()).padStart(2, '0')
-  const minutes = String(date.getMinutes()).padStart(2, '0')
-
-  return `${year}-${month}-${day} ${hours}:${minutes}`
+  Message.error(error instanceof Error && error.message ? error.message : fallback)
 }
 
-// 获取文档状态颜色
-const getDocStatusColor = (status?: string) => {
-  const colorMap: Record<string, string> = {
-    draft: 'gray',
-    published: 'green',
-    reviewed: 'blue',
-    rejected: 'red',
-  }
-  return colorMap[status || ''] || 'gray'
+function statusText(status: DocumentStatus) {
+  return { draft: '草稿', published: '待审核', reviewed: '已审核', rejected: '已拒绝' }[status]
 }
 
-// 获取文档状态文本
-const getDocStatusText = (status?: string) => {
-  const textMap: Record<string, string> = {
-    draft: '草稿',
-    published: '已发布',
-    reviewed: '已审核',
-    rejected: '已拒绝',
-  }
-  return textMap[status || ''] || '未知'
+function formatTime(value: string) {
+  return value ? dayjs(value).format('YYYY-MM-DD HH:mm') : '-'
 }
 
-// 初始化加载数据
-onMounted(() => {
-  fetchFavorites()
-})
-</script>
-
-<script lang="ts">
-export default {
-  name: 'FavoriteManage',
-}
+onMounted(loadFavorites)
 </script>
 
 <style scoped lang="less">
-.container {
-  padding: 20px;
+.favorite-page {
+  padding: 0 20px 20px;
 }
-
-.detail-content {
-  max-height: 60vh;
-  overflow-y: auto;
+.filters {
+  margin-bottom: 16px;
+}
+.detail-spin {
+  width: 100%;
 }
-
 .content-preview {
   max-height: 300px;
-  overflow-y: auto;
-  padding: 8px;
-  background-color: var(--color-fill-1);
-  border-radius: 4px;
+  margin: 0;
+  overflow: auto;
+  white-space: pre-wrap;
+  word-break: break-word;
+  font-family: inherit;
 }
 </style>
diff --git a/src/views/ops/pages/kb/items/index.vue b/src/views/ops/pages/kb/items/index.vue
index 88a8b21..e8f985f 100644
--- a/src/views/ops/pages/kb/items/index.vue
+++ b/src/views/ops/pages/kb/items/index.vue
@@ -1,1051 +1,613 @@
 <template>
-  <div class="kb-container">
-    <Breadcrumb :items="['知识管理', '知识库文档']" />
-
-    <div class="kb-content">
-      <!-- 左侧：文档列表 -->
-      <div class="kb-left-panel">
-        <a-card class="general-card" :body-style="{ padding: '12px' }">
-          <!-- 标签页切换 -->
-          <a-tabs v-model:active-key="activeTab" size="small" @change="handleTabChange">
-            <a-tab-pane key="mine" title="我的" />
-            <a-tab-pane key="all" title="全部" />
-          </a-tabs>
-
-          <!-- 搜索框 -->
-          <a-input-search
-            v-model="searchKeyword"
-            placeholder="搜索文档..."
-            allow-clear
-            @search="handleSearch"
-            @press-enter="handleSearch"
-          />
-
-          <!-- 工具栏 -->
-          <div class="list-toolbar">
-            <a-button type="primary" size="small" @click="handleCreate">
-              <template #icon><icon-plus /></template>
-              新建
-            </a-button>
-            <a-button size="small" @click="fetchData">
-              <template #icon><icon-refresh /></template>
-            </a-button>
-          </div>
-
-          <!-- 文档列表 -->
-          <div class="document-list">
-            <a-spin :loading="loading" style="width: 100%">
-              <a-empty v-if="documentList.length === 0" description="暂无文档" />
-              <div
-                v-for="doc in documentList"
-                :key="doc.id"
-                class="document-item"
-                :class="{ active: currentDocument?.id === doc.id }"
-                @click="handleSelectDocument(doc)"
-              >
-                <div class="doc-title">
-                  <icon-file class="doc-icon" />
-                  <span class="title-text">{{ doc.title }}</span>
-                </div>
-                <div class="doc-meta">
-                  <a-tag :color="getStatusColor(doc.status)" size="small">
-                    {{ getStatusText(doc.status) }}
-                  </a-tag>
-                  <span class="doc-time">{{ formatDate(doc.updated_at) }}</span>
-                </div>
-              </div>
-            </a-spin>
-          </div>
-
-          <!-- 分页 -->
-          <div class="list-pagination">
-            <a-pagination v-model:current="page" :total="total" :page-size="pageSize" size="small" simple @change="handlePageChange" />
-          </div>
-        </a-card>
+  <div class="document-page">
+    <Breadcrumb :items="['知识管理', '文档管理']" />
+    <a-card class="general-card" :bordered="false">
+      <div class="page-header">
+        <a-tabs v-model:active-key="scope" @change="handleScopeChange">
+          <a-tab-pane key="my" title="我的文档" />
+          <a-tab-pane key="all" title="全部文档" />
+        </a-tabs>
+        <a-space>
+          <a-button v-if="canCreate" type="primary" @click="openCreate">
+            <template #icon><icon-plus /></template>
+            新建文档
+          </a-button>
+          <a-button :loading="loading" @click="loadDocuments">
+            <template #icon><icon-refresh /></template>
+            刷新
+          </a-button>
+        </a-space>
       </div>
 
-      <!-- 右侧：Markdown编辑器 -->
-      <div class="kb-right-panel">
-        <a-card class="general-card editor-card">
-          <template #title>
-            <div class="editor-header">
-              <a-input v-if="isEditing" v-model="editForm.title" placeholder="请输入文档标题" :max-length="200" class="title-input" />
-              <span v-else class="title-text">
-                {{ currentDocument?.title || '请选择或新建文档' }}
+      <a-form :model="filters" layout="inline" class="filters" @submit-success="search">
+        <a-form-item label="关键词">
+          <a-input v-model="filters.keyword" placeholder="搜索标题、描述、正文或关键词" allow-clear style="width: 260px" />
+        </a-form-item>
+        <a-form-item label="公共分类">
+          <a-select v-model="filters.category_id" placeholder="全部分类" allow-clear allow-search style="width: 220px">
+            <a-option v-for="category in categoryOptions" :key="category.id" :value="category.id">
+              {{ category.label }}{{ category.status === 'inactive' ? '（停用）' : '' }}
+            </a-option>
+          </a-select>
+        </a-form-item>
+        <a-form-item v-if="scope === 'my'" label="状态">
+          <a-select v-model="filters.status" placeholder="全部状态" allow-clear style="width: 130px">
+            <a-option v-for="item in statusOptions" :key="item.value" :value="item.value">{{ item.label }}</a-option>
+          </a-select>
+        </a-form-item>
+        <a-form-item>
+          <a-space>
+            <a-button type="primary" html-type="submit">查询</a-button>
+            <a-button @click="resetFilters">重置</a-button>
+          </a-space>
+        </a-form-item>
+      </a-form>
+
+      <div class="content-layout">
+        <section class="document-list">
+          <a-spin :loading="loading" class="list-spin">
+            <a-empty v-if="!documents.length" :description="scope === 'my' ? '暂无我的文档' : '暂无已审核文档'" />
+            <button
+              v-for="document in documents"
+              :key="document.id"
+              type="button"
+              class="document-item"
+              :class="{ active: selected?.id === document.id }"
+              @click="selectDocument(document)"
+            >
+              <span class="document-title">{{ document.title }}</span>
+              <span class="document-meta">
+                <a-tag :color="statusColor(document.status)" size="small">{{ statusText(document.status) }}</a-tag>
+                <span>{{ categoryName(document.category_id) }}</span>
+                <span>{{ formatTime(document.updated_at) }}</span>
               </span>
-            </div>
-          </template>
-          <template #extra>
-            <a-space v-if="currentDocument || isEditing">
-              <!-- 编辑模式切换（仅在编辑状态时显示） -->
-              <a-button-group v-if="isEditing">
-                <a-button :type="editorMode === 'edit' ? 'primary' : 'secondary'" size="small" @click="editorMode = 'edit'">源码</a-button>
-                <a-button :type="editorMode === 'preview' ? 'primary' : 'secondary'" size="small" @click="editorMode = 'preview'">
-                  预览
-                </a-button>
-                <a-button :type="editorMode === 'split' ? 'primary' : 'secondary'" size="small" @click="editorMode = 'split'">
-                  分栏
-                </a-button>
-              </a-button-group>
+            </button>
+          </a-spin>
+          <a-pagination
+            v-model:current="pagination.current"
+            :page-size="pagination.pageSize"
+            :total="pagination.total"
+            simple
+            @change="changePage"
+          />
+        </section>
 
-              <!-- 操作按钮 -->
-              <template v-if="isEditing">
-                <a-button type="primary" size="small" :loading="saving" @click="handleSave">保存</a-button>
-                <a-button size="small" @click="handleCancelEdit">取消</a-button>
-              </template>
-              <template v-else-if="currentDocument">
-                <a-button v-if="activeTab === 'mine'" type="primary" size="small" @click="handleStartEdit">编辑</a-button>
-                <a-button
-                  v-if="activeTab === 'mine' && (currentDocument.status === 'draft' || currentDocument.status === 'rejected')"
-                  size="small"
-                  @click="handlePublish"
-                >
-                  发布
-                </a-button>
-                <a-button
-                  v-if="currentDocument.status === 'reviewed'"
-                  :type="isFavorited ? 'primary' : 'secondary'"
-                  size="small"
-                  @click="handleToggleFavorite"
-                >
-                  <template #icon>
-                    <icon-star-fill v-if="isFavorited" />
-                    <icon-star v-else />
-                  </template>
-                </a-button>
-                <a-button size="small" @click="handleDownload">
-                  <template #icon><icon-download /></template>
-                </a-button>
-                <a-button v-if="activeTab === 'mine'" size="small" status="danger" @click="handleDelete">删除</a-button>
-              </template>
-            </a-space>
-          </template>
-
-          <!-- 编辑器内容 -->
-          <div class="editor-content">
-            <template v-if="currentDocument || isEditing">
-              <!-- 文档元信息 -->
-              <div v-if="!isEditing && currentDocument" class="doc-info">
-                <a-descriptions :column="4" size="small">
-                  <a-descriptions-item label="类型">
-                    <a-tag :color="getTypeColor(currentDocument.type)" size="small">
-                      {{ getTypeText(currentDocument.type) }}
-                    </a-tag>
-                  </a-descriptions-item>
-                  <a-descriptions-item label="作者">{{ currentDocument.author_name }}</a-descriptions-item>
-                  <a-descriptions-item label="更新时间">{{ formatTime(currentDocument.updated_at) }}</a-descriptions-item>
-                  <a-descriptions-item label="浏览">{{ currentDocument.view_count }}次</a-descriptions-item>
-                  <a-descriptions-item label="检测点" :span="2">
-                    <a-typography-text code>{{ currentDocument.detection_point_ids || '未关联' }}</a-typography-text>
-                  </a-descriptions-item>
-                </a-descriptions>
-              </div>
-
-              <!-- 编辑表单 -->
-              <div v-if="isEditing" class="edit-form">
-                <a-form :model="editForm" layout="inline" size="small">
-                  <a-form-item label="类型">
-                    <a-select v-model="editForm.type" style="width: 120px">
-                      <a-option v-for="item in documentTypeOptions" :key="item.value" :value="item.value">
-                        {{ item.label }}
-                      </a-option>
-                    </a-select>
-                  </a-form-item>
-                  <a-form-item label="分类">
-                    <a-select v-model="editForm.category_id" placeholder="选择分类" allow-clear style="width: 150px">
-                      <a-option v-for="item in categoryOptions" :key="item.value" :value="item.value">
-                        {{ item.label }}
-                      </a-option>
-                    </a-select>
-                  </a-form-item>
-                  <a-form-item label="检测点">
-                    <a-input v-model="editForm.detection_point_ids" placeholder="[1,2]" style="width: 180px" allow-clear />
-                  </a-form-item>
-                </a-form>
-              </div>
-
-              <!-- Markdown编辑/预览区域 -->
-              <div class="markdown-area" :class="isEditing ? editorMode : 'preview'">
-                <!-- 编辑区（仅在编辑状态时显示） -->
-                <div v-show="isEditing && (editorMode === 'edit' || editorMode === 'split')" class="editor-pane">
-                  <!-- 工具栏 -->
-                  <div class="md-toolbar">
-                    <a-space>
-                      <a-tooltip content="加粗 (Ctrl+B)">
-                        <a-button size="mini" @click="insertFormat('bold')">
-                          <template #icon><icon-bold /></template>
-                        </a-button>
-                      </a-tooltip>
-                      <a-tooltip content="斜体 (Ctrl+I)">
-                        <a-button size="mini" @click="insertFormat('italic')">
-                          <template #icon><icon-italic /></template>
-                        </a-button>
-                      </a-tooltip>
-                      <a-divider direction="vertical" />
-                      <a-tooltip content="标题">
-                        <a-dropdown @select="insertHeading">
-                          <a-button size="mini">
-                            <template #icon><icon-edit /></template>
-                          </a-button>
-                          <template #content>
-                            <a-doption value="h1">一级标题</a-doption>
-                            <a-doption value="h2">二级标题</a-doption>
-                            <a-doption value="h3">三级标题</a-doption>
-                          </template>
-                        </a-dropdown>
-                      </a-tooltip>
-                      <a-tooltip content="代码块">
-                        <a-button size="mini" @click="insertFormat('code')">
-                          <template #icon><icon-code /></template>
-                        </a-button>
-                      </a-tooltip>
-                      <a-tooltip content="链接">
-                        <a-button size="mini" @click="insertFormat('link')">
-                          <template #icon><icon-link /></template>
-                        </a-button>
-                      </a-tooltip>
-                      <a-tooltip content="列表">
-                        <a-button size="mini" @click="insertFormat('list')">
-                          <template #icon><icon-list /></template>
-                        </a-button>
-                      </a-tooltip>
-                    </a-space>
-                  </div>
-                  <!-- 文本编辑区 -->
-                  <a-textarea
-                    ref="editorRef"
-                    v-model="editContent"
-                    :auto-size="{ minRows: 20, maxRows: 40 }"
-                    placeholder="请输入文档内容，支持Markdown格式..."
-                    class="md-editor"
-                  />
-                </div>
-                <!-- 预览区（非编辑状态始终显示，编辑状态根据模式显示） -->
-                <div v-show="!isEditing || editorMode === 'preview' || editorMode === 'split'" class="preview-pane">
-                  <div class="md-preview" v-html="renderedContent"></div>
+        <section class="document-detail">
+          <a-spin :loading="detailLoading" class="detail-spin">
+            <template v-if="selected">
+              <div class="detail-header">
+                <div>
+                  <h2>{{ selected.title }}</h2>
+                  <a-space wrap>
+                    <a-tag :color="statusColor(selected.status)">{{ statusText(selected.status) }}</a-tag>
+                    <a-tag>{{ typeText(selected.type) }}</a-tag>
+                    <span>{{ selected.author_name || `用户 ${selected.author_id}` }}</span>
+                  </a-space>
                 </div>
+                <a-space wrap>
+                  <a-button :loading="favoriteLoading" @click="toggleFavorite">
+                    <template #icon>
+                      <icon-star-fill v-if="selected.is_favorited" />
+                      <icon-star v-else />
+                    </template>
+                    {{ selected.is_favorited ? '取消收藏' : '收藏' }}
+                  </a-button>
+                  <a-button v-if="canEdit(selected)" type="primary" @click="openEdit">编辑</a-button>
+                  <a-button v-if="canSubmit(selected)" @click="confirmPublish">提交审核</a-button>
+                  <a-button v-if="canDelete(selected)" status="danger" @click="confirmDelete">删除</a-button>
+                </a-space>
               </div>
+              <a-descriptions :column="3" bordered size="small" class="metadata">
+                <a-descriptions-item label="文档编号">{{ selected.doc_no }}</a-descriptions-item>
+                <a-descriptions-item label="公共分类">{{ categoryName(selected.category_id) }}</a-descriptions-item>
+                <a-descriptions-item label="更新时间">{{ formatTime(selected.updated_at) }}</a-descriptions-item>
+                <a-descriptions-item label="描述" :span="3">{{ selected.description || '-' }}</a-descriptions-item>
+                <a-descriptions-item label="关键词" :span="3">{{ selected.keywords || '-' }}</a-descriptions-item>
+              </a-descriptions>
+              <h3>正文</h3>
+              <pre class="document-content">{{ selected.content }}</pre>
             </template>
-            <a-empty v-else description="请从左侧选择文档或新建文档" />
-          </div>
-        </a-card>
+            <a-empty v-else description="请从左侧选择文档" />
+          </a-spin>
+        </section>
       </div>
-    </div>
+    </a-card>
 
-    <!-- 删除确认对话框 -->
-    <a-modal v-model:visible="deleteConfirmVisible" title="删除确认" @ok="handleConfirmDelete" @cancel="deleteConfirmVisible = false">
-      <p>确定要删除文档「{{ currentDocument?.title }}」吗？</p>
-      <p style="color: rgb(var(--warning-6))">删除后文档将移入回收站。</p>
-    </a-modal>
+    <a-drawer
+      v-model:visible="formVisible"
+      :title="editing ? '编辑文档' : '新建文档'"
+      :width="720"
+      :ok-loading="saving"
+      @ok="saveDocument"
+      @cancel="closeForm"
+    >
+      <a-form ref="formRef" :model="form" layout="vertical">
+        <a-form-item label="标题" field="title" :rules="[{ required: true, message: '请输入标题' }]">
+          <a-input v-model="form.title" :max-length="200" />
+        </a-form-item>
+        <a-row :gutter="16">
+          <a-col :span="12">
+            <a-form-item label="类型" field="type">
+              <a-select v-model="form.type">
+                <a-option v-for="item in documentTypeOptions" :key="item.value" :value="item.value">{{ item.label }}</a-option>
+              </a-select>
+            </a-form-item>
+          </a-col>
+          <a-col :span="12">
+            <a-form-item label="公共分类" field="category_id">
+              <a-select v-model="form.category_id" placeholder="请选择启用分类" allow-clear allow-search>
+                <a-option v-for="category in activeCategoryOptions" :key="category.id" :value="category.id">
+                  {{ category.label }}
+                </a-option>
+              </a-select>
+            </a-form-item>
+          </a-col>
+        </a-row>
+        <a-form-item label="描述" field="description">
+          <a-textarea v-model="form.description" :max-length="1000" :auto-size="{ minRows: 2, maxRows: 4 }" />
+        </a-form-item>
+        <a-form-item label="正文" field="content" :rules="[{ required: true, message: '请输入正文' }]">
+          <a-textarea v-model="form.content" :auto-size="{ minRows: 16, maxRows: 30 }" />
+        </a-form-item>
+        <a-form-item label="关键词" field="keywords">
+          <a-input v-model="form.keywords" :max-length="500" placeholder="多个关键词可用逗号分隔" />
+        </a-form-item>
+        <a-form-item label="标签" field="tags">
+          <a-input v-model="form.tags" placeholder='JSON 数组，例如 ["运维"]' />
+        </a-form-item>
+        <a-form-item label="检测点 ID" field="detection_point_ids">
+          <a-input v-model="form.detection_point_ids" placeholder="JSON 数组，例如 [1,2]" />
+        </a-form-item>
+        <a-form-item label="备注" field="remarks">
+          <a-textarea v-model="form.remarks" :auto-size="{ minRows: 2, maxRows: 4 }" />
+        </a-form-item>
+      </a-form>
+    </a-drawer>
   </div>
 </template>
 
 <script lang="ts" setup>
-import { ref, reactive, computed, watch, onMounted, nextTick } from 'vue'
-import { Message } from '@arco-design/web-vue'
-import {
-  IconPlus,
-  IconRefresh,
-  IconFile,
-  IconBold,
-  IconItalic,
-  IconCode,
-  IconLink,
-  IconList,
-  IconDownload,
-  IconStar,
-  IconStarFill,
-  IconEdit,
-} from '@arco-design/web-vue/es/icon'
+import { computed, onMounted, reactive, ref } from 'vue'
+import axios from 'axios'
 import dayjs from 'dayjs'
-import type { Document, DocumentStatus, DocumentType, FetchDocumentListParams } from '@/api/kb/document'
+import { Message, Modal } from '@arco-design/web-vue'
+import type { FormInstance } from '@arco-design/web-vue'
+import { IconPlus, IconRefresh, IconStar, IconStarFill } from '@arco-design/web-vue/es/icon'
 import {
-  fetchMyDocumentList,
-  fetchApprovedDocumentList,
-  fetchDocumentDetail,
   createDocument,
-  updateDocument,
-  publishDocument,
-  moveToTrash,
+  deleteDocument,
+  documentTypeOptions,
   favoriteDocument,
+  fetchDocumentDetail,
+  fetchDocumentList,
+  publishDocument,
   unfavoriteDocument,
+  updateDocument,
+  type Document,
+  type DocumentScope,
+  type DocumentStatus,
+  type DocumentType,
 } from '@/api/kb/document'
-import { fetchCategoryList } from '@/api/kb/category'
-import { documentTypeOptions } from './config/options'
+import { fetchCategoryTree, type CategoryStatus, type CategoryTreeNode } from '@/api/kb/category'
+import usePermissionCodes from '@/hooks/usePermissionCodes'
+import { useUserStore } from '@/store'
+import SafeStorage, { AppStorageKey } from '@/utils/safeStorage'
 
-// 当前标签页
-const activeTab = ref<'mine' | 'all'>('mine')
+interface CategoryOption {
+  id: number
+  label: string
+  status: CategoryStatus
+}
 
-// 搜索
-const searchKeyword = ref('')
+const statusOptions: Array<{ label: string; value: DocumentStatus }> = [
+  { label: '草稿', value: 'draft' },
+  { label: '待审核', value: 'published' },
+  { label: '已审核', value: 'reviewed' },
+  { label: '已拒绝', value: 'rejected' },
+]
 
-// 文档列表
-const documentList = ref<Document[]>([])
-const resourceTypeMap = ref<Record<number, string>>({}) // 保存 id -> resource_type 的映射
+const userStore = useUserStore()
+const { hasPermission } = usePermissionCodes()
+const canCreate = computed(() => hasPermission('kb:content:create'))
+const canManage = computed(() => hasPermission('kb:content:manage'))
+const currentUserID = computed(() => {
+  let source = userStore.$state.userInfo as Record<string, unknown> | null | undefined
+  if (!source || typeof source !== 'object') source = SafeStorage.get<Record<string, unknown>>(AppStorageKey.USER_INFO)
+  const value = Number(source?.user_id ?? source?.id)
+  return Number.isFinite(value) ? value : 0
+})
+
+const scope = ref<DocumentScope>('my')
+const filters = reactive<{ keyword: string; category_id?: number; status?: DocumentStatus }>({
+  keyword: '',
+  category_id: undefined,
+  status: undefined,
+})
+const documents = ref<Document[]>([])
 const loading = ref(false)
-const page = ref(1)
-const pageSize = ref(20)
-const total = ref(0)
+const pagination = reactive({ current: 1, pageSize: 20, total: 0 })
+let listSequence = 0
 
-// 当前选中的文档
-const currentDocument = ref<Document | null>(null)
-const currentResourceType = ref<string>('document') // 外层类型：document 或 faq
-const isFavorited = ref(false)
+const categories = ref<CategoryTreeNode[]>([])
+const categoryOptions = computed<CategoryOption[]>(() => flattenCategories(categories.value))
+const activeCategoryOptions = computed(() => categoryOptions.value.filter((item) => item.status === 'active'))
+const categoryLabels = computed(() => new Map(categoryOptions.value.map((item) => [item.id, item.label])))
 
-// 编辑状态
-const isEditing = ref(false)
+const selected = ref<Document | null>(null)
+const detailLoading = ref(false)
+let detailSequence = 0
+const favoriteLoading = ref(false)
+
+const formVisible = ref(false)
+const formRef = ref<FormInstance>()
+const editing = ref<Document | null>(null)
 const saving = ref(false)
-const editForm = reactive({
+const form = reactive({
   title: '',
-  type: 'common' as DocumentType,
-  category_id: undefined as number | undefined,
   description: '',
+  content: '',
+  type: 'common' as DocumentType,
+  category_id: 0,
+  sub_category: '',
+  keywords: '',
+  tags: '',
   detection_point_ids: '',
-})
-const editContent = ref('')
-const editorRef = ref()
-
-// 编辑器模式
-const editorMode = ref<'edit' | 'preview' | 'split'>('split')
-
-// 分类选项
-const categoryOptions = ref<{ label: string; value: number }[]>([])
-
-// 删除确认
-const deleteConfirmVisible = ref(false)
-
-// 渲染Markdown内容
-const renderedContent = computed(() => {
-  const content = isEditing.value ? editContent.value : currentDocument.value?.content
-  if (!content) return ''
-
-  let html = content
-  // 标题
-  html = html.replace(/^### (.*$)/gim, '<h3>$1</h3>')
-  html = html.replace(/^## (.*$)/gim, '<h2>$1</h2>')
-  html = html.replace(/^# (.*$)/gim, '<h1>$1</h1>')
-  // 粗体
-  html = html.replace(/\*\*(.*?)\*\*/g, '<strong>$1</strong>')
-  // 斜体
-  html = html.replace(/\*(.*?)\*/g, '<em>$1</em>')
-  // 代码块
-  html = html.replace(/```([\s\S]*?)```/g, '<pre><code>$1</code></pre>')
-  // 行内代码
-  html = html.replace(/`(.*?)`/g, '<code>$1</code>')
-  // 链接
-  html = html.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2" target="_blank">$1</a>')
-  // 列表
-  html = html.replace(/^\- (.*$)/gim, '<li>$1</li>')
-  html = html.replace(/^\d+\. (.*$)/gim, '<li>$1</li>')
-  // 段落
-  html = html.replace(/\n\n/g, '</p><p>')
-  html = `<p>${html}</p>`
-  return html
+  remarks: '',
 })
 
-// 获取文档列表
-const fetchData = async () => {
+function flattenCategories(nodes: CategoryTreeNode[], prefix = ''): CategoryOption[] {
+  return nodes.flatMap((node) => {
+    const label = prefix ? `${prefix} / ${node.name}` : node.name
+    return [{ id: node.id, label, status: node.status }, ...flattenCategories(node.children || [], label)]
+  })
+}
+
+function categoryName(id: number) {
+  return categoryLabels.value.get(id) || (id ? `分类 ${id}` : '未分类')
+}
+
+/** 按服务端规则判断文档是否可修改。 */
+function canMutate(document: Document) {
+  if (document.status === 'published') return false
+  if (document.status === 'reviewed') return canManage.value
+  if (document.status !== 'draft' && document.status !== 'rejected') return false
+  return canManage.value || (canCreate.value && currentUserID.value > 0 && document.author_id === currentUserID.value)
+}
+
+function canEdit(document: Document) {
+  return canMutate(document)
+}
+
+function canSubmit(document: Document) {
+  return (document.status === 'draft' || document.status === 'rejected') && canMutate(document)
+}
+
+function canDelete(document: Document) {
+  return canMutate(document)
+}
+
+async function loadCategories() {
   try {
-    loading.value = true
-    const params: FetchDocumentListParams = {
-      page: page.value,
-      page_size: pageSize.value,
-      keyword: searchKeyword.value || undefined,
-    }
-
-    console.log('fetchData params:', params, 'activeTab:', activeTab.value)
-
-    const res: any = activeTab.value === 'mine' ? await fetchMyDocumentList(params) : await fetchApprovedDocumentList(params)
-
-    console.log('fetchData response:', res)
-
-    // 兼容多种API响应格式
-    if (res?.code === 0) {
-      let rawData: any[] = []
-
-      // 格式1: res.details.data
-      if (res.details?.data) {
-        rawData = res.details.data || []
-        total.value = res.details.total || 0
-      }
-      // 格式2: res.data.data
-      else if (res.data?.data) {
-        rawData = res.data.data || []
-        total.value = res.data.total || 0
-      }
-      // 格式3: res.data 是数组
-      else if (Array.isArray(res.data)) {
-        rawData = res.data
-        total.value = res.data.length
-      }
-      // 格式4: res.details 是数组
-      else if (Array.isArray(res.details)) {
-        rawData = res.details
-        total.value = res.details.length
-      }
-
-      // 处理数据：提取 resource 字段（document 和 faq 都作为文档处理）
-      // 同时保存每个文档对应的 resource_type
-      documentList.value = rawData.map((item: any) => {
-        // 保存 id -> resource_type 的映射
-        if (item.resource?.id && item.type) {
-          resourceTypeMap.value[item.resource.id] = item.type
-        }
-        return item.resource
-      })
-    } else {
-      documentList.value = []
-      total.value = 0
-    }
-
-    console.log('documentList:', documentList.value, 'total:', total.value)
+    const reply = await fetchCategoryTree()
+    if (reply.code !== 0) throw new Error(reply.message || '获取分类失败')
+    categories.value = reply.details || []
   } catch (error) {
-    console.error('获取文档列表失败:', error)
-    documentList.value = []
-    total.value = 0
+    categories.value = []
+    showRequestError(error, '获取分类失败')
+  }
+}
+
+/** 加载当前范围文档，忽略过期请求。 */
+async function loadDocuments() {
+  const sequence = ++listSequence
+  loading.value = true
+  try {
+    const reply = await fetchDocumentList({
+      page: pagination.current,
+      page_size: pagination.pageSize,
+      scope: scope.value,
+      keyword: filters.keyword.trim() || undefined,
+      category_id: filters.category_id,
+      status: scope.value === 'my' ? filters.status : undefined,
+    })
+    if (sequence !== listSequence) return
+    if (reply.code !== 0) throw new Error(reply.message || '获取文档列表失败')
+    documents.value = reply.details?.data || []
+    pagination.total = reply.details?.total || 0
+    if (selected.value && !documents.value.some((item) => item.id === selected.value?.id)) selected.value = null
+  } catch (error) {
+    if (sequence === listSequence) {
+      documents.value = []
+      pagination.total = 0
+      showRequestError(error, '获取文档列表失败')
+    }
   } finally {
-    loading.value = false
+    if (sequence === listSequence) loading.value = false
   }
 }
 
-// 加载分类
-const loadCategories = async () => {
+async function selectDocument(document: Document) {
+  const sequence = ++detailSequence
+  detailLoading.value = true
   try {
-    const res: any = await fetchCategoryList({ type: 'document' })
-    // 兼容多种API响应格式
-    let categoryList: any[] = []
-    if (res?.code === 0 && Array.isArray(res.details)) {
-      categoryList = res.details
-    }
-    categoryOptions.value = categoryList.map((item: any) => ({
-      label: item.name,
-      value: item.id,
-    }))
+    const reply = await fetchDocumentDetail(document.id)
+    if (sequence !== detailSequence) return
+    if (reply.code !== 0) throw new Error(reply.message || '获取文档详情失败')
+    selected.value = reply.details
   } catch (error) {
-    console.error('加载分类失败:', error)
-  }
-}
-
-// 标签页切换
-const handleTabChange = () => {
-  page.value = 1
-  currentDocument.value = null
-  isEditing.value = false
-  fetchData()
-}
-
-// 搜索
-const handleSearch = () => {
-  page.value = 1
-  fetchData()
-}
-
-// 分页
-const handlePageChange = (current: number) => {
-  page.value = current
-  fetchData()
-}
-
-// 选择文档
-const handleSelectDocument = async (doc: Document) => {
-  if (isEditing.value) {
-    // 如果正在编辑，提示保存
-    Message.warning('请先保存或取消当前编辑')
-    return
-  }
-
-  try {
-    loading.value = true
-    const res: any = await fetchDocumentDetail(doc.id)
-    if (res?.code === 0 && res.details) {
-      // 兼容两种响应格式：直接返回文档对象 或 { type, resource } 格式
-      const docData = res.details.resource || res.details
-      currentDocument.value = docData
-
-      // 从文档详情中获取收藏状态
-      isFavorited.value = docData.is_favorited || false
-
-      // 获取 resource_type：优先从列表映射中获取（因为详情接口可能不返回外层 type）
-      if (resourceTypeMap.value[doc.id]) {
-        currentResourceType.value = resourceTypeMap.value[doc.id]
-      } else if (res.details.type) {
-        // 备用：从详情响应中获取（注意：这可能是内层 type，如 common/guide）
-        currentResourceType.value = res.details.type
-      }
-    }
-  } catch (error) {
-    console.error('获取文档详情失败:', error)
-    Message.error('获取文档详情失败')
+    if (sequence === detailSequence) showRequestError(error, '获取文档详情失败')
   } finally {
-    loading.value = false
+    if (sequence === detailSequence) detailLoading.value = false
   }
 }
 
-// 新建文档
-const handleCreate = () => {
-  currentDocument.value = null
-  currentResourceType.value = 'document' // 新建时默认为 document
-  isFavorited.value = false
-  editForm.title = ''
-  editForm.type = 'common'
-  editForm.category_id = undefined
-  editForm.description = ''
-  editForm.detection_point_ids = ''
-  editContent.value = ''
-  isEditing.value = true
-  editorMode.value = 'edit'
-  loadCategories()
+function handleScopeChange() {
+  pagination.current = 1
+  selected.value = null
+  if (scope.value === 'all') filters.status = undefined
+  loadDocuments()
 }
 
-// 开始编辑
-const handleStartEdit = () => {
-  if (!currentDocument.value) return
-
-  editForm.title = currentDocument.value.title
-  editForm.type = currentDocument.value.type
-  editForm.category_id = currentDocument.value.category_id
-  editForm.description = currentDocument.value.description || ''
-  editForm.detection_point_ids = currentDocument.value.detection_point_ids || ''
-  editContent.value = currentDocument.value.content
-  isEditing.value = true
-  loadCategories()
+function search() {
+  pagination.current = 1
+  loadDocuments()
 }
 
-// 取消编辑
-const handleCancelEdit = () => {
-  isEditing.value = false
-  if (currentDocument.value) {
-    // 恢复原始内容
-    editContent.value = currentDocument.value.content
-  }
+function resetFilters() {
+  Object.assign(filters, { keyword: '', category_id: undefined, status: undefined })
+  pagination.current = 1
+  loadDocuments()
 }
 
-// 保存文档
-const handleSave = async () => {
-  if (!editForm.title.trim()) {
-    Message.warning('请输入文档标题')
-    return
-  }
-  if (!editContent.value.trim()) {
-    Message.warning('请输入文档内容')
-    return
-  }
+function changePage(page: number) {
+  pagination.current = page
+  loadDocuments()
+}
 
+function resetForm() {
+  Object.assign(form, {
+    title: '',
+    description: '',
+    content: '',
+    type: 'common',
+    category_id: 0,
+    sub_category: '',
+    keywords: '',
+    tags: '',
+    detection_point_ids: '',
+    remarks: '',
+  })
+}
+
+function openCreate() {
+  editing.value = null
+  resetForm()
+  formVisible.value = true
+}
+
+function openEdit() {
+  if (!selected.value || !canEdit(selected.value)) return
+  editing.value = selected.value
+  Object.assign(form, {
+    title: selected.value.title,
+    description: selected.value.description,
+    content: selected.value.content,
+    type: selected.value.type,
+    category_id: selected.value.category_id,
+    sub_category: selected.value.sub_category,
+    keywords: selected.value.keywords,
+    tags: selected.value.tags,
+    detection_point_ids: selected.value.detection_point_ids,
+    remarks: selected.value.remarks,
+  })
+  formVisible.value = true
+}
+
+function closeForm() {
+  formVisible.value = false
+  editing.value = null
+  formRef.value?.clearValidate()
+}
+
+async function saveDocument() {
+  if (await formRef.value?.validate()) return false
+  saving.value = true
   try {
-    saving.value = true
-    const data = {
-      title: editForm.title,
-      type: editForm.type,
-      category_id: editForm.category_id,
-      description: editForm.description,
-      detection_point_ids: editForm.detection_point_ids || undefined,
-      content: editContent.value,
-    }
-
-    if (currentDocument.value?.id) {
-      // 更新
-      await updateDocument({ ...data, id: currentDocument.value.id })
-      Message.success('更新成功')
-    } else {
-      // 新建
-      await createDocument(data)
-      Message.success('创建成功')
-    }
-
-    isEditing.value = false
-    await fetchData()
-
-    // 重新加载当前文档
-    if (currentDocument.value?.id) {
-      const res: any = await fetchDocumentDetail(currentDocument.value.id)
-      if (res?.code === 0) {
-        currentDocument.value = res.details
-      }
-    }
+    const payload = { ...form, title: form.title.trim(), content: form.content.trim() }
+    const reply = editing.value ? await updateDocument({ ...payload, id: editing.value.id }) : await createDocument(payload)
+    if (reply.code !== 0) throw new Error(reply.message || '保存文档失败')
+    Message.success(editing.value ? '文档已更新' : '文档已创建')
+    selected.value = reply.details
+    closeForm()
+    await loadDocuments()
+    return true
   } catch (error) {
-    console.error('保存失败:', error)
-    Message.error('保存失败')
+    showRequestError(error, '保存文档失败')
+    return false
   } finally {
     saving.value = false
   }
 }
 
-// 发布文档
-const handlePublish = async () => {
-  if (!currentDocument.value) return
-
-  try {
-    await publishDocument(currentDocument.value.id)
-    Message.success('发布成功，等待审核')
-    await fetchData()
-    // 重新加载当前文档
-    const res: any = await fetchDocumentDetail(currentDocument.value.id)
-    if (res?.code === 0) {
-      currentDocument.value = res.details
-    }
-  } catch (error) {
-    console.error('发布失败:', error)
-    Message.error('发布失败')
-  }
-}
-
-// 切换收藏
-const handleToggleFavorite = async () => {
-  if (!currentDocument.value) return
-
-  try {
-    if (isFavorited.value) {
-      await unfavoriteDocument(currentDocument.value.id)
-      Message.success('已取消收藏')
-    } else {
-      await favoriteDocument(currentDocument.value.id)
-      Message.success('收藏成功')
-    }
-    isFavorited.value = !isFavorited.value
-  } catch (error) {
-    console.error('操作失败:', error)
-    Message.error('操作失败')
-  }
-}
-
-// 下载文档
-const handleDownload = () => {
-  if (!currentDocument.value) return
-
-  const content =
-    `# ${currentDocument.value.title}\n\n` +
-    `文档编号: ${currentDocument.value.doc_no}\n` +
-    `作者: ${currentDocument.value.author_name}\n` +
-    `创建时间: ${formatTime(currentDocument.value.created_at)}\n\n` +
-    `## 描述\n\n${currentDocument.value.description || '无'}\n\n` +
-    `## 内容\n\n${currentDocument.value.content}`
-
-  const blob = new Blob([content], { type: 'text/markdown;charset=utf-8' })
-  const url = URL.createObjectURL(blob)
-  const link = window.document.createElement('a')
-  link.href = url
-  link.download = `${currentDocument.value.title}.md`
-  window.document.body.appendChild(link)
-  link.click()
-  window.document.body.removeChild(link)
-  URL.revokeObjectURL(url)
-
-  Message.success('下载成功')
-}
-
-// 删除文档
-const handleDelete = () => {
-  deleteConfirmVisible.value = true
-}
-
-// 确认删除
-const handleConfirmDelete = async () => {
-  if (!currentDocument.value?.id) return
-
-  try {
-    await moveToTrash(currentDocument.value.id, currentResourceType.value)
-    Message.success('删除成功，已移入回收站')
-    deleteConfirmVisible.value = false
-    currentDocument.value = null
-    await fetchData()
-  } catch (error) {
-    console.error('删除失败:', error)
-    Message.error('删除失败')
-  }
-}
-
-// 插入格式
-const insertFormat = (type: string) => {
-  const textarea = editorRef.value?.$el?.querySelector('textarea')
-  if (!textarea) return
-
-  const start = textarea.selectionStart
-  const end = textarea.selectionEnd
-  const selectedText = editContent.value.substring(start, end)
-  let newText = ''
-
-  switch (type) {
-    case 'bold':
-      newText = `**${selectedText || '粗体文本'}**`
-      break
-    case 'italic':
-      newText = `*${selectedText || '斜体文本'}*`
-      break
-    case 'code':
-      newText = selectedText.includes('\n') ? `\`\`\`\n${selectedText || '代码块'}\n\`\`\`` : `\`${selectedText || '代码'}\``
-      break
-    case 'link':
-      newText = `[${selectedText || '链接文本'}](url)`
-      break
-    case 'list':
-      newText = `\n- ${selectedText || '列表项'}`
-      break
-    default:
-      newText = selectedText
-  }
-
-  editContent.value = editContent.value.substring(0, start) + newText + editContent.value.substring(end)
-
-  nextTick(() => {
-    textarea.focus()
-    const newCursorPos = start + newText.length
-    textarea.setSelectionRange(newCursorPos, newCursorPos)
+function confirmPublish() {
+  if (!selected.value) return
+  const document = selected.value
+  Modal.confirm({
+    title: '提交审核',
+    content: `确认提交「${document.title}」审核吗？提交后将变为只读。`,
+    onOk: async () => {
+      try {
+        const reply = await publishDocument(document.id)
+        if (reply.code !== 0) throw new Error(reply.message || '提交审核失败')
+        Message.success(reply.message || '已提交审核')
+        await loadDocuments()
+        if (documents.value.some((item) => item.id === document.id)) await selectDocument(document)
+        else selected.value = null
+      } catch (error) {
+        showRequestError(error, '提交审核失败')
+      }
+    },
   })
 }
 
-// 插入标题
-const insertHeading = (level: string | number) => {
-  const textarea = editorRef.value?.$el?.querySelector('textarea')
-  if (!textarea) return
-
-  const start = textarea.selectionStart
-  const prefix = level === 'h1' ? '# ' : level === 'h2' ? '## ' : '### '
-  const selectedText = editContent.value.substring(start, textarea.selectionEnd)
-
-  editContent.value =
-    editContent.value.substring(0, start) + prefix + (selectedText || '标题') + editContent.value.substring(textarea.selectionEnd)
+function confirmDelete() {
+  if (!selected.value) return
+  const document = selected.value
+  Modal.confirm({
+    title: '确认删除',
+    content: `确认删除「${document.title}」吗？删除后可在回收站恢复。`,
+    onOk: async () => {
+      try {
+        const reply = await deleteDocument(document.id)
+        if (reply.code !== 0) throw new Error(reply.message || '删除文档失败')
+        Message.success('文档已移入回收站')
+        selected.value = null
+        await loadDocuments()
+      } catch (error) {
+        showRequestError(error, '删除文档失败')
+      }
+    },
+  })
 }
 
-// 格式化函数
-const formatTime = (time: string | null): string => {
-  return time ? dayjs(time).format('YYYY-MM-DD HH:mm') : '-'
-}
-
-const formatDate = (time: string | null): string => {
-  return time ? dayjs(time).format('MM-DD HH:mm') : '-'
-}
-
-const getStatusText = (status: DocumentStatus): string => {
-  const map: Record<DocumentStatus, string> = {
-    draft: '草稿',
-    published: '已发布',
-    reviewed: '已审核',
-    rejected: '未通过',
+async function toggleFavorite() {
+  if (!selected.value || favoriteLoading.value) return
+  favoriteLoading.value = true
+  try {
+    const reply = selected.value.is_favorited ? await unfavoriteDocument(selected.value.id) : await favoriteDocument(selected.value.id)
+    if (reply.code !== 0) throw new Error(reply.message || '收藏操作失败')
+    selected.value = { ...selected.value, is_favorited: !selected.value.is_favorited }
+    Message.success(selected.value.is_favorited ? '已收藏' : '已取消收藏')
+  } catch (error) {
+    showRequestError(error, '收藏操作失败')
+  } finally {
+    favoriteLoading.value = false
   }
-  return map[status] || status
 }
 
-const getStatusColor = (status: DocumentStatus): string => {
-  const map: Record<DocumentStatus, string> = {
-    draft: 'gray',
-    published: 'blue',
-    reviewed: 'green',
-    rejected: 'red',
+function showRequestError(error: unknown, fallback: string) {
+  if (axios.isAxiosError(error)) {
+    const status = error.response?.status
+    const message = (error.response?.data as { message?: string } | undefined)?.message
+    if (status === 403) return Message.error('无操作权限')
+    if (status === 400 || status === 409) return Message.error(message || fallback)
   }
-  return map[status] || 'gray'
+  Message.error(error instanceof Error && error.message ? error.message : fallback)
 }
 
-const getTypeText = (type: DocumentType): string => {
-  const map: Record<DocumentType, string> = {
-    common: '通用',
-    guide: '指南',
-    solution: '方案',
-    troubleshoot: '排查',
-    process: '流程',
-    technical: '技术',
-  }
-  return map[type] || type
+function statusText(status: DocumentStatus) {
+  return { draft: '草稿', published: '待审核', reviewed: '已审核', rejected: '已拒绝' }[status]
 }
 
-const getTypeColor = (type: DocumentType): string => {
-  const map: Record<DocumentType, string> = {
-    common: 'gray',
-    guide: 'blue',
-    solution: 'green',
-    troubleshoot: 'orange',
-    process: 'purple',
-    technical: 'cyan',
-  }
-  return map[type] || 'gray'
+function statusColor(status: DocumentStatus) {
+  return { draft: 'gray', published: 'orange', reviewed: 'green', rejected: 'red' }[status]
 }
 
-// 初始化
-onMounted(() => {
-  fetchData()
+function typeText(type: DocumentType) {
+  return documentTypeOptions.find((item) => item.value === type)?.label || type
+}
+
+function formatTime(value: string | null) {
+  return value ? dayjs(value).format('YYYY-MM-DD HH:mm') : '-'
+}
+
+onMounted(async () => {
+  await Promise.all([loadCategories(), loadDocuments()])
 })
 </script>
 
-<script lang="ts">
-export default {
-  name: 'KbItems',
-}
-</script>
-
 <style scoped lang="less">
-.kb-container {
-  height: 100%;
-  display: flex;
-  flex-direction: column;
+.document-page {
   padding: 0 20px 20px;
 }
-
-.kb-content {
-  flex: 1;
+.page-header {
   display: flex;
+  align-items: center;
+  justify-content: space-between;
   gap: 16px;
-  min-height: 0;
-  margin-top: 16px;
 }
-
-.kb-left-panel {
-  width: 320px;
-  flex-shrink: 0;
-
-  .general-card {
-    height: 100%;
-    display: flex;
-    flex-direction: column;
-
-    :deep(.arco-card-body) {
-      flex: 1;
-      display: flex;
-      flex-direction: column;
-      min-height: 0;
-      overflow: hidden;
-    }
+.filters {
+  margin-bottom: 16px;
+}
+.content-layout {
+  display: grid;
+  grid-template-columns: 360px minmax(0, 1fr);
+  gap: 16px;
+  min-height: 560px;
+}
+.document-list {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  border-right: 1px solid var(--color-border);
+  padding-right: 16px;
+}
+.list-spin,
+.detail-spin {
+  width: 100%;
+}
+.document-item {
+  width: 100%;
+  border: 1px solid transparent;
+  background: none;
+  border-radius: 6px;
+  padding: 12px;
+  text-align: left;
+  cursor: pointer;
+  color: inherit;
+}
+.document-item:hover {
+  background: var(--color-fill-2);
+}
+.document-item.active {
+  background: rgb(var(--primary-1));
+  border-color: rgb(var(--primary-3));
+}
+.document-title {
+  display: block;
+  font-weight: 600;
+  margin-bottom: 8px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.document-meta {
+  display: flex;
+  gap: 8px;
+  align-items: center;
+  color: var(--color-text-3);
+  font-size: 12px;
+}
+.detail-header {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 16px;
+  margin-bottom: 16px;
+}
+.detail-header h2 {
+  margin: 0 0 8px;
+}
+.metadata {
+  margin-bottom: 20px;
+}
+.document-content {
+  white-space: pre-wrap;
+  word-break: break-word;
+  line-height: 1.8;
+  font-family: inherit;
+  background: var(--color-fill-1);
+  padding: 16px;
+  border-radius: 6px;
+}
+@media (max-width: 1000px) {
+  .content-layout {
+    grid-template-columns: 1fr;
   }
-
-  .list-toolbar {
-    display: flex;
-    justify-content: space-between;
-    margin-top: 12px;
-    margin-bottom: 12px;
-    flex-shrink: 0;
-  }
-
   .document-list {
-    flex: 1;
-    overflow-y: auto;
-    min-height: 100px;
-  }
-
-  .document-item {
-    padding: 10px 12px;
-    border-radius: 4px;
-    cursor: pointer;
-    transition: all 0.2s;
-    margin-bottom: 4px;
-
-    &:hover {
-      background-color: var(--color-fill-2);
-    }
-
-    &.active {
-      background-color: rgb(var(--primary-1));
-      border-left: 3px solid rgb(var(--primary-6));
-    }
-
-    .doc-title {
-      display: flex;
-      align-items: center;
-      gap: 8px;
-      margin-bottom: 6px;
-
-      .doc-icon {
-        color: var(--color-text-3);
-        flex-shrink: 0;
-      }
-
-      .title-text {
-        font-weight: 500;
-        overflow: hidden;
-        text-overflow: ellipsis;
-        white-space: nowrap;
-      }
-    }
-
-    .doc-meta {
-      display: flex;
-      align-items: center;
-      justify-content: space-between;
-
-      .doc-time {
-        font-size: 12px;
-        color: var(--color-text-3);
-      }
-    }
-  }
-
-  .list-pagination {
-    margin-top: 12px;
-    display: flex;
-    justify-content: center;
-    flex-shrink: 0;
-    padding-top: 8px;
-  }
-}
-
-.kb-right-panel {
-  flex: 1;
-  min-width: 0;
-
-  .editor-card {
-    height: 100%;
-    display: flex;
-    flex-direction: column;
-
-    :deep(.arco-card-body) {
-      flex: 1;
-      display: flex;
-      flex-direction: column;
-      padding: 12px;
-      min-height: 0;
-    }
-  }
-
-  .editor-header {
-    max-width: 80%;
-    .title-input {
-      font-size: 16px;
-      font-weight: 600;
-    }
-
-    .title-text {
-      font-size: 16px;
-      font-weight: 600;
-    }
-  }
-
-  .editor-content {
-    flex: 1;
-    display: flex;
-    flex-direction: column;
-    min-height: 0;
-  }
-
-  .doc-info {
-    margin-bottom: 12px;
-    padding-bottom: 12px;
+    border-right: 0;
     border-bottom: 1px solid var(--color-border);
-  }
-
-  .edit-form {
-    margin-bottom: 12px;
-    padding-bottom: 12px;
-    border-bottom: 1px solid var(--color-border);
-  }
-
-  .markdown-area {
-    flex: 1;
-    display: flex;
-    gap: 12px;
-    min-height: 0;
-
-    &.edit .editor-pane {
-      flex: 1;
-    }
-
-    &.preview .preview-pane {
-      flex: 1;
-    }
-
-    &.split {
-      .editor-pane,
-      .preview-pane {
-        flex: 1;
-      }
-    }
-  }
-
-  .editor-pane {
-    display: flex;
-    flex-direction: column;
-    min-width: 0;
-
-    .md-toolbar {
-      padding: 8px;
-      background-color: var(--color-fill-1);
-      border: 1px solid var(--color-border);
-      border-bottom: none;
-      border-radius: 4px 4px 0 0;
-    }
-
-    .md-editor {
-      flex: 1;
-      border-radius: 0 0 4px 4px;
-      font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;
-      font-size: 14px;
-      line-height: 1.6;
-    }
-  }
-
-  .preview-pane {
-    min-width: 0;
-    overflow: auto;
-    border: 1px solid var(--color-border);
-    border-radius: 4px;
-
-    .md-preview {
-      padding: 16px;
-      line-height: 1.8;
-      color: var(--color-text-1);
-
-      :deep(h1) {
-        font-size: 24px;
-        font-weight: 600;
-        margin: 16px 0;
-        padding-bottom: 8px;
-        border-bottom: 1px solid var(--color-border);
-      }
-
-      :deep(h2) {
-        font-size: 20px;
-        font-weight: 600;
-        margin: 14px 0;
-      }
-
-      :deep(h3) {
-        font-size: 16px;
-        font-weight: 600;
-        margin: 12px 0;
-      }
-
-      :deep(p) {
-        margin: 8px 0;
-      }
-
-      :deep(code) {
-        background-color: var(--color-fill-3);
-        padding: 2px 6px;
-        border-radius: 4px;
-        font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;
-        font-size: 13px;
-      }
-
-      :deep(pre) {
-        background-color: var(--color-fill-2);
-        padding: 12px;
-        border-radius: 4px;
-        overflow-x: auto;
-
-        code {
-          background: none;
-          padding: 0;
-        }
-      }
-
-      :deep(a) {
-        color: rgb(var(--primary-6));
-        text-decoration: none;
-
-        &:hover {
-          text-decoration: underline;
-        }
-      }
-
-      :deep(li) {
-        margin: 4px 0;
-        margin-left: 20px;
-      }
-
-      :deep(blockquote) {
-        margin: 8px 0;
-        padding: 8px 16px;
-        border-left: 4px solid rgb(var(--primary-6));
-        background-color: var(--color-fill-1);
-        color: var(--color-text-2);
-      }
-    }
+    padding: 0 0 16px;
   }
 }
 </style>
diff --git a/src/views/ops/pages/kb/recycle/index.vue b/src/views/ops/pages/kb/recycle/index.vue
index c2210cb..5288aad 100644
--- a/src/views/ops/pages/kb/recycle/index.vue
+++ b/src/views/ops/pages/kb/recycle/index.vue
@@ -1,298 +1,259 @@
 <template>
-  <div class="container">
-    <SearchTable
-      :form-model="searchForm"
-      :form-items="filters"
-      :data="tableData"
-      :columns="columns"
-      :loading="loading"
-      title="回收站"
-      :pagination="{
-        current: page,
-        pageSize,
-        total,
-      }"
-      :show-download="false"
-      @update:form-model="handleFormModelUpdate"
-      @search="handleSearch"
-      @reset="handleReset"
-      @page-change="handlePageChange"
-      @refresh="fetchData"
-    >
-      <!-- 序号列 -->
-      <template #index="{ rowIndex }">
-        {{ rowIndex + 1 + (page - 1) * pageSize }}
+  <div class="trash-page">
+    <Breadcrumb :items="['知识管理', '回收站']" />
+    <a-card class="general-card" :bordered="false">
+      <template #title>回收站</template>
+      <template #extra><a-button :loading="loading" :disabled="!canManage" @click="loadTrash">刷新</a-button></template>
+
+      <a-alert v-if="!canManage" type="warning">当前账号没有知识内容管理权限。</a-alert>
+      <template v-else>
+        <a-form :model="filters" layout="inline" class="filters" @submit-success="search">
+          <a-form-item label="资源类型">
+            <a-select v-model="filters.resource_type" placeholder="全部类型" allow-clear style="width: 160px">
+              <a-option v-for="option in resourceTypeOptions" :key="option.value" :value="option.value">
+                {{ option.label }}
+              </a-option>
+            </a-select>
+          </a-form-item>
+          <a-form-item><a-button type="primary" html-type="submit">查询</a-button></a-form-item>
+        </a-form>
+
+        <a-table
+          row-key="id"
+          :data="records"
+          :columns="columns"
+          :loading="loading"
+          :pagination="pagination"
+          @page-change="changePage"
+          @page-size-change="changePageSize"
+        >
+          <template #resource_type="{ record }">
+            <a-tag :color="getResourceTypeColor(record.resource_type)">{{ getResourceTypeText(record.resource_type) }}</a-tag>
+          </template>
+          <template #deleted_name="{ record }">{{ record.deleted_name || `用户 ${record.deleted_by}` }}</template>
+          <template #deleted_time="{ record }">{{ formatTime(record.deleted_time) }}</template>
+          <template #actions="{ record }">
+            <a-space>
+              <a-button type="text" size="small" @click="openDetail(record)">查看</a-button>
+              <a-button type="text" size="small" :loading="actionID === record.id" @click="confirmRestore(record)">恢复</a-button>
+              <a-button type="text" size="small" status="danger" :loading="actionID === record.id" @click="confirmDelete(record)">
+                彻底删除
+              </a-button>
+            </a-space>
+          </template>
+          <template #empty><a-empty description="回收站为空" /></template>
+        </a-table>
       </template>
+    </a-card>
 
-      <!-- 资源类型列 -->
-      <template #resource_type="{ record }">
-        <a-tag :color="getResourceTypeColor(record.resource_type)">
-          {{ getResourceTypeText(record.resource_type) }}
-        </a-tag>
-      </template>
-
-      <!-- 删除时间列 -->
-      <template #deleted_time="{ record }">
-        {{ formatTime(record.deleted_time) }}
-      </template>
-
-      <!-- 删除人列 -->
-      <template #deleted_name="{ record }">
-        {{ record.deleted_name || '-' }}
-      </template>
-
-      <!-- 操作列 -->
-      <template #operation="{ record }">
-        <a-space>
-          <a-button type="text" size="small" @click="handleRestore(record)">恢复</a-button>
-          <a-button type="text" size="small" status="danger" @click="handleDelete(record)">彻底删除</a-button>
-        </a-space>
-      </template>
-    </SearchTable>
-
-    <!-- 恢复确认对话框 -->
-    <a-modal v-model:visible="restoreConfirmVisible" title="恢复确认" @ok="handleConfirmRestore" @cancel="restoreConfirmVisible = false">
-      <p>确定要恢复「{{ recordToRestore?.resource_name }}」吗？</p>
-      <p style="color: rgb(var(--primary-6))">恢复后资源将回到正常状态。</p>
-    </a-modal>
-
-    <!-- 彻底删除确认对话框 -->
-    <a-modal v-model:visible="deleteConfirmVisible" title="彻底删除确认" @ok="handleConfirmDelete" @cancel="deleteConfirmVisible = false">
-      <p>确定要彻底删除「{{ recordToDelete?.resource_name }}」吗？</p>
-      <p style="color: rgb(var(--danger-6))">警告：此操作不可恢复，删除后将无法找回！</p>
-    </a-modal>
+    <a-drawer v-model:visible="detailVisible" title="已删除内容" :width="720" :footer="false">
+      <a-alert v-if="detailParseError" type="error" class="parse-alert">原始数据无法解析，恢复操作仍以服务端结果为准。</a-alert>
+      <a-descriptions v-if="detailRecord" :column="2" bordered>
+        <a-descriptions-item label="资源类型">
+          <a-tag :color="getResourceTypeColor(detailRecord.resource_type)">{{ getResourceTypeText(detailRecord.resource_type) }}</a-tag>
+        </a-descriptions-item>
+        <a-descriptions-item label="资源 ID">{{ detailRecord.resource_id }}</a-descriptions-item>
+        <a-descriptions-item :label="detailRecord.resource_type === 'document' ? '标题' : '问题'" :span="2">
+          {{ originalTitle || detailRecord.resource_name }}
+        </a-descriptions-item>
+        <a-descriptions-item label="删除人">{{ detailRecord.deleted_name || `用户 ${detailRecord.deleted_by}` }}</a-descriptions-item>
+        <a-descriptions-item label="删除时间">{{ formatTime(detailRecord.deleted_time) }}</a-descriptions-item>
+        <a-descriptions-item label="删除原因" :span="2">{{ detailRecord.delete_reason || '-' }}</a-descriptions-item>
+        <a-descriptions-item v-if="detailRecord.resource_type === 'document'" label="描述" :span="2">
+          {{ originalDocument?.description || '-' }}
+        </a-descriptions-item>
+        <a-descriptions-item v-if="detailRecord.resource_type === 'document'" label="正文" :span="2">
+          <pre class="content-preview">{{ originalDocument?.content || '-' }}</pre>
+        </a-descriptions-item>
+        <a-descriptions-item v-if="detailRecord.resource_type === 'faq'" label="答案" :span="2">
+          <pre class="content-preview">{{ originalFaq?.answer || '-' }}</pre>
+        </a-descriptions-item>
+        <a-descriptions-item v-if="detailRecord.resource_type === 'faq'" label="解决方案" :span="2">
+          <pre class="content-preview">{{ originalFaq?.solution || '-' }}</pre>
+        </a-descriptions-item>
+        <a-descriptions-item v-if="detailRecord.resource_type === 'faq'" label="处理步骤" :span="2">
+          <pre class="content-preview">{{ originalFaq?.process_steps || '-' }}</pre>
+        </a-descriptions-item>
+      </a-descriptions>
+    </a-drawer>
   </div>
 </template>
 
 <script lang="ts" setup>
-import { ref, reactive, computed, onMounted } from 'vue'
-import { Message } from '@arco-design/web-vue'
+import { computed, onMounted, reactive, ref } from 'vue'
+import axios from 'axios'
 import dayjs from 'dayjs'
-import SearchTable from '@/components/search-table/index.vue'
-import type { FormItem } from '@/components/search-form/types'
+import { Message, Modal } from '@arco-design/web-vue'
 import type { TableColumnData } from '@arco-design/web-vue/es/table/interface'
-import type { TrashRecord, FetchTrashListParams } from '@/api/kb/trash'
-import { fetchTrashList, restoreTrash, deleteTrash, getResourceTypeText, getResourceTypeColor, resourceTypeOptions } from '@/api/kb/trash'
+import {
+  deleteTrash,
+  fetchTrashList,
+  getResourceTypeColor,
+  getResourceTypeText,
+  resourceTypeOptions,
+  restoreTrash,
+  type TrashRecord,
+  type TrashResourceType,
+} from '@/api/kb/trash'
+import type { Document } from '@/api/kb/document'
+import type { Faq } from '@/api/kb/faq'
+import usePermissionCodes from '@/hooks/usePermissionCodes'
 
-// 表格列配置
-const columns = computed((): TableColumnData[] => [
-  {
-    title: '序号',
-    dataIndex: 'index',
-    slotName: 'index',
-    width: 80,
-    align: 'center',
-  },
-  {
-    title: '标题',
-    dataIndex: 'resource_name',
-    ellipsis: true,
-    tooltip: true,
-  },
-  {
-    title: '分类',
-    dataIndex: 'resource_type',
-    slotName: 'resource_type',
-    width: 120,
-    align: 'center',
-  },
-  {
-    title: '删除人',
-    dataIndex: 'deleted_name',
-    slotName: 'deleted_name',
-    width: 120,
-    align: 'center',
-  },
-  {
-    title: '删除时间',
-    dataIndex: 'deleted_time',
-    slotName: 'deleted_time',
-    width: 180,
-    align: 'center',
-    sortable: {
-      sortDirections: ['ascend', 'descend'],
-    },
-  },
-  {
-    title: '操作',
-    dataIndex: 'operation',
-    slotName: 'operation',
-    width: 180,
-    align: 'center',
-    fixed: 'right',
-  },
-])
+const columns: TableColumnData[] = [
+  { title: '资源名称', dataIndex: 'resource_name', ellipsis: true, tooltip: true },
+  { title: '资源类型', dataIndex: 'resource_type', slotName: 'resource_type', width: 120, align: 'center' },
+  { title: '删除人', dataIndex: 'deleted_name', slotName: 'deleted_name', width: 150 },
+  { title: '删除时间', dataIndex: 'deleted_time', slotName: 'deleted_time', width: 180, align: 'center' },
+  { title: '删除原因', dataIndex: 'delete_reason', ellipsis: true, tooltip: true },
+  { title: '操作', slotName: 'actions', width: 250, fixed: 'right', align: 'center' },
+]
 
-// 搜索表单配置
-const filters = computed((): FormItem[] => [
-  {
-    label: '关键词',
-    field: 'keyword',
-    type: 'input',
-    placeholder: '搜索标题',
-    span: 6,
-  },
-  {
-    label: '资源类型',
-    field: 'resource_type',
-    type: 'select',
-    placeholder: '请选择资源类型',
-    options: resourceTypeOptions,
-    span: 6,
-  },
-])
-
-// 搜索表单数据
-const searchForm = reactive({
-  keyword: '',
-  resource_type: '',
-})
-
-// 处理表单模型更新
-const handleFormModelUpdate = (newFormModel: Record<string, any>) => {
-  Object.assign(searchForm, newFormModel)
-}
-
-// 表格数据
-const tableData = ref<TrashRecord[]>([])
+const { hasPermission } = usePermissionCodes()
+const canManage = computed(() => hasPermission('kb:content:manage'))
+const filters = reactive<{ resource_type?: TrashResourceType }>({ resource_type: undefined })
+const records = ref<TrashRecord[]>([])
 const loading = ref(false)
+const pagination = reactive({ current: 1, pageSize: 20, total: 0, showTotal: true, showPageSize: true })
+let listSequence = 0
+const actionID = ref(0)
 
-// 分页
-const page = ref(1)
-const pageSize = ref(10)
-const total = ref(0)
+const detailVisible = ref(false)
+const detailRecord = ref<TrashRecord | null>(null)
+const originalDocument = ref<Document | null>(null)
+const originalFaq = ref<Faq | null>(null)
+const detailParseError = ref(false)
+const originalTitle = computed(() => originalDocument.value?.title || originalFaq.value?.question || '')
 
-// 恢复确认
-const restoreConfirmVisible = ref(false)
-const recordToRestore = ref<TrashRecord | null>(null)
-
-// 删除确认
-const deleteConfirmVisible = ref(false)
-const recordToDelete = ref<TrashRecord | null>(null)
-
-// 获取数据
-const fetchData = async () => {
+/** 加载回收站列表。 */
+async function loadTrash() {
+  if (!canManage.value) {
+    records.value = []
+    pagination.total = 0
+    return
+  }
+  const sequence = ++listSequence
+  loading.value = true
   try {
-    loading.value = true
-    const params: FetchTrashListParams = {
-      page: page.value,
-      page_size: pageSize.value,
-      resource_type: (searchForm.resource_type || undefined) as 'document' | 'faq' | undefined,
-    }
-
-    const res: any = await fetchTrashList(params)
-    console.log('获取回收站列表成功:', res)
-    if (res?.code === 0) {
-      // 如果有关键词，在前端过滤
-      let data = res.details?.data || []
-      if (searchForm.keyword) {
-        const keyword = searchForm.keyword.toLowerCase()
-        data = data.filter(
-          (item) => item.resource_name?.toLowerCase().includes(keyword) || item.deleted_name?.toLowerCase().includes(keyword)
-        )
-      }
-      tableData.value = data
-      total.value = res.details.total || 0
-    }
+    const reply = await fetchTrashList({
+      page: pagination.current,
+      page_size: pagination.pageSize,
+      resource_type: filters.resource_type,
+    })
+    if (sequence !== listSequence) return
+    if (reply.code !== 0) throw new Error(reply.message || '获取回收站失败')
+    records.value = reply.details?.data || []
+    pagination.total = reply.details?.total || 0
   } catch (error) {
-    console.error('获取回收站列表失败:', error)
-    Message.error('获取回收站列表失败')
+    if (sequence === listSequence) {
+      records.value = []
+      pagination.total = 0
+      showRequestError(error, '获取回收站失败')
+    }
   } finally {
-    loading.value = false
+    if (sequence === listSequence) loading.value = false
   }
 }
 
-// 搜索
-const handleSearch = () => {
-  page.value = 1
-  fetchData()
+function search() {
+  pagination.current = 1
+  loadTrash()
 }
 
-// 重置
-const handleReset = () => {
-  searchForm.keyword = ''
-  searchForm.resource_type = ''
-  page.value = 1
-  fetchData()
+function changePage(page: number) {
+  pagination.current = page
+  loadTrash()
 }
 
-// 页码变化
-const handlePageChange = (current: number) => {
-  page.value = current
-  fetchData()
+function changePageSize(pageSize: number) {
+  pagination.current = 1
+  pagination.pageSize = pageSize
+  loadTrash()
 }
 
-// 格式化时间
-const formatTime = (time: string | null): string => {
-  return time ? dayjs(time).format('YYYY-MM-DD HH:mm') : '-'
-}
-
-// 恢复资源
-const handleRestore = (record: TrashRecord) => {
-  recordToRestore.value = record
-  restoreConfirmVisible.value = true
-}
-
-// 确认恢复
-const handleConfirmRestore = async () => {
-  if (!recordToRestore.value?.id) return
-
+function openDetail(record: TrashRecord) {
+  detailRecord.value = record
+  originalDocument.value = null
+  originalFaq.value = null
+  detailParseError.value = false
   try {
-    loading.value = true
-    const res = await restoreTrash({ id: recordToRestore.value.id })
-    if (res?.code === 0) {
-      Message.success('恢复成功')
-      restoreConfirmVisible.value = false
-      recordToRestore.value = null
-      await fetchData()
-    } else {
-      Message.error(res?.message || '恢复失败')
-    }
+    const parsed: unknown = JSON.parse(record.original_data)
+    if (!parsed || typeof parsed !== 'object') throw new Error('invalid original_data')
+    if (record.resource_type === 'document') originalDocument.value = parsed as Document
+    else originalFaq.value = parsed as Faq
+  } catch {
+    detailParseError.value = true
+  }
+  detailVisible.value = true
+}
+
+function confirmRestore(record: TrashRecord) {
+  if (!canManage.value) return Message.error('无操作权限')
+  Modal.confirm({
+    title: '确认恢复',
+    content: `确认恢复${getResourceTypeText(record.resource_type)}「${record.resource_name}」吗？`,
+    onOk: () => runAction(record, 'restore'),
+  })
+}
+
+function confirmDelete(record: TrashRecord) {
+  if (!canManage.value) return Message.error('无操作权限')
+  Modal.confirm({
+    title: '确认彻底删除',
+    content: `彻底删除「${record.resource_name}」后不可恢复，是否继续？`,
+    okText: '彻底删除',
+    okButtonProps: { status: 'danger' },
+    onOk: () => runAction(record, 'delete'),
+  })
+}
+
+async function runAction(record: TrashRecord, action: 'restore' | 'delete') {
+  actionID.value = record.id
+  try {
+    const reply = action === 'restore' ? await restoreTrash(record.id) : await deleteTrash(record.id)
+    if (reply.code !== 0) throw new Error(reply.message || (action === 'restore' ? '恢复失败' : '彻底删除失败'))
+    Message.success(action === 'restore' ? '资源已恢复' : '资源已彻底删除')
+    if (detailRecord.value?.id === record.id) detailVisible.value = false
+    await loadTrash()
   } catch (error) {
-    console.error('恢复失败:', error)
-    Message.error('恢复失败')
+    showRequestError(error, action === 'restore' ? '恢复失败' : '彻底删除失败')
   } finally {
-    loading.value = false
+    actionID.value = 0
   }
 }
 
-// 彻底删除
-const handleDelete = (record: TrashRecord) => {
-  recordToDelete.value = record
-  deleteConfirmVisible.value = true
-}
-
-// 确认彻底删除
-const handleConfirmDelete = async () => {
-  if (!recordToDelete.value?.id) return
-
-  try {
-    loading.value = true
-    const res = await deleteTrash({ id: recordToDelete.value.id })
-    if (res?.code === 0) {
-      Message.success('彻底删除成功')
-      deleteConfirmVisible.value = false
-      recordToDelete.value = null
-      await fetchData()
-    } else {
-      Message.error(res?.message || '删除失败')
-    }
-  } catch (error) {
-    console.error('删除失败:', error)
-    Message.error('删除失败')
-  } finally {
-    loading.value = false
+function showRequestError(error: unknown, fallback: string) {
+  if (axios.isAxiosError(error)) {
+    const status = error.response?.status
+    const message = (error.response?.data as { message?: string } | undefined)?.message
+    if (status === 403) return Message.error('无操作权限')
+    if (status === 400 || status === 409) return Message.error(message || fallback)
   }
+  Message.error(error instanceof Error && error.message ? error.message : fallback)
 }
 
-// 初始化
-onMounted(() => {
-  fetchData()
-})
+function formatTime(value: string | null) {
+  return value ? dayjs(value).format('YYYY-MM-DD HH:mm') : '-'
+}
+
+onMounted(loadTrash)
 </script>
 
 <style scoped lang="less">
-.container {
-  margin-top: 20px;
+.trash-page {
+  padding: 0 20px 20px;
+}
+.filters {
+  margin-bottom: 16px;
+}
+.parse-alert {
+  margin-bottom: 16px;
+}
+.content-preview {
+  max-height: 300px;
+  margin: 0;
+  overflow: auto;
+  white-space: pre-wrap;
+  word-break: break-word;
+  font-family: inherit;
 }
 </style>
diff --git a/src/views/ops/pages/kb/review/index.vue b/src/views/ops/pages/kb/review/index.vue
index fc6b0af..0a2175d 100644
--- a/src/views/ops/pages/kb/review/index.vue
+++ b/src/views/ops/pages/kb/review/index.vue
@@ -1,131 +1,105 @@
 <template>
-  <div class="container">
-    <SearchTable
-      :form-model="searchForm"
-      :form-items="filters"
-      :data="tableData"
-      :columns="columns"
-      :loading="loading"
-      title="待审核列表"
-      :pagination="{
-        current: page,
-        pageSize,
-        total,
-      }"
-      :show-download="false"
-      @update:form-model="handleFormModelUpdate"
-      @search="handleSearch"
-      @reset="handleReset"
-      @page-change="handlePageChange"
-      @refresh="fetchData"
-    >
-      <!-- 序号列 -->
-      <template #index="{ rowIndex }">
-        {{ rowIndex + 1 + (page - 1) * pageSize }}
+  <div class="review-page">
+    <Breadcrumb :items="['知识管理', '内容审核']" />
+    <a-card class="general-card" :bordered="false">
+      <template #title>待审核内容</template>
+      <template #extra>
+        <a-button :loading="loading" :disabled="!canReview" @click="loadReviews">刷新</a-button>
       </template>
 
-      <!-- 分类列 -->
-      <template #category="{ record }">
-        <a-tag :color="getResourceTypeColor(record.type)">
-          {{ getResourceTypeText(record.type) }}
-        </a-tag>
+      <a-alert v-if="!canReview" type="warning">当前账号没有内容审核权限。</a-alert>
+      <template v-else>
+        <a-form :model="filters" layout="inline" class="filters" @submit-success="search">
+          <a-form-item label="资源类型">
+            <a-select v-model="filters.resource_type" style="width: 160px">
+              <a-option v-for="option in resourceTypeOptions" :key="option.value" :value="option.value">
+                {{ option.label }}
+              </a-option>
+            </a-select>
+          </a-form-item>
+          <a-form-item>
+            <a-button type="primary" html-type="submit">查询</a-button>
+          </a-form-item>
+        </a-form>
+
+        <a-table
+          row-key="review_key"
+          :data="tableData"
+          :columns="columns"
+          :loading="loading"
+          :pagination="pagination"
+          @page-change="changePage"
+          @page-size-change="changePageSize"
+        >
+          <template #type="{ record }">
+            <a-tag :color="getResourceTypeColor(record.type)">{{ getResourceTypeText(record.type) }}</a-tag>
+          </template>
+          <template #title="{ record }">{{ resourceTitle(record) }}</template>
+          <template #author="{ record }">
+            {{ record.resource.author_name || `用户 ${record.resource.author_id}` }}
+            <a-tag v-if="isSelfReview(record)" color="orange" size="small">自审</a-tag>
+          </template>
+          <template #created_at="{ record }">{{ formatTime(record.resource.created_at) }}</template>
+          <template #actions="{ record }">
+            <a-space>
+              <a-button type="text" size="small" @click="openDetail(record)">查看</a-button>
+              <a-button type="text" size="small" status="success" :loading="isActionLoading(record)" @click="confirmApprove(record)">
+                通过
+              </a-button>
+              <a-button type="text" size="small" status="danger" :loading="isActionLoading(record)" @click="openReject(record)">
+                拒绝
+              </a-button>
+            </a-space>
+          </template>
+          <template #empty><a-empty description="暂无待审核内容" /></template>
+        </a-table>
       </template>
+    </a-card>
 
-      <!-- 作者列 -->
-      <template #author="{ record }">
-        {{ record.resource?.author_name || '-' }}
-      </template>
+    <a-drawer v-model:visible="detailVisible" title="审核详情" :width="720" :footer="false">
+      <a-spin :loading="detailLoading" class="detail-spin">
+        <a-descriptions v-if="detailRecord" :column="2" bordered>
+          <a-descriptions-item label="资源类型">
+            <a-tag :color="getResourceTypeColor(detailRecord.type)">{{ getResourceTypeText(detailRecord.type) }}</a-tag>
+          </a-descriptions-item>
+          <a-descriptions-item label="编号">{{ resourceNumber(detailRecord) }}</a-descriptions-item>
+          <a-descriptions-item :label="detailRecord.type === 'faq' ? '问题' : '标题'" :span="2">
+            {{ resourceTitle(detailRecord) }}
+          </a-descriptions-item>
+          <a-descriptions-item label="作者">
+            {{ detailRecord.resource.author_name || `用户 ${detailRecord.resource.author_id}` }}
+          </a-descriptions-item>
+          <a-descriptions-item label="提交时间">{{ formatTime(detailRecord.resource.published_at) }}</a-descriptions-item>
+          <a-descriptions-item v-if="detailRecord.type === 'document'" label="描述" :span="2">
+            {{ documentOf(detailRecord)?.description || '-' }}
+          </a-descriptions-item>
+          <a-descriptions-item v-if="detailRecord.type === 'document'" label="正文" :span="2">
+            <pre class="content-preview">{{ documentOf(detailRecord)?.content || '-' }}</pre>
+          </a-descriptions-item>
+          <a-descriptions-item v-if="detailRecord.type === 'faq'" label="答案" :span="2">
+            <pre class="content-preview">{{ faqOf(detailRecord)?.answer || '-' }}</pre>
+          </a-descriptions-item>
+          <a-descriptions-item v-if="detailRecord.type === 'faq'" label="解决方案" :span="2">
+            <pre class="content-preview">{{ faqOf(detailRecord)?.solution || '-' }}</pre>
+          </a-descriptions-item>
+          <a-descriptions-item label="关键词" :span="2">{{ detailRecord.resource.keywords || '-' }}</a-descriptions-item>
+          <a-descriptions-item label="备注" :span="2">{{ detailRecord.resource.remarks || '-' }}</a-descriptions-item>
+        </a-descriptions>
+      </a-spin>
+    </a-drawer>
 
-      <!-- 申请时间列 -->
-      <template #created_at="{ record }">
-        {{ formatTime(record.resource?.created_at) }}
-      </template>
-
-      <!-- 描述列 -->
-      <template #description="{ record }">
-        <a-tooltip :content="record.resource?.description || record.resource?.question || '-'">
-          <span class="description-text">
-            {{ record.resource?.description || record.resource?.question || '-' }}
-          </span>
-        </a-tooltip>
-      </template>
-
-      <!-- 操作列 -->
-      <template #operation="{ record }">
-        <a-space>
-          <a-button type="text" size="small" @click="handleView(record)">查看</a-button>
-          <a-button type="text" size="small" status="success" @click="handleApprove(record)">审核通过</a-button>
-          <a-button type="text" size="small" status="danger" @click="handleReject(record)">拒绝</a-button>
-        </a-space>
-      </template>
-    </SearchTable>
-
-    <!-- 详情弹窗 -->
-    <a-modal v-model:visible="detailVisible" title="详情" :width="720" :footer="false">
-      <a-descriptions :column="2" bordered>
-        <a-descriptions-item label="类型">
-          <a-tag :color="getResourceTypeColor(currentRecord?.type || '')">
-            {{ getResourceTypeText(currentRecord?.type || '') }}
-          </a-tag>
-        </a-descriptions-item>
-        <a-descriptions-item label="编号">
-          {{ getResourceNo(currentRecord) }}
-        </a-descriptions-item>
-        <a-descriptions-item label="标题" :span="2">
-          {{ getResourceTitle(currentRecord) }}
-        </a-descriptions-item>
-        <a-descriptions-item label="作者">
-          {{ currentRecord?.resource?.author_name || '-' }}
-        </a-descriptions-item>
-        <a-descriptions-item label="创建时间">
-          {{ formatTime(currentRecord?.resource?.created_at) }}
-        </a-descriptions-item>
-        <a-descriptions-item label="分类">
-          {{ currentRecord?.resource?.sub_category || '-' }}
-        </a-descriptions-item>
-        <a-descriptions-item label="状态">
-          <a-tag :color="getStatusColor(currentRecord?.resource?.status)">
-            {{ getStatusText(currentRecord?.resource?.status) }}
-          </a-tag>
-        </a-descriptions-item>
-        <a-descriptions-item label="描述" :span="2">
-          {{ getResourceDescription(currentRecord) }}
-        </a-descriptions-item>
-        <a-descriptions-item label="关键词" :span="2">
-          {{ currentRecord?.resource?.keywords || '-' }}
-        </a-descriptions-item>
-        <a-descriptions-item label="标签" :span="2">
-          <a-space wrap>
-            <a-tag v-for="tag in parseTags(currentRecord?.resource?.tags)" :key="tag">
-              {{ tag }}
-            </a-tag>
-          </a-space>
-        </a-descriptions-item>
-        <a-descriptions-item v-if="currentRecord?.type === 'faq'" label="答案" :span="2">
-          <div class="content-preview">{{ getFaqAnswer(currentRecord) }}</div>
-        </a-descriptions-item>
-        <a-descriptions-item v-if="currentRecord?.type === 'document'" label="内容" :span="2">
-          <div class="content-preview">{{ getDocumentContent(currentRecord) }}</div>
-        </a-descriptions-item>
-      </a-descriptions>
-    </a-modal>
-
-    <!-- 拒绝原因对话框 -->
-    <a-modal
-      v-model:visible="rejectVisible"
-      title="拒绝原因"
-      :ok-loading="rejectLoading"
-      @ok="handleConfirmReject"
-      @cancel="handleCancelReject"
-    >
+    <a-modal v-model:visible="rejectVisible" title="拒绝审核" :ok-loading="actionLoading" @ok="confirmReject" @cancel="closeReject">
+      <a-alert v-if="rejectRecord && isSelfReview(rejectRecord)" type="warning" class="self-review-alert">
+        这是你创建的内容。提交后还会再次确认，并记录自审日志。
+      </a-alert>
       <a-form :model="rejectForm" layout="vertical">
         <a-form-item label="拒绝原因" required>
           <a-textarea
             v-model="rejectForm.reason"
-            placeholder="请输入拒绝原因"
             :max-length="500"
-            :auto-size="{ minRows: 3, maxRows: 6 }"
+            :auto-size="{ minRows: 4, maxRows: 8 }"
             show-word-limit
+            placeholder="请输入拒绝原因"
           />
         </a-form-item>
       </a-form>
@@ -134,341 +108,293 @@
 </template>
 
 <script lang="ts" setup>
-import { ref, reactive, computed, onMounted } from 'vue'
-import { Message, Modal } from '@arco-design/web-vue'
+import { computed, onMounted, reactive, ref } from 'vue'
+import axios from 'axios'
 import dayjs from 'dayjs'
-import SearchTable from '@/components/search-table/index.vue'
-import type { FormItem } from '@/components/search-form/types'
+import { Message, Modal } from '@arco-design/web-vue'
 import type { TableColumnData } from '@arco-design/web-vue/es/table/interface'
-import type { ReviewListItem, FetchReviewListParams } from '@/api/kb/review'
 import {
-  fetchReviewList,
   approveReview,
-  rejectReview,
-  getResourceTypeText,
+  fetchReviewList,
   getResourceTypeColor,
+  getResourceTypeText,
+  rejectReview,
   resourceTypeOptions,
+  type ReviewListItem,
+  type ReviewResourceType,
 } from '@/api/kb/review'
+import { fetchDocumentDetail, type Document } from '@/api/kb/document'
+import { fetchFaqDetail, type Faq } from '@/api/kb/faq'
+import usePermissionCodes from '@/hooks/usePermissionCodes'
+import { useUserStore } from '@/store'
+import SafeStorage, { AppStorageKey } from '@/utils/safeStorage'
 
-// 表格列配置
-const columns = computed((): TableColumnData[] => [
-  {
-    title: '序号',
-    dataIndex: 'index',
-    slotName: 'index',
-    width: 80,
-    align: 'center',
-  },
-  {
-    title: '分类',
-    dataIndex: 'category',
-    slotName: 'category',
-    width: 100,
-    align: 'center',
-  },
-  {
-    title: '作者',
-    dataIndex: 'author',
-    slotName: 'author',
-    width: 120,
-    align: 'center',
-  },
-  {
-    title: '申请时间',
-    dataIndex: 'created_at',
-    slotName: 'created_at',
-    width: 180,
-    align: 'center',
-    sortable: {
-      sortDirections: ['ascend', 'descend'],
-    },
-  },
-  {
-    title: '描述',
-    dataIndex: 'description',
-    slotName: 'description',
-    ellipsis: true,
-    tooltip: true,
-  },
-  {
-    title: '操作',
-    dataIndex: 'operation',
-    slotName: 'operation',
-    width: 280,
-    align: 'center',
-    fixed: 'right',
-  },
-])
+type ReviewRow = ReviewListItem & { review_key: string }
 
-// 搜索表单配置
-const filters = computed((): FormItem[] => [
-  {
-    label: '资源类型',
-    field: 'resource_type',
-    type: 'select',
-    placeholder: '请选择资源类型',
-    options: resourceTypeOptions,
-    span: 6,
-  },
-])
+const columns: TableColumnData[] = [
+  { title: '类型', dataIndex: 'type', slotName: 'type', width: 100, align: 'center' },
+  { title: '标题 / 问题', slotName: 'title', ellipsis: true, tooltip: true },
+  { title: '作者', slotName: 'author', width: 180 },
+  { title: '提交时间', slotName: 'created_at', width: 180, align: 'center' },
+  { title: '操作', slotName: 'actions', width: 230, fixed: 'right', align: 'center' },
+]
 
-// 搜索表单数据
-const searchForm = reactive({
-  resource_type: 'all',
+const { hasPermission } = usePermissionCodes()
+const canReview = computed(() => hasPermission('kb:content:review'))
+const canSelfReview = computed(() => hasPermission('kb:content:self-review'))
+const userStore = useUserStore()
+const currentUserID = computed(() => {
+  let source = userStore.$state.userInfo as Record<string, unknown> | null | undefined
+  if (!source || typeof source !== 'object') source = SafeStorage.get<Record<string, unknown>>(AppStorageKey.USER_INFO)
+  const value = Number(source?.user_id ?? source?.id)
+  return Number.isFinite(value) ? value : 0
 })
 
-// 处理表单模型更新
-const handleFormModelUpdate = (newFormModel: Record<string, any>) => {
-  Object.assign(searchForm, newFormModel)
+const filters = reactive<{ resource_type: ReviewResourceType }>({ resource_type: 'all' })
+const tableData = ref<ReviewRow[]>([])
+const loading = ref(false)
+const pagination = reactive({ current: 1, pageSize: 10, total: 0, showTotal: true, showPageSize: true })
+let listSequence = 0
+
+const detailVisible = ref(false)
+const detailLoading = ref(false)
+const detailRecord = ref<ReviewListItem | null>(null)
+let detailSequence = 0
+
+const actionLoading = ref(false)
+const actionKey = ref('')
+const rejectVisible = ref(false)
+const rejectRecord = ref<ReviewListItem | null>(null)
+const rejectForm = reactive({ reason: '' })
+
+function rowKey(record: ReviewListItem) {
+  return `${record.type}:${record.resource.id}`
 }
 
-// 表格数据
-const tableData = ref<ReviewListItem[]>([])
-const loading = ref(false)
+function isSelfReview(record: ReviewListItem) {
+  return currentUserID.value > 0 && record.resource.author_id === currentUserID.value
+}
 
-// 分页
-const page = ref(1)
-const pageSize = ref(10)
-const total = ref(0)
+function canOperate(record: ReviewListItem) {
+  return canReview.value && record.resource.status === 'published' && (!isSelfReview(record) || canSelfReview.value)
+}
 
-// 详情弹窗
-const detailVisible = ref(false)
-const currentRecord = ref<ReviewListItem | null>(null)
-
-// 拒绝对话框
-const rejectVisible = ref(false)
-const rejectLoading = ref(false)
-const recordToReject = ref<ReviewListItem | null>(null)
-const rejectForm = reactive({
-  reason: '',
-})
-
-// 获取数据
-const fetchData = async () => {
+/** 加载审核列表，并在前端再次排除无自审权限的本人内容。 */
+async function loadReviews() {
+  if (!canReview.value) {
+    tableData.value = []
+    pagination.total = 0
+    return
+  }
+  const sequence = ++listSequence
+  loading.value = true
   try {
-    loading.value = true
-    const params: FetchReviewListParams = {
-      page: page.value,
-      page_size: pageSize.value,
-      resource_type: searchForm.resource_type as 'all' | 'document' | 'faq',
+    const reply = await fetchReviewList({
+      page: pagination.current,
+      page_size: pagination.pageSize,
+      resource_type: filters.resource_type,
+    })
+    if (sequence !== listSequence) return
+    if (reply.code !== 0) throw new Error(reply.message || '获取审核列表失败')
+    const rows = (reply.details?.data || []).filter(canOperate)
+    tableData.value = rows.map((item) => ({ ...item, review_key: rowKey(item) }))
+    pagination.total = reply.details?.total || 0
+  } catch (error) {
+    if (sequence === listSequence) {
+      tableData.value = []
+      pagination.total = 0
+      showRequestError(error, '获取审核列表失败')
     }
+  } finally {
+    if (sequence === listSequence) loading.value = false
+  }
+}
 
-    const res: any = await fetchReviewList(params)
+function search() {
+  pagination.current = 1
+  loadReviews()
+}
 
-    if (res?.code === 0) {
-      tableData.value = res.details?.data || []
-      total.value = res.details?.total || 0
+function changePage(page: number) {
+  pagination.current = page
+  loadReviews()
+}
+
+function changePageSize(pageSize: number) {
+  pagination.current = 1
+  pagination.pageSize = pageSize
+  loadReviews()
+}
+
+async function openDetail(record: ReviewListItem) {
+  const sequence = ++detailSequence
+  detailVisible.value = true
+  detailLoading.value = true
+  detailRecord.value = record
+  try {
+    if (record.type === 'document') {
+      const reply = await fetchDocumentDetail(record.resource.id)
+      if (sequence !== detailSequence) return
+      if (reply.code !== 0) throw new Error(reply.message || '获取文档详情失败')
+      detailRecord.value = { type: 'document', resource: reply.details }
     } else {
-      Message.error(res?.message || '获取审核列表失败')
+      const reply = await fetchFaqDetail(record.resource.id)
+      if (sequence !== detailSequence) return
+      if (reply.code !== 0) throw new Error(reply.message || '获取 FAQ 详情失败')
+      detailRecord.value = { type: 'faq', resource: reply.details }
     }
   } catch (error) {
-    console.error('获取审核列表失败:', error)
-    Message.error('获取审核列表失败')
+    if (sequence === detailSequence) showRequestError(error, '获取审核详情失败')
   } finally {
-    loading.value = false
+    if (sequence === detailSequence) detailLoading.value = false
   }
 }
 
-// 搜索
-const handleSearch = () => {
-  page.value = 1
-  fetchData()
-}
+function confirmApprove(record: ReviewListItem) {
+  if (!canOperate(record)) return Message.error('无操作权限')
+  const openFinalConfirm = () =>
+    Modal.confirm({
+      title: '确认审核通过',
+      content: `确认通过${getResourceTypeText(record.type)}「${resourceTitle(record)}」吗？`,
+      okText: '确认通过',
+      onOk: () => runApprove(record),
+    })
 
-// 重置
-const handleReset = () => {
-  searchForm.resource_type = 'all'
-  page.value = 1
-  fetchData()
-}
-
-// 页码变化
-const handlePageChange = (current: number) => {
-  page.value = current
-  fetchData()
-}
-
-// 格式化时间
-const formatTime = (time: string | null | undefined): string => {
-  return time ? dayjs(time).format('YYYY-MM-DD HH:mm') : '-'
-}
-
-// 获取状态文本
-const getStatusText = (status: string | undefined): string => {
-  const statusMap: Record<string, string> = {
-    draft: '草稿',
-    published: '待审核',
-    reviewed: '已审核',
-    rejected: '已拒绝',
+  if (isSelfReview(record)) {
+    Modal.confirm({
+      title: '确认自审',
+      content: '这是你创建的内容。继续操作将记录自审日志，是否进入最终确认？',
+      okText: '继续',
+      onOk: openFinalConfirm,
+    })
+    return
   }
-  return statusMap[status || ''] || status || '-'
+  openFinalConfirm()
 }
 
-// 获取状态颜色
-const getStatusColor = (status: string | undefined): string => {
-  const colorMap: Record<string, string> = {
-    draft: 'gray',
-    published: 'orange',
-    reviewed: 'green',
-    rejected: 'red',
-  }
-  return colorMap[status || ''] || 'gray'
-}
-
-// 解析标签
-const parseTags = (tags: string | null | undefined): string[] => {
-  if (!tags) return []
+async function runApprove(record: ReviewListItem) {
+  actionLoading.value = true
+  actionKey.value = rowKey(record)
   try {
-    return JSON.parse(tags)
-  } catch {
-    return tags.split(',').filter(Boolean)
+    const reply = await approveReview({ resource_type: record.type, id: record.resource.id })
+    if (reply.code !== 0) throw new Error(reply.message || '审核失败')
+    Message.success('审核已通过')
+    await loadReviews()
+  } catch (error) {
+    showRequestError(error, '审核失败')
+  } finally {
+    actionLoading.value = false
+    actionKey.value = ''
   }
 }
 
-// 获取资源编号
-const getResourceNo = (record: ReviewListItem | null): string => {
-  if (!record?.resource) return '-'
-  const resource = record.resource as any
-  return resource.doc_no || resource.faq_no || '-'
-}
-
-// 获取资源标题
-const getResourceTitle = (record: ReviewListItem | null): string => {
-  if (!record?.resource) return '-'
-  const resource = record.resource as any
-  return resource.title || resource.question || '-'
-}
-
-// 获取资源描述
-const getResourceDescription = (record: ReviewListItem | null): string => {
-  if (!record?.resource) return '-'
-  const resource = record.resource as any
-  return resource.description || '-'
-}
-
-// 获取FAQ答案
-const getFaqAnswer = (record: ReviewListItem | null): string => {
-  if (!record?.resource) return '-'
-  const resource = record.resource as any
-  return resource.answer || '-'
-}
-
-// 获取文档内容
-const getDocumentContent = (record: ReviewListItem | null): string => {
-  if (!record?.resource) return '-'
-  const resource = record.resource as any
-  return resource.content || '-'
-}
-
-// 查看详情
-const handleView = (record: ReviewListItem) => {
-  currentRecord.value = record
-  detailVisible.value = true
-}
-
-// 审核通过
-const handleApprove = (record: ReviewListItem) => {
-  const resourceTitle = getResourceTitle(record)
-  const resourceTypeText = getResourceTypeText(record.type)
-
-  Modal.confirm({
-    title: '确认审核通过',
-    content: `确定要通过该${resourceTypeText}的审核吗？\n标题：${resourceTitle}`,
-    okText: '确认通过',
-    cancelText: '取消',
-    onOk: async () => {
-      try {
-        loading.value = true
-        const res: any = await approveReview({
-          resource_type: record.type,
-          id: record.resource.id,
-        })
-        if (res?.code === 0) {
-          Message.success('审核通过')
-          await fetchData()
-        } else {
-          Message.error(res?.message || '审核失败')
-        }
-      } catch (error) {
-        console.error('审核失败:', error)
-        Message.error('审核失败')
-      } finally {
-        loading.value = false
-      }
-    },
-  })
-}
-
-// 拒绝
-const handleReject = (record: ReviewListItem) => {
-  recordToReject.value = record
+function openReject(record: ReviewListItem) {
+  if (!canOperate(record)) return Message.error('无操作权限')
+  rejectRecord.value = record
   rejectForm.reason = ''
   rejectVisible.value = true
 }
 
-// 确认拒绝
-const handleConfirmReject = async () => {
-  if (!recordToReject.value) return
-
+function confirmReject() {
+  if (!rejectRecord.value) return false
   if (!rejectForm.reason.trim()) {
     Message.warning('请输入拒绝原因')
-    return
+    return false
   }
-
-  try {
-    rejectLoading.value = true
-    const res: any = await rejectReview({
-      resource_type: recordToReject.value.type,
-      id: recordToReject.value.resource.id,
-      reason: rejectForm.reason,
+  const record = rejectRecord.value
+  if (isSelfReview(record)) {
+    Modal.confirm({
+      title: '再次确认自审拒绝',
+      content: '确认拒绝自己创建的内容吗？本次操作将记录自审日志。',
+      okText: '确认拒绝',
+      onOk: () => runReject(record, rejectForm.reason.trim()),
     })
-    if (res?.code === 0) {
-      Message.success('已拒绝')
-      rejectVisible.value = false
-      recordToReject.value = null
-      rejectForm.reason = ''
-      await fetchData()
-    } else {
-      Message.error(res?.message || '拒绝失败')
-    }
+    return false
+  }
+  return runReject(record, rejectForm.reason.trim())
+}
+
+async function runReject(record: ReviewListItem, reason: string) {
+  actionLoading.value = true
+  actionKey.value = rowKey(record)
+  try {
+    const reply = await rejectReview({ resource_type: record.type, id: record.resource.id, reason })
+    if (reply.code !== 0) throw new Error(reply.message || '拒绝审核失败')
+    Message.success('审核已拒绝')
+    closeReject()
+    await loadReviews()
+    return true
   } catch (error) {
-    console.error('拒绝失败:', error)
-    Message.error('拒绝失败')
+    showRequestError(error, '拒绝审核失败')
+    return false
   } finally {
-    rejectLoading.value = false
+    actionLoading.value = false
+    actionKey.value = ''
   }
 }
 
-// 取消拒绝
-const handleCancelReject = () => {
+function closeReject() {
   rejectVisible.value = false
-  recordToReject.value = null
+  rejectRecord.value = null
   rejectForm.reason = ''
 }
 
-// 初始化
-onMounted(() => {
-  fetchData()
-})
+function isActionLoading(record: ReviewListItem) {
+  return actionLoading.value && actionKey.value === rowKey(record)
+}
+
+function documentOf(record: ReviewListItem | null): Document | null {
+  return record?.type === 'document' ? (record.resource as Document) : null
+}
+
+function faqOf(record: ReviewListItem | null): Faq | null {
+  return record?.type === 'faq' ? (record.resource as Faq) : null
+}
+
+function resourceTitle(record: ReviewListItem | null) {
+  return documentOf(record)?.title || faqOf(record)?.question || '-'
+}
+
+function resourceNumber(record: ReviewListItem | null) {
+  return documentOf(record)?.doc_no || faqOf(record)?.faq_no || '-'
+}
+
+function showRequestError(error: unknown, fallback: string) {
+  if (axios.isAxiosError(error)) {
+    const status = error.response?.status
+    const message = (error.response?.data as { message?: string } | undefined)?.message
+    if (status === 403) return Message.error('无操作权限')
+    if (status === 400 || status === 409) return Message.error(message || fallback)
+  }
+  Message.error(error instanceof Error && error.message ? error.message : fallback)
+}
+
+function formatTime(value: string | null | undefined) {
+  return value ? dayjs(value).format('YYYY-MM-DD HH:mm') : '-'
+}
+
+onMounted(loadReviews)
 </script>
 
 <style scoped lang="less">
-.container {
-  margin-top: 20px;
+.review-page {
+  padding: 0 20px 20px;
 }
-
-.description-text {
-  display: -webkit-box;
-  -webkit-line-clamp: 2;
-  -webkit-box-orient: vertical;
-  overflow: hidden;
-  text-overflow: ellipsis;
+.filters {
+  margin-bottom: 16px;
+}
+.detail-spin {
+  width: 100%;
 }
-
 .content-preview {
-  max-height: 200px;
-  overflow-y: auto;
+  max-height: 320px;
+  margin: 0;
+  overflow: auto;
   white-space: pre-wrap;
-  word-break: break-all;
+  word-break: break-word;
+  font-family: inherit;
+}
+.self-review-alert {
+  margin-bottom: 16px;
 }
 </style>
diff --git a/src/views/ops/pages/kb/tags/components/CategoryFormDialog.vue b/src/views/ops/pages/kb/tags/components/CategoryFormDialog.vue
deleted file mode 100644
index 9fb622f..0000000
--- a/src/views/ops/pages/kb/tags/components/CategoryFormDialog.vue
+++ /dev/null
@@ -1,297 +0,0 @@
-<template>
-  <a-modal
-    :visible="visible"
-    :title="isEdit ? '编辑标签' : '新增标签'"
-    width="600px"
-    @ok="handleOk"
-    @cancel="handleCancel"
-    @update:visible="handleVisibleChange"
-    :confirm-loading="submitting"
-  >
-    <a-form :model="form" layout="vertical" ref="formRef">
-      <a-row :gutter="16">
-        <a-col :span="12">
-          <a-form-item label="标签名称" field="name" :rules="[{ required: true, message: '请输入标签名称' }]">
-            <a-input v-model="form.name" placeholder="请输入标签名称" :max-length="200" />
-          </a-form-item>
-        </a-col>
-        <a-col :span="12">
-          <a-form-item label="标签类型" field="type">
-            <a-select v-model="form.type" placeholder="请选择标签类型" allow-clear>
-              <a-option value="document">文档标签</a-option>
-              <a-option value="faq">FAQ标签</a-option>
-              <a-option value="general">通用标签</a-option>
-            </a-select>
-          </a-form-item>
-        </a-col>
-      </a-row>
-
-      <a-form-item label="标签描述" field="description">
-        <a-textarea v-model="form.description" placeholder="请输入标签描述" :auto-size="{ minRows: 2, maxRows: 4 }" :max-length="500" />
-      </a-form-item>
-
-      <a-form-item label="标签颜色" field="color">
-        <div class="color-picker-wrapper">
-          <a-input v-model="form.color" placeholder="请选择颜色" readonly @click="showColorPicker = !showColorPicker">
-            <template #prefix>
-              <div class="color-preview" :style="{ backgroundColor: form.color || '#ccc' }"></div>
-            </template>
-          </a-input>
-          <div v-if="showColorPicker" class="color-picker-dropdown">
-            <div class="color-picker-header">选择颜色</div>
-            <div class="color-picker-grid">
-              <div
-                v-for="color in presetColors"
-                :key="color"
-                class="color-item"
-                :style="{ backgroundColor: color }"
-                @click="selectColor(color)"
-              ></div>
-            </div>
-            <div class="color-picker-custom">
-              <span>自定义颜色:</span>
-              <input type="color" v-model="form.color" @change="showColorPicker = false" />
-            </div>
-          </div>
-        </div>
-      </a-form-item>
-
-      <a-form-item label="排序号" field="sort_order">
-        <a-input-number v-model="form.sort_order" placeholder="请输入排序号" :min="0" style="width: 100%" />
-      </a-form-item>
-
-      <a-form-item label="备注信息" field="remarks">
-        <a-textarea v-model="form.remarks" placeholder="请输入备注信息" :auto-size="{ minRows: 2, maxRows: 4 }" :max-length="500" />
-      </a-form-item>
-    </a-form>
-  </a-modal>
-</template>
-
-<script lang="ts" setup>
-import { ref, watch, computed } from 'vue'
-import { Message } from '@arco-design/web-vue'
-import { createCategory, updateCategory, type Category } from '@/api/kb/category'
-
-interface Props {
-  visible: boolean
-  category: Category | null
-}
-
-interface Emits {
-  (e: 'update:visible', value: boolean): void
-  (e: 'success'): void
-}
-
-const props = defineProps<Props>()
-const emit = defineEmits<Emits>()
-
-const formRef = ref()
-const submitting = ref(false)
-const showColorPicker = ref(false)
-
-// 预设颜色
-const presetColors = [
-  '#FF0000',
-  '#FF4500',
-  '#FF8C00',
-  '#FFD700',
-  '#FFFF00',
-  '#9ACD32',
-  '#32CD32',
-  '#00FF00',
-  '#00FA9A',
-  '#00CED1',
-  '#1E90FF',
-  '#0000FF',
-  '#8A2BE2',
-  '#9400D3',
-  '#FF00FF',
-  '#FF1493',
-  '#DC143C',
-  '#B22222',
-  '#8B0000',
-  '#800000',
-]
-
-// 表单数据
-const form = ref({
-  name: '',
-  description: '',
-  type: 'document',
-  color: '',
-  sort_order: 0,
-  remarks: '',
-})
-
-// 是否为编辑模式
-const isEdit = computed(() => !!props.category?.id)
-
-// 选择颜色
-const selectColor = (color: string) => {
-  form.value.color = color
-  showColorPicker.value = false
-}
-
-// 监听对话框显示状态
-watch(
-  () => props.visible,
-  (newVal) => {
-    if (newVal) {
-      if (props.category && isEdit.value) {
-        // 编辑模式：填充表单
-        form.value = {
-          name: props.category.name || '',
-          description: props.category.description || '',
-          type: props.category.type || 'document',
-          color: props.category.color || '',
-          sort_order: props.category.sort_order || 0,
-          remarks: props.category.remarks || '',
-        }
-      } else {
-        // 新建模式：重置表单
-        form.value = {
-          name: '',
-          description: '',
-          type: 'document',
-          color: '',
-          sort_order: 0,
-          remarks: '',
-        }
-      }
-      showColorPicker.value = false
-    }
-  }
-)
-
-// 确认提交
-const handleOk = async () => {
-  const valid = await formRef.value?.validate()
-  if (valid) return
-
-  submitting.value = true
-  try {
-    const data: any = {
-      name: form.value.name,
-      description: form.value.description,
-      type: form.value.type,
-      color: form.value.color,
-      sort_order: form.value.sort_order,
-      remarks: form.value.remarks,
-    }
-
-    let res: any
-    if (isEdit.value && props.category?.id) {
-      // 编辑标签
-      data.id = props.category.id
-      res = await updateCategory(data)
-    } else {
-      // 新建标签
-      res = await createCategory(data)
-    }
-
-    if (res.code === 0) {
-      Message.success(isEdit.value ? '编辑成功' : '创建成功')
-      emit('success')
-      emit('update:visible', false)
-    } else {
-      Message.error(res.message || (isEdit.value ? '编辑失败' : '创建失败'))
-    }
-  } catch (error) {
-    Message.error(isEdit.value ? '编辑失败' : '创建失败')
-    console.error(error)
-  } finally {
-    submitting.value = false
-  }
-}
-
-// 取消
-const handleCancel = () => {
-  emit('update:visible', false)
-}
-
-// 处理对话框可见性变化
-const handleVisibleChange = (visible: boolean) => {
-  emit('update:visible', visible)
-}
-</script>
-
-<script lang="ts">
-export default {
-  name: 'KbCategoryFormDialog',
-}
-</script>
-
-<style scoped lang="less">
-.color-picker-wrapper {
-  position: relative;
-
-  .color-preview {
-    width: 16px;
-    height: 16px;
-    border-radius: 2px;
-    border: 1px solid #d9d9d9;
-  }
-
-  .color-picker-dropdown {
-    position: absolute;
-    top: 100%;
-    left: 0;
-    z-index: 1000;
-    background: #fff;
-    border: 1px solid #d9d9d9;
-    border-radius: 4px;
-    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.15);
-    padding: 12px;
-    margin-top: 4px;
-    width: 280px;
-
-    .color-picker-header {
-      font-size: 14px;
-      font-weight: 500;
-      margin-bottom: 8px;
-      color: #262626;
-    }
-
-    .color-picker-grid {
-      display: grid;
-      grid-template-columns: repeat(10, 1fr);
-      gap: 4px;
-      margin-bottom: 12px;
-
-      .color-item {
-        width: 20px;
-        height: 20px;
-        border-radius: 2px;
-        cursor: pointer;
-        border: 1px solid #d9d9d9;
-
-        &:hover {
-          transform: scale(1.1);
-          border-color: #1890ff;
-        }
-      }
-    }
-
-    .color-picker-custom {
-      display: flex;
-      align-items: center;
-      gap: 8px;
-      padding-top: 8px;
-      border-top: 1px solid #f0f0f0;
-
-      span {
-        font-size: 12px;
-        color: #595959;
-      }
-
-      input[type='color'] {
-        width: 60px;
-        height: 28px;
-        border: 1px solid #d9d9d9;
-        border-radius: 4px;
-        cursor: pointer;
-      }
-    }
-  }
-}
-</style>
diff --git a/src/views/ops/pages/kb/tags/index.vue b/src/views/ops/pages/kb/tags/index.vue
deleted file mode 100644
index 34a2358..0000000
--- a/src/views/ops/pages/kb/tags/index.vue
+++ /dev/null
@@ -1,314 +0,0 @@
-<template>
-  <div class="container">
-    <search-table
-      :form-model="formModel"
-      :form-items="formItems"
-      :data="tableData"
-      :columns="columns"
-      :loading="loading"
-      :pagination="pagination"
-      title="标签管理"
-      search-button-text="查询"
-      reset-button-text="重置"
-      @update:form-model="handleFormModelUpdate"
-      @search="handleSearch"
-      @reset="handleReset"
-      @refresh="handleRefresh"
-      @page-change="handlePageChange"
-      @page-size-change="handlePageSizeChange"
-    >
-      <template #toolbar-left>
-        <a-button type="primary" @click="handleCreate">新增标签</a-button>
-      </template>
-
-      <!-- 序号 -->
-      <template #index="{ rowIndex }">
-        {{ rowIndex + 1 }}
-      </template>
-
-      <!-- 标签类型 -->
-      <template #type="{ record }">
-        <a-tag :color="getTypeColor(record.type)">
-          {{ getTypeLabel(record.type) }}
-        </a-tag>
-      </template>
-
-      <!-- 操作 -->
-      <template #actions="{ record }">
-        <a-button type="text" size="small" @click="handleEdit(record)">编辑</a-button>
-        <a-button type="text" size="small" status="danger" @click="handleDelete(record)">删除</a-button>
-      </template>
-    </search-table>
-
-    <!-- 标签表单对话框（新增/编辑） -->
-    <category-form-dialog v-model:visible="formVisible" :category="editingCategory" @success="handleFormSuccess" />
-  </div>
-</template>
-
-<script lang="ts" setup>
-import { ref, computed, onMounted } from 'vue'
-import { Message, Modal } from '@arco-design/web-vue'
-import type { FormItem } from '@/components/search-form/types'
-import SearchTable from '@/components/search-table/index.vue'
-import { fetchCategoryList, deleteCategory, type Category } from '@/api/kb/category'
-import CategoryFormDialog from './components/CategoryFormDialog.vue'
-
-// 状态管理
-const loading = ref(false)
-const allData = ref<Category[]>([]) // 存储全量数据
-const tableData = ref<Category[]>([]) // 当前页数据
-const formModel = ref({
-  keyword: '',
-  type: '',
-})
-
-// 分页状态
-const pagination = ref({
-  current: 1,
-  pageSize: 20,
-  total: 0,
-})
-
-// 表单项配置
-const formItems = computed<FormItem[]>(() => [
-  {
-    field: 'keyword',
-    label: '关键词',
-    type: 'input',
-    placeholder: '请输入标签名称',
-  },
-  {
-    field: 'type',
-    label: '标签类型',
-    type: 'select',
-    placeholder: '请选择标签类型',
-    options: [
-      { label: '文档标签', value: 'document' },
-      { label: 'FAQ标签', value: 'faq' },
-      { label: '通用标签', value: 'general' },
-    ],
-    allowClear: true,
-  },
-])
-
-// 表格列配置
-const columns = computed(() => [
-  {
-    title: '序号',
-    dataIndex: 'index',
-    slotName: 'index',
-    width: 80,
-    align: 'center' as const,
-  },
-  {
-    title: '标签名称',
-    dataIndex: 'name',
-    ellipsis: true,
-    tooltip: true,
-  },
-  {
-    title: '标签描述',
-    dataIndex: 'description',
-    ellipsis: true,
-    tooltip: true,
-  },
-  {
-    title: '标签类型',
-    dataIndex: 'type',
-    slotName: 'type',
-    width: 120,
-    align: 'center' as const,
-  },
-  {
-    title: '排序',
-    dataIndex: 'sort_order',
-    width: 80,
-    align: 'center' as const,
-  },
-  {
-    title: '备注信息',
-    dataIndex: 'remarks',
-    ellipsis: true,
-    tooltip: true,
-  },
-  {
-    title: '操作',
-    slotName: 'actions',
-    width: 250,
-    fixed: 'right' as const,
-  },
-])
-
-// 当前选中的标签
-const editingCategory = ref<Category | null>(null)
-
-// 对话框可见性
-const formVisible = ref(false)
-
-// 获取标签类型标签
-const getTypeLabel = (type: string) => {
-  const typeMap: Record<string, string> = {
-    document: '文档标签',
-    faq: 'FAQ标签',
-    general: '通用标签',
-  }
-  return typeMap[type] || type
-}
-
-// 获取标签类型颜色
-const getTypeColor = (type: string) => {
-  const colorMap: Record<string, string> = {
-    document: 'blue',
-    faq: 'green',
-    general: 'orange',
-  }
-  return colorMap[type] || 'gray'
-}
-
-// 更新表格数据（前端分页）
-const updateTableData = () => {
-  const { current, pageSize } = pagination.value
-  const start = (current - 1) * pageSize
-  const end = start + pageSize
-  tableData.value = allData.value.slice(start, end)
-}
-
-// 获取标签列表
-const fetchCategories = async () => {
-  loading.value = true
-
-  try {
-    const params: any = {}
-
-    if (formModel.value.type) {
-      params.type = formModel.value.type
-    }
-
-    const res: any = await fetchCategoryList(params)
-
-    if (res.code === 0) {
-      let data = res.details || []
-
-      // 如果有关键词搜索，进行过滤
-      if (formModel.value.keyword) {
-        data = data.filter((item: Category) => item.name.toLowerCase().includes(formModel.value.keyword.toLowerCase()))
-      }
-
-      // 保存全量数据并更新分页
-      allData.value = data
-      pagination.value.total = data.length
-      // 重置到第一页
-      pagination.value.current = 1
-      updateTableData()
-    } else {
-      Message.error(res.message || '获取标签列表失败')
-      allData.value = []
-      tableData.value = []
-      pagination.value.total = 0
-    }
-  } catch (error) {
-    console.error('获取标签列表失败:', error)
-    Message.error('获取标签列表失败')
-    allData.value = []
-    tableData.value = []
-    pagination.value.total = 0
-  } finally {
-    loading.value = false
-  }
-}
-
-// 搜索
-const handleSearch = () => {
-  fetchCategories()
-}
-
-// 处理表单模型更新
-const handleFormModelUpdate = (value: any) => {
-  formModel.value = value
-}
-
-// 重置
-const handleReset = () => {
-  formModel.value = {
-    keyword: '',
-    type: '',
-  }
-  fetchCategories()
-}
-
-// 刷新
-const handleRefresh = () => {
-  fetchCategories()
-  Message.success('数据已刷新')
-}
-
-// 分页切换
-const handlePageChange = (current: number) => {
-  pagination.value.current = current
-  updateTableData()
-}
-
-// 每页条数切换
-const handlePageSizeChange = (pageSize: number) => {
-  pagination.value.current = 1
-  pagination.value.pageSize = pageSize
-  updateTableData()
-}
-
-// 新增标签
-const handleCreate = () => {
-  editingCategory.value = null
-  formVisible.value = true
-}
-
-// 编辑标签
-const handleEdit = (record: Category) => {
-  editingCategory.value = { ...record }
-  formVisible.value = true
-}
-
-// 删除标签
-const handleDelete = async (record: Category) => {
-  Modal.confirm({
-    title: '确认删除',
-    content: `确认删除标签「${record.name}」吗？`,
-    onOk: async () => {
-      try {
-        const res: any = await deleteCategory(record.id)
-        if (res.code === 0) {
-          Message.success('删除成功')
-          fetchCategories()
-        } else {
-          Message.error(res.message || '删除失败')
-        }
-      } catch (error) {
-        console.error('删除标签失败:', error)
-        Message.error('删除失败')
-      }
-    },
-  })
-}
-
-// 表单成功回调
-const handleFormSuccess = () => {
-  formVisible.value = false
-  fetchCategories()
-}
-
-// 初始化加载数据
-onMounted(() => {
-  fetchCategories()
-})
-</script>
-
-<script lang="ts">
-export default {
-  name: 'KbCategoryManage',
-}
-</script>
-
-<style scoped lang="less">
-.container {
-  margin-top: 20px;
-}
-</style>
diff --git a/src/views/ops/pages/overview/index.vue b/src/views/ops/pages/overview/index.vue
index 6a029c8..c4448d4 100644
--- a/src/views/ops/pages/overview/index.vue
+++ b/src/views/ops/pages/overview/index.vue
@@ -218,6 +218,9 @@ const getPageTotal = (payload: any) => {
   return Number(body?.total ?? payload?.total ?? 0) || 0
 }
 
+const isFailedRequest = (value: unknown): value is { error: unknown; success: false } =>
+  Boolean(value && typeof value === 'object' && 'success' in value && value.success === false)
+
 // 统计卡片数据
 const statCards = computed(() => [
   {
@@ -551,26 +554,19 @@ const loadStatistics = async () => {
     loading.value = true
 
     // 并行请求所有统计接口和待处理告警
-    const [
-      alertData,
-      collectorData,
-      ticketData,
-      alertListData,
-      reviewStatsData,
-      networkTotalData,
-      networkEnabledData,
-    ] = await Promise.allSettled([
-      fetchAlertCount().catch((e) => ({ error: e, success: false })),
-      fetchCollectorStatistics().catch((e) => ({ error: e, success: false })),
-      fetchFeedbackTicketStatistics().catch((e) => ({ error: e, success: false })),
-      fetchHistories({ page: 1, page_size: 5, status: 'pending' }).catch((e) => ({ error: e, success: false })),
-      fetchReviewStats({ resource_type: 'all' }).catch((e) => ({ error: e, success: false })),
-      fetchNetworkDeviceList({ page: 1, size: 1 }).catch((e) => ({ error: e, success: false })),
-      fetchNetworkDeviceList({ page: 1, size: 1, enabled: true }).catch((e) => ({ error: e, success: false })),
-    ])
+    const [alertData, collectorData, ticketData, alertListData, reviewStatsData, networkTotalData, networkEnabledData] =
+      await Promise.allSettled([
+        fetchAlertCount().catch((e) => ({ error: e, success: false })),
+        fetchCollectorStatistics().catch((e) => ({ error: e, success: false })),
+        fetchFeedbackTicketStatistics().catch((e) => ({ error: e, success: false })),
+        fetchHistories({ page: 1, page_size: 5, status: 'pending' }).catch((e) => ({ error: e, success: false })),
+        fetchReviewStats({ resource_type: 'all' }).catch((e: unknown) => ({ error: e, success: false as const })),
+        fetchNetworkDeviceList({ page: 1, size: 1 }).catch((e) => ({ error: e, success: false })),
+        fetchNetworkDeviceList({ page: 1, size: 1, enabled: true }).catch((e) => ({ error: e, success: false })),
+      ])
 
     // 处理服务器及PC统计数据
-    if (collectorData.status === 'fulfilled' && collectorData.value?.success !== false) {
+    if (collectorData.status === 'fulfilled' && !isFailedRequest(collectorData.value)) {
       const resourceStats = unwrapDetails(collectorData.value)
       statistics.serverPc = normalizeCountPair(resourceStats.servers)
       statistics.database = normalizeCountPair(resourceStats.database_services)
@@ -580,9 +576,9 @@ const loadStatistics = async () => {
 
     if (
       networkTotalData.status === 'fulfilled' &&
-      networkTotalData.value?.success !== false &&
+      !isFailedRequest(networkTotalData.value) &&
       networkEnabledData.status === 'fulfilled' &&
-      networkEnabledData.value?.success !== false
+      !isFailedRequest(networkEnabledData.value)
     ) {
       statistics.network = {
         pending: getPageTotal(networkEnabledData.value),
@@ -593,7 +589,7 @@ const loadStatistics = async () => {
     }
 
     // 处理告警统计数据
-    if (alertData.status === 'fulfilled' && alertData.value?.success !== false) {
+    if (alertData.status === 'fulfilled' && !isFailedRequest(alertData.value)) {
       statistics.alert = {
         pending: alertData.value?.details?.status_counts?.pending || 0,
         total: alertData.value?.details?.total || 0,
@@ -603,7 +599,7 @@ const loadStatistics = async () => {
     }
 
     // 处理工单统计数据
-    if (ticketData.status === 'fulfilled' && ticketData.value?.success !== false) {
+    if (ticketData.status === 'fulfilled' && !isFailedRequest(ticketData.value)) {
       statistics.ticket = {
         pending: ticketData.value?.details?.pending || ticketData.value?.pending || 0,
         total: ticketData.value?.details?.total || ticketData.value?.total || 0,
@@ -613,20 +609,24 @@ const loadStatistics = async () => {
     }
 
     // 审核统计数据（待处理=尚未审核，总数=需本人审核）
-    if (reviewStatsData.status === 'fulfilled' && reviewStatsData.value?.success !== false) {
-      const reviewPayload = reviewStatsData.value?.data ?? reviewStatsData.value?.details
-      if (reviewPayload != null && 'need_my_review_total' in reviewPayload) {
-        statistics.review = {
-          pending: Number(reviewPayload.need_my_review_unreviewed_total) || 0,
-          total: Number(reviewPayload.need_my_review_total) || 0,
-        }
+    if (reviewStatsData.status === 'fulfilled' && !isFailedRequest(reviewStatsData.value)) {
+      const reviewPayload = reviewStatsData.value.details
+      statistics.review = {
+        pending: Number(reviewPayload.need_my_review_unreviewed_total) || 0,
+        total: Number(reviewPayload.need_my_review_total) || 0,
       }
     } else {
-      console.warn('审核统计数据加载失败:', reviewStatsData.status === 'rejected' ? reviewStatsData.reason : reviewStatsData.value?.error)
+      const reason =
+        reviewStatsData.status === 'rejected'
+          ? reviewStatsData.reason
+          : isFailedRequest(reviewStatsData.value)
+            ? reviewStatsData.value.error
+            : undefined
+      console.warn('审核统计数据加载失败:', reason)
     }
 
     // 设置待处理告警列表
-    if (alertListData.status === 'fulfilled' && alertListData.value?.success !== false) {
+    if (alertListData.status === 'fulfilled' && !isFailedRequest(alertListData.value)) {
       pendingAlerts.value = alertListData.value?.details?.data || []
     } else {
       console.warn('待处理告警列表加载失败:', alertListData.status === 'rejected' ? alertListData.reason : alertListData.value?.error)