From 06de569748a46d861a574a6a6141795e469054db Mon Sep 17 00:00:00 2001
From: "xinxin.wu" <xinxin.wu@fit2cloud.com>
Date: Tue, 27 Oct 2026 10:52:51 +0800
Subject: [PATCH] feat: application rank description

---
 ui/src/api/admin/system/api-key.ts                        | 1 -
 .../system/resource-management/application/api-key.ts     | 1 -
 .../system/resource-management/application/application.ts | 4 +---
 .../system/resource-management/application/overview.ts    | 1 -
 ui/src/api/admin/system/resource-management/chat-user.ts  | 1 -
 .../system/resource-management/knowledge/document.ts      | 1 -
 ui/src/api/admin/system/shared-resources/chat-user.ts     | 1 -
 .../admin/system/shared-resources/knowledge/document.ts   | 1 -
 ui/src/api/admin/workspace/application/application.ts     | 2 --
 ui/src/api/admin/workspace/application/overview.ts        | 1 -
 ui/src/api/admin/workspace/knowledge/document.ts          | 1 -
 ui/src/api/admin/workspace/shared/chat-user.ts            | 1 -
 ui/src/api/admin/workspace/shared/knowledge/termbase.ts   | 1 -
 ui/src/api/types/api-key.ts                               | 1 -
 .../business/api-key-list/edit-api-key/index.vue          | 1 -
 .../overview/components/ApplicationRanking.vue            | 8 +++++++-
 .../problem/components/AssociateParagraphDialog.vue       | 1 +
 17 files changed, 9 insertions(+), 19 deletions(-)

diff --git a/ui/src/api/admin/system/api-key.ts b/ui/src/api/admin/system/api-key.ts
index 6987fbe128d..066634f9c49 100644
--- a/ui/src/api/admin/system/api-key.ts
+++ b/ui/src/api/admin/system/api-key.ts
@@ -1,4 +1,3 @@
-/** 系统 API Key 接口。TODO：联调 /system/api_key 及 remark 字段。 */
 import { del, get, post, put } from '../core/request'
 import type { ParamsPage, ResponsePage } from '../core/types'
 import type { ApiKeyPayload, ApiKeyRecord, Dict } from '@/api/types'
diff --git a/ui/src/api/admin/system/resource-management/application/api-key.ts b/ui/src/api/admin/system/resource-management/application/api-key.ts
index e17f91b1371..a1f313f2f16 100644
--- a/ui/src/api/admin/system/resource-management/application/api-key.ts
+++ b/ui/src/api/admin/system/resource-management/application/api-key.ts
@@ -1,4 +1,3 @@
-/** System 资源管理智能体 API Key 接口。TODO：接口待联调。 */
 import { del, get, post, put } from '@/api/admin/core/request'
 import type { ParamsPage, ResponsePage } from '@/api/admin/core/types'
 import type { ApiKeyPayload, ApiKeyRecord, Dict } from '@/api/types'
diff --git a/ui/src/api/admin/system/resource-management/application/application.ts b/ui/src/api/admin/system/resource-management/application/application.ts
index 2866d4f4624..e2a0a5cd767 100644
--- a/ui/src/api/admin/system/resource-management/application/application.ts
+++ b/ui/src/api/admin/system/resource-management/application/application.ts
@@ -36,12 +36,10 @@ const putApplicationPortalDown = (applicationId: string) => put<Record<string, n
 const getApplicationDetail = (applicationId: string) => get<ApplicationDetail>(`${prefix}/${applicationId}`)
 
 /** 获取 System 资源管理智能体公开访问凭证与访问限制。 */
-// TODO：访问限制接口待联调。
-// TODO：社区版身份认证读写待后台联调。
 const getAccessToken = (applicationId: string) => get<ApplicationAccessToken>(`${prefix}/${applicationId}/access_token`)
 
 /** 修改 System 资源管理智能体访问配置或重置凭证，返回更新后的配置。 */
-// TODO：身份认证、默认登录方式及账号锁定配置待后台联调。
+// 身份认证、默认登录方式及账号锁定配置待后台联调。
 const putAccessToken = (applicationId: string, payload: ApplicationAccessTokenPayload) =>
   put<ApplicationAccessTokenPayload, ApplicationAccessToken>(`${prefix}/${applicationId}/access_token`, payload)
 
