AIYOUcodex

与更强的你，一起构建可能。

AIYOUcodex 是一套面向 macOS 与 Windows Codex 桌面体验的本地交互工作台。它为对话增加摘要、最近消息预览、双列卡片、项目标签搜索、最近使用排序和额度展示，并默认集成本地项目管理看板、Skills 分组和多媒体资产库，同时不修改应用包或对话正文。

GitHub 开源地址：https://github.com/yubowen123/AIYOUCODEX

每款主题都可独立下载，安装后通过「主题与动效」切换。新增动态 / 静态卡片配色、背景与边框颜色、边框粗细、流光颜色；透明度保持独立调节。浠浠主题以 ⭐ 标记社区共创，并在下方和主题设置页保留特别鸣谢。

机甲控制舱 · v1.4.3 ↓ 独立下载 原生截图 · 截图早于本次卡片配置更新	粉嫩软糖 · v1.0.4 ↓ 独立下载 原生截图 · 截图早于本次卡片配置更新
⭐ 海边度假·浠浠 · v1.2.0 ↓ 独立下载 社区共创 · 特别鸣谢 素材预览，原生安装效果待验证	⭐ 海底假日·海绵宝宝 · v1.0.2 ↓ 独立下载 浠浠设计 · 社区共创
⭐ YOYO萌趣歪头·浠浠 · v1.3.2 ↓ 独立下载 浠浠设计 · 社区共创 · 素材预览	⭐ 小新四图轮播·浠浠 · v1.0.2 ↓ 独立下载 浠浠设计 · 社区共创 · 素材预览
海岛心动陪伴 · v1.0.2 ↓ 独立下载 连续视频 · 声音默认关闭 视频预览与使用说明

⭐ 特别鸣谢 · 浠浠（xixi）：海边度假、海底假日、YOYO萌趣歪头与小新四图轮播主题设计 / 社区贡献者。主题说明保留署名与素材权利边界：海边度假 · 海底假日 · YOYO萌趣歪头 · 小新四图轮播。

查看主题安装与配置。本次新增控件通过隔离浏览器测试；上述旧原生截图和素材预览不代表新增控件的实机验收。

当前发行版：v1.7.1。项目管理、Skills 分组、本地资产库、快捷入口设置及对应的 macOS/Windows 后台运行时会作为同一安装包更新，不需要分别安装。

v1.4.0 将菜单功能统一为不打断对话的右侧面板：可以直接在项目对话里搜索项目、Skills 或资产，并把 Skill 与本地资产安全预填到当前输入框，不会自动发送。

设置底部新增 关闭插件：移除 AIYOUcodex 增强界面、暂停自有工作服务，保留原生 Codex、草稿与配置。刷新、后台恢复和登录启动不自动启用；再次手动打开 AIYOUcodex 可恢复。原有“退出 AIYOUcodex”仍用于退出整个应用。关闭与恢复说明

10 月 8—14 日：卡片配色与社区主题、实时排序与对话菜单、MOKE 集成、Agent 工作区、OpenChatCut 对话剪辑、DeepSeek、Skills / 资产搜索、模块加载恢复，以及新的关闭入口。

卡片由 Codex Image 生成，配图来自 7 款现有主题素材；属于素材展示，原生效果与平台范围见本周更新详情。下载 v1.7.1

原生模型菜单新增 DeepSeek V4.1 Flash，保留 GPT 与现有登录；同一对话可双向切换，长上下文按目标模型窗口处理。设置页支持保存自己的 DeepSeek API Key。自动接入目前限 macOS，更新后完整退出并从 AIYOUcodex 入口重开；Windows 尚未启用自动代理。DeepSeek 使用说明

Skills 与资产库新增 Laya / 普通搜索切换；资产搜索按名称、标签与已有资料文本匹配，并显示命中摘要。多个面板补齐加载、慢连接与失败重试状态，保留已加载内容和未发送草稿；设置新增明确退出入口。海岛心动陪伴 v1.0.2 随包提供，视频声音默认关闭。

发行说明与验证范围 · 下载 v1.7.0

Agent 工作区支持本机 Agent 发现、资源与对话选择、迁移预览、哈希校验、回执和撤销；Claude 原生文本导入与其他 Agent 可读副本分别提示。OpenChatCut 按当前对话绑定独立工程，右侧保留素材、预览与时间线；整合后台冷启动恢复、工具栏与提示条修复。

本版还包含快捷入口拖动排序、项目看板断连恢复、自动生成 NPC 对话过滤，以及便携 Node 的原生插件启动修复。Agent 预览中的凭证先拒绝再落盘，迁移计划和运行状态不会随源码发布。发行说明与验证范围

卡片通过 DramaTV MCP 的 GPT-image-2.5 生成，2k 档位，原图 1440×2560 PNG；主题配图为示意插画，状态与未验收项见图中文字。

左侧 OpenChatCut 入口和设置共用安装状态；大型官方应用按需下载，支持校验、续传和原子安装。轻量原生 MCP 插件随 AIYOUcodex 注册，视频剪辑默认使用当前对话的独立工程，右侧真实编辑器同步时间线操作。

Mac arm64 已通过真实素材导入、裁剪、工程保存、H.264/AAC 导出和桥接重连验证。Mac x64/Linux x64 有自动安装实现，尚未真机验证；Windows 当前提供官方手动安装入口及已有应用检测。转写、音乐分析和模型生成需另行配置相应资源。插件说明

历史消息滚动保持阅读位置；“最近”过滤子 Agent 对话；右键菜单跟随卡片主题，补齐置顶、重命名、归档和移动项目。MOKE 官网 Logo 入口使用原生右侧浏览器，MCP 插件随安装集成。

验证进展（2026-10-11）： 本机 MOKE 只读目录查询成功；这不代表通用 OAuth 或所有安装环境均已验证。原生菜单页面加载仍待实机确认。Windows 安装与交互以相应 CI 和实机结果为准。更新详情与验证范围

卡片由 Codex Image 生成，其中真实界面示例来自 10 月 8 日的教程截图；以上源码更新现已纳入 v1.6.0。

侧栏边框与状态光晕完整显示；“最近”接入实时会话目录并自动更新排序，首批 30 条后可加载更多；“置顶”按最新对话时间倒序。粉嫩软糖气泡在聊天区域重建时保持统一留白，主题 Skill 补齐插件展开和拖动边界标准。

87 项侧栏及相关专项回归通过，并完成当前 Codex 实机核验。修复说明与验证

卡片使用 Codex Image 生成；其中界面素材来自当前原生 Codex，卡片文案已替换为教程示例。本节为主分支源码更新，发行包版本以 Releases 页面为准。

• 扩展功能统一右侧并排：Skills、Claude、模型竞技场、项目管理、设置和重置详情分配独立宽度，保留聊天与输入区，支持关闭和调整宽度。
• 对话设置跟随主题：重做对话信息卡、设置入口和项目选择器，自动使用机甲、粉嫩软糖或默认主题的颜色、边框、圆角与透明度，保留现有皮肤配置。
• 右键移动对话：卡片右键进入对话设置，选择目标项目后通过原生项目服务保存；列表读回确认后再显示成功。同名对话按准确 ID 区分。
• 新建沿用当前项目：在项目内新建对话时默认传递当前项目和文件夹，减少重复选择。
• 重置追踪覆盖回复：采集 Tibo 帖子及回复，保留来源与引用关系；顶部展示未来 24 小时重置概率估计，详情区分已完成、未来预告与实际账号到账。

截图直接截取当前原生 Codex；仅将私人对话、项目名称匿名化，不修改业务数据。概率来自公开信号规则，未经统计校准；证据评分不代表账号一定重置。查看本次修复、截图与验证范围。本节为 main 源码更新，既有 v1.5.0 发布包保持原样。

• 重启自动加载：安装器启用登录启动、增强恢复和主题后台服务，解除系统禁用标记；自动恢复等待会话空闲，重复打开不重启健康服务。
• 机甲与粉嫩软糖同时保留：最新机甲控制舱 v1.4.2 与粉嫩软糖 v1.0.2 共存，独立保存配置；升级基础模块保留原有皮肤，可回到系统默认。
• 完整主题配置：静态图 / GIF / 视频背景、七个事件媒体槽、输入框内外分层透明度、独立文字颜色、实时预览、取消和保存。
• 按参考图构建主题：新增 aiyoucodex-theme-builder Skill，包含独立身份模板、色卡与资源验证、编译安装和原生检查。
• 近期交互更新合并发布：Tibo 记录中文摘要与明确预告识别、Claude 交互与快捷指令、远程项目列表和执行状态、本地 Laya 搜索，以及右上角文件/上下文入口。

知识卡片中的皮肤画面为插画示意；真实皮肤以本页原生截图与动态实录为准。

上方 GIF 与截图直接录制当前原生 Codex，私人对话和输入草稿已隐藏。查看完整更新详情与截图、安装与主题配置和主题 Skill。整机重启与 Windows 原生主题效果未在本次实机验证。

• Dot / Claude 双入口：同一行并排显示，小字号 #595959、淡阴影。Claude 使用自己的居中 Logo 与名称；点击头像或名字可配置角色名称、上传 Logo、填写角色说明，本机保存，重启保留，侧栏同步。打开 Claude 不显示 Dot 的悬浮头像，返回 Dot 恢复原状。
• 同项目协作，独立会话：Claude 选择真实本机 Codex 项目；Skills 和标准 MCP 收进输入框「＋」引用菜单。会话支持流式回复、停止、继续与工具确认，不自动改动 Codex 对话；宿主专用工具标明不能直接迁移。沿用已安装 Claude Code 的模型、登录与供应商配置。完整说明
• 远程项目也能看见：项目标签纳入宿主保存的远程项目，用「远」角标标识；机器和项目 ID 区分同名项。远程会话由原生连接加载，不把远程目录当成本机 Claude 工作目录。
• 角色资产关联：资产库增加紧凑缩略图 / 详情视图与侧边分类；按角色名称、生成参考和明确同角色线索关联基准图、状态图及风格衍生图，分组相邻排列后分页。可编辑角色名、状态、样式和来源，或排除错误关联；人工确认优先，不改素材原文件。识别边界
• 相似只是候选：按需比较已经加载的缩略图，提供画面构图 / 色彩相似候选；不上传图片、不后台扫描、不调用模型，也不声称人脸或角色身份识别。没有可靠名字或来源的图片不会强行合并。
• 双击仍是预览：文本、图片、音频和视频双击查看详情；通过明确的「添加到对话」操作引用，不自动发送。项目排序、新建项目和新建对话入口保留独立操作；修复跨页面挂载与编辑面板遮挡。
• 公开安装补齐 Claude 依赖：有 npm 时按锁文件安装桥接依赖，禁用安装脚本；失败在替换前停止，保留旧安装。没有 npm 时保留基础增强，并提示安装带 npm 的 Node.js 后重跑；Claude Code 本身仍需自行安装、配置。

以上是 main 源码更新，不代表所有供应商模型或 Windows 桌面已实机验收；角色提示词经过模拟 SDK 验证，原生 macOS 头像、设置、保存回读和 Dot 切换已经检查。

• 新版 Codex 按原生导航标记将整排快捷入口移入最左侧滚动图标栏：新对话、已配置网页入口、模型竞技场、Skills 分组、项目管理、资产控制台及设置；顶部不再重复横排，保留宿主原有图标和底部帮助/账号。兼容隐藏文本标签与窗口缩放；只有无新版导航栏的旧版使用横向快捷栏。

• 设置移出顶栏，卡片/列表切换收纳进设置；菜单支持隐藏/恢复，宿主重绘后重新挂载。新版顶栏不再提供旧标题标记、或将右侧操作拆成独立按钮时，“打开文件”和“任务上下文”仍定位在原生右侧操作区；仅在当前对话身份可核验时显示。

• 顶部用量左侧增加“重置公告”：订阅公开 RSS，新帖子去重后再核验，保留原帖、适用范围与检查状态。

• 设置 → 重置公告监控：默认每 15 分钟检查 RSS，可输入 1–10080 分钟，支持暂停/恢复、缓存去重与失败退避；不扫描 X 页面、不唤醒 Codex 对话。保存到模块本地计划，并核对后台运行状态和下次监控时间。

• 时间明确才显示倒计时，临近时从黄橙渐变为红色；模糊时间不猜测，完成/取消公告停止旧倒计时。到时仅表示“待核验”，不会兑换重置券。

• 公告本地持久保存，由独立 worker 采集 RSS、去重并按保守规则判断，不创建 Codex 定时对话、不调用模型。失败保留记录与设置草稿，无变化保持安静；规则未覆盖的表达留在历史信号中。

macOS 安装独立登录后台服务，Windows 由 AIYOUcodex 运行时托管；旧 heartbeat 迁移后应暂停，防止重复。详见启用与设置说明。

查看本次更新知识卡片（单张长图）

• 在“资产控制台”后新增 模型竞技场，以可收起的右侧面板展示，保留当前对话。
• 在生成页直接切换图片竞技 / 视频竞技；API 与模型配置统一放到右上角，不再重复占用第一步。生成页只展示已配置且已启用的可用模型；没有可用模型时直接引导配置。
• 图片目录覆盖 OpenAI、阿里云百炼、火山方舟、Google、Stability AI、Black Forest Labs 六个家族共 29 个条目，支持提示词、参考图 @ 引用、多模型并发、横向结果和本地网格拼接图；目录模型默认关闭，按账号实际能力启用。
• 视频继续支持 Wan 3.0、Seedance 2.0 / Fast / Mini / 2.5、MiniMax H3 六模型对比；H3 分辨率为 768P、2K。两种模式都按已选模型的共同能力限制比例、分辨率与素材数量，不静默删除素材。
• 先预览请求，再确认上传与生成；任务本地持久保存，提交结果不明时不自动重复发送。图片和视频结果均可横向滚动比较，并可定位本地产物。

