跳到主要内容

环境设置（管理员）

环境设置仅对管理员账号可见。通过侧边栏最下方的齿轮图标（fa-gear，环境设置）进入。同一位置也集中了管理员专用菜单。

图标菜单内容
fa-users用户管理账号创建·角色·密码
fa-chart-column统计使用量·活动·部署·审计日志
fa-gear环境设置下方7个标签页

环境设置分为多个标签页，通过页面最下方的单个[保存]按钮一次性保存所有内容（保存后旁边会出现✓ 저장됨）。但一般标签页中的主题·语言·Logo·产品名称会即时生效，无需单独保存。

环境变量值不是锁定的 «默认值»

如果API密钥·令牌已通过服务器环境变量传入，则相应输入框会显示환경변수 기본값徽章， 空输入框中会显示**「正在使用环境变量值 — 若输入将覆盖」**的浅色提示。

输入框不会被锁定。 在此处输入值将会覆盖环境变量，并无需重启即可立即 生效。清空输入框则继续使用环境变量值。

这意味着需要紧急更换密钥时，无需登录服务器修改.env并重启。 但请注意，在界面中覆盖的值仅保留在此安装中，若需永久更改，请同时调整环境变量 → 密码管理

一般 (fa-sliders)​

影响范围 — 我所看到的Studio界面，以及所有用户可见的品牌信息。

  • 主题 — 浅色 / 深色。即时生效，仅保存于当前浏览器。
  • 语言 — 韩语 / English。同样属于个人设置。
  • 品牌（白标） — 此处修改的值将应用于所有用户。
    • Logo — png/svg/jpg/webp · 512KB以内。应用于侧边栏·登录界面·图库。可使用恢复默认还原。
    • 产品显示名称 — 留空则将显示为PlantPulse Studio。
提示

Logo使用接近正方形的透明背景PNG/SVG效果最佳（在侧边栏会缩小至24px显示）。

AI服务提供商 (fa-microchip-ai)​

影响范围 — 所有聊天响应和应用生成。此处为空则一切功能无法运行。

可从三种服务商中选择，每个分别记忆各自的模型·Base URL·密钥。切换后之前的设置仍然保留。

服务商模型输入示例Base URL
Anthropic (Claude)claude-fable-5 · claude-opus-4-8 · claude-sonnet-5无需输入
OpenAIgpt-4o · gpt-4.1 · o3可选（默认https://api.openai.com/v1）
OpenAI-Compatible服务器所提供的模型名必填 — 例如http://vllm-host:8000/v1
  • API密钥 — 若已保存，则显示설정됨徽章；留空则保留现有密钥。
  • 连接测试 (fa-plug-circle-check) — 使用当前界面输入的值实际连接服务商。 保存前也可点击测试，无需保存。成功则显示绿色对勾， 失败则显示红色标记并附带原因。
已输入密钥但聊天功能无法使用时，请从此处开始排查

将在保存前进行验证 — 可快速排查地址输入错误·密钥过期·网关不可用等问题。

建议

在隔离网络环境中，可将 OpenAI-Compatible 指定为内部vLLM/Ollama网关，即可在不进行外部通信的情况下运行。

代理行为 (fa-robot)​

影响范围 — 代理创建应用的方式以及结果的一致性。

  • 默认提示词（操作员附加指令） — 附加在所有对话的系统提示词之后（最长4000字符）。请填写公司规范·偏好库·界面风格指令。例如："所有页面顶部放置公司Logo。图表颜色统一使用深蓝色系。"
  • 构建引擎 — 내장 엔진 (기본) / 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 = 不自动停止。 停止后工作内容仍保留，重新打开可继续。
没有可指定应用源的项目

应用在Studio的同一域名下的/container/路径中提供服务，因此无需指定。 代理配置请参阅域名与反向代理。

应用镜像仓库​

构建部署版本为容器镜像并push的目标地址。构建器 部署抽屉中的镜像push使用此设置，若为空则对应按钮会显示“未配置”提示。

  • 仓库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·姓名·角色·来源·创建日期。

角色有三种。

角色权限
管理员全部 — 包括环境设置·用户管理·统计
构建者应用创建·修改·部署，Watcher·技能管理
查看者只读 — 无法创建应用（“查看者权限无法创建应用”）

来源为환경변수的账号是由服务器配置创建的，无法在界面中修改或删除。仅스튜디오账号可执行以下操作。

  • 添加用户 — 输入ID·密码·姓名·角色
  • 修改角色 · 重置密码（至少6位） · 删除
  • 点击列表中的头像可更换头像图片

统计​

通过侧边栏fa-chart-column进入。时间范围可选择7天 / 30天 / 90天。

顶部五个KPI：全部应用 · 已部署应用 · 对话 · 活跃技能 · 工厂规模（站点数·标签数）。

标签页查看内容
AI使用量代理轮次·输入/输出令牌，按日·按用户·按项目，构建引擎对比
活动每日活动（按操作分类），活跃用户，近期重要事件
应用新应用趋势，部署状态，部署版本靠前的应用，模板使用排行
聊天每日提问数，提问多的用户
部署部署尝试·成功·失败，每日成功/失败，近期部署记录
审计日志时间·用户·操作·对象·详情（支持搜索）
每月巡检项目

若AI使用量中令牌数激增，很可能是Watcher周期过短或开启了“视觉自检”时进行了大量构建。部署页签中的失败数量可结合问题排查一起确认。