Package @codex-pro/chat · v1.0.15

把 Codex 任务变成可持续推进的 Job 工作台

Codex Chat 是面向 Codex 的 Web 控制台、CLI 和飞书任务入口。它围绕 Job 管理、Agent 默认配置、Provider App Server、附件、记忆和运行观测,把一次对话扩展成可追踪、可继续、可协作的工程任务。

codex-chat
$ npm install -g @codex-pro/chat
ready install package

$ codex-chat start
ready http://127.0.0.1:3030

$ codex-chat-cli doctor
ready agents, providers, channels

Features

一个入口管理任务、渠道和运行实例

围绕 Job 组织任务,将角色配置、模型服务、消息渠道与执行记录连接起来。

Job 管理

创建、补充、steer、停止和继续 Job,保留状态、消息、历史记录与底层 Session 追踪。

多角色 Agent

为不同任务角色配置 Provider、模型、工作目录、sandbox、reasoning、运行限制和 Developer Instructions。

Provider App Server

管理 Built-in、DeepSeek、OpenAI、Qwen 与 Custom Provider,多个 Agent 可复用同一运行实例。

Web / CLI / 飞书

三种入口共用同一套 Job API 和本地数据;飞书 Channel 可独立保存凭证、连接和默认 Agent。

图片、文件与 Artifact

接收 Web 和飞书附件并保存为 Artifact;DeepSeek 可选配独立 Vision/OCR 服务理解图片。

Job Memory

完成 Job 后提取持久偏好和项目摘要,供后续启用记忆的任务检索复用。

Architecture

Job 是用户心智,Session 是执行证据

项目把用户任务、Agent 默认值、运行实例和底层 Codex 执行记录分离,便于诊断和继续推进。

  1. 01Web / CLI / Feishu

    任务入口

  2. 02Job API

    任务管理

  3. 03Agent Settings

    角色与默认配置

  4. 04Provider App Server

    模型运行实例

  5. 05Session / Turn

    执行记录

本地优先

安装版默认监听 127.0.0.1:3030,并在用户主目录创建 .codex-chat 运行目录。

可观测

提供 Sessions、Messages、Call Flow、App Server 健康状态和 Doctor 诊断结果。

受控扩展

系统命令通过白名单和参数规则执行,飞书扫码授权使用聊天相关最小权限。

Operation

任务配置与本地运行

独立保存任务设置与运行数据,通过 Web、CLI 和飞书使用同一套任务流程。

任务模型与配置

  • Job 关联 Session、Turn、Artifact 和 Channel,组织任务及其执行记录。
  • Agent 默认值、Channel 默认值和当前 Job 设置分开保存。

多端入口与本地数据

  • Nuxt Web UI、CLI 和飞书长连接共用 Node 服务,数据保存在本地 JSON/JSONL 文件中。
  • 统一管理 Provider、模型切换、运行观测、附件和记忆。

安装与日常维护

  • 通过 npm 包安装,使用启动、状态查询、重启和 Doctor 诊断命令管理运行。
  • 本地运行,无需额外部署外部数据库。