在codex中实现侧边导航折叠需配置\_codex.yml:全局启用collapsible: true,用空格缩进定义层级,子菜单默认展开;通过collapsed: true或title+items结构指定默认收起;验证需启动服务并在窄屏下测试箭头交互与真实收起效果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Codex中制作可折叠的侧边导航,需借助其内置的YAML元数据控制菜单层级与展开状态,不能仅靠CSS或JavaScript手动添加交互。
启用侧边导航折叠功能
打开项目根目录下的 _codex.yml 文件,在 menu 节点下添加 collapsible: true 配置项。
这一步必须在全局配置中声明,否则所有子菜单默认保持展开,无法响应点击收起动作。
为菜单项设置嵌套层级
在 _codex.yml 的 menu 列表中,用缩进表示层级关系:一级菜单顶格写,二级菜单缩进两个空格,三级再加两个空格。
缩进必须使用空格(不能用Tab),Codex解析器会严格校验缩进格式,错一位就会导致整个菜单渲染失败且无报错提示。
- 主题配置
- 颜色方案
- 字体设置
- 布局模式
- 插件管理
- 已启用插件
- 安装新插件
指定某菜单组默认收起
方法一:在对应菜单项后添加 collapsed: true 标记
通过 Codex CLI 生成图片,支持尺寸控制和批量模式。依赖:codex (npm)。代理默认启用。用 generate.sh 生成单张,batch_generate.sh 批量生成游戏 UI 素材,gen_size.sh 指定尺寸。所有输出保存至 ~/.codex/generated_images/。
- 主题配置
collapsed: true
- 颜色方案
- 字体设置
方法二:用 title + items 结构显式声明折叠组
- title: “插件管理”
collapsed: true
items:
- 已启用插件
- 安装新插件
注意:方法二中 items 下的条目必须缩进四格,比 collapsed: 行多两格,否则解析时会被忽略。
验证折叠行为是否生效
第一步:执行 codex serve 启动本地服务。
第二步:在浏览器中打开文档站点,将窗口宽度调至小于 1200px,观察左侧导航栏是否出现箭头图标。
第三步:点击箭头图标,确认对应子菜单能展开/收起,且收起后不占用垂直空间——如果子菜单仍显示为占位空白,说明 YAML 中缩进有误或 collapsed 写在了错误层级。










