@rainmanhhh/pi-web 0.12.1 → 0.13.1

package/README.md

@@ -35,6 +35,7 @@ pi-web --hostname 0.0.0.0       # expose on a trusted network
 pi-web -p 8080 -H 0.0.0.0       # combine options
 pi-web --open                   # open the browser when the server is ready
 pi-web --agent-dir ~/.pi/agent  # point at another pi agent directory
+pi-web -d                       # verbose debug logs (also written to server.log)
 
 PORT=8080 pi-web                # environment variable is also supported
 HOST=0.0.0.0 pi-web             # explicit network exposure
@@ -76,15 +77,16 @@ npx @rainmanhhh/pi-web@latest
 - **Work across branches**: switch Git worktrees from the sidebar so new sessions and the Explorer follow the checkout you choose.
 - **Chat beside the project**: browse files on the left and preview source, docs, images, audio, and PDFs on the right while the agent works.
 - **See session state clearly**: context usage, cost, compaction state, and system prompt details are visible from the top bar.
-- **Configure less from the terminal**: manage models, login/API keys, model tests, and skill switches from the web UI.
+- **Configure less from the terminal**: manage models, login/API keys, model tests, thinking levels, and skill switches from the web UI.
+- **Commit faster from the Explorer**: stage, commit, and push from the web UI, with AI-generated Conventional Commits messages — use a small fixed model or follow the current chat model.
 - **Use the interface in your language**: switch between the supported UI languages from the top bar.
 
 ## Notes
 
 - **Data directory**: Pi Web reads `~/.pi/agent/sessions` by default. Set `PI_CODING_AGENT_DIR` to point at another pi agent directory.
 - **Session files**: files are stored as `~/.pi/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl`.
-- **Model config**: the Models panel reads and writes `models.json` in the pi agent directory. Model lists and defaults come from pi's config.
-- **Preferences**: UI preferences (scroll step, auto-reload, long-block collapse, …) live in `pi-web-preferences.json` in the pi agent directory (default `~/.pi/agent/pi-web-preferences.json`). The browser's `localStorage` holds a front-end copy; the server file is the source of truth for other clients.
+- **Model config**: the Models panel reads and writes `models.json` in the pi agent directory. Model lists and defaults come from pi's config; lists synced from a provider's `/models` endpoint are cached under `<agentDir>/pi-web/provider/`.
+- **Preferences**: UI preferences (scroll step, auto-reload, long-block collapse, …) live in `<agentDir>/pi-web/config.json` (default `~/.pi/agent/pi-web/config.json`). The browser's `localStorage` holds a front-end copy; the server file is the source of truth for other clients. The legacy `pi-web-preferences.json` is migrated once on startup.
 - **File access**: file browsing and preview are scoped to the selected project directory and working directories that appear in sessions.
 - **Git worktrees**: see [Worktrees in Pi Web](./docs/worktrees.md) for when the switcher appears, how new worktrees are created, and what removal does.
 - **Forks vs in-session branches**: Fork creates a new `.jsonl` file. "Edit from here" creates another branch inside the same session file.
@@ -130,7 +132,7 @@ Known issue: `bun publish` does not read the `//registry.npmjs.org/:_authToken`
 src/
   components/   # React UI: AppShell, SessionSidebar, ChatWindow, ChatInput,
                 #   MessageView, ModelsConfig, SkillsConfig, FileExplorer, FileViewer, …
-  hooks/        # useAgentSession (SSE state machine), useTheme, useDragDrop, …
+  hooks/        # useAgentSession (WebSocket bus state machine), useTheme, useDragDrop, …
   lib/          # session .jsonl parsing, RPC manager, file-access safety,
                 #   request security, i18n, markdown setup
   main.tsx      # frontend entry

package/README.zh-CN.md

@@ -33,6 +33,7 @@ pi-web --hostname 0.0.0.0       # 在可信网络中开放访问
 pi-web -p 8080 -H 0.0.0.0       # 组合使用
 pi-web --open                   # 服务就绪后自动打开浏览器
 pi-web --agent-dir ~/.pi/agent  # 指定其他 pi agent 目录
