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:
wizardchen
2026-07-14 16:13:49 +08:00
committed by lyingbug
parent e1572b71b9
commit 41975abcc5
161 changed files with 1865 additions and 1770 deletions
+6 -6
View File
@@ -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、认证信息在前端会被自动隐藏,但数据库中的原始数据仍然存在,请妥善保管数据库访问权限