重新运行本仓库安装命令即可更新；真实供应商生成需配置自己的账号并确认。素材探测与合成需要本机 FFmpeg / FFprobe。公开包不附带账号、内部通道或生成额度。详见配置、操作与验证范围。

• 默认全部，六类自动整理：影视分镜、图像设计、音频音乐、写作研究、办公协作、开发工具。分类按钮和卡片在后台刷新时保持稳定，避免按下与松开之间重绘吞掉点击；介绍保留两行。
• 分类由你决定：自定义分类可新建、改名、删除；右键移动分类或恢复自动分类。手动选择优先，重启后保留，只改分组不搬动源文件。
• 单击查看使用介绍：弹窗按需读取准确的 SKILL.md，展示用途、场景、用法及文件明确提供的输入和交付物；保留原始说明与“添加到对话”。
• 右键追溯来源：优先打开最近可验证的优化对话，否则打开创建对话；普通使用、提及和失败修改不算来源，无可靠记录不猜测跳转。
• 准确定位文件：右键“打开所在文件”在 Finder / 资源管理器中选中该 Skill 的 SKILL.md，同名不同来源互不混淆。
• 本地增量处理：分类和追溯不额外调用模型；追溯首次建索引，之后只处理新增或替换的记录。配置、索引与私人入口均不进入开源包。
• Windows 保存兼容修复：资产库配置遇到短暂文件占用时有界重试原子替换，不删除旧配置；持续占用仍明确报错。

重新运行下方安装命令更新，打开 Skills 分组 即可使用。查看不执行、添加不自动发送。历史来源是否可追溯取决于是否保留成功修改证据，详见完整使用说明与覆盖边界。

查看 Skills 更新知识卡片（单张长图）

• 每个对话一个文件夹：在所属工作区下建立同名目录，按对话 ID 持久绑定；同名自动避让，重启复用，不批量搬迁历史文件。
• 对话改名，目录跟随：保留已有文件，运行中延迟到完成或下一轮开始前同步；遇到目录丢失、占用或绑定异常时明确提示。
• 右上角文件与上下文图标：“打开文件”和“任务上下文”位于原生右侧工具按钮组，悬停可见说明。打开母文件夹会定位并选中本对话目录；打开子文件夹直接进入，不再混淆工作区与对话目录。
• 项目操作按钮恢复：项目 Tab 右侧按钮组和搜索行的排序、创建项目入口在局部重绘、节点替换后自动修复；各按钮按原生操作类型执行，不把不同操作统一跳转到项目列表。新建对话始终按当前所选文件夹解析入口。
• 新产出默认归入对话目录：通过原生会话钩子提供保存路径，覆盖文本、图片、音频、视频和报告。安装会合并钩子配置，但须先在原生 /hooks 审阅信任处理器；目录已创建不代表模型已收到规则。原项目代码仍原位修改，用户指定路径优先，规则不是强制文件系统隔离。
• 通用网页入口兼容预览：可选原生侧边浏览器标签复用与展开/收起，避免反复发送首页 URL。默认不启用，不绕过宿主安全策略；跨重启恢复与后台持续执行由 Codex 控制，尚不作保证。

重新运行下方安装命令更新。启用保存规则后，在新一轮消息中检查实际产出路径。详见对话文件夹与启用说明及网页入口兼容边界。

查看本次更新知识卡片

• 关闭更好点：项目管理新增独立关闭按钮，自动避开 Codex 原生右上角工具栏；点击区域为 40×40，随工具栏高度、窗口宽度和缩放调整。
• 菜单可展开 / 收起：再次点击项目管理、Skills 分组、资产控制台、内置自定义入口或任务上下文即可收起；命令检索仍按“打开并定位”执行，不因重复调用意外收起。
• 看板按最近消息排序：六个泳道及单项目任务列表按关联对话或议题评论的最新消息倒序排列；没有消息时按创建时间回退。修改属性不再把旧任务顶到前面。
• 优先级一眼可见：项目管理卡片边框统一为紧急红色、高优先级黄色、低优先级绿色。
• 当前任务用量：右上角“任务上下文”展示本对话累计、最近一次模型请求及输入 / 输出 / 缓存明细，明确区别于账号额度与文件夹总量。刷新不覆盖未保存草稿，缺失记录不估算。

