环境设置(管理员)
环境设置仅管理员账户可见。从侧边栏底部齿轮图标(fa-gear, 环境设置)进入。管理员专用菜单集中在同一位置。
| 图标 | 菜单 | 内容 |
|---|---|---|
fa-users | 用户管理 | 账户创建·角色·密码 |
fa-chart-column | 统计 | 使用量·活动·部署·审计日志 |
fa-gear | 环境设置 | 下列7个标签页 |
环境设置以顶部标签页划分，屏幕底部只需一个[保存]按钮即可保存全部内容(保存后旁边显示 ✓ 저장됨)。但通用标签页的主题·语言·徽标·产品名称会即时生效，无需单独保存。
如果 API 密钥·令牌已作为服务器环境变量注入，相应的输入框会被锁定，并显示 환경변수로 관리 중 徽章和提示文本 "从环境变量注入(此处无法修改)"。要修改值，必须编辑服务器的 .env 并重启。详见密钥管理。
通用 (fa-sliders)
影响范围 — 我看到的 Studio 界面和全体用户看到的品牌展示。
- 主题 — 亮色 / 暗色。即时应用，仅保存到该浏览器。
- 语言 — 中文 / English。同样为个人设置。
- 品牌(白标) — 此处修改的值对所有用户生效。
- 徽标 — png/svg/jpg/webp · 512KB 以下。应用于侧边栏·登录界面·库。可通过恢复默认还原。
- 产品显示名称 — 留空则显示为
PlantPulse Studio。
徽标用正方形透明背景的 PNG/SVG 最清爽(在侧边栏中显示为 24px)。
AI 提供商 (fa-microchip-ai)
影响范围 — 聊天回复和整个应用生成。此项为空则一切功能无法运作。
提供商可从三种中选择，各自独立保存模型·Base URL·密钥。切换提供商时前面的设置保留。
| 提供商 | 模型输入示例 | Base URL |
|---|---|---|
| Anthropic (Claude) | claude-fable-5 · claude-opus-4-8 · claude-sonnet-5 | 不需要输入 |
| OpenAI | gpt-4o · gpt-4.1 · o3 | 可选(默认 https://api.openai.com/v1) |
| OpenAI-Compatible | 服务器提供的模型名 | 必填 — 示例 http://vllm-host:8000/v1 |
- API Key — 已保存则显示
설정됨徽章，留空则保留既有密钥。 - 连接测试 (
fa-plug-circle-check) — 用当前屏幕上输入的值实际连接到提供商。保存前可按，也无需保存。成功显示绿色勾号，失败显示红色标记并给出原因。
早期版本这个按钮仅在"平台"标签页有，AI 标签页只能输入值、保存后才能通过聊天来判断正确性。现在保存前就能确认 — 可立即发现地址笔误·密钥过期·网关离线等问题。
在隔离网络中，用OpenAI-Compatible指向内部 vLLM/Ollama 网关，可在不连外网的情况下运营。
代理行为 (fa-robot)
影响范围 — 代理生成应用的方式和输出结果的一致性。
- 默认提示词(运维人员补充指令) — 追加到所有对话的系统提示词后面(最多 4000 字)。输入公司规范·偏好库·屏幕样式指南。例: "所有屏幕顶部插入公司徽标。图表色系统一为深蓝色。"
- 构建器引擎 —
내장 엔진 (기본)/OpenHands 사이드카 (추천)。仅影响应用构建，对聊天(查询)无影响。如环境已安装 Sidecar，OpenHands 更擅长复杂编辑。 - 视觉自检 — 轮次结束时由 AI 审查屏幕截图并自动修复布局问题。品质提升，但令牌消耗增加。
- 单轮最大工具步数 — 4~48，默认 24。一次请求中代理读取和修改文件的上限次数。复杂应用频繁出现"超过最大步数"则可提升至 32。
- 响应最大令牌 — 1,000~200,000，默认 128000。过低则长代码会被截断。
构建标准
固定生成应用的技术栈和布局，防止代理随意偏离。标准栈(React + Vite · TypeScript · ECharts 包装器 · TanStack Query · AppShell/Grid/Section · HashRouter)显示为只读。
- 依赖锁定 — 禁止安装新的 npm 包。建议保持开启(隔离网络中安装会失败导致构建中断)。
- 强制布局规范 — 验证所有屏幕使用公共
AppShell，违规时由代理自动修正。 - 允许例外包 — 逗号分隔(例:
leaflet, framer-motion)。锁定中仍允许此列表内的包安装。 - 应用默认布局(新建应用) — 产品名·标头颜色(例
#0e2a4e)·最大宽度(px，默认 1280)·页脚文字。仅应用于新建应用，不对既有应用溯及。
运行时(服务器全局) (fa-server)
影响范围 — 服务器资源和应用访问地址。全体用户共享设置。
- 并发应用上限 — 1~32，默认 8。同时运行的开发会话数。根据服务器内存调整(每个会话一个开发服务器)。
- 空闲自动停止(分钟) — 0~1440，默认 30。该时间内无操作则停止会话回收资源。0 = 不自动停止。即使停止，工作内容保留，重新打开可继续。
2026-08-23 之前的版本，此标签页有应用源项用于指定预览和部署应用的公开 URL。现在应用在 Studio 同一域名的 /container/ 下提供服务，无需指定。
如从旧版文档查看此项，请参阅域名和反向代理。
应用镜像仓库
部署版本构建为容器镜像并推送的目标。构建器部署抽屉的镜像推送使用此设置，为空时显示"未配置"提示。
- 仓库 URL(例
registry.kopens.io) · 命名空间(例plantpulse-apps) · 用户名 · 访问令牌 - 令牌已保存则显示
저장됨 — 변경 시에만 입력。
平台集成 (fa-plug)
影响范围 — 实时数据。无此密钥则无法查询站点·资产·标签，应用将使用假数据生成。
- 平台 API 密钥 — 输入平台颁发的
X-API-Key。已存在则显示설정됨，由环境变量注入则被환경변수로 관리 중锁定。 - 连接测试 — 保存前即时验证密钥有效性。成功显示
연결됨，失败则显示原因。
平台连接状态可从屏幕底部状态栏随时查看(已连接 / 响应异常 / 断开)。
Git 集成 (fa-code-branch)
影响范围 — 生成的应用源码是否保存到客户仓库。
- GitLab / GitHub 选择 — 选 GitHub 则服务器 URL 固定为
https://github.com。 - 服务器 URL(例
https://gitlab.example.com) · 命名空间(组织/组)(例myorg/apps) - 用户名(可选) — 留空则用默认值
oauth2认证。 - 访问令牌 —
glpat-…/ghp_…。已保存，留空时保留既有值。 - 部署时自动推送 — 部署应用时同步推送到远程 Git 项目。需形状管理的组织建议开启。
MCP (fa-diagram-project)
影响范围 — 代理可用的工具范围。
从 MCP 服务器公开工具给代理。除内置平台服务器外，还可添加外部 MCP 服务器(Streamable HTTP)，新工具自动生效(默认开启)。
- 服务器列表 — 每行显示状态 LED·名称·地址·
도구 n개·激活复选框。内置服务器带내장徽章。点击行可展开该服务器的工具列表。 - 添加 MCP 服务器 — 输入 ID·名称·URL·认证头·令牌。
- 按工具公开 — 每个工具可独立控制激活 / 聊天 / 构建。需在聊天中使用但构建中禁用时有用。
- 重新发现工具 — 外部服务器新增工具但列表未显示时按此。若显示"未发现工具"则检查服务器连接。
- 冲突 — 多个服务器有同名工具时，先注册的优先，后注册的不公开。
外部 MCP 服务器地址末尾必须带斜杠(例 https://host/mcp/)。遗漏则连接失败。
用户管理
从侧边栏 fa-users 进入。表格显示ID · 名称 · 角色 · 来源 · 创建日期。
角色有三种。
| 角色 | 权限 |
|---|---|
| 管理员 | 全部 — 含环境设置·用户管理·统计 |
| 构建者 | 应用创建·编辑·部署，监视器·技能管理 |
| 查看者 | 仅查询 — 无法创建应用("查看者权限无法创建应用") |
来源为 환경변수 的账户由服务器配置生成，屏幕无法修改或删除。仅 스튜디오 账户可进行：
- 添加用户 — 输入 ID·密码·名称·角色
- 修改角色 · 重设密码(6 字符以上) · 删除
- 点击列表中的头像可更改用户头像
统计
从侧边栏 fa-chart-column 进入。时间范围可选7 天 / 30 天 / 90 天。
顶部五项关键指标：应用总数 · 已部署应用 · 对话数 · 活跃技能 · 工厂规模(站点数·标签数)。
| 标签页 | 内容 |
|---|---|
| AI 使用量 | 代理轮次·输入/输出令牌，按日期·用户·项目分类，构建器引擎对比 |
| 活动 | 日活动量(按操作分类)、活跃用户、最近重要事件 |
| 应用 | 新建应用趋势、部署状态、部署版本热门应用、模板使用排行 |
| 聊天 | 日提问数、提问最多的用户 |
| 部署 | 部署尝试·成功·失败，日成功/失败，最近部署记录 |
| 审计日志 | 时间·用户·操作·对象·详情(支持搜索) |
AI 使用量中令牌激增说明监视器周期过短或"视觉自检"在大量构建时开启。部署标签页的失败数应配合故障排除查看。