一个为个人使用设计的本地项目管理器。它把散落在 Codex 里的对话,整理成你看得懂的「项目 → 主题 → 对话」结构。
这里的原则很简单:一张卡片就是一条 Codex 对话。工作台负责归类、回看和管理;完整对话仍留在 Codex 里完成。
这是一个独立的本地项目,不是 OpenAI 官方产品,也不会修改 Codex 桌面端本身。
当你同时在做工作项目、Vibe Coding、内容创作或个人计划时,Codex 对话会越来越多。这个工作台帮助你:
- 用项目和主题整理已有及未来的 Codex 对话;
- 在一个看板里看待办、进行中、待确认和已完成;
- 把暂时不需要关注的已完成对话放进收集箱;
- 从卡片直接回到对应的 Codex 对话;
- 保留最终文本、文件、图片和链接等完成结果的索引;
- 在本机管理素材、附件和项目目录,不把个人工作数据传到第三方服务。
它并不试图取代 Codex 的聊天界面,也不是通用团队协作工具。它首先是你的个人工作视图。
- 启动服务后,打开
http://127.0.0.1:4317/。 - 在「项目视图」中创建项目,例如“工作”“Vibe Coding”“自媒体”。
- 在项目下创建主题,例如“WPS 笔记首页”。
- 打开「待归类对话」,为历史 Codex 对话选择合适主题。
- 归入后,这条对话就是该主题下的一张卡片。你可以把它放进待办或已完成;进行中与待确认由 Codex 的真实状态驱动。
- 在主题的待办事项中新建任务,会创建并开始一条 Codex 对话。
- 点击任意卡片,在侧边详情中查看结果、重命名或调整分类。
- 点击「回到 Codex」会尝试通过
codex://threads/<thread-id>打开并定位到对应对话;如果系统或 Codex 版本不支持深链,则会退化为仅打开 Codex。 - 已完成对话可以移入收集箱;收集箱只是工作台内的轻量整理,不等同于 Codex 归档。
- 在工作台归档对话,会同步归档对应的 Codex 对话;之后仍可在 Codex 的归档中查看。
- macOS 12 或更高版本
- Node.js 22
- npm
- Codex CLI,并且已经完成登录
- Codex 桌面端(用于“回到 Codex”深链)
npm ci
npm run check
npm test
npm run dev然后在浏览器打开 http://127.0.0.1:4317/。
生产模式:
npm run build
npm start- 服务只监听
127.0.0.1,不提供远程访问。 - 项目、主题、卡片关系和素材索引保存在本机的
data/workbench.sqlite。 - 完整对话依然由 Codex 管理;工作台只保存管理所需的摘要和关联关系。
data/、附件、日志、备份、构建产物与node_modules/都已被 Git 忽略,不应提交。- 不保存 ChatGPT 登录凭据,也不会自动批准 Codex 的命令、文件或网络权限。
使用前建议先阅读 AI_HANDOFF.md 中的安全边界和已知限制。
这是一个已有交互和产品规则的项目,不建议把它重写成通用看板。
请按以下顺序阅读:
- README-FIRST.md:快速启动与资料范围。
- AI_HANDOFF.md:产品结构、状态规则、Codex 接入、数据和技术债。
- CONTINUE_PROMPT.md:继续开发时应遵守的工作方式。
src/shared/types.ts、src/server/workbench-service.ts、src/client/App.tsx:核心数据、服务和界面入口。
提交改动前请至少运行:
npm run check
npm test
npm run buildsrc/client/ React 看板、卡片、侧边详情和视觉样式
src/server/ Express、SQLite、Codex App Server 和状态同步
src/shared/ 前后端共用类型与工具
tests/ 数据与归类逻辑测试
handoff/ 交接包完整性检查
- 仅支持个人、本机、macOS 使用。
- 不包含多人协作、云同步、手机端或远程访问。
- 自动化是本地调度能力,不等同于 Codex 官方 Scheduled。
- Codex 对话状态以本机观察到的活动为依据;桌面端深链是否精确聚焦到会话,仍受 Codex 应用版本影响。
当前仓库未附带开源许可证。除非仓库所有者另行声明,请不要将其作为可自由再分发的开源项目使用。