重新运行下方对应系统的安装命令即可更新；本地项目、资产索引、任务卡与私人入口配置继续保留。详见任务上下文与用量说明。

对话右上角新增独立的“任务上下文”：从本地近期消息整理目标、进度、下一步和关键约定，核对后保存；需要继续执行时，先预览完整内容，再确认发送。每条对话独立保存，不替代完整历史，也不覆盖已有输入。

输出偏好与默认 Skills 保留在设置中，按全局、项目目录、当前任务分层管理。原生 Hooks 需要审阅启用，保存配置不等于已加载；本次不承诺固定 Token 节省比例。

设置入口在主内容结构变化时使用独立的屏幕内面板；打开失败会保留原设置并提示重试，不再静默关闭。

查看本次更新知识卡片 · 配置与启用说明

在 PowerShell 中粘贴并回车：

irm https://raw.githubusercontent.com/yubowen123/AIYOUCODEX/main/install.ps1 | iex

Windows 安装器会自动：

1. 安装到兼容目录 %LOCALAPPDATA%\Codex Sidebar Enhancer，升级时复用已有配置与数据；
2. 优先复用 Node.js 22.5+；本机缺少时，从 Node.js 官网下载对应架构的便携版 Node 22，并校验 SHA-256；
3. 安装固定版本的本地项目管理看板、Skills 分组层和资产控制台，并在当前用户的“启动”目录创建隐藏后台运行时快捷方式，登录后自动恢复；
4. 在开始菜单创建 AIYOUcodex 启动器，并自动移除旧名称的启动快捷方式；
5. 用本地回环调试端口启动 Codex/ChatGPT。首次启用时，如果应用正在运行，会先询问是否重启一次。

以后可照常打开 Codex/ChatGPT；后台注入器发现普通启动没有增强端口时，会自动纠正启动方式。无需管理员权限。

不想直接执行远程脚本？先查看 install.ps1，或下载仓库后在 PowerShell 运行 .\install.ps1。

在“终端”中粘贴并回车：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/yubowen123/AIYOUCODEX/main/install.sh)"

安装器会自动：

1. 下载到兼容目录 ~/Library/Application Support/Codex Sidebar Enhancer，升级时复用已有配置与数据；
2. 使用系统 Node.js，或 Codex/ChatGPT 桌面应用内置的 Node.js；
3. 安装固定版本的本地项目管理看板、Skills 分组层、资产控制台和用户级 LaunchAgent，登录和应用重启后自动恢复；后台默认不会因为连接暂时不可用而退出或重启 Codex；
4. 在 ~/Applications 创建 AIYOUcodex.app 启动器，并自动移除旧名称的启动器；
5. 打开启动器。首次启用时，如 Codex 正在运行，会重启一次以挂载增强界面。

以后建议从 Spotlight、访达的“应用程序”或 ~/Applications 打开 AIYOUcodex，让启动器配置增强端口。直接打开 Codex/ChatGPT 时，后台会连接已就绪的窗口；若缺少调试端口，默认保留当前对话并等待通过启动器重新打开。注入器只连接 127.0.0.1:9231。

不想直接执行远程脚本？先查看 install.sh，或下载仓库后运行 bash install.sh。

Windows PowerShell：

irm https://raw.githubusercontent.com/yubowen123/AIYOUCODEX/main/uninstall.ps1 | iex

macOS 终端：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/yubowen123/AIYOUCODEX/main/uninstall.sh)"

卸载会停止增强进程，并移除本工具的安装目录、当前用户自启动项、启动器和增强日志，不会删除 Codex 对话或设置。

• Skills 自动与自定义分类：默认打开“全部”，按影视分镜、图像设计、音频音乐、写作研究、办公协作、开发工具 6 类本地自动归类，不调用模型。“分类管理”支持新建、改名、删除自定义分类；右键 Skill 可移动分类、恢复自动分类、添加到对话，或在所在文件夹选中 SKILL.md。手动分类按准确来源持久保存，不移动技能源文件，保留常用收藏与两行介绍。
• 对话专属文件夹：本地对话在所属工作区下创建同名目录，按对话 ID 持久绑定；新交付物默认写入其中，对话改名后同步目录名称，同名对话不混用。生成过程中暂缓改名，任务结束后同步；不批量搬迁历史文件，不改宿主工作区。
• 对话右上角“打开文件”：母文件夹在所属项目目录中选中本对话文件夹，子文件夹直接进入该目录。保存规则通过原生会话钩子传递，安装会合并配置；首次使用须由用户在原生 /hooks 审阅信任。规则不是文件系统强制隔离，第三方工具缓存及显式输出路径仍须按交付规则处理。
• 设置管理智能 / 精简 / 详细输出与默认 Skills，按全局 → 项目目录 → 当前任务继承，独立于收藏。对话右上角的“任务上下文”按对话独立管理目标、进度和下一步：本地近期消息自动提取可编辑草稿，保留来源与待核验标记；确认保存，或预览完整内容后确认向当前对话继续执行，不覆盖已有输入、不打断运行任务。
• 输出偏好通过可审阅的原生 Hooks 按变化加载，不截短完整交付物，不使用 Stop 自动续写；界面区分“已保存”和真实加载回执，只显示 Codex 已记录的 Token，用量未知不估算。Hooks 需单独审阅信任，见配置与启用说明。
• 每条对话直接展示核心总结。
• 原生悬浮预览增加核心总结、最近输入和最近输出；消息最多展示 3 行。
• 列表/卡片滑块支持鼠标和键盘切换，并记住选择。
• 同一文件夹内一行两张半透明卡片，固定展示名称、最后沟通时间、AI 总结和 3 个核心标签。
• 3 个标签分别提炼任务对象、工作类型和交付结果，过滤版本号、状态码及孤立工具名。
• “置顶 / 项目 / 最近 / 中断”改为同一行的可访问 Tab，一次只展示一个分组；主动停止、重启或关闭造成的未完成对话统一进入“中断”。
• “最近”内的对话按最后沟通时间降序排列；双列卡片按从左到右、从上到下阅读。
• 项目文件夹改为标签：按真实最近沟通时间降序排列，默认两行，可展开全部。
• 文件夹标签首位提供“全部”：汇总完整项目会话索引，并按最近一次请求或沟通时间跨文件夹排序。
• 搜索框可模糊搜索文件夹名和项目名，命中后直接展示对应文件夹。
• 项目搜索栏右侧保留三个独立操作：排序设置、创建项目、在当前选中文件夹中新建对话。缺少可用的原生新建对话入口且无法确认唯一工作区时，按钮明确不可用，不把它误导向项目列表。
• 项目管理、Skills 分组、资产控制台和内置自定义入口统一在可拖动调宽的右侧面板打开，切换功能时互斥收起，当前对话、滚动位置和输入框始终保留；本机专属入口由仓库外配置管理，公开包不携带任何本机配置。
• 在当前对话输入“项目管理，帮我找下管理优化”“Skills 帮我找下知识卡片”或“资产控制台，帮我找下角色”等指令，可自动打开对应面板并带入检索词。
• “项目管理”随安装包提供：右侧打开本地 Taskboard，支持按项目名定位，并保留跨项目六泳道、紧急状态、文件夹过滤、项目描述、进度和下一步规划。
• “Skills 分组”默认显示全部，按六个大类自动整理，支持自定义分类和手动移动；单击卡片查看使用方法与场景，右键定位源文件或追溯最近可验证的创建 / 优化对话。搜索、常用收藏及“+”添加原生 Skill 引用仍保留。完整操作及追溯范围。
• “资产控制台”在右侧打开纯本地多媒体资产库。每个项目可关联一个或多个文件夹并递归扫描，自动归类文本、图片、音频和视频；支持子分类、标签、项目内搜索、排序及 1–8 列自适应布局。
• 资产控制台使用本地零 Token 规则进行智能整理：自动将图片分为“正式资产 / 待确认 / 干扰项”，识别角色、场景、道具、分镜、视频解析帧、缩略图和联系表，并展示自动标签、置信度与判断原因；人工修改始终优先，干扰项不会被自动删除。
• “待确认”资产可直接设置正式分类和手动标签；人工选择会持久保存，并覆盖后续本地规则判断。
• Codex 生成图片、视频或音频时会记录对应提示词；在资产控制台放大有关联的媒体时，左侧展示资产，右侧展示提示词、模型、生成器和参考信息。
• 以图片、视频或音频制作为目的的 Codex 项目会自动关联到资产控制台，并约每 8 秒增量同步新增文件夹；手工名称、附加文件夹和排除设置不会被自动覆盖，普通代码项目和含糊的共享目录不会误导入。
• 文本、图片、音频和视频资产双击预览查看详情；用明确的“添加到对话”操作添加本地引用到当前输入框，不自动发送。预览保留放大、关联提示词查看和文本编辑能力。
• 文本资产以可滚动卡片展示，可在预览中编辑保存受支持编码的 Markdown、TXT；DOCX、RTF 和旧式 .doc 保留只读预览或元数据，不通过纯文本保存破坏富文档原件。
• 图片和视频采用瀑布流，音频与视频支持悬停播放，视频支持全屏；卡片展示名称、大小、尺寸或时长及标签。
• 所有资产支持重命名和逻辑移动项目；永久删除需要输入完整文件名二次确认，操作直接删除本机真实文件且不可撤销。
• 左侧菜单的设置入口可显示或隐藏快捷菜单，也可用图标、名称、链接和“内置 / 浏览器”打开方式创建自定义入口。长按左侧快捷菜单约半秒，或长按设置列表的拖动柄，拖到目标位置松开后自动保存顺序；也可用 Alt + ↑ / ↓ 调整。隐藏后恢复的菜单保留原位置，设置入口始终可见。配置跨重启保留。
• 设置面板铺满右侧窗口，标题、展开与关闭按钮保持可见，正文独立滚动；短窗口、长窗口及展开模式均可完整访问底部新建入口表单。
• 顶部展示 Codex 自身记录的真实剩余比例和重置时间，不自行估算额度。
• 每张对话卡片默认保持“未标记”；用户主动选择后，才用红、橙、绿三色标注“紧急且重要 / 紧急或重要 / 不紧急”。颜色状态按对话保存，清除后恢复未标记。
• 打开历史任务时，会把本地会话文件中仍可见的用户与助手消息补回原生对话流，同时过滤系统说明、工具调用和内部传输内容，不建立覆盖式历史页面。
• 项目管理内置的是 2026-08-31 已验证的定制 Taskboard 快照，不是上游通用界面；保留跨项目六泳道、侧边调宽、Codex 对话联动、当前项目、待查看与钉住等能力。安装时不现场编译，看板和侧栏由同一后台运行时守护。
• Codex 短暂重绘侧栏时会保留搜索、筛选和 Tab，并等待原生数据恢复；只有锚点持续缺失才完整撤销对应增强区，避免半加载、错位或不可点击。

