feat: shared router

Author: wangdan-fit2cloud

ui/AGENTS.md

@@ -141,9 +141,9 @@ Structural responsibilities:
   internally to avoid circular access through the aggregate entry.
 - Put functions shared by most pages or multiple business modules in `utils/`; detailed placement, file organization, and naming rules are maintained in `src/utils/UTILS_README.md`.
 - Treat application, knowledge, model, and tool as the four special resource domains that can span
-  Workspace, System resource management, and System shared resources. Their route scope, API
+  Workspace resources, Workspace shared resources, System resource management, and System shared resources. Their route scope, API
   selection, reusable cards, and context-specific Actions follow `ROUTE_README.md`,
-  `API_README.md`, and `VIEW_README.md`; do not extend this three-scope pattern to ordinary pages.
+  `API_README.md`, and `VIEW_README.md`; do not extend this resource-scope pattern to ordinary pages.
 - Import source assets through `src/assets/`; use `public/` only when a file must retain its original filename and URL.
 
 ## Entry Points

ui/src/api/API_README.md

@@ -23,6 +23,7 @@ src/api/
 │   │   ├── conversation.ts           # 调试对话、历史会话与语音接口
 │   │   ├── application/              # 智能体接口
 │   │   ├── knowledge/                # 知识库接口
+│   │   ├── shared/                   # 工作空间可用的共享模型、工具、知识库查询
 │   │   ├── model.ts                  # 模型接口
 │   │   ├── trigger/                   # 触发器查询及维护接口
 │   │   ├── tool/                     # 工具、工具工作流及工具商店接口
@@ -101,7 +102,7 @@ FormData；保存返回完整配置，页面以该返回值作为唯一数据来
 多套 API 时，以 `request` 为前缀加业务名区分，例如 `requestModelApi`、`requestToolApi`。
 直接导入的 API 保持 PascalCase 命名；请求返回的 Promise 不属于此命名规则。
 
-`application`、`knowledge`、`model`、`tool` 是需要同时考虑 Workspace、System 资源管理和
+`application`、`knowledge`、`model`、`tool` 是需要同时考虑 Workspace 普通资源、Workspace 共享资源、System 资源管理和
 System 共享资源的四类特殊资源。其接口按真实后端边界分别维护在 `admin/workspace/` 与
 `admin/system/` 下，不把不同范围的 URL 合并为页面侧 API Map，也不让卡片或 Action 根据路由拼接
 System 接口地址。
@@ -153,7 +154,7 @@ v3 编辑表单提交 `{ name, description }`，标题上限 64、更新说明
 `workspace/tool/tool.ts` 的 `getAllTool(query)` 查询支持 `folder_id` 筛选的工作空间工具
 非分页列表，用于文件夹菜单和工具选择弹窗。`getToolListWithShared(query)` 请求 `tool/tool_list`，
 将响应的 `tools` 与 `shared_tools` 合并为 `ToolItem[]`，用于包含已授权共享工具的选项查询；
-按工具类型筛选时使用 `tool_type`。`workspace/shared.ts` 的 `getAllTool(query)` 仅查询共享工具。
+按工具类型筛选时使用 `tool_type`。`workspace/shared/tool.ts` 的 `getAllTool(query)` 仅查询共享工具。
 
 ### System 共享工具
 
@@ -200,7 +201,7 @@ MCP 入口加载配置后打开只读及复制弹窗；分词索引入口仅调
 `/workspace/<workspaceId>/knowledge/import_knowledge`，响应为 `{ knowledge_id, type }`。
 后端校验知识库导出包并创建资源；导入成功后的用户权限和列表刷新由调用页面负责。
 
-`workspace/knowledge/knowledge.ts` 与 `workspace/shared.ts` 的 `getAllKnowledge(query)`
+`workspace/knowledge/knowledge.ts` 与 `workspace/shared/knowledge/knowledge.ts` 的 `getAllKnowledge(query)`
 分别查询工作空间及共享知识库的非分页列表，返回 `KnowledgeItem[]`，用于关联知识库选择等
 需要全量选项的场景。原有 `getKnowledgePage` 继续用于分页列表。
 
@@ -492,3 +493,30 @@ System 接口由资源管理服务提供；本地开源后端没有对应扩展
 版本和执行记录，前缀为 `/system/shared/tool`，调用只传资源 ID，不读取工作空间。
 两种 System 工具 API 的 `getToolListWithShared` 查询各自 `/tool_list` 并合并 `tools`、`shared_tools`，
 供画布的工具菜单及 MCP 选项使用。系统扩展接口需连接支持相应协议的部署进行联调。
+
+### 知识库文档
+
+`workspace/knowledge/document.ts` 仅维护文档分页查询，路径为
+`/workspace/<workspaceId>/knowledge/<knowledgeId>/document/<currentPage>/<pageSize>`。
+分页使用 `ParamsPage` / `ResponsePage<DocumentItem>`，支持 `name`、`create_user` 筛选；
+文档页传 `resource_type: 'document'`，创建者选项复用 Workspace `common.ts` 的 `getAllUsers`。
+类型从 `@/api/types` 导入，命中处理枚举从 `@/api/enums` 导入。API 不接收 loading，不重复包装响应。
+
+### 工作空间共享资源查询
+
+`workspace/shared/` 按最终资源文件拆分：`model.ts` 提供 `getModelList`，`tool.ts` 提供
+`getToolPage`、`getAllTool`，`knowledge/knowledge.ts` 提供 `getKnowledgePage`、`getAllKnowledge`、`getKnowledgeDetail`。
+上述资源查询沿用 `/system/shared/workspace/<workspaceId>/<resource>`，工作空间 ID 在调用时读取。
+调用方直接导入对应资源文件，与普通工作空间 API 同时使用时分别命名为
+`SharedModelApi`、`SharedToolApi`、`SharedKnowledgeApi`；目录不提供聚合入口。
+
+`workspace/shared/knowledge/document.ts` 提供 `getDocumentPage(knowledgeId, page, query)`，
+请求 `/system/shared/workspace/<workspaceId>/knowledge/<knowledgeId>/document/<currentPage>/<pageSize>`。
+共享与普通知识库文档查询统一使用 `ParamsPage`、`ResponsePage<DocumentItem>` 和 `Dict<unknown>`，
+不传 loading，不保留 v2 的 `Result` 或下划线分页参数。两个文件各自默认导出 API 对象。
+
+共享知识库 `getKnowledgeDetail(knowledgeId)` 请求知识库资源 `/<knowledgeId>`，返回 `KnowledgeDetail`。
+
+Workspace 共享知识库详情由 `resourceScope: 'workspace-shared'` 选择上述完整共享 API 对象；
+普通详情继续使用 `workspace/knowledge/`。共享详情和文档查询不使用 System 共享资源管理 API，
+也不回退到普通 Workspace 知识库接口。文档创建者选项沿用共享列表的 System `common.ts` 查询。

ui/src/api/admin/workspace/knowledge/document.ts

@@ -0,0 +1,12 @@
+import { get } from '../../core/request'
+import type { ParamsPage, ResponsePage } from '../../core/types'
+import type { Dict, DocumentItem } from '@/api/types'
+import { getWorkspaceId } from '@/utils/resource-context'
+
+const getPrefix = (knowledgeId: string) => `/workspace/${getWorkspaceId()}/knowledge/${knowledgeId}/document`
+
+/** 获取文档分页列表，支持名称和创建者筛选。 */
+const getDocumentPage = (knowledgeId: string, page: ParamsPage, query?: Dict<unknown>) =>
+  get<ResponsePage<DocumentItem>>(`${getPrefix(knowledgeId)}/${page.currentPage}/${page.pageSize}`, query)
+
+export default { getDocumentPage }

ui/src/api/admin/workspace/shared.ts

