讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

SoundView
SoundView

字幕擦除翻译、配音口型同步

剧云
剧云

中文短剧剧本制作平台

Seko
Seko

AI短剧一键生成成片

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

风芳同学_3364

风芳同学_3364

发布时间:2026-11-18 10:47:19

|

738人浏览过

|

来源于php中文网

原创

必须在插件根目录添加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。

qapten-codex
qapten-codex

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

下载

注册设置入口到插件 manifest

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

若使用 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 路径拼写错误或导出函数名不符。

热门AI工具

更多
墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

相关专题

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

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

734

2026.05.26

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

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

264

2026.05.26

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

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

197

2026.05.26

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

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

430

2026.05.27

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

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

248

2026.06.10

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

0

2026.11.17

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

0

2026.11.17

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

0

2026.11.17

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

0

2026.11.17

热门下载

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

精品课程

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

共0课时 | 192人学习

Codex官方文档
Codex官方文档

共0课时 | 0人学习

Codex官方文档
Codex官方文档

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn