Codex怎么给应用添加设置页面

风芳同学_3364

风芳同学_3364

2026-11-18

738人浏览

原创

必须在插件根目录添加settings.json并声明has_settings_page:true,且settings.json需含title、description、schema和handler字段,handler文件须导出handleSettingsUpdate函数处理保存逻辑。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

codex怎么给应用添加设置页面

要在 Codex 应用中为自定义插件或 Skill 添加设置页面,必须通过修改其配置文件并注册 UI 入口实现,不能仅靠前端 HTML 或弹窗模拟——Codex 不会识别未声明的设置路径。

确认插件已正确加载并具备设置能力

打开 Codex App → 点击左上角「插件」图标 → 查看目标插件是否显示为「已启用」且状态为绿色。若插件名灰显或带「⚠️」,说明它未完成注册或缺少 settings.json 声明,此时添加设置页无效。

插件根目录下必须存在 【settings.json】 文件,且该文件需导出一个合法 JSON 对象,字段包括 title、description、schema(JSON Schema 格式定义表单项)和 handler(指向处理保存逻辑的函数路径)。

编写 settings.json 配置文件

在插件主目录(如 ./my-skill/)中新建或编辑 settings.json:

```json
{"title": "我的数据处理器设置",
"description": "控制API密钥与超时行为",
"schema": {
"type": "object",
"properties": {
"api_key": {"type": "string", "title": "API密钥", "description": "用于认证第三方服务"},
"timeout_ms": {"type": "integer", "title": "请求超时(毫秒)", "default": 5000}
}},
"handler": "./src/handlers/settings-handler.ts"
}```

注意:schema 中每个字段的 type 必须是 JSON Schema 支持的基础类型(string/integer/boolean/object/array),Codex 不支持自定义 widget 类型或 condition 规则;handler 路径必须相对于插件根目录,且对应文件需导出 async function handleSettingsUpdate(settings: Record): Promise。

注册设置入口到插件 manifest

打开插件的 manifest.json(或 plugin.yaml,取决于插件类型),在顶层添加:
【"has_settings_page": true】

qapten-codex
qapten-codex

分步指南,教你如何使用OpenAI Codex CLI编写代码、管理GitHub仓库以及部署到服务器。需要codex CLI、git,可选使用令牌。

下载

若使用 YAML 格式,则写为:
has_settings_page: true
此字段是 Codex 加载设置页的开关,缺失将导致插件在「插件」列表中不显示「⚙️ 设置」按钮,即使 settings.json 存在也无效。

实现 settings-handler.ts 处理逻辑

创建 ./src/handlers/settings-handler.ts,内容必须包含:

```ts
import { SettingsUpdateEvent } from '@codex/core';

export async function handleSettingsUpdate(event: SettingsUpdateEvent) {
const { settings, previousSettings } = event;
// 保存到本地存储或触发重连逻辑
await window.localStorage.setItem('my-skill:config', JSON.stringify(settings));
}
```

该函数会在用户点击「保存」后立即执行,Codex 会自动注入 SettingsUpdateEvent 参数。不要在此函数中调用 alert() 或直接操作 DOM,Codex 的设置页运行在受限上下文中,仅允许异步持久化或触发事件。

重启插件并访问设置页

方法一:在 Codex App 中按 Ctrl+R(Windows)或 Cmd+R(Mac)强制重载所有插件 → 找到你的插件 → 点击右侧 ⚙️ 图标。
方法二:在插件目录中执行 【codex-plugin reload --force】(需 CLI 已安装并登录)→ 等待终端返回「Reloaded successfully」→ 切回 App 点击设置图标。
首次加载可能延迟 1–2 秒,因 Codex 需解析 schema 并渲染表单;若页面空白,检查控制台是否有「Failed to load settings handler」错误,大概率是 handler 路径拼写错误或导出函数名不符。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

codex codex应用开发

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Codex AI 编程代理与智能开发工作流
Codex AI 编程代理与智能开发工作流

Codex 是一款超越传统代码生成的 AI 编程代理,致力于构建全生命周期的智能开发工作流。通过持久线程保留上下文,支持多智能体并行协作与后台自动化运维。借助沙箱权限控制、Plan/Steer 任务管理机制,Codex 既能自主拆解并执行复杂工程任务,又能让开发者牢牢掌控项目进程。从需求分析、编码测试到代码审查与部署,Codex 将 AI 深度融入研发全链路,极大提升了软件工程的交付效率与质量标准。

2026.05.26

734

10

Codex API集成与AI编程生态开发
Codex API集成与AI编程生态开发

Codex API 集成是构建下一代 AI 编程生态的核心基石,能通过 API 将强大的代码生成与推理能力无缝接入 VS Code、JetBrains 等主流 IDE 插件,还能将其深度嵌入 CI/CD 流水线,实现自动化的代码审查、单元测试生成与 Bug 修复。结合 Amazon Bedrock 等云平台的托管服务,企业可以灵活打造符合内部安全规范的专属 AI 编程助手。

2026.05.26

264

10

Codex 模型原理与AI软件工程进阶
Codex 模型原理与AI软件工程进阶

Codex 是基于通用大模型底座,通过海量代码语料与真实 Pull Request 进行专项微调的代码专用模型,能深度理解代码语法树与跨文件依赖,实现从自然语言到高质量工程代码的精准转化。在 AI 软件工程进阶中,Codex 推动了从提示词工程向“驾驭工程(Harness Engineering)”的范式跃迁。

2026.05.26

197

10

Codex AI编程工具新手指南
Codex AI编程工具新手指南

全面解析Codex AI编程工具的核心原理、功能特点与实际用途,提供适合新手的Codex入门教程、环境配置方法、代码生成演示与常见问题解答,帮助开发者快速掌握AI自动写代码能力,提升编程学习与开发效率。

2026.05.27

430

10

Codex Agent编程与自主开发能力调优专题
Codex Agent编程与自主开发能力调优专题

PHP中文网为您提供Codex Agent编程与自主开发能力调优专题。针对AI Agent全权委托开发模式,我们为您系统梳理了Harness Engineering(驾驭工程)核心理念,以及涵盖AGENTS.md规范编写、Skills技能配置、Worktree沙盒隔离与多Agent协作架构的实战指南。

2026.06.10

248

7

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

140

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

100

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

100

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

160

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Codex 应用程序简介
Codex 应用程序简介

共0课时 | 192人学习

Codex官方文档
Codex官方文档

共0课时 | 0人学习