• macOS 13+，或 Windows 10/11；
• 已安装当前 Codex 或包含 Codex 工作区的 ChatGPT 桌面应用；OpenAI 官方桌面应用支持 macOS 与 Windows；
• 本地存在 ~/.codex 会话目录；
• Node.js 22.5 或更新版本。macOS 安装器会复用系统或桌面应用内置 Node.js；Windows 缺少 Node 时会安装经过 SHA-256 校验的便携 Node 22 运行时到本工具目录。

当前实现已在 Codex 26.901.41600 的 macOS 界面进行定向验证，并有 macOS/Windows 自动测试；这不等于 Windows 桌面和所有版本已实机验收。Codex 更新如果更改侧栏 DOM 锚点，可能需要同步升级本项目。

• 只读访问 ~/.codex/session_index.jsonl 与 ~/.codex/sessions；
• 不修改 /Applications/ChatGPT.app、/Applications/Codex.app、app.asar 或对话数据；
• 项目管理 HTTP 服务从 127.0.0.1:47823 开始选择可用回环端口；端口被其他本地服务占用时会自动顺延，不向局域网或公网开放，也不上传对话、额度或标签；
• 资产控制台从 127.0.0.1:5177 开始选择可用回环端口，API 使用独立随机令牌；内嵌页面通过一次性私有沙箱路径转发，并限制为对应 iframe；
• CDP 只使用回环地址 127.0.0.1:9231；
• 安装内容完全位于当前用户目录，可通过对应平台的卸载脚本完整移除；Windows 不创建管理员级服务或系统级注册表项。

更新时重新运行安装命令即可。安装器会原子替换旧版本，并迁移旧名称启动器及早期 com.yubowen.codex-conversation-preview LaunchAgent。为保证无损升级，安装目录、数据目录、LaunchAgent label 和内部消息协议继续沿用既有兼容标识；这不会影响界面及启动器统一显示为 AIYOUcodex。Taskboard 数据独立保存在用户数据目录，更新安装包不会覆盖已有项目和任务。

macOS 日志位置：

~/Library/Logs/CodexSidebarEnhancer/injector.log
~/Library/Logs/CodexSidebarEnhancer/injector.error.log

Windows 日志位置：

%LOCALAPPDATA%\CodexSidebarEnhancer\Logs\injector.log
%LOCALAPPDATA%\CodexSidebarEnhancer\Logs\injector.error.log

如果增强没有出现：