@@ -0,0 +1,12 @@
+import { get } from '../../../core/request'
+import type { ParamsPage, ResponsePage } from '../../../core/types'
+import type { Dict, DocumentItem } from '@/api/types'
+import { getWorkspaceId } from '@/utils/resource-context'
+
+const getPrefix = (knowledgeId: string) => `/system/shared/workspace/${getWorkspaceId()}/knowledge/${knowledgeId}/document`
+
+/** 获取工作空间共享知识库的文档分页列表。 */
+const getDocumentPage = (knowledgeId: string, page: ParamsPage, query?: Dict<unknown>) =>
+  get<ResponsePage<DocumentItem>>(`${getPrefix(knowledgeId)}/${page.currentPage}/${page.pageSize}`, query)
+
+export default { getDocumentPage }

ui/src/api/admin/workspace/shared/knowledge/document.ts

@@ -0,0 +1,18 @@
+import { get } from '../../../core/request'
+import type { ParamsPage, ResponsePage } from '../../../core/types'
+import type { Dict, KnowledgeDetail, KnowledgeItem } from '@/api/types'
+import { getWorkspaceId } from '@/utils/resource-context'
+
+const getPrefix = () => `/system/shared/workspace/${getWorkspaceId()}/knowledge`
+
+/** 获取工作空间共享的知识库分页列表。 */
+const getKnowledgePage = (page: ParamsPage, query?: Dict<unknown>) =>
+  get<ResponsePage<KnowledgeItem>>(`${getPrefix()}/${page.currentPage}/${page.pageSize}`, query)
+
+/** 获取工作空间共享的不分页知识库列表。 */
+const getAllKnowledge = (query?: Dict<unknown>) => get<KnowledgeItem[]>(getPrefix(), query)
+
+/** 获取工作空间共享的知识库详情。 */
+const getKnowledgeDetail = (knowledgeId: string) => get<KnowledgeDetail>(`${getPrefix()}/${knowledgeId}`)
+
+export default { getKnowledgePage, getAllKnowledge, getKnowledgeDetail }

ui/src/api/admin/workspace/shared/knowledge/knowledge.ts

@@ -0,0 +1,12 @@
+import { get } from '../../core/request'
+import type { Dict, ModelItem } from '@/api/types'
+import { getWorkspaceId } from '@/utils/resource-context'
+
+const getPrefix = () => `/system/shared/workspace/${getWorkspaceId()}/model`
+
+/** 获取工作空间共享的模型列表。 */
+const getModelList = (query?: Dict<unknown>) => {
+  return get<ModelItem[]>(getPrefix(), query)
+}
+
+export default { getModelList }

ui/src/api/admin/workspace/shared/model.ts

@@ -0,0 +1,18 @@
+import { get } from '../../core/request'
+import type { ParamsPage, ResponsePage } from '../../core/types'
+import type { Dict, ToolItem } from '@/api/types'
+import { getWorkspaceId } from '@/utils/resource-context'
+
+const getPrefix = () => `/system/shared/workspace/${getWorkspaceId()}/tool`
+
+/** 获取工作空间共享的分页工具列表。 */
+const getToolPage = (page: ParamsPage, query?: Dict<unknown>) => {
+  return get<ResponsePage<ToolItem>>(`${getPrefix()}/${page.currentPage}/${page.pageSize}`, query)
+}
+
+/** 获取工作空间共享的不分页工具列表。 */
+const getAllTool = (query?: Dict<unknown>) => {
+  return get<ToolItem[]>(getPrefix(), query)
+}
+
+export default { getToolPage, getAllTool }

ui/src/api/admin/workspace/shared/tool.ts

@@ -0,0 +1,2 @@
+/** 文档命中处理方式。 */
+export const DOCUMENT_HIT_HANDLING = { OPTIMIZATION: 'optimization', DIRECTLY_RETURN: 'directly_return' } as const

ui/src/api/enums/document.ts

@@ -10,3 +10,5 @@ export * from './knowledge'
 export * from './trigger'
 export * from './file'
 export * from './state'
+
+export * from './document'