refactor(terminology): rename user-facing tenant labels to workspace
Align product copy, API docs, Swagger descriptions, and i18n strings with workspace terminology while keeping internal tenant identifiers and headers unchanged for API compatibility.
This commit is contained in:
+7
-7
@@ -147,7 +147,7 @@ DISABLE_REGISTRATION=false
|
||||
# WEKNORA_AUTH_DEFAULT_TENANT_MODE=create_personal
|
||||
|
||||
# 是否允许普通用户登录后主动创建空间。设为 false 时只能通过邀请加入已有空间,
|
||||
# 跨租户超管不受影响。默认 true。
|
||||
# 跨空间超管不受影响。默认 true。
|
||||
# WEKNORA_TENANT_SELF_SERVICE_CREATION_ENABLED=true
|
||||
|
||||
# Ollama 服务的基准 URL,用于连接本地/其他服务器上运行的 Ollama 服务
|
||||
@@ -513,7 +513,7 @@ WEKNORA_SANDBOX_TIMEOUT=60
|
||||
# WEKNORA_AGENT_TOOL_APPROVAL_TIMEOUT=600
|
||||
|
||||
# ========== Tenant / RBAC 配置 ==========
|
||||
# 启用租户级 RBAC(基于 tenant_members 表的角色强制鉴权)。
|
||||
# 启用空间级 RBAC(基于 tenant_members 表的角色强制鉴权)。
|
||||
# - true(默认):开启后,无 active membership 或角色不足的请求会被 403 拒绝
|
||||
# - false:观察模式,记录但不拦截,仅用于上线初期审计角色分配的灰度窗口
|
||||
# 详细灰度方案见 docs/RBAC说明.md。
|
||||
@@ -527,7 +527,7 @@ WEKNORA_SANDBOX_TIMEOUT=60
|
||||
# - 适用于 docker-compose / k8s 部署的初次自举;后续的提权/撤销请走 SystemAdmin 管理页
|
||||
# WEKNORA_BOOTSTRAP_SYSTEM_ADMIN_EMAIL=
|
||||
|
||||
# 单个非超管用户可自助创建(成为 Owner)的租户数上限。
|
||||
# 单个非超管用户可自助创建(成为 Owner)的空间数上限。
|
||||
# 仅统计 Owner 角色——被邀请为 Admin/Editor/Viewer 的不计入。
|
||||
# 拥有 CanAccessAllTenants 的超管不受此限制。
|
||||
# > 0 :启用该值作为硬上限;超出返回 429
|
||||
@@ -535,10 +535,10 @@ WEKNORA_SANDBOX_TIMEOUT=60
|
||||
# < 0 :彻底关闭限额(不建议在共享部署中使用)
|
||||
# WEKNORA_TENANT_MAX_OWNED_PER_USER=
|
||||
|
||||
# 创建租户时是否自动生成一个全量权限(full_access)的 API Key,
|
||||
# 并在「创建租户」接口的响应中返回其明文 token(字段 api_key)。
|
||||
# 用于兼容旧版本「创建租户即下发默认 API Key」的行为(破坏性变更的回退开关)。
|
||||
# - true :创建租户时自动创建 full_access API Key 并返回 token
|
||||
# 创建空间时是否自动生成一个全量权限(full_access)的 API Key,
|
||||
# 并在「创建空间」接口的响应中返回其明文 token(字段 api_key)。
|
||||
# 用于兼容旧版本「创建空间即下发默认 API Key」的行为(破坏性变更的回退开关)。
|
||||
# - true :创建空间时自动创建 full_access API Key 并返回 token
|
||||
# - false(默认):不自动创建,需通过 API Key 管理页/接口显式创建
|
||||
# 也可在系统设置中以 tenant.auto_create_api_key 实时调整,无需重启。
|
||||
# WEKNORA_TENANT_AUTO_CREATE_API_KEY=false
|
||||
|
||||
@@ -50,7 +50,7 @@
|
||||
|
||||
[**WeKnora**](https://weknora.weixin.qq.com) is an open-source, LLM-powered knowledge framework built for enterprise-grade document understanding, semantic retrieval, and autonomous reasoning.
|
||||
|
||||
It is organized around three core capabilities: **RAG-based Quick Q&A** for everyday lookups, a **ReAct Agent** that autonomously orchestrates retrieval, MCP tools and web search to handle complex multi-step tasks, and a brand-new **Wiki Mode** in which agents distill raw documents into a self-maintaining, interlinked markdown knowledge base with an interactive knowledge graph. Combined with multi-source ingestion (Feishu / Notion / Yuque / RSS, and growing), **website embed widgets** for publishing agents to external sites, 20+ LLM provider integrations, full Langfuse observability, **enterprise-ready multi-tenant RBAC** (4-tier role matrix + per-resource ownership + per-tenant audit log), and a fully self-hostable modular architecture, WeKnora turns scattered documents into a queryable, reasoning-capable, continuously evolving knowledge asset.
|
||||
It is organized around three core capabilities: **RAG-based Quick Q&A** for everyday lookups, a **ReAct Agent** that autonomously orchestrates retrieval, MCP tools and web search to handle complex multi-step tasks, and a brand-new **Wiki Mode** in which agents distill raw documents into a self-maintaining, interlinked markdown knowledge base with an interactive knowledge graph. Combined with multi-source ingestion (Feishu / Notion / Yuque / RSS, and growing), **website embed widgets** for publishing agents to external sites, 20+ LLM provider integrations, full Langfuse observability, **enterprise-ready multi-workspace RBAC** (4-tier role matrix + per-resource ownership + per-workspace audit log), and a fully self-hostable modular architecture, WeKnora turns scattered documents into a queryable, reasoning-capable, continuously evolving knowledge asset.
|
||||
|
||||
The framework supports auto-syncing knowledge from Feishu, Notion, and Yuque (more data sources coming soon), handles 10+ document formats including PDF, Word, images, and Excel, and can serve Q&A directly through IM channels like WeCom, Feishu, Slack, and Telegram. It is compatible with major LLM providers including OpenAI, DeepSeek, Qwen (Alibaba Cloud), Zhipu, Hunyuan, Gemini, MiniMax, NVIDIA, and Ollama. Its fully modular design allows swapping LLMs, vector databases, and storage backends, with support for local and private cloud deployment ensuring complete data sovereignty. WeKnora also integrates with **Langfuse** for comprehensive observability into agent reasoning, token usage, and pipeline tracing.
|
||||
|
||||
@@ -60,9 +60,9 @@ The framework supports auto-syncing knowledge from Feishu, Notion, and Yuque (mo
|
||||
- **v0.6.3** — Website embed widget & Integrations Center (secure-mode token exchange + rate limits); chat experience overhaul (citation popovers, RAG pipeline progress, streaming markdown); document multi-tag & batch reparse; Wiki folders & hierarchy navigation; RSS data source; MCP OAuth2; EPUB / MHTML parsing; agent model-readiness checks; model test debugger; session source filter; workspace deletion UI. See [`CHANGELOG.md`](./CHANGELOG.md).
|
||||
- **v0.6.2** — Per-upload process configuration with upload-confirm dialog; document reparse with `process_config`; `weknora` CLI v0.9 (bundled Agent Skills, `session stop`, auth/profile harmonization); KB marquee multi-select; HNSW index for 1024-dim pgvector embeddings; chat resources store refactor; Langfuse-only tracing (Jaeger removed). See [`CHANGELOG.md`](./CHANGELOG.md).
|
||||
- **v0.6.1** — Document parsing trace timeline (Langfuse-style span tree with stage-by-stage progress + stop-parse); OpenSearch vector store driver; declarative built-in models via YAML; system admin & consolidated platform settings + audit log; new-user onboarding guide; settings UI redesign; `weknora` CLI v0.7 / v0.8 (agent-first wire contract, NDJSON, `--dry-run`); OpenDataLoader + PaddleOCR-VL parsers; MCP server multi-transport (stdio / SSE / HTTP); per-model thinking-mode config; Tencent LKEAP rerank + native Gemini embeddings + MiniMax-M3. See [`CHANGELOG.md`](./CHANGELOG.md).
|
||||
- **v0.6.0** — Tenant RBAC (4-tier role matrix `Owner` / `Admin` / `Contributor` / `Viewer` + per-KB ownership + per-tenant audit log), tenant member management & multi-workspace UX, self-service workspaces; `weknora` CLI v0.4 GA with `mcp serve`; KB retrieval fan-out across vector stores; AES-256-GCM credential encryption + docreader gRPC TLS + Token; Zhipu embedder + Huawei OBS; server-side user preferences; Go 1.26.0. See [`docs/RBAC说明.md`](./docs/RBAC说明.md) and [`CHANGELOG.md`](./CHANGELOG.md).
|
||||
- **v0.6.0** — Workspace RBAC (4-tier role matrix `Owner` / `Admin` / `Contributor` / `Viewer` + per-KB ownership + per-workspace audit log), workspace member management & multi-workspace UX, self-service workspaces; `weknora` CLI v0.4 GA with `mcp serve`; KB retrieval fan-out across vector stores; AES-256-GCM credential encryption + docreader gRPC TLS + Token; Zhipu embedder + Huawei OBS; server-side user preferences; Go 1.26.0. See [`docs/RBAC说明.md`](./docs/RBAC说明.md) and [`CHANGELOG.md`](./CHANGELOG.md).
|
||||
- **v0.5.2** — Wiki ingest scales to 40k-document KBs (task queue + DLQ); MCP human-in-the-loop tool approval; Anthropic / Apache Doris / Tencent VectorDB / KS3 / SearXNG backends; adaptive 3-tier chunking with live preview; global ⌘K command palette; Yuque connector + WeChat Mini Program; `weknora` CLI preview.
|
||||
- **v0.5.1** — Knowledge-base batch management; tenant-wide IM channels overview; session search + user-scoped pinning; unified Model / Web Search / MCP settings cards; per-agent LLM timeout; desktop tenant switching.
|
||||
- **v0.5.1** — Knowledge-base batch management; workspace-wide IM channels overview; session search + user-scoped pinning; unified Model / Web Search / MCP settings cards; per-agent LLM timeout; desktop workspace switching.
|
||||
- **v0.5.0** — Wiki Mode GA — agents auto-generate structured, interlinked Markdown wiki pages with a knowledge graph; wiki browser + visual graph in the UI.
|
||||
- **v0.4.0** — WeKnora Cloud (hosted LLM + parsing); Chrome Extension; ClawHub Skill; WeChat IM; attachment processing; Azure OpenAI / Alibaba OSS; Notion connector; Baidu + Ollama web search; VectorStore management.
|
||||
- **v0.3.6** — ASR (audio); Feishu data-source auto-sync; OIDC; IM quote-reply context + thread-based sessions; document summarization; Tavily search; parallel tool calling; agent @mention scope restriction.
|
||||
@@ -145,11 +145,11 @@ Fully modular pipeline from document parsing, vectorization, and retrieval to LL
|
||||
|------------|---------|
|
||||
| Deployment | Local / Docker / Kubernetes (Helm) with private and offline support |
|
||||
| UI | Web UI / RESTful API / CLI (`weknora`) / Chrome Extension / Website Embed Widget / WeChat Mini Program |
|
||||
| Access Control | Tenant RBAC with 4-tier role matrix (Owner / Admin / Contributor / Viewer), per-KB resource ownership, per-tenant audit log, invite-only workspaces, self-service tenant creation, cross-tenant superuser |
|
||||
| Access Control | Workspace RBAC with 4-tier role matrix (Owner / Admin / Contributor / Viewer), per-KB resource ownership, per-workspace audit log, invite-only workspaces, self-service workspace creation, cross-workspace superuser |
|
||||
| Security | AES-256-GCM at-rest encryption for API keys and MCP / data-source credentials with graceful key rotation; gRPC TLS + Token between app and docreader; SSRF-safe HTTP client; sandbox isolation for agent skills |
|
||||
| Observability | Integrated Langfuse (sole tracing backend) for ReAct loops, token tracking, tool calls, and pipeline tracing; built-in Langfuse-style document parsing trace timeline with stage-by-stage progress |
|
||||
| Task Management | MQ async tasks, automatic database migration on version upgrade |
|
||||
| Model Management | Centralized config, declarative built-in models via YAML, per-knowledge-base model selection, per-model thinking-mode and embedding-dimension overrides, interactive model test debugger, multi-tenant built-in model sharing, WeKnora Cloud hosted models and parsing |
|
||||
| Model Management | Centralized config, declarative built-in models via YAML, per-knowledge-base model selection, per-model thinking-mode and embedding-dimension overrides, interactive model test debugger, multi-workspace built-in model sharing, WeKnora Cloud hosted models and parsing |
|
||||
|
||||
## 🧩 Chrome Extension
|
||||
|
||||
|
||||
+5
-5
@@ -50,7 +50,7 @@
|
||||
|
||||
**[WeKnora(维娜拉)](https://weknora.weixin.qq.com)** 是一款开源的、基于大语言模型(LLM)的知识管理框架,专为企业级文档理解、语义检索与智能推理场景打造。
|
||||
|
||||
框架围绕三大核心能力构建:**RAG 快速问答**适合日常知识查询,**ReAct Agent 智能推理**自主编排知识检索、MCP 工具与网络搜索完成复杂多步任务,全新的 **Wiki 模式**则让 Agent 从原始文档中自治生成相互链接的 Markdown 知识库与可视化知识图谱。结合多源数据接入(飞书 / Notion / 语雀 / RSS,更多持续接入中)、**网站嵌入 Widget** 将智能体发布到外部站点、二十余家主流模型厂商集成、Langfuse 全链路可观测性、**企业级多租户 RBAC(四级角色矩阵 + 资源归属 + 租户审计日志)**,以及完全可私有化部署的模块化架构,WeKnora 帮助团队把分散文档沉淀为可查询、可推理、可持续演进的专属知识资产。
|
||||
框架围绕三大核心能力构建:**RAG 快速问答**适合日常知识查询,**ReAct Agent 智能推理**自主编排知识检索、MCP 工具与网络搜索完成复杂多步任务,全新的 **Wiki 模式**则让 Agent 从原始文档中自治生成相互链接的 Markdown 知识库与可视化知识图谱。结合多源数据接入(飞书 / Notion / 语雀 / RSS,更多持续接入中)、**网站嵌入 Widget** 将智能体发布到外部站点、二十余家主流模型厂商集成、Langfuse 全链路可观测性、**企业级多空间 RBAC(四级角色矩阵 + 资源归属 + 空间审计日志)**,以及完全可私有化部署的模块化架构,WeKnora 帮助团队把分散文档沉淀为可查询、可推理、可持续演进的专属知识资产。
|
||||
|
||||
框架支持从飞书、Notion 及语雀等外部平台自动同步知识(更多数据源持续接入中),覆盖 PDF、Word、图片、Excel 等十余种文档格式,并可通过企业微信、飞书、Slack、Telegram 等 IM 频道直接提供问答服务。模型层面兼容 OpenAI、DeepSeek、Qwen(阿里云)、智谱、混元、Gemini、MiniMax、NVIDIA、Ollama 等主流厂商。全流程模块化设计,大模型、向量数据库、存储等组件均可灵活替换,支持本地与私有云部署,数据完全自主可控。WeKnora 还无缝集成了 **Langfuse**,为 Agent 运行、Token 使用及任务流水线提供了全面的可观测性追踪。
|
||||
|
||||
@@ -59,9 +59,9 @@
|
||||
- **v0.6.3** —— 网站嵌入 Widget 与发布集成中心(安全模式 Token 交换 + 限流);对话体验全面革新(引用浮层、RAG 流水线进度、流式 Markdown);文档多标签与批量重新解析;Wiki 文件夹与层级导航;RSS 数据源;MCP OAuth2;EPUB / MHTML 解析;Agent 模型就绪校验;模型调试器;会话来源筛选;工作区删除 UI。详见 [`CHANGELOG.md`](./CHANGELOG.md)。
|
||||
- **v0.6.2** —— 按批次解析配置(`process_config`)+ 上传确认对话框;文档重新解析(reparse)支持覆盖配置;`weknora` CLI v0.9(内置 Agent Skills、`session stop`、auth/profile 统一);知识库框选多选;pgvector 1024 维 HNSW 索引;对话资源 Store 重构;仅保留 Langfuse 追踪(移除 Jaeger)。详见 [`CHANGELOG.md`](./CHANGELOG.md)。
|
||||
- **v0.6.1** —— 文档解析追踪时间线(Langfuse 风格 Span 树,逐阶段进度展示 + 解析中止);OpenSearch 向量库驱动;YAML 声明式内置模型配置;系统管理员与统一平台设置 + 审计日志;新用户引导;设置页 UI 重构;`weknora` CLI v0.7 / v0.8(Agent 优先线协议、NDJSON、`--dry-run`);OpenDataLoader 与 PaddleOCR-VL 解析引擎;MCP Server 多传输(stdio / SSE / HTTP);按模型的思考模式配置;腾讯云 LKEAP 重排 + 原生 Gemini Embedding + MiniMax-M3。详见 [`CHANGELOG.md`](./CHANGELOG.md)。
|
||||
- **v0.6.0** —— 租户 RBAC(四级角色矩阵 `Owner` / `Admin` / `Contributor` / `Viewer` + 按 KB 归属 + 每租户审计日志)、租户成员管理与多工作区 UX、自助创建工作区;`weknora` CLI v0.4 正式版 + `mcp serve`;KB 检索跨向量库扇出;MCP / 数据源凭据 AES-256-GCM 加密 + docreader gRPC TLS + Token;新增智谱 Embedding 与华为云 OBS;服务端用户偏好;Go 1.26.0。详见 [`docs/RBAC说明.md`](./docs/RBAC说明.md) 与 [`CHANGELOG.md`](./CHANGELOG.md)。
|
||||
- **v0.6.0** —— 空间 RBAC(四级角色矩阵 `Owner` / `Admin` / `Contributor` / `Viewer` + 按 KB 归属 + 每空间审计日志)、空间成员管理与多工作区 UX、自助创建工作区;`weknora` CLI v0.4 正式版 + `mcp serve`;KB 检索跨向量库扇出;MCP / 数据源凭据 AES-256-GCM 加密 + docreader gRPC TLS + Token;新增智谱 Embedding 与华为云 OBS;服务端用户偏好;Go 1.26.0。详见 [`docs/RBAC说明.md`](./docs/RBAC说明.md) 与 [`CHANGELOG.md`](./CHANGELOG.md)。
|
||||
- **v0.5.2** —— Wiki 入库支撑万级文档知识库(任务队列 + 死信队列);MCP 工具人机审批;Anthropic / Apache Doris / 腾讯云 VectorDB / 金山云 KS3 / SearXNG 后端;自适应三层分块 + 实时调试面板;全局 ⌘K 命令面板;语雀连接器 + 微信小程序;`weknora` CLI 早期版本。
|
||||
- **v0.5.1** —— 知识库批量管理;租户级 IM 频道总览;会话搜索 + 用户级置顶;模型 / 网页搜索 / MCP 统一卡片化设置;按 Agent LLM 调用超时;桌面端租户切换。
|
||||
- **v0.5.1** —— 知识库批量管理;空间级 IM 频道总览;会话搜索 + 用户级置顶;模型 / 网页搜索 / MCP 统一卡片化设置;按 Agent LLM 调用超时;桌面端空间切换。
|
||||
- **v0.5.0** —— Wiki 模式正式版 —— Agent 从原始文档自治生成结构化、相互链接的 Markdown Wiki 页面及知识图谱;Wiki 浏览器 + 可视化图谱。
|
||||
- **v0.4.0** —— WeKnora Cloud(托管模型 + 解析);Chrome 插件;ClawHub Skill;微信 IM;附件处理;Azure OpenAI / 阿里云 OSS;Notion 连接器;百度 + Ollama 网页搜索;VectorStore 管理。
|
||||
- **v0.3.6** —— ASR 语音;飞书数据源自动同步;OIDC;IM 引用回复 + 线程会话;文档自动摘要;Tavily 搜索;并行工具调用;Agent @提及范围限制。
|
||||
@@ -145,11 +145,11 @@
|
||||
|------|------|
|
||||
| 部署 | 本地 / Docker / Kubernetes (Helm),支持私有化离线部署 |
|
||||
| 界面 | Web UI / RESTful API / 命令行(`weknora`)/ Chrome Extension / 网站嵌入 Widget / 微信小程序 |
|
||||
| 权限控制 | 租户 RBAC 四级角色矩阵(Owner / Admin / Contributor / Viewer),按知识库的资源归属,每租户审计日志,invite-only 准入,自助创建工作区,跨租户超级管理员 |
|
||||
| 权限控制 | 空间 RBAC 四级角色矩阵(Owner / Admin / Contributor / Viewer),按知识库的资源归属,每空间审计日志,invite-only 准入,自助创建工作区,跨空间超级管理员 |
|
||||
| 安全 | API Key 与 MCP / 数据源凭据 AES-256-GCM 静态加密、支持平滑密钥轮换;app ↔ docreader gRPC TLS + Token;防 SSRF HTTP 客户端;Agent 技能沙箱隔离 |
|
||||
| 可观测性 | 集成 Langfuse(唯一追踪后端)以追踪 ReAct 循环、Token 消耗、工具调用和任务流水线;内置 Langfuse 风格的文档解析追踪时间线,逐阶段展示解析进度 |
|
||||
| 任务管理 | MQ 异步任务,版本升级自动数据库迁移 |
|
||||
| 模型管理 | 集中配置,YAML 声明式内置模型配置,知识库级别模型选择,按模型思考模式与 Embedding 维度覆盖,交互式模型调试器,多租户共享内置模型,WeKnora Cloud 托管模型与文档解析 |
|
||||
| 模型管理 | 集中配置,YAML 声明式内置模型配置,知识库级别模型选择,按模型思考模式与 Embedding 维度覆盖,交互式模型调试器,多空间共享内置模型,WeKnora Cloud 托管模型与文档解析 |
|
||||
|
||||
## 🧩 Chrome 插件
|
||||
|
||||
|
||||
+5
-5
@@ -9,7 +9,7 @@
|
||||
1. **会话管理**:创建、获取、更新和删除会话
|
||||
2. **知识库管理**:创建、获取、更新和删除知识库
|
||||
3. **知识管理**:添加、获取和删除知识内容
|
||||
4. **租户管理**:租户的CRUD操作
|
||||
4. **空间管理**:空间的CRUD操作
|
||||
5. **知识问答**:支持普通问答和流式问答
|
||||
6. **Agent问答**:支持基于Agent的智能问答,包含思考过程、工具调用和反思
|
||||
7. **分块管理**:查询、更新和删除知识分块
|
||||
@@ -35,9 +35,9 @@ apiClient := client.NewClient(
|
||||
)
|
||||
```
|
||||
|
||||
### 租户配置
|
||||
### 空间配置
|
||||
|
||||
客户端支持通过 `WithTenantID` 设置默认租户,请求时会自动携带 `X-Tenant-ID` 请求头:
|
||||
客户端支持通过 `WithTenantID` 设置默认空间,请求时会自动携带 `X-Tenant-ID` 请求头:
|
||||
|
||||
```go
|
||||
tenantID := uint64(10000)
|
||||
@@ -48,11 +48,11 @@ apiClient := client.NewClient(
|
||||
)
|
||||
```
|
||||
|
||||
如果某个请求需要临时切换租户,可以在 `context` 中设置 `TenantID`,值可以是 `uint64`、`*uint64` 或字符串形式的数字,客户端会优先使用该值:
|
||||
如果某个请求需要临时切换空间,可以在 `context` 中设置 `TenantID`,值可以是 `uint64`、`*uint64` 或字符串形式的数字,客户端会优先使用该值:
|
||||
|
||||
```go
|
||||
ctx := context.WithValue(context.Background(), "TenantID", uint64(10000))
|
||||
// 调用任意客户端方法时传入 ctx,即可切换到租户 10000
|
||||
// 调用任意客户端方法时传入 ctx,即可切换到空间 10000
|
||||
```
|
||||
|
||||
### 示例:创建知识库并上传文件
|
||||
|
||||
+5
-5
@@ -9,7 +9,7 @@ The client includes the following main functional modules:
|
||||
1. **Session Management**: Create, retrieve, update, and delete sessions
|
||||
2. **Knowledge Base Management**: Create, retrieve, update, and delete knowledge bases
|
||||
3. **Knowledge Management**: Add, retrieve, and delete knowledge content
|
||||
4. **Tenant Management**: CRUD operations for tenants
|
||||
4. **Workspace Management**: CRUD operations for workspaces
|
||||
5. **Knowledge Q&A**: Supports regular Q&A and streaming Q&A
|
||||
6. **Chunk Management**: Query, update, and delete knowledge chunks
|
||||
7. **Message Management**: Retrieve and delete session messages
|
||||
@@ -35,9 +35,9 @@ apiClient := client.NewClient(
|
||||
)
|
||||
```
|
||||
|
||||
### Tenant Configuration
|
||||
### Workspace Configuration
|
||||
|
||||
You can set a default tenant with `WithTenantID`; the client will automatically send the `X-Tenant-ID` header:
|
||||
You can set a default workspace with `WithTenantID`; the client will automatically send the `X-Tenant-ID` header:
|
||||
|
||||
```go
|
||||
tenantID := uint64(10000)
|
||||
@@ -48,11 +48,11 @@ apiClient := client.NewClient(
|
||||
)
|
||||
```
|
||||
|
||||
If a single request needs a different tenant, set `TenantID` in the request context. The value can be a `uint64`, `*uint64`, or a numeric string, and it will take precedence over the client default:
|
||||
If a single request needs a different workspace, set `TenantID` in the request context. The value can be a `uint64`, `*uint64`, or a numeric string, and it will take precedence over the client default:
|
||||
|
||||
```go
|
||||
ctx := context.WithValue(context.Background(), "TenantID", uint64(10000))
|
||||
// Pass ctx into any client method to switch to tenant 10000 for that request
|
||||
// Pass ctx into any client method to switch to workspace 10000 for that request
|
||||
```
|
||||
|
||||
### Example: Create Knowledge Base and Upload File
|
||||
|
||||
+1
-1
@@ -19,7 +19,7 @@
|
||||
// @securityDefinitions.apikey ApiKeyAuth
|
||||
// @in header
|
||||
// @name X-API-Key
|
||||
// @description 租户身份认证:输入 sk- 开头的 API Key
|
||||
// @description 空间身份认证:输入 sk- 开头的 API Key
|
||||
package main
|
||||
|
||||
import (
|
||||
|
||||
+3
-3
@@ -189,10 +189,10 @@ services:
|
||||
- WEKNORA_AGENT_LLM_TIMEOUT=${WEKNORA_AGENT_LLM_TIMEOUT:-}
|
||||
- WEKNORA_AGENT_TOOL_APPROVAL_TIMEOUT=${WEKNORA_AGENT_TOOL_APPROVAL_TIMEOUT:-}
|
||||
# Tenant / RBAC(详见 docs/RBAC说明.md 与 .env.example 注释)
|
||||
# - WEKNORA_TENANT_ENABLE_RBAC: 是否启用租户角色强制鉴权(true / false),默认 true
|
||||
# - WEKNORA_TENANT_MAX_OWNED_PER_USER: 单个非超管自助创建租户的上限
|
||||
# - WEKNORA_TENANT_ENABLE_RBAC: 是否启用空间角色强制鉴权(true / false),默认 true
|
||||
# - WEKNORA_TENANT_MAX_OWNED_PER_USER: 单个非超管自助创建空间的上限
|
||||
# >0 强制限额;=0 走 handler 默认;<0 关闭限额(不建议共享部署使用)
|
||||
# - WEKNORA_TENANT_AUTO_CREATE_API_KEY: 创建租户时自动生成 full_access API Key 并在响应中返回 token
|
||||
# - WEKNORA_TENANT_AUTO_CREATE_API_KEY: 创建空间时自动生成 full_access API Key 并在响应中返回 token
|
||||
# (兼容旧版默认下发 API Key 行为,破坏性变更回退开关;true / false,默认 false)
|
||||
- WEKNORA_TENANT_ENABLE_RBAC=${WEKNORA_TENANT_ENABLE_RBAC:-}
|
||||
- WEKNORA_TENANT_MAX_OWNED_PER_USER=${WEKNORA_TENANT_MAX_OWNED_PER_USER:-}
|
||||
|
||||
@@ -2,11 +2,11 @@
|
||||
|
||||
## 概述
|
||||
|
||||
内置 MCP 服务是系统级别的 MCP(Model Context Protocol)服务配置,对所有租户可见,但敏感信息会被隐藏,且不可编辑或删除。内置 MCP 服务通常用于提供系统默认的外部工具和资源接入,确保所有租户都能使用统一的 MCP 服务。
|
||||
内置 MCP 服务是系统级别的 MCP(Model Context Protocol)服务配置,对所有空间可见,但敏感信息会被隐藏,且不可编辑或删除。内置 MCP 服务通常用于提供系统默认的外部工具和资源接入,确保所有空间都能使用统一的 MCP 服务。
|
||||
|
||||
## 内置 MCP 服务特性
|
||||
|
||||
- **所有租户可见**:内置 MCP 服务对所有租户都可见,无需单独配置
|
||||
- **所有空间可见**:内置 MCP 服务对所有空间都可见,无需单独配置
|
||||
- **安全保护**:内置 MCP 服务的敏感信息(URL、认证配置、Headers、环境变量)会被隐藏,无法查看详情
|
||||
- **只读保护**:内置 MCP 服务不能被编辑或删除,仅支持测试连接
|
||||
- **统一管理**:由系统管理员统一维护,确保配置一致性和安全性
|
||||
@@ -16,7 +16,7 @@
|
||||
| 特性 | 内置模型 | 内置 MCP 服务 |
|
||||
|------|---------|--------------|
|
||||
| 标识字段 | `is_builtin` | `is_builtin` |
|
||||
| 可见范围 | 所有租户 | 所有租户 |
|
||||
| 可见范围 | 所有空间 | 所有空间 |
|
||||
| 隐藏信息 | API Key、Base URL | URL、认证配置、Headers、环境变量 |
|
||||
| 编辑保护 | 不可编辑/删除 | 不可编辑/删除 |
|
||||
| 前端标签 | 显示"内置"标签 | 显示"内置"标签 |
|
||||
@@ -35,7 +35,7 @@
|
||||
- 服务地址(url):SSE / HTTP Streamable 必填
|
||||
- 认证配置(auth_config):可选,包括 api_key、token 等
|
||||
- 高级配置(advanced_config):可选,包括超时、重试策略等
|
||||
- 租户ID(tenant_id):建议使用小于 10000 的租户ID,避免冲突
|
||||
- 空间ID(tenant_id):建议使用小于 10000 的空间ID,避免冲突
|
||||
|
||||
**支持的传输方式**:
|
||||
- `sse`:Server-Sent Events,推荐用于流式体验
|
||||
@@ -62,7 +62,7 @@ INSERT INTO mcp_services (
|
||||
is_builtin
|
||||
) VALUES (
|
||||
'builtin-mcp-001', -- 使用固定ID,建议使用 builtin-mcp- 前缀
|
||||
10000, -- 租户ID(使用第一个租户)
|
||||
10000, -- 空间ID(使用第一个空间)
|
||||
'Web Search', -- 服务名称
|
||||
'内置 Web 搜索 MCP 服务', -- 描述
|
||||
true, -- 启用状态
|
||||
@@ -115,7 +115,7 @@ ORDER BY created_at;
|
||||
## 注意事项
|
||||
|
||||
1. **ID 命名规范**:建议使用 `builtin-mcp-{序号}` 的格式,例如 `builtin-mcp-001`、`builtin-mcp-002`
|
||||
2. **租户ID**:内置 MCP 服务可以属于任意租户,但建议使用第一个租户ID(通常是 10000)
|
||||
2. **空间ID**:内置 MCP 服务可以属于任意空间,但建议使用第一个空间ID(通常是 10000)
|
||||
3. **JSON 格式**:`auth_config`、`advanced_config`、`headers` 等字段必须是有效的 JSON 格式
|
||||
4. **幂等性**:使用 `ON CONFLICT (id) DO NOTHING` 确保重复执行不会报错
|
||||
5. **安全性**:内置 MCP 服务的 URL、认证信息在前端会被自动隐藏,但数据库中的原始数据仍然存在,请妥善保管数据库访问权限
|
||||
|
||||
@@ -2,18 +2,18 @@
|
||||
|
||||
## 概述
|
||||
|
||||
内置模型是系统级别的模型配置,对所有租户可见。普通租户用户(包括租户管理员)看到的敏感信息会被隐藏,且不能修改;系统管理员可以在「模型管理」界面编辑配置和凭据。内置模型通常用于提供系统默认的模型配置,确保所有租户都能使用统一的模型服务。
|
||||
内置模型是系统级别的模型配置,对所有空间可见。普通空间用户(包括空间管理员)看到的敏感信息会被隐藏,且不能修改;系统管理员可以在「模型管理」界面编辑配置和凭据。内置模型通常用于提供系统默认的模型配置,确保所有空间都能使用统一的模型服务。
|
||||
|
||||
## 内置模型特性
|
||||
|
||||
- **所有租户可见**:内置模型对所有租户都可见,无需单独配置
|
||||
- **所有空间可见**:内置模型对所有空间都可见,无需单独配置
|
||||
- **安全保护**:API Key 等凭据永远不会明文返回;只有系统管理员能看到 Base URL 等管理信息和凭据是否已配置
|
||||
- **权限保护**:普通租户用户只能查看;系统管理员可以编辑配置和凭据
|
||||
- **统一管理**:内置模型对所有租户生效;删除仍通过 YAML 或 SQL 管理,避免部署配置与运行时状态冲突
|
||||
- **权限保护**:普通空间用户只能查看;系统管理员可以编辑配置和凭据
|
||||
- **统一管理**:内置模型对所有空间生效;删除仍通过 YAML 或 SQL 管理,避免部署配置与运行时状态冲突
|
||||
|
||||
## 在管理界面编辑
|
||||
|
||||
系统管理员可直接在「设置 → 模型管理」中点击内置模型,修改模型参数或更新凭据。普通租户管理员仍然只能查看。
|
||||
系统管理员可直接在「设置 → 模型管理」中点击内置模型,修改模型参数或更新凭据。普通空间管理员仍然只能查看。
|
||||
|
||||
首次通过管理界面保存 YAML 托管的内置模型后,该行会转为运行时托管(`managed_by` 清空),后续应用启动不会再用同 ID 的 YAML 条目覆盖它。这样可以保证界面保存的结果在重启后仍然有效。若希望重新交给 YAML 管理,需要由部署管理员在数据库中把该行的 `managed_by` 恢复为 `yaml`,或移除运行时覆盖后重新启动。
|
||||
|
||||
@@ -271,7 +271,7 @@ DELETE FROM models WHERE id = '模型ID';
|
||||
## 注意事项
|
||||
|
||||
1. **ID 命名规范**:建议使用 `builtin-{type}-{slug}` 的格式,例如 `builtin-openai-chat`、`builtin-rerank`
|
||||
2. **租户ID**:内置模型可以属于任意租户,默认 `10000`(与 `tenants_id_seq` 起点一致)
|
||||
2. **空间ID**:内置模型可以属于任意空间,默认 `10000`(与 `tenants_id_seq` 起点一致)
|
||||
3. **YAML 与 SQL 并存**:两种方式可以同时使用,loader 只动 `managed_by='yaml'` 的行;通过 SQL 插入的 builtin 行对 loader 完全不可见
|
||||
4. **`is_default` 单一保证**:YAML 中将某条 entry 标记 `is_default: true` 时,loader 会先把同 `(tenant_id, type)` 下的其它默认模型置为 `false`,避免 API 路径维护的"每类型一个默认模型"语义被破坏
|
||||
5. **重启即生效**:修改 YAML 后 `docker compose restart app` 即可让新配置生效
|
||||
|
||||
+4
-4
@@ -1,16 +1,16 @@
|
||||
# WeKnora Lite 与标准版区别
|
||||
|
||||
Lite 面向希望快速在本地使用、部署尽量简单的场景;标准版面向多租户协作与完整企业能力。主要差异如下。
|
||||
Lite 面向希望快速在本地使用、部署尽量简单的场景;标准版面向多空间协作与完整企业能力。主要差异如下。
|
||||
|
||||
|
||||
| 维度 | Lite | 标准版 |
|
||||
| --------- | ----------------------------------------------- | --------------------------------- |
|
||||
| **共享空间** | 不提供共享空间(成员邀请、跨成员共享知识库与智能体等) | 提供共享空间及租户隔离检索等协作能力 |
|
||||
| **租户与账号** | 单租户;开箱即用,**无需注册** | 多租户;通常需要注册、登录与组织管理 |
|
||||
| **共享空间** | 不提供共享空间(成员邀请、跨成员共享知识库与智能体等) | 提供共享空间及空间隔离检索等协作能力 |
|
||||
| **空间与账号** | 单空间;开箱即用,**无需注册** | 多空间;通常需要注册、登录与组织管理 |
|
||||
| **文档解析** | 内置仅 **Simple** 类型解析引擎;可通过 **Cloud** 等方式接入其他解析能力 | 可配置多种解析引擎(含高精度等),与完整文档处理链路集成 |
|
||||
| **部署形态** | **单应用、零依赖**(不依赖独立的数据库、消息队列等外部服务栈) | 典型为 Docker Compose 等多服务部署,依赖与组件更多 |
|
||||
| **数据归属** | 数据**完全在本地**存储与处理 | 私有化部署时数据也可在本地;具体取决于你的部署方式 |
|
||||
| **网络暴露** | **默认仅本机访问**;可按需配置,**选择是否放行到公网** | 按部署与安全策略自行绑定地址与网关 |
|
||||
|
||||
|
||||
若你不需要多团队协作、复杂解析流水线与多服务架构,Lite 更适合个人或小团队在本机零依赖试用;需要共享空间、多租户与完整解析引擎矩阵时,请使用标准版。
|
||||
若你不需要多团队协作、复杂解析流水线与多服务架构,Lite 更适合个人或小团队在本机零依赖试用;需要共享空间、多空间与完整解析引擎矩阵时,请使用标准版。
|
||||
+1
-1
@@ -233,7 +233,7 @@ Dev 相关容器都带 `-dev` 后缀、用独立网络 `WeKnora-network-dev`,
|
||||
| Input Tokens | `TokenUsage.PromptTokens` | 来自模型返回的 usage 字段。 |
|
||||
| Output Tokens | `TokenUsage.CompletionTokens` | 来自模型返回的 usage 字段。 |
|
||||
| Total Tokens | `TokenUsage.TotalTokens` | 大多数厂商返回;未返回时自动求和。 |
|
||||
| `userId` | `X-User-ID` / 租户 ID | 未登录时退化为 `tenant:<id>`,方便按租户汇总消耗;enqueue 时会写入 payload,worker 在无上游 trace 的场景也能保留归属。 |
|
||||
| `userId` | `X-User-ID` / 空间 ID | 未登录时退化为 `tenant:<id>`,方便按空间汇总消耗;enqueue 时会写入 payload,worker 在无上游 trace 的场景也能保留归属。 |
|
||||
| `sessionId` | URL 中的 `:session_id`(或 `RequestID` 兜底) | 可以在 Langfuse 的 Sessions 视图聚合一整场对话,或按单次异步批次聚合。 |
|
||||
| Time-To-First-Token | 流式调用首条有效 chunk 的时间 | 通过 `generation-update.completionStartTime` 上报。 |
|
||||
|
||||
|
||||
+1
-1
@@ -6,7 +6,7 @@
|
||||
- 每个服务都包含名称、传输方式(SSE / HTTP Streamable / Stdio)、连接地址或命令、认证信息以及高级超时与重试策略。
|
||||
|
||||
### 入口与界面
|
||||
- 打开控制台左侧菜单 `设置 -> MCP 服务`,即可看到当前租户下的所有 MCP 服务列表。
|
||||
- 打开控制台左侧菜单 `设置 -> MCP 服务`,即可看到当前空间下的所有 MCP 服务列表。
|
||||
- 列表中可快速启停服务、查看描述,并通过右侧菜单执行“测试 / 编辑 / 删除”。
|
||||
- “添加服务”按钮会弹出 `McpServiceDialog`,用于创建或修改服务。
|
||||
|
||||
|
||||
+6
-6
@@ -31,12 +31,12 @@
|
||||
2. **后端负责用授权码 `code` 向 OIDC Provider 换取 token**。
|
||||
3. 后端拿到 OIDC 用户信息后,会:
|
||||
- 查找本地用户;
|
||||
- 若用户不存在,则自动创建本地账号和默认租户;
|
||||
- 若用户不存在,则自动创建本地账号和默认空间;
|
||||
- 最终签发 WeKnora 自己的本地 JWT(`token` / `refresh_token`)。
|
||||
4. 后端不会直接把登录结果放在 query string 中,而是:
|
||||
- 将登录结果 JSON( `success`、`token`、`refresh_token` 等字段)序列化后再做 base64url 编码;
|
||||
- 以 `#oidc_result=...` 的形式重定向回前端;
|
||||
- 前端在 `App.vue` 中统一解析 hash,再调用 `/api/v1/auth/me` 补全用户和租户信息。
|
||||
- 前端在 `App.vue` 中统一解析 hash,再调用 `/api/v1/auth/me` 补全用户和空间信息。
|
||||
|
||||
因此,**OIDC Provider 的 token 只用于后端换取用户身份,本项目真正的业务访问凭证仍然是 WeKnora 自己签发的 JWT**。
|
||||
|
||||
@@ -118,7 +118,7 @@ flowchart TD
|
||||
J --> K[向 OIDC token endpoint 换 token]
|
||||
K --> L[解析 id_token / 调用 userinfo]
|
||||
L --> M{本地用户是否存在}
|
||||
M -- 否 --> N[自动注册新用户并创建默认租户]
|
||||
M -- 否 --> N[自动注册新用户并创建默认空间]
|
||||
M -- 是 --> O[使用现有用户]
|
||||
N --> P[签发 WeKnora JWT]
|
||||
O --> P
|
||||
@@ -319,7 +319,7 @@ LoginWithOIDC(ctx, code, decodedState.RedirectURI, h.resolveDefaultTenantMode(ct
|
||||
|
||||
注意这里传入的是 **state 中保存的 redirect_uri**,而不是重新拼接的地址,这样保证了 code 交换时使用的 `redirect_uri` 和授权时完全一致。
|
||||
|
||||
第四个参数是首次自动开户时的默认租户策略,由 `resolveDefaultTenantMode` 从 `auth.default_tenant_mode`(SystemSetting,DB > `WEKNORA_AUTH_DEFAULT_TENANT_MODE` > 配置文件)解析,与本地密码注册共用同一开关;OIDC 不再有独立的 `OIDC_AUTH_DEFAULT_TENANT_MODE`。
|
||||
第四个参数是首次自动开户时的默认空间策略,由 `resolveDefaultTenantMode` 从 `auth.default_tenant_mode`(SystemSetting,DB > `WEKNORA_AUTH_DEFAULT_TENANT_MODE` > 配置文件)解析,与本地密码注册共用同一开关;OIDC 不再有独立的 `OIDC_AUTH_DEFAULT_TENANT_MODE`。
|
||||
|
||||
---
|
||||
|
||||
@@ -397,7 +397,7 @@ userRepo.GetUserByEmail(ctx, userInfo.Email)
|
||||
2. 若用户名冲突,则自动追加 `-1`、`-2` 等后缀;
|
||||
3. 生成随机密码;
|
||||
4. 调用现有 `Register()` 流程创建用户;
|
||||
5. `Register()` 内部还会自动创建默认租户。
|
||||
5. `Register()` 内部还会自动创建默认空间。
|
||||
|
||||
因此,**首次使用 OIDC 登录的用户,不需要提前在 WeKnora 中手工建号**。
|
||||
|
||||
@@ -619,7 +619,7 @@ Provider 回调后端 `/auth/oidc/callback`,后端用 `code` 换 token、拉
|
||||
- 后端再固定重定向到前端首页 `/`
|
||||
3. **邮箱是本地账号关联主键**。
|
||||
- 若 Provider 没返回 email,将无法完成登录。
|
||||
4. **首次 OIDC 登录会自动创建用户和默认租户**。
|
||||
4. **首次 OIDC 登录会自动创建用户和默认空间**。
|
||||
5. **真正用于访问 WeKnora API 的仍是本地 JWT**,不是 OIDC access token。
|
||||
6. 当前实现对 `state` 做了编码封装,但 **没有服务端持久化 state/nonce 校验**;它主要用于传递上下文和基本防错,而不是完整的防重放机制。
|
||||
|
||||
|
||||
+8
-8
@@ -205,12 +205,12 @@ Wiki 模式允许 Agent 根据原始文档自动生成并维护一套结构化
|
||||
|
||||
## 11. 升级到 0.6.0 后,原本能做的操作变成了「权限不足」?
|
||||
|
||||
0.6.0 引入了租户内 RBAC(角色矩阵 + 资源归属),所有写入接口都会按角色 + `creator_id` 鉴权。常见现象:
|
||||
0.6.0 引入了空间内 RBAC(角色矩阵 + 资源归属),所有写入接口都会按角色 + `creator_id` 鉴权。常见现象:
|
||||
|
||||
- **看得到但点不动**:你大概率是该资源的 `Viewer` 或非创建者的 `Contributor`,UI 已经把写操作隐藏/置灰。检查 **用户菜单 → 当前工作区** 角色徽章。
|
||||
- **共享空间里的 KB / Agent**:他人共享给你的 KB 默认按 `Viewer` 看待;要写需要在源租户里被授予 `Admin+`。
|
||||
- **API Key 调用**:`X-API-Key` 合成虚拟用户固定为所属租户的 `Admin`(仅删除租户需 `Owner`),脚本一般无需迁移。
|
||||
- **跨租户超管**:要 `User.CanAccessAllTenants=true` 且 `enable_cross_tenant_access=true`,并通过 `X-Tenant-ID` 切租户。
|
||||
- **共享空间里的 KB / Agent**:他人共享给你的 KB 默认按 `Viewer` 看待;要写需要在源空间里被授予 `Admin+`。
|
||||
- **API Key 调用**:`X-API-Key` 合成虚拟用户固定为所属空间的 `Admin`(仅删除空间需 `Owner`),脚本一般无需迁移。
|
||||
- **跨空间超管**:要 `User.CanAccessAllTenants=true` 且 `enable_cross_tenant_access=true`,并通过 `X-Tenant-ID` 切空间。
|
||||
|
||||
如需临时回退到「仅审计、不拦截」灰度窗口,可在配置里设置 `tenant.enable_rbac=false`(或环境变量 `WEKNORA_TENANT_ENABLE_RBAC=false`)。完整的角色矩阵和归属链请见 [`docs/RBAC说明.md`](./RBAC说明.md)。
|
||||
|
||||
@@ -219,7 +219,7 @@ Wiki 模式允许 Agent 根据原始文档自动生成并维护一套结构化
|
||||
升级到 0.6.0 后系统会记住「最后活跃工作区」并在登录后自动恢复。若仍未恢复,通常是:
|
||||
|
||||
1. 浏览器清理了 LocalStorage / 切换了浏览器;
|
||||
2. 你最后访问的那个工作区已经把你移除(`/leave` 或被管理员剔除)— 系统会回退到默认租户;
|
||||
2. 你最后访问的那个工作区已经把你移除(`/leave` 或被管理员剔除)— 系统会回退到默认空间;
|
||||
3. JWT 中携带了 `tenant_id` 但已无效 — 退出重登录即可。
|
||||
|
||||
## 13. 如何让多人协作时正确分配权限?
|
||||
@@ -229,9 +229,9 @@ Wiki 模式允许 Agent 根据原始文档自动生成并维护一套结构化
|
||||
- 只读用户 → `Viewer`
|
||||
- 普通成员(上传文档、维护「自己」的 KB / Agent)→ `Contributor`
|
||||
- 运维人员(管理共享模型、向量库、解析器等基础设施)→ `Admin`
|
||||
- 租户所有者(拥有删除租户权限,每租户唯一)→ `Owner`
|
||||
- 空间所有者(拥有删除空间权限,每空间唯一)→ `Owner`
|
||||
|
||||
如果你希望开启「invite-only」(不允许自助注册到本租户),可在租户设置里打开邀请制,并通过「邀请」入口签发邀请码或链接。
|
||||
如果你希望开启「invite-only」(不允许自助注册到本空间),可在空间设置里打开邀请制,并通过「邀请」入口签发邀请码或链接。
|
||||
|
||||
## 14. 文档解析卡在「处理中」/ 解析追踪时间线打不开怎么办?
|
||||
|
||||
@@ -258,7 +258,7 @@ Wiki 模式允许 Agent 根据原始文档自动生成并维护一套结构化
|
||||
|
||||
## 17. 系统管理员(System Admin)与平台设置怎么用?
|
||||
|
||||
0.6.1 引入了系统管理员与统一平台设置面板(含平台审计日志),与租户内 RBAC 区分:系统管理员管理的是「平台级」配置,而非单个租户内的资源。首次启用需通过系统管理员 bootstrap 流程晋升首个管理员;撤销管理员权限有安全防护(避免误撤导致无人可管)。相关迁移为 `000053_system_admin_and_settings`。
|
||||
0.6.1 引入了系统管理员与统一平台设置面板(含平台审计日志),与空间内 RBAC 区分:系统管理员管理的是「平台级」配置,而非单个空间内的资源。首次启用需通过系统管理员 bootstrap 流程晋升首个管理员;撤销管理员权限有安全防护(避免误撤导致无人可管)。相关迁移为 `000053_system_admin_and_settings`。
|
||||
|
||||
## 18. 上传时如何自定义解析配置(process_config)?
|
||||
|
||||
|
||||
+33
-33
@@ -1,43 +1,43 @@
|
||||
# 租户 RBAC 说明
|
||||
# 空间 RBAC 说明
|
||||
|
||||
本文档介绍 WeKnora **租户内权限控制(Tenant RBAC)** 的设计、角色矩阵、资源归属模型、配置方式,以及它与 [共享空间](./共享空间说明.md) 之间的关系。
|
||||
本文档介绍 WeKnora **空间内权限控制(Workspace RBAC)** 的设计、角色矩阵、资源归属模型、配置方式,以及它与 [共享空间](./共享空间说明.md) 之间的关系。
|
||||
|
||||
> 状态:已随 #1303 发布,由配置项 `tenant.enable_rbac` 控制,默认 `true`(强制鉴权)。可临时切到 `false` 进入「仅记录不拦截」的灰度窗口。
|
||||
|
||||
## 一、为什么需要 RBAC
|
||||
|
||||
在 RBAC 引入之前,只要通过 `X-API-Key` 或 JWT 认证成功,调用方在租户内基本等同于管理员。这在单人自部署场景没问题,但只要一个租户里出现两个及以上的真人成员(团队共享一套知识库),就必须区分:
|
||||
在 RBAC 引入之前,只要通过 `X-API-Key` 或 JWT 认证成功,调用方在空间内基本等同于管理员。这在单人自部署场景没问题,但只要一个空间里出现两个及以上的真人成员(团队共享一套知识库),就必须区分:
|
||||
|
||||
- 谁可以删除知识库、撤销 API Key(管理员/Owner);
|
||||
- 谁可以上传文档、编辑「自己」的知识库(Contributor);
|
||||
- 谁只能读取与提问(Viewer)。
|
||||
|
||||
RBAC 在原有 JWT / API Key 认证之上,叠加了一层**租户内角色矩阵**,使三种状态都成为一等公民。
|
||||
RBAC 在原有 JWT / API Key 认证之上,叠加了一层**空间内角色矩阵**,使三种状态都成为一等公民。
|
||||
|
||||
## 二、角色矩阵
|
||||
|
||||
每个租户成员(`tenant_members` 一行)拥有且仅拥有一个角色:
|
||||
每个空间成员(`tenant_members` 一行)拥有且仅拥有一个角色:
|
||||
|
||||
| 角色 | 标识 | 典型场景 | 关键能力 |
|
||||
|------|------|----------|----------|
|
||||
| 只读 | `viewer` | 只查阅、提问的成员 | 仅读,不可发起任何变更 |
|
||||
| 贡献者 | `contributor` | 上传文档、维护自己的 KB / Agent | 可变更 `creator_id == 自己` 的资源;他人资源等同 Viewer |
|
||||
| 管理员 | `admin` | 租户内运维 | 可变更租户内任意资源;管理成员;配置共享基础设施(模型、解析器、存储、向量库等) |
|
||||
| Owner | `owner` | 租户创建者 | Admin 的全部权限 + 可删除租户;不会被其他 Admin 降级;每个租户**有且只有一位** |
|
||||
| 管理员 | `admin` | 空间内运维 | 可变更空间内任意资源;管理成员;配置共享基础设施(模型、解析器、存储、向量库等) |
|
||||
| Owner | `owner` | 空间创建者 | Admin 的全部权限 + 可删除空间;不会被其他 Admin 降级;每个空间**有且只有一位** |
|
||||
|
||||
角色按 `viewer < contributor < admin < owner` 递增,高角色继承低角色权限。
|
||||
|
||||
### 鉴权层的两个例外
|
||||
|
||||
- **跨租户超管**:`User.CanAccessAllTenants=true` 且 `enable_cross_tenant_access=true` 时,通过 `X-Tenant-ID` 切换到目标租户后等同 Admin,不需要在目标租户里有 `tenant_members` 行。用于多租户运营方。
|
||||
- **API Key 调用**:`X-API-Key` 合成的虚拟用户在其所属租户内固定为 Admin(仅删除租户仍需 Owner)。脚本集成无需迁移。
|
||||
- **孤儿租户自愈**:若一个租户在 `tenant_members` 表里没有任何活跃成员(典型场景:仅 API Key 使用过该租户),首位通过认证的真人会被自动晋升为 Owner,避免锁死。
|
||||
- **跨空间超管**:`User.CanAccessAllTenants=true` 且 `enable_cross_tenant_access=true` 时,通过 `X-Tenant-ID` 切换到目标空间后等同 Admin,不需要在目标空间里有 `tenant_members` 行。用于多空间运营方。
|
||||
- **API Key 调用**:`X-API-Key` 合成的虚拟用户在其所属空间内固定为 Admin(仅删除空间仍需 Owner)。脚本集成无需迁移。
|
||||
- **孤儿空间自愈**:若一个空间在 `tenant_members` 表里没有任何活跃成员(典型场景:仅 API Key 使用过该空间),首位通过认证的真人会被自动晋升为 Owner,避免锁死。
|
||||
|
||||
## 三、资源归属模型
|
||||
|
||||
光有角色矩阵不够,否则 Contributor 之间可以互相破坏。为此在迁移 `000043` 中给关键表加了 `creator_id`:
|
||||
|
||||
- `knowledge_bases.creator_id` —— 老数据回填为该租户的 Owner;空串/NULL 表示「租户共有,仅 Admin+ 可变更」。
|
||||
- `knowledge_bases.creator_id` —— 老数据回填为该空间的 Owner;空串/NULL 表示「空间共有,仅 Admin+ 可变更」。
|
||||
- `custom_agents.creator_id` —— Agent 创建者。
|
||||
- `custom_agents.runnable_by_viewer` —— 默认 `true`,允许 Viewer 在对话中调用该 Agent;置 `false` 则提升到 Contributor 起步。
|
||||
|
||||
@@ -51,34 +51,34 @@ FAQ 条目、生成的问题、KB 标签、Wiki 页面同理。
|
||||
|
||||
由此衍生出两类守卫:
|
||||
|
||||
- **角色守卫**:`Viewer()` / `Contributor()` / `Admin()` / `Owner()` —— 只看角色。用于租户级基础设施(模型、向量库、IM 通道等)。
|
||||
- **角色守卫**:`Viewer()` / `Contributor()` / `Admin()` / `Owner()` —— 只看角色。用于空间级基础设施(模型、向量库、IM 通道等)。
|
||||
- **归属守卫**:`OwnedKBOrAdmin()` / `OwnedAgentOrAdmin()` / `OwnedChunkKBOrAdmin()` …… —— 「我是这条资源的 `creator_id`」**或**「我至少是 Admin」二者满足其一即可。用于具体资源的写操作。
|
||||
|
||||
这样可以让「Contributor 在自己的 KB 里像 Owner,在别人的 KB 里像 Viewer」自然成立。
|
||||
|
||||
## 四、与共享空间的关系(重点)
|
||||
|
||||
[共享空间](./共享空间说明.md)(Organization)和租户 RBAC 解决的是**不同维度**的问题,必须同时满足才能完成一次跨租户操作:
|
||||
[共享空间](./共享空间说明.md)(Organization)和空间 RBAC 解决的是**不同维度**的问题,必须同时满足才能完成一次跨空间操作:
|
||||
|
||||
| 维度 | 解决什么 | 主键模型 | 角色集合 |
|
||||
|------|---------|---------|---------|
|
||||
| **租户 RBAC** | 同一租户内「你能对自己 / 别人 / 共享基础设施做什么」 | `tenant_members(user_id, tenant_id, role)` | viewer / contributor / admin / owner |
|
||||
| **共享空间** | 跨租户「把我的 KB / Agent 让别的租户的人也用」 | `organization_members(user_id, org_id, role)` + 共享关系表 | 管理员 / 编辑者 / 只读 |
|
||||
| **空间 RBAC** | 同一空间内「你能对自己 / 别人 / 共享基础设施做什么」 | `tenant_members(user_id, tenant_id, role)` | viewer / contributor / admin / owner |
|
||||
| **共享空间** | 跨空间「把我的 KB / Agent 让别的空间的人也用」 | `organization_members(user_id, org_id, role)` + 共享关系表 | 管理员 / 编辑者 / 只读 |
|
||||
|
||||
两者**正交**:
|
||||
|
||||
- 共享空间不持有任何 KB 或 Agent,它只是「某 KB 以某权限被共享到某空间」的关系记录。
|
||||
- 资源始终归属一个租户,归属与 `creator_id` 都不会因为共享而改变。
|
||||
- 资源始终归属一个空间,归属与 `creator_id` 都不会因为共享而改变。
|
||||
- 一次对**他人共享给你**的 KB 的写操作,需要同时满足:
|
||||
1. **共享一侧**:该 KB 被以「可写」权限共享到了你和发起方都在的共享空间;
|
||||
2. **空间角色一侧**:你在该共享空间内不是「只读」(即至少是编辑者);
|
||||
3. **租户 RBAC 一侧**:你的访问通过共享路径解析为对源租户的「以共享空间身份」访问,仍要经过源租户的 RBAC 检查。具体地,访问检查会在确认 `kb.tenant_id == 你的当前租户` 不成立后,回落到共享路径校验。
|
||||
3. **空间 RBAC 一侧**:你的访问通过共享路径解析为对源空间的「以共享空间身份」访问,仍要经过源空间的 RBAC 检查。具体地,访问检查会在确认 `kb.tenant_id == 你的当前空间` 不成立后,回落到共享路径校验。
|
||||
|
||||
简化的判定顺序(见 `internal/middleware/kb_access.go`):
|
||||
|
||||
```text
|
||||
┌────────────────────────┐
|
||||
│ KB 属于我当前租户? │ ──是──► 进入租户 RBAC:
|
||||
│ KB 属于我当前空间? │ ──是──► 进入空间 RBAC:
|
||||
└──────┬─────────────────┘ 角色 + creator_id 决定能否写
|
||||
否
|
||||
▼
|
||||
@@ -96,11 +96,11 @@ FAQ 条目、生成的问题、KB 标签、Wiki 页面同理。
|
||||
|
||||
要点整理:
|
||||
|
||||
- **共享空间不会绕过租户 RBAC**:若一个 KB 在源租户里被标记为「仅 Admin+ 可写」(例如 `creator_id` 为空的租户共有 KB),即使共享时给了「可写」权限,外租户成员也只能读取——因为没人能跨租户成为源租户的 Admin。
|
||||
- **API Key 跨空间访问**:API Key 在所属租户内是 Admin,但**不会**因此自动获得对其他租户通过共享空间共享过来的 KB 的写权限——共享空间使用的是 `organization_members.role`,与 API Key 无关。
|
||||
- **审计也是分开的**:租户内角色变更写入 `audit_logs`(`rbac.member_*` 动作),共享空间内的成员、共享关系变更由共享空间自身的接口记录。
|
||||
- **共享空间不会绕过空间 RBAC**:若一个 KB 在源空间里被标记为「仅 Admin+ 可写」(例如 `creator_id` 为空的空间共有 KB),即使共享时给了「可写」权限,外空间成员也只能读取——因为没人能跨空间成为源空间的 Admin。
|
||||
- **API Key 跨空间访问**:API Key 在所属空间内是 Admin,但**不会**因此自动获得对其他空间通过共享空间共享过来的 KB 的写权限——共享空间使用的是 `organization_members.role`,与 API Key 无关。
|
||||
- **审计也是分开的**:空间内角色变更写入 `audit_logs`(`rbac.member_*` 动作),共享空间内的成员、共享关系变更由共享空间自身的接口记录。
|
||||
|
||||
一句话总结:**租户 RBAC 是「纵向」的纵深防御,共享空间是「横向」的协作通道;任何跨租户的有写副作用的操作,都要同时穿过这两道闸口。**
|
||||
一句话总结:**空间 RBAC 是「纵向」的纵深防御,共享空间是「横向」的协作通道;任何跨空间的有写副作用的操作,都要同时穿过这两道闸口。**
|
||||
|
||||
## 五、配置
|
||||
|
||||
@@ -110,11 +110,11 @@ FAQ 条目、生成的问题、KB 标签、Wiki 页面同理。
|
||||
tenant:
|
||||
# 默认 true,强制鉴权。改为 false 进入「仅记录不拦截」灰度窗口
|
||||
enable_rbac: true
|
||||
# 跨租户超管开关,默认 false
|
||||
# 跨空间超管开关,默认 false
|
||||
enable_cross_tenant_access: false
|
||||
|
||||
auth:
|
||||
# self_serve(默认):任何人都可注册,自动建租户 + Owner 成员
|
||||
# self_serve(默认):任何人都可注册,自动建空间 + Owner 成员
|
||||
# invite_only :禁止公开注册,新用户必须通过 /tenants/:id/members 邀请进入
|
||||
registration_mode: self_serve
|
||||
|
||||
@@ -154,9 +154,9 @@ audit:
|
||||
|
||||
无论是自部署运维还是上游仓库本身,从「仅记录」切到「强制鉴权」都建议走以下流程:
|
||||
|
||||
1. **升级**:若想保留观察窗口,升级前先设置 `tenant.enable_rbac=false`(或环境变量)。否则默认就是强制鉴权——schema 落地、`tenant_members` 自动回填(每租户一个 Owner,其余 Contributor)、所有 KB 自动写入 `creator_id`。
|
||||
1. **升级**:若想保留观察窗口,升级前先设置 `tenant.enable_rbac=false`(或环境变量)。否则默认就是强制鉴权——schema 落地、`tenant_members` 自动回填(每空间一个 Owner,其余 Contributor)、所有 KB 自动写入 `creator_id`。
|
||||
2. **核对成员**:调用 `GET /api/v1/tenants/:id/members` 确认:
|
||||
- 每个租户都只有一位 Owner;
|
||||
- 每个空间都只有一位 Owner;
|
||||
- Contributor / Viewer 划分符合预期;
|
||||
- 通过 `PUT /api/v1/tenants/:id/members/:user_id` / `DELETE` 调整。每次调整都会写入 `audit_logs`。
|
||||
3. **观察日志**:抓取应用日志里的 `[rbac] role insufficient (logged but not enforced) ...`,这些就是切换到强制鉴权后会变成 403 的请求。逐条修正成员角色或客户端身份。
|
||||
@@ -203,7 +203,7 @@ Pinia 中的 `authStore` 暴露:
|
||||
<td width="50%" align="center">
|
||||
<b>自助创建工作区</b><br/>
|
||||
<img src="./images/rbac-create-workspace.png" alt="创建新空间" width="100%"/>
|
||||
<br/><sub>任何用户都可以自助创建租户,创建后自动成为新空间的 Owner(受 <code>WEKNORA_TENANT_MAX_PER_USER</code> 上限保护)。</sub>
|
||||
<br/><sub>任何用户都可以自助创建空间,创建后自动成为新空间的 Owner(受 <code>WEKNORA_TENANT_MAX_PER_USER</code> 上限保护)。</sub>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
@@ -219,21 +219,21 @@ Pinia 中的 `authStore` 暴露:
|
||||
|
||||
### 升级后所有人都变成了 Contributor,找不到 Admin?
|
||||
|
||||
回填逻辑选「每个租户里最早活跃的用户」作为 Owner,其余人统一变成 Contributor。如果创建租户的账号其实是一个机器人 / 共用账号,可能需要先用 `PUT /api/v1/tenants/:id/members/:user_id` 把机器人降级、把真人 Admin 提升。
|
||||
回填逻辑选「每个空间里最早活跃的用户」作为 Owner,其余人统一变成 Contributor。如果创建空间的账号其实是一个机器人 / 共用账号,可能需要先用 `PUT /api/v1/tenants/:id/members/:user_id` 把机器人降级、把真人 Admin 提升。
|
||||
|
||||
### 切到强制鉴权后某个脚本开始 403?
|
||||
|
||||
大概率脚本的 JWT 对应的成员是 Viewer / Contributor 而非 Admin。两种解法:
|
||||
- 通过 `tenant_members` 把对应用户升级到 Admin;
|
||||
- 或者把脚本切到 `X-API-Key` 调用 —— API Key 在所属租户内固定 Admin。
|
||||
- 或者把脚本切到 `X-API-Key` 调用 —— API Key 在所属空间内固定 Admin。
|
||||
|
||||
### 共享空间里的成员为什么读不到我「以可写共享」过去的 KB?
|
||||
|
||||
请按第四节的判定顺序排查:
|
||||
- KB 是否真的属于源租户、`tenant_id` 配置是否正确;
|
||||
- KB 是否真的属于源空间、`tenant_id` 配置是否正确;
|
||||
- 该共享关系当前是否还存在(未被取消);
|
||||
- 调用方在共享空间里是不是 Viewer;
|
||||
- 若 KB 的 `creator_id` 在源租户内为空且共享权限要求写,源租户的 RBAC 仍会要求 Admin+,导致跨租户写无法成立。
|
||||
- 若 KB 的 `creator_id` 在源空间内为空且共享权限要求写,源空间的 RBAC 仍会要求 Admin+,导致跨空间写无法成立。
|
||||
|
||||
### 审计日志怎么有些 403 没记录?
|
||||
|
||||
@@ -252,6 +252,6 @@ v1 不支持。这个矩阵刻意保持成一个小固定格(Viewer < Contribu
|
||||
|
||||
## 相关文档
|
||||
|
||||
- 跨租户协作:[`共享空间说明.md`](./共享空间说明.md)
|
||||
- 多租户认证背景:[`OIDC认证调用流程.md`](./OIDC认证调用流程.md)
|
||||
- 跨空间协作:[`共享空间说明.md`](./共享空间说明.md)
|
||||
- 多空间认证背景:[`OIDC认证调用流程.md`](./OIDC认证调用流程.md)
|
||||
- 配置项与环境变量:[`.env.example`](../.env.example)
|
||||
|
||||
+1
-1
@@ -69,7 +69,7 @@ WeKnora API 按功能分为以下几类:
|
||||
| 分类 | 描述 | 文档链接 |
|
||||
|------|------|----------|
|
||||
| 认证管理 | 用户注册、登录、令牌管理;OIDC 流程 | [auth.md](./auth.md) · [OIDC认证调用流程.md](../OIDC认证调用流程.md) |
|
||||
| 租户管理 | 创建和管理租户账户 | [tenant.md](./tenant.md) |
|
||||
| 空间管理 | 创建和管理空间账户 | [tenant.md](./tenant.md) |
|
||||
| 知识库管理 | 创建、查询和管理知识库 | [knowledge-base.md](./knowledge-base.md) |
|
||||
| 知识管理 | 上传、检索和管理知识内容 | [knowledge.md](./knowledge.md) |
|
||||
| 模型管理 | 配置和管理各种AI模型 | [model.md](./model.md) |
|
||||
|
||||
+4
-4
@@ -111,7 +111,7 @@ curl --location 'http://localhost:8080/api/v1/agents' \
|
||||
|
||||
## GET `/agents` - 获取智能体列表
|
||||
|
||||
获取当前租户的所有智能体,包括内置智能体和自定义智能体。响应中额外返回 `disabled_own_agent_ids`,指示当前租户在前端对话下拉框中主动隐藏的本租户自有智能体 ID 列表(不影响其他租户)。
|
||||
获取当前空间的所有智能体,包括内置智能体和自定义智能体。响应中额外返回 `disabled_own_agent_ids`,指示当前空间在前端对话下拉框中主动隐藏的本空间自有智能体 ID 列表(不影响其他空间)。
|
||||
|
||||
**请求**:
|
||||
|
||||
@@ -164,7 +164,7 @@ curl --location 'http://localhost:8080/api/v1/agents' \
|
||||
|
||||
| 状态码 | 错误码 | 错误 | 说明 |
|
||||
| ------ | ------ | --------------------- | ------------------ |
|
||||
| 401 | 1001 | Unauthorized | 缺少租户上下文 |
|
||||
| 401 | 1001 | Unauthorized | 缺少空间上下文 |
|
||||
| 500 | 1007 | Internal Server Error | 服务器内部错误 |
|
||||
|
||||
---
|
||||
@@ -470,7 +470,7 @@ curl --location 'http://localhost:8080/api/v1/agents/placeholders' \
|
||||
|------|------|--------|------|
|
||||
| `web_search_enabled` | bool | true | 是否启用网络搜索 |
|
||||
| `web_search_max_results` | int | 5 | 网络搜索最大结果数 |
|
||||
| `web_search_provider_id` | string | - | 网络搜索提供者 ID,为空使用租户默认提供者 |
|
||||
| `web_search_provider_id` | string | - | 网络搜索提供者 ID,为空使用空间默认提供者 |
|
||||
| `web_fetch_enabled` | bool | false | 是否自动获取重排后的搜索结果页面全文 |
|
||||
| `web_fetch_top_n` | int | 3 | 重排后获取全文的最大页面数 |
|
||||
|
||||
@@ -548,6 +548,6 @@ curl --location 'http://localhost:8080/api/v1/agent-chat/session-123' \
|
||||
|
||||
## 相关文档
|
||||
|
||||
- 智能体的组织共享、跨租户分发与禁用(`/agents/:id/shares`、`/shared-agents` 等):见 [组织管理 API](./organization.md)
|
||||
- 智能体的组织共享、跨空间分发与禁用(`/agents/:id/shares`、`/shared-agents` 等):见 [组织管理 API](./organization.md)
|
||||
- 智能体绑定 IM 渠道(`/agents/:id/im-channels`):见组织/IM 渠道相关文档
|
||||
- 网络搜索提供者配置(被 `web_search_provider_id` 引用):见 [Web Search API](./web-search.md)
|
||||
|
||||
+1
-1
@@ -84,7 +84,7 @@ Agent 模式支持更智能的问答,包括工具调用、网络搜索、多
|
||||
|
||||
## 回答后推荐问题
|
||||
|
||||
回答主消息完成后,服务端会异步生成推荐问题,不阻塞 SSE 的 `complete`/`done` 事件。生成结果按“租户、助手消息、位置、配置快照、语言”持久化并去重。
|
||||
回答主消息完成后,服务端会异步生成推荐问题,不阻塞 SSE 的 `complete`/`done` 事件。生成结果按“空间、助手消息、位置、配置快照、语言”持久化并去重。
|
||||
|
||||
```http
|
||||
POST /api/v1/sessions/{session_id}/messages/{message_id}/suggestions
|
||||
|
||||
+16
-16
@@ -6,9 +6,9 @@
|
||||
|
||||
- 知识库类型 `type` 为 `document`(文档)或 `faq`(FAQ),默认 `document`。
|
||||
- JSON 中对象存储相关字段:**`storage_config`** 为序列化字段名(对应数据库列 `cos_config`,兼容旧数据)。旧客户端若仍发送或接收 `cos_config`,服务端会兼容解析;新集成请使用 **`storage_config`**。
|
||||
- **`storage_provider_config`** 为新版存储提供者选择(如 `{"provider": "local"}`),与租户级存储引擎凭证配合使用;无配置时可为 `null`。
|
||||
- **`storage_provider_config`** 为新版存储提供者选择(如 `{"provider": "local"}`),与空间级存储引擎凭证配合使用;无配置时可为 `null`。
|
||||
- 嵌套配置对象:`chunking_config`、`image_processing_config`、`vlm_config`、`asr_config`、`extract_config`、`faq_config`、`question_generation_config`。其中 `extract_config`、`faq_config`、`question_generation_config` 允许为 `null`。
|
||||
- **`vector_store_id`** 为知识库绑定的向量存储 ID(参见 [vector-store.md](./vector-store.md))。未指定(或 `null`/`""`)时使用租户级默认的环境变量存储;一旦创建即不可修改。详情接口返回时会附带 `vector_store_name` / `vector_store_source` / `vector_store_engine_type` / `vector_store_status` 四个只读元数据字段,用于前端展示。
|
||||
- **`vector_store_id`** 为知识库绑定的向量存储 ID(参见 [vector-store.md](./vector-store.md))。未指定(或 `null`/`""`)时使用空间级默认的环境变量存储;一旦创建即不可修改。详情接口返回时会附带 `vector_store_name` / `vector_store_source` / `vector_store_engine_type` / `vector_store_status` 四个只读元数据字段,用于前端展示。
|
||||
|
||||
| 方法 | 路径 | 描述 |
|
||||
| ------ | ----------------------------------------- | ------------------------ |
|
||||
@@ -46,7 +46,7 @@
|
||||
| extract_config | object | 否 | 图谱抽取配置;`enabled=true` 时需提供 `text`/`tags`/`nodes`/`relations` |
|
||||
| faq_config | object | 否 | FAQ 配置(仅 FAQ 类型知识库需要) |
|
||||
| question_generation_config | object | 否 | 问题生成配置 |
|
||||
| vector_store_id | string | 否 | 绑定的向量存储 ID。不传或为空字符串等同于 `null`(使用环境变量默认存储)。指定时必须是调用者所在租户拥有的向量存储 UUID;创建后不可修改。无效 UUID / 跨租户 / 未注册到引擎的 ID 会返回 `400` |
|
||||
| vector_store_id | string | 否 | 绑定的向量存储 ID。不传或为空字符串等同于 `null`(使用环境变量默认存储)。指定时必须是调用者所在空间拥有的向量存储 UUID;创建后不可修改。无效 UUID / 跨空间 / 未注册到引擎的 ID 会返回 `400` |
|
||||
|
||||
**请求**:
|
||||
|
||||
@@ -193,8 +193,8 @@ curl --location 'http://localhost:8080/api/v1/knowledge-bases' \
|
||||
| 字段 | 类型 | 说明 |
|
||||
| -------------------------- | ------ | ---------------------------------------------------------------------------------------------------------- |
|
||||
| `vector_store_id` | string | 绑定的向量存储 ID(创建时未指定时为 `null`,从响应中省略) |
|
||||
| `vector_store_name` | string | 绑定存储的展示名。未绑定时返回 `"System default"`;跨租户共享 KB 视图中被隐藏 |
|
||||
| `vector_store_source` | string | `"user"`(DB 中创建的存储)/ `"env"`(环境变量虚拟存储)/ `"shared"`(跨租户共享 KB)/ `"unavailable"`(绑定的存储已不可解析) |
|
||||
| `vector_store_name` | string | 绑定存储的展示名。未绑定时返回 `"System default"`;跨空间共享 KB 视图中被隐藏 |
|
||||
| `vector_store_source` | string | `"user"`(DB 中创建的存储)/ `"env"`(环境变量虚拟存储)/ `"shared"`(跨空间共享 KB)/ `"unavailable"`(绑定的存储已不可解析) |
|
||||
| `vector_store_engine_type` | string | 引擎类型(`elasticsearch` / `qdrant` / `milvus` 等)。`shared` / `unavailable` 时为空 |
|
||||
| `vector_store_status` | string | `"available"` / `"unavailable"`。`unavailable` 表示绑定的存储已被删除或不在内存注册表中,UI 可据此提示用户重新绑定 |
|
||||
|
||||
@@ -202,12 +202,12 @@ curl --location 'http://localhost:8080/api/v1/knowledge-bases' \
|
||||
|
||||
| HTTP | code | 说明 |
|
||||
| ---- | ---- | ----------------------------------------------------------------- |
|
||||
| 400 | 2200 | `vector_store_id` 无效:格式错误、不存在或属于其他租户(统一返回,避免枚举泄漏) |
|
||||
| 400 | 2200 | `vector_store_id` 无效:格式错误、不存在或属于其他空间(统一返回,避免枚举泄漏) |
|
||||
| 400 | 2201 | 指定的向量存储当前不可用:存在于数据库但未注册到引擎注册表,请检查 connection_config |
|
||||
|
||||
## GET `/knowledge-bases` - 获取知识库列表
|
||||
|
||||
返回当前租户拥有的全部知识库。当传入 `agent_id` 时,校验调用者对该共享智能体的访问权限后,返回该智能体配置可见的知识库范围(用于 `@` 提及)。
|
||||
返回当前空间拥有的全部知识库。当传入 `agent_id` 时,校验调用者对该共享智能体的访问权限后,返回该智能体配置可见的知识库范围(用于 `@` 提及)。
|
||||
|
||||
**Query 参数**:
|
||||
|
||||
@@ -251,7 +251,7 @@ curl --location 'http://localhost:8080/api/v1/knowledge-bases/kb-00000001' \
|
||||
--header 'X-API-Key: sk-xxxxx'
|
||||
```
|
||||
|
||||
**响应**: 字段结构同 `POST /knowledge-bases` 响应(包含 Phase 2 的 `vector_store_*` 元数据字段),并附 `is_pinned` / `pinned_at` / `knowledge_count` / `chunk_count` / `processing_count` 状态字段。通过共享智能体访问时还会附加 `my_permission`;同时 `vector_store_name` / `vector_store_engine_type` 会被隐藏(`vector_store_source` 返回 `"shared"`),避免跨租户泄漏存储展示名。
|
||||
**响应**: 字段结构同 `POST /knowledge-bases` 响应(包含 Phase 2 的 `vector_store_*` 元数据字段),并附 `is_pinned` / `pinned_at` / `knowledge_count` / `chunk_count` / `processing_count` 状态字段。通过共享智能体访问时还会附加 `my_permission`;同时 `vector_store_name` / `vector_store_engine_type` 会被隐藏(`vector_store_source` 返回 `"shared"`),避免跨空间泄漏存储展示名。
|
||||
|
||||
## PUT `/knowledge-bases/:id` - 更新知识库
|
||||
|
||||
@@ -315,7 +315,7 @@ curl --location --request PUT 'http://localhost:8080/api/v1/knowledge-bases/b582
|
||||
|
||||
## DELETE `/knowledge-bases/:id` - 删除知识库
|
||||
|
||||
仅知识库 owner(与 owning tenant 匹配的 admin)可调用,删除将级联清理知识库下所有知识与切片。
|
||||
仅知识库 owner(与所属空间匹配的 admin)可调用,删除将级联清理知识库下所有知识与切片。
|
||||
|
||||
**路径参数**:
|
||||
|
||||
@@ -431,7 +431,7 @@ curl --location --request POST 'http://localhost:8080/api/v1/knowledge-bases/kb-
|
||||
|
||||
异步拷贝整个知识库(配置 + 全部知识内容)。请求会被入队到 Asynq 后台任务(队列 `default`,最多重试 3 次),并立即返回 `task_id` 供轮询进度。
|
||||
|
||||
**约束**:源知识库 `source_id` 必须属于调用者所在租户;若指定 `target_id`,目标知识库同样必须属于调用者租户,否则返回 `403 Forbidden`。
|
||||
**约束**:源知识库 `source_id` 必须属于调用者所在空间;若指定 `target_id`,目标知识库同样必须属于调用者空间,否则返回 `403 Forbidden`。
|
||||
|
||||
**Phase 2 同步预检(当 `target_id` 非空时)**:
|
||||
|
||||
@@ -446,9 +446,9 @@ curl --location --request POST 'http://localhost:8080/api/v1/knowledge-bases/kb-
|
||||
|
||||
| 字段 | 类型 | 必填 | 说明 |
|
||||
| ---------- | ------ | ---- | ------------------------------------------------------------- |
|
||||
| source_id | string | 是 | 源知识库 ID(必须属于当前租户) |
|
||||
| target_id | string | 否 | 目标知识库 ID(若复用已存在知识库;同样必须属于当前租户) |
|
||||
| task_id | string | 否 | 自定义任务 ID;不传则由服务端生成(基于租户、源 ID、时间戳) |
|
||||
| source_id | string | 是 | 源知识库 ID(必须属于当前空间) |
|
||||
| target_id | string | 否 | 目标知识库 ID(若复用已存在知识库;同样必须属于当前空间) |
|
||||
| task_id | string | 否 | 自定义任务 ID;不传则由服务端生成(基于空间、源 ID、时间戳) |
|
||||
|
||||
**请求**:
|
||||
|
||||
@@ -542,7 +542,7 @@ curl --location 'http://localhost:8080/api/v1/knowledge-bases/copy/progress/kb_c
|
||||
| 复制内容 | 仅设置 | 设置 + 全部知识内容 |
|
||||
| 新 KB ID | 服务端自动生成 UUID | 可指定已有目标库或新建 |
|
||||
|
||||
**权限**:需要 `Contributor+`,且对源知识库至少有 `Viewer` 读权限(路由层 `KBAccessRead`)。源知识库必须属于调用者所在租户,否则返回 `403 Forbidden`。
|
||||
**权限**:需要 `Contributor+`,且对源知识库至少有 `Viewer` 读权限(路由层 `KBAccessRead`)。源知识库必须属于调用者所在空间,否则返回 `403 Forbidden`。
|
||||
|
||||
**命名规则**:新 KB 名称在源名称后追加本地化后缀(依据 `Accept-Language` 或 `WEKNORA_LANGUAGE`),例如中文 `原名 副本`、英文 `Original Name Copy`;若同名已存在则递增为 `原名 副本 2`、`Original Name Copy 2` 等。
|
||||
|
||||
@@ -598,7 +598,7 @@ curl --location 'http://localhost:8080/api/v1/knowledge-bases/kb-00000001/duplic
|
||||
| 场景 | HTTP | 说明 |
|
||||
| -------------------- | ---- | ---- |
|
||||
| 源知识库不存在 | 404 | `Source knowledge base not found` |
|
||||
| 源库属于其他租户 | 403 | `No permission to duplicate this knowledge base` |
|
||||
| 源库属于其他空间 | 403 | `No permission to duplicate this knowledge base` |
|
||||
| 向量存储绑定无效 | 400 | 源库绑定的 vector store 不可用 |
|
||||
|
||||
## GET `/knowledge-bases/:id/move-targets` - 获取可迁移目标知识库列表
|
||||
@@ -609,7 +609,7 @@ curl --location 'http://localhost:8080/api/v1/knowledge-bases/kb-00000001/duplic
|
||||
- 与源知识库 `embedding_model_id` 相同
|
||||
- 非临时知识库(`is_temporary = false`)
|
||||
- 不包含源知识库自身
|
||||
- 仅同租户的知识库
|
||||
- 仅同空间的知识库
|
||||
|
||||
**路径参数**:
|
||||
|
||||
|
||||
@@ -29,7 +29,7 @@
|
||||
|
||||
> **公共说明**:
|
||||
> - 路径中的 `:id`(知识库路径下)为**知识库 ID**,`/knowledge/:id` 中的 `:id` 为**知识 ID**。
|
||||
> - 所有写操作(创建、更新、删除、迁移、重新解析、取消解析)需要当前用户在知识库所属组织内具有 `editor` 或 `admin` 权限;清空知识库内容仅 KB **所有者**(admin 且租户匹配)可操作。
|
||||
> - 所有写操作(创建、更新、删除、迁移、重新解析、取消解析)需要当前用户在知识库所属组织内具有 `editor` 或 `admin` 权限;清空知识库内容仅 KB **所有者**(admin 且空间匹配)可操作。
|
||||
> - 关键状态字段:`parse_status` 取值 `pending` / `processing` / `finalizing` / `completed` / `failed` / `cancelled`;`enable_status` 取值 `enabled` / `disabled`。
|
||||
> - `processing` 指 DocReader / 分块 / 向量化阶段;`finalizing` 指主解析已完成、仍在执行摘要 / 问题生成 / 图谱抽取等索引优化任务;只有当全部子任务到达终态后才进入 `completed`。
|
||||
> - `cancelled` 表示解析被用户主动取消,可通过 `reparse` 重新触发。`pending` / `processing` / `finalizing` 这三种状态都可通过 `cancel-parse` 终止。
|
||||
@@ -325,7 +325,7 @@ curl --location 'http://localhost:8080/api/v1/knowledge-bases/kb-00000001/knowle
|
||||
|
||||
## DELETE `/knowledge-bases/:id/knowledge` - 清空知识库下的所有知识
|
||||
|
||||
异步提交"清空任务",删除该知识库下的全部知识条目;知识库本身保留。**仅 KB 所有者(admin 且租户匹配)可操作**。
|
||||
异步提交"清空任务",删除该知识库下的全部知识条目;知识库本身保留。**仅 KB 所有者(admin 且空间匹配)可操作**。
|
||||
|
||||
**请求**:
|
||||
|
||||
@@ -363,8 +363,8 @@ curl --location --request DELETE 'http://localhost:8080/api/v1/knowledge-bases/k
|
||||
| 字段 | 类型 | 必填 | 说明 |
|
||||
| ----------- | -------- | ---- | --------------------------------------------------------------------- |
|
||||
| `ids` | string[] | 是 | 知识 ID,重复 `ids=...` 传多个 |
|
||||
| `kb_id` | string | 否 | 限定知识库范围;共享知识库场景下用于按 KB 校验权限并解析有效租户 |
|
||||
| `agent_id` | string | 否 | 共享 Agent ID;按 Agent 所属租户拉取,常用于共享场景刷新后的文件回填 |
|
||||
| `kb_id` | string | 否 | 限定知识库范围;共享知识库场景下用于按 KB 校验权限并解析有效空间 |
|
||||
| `agent_id` | string | 否 | 共享 Agent ID;按 Agent 所属空间拉取,常用于共享场景刷新后的文件回填 |
|
||||
|
||||
**请求**:
|
||||
|
||||
@@ -729,7 +729,7 @@ curl --location --request PUT 'http://localhost:8080/api/v1/knowledge/tags' \
|
||||
|
||||
## GET `/knowledge/search` - 跨知识库搜索/过滤知识
|
||||
|
||||
按关键词在当前租户(含已共享给当前租户)的知识中检索;可按文件类型过滤;指定 `agent_id` 时按共享 Agent 所配置的知识库范围检索。
|
||||
按关键词在当前空间(含已共享给当前空间)的知识中检索;可按文件类型过滤;指定 `agent_id` 时按共享 Agent 所配置的知识库范围检索。
|
||||
|
||||
**查询参数**:
|
||||
|
||||
@@ -827,7 +827,7 @@ curl --location 'http://localhost:8080/api/v1/knowledge/batch-delete' \
|
||||
|
||||
将一条或多条**处于 `completed` 状态**的知识从源 KB 迁到目标 KB(异步)。约束:
|
||||
|
||||
- 源/目标 KB 必须属于当前租户;
|
||||
- 源/目标 KB 必须属于当前空间;
|
||||
- 源/目标必须为同一 KB 类型且**使用相同的 Embedding 模型**;
|
||||
- 源 KB ≠ 目标 KB;
|
||||
- 仅 `parse_status=completed` 的知识可迁移。
|
||||
|
||||
@@ -7,7 +7,7 @@ MCP(Model Context Protocol)服务管理接口,提供 MCP 服务的 CRUD、
|
||||
| 方法 | 路径 | 描述 |
|
||||
| ------ | ------------------------------------------------- | --------------------------------------------- |
|
||||
| POST | `/mcp-services` | 创建 MCP 服务 |
|
||||
| GET | `/mcp-services` | 获取当前租户的 MCP 服务列表 |
|
||||
| GET | `/mcp-services` | 获取当前空间的 MCP 服务列表 |
|
||||
| GET | `/mcp-services/:id` | 获取 MCP 服务详情 |
|
||||
| PUT | `/mcp-services/:id` | 更新 MCP 服务(部分字段更新) |
|
||||
| DELETE | `/mcp-services/:id` | 删除 MCP 服务 |
|
||||
@@ -113,7 +113,7 @@ curl --location 'http://localhost:8080/api/v1/mcp-services' \
|
||||
|
||||
## GET `/mcp-services` - 获取 MCP 服务列表
|
||||
|
||||
返回当前租户已配置的所有 MCP 服务。
|
||||
返回当前空间已配置的所有 MCP 服务。
|
||||
|
||||
**请求**:
|
||||
|
||||
@@ -497,7 +497,7 @@ curl --location --request PUT 'http://localhost:8080/api/v1/mcp-services/mcp-000
|
||||
|
||||
用于 Agent 在执行过程中阻塞等待人工审批的场景:当 Agent 命中一个 `require_approval = true` 的工具时会生成一条 `pending_id`,前端拿到这个 ID 后调用此接口将审批结果回传给 Agent,Agent 才会继续执行(或终止)。
|
||||
|
||||
**鉴权要求**:请求上下文中必须有已认证用户(`user_id`),且该用户必须是当前 pending 会话的所有者;租户与用户两层都会做 fail-close 校验。
|
||||
**鉴权要求**:请求上下文中必须有已认证用户(`user_id`),且该用户必须是当前 pending 会话的所有者;空间与用户两层都会做 fail-close 校验。
|
||||
|
||||
**路径参数**:
|
||||
|
||||
@@ -552,6 +552,6 @@ curl --location --request POST 'http://localhost:8080/api/v1/agent/tool-approval
|
||||
|
||||
| HTTP | 触发条件 |
|
||||
| ---- | --------------------------------------------------------------------------------------- |
|
||||
| 400 | `decision` 不是 `approve`/`reject`;或 `modified_args` 是 `null`/非对象;或租户/用户错配 |
|
||||
| 400 | `decision` 不是 `approve`/`reject`;或 `modified_args` 是 `null`/非对象;或空间/用户错配 |
|
||||
| 401 | 上下文缺失认证用户(中间件未注入 `user_id`) |
|
||||
| 404 | `pending_id` 不存在或已完成(超时/取消已先一步消费) |
|
||||
|
||||
+1
-1
@@ -239,7 +239,7 @@ curl --location 'http://localhost:8080/api/v1/messages/search' \
|
||||
|
||||
## GET `/messages/chat-history-stats` - 获取聊天历史知识库统计
|
||||
|
||||
获取当前租户的聊天历史知识库索引统计信息。
|
||||
获取当前空间的聊天历史知识库索引统计信息。
|
||||
|
||||
**请求**:
|
||||
|
||||
|
||||
+4
-4
@@ -2,7 +2,7 @@
|
||||
|
||||
[返回目录](./README.md)
|
||||
|
||||
模型管理接口用于维护当前租户下可用的 LLM / Embedding / Rerank / VLLM / ASR 模型配置。
|
||||
模型管理接口用于维护当前空间下可用的 LLM / Embedding / Rerank / VLLM / ASR 模型配置。
|
||||
|
||||
| 方法 | 路径 | 描述 |
|
||||
| ------ | ------------------- | --------------------- |
|
||||
@@ -46,7 +46,7 @@ WeKnora 支持多种主流 AI 模型服务商,在创建模型时可通过 `par
|
||||
|
||||
## GET `/models/providers` - 获取模型服务商列表
|
||||
|
||||
根据模型类型获取支持的服务商列表及配置信息(系统级元数据,与租户无关)。
|
||||
根据模型类型获取支持的服务商列表及配置信息(系统级元数据,与空间无关)。
|
||||
|
||||
**查询参数**:
|
||||
|
||||
@@ -100,7 +100,7 @@ curl --location 'http://localhost:8080/api/v1/models/providers?model_type=embedd
|
||||
|
||||
## POST `/models` - 创建模型
|
||||
|
||||
为当前租户创建一个新的模型配置。
|
||||
为当前空间创建一个新的模型配置。
|
||||
|
||||
**参数说明(请求体)**:
|
||||
|
||||
@@ -314,7 +314,7 @@ curl --location 'http://localhost:8080/api/v1/models' \
|
||||
|
||||
## GET `/models` - 获取模型列表
|
||||
|
||||
返回当前租户下的所有模型。内置模型(`is_builtin = true`)的 `base_url` 与 `api_key` 会被清空以隐藏敏感信息。
|
||||
返回当前空间下的所有模型。内置模型(`is_builtin = true`)的 `base_url` 与 `api_key` 会被清空以隐藏敏感信息。
|
||||
|
||||
**请求**:
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
[返回目录](./README.md)
|
||||
|
||||
组织(Organization,又称"空间")是 WeKnora 的多租户协作单元。一个用户可以创建/加入多个组织,并以 owner / admin / editor / viewer 的角色参与;知识库与智能体可以共享到组织内,组织成员根据角色获得相应的访问权限。
|
||||
组织(Organization,又称"空间")是 WeKnora 的多空间协作单元。一个用户可以创建/加入多个组织,并以 owner / admin / editor / viewer 的角色参与;知识库与智能体可以共享到组织内,组织成员根据角色获得相应的访问权限。
|
||||
|
||||
本页文档覆盖以下六类接口:
|
||||
|
||||
@@ -1183,7 +1183,7 @@ curl --location 'http://localhost:8080/api/v1/shared-knowledge-bases' \
|
||||
|
||||
### GET `/shared-agents` - 获取共享给我的智能体(跨组织)
|
||||
|
||||
返回当前用户通过所有组织共享获得的智能体列表,供"全部智能体"视图使用。`disabled_by_me: true` 表示当前租户已在对话下拉中隐藏该智能体。
|
||||
返回当前用户通过所有组织共享获得的智能体列表,供"全部智能体"视图使用。`disabled_by_me: true` 表示当前空间已在对话下拉中隐藏该智能体。
|
||||
|
||||
**请求**:
|
||||
|
||||
|
||||
+6
-6
@@ -9,7 +9,7 @@
|
||||
| POST | `/sessions` | 创建会话 |
|
||||
| DELETE | `/sessions/batch` | 批量删除会话 |
|
||||
| GET | `/sessions/:id` | 获取会话详情 |
|
||||
| GET | `/sessions` | 获取当前租户的会话列表 |
|
||||
| GET | `/sessions` | 获取当前空间的会话列表 |
|
||||
| PUT | `/sessions/:id` | 更新会话 |
|
||||
| DELETE | `/sessions/:id` | 删除会话 |
|
||||
| DELETE | `/sessions/:id/messages` | 清空会话消息 |
|
||||
@@ -61,11 +61,11 @@ curl --location 'http://localhost:8080/api/v1/sessions' \
|
||||
}
|
||||
```
|
||||
|
||||
> 通过 API-Key 调用时 `user_id` 可能为空,此时会话以租户级可见。
|
||||
> 通过 API-Key 调用时 `user_id` 可能为空,此时会话以空间级可见。
|
||||
|
||||
## DELETE `/sessions/batch` - 批量删除会话
|
||||
|
||||
支持两种模式:按 ID 列表批量删除,或删除当前租户的所有会话。
|
||||
支持两种模式:按 ID 列表批量删除,或删除当前空间的所有会话。
|
||||
|
||||
**请求 - 按 ID 列表删除**:
|
||||
|
||||
@@ -97,7 +97,7 @@ curl --location --request DELETE 'http://localhost:8080/api/v1/sessions/batch' \
|
||||
| 字段 | 类型 | 必填 | 描述 |
|
||||
| ------------ | -------- | ---- | ---------------------------------------------------------- |
|
||||
| `ids` | string[] | 否 | 要删除的会话 ID 列表(`delete_all` 为 `false` 时必填) |
|
||||
| `delete_all` | bool | 否 | 设为 `true` 时删除当前租户的所有会话,忽略 `ids` 字段 |
|
||||
| `delete_all` | bool | 否 | 设为 `true` 时删除当前空间的所有会话,忽略 `ids` 字段 |
|
||||
|
||||
**响应**:
|
||||
|
||||
@@ -148,9 +148,9 @@ curl --location 'http://localhost:8080/api/v1/sessions/ceb9babb-1e30-41d7-817d-f
|
||||
|
||||
会话不存在时返回 `404`。
|
||||
|
||||
## GET `/sessions` - 获取当前租户的会话列表
|
||||
## GET `/sessions` - 获取当前空间的会话列表
|
||||
|
||||
获取当前租户的会话列表,支持分页、关键字搜索、按来源 / Agent 过滤。
|
||||
获取当前空间的会话列表,支持分页、关键字搜索、按来源 / Agent 过滤。
|
||||
|
||||
**请求**:
|
||||
|
||||
|
||||
+60
-60
@@ -1,32 +1,32 @@
|
||||
# 租户管理 API
|
||||
# 空间管理 API
|
||||
|
||||
[返回目录](./README.md)
|
||||
|
||||
包含两组接口:
|
||||
- 租户 CRUD(`/tenants`、`/tenants/:id`):当前认证用户对自己所属租户进行管理;跨租户访问需要管理员权限。
|
||||
- 跨租户接口(`/tenants/all`、`/tenants/search`):**需要服务端启用 `EnableCrossTenantAccess` 且当前用户具备 `CanAccessAllTenants` 权限**,否则返回 403。
|
||||
- 租户 KV 配置(`/tenants/kv/:key`):当前租户级别的通用配置项,**`tenant_id` 从认证上下文中获取,不在 URL 中传入**。
|
||||
- 空间 CRUD(`/tenants`、`/tenants/:id`):当前认证用户对自己所属空间进行管理;跨空间访问需要管理员权限。
|
||||
- 跨空间接口(`/tenants/all`、`/tenants/search`):**需要服务端启用 `EnableCrossTenantAccess` 且当前用户具备 `CanAccessAllTenants` 权限**,否则返回 403。
|
||||
- 空间 KV 配置(`/tenants/kv/:key`):当前空间级别的通用配置项,**`tenant_id` 从认证上下文中获取,不在 URL 中传入**。
|
||||
|
||||
| 方法 | 路径 | 描述 |
|
||||
| ------ | -------------------------- | ------------------------------------------------- |
|
||||
| GET | `/tenants/all` | 获取所有租户列表(需跨租户权限) |
|
||||
| GET | `/tenants/search` | 分页搜索租户(需跨租户权限) |
|
||||
| POST | `/tenants` | 创建新租户 |
|
||||
| GET | `/tenants/:id` | 获取指定租户信息 |
|
||||
| PUT | `/tenants/:id` | 更新租户信息 |
|
||||
| DELETE | `/tenants/:id` | 删除租户 |
|
||||
| GET | `/tenants/:id/api-keys` | 列出租户 API Key(Owner) |
|
||||
| GET | `/tenants/all` | 获取所有空间列表(需跨空间权限) |
|
||||
| GET | `/tenants/search` | 分页搜索空间(需跨空间权限) |
|
||||
| POST | `/tenants` | 创建新空间 |
|
||||
| GET | `/tenants/:id` | 获取指定空间信息 |
|
||||
| PUT | `/tenants/:id` | 更新空间信息 |
|
||||
| DELETE | `/tenants/:id` | 删除空间 |
|
||||
| GET | `/tenants/:id/api-keys` | 列出空间 API Key(Owner) |
|
||||
| POST | `/tenants/:id/api-keys` | 创建带角色的 API Key(Owner) |
|
||||
| DELETE | `/tenants/:id/api-keys/:key_id` | 吊销指定 API Key(Owner) |
|
||||
| GET | `/tenants/:id/api-principal-config` | 获取 API Key 用户身份配置(Owner) |
|
||||
| PUT | `/tenants/:id/api-principal-config` | 更新 API Key 用户身份配置(Owner) |
|
||||
| GET | `/tenants` | 获取当前用户可见的租户列表 |
|
||||
| GET | `/tenants/kv/:key` | 获取当前租户的 KV 配置(tenant 由认证上下文确定) |
|
||||
| PUT | `/tenants/kv/:key` | 更新当前租户的 KV 配置(tenant 由认证上下文确定) |
|
||||
| GET | `/tenants` | 获取当前用户可见的空间列表 |
|
||||
| GET | `/tenants/kv/:key` | 获取当前空间的 KV 配置(空间由认证上下文确定) |
|
||||
| PUT | `/tenants/kv/:key` | 更新当前空间的 KV 配置(空间由认证上下文确定) |
|
||||
|
||||
## GET `/tenants/all` - 获取所有租户列表
|
||||
## GET `/tenants/all` - 获取所有空间列表
|
||||
|
||||
获取系统中所有租户列表,需要跨租户权限。
|
||||
获取系统中所有空间列表,需要跨空间权限。
|
||||
|
||||
**请求**:
|
||||
|
||||
@@ -45,7 +45,7 @@ curl --location 'http://localhost:8080/api/v1/tenants/all' \
|
||||
{
|
||||
"id": 10001,
|
||||
"name": "weknora-1",
|
||||
"description": "weknora tenants 1",
|
||||
"description": "weknora workspaces 1",
|
||||
"status": "active",
|
||||
"business": "wechat",
|
||||
"created_at": "2025-08-11T20:37:28.39698+08:00",
|
||||
@@ -54,7 +54,7 @@ curl --location 'http://localhost:8080/api/v1/tenants/all' \
|
||||
{
|
||||
"id": 10002,
|
||||
"name": "weknora-2",
|
||||
"description": "weknora tenants 2",
|
||||
"description": "weknora workspaces 2",
|
||||
"status": "active",
|
||||
"business": "wechat",
|
||||
"created_at": "2025-08-11T20:52:58.05679+08:00",
|
||||
@@ -66,13 +66,13 @@ curl --location 'http://localhost:8080/api/v1/tenants/all' \
|
||||
}
|
||||
```
|
||||
|
||||
## GET `/tenants/search` - 搜索租户
|
||||
## GET `/tenants/search` - 搜索空间
|
||||
|
||||
按关键词搜索租户,需要跨租户权限。
|
||||
按关键词搜索空间,需要跨空间权限。
|
||||
|
||||
**查询参数**:
|
||||
- `keyword`: 搜索关键词(可选)
|
||||
- `tenant_id`: 按租户ID筛选(可选)
|
||||
- `tenant_id`: 按空间ID筛选(可选)
|
||||
- `page`: 页码(默认 1)
|
||||
- `page_size`: 每页条数(默认 20)
|
||||
|
||||
@@ -93,7 +93,7 @@ curl --location 'http://localhost:8080/api/v1/tenants/search?keyword=weknora&pag
|
||||
{
|
||||
"id": 10002,
|
||||
"name": "weknora",
|
||||
"description": "weknora tenants",
|
||||
"description": "weknora workspaces",
|
||||
"status": "active",
|
||||
"business": "wechat",
|
||||
"created_at": "2025-08-11T20:52:58.05679+08:00",
|
||||
@@ -108,18 +108,18 @@ curl --location 'http://localhost:8080/api/v1/tenants/search?keyword=weknora&pag
|
||||
}
|
||||
```
|
||||
|
||||
## POST `/tenants` - 创建新租户
|
||||
## POST `/tenants` - 创建新空间
|
||||
|
||||
创建一个新的租户。**默认不会**自动发放 API Key;请在创建后通过 `POST /tenants/:id/api-keys` 创建密钥。从旧版本升级时,原有 `tenants.api_key` 会迁移到 `tenant_api_keys` 表并继续可用,直至被吊销。
|
||||
创建一个新的空间。**默认不会**自动发放 API Key;请在创建后通过 `POST /tenants/:id/api-keys` 创建密钥。从旧版本升级时,原有 `tenants.api_key` 会迁移到 `tenant_api_keys` 表并继续可用,直至被吊销。
|
||||
|
||||
> **兼容旧行为(可选)**:如需恢复旧版「创建租户即下发默认 API Key」的行为,可将系统设置 `tenant.auto_create_api_key` 置为 `true`(或设置环境变量 `WEKNORA_TENANT_AUTO_CREATE_API_KEY=true`)。开启后,创建租户会自动生成一个 `full_access` 权限的 API Key,并在响应体 `data.api_key` 中返回其明文 token(仅本次创建响应返回,请妥善保存)。默认 `false`。
|
||||
> **兼容旧行为(可选)**:如需恢复旧版「创建空间即下发默认 API Key」的行为,可将系统设置 `tenant.auto_create_api_key` 置为 `true`(或设置环境变量 `WEKNORA_TENANT_AUTO_CREATE_API_KEY=true`)。开启后,创建空间会自动生成一个 `full_access` 权限的 API Key,并在响应体 `data.api_key` 中返回其明文 token(仅本次创建响应返回,请妥善保存)。默认 `false`。
|
||||
|
||||
**参数说明(请求体)**:
|
||||
|
||||
| 字段 | 类型 | 必填 | 说明 |
|
||||
| ----------------- | ------ | ---- | ------------------------------------------------------ |
|
||||
| name | string | 是 | 租户名称 |
|
||||
| description | string | 否 | 租户描述 |
|
||||
| name | string | 是 | 空间名称 |
|
||||
| description | string | 否 | 空间描述 |
|
||||
| business | string | 否 | 业务标识(如 `wechat`) |
|
||||
| retriever_engines | object | 否 | 检索引擎组合配置(`engines` 数组:每项含 `retriever_type` 与 `retriever_engine_type`) |
|
||||
| storage_quota | int | 否 | 存储配额(字节) |
|
||||
@@ -131,7 +131,7 @@ curl --location 'http://localhost:8080/api/v1/tenants' \
|
||||
--header 'Content-Type: application/json' \
|
||||
--data '{
|
||||
"name": "weknora",
|
||||
"description": "weknora tenants",
|
||||
"description": "weknora workspaces",
|
||||
"business": "wechat",
|
||||
"retriever_engines": {
|
||||
"engines": [
|
||||
@@ -155,7 +155,7 @@ curl --location 'http://localhost:8080/api/v1/tenants' \
|
||||
"data": {
|
||||
"id": 10000,
|
||||
"name": "weknora",
|
||||
"description": "weknora tenants",
|
||||
"description": "weknora workspaces",
|
||||
"status": "active",
|
||||
"retriever_engines": {
|
||||
"engines": [
|
||||
@@ -187,7 +187,7 @@ curl --location 'http://localhost:8080/api/v1/tenants' \
|
||||
"data": {
|
||||
"id": 10000,
|
||||
"name": "weknora",
|
||||
"description": "weknora tenants",
|
||||
"description": "weknora workspaces",
|
||||
"api_key": "sk-aaLRAgvCRJcmtiL2vLMeB1FB5UV0Q-qB7DlTE1pJ9KA93XZG",
|
||||
"status": "active",
|
||||
"business": "wechat",
|
||||
@@ -201,15 +201,15 @@ curl --location 'http://localhost:8080/api/v1/tenants' \
|
||||
}
|
||||
```
|
||||
|
||||
## GET `/tenants/:id` - 获取指定租户信息
|
||||
## GET `/tenants/:id` - 获取指定空间信息
|
||||
|
||||
获取指定 ID 的租户详情。只能访问自己所属租户;访问其他租户需要跨租户权限,否则返回 403。
|
||||
获取指定 ID 的空间详情。只能访问自己所属空间;访问其他空间需要跨空间权限,否则返回 403。
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 字段 | 类型 | 说明 |
|
||||
| ---- | ---- | ------- |
|
||||
| id | int | 租户 ID |
|
||||
| id | int | 空间 ID |
|
||||
|
||||
**请求**:
|
||||
|
||||
@@ -226,7 +226,7 @@ curl --location 'http://localhost:8080/api/v1/tenants/10000' \
|
||||
"data": {
|
||||
"id": 10000,
|
||||
"name": "weknora",
|
||||
"description": "weknora tenants",
|
||||
"description": "weknora workspaces",
|
||||
"api_key": "sk-aaLRAgvCRJcmtiL2vLMeB1FB5UV0Q-qB7DlTE1pJ9KA93XZG",
|
||||
"status": "active",
|
||||
"retriever_engines": {
|
||||
@@ -252,15 +252,15 @@ curl --location 'http://localhost:8080/api/v1/tenants/10000' \
|
||||
}
|
||||
```
|
||||
|
||||
## PUT `/tenants/:id` - 更新租户信息
|
||||
## PUT `/tenants/:id` - 更新空间信息
|
||||
|
||||
更新指定租户的基础信息。访问规则同 `GET /tenants/:id`。
|
||||
更新指定空间的基础信息。访问规则同 `GET /tenants/:id`。
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 字段 | 类型 | 说明 |
|
||||
| ---- | ---- | ------- |
|
||||
| id | int | 租户 ID |
|
||||
| id | int | 空间 ID |
|
||||
|
||||
**参数说明(请求体)**: 与 `POST /tenants` 相同字段;未传字段保持原值。
|
||||
|
||||
@@ -272,7 +272,7 @@ curl --location --request PUT 'http://localhost:8080/api/v1/tenants/10000' \
|
||||
--header 'Content-Type: application/json' \
|
||||
--data '{
|
||||
"name": "weknora new",
|
||||
"description": "weknora tenants new",
|
||||
"description": "weknora workspaces new",
|
||||
"status": "active",
|
||||
"retriever_engines": {
|
||||
"engines": [
|
||||
@@ -298,7 +298,7 @@ curl --location --request PUT 'http://localhost:8080/api/v1/tenants/10000' \
|
||||
"data": {
|
||||
"id": 10000,
|
||||
"name": "weknora new",
|
||||
"description": "weknora tenants new",
|
||||
"description": "weknora workspaces new",
|
||||
"api_key": "sk-aaLRAgvCRJcmtiL2vLMeB1FB5UV0Q-qB7DlTE1pJ9KA93XZG",
|
||||
"status": "active",
|
||||
"retriever_engines": {
|
||||
@@ -324,15 +324,15 @@ curl --location --request PUT 'http://localhost:8080/api/v1/tenants/10000' \
|
||||
}
|
||||
```
|
||||
|
||||
## DELETE `/tenants/:id` - 删除租户
|
||||
## DELETE `/tenants/:id` - 删除空间
|
||||
|
||||
删除指定租户。访问规则同 `GET /tenants/:id`。
|
||||
删除指定空间。访问规则同 `GET /tenants/:id`。
|
||||
|
||||
**路径参数**:
|
||||
|
||||
| 字段 | 类型 | 说明 |
|
||||
| ---- | ---- | ------- |
|
||||
| id | int | 租户 ID |
|
||||
| id | int | 空间 ID |
|
||||
|
||||
**请求**:
|
||||
|
||||
@@ -346,21 +346,21 @@ curl --location --request DELETE 'http://localhost:8080/api/v1/tenants/10000' \
|
||||
|
||||
```json
|
||||
{
|
||||
"message": "Tenant deleted successfully",
|
||||
"message": "Workspace deleted successfully",
|
||||
"success": true
|
||||
}
|
||||
```
|
||||
|
||||
## 租户 API Key 管理(`tenant_api_keys`)
|
||||
## 空间 API Key 管理(`tenant_api_keys`)
|
||||
|
||||
自 scoped API Key 改造后,密钥以独立记录存储,支持:
|
||||
|
||||
- **role**:`viewer`(只读 + 语义检索 POST)、`contributor`(知识库写入)、`admin`(租户级管理,不含 `/api-keys` 管理面)
|
||||
- **role**:`viewer`(只读 + 语义检索 POST)、`contributor`(知识库写入)、`admin`(空间级管理,不含 `/api-keys` 管理面)
|
||||
- **knowledge_base_ids**:可选,将 Key 限制在指定知识库
|
||||
- **吊销**:`DELETE /tenants/:id/api-keys/:key_id`
|
||||
- **过期**:创建时可选 `expires_at_unix`
|
||||
|
||||
认证上下文中的租户角色与 Key 的 `role` 一致(`viewer` / `contributor` / `admin`)。路由级 API Key 鉴权与 KB 访问守卫在 `X-API-Key` 认证后强制执行。
|
||||
认证上下文中的空间角色与 Key 的 `role` 一致(`viewer` / `contributor` / `admin`)。路由级 API Key 鉴权与 KB 访问守卫在 `X-API-Key` 认证后强制执行。
|
||||
|
||||
## API Key Principal:隔离边界与安全说明
|
||||
|
||||
@@ -370,25 +370,25 @@ curl --location --request DELETE 'http://localhost:8080/api/v1/tenants/10000' \
|
||||
|
||||
Principal **仅**用于按终端用户隔离以下能力:
|
||||
|
||||
- **对话 Session**(创建、列表、读取按外部用户分开;`仅租户` 模式仍共用租户级 Session)
|
||||
- **MCP OAuth** 访问令牌(同一租户下不同外部用户各自授权,token 互不共用)
|
||||
- **对话 Session**(创建、列表、读取按外部用户分开;`仅空间` 模式仍共用空间级 Session)
|
||||
- **MCP OAuth** 访问令牌(同一空间下不同外部用户各自授权,token 互不共用)
|
||||
- 对话内 MCP OAuth 提示、MCP 工具审批等与终端用户绑定的流程
|
||||
|
||||
Principal **不会**缩小 API Key 的 HTTP 路由权限:路由访问由 Key 的 `role` 控制;租户内 RBAC 角色与 `role` 一致。知识库、Agent 等资源的细粒度访问另受 KB 守卫约束。
|
||||
Principal **不会**缩小 API Key 的 HTTP 路由权限:路由访问由 Key 的 `role` 控制;空间内 RBAC 角色与 `role` 一致。知识库、Agent 等资源的细粒度访问另受 KB 守卫约束。
|
||||
|
||||
### 模式与安全假设
|
||||
|
||||
| mode | 适用场景 | 安全假设 |
|
||||
| ---- | -------- | -------- |
|
||||
| `tenant` | 无 per-user MCP 需求 | 全租户共用一个 MCP OAuth 身份 |
|
||||
| `tenant` | 无 per-user MCP 需求 | 全空间共用一个 MCP OAuth 身份 |
|
||||
| `direct_header` | 仅可信服务端到服务端 | 用户 ID 来自调用方请求头,**可被持有 API Key 的任意调用方伪造**(冒充其他外部用户并共用/劫持其 MCP OAuth 授权)。面向终端用户或不可信客户端时**禁止**使用;若必须使用,请开启 `require_direct_header` 并确保 API Key 仅保存在可信后端 |
|
||||
| `signed_token` | 面向终端用户的集成(**推荐**) | 由业务后端使用 `hmac_secret` 为外部用户签发短期 HS256 JWT;无效或缺失 token 返回 401,**不回退**为租户级 Principal |
|
||||
| `signed_token` | 面向终端用户的集成(**推荐**) | 由业务后端使用 `hmac_secret` 为外部用户签发短期 HS256 JWT;无效或缺失 token 返回 401,**不回退**为空间级 Principal |
|
||||
|
||||
`direct_header` 模式下,若未携带用户 ID 请求头:`require_direct_header=false` 时回退为租户级 Principal;`require_direct_header=true` 时返回 401。
|
||||
`direct_header` 模式下,若未携带用户 ID 请求头:`require_direct_header=false` 时回退为空间级 Principal;`require_direct_header=true` 时返回 401。
|
||||
|
||||
## GET `/tenants/:id/api-principal-config` - 获取 API Key 用户身份配置
|
||||
|
||||
返回租户级 API Key 请求如何映射为终端 Principal 的配置。**需要 Owner 权限**。
|
||||
返回空间级 API Key 请求如何映射为终端 Principal 的配置。**需要 Owner 权限**。
|
||||
|
||||
**响应字段**:
|
||||
|
||||
@@ -453,9 +453,9 @@ curl --location --request PUT 'http://localhost:8080/api/v1/tenants/10000/api-pr
|
||||
}'
|
||||
```
|
||||
|
||||
## GET `/tenants` - 获取租户列表
|
||||
## GET `/tenants` - 获取空间列表
|
||||
|
||||
返回当前认证上下文对应的租户(普通用户为单条;管理员仍只返回自身租户)。
|
||||
返回当前认证上下文对应的空间(普通用户为单条;管理员仍只返回自身空间)。
|
||||
|
||||
**请求**:
|
||||
|
||||
@@ -474,7 +474,7 @@ curl --location 'http://localhost:8080/api/v1/tenants' \
|
||||
{
|
||||
"id": 10002,
|
||||
"name": "weknora",
|
||||
"description": "weknora tenants",
|
||||
"description": "weknora workspaces",
|
||||
"api_key": "sk-An7_t_izCKFIJ4iht9Xjcjnj_MC48ILvwezEDki9ScfIa7KA",
|
||||
"status": "active",
|
||||
"retriever_engines": {
|
||||
@@ -502,9 +502,9 @@ curl --location 'http://localhost:8080/api/v1/tenants' \
|
||||
}
|
||||
```
|
||||
|
||||
## GET `/tenants/kv/:key` - 获取租户 KV 配置
|
||||
## GET `/tenants/kv/:key` - 获取空间 KV 配置
|
||||
|
||||
获取当前租户的 KV 配置项。**租户 ID 从认证上下文中获取**(即由 `X-API-Key` / Bearer Token 对应的租户决定),URL 中不需要也不接受 tenant_id。
|
||||
获取当前空间的 KV 配置项。**空间 ID 从认证上下文中获取**(即由 `X-API-Key` / Bearer Token 对应的空间决定),URL 中不需要也不接受 tenant_id。
|
||||
|
||||
**路径参数**:
|
||||
|
||||
@@ -560,9 +560,9 @@ curl --location 'http://localhost:8080/api/v1/tenants/kv/agent-config' \
|
||||
{ "success": false, "error": "unsupported key" }
|
||||
```
|
||||
|
||||
## PUT `/tenants/kv/:key` - 更新租户 KV 配置
|
||||
## PUT `/tenants/kv/:key` - 更新空间 KV 配置
|
||||
|
||||
更新当前租户的 KV 配置项。**租户 ID 从认证上下文中获取**,请求体结构按 `key` 不同而异。`prompt-templates` 为只读,不支持 PUT。
|
||||
更新当前空间的 KV 配置项。**空间 ID 从认证上下文中获取**,请求体结构按 `key` 不同而异。`prompt-templates` 为只读,不支持 PUT。
|
||||
|
||||
**路径参数**:
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
[返回目录](./README.md)
|
||||
|
||||
向量存储(VectorStore)API 用于管理租户的向量数据库连接配置,支持 Elasticsearch、PostgreSQL、Qdrant、Milvus、Weaviate、Tencent VectorDB、SQLite 等引擎。接口同时管理用户在 DB 中创建的配置(`source: "user"`)以及通过 `RETRIEVE_DRIVER` 环境变量配置的虚拟存储(`source: "env"`,只读)。
|
||||
向量存储(VectorStore)API 用于管理空间的向量数据库连接配置,支持 Elasticsearch、PostgreSQL、Qdrant、Milvus、Weaviate、Tencent VectorDB、SQLite 等引擎。接口同时管理用户在 DB 中创建的配置(`source: "user"`)以及通过 `RETRIEVE_DRIVER` 环境变量配置的虚拟存储(`source: "env"`,只读)。
|
||||
|
||||
| 方法 | 路径 | 描述 |
|
||||
| ------ | ---------------------------- | -------------------------------- |
|
||||
@@ -109,13 +109,13 @@ curl --location --request POST 'http://localhost:8080/api/v1/vector-stores/test'
|
||||
|
||||
## POST `/vector-stores` - 创建向量存储
|
||||
|
||||
为当前租户创建一个新的向量存储配置。同一 endpoint + index 组合在租户内不允许重复(与环境变量配置的存储也会冲突)。
|
||||
为当前空间创建一个新的向量存储配置。同一 endpoint + index 组合在空间内不允许重复(与环境变量配置的存储也会冲突)。
|
||||
|
||||
**参数说明(请求体)**:
|
||||
|
||||
| 字段 | 类型 | 必填 | 说明 |
|
||||
| ----------------- | ------ | ---- | --------------------------------------------------------------- |
|
||||
| name | string | 是 | 存储显示名(租户内友好名) |
|
||||
| name | string | 是 | 存储显示名(空间内友好名) |
|
||||
| engine_type | string | 是 | 引擎类型,取自 `/vector-stores/types` |
|
||||
| connection_config | object | 是 | 连接配置(与所选引擎的 `connection_fields` 对应) |
|
||||
| index_config | object | 否 | 索引配置(与所选引擎的 `index_fields` 对应) |
|
||||
@@ -193,7 +193,7 @@ curl --location 'http://localhost:8080/api/v1/vector-stores' \
|
||||
|
||||
## GET `/vector-stores` - 获取向量存储列表
|
||||
|
||||
返回当前租户的所有向量存储,包含 `RETRIEVE_DRIVER` 环境变量配置的虚拟存储(`source: "env"`、`readonly: true`)和用户在 DB 中创建的存储(`source: "user"`、`readonly: false`)。环境变量存储排列在前。
|
||||
返回当前空间的所有向量存储,包含 `RETRIEVE_DRIVER` 环境变量配置的虚拟存储(`source: "env"`、`readonly: true`)和用户在 DB 中创建的存储(`source: "user"`、`readonly: false`)。环境变量存储排列在前。
|
||||
|
||||
**请求**:
|
||||
|
||||
@@ -335,7 +335,7 @@ curl --location --request PUT 'http://localhost:8080/api/v1/vector-stores/550e84
|
||||
|
||||
**Phase 2 — 绑定保护**:
|
||||
|
||||
删除请求在事务中执行,并按 `(tenant_id, vector_store_id)` 复合索引统计当前租户中仍绑定到该存储的活跃知识库数量。**只要存在任意绑定的知识库(已软删除的 KB 不计入),删除即被拒绝**,调用者必须先解绑或删除这些知识库才能继续。在 PostgreSQL 上,事务期间会对 `vector_stores` 行加 `SELECT … FOR UPDATE` 行锁,阻止并发的知识库创建请求悄悄落到正在被删除的存储上(SQLite 上则依赖 WAL + 单写入序列化达成同样语义)。
|
||||
删除请求在事务中执行,并按 `(tenant_id, vector_store_id)` 复合索引统计当前空间中仍绑定到该存储的活跃知识库数量。**只要存在任意绑定的知识库(已软删除的 KB 不计入),删除即被拒绝**,调用者必须先解绑或删除这些知识库才能继续。在 PostgreSQL 上,事务期间会对 `vector_stores` 行加 `SELECT … FOR UPDATE` 行锁,阻止并发的知识库创建请求悄悄落到正在被删除的存储上(SQLite 上则依赖 WAL + 单写入序列化达成同样语义)。
|
||||
|
||||
**路径参数**:
|
||||
|
||||
@@ -370,7 +370,7 @@ curl --location --request DELETE 'http://localhost:8080/api/v1/vector-stores/550
|
||||
}
|
||||
```
|
||||
|
||||
HTTP `400`。错误消息中包含具体的知识库数量(便于运营定位),但不包含任何 KB 的 ID/名称,以避免跨租户信息泄漏。删除被拒绝时,DB 中的存储行保持原状,进程内引擎注册表也不会被清除。
|
||||
HTTP `400`。错误消息中包含具体的知识库数量(便于运营定位),但不包含任何 KB 的 ID/名称,以避免跨空间信息泄漏。删除被拒绝时,DB 中的存储行保持原状,进程内引擎注册表也不会被清除。
|
||||
|
||||
## POST `/vector-stores/:id/test` - 测试已保存或环境变量存储的连接
|
||||
|
||||
@@ -427,9 +427,9 @@ Tencent VectorDB 环境变量存储可通过 `TENCENT_VECTORDB_REPLICA_NUMBER`
|
||||
| HTTP 状态码 | code | 含义 |
|
||||
| ----------- | ---- | --------------------------------------------------- |
|
||||
| 400 | 1000 | 请求参数错误、校验失败、尝试修改环境变量存储、删除时仍有知识库绑定 |
|
||||
| 400 | 2200 | 知识库创建时引用的 `vector_store_id` 无效(不存在或属于其他租户) |
|
||||
| 400 | 2200 | 知识库创建时引用的 `vector_store_id` 无效(不存在或属于其他空间) |
|
||||
| 400 | 2201 | 知识库创建时引用的存储当前不可用(DB 中存在但未注册到引擎) |
|
||||
| 401 | 1001 | 未认证(缺少租户上下文或 API Key) |
|
||||
| 401 | 1001 | 未认证(缺少空间上下文或 API Key) |
|
||||
| 404 | 1003 | 向量存储不存在 |
|
||||
| 409 | 1005 | 同一 endpoint + index 组合已存在 |
|
||||
| 500 | 1007 | 内部服务器错误 |
|
||||
|
||||
@@ -4,15 +4,15 @@
|
||||
|
||||
包含两组接口:
|
||||
- `/web-search/providers`:返回**可用的 provider 类型**(只读元数据)
|
||||
- `/web-search-providers/*`:当前租户**自定义保存**的 provider CRUD 与连通性测试
|
||||
- `/web-search-providers/*`:当前空间**自定义保存**的 provider CRUD 与连通性测试
|
||||
|
||||
| 方法 | 路径 | 描述 |
|
||||
| ------ | ------------------------------------- | ----------------------------------- |
|
||||
| GET | `/web-search/providers` | 获取网络搜索服务商类型列表 |
|
||||
| GET | `/web-search-providers/types` | 获取 Provider 类型元数据(含参数定义) |
|
||||
| POST | `/web-search-providers/test` | 使用原始凭证测试连通性(不落库) |
|
||||
| POST | `/web-search-providers` | 创建租户级 Provider 配置 |
|
||||
| GET | `/web-search-providers` | 获取当前租户已保存的 Provider 列表 |
|
||||
| POST | `/web-search-providers` | 创建空间级 Provider 配置 |
|
||||
| GET | `/web-search-providers` | 获取当前空间已保存的 Provider 列表 |
|
||||
| GET | `/web-search-providers/:id` | 获取指定 Provider 详情 |
|
||||
| PUT | `/web-search-providers/:id` | 更新 Provider |
|
||||
| DELETE | `/web-search-providers/:id` | 删除 Provider |
|
||||
@@ -20,7 +20,7 @@
|
||||
|
||||
## GET `/web-search/providers` - 获取网络搜索服务商类型列表
|
||||
|
||||
获取系统中可用的网络搜索服务商列表(系统级元数据,与租户无关)。
|
||||
获取系统中可用的网络搜索服务商列表(系统级元数据,与空间无关)。
|
||||
|
||||
**请求**:
|
||||
|
||||
@@ -132,11 +132,11 @@ curl --location --request POST 'http://localhost:8080/api/v1/web-search-provider
|
||||
|
||||
| 字段 | 类型 | 必填 | 说明 |
|
||||
| ----------- | ------- | ---- | ------------------------------------------ |
|
||||
| name | string | 是 | Provider 显示名(在租户内唯一友好名) |
|
||||
| name | string | 是 | Provider 显示名(在空间内唯一友好名) |
|
||||
| provider | string | 是 | Provider 类型(来自 `/web-search-providers/types`) |
|
||||
| description | string | 否 | 备注 |
|
||||
| parameters | object | 否 | 凭证与参数 |
|
||||
| is_default | boolean | 否 | 是否设为当前租户默认 Provider |
|
||||
| is_default | boolean | 否 | 是否设为当前空间默认 Provider |
|
||||
|
||||
**请求**:
|
||||
|
||||
@@ -174,7 +174,7 @@ curl --location 'http://localhost:8080/api/v1/web-search-providers' \
|
||||
|
||||
## GET `/web-search-providers` - 获取 Provider 列表
|
||||
|
||||
返回当前租户已保存的所有 Provider。
|
||||
返回当前空间已保存的所有 Provider。
|
||||
|
||||
**请求**:
|
||||
|
||||
|
||||
+153
-153
File diff suppressed because it is too large
Load Diff
+153
-153
File diff suppressed because it is too large
Load Diff
+166
-165
File diff suppressed because it is too large
Load Diff
@@ -46,7 +46,7 @@ API Key 在 Web 页面完成账户注册后,前往账户信息页面获取。
|
||||
| 分类 | 描述 | 详细文档 |
|
||||
|------|------|----------|
|
||||
| 认证管理 | 用户注册、登录、令牌管理;OIDC 流程 | [auth.md](../../api/auth.md) · [OIDC认证调用流程.md](../安全认证/OIDC认证调用流程.md) |
|
||||
| 租户管理 | 创建和管理租户账户 | [tenant.md](../../api/tenant.md) |
|
||||
| 空间管理 | 创建和管理空间账户 | [tenant.md](../../api/tenant.md) |
|
||||
| 知识库管理 | 创建、查询和管理知识库 | [knowledge-base.md](../../api/knowledge-base.md) |
|
||||
| 知识管理 | 上传、检索和管理知识内容 | [knowledge.md](../../api/knowledge.md) |
|
||||
| 模型管理 | 配置和管理各种AI模型 | [model.md](../../api/model.md) |
|
||||
|
||||
+3
-3
@@ -42,8 +42,8 @@ aliases: [Home, Index, wiki首页]
|
||||
| 页面 | 简介 |
|
||||
|------|------|
|
||||
| [OIDC认证调用流程](安全认证/OIDC认证调用流程.md) | OIDC 第三方登录的完整调用链路 |
|
||||
| [租户RBAC说明](安全认证/RBAC说明.md) | 租户内角色矩阵、资源归属与审计 |
|
||||
| [共享空间说明](安全认证/共享空间说明.md) | 跨租户协作与知识库/智能体共享 |
|
||||
| [空间RBAC说明](安全认证/RBAC说明.md) | 空间内角色矩阵、资源归属与审计 |
|
||||
| [共享空间说明](安全认证/共享空间说明.md) | 跨空间协作与知识库/智能体共享 |
|
||||
|
||||
## 开发与部署
|
||||
|
||||
@@ -95,7 +95,7 @@ graph TB
|
||||
集成扩展 --> VecDB[集成向量数据库]
|
||||
|
||||
安全认证 --> OIDC[OIDC认证调用流程]
|
||||
安全认证 --> RBAC[租户RBAC说明]
|
||||
安全认证 --> RBAC[空间RBAC说明]
|
||||
安全认证 --> SharedSpace[共享空间说明]
|
||||
|
||||
开发部署 --> DevGuide[开发指南]
|
||||
|
||||
@@ -9,7 +9,7 @@ source: OIDC认证调用流程.md
|
||||
|
||||
本文档说明 WeKnora 当前 OIDC 登录能力的实际调用过程,覆盖前后端完整链路。
|
||||
|
||||
> OIDC 认证是标准版多租户场景下的登录方式,[Lite 版](../项目概述/Lite与标准版区别.md)不需要
|
||||
> OIDC 认证是标准版多空间场景下的登录方式,[Lite 版](../项目概述/Lite与标准版区别.md)不需要
|
||||
|
||||
## 整体设计说明
|
||||
|
||||
@@ -19,10 +19,10 @@ source: OIDC认证调用流程.md
|
||||
|
||||
1. **前端只负责发起跳转**,不直接和 OIDC Provider 交换 token
|
||||
2. **后端负责用授权码 `code` 向 OIDC Provider 换取 token**
|
||||
3. 后端拿到 OIDC 用户信息后,会查找本地用户;若不存在则自动创建本地账号和默认租户
|
||||
3. 后端拿到 OIDC 用户信息后,会查找本地用户;若不存在则自动创建本地账号和默认空间
|
||||
4. 最终签发 WeKnora 自己的本地 JWT,OIDC token 只用于后端换取用户身份
|
||||
|
||||
> 自动创建用户与租户的逻辑与 [共享空间说明](../安全认证/共享空间说明.md) 的多租户模型相关
|
||||
> 自动创建用户与空间的逻辑与 [共享空间说明](../安全认证/共享空间说明.md) 的多空间模型相关
|
||||
|
||||
## 相关接口
|
||||
|
||||
@@ -72,13 +72,13 @@ Provider 回调后端 `/auth/oidc/callback`,后端用 `code` 换 token、拉
|
||||
|
||||
1. **`redirect_uri` 必须严格匹配** Provider 客户端配置
|
||||
2. **邮箱是本地账号关联主键** — 若 Provider 没返回 email,将无法完成登录
|
||||
3. **首次 OIDC 登录会自动创建用户和默认租户**
|
||||
3. **首次 OIDC 登录会自动创建用户和默认空间**
|
||||
4. **真正用于访问 API 的是本地 JWT**,不是 OIDC access token
|
||||
|
||||
## 相关主题
|
||||
|
||||
- [共享空间说明](../安全认证/共享空间说明.md) — 多租户场景下的用户与组织管理
|
||||
- [Lite与标准版区别](../项目概述/Lite与标准版区别.md) — Lite 版无需 OIDC(单租户)
|
||||
- [共享空间说明](../安全认证/共享空间说明.md) — 多空间场景下的用户与组织管理
|
||||
- [Lite与标准版区别](../项目概述/Lite与标准版区别.md) — Lite 版无需 OIDC(单空间)
|
||||
- [API文档概览](../API参考/API文档概览.md) — API 认证机制
|
||||
|
||||
---
|
||||
@@ -86,6 +86,6 @@ Provider 回调后端 `/auth/oidc/callback`,后端用 `code` 换 token、拉
|
||||
## 反向链接
|
||||
|
||||
- [Home](../Home.md) — Wiki 首页导航
|
||||
- [共享空间说明](../安全认证/共享空间说明.md) — OIDC 创建的用户与租户可用于共享空间
|
||||
- [Lite与标准版区别](../项目概述/Lite与标准版区别.md) — Lite 不需要 OIDC(单租户无需注册)
|
||||
- [共享空间说明](../安全认证/共享空间说明.md) — OIDC 创建的用户与空间可用于共享空间
|
||||
- [Lite与标准版区别](../项目概述/Lite与标准版区别.md) — Lite 不需要 OIDC(单空间无需注册)
|
||||
- [API文档概览](../API参考/API文档概览.md) — API 的认证机制与 OIDC JWT 相关
|
||||
|
||||
+21
-21
@@ -1,20 +1,20 @@
|
||||
---
|
||||
title: 租户RBAC说明
|
||||
tags: [安全认证, RBAC, 权限, 多租户, 角色]
|
||||
aliases: [RBAC, 角色权限, 租户角色, TenantRBAC]
|
||||
title: 空间RBAC说明
|
||||
tags: [安全认证, RBAC, 权限, 多空间, 角色]
|
||||
aliases: [RBAC, 角色权限, 空间角色, TenantRBAC]
|
||||
source: RBAC说明.md
|
||||
---
|
||||
|
||||
# 租户 RBAC 说明
|
||||
# 空间 RBAC 说明
|
||||
|
||||
本文档介绍 WeKnora 的**租户内权限控制(Tenant RBAC)**,包括角色矩阵、资源归属模型,以及它与 [共享空间](./共享空间说明.md) 的关系。
|
||||
本文档介绍 WeKnora 的**空间内权限控制(Workspace RBAC)**,包括角色矩阵、资源归属模型,以及它与 [共享空间](./共享空间说明.md) 的关系。
|
||||
|
||||
> 状态:已发布;由配置项 `tenant.enable_rbac` 控制,默认 `true`(强制鉴权)。
|
||||
> 完整说明、灰度方案、Schema、路由守卫等参见 [`docs/RBAC说明.md`](../../RBAC说明.md)。
|
||||
|
||||
## 解决的问题
|
||||
|
||||
RBAC 引入前,只要通过 `X-API-Key` 或 JWT 认证成功,调用方在租户内基本等同管理员。一旦一个租户出现多名真人成员,就需要区分:
|
||||
RBAC 引入前,只要通过 `X-API-Key` 或 JWT 认证成功,调用方在空间内基本等同管理员。一旦一个空间出现多名真人成员,就需要区分:
|
||||
|
||||
- 谁可以删除知识库、撤销 API Key;
|
||||
- 谁可以编辑「自己」的 KB / Agent;
|
||||
@@ -26,53 +26,53 @@ RBAC 引入前,只要通过 `X-API-Key` 或 JWT 认证成功,调用方在租
|
||||
|------|------|----------|
|
||||
| 只读 | `viewer` | 仅读 |
|
||||
| 贡献者 | `contributor` | 可变更 `creator_id == 自己` 的资源;他人资源按 Viewer |
|
||||
| 管理员 | `admin` | 可变更租户内任意资源;管理成员、共享基础设施 |
|
||||
| Owner | `owner` | Admin + 可删租户;每个租户唯一 |
|
||||
| 管理员 | `admin` | 可变更空间内任意资源;管理成员、共享基础设施 |
|
||||
| Owner | `owner` | Admin + 可删空间;每个空间唯一 |
|
||||
|
||||
层级 `viewer < contributor < admin < owner`,高角色继承低角色。
|
||||
|
||||
### 鉴权层的例外
|
||||
|
||||
- **跨租户超管**:`enable_cross_tenant_access` 打开且账号 `CanAccessAllTenants=true`,通过 `X-Tenant-ID` 切换后等同 Admin。
|
||||
- **API Key**:合成虚拟用户在所属租户内固定 Admin(删租户除外)。
|
||||
- **孤儿租户自愈**:首位认证的真人自动晋升 Owner,避免 API Key-only 租户锁死。
|
||||
- **跨空间超管**:`enable_cross_tenant_access` 打开且账号 `CanAccessAllTenants=true`,通过 `X-Tenant-ID` 切换后等同 Admin。
|
||||
- **API Key**:合成虚拟用户在所属空间内固定 Admin(删空间除外)。
|
||||
- **孤儿空间自愈**:首位认证的真人自动晋升 Owner,避免 API Key-only 空间锁死。
|
||||
|
||||
## 资源归属
|
||||
|
||||
迁移 `000043` 在关键表加上 `creator_id`:
|
||||
|
||||
- `knowledge_bases.creator_id` —— 老数据回填为该租户的 Owner;
|
||||
- `knowledge_bases.creator_id` —— 老数据回填为该空间的 Owner;
|
||||
- `custom_agents.creator_id` + `runnable_by_viewer`(默认 `true`,允许 Viewer 在对话中调用)。
|
||||
|
||||
子资源沿 `chunk → knowledge → kb → creator_id` 链回溯。
|
||||
|
||||
由此得到两类守卫:
|
||||
|
||||
- **角色守卫**:只看角色,用于租户级基础设施(模型、向量库、IM 通道等)。
|
||||
- **角色守卫**:只看角色,用于空间级基础设施(模型、向量库、IM 通道等)。
|
||||
- **归属守卫**`OwnedXxxOrAdmin`:creator 或 Admin+ 二者其一即放行,用于具体资源写操作。
|
||||
|
||||
## 与共享空间的关系
|
||||
|
||||
| 维度 | 解决什么 | 主键 |
|
||||
|------|---------|------|
|
||||
| **租户 RBAC** | 同一租户内「你能对自己/别人/共享基础设施做什么」 | `tenant_members(user_id, tenant_id, role)` |
|
||||
| **共享空间** | 跨租户「让别的租户的人也能用我的 KB / Agent」 | `organization_members` + 共享关系 |
|
||||
| **空间 RBAC** | 同一空间内「你能对自己/别人/共享基础设施做什么」 | `tenant_members(user_id, tenant_id, role)` |
|
||||
| **共享空间** | 跨空间「让别的空间的人也能用我的 KB / Agent」 | `organization_members` + 共享关系 |
|
||||
|
||||
两者**正交**:
|
||||
|
||||
- 共享空间不持有 KB / Agent,只记录「以何种权限共享到了哪个空间」;资源归属与 `creator_id` 不变;
|
||||
- 一次对**他人共享过来**的 KB 的写操作,需要同时满足:共享时设了「可写」 + 你在该空间不是 Viewer + 源租户的 RBAC 仍然放行;
|
||||
- 一次对**他人共享过来**的 KB 的写操作,需要同时满足:共享时设了「可写」 + 你在该空间不是 Viewer + 源空间的 RBAC 仍然放行;
|
||||
- API Key 跨空间访问**不会**带 Admin 光环——共享路径由 `organization_members.role` 决定,与 API Key 无关。
|
||||
|
||||
判定顺序见 `internal/middleware/kb_access.go`:
|
||||
|
||||
```text
|
||||
KB 属于我当前租户?─是─► 走租户 RBAC(角色 + creator_id)
|
||||
KB 属于我当前空间?─是─► 走空间 RBAC(角色 + creator_id)
|
||||
└─否─► KB 共享给我所在空间?─是─► 取 min(共享权限, 空间角色)
|
||||
└─否─► 403 / 404
|
||||
```
|
||||
|
||||
一句话:**租户 RBAC 是纵向的纵深防御,共享空间是横向的协作通道;跨租户写动作必须同时穿过两道闸口。**
|
||||
一句话:**空间 RBAC 是纵向的纵深防御,共享空间是横向的协作通道;跨空间写动作必须同时穿过两道闸口。**
|
||||
|
||||
## 配置
|
||||
|
||||
@@ -99,8 +99,8 @@ audit:
|
||||
|
||||
## 相关主题
|
||||
|
||||
- [共享空间说明](./共享空间说明.md) — 跨租户协作与共享,与 RBAC 正交
|
||||
- [OIDC认证调用流程](./OIDC认证调用流程.md) — 多租户用户体系的认证入口
|
||||
- [共享空间说明](./共享空间说明.md) — 跨空间协作与共享,与 RBAC 正交
|
||||
- [OIDC认证调用流程](./OIDC认证调用流程.md) — 多空间用户体系的认证入口
|
||||
- [Lite与标准版区别](../项目概述/Lite与标准版区别.md) — Lite 单用户场景下 RBAC 实际不发挥作用
|
||||
|
||||
---
|
||||
@@ -108,5 +108,5 @@ audit:
|
||||
## 反向链接
|
||||
|
||||
- [Home](../Home.md) — Wiki 首页导航
|
||||
- [共享空间说明](./共享空间说明.md) — 共享空间访问最终落到租户 RBAC 校验
|
||||
- [共享空间说明](./共享空间说明.md) — 共享空间访问最终落到空间 RBAC 校验
|
||||
- [OIDC认证调用流程](./OIDC认证调用流程.md) — JWT 解析后即进入 RBAC 角色匹配
|
||||
|
||||
+13
-13
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: 共享空间说明
|
||||
tags: [安全认证, 共享空间, 协作, 多租户, 权限]
|
||||
tags: [安全认证, 共享空间, 协作, 多空间, 权限]
|
||||
aliases: [共享空间, SharedSpace, Organization, 组织]
|
||||
source: 共享空间说明.md
|
||||
---
|
||||
@@ -13,20 +13,20 @@ source: 共享空间说明.md
|
||||
|
||||
## 共享空间概述
|
||||
|
||||
共享空间是跨租户协作的载体。用户可以在同一系统内属于不同租户(账户),通过**加入同一共享空间**,实现:
|
||||
共享空间是跨空间协作的载体。用户可以在同一系统内属于不同空间(账户),通过**加入同一共享空间**,实现:
|
||||
|
||||
- 共享知识库:将本租户的知识库共享到空间,供空间内其他成员使用
|
||||
- 共享智能体:将本租户的智能体共享到空间,供空间内其他成员在对话等场景中使用
|
||||
- 共享知识库:将本空间的知识库共享到空间,供空间内其他成员使用
|
||||
- 共享智能体:将本空间的智能体共享到空间,供空间内其他成员在对话等场景中使用
|
||||
- 访问他人共享的知识库和智能体
|
||||
|
||||
### 核心概念对照
|
||||
|
||||
| 概念 | 说明 |
|
||||
|------|------|
|
||||
| 共享空间 | 系统中的「组织」(Organization),用于跨租户共享 |
|
||||
| 共享空间 | 系统中的「组织」(Organization),用于跨空间共享 |
|
||||
| 空间创建者 | 自动成为管理员,不可被移除或降级 |
|
||||
| 空间成员 | 管理员 / 编辑者 / 只读 三种角色 |
|
||||
| 知识库/智能体归属 | 始终属于一个租户;共享不改变归属 |
|
||||
| 知识库/智能体归属 | 始终属于一个空间;共享不改变归属 |
|
||||
|
||||
## 角色与权限
|
||||
|
||||
@@ -40,7 +40,7 @@ source: 共享空间说明.md
|
||||
|
||||
## 知识库共享规则
|
||||
|
||||
- 只有知识库所属租户下的用户才能发起共享
|
||||
- 只有知识库所属空间下的用户才能发起共享
|
||||
- 发起人必须是目标空间的**管理员**或**编辑者**
|
||||
- 共享时指定权限:只读或可写
|
||||
- 同一知识库可共享到多个空间,各自独立配置权限
|
||||
@@ -54,15 +54,15 @@ source: 共享空间说明.md
|
||||
|
||||
## 智能体停用机制
|
||||
|
||||
- 停用是当前租户对**通过共享空间获得的智能体**的个人偏好设置
|
||||
- 仅影响本租户在对话中选择智能体时的展示,不改变共享关系
|
||||
- 停用是当前空间对**通过共享空间获得的智能体**的个人偏好设置
|
||||
- 仅影响本空间在对话中选择智能体时的展示,不改变共享关系
|
||||
- 不影响其他成员
|
||||
|
||||
## 相关主题
|
||||
|
||||
- [租户RBAC说明](./RBAC说明.md) — 单租户内的角色与资源归属,跨租户写操作需同时满足两边
|
||||
- [空间RBAC说明](./RBAC说明.md) — 单空间内的角色与资源归属,跨空间写操作需同时满足两边
|
||||
- [Lite与标准版区别](../项目概述/Lite与标准版区别.md) — Lite 不支持共享空间
|
||||
- [OIDC认证调用流程](../安全认证/OIDC认证调用流程.md) — 多租户场景下的用户认证
|
||||
- [OIDC认证调用流程](../安全认证/OIDC认证调用流程.md) — 多空间场景下的用户认证
|
||||
- [数据源导入开发](../集成扩展/数据源导入开发.md) — 数据源导入的知识库可被共享
|
||||
- [内置模型管理](../核心功能/内置模型管理.md) — 智能体共享前需确保模型已配置
|
||||
|
||||
@@ -71,8 +71,8 @@ source: 共享空间说明.md
|
||||
## 反向链接
|
||||
|
||||
- [Home](../Home.md) — Wiki 首页导航
|
||||
- [租户RBAC说明](./RBAC说明.md) — 共享空间访问最终落到租户 RBAC 校验
|
||||
- [空间RBAC说明](./RBAC说明.md) — 共享空间访问最终落到空间 RBAC 校验
|
||||
- [Lite与标准版区别](../项目概述/Lite与标准版区别.md) — Lite 不支持共享空间
|
||||
- [OIDC认证调用流程](../安全认证/OIDC认证调用流程.md) — 多租户用户体系支撑共享空间
|
||||
- [OIDC认证调用流程](../安全认证/OIDC认证调用流程.md) — 多空间用户体系支撑共享空间
|
||||
- [数据源导入开发](../集成扩展/数据源导入开发.md) — 导入的知识库可通过共享空间共享
|
||||
- [内置模型管理](../核心功能/内置模型管理.md) — 智能体共享前的模型配置要求
|
||||
|
||||
@@ -17,7 +17,7 @@ source: MCP功能使用说明.md
|
||||
|
||||
## 入口与界面
|
||||
|
||||
- 打开控制台左侧菜单 `设置 -> MCP 服务`,即可看到当前租户下的所有 MCP 服务列表。
|
||||
- 打开控制台左侧菜单 `设置 -> MCP 服务`,即可看到当前空间下的所有 MCP 服务列表。
|
||||
- 列表中可快速启停服务、查看描述,并通过右侧菜单执行"测试 / 编辑 / 删除"。
|
||||
- "添加服务"按钮会弹出 `McpServiceDialog`,用于创建或修改服务。
|
||||
|
||||
|
||||
@@ -9,13 +9,13 @@ source: BUILTIN_MCP_SERVICES.md
|
||||
|
||||
## 概述
|
||||
|
||||
内置 MCP 服务是系统级别的 MCP(Model Context Protocol)服务配置,对所有租户可见,但敏感信息会被隐藏,且不可编辑或删除。内置 MCP 服务通常用于提供系统默认的外部工具和资源接入,确保所有租户都能使用统一的 MCP 服务。
|
||||
内置 MCP 服务是系统级别的 MCP(Model Context Protocol)服务配置,对所有空间可见,但敏感信息会被隐藏,且不可编辑或删除。内置 MCP 服务通常用于提供系统默认的外部工具和资源接入,确保所有空间都能使用统一的 MCP 服务。
|
||||
|
||||
> 用户视角的 MCP 服务操作参见 [MCP功能使用说明](MCP功能使用说明.md)
|
||||
|
||||
## 内置 MCP 服务特性
|
||||
|
||||
- **所有租户可见**:内置 MCP 服务对所有租户都可见,无需单独配置
|
||||
- **所有空间可见**:内置 MCP 服务对所有空间都可见,无需单独配置
|
||||
- **安全保护**:内置 MCP 服务的敏感信息(URL、认证配置、Headers、环境变量)会被隐藏,无法查看详情
|
||||
- **只读保护**:内置 MCP 服务不能被编辑或删除,仅支持测试连接
|
||||
- **统一管理**:由系统管理员统一维护,确保配置一致性和安全性
|
||||
@@ -25,7 +25,7 @@ source: BUILTIN_MCP_SERVICES.md
|
||||
| 特性 | 内置模型 | 内置 MCP 服务 |
|
||||
|------|---------|--------------|
|
||||
| 标识字段 | `is_builtin` | `is_builtin` |
|
||||
| 可见范围 | 所有租户 | 所有租户 |
|
||||
| 可见范围 | 所有空间 | 所有空间 |
|
||||
| 隐藏信息 | API Key、Base URL | URL、认证配置、Headers、环境变量 |
|
||||
| 编辑保护 | 不可编辑/删除 | 不可编辑/删除 |
|
||||
| 前端标签 | 显示"内置"标签 | 显示"内置"标签 |
|
||||
@@ -45,7 +45,7 @@ source: BUILTIN_MCP_SERVICES.md
|
||||
- 服务地址(url)
|
||||
- 认证配置(auth_config)
|
||||
- 高级配置(advanced_config)
|
||||
- 租户ID(tenant_id):建议使用小于 10000 的租户ID
|
||||
- 空间ID(tenant_id):建议使用小于 10000 的空间ID
|
||||
|
||||
**支持的传输方式**:
|
||||
- `sse`:Server-Sent Events,推荐用于流式体验
|
||||
@@ -78,7 +78,7 @@ FROM mcp_services WHERE is_builtin = true ORDER BY created_at;
|
||||
## 注意事项
|
||||
|
||||
1. **ID 命名规范**:建议使用 `builtin-mcp-{序号}` 格式
|
||||
2. **租户ID**:建议使用第一个租户ID(通常是 10000)
|
||||
2. **空间ID**:建议使用第一个空间ID(通常是 10000)
|
||||
3. **JSON 格式**:`auth_config`、`advanced_config`、`headers` 必须是有效的 JSON
|
||||
4. **幂等性**:使用 `ON CONFLICT (id) DO NOTHING` 确保重复执行不会报错
|
||||
5. **安全性**:内置 MCP 服务的 URL、认证信息在前端会被自动隐藏
|
||||
|
||||
@@ -9,13 +9,13 @@ source: BUILTIN_MODELS.md
|
||||
|
||||
## 概述
|
||||
|
||||
内置模型是系统级别的模型配置,对所有租户可见,但敏感信息会被隐藏,且不可编辑或删除。内置模型通常用于提供系统默认的模型配置,确保所有租户都能使用统一的模型服务。
|
||||
内置模型是系统级别的模型配置,对所有空间可见,但敏感信息会被隐藏,且不可编辑或删除。内置模型通常用于提供系统默认的模型配置,确保所有空间都能使用统一的模型服务。
|
||||
|
||||
> 同为内置系统配置的还有 [内置MCP服务管理](内置MCP服务管理.md)
|
||||
|
||||
## 内置模型特性
|
||||
|
||||
- **所有租户可见**:无需单独配置
|
||||
- **所有空间可见**:无需单独配置
|
||||
- **安全保护**:API Key、Base URL 被隐藏
|
||||
- **只读保护**:不能被编辑或删除,只能设置为默认模型
|
||||
- **统一管理**:由系统管理员统一维护
|
||||
@@ -28,7 +28,7 @@ source: BUILTIN_MODELS.md
|
||||
- 模型类型(type):`KnowledgeQA`、`Embedding`、`Rerank` 或 `VLLM`
|
||||
- 模型来源(source):`local` 或 `remote`
|
||||
- 模型参数(parameters):包括 base_url、api_key、provider 等
|
||||
- 租户ID(tenant_id):建议使用小于10000的租户ID
|
||||
- 空间ID(tenant_id):建议使用小于10000的空间ID
|
||||
|
||||
**支持的服务商(provider)**:`generic`、`openai`、`aliyun`、`zhipu`、`volcengine`、`hunyuan`、`deepseek`、`minimax`、`mimo`、`siliconflow`、`jina`、`openrouter`、`requesty`、`gemini`、`modelscope`、`moonshot`、`qianfan`、`qiniu`、`longcat`、`gpustack`
|
||||
|
||||
@@ -63,7 +63,7 @@ FROM models WHERE is_builtin = true ORDER BY type, created_at;
|
||||
## 注意事项
|
||||
|
||||
1. **ID 命名规范**:建议使用 `builtin-{type}-{序号}` 格式
|
||||
2. **租户ID**:建议使用第一个租户ID(通常是 10000)
|
||||
2. **空间ID**:建议使用第一个空间ID(通常是 10000)
|
||||
3. **参数格式**:`parameters` 字段必须是有效的 JSON 格式
|
||||
4. **幂等性**:使用 `ON CONFLICT (id) DO NOTHING`
|
||||
5. **安全性**:API Key 和 Base URL 在前端会被自动隐藏
|
||||
|
||||
@@ -7,23 +7,23 @@ source: LITE.md
|
||||
|
||||
# Lite 与标准版区别
|
||||
|
||||
Lite 面向希望快速在本地使用、部署尽量简单的场景;标准版面向多租户协作与完整企业能力。主要差异如下。
|
||||
Lite 面向希望快速在本地使用、部署尽量简单的场景;标准版面向多空间协作与完整企业能力。主要差异如下。
|
||||
|
||||
| 维度 | Lite | 标准版 |
|
||||
|------|------|--------|
|
||||
| **共享空间** | 不提供共享空间(成员邀请、跨成员共享知识库与智能体等) | 提供共享空间及租户隔离检索等协作能力 |
|
||||
| **租户与账号** | 单租户;开箱即用,**无需注册** | 多租户;通常需要注册、登录与组织管理 |
|
||||
| **共享空间** | 不提供共享空间(成员邀请、跨成员共享知识库与智能体等) | 提供共享空间及空间隔离检索等协作能力 |
|
||||
| **空间与账号** | 单空间;开箱即用,**无需注册** | 多空间;通常需要注册、登录与组织管理 |
|
||||
| **文档解析** | 内置仅 **Simple** 类型解析引擎;可通过 **Cloud** 等方式接入其他解析能力 | 可配置多种解析引擎(含高精度等),与完整文档处理链路集成 |
|
||||
| **部署形态** | **单应用、零依赖**(不依赖独立的数据库、消息队列等外部服务栈) | 典型为 Docker Compose 等多服务部署,依赖与组件更多 |
|
||||
| **数据归属** | 数据**完全在本地**存储与处理 | 私有化部署时数据也可在本地;具体取决于你的部署方式 |
|
||||
| **网络暴露** | **默认仅本机访问**;可按需配置,**选择是否放行到公网** | 按部署与安全策略自行绑定地址与网关 |
|
||||
|
||||
> 若你不需要多团队协作、复杂解析流水线与多服务架构,Lite 更适合个人或小团队在本机零依赖试用;需要共享空间、多租户与完整解析引擎矩阵时,请使用标准版。
|
||||
> 若你不需要多团队协作、复杂解析流水线与多服务架构,Lite 更适合个人或小团队在本机零依赖试用;需要共享空间、多空间与完整解析引擎矩阵时,请使用标准版。
|
||||
|
||||
## 相关主题
|
||||
|
||||
- 共享空间的详细说明参见 [共享空间说明](../安全认证/共享空间说明.md) — 标准版独有功能
|
||||
- 认证体系参见 [OIDC认证调用流程](../安全认证/OIDC认证调用流程.md) — 标准版多租户 OIDC 登录
|
||||
- 认证体系参见 [OIDC认证调用流程](../安全认证/OIDC认证调用流程.md) — 标准版多空间 OIDC 登录
|
||||
- 开发环境搭建参见 [开发指南](../开发部署/开发指南.md)
|
||||
- 部署相关 FAQ 参见 [常见问题](../运维排障/常见问题.md)
|
||||
|
||||
@@ -34,4 +34,4 @@ Lite 面向希望快速在本地使用、部署尽量简单的场景;标准版
|
||||
- [Home](../Home.md) — Wiki 首页导航
|
||||
- [版本路线图](版本路线图.md) — 路线图中的轻量化部署方向
|
||||
- [共享空间说明](../安全认证/共享空间说明.md) — Lite 不支持的共享空间功能的详细说明
|
||||
- [OIDC认证调用流程](../安全认证/OIDC认证调用流程.md) — 标准版多租户场景下的认证方式
|
||||
- [OIDC认证调用流程](../安全认证/OIDC认证调用流程.md) — 标准版多空间场景下的认证方式
|
||||
|
||||
@@ -39,4 +39,4 @@ WEKNORA_AGENT_TOOL_APPROVAL_TIMEOUT=600
|
||||
- **审批等待状态保存在进程内存** 中:`pending_id` 仅对当前实例有效;进程重启后进行中的等待会失败(表现为拒绝/取消)。
|
||||
- **多副本部署**:当配置了 `REDIS_ADDR` 时,`Resolve` 会通过 Redis Pub/Sub(频道 `weknora:mcp_approval:resolve`)跨实例转发,因此 SSE 与提交审批的 HTTP 请求落到不同实例也能正确唤醒等待者;未配置 Redis 时退化为单机模式,需要使用会话粘滞(sticky session)。
|
||||
- **审批等待不会被工具默认 60s 超时取消**:审批阶段使用 round 级别的 ctx(不带 `defaultToolExecTimeout`),仅受 `agent.tool_approval_timeout_seconds` 与请求级取消控制。
|
||||
- 安全边界:审核通过后的参数仍由当前登录租户提交;请仅在可信环境下授予「通过」权限。
|
||||
- 安全边界:审核通过后的参数仍由当前登录空间提交;请仅在可信环境下授予「通过」权限。
|
||||
|
||||
+14
-14
@@ -2,7 +2,7 @@
|
||||
|
||||
本文档说明 WeKnora 中的**共享空间**功能,包括空间创建与加入、成员角色与权限、知识库与智能体共享规则、智能体停用机制,以及用户对知识库的最终访问权限计算方式。
|
||||
|
||||
> 共享空间解决「跨租户协作」,与单租户内的角色权限([租户 RBAC 说明](./RBAC说明.md))正交:一次跨租户的写操作必须同时穿过两道闸口。详见 RBAC 文档「与共享空间的关系」一节。
|
||||
> 共享空间解决「跨空间协作」,与单空间内的角色权限([空间 RBAC 说明](./RBAC说明.md))正交:一次跨空间的写操作必须同时穿过两道闸口。详见 RBAC 文档「与共享空间的关系」一节。
|
||||
|
||||
---
|
||||
|
||||
@@ -10,16 +10,16 @@
|
||||
|
||||
### 1.1 什么是共享空间
|
||||
|
||||
共享空间是跨租户协作的载体。用户可以在同一系统内属于不同租户(账户),通过**加入同一共享空间**,实现:
|
||||
共享空间是跨空间协作的载体。用户可以在同一系统内属于不同空间(账户),通过**加入同一共享空间**,实现:
|
||||
|
||||
- 共享知识库:将本租户的知识库共享到空间,供空间内其他成员使用;
|
||||
- 共享智能体:将本租户的智能体共享到空间,供空间内其他成员在对话等场景中使用;
|
||||
- 共享知识库:将本空间的知识库共享到空间,供空间内其他成员使用;
|
||||
- 共享智能体:将本空间的智能体共享到空间,供空间内其他成员在对话等场景中使用;
|
||||
- 访问他人共享的知识库:在「知识库列表」中看到并打开通过空间共享给自己的知识库;
|
||||
- 在对话、智能体等场景中选择并使用这些共享知识库与共享智能体。
|
||||
|
||||
数据与权限关系简要如下:
|
||||
|
||||
- **租户**:知识库、智能体的归属单位,每个知识库/智能体属于一个租户;
|
||||
- **空间**:知识库、智能体的归属单位,每个知识库/智能体属于一个空间;
|
||||
- **共享空间**:不拥有知识库或智能体,只记录「某知识库/智能体被共享到某空间」以及「共享时的权限」;
|
||||
- **成员**:用户通过邀请码或管理员邀请加入空间,在空间内拥有一个角色(管理员 / 编辑者 / 只读)。
|
||||
|
||||
@@ -27,10 +27,10 @@
|
||||
|
||||
| 概念 | 说明 |
|
||||
|------|------|
|
||||
| 共享空间 | 系统中的「组织」(Organization),用于跨租户共享知识库与智能体 |
|
||||
| 共享空间 | 系统中的「组织」(Organization),用于跨空间共享知识库与智能体 |
|
||||
| 空间创建者 | 创建该空间的用户,自动成为该空间的管理员,且不可被移除或降级 |
|
||||
| 空间成员 | 通过邀请码加入或由管理员邀请加入的用户,拥有管理员、编辑者或只读之一角色 |
|
||||
| 知识库/智能体归属 | 知识库、智能体始终属于一个租户;共享到空间不改变归属,只建立「空间 ↔ 知识库/智能体」的共享关系 |
|
||||
| 知识库/智能体归属 | 知识库、智能体始终属于一个空间;共享到空间不改变归属,只建立「空间 ↔ 知识库/智能体」的共享关系 |
|
||||
| 共享关系 | 一条记录表示:某知识库以某种权限(只读/可写)被共享到某共享空间;或某智能体以只读方式被共享到某共享空间 |
|
||||
|
||||
---
|
||||
@@ -124,7 +124,7 @@
|
||||
|
||||
### 4.1 谁可以发起共享
|
||||
|
||||
- 只有**知识库所属租户下的用户**(即「拥有」该知识库的账户下的用户)才能将该知识库共享到某个共享空间。
|
||||
- 只有**知识库所属空间下的用户**(即「拥有」该知识库的账户下的用户)才能将该知识库共享到某个共享空间。
|
||||
- 同时,该用户必须是目标共享空间的**成员**,且角色为**管理员**或**编辑者**。
|
||||
即:**只读成员不能把任何知识库(包括自己的)共享到该空间。**
|
||||
|
||||
@@ -158,7 +158,7 @@
|
||||
|
||||
### 5.1 谁可以发起智能体共享
|
||||
|
||||
- 只有**智能体所属租户下的用户**才能将该智能体共享到某个共享空间。
|
||||
- 只有**智能体所属空间下的用户**才能将该智能体共享到某个共享空间。
|
||||
- 同时,该用户必须是目标共享空间的**成员**,且角色为**管理员**或**编辑者**(与知识库共享一致)。
|
||||
- 智能体须已配置完成(如已选模型、若使用知识库则已选 rerank 模型等)方可共享。
|
||||
|
||||
@@ -177,17 +177,17 @@
|
||||
|
||||
## 六、智能体停用机制
|
||||
|
||||
「停用」是当前租户对**通过共享空间获得的智能体**的一种个人偏好设置,仅影响本租户在**对话中选择智能体**时的展示与使用体验,不改变共享关系,也不影响其他成员。
|
||||
「停用」是当前空间对**通过共享空间获得的智能体**的一种个人偏好设置,仅影响本空间在**对话中选择智能体**时的展示与使用体验,不改变共享关系,也不影响其他成员。
|
||||
|
||||
### 6.1 停用的含义
|
||||
|
||||
- 当某租户将某个「通过共享空间获得的智能体」标记为**已停用**时:
|
||||
- 在该租户的对话界面中,该智能体可在下拉列表中被隐藏或标记为已停用,减少干扰;
|
||||
- 当某空间将某个「通过共享空间获得的智能体」标记为**已停用**时:
|
||||
- 在该空间的对话界面中,该智能体可在下拉列表中被隐藏或标记为已停用,减少干扰;
|
||||
- 该智能体仍对该共享空间的其他成员可见、可用;
|
||||
- 共享关系不变,发起共享的用户与空间管理员仍可照常管理该条共享。
|
||||
- 停用状态按「租户 + 智能体(含来源租户)」记录,即:同一智能体被多个空间共享时,用户停用后在所有入口对该智能体的展示偏好一致。
|
||||
- 停用状态按「空间 + 智能体(含来源空间)」记录,即:同一智能体被多个空间共享时,用户停用后在所有入口对该智能体的展示偏好一致。
|
||||
|
||||
### 6.2 停用与恢复
|
||||
|
||||
- 用户可随时将已停用的共享智能体**恢复**,恢复后该智能体重新在对话下拉等列表中正常显示。
|
||||
- 停用/恢复仅影响当前租户自己的视图与选择列表,不影响他人,也不影响该用户通过直接链接等方式访问该智能体。
|
||||
- 停用/恢复仅影响当前空间自己的视图与选择列表,不影响他人,也不影响该用户通过直接链接等方式访问该智能体。
|
||||
|
||||
+1
-1
@@ -442,7 +442,7 @@ type Resource struct {
|
||||
│ 1. 解析任务体 (DataSourceSyncPayload) │
|
||||
│ 2. 加载数据源配置 │
|
||||
│ 3. 解密凭证 → 获取 Connector │
|
||||
│ 4. 设置租户上下文 │
|
||||
│ 4. 设置空间上下文 │
|
||||
│ 5. 创建/获取自动标签 (连接器名·数据源名) │
|
||||
│ 6. 判断同步模式: │
|
||||
│ ├─ ForceFull 或 SyncModeFull → FetchAll │
|
||||
|
||||
@@ -194,7 +194,7 @@ watch(
|
||||
{ immediate: true },
|
||||
)
|
||||
|
||||
// 切换租户后会 hard reload;切换前 stash 的 toast 这里 consume 并弹出,
|
||||
// 切换空间后会 hard reload;切换前 stash 的 toast 这里 consume 并弹出,
|
||||
// 这样 toast 显示在新页面上,duration 才真正生效。
|
||||
const showPendingTenantSwitchToast = () => {
|
||||
const pending = consumePendingTenantSwitchToast()
|
||||
|
||||
@@ -163,7 +163,7 @@ export const BUILTIN_AGENT_NORMAL_ID = BUILTIN_QUICK_ANSWER_ID;
|
||||
export const BUILTIN_AGENT_AGENT_ID = BUILTIN_SMART_REASONING_ID;
|
||||
|
||||
// 获取智能体列表(包括内置智能体)
|
||||
// disabled_own_agent_ids: 当前租户在对话下拉中停用的「我的」智能体 ID,仅影响本租户
|
||||
// disabled_own_agent_ids: 当前空间在对话下拉中停用的「我的」智能体 ID,仅影响本空间
|
||||
export function listAgents(params?: {
|
||||
/**
|
||||
* Optional creator filter; mirrors listKnowledgeBases. Built-in agents
|
||||
|
||||
@@ -157,7 +157,7 @@ export function userInfoFromApi(
|
||||
}
|
||||
}
|
||||
|
||||
// 租户信息接口
|
||||
// 空间信息接口
|
||||
export interface TenantInfo {
|
||||
id: string
|
||||
name: string
|
||||
@@ -288,7 +288,7 @@ export async function register(data: RegisterRequest): Promise<RegisterResponse>
|
||||
}
|
||||
|
||||
/**
|
||||
* Lite 版自动初始化(创建默认用户/租户 + 签发令牌)
|
||||
* Lite 版自动初始化(创建默认用户/空间 + 签发令牌)
|
||||
*/
|
||||
export async function autoSetup(): Promise<LoginResponse> {
|
||||
try {
|
||||
@@ -353,7 +353,7 @@ export async function updateMyPreferences(
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取当前租户信息
|
||||
* 获取当前空间信息
|
||||
*/
|
||||
export async function getCurrentTenant(): Promise<{ success: boolean; data?: TenantInfo; message?: string }> {
|
||||
try {
|
||||
|
||||
@@ -55,13 +55,13 @@ export function useStream() {
|
||||
return;
|
||||
}
|
||||
|
||||
// 跨租户访问请求头:只要 setSelectedTenant 写过激活租户,就附
|
||||
// 跨空间访问请求头:只要 setSelectedTenant 写过激活空间,就附
|
||||
// X-Tenant-ID。早期版本会 short-circuit "selectedTenantId ===
|
||||
// defaultTenantId 时不附" 来减少 header 体积,但任何把 weknora_tenant
|
||||
// 写成激活租户的代码(OIDC 同步 / UserMenu loadUserInfo / router
|
||||
// 写成激活空间的代码(OIDC 同步 / UserMenu loadUserInfo / router
|
||||
// hydrate)都会让两者相等,使得后续流式请求悄悄丢 header、落到
|
||||
// home 租户上,导致 SSE 接口返回 404。直接附即可——后端
|
||||
// IsTenantAccessible 也允许 header 指向自家租户。
|
||||
// home 空间上,导致 SSE 接口返回 404。直接附即可——后端
|
||||
// IsTenantAccessible 也允许 header 指向自家空间。
|
||||
const selectedTenantId = localStorage.getItem('weknora_selected_tenant_id');
|
||||
const tenantIdHeader: string | null = selectedTenantId || null;
|
||||
|
||||
|
||||
@@ -464,7 +464,7 @@ export function testMultimodalFunction(testData: {
|
||||
headers['Authorization'] = `Bearer ${token}`;
|
||||
}
|
||||
|
||||
// 跨租户访问请求头:直接附,避免 short-circuit "selectedTenantId
|
||||
// 跨空间访问请求头:直接附,避免 short-circuit "selectedTenantId
|
||||
// === defaultTenantId 时不附" 在某些边角下让 header 静默丢失。
|
||||
// 与 utils/request.ts、api/chat/streame.ts 行为一致。
|
||||
const selectedTenantId = localStorage.getItem('weknora_selected_tenant_id');
|
||||
|
||||
@@ -71,7 +71,7 @@ export interface ParserEngineInfo {
|
||||
UnavailableReason?: string
|
||||
}
|
||||
|
||||
/** 解析引擎配置(引擎相关存租户;docreader 地址由环境变量配置) */
|
||||
/** 解析引擎配置(引擎相关存空间;docreader 地址由环境变量配置) */
|
||||
export interface ParserEngineConfig {
|
||||
docreader_addr?: string
|
||||
docreader_transport?: string
|
||||
@@ -130,7 +130,7 @@ export function reconnectDocReader(addr: string): Promise<ParserEnginesResponse
|
||||
return post('/api/v1/system/docreader/reconnect', { addr })
|
||||
}
|
||||
|
||||
// ---- 存储引擎配置(租户级,供文档/图片存储与 docreader 使用) ----
|
||||
// ---- 存储引擎配置(空间级,供文档/图片存储与 docreader 使用) ----
|
||||
|
||||
export interface StorageEngineConfig {
|
||||
default_provider: string // "local" | "minio" | "cos" | "tos" | "s3" | "oss" | "ks3" | "obs"
|
||||
|
||||
@@ -3,7 +3,7 @@ import i18n from '@/i18n'
|
||||
|
||||
const t = (key: string) => i18n.global.t(key)
|
||||
|
||||
// 租户信息接口
|
||||
// 空间信息接口
|
||||
export interface TenantInfo {
|
||||
id: number
|
||||
name: string
|
||||
@@ -109,7 +109,7 @@ export interface CreateTenantAPIKeyPayload {
|
||||
expires_at_unix?: number
|
||||
}
|
||||
|
||||
// 搜索租户参数
|
||||
// 搜索空间参数
|
||||
export interface SearchTenantsParams {
|
||||
keyword?: string
|
||||
tenant_id?: number
|
||||
@@ -117,7 +117,7 @@ export interface SearchTenantsParams {
|
||||
page_size?: number
|
||||
}
|
||||
|
||||
// 搜索租户响应
|
||||
// 搜索空间响应
|
||||
export interface SearchTenantsResponse {
|
||||
success: boolean
|
||||
data?: {
|
||||
@@ -130,7 +130,7 @@ export interface SearchTenantsResponse {
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取所有租户列表(需要跨租户访问权限)
|
||||
* 获取所有空间列表(需要跨空间访问权限)
|
||||
* @deprecated 建议使用 searchTenants 代替,支持分页和搜索
|
||||
*/
|
||||
export async function listAllTenants(): Promise<{ success: boolean; data?: { items: TenantInfo[] }; message?: string }> {
|
||||
@@ -234,7 +234,7 @@ export async function deleteTenantAPIKey(
|
||||
}
|
||||
|
||||
/**
|
||||
* 更新租户信息(目前暴露名称、描述两个字段的编辑入口)。
|
||||
* 更新空间信息(目前暴露名称、描述两个字段的编辑入口)。
|
||||
* 后端 `PUT /tenants/:id` 用指针字段区分"未传"和"显式空串",未传的列不会
|
||||
* 被改动;这里也按需选择性传 `name` / `description`,互不影响。
|
||||
* 权限:owner(与 router.go 中的 g.Owner() 守卫保持一致)。
|
||||
@@ -273,7 +273,7 @@ export async function deleteTenant(
|
||||
|
||||
/**
|
||||
* 创建新工作区(任意已登录用户均可调用)。
|
||||
* 后端会自动把调用者写成新租户的 Owner,并填充默认 storage_quota
|
||||
* 后端会自动把调用者写成新空间的 Owner,并填充默认 storage_quota
|
||||
* 等服务端字段;API Key 由用户在集成页手动创建。
|
||||
* 路由:POST /api/v1/tenants(router 上不挂 g.CrossTenant(),自助场景使用)。
|
||||
*/
|
||||
@@ -295,7 +295,7 @@ export async function createTenant(
|
||||
}
|
||||
|
||||
/**
|
||||
* 搜索租户(支持分页、关键词搜索和租户ID过滤)
|
||||
* 搜索空间(支持分页、关键词搜索和空间ID过滤)
|
||||
*/
|
||||
export async function searchTenants(params: SearchTenantsParams = {}): Promise<SearchTenantsResponse> {
|
||||
try {
|
||||
|
||||
@@ -65,7 +65,7 @@ export interface SimpleResponse {
|
||||
}
|
||||
|
||||
/**
|
||||
* 分页列出租户成员。
|
||||
* 分页列出空间成员。
|
||||
* Backend: GET /api/v1/tenants/:id/members (Viewer+)。查询参数:`q`、`page`、`page_size`。
|
||||
*/
|
||||
export async function listMembers(
|
||||
@@ -79,7 +79,7 @@ export async function listMembers(
|
||||
}
|
||||
|
||||
/**
|
||||
* 遍历分页拉取租户的全部成员(每页最大 100,最多 500 页兜底)。
|
||||
* 遍历分页拉取空间的全部成员(每页最大 100,最多 500 页兜底)。
|
||||
* 用于「退出空间」等对全量成员的轻量校验;普通表格请直接使用 {@link listMembers} 分页接口。
|
||||
*/
|
||||
export async function fetchAllTenantMembers(tenantId: number): Promise<TenantMember[]> {
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
<template>
|
||||
<!-- 自助创建新工作区弹窗。任意已登录用户均可调用 POST /api/v1/tenants
|
||||
(后端 router 已去掉 g.CrossTenant() 守卫),handler 会自动把当前
|
||||
用户 EnsureOwner 成新租户的 Owner。 -->
|
||||
用户 EnsureOwner 成新空间的 Owner。 -->
|
||||
<t-dialog :visible="visible" width="480px" :on-confirm="handleSubmit" :on-close="handleClose"
|
||||
:confirm-btn="{ content: $t('tenant.create.submit'), loading: submitting, theme: 'primary' }"
|
||||
:cancel-btn="{ content: $t('tenant.create.cancel') }" :close-on-overlay-click="!submitting"
|
||||
@@ -40,7 +40,7 @@ const props = defineProps<{
|
||||
|
||||
const emit = defineEmits<{
|
||||
(e: 'update:visible', value: boolean): void
|
||||
// 创建成功后由父组件决定如何导航(切换到新租户、刷新本地列表等)。
|
||||
// 创建成功后由父组件决定如何导航(切换到新空间、刷新本地列表等)。
|
||||
(e: 'created', tenant: TenantInfo): void
|
||||
}>()
|
||||
|
||||
|
||||
@@ -183,7 +183,7 @@ const isCustomAgent = computed(() => {
|
||||
// 判断是否有智能体配置(包括内置智能体)
|
||||
const hasAgentConfig = computed(() => {
|
||||
const agent = selectedAgent.value;
|
||||
// 共享智能体的 config 来自源租户,直接使用 agent.config,避免被本租户同 ID 的 builtin 覆盖
|
||||
// 共享智能体的 config 来自源空间,直接使用 agent.config,避免被本空间同 ID 的 builtin 覆盖
|
||||
const sourceTenantId = settingsStore.selectedAgentSourceTenantId;
|
||||
if (agent?.is_builtin && !sourceTenantId) {
|
||||
const builtinAgent = agents.value.find(a => a.id === agent.id);
|
||||
@@ -508,7 +508,7 @@ const selectedTags = computed(() => settingsStore.settings.selectedTags || []);
|
||||
const selectedMCPServiceIds = computed(() => settingsStore.settings.selectedMCPServices || []);
|
||||
const selectedSkillNames = computed(() => settingsStore.settings.selectedSkills || []);
|
||||
|
||||
// 已就绪的知识库(来自租户级缓存)
|
||||
// 已就绪的知识库(来自空间级缓存)
|
||||
const knowledgeBases = computed(() => chatResources.validKnowledgeBases);
|
||||
const fileList = ref<Array<{ id: string; name: string }>>([]);
|
||||
|
||||
@@ -832,9 +832,9 @@ const loadAgents = async (force = false) => {
|
||||
}
|
||||
};
|
||||
|
||||
// 默认选中的 builtin(builtin-quick-answer)也可能被当前租户管理员停用。
|
||||
// 列表加载完后做一次纠偏:若当前选中的是本租户停用的 agent(仅限「我的/builtin」,
|
||||
// 共享智能体由源租户决定,本地停用列表不适用),按 智能推理 → 快速问答 →
|
||||
// 默认选中的 builtin(builtin-quick-answer)也可能被当前空间管理员停用。
|
||||
// 列表加载完后做一次纠偏:若当前选中的是本空间停用的 agent(仅限「我的/builtin」,
|
||||
// 共享智能体由源空间决定,本地停用列表不适用),按 智能推理 → 快速问答 →
|
||||
// 第一个可用 的顺序兜底切换。全部都被停用时保持原选择不动(极端场景,UI 仍会
|
||||
// 在 enabledAgents 过滤后显示空,由用户在智能体页恢复任意一个)。
|
||||
const ensureSelectedAgentNotDisabled = () => {
|
||||
@@ -863,7 +863,7 @@ const ensureSelectedAgentNotDisabled = () => {
|
||||
}
|
||||
}
|
||||
|
||||
// 对话下拉中展示的「我的」智能体(排除当前租户已停用的)
|
||||
// 对话下拉中展示的「我的」智能体(排除当前空间已停用的)
|
||||
const enabledAgents = computed(() =>
|
||||
agents.value.filter(a => !disabledOwnAgentIds.value.includes(a.id))
|
||||
);
|
||||
@@ -948,7 +948,7 @@ const ensureModelSelection = () => {
|
||||
|
||||
// 智能体身份或其数据到位时,把对话模型同步到智能体配置的 model_id。
|
||||
// 修复场景:导航离开再返回时,initChatModelSelection 会用 localStorage 的 lastPick
|
||||
// 覆盖共享智能体绑定的源租户 model_id,UI 显示「未配置」——此时需要拉回 agent 模型。
|
||||
// 覆盖共享智能体绑定的源空间 model_id,UI 显示「未配置」——此时需要拉回 agent 模型。
|
||||
// 但若用户在本页手动改过模型(lastPick 与 agent 默认不同且当前选中即为 lastPick),
|
||||
// 则保留用户选择,避免 creatChat → chat 跳转后把模型 B 冲回智能体默认 A。
|
||||
watch(
|
||||
@@ -1021,7 +1021,7 @@ const selectedModel = computed(() => {
|
||||
return availableModels.value.find(model => model.id === selectedModelId.value);
|
||||
});
|
||||
|
||||
// 模型展示名:本租户列表中有则用名称;若为共享智能体且其 model_id 不在本租户列表中则显示“共享智能体配置的模型”
|
||||
// 模型展示名:本空间列表中有则用名称;若为共享智能体且其 model_id 不在本空间列表中则显示“共享智能体配置的模型”
|
||||
const selectedModelDisplayName = computed(() => {
|
||||
if (selectedModel.value) return modelDisplayName(selectedModel.value);
|
||||
if (!selectedModelId.value) return t('input.notConfigured');
|
||||
@@ -1154,7 +1154,7 @@ const loadMentionItems = async (q: string, resetIndex = true, append = false) =>
|
||||
mentionOffset.value = 0;
|
||||
}
|
||||
|
||||
// 根据智能体的 kb_selection_mode 过滤知识库;选中共享智能体时使用该租户下的知识库,否则使用本租户 + 共享给自己的
|
||||
// 根据智能体的 kb_selection_mode 过滤知识库;选中共享智能体时使用该空间下的知识库,否则使用本空间 + 共享给自己的
|
||||
let kbItems: any[] = [];
|
||||
let tagItems: MentionItem[] = [];
|
||||
let mcpItems: MentionItem[] = [];
|
||||
@@ -1164,7 +1164,7 @@ const loadMentionItems = async (q: string, resetIndex = true, append = false) =>
|
||||
const sourceTenantId = settingsStore.selectedAgentSourceTenantId;
|
||||
const agentId = selectedAgentId.value;
|
||||
if (sourceTenantId && agentId) {
|
||||
// 共享智能体:按 agent_id 拉取该智能体配置的知识库范围(后端从共享关系解析租户)
|
||||
// 共享智能体:按 agent_id 拉取该智能体配置的知识库范围(后端从共享关系解析空间)
|
||||
try {
|
||||
const list = await chatResources.ensureAgentKnowledgeBases(agentId);
|
||||
const orgLabel = sharedAgentOrgName.value || '';
|
||||
|
||||
@@ -102,8 +102,8 @@ const loading = ref(false)
|
||||
const searchTimer = ref<number | null>(null)
|
||||
|
||||
const selectedTenantId = computed(() => authStore.selectedTenantId)
|
||||
// home 租户 id 来自 user.tenant_id(注册时分配、永不变)。不要读
|
||||
// authStore.tenant.id —— 那是当前激活租户,会随 X-Tenant-ID 切换;用它
|
||||
// home 空间 id 来自 user.tenant_id(注册时分配、永不变)。不要读
|
||||
// authStore.tenant.id —— 那是当前激活空间,会随 X-Tenant-ID 切换;用它
|
||||
// 当 home 会让「切回 home」分支错判,详见 useHomeTenant() 注释。
|
||||
const defaultTenantId = computed(() =>
|
||||
authStore.user?.tenant_id ? Number(authStore.user.tenant_id) : null,
|
||||
@@ -115,14 +115,14 @@ const currentTenantId = computed(() => {
|
||||
|
||||
const currentTenantName = computed(() => {
|
||||
if (!currentTenantId.value) return t('tenant.unknown')
|
||||
// 首先从当前加载的租户列表中查找
|
||||
// 首先从当前加载的空间列表中查找
|
||||
const tenant = tenants.value.find(t => t.id === currentTenantId.value)
|
||||
if (tenant) return tenant.name
|
||||
// 如果是选中的租户,使用保存的租户名称
|
||||
// 如果是选中的空间,使用保存的空间名称
|
||||
if (selectedTenantId.value && authStore.selectedTenantName) {
|
||||
return authStore.selectedTenantName
|
||||
}
|
||||
// 最后使用默认租户名称
|
||||
// 最后使用默认空间名称
|
||||
return authStore.tenant?.name || t('tenant.unknown')
|
||||
})
|
||||
|
||||
@@ -165,7 +165,7 @@ const clearSearch = () => {
|
||||
}
|
||||
|
||||
const selectTenant = (tenantId: number) => {
|
||||
// 找到选中的租户信息
|
||||
// 找到选中的空间信息
|
||||
const selectedTenant = tenants.value.find(t => t.id === tenantId)
|
||||
|
||||
// 始终写入 override,让 request.ts 永远附 X-Tenant-ID 覆盖 JWT;不要因为
|
||||
@@ -174,7 +174,7 @@ const selectTenant = (tenantId: number) => {
|
||||
const switchingToHome = tenantId === defaultTenantId.value
|
||||
// 切到 home 时,selectedTenant 可能因为分页 / 搜索没把 home 加载进列表,
|
||||
// 退而求其次从 memberships 上挑名字。注意不要回退到 authStore.tenant?.name
|
||||
// —— 那是当前激活租户的名字,在 active != home 的会话里就是 peer 的名字。
|
||||
// —— 那是当前激活空间的名字,在 active != home 的会话里就是 peer 的名字。
|
||||
const homeNameFallback = switchingToHome
|
||||
? (authStore.memberships ?? []).find((m) => Number(m.tenant_id) === tenantId)?.tenant_name
|
||||
|| null
|
||||
@@ -198,7 +198,7 @@ const selectTenant = (tenantId: number) => {
|
||||
// Persist "last active tenant" preference (switching to home clears
|
||||
// it). Fire-and-forget, but race it against the existing 500ms grace
|
||||
// window so most writes finish before the hard reload tears the page
|
||||
// down. 切换租户后跳转到新租户下安全的入口(详见 tenantSwitch.ts 注释)。
|
||||
// down. 切换空间后跳转到新空间下安全的入口(详见 tenantSwitch.ts 注释)。
|
||||
const persist = persistLastActiveTenantPreference(switchingToHome ? null : tenantId)
|
||||
Promise.race([persist, new Promise((r) => setTimeout(r, 500))])
|
||||
.finally(() => navigateAfterTenantSwitch())
|
||||
@@ -213,7 +213,7 @@ const loadTenants = async (append = false) => {
|
||||
let tenantID: number | undefined = undefined
|
||||
|
||||
// 如果是纯数字,同时作为 tenant_id 和 keyword 搜索
|
||||
// 这样既能精确匹配租户ID,也能模糊匹配名称中包含数字的租户
|
||||
// 这样既能精确匹配空间ID,也能模糊匹配名称中包含数字的空间
|
||||
if (keyword && /^\d+$/.test(keyword)) {
|
||||
tenantID = Number(keyword)
|
||||
}
|
||||
@@ -283,7 +283,7 @@ const openCreateDialog = () => {
|
||||
}
|
||||
|
||||
const onTenantCreated = async (newTenant: TenantInfo) => {
|
||||
// 把新租户合并进当前列表并切过去。和 selectTenant 走同一条链路:
|
||||
// 把新空间合并进当前列表并切过去。和 selectTenant 走同一条链路:
|
||||
// setSelectedTenant + navigateAfterTenantSwitch。后端 X-Tenant-ID 中
|
||||
// 间件会查 tenant_members 校验,EnsureOwner 已经在后端写好 owner 行。
|
||||
tenants.value = [newTenant, ...tenants.value.filter(t => t.id !== newTenant.id)]
|
||||
@@ -299,7 +299,7 @@ const onTenantCreated = async (newTenant: TenantInfo) => {
|
||||
}
|
||||
|
||||
onMounted(() => {
|
||||
// 预加载租户列表
|
||||
// 预加载空间列表
|
||||
loadTenants()
|
||||
})
|
||||
|
||||
|
||||
@@ -8,7 +8,7 @@
|
||||
</div>
|
||||
<template v-if="!uiStore.sidebarCollapsed">
|
||||
<div class="user-info">
|
||||
<!-- 多租户 / superuser:首行租户名,次行 username · 角色。单租户:昵称 + 邮箱。 -->
|
||||
<!-- 多空间 / superuser:首行空间名,次行 username · 角色。单空间:昵称 + 邮箱。 -->
|
||||
<template v-if="showTenantIdentityLine">
|
||||
<div class="user-tenant-name" :title="activeTenantName">{{ activeTenantName }}</div>
|
||||
<div class="user-tenant-meta">
|
||||
@@ -31,7 +31,7 @@
|
||||
<!-- 下拉菜单 -->
|
||||
<Transition name="dropdown">
|
||||
<div v-if="menuVisible" class="user-dropdown" @click.stop>
|
||||
<!-- 弹出菜单:账号(头像+昵称)/当前租户(名称+权限);底部侧栏样式不改。 -->
|
||||
<!-- 弹出菜单:账号(头像+昵称)/当前空间(名称+权限);底部侧栏样式不改。 -->
|
||||
<div v-if="userName" class="dropdown-user-header">
|
||||
<div class="dropdown-user-avatar">
|
||||
<img v-if="userAvatar" :src="userAvatar" :alt="$t('common.avatar')" />
|
||||
@@ -118,7 +118,7 @@
|
||||
<t-icon name="server" class="menu-icon" />
|
||||
<span>{{ $t('settings.system') }}</span>
|
||||
</div>
|
||||
<!-- 切换租户入口在下拉「当前租户」区块 hover;此处仅为分隔线与菜单项。 -->
|
||||
<!-- 切换空间入口在下拉「当前空间」区块 hover;此处仅为分隔线与菜单项。 -->
|
||||
<div class="menu-divider"></div>
|
||||
<div class="menu-item" :title="$t('common.githubStarTip')" @click="openGithub">
|
||||
<t-icon name="logo-github" class="menu-icon" />
|
||||
@@ -225,9 +225,9 @@ const authStore = useAuthStore()
|
||||
const { formatRole, roleIcon } = useRoleLabel()
|
||||
const { homeTenantId, isHomeTenantActive, isHomeTenant } = useHomeTenant()
|
||||
|
||||
// 顶部用户卡片展示的租户名 / 当前角色:跟着 tenant 切换器实时变。
|
||||
// 顶部用户卡片展示的空间名 / 当前角色:跟着 tenant 切换器实时变。
|
||||
// activeTenantName 优先用切换器选中的名字(含 fallback 到 home tenant 名字),
|
||||
// 单租户用户也能正常显示自己的 home tenant 名。
|
||||
// 单空间用户也能正常显示自己的 home tenant 名。
|
||||
const activeTenantName = computed(() => {
|
||||
return (
|
||||
authStore.selectedTenantName ||
|
||||
@@ -238,8 +238,8 @@ const activeTenantName = computed(() => {
|
||||
const currentRoleLabel = computed(() => formatRole(authStore.currentTenantRole))
|
||||
const currentRoleIcon = computed(() => roleIcon(authStore.currentTenantRole))
|
||||
|
||||
// 单租户用户(memberships <= 1 且非 superuser)= 永远 home + owner,第三
|
||||
// 行就是 user-email 信息的重复,没必要占视觉空间;只对多租户 / superuser
|
||||
// 单空间用户(memberships <= 1 且非 superuser)= 永远 home + owner,第三
|
||||
// 行就是 user-email 信息的重复,没必要占视觉空间;只对多空间 / superuser
|
||||
// 渲染。Lite 模式下没有 RBAC 概念,统一隐藏。
|
||||
const showTenantIdentityLine = computed(() => {
|
||||
if (authStore.isLiteMode) return false
|
||||
@@ -333,10 +333,10 @@ const closeAll = () => {
|
||||
}
|
||||
|
||||
// ---------- Create new tenant ----------
|
||||
// 普通用户在租户子菜单底部点 "+ 创建新工作区" → 弹 CreateTenantDialog →
|
||||
// 后端写一行 owner 的 tenant_members → 直接切到新租户。复用 switchToTenant
|
||||
// 普通用户在空间子菜单底部点 "+ 创建新工作区" → 弹 CreateTenantDialog →
|
||||
// 后端写一行 owner 的 tenant_members → 直接切到新空间。复用 switchToTenant
|
||||
// 同款的 setSelectedTenant + navigateAfterTenantSwitch 链路,避免 token
|
||||
// 依然指向旧租户带来的 SSE / store 不一致。
|
||||
// 依然指向旧空间带来的 SSE / store 不一致。
|
||||
const createTenantDialogVisible = ref(false)
|
||||
|
||||
const openCreateTenantDialog = () => {
|
||||
@@ -406,9 +406,9 @@ const switchToTenant = (m: Membership) => {
|
||||
closeAll()
|
||||
return
|
||||
}
|
||||
// 始终把激活租户写进 selectedTenantId,让 request.ts 永远附 X-Tenant-ID。
|
||||
// 历史实现里「切回 home 就清 override」会让请求落回 JWT 编码的租户,
|
||||
// 而 JWT 在 last_active != home 的会话里恰好是 peer 租户(见
|
||||
// 始终把激活空间写进 selectedTenantId,让 request.ts 永远附 X-Tenant-ID。
|
||||
// 历史实现里「切回 home 就清 override」会让请求落回 JWT 编码的空间,
|
||||
// 而 JWT 在 last_active != home 的会话里恰好是 peer 空间(见
|
||||
// userService.resolveLoginTenantID),结果切回 home 反而原地不动。
|
||||
// 服务端持久化偏好仍然按 home/peer 区分:home 时清空 last_active,
|
||||
// 让下次干净重登能正确回到 home。
|
||||
@@ -556,8 +556,8 @@ const loadUserInfo = async () => {
|
||||
// (同时污染 localStorage),系统管理入口在 hover 工作空间触发
|
||||
// refreshFromAuthMe 后才出现。新增字段请只改 userInfoFromApi。
|
||||
authStore.setUser(userInfoFromApi(user))
|
||||
// 如果返回了租户信息,也更新租户信息;tenantless 用户(/auth/me
|
||||
// 无 tenant)必须显式清空,否则会残留上一账号/上一会话的租户快照。
|
||||
// 如果返回了空间信息,也更新空间信息;tenantless 用户(/auth/me
|
||||
// 无 tenant)必须显式清空,否则会残留上一账号/上一会话的空间快照。
|
||||
if (response.data.tenant) {
|
||||
authStore.setTenant({
|
||||
id: String(response.data.tenant.id),
|
||||
@@ -1052,7 +1052,7 @@ onUnmounted(() => {
|
||||
margin: 3px 0;
|
||||
}
|
||||
|
||||
// 紧跟账号/租户区块后的分隔线:略收紧与上方的留白
|
||||
// 紧跟账号/空间区块后的分隔线:略收紧与上方的留白
|
||||
.dropdown-user-header+.menu-divider,
|
||||
.dropdown-tenant-panel+.menu-divider {
|
||||
margin-top: 1px;
|
||||
@@ -1207,7 +1207,7 @@ onUnmounted(() => {
|
||||
|
||||
// Home 标识改为叠在 avatar 右下角的小 dot,不在 meta 行额外占位,让
|
||||
// 各行徽标列宽对齐;用户切到非 home tenant 时这个小 icon 仍能一眼指
|
||||
// 出「我的主租户在哪一行」。
|
||||
// 出「我的主空间在哪一行」。
|
||||
.tenant-submenu-item-avatar {
|
||||
position: relative;
|
||||
}
|
||||
|
||||
@@ -22,7 +22,7 @@ const { t } = useI18n();
|
||||
const authStore = useAuthStore();
|
||||
|
||||
// canDeleteGeneratedQuestion 对应后端 DELETE /chunks/by-id/:id/questions
|
||||
// 的 OwnedChunkKBOrAdminFromChunkID 守卫——KB 创建者或租户 Admin+
|
||||
// 的 OwnedChunkKBOrAdminFromChunkID 守卫——KB 创建者或空间 Admin+
|
||||
// 才允许删除。父组件 KnowledgeBase.vue 通过 :canEditKB 把 KB 级权限
|
||||
// 传下来(包含 KB creator / Admin / 组织分享 editor 三种来源),未
|
||||
// 传时按更严格的 Admin 兜底,避免 Viewer 看到一个会 403 的入口。
|
||||
|
||||
@@ -49,7 +49,7 @@
|
||||
</div>
|
||||
</t-tooltip>
|
||||
|
||||
<!-- 租户选择器:仅在用户可切换租户时显示 -->
|
||||
<!-- 空间选择器:仅在用户可切换空间时显示 -->
|
||||
<TenantSelector v-if="canAccessAllTenants && !uiStore.sidebarCollapsed" />
|
||||
|
||||
<!-- 折叠时右侧拖拽展开手柄 -->
|
||||
@@ -355,7 +355,7 @@ const batchDisplayCount = computed(() =>
|
||||
isAllBatchSelected.value ? total.value : batchSelectedIds.value.length
|
||||
)
|
||||
|
||||
// 是否可以访问所有租户
|
||||
// 是否可以访问所有空间
|
||||
const canAccessAllTenants = computed(() => authStore.canAccessAllTenants);
|
||||
|
||||
// 是否处于知识库详情页(不包括全局聊天)
|
||||
|
||||
+114
-114
@@ -164,7 +164,7 @@ export default {
|
||||
},
|
||||
storage: {
|
||||
title: 'Storage (optional)',
|
||||
desc: 'Where raw files are stored (local or object storage). The tenant default is usually fine.',
|
||||
desc: 'Where raw files are stored (local or object storage). The workspace default is usually fine.',
|
||||
},
|
||||
navMultimodal: {
|
||||
title: 'Multimodal / images (optional)',
|
||||
@@ -323,7 +323,7 @@ export default {
|
||||
spaceTooltip: 'Shared via space "{space}"',
|
||||
spaceTooltipWithTenant: 'Shared via space "{space}" · from {tenant}',
|
||||
shared: 'External',
|
||||
sharedTooltip: 'Accessed from an external tenant via a shared space'
|
||||
sharedTooltip: 'Accessed from an external workspace via a shared space'
|
||||
},
|
||||
knowledgeBase: {
|
||||
title: 'Knowledge Base',
|
||||
@@ -1096,7 +1096,7 @@ export default {
|
||||
rerankModel: 'ReRank Model',
|
||||
rerankModelDesc: 'Used to rerank knowledge base retrieval results for better accuracy',
|
||||
rerankModelPlaceholder: 'Select ReRank Model',
|
||||
rerankModelOptionalHint: 'No RAG knowledge base in current scope, so this is optional. If a RAG knowledge base is added later, the tenant default rerank model will be used as a fallback. Configuring it explicitly is still recommended.',
|
||||
rerankModelOptionalHint: 'No RAG knowledge base in current scope, so this is optional. If a RAG knowledge base is added later, the workspace default rerank model will be used as a fallback. Configuring it explicitly is still recommended.',
|
||||
maxIterations: 'Max Iterations',
|
||||
allowedTools: 'Allowed Tools',
|
||||
multiTurn: 'Multi-turn Conversation',
|
||||
@@ -1217,7 +1217,7 @@ export default {
|
||||
mcpService: 'MCP Service',
|
||||
versionInfo: 'Version Info',
|
||||
taskQueue: 'Task Queues',
|
||||
tenantInfo: 'Tenant Info',
|
||||
tenantInfo: 'Workspace Info',
|
||||
apiInfo: 'API Info',
|
||||
navGroups: {
|
||||
account: 'Account',
|
||||
@@ -1229,7 +1229,7 @@ export default {
|
||||
},
|
||||
roleDenied: {
|
||||
title: 'Insufficient permissions',
|
||||
desc: "Your role can't access this settings page. Ask an admin of this tenant to grant the required role.",
|
||||
desc: "Your role can't access this settings page. Ask an admin of this workspace to grant the required role.",
|
||||
},
|
||||
weknoraCloud: {
|
||||
title: 'WeKnora Cloud',
|
||||
@@ -1990,7 +1990,7 @@ export default {
|
||||
authStore: {
|
||||
errors: {
|
||||
parseUserFailed: 'Failed to parse user information',
|
||||
parseTenantFailed: 'Failed to parse tenant information',
|
||||
parseTenantFailed: 'Failed to parse workspace information',
|
||||
parseKnowledgeBasesFailed: 'Failed to parse knowledge base list',
|
||||
parseCurrentKnowledgeBaseFailed: 'Failed to parse current knowledge base'
|
||||
}
|
||||
@@ -3253,8 +3253,8 @@ export default {
|
||||
attachmentTypeNotSupported: 'Unsupported file type: {name}',
|
||||
},
|
||||
tenant: {
|
||||
title: 'Tenant Information',
|
||||
currentTenant: 'Current Tenant',
|
||||
title: 'Workspace Information',
|
||||
currentTenant: 'Current Workspace',
|
||||
switchTenant: 'Switch workspace',
|
||||
switcher: {
|
||||
menuLabel: 'Switch workspace',
|
||||
@@ -3264,12 +3264,12 @@ export default {
|
||||
empty: 'You only belong to one workspace',
|
||||
},
|
||||
currentChip: {
|
||||
home: 'Home tenant',
|
||||
home: 'Home workspace',
|
||||
},
|
||||
sectionDescription: 'View detailed configuration for the tenant',
|
||||
sectionDescription: 'View detailed configuration for the workspace',
|
||||
apiDocument: 'API Document',
|
||||
name: 'Tenant Name',
|
||||
id: 'Tenant ID',
|
||||
name: 'Workspace Name',
|
||||
id: 'Workspace ID',
|
||||
createdAt: 'Created At',
|
||||
updatedAt: 'Updated At',
|
||||
status: 'Status',
|
||||
@@ -3285,9 +3285,9 @@ export default {
|
||||
userId: 'User ID',
|
||||
username: 'Username',
|
||||
email: 'Email',
|
||||
tenantInfo: 'Tenant Information',
|
||||
tenantId: 'Tenant ID',
|
||||
tenantName: 'Tenant Name',
|
||||
tenantInfo: 'Workspace Information',
|
||||
tenantId: 'Workspace ID',
|
||||
tenantName: 'Workspace Name',
|
||||
description: 'Description',
|
||||
business: 'Business',
|
||||
noDescription: 'No description',
|
||||
@@ -3312,13 +3312,13 @@ export default {
|
||||
apiKeyCopied: 'API Key copied to clipboard',
|
||||
unknown: 'Unknown',
|
||||
formatError: 'Format error',
|
||||
searchPlaceholder: 'Search by name or enter tenant ID...',
|
||||
searchHint: 'Search by name or enter tenant ID directly',
|
||||
noMatch: 'No matching tenants found',
|
||||
searchPlaceholder: 'Search by name or enter workspace ID...',
|
||||
searchHint: 'Search by name or enter workspace ID directly',
|
||||
noMatch: 'No matching workspaces found',
|
||||
switchSuccessTitle: 'Workspace switched',
|
||||
switchSuccessContent: 'You are now in {name}',
|
||||
switchSuccessContentWithRole: 'You are now in {name} · as {role}',
|
||||
loadTenantsFailed: 'Failed to load tenant list',
|
||||
loadTenantsFailed: 'Failed to load workspace list',
|
||||
loading: 'Loading...',
|
||||
loadMore: 'Load more',
|
||||
create: {
|
||||
@@ -3337,34 +3337,34 @@ export default {
|
||||
disabled: 'This system only allows joining workspaces by invitation. You cannot create one yourself.',
|
||||
},
|
||||
details: {
|
||||
idLabel: 'Tenant ID',
|
||||
idDescription: 'Unique identifier of your tenant',
|
||||
nameLabel: 'Tenant Name',
|
||||
nameDescription: 'Name of your tenant',
|
||||
descriptionLabel: 'Tenant Description',
|
||||
descriptionDescription: 'Detailed description of the tenant',
|
||||
businessLabel: 'Tenant Business',
|
||||
businessDescription: 'Business domain that the tenant belongs to',
|
||||
statusLabel: 'Tenant Status',
|
||||
statusDescription: 'Current operational status of the tenant',
|
||||
createdAtLabel: 'Tenant Creation Time',
|
||||
createdAtDescription: 'Time when the tenant was created',
|
||||
idLabel: 'Workspace ID',
|
||||
idDescription: 'Unique identifier of your workspace',
|
||||
nameLabel: 'Workspace Name',
|
||||
nameDescription: 'Name of your workspace',
|
||||
descriptionLabel: 'Workspace Description',
|
||||
descriptionDescription: 'Detailed description of the workspace',
|
||||
businessLabel: 'Workspace Business',
|
||||
businessDescription: 'Business domain that the workspace belongs to',
|
||||
statusLabel: 'Workspace Status',
|
||||
statusDescription: 'Current operational status of the workspace',
|
||||
createdAtLabel: 'Workspace Creation Time',
|
||||
createdAtDescription: 'Time when the workspace was created',
|
||||
editName: 'Edit name',
|
||||
editNamePlaceholder: 'Enter the new tenant name',
|
||||
editNamePlaceholder: 'Enter the new workspace name',
|
||||
editNameConfirm: 'Save',
|
||||
editNameCancel: 'Cancel',
|
||||
editNameRequired: 'Tenant name cannot be empty',
|
||||
editNameSuccess: 'Tenant name updated',
|
||||
editNameFailed: 'Failed to update tenant name',
|
||||
editNameRequired: 'Workspace name cannot be empty',
|
||||
editNameSuccess: 'Workspace name updated',
|
||||
editNameFailed: 'Failed to update workspace name',
|
||||
editDescription: 'Edit description',
|
||||
editDescriptionPlaceholder: 'Enter the new tenant description',
|
||||
editDescriptionSuccess: 'Tenant description updated',
|
||||
editDescriptionFailed: 'Failed to update tenant description',
|
||||
editDescriptionPlaceholder: 'Enter the new workspace description',
|
||||
editDescriptionSuccess: 'Workspace description updated',
|
||||
editDescriptionFailed: 'Failed to update workspace description',
|
||||
descriptionEmptyPlaceholder: 'Not set'
|
||||
},
|
||||
storage: {
|
||||
quotaLabel: 'Storage Quota',
|
||||
quotaDescription: 'Total storage capacity allocated to the tenant',
|
||||
quotaDescription: 'Total storage capacity allocated to the workspace',
|
||||
usedLabel: 'Used Storage',
|
||||
usedDescription: 'Storage space that has been used',
|
||||
usageLabel: 'Storage Usage',
|
||||
@@ -3388,7 +3388,7 @@ export default {
|
||||
failed: 'Failed to delete workspace',
|
||||
},
|
||||
messages: {
|
||||
fetchFailed: 'Failed to fetch tenant information',
|
||||
fetchFailed: 'Failed to fetch workspace information',
|
||||
networkError: 'Network error, please try again later'
|
||||
},
|
||||
api: {
|
||||
@@ -3486,7 +3486,7 @@ export default {
|
||||
},
|
||||
globalSettings: {
|
||||
title: 'System Settings',
|
||||
description: 'Platform-wide runtime configuration. Saves take effect immediately for every tenant. Visible and editable by system administrators only.',
|
||||
description: 'Platform-wide runtime configuration. Saves take effect immediately for every workspace. Visible and editable by system administrators only.',
|
||||
loading: 'Loading...',
|
||||
empty: 'No configurable system settings available',
|
||||
autoSaveHint: 'Changes save automatically',
|
||||
@@ -3518,9 +3518,9 @@ export default {
|
||||
description: 'Manage system administrators, public registration, and workspace-creation rules.',
|
||||
},
|
||||
tenant: {
|
||||
tab: 'Tenant defaults {count}',
|
||||
title: 'Tenant defaults',
|
||||
description: 'Set initial quotas and compatibility behavior for new tenants without rewriting existing tenants.',
|
||||
tab: 'Workspace defaults {count}',
|
||||
title: 'Workspace defaults',
|
||||
description: 'Set initial quotas and compatibility behavior for new workspaces without rewriting existing workspaces.',
|
||||
},
|
||||
runtime: {
|
||||
tab: 'Runtime & concurrency {count}',
|
||||
@@ -3618,7 +3618,7 @@ export default {
|
||||
knowledgeBaseLabel: "Knowledge base ID",
|
||||
knowledgeLabel: "Document ID",
|
||||
taskIDLabel: "Business task ID",
|
||||
tenantLabel: "Tenant ID",
|
||||
tenantLabel: "Workspace ID",
|
||||
sourceLabel: "Source ID",
|
||||
targetLabel: "Target ID",
|
||||
sourceKBLabel: "Source knowledge base",
|
||||
@@ -3739,10 +3739,10 @@ export default {
|
||||
whitelist: 'SSRF protection allowlist',
|
||||
},
|
||||
tenant: {
|
||||
max_owned_per_user: 'Max tenants owned per user',
|
||||
max_owned_per_user: 'Max workspaces owned per user',
|
||||
self_service_creation_enabled: 'Allow self-service workspace creation',
|
||||
default_storage_quota_gb: 'Default storage quota for new tenants (GB)',
|
||||
auto_create_api_key: 'Automatically create an API key for new tenants',
|
||||
default_storage_quota_gb: 'Default storage quota for new workspaces (GB)',
|
||||
auto_create_api_key: 'Automatically create an API key for new workspaces',
|
||||
},
|
||||
asynq: {
|
||||
core_concurrency: 'Guaranteed core parse concurrency',
|
||||
@@ -3769,13 +3769,13 @@ export default {
|
||||
},
|
||||
tenant: {
|
||||
max_owned_per_user:
|
||||
'Maximum number of tenants a non-superuser may own via self-service creation. Read on every tenant creation and takes effect immediately after saving. 0 uses the built-in default of 10; a negative value disables the cap entirely (not recommended on public deployments).',
|
||||
'Maximum number of workspaces a non-superuser may own via self-service creation. Read on every workspace creation and takes effect immediately after saving. 0 uses the built-in default of 10; a negative value disables the cap entirely (not recommended on public deployments).',
|
||||
self_service_creation_enabled:
|
||||
'Whether non-superusers may create workspaces themselves. When disabled, regular users can only join existing workspaces by invitation; cross-tenant superusers remain exempt. Takes effect immediately.',
|
||||
'Whether non-superusers may create workspaces themselves. When disabled, regular users can only join existing workspaces by invitation; cross-workspace superusers remain exempt. Takes effect immediately.',
|
||||
default_storage_quota_gb:
|
||||
'Default storage quota (GB) assigned when a new tenant is created, covering vectors, originals, text, indexes, and related data. Read only at creation time — changes apply to newly created tenants only and do not retroactively update existing tenants. 0 or a negative value uses the built-in default of 10 GB.',
|
||||
'Default storage quota (GB) assigned when a new workspace is created, covering vectors, originals, text, indexes, and related data. Read only at creation time — changes apply to newly created workspaces only and do not retroactively update existing workspaces. 0 or a negative value uses the built-in default of 10 GB.',
|
||||
auto_create_api_key:
|
||||
'Automatically creates a full_access API key for a new tenant and returns its plaintext token in the create response. Use only for integrations that depend on the legacy behavior; it is disabled by default and explicit API-key creation is recommended.',
|
||||
'Automatically creates a full_access API key for a new workspace and returns its plaintext token in the create response. Use only for integrations that depend on the legacy behavior; it is disabled by default and explicit API-key creation is recommended.',
|
||||
},
|
||||
asynq: {
|
||||
core_concurrency: 'Guaranteed per-process concurrency for document and manual parsing. Core may also borrow the shared elastic pool. Minimum 1; requires a service restart.',
|
||||
@@ -3850,7 +3850,7 @@ export default {
|
||||
confirm: {
|
||||
promote: {
|
||||
header: 'Promote to system administrator',
|
||||
body: 'Promote {email} to system administrator? This user will gain platform-level privileges: access to every tenant, system settings, and the admin roster itself.',
|
||||
body: 'Promote {email} to system administrator? This user will gain platform-level privileges: access to every workspace, system settings, and the admin roster itself.',
|
||||
confirmBtn: 'Promote',
|
||||
},
|
||||
revoke: {
|
||||
@@ -3887,12 +3887,12 @@ export default {
|
||||
},
|
||||
},
|
||||
bulkApply: {
|
||||
label: 'Apply to all existing tenants',
|
||||
tooltip: 'Saving the value only affects new tenants by default; click here to also overwrite every existing tenant.',
|
||||
label: 'Apply to all existing workspaces',
|
||||
tooltip: 'Saving the value only affects new workspaces by default; click here to also overwrite every existing workspace.',
|
||||
confirmBtn: 'Confirm apply',
|
||||
confirmBody: 'Overwrite the storage quota of every existing tenant to {value} GB. Tenants whose quota was tuned manually by operations will also be overwritten. Continue?',
|
||||
success: 'Updated storage quota for {count} tenants to {gb} GB',
|
||||
failed: 'Failed to apply to all tenants',
|
||||
confirmBody: 'Overwrite the storage quota of every existing workspace to {value} GB. Workspaces whose quota was tuned manually by operations will also be overwritten. Continue?',
|
||||
success: 'Updated storage quota for {count} workspaces to {gb} GB',
|
||||
failed: 'Failed to apply to all workspaces',
|
||||
},
|
||||
audit: {
|
||||
tabLabel: 'Audit log',
|
||||
@@ -3935,7 +3935,7 @@ export default {
|
||||
},
|
||||
target: {
|
||||
bulkQuota: 'Bulk sync: default storage quota',
|
||||
bulkQuotaDiff: 'Applied to {count} tenants ({gb} GB)',
|
||||
bulkQuotaDiff: 'Applied to {count} workspaces ({gb} GB)',
|
||||
promoteIdempotent: 'Target was already a system admin (idempotent)',
|
||||
revokeNoop: 'Target was not a system admin (idempotent)',
|
||||
requiredRole: 'Required role: {role}',
|
||||
@@ -3990,7 +3990,7 @@ export default {
|
||||
loginFailed: 'Login failed',
|
||||
registerFailed: 'Registration failed',
|
||||
getUserFailed: 'Failed to get user info',
|
||||
getTenantFailed: 'Failed to get tenant info',
|
||||
getTenantFailed: 'Failed to get workspace info',
|
||||
updatePreferencesFailed: 'Failed to update preferences',
|
||||
refreshTokenFailed: 'Token refresh failed',
|
||||
logoutFailed: 'Logout failed',
|
||||
@@ -4003,13 +4003,13 @@ export default {
|
||||
deleteFailed: 'Failed to delete model',
|
||||
},
|
||||
tenant: {
|
||||
listFailed: 'Failed to list tenants',
|
||||
searchFailed: 'Failed to search tenants',
|
||||
listFailed: 'Failed to list workspaces',
|
||||
searchFailed: 'Failed to search workspaces',
|
||||
getApiPrincipalConfigFailed: 'Failed to get API principal config',
|
||||
updateApiPrincipalConfigFailed: 'Failed to update API principal config',
|
||||
createApiPrincipalTestTokenFailed: 'Failed to create API test token',
|
||||
updateFailed: 'Failed to update tenant information',
|
||||
deleteFailed: 'Failed to delete tenant',
|
||||
updateFailed: 'Failed to update workspace information',
|
||||
deleteFailed: 'Failed to delete workspace',
|
||||
},
|
||||
initialization: {
|
||||
checkFailed: 'Check failed',
|
||||
@@ -4343,7 +4343,7 @@ export default {
|
||||
multimodalParsing: 'Multimodal Document Parsing',
|
||||
hybridSearchEngine: 'Hybrid Search + Knowledge Graph',
|
||||
ragQandA: 'ReAct Agent Q&A',
|
||||
independentTenant: 'Independent Tenant Space',
|
||||
independentTenant: 'Independent Workspace',
|
||||
fullApiAccess: 'Full API Access',
|
||||
knowledgeBaseManagement: 'Knowledge Base Management',
|
||||
carousel: {
|
||||
@@ -4712,8 +4712,8 @@ export default {
|
||||
copySuffix: ' Copy',
|
||||
builtinModels: {
|
||||
title: 'Built-in Models',
|
||||
description: 'Built-in models are visible to all tenants. Sensitive information is hidden, and they cannot be edited or deleted.',
|
||||
descriptionAdmin: 'Built-in models are visible to all tenants. System administrators can edit configuration and credentials; deletion remains deployment-managed.',
|
||||
description: 'Built-in models are visible to all workspaces. Sensitive information is hidden, and they cannot be edited or deleted.',
|
||||
descriptionAdmin: 'Built-in models are visible to all workspaces. System administrators can edit configuration and credentials; deletion remains deployment-managed.',
|
||||
viewGuide: 'View Built-in Models Guide',
|
||||
},
|
||||
builtinTag: 'Built-in',
|
||||
@@ -4937,11 +4937,11 @@ export default {
|
||||
inviteCodeRefreshed: 'Invite code refreshed',
|
||||
inviteCodeRefreshFailed: 'Failed to refresh invite code',
|
||||
rbac: {
|
||||
needTenantAdmin: 'Tenant admin role required',
|
||||
needTenantAdminTip: 'This action requires the admin role (or higher) in the current tenant. Please contact the tenant owner.',
|
||||
cannotCreate: 'Your tenant role is insufficient to create a shared space',
|
||||
cannotJoin: 'Your tenant role is insufficient to join or request to join a shared space',
|
||||
cannotManage: 'Your tenant role is insufficient to manage this shared space',
|
||||
needTenantAdmin: 'Workspace admin role required',
|
||||
needTenantAdminTip: 'This action requires the admin role (or higher) in the current workspace. Please contact the workspace owner.',
|
||||
cannotCreate: 'Your workspace role is insufficient to create a shared space',
|
||||
cannotJoin: 'Your workspace role is insufficient to join or request to join a shared space',
|
||||
cannotManage: 'Your workspace role is insufficient to manage this shared space',
|
||||
},
|
||||
join: {
|
||||
title: 'Join Space',
|
||||
@@ -5049,7 +5049,7 @@ export default {
|
||||
editTitle: 'Space Settings',
|
||||
detailTitle: 'Space Details',
|
||||
myRoleDesc: 'Your role in this space determines your permissions',
|
||||
membersDesc: 'View and manage space members and their roles. Each member represents a tenant — all users in the same tenant share access to this space.',
|
||||
membersDesc: 'View and manage space members and their roles. Each member represents a workspace — all users in the same workspace share access to this space.',
|
||||
sharedDesc: 'View all knowledge bases shared to this space',
|
||||
noSharedKB: 'No shared knowledge bases yet',
|
||||
noSharedKBTip: 'Knowledge base owners can share their knowledge bases to this space in KB settings',
|
||||
@@ -5152,13 +5152,13 @@ export default {
|
||||
button: 'Add Member',
|
||||
dialogTitle: 'Add Member',
|
||||
tip: 'Added users will immediately become space members and can access shared knowledge bases.',
|
||||
tipTenant: 'Membership is at the tenant level: once a tenant joins, all of its users share access to this space. Results below are deduplicated by tenant.',
|
||||
tipTenant: 'Membership is at the workspace level: once a workspace joins, all of its users share access to this space. Results below are deduplicated by workspace.',
|
||||
searchUser: 'Select User',
|
||||
searchTenant: 'Select Tenant',
|
||||
searchTenant: 'Select Workspace',
|
||||
searchPlaceholder: 'Search by username or email...',
|
||||
searchTenantPlaceholder: 'Search by tenant name, username or email...',
|
||||
searchTenantPlaceholder: 'Search by workspace name, username or email...',
|
||||
searchHint: 'Type at least 2 characters to search',
|
||||
searchTenantHint: 'Type at least 2 characters; results are deduplicated by tenant and exclude tenants already in this space',
|
||||
searchTenantHint: 'Type at least 2 characters; results are deduplicated by workspace and exclude workspaces already in this space',
|
||||
selectRole: 'Assign Role',
|
||||
confirmBtn: 'Add',
|
||||
success: 'Member added successfully',
|
||||
@@ -5311,7 +5311,7 @@ export default {
|
||||
loading: 'Loading vector stores...',
|
||||
engineLabel: 'Vector store',
|
||||
engineDesc:
|
||||
'Pick a store from the global Vector Stores configuration, or leave as System default to use the tenant-wide RETRIEVE_DRIVER engine.',
|
||||
'Pick a store from the global Vector Stores configuration, or leave as System default to use the workspace-wide RETRIEVE_DRIVER engine.',
|
||||
boundLabel: 'Bound vector store',
|
||||
systemDefault: 'System default',
|
||||
immutableHint:
|
||||
@@ -6175,7 +6175,7 @@ export default {
|
||||
save: 'Save',
|
||||
baseUrl: 'API Base URL',
|
||||
baseUrlDesc: 'Use this base URL with REST API paths.',
|
||||
apiKey: 'Tenant API Key',
|
||||
apiKey: 'Workspace API Key',
|
||||
apiKeyDesc: 'Create API keys with operation permissions and knowledge-base scope.',
|
||||
apiKeys: 'API Keys',
|
||||
apiKeysDesc: 'Create separate keys per integration and restrict operation permissions plus knowledge-base access.',
|
||||
@@ -6191,28 +6191,28 @@ export default {
|
||||
apiKeyScopedAccess: 'Scoped access',
|
||||
apiKeyAccessRole: "Access role",
|
||||
apiKeyAccessType: "Access type",
|
||||
apiKeyAccessTypeHint: "\"Knowledge base\" operates within the KB scope at the permission level below; \"Tenant full\" additionally unlocks every tenant-level API such as models and data sources.",
|
||||
apiKeyAccessTypeHint: "\"Knowledge base\" operates within the KB scope at the permission level below; \"Workspace full\" additionally unlocks every workspace-level API such as models and data sources.",
|
||||
accessTypeKnowledgeBase: "Knowledge base",
|
||||
accessTypeTenantFull: "Tenant full",
|
||||
accessTypeTenantFull: "Workspace full",
|
||||
apiKeyPermissionLevel: "Permission level",
|
||||
apiKeyAccessRoleHint: "The first three roles are limited to knowledge-base operations; \"Tenant Full\" also unlocks tenant-level APIs such as models and data sources.",
|
||||
apiKeyAccessRoleHint: "The first three roles are limited to knowledge-base operations; \"Workspace Full\" also unlocks workspace-level APIs such as models and data sources.",
|
||||
accessRoleViewer: "KB Read",
|
||||
accessRoleContributor: "KB Write",
|
||||
accessRoleAdmin: "KB Admin",
|
||||
accessRoleOwner: "Tenant Full",
|
||||
accessRoleOwner: "Workspace Full",
|
||||
accessRoleViewerDesc: "Query, search, and chat without modifying knowledge-base content.",
|
||||
accessRoleContributorDesc: "Create, update, or delete knowledge-base content within the selected scope.",
|
||||
accessRoleAdminDesc: "Manage knowledge bases, including destructive operations like clearing a KB, within the selected scope; no tenant-level configuration.",
|
||||
accessRoleOwnerDesc: "Full access, equivalent to a tenant owner: may call every tenant-level API (models, vector stores, data sources, channels, ...). Not limited by knowledge-base scope.",
|
||||
accessRoleAdminDesc: "Manage knowledge bases, including destructive operations like clearing a KB, within the selected scope; no workspace-level configuration.",
|
||||
accessRoleOwnerDesc: "Full access, equivalent to a workspace owner: may call every workspace-level API (models, vector stores, data sources, channels, ...). Not limited by knowledge-base scope.",
|
||||
apiKeyCapabilities: 'Capabilities',
|
||||
apiKeyCapabilityGroupKnowledge: 'Knowledge-base data',
|
||||
apiKeyCapabilityGroupAutomation: 'Agents and integrations',
|
||||
apiKeyCapabilityGroupCollaboration: 'Members and spaces',
|
||||
apiKeyCapabilityGroupTenant: 'Tenant configuration',
|
||||
apiKeyCapabilityGroupTenant: 'Workspace configuration',
|
||||
apiKeyCapabilitySelectGroup: 'Select all',
|
||||
apiKeyCapabilityClearGroup: 'Clear',
|
||||
capabilityTenantFull: 'Tenant full access',
|
||||
capabilityTenantFullHint: 'Allow every tenant-level API, including models, vector stores, data sources and channels. Knowledge-base scope does not apply.',
|
||||
capabilityTenantFull: 'Workspace full access',
|
||||
capabilityTenantFullHint: 'Allow every workspace-level API, including models, vector stores, data sources and channels. Knowledge-base scope does not apply.',
|
||||
capabilityRetrieve: 'Retrieve knowledge bases',
|
||||
capabilityRetrieveHint: 'Read, query, and search data inside the selected knowledge-base scope. Does not create sessions or modify content.',
|
||||
capabilityChat: 'Chat',
|
||||
@@ -6226,7 +6226,7 @@ export default {
|
||||
capabilityManageAgents: 'Manage agents',
|
||||
capabilityManageAgentsHint: 'Let this key create, update, delete and copy agents. Agent config can carry sensitive model/MCP bindings, so this is off by default — enable only when needed.',
|
||||
capabilityMessageHistory: 'Message history',
|
||||
capabilityMessageHistoryHint: 'Let this key search tenant chat history and read chat-history stats. It does not grant tenant configuration access.',
|
||||
capabilityMessageHistoryHint: 'Let this key search workspace chat history and read chat-history stats. It does not grant workspace configuration access.',
|
||||
capabilityManageModels: 'Manage models',
|
||||
capabilityManageModelsHint: 'Manage model definitions, credentials, connectivity checks, and WeKnoraCloud credentials.',
|
||||
capabilityManageMcpServices: 'Manage MCP services',
|
||||
@@ -6242,11 +6242,11 @@ export default {
|
||||
capabilityRunEvaluations: 'Run evaluations',
|
||||
capabilityRunEvaluationsHint: 'Run evaluation jobs and read evaluation results.',
|
||||
capabilityManageMembers: 'Manage members',
|
||||
capabilityManageMembersHint: 'List and manage tenant members, roles, invitations, and invite links. Does not include API key management, tenant deletion, or ownership transfer.',
|
||||
capabilityManageMembersHint: 'List and manage workspace members, roles, invitations, and invite links. Does not include API key management, workspace deletion, or ownership transfer.',
|
||||
capabilityManageSpaces: 'Manage spaces',
|
||||
capabilityManageSpacesHint: 'Manage organization spaces, join flows, space membership, invitations, and shared-space visibility. Does not grant KB or agent share management.',
|
||||
capabilityManageTenantSettings: 'Manage tenant settings',
|
||||
capabilityManageTenantSettingsHint: 'Read and update tenant-level integration settings such as API end-user identity mode, request header configuration, and tenant KV settings. Does not include API key management, member management, tenant deletion, or ownership transfer.',
|
||||
capabilityManageTenantSettings: 'Manage workspace settings',
|
||||
capabilityManageTenantSettingsHint: 'Read and update workspace-level integration settings such as API end-user identity mode, request header configuration, and workspace KV settings. Does not include API key management, member management, workspace deletion, or ownership transfer.',
|
||||
apiKeyKnowledgeScope: 'Knowledge bases',
|
||||
apiKeyKnowledgeScopePlaceholder: 'Leave empty to allow all knowledge bases',
|
||||
apiKeyKnowledgeScopeOwnerHint: 'Full-access keys are not limited by knowledge-base scope.',
|
||||
@@ -6266,7 +6266,7 @@ export default {
|
||||
'Choose how API requests identify the end user. This identity scopes both conversation sessions and MCP tool authorization per user.',
|
||||
principalScope:
|
||||
'End-user identity isolates sessions and MCP OAuth. Operation permissions and knowledge-base scope are controlled by API Keys above.',
|
||||
modeTenant: 'Tenant only',
|
||||
modeTenant: 'Workspace only',
|
||||
modeDirect: 'Direct user ID',
|
||||
modeSigned: 'Signed token',
|
||||
directWarning: 'Direct user ID trusts the caller-supplied header. Use only for trusted server-to-server calls.',
|
||||
@@ -6278,7 +6278,7 @@ export default {
|
||||
directHeader: 'User ID header',
|
||||
requireDirectHeader: 'Require user ID header',
|
||||
requireDirectHeaderDesc:
|
||||
'When enabled, API Key requests without the user ID header are rejected; when disabled, all requests are treated as the whole tenant with no per-user distinction.',
|
||||
'When enabled, API Key requests without the user ID header are rejected; when disabled, all requests are treated as the whole workspace with no per-user distinction.',
|
||||
tokenHeader: 'Token header',
|
||||
tokenHeaderDesc: 'Clients send the backend-signed JWT in this fixed header.',
|
||||
hmacSecret: 'HMAC secret',
|
||||
@@ -6312,7 +6312,7 @@ export default {
|
||||
playgroundAgentsLoadFailed: 'Failed to load agents',
|
||||
playgroundExternalUser: 'External user ID',
|
||||
playgroundExternalUserPlaceholder: 'user_123',
|
||||
playgroundTenantModeHint: 'Tenant-only mode does not send an external user identity; all API sessions use the same tenant-level principal.',
|
||||
playgroundTenantModeHint: 'Workspace-only mode does not send an external user identity; all API sessions use the same workspace-level principal.',
|
||||
playgroundDirectModeHint: 'This user ID is sent with the {headerName} header.',
|
||||
playgroundSignedModeHint: 'Signed-token mode uses the JWT sub as the external user. The playground signs a short-lived test JWT for this user ID.',
|
||||
playgroundQuestion: 'Test question',
|
||||
@@ -6320,7 +6320,7 @@ export default {
|
||||
playgroundRequestPreview: 'Request preview (secrets masked)',
|
||||
playgroundRun: 'Run test',
|
||||
playgroundStop: 'Stop',
|
||||
playgroundNeedApiKey: 'This tenant has no API key.',
|
||||
playgroundNeedApiKey: 'This workspace has no API key.',
|
||||
playgroundNeedAgent: 'Select a test agent.',
|
||||
playgroundNeedQuestion: 'Enter a test question.',
|
||||
playgroundNeedExternalUser: 'Enter an external user ID.',
|
||||
@@ -6483,9 +6483,9 @@ export default {
|
||||
imOverview: {
|
||||
menuTitle: 'Connected IMs',
|
||||
pageTitle: 'Connected IMs',
|
||||
subtitle: 'All IM channels connected to agents in this tenant — toggle state or jump to the owning agent',
|
||||
subtitle: 'All IM channels connected to agents in this workspace — toggle state or jump to the owning agent',
|
||||
totalCount: '{count} total',
|
||||
empty: 'This tenant has no IM bots configured yet',
|
||||
empty: 'This workspace has no IM bots configured yet',
|
||||
loadFailed: 'Failed to load IM bots',
|
||||
builtinAgent: 'Built-in agent',
|
||||
liveIndicator: 'IM channels are live',
|
||||
@@ -6531,7 +6531,7 @@ export default {
|
||||
},
|
||||
tenantMember: {
|
||||
title: 'Members',
|
||||
sectionDescription: 'Invite teammates to the tenant and manage their roles. Only Owner can add or remove members.',
|
||||
sectionDescription: 'Invite teammates to the workspace and manage their roles. Only Owner can add or remove members.',
|
||||
learnRbacGuide: 'Learn about RBAC',
|
||||
totalCount: '{n} members',
|
||||
listTitle: 'Workspace members',
|
||||
@@ -6543,13 +6543,13 @@ export default {
|
||||
searchPlaceholder: 'Search by name or email',
|
||||
permissions: {
|
||||
title: 'Role permissions',
|
||||
desc: 'What each role can do inside this tenant. Server-enforced; UI controls reflect the rules but are not the source of truth.',
|
||||
desc: 'What each role can do inside this workspace. Server-enforced; UI controls reflect the rules but are not the source of truth.',
|
||||
iconHint: 'Hover to view role permission details',
|
||||
manageMembers: 'Manage members',
|
||||
manageTenantConfig: 'Edit tenant settings',
|
||||
manageTenantConfig: 'Edit workspace settings',
|
||||
manageInfra: 'Configure models / vector stores / IM channels',
|
||||
createOwnKB: 'Create and edit own KBs and agents',
|
||||
readAll: 'Read tenant content',
|
||||
readAll: 'Read workspace content',
|
||||
},
|
||||
columns: {
|
||||
member: 'Name & email',
|
||||
@@ -6577,16 +6577,16 @@ export default {
|
||||
remove: {
|
||||
button: 'Remove',
|
||||
confirmTitle: 'Remove member?',
|
||||
confirmBody: 'Are you sure you want to remove {name} from this tenant? They will lose access immediately.',
|
||||
confirmBody: 'Are you sure you want to remove {name} from this workspace? They will lose access immediately.',
|
||||
confirm: 'Remove',
|
||||
success: 'Member removed',
|
||||
},
|
||||
leave: {
|
||||
button: 'Leave Tenant',
|
||||
confirmTitle: 'Leave this tenant?',
|
||||
confirmBody: 'You will lose access to all knowledge bases and agents in this tenant. You can be re-invited later.',
|
||||
button: 'Leave Workspace',
|
||||
confirmTitle: 'Leave this workspace?',
|
||||
confirmBody: 'You will lose access to all knowledge bases and agents in this workspace. You can be re-invited later.',
|
||||
confirm: 'Leave',
|
||||
success: 'You have left the tenant',
|
||||
success: 'You have left the workspace',
|
||||
},
|
||||
roleChange: {
|
||||
success: 'Role updated',
|
||||
@@ -6596,10 +6596,10 @@ export default {
|
||||
emailFormat: 'Invalid email address',
|
||||
roleRequired: 'Role is required',
|
||||
userNotFound: 'No registered user with this email. Ask them to sign up first.',
|
||||
alreadyMember: 'This user is already a member of the tenant.',
|
||||
alreadyMember: 'This user is already a member of the workspace.',
|
||||
lastOwner: 'Cannot demote, remove, or leave as the last Owner. Promote another member to Owner first.',
|
||||
notFound: 'Membership not found.',
|
||||
noTenant: 'No active tenant.',
|
||||
noTenant: 'No active workspace.',
|
||||
invalidRole: 'Role must be one of owner / admin / contributor / viewer.',
|
||||
generic: 'Something went wrong. Please try again.',
|
||||
},
|
||||
@@ -6610,7 +6610,7 @@ export default {
|
||||
audit: {
|
||||
tabLabel: 'Audit log',
|
||||
description:
|
||||
'Records every membership change and access denial in this tenant. Newest first. Repeated denials within a minute are deduplicated.',
|
||||
'Records every membership change and access denial in this workspace. Newest first. Repeated denials within a minute are deduplicated.',
|
||||
refresh: 'Refresh',
|
||||
loadMore: 'Load older',
|
||||
end: 'End of log.',
|
||||
@@ -6662,7 +6662,7 @@ export default {
|
||||
inviteSuccess: 'Invitation sent. Waiting for the invitee to accept.',
|
||||
confirmInviteTitle: 'Send invitation?',
|
||||
confirmInviteBody:
|
||||
'Send an invitation to {email} (role: {role}). They will join the tenant only after accepting.',
|
||||
'Send an invitation to {email} (role: {role}). They will join the workspace only after accepting.',
|
||||
confirmSend: 'Send',
|
||||
copyLink: 'Copy invite link',
|
||||
copied: 'Copied to clipboard',
|
||||
@@ -6708,21 +6708,21 @@ export default {
|
||||
myInbox: {
|
||||
title: 'My invitations',
|
||||
description:
|
||||
'Invitations from other tenants. Accept to join with the assigned role.',
|
||||
'Invitations from other workspaces. Accept to join with the assigned role.',
|
||||
empty: 'No pending invitations.',
|
||||
acceptButton: 'Accept',
|
||||
declineButton: 'Decline',
|
||||
acceptSuccess: 'Joined "{tenant}".',
|
||||
declineSuccess: 'Invitation declined.',
|
||||
from: 'From',
|
||||
tenantLabel: 'Tenant',
|
||||
tenantLabel: 'Workspace',
|
||||
expiresIn: 'Expires: {date}',
|
||||
messageLabel: 'Message',
|
||||
gotoLink: 'Open inbox',
|
||||
},
|
||||
errors: {
|
||||
pendingExists: 'A pending invitation for this user already exists.',
|
||||
alreadyMember: 'This user is already an active member of the tenant.',
|
||||
alreadyMember: 'This user is already an active member of the workspace.',
|
||||
notPending: 'The invitation is no longer pending.',
|
||||
expired: 'The invitation has expired.',
|
||||
forbidden: 'Only the invitee can accept or decline this invitation.',
|
||||
|
||||
+111
-111
@@ -164,7 +164,7 @@ export default {
|
||||
},
|
||||
storage: {
|
||||
title: "스토리지(선택)",
|
||||
desc: "원본 파일 저장 위치(로컬 또는 객체 스토리지)입니다. 테넌트 기본값을 따르면 됩니다.",
|
||||
desc: "원본 파일 저장 위치(로컬 또는 객체 스토리지)입니다. 워크스페이스 기본값을 따르면 됩니다.",
|
||||
},
|
||||
navMultimodal: {
|
||||
title: "멀티모달/이미지(선택)",
|
||||
@@ -323,7 +323,7 @@ export default {
|
||||
spaceTooltip: "공유 스페이스 「{space}」에서 가져옴",
|
||||
spaceTooltipWithTenant: "공유 스페이스 「{space}」 · 출처 {tenant}",
|
||||
shared: "외부 공유",
|
||||
sharedTooltip: "공유 스페이스를 통해 외부 테넌트에서 접근",
|
||||
sharedTooltip: "공유 스페이스를 통해 외부 워크스페이스에서 접근",
|
||||
},
|
||||
knowledgeBase: {
|
||||
title: "지식베이스",
|
||||
@@ -1075,7 +1075,7 @@ export default {
|
||||
mcpService: "MCP 서비스",
|
||||
versionInfo: "버전 정보",
|
||||
taskQueue: "작업 큐",
|
||||
tenantInfo: "테넌트 정보",
|
||||
tenantInfo: "워크스페이스 정보",
|
||||
apiInfo: "API 정보",
|
||||
navGroups: {
|
||||
account: "계정",
|
||||
@@ -1087,7 +1087,7 @@ export default {
|
||||
},
|
||||
roleDenied: {
|
||||
title: "권한 없음",
|
||||
desc: "현재 역할로는 이 설정 페이지에 접근할 수 없습니다. 이 테넌트의 관리자에게 필요한 역할을 요청하세요.",
|
||||
desc: "현재 역할로는 이 설정 페이지에 접근할 수 없습니다. 이 워크스페이스의 관리자에게 필요한 역할을 요청하세요.",
|
||||
},
|
||||
weknoraCloud: {
|
||||
title: 'WeKnora Cloud',
|
||||
@@ -1842,7 +1842,7 @@ export default {
|
||||
authStore: {
|
||||
errors: {
|
||||
parseUserFailed: "사용자 정보 파싱 실패",
|
||||
parseTenantFailed: "테넌트 정보 파싱 실패",
|
||||
parseTenantFailed: "워크스페이스 정보 파싱 실패",
|
||||
parseKnowledgeBasesFailed: "지식베이스 목록 파싱 실패",
|
||||
parseCurrentKnowledgeBaseFailed: "현재 지식베이스 파싱 실패",
|
||||
},
|
||||
@@ -2129,7 +2129,7 @@ export default {
|
||||
rerankModel: "리랭크 모델",
|
||||
rerankModelDesc: "지식베이스 검색 결과를 재정렬하여 답변 정확도를 높입니다",
|
||||
rerankModelPlaceholder: "ReRank 모델을 선택하세요.",
|
||||
rerankModelOptionalHint: "현재 범위에 RAG 유형의 지식베이스가 없으므로 선택 사항입니다. 이후 RAG 지식베이스가 추가되면 테넌트 기본 ReRank 모델로 자동 폴백되지만, 명시적으로 설정하는 것을 권장합니다.",
|
||||
rerankModelOptionalHint: "현재 범위에 RAG 유형의 지식베이스가 없으므로 선택 사항입니다. 이후 RAG 지식베이스가 추가되면 워크스페이스 기본 ReRank 모델로 자동 폴백되지만, 명시적으로 설정하는 것을 권장합니다.",
|
||||
maxIterations: "최대 반복 횟수",
|
||||
allowedTools: "허용된 도구",
|
||||
multiTurn: "여러 라운드의 대화",
|
||||
@@ -2250,8 +2250,8 @@ export default {
|
||||
selectFile: "파일 선택",
|
||||
},
|
||||
tenant: {
|
||||
title: "테넌트 정보",
|
||||
currentTenant: "현재 테넌트",
|
||||
title: "워크스페이스 정보",
|
||||
currentTenant: "현재 워크스페이스",
|
||||
switchTenant: "워크스페이스 전환",
|
||||
switcher: {
|
||||
menuLabel: "워크스페이스 전환",
|
||||
@@ -2261,12 +2261,12 @@ export default {
|
||||
empty: "현재 하나의 워크스페이스에만 속해 있습니다",
|
||||
},
|
||||
currentChip: {
|
||||
home: "기본 테넌트",
|
||||
home: "기본 워크스페이스",
|
||||
},
|
||||
sectionDescription: "테넌트의 상세 설정 정보 보기",
|
||||
sectionDescription: "워크스페이스의 상세 설정 정보 보기",
|
||||
apiDocument: "API 문서",
|
||||
name: "테넌트 이름",
|
||||
id: "테넌트 ID",
|
||||
name: "워크스페이스 이름",
|
||||
id: "워크스페이스 ID",
|
||||
createdAt: "생성 시간",
|
||||
updatedAt: "업데이트 시간",
|
||||
status: "상태",
|
||||
@@ -2281,9 +2281,9 @@ export default {
|
||||
userId: "사용자 ID",
|
||||
username: "사용자명",
|
||||
email: "이메일",
|
||||
tenantInfo: "테넌트 정보",
|
||||
tenantId: "테넌트 ID",
|
||||
tenantName: "테넌트 이름",
|
||||
tenantInfo: "워크스페이스 정보",
|
||||
tenantId: "워크스페이스 ID",
|
||||
tenantName: "워크스페이스 이름",
|
||||
description: "설명",
|
||||
business: "비즈니스",
|
||||
noDescription: "설명 없음",
|
||||
@@ -2308,13 +2308,13 @@ export default {
|
||||
apiKeyCopied: "API 키가 클립보드에 복사되었습니다",
|
||||
unknown: "알 수 없음",
|
||||
formatError: "형식 오류",
|
||||
searchPlaceholder: "테넌트 이름 검색 또는 테넌트 ID 입력...",
|
||||
searchHint: "이름으로 검색하거나 테넌트 ID를 직접 입력할 수 있습니다",
|
||||
noMatch: "일치하는 테넌트를 찾을 수 없습니다",
|
||||
searchPlaceholder: "워크스페이스 이름 검색 또는 워크스페이스 ID 입력...",
|
||||
searchHint: "이름으로 검색하거나 워크스페이스 ID를 직접 입력할 수 있습니다",
|
||||
noMatch: "일치하는 워크스페이스를 찾을 수 없습니다",
|
||||
switchSuccessTitle: "공간이 전환되었습니다",
|
||||
switchSuccessContent: "{name} 에 입장했습니다",
|
||||
switchSuccessContentWithRole: "{name} 에 입장했습니다 · 역할 {role}",
|
||||
loadTenantsFailed: "테넌트 목록 로드 실패",
|
||||
loadTenantsFailed: "워크스페이스 목록 로드 실패",
|
||||
loading: "로딩 중...",
|
||||
loadMore: "더 보기",
|
||||
create: {
|
||||
@@ -2333,34 +2333,34 @@ export default {
|
||||
disabled: "현재 시스템에서는 초대를 통해서만 공간에 참여할 수 있으며 직접 만들 수 없습니다.",
|
||||
},
|
||||
details: {
|
||||
idLabel: "테넌트 ID",
|
||||
idDescription: "소속 테넌트의 고유 식별자",
|
||||
nameLabel: "테넌트 이름",
|
||||
nameDescription: "소속 테넌트의 이름",
|
||||
descriptionLabel: "테넌트 설명",
|
||||
descriptionDescription: "테넌트의 상세 설명",
|
||||
businessLabel: "테넌트 비즈니스",
|
||||
businessDescription: "테넌트가 속한 비즈니스 유형",
|
||||
statusLabel: "테넌트 상태",
|
||||
statusDescription: "테넌트의 현재 운영 상태",
|
||||
createdAtLabel: "테넌트 생성 시간",
|
||||
createdAtDescription: "테넌트가 생성된 시간",
|
||||
idLabel: "워크스페이스 ID",
|
||||
idDescription: "소속 워크스페이스의 고유 식별자",
|
||||
nameLabel: "워크스페이스 이름",
|
||||
nameDescription: "소속 워크스페이스의 이름",
|
||||
descriptionLabel: "워크스페이스 설명",
|
||||
descriptionDescription: "워크스페이스의 상세 설명",
|
||||
businessLabel: "워크스페이스 비즈니스",
|
||||
businessDescription: "워크스페이스가 속한 비즈니스 유형",
|
||||
statusLabel: "워크스페이스 상태",
|
||||
statusDescription: "워크스페이스의 현재 운영 상태",
|
||||
createdAtLabel: "워크스페이스 생성 시간",
|
||||
createdAtDescription: "워크스페이스가 생성된 시간",
|
||||
editName: "이름 수정",
|
||||
editNamePlaceholder: "새 테넌트 이름을 입력하세요",
|
||||
editNamePlaceholder: "새 워크스페이스 이름을 입력하세요",
|
||||
editNameConfirm: "저장",
|
||||
editNameCancel: "취소",
|
||||
editNameRequired: "테넌트 이름은 비어 있을 수 없습니다",
|
||||
editNameSuccess: "테넌트 이름이 업데이트되었습니다",
|
||||
editNameFailed: "테넌트 이름 업데이트 실패",
|
||||
editNameRequired: "워크스페이스 이름은 비어 있을 수 없습니다",
|
||||
editNameSuccess: "워크스페이스 이름이 업데이트되었습니다",
|
||||
editNameFailed: "워크스페이스 이름 업데이트 실패",
|
||||
editDescription: "설명 수정",
|
||||
editDescriptionPlaceholder: "새 테넌트 설명을 입력하세요",
|
||||
editDescriptionSuccess: "테넌트 설명이 업데이트되었습니다",
|
||||
editDescriptionFailed: "테넌트 설명 업데이트 실패",
|
||||
editDescriptionPlaceholder: "새 워크스페이스 설명을 입력하세요",
|
||||
editDescriptionSuccess: "워크스페이스 설명이 업데이트되었습니다",
|
||||
editDescriptionFailed: "워크스페이스 설명 업데이트 실패",
|
||||
descriptionEmptyPlaceholder: "미입력",
|
||||
},
|
||||
storage: {
|
||||
quotaLabel: "저장소 할당량",
|
||||
quotaDescription: "테넌트의 총 저장 스페이스 할당량",
|
||||
quotaDescription: "워크스페이스의 총 저장 스페이스 할당량",
|
||||
usedLabel: "사용된 저장소",
|
||||
usedDescription: "이미 사용된 저장 스페이스",
|
||||
usageLabel: "저장소 사용률",
|
||||
@@ -2372,7 +2372,7 @@ export default {
|
||||
button: "스페이스 나가기",
|
||||
},
|
||||
messages: {
|
||||
fetchFailed: "테넌트 정보 가져오기 실패",
|
||||
fetchFailed: "워크스페이스 정보 가져오기 실패",
|
||||
networkError: "네트워크 오류, 나중에 다시 시도해주세요",
|
||||
},
|
||||
api: {
|
||||
@@ -2471,7 +2471,7 @@ export default {
|
||||
},
|
||||
globalSettings: {
|
||||
title: "시스템 설정",
|
||||
description: "플랫폼 전역 런타임 설정입니다. 저장하면 모든 테넌트에 즉시 적용됩니다. 시스템 관리자만 보고 수정할 수 있습니다.",
|
||||
description: "플랫폼 전역 런타임 설정입니다. 저장하면 모든 워크스페이스에 즉시 적용됩니다. 시스템 관리자만 보고 수정할 수 있습니다.",
|
||||
loading: "로딩 중...",
|
||||
empty: "설정 가능한 시스템 항목이 없습니다",
|
||||
autoSaveHint: "변경 내용은 자동으로 저장됩니다",
|
||||
@@ -2503,9 +2503,9 @@ export default {
|
||||
description: "시스템 관리자, 공개 가입, 공간 생성 규칙을 관리합니다.",
|
||||
},
|
||||
tenant: {
|
||||
tab: "테넌트 기본값 {count}",
|
||||
title: "테넌트 기본값",
|
||||
description: "기존 테넌트를 변경하지 않고 신규 테넌트의 초기 할당량과 호환 동작을 설정합니다.",
|
||||
tab: "워크스페이스 기본값 {count}",
|
||||
title: "워크스페이스 기본값",
|
||||
description: "기존 워크스페이스를 변경하지 않고 신규 워크스페이스의 초기 할당량과 호환 동작을 설정합니다.",
|
||||
},
|
||||
runtime: {
|
||||
tab: "런타임 및 동시성 {count}",
|
||||
@@ -2610,7 +2610,7 @@ export default {
|
||||
knowledgeBaseLabel: "지식 베이스 ID",
|
||||
knowledgeLabel: "문서 ID",
|
||||
taskIDLabel: "비즈니스 작업 ID",
|
||||
tenantLabel: "테넌트 ID",
|
||||
tenantLabel: "워크스페이스 ID",
|
||||
sourceLabel: "소스 ID",
|
||||
targetLabel: "대상 ID",
|
||||
sourceKBLabel: "소스 지식 베이스",
|
||||
@@ -2734,10 +2734,10 @@ export default {
|
||||
whitelist: "SSRF 보호 허용 목록",
|
||||
},
|
||||
tenant: {
|
||||
max_owned_per_user: "사용자당 최대 테넌트 수",
|
||||
max_owned_per_user: "사용자당 최대 워크스페이스 수",
|
||||
self_service_creation_enabled: "사용자 공간 직접 생성 허용",
|
||||
default_storage_quota_gb: "신규 테넌트 기본 저장 용량 (GB)",
|
||||
auto_create_api_key: "신규 테넌트 API Key 자동 생성",
|
||||
default_storage_quota_gb: "신규 워크스페이스 기본 저장 용량 (GB)",
|
||||
auto_create_api_key: "신규 워크스페이스 API Key 자동 생성",
|
||||
},
|
||||
asynq: {
|
||||
core_concurrency: "핵심 파싱 보장 동시성",
|
||||
@@ -2764,13 +2764,13 @@ export default {
|
||||
},
|
||||
tenant: {
|
||||
max_owned_per_user:
|
||||
"슈퍼유저가 아닌 사용자가 셀프 서비스로 소유할 수 있는 최대 테넌트 수입니다. 테넌트 생성 시마다 읽으며 저장 즉시 적용됩니다. 0은 내장 기본값 10을 사용하고, 음수는 제한을 완전히 해제합니다(공개 배포에는 권장하지 않음).",
|
||||
"슈퍼유저가 아닌 사용자가 셀프 서비스로 소유할 수 있는 최대 워크스페이스 수입니다. 워크스페이스 생성 시마다 읽으며 저장 즉시 적용됩니다. 0은 내장 기본값 10을 사용하고, 음수는 제한을 완전히 해제합니다(공개 배포에는 권장하지 않음).",
|
||||
self_service_creation_enabled:
|
||||
"비슈퍼유저가 공간을 직접 만들 수 있는지 설정합니다. 비활성화하면 일반 사용자는 초대로만 기존 공간에 참여할 수 있으며, 크로스 테넌트 슈퍼유저는 계속 만들 수 있습니다.",
|
||||
"비슈퍼유저가 공간을 직접 만들 수 있는지 설정합니다. 비활성화하면 일반 사용자는 초대로만 기존 공간에 참여할 수 있으며, 크로스 워크스페이스 슈퍼유저는 계속 만들 수 있습니다.",
|
||||
default_storage_quota_gb:
|
||||
"신규 테넌트 생성 시 기본으로 할당되는 저장 용량(GB)으로, 벡터·원본·텍스트·인덱스 등을 포함합니다. 생성 시에만 읽으며, 변경은 이후 생성되는 테넌트에만 적용되고 기존 테넌트에는 소급되지 않습니다. 0 또는 음수는 내장 기본값 10GB를 사용합니다.",
|
||||
"신규 워크스페이스 생성 시 기본으로 할당되는 저장 용량(GB)으로, 벡터·원본·텍스트·인덱스 등을 포함합니다. 생성 시에만 읽으며, 변경은 이후 생성되는 워크스페이스에만 적용되고 기존 워크스페이스에는 소급되지 않습니다. 0 또는 음수는 내장 기본값 10GB를 사용합니다.",
|
||||
auto_create_api_key:
|
||||
"신규 테넌트에 full_access API Key를 자동 생성하고 생성 응답에 평문 token을 반환합니다. 기존 동작에 의존하는 연동에만 사용하세요. 기본값은 비활성화입니다.",
|
||||
"신규 워크스페이스에 full_access API Key를 자동 생성하고 생성 응답에 평문 token을 반환합니다. 기존 동작에 의존하는 연동에만 사용하세요. 기본값은 비활성화입니다.",
|
||||
},
|
||||
asynq: {
|
||||
core_concurrency: "문서 및 수동 파싱의 프로세스별 보장 동시성입니다. 공유 탄력 풀도 사용할 수 있습니다. 최소 1, 서비스 재시작이 필요합니다.",
|
||||
@@ -2845,7 +2845,7 @@ export default {
|
||||
confirm: {
|
||||
promote: {
|
||||
header: "시스템 관리자로 승격",
|
||||
body: "{email} 사용자를 시스템 관리자로 승격하시겠습니까? 이 사용자는 모든 테넌트 접근, 시스템 설정 변경, 관리자 명단 관리 등 플랫폼 수준의 권한을 갖게 됩니다.",
|
||||
body: "{email} 사용자를 시스템 관리자로 승격하시겠습니까? 이 사용자는 모든 워크스페이스 접근, 시스템 설정 변경, 관리자 명단 관리 등 플랫폼 수준의 권한을 갖게 됩니다.",
|
||||
confirmBtn: "승격 확인",
|
||||
},
|
||||
revoke: {
|
||||
@@ -2882,12 +2882,12 @@ export default {
|
||||
},
|
||||
},
|
||||
bulkApply: {
|
||||
label: "모든 기존 테넌트에 적용",
|
||||
tooltip: "저장한 값은 기본적으로 새로 생성되는 테넌트에만 적용됩니다. 이 버튼을 누르면 현재 값을 모든 기존 테넌트에도 덮어씁니다.",
|
||||
label: "모든 기존 워크스페이스에 적용",
|
||||
tooltip: "저장한 값은 기본적으로 새로 생성되는 워크스페이스에만 적용됩니다. 이 버튼을 누르면 현재 값을 모든 기존 워크스페이스에도 덮어씁니다.",
|
||||
confirmBtn: "적용 확인",
|
||||
confirmBody: "모든 기존 테넌트의 저장 용량을 {value} GB로 덮어씁니다. 운영팀이 개별로 조정한 테넌트의 용량도 함께 덮어쓰여집니다. 계속하시겠습니까?",
|
||||
success: "{count}개 테넌트의 저장 용량을 {gb} GB로 갱신했습니다",
|
||||
failed: "모든 테넌트에 적용 실패",
|
||||
confirmBody: "모든 기존 워크스페이스의 저장 용량을 {value} GB로 덮어씁니다. 운영팀이 개별로 조정한 워크스페이스의 용량도 함께 덮어쓰여집니다. 계속하시겠습니까?",
|
||||
success: "{count}개 워크스페이스의 저장 용량을 {gb} GB로 갱신했습니다",
|
||||
failed: "모든 워크스페이스에 적용 실패",
|
||||
},
|
||||
audit: {
|
||||
tabLabel: "감사 로그",
|
||||
@@ -2930,7 +2930,7 @@ export default {
|
||||
},
|
||||
target: {
|
||||
bulkQuota: "일괄 동기화: 기본 저장 할당량",
|
||||
bulkQuotaDiff: "{count}개 테넌트에 적용됨 ({gb} GB)",
|
||||
bulkQuotaDiff: "{count}개 워크스페이스에 적용됨 ({gb} GB)",
|
||||
promoteIdempotent: "이미 시스템 관리자임 (멱등)",
|
||||
revokeNoop: "원래 시스템 관리자가 아니었음 (멱등)",
|
||||
requiredRole: "필요 역할: {role}",
|
||||
@@ -2984,7 +2984,7 @@ export default {
|
||||
loginFailed: '로그인 실패',
|
||||
registerFailed: '회원가입 실패',
|
||||
getUserFailed: '사용자 정보 조회 실패',
|
||||
getTenantFailed: '테넌트 정보 조회 실패',
|
||||
getTenantFailed: '워크스페이스 정보 조회 실패',
|
||||
updatePreferencesFailed: '개인 설정 업데이트 실패',
|
||||
refreshTokenFailed: '토큰 갱신 실패',
|
||||
logoutFailed: '로그아웃 실패',
|
||||
@@ -2997,12 +2997,12 @@ export default {
|
||||
deleteFailed: '모델 삭제 실패',
|
||||
},
|
||||
tenant: {
|
||||
listFailed: '테넌트 목록 조회 실패',
|
||||
searchFailed: '테넌트 검색 실패',
|
||||
listFailed: '워크스페이스 목록 조회 실패',
|
||||
searchFailed: '워크스페이스 검색 실패',
|
||||
getApiPrincipalConfigFailed: 'API principal config 조회 실패',
|
||||
updateApiPrincipalConfigFailed: 'API principal config 업데이트 실패',
|
||||
createApiPrincipalTestTokenFailed: 'API 테스트 토큰 생성 실패',
|
||||
updateFailed: '테넌트 정보 업데이트 실패',
|
||||
updateFailed: '워크스페이스 정보 업데이트 실패',
|
||||
},
|
||||
initialization: {
|
||||
checkFailed: '검사 실패',
|
||||
@@ -3323,7 +3323,7 @@ export default {
|
||||
multimodalParsing: "멀티모달 문서 파싱",
|
||||
hybridSearchEngine: "하이브리드 검색 + 지식 그래프",
|
||||
ragQandA: "ReAct 에이전트 Q&A",
|
||||
independentTenant: "독립 테넌트 스페이스",
|
||||
independentTenant: "독립 워크스페이스",
|
||||
fullApiAccess: "전체 API 접근",
|
||||
knowledgeBaseManagement: "지식베이스 관리",
|
||||
carousel: {
|
||||
@@ -4718,8 +4718,8 @@ export default {
|
||||
copySuffix: " 사본",
|
||||
builtinModels: {
|
||||
title: "기본 제공 모델",
|
||||
description: "기본 제공 모델은 모든 테넌트에게 표시됩니다. 민감한 정보는 숨겨지며, 편집하거나 삭제할 수 없습니다.",
|
||||
descriptionAdmin: "기본 제공 모델은 모든 테넌트에게 표시됩니다. 시스템 관리자는 구성과 자격 증명을 편집할 수 있으며, 삭제는 배포 구성에서 관리됩니다.",
|
||||
description: "기본 제공 모델은 모든 워크스페이스에게 표시됩니다. 민감한 정보는 숨겨지며, 편집하거나 삭제할 수 없습니다.",
|
||||
descriptionAdmin: "기본 제공 모델은 모든 워크스페이스에게 표시됩니다. 시스템 관리자는 구성과 자격 증명을 편집할 수 있으며, 삭제는 배포 구성에서 관리됩니다.",
|
||||
viewGuide: "기본 제공 모델 관리 가이드 보기",
|
||||
},
|
||||
builtinTag: "기본제공",
|
||||
@@ -4945,11 +4945,11 @@ export default {
|
||||
inviteCodeRefreshed: "초대 코드가 새로 고쳐졌습니다.",
|
||||
inviteCodeRefreshFailed: "초대 코드를 새로 고치지 못했습니다.",
|
||||
rbac: {
|
||||
needTenantAdmin: "테넌트 관리자 권한이 필요합니다",
|
||||
needTenantAdminTip: "이 작업은 현재 테넌트에서 admin 이상 역할이 필요합니다. 테넌트 소유자에게 문의하세요.",
|
||||
cannotCreate: "현재 테넌트 역할이 부족하여 공유 공간을 만들 수 없습니다",
|
||||
cannotJoin: "현재 테넌트 역할이 부족하여 공유 공간에 가입하거나 가입을 신청할 수 없습니다",
|
||||
cannotManage: "현재 테넌트 역할이 부족하여 공유 공간을 관리할 수 없습니다",
|
||||
needTenantAdmin: "워크스페이스 관리자 권한이 필요합니다",
|
||||
needTenantAdminTip: "이 작업은 현재 워크스페이스에서 admin 이상 역할이 필요합니다. 워크스페이스 소유자에게 문의하세요.",
|
||||
cannotCreate: "현재 워크스페이스 역할이 부족하여 공유 공간을 만들 수 없습니다",
|
||||
cannotJoin: "현재 워크스페이스 역할이 부족하여 공유 공간에 가입하거나 가입을 신청할 수 없습니다",
|
||||
cannotManage: "현재 워크스페이스 역할이 부족하여 공유 공간을 관리할 수 없습니다",
|
||||
},
|
||||
join: {
|
||||
title: "스페이스에 참여하기",
|
||||
@@ -5063,7 +5063,7 @@ export default {
|
||||
editTitle: "스페이스 설정",
|
||||
detailTitle: "스페이스 세부정보",
|
||||
myRoleDesc: "이 스페이스에서의 귀하의 역할은 귀하의 권한 범위를 결정합니다.",
|
||||
membersDesc: "스페이스 구성원과 역할을 조회·관리합니다. 각 구성원은 하나의 테넌트를 의미하며, 같은 테넌트의 모든 사용자가 이 스페이스 접근 권한을 공유합니다.",
|
||||
membersDesc: "스페이스 구성원과 역할을 조회·관리합니다. 각 구성원은 하나의 워크스페이스를 의미하며, 같은 워크스페이스의 모든 사용자가 이 스페이스 접근 권한을 공유합니다.",
|
||||
sharedDesc: "이 스페이스에 공유된 모든 지식베이스 보기",
|
||||
noSharedKB: "아직 공유 지식베이스가 없습니다.",
|
||||
noSharedKBTip:
|
||||
@@ -5177,13 +5177,13 @@ export default {
|
||||
button: "회원 추가",
|
||||
dialogTitle: "회원 추가",
|
||||
tip: "추가된 사용자는 즉시 스페이스 구성원이 되며, 스페이스에 공유된 지식베이스에 접근할 수 있습니다.",
|
||||
tipTenant: "구성원의 최소 단위는 테넌트입니다: 한 테넌트가 가입하면 해당 테넌트의 모든 사용자가 이 스페이스 접근 권한을 공유합니다. 아래 결과는 테넌트 기준으로 중복 제거됩니다.",
|
||||
tipTenant: "구성원의 최소 단위는 워크스페이스입니다: 한 워크스페이스가 가입하면 해당 워크스페이스의 모든 사용자가 이 스페이스 접근 권한을 공유합니다. 아래 결과는 워크스페이스 기준으로 중복 제거됩니다.",
|
||||
searchUser: "사용자 선택",
|
||||
searchTenant: "테넌트 선택",
|
||||
searchTenant: "워크스페이스 선택",
|
||||
searchPlaceholder: "검색하려면 사용자 이름이나 이메일을 입력하세요..",
|
||||
searchTenantPlaceholder: "테넌트 이름, 사용자 이름 또는 이메일로 검색...",
|
||||
searchTenantPlaceholder: "워크스페이스 이름, 사용자 이름 또는 이메일로 검색...",
|
||||
searchHint: "검색을 시작하려면 2자 이상 입력하세요.",
|
||||
searchTenantHint: "2자 이상 입력하세요. 결과는 테넌트 기준으로 중복 제거되며 이미 가입한 테넌트는 제외됩니다.",
|
||||
searchTenantHint: "2자 이상 입력하세요. 결과는 워크스페이스 기준으로 중복 제거되며 이미 가입한 워크스페이스는 제외됩니다.",
|
||||
selectRole: "역할 할당",
|
||||
confirmBtn: "추가",
|
||||
success: "회원이 추가되었습니다.",
|
||||
@@ -5338,7 +5338,7 @@ export default {
|
||||
loading: "벡터 스토어 목록을 불러오는 중...",
|
||||
engineLabel: "벡터 스토어",
|
||||
engineDesc:
|
||||
"전역 벡터 스토어 설정에서 등록한 스토어를 선택하거나, '시스템 기본값'을 유지하면 테넌트의 RETRIEVE_DRIVER 엔진을 사용합니다.",
|
||||
"전역 벡터 스토어 설정에서 등록한 스토어를 선택하거나, '시스템 기본값'을 유지하면 워크스페이스의 RETRIEVE_DRIVER 엔진을 사용합니다.",
|
||||
boundLabel: "바인딩된 벡터 스토어",
|
||||
systemDefault: "시스템 기본값",
|
||||
immutableHint:
|
||||
@@ -6179,7 +6179,7 @@ export default {
|
||||
save: "저장",
|
||||
baseUrl: "API Base URL",
|
||||
baseUrlDesc: "REST API 경로와 함께 사용하세요.",
|
||||
apiKey: "테넌트 API Key",
|
||||
apiKey: "워크스페이스 API Key",
|
||||
apiKeyDesc: "통합용 API Key를 권한 및 지식베이스 범위와 함께 생성하세요.",
|
||||
apiKeys: "API Keys",
|
||||
apiKeysDesc: "통합마다 별도 Key를 만들고 작업 권한 및 접근 가능한 지식베이스 범위를 제한합니다.",
|
||||
@@ -6195,28 +6195,28 @@ export default {
|
||||
apiKeyScopedAccess: "범위 지정 접근",
|
||||
apiKeyAccessRole: "접근 역할",
|
||||
apiKeyAccessType: "접근 유형",
|
||||
apiKeyAccessTypeHint: "\"지식베이스\"는 아래 권한 수준에 따라 지식베이스 범위 내에서 작동합니다. \"테넌트 전체 접근\"은 모델, 데이터 소스 등 모든 테넌트 수준 API를 추가로 사용할 수 있습니다.",
|
||||
apiKeyAccessTypeHint: "\"지식베이스\"는 아래 권한 수준에 따라 지식베이스 범위 내에서 작동합니다. \"워크스페이스 전체 접근\"은 모델, 데이터 소스 등 모든 워크스페이스 수준 API를 추가로 사용할 수 있습니다.",
|
||||
accessTypeKnowledgeBase: "지식베이스",
|
||||
accessTypeTenantFull: "테넌트 전체 접근",
|
||||
accessTypeTenantFull: "워크스페이스 전체 접근",
|
||||
apiKeyPermissionLevel: "권한 수준",
|
||||
apiKeyAccessRoleHint: "앞의 세 역할은 지식베이스 범위 내 작업으로 제한되며, \"테넌트 전체 접근\"은 모델, 데이터 소스 등 테넌트 수준 API도 추가로 사용할 수 있습니다.",
|
||||
apiKeyAccessRoleHint: "앞의 세 역할은 지식베이스 범위 내 작업으로 제한되며, \"워크스페이스 전체 접근\"은 모델, 데이터 소스 등 워크스페이스 수준 API도 추가로 사용할 수 있습니다.",
|
||||
accessRoleViewer: "지식베이스 읽기",
|
||||
accessRoleContributor: "지식베이스 읽기·쓰기",
|
||||
accessRoleAdmin: "지식베이스 관리자",
|
||||
accessRoleOwner: "테넌트 전체 접근",
|
||||
accessRoleOwner: "워크스페이스 전체 접근",
|
||||
accessRoleViewerDesc: "조회, 검색 및 대화만 가능하며 지식베이스 내용은 수정하지 않습니다.",
|
||||
accessRoleContributorDesc: "선택한 범위 내에서 지식베이스 콘텐츠를 생성, 수정 또는 삭제합니다.",
|
||||
accessRoleAdminDesc: "선택한 범위 내에서 지식베이스를 관리하며, 지식베이스 비우기 등 파괴적 작업을 포함합니다. 테넌트 수준 설정은 다루지 않습니다.",
|
||||
accessRoleOwnerDesc: "전체 접근, 테넌트 소유자와 동일: 모델, 벡터 스토어, 데이터 소스, 채널 등 모든 테넌트 수준 API를 호출할 수 있으며 지식베이스 범위의 제한을 받지 않습니다.",
|
||||
accessRoleAdminDesc: "선택한 범위 내에서 지식베이스를 관리하며, 지식베이스 비우기 등 파괴적 작업을 포함합니다. 워크스페이스 수준 설정은 다루지 않습니다.",
|
||||
accessRoleOwnerDesc: "전체 접근, 워크스페이스 소유자와 동일: 모델, 벡터 스토어, 데이터 소스, 채널 등 모든 워크스페이스 수준 API를 호출할 수 있으며 지식베이스 범위의 제한을 받지 않습니다.",
|
||||
apiKeyCapabilities: "사용 가능 기능",
|
||||
apiKeyCapabilityGroupKnowledge: "지식베이스 데이터",
|
||||
apiKeyCapabilityGroupAutomation: "에이전트 및 통합",
|
||||
apiKeyCapabilityGroupCollaboration: "멤버 및 공간",
|
||||
apiKeyCapabilityGroupTenant: "테넌트 설정",
|
||||
apiKeyCapabilityGroupTenant: "워크스페이스 설정",
|
||||
apiKeyCapabilitySelectGroup: "전체 선택",
|
||||
apiKeyCapabilityClearGroup: "비우기",
|
||||
capabilityTenantFull: "테넌트 전체 접근",
|
||||
capabilityTenantFullHint: "모델, 벡터 스토어, 데이터 소스, 채널 등 모든 테넌트 수준 API를 허용합니다. 지식베이스 범위는 적용되지 않습니다.",
|
||||
capabilityTenantFull: "워크스페이스 전체 접근",
|
||||
capabilityTenantFullHint: "모델, 벡터 스토어, 데이터 소스, 채널 등 모든 워크스페이스 수준 API를 허용합니다. 지식베이스 범위는 적용되지 않습니다.",
|
||||
capabilityRetrieve: "지식베이스 검색",
|
||||
capabilityRetrieveHint: "선택한 지식베이스 범위 내 데이터를 읽고 조회하고 검색할 수 있습니다. 세션을 만들거나 콘텐츠를 수정하지 않습니다.",
|
||||
capabilityChat: "대화 기능",
|
||||
@@ -6230,7 +6230,7 @@ export default {
|
||||
capabilityManageAgents: "에이전트 관리",
|
||||
capabilityManageAgentsHint: "에이전트를 생성, 수정, 삭제, 복사할 수 있습니다. 에이전트 설정에는 모델/MCP 등 민감한 바인딩이 포함될 수 있으므로 기본적으로 꺼져 있으며 필요할 때만 켜세요.",
|
||||
capabilityMessageHistory: "메시지 기록",
|
||||
capabilityMessageHistoryHint: "테넌트 채팅 기록 검색과 채팅 기록 통계 조회를 허용합니다. 테넌트 설정 권한은 부여하지 않습니다.",
|
||||
capabilityMessageHistoryHint: "워크스페이스 채팅 기록 검색과 채팅 기록 통계 조회를 허용합니다. 워크스페이스 설정 권한은 부여하지 않습니다.",
|
||||
capabilityManageModels: "모델 관리",
|
||||
capabilityManageModelsHint: "모델 설정, 자격 증명, 연결 테스트 및 WeKnoraCloud 자격 증명을 관리합니다.",
|
||||
capabilityManageMcpServices: "MCP 서비스 관리",
|
||||
@@ -6246,11 +6246,11 @@ export default {
|
||||
capabilityRunEvaluations: "평가 실행",
|
||||
capabilityRunEvaluationsHint: "평가 작업을 실행하고 결과를 읽을 수 있습니다.",
|
||||
capabilityManageMembers: "멤버 관리",
|
||||
capabilityManageMembersHint: "테넌트 멤버, 역할, 초대 및 초대 링크를 조회하고 관리할 수 있습니다. API Key 관리, 테넌트 삭제 또는 소유권 이전은 포함하지 않습니다.",
|
||||
capabilityManageMembersHint: "워크스페이스 멤버, 역할, 초대 및 초대 링크를 조회하고 관리할 수 있습니다. API Key 관리, 워크스페이스 삭제 또는 소유권 이전은 포함하지 않습니다.",
|
||||
capabilityManageSpaces: "공간 관리",
|
||||
capabilityManageSpacesHint: "조직/공간, 가입 흐름, 공간 멤버, 초대 및 공유 공간 표시를 관리할 수 있습니다. 지식베이스 또는 에이전트 공유 관리는 부여하지 않습니다.",
|
||||
capabilityManageTenantSettings: "테넌트 설정 관리",
|
||||
capabilityManageTenantSettingsHint: "API 최종 사용자 식별 모드, 요청 헤더 설정, 테넌트 KV 설정 등 테넌트 수준 통합 설정을 읽고 업데이트합니다. API Key 관리, 멤버 관리, 테넌트 삭제 또는 소유권 이전은 포함하지 않습니다.",
|
||||
capabilityManageTenantSettings: "워크스페이스 설정 관리",
|
||||
capabilityManageTenantSettingsHint: "API 최종 사용자 식별 모드, 요청 헤더 설정, 워크스페이스 KV 설정 등 워크스페이스 수준 통합 설정을 읽고 업데이트합니다. API Key 관리, 멤버 관리, 워크스페이스 삭제 또는 소유권 이전은 포함하지 않습니다.",
|
||||
apiKeyKnowledgeScope: "지식베이스 범위",
|
||||
apiKeyKnowledgeScopePlaceholder: "비워 두면 모든 지식베이스 접근 허용",
|
||||
apiKeyKnowledgeScopeOwnerHint: "전체 접근 키는 지식베이스 범위로 제한되지 않습니다.",
|
||||
@@ -6267,10 +6267,10 @@ export default {
|
||||
apiKeyCreatedDesc: "API Key가 생성되었습니다. 목록에서 확인하거나 복사할 수 있습니다.",
|
||||
principalMode: "사용자 ID 모드",
|
||||
principalModeDesc:
|
||||
"API 요청이 최종 사용자를 어떻게 식별할지 설정합니다. 이 신원은 대화 Session과 MCP 도구 인증을 사용자별로 구분하며, API Key의 테넌트 관리자 권한은 바뀌지 않습니다.",
|
||||
"API 요청이 최종 사용자를 어떻게 식별할지 설정합니다. 이 신원은 대화 Session과 MCP 도구 인증을 사용자별로 구분하며, API Key의 워크스페이스 관리자 권한은 바뀌지 않습니다.",
|
||||
principalScope:
|
||||
"최종 사용자별로 대화 Session과 MCP 도구 인증(OAuth)을 구분합니다. API Key는 여전히 테넌트 내 모든 지식베이스에 접근할 수 있으며, API 권한 범위는 외부 사용자별로 나뉘지 않습니다.",
|
||||
modeTenant: "테넌트만",
|
||||
"최종 사용자별로 대화 Session과 MCP 도구 인증(OAuth)을 구분합니다. API Key는 여전히 워크스페이스 내 모든 지식베이스에 접근할 수 있으며, API 권한 범위는 외부 사용자별로 나뉘지 않습니다.",
|
||||
modeTenant: "워크스페이스만",
|
||||
modeDirect: "사용자 ID 직접 전달",
|
||||
modeSigned: "서명 토큰",
|
||||
directWarning: "직접 사용자 ID 모드는 요청 헤더를 신뢰합니다. 신뢰된 서버 간 호출에만 사용하세요.",
|
||||
@@ -6282,7 +6282,7 @@ export default {
|
||||
directHeader: "사용자 ID 헤더",
|
||||
requireDirectHeader: "사용자 ID 헤더 필수",
|
||||
requireDirectHeaderDesc:
|
||||
"켜면 사용자 ID 헤더가 없는 API Key 요청을 거부하고, 끄면 테넌트 전체로 통일 처리하며 개별 사용자를 구분하지 않습니다.",
|
||||
"켜면 사용자 ID 헤더가 없는 API Key 요청을 거부하고, 끄면 워크스페이스 전체로 통일 처리하며 개별 사용자를 구분하지 않습니다.",
|
||||
tokenHeader: "토큰 헤더",
|
||||
tokenHeaderDesc: "클라이언트는 이 고정 헤더에 백엔드가 서명한 JWT를 전달합니다.",
|
||||
hmacSecret: "HMAC secret",
|
||||
@@ -6316,7 +6316,7 @@ export default {
|
||||
playgroundAgentsLoadFailed: "Agent 목록을 불러오지 못했습니다",
|
||||
playgroundExternalUser: "외부 사용자 ID",
|
||||
playgroundExternalUserPlaceholder: "user_123",
|
||||
playgroundTenantModeHint: "테넌트 전용 모드는 외부 사용자 ID를 보내지 않으며 모든 API 세션이 동일한 테넌트 주체에 속합니다.",
|
||||
playgroundTenantModeHint: "워크스페이스 전용 모드는 외부 사용자 ID를 보내지 않으며 모든 API 세션이 동일한 워크스페이스 주체에 속합니다.",
|
||||
playgroundDirectModeHint: "{headerName} 헤더로 이 사용자 ID를 보냅니다.",
|
||||
playgroundSignedModeHint: "서명 토큰 모드는 JWT sub를 외부 사용자로 사용합니다. Playground가 이 사용자 ID로 단기 테스트 JWT를 자동 서명합니다.",
|
||||
playgroundQuestion: "테스트 질문",
|
||||
@@ -6324,7 +6324,7 @@ export default {
|
||||
playgroundRequestPreview: "요청 미리보기(secret 마스킹됨)",
|
||||
playgroundRun: "테스트 실행",
|
||||
playgroundStop: "중지",
|
||||
playgroundNeedApiKey: "현재 테넌트에 API Key가 없습니다.",
|
||||
playgroundNeedApiKey: "현재 워크스페이스에 API Key가 없습니다.",
|
||||
playgroundNeedAgent: "테스트 Agent를 선택하세요.",
|
||||
playgroundNeedQuestion: "테스트 질문을 입력하세요.",
|
||||
playgroundNeedExternalUser: "외부 사용자 ID를 입력하세요.",
|
||||
@@ -6465,9 +6465,9 @@ export default {
|
||||
imOverview: {
|
||||
menuTitle: "연결된 IM",
|
||||
pageTitle: "연결된 IM",
|
||||
subtitle: "이 테넌트의 에이전트에 연결된 모든 IM 채널 — 활성화/비활성화 전환 또는 해당 에이전트로 이동",
|
||||
subtitle: "이 워크스페이스의 에이전트에 연결된 모든 IM 채널 — 활성화/비활성화 전환 또는 해당 에이전트로 이동",
|
||||
totalCount: "총 {count}개",
|
||||
empty: "이 테넌트에 구성된 IM 봇이 없습니다",
|
||||
empty: "이 워크스페이스에 구성된 IM 봇이 없습니다",
|
||||
loadFailed: "IM 봇 목록을 불러오지 못했습니다",
|
||||
builtinAgent: "내장 에이전트",
|
||||
liveIndicator: "활성화된 IM 채널이 실행 중입니다",
|
||||
@@ -6510,7 +6510,7 @@ export default {
|
||||
},
|
||||
tenantMember: {
|
||||
title: "멤버 관리",
|
||||
sectionDescription: "테넌트에 동료를 초대하고 역할을 관리합니다. 소유자만 멤버를 추가하거나 제거할 수 있습니다.",
|
||||
sectionDescription: "워크스페이스에 동료를 초대하고 역할을 관리합니다. 소유자만 멤버를 추가하거나 제거할 수 있습니다.",
|
||||
learnRbacGuide: "RBAC 알아보기",
|
||||
totalCount: "총 {n}명",
|
||||
listTitle: "워크스페이스 멤버",
|
||||
@@ -6522,13 +6522,13 @@ export default {
|
||||
searchPlaceholder: "이름 또는 이메일로 검색",
|
||||
permissions: {
|
||||
title: "역할 권한",
|
||||
desc: "각 역할이 이 테넌트에서 할 수 있는 작업입니다. 서버에서 적용되며 UI 컨트롤은 표시만 합니다.",
|
||||
desc: "각 역할이 이 워크스페이스에서 할 수 있는 작업입니다. 서버에서 적용되며 UI 컨트롤은 표시만 합니다.",
|
||||
iconHint: "역할 권한 안내를 보려면 마우스를 올리세요",
|
||||
manageMembers: "멤버 관리",
|
||||
manageTenantConfig: "테넌트 설정 변경",
|
||||
manageTenantConfig: "워크스페이스 설정 변경",
|
||||
manageInfra: "모델 / 벡터 저장소 / IM 채널 구성",
|
||||
createOwnKB: "내 지식 베이스 및 에이전트 생성/편집",
|
||||
readAll: "테넌트 콘텐츠 조회",
|
||||
readAll: "워크스페이스 콘텐츠 조회",
|
||||
},
|
||||
columns: {
|
||||
member: "이름 · 이메일",
|
||||
@@ -6556,16 +6556,16 @@ export default {
|
||||
remove: {
|
||||
button: "제거",
|
||||
confirmTitle: "멤버를 제거하시겠어요?",
|
||||
confirmBody: "{name} 님을 이 테넌트에서 제거하시겠어요? 즉시 접근 권한이 해제됩니다.",
|
||||
confirmBody: "{name} 님을 이 워크스페이스에서 제거하시겠어요? 즉시 접근 권한이 해제됩니다.",
|
||||
confirm: "제거",
|
||||
success: "멤버를 제거했습니다",
|
||||
},
|
||||
leave: {
|
||||
button: "테넌트 떠나기",
|
||||
confirmTitle: "이 테넌트에서 나가시겠어요?",
|
||||
confirmBody: "이 테넌트의 모든 지식 베이스와 에이전트에 접근할 수 없게 됩니다. 나중에 다시 초대받을 수 있습니다.",
|
||||
button: "워크스페이스 떠나기",
|
||||
confirmTitle: "이 워크스페이스에서 나가시겠어요?",
|
||||
confirmBody: "이 워크스페이스의 모든 지식 베이스와 에이전트에 접근할 수 없게 됩니다. 나중에 다시 초대받을 수 있습니다.",
|
||||
confirm: "나가기",
|
||||
success: "테넌트에서 나갔습니다",
|
||||
success: "워크스페이스에서 나갔습니다",
|
||||
},
|
||||
roleChange: {
|
||||
success: "역할이 업데이트되었습니다",
|
||||
@@ -6575,10 +6575,10 @@ export default {
|
||||
emailFormat: "올바른 이메일 형식이 아닙니다",
|
||||
roleRequired: "역할을 선택하세요",
|
||||
userNotFound: "해당 이메일로 가입된 사용자가 없습니다. 먼저 가입을 요청하세요.",
|
||||
alreadyMember: "이미 이 테넌트의 멤버입니다.",
|
||||
alreadyMember: "이미 이 워크스페이스의 멤버입니다.",
|
||||
lastOwner: "마지막 소유자를 강등, 제거, 또는 떠날 수 없습니다. 다른 멤버를 먼저 소유자로 승격하세요.",
|
||||
notFound: "멤버를 찾을 수 없습니다.",
|
||||
noTenant: "활성 테넌트가 없습니다.",
|
||||
noTenant: "활성 워크스페이스가 없습니다.",
|
||||
invalidRole: "역할은 owner / admin / contributor / viewer 중 하나여야 합니다.",
|
||||
generic: "오류가 발생했습니다. 다시 시도해 주세요.",
|
||||
},
|
||||
@@ -6589,7 +6589,7 @@ export default {
|
||||
audit: {
|
||||
tabLabel: "감사 로그",
|
||||
description:
|
||||
"이 테넌트의 멤버 변경 및 접근 거부 이벤트를 최신순으로 기록합니다. 1분 이내의 반복 거부는 자동으로 중복 제거됩니다.",
|
||||
"이 워크스페이스의 멤버 변경 및 접근 거부 이벤트를 최신순으로 기록합니다. 1분 이내의 반복 거부는 자동으로 중복 제거됩니다.",
|
||||
refresh: "새로고침",
|
||||
loadMore: "이전 항목 더 보기",
|
||||
end: "마지막 항목입니다.",
|
||||
|
||||
+111
-111
@@ -164,7 +164,7 @@ export default {
|
||||
},
|
||||
storage: {
|
||||
title: 'Хранилище (необязательно)',
|
||||
desc: 'Где хранятся исходные файлы (локально или объектное хранилище). Обычно достаточно значения арендатора.',
|
||||
desc: 'Где хранятся исходные файлы (локально или объектное хранилище). Обычно достаточно значения пространства.',
|
||||
},
|
||||
navMultimodal: {
|
||||
title: 'Мультимодальность / изображения (необязательно)',
|
||||
@@ -915,7 +915,7 @@ export default {
|
||||
rerankModel: 'ReRank Model',
|
||||
rerankModelDesc: 'Used to rerank knowledge base retrieval results for better accuracy',
|
||||
rerankModelPlaceholder: 'Select ReRank Model',
|
||||
rerankModelOptionalHint: 'В текущей области нет RAG-базы знаний, поэтому поле необязательное. Если RAG-база будет добавлена позже, будет использоваться модель ReRank по умолчанию для тенанта; всё же рекомендуется настроить её явно.',
|
||||
rerankModelOptionalHint: 'В текущей области нет RAG-базы знаний, поэтому поле необязательное. Если RAG-база будет добавлена позже, будет использоваться модель ReRank по умолчанию для пространства; всё же рекомендуется настроить её явно.',
|
||||
maxIterations: 'Max Iterations',
|
||||
allowedTools: 'Allowed Tools',
|
||||
multiTurn: 'Multi-turn Conversation',
|
||||
@@ -1130,7 +1130,7 @@ export default {
|
||||
conversationStrategy: 'Стратегия диалога',
|
||||
versionInfo: 'Информация о версии',
|
||||
taskQueue: 'Очереди задач',
|
||||
tenantInfo: 'Информация о арендаторе',
|
||||
tenantInfo: 'Информация о пространстве',
|
||||
apiInfo: 'Информация API',
|
||||
navGroups: {
|
||||
account: 'Аккаунт',
|
||||
@@ -1142,7 +1142,7 @@ export default {
|
||||
},
|
||||
roleDenied: {
|
||||
title: 'Недостаточно прав',
|
||||
desc: 'Ваша роль не позволяет открыть этот раздел настроек. Обратитесь к администратору арендатора, чтобы запросить нужную роль.',
|
||||
desc: 'Ваша роль не позволяет открыть этот раздел настроек. Обратитесь к администратору пространства, чтобы запросить нужную роль.',
|
||||
},
|
||||
weknoraCloud: {
|
||||
title: 'WeKnora Cloud',
|
||||
@@ -1860,7 +1860,7 @@ export default {
|
||||
authStore: {
|
||||
errors: {
|
||||
parseUserFailed: 'Не удалось разобрать данные пользователя',
|
||||
parseTenantFailed: 'Не удалось разобрать данные арендатора',
|
||||
parseTenantFailed: 'Не удалось разобрать данные пространства',
|
||||
parseKnowledgeBasesFailed: 'Не удалось разобрать список баз знаний',
|
||||
parseCurrentKnowledgeBaseFailed: 'Не удалось разобрать текущую базу знаний'
|
||||
}
|
||||
@@ -1948,8 +1948,8 @@ export default {
|
||||
selectFile: 'Выберите файл'
|
||||
},
|
||||
tenant: {
|
||||
title: 'Информация об арендаторе',
|
||||
currentTenant: 'Текущий арендатор',
|
||||
title: 'Информация о пространстве',
|
||||
currentTenant: 'Текущее пространство',
|
||||
switchTenant: 'Переключить рабочее пространство',
|
||||
switcher: {
|
||||
menuLabel: 'Переключить рабочее пространство',
|
||||
@@ -1959,12 +1959,12 @@ export default {
|
||||
empty: 'Вы состоите только в одном рабочем пространстве',
|
||||
},
|
||||
currentChip: {
|
||||
home: 'Основной арендатор',
|
||||
home: 'Основное пространство',
|
||||
},
|
||||
sectionDescription: 'Просмотр детальной конфигурации арендатора',
|
||||
sectionDescription: 'Просмотр детальной конфигурации пространства',
|
||||
apiDocument: 'Документация API',
|
||||
name: 'Имя арендатора',
|
||||
id: 'ID арендатора',
|
||||
name: 'Имя пространства',
|
||||
id: 'ID пространства',
|
||||
createdAt: 'Дата создания',
|
||||
updatedAt: 'Дата обновления',
|
||||
status: 'Статус',
|
||||
@@ -1979,9 +1979,9 @@ export default {
|
||||
userId: 'ID пользователя',
|
||||
username: 'Имя пользователя',
|
||||
email: 'Электронная почта',
|
||||
tenantInfo: 'Информация об арендаторе',
|
||||
tenantId: 'ID арендатора',
|
||||
tenantName: 'Название арендатора',
|
||||
tenantInfo: 'Информация о пространстве',
|
||||
tenantId: 'ID пространства',
|
||||
tenantName: 'Название пространства',
|
||||
description: 'Описание',
|
||||
business: 'Бизнес',
|
||||
noDescription: 'Нет описания',
|
||||
@@ -2006,13 +2006,13 @@ export default {
|
||||
apiKeyCopied: 'API Key скопирован в буфер обмена',
|
||||
unknown: 'Неизвестно',
|
||||
formatError: 'Ошибка формата',
|
||||
searchPlaceholder: 'Поиск по имени или введите ID арендатора...',
|
||||
searchHint: 'Поиск по имени или введите ID арендатора напрямую',
|
||||
noMatch: 'Не найдено подходящих арендаторов',
|
||||
searchPlaceholder: 'Поиск по имени или введите ID пространства...',
|
||||
searchHint: 'Поиск по имени или введите ID пространства напрямую',
|
||||
noMatch: 'Не найдено подходящих пространств',
|
||||
switchSuccessTitle: 'Пространство переключено',
|
||||
switchSuccessContent: 'Вы вошли в {name}',
|
||||
switchSuccessContentWithRole: 'Вы вошли в {name} · роль {role}',
|
||||
loadTenantsFailed: 'Не удалось загрузить список арендаторов',
|
||||
loadTenantsFailed: 'Не удалось загрузить список пространств',
|
||||
loading: 'Загрузка...',
|
||||
loadMore: 'Загрузить еще',
|
||||
create: {
|
||||
@@ -2031,34 +2031,34 @@ export default {
|
||||
disabled: 'В этой системе присоединиться к пространству можно только по приглашению; создать его самостоятельно нельзя.',
|
||||
},
|
||||
details: {
|
||||
idLabel: 'ID арендатора',
|
||||
idDescription: 'Уникальный идентификатор вашего арендатора',
|
||||
nameLabel: 'Название арендатора',
|
||||
nameDescription: 'Название арендатора, к которому вы принадлежите',
|
||||
descriptionLabel: 'Описание арендатора',
|
||||
descriptionDescription: 'Подробное описание арендатора',
|
||||
businessLabel: 'Бизнес арендатора',
|
||||
businessDescription: 'Бизнес-направление, к которому относится арендатор',
|
||||
statusLabel: 'Статус арендатора',
|
||||
statusDescription: 'Текущий рабочий статус арендатора',
|
||||
createdAtLabel: 'Время создания арендатора',
|
||||
createdAtDescription: 'Дата и время создания арендатора',
|
||||
idLabel: 'ID пространства',
|
||||
idDescription: 'Уникальный идентификатор вашего пространства',
|
||||
nameLabel: 'Название пространства',
|
||||
nameDescription: 'Название пространства, к которому вы принадлежите',
|
||||
descriptionLabel: 'Описание пространства',
|
||||
descriptionDescription: 'Подробное описание пространства',
|
||||
businessLabel: 'Бизнес пространства',
|
||||
businessDescription: 'Бизнес-направление, к которому относится пространство',
|
||||
statusLabel: 'Статус пространства',
|
||||
statusDescription: 'Текущий рабочий статус пространства',
|
||||
createdAtLabel: 'Время создания пространства',
|
||||
createdAtDescription: 'Дата и время создания пространства',
|
||||
editName: 'Изменить имя',
|
||||
editNamePlaceholder: 'Введите новое имя арендатора',
|
||||
editNamePlaceholder: 'Введите новое имя пространства',
|
||||
editNameConfirm: 'Сохранить',
|
||||
editNameCancel: 'Отмена',
|
||||
editNameRequired: 'Имя арендатора не может быть пустым',
|
||||
editNameSuccess: 'Имя арендатора обновлено',
|
||||
editNameFailed: 'Не удалось обновить имя арендатора',
|
||||
editNameRequired: 'Имя пространства не может быть пустым',
|
||||
editNameSuccess: 'Имя пространства обновлено',
|
||||
editNameFailed: 'Не удалось обновить имя пространства',
|
||||
editDescription: 'Изменить описание',
|
||||
editDescriptionPlaceholder: 'Введите новое описание арендатора',
|
||||
editDescriptionSuccess: 'Описание арендатора обновлено',
|
||||
editDescriptionFailed: 'Не удалось обновить описание арендатора',
|
||||
editDescriptionPlaceholder: 'Введите новое описание пространства',
|
||||
editDescriptionSuccess: 'Описание пространства обновлено',
|
||||
editDescriptionFailed: 'Не удалось обновить описание пространства',
|
||||
descriptionEmptyPlaceholder: 'Не указано'
|
||||
},
|
||||
storage: {
|
||||
quotaLabel: 'Квота хранения',
|
||||
quotaDescription: 'Общий объём хранилища, выделенный арендатору',
|
||||
quotaDescription: 'Общий объём хранилища, выделенный пространству',
|
||||
usedLabel: 'Использовано хранения',
|
||||
usedDescription: 'Объём уже использованного пространства',
|
||||
usageLabel: 'Использование хранения',
|
||||
@@ -2070,7 +2070,7 @@ export default {
|
||||
button: 'Покинуть пространство',
|
||||
},
|
||||
messages: {
|
||||
fetchFailed: 'Не удалось получить информацию об арендаторе',
|
||||
fetchFailed: 'Не удалось получить информацию о пространстве',
|
||||
networkError: 'Ошибка сети, попробуйте позже'
|
||||
},
|
||||
api: {
|
||||
@@ -2168,7 +2168,7 @@ export default {
|
||||
},
|
||||
globalSettings: {
|
||||
title: 'Системные настройки',
|
||||
description: 'Настройки платформы, применяемые в режиме реального времени. Изменения сразу действуют для всех тенантов. Доступны только системным администраторам.',
|
||||
description: 'Настройки платформы, применяемые в режиме реального времени. Изменения сразу действуют для всех пространств. Доступны только системным администраторам.',
|
||||
loading: 'Загрузка...',
|
||||
empty: 'Нет доступных для настройки параметров',
|
||||
autoSaveHint: 'Изменения сохраняются автоматически',
|
||||
@@ -2200,9 +2200,9 @@ export default {
|
||||
description: 'Системные администраторы, открытая регистрация и правила создания пространств.',
|
||||
},
|
||||
tenant: {
|
||||
tab: 'Значения тенанта {count}',
|
||||
title: 'Значения тенанта по умолчанию',
|
||||
description: 'Начальные квоты и режимы совместимости для новых тенантов.',
|
||||
tab: 'Значения пространства {count}',
|
||||
title: 'Значения пространства по умолчанию',
|
||||
description: 'Начальные квоты и режимы совместимости для новых пространств.',
|
||||
},
|
||||
runtime: {
|
||||
tab: 'Среда и параллелизм {count}',
|
||||
@@ -2307,7 +2307,7 @@ export default {
|
||||
knowledgeBaseLabel: "ID базы знаний",
|
||||
knowledgeLabel: "ID документа",
|
||||
taskIDLabel: "ID бизнес-задачи",
|
||||
tenantLabel: "ID тенанта",
|
||||
tenantLabel: "ID пространства",
|
||||
sourceLabel: "ID источника",
|
||||
targetLabel: "ID цели",
|
||||
sourceKBLabel: "Исходная база знаний",
|
||||
@@ -2431,10 +2431,10 @@ export default {
|
||||
whitelist: 'Белый список SSRF-защиты',
|
||||
},
|
||||
tenant: {
|
||||
max_owned_per_user: 'Максимум тенантов на пользователя',
|
||||
max_owned_per_user: 'Максимум пространств на пользователя',
|
||||
self_service_creation_enabled: 'Разрешить самостоятельное создание пространств',
|
||||
default_storage_quota_gb: 'Квота хранилища для новых тенантов по умолчанию (ГБ)',
|
||||
auto_create_api_key: 'Автоматически создавать API-ключ для новых тенантов',
|
||||
default_storage_quota_gb: 'Квота хранилища для новых пространств по умолчанию (ГБ)',
|
||||
auto_create_api_key: 'Автоматически создавать API-ключ для новых пространств',
|
||||
},
|
||||
asynq: {
|
||||
core_concurrency: 'Гарантированный параллелизм разбора',
|
||||
@@ -2461,13 +2461,13 @@ export default {
|
||||
},
|
||||
tenant: {
|
||||
max_owned_per_user:
|
||||
'Максимальное число тенантов, которыми может владеть обычный (не супер) пользователь через самостоятельное создание. Читается при каждом создании тенанта и вступает в силу сразу после сохранения. 0 — встроенное значение по умолчанию 10; отрицательное значение полностью снимает ограничение (не рекомендуется для публичных развёртываний).',
|
||||
'Максимальное число пространств, которыми может владеть обычный (не супер) пользователь через самостоятельное создание. Читается при каждом создании пространства и вступает в силу сразу после сохранения. 0 — встроенное значение по умолчанию 10; отрицательное значение полностью снимает ограничение (не рекомендуется для публичных развёртываний).',
|
||||
self_service_creation_enabled:
|
||||
'Разрешает обычным пользователям самостоятельно создавать пространства. Если отключено, они могут только присоединяться по приглашению; межтенантные суперпользователи не ограничены.',
|
||||
'Разрешает обычным пользователям самостоятельно создавать пространства. Если отключено, они могут только присоединяться по приглашению; межпространственные суперпользователи не ограничены.',
|
||||
default_storage_quota_gb:
|
||||
'Квота хранилища по умолчанию (ГБ) для нового тенанта: векторы, оригиналы, текст, индексы и т.д. Читается только при создании — изменения применяются только к новым тенантам и не перезаписывают существующие. 0 или отрицательное значение — встроенное значение по умолчанию 10 ГБ.',
|
||||
'Квота хранилища по умолчанию (ГБ) для нового пространства: векторы, оригиналы, текст, индексы и т.д. Читается только при создании — изменения применяются только к новым пространствам и не перезаписывают существующие. 0 или отрицательное значение — встроенное значение по умолчанию 10 ГБ.',
|
||||
auto_create_api_key:
|
||||
'Автоматически создаёт API-ключ full_access и возвращает его открытый токен при создании тенанта. Включайте только для старых интеграций; по умолчанию отключено.',
|
||||
'Автоматически создаёт API-ключ full_access и возвращает его открытый токен при создании пространства. Включайте только для старых интеграций; по умолчанию отключено.',
|
||||
},
|
||||
asynq: {
|
||||
core_concurrency: 'Гарантированный параллелизм разбора документов на процесс; также может использовать общий эластичный пул. Минимум 1; требуется перезапуск.',
|
||||
@@ -2542,7 +2542,7 @@ export default {
|
||||
confirm: {
|
||||
promote: {
|
||||
header: 'Повысить до системного администратора',
|
||||
body: 'Повысить пользователя {email} до системного администратора? Пользователь получит права уровня платформы: доступ ко всем тенантам, изменение системных настроек и управление списком администраторов.',
|
||||
body: 'Повысить пользователя {email} до системного администратора? Пользователь получит права уровня платформы: доступ ко всем пространствам, изменение системных настроек и управление списком администраторов.',
|
||||
confirmBtn: 'Повысить',
|
||||
},
|
||||
revoke: {
|
||||
@@ -2579,12 +2579,12 @@ export default {
|
||||
},
|
||||
},
|
||||
bulkApply: {
|
||||
label: 'Применить ко всем существующим тенантам',
|
||||
tooltip: 'По умолчанию сохранённое значение применяется только к новым тенантам. Нажмите, чтобы также перезаписать всех существующих.',
|
||||
label: 'Применить ко всем существующим пространствам',
|
||||
tooltip: 'По умолчанию сохранённое значение применяется только к новым пространствам. Нажмите, чтобы также перезаписать все существующие.',
|
||||
confirmBtn: 'Подтвердить применение',
|
||||
confirmBody: 'Перезаписать квоту хранилища всех существующих тенантов значением {value} ГБ. Тенанты, чью квоту вручную правили эксплуатация, также будут перезаписаны. Продолжить?',
|
||||
success: 'Обновлена квота хранилища у {count} тенантов: {gb} ГБ',
|
||||
failed: 'Ошибка применения ко всем тенантам'
|
||||
confirmBody: 'Перезаписать квоту хранилища всех существующих пространств значением {value} ГБ. Пространства, чью квоту вручную правили эксплуатация, также будут перезаписаны. Продолжить?',
|
||||
success: 'Обновлена квота хранилища у {count} пространств: {gb} ГБ',
|
||||
failed: 'Ошибка применения ко всем пространствам'
|
||||
},
|
||||
audit: {
|
||||
tabLabel: 'Журнал аудита',
|
||||
@@ -2627,7 +2627,7 @@ export default {
|
||||
},
|
||||
target: {
|
||||
bulkQuota: 'Массовая синхронизация: квота хранилища по умолчанию',
|
||||
bulkQuotaDiff: 'Применено к {count} тенантам ({gb} ГБ)',
|
||||
bulkQuotaDiff: 'Применено к {count} пространствам ({gb} ГБ)',
|
||||
promoteIdempotent: 'Уже системный администратор (идемпотентно)',
|
||||
revokeNoop: 'И так не был системным администратором (идемпотентно)',
|
||||
requiredRole: 'Требуемая роль: {role}',
|
||||
@@ -2680,7 +2680,7 @@ export default {
|
||||
loginFailed: 'Ошибка входа',
|
||||
registerFailed: 'Ошибка регистрации',
|
||||
getUserFailed: 'Не удалось получить информацию о пользователе',
|
||||
getTenantFailed: 'Не удалось получить информацию о тенанте',
|
||||
getTenantFailed: 'Не удалось получить информацию о пространстве',
|
||||
updatePreferencesFailed: 'Не удалось обновить настройки',
|
||||
refreshTokenFailed: 'Не удалось обновить токен',
|
||||
logoutFailed: 'Ошибка выхода',
|
||||
@@ -2693,12 +2693,12 @@ export default {
|
||||
deleteFailed: 'Не удалось удалить модель'
|
||||
},
|
||||
tenant: {
|
||||
listFailed: 'Не удалось получить список тенантов',
|
||||
searchFailed: 'Не удалось выполнить поиск тенантов',
|
||||
listFailed: 'Не удалось получить список пространств',
|
||||
searchFailed: 'Не удалось выполнить поиск пространств',
|
||||
getApiPrincipalConfigFailed: 'Не удалось получить конфигурацию API principal',
|
||||
updateApiPrincipalConfigFailed: 'Не удалось обновить конфигурацию API principal',
|
||||
createApiPrincipalTestTokenFailed: 'Не удалось создать тестовый API Token',
|
||||
updateFailed: 'Не удалось обновить информацию об арендаторе'
|
||||
updateFailed: 'Не удалось обновить информацию о пространстве'
|
||||
},
|
||||
initialization: {
|
||||
checkFailed: 'Проверка не пройдена',
|
||||
@@ -4005,7 +4005,7 @@ export default {
|
||||
multimodalParsing: 'Мультимодальный анализ документов',
|
||||
hybridSearchEngine: 'Гибридный поиск + граф знаний',
|
||||
ragQandA: 'Вопрос-ответ с ReAct агентом',
|
||||
independentTenant: 'Независимое пространство арендатора',
|
||||
independentTenant: 'Независимое рабочее пространство',
|
||||
fullApiAccess: 'Полный доступ к API',
|
||||
knowledgeBaseManagement: 'Управление базой знаний',
|
||||
carousel: {
|
||||
@@ -4372,8 +4372,8 @@ export default {
|
||||
copySuffix: ' копия',
|
||||
builtinModels: {
|
||||
title: 'Встроенные модели',
|
||||
description: 'Встроенные модели видны всем тенантам. Конфиденциальная информация скрыта, их нельзя редактировать или удалять.',
|
||||
descriptionAdmin: 'Встроенные модели видны всем тенантам. Системные администраторы могут изменять конфигурацию и учетные данные; удаление управляется конфигурацией развертывания.',
|
||||
description: 'Встроенные модели видны всем пространствам. Конфиденциальная информация скрыта, их нельзя редактировать или удалять.',
|
||||
descriptionAdmin: 'Встроенные модели видны всем пространствам. Системные администраторы могут изменять конфигурацию и учетные данные; удаление управляется конфигурацией развертывания.',
|
||||
viewGuide: 'Посмотреть руководство по управлению встроенными моделями'
|
||||
},
|
||||
builtinTag: 'Встроенная',
|
||||
@@ -4838,7 +4838,7 @@ export default {
|
||||
loading: 'Loading vector stores...',
|
||||
engineLabel: 'Vector store',
|
||||
engineDesc:
|
||||
'Pick a store from the global Vector Stores configuration, or leave as System default to use the tenant-wide RETRIEVE_DRIVER engine.',
|
||||
'Pick a store from the global Vector Stores configuration, or leave as System default to use the workspace-wide RETRIEVE_DRIVER engine.',
|
||||
boundLabel: 'Bound vector store',
|
||||
systemDefault: 'System default',
|
||||
immutableHint:
|
||||
@@ -5489,7 +5489,7 @@ export default {
|
||||
spaceTooltip: 'Через пространство "{space}"',
|
||||
spaceTooltipWithTenant: 'Через пространство "{space}" · от {tenant}',
|
||||
shared: 'Внешнее',
|
||||
sharedTooltip: 'Доступ из внешнего арендатора через общее пространство'
|
||||
sharedTooltip: 'Доступ из внешнего пространства через общее пространство'
|
||||
},
|
||||
promptTemplate: {
|
||||
noTemplates: 'No templates available',
|
||||
@@ -5527,11 +5527,11 @@ export default {
|
||||
inviteCodeRefreshed: 'Invite code refreshed',
|
||||
inviteCodeRefreshFailed: 'Failed to refresh invite code',
|
||||
rbac: {
|
||||
needTenantAdmin: 'Требуется роль администратора тенанта',
|
||||
needTenantAdminTip: 'Для этого действия требуется роль admin или выше в текущем тенанте. Обратитесь к владельцу тенанта.',
|
||||
cannotCreate: 'Недостаточно прав в текущем тенанте для создания общего пространства',
|
||||
cannotJoin: 'Недостаточно прав в текущем тенанте для присоединения к общему пространству',
|
||||
cannotManage: 'Недостаточно прав в текущем тенанте для управления общим пространством',
|
||||
needTenantAdmin: 'Требуется роль администратора пространства',
|
||||
needTenantAdminTip: 'Для этого действия требуется роль admin или выше в текущем пространстве. Обратитесь к владельцу пространства.',
|
||||
cannotCreate: 'Недостаточно прав в текущем пространстве для создания общего пространства',
|
||||
cannotJoin: 'Недостаточно прав в текущем пространстве для присоединения к общему пространству',
|
||||
cannotManage: 'Недостаточно прав в текущем пространстве для управления общим пространством',
|
||||
},
|
||||
join: {
|
||||
title: 'Join Space',
|
||||
@@ -5639,7 +5639,7 @@ export default {
|
||||
editTitle: 'Space Settings',
|
||||
detailTitle: 'Space Details',
|
||||
myRoleDesc: 'Your role in this space determines your permissions',
|
||||
membersDesc: 'Просмотр и управление участниками пространства и их ролями. Каждый участник — это один тенант: все пользователи внутри тенанта получают одинаковый доступ к пространству.',
|
||||
membersDesc: 'Просмотр и управление участниками пространства и их ролями. Каждый участник представляет одно рабочее пространство: все его пользователи получают одинаковый доступ к общему пространству.',
|
||||
sharedDesc: 'View all knowledge bases shared to this space',
|
||||
noSharedKB: 'No shared knowledge bases yet',
|
||||
noSharedKBTip: 'Knowledge base owners can share their knowledge bases to this space in KB settings',
|
||||
@@ -5742,13 +5742,13 @@ export default {
|
||||
button: 'Add Member',
|
||||
dialogTitle: 'Add Member',
|
||||
tip: 'Added users will immediately become space members and can access shared knowledge bases.',
|
||||
tipTenant: 'Членство задаётся на уровне тенанта: после присоединения тенанта все его пользователи получают доступ к этому пространству. Результаты ниже сгруппированы по тенанту.',
|
||||
tipTenant: 'Членство задаётся на уровне пространства: после присоединения пространства все его пользователи получают доступ к этому пространству. Результаты ниже сгруппированы по пространству.',
|
||||
searchUser: 'Select User',
|
||||
searchTenant: 'Выбрать тенант',
|
||||
searchTenant: 'Выбрать пространство',
|
||||
searchPlaceholder: 'Search by username or email...',
|
||||
searchTenantPlaceholder: 'Поиск по имени тенанта, пользователя или email...',
|
||||
searchTenantPlaceholder: 'Поиск по имени пространства, пользователя или email...',
|
||||
searchHint: 'Type at least 2 characters to search',
|
||||
searchTenantHint: 'Введите не менее 2 символов; результаты сгруппированы по тенанту и не включают уже добавленных.',
|
||||
searchTenantHint: 'Введите не менее 2 символов; результаты сгруппированы по пространству и не включают уже добавленных.',
|
||||
selectRole: 'Assign Role',
|
||||
confirmBtn: 'Add',
|
||||
success: 'Member added successfully',
|
||||
@@ -6000,7 +6000,7 @@ export default {
|
||||
save: 'Сохранить',
|
||||
baseUrl: 'Базовый URL API',
|
||||
baseUrlDesc: 'Используйте с путями REST API.',
|
||||
apiKey: 'API Key арендатора',
|
||||
apiKey: 'API Key пространства',
|
||||
apiKeyDesc: 'Создавайте API key с правами операций и областью баз знаний для интеграций.',
|
||||
apiKeys: 'API Keys',
|
||||
apiKeysDesc: 'Создавайте отдельные ключи для интеграций и ограничивайте права операций и доступ к базам знаний.',
|
||||
@@ -6016,28 +6016,28 @@ export default {
|
||||
apiKeyScopedAccess: 'Ограниченный доступ',
|
||||
apiKeyAccessRole: 'Роль доступа',
|
||||
apiKeyAccessType: 'Тип доступа',
|
||||
apiKeyAccessTypeHint: '«База знаний» работает в пределах области БЗ на выбранном ниже уровне прав; «Полный доступ арендатора» дополнительно открывает все API уровня арендатора, такие как модели и источники данных.',
|
||||
apiKeyAccessTypeHint: '«База знаний» работает в пределах области БЗ на выбранном ниже уровне прав; «Полный доступ пространства» дополнительно открывает все API уровня пространства, такие как модели и источники данных.',
|
||||
accessTypeKnowledgeBase: 'База знаний',
|
||||
accessTypeTenantFull: 'Полный доступ арендатора',
|
||||
accessTypeTenantFull: 'Полный доступ пространства',
|
||||
apiKeyPermissionLevel: 'Уровень прав',
|
||||
apiKeyAccessRoleHint: 'Первые три роли ограничены операциями с базами знаний; «Полный доступ арендатора» дополнительно открывает API уровня арендатора, такие как модели и источники данных.',
|
||||
apiKeyAccessRoleHint: 'Первые три роли ограничены операциями с базами знаний; «Полный доступ пространства» дополнительно открывает API уровня пространства, такие как модели и источники данных.',
|
||||
accessRoleViewer: 'Чтение БЗ',
|
||||
accessRoleContributor: 'Чтение и запись БЗ',
|
||||
accessRoleAdmin: 'Администратор БЗ',
|
||||
accessRoleOwner: 'Полный доступ арендатора',
|
||||
accessRoleOwner: 'Полный доступ пространства',
|
||||
accessRoleViewerDesc: 'Запросы, поиск и диалог без изменения содержимого баз знаний.',
|
||||
accessRoleContributorDesc: 'Создание, обновление или удаление записей в выбранном диапазоне баз знаний.',
|
||||
accessRoleAdminDesc: 'Управление базами знаний в выбранном диапазоне, включая деструктивные операции, такие как очистка базы знаний; настройки уровня арендатора недоступны.',
|
||||
accessRoleOwnerDesc: 'Полный доступ, эквивалент владельца арендатора: доступны все API уровня арендатора (модели, векторные хранилища, источники данных, каналы, ...). Не ограничивается диапазоном баз знаний.',
|
||||
accessRoleAdminDesc: 'Управление базами знаний в выбранном диапазоне, включая деструктивные операции, такие как очистка базы знаний; настройки уровня пространства недоступны.',
|
||||
accessRoleOwnerDesc: 'Полный доступ, эквивалент владельца пространства: доступны все API уровня пространства (модели, векторные хранилища, источники данных, каналы, ...). Не ограничивается диапазоном баз знаний.',
|
||||
apiKeyCapabilities: 'Возможности',
|
||||
apiKeyCapabilityGroupKnowledge: 'Данные баз знаний',
|
||||
apiKeyCapabilityGroupAutomation: 'Агенты и интеграции',
|
||||
apiKeyCapabilityGroupCollaboration: 'Участники и пространства',
|
||||
apiKeyCapabilityGroupTenant: 'Настройки арендатора',
|
||||
apiKeyCapabilityGroupTenant: 'Настройки пространства',
|
||||
apiKeyCapabilitySelectGroup: 'Выбрать всё',
|
||||
apiKeyCapabilityClearGroup: 'Очистить',
|
||||
capabilityTenantFull: 'Полный доступ арендатора',
|
||||
capabilityTenantFullHint: 'Разрешает все API уровня арендатора, включая модели, векторные хранилища, источники данных и каналы. Диапазон баз знаний не применяется.',
|
||||
capabilityTenantFull: 'Полный доступ пространства',
|
||||
capabilityTenantFullHint: 'Разрешает все API уровня пространства, включая модели, векторные хранилища, источники данных и каналы. Диапазон баз знаний не применяется.',
|
||||
capabilityRetrieve: 'Поиск в базах знаний',
|
||||
capabilityRetrieveHint: 'Чтение, запросы и поиск данных в выбранном диапазоне баз знаний. Не создаёт сессии и не изменяет содержимое.',
|
||||
capabilityChat: 'Диалог',
|
||||
@@ -6051,7 +6051,7 @@ export default {
|
||||
capabilityManageAgents: 'Управление агентами',
|
||||
capabilityManageAgentsHint: 'Позволяет создавать, изменять, удалять и копировать агентов. Конфигурация агента может содержать чувствительные привязки моделей/MCP, поэтому по умолчанию отключено — включайте только при необходимости.',
|
||||
capabilityMessageHistory: 'История сообщений',
|
||||
capabilityMessageHistoryHint: 'Позволяет искать историю чатов арендатора и читать статистику истории. Не даёт доступ к настройкам арендатора.',
|
||||
capabilityMessageHistoryHint: 'Позволяет искать историю чатов пространства и читать статистику истории. Не даёт доступ к настройкам пространства.',
|
||||
capabilityManageModels: 'Управление моделями',
|
||||
capabilityManageModelsHint: 'Управление конфигурациями моделей, учётными данными, проверками подключения и данными WeKnoraCloud.',
|
||||
capabilityManageMcpServices: 'Управление MCP-сервисами',
|
||||
@@ -6067,11 +6067,11 @@ export default {
|
||||
capabilityRunEvaluations: 'Запуск оценок',
|
||||
capabilityRunEvaluationsHint: 'Запуск задач оценки и чтение результатов.',
|
||||
capabilityManageMembers: 'Управление участниками',
|
||||
capabilityManageMembersHint: 'Просмотр и управление участниками арендатора, ролями, приглашениями и ссылками-приглашениями. Не включает управление API Key, удаление арендатора или передачу владения.',
|
||||
capabilityManageMembersHint: 'Просмотр и управление участниками пространства, ролями, приглашениями и ссылками-приглашениями. Не включает управление API Key, удаление пространства или передачу владения.',
|
||||
capabilityManageSpaces: 'Управление пространствами',
|
||||
capabilityManageSpacesHint: 'Управление организациями/пространствами, вступлением, участниками, приглашениями и видимостью общих пространств. Не даёт управление шарингом баз знаний или агентов.',
|
||||
capabilityManageTenantSettings: 'Управление настройками арендатора',
|
||||
capabilityManageTenantSettingsHint: 'Чтение и обновление интеграционных настроек арендатора: режим идентификации конечного пользователя API, настройки заголовков запросов и tenant KV. Не включает управление API Key, участниками, удаление арендатора или передачу владения.',
|
||||
capabilityManageTenantSettings: 'Управление настройками пространства',
|
||||
capabilityManageTenantSettingsHint: 'Чтение и обновление интеграционных настроек пространства: режим идентификации конечного пользователя API, настройки заголовков запросов и KV пространства. Не включает управление API Key, участниками, удаление пространства или передачу владения.',
|
||||
apiKeyKnowledgeScope: 'Базы знаний',
|
||||
apiKeyKnowledgeScopePlaceholder: 'Оставьте пустым, чтобы разрешить доступ ко всем базам знаний',
|
||||
apiKeyKnowledgeScopeOwnerHint: 'Ключи с полным доступом не ограничиваются диапазоном баз знаний.',
|
||||
@@ -6088,10 +6088,10 @@ export default {
|
||||
apiKeyCreatedDesc: 'API key создан; его можно скопировать из списка.',
|
||||
principalMode: 'Режим идентификации пользователя',
|
||||
principalModeDesc:
|
||||
'Настройка того, как API-запросы идентифицируют конечного пользователя. Эта идентичность разделяет сессии диалога и авторизацию MCP-инструментов по пользователям, не сужая доступ API key уровня admin арендатора.',
|
||||
'Настройка того, как API-запросы идентифицируют конечного пользователя. Эта идентичность разделяет сессии диалога и авторизацию MCP-инструментов по пользователям, не сужая доступ API key уровня admin пространства.',
|
||||
principalScope:
|
||||
'Идентификация конечного пользователя разделяет сессии диалога и авторизацию MCP-инструментов (OAuth) по пользователям. API key по-прежнему имеет доступ ко всем базам знаний арендатора; область API-прав не делится по внешним пользователям.',
|
||||
modeTenant: 'Только арендатор',
|
||||
'Идентификация конечного пользователя разделяет сессии диалога и авторизацию MCP-инструментов (OAuth) по пользователям. API key по-прежнему имеет доступ ко всем базам знаний пространства; область API-прав не делится по внешним пользователям.',
|
||||
modeTenant: 'Только пространство',
|
||||
modeDirect: 'Прямой ID пользователя',
|
||||
modeSigned: 'Подписанный token',
|
||||
directWarning: 'Прямой ID доверяет заголовку вызывающей стороны. Используйте только для доверенных server-to-server вызовов.',
|
||||
@@ -6103,7 +6103,7 @@ export default {
|
||||
directHeader: 'Заголовок ID пользователя',
|
||||
requireDirectHeader: 'Требовать заголовок ID пользователя',
|
||||
requireDirectHeaderDesc:
|
||||
'Если включено, запросы без заголовка ID пользователя отклоняются; иначе все запросы обрабатываются как единый арендатор без различия конечных пользователей.',
|
||||
'Если включено, запросы без заголовка ID пользователя отклоняются; иначе все запросы обрабатываются как единое пространство без различия конечных пользователей.',
|
||||
tokenHeader: 'Заголовок token',
|
||||
tokenHeaderDesc: 'Клиент передаёт JWT, подписанный backend, в этом фиксированном заголовке.',
|
||||
hmacSecret: 'HMAC secret',
|
||||
@@ -6137,7 +6137,7 @@ export default {
|
||||
playgroundAgentsLoadFailed: 'Не удалось загрузить агентов',
|
||||
playgroundExternalUser: 'ID внешнего пользователя',
|
||||
playgroundExternalUserPlaceholder: 'user_123',
|
||||
playgroundTenantModeHint: 'Режим только арендатора не отправляет внешнего пользователя; все API sessions используют один tenant principal.',
|
||||
playgroundTenantModeHint: 'Режим только пространства не отправляет внешнего пользователя; все API-сессии используют один субъект пространства.',
|
||||
playgroundDirectModeHint: 'Этот ID пользователя будет отправлен в заголовке {headerName}.',
|
||||
playgroundSignedModeHint: 'В режиме signed token внешний пользователь берётся из JWT sub. Playground автоматически подпишет краткоживущий тестовый JWT для этого user ID.',
|
||||
playgroundQuestion: 'Тестовый вопрос',
|
||||
@@ -6145,7 +6145,7 @@ export default {
|
||||
playgroundRequestPreview: 'Preview запроса (секреты скрыты)',
|
||||
playgroundRun: 'Запустить тест',
|
||||
playgroundStop: 'Остановить',
|
||||
playgroundNeedApiKey: 'У этого арендатора нет API key.',
|
||||
playgroundNeedApiKey: 'У этого пространства нет API key.',
|
||||
playgroundNeedAgent: 'Выберите тестового агента.',
|
||||
playgroundNeedQuestion: 'Введите тестовый вопрос.',
|
||||
playgroundNeedExternalUser: 'Введите external user ID.',
|
||||
@@ -6287,9 +6287,9 @@ export default {
|
||||
imOverview: {
|
||||
menuTitle: 'Подключённые IM',
|
||||
pageTitle: 'Подключённые IM',
|
||||
subtitle: 'Все IM-каналы агентов этого арендатора — переключение состояния или переход к владеющему агенту',
|
||||
subtitle: 'Все IM-каналы агентов этого пространства — переключение состояния или переход к владеющему агенту',
|
||||
totalCount: 'Всего: {count}',
|
||||
empty: 'В этом арендаторе пока не настроены IM-боты',
|
||||
empty: 'В этом пространстве пока не настроены IM-боты',
|
||||
loadFailed: 'Не удалось загрузить список IM-ботов',
|
||||
builtinAgent: 'Встроенный агент',
|
||||
liveIndicator: 'IM-каналы работают',
|
||||
@@ -6332,7 +6332,7 @@ export default {
|
||||
},
|
||||
tenantMember: {
|
||||
title: 'Участники',
|
||||
sectionDescription: 'Приглашайте коллег в тенант и управляйте их ролями. Добавлять и удалять участников может только Владелец.',
|
||||
sectionDescription: 'Приглашайте коллег в пространство и управляйте их ролями. Добавлять и удалять участников может только Владелец.',
|
||||
learnRbacGuide: 'Подробнее о RBAC',
|
||||
totalCount: 'Участников: {n}',
|
||||
listTitle: 'Участники пространства',
|
||||
@@ -6344,13 +6344,13 @@ export default {
|
||||
searchPlaceholder: 'Поиск по имени или email',
|
||||
permissions: {
|
||||
title: 'Права ролей',
|
||||
desc: 'Что может делать каждая роль внутри этого тенанта. Контролируется сервером; элементы UI лишь отражают правила.',
|
||||
desc: 'Что может делать каждая роль внутри этого пространства. Контролируется сервером; элементы UI лишь отражают правила.',
|
||||
iconHint: 'Наведите курсор, чтобы открыть описание прав ролей',
|
||||
manageMembers: 'Управление участниками',
|
||||
manageTenantConfig: 'Изменение настроек тенанта',
|
||||
manageTenantConfig: 'Изменение настроек пространства',
|
||||
manageInfra: 'Настройка моделей / векторных хранилищ / IM-каналов',
|
||||
createOwnKB: 'Создание и редактирование своих БЗ и агентов',
|
||||
readAll: 'Чтение содержимого тенанта',
|
||||
readAll: 'Чтение содержимого пространства',
|
||||
},
|
||||
columns: {
|
||||
member: 'Имя и email',
|
||||
@@ -6378,16 +6378,16 @@ export default {
|
||||
remove: {
|
||||
button: 'Удалить',
|
||||
confirmTitle: 'Удалить участника?',
|
||||
confirmBody: 'Вы уверены, что хотите удалить {name} из этого тенанта? Доступ будет отозван немедленно.',
|
||||
confirmBody: 'Вы уверены, что хотите удалить {name} из этого пространства? Доступ будет отозван немедленно.',
|
||||
confirm: 'Удалить',
|
||||
success: 'Участник удалён',
|
||||
},
|
||||
leave: {
|
||||
button: 'Покинуть тенант',
|
||||
confirmTitle: 'Покинуть этот тенант?',
|
||||
confirmBody: 'Вы потеряете доступ ко всем базам знаний и агентам в этом тенанте. Позже вас можно будет пригласить снова.',
|
||||
button: 'Покинуть пространство',
|
||||
confirmTitle: 'Покинуть это пространство?',
|
||||
confirmBody: 'Вы потеряете доступ ко всем базам знаний и агентам в этом пространстве. Позже вас можно будет пригласить снова.',
|
||||
confirm: 'Покинуть',
|
||||
success: 'Вы покинули тенант',
|
||||
success: 'Вы покинули пространство',
|
||||
},
|
||||
roleChange: {
|
||||
success: 'Роль обновлена',
|
||||
@@ -6397,10 +6397,10 @@ export default {
|
||||
emailFormat: 'Неверный формат email',
|
||||
roleRequired: 'Выберите роль',
|
||||
userNotFound: 'Пользователь с таким email не зарегистрирован. Попросите его зарегистрироваться.',
|
||||
alreadyMember: 'Этот пользователь уже участник тенанта.',
|
||||
alreadyMember: 'Этот пользователь уже участник пространства.',
|
||||
lastOwner: 'Нельзя понизить, удалить или покинуть как последний Владелец. Сначала повысьте кого-то ещё до Владельца.',
|
||||
notFound: 'Участник не найден.',
|
||||
noTenant: 'Нет активного тенанта.',
|
||||
noTenant: 'Нет активного пространства.',
|
||||
invalidRole: 'Роль должна быть owner / admin / contributor / viewer.',
|
||||
generic: 'Что-то пошло не так. Попробуйте ещё раз.',
|
||||
},
|
||||
@@ -6411,7 +6411,7 @@ export default {
|
||||
audit: {
|
||||
tabLabel: 'Журнал аудита',
|
||||
description:
|
||||
'Регистрирует все изменения участников и отказы в доступе в этом тенанте, в обратном хронологическом порядке. Повторные отказы в течение минуты дедуплицируются.',
|
||||
'Регистрирует все изменения участников и отказы в доступе в этом пространстве, в обратном хронологическом порядке. Повторные отказы в течение минуты дедуплицируются.',
|
||||
refresh: 'Обновить',
|
||||
loadMore: 'Показать ещё',
|
||||
end: 'Конец журнала.',
|
||||
|
||||
@@ -0,0 +1,94 @@
|
||||
import assert from 'node:assert/strict'
|
||||
import { readdirSync, readFileSync } from 'node:fs'
|
||||
import { dirname, extname, resolve } from 'node:path'
|
||||
import test from 'node:test'
|
||||
import { fileURLToPath } from 'node:url'
|
||||
|
||||
import enUS from './en-US.ts'
|
||||
import koKR from './ko-KR.ts'
|
||||
import ruRU from './ru-RU.ts'
|
||||
import zhCN from './zh-CN.ts'
|
||||
|
||||
type LocaleValue = string | Record<string, unknown> | unknown[]
|
||||
|
||||
function collectStrings(value: LocaleValue, path = ''): Array<{ path: string; value: string }> {
|
||||
if (typeof value === 'string') return [{ path, value }]
|
||||
if (Array.isArray(value)) {
|
||||
return value.flatMap((item, index) =>
|
||||
collectStrings(item as LocaleValue, `${path}[${index}]`),
|
||||
)
|
||||
}
|
||||
if (value && typeof value === 'object') {
|
||||
return Object.entries(value).flatMap(([key, item]) =>
|
||||
collectStrings(item as LocaleValue, path ? `${path}.${key}` : key),
|
||||
)
|
||||
}
|
||||
return []
|
||||
}
|
||||
|
||||
function withoutTechnicalTenantTokens(value: string): string {
|
||||
return value
|
||||
.replace(/\{tenant(?:Id)?\}/g, '')
|
||||
.replace(/\btenant_id\b/gi, '')
|
||||
.replace(/\btenantless\b/gi, '')
|
||||
.replace(/\bX-Tenant-ID\b/g, '')
|
||||
}
|
||||
|
||||
const localeChecks = [
|
||||
{ name: 'zh-CN', locale: zhCN, forbidden: /租户/ },
|
||||
{ name: 'en-US', locale: enUS, forbidden: /\btenants?\b/i },
|
||||
{ name: 'ko-KR', locale: koKR, forbidden: /테넌트/ },
|
||||
{ name: 'ru-RU', locale: ruRU, forbidden: /(?:тенант|арендатор)/i },
|
||||
]
|
||||
|
||||
const repositoryRoot = resolve(dirname(fileURLToPath(import.meta.url)), '../../../..')
|
||||
const publicDocumentationRoots = [
|
||||
'.env.example',
|
||||
'README_CN.md',
|
||||
'client',
|
||||
'docker-compose.yml',
|
||||
'docs',
|
||||
'mcp-server',
|
||||
]
|
||||
const documentationExtensions = new Set(['.go', '.json', '.md', '.yaml', '.yml'])
|
||||
|
||||
function collectDocumentationFiles(path: string): string[] {
|
||||
const entries = readdirSync(path, { withFileTypes: true })
|
||||
return entries.flatMap((entry) => {
|
||||
const child = resolve(path, entry.name)
|
||||
if (entry.isDirectory()) return collectDocumentationFiles(child)
|
||||
return documentationExtensions.has(extname(entry.name)) ? [child] : []
|
||||
})
|
||||
}
|
||||
|
||||
test('user-facing locale values use workspace terminology', () => {
|
||||
for (const check of localeChecks) {
|
||||
const legacyValues = collectStrings(check.locale)
|
||||
.filter(({ value }) => check.forbidden.test(withoutTechnicalTenantTokens(value)))
|
||||
.map(({ path, value }) => `${check.name}:${path}=${value}`)
|
||||
|
||||
assert.deepEqual(
|
||||
legacyValues,
|
||||
[],
|
||||
`${check.name} still contains user-facing tenant terminology`,
|
||||
)
|
||||
}
|
||||
})
|
||||
|
||||
test('public documentation uses workspace terminology', () => {
|
||||
const legacyLines = publicDocumentationRoots.flatMap((relativePath) => {
|
||||
const absolutePath = resolve(repositoryRoot, relativePath)
|
||||
const files = extname(absolutePath) ? [absolutePath] : collectDocumentationFiles(absolutePath)
|
||||
return files.flatMap((file) =>
|
||||
readFileSync(file, 'utf8')
|
||||
.split('\n')
|
||||
.flatMap((line, index) =>
|
||||
line.includes('租户')
|
||||
? [`${file.slice(repositoryRoot.length + 1)}:${index + 1}=${line.trim()}`]
|
||||
: [],
|
||||
),
|
||||
)
|
||||
})
|
||||
|
||||
assert.deepEqual(legacyLines, [], 'public documentation still contains legacy tenant terminology')
|
||||
})
|
||||
@@ -164,7 +164,7 @@ export default {
|
||||
},
|
||||
storage: {
|
||||
title: "存储引擎(可选)",
|
||||
desc: "原始文件存放位置(本地或对象存储)。默认跟随租户设置即可。",
|
||||
desc: "原始文件存放位置(本地或对象存储)。默认跟随空间设置即可。",
|
||||
},
|
||||
navMultimodal: {
|
||||
title: "多模态 / 图片理解(可选)",
|
||||
@@ -2127,7 +2127,7 @@ export default {
|
||||
rerankModel: "ReRank 模型",
|
||||
rerankModelDesc: "用于对知识库检索结果进行重排序,提高回答准确性",
|
||||
rerankModelPlaceholder: "请选择 ReRank 模型",
|
||||
rerankModelOptionalHint: "当前作用域内暂无 RAG 类型知识库,可不填;后续若加入 RAG 知识库,将自动使用租户默认重排模型,仍建议显式配置。",
|
||||
rerankModelOptionalHint: "当前作用域内暂无 RAG 类型知识库,可不填;后续若加入 RAG 知识库,将自动使用空间默认重排模型,仍建议显式配置。",
|
||||
maxIterations: "最大迭代次数",
|
||||
allowedTools: "允许的工具",
|
||||
multiTurn: "多轮对话",
|
||||
@@ -2474,7 +2474,7 @@ export default {
|
||||
},
|
||||
globalSettings: {
|
||||
title: "系统设置",
|
||||
description: "平台级运行时配置,保存后立即对所有租户生效。仅系统管理员可见可改。",
|
||||
description: "平台级运行时配置,保存后立即对所有空间生效。仅系统管理员可见可改。",
|
||||
loading: "加载中...",
|
||||
empty: "暂无可配置的系统设置",
|
||||
autoSaveHint: "修改后自动保存",
|
||||
@@ -2506,9 +2506,9 @@ export default {
|
||||
description: "管理系统管理员、公开注册与用户创建空间的规则。",
|
||||
},
|
||||
tenant: {
|
||||
tab: "租户默认值 {count}",
|
||||
title: "租户默认值",
|
||||
description: "设置新租户的初始配额与兼容性行为,不会自动改写已有租户。",
|
||||
tab: "空间默认值 {count}",
|
||||
title: "空间默认值",
|
||||
description: "设置新空间的初始配额与兼容性行为,不会自动改写已有空间。",
|
||||
},
|
||||
runtime: {
|
||||
tab: "运行与并发 {count}",
|
||||
@@ -2606,7 +2606,7 @@ export default {
|
||||
knowledgeBaseLabel: "知识库 ID",
|
||||
knowledgeLabel: "文档 ID",
|
||||
taskIDLabel: "业务任务 ID",
|
||||
tenantLabel: "租户 ID",
|
||||
tenantLabel: "空间 ID",
|
||||
sourceLabel: "来源 ID",
|
||||
targetLabel: "目标 ID",
|
||||
sourceKBLabel: "来源知识库",
|
||||
@@ -2735,10 +2735,10 @@ export default {
|
||||
whitelist: "SSRF 防护白名单",
|
||||
},
|
||||
tenant: {
|
||||
max_owned_per_user: "每用户最大租户数",
|
||||
max_owned_per_user: "每用户最大空间数",
|
||||
self_service_creation_enabled: "允许用户自助创建空间",
|
||||
default_storage_quota_gb: "新租户默认存储配额 (GB)",
|
||||
auto_create_api_key: "创建租户时自动生成 API Key",
|
||||
default_storage_quota_gb: "新空间默认存储配额 (GB)",
|
||||
auto_create_api_key: "创建空间时自动生成 API Key",
|
||||
},
|
||||
asynq: {
|
||||
core_concurrency: "核心解析保底并发数",
|
||||
@@ -2768,17 +2768,17 @@ export default {
|
||||
},
|
||||
tenant: {
|
||||
max_owned_per_user:
|
||||
"每个非超管用户通过自助创建可拥有的最大租户数。每次创建租户时实时读取," +
|
||||
"每个非超管用户通过自助创建可拥有的最大空间数。每次创建空间时实时读取," +
|
||||
"修改后立即生效。0 表示使用内置默认值 10;负数表示完全关闭限制(不建议在公开部署使用)。",
|
||||
self_service_creation_enabled:
|
||||
"是否允许非超管用户主动创建空间。关闭后,普通用户只能通过邀请加入已有空间;" +
|
||||
"跨租户超管仍可创建。修改后立即生效。",
|
||||
"跨空间超管仍可创建。修改后立即生效。",
|
||||
default_storage_quota_gb:
|
||||
"新建租户时默认分配的存储配额(GB),包含向量、原文、文本、索引等。" +
|
||||
"仅在创建时读取,修改后只对之后新建的租户生效,不会回写已存在的租户。" +
|
||||
"新建空间时默认分配的存储配额(GB),包含向量、原文、文本、索引等。" +
|
||||
"仅在创建时读取,修改后只对之后新建的空间生效,不会回写已存在的空间。" +
|
||||
"0 或负数表示使用内置默认值 10GB。",
|
||||
auto_create_api_key:
|
||||
"为新租户自动生成 full_access API Key,并在创建响应中返回明文 token。" +
|
||||
"为新空间自动生成 full_access API Key,并在创建响应中返回明文 token。" +
|
||||
"仅用于兼容依赖旧行为的集成;默认关闭,建议通过 API Key 管理显式创建。",
|
||||
},
|
||||
asynq: {
|
||||
@@ -2857,7 +2857,7 @@ export default {
|
||||
confirm: {
|
||||
promote: {
|
||||
header: "提升为系统管理员",
|
||||
body: "确认将 {email} 提升为系统管理员?该用户将获得平台级权限,可访问所有租户、修改系统设置、管理其他管理员。",
|
||||
body: "确认将 {email} 提升为系统管理员?该用户将获得平台级权限,可访问所有空间、修改系统设置、管理其他管理员。",
|
||||
confirmBtn: "确认提升",
|
||||
},
|
||||
revoke: {
|
||||
@@ -2894,12 +2894,12 @@ export default {
|
||||
},
|
||||
},
|
||||
bulkApply: {
|
||||
label: "应用到所有现有租户",
|
||||
tooltip: "保存的值默认只对之后新建的租户生效;点击此按钮将当前值同步写入所有现有租户。",
|
||||
label: "应用到所有现有空间",
|
||||
tooltip: "保存的值默认只对之后新建的空间生效;点击此按钮将当前值同步写入所有现有空间。",
|
||||
confirmBtn: "确认应用",
|
||||
confirmBody: "将把所有现有租户的存储配额覆盖为 {value} GB。如有租户被运维单独调整过的配额,也会一并被覆盖。是否继续?",
|
||||
success: "已将 {count} 个租户的存储配额更新为 {gb} GB",
|
||||
failed: "应用到所有租户失败",
|
||||
confirmBody: "将把所有现有空间的存储配额覆盖为 {value} GB。如有空间被运维单独调整过的配额,也会一并被覆盖。是否继续?",
|
||||
success: "已将 {count} 个空间的存储配额更新为 {gb} GB",
|
||||
failed: "应用到所有空间失败",
|
||||
},
|
||||
audit: {
|
||||
tabLabel: "审计日志",
|
||||
@@ -2942,7 +2942,7 @@ export default {
|
||||
},
|
||||
target: {
|
||||
bulkQuota: "批量同步:默认存储配额",
|
||||
bulkQuotaDiff: "应用到 {count} 个租户({gb} GB)",
|
||||
bulkQuotaDiff: "应用到 {count} 个空间({gb} GB)",
|
||||
promoteIdempotent: "目标已是系统管理员(幂等)",
|
||||
revokeNoop: "目标本就不是系统管理员(幂等)",
|
||||
requiredRole: "需要角色:{role}",
|
||||
@@ -3349,7 +3349,7 @@ export default {
|
||||
multimodalParsing: "多模态文档解析",
|
||||
hybridSearchEngine: "混合检索 + 知识图谱",
|
||||
ragQandA: "ReAct 智能体问答",
|
||||
independentTenant: "独立租户空间",
|
||||
independentTenant: "独立空间",
|
||||
fullApiAccess: "完整 API 访问",
|
||||
knowledgeBaseManagement: "知识库管理",
|
||||
carousel: {
|
||||
@@ -4724,8 +4724,8 @@ export default {
|
||||
copySuffix: " 副本",
|
||||
builtinModels: {
|
||||
title: "内置模型",
|
||||
description: "内置模型对所有租户可见,敏感信息会被隐藏,且不可编辑或删除。",
|
||||
descriptionAdmin: "内置模型对所有租户可见。系统管理员可编辑配置和凭据;删除仍由部署配置管理。",
|
||||
description: "内置模型对所有空间可见,敏感信息会被隐藏,且不可编辑或删除。",
|
||||
descriptionAdmin: "内置模型对所有空间可见。系统管理员可编辑配置和凭据;删除仍由部署配置管理。",
|
||||
viewGuide: "查看内置模型管理指南",
|
||||
},
|
||||
builtinTag: "内置",
|
||||
@@ -5336,7 +5336,7 @@ export default {
|
||||
loading: "正在加载向量存储列表...",
|
||||
engineLabel: "向量存储",
|
||||
engineDesc:
|
||||
"从全局向量存储配置中选择,或保持系统默认以使用租户的 RETRIEVE_DRIVER 引擎。",
|
||||
"从全局向量存储配置中选择,或保持系统默认以使用空间的 RETRIEVE_DRIVER 引擎。",
|
||||
boundLabel: "已绑定的向量存储",
|
||||
systemDefault: "系统默认",
|
||||
immutableHint:
|
||||
@@ -6200,7 +6200,7 @@ export default {
|
||||
save: "保存",
|
||||
baseUrl: "API 地址",
|
||||
baseUrlDesc: "与 REST API 路径拼接使用。",
|
||||
apiKey: "租户 API Key",
|
||||
apiKey: "空间 API Key",
|
||||
apiKeyDesc: "为集成创建带权限和知识库范围的 API Key。",
|
||||
apiKeys: "API Keys",
|
||||
apiKeysDesc: "为不同集成创建独立 Key,并限制操作权限与可访问知识库范围。",
|
||||
@@ -6216,28 +6216,28 @@ export default {
|
||||
apiKeyScopedAccess: "能力授权",
|
||||
apiKeyAccessRole: "访问角色",
|
||||
apiKeyAccessType: "访问类型",
|
||||
apiKeyAccessTypeHint: "「知识库」按下方权限级别在知识库范围内操作;「租户完全访问」额外开放模型、数据源等全部租户级接口。",
|
||||
apiKeyAccessTypeHint: "「知识库」按下方权限级别在知识库范围内操作;「空间完全访问」额外开放模型、数据源等全部空间级接口。",
|
||||
accessTypeKnowledgeBase: "知识库",
|
||||
accessTypeTenantFull: "租户完全访问",
|
||||
accessTypeTenantFull: "空间完全访问",
|
||||
apiKeyPermissionLevel: "权限级别",
|
||||
apiKeyAccessRoleHint: "前三档仅限知识库范围内操作;「租户完全访问」额外开放模型、数据源等租户级接口。",
|
||||
apiKeyAccessRoleHint: "前三档仅限知识库范围内操作;「空间完全访问」额外开放模型、数据源等空间级接口。",
|
||||
accessRoleViewer: "知识库只读",
|
||||
accessRoleContributor: "知识库读写",
|
||||
accessRoleAdmin: "知识库管理员",
|
||||
accessRoleOwner: "租户完全访问",
|
||||
accessRoleOwner: "空间完全访问",
|
||||
accessRoleViewerDesc: "查询、检索和对话,不修改知识库内容。",
|
||||
accessRoleContributorDesc: "创建、更新或删除知识库内容,受知识库范围限制。",
|
||||
accessRoleAdminDesc: "知识库管理,包含清空知识库等破坏性操作,受知识库范围限制;不涉及租户级配置。",
|
||||
accessRoleOwnerDesc: "完全访问,等同租户所有者:可调用模型、向量库、数据源、渠道等全部租户级接口,不受知识库范围限制。",
|
||||
accessRoleAdminDesc: "知识库管理,包含清空知识库等破坏性操作,受知识库范围限制;不涉及空间级配置。",
|
||||
accessRoleOwnerDesc: "完全访问,等同空间所有者:可调用模型、向量库、数据源、渠道等全部空间级接口,不受知识库范围限制。",
|
||||
apiKeyCapabilities: "可用能力",
|
||||
apiKeyCapabilityGroupKnowledge: "知识库数据",
|
||||
apiKeyCapabilityGroupAutomation: "智能体与集成",
|
||||
apiKeyCapabilityGroupCollaboration: "成员与空间",
|
||||
apiKeyCapabilityGroupTenant: "租户配置",
|
||||
apiKeyCapabilityGroupTenant: "空间配置",
|
||||
apiKeyCapabilitySelectGroup: "全选",
|
||||
apiKeyCapabilityClearGroup: "清空",
|
||||
capabilityTenantFull: "租户完全访问",
|
||||
capabilityTenantFullHint: "允许调用模型、向量库、数据源、渠道等全部租户级接口;知识库范围不再生效。",
|
||||
capabilityTenantFull: "空间完全访问",
|
||||
capabilityTenantFullHint: "允许调用模型、向量库、数据源、渠道等全部空间级接口;知识库范围不再生效。",
|
||||
capabilityRetrieve: "检索知识库",
|
||||
capabilityRetrieveHint: "允许读取、查询和检索所选知识库范围内的数据;不创建会话,也不修改内容。",
|
||||
capabilityChat: "对话能力",
|
||||
@@ -6251,7 +6251,7 @@ export default {
|
||||
capabilityManageAgents: "管理智能体",
|
||||
capabilityManageAgentsHint: "允许创建、修改、删除、复制智能体。智能体配置可能含模型/MCP 等敏感绑定,默认关闭,按需开启。",
|
||||
capabilityMessageHistory: "消息历史",
|
||||
capabilityMessageHistoryHint: "允许检索租户聊天历史并读取聊天历史统计;不授予租户配置权限。",
|
||||
capabilityMessageHistoryHint: "允许检索空间聊天历史并读取聊天历史统计;不授予空间配置权限。",
|
||||
capabilityManageModels: "管理模型",
|
||||
capabilityManageModelsHint: "允许管理模型配置、模型凭据、模型连通性测试和 WeKnoraCloud 凭据。",
|
||||
capabilityManageMcpServices: "管理 MCP 服务",
|
||||
@@ -6267,11 +6267,11 @@ export default {
|
||||
capabilityRunEvaluations: "运行评测",
|
||||
capabilityRunEvaluationsHint: "允许运行评测任务并读取评测结果。",
|
||||
capabilityManageMembers: "管理成员",
|
||||
capabilityManageMembersHint: "允许查看和管理租户成员、角色、邀请和邀请链接;不包含 API Key 管理、租户删除或所有权转移。",
|
||||
capabilityManageMembersHint: "允许查看和管理空间成员、角色、邀请和邀请链接;不包含 API Key 管理、空间删除或所有权转移。",
|
||||
capabilityManageSpaces: "管理空间",
|
||||
capabilityManageSpacesHint: "允许管理组织空间、加入流程、空间成员、邀请和共享空间可见性;不授予知识库或智能体分享管理权限。",
|
||||
capabilityManageTenantSettings: "管理租户设置",
|
||||
capabilityManageTenantSettingsHint: "允许读取和更新租户级集成设置,例如 API 终端用户身份模式、请求头配置、租户 KV 配置等;不包含 API Key 管理、成员管理、租户删除或所有权转移。",
|
||||
capabilityManageTenantSettings: "管理空间设置",
|
||||
capabilityManageTenantSettingsHint: "允许读取和更新空间级集成设置,例如 API 终端用户身份模式、请求头配置、空间 KV 配置等;不包含 API Key 管理、成员管理、空间删除或所有权转移。",
|
||||
apiKeyKnowledgeScope: "知识库范围",
|
||||
apiKeyKnowledgeScopePlaceholder: "留空表示允许访问全部知识库",
|
||||
apiKeyKnowledgeScopeOwnerHint: "完全访问密钥不受知识库范围限制。",
|
||||
@@ -6291,7 +6291,7 @@ export default {
|
||||
"配置 API 请求如何识别终端用户。该身份会同时用于区分不同用户的对话 Session 与 MCP 工具授权。",
|
||||
principalScope:
|
||||
"终端用户身份负责隔离 Session 与 MCP OAuth;API Key 自身的操作权限和知识库范围由上方 API Keys 管理。",
|
||||
modeTenant: "仅租户",
|
||||
modeTenant: "仅空间",
|
||||
modeDirect: "直接传用户 ID",
|
||||
modeSigned: "签名 Token",
|
||||
directWarning: "直接传用户 ID 会信任调用方请求头,仅适用于可信服务端到服务端调用。",
|
||||
@@ -6303,7 +6303,7 @@ export default {
|
||||
directHeader: "用户 ID 请求头",
|
||||
requireDirectHeader: "必须携带用户 ID",
|
||||
requireDirectHeaderDesc:
|
||||
"开启后,缺少用户 ID 请求头的 API Key 请求将被拒绝;关闭则按整个租户统一处理,不区分具体终端用户。",
|
||||
"开启后,缺少用户 ID 请求头的 API Key 请求将被拒绝;关闭则按整个空间统一处理,不区分具体终端用户。",
|
||||
tokenHeader: "Token 请求头",
|
||||
tokenHeaderDesc: "客户端在该固定请求头中携带后端签发的 JWT。",
|
||||
hmacSecret: "HMAC 密钥",
|
||||
@@ -6337,7 +6337,7 @@ export default {
|
||||
playgroundAgentsLoadFailed: "智能体列表加载失败",
|
||||
playgroundExternalUser: "外部用户 ID",
|
||||
playgroundExternalUserPlaceholder: "user_123",
|
||||
playgroundTenantModeHint: "仅租户模式不会发送外部用户身份,所有 API 会话归属同一个租户级主体。",
|
||||
playgroundTenantModeHint: "仅空间模式不会发送外部用户身份,所有 API 会话归属同一个空间级主体。",
|
||||
playgroundDirectModeHint: "将通过 {headerName} 请求头发送此用户 ID。",
|
||||
playgroundSignedModeHint: "签名模式由 JWT 的 sub 代表外部用户;Playground 会用这里的用户 ID 自动签出短期测试 JWT。",
|
||||
playgroundQuestion: "测试问题",
|
||||
@@ -6345,7 +6345,7 @@ export default {
|
||||
playgroundRequestPreview: "请求预览(已遮蔽密钥)",
|
||||
playgroundRun: "运行测试",
|
||||
playgroundStop: "停止",
|
||||
playgroundNeedApiKey: "当前租户没有 API Key。",
|
||||
playgroundNeedApiKey: "当前空间没有 API Key。",
|
||||
playgroundNeedAgent: "请选择测试智能体。",
|
||||
playgroundNeedQuestion: "请输入测试问题。",
|
||||
playgroundNeedExternalUser: "请输入外部用户 ID。",
|
||||
|
||||
@@ -12,7 +12,7 @@ import { useChatResourcesStore } from '@/stores/chatResources'
|
||||
import { useEditorResourcesStore } from '@/stores/editorResources'
|
||||
import { useOrganizationStore } from '@/stores/organization'
|
||||
|
||||
/** 登出时丢弃 Pinia 内的租户级资源缓存,避免 SPA 重登复用上一账号数据。 */
|
||||
/** 登出时丢弃 Pinia 内的空间级资源缓存,避免 SPA 重登复用上一账号数据。 */
|
||||
function clearSessionResourceCaches() {
|
||||
useChatResourcesStore().invalidate()
|
||||
useEditorResourcesStore().invalidate()
|
||||
@@ -179,7 +179,7 @@ export const useAuthStore = defineStore('auth', () => {
|
||||
}
|
||||
|
||||
const effectiveTenantId = computed(() => {
|
||||
// 如果选择了其他租户,使用选择的租户ID,否则使用用户默认租户ID
|
||||
// 如果选择了其他空间,使用选择的空间ID,否则使用用户默认空间ID
|
||||
return selectedTenantId.value || (tenant.value?.id ? Number(tenant.value.id) : null)
|
||||
})
|
||||
|
||||
|
||||
@@ -6,7 +6,7 @@ import { listModels, type ModelConfig } from '@/api/model'
|
||||
import { listWebSearchProviders, type WebSearchProviderEntity } from '@/api/web-search-provider'
|
||||
import { useOrganizationStore } from '@/stores/organization'
|
||||
|
||||
/** 租户级资源缓存 TTL */
|
||||
/** 空间级资源缓存 TTL */
|
||||
const CACHE_TTL_MS = 60_000
|
||||
|
||||
type ResourceKey = 'knowledgeBases' | 'agents' | 'models' | 'webSearchProviders'
|
||||
@@ -174,7 +174,7 @@ export const useChatResourcesStore = defineStore('chatResources', () => {
|
||||
})
|
||||
}
|
||||
|
||||
/** 并行预取对话输入栏及列表页常用的租户级资源 */
|
||||
/** 并行预取对话输入栏及列表页常用的空间级资源 */
|
||||
async function prefetchChatInput(force = false): Promise<void> {
|
||||
const orgStore = useOrganizationStore()
|
||||
await Promise.all([
|
||||
|
||||
@@ -60,7 +60,7 @@ export const useMenuStore = defineStore('menuStore', () => {
|
||||
|
||||
const liteHiddenPaths = new Set(['logout', 'organizations'])
|
||||
|
||||
// 共享空间 (organizations) 仅对当前租户的 admin / owner 暴露入口。
|
||||
// 共享空间 (organizations) 仅对当前空间的 admin / owner 暴露入口。
|
||||
// viewer / contributor 即便在共享空间里拥有资源,也无需自行管理共享关系,
|
||||
// 入口在侧栏只会徒增噪音;后端 RBAC 才是权限的最终来源(见 middleware/rbac.go)。
|
||||
const visibleMenuArr = computed(() => {
|
||||
|
||||
@@ -26,7 +26,7 @@ interface Settings {
|
||||
enableMemory: boolean; // 是否开启记忆功能
|
||||
conversationModels: ConversationModels;
|
||||
selectedAgentId: string; // 当前选中的智能体ID
|
||||
selectedAgentSourceTenantId: string | null; // 当使用共享智能体时,来源租户 ID(用于后端 model/KB/MCP 解析)
|
||||
selectedAgentSourceTenantId: string | null; // 当使用共享智能体时,来源空间 ID(用于后端 model/KB/MCP 解析)
|
||||
autoCheckUpdate?: boolean; // 是否自动检查并下载更新
|
||||
}
|
||||
|
||||
@@ -107,7 +107,7 @@ const defaultSettings: Settings = {
|
||||
selectedChatModelId: "", // 用户当前选择的对话模型ID
|
||||
},
|
||||
selectedAgentId: BUILTIN_QUICK_ANSWER_ID, // 默认选中快速问答模式
|
||||
selectedAgentSourceTenantId: null as string | null, // 共享智能体来源租户 ID
|
||||
selectedAgentSourceTenantId: null as string | null, // 共享智能体来源空间 ID
|
||||
autoCheckUpdate: true,
|
||||
};
|
||||
|
||||
@@ -178,7 +178,7 @@ export const useSettingsStore = defineStore("settings", {
|
||||
|
||||
// 当前选中的智能体ID
|
||||
selectedAgentId: (state) => state.settings.selectedAgentId || BUILTIN_QUICK_ANSWER_ID,
|
||||
// 共享智能体来源租户 ID(可选)
|
||||
// 共享智能体来源空间 ID(可选)
|
||||
selectedAgentSourceTenantId: (state) => state.settings.selectedAgentSourceTenantId ?? null,
|
||||
},
|
||||
|
||||
@@ -360,7 +360,7 @@ export const useSettingsStore = defineStore("settings", {
|
||||
},
|
||||
|
||||
// 从 /auth/me 或 /auth/login 返回的 user.preferences 同步到本地 settings。
|
||||
// 调用方:authStore.setUser(每次登录 / 刷新 user / 切租户后都会触发)。
|
||||
// 调用方:authStore.setUser(每次登录 / 刷新 user / 切空间后都会触发)。
|
||||
// 不写后端,纯本地状态 + localStorage 写入,避免把后端的值再原路 PUT 回去。
|
||||
hydrateFromUserPreferences(prefs: UserPreferences | undefined | null) {
|
||||
if (!prefs) return;
|
||||
|
||||
@@ -31,7 +31,7 @@ export function isAgentWebSearchReady(
|
||||
return resolveAgentWebSearchProviderId(config, providers) !== null;
|
||||
}
|
||||
|
||||
/** 租户级默认搜索引擎是否可用(无智能体约束时) */
|
||||
/** 空间级默认搜索引擎是否可用(无智能体约束时) */
|
||||
export function isTenantWebSearchReady(providers: WebSearchProviderEntity[]): boolean {
|
||||
return providers.some((p) => p.is_default);
|
||||
}
|
||||
|
||||
@@ -43,14 +43,14 @@ instance.interceptors.request.use(
|
||||
// 添加用户语言偏好
|
||||
config.headers["Accept-Language"] = getCurrentLanguage();
|
||||
|
||||
// 添加跨租户访问请求头:只要 setSelectedTenant 写过激活租户,
|
||||
// 添加跨空间访问请求头:只要 setSelectedTenant 写过激活空间,
|
||||
// 每个请求都要附 X-Tenant-ID。早期版本会 short-circuit
|
||||
// "selectedTenantId === defaultTenantId 时不附"以减少 header 体积,
|
||||
// 但这条优化会被任何把 weknora_tenant 写成激活租户的代码(OIDC
|
||||
// 但这条优化会被任何把 weknora_tenant 写成激活空间的代码(OIDC
|
||||
// 回调、UserMenu loadUserInfo、router hydrate)触发,导致后续请求
|
||||
// 静默丢失 header,前端"切换了"但实际仍跑在 home 租户里——把"切
|
||||
// 静默丢失 header,前端"切换了"但实际仍跑在 home 空间里——把"切
|
||||
// 换之后只有第一批请求带 X-Tenant-ID"调成永久状态。
|
||||
// 后端 IsTenantAccessible 已经允许 header 指向 home 租户(自家),
|
||||
// 后端 IsTenantAccessible 已经允许 header 指向 home 空间(自家),
|
||||
// 所以无脑附不会引入新风险。
|
||||
if (!isEmbedAuth && !isEmbedPath) {
|
||||
const selectedTenantId = localStorage.getItem('weknora_selected_tenant_id');
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
//
|
||||
// Switching the active tenant always lands the user on the platform's KB
|
||||
// list. 之前是「在当前路径 reload」+ 个别敏感路径回退到 KB 列表,但即便不带
|
||||
// resource id 的页面(设置、Agent 列表等)reload 后也常常因为新租户下没有
|
||||
// resource id 的页面(设置、Agent 列表等)reload 后也常常因为新空间下没有
|
||||
// 对应数据出现空状态,体验跟跳到固定首页其实差不多——干脆统一跳到 KB 列表,
|
||||
// 用一次 full navigation 把所有 store / SSE / 请求都重置一遍。
|
||||
|
||||
|
||||
@@ -3199,7 +3199,7 @@ const applyPromptTemplateDefaults = (cfg: PromptTemplatesConfig | null) => {
|
||||
}
|
||||
};
|
||||
|
||||
// 加载依赖数据(复用租户级缓存,避免重复请求)
|
||||
// 加载依赖数据(复用空间级缓存,避免重复请求)
|
||||
const loadDependencies = async () => {
|
||||
try {
|
||||
await Promise.all([
|
||||
|
||||
@@ -83,8 +83,8 @@
|
||||
<t-icon class="agent-section-toggle"
|
||||
:name="isAgentSectionCollapsed('builtin') ? 'chevron-right' : 'chevron-down'" size="14px" />
|
||||
</div>
|
||||
<!-- 我创建的:当前 agent 是本租户 + 非内置 + 我亲手创建,且前一张
|
||||
要么不存在、要么不是本租户、要么是内置(builtin → mine 过渡)、
|
||||
<!-- 我创建的:当前 agent 是本空间 + 非内置 + 我亲手创建,且前一张
|
||||
要么不存在、要么不是本空间、要么是内置(builtin → mine 过渡)、
|
||||
要么是同事创建。与 KB 列表对齐。 -->
|
||||
<div v-if="showShareGroupHeaders
|
||||
&& agent.isMine
|
||||
@@ -103,7 +103,7 @@
|
||||
<t-icon class="agent-section-toggle"
|
||||
:name="isAgentSectionCollapsed('mine') ? 'chevron-right' : 'chevron-down'" size="14px" />
|
||||
</div>
|
||||
<!-- 本空间 · 仅查看 / 其他成员:本租户里非内置且非我创建的同事 agent。 -->
|
||||
<!-- 本空间 · 仅查看 / 其他成员:本空间里非内置且非我创建的同事 agent。 -->
|
||||
<div v-if="showShareGroupHeaders
|
||||
&& agent.isMine
|
||||
&& !agent.is_builtin
|
||||
@@ -482,7 +482,7 @@
|
||||
</t-tooltip>
|
||||
</div>
|
||||
</div>
|
||||
<!-- 右下角:内置 / 来源徽章(我创建 / 同租户其他成员) -->
|
||||
<!-- 右下角:内置 / 来源徽章(我创建 / 同空间其他成员) -->
|
||||
<div v-if="showAgentBuiltinBadge(agent)" class="builtin-badge">
|
||||
<t-icon name="lock-on" size="12px" />
|
||||
<span>{{ $t('agent.builtin') }}</span>
|
||||
@@ -850,7 +850,7 @@ const { loaded: modelsReadyLoaded, isReadyForAgent } = useTenantModelReadiness()
|
||||
|
||||
interface AgentWithUI extends CustomAgent {
|
||||
showMore?: boolean
|
||||
/** 当前租户在对话下拉中停用(仅影响本租户) */
|
||||
/** 当前空间在对话下拉中停用(仅影响本空间) */
|
||||
disabled_by_me?: boolean
|
||||
}
|
||||
|
||||
@@ -860,7 +860,7 @@ interface AgentWithUI extends CustomAgent {
|
||||
type DisplayAgent = (AgentWithUI & { isMine: true }) | (CustomAgent & { isMine: false; org_name: string; source_tenant_id: number; share_id: string; permission?: string; showMore?: boolean; disabled_by_me?: boolean })
|
||||
|
||||
// 左侧空间选择:默认根据当前角色决定。
|
||||
// 与 KnowledgeBaseList 同款逻辑:Viewer 在当前租户里通常没有自建智能体,
|
||||
// 与 KnowledgeBaseList 同款逻辑:Viewer 在当前空间里通常没有自建智能体,
|
||||
// 默认落到 "all" 才能看到内置 + 共享给我的;Contributor 以上仍默认 "mine"。
|
||||
// State synced to `?scope=` so links are shareable. The "mine" value is
|
||||
// retained for back-compat with existing links; its display label is
|
||||
@@ -986,7 +986,7 @@ const filteredAgents = computed<DisplayAgent[]>(() => {
|
||||
}
|
||||
if (spaceSelection.value !== 'all') return []
|
||||
const list: DisplayAgent[] = []
|
||||
// 本租户内的 agent 拆成 内置 → 我创建 → 同事创建 三段。
|
||||
// 本空间内的 agent 拆成 内置 → 我创建 → 同事创建 三段。
|
||||
// 内置(is_builtin=true)和"个人所有权"是两个维度的概念,置顶为单独
|
||||
// 一段;它们的 created_by 始终为空,跟在「同事/无创建者」桶里反而让
|
||||
// tenantOthers 段同时混入"系统内置 + 历史无 owner 的自定义"两类,
|
||||
@@ -1026,7 +1026,7 @@ const filteredAgents = computed<DisplayAgent[]>(() => {
|
||||
return list
|
||||
})
|
||||
|
||||
// 「工作空间」视图下的稳定排序:本租户内「我创建」在前、「同事创建 / 内建」
|
||||
// 「工作空间」视图下的稳定排序:本空间内「我创建」在前、「同事创建 / 内建」
|
||||
// 在后。给 contributor 视图把「本空间 · 仅查看」分组标题正好插在过渡处。
|
||||
const sortedMineAgents = computed(() => {
|
||||
// 内置 → 我创建 → 同事创建。与 filteredAgents 的"全部"视图保持同序。
|
||||
@@ -1327,7 +1327,7 @@ function canManageAgent(agent: AgentWithUI): boolean {
|
||||
return authStore.hasRole('admin')
|
||||
}
|
||||
|
||||
// isMyAgent 仅用于卡片来源徽章在「我创建」与「同租户其他成员创建」之间切换。
|
||||
// isMyAgent 仅用于卡片来源徽章在「我创建」与「同空间其他成员创建」之间切换。
|
||||
// 跟 canManageAgent 区别:管理权限有 admin 兜底;徽章纯粹按 created_by 匹配。
|
||||
// 内建 agent(created_by="")也归到非 mine 一档,由模板上的 builtin 分支
|
||||
// 提前拦截,不会落到 ResourceOriginBadge。
|
||||
@@ -1336,8 +1336,8 @@ function isMyAgent(agent: { created_by?: string }): boolean {
|
||||
return !!(agent.created_by && userId && agent.created_by === userId)
|
||||
}
|
||||
|
||||
// agentOriginVariant 跟 kbOriginVariant 对齐:右下角徽章不再重复租户名
|
||||
// (顶部 TenantSelector 已经标了租户身份),所有角色都用 creator 变体。
|
||||
// agentOriginVariant 跟 kbOriginVariant 对齐:右下角徽章不再重复空间名
|
||||
// (顶部 TenantSelector 已经标了空间身份),所有角色都用 creator 变体。
|
||||
// 内建 agent 走 v-else 前的 builtin 分支,到不了这里。
|
||||
function agentOriginVariant(agent: { created_by?: string }): 'mine' | 'creator' {
|
||||
return isMyAgent(agent) ? 'mine' : 'creator'
|
||||
@@ -1371,9 +1371,9 @@ function isSharedAgentEditable(perm: string | undefined): boolean {
|
||||
// 这种客观信息分段,不再按当前用户的可写权限筛掉。
|
||||
const showShareGroupHeaders = computed(() => true)
|
||||
|
||||
// 同租户、非当前用户创建的 Agent 分组标题。
|
||||
// contributor / viewer 在本租户里对这些 Agent 没有写权限,所以打"仅查看";
|
||||
// admin / owner 对整个租户都有编辑权限,"仅查看"反而误导,统一改成
|
||||
// 同空间、非当前用户创建的 Agent 分组标题。
|
||||
// contributor / viewer 在本空间里对这些 Agent 没有写权限,所以打"仅查看";
|
||||
// admin / owner 对整个空间都有编辑权限,"仅查看"反而误导,统一改成
|
||||
// "本空间 · 其他成员"——按所有权而非权限来标注。
|
||||
const tenantSectionLabelKey = computed(() =>
|
||||
authStore.hasRole('admin')
|
||||
@@ -1399,23 +1399,23 @@ const toggleAgentSection = (key: AgentSectionKey) => {
|
||||
collapsedAgentSections.value = next
|
||||
}
|
||||
// 根据 agent 数据形态判分组:filteredAgents 元素带 isMine;sortedMineAgents
|
||||
// 是原始 agent(永远当作本租户);sortedSpaceAgentsList 用 is_mine。
|
||||
// 是原始 agent(永远当作本空间);sortedSpaceAgentsList 用 is_mine。
|
||||
//
|
||||
// 当前用户自己创建的 agent 在模板里**没有**独立分组标题(不像 KB 那边有
|
||||
// "我创建的"段),所以这里返回 null——折叠任何分组都不会影响到它们。
|
||||
const agentSectionOf = (item: any): AgentSectionKey | null => {
|
||||
// 内置 agent(is_builtin=true)单独成段,置顶展示——它们是租户共有的
|
||||
// 内置 agent(is_builtin=true)单独成段,置顶展示——它们是空间共有的
|
||||
// 系统资源,跟"我 / 同事 / 共享"几个所有权分类不在同一维度。判定要早于
|
||||
// shared 那一档,因为 filteredAgents 里的 shared 条目也可能携带 is_builtin
|
||||
// (理论上不会,但保守一些)。
|
||||
if (item?.is_builtin === true) return 'builtin'
|
||||
// 跨租户 shared 条目(filteredAgents 拆出来的 isMine=false / 空间视图的
|
||||
// 跨空间 shared 条目(filteredAgents 拆出来的 isMine=false / 空间视图的
|
||||
// sortedSpaceAgentsList 用 is_mine=false)一律按 permission 分到
|
||||
// sharedEditable / sharedReadonly。
|
||||
if (item?.isMine === false || item?.is_mine === false) {
|
||||
return isSharedAgentEditable(item?.permission) ? 'sharedEditable' : 'sharedReadonly'
|
||||
}
|
||||
// 本租户内:我亲手创建 → 'mine';同事 / 非内置但无 created_by → 'tenantOthers'。
|
||||
// 本空间内:我亲手创建 → 'mine';同事 / 非内置但无 created_by → 'tenantOthers'。
|
||||
return isMyAgent(item as AgentWithUI) ? 'mine' : 'tenantOthers'
|
||||
}
|
||||
const isAgentRowHidden = (item: any): boolean => {
|
||||
@@ -1478,7 +1478,7 @@ const handleCopy = (agent: AgentWithUI) => {
|
||||
})
|
||||
}
|
||||
|
||||
/** 切换「我的」智能体停用状态(仅影响当前租户对话下拉显示) */
|
||||
/** 切换「我的」智能体停用状态(仅影响当前空间对话下拉显示) */
|
||||
const handleToggleDisabled = (agent: AgentWithUI) => {
|
||||
openMoreAgentId.value = null
|
||||
const nextDisabled = !agent.disabled_by_me
|
||||
|
||||
@@ -1469,14 +1469,14 @@ watch(() => props.visible, async (newVal) => {
|
||||
currentSection.value = uiStore.kbEditorInitialSection
|
||||
}
|
||||
|
||||
// 加载模型列表与租户默认存储引擎(创建 KB 时即使用,不依赖是否打开「存储引擎」Tab)
|
||||
// 加载模型列表与空间默认存储引擎(创建 KB 时即使用,不依赖是否打开「存储引擎」Tab)
|
||||
await Promise.all([loadAllModels(), loadTenantDefaultStorageProvider()])
|
||||
|
||||
// 根据模式加载数据
|
||||
if (props.mode === 'edit' && props.kbId) {
|
||||
await loadKBData()
|
||||
} else {
|
||||
// 创建模式:初始化空表单,并预填租户默认存储引擎
|
||||
// 创建模式:初始化空表单,并预填空间默认存储引擎
|
||||
formData.value = initFormData(props.initialType || 'document')
|
||||
formData.value.storageProvider = tenantDefaultStorageProvider.value
|
||||
hasFiles.value = false
|
||||
|
||||
@@ -130,7 +130,7 @@
|
||||
<t-icon class="kb-section-toggle" :name="isKbSectionCollapsed('mine') ? 'chevron-right' : 'chevron-down'"
|
||||
size="14px" />
|
||||
</div>
|
||||
<!-- 本空间 · 仅查看:本租户里同事创建、对当前 contributor 不可编辑。
|
||||
<!-- 本空间 · 仅查看:本空间里同事创建、对当前 contributor 不可编辑。
|
||||
当前卡片必须是非置顶(否则归在「已置顶」),且前一张要么
|
||||
不存在、要么是「共享给我」、要么是我创建、要么是置顶卡片
|
||||
(置顶→非置顶的过渡同样要打这个标题)。 -->
|
||||
@@ -630,7 +630,7 @@
|
||||
</template>
|
||||
</div>
|
||||
|
||||
<!-- 全部空状态:保留「新建知识库」CTA,因为是租户没有任何 KB 的真空场景 -->
|
||||
<!-- 全部空状态:保留「新建知识库」CTA,因为是空间没有任何 KB 的真空场景 -->
|
||||
<div v-if="spaceSelection === 'all' && filteredKnowledgeBases.length === 0 && !loading" class="empty-state">
|
||||
<img class="empty-img" src="@/assets/img/upload.svg" alt="">
|
||||
<span class="empty-txt">{{ $t('knowledgeList.empty.title') }}</span>
|
||||
@@ -814,7 +814,7 @@ const chatResources = useChatResourcesStore()
|
||||
const { t } = useI18n()
|
||||
|
||||
// 左侧空间选择:默认根据当前角色决定。
|
||||
// Viewer 在该租户里通常 0 KB owned,"我的"会显示空状态、又把共享 KB 藏起来,
|
||||
// Viewer 在该空间里通常 0 KB owned,"我的"会显示空状态、又把共享 KB 藏起来,
|
||||
// 体验非常误导;所以 Viewer 默认落到 "all"(我的 + 共享给我都显示)。
|
||||
// Contributor 及以上一进来主要管理自己创建的 KB,仍默认 "mine"。
|
||||
//
|
||||
@@ -916,7 +916,7 @@ const sharedKbsByOrg = computed(() => {
|
||||
const spaceKbsList = ref<OrganizationSharedKnowledgeBaseItem[]>([])
|
||||
const spaceKbsLoading = ref(false)
|
||||
|
||||
// 「工作空间」视图下的稳定排序:本租户内「我创建」在前、「同事创建」在后;
|
||||
// 「工作空间」视图下的稳定排序:本空间内「我创建」在前、「同事创建」在后;
|
||||
// 子段内保留服务端的置顶优先顺序。给 contributor 视图把「本空间 · 仅查看」
|
||||
// 分组标题正好插在过渡处;其他角色看不到标题,纯排序变化也无害。
|
||||
// Ordering for the 「本空间」 tab:
|
||||
@@ -1054,9 +1054,9 @@ const recentsList = computed(() => {
|
||||
})
|
||||
|
||||
// 可编辑权限:editor / admin。viewer 进入「仅查看」组。
|
||||
// 用 share-level permission(不是租户角色)做判断——跨租户拿到 viewer 的,
|
||||
// 即便我在本租户是 owner 也确实改不动那个 KB;反过来跨租户拿到 editor 的,
|
||||
// 哪怕我在本租户是 contributor 也确实能改。
|
||||
// 用 share-level permission(不是空间角色)做判断——跨空间拿到 viewer 的,
|
||||
// 即便我在本空间是 owner 也确实改不动那个 KB;反过来跨空间拿到 editor 的,
|
||||
// 哪怕我在本空间是 contributor 也确实能改。
|
||||
const EDITABLE_PERMS = new Set(['admin', 'editor'])
|
||||
function isSharedKbEditable(perm: string | undefined): boolean {
|
||||
return !!perm && EDITABLE_PERMS.has(perm)
|
||||
@@ -1073,9 +1073,9 @@ function isSharedKbEditable(perm: string | undefined): boolean {
|
||||
// 不需要再回头碰这个 computed。
|
||||
const showShareGroupHeaders = computed(() => true)
|
||||
|
||||
// 同租户、非当前用户创建的 KB 分组标题。
|
||||
// contributor / viewer 在本租户里对这些 KB 没有写权限,所以打"仅查看";
|
||||
// admin / owner 反而对整个租户都有编辑权限,"仅查看"会反复误导他们以为
|
||||
// 同空间、非当前用户创建的 KB 分组标题。
|
||||
// contributor / viewer 在本空间里对这些 KB 没有写权限,所以打"仅查看";
|
||||
// admin / owner 反而对整个空间都有编辑权限,"仅查看"会反复误导他们以为
|
||||
// 自己改不了——这一段实际上是"工作空间里其他成员创建的 KB",按所有权
|
||||
// 而非权限来标注更准确。
|
||||
const tenantSectionLabelKey = computed(() =>
|
||||
@@ -1111,10 +1111,10 @@ const toggleKbSection = (key: KbSectionKey) => {
|
||||
//
|
||||
// 输入有两种形态:
|
||||
// 1. filteredKnowledgeBases 的元素,会显式带 `isMine` 标志(见
|
||||
// filteredKnowledgeBases 里的 spread;跨租户 shared 拆给 isMine=false)。
|
||||
// filteredKnowledgeBases 里的 spread;跨空间 shared 拆给 isMine=false)。
|
||||
// 2. sortedMineKbs 的元素就是原始 KB,无 isMine、也无 permission 字段。
|
||||
// 跨租户共享条目一定带 `permission`,本租户条目永远没有,所以"无 permission"
|
||||
// 是本租户的安全标识。综合:先看 isMine,再回退到 permission 是否存在。
|
||||
// 跨空间共享条目一定带 `permission`,本空间条目永远没有,所以"无 permission"
|
||||
// 是本空间的安全标识。综合:先看 isMine,再回退到 permission 是否存在。
|
||||
const kbSectionOf = (kb: any): KbSectionKey => {
|
||||
if (kb?.is_pinned) return 'pinned'
|
||||
const isOwnTenant = kb?.isMine === true || (kb?.isMine !== false && kb?.permission == null)
|
||||
@@ -1361,10 +1361,10 @@ function canDuplicateKBCard(kb: any): boolean {
|
||||
return authStore.hasRole('contributor') && kb.isMine !== false
|
||||
}
|
||||
|
||||
// isMyKb 仅用于卡片右下角徽章在「我创建」与「同租户其他成员创建」之间切换。
|
||||
// isMyKb 仅用于卡片右下角徽章在「我创建」与「同空间其他成员创建」之间切换。
|
||||
// 与 canManageKBCard 不同:管理权限有 admin 兜底,徽章纯粹按创建者匹配。
|
||||
// creator_id 为空(PR 5 RBAC 迁移之前的老 KB)一律按 tenant 处理——避免把
|
||||
// 全租户共有的旧 KB 错误地都标成「我创建」。
|
||||
// 全空间共有的旧 KB 错误地都标成「我创建」。
|
||||
function isMyKb(kb: { creator_id?: string }): boolean {
|
||||
const userId = authStore.user?.id || ''
|
||||
return !!(kb.creator_id && userId && kb.creator_id === userId)
|
||||
@@ -1372,9 +1372,9 @@ function isMyKb(kb: { creator_id?: string }): boolean {
|
||||
|
||||
// kbOriginVariant 决定卡片右下角徽章的展示形态:
|
||||
// - 我自己创建的:mine(绿色 "我创建")
|
||||
// - 同租户他人创建的:creator 变体——只显示创建者名字。用户始终在
|
||||
// 某个工作空间内浏览(顶部 TenantSelector 已经标了租户身份),右下
|
||||
// 角再贴一遍租户名属于重复信息;contributor / admin / owner / viewer
|
||||
// - 同空间他人创建的:creator 变体——只显示创建者名字。用户始终在
|
||||
// 某个工作空间内浏览(顶部 TenantSelector 已经标了空间身份),右下
|
||||
// 角再贴一遍空间名属于重复信息;contributor / admin / owner / viewer
|
||||
// 看到的徽章一致。创建者无法解析时,creator 变体自动回退到
|
||||
// resourceOrigin.tenant 文案("本空间"),不会出现空标签。
|
||||
function kbOriginVariant(kb: { creator_id?: string }): 'mine' | 'creator' {
|
||||
|
||||
@@ -5,7 +5,7 @@
|
||||
<p class="section-desc">{{ $t('knowledgeEditor.share.description') }}</p>
|
||||
</div>
|
||||
<div class="section-body">
|
||||
<!-- 共享表单:仅 KB creator 或租户 Admin+ 可见,其他角色看到的是只读列表。 -->
|
||||
<!-- 共享表单:仅 KB creator 或空间 Admin+ 可见,其他角色看到的是只读列表。 -->
|
||||
<div v-if="canShare" class="share-form">
|
||||
<div class="form-item">
|
||||
<label class="form-label">{{ $t('organization.share.selectOrg') }}</label>
|
||||
@@ -181,7 +181,7 @@ function getOrgForShare(organizationId: string) {
|
||||
interface Props {
|
||||
kbId: string
|
||||
// 后端 POST/PUT/DELETE /knowledge-bases/:id/shares 受 OwnedKBOrAdmin
|
||||
// 守卫:仅 KB creator 或租户 Admin+ 能改动共享。父组件根据 KB.creator_id
|
||||
// 守卫:仅 KB creator 或空间 Admin+ 能改动共享。父组件根据 KB.creator_id
|
||||
// 计算后传入,缺省 false 表示只读。
|
||||
canShare?: boolean
|
||||
}
|
||||
|
||||
@@ -176,7 +176,7 @@ docker pull docker.m.daocloud.io/wechatopenai/weknora-ui:v0.5.0
|
||||
检查代理网络与 \`OPENAI_BASE_URL\` 配置;本地无外网时切换到 Ollama 或国内大模型。
|
||||
|
||||
### Q14: token 用量在哪里看?
|
||||
开启 Langfuse 后,每个会话、每次推理、每个工具调用的 token 消耗都有完整 trace,可按时间、租户、模型聚合。
|
||||
开启 Langfuse 后,每个会话、每次推理、每个工具调用的 token 消耗都有完整 trace,可按时间、空间、模型聚合。
|
||||
|
||||
### Q15: 如何接入私有 LLM?
|
||||
实现 \`internal/models/chat/provider/Provider\` 接口,注册到 provider 工厂,配置文件中加一条记录即可,约 100-200 行代码。
|
||||
|
||||
@@ -46,7 +46,7 @@ onMounted(async () => {
|
||||
return
|
||||
}
|
||||
|
||||
// 后端 POST /organizations/join 要求当前租户角色 ≥ admin,先在前端拦截以给出友好提示
|
||||
// 后端 POST /organizations/join 要求当前空间角色 ≥ admin,先在前端拦截以给出友好提示
|
||||
if (!authStore.hasRole('admin') && !authStore.canAccessAllTenants) {
|
||||
error.value = t('organization.rbac.cannotJoin')
|
||||
loading.value = false
|
||||
|
||||
@@ -570,7 +570,7 @@ const orgStore = useOrganizationStore()
|
||||
const authStore = useAuthStore()
|
||||
|
||||
// 后端 /api/v1/organizations 下的写操作(创建、加入、申请加入、邀请、审批、改设置等)
|
||||
// 在路由层都要求当前租户角色 ≥ admin。前端只用于 UI 渲染,安全边界仍在服务端。
|
||||
// 在路由层都要求当前空间角色 ≥ admin。前端只用于 UI 渲染,安全边界仍在服务端。
|
||||
const canManageOrg = computed(
|
||||
() => authStore.hasRole('admin') || authStore.canAccessAllTenants
|
||||
)
|
||||
|
||||
@@ -35,7 +35,7 @@
|
||||
<!-- 右侧内容区域 -->
|
||||
<div class="settings-content">
|
||||
<div class="content-wrapper">
|
||||
<!-- 组织管理员但租户角色不足,给出只读提示 -->
|
||||
<!-- 组织管理员但空间角色不足,给出只读提示 -->
|
||||
<div v-if="showTenantRoleHint" class="tenant-role-hint">
|
||||
<t-icon name="info-circle" size="16px" />
|
||||
<span>{{ $t('organization.rbac.needTenantAdminTip') }}</span>
|
||||
@@ -641,7 +641,7 @@
|
||||
</div>
|
||||
</t-dialog>
|
||||
|
||||
<!-- 添加成员弹窗(按租户邀请) -->
|
||||
<!-- 添加成员弹窗(按空间邀请) -->
|
||||
<t-dialog v-model:visible="showAddMemberDialog" :header="$t('organization.addMember.dialogTitle')"
|
||||
:confirm-btn="{ content: $t('organization.addMember.confirmBtn'), loading: addMemberSubmitting, disabled: selectedTenantId == null }"
|
||||
:cancel-btn="$t('common.cancel')" @confirm="handleAddMember" @close="resetAddMemberDialog" width="420px">
|
||||
@@ -746,8 +746,8 @@ const upgradeForm = ref({
|
||||
message: ''
|
||||
})
|
||||
|
||||
// 添加成员(按租户邀请)相关状态。Plan 3 之后,邀请实际上是把
|
||||
// 一整个租户拉进空间;这里的「搜索结果」是租户候选列表,每条带一个
|
||||
// 添加成员(按空间邀请)相关状态。Plan 3 之后,邀请实际上是把
|
||||
// 一整个空间拉进空间;这里的「搜索结果」是空间候选列表,每条带一个
|
||||
// 代表用户用于展示。`selectedTenantId` 是真正提交给后端的 tenant_id。
|
||||
const showAddMemberDialog = ref(false)
|
||||
const addMemberSubmitting = ref(false)
|
||||
@@ -793,9 +793,9 @@ function clearAvatarEmoji() {
|
||||
const isCreateMode = computed(() => props.mode === 'create')
|
||||
const isEditMode = computed(() => props.mode === 'edit' || props.mode === 'create')
|
||||
// 后端组织相关变更接口(保存设置、邀请、搜索用户、改/删成员、审核加入申请、
|
||||
// 升级申请、刷新邀请码、移除共享等)在路由层都要求当前租户角色 ≥ admin(见
|
||||
// internal/router/router.go 的 RegisterOrganizationRoutes)。跨租户超管可绕过。
|
||||
// 因此前端任何"管理类"入口必须同时满足:组织内是 admin/owner ∩ 当前租户 admin+。
|
||||
// 升级申请、刷新邀请码、移除共享等)在路由层都要求当前空间角色 ≥ admin(见
|
||||
// internal/router/router.go 的 RegisterOrganizationRoutes)。跨空间超管可绕过。
|
||||
// 因此前端任何"管理类"入口必须同时满足:组织内是 admin/owner ∩ 当前空间 admin+。
|
||||
const hasTenantAdmin = computed(
|
||||
() => authStore.hasRole('admin') || authStore.canAccessAllTenants
|
||||
)
|
||||
@@ -805,14 +805,14 @@ const isAdmin = computed(() => {
|
||||
return !!orgAdmin && hasTenantAdmin.value
|
||||
})
|
||||
|
||||
// 当用户在组织内是 admin/owner 但当前租户角色不足时,展示只读提示
|
||||
// 当用户在组织内是 admin/owner 但当前空间角色不足时,展示只读提示
|
||||
const showTenantRoleHint = computed(() => {
|
||||
if (isCreateMode.value) return !hasTenantAdmin.value
|
||||
const orgAdmin = orgInfo.value?.my_role === 'admin' || orgInfo.value?.is_owner
|
||||
return !!orgAdmin && !hasTenantAdmin.value
|
||||
})
|
||||
|
||||
// 是否可以申请权限升级(非管理员成员可申请;后端也要求租户 admin+)
|
||||
// 是否可以申请权限升级(非管理员成员可申请;后端也要求空间 admin+)
|
||||
const canRequestUpgrade = computed(() => {
|
||||
if (isCreateMode.value || !props.orgId) return false
|
||||
const myRole = orgInfo.value?.my_role
|
||||
@@ -840,9 +840,9 @@ const addMemberRoleOptions = computed(() => [
|
||||
{ label: t('organization.role.admin'), value: 'admin' },
|
||||
])
|
||||
|
||||
// 租户搜索结果选项。主标签展示租户名,括号里附带代表用户名(不再展示
|
||||
// 邮箱、不带"代表:"前缀,避免冗长和译文别扭);租户名缺失时回退到
|
||||
// 代表用户名 / 租户 ID。
|
||||
// 空间搜索结果选项。主标签展示空间名,括号里附带代表用户名(不再展示
|
||||
// 邮箱、不带"代表:"前缀,避免冗长和译文别扭);空间名缺失时回退到
|
||||
// 代表用户名 / 空间 ID。
|
||||
const tenantSearchOptions = computed(() =>
|
||||
tenantSearchResults.value.map((c) => {
|
||||
const tenantLabel = c.tenant_name || c.representative_username || `tenant#${c.tenant_id}`
|
||||
@@ -908,16 +908,16 @@ const filteredMembers = computed(() => {
|
||||
)
|
||||
})
|
||||
|
||||
// 成员行的主标题:优先展示「租户名」,回退到代表用户名 / 租户 ID。Plan 3
|
||||
// 之后每一行成员都对应一个租户,UI 必须先于代表用户呈现租户身份,
|
||||
// 成员行的主标题:优先展示「空间名」,回退到代表用户名 / 空间 ID。Plan 3
|
||||
// 之后每一行成员都对应一个空间,UI 必须先于代表用户呈现空间身份,
|
||||
// 否则用户会误以为这是按"人"加进来的。
|
||||
const memberPrimaryLabel = (m: OrganizationMember): string => {
|
||||
return m.tenant_name || m.username || `tenant#${m.tenant_id}`
|
||||
}
|
||||
|
||||
// 副标题:主标题展示的是租户名时,副标题展示代表用户名;如果主标题已经
|
||||
// 副标题:主标题展示的是空间名时,副标题展示代表用户名;如果主标题已经
|
||||
// 是用户名(无 tenant_name 时的回退),副标题留空,避免重复信息。
|
||||
// 邮箱在租户成员列表里没什么用(不是邀请人需要联系的对象),不展示。
|
||||
// 邮箱在空间成员列表里没什么用(不是邀请人需要联系的对象),不展示。
|
||||
const memberSecondaryLabel = (m: OrganizationMember): string => {
|
||||
if (m.tenant_name && m.username) {
|
||||
return m.username
|
||||
@@ -1218,7 +1218,7 @@ const handleSubmitUpgrade = async () => {
|
||||
}
|
||||
}
|
||||
|
||||
// 添加成员:搜索租户(按租户名 / 用户名 / 邮箱模糊匹配,按 tenant_id 去重)
|
||||
// 添加成员:搜索空间(按空间名 / 用户名 / 邮箱模糊匹配,按 tenant_id 去重)
|
||||
let tenantSearchTimer: ReturnType<typeof setTimeout> | null = null
|
||||
const handleTenantSearch = (query: string) => {
|
||||
if (tenantSearchTimer) {
|
||||
@@ -1244,7 +1244,7 @@ const handleTenantSearch = (query: string) => {
|
||||
}, 300)
|
||||
}
|
||||
|
||||
// 添加成员:把选中的租户拉入空间。后端要求 tenant_id;representative_user_id
|
||||
// 添加成员:把选中的空间拉入空间。后端要求 tenant_id;representative_user_id
|
||||
// 仅做展示/审计用,所以把搜索结果中代表用户也一并带上。
|
||||
const handleAddMember = async () => {
|
||||
if (!props.orgId || selectedTenantId.value == null) return
|
||||
|
||||
@@ -73,7 +73,7 @@
|
||||
'content-wrapper--wide': currentSection === 'members',
|
||||
'content-wrapper--full': SYSTEM_ADMIN_SECTIONS.has(currentSection) || isIntegrationSection(currentSection),
|
||||
}">
|
||||
<!-- 角色不允许访问当前 section(deep-link 进来 / 跨租户切换后角色降级)—— 优先于具体 section 渲染。
|
||||
<!-- 角色不允许访问当前 section(deep-link 进来 / 跨空间切换后角色降级)—— 优先于具体 section 渲染。
|
||||
正常导航走 navItems filter 不会到这里,但 watch(navItems) 的 fallback 会在角色降级
|
||||
的瞬间触发;这一段做兜底兼容旧 URL。 -->
|
||||
<div v-if="!canSeeSection(currentSection)" class="section role-denied">
|
||||
@@ -150,7 +150,7 @@
|
||||
<UserProfile />
|
||||
</div>
|
||||
|
||||
<!-- 租户信息 -->
|
||||
<!-- 空间信息 -->
|
||||
<div v-if="currentSection === 'tenant'" class="section">
|
||||
<TenantInfo />
|
||||
</div>
|
||||
@@ -512,7 +512,7 @@ watch(
|
||||
{ immediate: true },
|
||||
)
|
||||
|
||||
// 切换租户后角色可能变化,原本可见的 admin-only 面板可能消失。
|
||||
// 切换空间后角色可能变化,原本可见的 admin-only 面板可能消失。
|
||||
// 如果 currentSection 落到了不再显示的 key 上,就回退到第一个可见项。
|
||||
watch(navItems, (items) => {
|
||||
if (!items.some((item) => item.key === currentSection.value)) {
|
||||
|
||||
@@ -268,7 +268,7 @@ const tenantInfo = ref<TenantInfo | null>(null)
|
||||
const loading = ref(true)
|
||||
const error = ref('')
|
||||
|
||||
// 仅 owner 可改租户名(与后端 router.go 中 g.Owner() 守卫一致;
|
||||
// 仅 owner 可改空间名(与后端 router.go 中 g.Owner() 守卫一致;
|
||||
// 服务端始终是权限的最终裁判,这里只决定 UI 是否露出入口)。
|
||||
const canEditTenant = computed(() => authStore.hasRole('owner'))
|
||||
|
||||
@@ -435,7 +435,7 @@ watch(
|
||||
},
|
||||
)
|
||||
|
||||
// 原地编辑租户名称:editing 控制行内只读 / 编辑两种形态切换。
|
||||
// 原地编辑空间名称:editing 控制行内只读 / 编辑两种形态切换。
|
||||
// 不沿用 dialog 是因为这里只有一个字段,弹窗反而打断了配置浏览节奏。
|
||||
const editing = ref(false)
|
||||
const editName = ref('')
|
||||
@@ -516,7 +516,7 @@ const saveTenantDescription = async () => {
|
||||
savingDescription.value = true
|
||||
const resp = await updateTenantApi(Number(tenantInfo.value.id), { description: newDesc })
|
||||
if (resp.success) {
|
||||
// 本地立即回显,避免等 /auth/me 往返。描述不像名称那样会出现在租户切换器等
|
||||
// 本地立即回显,避免等 /auth/me 往返。描述不像名称那样会出现在空间切换器等
|
||||
// 顶部组件里,所以无需同步 authStore.tenant / memberships。
|
||||
if (tenantInfo.value) {
|
||||
tenantInfo.value = { ...tenantInfo.value, description: newDesc }
|
||||
@@ -550,14 +550,14 @@ const saveTenantName = async () => {
|
||||
const resp = await updateTenantApi(Number(tenantInfo.value.id), { name: newName })
|
||||
if (resp.success) {
|
||||
// 本地立即回显,避免等 /auth/me 往返;同步刷新登录态里的 tenant
|
||||
// 缓存(若当前激活租户就是 home tenant,顶部租户切换器等地方也跟着更新)。
|
||||
// 缓存(若当前激活空间就是 home tenant,顶部空间切换器等地方也跟着更新)。
|
||||
if (tenantInfo.value) {
|
||||
tenantInfo.value = { ...tenantInfo.value, name: newName }
|
||||
}
|
||||
if (authStore.tenant && String(authStore.tenant.id) === String(tenantInfo.value?.id)) {
|
||||
authStore.setTenant({ ...authStore.tenant, name: newName })
|
||||
}
|
||||
// memberships 里的 tenant_name 是租户切换器读的字段,一并同步避免显示旧名字。
|
||||
// memberships 里的 tenant_name 是空间切换器读的字段,一并同步避免显示旧名字。
|
||||
if (authStore.memberships?.length) {
|
||||
const next = authStore.memberships.map((m) =>
|
||||
String(m.tenant_id) === String(tenantInfo.value?.id)
|
||||
|
||||
@@ -174,7 +174,7 @@ var (
|
||||
// ErrPendingNotFound is returned when Resolve is called with an unknown id.
|
||||
ErrPendingNotFound = errors.New("tool approval pending not found")
|
||||
// ErrTenantMismatch is returned when Resolve tenant does not match the pending request.
|
||||
ErrTenantMismatch = errors.New("tenant mismatch for tool approval")
|
||||
ErrTenantMismatch = errors.New("workspace mismatch for tool approval")
|
||||
// ErrAlreadyResolved is returned when Resolve loses the race against a
|
||||
// timeout / cancellation: the waiter is still in the map but its decision
|
||||
// channel was already consumed by the timer/ctx branch.
|
||||
|
||||
@@ -144,11 +144,11 @@ func (t *WebSearchTool) Execute(ctx context.Context, args json.RawMessage) (*typ
|
||||
}
|
||||
|
||||
if tenantID == 0 {
|
||||
logger.Errorf(ctx, "[Tool][WebSearch] Tenant ID not found in context")
|
||||
logger.Errorf(ctx, "[Tool][WebSearch] Workspace ID not found in context")
|
||||
return &types.ToolResult{
|
||||
Success: false,
|
||||
Error: "tenant ID not found in context",
|
||||
}, fmt.Errorf("tenant ID not found in context")
|
||||
Error: "workspace ID not found in context",
|
||||
}, fmt.Errorf("workspace ID not found in context")
|
||||
}
|
||||
|
||||
// Get tenant info from context (same approach as search.go)
|
||||
|
||||
@@ -293,8 +293,8 @@ func (s *embedChannelService) chunkAllowedForEmbed(
|
||||
if chunk == nil || chunk.KnowledgeBaseID == "" {
|
||||
return false
|
||||
}
|
||||
// 显式重校验租户:GetChunkByIDOnly 无租户过滤,且 KBSelectionMode=="all"/默认
|
||||
// 分支会无条件放行,必须在此挡住跨租户 chunk id 撞库读取他人知识库正文。
|
||||
// 显式重校验空间:GetChunkByIDOnly 无空间过滤,且 KBSelectionMode=="all"/默认
|
||||
// 分支会无条件放行,必须在此挡住跨空间 chunk id 撞库读取他人知识库正文。
|
||||
if ch == nil || chunk.TenantID != ch.TenantID {
|
||||
return false
|
||||
}
|
||||
|
||||
@@ -498,7 +498,7 @@ func (s *DataTableSummaryService) prepareResources(ctx context.Context, payload
|
||||
return nil, fmt.Errorf("unsupported file type: %s", fileType)
|
||||
}
|
||||
|
||||
// 获取租户信息
|
||||
// 获取空间信息
|
||||
tenantInfo, err := s.tenantService.GetTenantByID(ctx, payload.TenantID)
|
||||
if err != nil {
|
||||
logger.Errorf(ctx, "failed to get tenant: %v", err)
|
||||
|
||||
@@ -414,11 +414,11 @@ func (s *knowledgeService) isKnowledgeAborted(
|
||||
// checkStorageEngineConfigured verifies that the knowledge base has a storage engine configured
|
||||
// (either at the KB level or via the tenant default).
|
||||
//
|
||||
// 内部版兜底语义:当 KB 与租户都未配置 storage provider 时,如果服务实例持有
|
||||
// 内部版兜底语义:当 KB 与空间都未配置 storage provider 时,如果服务实例持有
|
||||
// 全局 FileService(由容器按 STORAGE_TYPE 注入,默认 local),允许直接落到该
|
||||
// 全局 fileSvc 上,不再硬性阻断。这与 resolveFileService / resolveFileServiceForPath
|
||||
// 在 provider 为空时回退到 s.fileSvc 的行为保持一致,避免上层闸门和下游解析口径不一。
|
||||
// 仅当 KB/租户/全局三处都拿不到任何可用 FileService 时才报错。
|
||||
// 仅当 KB/空间/全局三处都拿不到任何可用 FileService 时才报错。
|
||||
func (s *knowledgeService) checkStorageEngineConfigured(ctx context.Context, kb *types.KnowledgeBase) error {
|
||||
provider := kb.GetStorageProvider()
|
||||
if provider == "" {
|
||||
@@ -498,7 +498,7 @@ func (s *knowledgeService) GetOwningKBCreatorID(ctx context.Context, knowledgeID
|
||||
// minimal and tenant-scoped.
|
||||
tenantID, ok := ctx.Value(types.TenantIDContextKey).(uint64)
|
||||
if !ok {
|
||||
return "", werrors.NewUnauthorizedError("Tenant ID not found in context")
|
||||
return "", werrors.NewUnauthorizedError("Workspace ID not found in context")
|
||||
}
|
||||
knowledge, err := s.repo.GetKnowledgeByID(ctx, tenantID, knowledgeID)
|
||||
if err != nil {
|
||||
@@ -791,11 +791,11 @@ func (s *knowledgeService) UpdateKnowledgeTagBatch(ctx context.Context, authoriz
|
||||
}
|
||||
tenantIDVal := ctx.Value(types.TenantIDContextKey)
|
||||
if tenantIDVal == nil {
|
||||
return werrors.NewUnauthorizedError("tenant ID not found in context")
|
||||
return werrors.NewUnauthorizedError("workspace ID not found in context")
|
||||
}
|
||||
tenantID, ok := tenantIDVal.(uint64)
|
||||
if !ok {
|
||||
return werrors.NewUnauthorizedError("invalid tenant ID in context")
|
||||
return werrors.NewUnauthorizedError("invalid workspace ID in context")
|
||||
}
|
||||
|
||||
// Get all knowledge items in batch
|
||||
@@ -882,7 +882,7 @@ func (s *knowledgeService) UpdateKnowledgeTagBatch(ctx context.Context, authoriz
|
||||
func (s *knowledgeService) SearchKnowledge(ctx context.Context, keyword string, offset, limit int, fileTypes []string) ([]*types.Knowledge, bool, int64, error) {
|
||||
tenantID, ok := ctx.Value(types.TenantIDContextKey).(uint64)
|
||||
if !ok {
|
||||
return nil, false, 0, werrors.NewUnauthorizedError("Tenant ID not found in context")
|
||||
return nil, false, 0, werrors.NewUnauthorizedError("Workspace ID not found in context")
|
||||
}
|
||||
|
||||
scopes := make([]types.KnowledgeSearchScope, 0)
|
||||
|
||||
@@ -1899,7 +1899,7 @@ func (s *knowledgeService) UpdateLastFAQImportResultDisplayStatus(ctx context.Co
|
||||
return werrors.NewBadRequestError("invalid display status, must be 'open' or 'close'")
|
||||
}
|
||||
|
||||
// 获取当前租户ID
|
||||
// 获取当前空间ID
|
||||
tenantID := ctx.Value(types.TenantIDContextKey).(uint64)
|
||||
|
||||
// 查找FAQ类型的knowledge
|
||||
|
||||
@@ -167,8 +167,8 @@ func (s *messageService) GetRecentMessagesBySession(ctx context.Context,
|
||||
|
||||
tenantID, ok := sessionTenantIDForLookup(ctx)
|
||||
if !ok {
|
||||
logger.Error(ctx, "Tenant ID not found in context for session lookup")
|
||||
return nil, errors.New("tenant ID not found in context")
|
||||
logger.Error(ctx, "Workspace ID not found in context for session lookup")
|
||||
return nil, errors.New("workspace ID not found in context")
|
||||
}
|
||||
logger.Infof(ctx, "Checking if session exists, tenant ID: %d", tenantID)
|
||||
_, err := s.sessionRepo.Get(ctx, tenantID, sessionUserIDForLookup(ctx), sessionID)
|
||||
@@ -200,8 +200,8 @@ func (s *messageService) GetMessagesBySessionBeforeTime(ctx context.Context,
|
||||
|
||||
tenantID, ok := sessionTenantIDForLookup(ctx)
|
||||
if !ok {
|
||||
logger.Error(ctx, "Tenant ID not found in context for session lookup")
|
||||
return nil, errors.New("tenant ID not found in context")
|
||||
logger.Error(ctx, "Workspace ID not found in context for session lookup")
|
||||
return nil, errors.New("workspace ID not found in context")
|
||||
}
|
||||
logger.Infof(ctx, "Checking if session exists, tenant ID: %d", tenantID)
|
||||
_, err := s.sessionRepo.Get(ctx, tenantID, sessionUserIDForLookup(ctx), sessionID)
|
||||
|
||||
@@ -64,7 +64,7 @@ func (s *modelService) decryptAppSecret(encrypted string) string {
|
||||
}
|
||||
|
||||
// resolveWeKnoraCloudCredentials 为 WeKnoraCloud 厂商模型补全 AppID/AppSecret。
|
||||
// 当模型自身参数中未存储凭证时,自动从租户配置中获取(SaveCredentials 保存的凭证)。
|
||||
// 当模型自身参数中未存储凭证时,自动从空间配置中获取(SaveCredentials 保存的凭证)。
|
||||
func (s *modelService) resolveWeKnoraCloudCredentials(ctx context.Context, params *types.ModelParameters) (appID, appSecret string) {
|
||||
appID = params.AppID
|
||||
appSecret = s.decryptAppSecret(params.AppSecret)
|
||||
|
||||
@@ -142,7 +142,7 @@ func (s *sessionService) GetSessionByID(ctx context.Context, tenantID uint64, id
|
||||
return nil, stderrors.New("session id is required")
|
||||
}
|
||||
if tenantID == 0 {
|
||||
return nil, stderrors.New("tenant id is required")
|
||||
return nil, stderrors.New("workspace id is required")
|
||||
}
|
||||
return s.sessionRepo.GetByID(ctx, tenantID, id)
|
||||
}
|
||||
|
||||
@@ -800,7 +800,7 @@ func (s *sessionService) SearchKnowledge(ctx context.Context,
|
||||
tenantID, ok := types.TenantIDFromContext(ctx)
|
||||
if !ok {
|
||||
logger.Error(ctx, "Failed to get tenant ID from context")
|
||||
return nil, fmt.Errorf("tenant ID not found in context")
|
||||
return nil, fmt.Errorf("workspace ID not found in context")
|
||||
}
|
||||
|
||||
// Build unified search targets (computed once, used throughout pipeline)
|
||||
|
||||
@@ -141,8 +141,8 @@ var registry = map[string]settingSpec{
|
||||
Default: "create_personal",
|
||||
Enum: []string{"create_personal", "tenantless"},
|
||||
Category: "auth",
|
||||
Description: "公开注册成功后的默认租户策略。create_personal = 自动创建个人租户并设为 Owner;" +
|
||||
"tenantless = 仅创建用户,等待接受邀请或主动创建租户。修改后只影响新注册用户。",
|
||||
Description: "公开注册成功后的默认空间策略。create_personal = 自动创建个人空间并设为 Owner;" +
|
||||
"tenantless = 仅创建用户,等待接受邀请或主动创建空间。修改后只影响新注册用户。",
|
||||
},
|
||||
// tenant.max_owned_per_user caps how many tenants a single non-superuser
|
||||
// can create (and Own) via self-service POST /tenants. Read on every
|
||||
@@ -156,7 +156,7 @@ var registry = map[string]settingSpec{
|
||||
EnvName: "WEKNORA_TENANT_MAX_OWNED_PER_USER",
|
||||
Default: int64(10),
|
||||
Category: "tenant",
|
||||
Description: "每个非超管用户通过自助创建可拥有的最大租户数。每次创建租户时实时读取," +
|
||||
Description: "每个非超管用户通过自助创建可拥有的最大空间数。每次创建空间时实时读取," +
|
||||
"修改后立即生效。0 表示使用内置默认值 10;负数表示完全关闭限制(不建议在公开部署使用)。",
|
||||
},
|
||||
"tenant.self_service_creation_enabled": {
|
||||
@@ -164,8 +164,8 @@ var registry = map[string]settingSpec{
|
||||
EnvName: "WEKNORA_TENANT_SELF_SERVICE_CREATION_ENABLED",
|
||||
Default: true,
|
||||
Category: "tenant",
|
||||
Description: "是否允许非超管用户主动创建租户。关闭后,普通用户只能通过邀请加入已有租户;" +
|
||||
"跨租户超管仍可创建。修改后立即生效。",
|
||||
Description: "是否允许非超管用户主动创建空间。关闭后,普通用户只能通过邀请加入已有空间;" +
|
||||
"跨空间超管仍可创建。修改后立即生效。",
|
||||
},
|
||||
// tenant.default_storage_quota_gb is the default storage quota (in GB)
|
||||
// applied to a newly-created tenant when the caller doesn't specify
|
||||
@@ -179,8 +179,8 @@ var registry = map[string]settingSpec{
|
||||
EnvName: "WEKNORA_TENANT_DEFAULT_STORAGE_QUOTA_GB",
|
||||
Default: int64(10),
|
||||
Category: "tenant",
|
||||
Description: "新建租户时默认分配的存储配额(GB),包含向量、原文、文本、索引等。" +
|
||||
"仅在创建时读取,修改后只对之后新建的租户生效,不会回写已存在的租户。" +
|
||||
Description: "新建空间时默认分配的存储配额(GB),包含向量、原文、文本、索引等。" +
|
||||
"仅在创建时读取,修改后只对之后新建的空间生效,不会回写已存在的空间。" +
|
||||
"0 或负数表示使用内置默认值 10GB。",
|
||||
},
|
||||
// tenant.auto_create_api_key restores the legacy behaviour where creating
|
||||
@@ -196,9 +196,9 @@ var registry = map[string]settingSpec{
|
||||
EnvName: "WEKNORA_TENANT_AUTO_CREATE_API_KEY",
|
||||
Default: false,
|
||||
Category: "tenant",
|
||||
Description: "创建租户时是否自动生成一个全量权限(full_access)的 API Key,并在创建接口的响应中返回其明文 token。" +
|
||||
"用于兼容旧版本「创建租户即下发默认 API Key」的行为(属于破坏性变更的回退开关)。" +
|
||||
"每次创建租户时实时读取,修改后立即生效。默认 false(不自动创建,需通过 API Key 管理显式创建)。",
|
||||
Description: "创建空间时是否自动生成一个全量权限(full_access)的 API Key,并在创建接口的响应中返回其明文 token。" +
|
||||
"用于兼容旧版本「创建空间即下发默认 API Key」的行为(属于破坏性变更的回退开关)。" +
|
||||
"每次创建空间时实时读取,修改后立即生效。默认 false(不自动创建,需通过 API Key 管理显式创建)。",
|
||||
},
|
||||
"asynq.core_concurrency": {
|
||||
Type: "int",
|
||||
|
||||
@@ -34,8 +34,8 @@ func (s *tenantService) CreateTenant(ctx context.Context, tenant *types.Tenant)
|
||||
logger.Info(ctx, "Start creating tenant")
|
||||
|
||||
if tenant.Name == "" {
|
||||
logger.Error(ctx, "Tenant name cannot be empty")
|
||||
return nil, errors.New("tenant name cannot be empty")
|
||||
logger.Error(ctx, "Workspace name cannot be empty")
|
||||
return nil, errors.New("workspace name cannot be empty")
|
||||
}
|
||||
|
||||
logger.Infof(ctx, "Creating tenant, name: %s", tenant.Name)
|
||||
@@ -68,7 +68,7 @@ func (s *tenantService) CreateTenant(ctx context.Context, tenant *types.Tenant)
|
||||
// GetTenantByID retrieves a tenant by their ID
|
||||
func (s *tenantService) GetTenantByID(ctx context.Context, id uint64) (*types.Tenant, error) {
|
||||
if id == 0 {
|
||||
logger.Error(ctx, "Tenant ID cannot be 0")
|
||||
logger.Error(ctx, "Workspace ID cannot be 0")
|
||||
return nil, errors.New("tenant ID cannot be 0")
|
||||
}
|
||||
|
||||
@@ -103,7 +103,7 @@ func (s *tenantService) ListTenants(ctx context.Context) ([]*types.Tenant, error
|
||||
// UpdateTenant updates an existing tenant's information
|
||||
func (s *tenantService) UpdateTenant(ctx context.Context, tenant *types.Tenant) (*types.Tenant, error) {
|
||||
if tenant.ID == 0 {
|
||||
logger.Error(ctx, "Tenant ID cannot be 0")
|
||||
logger.Error(ctx, "Workspace ID cannot be 0")
|
||||
return nil, errors.New("tenant ID cannot be 0")
|
||||
}
|
||||
|
||||
@@ -135,7 +135,7 @@ func (s *tenantService) DeleteTenant(ctx context.Context, id uint64) error {
|
||||
logger.Info(ctx, "Start deleting tenant")
|
||||
|
||||
if id == 0 {
|
||||
logger.Error(ctx, "Tenant ID cannot be 0")
|
||||
logger.Error(ctx, "Workspace ID cannot be 0")
|
||||
return errors.New("tenant ID cannot be 0")
|
||||
}
|
||||
|
||||
@@ -164,7 +164,7 @@ func (s *tenantService) DeleteTenant(ctx context.Context, id uint64) error {
|
||||
return err
|
||||
}
|
||||
|
||||
logger.Infof(ctx, "Tenant deleted successfully, ID: %d", id)
|
||||
logger.Infof(ctx, "Workspace deleted successfully, ID: %d", id)
|
||||
return nil
|
||||
}
|
||||
|
||||
@@ -324,7 +324,7 @@ func (s *tenantService) validateStorageBucketUniqueness(ctx context.Context, ten
|
||||
oldB := oldBuckets[p]
|
||||
if b != oldB { // User is trying to change their bucket name or set a new one
|
||||
if usedByOthers[p] != nil && usedByOthers[p][b] {
|
||||
return werrors.NewBadRequestError("存储桶名称「" + b + "」已被其他租户使用,为保证数据隔离,请使用其他名称")
|
||||
return werrors.NewBadRequestError("存储桶名称「" + b + "」已被其他空间使用,为保证数据隔离,请使用其他名称")
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -154,7 +154,7 @@ func (s *userService) Register(ctx context.Context, req *types.RegisterRequest)
|
||||
|
||||
createdTenant, err = s.tenantService.CreateTenant(ctx, tenant)
|
||||
if err != nil {
|
||||
logger.Errorf(ctx, "Failed to create tenant")
|
||||
logger.Errorf(ctx, "Failed to create workspace")
|
||||
return nil, errors.New("failed to create workspace")
|
||||
}
|
||||
}
|
||||
@@ -931,14 +931,14 @@ func (s *userService) SwitchTenant(
|
||||
return nil, errors.New("user is required")
|
||||
}
|
||||
if targetTenantID == 0 {
|
||||
return nil, errors.New("target tenant ID is required")
|
||||
return nil, errors.New("target workspace ID is required")
|
||||
}
|
||||
|
||||
// Verify membership unless the caller is a cross-tenant superuser
|
||||
// switching outside their home tenant.
|
||||
if !user.CanAccessAllTenants || targetTenantID == user.TenantID {
|
||||
if s.memberService == nil {
|
||||
return nil, errors.New("tenant membership service unavailable")
|
||||
return nil, errors.New("workspace membership service unavailable")
|
||||
}
|
||||
member, err := s.memberService.GetMembership(ctx, user.ID, targetTenantID)
|
||||
if err != nil {
|
||||
@@ -951,7 +951,7 @@ func (s *userService) SwitchTenant(
|
||||
|
||||
tenant, err := s.tenantService.GetTenantByID(ctx, targetTenantID)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("load target tenant: %w", err)
|
||||
return nil, fmt.Errorf("load target workspace: %w", err)
|
||||
}
|
||||
|
||||
accessToken, refreshToken, err := s.generateTokensForTenant(ctx, user, targetTenantID)
|
||||
@@ -972,7 +972,7 @@ func (s *userService) SwitchTenant(
|
||||
|
||||
return &types.LoginResponse{
|
||||
Success: true,
|
||||
Message: "Tenant switched",
|
||||
Message: "Workspace switched",
|
||||
User: user,
|
||||
ActiveTenant: tenant,
|
||||
Memberships: memberships,
|
||||
|
||||
@@ -94,7 +94,7 @@ func (s *WebSearchService) resolveProvider(
|
||||
if providerID != "" {
|
||||
tenantID, ok := types.TenantIDFromContext(ctx)
|
||||
if !ok {
|
||||
return nil, fmt.Errorf("tenant ID not found in context")
|
||||
return nil, fmt.Errorf("workspace ID not found in context")
|
||||
}
|
||||
|
||||
entity, err := s.providerRepo.GetByID(ctx, tenantID, providerID)
|
||||
|
||||
@@ -116,7 +116,7 @@ func (s *weKnoraCloudService) CheckStatus(ctx context.Context) (*types.WeKnoraCl
|
||||
return &types.WeKnoraCloudStatusResult{HasModels: true, NeedsReinit: false}, nil
|
||||
}
|
||||
|
||||
// updateTenantCredentials 更新租户的 WeKnoraCloud 凭证
|
||||
// updateTenantCredentials 更新空间的 WeKnoraCloud 凭证
|
||||
func (s *weKnoraCloudService) updateTenantCredentials(ctx context.Context, tenantID uint64, appID, appSecret string) error {
|
||||
if s.tenantRepo == nil {
|
||||
return fmt.Errorf("tenant repository is required")
|
||||
|
||||
@@ -195,7 +195,7 @@ type ImageProcessingConfig struct {
|
||||
EnableMultimodal bool `yaml:"enable_multimodal" json:"enable_multimodal"`
|
||||
}
|
||||
|
||||
// TenantConfig 租户配置
|
||||
// TenantConfig 空间配置
|
||||
type TenantConfig struct {
|
||||
DefaultSessionName string `yaml:"default_session_name" json:"default_session_name"`
|
||||
DefaultSessionTitle string `yaml:"default_session_title" json:"default_session_title"`
|
||||
|
||||
@@ -162,7 +162,7 @@ func NewValidationError(message string) *AppError {
|
||||
func NewTenantNotFoundError() *AppError {
|
||||
return &AppError{
|
||||
Code: ErrTenantNotFound,
|
||||
Message: "租户不存在",
|
||||
Message: "空间不存在",
|
||||
HTTPCode: http.StatusNotFound,
|
||||
}
|
||||
}
|
||||
@@ -171,7 +171,7 @@ func NewTenantNotFoundError() *AppError {
|
||||
func NewTenantAlreadyExistsError() *AppError {
|
||||
return &AppError{
|
||||
Code: ErrTenantAlreadyExists,
|
||||
Message: "租户已存在",
|
||||
Message: "空间已存在",
|
||||
HTTPCode: http.StatusConflict,
|
||||
}
|
||||
}
|
||||
@@ -180,7 +180,7 @@ func NewTenantAlreadyExistsError() *AppError {
|
||||
func NewTenantInactiveError() *AppError {
|
||||
return &AppError{
|
||||
Code: ErrTenantInactive,
|
||||
Message: "租户已停用",
|
||||
Message: "空间已停用",
|
||||
HTTPCode: http.StatusForbidden,
|
||||
}
|
||||
}
|
||||
@@ -190,7 +190,7 @@ func NewTenantInactiveError() *AppError {
|
||||
func NewTenantCreationDisabledError() *AppError {
|
||||
return &AppError{
|
||||
Code: ErrTenantCreationDisabled,
|
||||
Message: "self-service tenant creation is disabled; join a workspace by invitation",
|
||||
Message: "self-service workspace creation is disabled; join a workspace by invitation",
|
||||
HTTPCode: http.StatusForbidden,
|
||||
}
|
||||
}
|
||||
|
||||
@@ -35,11 +35,11 @@ type auditLogListResponse struct {
|
||||
}
|
||||
|
||||
// ListTenantAuditLog godoc
|
||||
// @Summary 获取租户审计日志
|
||||
// @Description 返回该租户最近的审计事件,按 id 倒序。游标分页:将上次响应的 next_cursor 作为下一次请求的 after_id。
|
||||
// @Summary 获取空间审计日志
|
||||
// @Description 返回该空间最近的审计事件,按 id 倒序。游标分页:将上次响应的 next_cursor 作为下一次请求的 after_id。
|
||||
// @Tags 审计日志
|
||||
// @Produce json
|
||||
// @Param id path string true "租户ID"
|
||||
// @Param id path string true "空间ID"
|
||||
// @Param after_id query int false "游标:返回 id 小于此值的记录(默认从最新开始)"
|
||||
// @Param limit query int false "页大小,1-100,默认 50"
|
||||
// @Param action query string false "按 action 精确过滤(如 rbac.member_added / rbac.access_denied)"
|
||||
|
||||
@@ -586,7 +586,7 @@ type updateMyPreferencesRequest struct {
|
||||
EnableMemory *bool `json:"enable_memory"`
|
||||
// LastActiveTenantID lets the SPA persist "after a fresh login,
|
||||
// drop me back into this workspace" across devices. Send a positive
|
||||
// tenant id to set / replace, or 0 to clear. Membership is validated
|
||||
// workspace id to set / replace, or 0 to clear. Membership is validated
|
||||
// at next login, not here. Nil = field omitted from the PATCH and
|
||||
// stays untouched.
|
||||
LastActiveTenantID *uint64 `json:"last_active_tenant_id"`
|
||||
@@ -717,15 +717,15 @@ func (h *AuthHandler) GetAuthConfig(c *gin.Context) {
|
||||
}
|
||||
|
||||
// SwitchTenant godoc
|
||||
// @Summary 切换激活租户
|
||||
// @Description 为当前用户在目标租户重新签发访问令牌;要求该用户在目标租户存在 active 成员关系
|
||||
// @Summary 切换激活空间
|
||||
// @Description 为当前用户在目标空间重新签发访问令牌;要求该用户在目标空间存在 active 成员关系
|
||||
// @Tags 认证
|
||||
// @Accept json
|
||||
// @Produce json
|
||||
// @Param request body object{tenant_id=integer,refresh_token=string} true "切换请求"
|
||||
// @Success 200 {object} types.LoginResponse
|
||||
// @Failure 400 {object} errors.AppError "参数错误"
|
||||
// @Failure 403 {object} errors.AppError "无该租户成员关系"
|
||||
// @Failure 403 {object} errors.AppError "无该空间成员关系"
|
||||
// @Security Bearer
|
||||
// @Router /auth/switch-tenant [post]
|
||||
//
|
||||
@@ -740,7 +740,7 @@ func (h *AuthHandler) SwitchTenant(c *gin.Context) {
|
||||
RefreshToken string `json:"refresh_token"`
|
||||
}
|
||||
if err := c.ShouldBindJSON(&req); err != nil {
|
||||
appErr := errors.NewValidationError("Invalid switch-tenant request").WithDetails(err.Error())
|
||||
appErr := errors.NewValidationError("Invalid workspace switch request").WithDetails(err.Error())
|
||||
c.Error(appErr)
|
||||
return
|
||||
}
|
||||
@@ -755,7 +755,7 @@ func (h *AuthHandler) SwitchTenant(c *gin.Context) {
|
||||
resp, err := h.userService.SwitchTenant(ctx, user, req.TenantID, req.RefreshToken)
|
||||
if err != nil {
|
||||
logger.Errorf(ctx, "SwitchTenant failed user=%s target=%d: %v", user.ID, req.TenantID, err)
|
||||
appErr := errors.NewForbiddenError("switch tenant failed").WithDetails(err.Error())
|
||||
appErr := errors.NewForbiddenError("workspace switch failed").WithDetails(err.Error())
|
||||
c.Error(appErr)
|
||||
return
|
||||
}
|
||||
@@ -764,7 +764,7 @@ func (h *AuthHandler) SwitchTenant(c *gin.Context) {
|
||||
}
|
||||
|
||||
// @Summary 自动初始化(Lite 桌面版)
|
||||
// @Description Lite 版专用:首次启动时自动创建默认用户和租户并返回令牌,后续启动直接签发令牌,免除手动注册/登录流程
|
||||
// @Description Lite 版专用:首次启动时自动创建默认用户和空间并返回令牌,后续启动直接签发令牌,免除手动注册/登录流程
|
||||
// @Tags 认证
|
||||
// @Accept json
|
||||
// @Produce json
|
||||
|
||||
@@ -49,7 +49,7 @@ type invitationLookupRequest struct {
|
||||
|
||||
// LookupInvitationByToken godoc
|
||||
// @Summary 解析共享邀请链接 token
|
||||
// @Description 根据邀请链接中的 token 返回邀请上下文(租户名 / 角色 / 过期时间),
|
||||
// @Description 根据邀请链接中的 token 返回邀请上下文(空间名 / 角色 / 过期时间),
|
||||
// @Description 供注册页展示。无认证;token 无效或被撤销返回 410。
|
||||
// @Description 使用 POST + body 而非 GET + path,避免 token 落入访问日志 / 浏览器历史 / tracing。
|
||||
// @Tags 认证
|
||||
@@ -107,7 +107,7 @@ func (h *AuthHandler) LookupInvitationByToken(c *gin.Context) {
|
||||
// RegisterByInvite godoc
|
||||
// @Summary 使用共享链接注册
|
||||
// @Description 通过 Owner 生成的共享邀请链接 token 完成注册,绕过 invite_only 模式拦截。
|
||||
// @Description 注册者自填邮箱(与 token 不绑定);注册成功后自动加入对应租户。
|
||||
// @Description 注册者自填邮箱(与 token 不绑定);注册成功后自动加入对应空间。
|
||||
// @Tags 认证
|
||||
// @Accept json
|
||||
// @Produce json
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user