1. 等待约 10 秒，后台增强会自动连接已开放调试端口的 Codex 窗口；
2. 仍未出现时，先保存当前工作，再退出 Codex/ChatGPT，打开 macOS 的 ~/Applications/AIYOUcodex.app，或 Windows 开始菜单中的 AIYOUcodex。默认不因端口故障自动退出正在使用的 Codex；
3. 在安装目录运行 node scripts/doctor.mjs --strict，检查包、服务和每个窗口的实际组件状态；不加 --strict 只验证安装包完整性，不能作为运行成功证明；
4. 查看上述日志。

• 窗口有独立的文档代次与组件健康状态。重新加载后重新交付数据；同一页面连接短暂中断不会销毁整个界面。未知布局按组件降级，不通过不断重启 Codex 猜测修复。
• 侧栏与项目管理常驻注入器的初次附着、健康检查重试和重连均不刷新宿主页面；资产面板按窗口保存打开意图，在真正重载且桥接就绪后恢复一次。用户主动关闭或后来打开其他面板优先，不抢占聊天焦点。
• 界面快照合并更新，未变化的数据不重绘；原生菜单通过代理触发，不搬走 React 管理的按钮。快捷入口、标签与搜索分别报告健康状态。
• 资产优先读取持久索引，服务启动后后台补偿离线变化，运行时按变化文件同步。切换项目的过期请求不能覆盖当前项目，未变化的媒体卡片保持节点。
• 新资产界面使用服务端分页，每次读取 120 条、驻留最多 240 张卡片；搜索、分类与排序覆盖整个已索引项目，不局限于当前页。元数据校准设有单根目录 100,000 条候选预算，超限报告待校准并保留旧记录，不把截断当作删除。
• 音视频仅在播放时加载，离开后释放；嵌入通道分段传输并限制并发和响应大小，避免整段大视频转成内存中的 Base64。文件断开或流读取失败不会直接退出整个服务。
• MD/TXT 编辑使用版本校验与恢复备份。DOCX/DOC/RTF 目前只读，避免纯文本保存破坏原文排版、图片和表格；富文档无损编辑尚未实现。
• 安装器验证新包并保留旧运行时目录，路径在安装输出中显示。旧目录只是恢复副本，不代表已通过功能验收；数据目录仍独立保存。需要恢复时，以该目录为 CODEX_SIDEBAR_SOURCE_DIR 重新执行安装器，勿删除资产或项目数据。
• 自动测试包含真实隔离浏览器点击、界面空闲不自激、项目请求乱序、离线索引补偿和文件编辑保护。CI 必须有 Chrome/Chromium，不能静默跳过交互回归。

当前仍需人工验收未见过的 Codex 布局，以及真实 Windows 界面和大规模资产库。资产索引仍为原子 JSON 快照；合并写入与增量解析降低开销，但不等同于逐资产数据库更新。

git clone https://github.com/yubowen123/AIYOUCODEX.git
cd AIYOUCODEX
npm install
npm test
npm run runtime

Windows 本地安装测试：

$env:CODEX_SIDEBAR_SOURCE_DIR = (Get-Location).Path
.\install.ps1

实时界面验收脚本需要已用 9231 端口启动的 Codex：

node scripts/verify-shortcut-grid.mjs
node scripts/verify-project-management.mjs
node scripts/verify-workspace-enhancements.mjs
node scripts/verify-shortcut-settings-click.mjs
node scripts/verify-section-tabs.mjs
node scripts/verify-folder-switcher.mjs
node scripts/verify-card-view.mjs
node scripts/verify-card-status.mjs
node scripts/verify-reload-persistence.mjs
node scripts/verify-complete-history.mjs --thread-id <conversation-uuid> --min-users 1 --expect "公开可验证短句"
node scripts/verify-asset-console-platform.mjs
node scripts/verify-local-asset-manager.mjs

左侧菜单默认提供 MOKE AIGC，使用 Codex 原生右侧浏览器打开 官网。图标使用官网原始 Logo，按钮适配当前主题，快捷入口设置支持隐藏/显示；点击总是显示网站，由宿主复用或重新打开页面，遵守网站的 iframe 限制。

安装 AIYOUcodex 时，通过 Codex 本地插件安装流程注册 moke-aigc@aiyoucodex-bundled。已有同名 moke MCP 连接、其他插件及禁用偏好会保留；卸载只移除本集成的插件与市场注册。未找到支持插件的 Codex CLI 时，返回待安装状态，可在 CLI 可用后运行 node scripts/install-bundled-plugins.mjs。

官方接入说明提供 Skills 与提示词的只读 OAuth 接入。首次使用需要 codex mcp login moke --scopes openid,skill:read,prompt:read；插件安装不等于账号已授权。源包包含可移植清单和 Codex 兼容清单，详见 插件说明。

MIT