TOOL GUIDE
南鸢 Codex 工作站
在 Codex 桌面里查看项目与任务、并排打开最多四个对话，随手调用 Skills 和本地素材。附源码安装与上手指南。
- 准备什么
- 已安装的 Codex / ChatGPT 桌面应用、Git、Node.js 22.5+，以及你选定的项目与素材。
- 得到什么
- 项目与任务地图、最多四个 Codex 对话、可调用 Skills 和本地素材浏览。
- 数据与隐私
- 工作站在本机运行；素材插入后由你确认发送。发送后的内容由原 Codex / ChatGPT 服务处理。
让项目、对话和素材待在同一个窗口
南鸢 Codex 工作站把项目、任务看板、Skills 和本地资产放进 Codex / ChatGPT 桌面应用的右侧面板。左边继续使用原生项目导航，中间保留对话与输入框，需要材料时再打开工作站。
本指南按公开仓库 0.27.3 的说明整理。工作站以 MIT 许可开放源码，需要在自己的电脑上安装，适合已经使用 Codex 桌面端、希望集中管理多个任务和创作素材的人。它依赖桌面应用的界面结构，应用更新后可能需要等待适配。
你可以用它做什么
同时照看几个对话。中央区域最多显示四个本机或已配置远程设备的 Codex 对话，每格独立输入和滚动。可以新建会话、选择工作文件夹，也能打开已有任务；拖动分隔线调整大小，单格放大后还可以返回单聊。新会话支持原生模型与推理强度选择。
接着上次的工作继续。项目页集中展示任务关系、摘要与产出。任务地图区分父子、派生和关联关系，可以选择卡片补充要求、拆出子任务，或把成果交给主任务继续。真正发送前，先核对目标对话和输入内容。
把跨多次对话的工作记下来。在工作事项中记录方向和下一步，并关联相关任务。复杂事项可以再加入计划节点，通过画布或列表查看。事项是否完成与对话是否正在运行分别记录，停止生成并不代表工作已经做完。
找到当前能调用的 Skill。技能页优先读取当前工作区的真实可用清单，展示中文标题、简介和原始调用名。选好后点击“插入到任务”，检查输入框，再自行发送。
把素材带进当前任务。资产页可浏览项目文件、Eagle 和当前任务产出，支持搜索、筛选及只读预览。导入来源后，素材不会自动发到对话；需要使用时再明确插入。
安装前准备
准备已安装的 Codex 或 ChatGPT 桌面应用、Git，以及 Node.js 22.5 或更新版本。公开仓库提供 macOS 和 Windows 安装脚本；有脚本入口不等于所有系统版本都经过实际验收。
首次启用需要以本地调试端口重新打开桌面应用。先保存正在编辑的内容，等当前任务结束后再安装，避免中断承载安装指令的对话。先下载并查看本地脚本，再执行对应系统的安装步骤。
git clone https://github.com/nuyoah-ai-works/nuyoah-codex-workstation.git
cd nuyoah-codex-workstation
npm ci在 Mac 上安装
在刚克隆的仓库目录中运行下方命令。安装后按脚本提示启动桌面应用，进入对话，检查顶部是否出现“工作站”入口。安装沿用 Codex Sidebar Enhancer 的兼容名称，所以系统中看到这个名称是正常的。
CODEX_SIDEBAR_SOURCE_DIR="$PWD" bash install.sh在 Windows 上安装
在 PowerShell 中进入刚克隆的仓库目录，再运行下方命令。遇到脚本策略、依赖或启动错误时，先保留具体错误并对照仓库说明排查，不要反复安装来代替诊断。
$env:CODEX_SIDEBAR_SOURCE_DIR = (Get-Location).Path
.\install.ps1第一次打开，先走通一个任务
1. 打开一个已有 Codex 对话，点击顶部“工作站”。右侧应出现项目、任务、技能和资产四个入口，也可以使用 /工作站 命令入口。
2. 进入项目页，核对当前项目和任务。先查看摘要与产出，确认你正在处理的对象，再打开关联任务。
3. 切到技能页，选一个与当前任务有关的 Skill。点击插入后检查输入框，确认已有草稿仍在，再发送自己的要求。
4. 进入资产页，通过“导入文件夹”添加一个需要使用的来源。先预览一个文件，再尝试插入；新增素材没有出现时点击刷新。
5. 需要同时查看多项工作时，再使用四宫格。先开两格、分别选择对话，确认当前选中的格子和工作站显示的任务一致，再逐步增加。
Eagle 素材怎么接进来
在资产页选择导入 Eagle 文件夹，填写自己的 .library 资料库根目录，读取文件夹清单并选中目标。工作站会收录所选文件夹及其子文件夹，同一资料库可以添加多个来源。
浏览时保留 Eagle 文件夹层级，支持网格或列表。每页最多显示 60 项，图片列表优先加载缩略图。移除来源只清理工作站索引，资产原文件保持不变。工作站不提供原文件编辑、移动或删除。
持续推进一件事
进入“工作站 → 项目 → 工作事项”，记录这件事的方向和下一步，再关联已经存在的任务。画布可以拖动节点、平移和缩放；找不到内容时使用“适应全部”，需要重新排列时使用“整理布局”。
也可以对 Codex 说“把这件事记入工作事项，并关联相关任务”，或“读取这个事项，继续下一步”。“请助手更新”只把请求放入输入框，检查后发送才会执行。一次性问题直接聊天即可，不必都建成事项。
隐私与使用边界
工作站的本地服务只监听 127.0.0.1，安装不会修改桌面应用包或 app.asar。项目和会话目录展示按只读方式获取；任务地图中的补充要求、创建子任务等操作，会在用户明确发送后作用于真实对话。
技能或素材插入输入框后不会自动发送。你点击发送后，内容由原来的 Codex / ChatGPT 服务处理，不能把本地工作站理解成整个 AI 对话都离线。知识站只介绍工具并链接源码，不接收工作站里的项目文件和会话内容。
远程对话依赖桌面应用已经配置好的设备连接，工作站不会替你创建远程连接。四宫格属于 Codex 对话功能，不把它扩大宣传成任意聊天服务的通用分屏。
源码开放不包含 Codex / ChatGPT 的账号或模型服务。使用宿主服务需要满足其自身的账号、权限与使用条件。
入口没出现，先查哪里
先确认当前终端位于仓库目录，Node.js 满足版本要求，npm ci 已成功完成，桌面应用已按安装提示重新打开。随后运行诊断命令，按第一处失败排查。
诊断通过只能说明它检查到的运行环节正常。还需要自己打开工作站，验证四个入口、模块切换和素材插入；若桌面应用刚更新，查看仓库更新记录与已知问题。提交问题时描述系统、应用版本、工作站版本和复现步骤，避免附带私人对话或凭据。
npm run doctor更新与卸载
更新前先看公开仓库的更新记录。如果在源码里做过自己的修改，先单独保存，避免覆盖。下载新版本后按对应系统的本地安装流程处理，并再次检查常用功能。
卸载前先导出或备份需要保留的工作事项与配置。仓库提供 uninstall.sh 和 uninstall.ps1，执行前阅读脚本，确认它会移除的安装目录、启动项和日志。工作站中的兼容名称仍可能显示为 Codex Sidebar Enhancer。
源码与致谢
南鸢 Codex 工作站基于 yubowen123/codex-sidebar-enhancer 的 MIT 授权源码继续开发，并保留项目及第三方许可。固定上游版本和南鸢扩展范围记录在 UPSTREAM.md，完整第三方说明见 THIRD_PARTY_NOTICES.md。
下载源码、查看最新说明和反馈问题，请前往下方 GitHub 仓库。