Skip to content

About

把散落的 Codex 对话整理成项目、主题与看板,在本机清楚掌握每个 AI 任务的进展。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Codex 对话工作台

一个为个人使用设计的本地项目管理器。它把散落在 Codex 里的对话,整理成你看得懂的「项目 → 主题 → 对话」结构。

这里的原则很简单:一张卡片就是一条 Codex 对话。工作台负责归类、回看和管理;完整对话仍留在 Codex 里完成。

这是一个独立的本地项目,不是 OpenAI 官方产品,也不会修改 Codex 桌面端本身。

它适合解决什么

当你同时在做工作项目、Vibe Coding、内容创作或个人计划时,Codex 对话会越来越多。这个工作台帮助你:

  • 用项目和主题整理已有及未来的 Codex 对话;
  • 在一个看板里看待办、进行中、待确认和已完成;
  • 把暂时不需要关注的已完成对话放进收集箱;
  • 从卡片直接回到对应的 Codex 对话;
  • 保留最终文本、文件、图片和链接等完成结果的索引;
  • 在本机管理素材、附件和项目目录,不把个人工作数据传到第三方服务。

它并不试图取代 Codex 的聊天界面,也不是通用团队协作工具。它首先是你的个人工作视图。

使用方式

第一次整理

  1. 启动服务后,打开 http://127.0.0.1:4317/。
  2. 在「项目视图」中创建项目,例如“工作”“Vibe Coding”“自媒体”。
  3. 在项目下创建主题,例如“WPS 笔记首页”。
  4. 打开「待归类对话」,为历史 Codex 对话选择合适主题。
  5. 归入后,这条对话就是该主题下的一张卡片。你可以把它放进待办或已完成;进行中与待确认由 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 中的安全边界和已知限制。

给接手开发者 / AI

这是一个已有交互和产品规则的项目,不建议把它重写成通用看板。

请按以下顺序阅读:

  1. README-FIRST.md:快速启动与资料范围。
  2. AI_HANDOFF.md:产品结构、状态规则、Codex 接入、数据和技术债。
  3. CONTINUE_PROMPT.md:继续开发时应遵守的工作方式。
  4. src/shared/types.ts、src/server/workbench-service.ts、src/client/App.tsx:核心数据、服务和界面入口。

提交改动前请至少运行:

npm run check
npm test
npm run build

项目结构

src/client/   React 看板、卡片、侧边详情和视觉样式
src/server/   Express、SQLite、Codex App Server 和状态同步
src/shared/   前后端共用类型与工具
tests/        数据与归类逻辑测试
handoff/      交接包完整性检查

当前边界

  • 仅支持个人、本机、macOS 使用。
  • 不包含多人协作、云同步、手机端或远程访问。
  • 自动化是本地调度能力,不等同于 Codex 官方 Scheduled。
  • Codex 对话状态以本机观察到的活动为依据;桌面端深链是否精确聚焦到会话,仍受 Codex 应用版本影响。

许可证

当前仓库未附带开源许可证。除非仓库所有者另行声明,请不要将其作为可自由再分发的开源项目使用。

About

把散落的 Codex 对话整理成项目、主题与看板,在本机清楚掌握每个 AI 任务的进展。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages