omp packages

pi-chat-helper0.4.0

pi coding agent 扩展包：浏览器会话轨迹回放 + TUI 提问跳转面板（trajectory web viewer + question panel）

zhubblego Published 1 day ago MIT ~683 downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Did it work for you?

Result

One report per person. A new report replaces your old one.

Reports 0

No reports yet.

Readme

pi-chat-helper

pi coding agent 的扩展包：在浏览器里完整回看会话轨迹（trajectory-web），在 TUI 里快速跳转历史提问（question-panel）。

浅色主题

浅色主题：会话栏 ＋ 问题栏 ＋ 按提问分段的轨迹，工具调用与结果成对展示

深色主题

深色主题：跟随系统，也可手动指定

安装

pi install git:github.com/zhubblego/pi-chat-helper

新开会话生效。pi list 查看已装扩展包，pi remove git:github.com/zhubblego/pi-chat-helper 移除。

想先试用一次、不写入配置：

pi -e git:github.com/zhubblego/pi-chat-helper

快速上手

安装后两件事开箱即用：

１．TUI 里跳回任意历史提问

/questions

打开提问列表面板（浮动 overlay，停靠右上角）。单击任意条目，transcript 直接跳回那一问；双击进入该回合的分析视图（思考→工具→输出节点树）。

２．浏览器里看会话轨迹

/deepseek-trail start

进程内启动 web 服务（默认 http://127.0.0.1:7717），浏览器里看当前项目的全部会话：左侧会话栏 + 问题栏，右侧轨迹按提问分段，条目点开有 Markdown 渲染、工具参数与结果、tokens 与耗时。/deepseek-trail stop 停止。

也可以脱离 pi 跑独立服务，观察全部 pi 历史与运行中会话（按项目分组、live 徽标）：

npm run dev        # 默认 http://127.0.0.1:7788
# 等价：node trajectory-web/server/main.mjs --scope all --port 7788

trajectory-web：轨迹观察 web 服务

一整页会话轨迹：左侧会话栏 + 问题栏（含过滤按钮组），右侧轨迹按问题分段。一级是提问（问题 1、问题 2 …，同级分组），二级是该回合内的事件链（提问原文、思维链、工具调用与结果、输出文本、系统提示/压缩/模型切换等上下文事件）。条目点击开详情抽屉：Markdown 渲染、工具参数/结果、tokens 与耗时、子调用。

两种启动模式

模式 A（pi 插件） 模式 B（独立 web server）
启动 pi 内执行 /deepseek-trail start [端口] npm run dev（默认 7788）
范围 当前项目的全部会话 全部 pi 历史 + 运行中的会话（按项目分组）
生命周期 绑定本 pi 实例，退出即停 独立常驻，与 pi 无关
实现 进程内 HTTP 服务 独立 node 进程

模式 A 命令：

/deepseek-trail start          # 默认 127.0.0.1:7717；端口占用自动降级并提示
/deepseek-trail stop           # 停止服务

界面能力

  • 会话栏（deepseek sidebar 风格）：模式 B 按项目分组；运行中的会话带 live 亮点；点击切换会话，模式 A 下会话切换（/new、/resume、/fork）不影响服务。
  • 问题栏：问题列表 + 可折叠过滤按钮组（提问/思考/工具/输出/上下文，含「仅思考」等预设），过滤状态持久化。
  • 轨迹区：按问题 sticky 分段；条目行带类型标签与耗时/token；错误与回合输出高亮；支持轮次折叠与全文搜索。
  • 工具过滤：工具名子菜单多选（默认全选），工具按归属分组显示——内置 / MCP: <server> / 扩展包 / 未识别；归属来自 pi 运行时映射 + 静态扫描合并。
  • 前端 2s 轮询（etag 增量）、会话列表约 6s 刷新、详情按需取全文；服务只读会话 JSONL，仅监听回环地址。

界面风格

全部组件使用 deepseek 设计 token（web/tokens.css），复刻自 deepseek-harness 的 ui-theme（MIT，上游提交 571902028a）：设计平台色板、语义别名、字体/圆角/动效、滚动条与焦点环。暗色由 body[data-ds-dark-theme] 承载，默认跟随系统；顶栏主题按钮可循环切换「跟随系统 → 浅色 → 深色」（偏好持久化于 localStorage，首帧内联脚本防闪屏）。tokens.css 是生成产物，请勿手改；更新时回上游同步后重新生成。

question-panel：TUI 提问面板

/questions — 提问列表面板（浮动 overlay，停靠右上角）：

  • 单击条目：transcript 跳转到该提问处（复用 pi 内置的 OSC 133 标记定位机制）
  • 双击条目 / d：进入回合分析视图（思考→工具→输出 节点树 + 详情区，输出节点 Markdown 渲染，t 键只看思维链）
  • 宽度：/questions 50（列数）或 /questions 60%（百分比），会话内记忆
  • 键盘备用路径：↑↓ 选择、回车跳转、q/Esc 关闭

开发与测试

git clone git:github.com/zhubblego/pi-chat-helper
cd pi-chat-helper

# 开发加载（根 index.ts 是聚合入口，注册 /questions 与 /deepseek-trail）
pi -e .
pi -ne -e .        # 只加载本仓库开发版，不叠加其它已装扩展

# trajectory-web（纯 node，不需要 PI_HOME）
node tests/test-projection.cjs   # 投影：分组/工具配对/统计/分支重建/light 截断
node tests/test-sessions.cjs     # 会话扫描：列表字段/项目范围/尾部会话名/live/排序
node tests/test-server.cjs       # HTTP：多会话列表/指定会话/增量/详情/双范围/热更新/退出
node tests/test-web-lib.cjs      # 前端纯函数：过滤映射/Markdown 转义/会话列表助手
node tests/test-tool-origins.cjs # 工具归属静态扫描：分组/保护规则/相似度竞争

# trajectory-web 扩展命令（需要 PI_HOME 提供 jiti）
PI_HOME=<pi 安装目录> node tests/test-extension.cjs

# question-panel（无头，需要 PI_HOME）
PI_HOME=<pi 安装目录> node tests/test-question-panel.cjs
PI_HOME=<pi 安装目录> node tests/test-render.cjs
PI_HOME=<pi 安装目录> node tests/test-turn.cjs
PI_HOME=<pi 安装目录> node tests/test-headless-tui.cjs

# 类型检查（仓库无本地 typescript，用 npx 缓存路径）
node ~/.npm/_npx/483d2954a4c5190c/node_modules/typescript/bin/tsc -p tsconfig.json

环境变量 PI_HOME 指向本机 pi 安装目录（含 jiti 与 pi-tui）。

License

MIT。trajectory-web/web/tokens.css 复刻自 deepseek-harness 的 ui-theme（MIT），上游归属见 LICENSE。