diff --git a/ui/src/api/admin/system/resource-management/application/overview.ts b/ui/src/api/admin/system/resource-management/application/overview.ts
index a768589a968..cfda2413d04 100644
--- a/ui/src/api/admin/system/resource-management/application/overview.ts
+++ b/ui/src/api/admin/system/resource-management/application/overview.ts
@@ -9,7 +9,6 @@ const getPrefix = () => '/system/resource/application'
 const getMonitoring = (_workspaceId: string, range: HomeDateRange, applicationId: string) =>
   get<HomeMonitoringDay[]>(`${getPrefix()}/${applicationId}/application_stats`, { ...range })
 
-// TODO：后台按首页协议补齐用户排行分页、name 搜索、汇总和导出。
 const rankingPaths = { userTokens: 'application_token_usage', questions: 'top_questions' }
 
 /** 分页查询当前智能体的用户排行。 */
diff --git a/ui/src/api/admin/system/resource-management/chat-user.ts b/ui/src/api/admin/system/resource-management/chat-user.ts
index a5decd9657f..9fca01199cb 100644
--- a/ui/src/api/admin/system/resource-management/chat-user.ts
+++ b/ui/src/api/admin/system/resource-management/chat-user.ts
@@ -9,7 +9,6 @@ import type {
   Dict,
 } from '@/api/types'
 
-// TODO：V3 联调确认授权前缀；当前沿用 V2 的 /system/resource/knowledge/{resource_type}。
 const getPrefix = (resource: ChatUserAuthorizationResource) => `/system/resource/knowledge/${resource.resource_type}/${resource.resource_id}`
 
 /** 获取资源的对话用户组及自动授权状态。 */
diff --git a/ui/src/api/admin/system/resource-management/knowledge/document.ts b/ui/src/api/admin/system/resource-management/knowledge/document.ts
index 80813ced395..7ab8c6b9841 100644
--- a/ui/src/api/admin/system/resource-management/knowledge/document.ts
+++ b/ui/src/api/admin/system/resource-management/knowledge/document.ts
@@ -24,7 +24,6 @@ const getPrefix = (knowledgeId: string) => `/system/resource/knowledge/${knowled
 
 /**
  * 获取知识库不分页的文档或图片选项。
- * TODO：联调 resource_type=document/image 筛选及图片缩略图字段 meta.source_file_id。
  */
 const getAllDocuments = (knowledgeId: string, query?: { resource_type: DocumentResourceType }) => get<DocumentItem[]>(getPrefix(knowledgeId), query)
 
diff --git a/ui/src/api/admin/system/shared-resources/chat-user.ts b/ui/src/api/admin/system/shared-resources/chat-user.ts
index 8ddf2921544..ff69ffab0bb 100644
--- a/ui/src/api/admin/system/shared-resources/chat-user.ts
+++ b/ui/src/api/admin/system/shared-resources/chat-user.ts
@@ -9,7 +9,6 @@ import type {
   Dict,
 } from '@/api/types'
 
-// TODO：V3 联调确认授权前缀；当前沿用 V2 的 /system/shared/knowledge/{resource_type}。
 const getPrefix = (resource: ChatUserAuthorizationResource) => `/system/shared/knowledge/${resource.resource_type}/${resource.resource_id}`
 
 /** 获取资源的对话用户组及自动授权状态。 */
diff --git a/ui/src/api/admin/system/shared-resources/knowledge/document.ts b/ui/src/api/admin/system/shared-resources/knowledge/document.ts
index 7d2ceebba2c..08578b0dcdb 100644
--- a/ui/src/api/admin/system/shared-resources/knowledge/document.ts
+++ b/ui/src/api/admin/system/shared-resources/knowledge/document.ts
@@ -24,7 +24,6 @@ const getPrefix = (knowledgeId: string) => `/system/shared/knowledge/${knowledge
 
 /**
  * 获取知识库不分页的文档或图片选项。
- * TODO：联调 resource_type=document/image 筛选及图片缩略图字段 meta.source_file_id。
  */
 const getAllDocuments = (knowledgeId: string, query?: { resource_type: DocumentResourceType }) => get<DocumentItem[]>(getPrefix(knowledgeId), query)
 
diff --git a/ui/src/api/admin/workspace/application/application.ts b/ui/src/api/admin/workspace/application/application.ts
index fce1df2b9eb..71924d78ae8 100644
--- a/ui/src/api/admin/workspace/application/application.ts
+++ b/ui/src/api/admin/workspace/application/application.ts
@@ -26,11 +26,9 @@ const getApplicationDetail = (applicationId: string) => {
 }
 
 /** 获取智能体公开访问凭证与访问限制。 */
-// TODO：社区版身份认证读写待后台联调。
 const getAccessToken = (applicationId: string) => get<ApplicationAccessToken>(`${getPrefix()}/${applicationId}/access_token`)
 
 /** 修改智能体访问配置或重置凭证，返回更新后的配置。 */
-// TODO：身份认证、默认登录方式及账号锁定配置待后台联调。
 const putAccessToken = (applicationId: string, payload: ApplicationAccessTokenPayload) =>
   put<ApplicationAccessTokenPayload, ApplicationAccessToken>(`${getPrefix()}/${applicationId}/access_token`, payload)
 
diff --git a/ui/src/api/admin/workspace/application/overview.ts b/ui/src/api/admin/workspace/application/overview.ts
index 510ded36360..c03abdf86d5 100644
--- a/ui/src/api/admin/workspace/application/overview.ts
+++ b/ui/src/api/admin/workspace/application/overview.ts
@@ -10,7 +10,6 @@ const getPrefix = (workspaceId = getWorkspaceId()) => `/workspace/${workspaceId}
 const getMonitoring = (workspaceId: string, range: HomeDateRange, applicationId: string) =>
   get<HomeMonitoringDay[]>(`${getPrefix(workspaceId)}/${applicationId}/application_stats`, { ...range })
 
-// TODO：后台按首页协议补齐用户排行分页、name 搜索、汇总和导出。
 const rankingPaths = { userTokens: 'application_token_usage', questions: 'top_questions' }
 
 /** 分页查询当前智能体的用户排行。 */
diff --git a/ui/src/api/admin/workspace/knowledge/document.ts b/ui/src/api/admin/workspace/knowledge/document.ts
index 747776de878..22876b525fc 100644
--- a/ui/src/api/admin/workspace/knowledge/document.ts
+++ b/ui/src/api/admin/workspace/knowledge/document.ts
@@ -25,7 +25,6 @@ const getPrefix = (knowledgeId: string) => `/workspace/${getWorkspaceId()}/knowl
 
 /**
  * 获取知识库不分页的文档或图片选项。
- * TODO：联调 resource_type=document/image 筛选及图片缩略图字段 meta.source_file_id。
  */
 const getAllDocuments = (knowledgeId: string, query?: { resource_type: DocumentResourceType }) => get<DocumentItem[]>(getPrefix(knowledgeId), query)
 
diff --git a/ui/src/api/admin/workspace/shared/chat-user.ts b/ui/src/api/admin/workspace/shared/chat-user.ts
index a1917f0b644..eb41692b37c 100644
--- a/ui/src/api/admin/workspace/shared/chat-user.ts
+++ b/ui/src/api/admin/workspace/shared/chat-user.ts
@@ -3,7 +3,6 @@ import type { ParamsPage, ResponsePage } from '../../core/types'
 import type { ChatUserAuthorization, ChatUserAuthorizationGroup, ChatUserAuthorizationResource, Dict } from '@/api/types'
 import { getWorkspaceId } from '@/utils/resource-context'
 
-// TODO：V3 联调确认共享授权路径；当前沿用 V2 的大写资源类型，已核对 KNOWLEDGE 查询。
 const getPrefix = (resource: ChatUserAuthorizationResource) =>
   `/system/shared/workspace/${getWorkspaceId()}/${resource.resource_type}/${resource.resource_id}`
 
diff --git a/ui/src/api/admin/workspace/shared/knowledge/termbase.ts b/ui/src/api/admin/workspace/shared/knowledge/termbase.ts
index 5cdf3229e4d..c8bbeb6d309 100644
--- a/ui/src/api/admin/workspace/shared/knowledge/termbase.ts
+++ b/ui/src/api/admin/workspace/shared/knowledge/termbase.ts
@@ -6,7 +6,6 @@ import { getWorkspaceId } from '@/utils/resource-context'
 const getPrefix = (knowledgeId: string) => `/system/shared/workspace/${getWorkspaceId()}/knowledge/${knowledgeId}/termbase`
 
 /** 分页查询工作空间共享知识库的自定义分词条目，只提供只读访问。 */
-// TODO：V3 后端需确认并提供工作空间共享知识库的 termbase 分页查询路由。
 const getTermbasePage = (knowledgeId: string, page: ParamsPage, query?: { content?: string }) =>
   get<ResponsePage<TermbaseItem>>(`${getPrefix(knowledgeId)}/${page.currentPage}/${page.pageSize}`, query)
 
diff --git a/ui/src/api/types/api-key.ts b/ui/src/api/types/api-key.ts
index abd04259332..d0b0ea50e50 100644
--- a/ui/src/api/types/api-key.ts
+++ b/ui/src/api/types/api-key.ts
@@ -8,7 +8,6 @@ export interface ApiKeyRecord {
   is_permanent: boolean
   expire_time: string | null
   create_time?: string
-  // TODO：后端补充 remark 的返回与持久化。
   remark?: string | null
 }
 
diff --git a/ui/src/components/business/api-key-list/edit-api-key/index.vue b/ui/src/components/business/api-key-list/edit-api-key/index.vue
index da67528735b..004cbc42289 100644
--- a/ui/src/components/business/api-key-list/edit-api-key/index.vue
+++ b/ui/src/components/business/api-key-list/edit-api-key/index.vue
@@ -153,7 +153,6 @@ function handleClosed() {
         <el-date-picker v-model="form.expire_time" class="w-full!" type="datetime" value-format="YYYY-MM-DDTHH:mm:ssZ" placeholder="请选择到期时间" />
       </el-form-item>
       <el-form-item label="备注" prop="remark">
-        <!-- TODO：后端支持 remark 后移除联调提示。 -->
         <el-input v-model="form.remark" type="textarea" :rows="3" maxlength="256" show-word-limit placeholder="请输入" />
       </el-form-item>
       <el-form-item label="跨域设置">
diff --git a/ui/src/views/application-detail/overview/components/ApplicationRanking.vue b/ui/src/views/application-detail/overview/components/ApplicationRanking.vue
index 24496112388..458c00ff780 100644
--- a/ui/src/views/application-detail/overview/components/ApplicationRanking.vue
+++ b/ui/src/views/application-detail/overview/components/ApplicationRanking.vue
@@ -6,6 +6,7 @@ import type { ApplicationRankingKind, HomeRankingRecord } from '@/api/types'
 import MkDateRange from '@/components/mk-date-range/index.vue'
 import type { MkDateRangeValue } from '@/components/mk-date-range/types'
 import { beforeDay } from '@/utils/time'
+import { formatTokenNumber, numberFormat } from '@/utils/number'
 import RankingCard from '@/views/home/components/ranking/RankingCard.vue'
 import ApplicationRankingDrawer from './ApplicationRankingDrawer.vue'
 
@@ -101,7 +102,12 @@ onMounted(loadRankings)
         :loading="loading"
         :total="totals[option.kind]"
         @detail="handleOpenRankingDetail(option.kind)"
-      />
+      >
+        <template #description="{ record }">
+          <span v-if="option.kind === 'userTokens'">对话 {{ numberFormat(record.chat_record_count) }} 次</span>
+          <span v-else>{{ formatTokenNumber(record.total_tokens ?? 0) }}</span>
+        </template>
+      </RankingCard>
     </div>
     <ApplicationRankingDrawer
       v-if="detailKind"
diff --git a/ui/src/views/knowledge-detail/problem/components/AssociateParagraphDialog.vue b/ui/src/views/knowledge-detail/problem/components/AssociateParagraphDialog.vue
index 038488d7a65..f0aea872cdb 100644
--- a/ui/src/views/knowledge-detail/problem/components/AssociateParagraphDialog.vue
+++ b/ui/src/views/knowledge-detail/problem/components/AssociateParagraphDialog.vue
@@ -255,6 +255,7 @@ defineExpose({ open })
               <MkEmpty :type="paragraphSearchText ? 'search' : 'default'" description="暂无分段" />
             </template>
           </MkInfiniteScroll>
+          <el-empty v-else-if="!documentLoading" class="flex-1" description="暂无数据" />
         </div>
       </template>
     </MkViewLayout>