+pi-web -d                       # 输出调试日志（同时写入 server.log）
 
 PORT=8080 pi-web                # 也支持环境变量
 HOST=0.0.0.0 pi-web             # 显式开放网络访问
@@ -74,15 +75,16 @@ npx @rainmanhhh/pi-web@latest
 - **跨分支工作**：在侧边栏切换 Git worktree，让新会话和 Explorer 跟随你选择的 checkout。
 - **边聊边看项目文件**：左侧浏览项目文件，右侧打开源码、文档、图片、音频和 PDF；文件变化会自动刷新，适合边让 agent 改边检查结果。
 - **随时掌握会话状态**：在顶部就能看到上下文占用、花费、压缩结果和系统提示，长会话不再像黑箱。
-- **少离开当前界面**：模型、登录/API key、模型测试和技能开关都能在网页里处理，配置 agent 时不用在多个工具之间来回切换。
+- **少离开当前界面**：模型、登录/API key、模型测试、思考级别和技能开关都能在网页里处理，配置 agent 时不用在多个工具之间来回切换。
+- **在 Explorer 里更快提交**：网页内完成暂存、提交和推送，还能用 AI 生成符合 Conventional Commits 的提交信息——可以固定用一个小模型，也可以跟随当前会话的主模型。
 - **界面语言可选**：在顶部栏切换界面支持的 UI 语言。
 
 ## 注意事项
 
 - **数据目录**：默认读取 `~/.pi/agent/sessions` 下的会话文件。可通过环境变量 `PI_CODING_AGENT_DIR` 指定其他 pi agent 目录。
 - **会话文件**：路径形如 `~/.pi/agent/sessions/<编码后的工作目录>/<时间戳>_<uuid>.jsonl`。
-- **模型配置**：Models 面板读写 pi agent 目录下的 `models.json`，模型列表和默认模型由 pi 的配置解析得到。
-- **偏好配置**：UI 偏好（滚动步长、自动刷新、长块折叠等）保存在 pi agent 目录下的 `pi-web-preferences.json`（默认 `~/.pi/agent/pi-web-preferences.json`）。浏览器 `localStorage` 是前端副本，服务端文件是其他客户端读取的权威来源。
+- **模型配置**：Models 面板读写 pi agent 目录下的 `models.json`，模型列表和默认模型由 pi 的配置解析得到；从服务商 `/models` 端点同步的模型列表缓存在 `<agentDir>/pi-web/provider/` 下。
+- **偏好配置**：UI 偏好（滚动步长、自动刷新、长块折叠等）保存在 pi agent 目录下的 `pi-web/config.json`（默认 `~/.pi/agent/pi-web/config.json`）。浏览器 `localStorage` 是前端副本，服务端文件是其他客户端读取的权威来源。旧版 `pi-web-preferences.json` 会在启动时一次性迁移。
 - **文件访问**：文件浏览和预览面向当前选择的项目目录，以及会话中已出现过的工作目录。
 - **Git worktree**：什么时候显示切换器、新建目录在哪里、删除会影响什么，见 [Pi Web 里的 Worktree](./docs/worktrees.zh-CN.md)。
 - **Fork 与会话内分支不同**：Fork 会创建新的 `.jsonl` 文件；“Edit from here” 是同一会话文件里的分支。
@@ -128,7 +130,7 @@ bun run test:e2e   # Playwright；e2e 使用隔离端口（E2E_API_PORT 等）
 src/
   components/   # React UI：AppShell、SessionSidebar、ChatWindow、ChatInput、
                 #   MessageView、ModelsConfig、SkillsConfig、FileExplorer、FileViewer 等
-  hooks/        # useAgentSession（SSE 状态机）、useTheme、useDragDrop 等
+  hooks/        # useAgentSession（WebSocket 总线状态机）、useTheme、useDragDrop 等
   lib/          # 会话 .jsonl 解析、RPC manager、文件访问安全边界、
                 #   请求安全、i18n、markdown 配置
   main.tsx      # 前端入口