codex-focus-ui

面向 Codex CLI 的聚焦会话面板，目标是让你在 5-10 秒内定位上一轮提问，并减少无关输出干扰。

30 秒启动

git clone https://github.com/spsz831/codex-focus-ui.git
cd codex-focus-ui
npm install
npm run ui

浏览器打开：http://127.0.0.1:3939

Latest Release

• Version: v0.1.1
• Release: https://github.com/spsz831/codex-focus-ui/releases/tag/v0.1.1
• Status: Stable

Highlights

• 默认折叠命令输出，保留关键过程摘要
• 一键定位上一问（按钮 + J 快捷键）
• / 快速聚焦搜索框
• 类型过滤：全部 / 仅提问 / 仅回答 / 仅命令 / 仅书签
• 关键词搜索（问题、回答、命令、输出）
• 会话书签（本地保存）
• 历史会话切换（按 .jsonl 文件）
• 悬浮上一问栏（定位 + 复制）
• 按当前筛选条件导出 Markdown 复盘清单
• 支持“导出勾选”与“全选当前可见 / 取消全选当前可见”
• 一键控制面板（双击 cfu-control.cmd）和常驻服务开关

Stability

• 配置文件：codex-focus-ui.config.json
• CLI 诊断命令：npm run doctor
• 最小冒烟测试：npm run test:smoke
• Viewer 请求异常兜底与错误提示

快速开始

git clone https://github.com/spsz831/codex-focus-ui.git
cd codex-focus-ui
npm install
npm run doctor
npm run demo:capture
npm run proxy:codex-version
npm run dev:viewer

浏览器打开：http://127.0.0.1:3939

配置文件

codex-focus-ui.config.json：

{
  "dataDir": ".data",
  "viewerPort": 3939,
  "cli": {
    "maxOutputChars": 200000
  }
}

常用命令

# 一键打开（确保服务运行并打开页面）
npm run ui

# 诊断
npm run doctor

# 生成演示数据
npm run demo:capture

# 代理真实命令并自动记录
node apps/cli/src/index.js proxy -- codex --version
node apps/cli/src/index.js proxy -- npm -v

# 启动 viewer
npm run dev:viewer

# 冒烟测试
npm run test:smoke

版本发布建议

# 1) 更新 CHANGELOG 与版本号
# 2) 提交并推送
git tag v0.1.2
git push origin master --tags

# 3) 在 GitHub Releases 基于 tag 发布说明