Skip to content

Commit bd966d4

Browse files
c121914yuc121914yu
authored
fix: login secret (#6635)
* fix: login secret * lock * env template * fix: ts * fix: ts * fix: ts
1 parent e48a037 commit bd966d4

54 files changed

Lines changed: 2063 additions & 502 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.claude/CLAUDE.md‎

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,11 +5,12 @@
55
## 输出要求
66

77
1. 输出语言：中文
8-
2. 输出的设计文档位置：.claude/design，问题分析文档位置: .claude/issue，以 Markdown 文件为主。
9-
3. 输出 Plan 时，均需写入 .claude/plan 目录下，以 Markdown 文件为主。
10-
4. 相同需求文档，尽量写在一起（内容超过 300 行，可以分批写入），或者创建要给目录一起管理，不要随意平铺一堆不同版本的相同问题的文档。
11-
5. 文件输出，使用正确的编码格式，例如UTF-8。
12-
6. 如果用户未指明，不要随意编写总结报告。
8+
2. 输出文档位置:
9+
1. 设计文档：.claude/design，todo 跟在设计文档后面。
10+
2. 问题分析文档: .claude/issue
11+
3. 相同需求文档，尽量写在一起（内容超过 300 行，可以分批写入），或者创建要给目录一起管理，不要随意平铺一堆不同版本的相同问题的文档。
12+
4. 文件输出，使用正确的编码格式，例如UTF-8。
13+
5. 如果用户未指明，不要随意编写总结报告。
1314

1415
## 项目概述
1516

‎.claude/plan/opensandbox-persistence-plan.md‎

Lines changed: 173 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,173 @@
1+
# Context
2+
3+
当前 `opensandbox` 分支已经暴露了 OpenSandbox provider 环境变量，并在运行时通过 `SandboxClient` 走 provider 分支，但 OpenSandbox 的“持久化配置”仍然散落在 `SandboxClient` 内部，没有形成独立的配置抽象，也没有 volume-manager / `createConfig.volumes` / 实例详情落库这条完整链路。
4+
5+
相比之下，`agent-skill-dev` 已经把这部分能力拆成了独立配置模块，并通过 volume-manager 为 session/runtime 准备持久化卷，再将存储与运行时详情写入 sandbox 实例记录。
6+
7+
本次推荐方案的目标不是整包迁入 `agentSkills` 上层编排，而是：**保留当前分支以 `SandboxClient` 为唯一消费入口的形态，将 OpenSandbox 持久化配置能力下沉到 `packages/service/core/ai/sandbox` 域内完成抽离**。这样可以在最小扰动现有 workflow/tool 调用链的前提下，把持久化卷、配置解析和实例详情持久化补齐。
8+
9+
# Recommended Approach
10+
11+
## 1. 先把配置抽象从 `SandboxClient` 构造函数中抽离
12+
13+
新增统一配置模块，建议放在：
14+
- `packages/service/core/ai/sandbox/config.ts`
15+
16+
从 `agent-skill-dev` 复用并改造以下能力，统一收敛到 sandbox 域：
17+
- `getSandboxProviderConfig`
18+
- `getVolumeManagerConfig`
19+
- `buildVolumeConfig`
20+
- `buildBaseContainerEnv`
21+
22+
这样 `packages/service/core/ai/sandbox/controller.ts` 不再直接读取 env 并内联拼 provider 参数，而是只消费配置模块输出。
23+
24+
## 2. 补齐 provider 类型与实例详情结构
25+
26+
当前事实：
27+
- `packages/service/env.ts` 已支持 `opensandbox`
28+
- `packages/service/core/ai/sandbox/type.ts` 的 `SandboxProviderSchema` 仍只有 `sealosdevbox`
29+
30+
需要在：
31+
- `packages/service/core/ai/sandbox/type.ts`
32+
- `packages/service/core/ai/sandbox/schema.ts`
33+
34+
补齐以下结构：
35+
- `SandboxProviderSchema` 至少包含 `opensandbox`
36+
- 实例 `detail`：provider 运行时返回信息、endpoint、连接信息
37+
- 实例 `storage`：volume 标识、claimName、mountPath、provider storage payload
38+
- 实例 `metadata`：session 维度标识、createConfig 摘要、迁移/兼容标记
39+
40+
要求：新字段全部可选，保证旧记录仍可读。
41+
42+
## 3. 在 `SandboxClient` 内接入持久化卷准备与详情落库
43+
44+
核心改造文件：
45+
- `packages/service/core/ai/sandbox/controller.ts`
46+
47+
推荐保留 `SandboxClient` 作为唯一消费入口，内部改造为：
48+
1. 根据业务标识（`appId/userId/chatId` 或 `sandboxId`）构建稳定 session key
49+
2. 调用 `config.ts` 读取 provider 配置
50+
3. 如果 provider 为 `opensandbox`，则调用 volume-manager 配置与卷构建逻辑
51+
4. 将 volume 信息塞入 `createConfig.volumes`
52+
5. 创建/恢复实例后，把 `detail/storage/metadata` 写入 `MongoSandboxInstance`
53+
54+
复用目标分支的关键能力时，优先迁“配置与卷构建逻辑”，不要直接把 `agentSkills` 生命周期编排整包搬入。
55+
56+
## 4. 保持业务入口不变，只做最小上下文透传
57+
58+
现有消费入口继续复用 `SandboxClient`：
59+
- `packages/service/core/workflow/dispatch/ai/agent/sub/sandbox/index.ts`
60+
- `packages/service/core/workflow/dispatch/ai/tool/toolCall.ts`
61+
62+
这两个入口只做最小修改：
63+
- 确保传入稳定的 `appId/userId/chatId`
64+
- 不感知 provider 配置、volume-manager、存储细节
65+
66+
原则：**底层配置与持久化逻辑留在 sandbox 域，业务入口不扩散基础设施细节。**
67+
68+
## 5. 分两阶段实施
69+
70+
### 第一阶段（必须先迁）
71+
1. 新增 `packages/service/core/ai/sandbox/config.ts`
72+
2. 扩展 `packages/service/env.ts` 中 OpenSandbox 持久化相关 env
73+
3. 扩展 `packages/service/core/ai/sandbox/type.ts`
74+
4. 扩展 `packages/service/core/ai/sandbox/schema.ts`
75+
5. 改造 `packages/service/core/ai/sandbox/controller.ts`
76+
6. 最小化调整 workflow / tool 入口透传上下文
77+
78+
### 第二阶段（可后补）
79+
1. 引入独立 lifecycle 管理（参考 `agent-skill-dev` 的 `.../sandbox/lifecycle.ts`）
80+
2. 区分 edit-debug 与 session-runtime 的 volume 策略
81+
3. 补充 volume 清理、回滚、观测与旧数据回填能力
82+
83+
# Critical Files to Modify
84+
85+
必须修改：
86+
- `packages/service/env.ts`
87+
- `packages/service/core/ai/sandbox/type.ts`
88+
- `packages/service/core/ai/sandbox/schema.ts`
89+
- `packages/service/core/ai/sandbox/controller.ts`
90+
- `packages/service/core/workflow/dispatch/ai/agent/sub/sandbox/index.ts`
91+
- `packages/service/core/workflow/dispatch/ai/tool/toolCall.ts`
92+
93+
建议新增：
94+
- `packages/service/core/ai/sandbox/config.ts`
95+
96+
目标分支中应重点参考、复用逻辑的来源文件：
97+
- `packages/service/core/agentSkills/sandboxConfig.ts`
98+
- `packages/service/core/agentSkills/sandboxController.ts`
99+
- `packages/service/core/workflow/dispatch/ai/agent/sub/sandbox/lifecycle.ts`
100+
101+
# Reuse Existing Functions and Patterns
102+
103+
优先复用当前仓库已验证的模式：
104+
- 现有单一消费入口模式：`packages/service/core/ai/sandbox/controller.ts` 中的 `SandboxClient`
105+
- 现有运行时消费入口：
106+
- `packages/service/core/workflow/dispatch/ai/agent/sub/sandbox/index.ts`
107+
- `packages/service/core/workflow/dispatch/ai/tool/toolCall.ts`
108+
- 目标分支中可迁入的配置抽离函数：
109+
- `getSandboxProviderConfig`
110+
- `getVolumeManagerConfig`
111+
- `buildVolumeConfig`
112+
- `buildBaseContainerEnv`
113+
114+
复用原则：
115+
- 复用“能力”与“结构”，不直接复制 `agentSkills` 上层调用链
116+
- 将通用配置逻辑沉入 `core/ai/sandbox`，避免基础设施层依赖业务层
117+
118+
# Key Risks and Compatibility Notes
119+
120+
1. **类型不一致风险**
121+
- 现在 env 支持 `opensandbox`，但 `SandboxProviderSchema` 不支持
122+
- 必须先统一类型层，再改控制器逻辑
123+
124+
2. **旧数据兼容风险**
125+
- 历史 `agent_sandbox_instances` 没有 `detail/storage/metadata`
126+
- 新字段必须 optional，读取逻辑必须支持旧数据回退到 `provider + sandboxId`
127+
128+
3. **provider 分支串扰风险**
129+
- OpenSandbox 的 volume 逻辑不能污染 `sealosdevbox` / `e2b`
130+
- `createConfig.volumes` 只能在对应 provider 下启用
131+
132+
4. **依赖反转风险**
133+
- 不要让 `core/ai/sandbox` 反向依赖 `agentSkills`
134+
- 通用配置能力必须落在 sandbox 域内
135+
136+
5. **卷幂等与清理风险**
137+
- 第一阶段至少保证 ensure volume 幂等
138+
- 清理/回滚放第二阶段补齐
139+
140+
# Verification
141+
142+
## 单测
143+
144+
1. `config.ts`
145+
- `getSandboxProviderConfig`：不同 provider 输出正确；缺失关键 env 时给出明确错误
146+
- `getVolumeManagerConfig`：能正确解析 volume-manager 配置
147+
- `buildVolumeConfig`：相同 session 上下文生成稳定 volume 配置
148+
- `buildBaseContainerEnv`：容器基础 env 正确且不泄漏无关敏感信息
149+
150+
2. `type.ts` / `schema.ts`
151+
- 旧记录仅有基础字段时可通过读取
152+
- 新记录包含 `detail/storage/metadata` 时可通过校验
153+
154+
3. `controller.ts`
155+
- OpenSandbox 创建时会注入 `createConfig.volumes`
156+
- 创建后会写入 `detail/storage/metadata`
157+
- 旧实例记录仍可兼容
158+
- 非 OpenSandbox provider 行为不变
159+
160+
## 集成测试
161+
162+
1. 通过 `dispatchSandboxShell` 触发首次 session sandbox 创建
163+
2. 检查 `agent_sandbox_instances` 中是否写入 `detail/storage/metadata`
164+
3. 同一 `appId + userId + chatId` 再次进入时，验证 volume 信息可复用
165+
4. 从 `toolCall.ts` 链路触发一次 sandbox 执行，确认入口无需感知底层 volume 配置
166+
167+
## 人工验证
168+
169+
1. 配齐 OpenSandbox + volume-manager 环境变量后启动服务
170+
2. 首次会话进入 sandbox，写入一个测试文件
171+
3. 结束请求后使用相同 `appId/userId/chatId` 再次进入
172+
4. 验证测试文件仍然存在，且实例记录中保留 storage/detail 信息
173+
5. 切换到 `sealosdevbox` / `e2b` 时，验证旧链路行为不变

‎document/content/docs/self-host/upgrading/4-14/41410.mdx‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ description: 'FastGPT V4.14.10 更新说明'
77
## 🚀 新增内容
88

99
1. 飞书发布渠道，支持流输出。
10+
2. 目录最大上限，可通过环境变量配置。
1011

1112
## ⚙️ 优化
1213

‎document/content/docs/self-host/upgrading/4-14/4149.mdx‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,7 @@ CODE_SANDBOX_TOKEN=代码运行沙盒的凭证
6767
13. 修复视频音频自定义文件类型流程开始无文件链接变量
6868
14. 用户输入框消息不转义成 markdown 格式
6969
15. 修复 AgentV2 部分上下文拼接错误。
70+
16. login 接口安全风险。
7071

7172
## 代码优化
7273

‎document/data/doc-last-modified.json‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -220,7 +220,7 @@
220220
"document/content/docs/self-host/upgrading/4-14/4140.mdx": "2026-03-03T17:39:47+08:00",
221221
"document/content/docs/self-host/upgrading/4-14/4141.en.mdx": "2026-03-03T17:39:47+08:00",
222222
"document/content/docs/self-host/upgrading/4-14/4141.mdx": "2026-03-03T17:39:47+08:00",
223-
"document/content/docs/self-host/upgrading/4-14/41410.mdx": "2026-03-24T09:59:30+08:00",
223+
"document/content/docs/self-host/upgrading/4-14/41410.mdx": "2026-03-24T18:02:38+08:00",
224224
"document/content/docs/self-host/upgrading/4-14/4142.en.mdx": "2026-03-03T17:39:47+08:00",
225225
"document/content/docs/self-host/upgrading/4-14/4142.mdx": "2026-03-03T17:39:47+08:00",
226226
"document/content/docs/self-host/upgrading/4-14/4143.en.mdx": "2026-03-03T17:39:47+08:00",
@@ -240,7 +240,7 @@
240240
"document/content/docs/self-host/upgrading/4-14/41481.en.mdx": "2026-03-09T12:02:02+08:00",
241241
"document/content/docs/self-host/upgrading/4-14/41481.mdx": "2026-03-09T17:39:53+08:00",
242242
"document/content/docs/self-host/upgrading/4-14/4149.en.mdx": "2026-03-23T12:17:04+08:00",
243-
"document/content/docs/self-host/upgrading/4-14/4149.mdx": "2026-03-23T23:37:12+08:00",
243+
"document/content/docs/self-host/upgrading/4-14/4149.mdx": "2026-03-25T13:54:15+08:00",
244244
"document/content/docs/self-host/upgrading/outdated/40.en.mdx": "2026-03-03T17:39:47+08:00",
245245
"document/content/docs/self-host/upgrading/outdated/40.mdx": "2026-03-03T17:39:47+08:00",
246246
"document/content/docs/self-host/upgrading/outdated/41.en.mdx": "2026-03-03T17:39:47+08:00",

‎packages/global/common/i18n/type.ts‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ export enum LangEnum {
1616
export type localeType = `${LangEnum}`;
1717
export const LocaleList = ['en', 'zh-CN', 'zh-Hant'] as const;
1818

19+
export const LanguageSchema = z.enum(LocaleList).meta({ description: '用户语言偏好' });
20+
1921
export const langMap = {
2022
[LangEnum.en]: {
2123
label: 'English(US)',

‎packages/global/openapi/admin/support/user/index.ts‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
import { AdminInformPath } from './inform';
2+
import { AdminLoginPath } from './login';
23
import type { OpenAPIPath } from '../../../type';
34

45
export const AdminUserPath: OpenAPIPath = {
5-
...AdminInformPath
6+
...AdminInformPath,
7+
...AdminLoginPath
68
};

‎packages/global/openapi/admin/support/user/login/api.ts‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
import { z } from 'zod';
2+
3+
// Admin login request body
4+
export const AdminLoginBodySchema = z.object({
5+
username: z.string().meta({ description: '用户名' }),
6+
password: z.string().meta({ description: '密码' })
7+
});
8+
export type AdminLoginBodyType = z.infer<typeof AdminLoginBodySchema>;
9+
10+
// Admin login response
11+
export const AdminLoginResponseSchema = z.object({
12+
user: z.any().meta({ description: '用户信息' }),
13+
token: z.string().meta({ description: '登录令牌' })
14+
});
15+
export type AdminLoginResponseType = z.infer<typeof AdminLoginResponseSchema>;

‎packages/global/openapi/admin/support/user/login/index.ts‎

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
import type { OpenAPIPath } from '../../../../type';
2+
import { AdminLoginBodySchema, AdminLoginResponseSchema } from './api';
3+
import { TagsMap } from '../../../../tag';
4+
5+
export const AdminLoginPath: OpenAPIPath = {
6+
'/admin/support/user/login': {
7+
post: {
8+
summary: '管理员登录',
9+
description: '管理员使用用户名和密码登录',
10+
tags: [TagsMap.userLogin],
11+
requestBody: {
12+
content: {
13+
'application/json': {
14+
schema: AdminLoginBodySchema
15+
}
16+
}
17+
},
18+
responses: {
19+
200: {
20+
description: '登录成功',
21+
content: {
22+
'application/json': {
23+
schema: AdminLoginResponseSchema
24+
}
25+
}
26+
}
27+
}
28+
}
29+
}
30+
};

‎packages/global/openapi/index.ts‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,12 @@ export const openAPIDocument = createDocument({
5454
},
5555
{
5656
name: '用户体系',
57-
tags: [TagsMap.userInform, TagsMap.walletBill, TagsMap.walletDiscountCoupon]
57+
tags: [
58+
TagsMap.userInform,
59+
TagsMap.walletBill,
60+
TagsMap.walletDiscountCoupon,
61+
TagsMap.userLogin
62+
]
5863
},
5964
{
6065
name: '通用-核心功能',

0 commit comments

Comments
 (0)