@qt4798/pi-web 0.9.15 → 0.9.16-beta.1

package/.next/types/routes.d.ts

@@ -2,7 +2,7 @@
 // Do not edit this file manually
 
 type AppRoutes = "/"
-type AppRouteHandlerRoutes = "/api/agent/[id]" | "/api/agent/[id]/bash-output" | "/api/agent/[id]/events" | "/api/agent/new" | "/api/agent/running" | "/api/auth/all-providers" | "/api/auth/api-key/[provider]" | "/api/auth/login/[provider]" | "/api/auth/logout/[provider]" | "/api/auth/providers" | "/api/backup/export" | "/api/backup/import" | "/api/cwd/browse" | "/api/cwd/validate" | "/api/default-cwd" | "/api/file-index" | "/api/files/[...path]" | "/api/git/diff" | "/api/git/status" | "/api/home" | "/api/import/discover" | "/api/import/execute" | "/api/import/status" | "/api/models" | "/api/models-config" | "/api/models-config/builtin" | "/api/models-config/catalog" | "/api/models-config/discover" | "/api/models-config/test" | "/api/plugins" | "/api/project-trust" | "/api/sessions" | "/api/sessions/[id]" | "/api/sessions/[id]/auto-name" | "/api/sessions/[id]/context" | "/api/sessions/[id]/entries/[entryId]/thinking" | "/api/sessions/[id]/export" | "/api/sessions/[id]/queue-recovery" | "/api/sessions/[id]/state" | "/api/settings/title-model" | "/api/skills" | "/api/skills/check" | "/api/skills/install" | "/api/skills/search" | "/api/skills/update" | "/api/themes" | "/api/themes/[name]" | "/api/worktrees"
+type AppRouteHandlerRoutes = "/api/agent/[id]" | "/api/agent/[id]/bash-output" | "/api/agent/[id]/events" | "/api/agent/new" | "/api/agent/running" | "/api/auth/all-providers" | "/api/auth/api-key/[provider]" | "/api/auth/login/[provider]" | "/api/auth/logout/[provider]" | "/api/auth/providers" | "/api/backup/export" | "/api/backup/import" | "/api/cwd/browse" | "/api/cwd/validate" | "/api/default-cwd" | "/api/features" | "/api/file-index" | "/api/files/[...path]" | "/api/git/diff" | "/api/git/push" | "/api/git/stash" | "/api/git/status" | "/api/home" | "/api/import/discover" | "/api/import/execute" | "/api/import/status" | "/api/models" | "/api/models-config" | "/api/models-config/builtin" | "/api/models-config/catalog" | "/api/models-config/discover" | "/api/models-config/test" | "/api/plugins" | "/api/project-trust" | "/api/proxy" | "/api/proxy/test" | "/api/sessions" | "/api/sessions/[id]" | "/api/sessions/[id]/auto-name" | "/api/sessions/[id]/context" | "/api/sessions/[id]/entries/[entryId]/thinking" | "/api/sessions/[id]/export" | "/api/sessions/[id]/queue-recovery" | "/api/sessions/[id]/state" | "/api/settings/title-model" | "/api/skills" | "/api/skills/check" | "/api/skills/install" | "/api/skills/search" | "/api/skills/update" | "/api/tasks" | "/api/tasks/[id]" | "/api/tasks/[id]/[action]" | "/api/tasks/[id]/changed-files" | "/api/tasks/[id]/diff" | "/api/tasks/[id]/events" | "/api/tasks/batch" | "/api/tasks/events" | "/api/tasks/settings" | "/api/tasks/templates" | "/api/themes" | "/api/themes/[name]" | "/api/usage" | "/api/worktrees"
 type PageRoutes = never
 type LayoutRoutes = "/"
 type RedirectRoutes = never
@@ -27,9 +27,12 @@ interface ParamMap {
   "/api/cwd/browse": {}
   "/api/cwd/validate": {}
   "/api/default-cwd": {}
+  "/api/features": {}
   "/api/file-index": {}
   "/api/files/[...path]": { "path": string[]; }
   "/api/git/diff": {}
+  "/api/git/push": {}
+  "/api/git/stash": {}
   "/api/git/status": {}
   "/api/home": {}
   "/api/import/discover": {}
@@ -43,6 +46,8 @@ interface ParamMap {
   "/api/models-config/test": {}
   "/api/plugins": {}
   "/api/project-trust": {}
+  "/api/proxy": {}
+  "/api/proxy/test": {}
   "/api/sessions": {}
   "/api/sessions/[id]": { "id": string; }
   "/api/sessions/[id]/auto-name": { "id": string; }
@@ -57,8 +62,19 @@ interface ParamMap {
   "/api/skills/install": {}
   "/api/skills/search": {}
   "/api/skills/update": {}
+  "/api/tasks": {}
+  "/api/tasks/[id]": { "id": string; }
+  "/api/tasks/[id]/[action]": { "id": string; "action": string; }
+  "/api/tasks/[id]/changed-files": { "id": string; }
+  "/api/tasks/[id]/diff": { "id": string; }
+  "/api/tasks/[id]/events": { "id": string; }
+  "/api/tasks/batch": {}
+  "/api/tasks/events": {}
+  "/api/tasks/settings": {}
+  "/api/tasks/templates": {}
   "/api/themes": {}
   "/api/themes/[name]": { "name": string; }
+  "/api/usage": {}
   "/api/worktrees": {}
 }
 

package/.next/types/validator.ts

@@ -191,6 +191,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/api/features/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/features">> = Specific
+  const handler = {} as typeof import("../../app/api/features/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/api/file-index/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/file-index">> = Specific
@@ -218,6 +227,24 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/api/git/push/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/git/push">> = Specific
+  const handler = {} as typeof import("../../app/api/git/push/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/git/stash/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/git/stash">> = Specific
+  const handler = {} as typeof import("../../app/api/git/stash/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/api/git/status/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/git/status">> = Specific
@@ -335,6 +362,24 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/api/proxy/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/proxy">> = Specific
+  const handler = {} as typeof import("../../app/api/proxy/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/proxy/test/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/proxy/test">> = Specific
+  const handler = {} as typeof import("../../app/api/proxy/test/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/api/sessions/[id]/auto-name/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/sessions/[id]/auto-name">> = Specific
@@ -461,6 +506,96 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/api/tasks/[id]/[action]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/tasks/[id]/[action]">> = Specific
+  const handler = {} as typeof import("../../app/api/tasks/[id]/[action]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/tasks/[id]/changed-files/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/tasks/[id]/changed-files">> = Specific
+  const handler = {} as typeof import("../../app/api/tasks/[id]/changed-files/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/tasks/[id]/diff/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/tasks/[id]/diff">> = Specific
+  const handler = {} as typeof import("../../app/api/tasks/[id]/diff/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/tasks/[id]/events/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/tasks/[id]/events">> = Specific
+  const handler = {} as typeof import("../../app/api/tasks/[id]/events/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/tasks/[id]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/tasks/[id]">> = Specific
+  const handler = {} as typeof import("../../app/api/tasks/[id]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/tasks/batch/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/tasks/batch">> = Specific
+  const handler = {} as typeof import("../../app/api/tasks/batch/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/tasks/events/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/tasks/events">> = Specific
+  const handler = {} as typeof import("../../app/api/tasks/events/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/tasks/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/tasks">> = Specific
+  const handler = {} as typeof import("../../app/api/tasks/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/tasks/settings/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/tasks/settings">> = Specific
+  const handler = {} as typeof import("../../app/api/tasks/settings/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/tasks/templates/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/tasks/templates">> = Specific
+  const handler = {} as typeof import("../../app/api/tasks/templates/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/api/themes/[name]/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/themes/[name]">> = Specific
@@ -479,6 +614,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/api/usage/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/usage">> = Specific
+  const handler = {} as typeof import("../../app/api/usage/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/api/worktrees/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/worktrees">> = Specific

package/README.en.md

@@ -17,10 +17,57 @@
 - A browsable folder picker for loading a project without manually entering a path.
 - File explorer and preview for source, diffs, images, audio, PDF, and DOCX files.
 - Model, OAuth/API-key, skill, plugin, theme, language, and Git worktree management in the browser.
+- Task board (Beta, desktop only): four-column kanban that runs each task as an agent in its own git worktree branch, with review, merge, archive and per-project settings.
 - Mobile layout keeps the selected model and send action visible, while long project and repository labels truncate instead of causing horizontal scrolling.
 
+## Task board (Beta)
+
+On desktop, click the board button (four-square icon) in the title bar to toggle between chat and the task board. The board turns "delegate work to an agent" into a trackable pipeline: create → start → run → review → merge → done.
+
+### Status columns
+
+| Column | Statuses | Meaning |
+| --- | --- | --- |
+| Todo | `todo` | Created, waiting to start |
+| In progress | `queued` / `preparing` / `running` | Queued, setting up the worktree, agent running |
+| Attention | `awaiting_input` / `review` / `merging` / `failed` | Needs you: waiting for input, review, merging, failed |
+| Done | `done` / `canceled` | Finished or canceled (canceled hidden by default, toggle in Filter) |
+
+### Workflow
+
+1. **New task** — pick a project, write a title and a prompt (task description). Save recurring prompts as templates.
+2. **Start** — click **Start** on the card; the engine creates a dedicated branch (`task/<id>-<slug>`) under the project's `-worktrees` directory and runs the agent there. You can also drag a todo card onto the **In progress** column to start it, or use **Start all** to queue every todo of the project.
+3. **Running / cancel** — cancel anytime while running; tasks that need your input flip to *awaiting input*.
+4. **Review** — when the agent finishes, the task moves to **Attention** (a red badge appears in the board title; a system notification fires while the window is inactive). Open the detail drawer to inspect changed files, diffs and the full timeline; projects with a preflight command show an acceptance red/green light.
+   - **Merge** — accept the result (auto or manual commit message; optionally delete the worktree). The agent merges inside its session; the task then lands in **Done**.
+   - **Return** — send it back with feedback to keep working.
+5. **Archive** — archive finished/failed/canceled tasks (hidden by default, toggle in Filter); **Archive all** clears the Done column.
+6. **Failures** — failed tasks show the error; **Retry** relaunches on a new run generation, or **Edit** then restart; canceled tasks can be **re-queued**.
+
+### Task settings
+
+The board's own **Task settings** button configures per-project execution (separate from the main Settings modal):
+
+| Setting | Meaning |
+| --- | --- |
+| Auto-process queued tasks | Start tasks as soon as they are queued |
+| Max concurrent tasks | Per-project execution limit (0 = unlimited) |
+| Merge strategy | Merge commit or squash |
+| Delete worktree after merge (default) | Auto-clean worktree + branch after merge |
+| Preflight command | Command run in the worktree before review (acceptance check, e.g. `npm test`) |
+| Init command | Command run in the worktree before the agent starts (e.g. `pnpm install`) |
+| Stage prompts | Extra instructions per stage: work / retry / return / merge |
+
+### Notes & limits
+
+- Tasks are stored under `~/.pi/agent/tasks/` (JSONL, atomic writes); task sessions live with your other sessions and are browsable from the sessions list.
+- Each task runs in its own git worktree branch; task agents are explicitly constrained not to commit/push other branches or checkouts.
+- The engine is a single server process (exclusive lock); interrupted tasks are recovered on restart (marked failed/interrupted, retryable).
+- Beta: desktop only; the mobile UI does not show the board.
+
 ## Latest changes (2026-08-05)
 
+- **Task board (Beta, desktop)** — a new title-bar button toggles a four-column kanban (Todo / In progress / Attention / Done) that runs each task as an agent in its own git worktree branch: drag-to-start, detail drawer (timeline / diff / changed files), review & merge, return with feedback, archive, task templates, per-project task settings (concurrency / merge strategy / preflight / init command / stage prompts), system notifications, and full i18n + theme support. Tasks are stored under `~/.pi/agent/tasks/` (JSONL).
 - **Builtin model config persistence fix** — edits to builtin provider models (context window / max output / reasoning / thinking map / name / hidden) now persist as field-level `modelOverrides` instead of whole-model replacement entries, so untouched fields are never reset. All `models.json` mutations are serialized behind a file lock with atomic writes; local saves and the global Save button can no longer overwrite each other.
 - **Draft protection** — switching providers, clicking the global Save, or closing Settings first flushes pending builtin model edits; on failure the draft is kept and an error is shown instead of silently dropping changes. Historical `models[]` configs remain supported with custom/transport fields preserved.
 

package/README.md

@@ -34,11 +34,72 @@
 | 备份恢复 | 一键导出/导入核心配置、技能、插件、MCP 服务器与会话（可选含密钥），跨平台自动适配路径与命令。 |
 | 技能与插件 | 查询、安装、启停 Skills 与 package 插件。 |
 | Git Worktree | 在同一项目下创建、切换和移除 Worktree。 |
+| 任务看板 | 桌面端四列看板：把任务交给 agent 在 worktree 分支中执行，支持验收、合并、归档、每项目设置（Beta）。 |
 | 主题与语言 | 支持 Pi TUI 主题、亮暗模式及中文/English。 |
 | 移动端 | 适配 Safari/Chrome 窄屏布局；模型选择和发送操作保持可见。 |
 
-## 最新更新（2026-08-05）
+## 任务看板（Beta）
 
+桌面端（非移动端）点击标题栏的看板按钮（四宫格图标）即可在聊天与任务看板之间切换。看板把「给 agent 派活」变成了一个可跟踪、可验收、可归档的流水线。
+
+### 状态与四列
+
+任务按状态落入四列：
+
+| 列 | 状态 | 说明 |
+| --- | --- | --- |
+| 待办 | `todo` | 已创建、等待启动 |
+| 进行中 | `queued` / `preparing` / `running` | 排队中、创建 worktree 中、agent 执行中 |
+| 待处理 | `awaiting_input` / `review` / `merging` / `failed` | 需要你处理：等待输入、待验收、合并中、失败 |
+| 已完成 | `done` / `canceled` | 完成或取消（取消默认隐藏，可在筛选里打开） |
+
+一条任务的完整生命周期：**创建 → 启动 → 执行 → 待验收 → 合并 → 已完成**。
+
+### 使用流程
+
+1. **新建任务**：点击「新建任务」，选择项目、填写标题与任务说明（prompt）。可把常用任务存为模板复用。
+2. **启动**：点击卡片上的「开始」，引擎会自动在该项目的 `-worktrees` 目录下创建独立分支（`task/<id>-<slug>`），在其中启动 agent 执行。也可以把待办卡片**拖到「进行中」列**直接启动；「全部启动」会排队当前项目的全部待办任务。
+3. **执行与等待**：任务运行时可随时点「取消」；agent 需要你输入时会进入「等待输入」状态。
+4. **验收**：agent 完成后任务进入「待处理」列（顶部标题栏会出现红色待处理计数徽章，窗口未激活时还会收到系统通知）。点卡片打开详情抽屉：查看变更文件、Diff、完整时间线；配置了预检命令的项目会显示验收红绿灯。
+   - **合并**：接受产出，可选择自动/手动提交信息、是否删除 worktree。合并由 agent 在会话内完成，成功后任务进入「已完成」。
+   - **退回**：不满意时填写反馈退回给 agent 继续修改。
+5. **归档**：已完成/失败/取消的任务可归档（默认隐藏，筛选里可显示）；「全部归档」一键清空已完成列。
+6. **失败处理**：失败任务显示错误信息，可「重试」（换新代际重新执行）或「编辑」后重新启动；取消的任务可「重新排队」回到待办。
+
+### 任务设置
+
+看板标题栏的「任务设置」按项目配置执行行为（独立于主设置弹窗）：
+
+| 设置 | 说明 |
+| --- | --- |
+| 自动处理排队任务 | 开启后任务一排队即自动启动 |
+| 最大并发任务数 | 每项目同时执行的上限（0 = 不限） |
+| 合并策略 | 合并提交（merge commit）或压缩提交（squash） |
+| 合并后删除 worktree（默认） | 合并完成后自动清理 worktree 与分支 |
+| 预检命令（验收检查） | 任务进入待验收前在 worktree 中运行的命令，输出红绿灯结果（如 `npm test`） |
+| 初始化命令 | agent 启动前在 worktree 中执行（如 `pnpm install`） |
+| 阶段提示词 | 执行 / 重试 / 退回 / 合并各阶段的附加指令 |
+
+### 技术说明与限制
+
+- 任务存储于 `~/.pi/agent/tasks/`（JSONL，原子写），与会话文件同级；任务会话与其他会话一样可在会话列表查看。
+- 每个任务在独立 git worktree 分支中执行，互不干扰；**任务 agent 被明确约束不得提交/推送其他分支或工作区的改动**。
+- 引擎由服务器进程持有（单实例锁），重启后自动恢复中断的任务（标记为失败/中断，可重试）。
+- Beta 阶段：仅在桌面端显示入口；移动端不可用。
+
+## 最新更新（2026-08-06 · v0.9.16-beta.1）
+
+- **代理配置**：设置弹窗新增「代理」标签页，支持 HTTP / HTTPS / SOCKS5 代理，主机端口与用户名密码分开填写、密码脱敏；可测试连通性；保存后运行时热生效无需重启。适用于外部代理与本地代理（Clash / V2Ray 等）。
+- **计划模式**：输入框左下角加号升级为三选项菜单（常规 / 计划 / 上传文件）。计划模式切到只读工具集并自动注入「只读分析、输出实现计划」指令，输入框显示「计划模式」徽章；计划完成后弹出确认框，可确认执行、提出建议继续完善、或退出计划模式。
+- **用量统计**：设置弹窗新增「用量」标签页，支持当前会话（实时上下文占用环形图）与全局（总量、每日趋势、Top 会话）切换；优先使用会话中真实记录的模型用量，无记录时按文本估算。
+- **任务看板增强**：取消任务可填原因；重试/重新排队可填备注（注入下次运行提示词）；无文件变更的任务支持「直接完成」跳过合并；所有列按更新时间最新优先。
+- **任务从消息创建**：用户消息悬浮栏新增「创建任务」按钮，自动打开看板并预填。
+- **一键推送与 Stash**：会话信息栏新增推送按钮与 Stash 管理（列表 / 保存 / 恢复 / 删除）。
+- **功能开关**：设置弹窗新增「功能」标签页，可整体开关任务看板（Beta）。
+
+## 历史更新（2026-08-05）
+
+- **任务看板（Beta，桌面端）**：标题栏新增看板按钮，四列看板（待办/进行中/待处理/已完成）把任务交给 agent 在独立 git worktree 分支中执行；支持拖拽启动、详情抽屉（时间线/Diff/变更文件）、验收合并、退回反馈、归档、任务模板、每项目任务设置（并发/合并策略/预检/初始化命令/阶段提示词）、系统通知与中英文/主题适配。任务存于 `~/.pi/agent/tasks/`（JSONL）。
 - **内置模型配置持久化修复**：内置供应商模型编辑（上下文窗口 / 最大输出 / 思考映射 / 名称 / 隐藏）改为写入 SDK 原生 `modelOverrides` 字段级覆盖，不再整模型替换，也不会重置未修改字段；`models.json` 读写加互斥锁与原子写，局部保存和全局保存互不覆盖。
 - **草稿保护**：切换供应商、点击全局保存或关闭设置前会自动保存未提交的内置模型修改；保存失败保留草稿并提示，不再静默丢失。兼容历史 `models[]` 配置，自定义与传输字段原样保留。
 - **备份导入修复**：修复超过 10MB 的备份包导入被截断（413）的问题，上传上限与导入接口对齐（600MB）；导入按钮改为标准按钮样式，不再像纯文字。
@@ -71,7 +132,7 @@
 
 - `allow-scripts`：npm 11 新增的安装脚本审批提示（sharp / protobufjs / @google/genai 等）。本项目已在包内声明 `allowScripts`，若你的 npm 仍提示，可执行 `npm approve-scripts --all` 审批，或在安装命令加 `--allow-scripts=sharp,protobufjs,@google/genai`。
 
-## 最新更新（2026-08-03）
+## 历史更新（2026-08-03）
 
 - **Web-only 基线**：界面和运行代码已统一为 `pi-web-desktop` 的网页基线；Electron 主进程、桌面端打包、PWA Service Worker 与 tag 驱动的桌面 Release 工作流已移除。
 - **目录选择器**：侧栏“选择文件夹”改为可逐级浏览的目录弹窗，选择“此文件夹”后直接加载项目，不再要求手动输入路径。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qt4798/pi-web",
-  "version": "0.9.15",
+  "version": "0.9.16-beta.1",
   "description": "Web workspace for the pi coding agent",
   "homepage": "https://github.com/t479842598/pi-web-QT#readme",
   "repository": {

package/.next/server/chunks/3961.js

@@ -1,6 +0,0 @@
-"use strict";exports.id=3961,exports.ids=[3961],exports.modules={1060:(a,b,c)=>{c.d(b,{Ac:()=>n,GO:()=>j,X:()=>l,_4:()=>d,cV:()=>k,jL:()=>f,kv:()=>e,oC:()=>m});let d=262144,e=0xa00000,f=0xa00000,g={png:"image/png",jpg:"image/jpeg",jpeg:"image/jpeg",gif:"image/gif",webp:"image/webp",svg:"image/svg+xml",bmp:"image/bmp",ico:"image/x-icon",avif:"image/avif"},h={mp3:"audio/mpeg",wav:"audio/wav",ogg:"audio/ogg",oga:"audio/ogg",opus:"audio/ogg",m4a:"audio/mp4",aac:"audio/aac",flac:"audio/flac",weba:"audio/webm",webm:"audio/webm"},i={pdf:"application/pdf",docx:"application/vnd.openxmlformats-officedocument.wordprocessingml.document"};function j(a){return(a.replace(/\\/g,"/").split("/").pop()??"").toLowerCase().split(".").pop()??""}function k(a){return g[j(a)]??null}function l(a){return h[j(a)]??null}function m(a){return i[j(a)]??null}function n(a){let b=j(a);return"pdf"===b||"docx"===b?b:null}},33012:(a,b,c)=>{c.d(b,{S:()=>A,$:()=>x});var d=c(79646),e=c(29021),f=c(33873),g=c.n(f),h=c(28354),i=c(1060);let j=new Set(["DD","AU","UD","UA","DU","AA","UU"]);function k(a){let b=`${a.indexStatus}${a.worktreeStatus}`;return"??"===b?{status:"untracked",code:"U"}:j.has(b)||b.includes("U")?{status:"conflict",code:"C"}:b.includes("D")?{status:"deleted",code:"D"}:b.includes("R")||b.includes("C")?{status:"renamed",code:"R"}:b.includes("A")?{status:"added",code:"A"}:{status:"modified",code:"M"}}let l=(0,h.promisify)(d.execFile);async function m(a,b,c=8388608){let{stdout:d}=await l("git",["-C",a,...b],{timeout:1e4,maxBuffer:c,env:{...process.env,LC_ALL:"C"}});return d}async function n(a){try{return(await m(a,["rev-parse","--show-toplevel"])).trim()||null}catch{return null}}function o(a,b){let c=g().relative(g().resolve(a),g().resolve(b));return""===c||!c.startsWith(`..${g().sep}`)&&".."!==c&&!g().isAbsolute(c)}function p(a){try{return(0,e.realpathSync)(a)}catch{return g().resolve(a)}}function q(a){return a.split(g().sep).join("/")}async function r(a){return function(a){let b=a.split("\0"),c=[];for(let a=0;a<b.length;a+=1){var d,e;let f=b[a];if(!f||f.length<4||" "!==f[2])continue;let g={path:f.slice(3),indexStatus:f[0],worktreeStatus:f[1]};d=g.indexStatus,e=g.worktreeStatus,("R"===d||"C"===d||"R"===e||"C"===e)&&(g.originalPath=b[a+1]||void 0,a+=1),c.push(g)}return c}(await m(a,["status","--porcelain=v1","-z","--untracked-files=all"]))}async function s(a,b){let c=q(g().relative(a,b));try{let b=await m(a,["diff","--no-color","--no-ext-diff","--numstat","HEAD","--",c||"."]),d=0,e=0;for(let a of b.split(/\r?\n/)){if(!a)continue;let[b,c]=a.split("	",2),f=Number(b),g=Number(c);Number.isInteger(f)&&(d+=f),Number.isInteger(g)&&(e+=g)}return{additions:d,deletions:e}}catch{return{additions:0,deletions:0}}}function t(a){return a.includes(0)}function u(a){return a.split("\0").filter(Boolean)}async function v(a,b){return 0===b.length?[]:new Promise(c=>{let e=(0,d.spawn)("git",["-C",a,"check-ignore","--no-index","--stdin","-z"],{env:{...process.env,LC_ALL:"C"},stdio:["pipe","pipe","ignore"]}),f="",g=!1,h=a=>{g||(g=!0,clearTimeout(i),c(a))},i=setTimeout(()=>{e.kill(),h([])},1e4);e.stdout.on("data",a=>{f+=a.toString()}),e.once("error",()=>h([])),e.once("close",()=>h(u(f))),e.stdin.end(`${b.join("\0")}\0`)})}async function w(a){try{let[b,c]=await Promise.all([m(a,["ls-files","--cached","-z"]),m(a,["ls-files","--others","--ignored","--exclude-standard","--directory","-z"])]),d=u(b),e=new Set([...d,...function(a){let b=new Set;for(let c of a){let a=g().posix.dirname(c);for(;a&&"."!==a;)b.add(a),a=g().posix.dirname(a)}return[...b]}(d),...u(c).map(a=>a.replace(/\/+$/,""))]);return(await v(a,[...e])).map(b=>g().resolve(a,b))}catch{return[]}}async function x(a){let b=p(a),c=await n(b);if(!c)return{isGitRepository:!1,repositoryRoot:null,files:[],additions:0,deletions:0,ignoredPaths:[]};let[d,f,h]=await Promise.all([r(c),s(c,b),w(c)]),j=d.flatMap(a=>{let d=g().resolve(c,a.path);return o(b,d)?[{filePath:d,...k(a),indexStatus:a.indexStatus,worktreeStatus:a.worktreeStatus}]:[]}),l=j.reduce((a,b)=>a+("untracked"===b.status?function(a){try{let b=(0,e.lstatSync)(a);if(!b.isFile()||b.size>i._4)return 0;let c=(0,e.readFileSync)(a);if(t(c)||0===c.length)return 0;let d=c.toString("utf8");return d.endsWith("\n")?d.split("\n").length-1:d.split("\n").length}catch{return 0}}(b.filePath):0),0);return{isGitRepository:!0,repositoryRoot:c,files:j,additions:f.additions+l,deletions:f.deletions,ignoredPaths:h.filter(a=>o(b,a))}}function y(a,b){let c=b.endsWith("\n"),d=b.split("\n");c&&d.pop();let e=d.map(a=>`+${a}`).join("\n"),f=!c&&d.length>0?"\n\":"";return`diff --git a/${a} b/${a}
-new file mode 100644
---- /dev/null
-+++ b/${a}
-@@ -0,0 +1,${d.length} @@
-${e}${f}`}async function z(a,b,c){try{return await m(a,["diff","--no-color","--no-ext-diff","--unified=3","HEAD","--",...c&&c!==b?[c,b]:[b]],4*i._4)}catch{return null}}async function A(a,b){let c,d=p(a),f=await n(d),h=g().resolve(d,g().relative(g().resolve(a),g().resolve(b)));if(!f||!o(f,h))return{supported:!1};let j=q(g().relative(f,h)),l=(await r(f)).find(a=>a.path===j);if(!l)return{supported:!1};let{status:m}=k(l);if("deleted"===m){let a=await z(f,j,l.originalPath);return a?.includes("\n@@ ")?{supported:!0,status:m,patch:a}:{supported:!1}}try{c=(0,e.lstatSync)(h)}catch{return{supported:!1}}if(!c.isFile()||c.size>i._4)return{supported:!1};let s=(0,e.readFileSync)(h);if(t(s))return{supported:!1};let u=s.toString("utf8"),v="untracked"===m?y(j,u):await z(f,j,l.originalPath)??("added"===m?y(j,u):null);return v?.includes("\n@@ ")?{supported:!0,status:m,patch:v}:{supported:!1}}},66544:(a,b,c)=>{c.d(b,{E2:()=>j,EN:()=>i});var d=c(77030);function e(a){return(a.startsWith("[")&&a.endsWith("]")?a.slice(1,-1):a).toLowerCase().replace(/\.$/,"")}function f(a){if(!a||/[\s/@\\]/.test(a))return null;try{let b=new URL(`http://${a}`);if(b.username||b.password||"/"!==b.pathname||b.search||b.hash)return null;return e(b.hostname)}catch{return null}}function g(){return[process.env.PI_WEB_HOSTNAME,...process.env.PI_WEB_ALLOWED_HOSTS?.split(",")??[]].filter(a=>!!a?.trim())}function h(a){try{return new URL(a).origin}catch{return null}}function i(a,b=g()){return!!function(a,b=g()){let c=a.headers.get("host"),h=c?f(c):null;return!!h&&(!!("localhost"===h||h.endsWith(".localhost")||(0,d.isIP)(h))||b.some(a=>{let b;return((b=a?.trim())?(0,d.isIP)(b)?e(b):f(b):null)===h}))}(a,b)&&(!!function(a){if("GET"!==a.method||"navigate"!==a.headers.get("sec-fetch-mode")||"document"!==a.headers.get("sec-fetch-dest")||"?1"!==a.headers.get("sec-fetch-user"))return!1;try{return/^\/api\/sessions\/[^/]+\/export$/.test(new URL(a.url).pathname)}catch{return!1}}(a)||!(a.headers.has("origin")||a.headers.has("sec-fetch-site"))||function(a){let b,c;if("cross-site"===a.headers.get("sec-fetch-site"))return!1;let d=a.headers.get("origin");if(!d)return!0;let e=(b=new URL(a.url),(c=a.headers.get("host"))?h(`${b.protocol}//${c}`):null);return null!==e&&h(d)===e}(a))}function j(a){let b=a.headers.get("content-type")?.split(";",1)[0]?.trim().toLowerCase();return"application/json"===b||!!(b?.startsWith("application/")&&b.endsWith("+json"))}},80547:(a,b,c)=>{c.a(a,async(a,d)=>{try{c.d(b,{A$:()=>n,Nw:()=>i.Nw,mc:()=>m,uK:()=>l,wz:()=>i.wz});var e=c(29021),f=c(21820),g=c(33873),h=c.n(g),i=c(25252),j=c(40402),k=a([j]);j=(k.then?(await k)():k)[0];let o=/^[a-zA-Z]:[\\/]/;function l(a){return o.test(a)||a.startsWith("\\\\")||a.startsWith("//")}async function m(){let a=Date.now(),b=globalThis.__piAllowedRootsCache;if(b&&b.expiresAt>a)return b.roots;let c=await (0,j.dQ)(),d=new Set;for(let a of c)a.cwd&&d.add((0,i.Nw)(a.cwd)),a.projectRoot&&d.add((0,i.Nw)(a.projectRoot));try{for(let a of(0,e.readdirSync)((0,f.homedir)()))/^pi-cwd-\d{8}$/.test(a)&&d.add((0,i.Nw)(h().join((0,f.homedir)(),a)))}catch{}for(let a of(0,i.HM)())d.add(a);return globalThis.__piAllowedRootsCache={roots:d,expiresAt:a+5e3},d}function n(a,b){for(let c of b){let b=l(a)||l(c),d=b?h().win32:h(),e=b?"\\":h().sep,f=d.resolve(a),g=d.resolve(c),i=b?f.toLowerCase():f,j=b?g.toLowerCase():g,k=j.endsWith(e)?j:j+e;if(i===j||i.startsWith(k))return!0}return!1}d()}catch(a){d(a)}})}};

package/.next/static/2u8qV5tbHVkAgCeA8TyZR/_buildManifest.js

@@ -1 +0,0 @@
-self.__BUILD_MANIFEST={__rewrites:{afterFiles:[],beforeFiles:[],fallback:[]},__routerFilterStatic:{numItems:39,errorRate:1e-4,numBits:748,numHashes:14,bitArray:[1,0,0,1,0,1,1,1,1,1,0,1,0,1,1,0,0,0,1,0,1,1,1,1,1,0,1,1,1,0,0,0,1,0,1,1,1,1,1,0,0,1,0,1,0,0,1,1,1,0,1,1,0,1,0,0,1,1,0,0,1,1,0,1,0,1,0,1,0,0,1,1,1,1,0,0,1,0,0,1,1,0,0,0,1,0,1,0,1,0,0,0,1,0,1,0,1,0,1,1,1,0,1,1,0,1,0,1,0,1,1,0,1,1,1,0,1,0,1,1,1,0,1,1,1,0,1,1,1,1,1,1,1,0,0,0,0,0,0,1,0,0,0,1,0,0,1,1,0,1,1,0,0,0,1,1,1,1,1,0,1,1,0,0,1,0,0,1,0,1,0,1,1,1,1,0,1,0,1,1,0,0,1,1,0,1,1,0,0,0,0,0,1,0,0,1,0,0,0,1,1,0,1,0,0,1,0,1,0,1,0,0,1,1,0,0,1,0,1,1,1,1,1,0,1,0,1,0,1,0,0,1,0,0,1,1,0,1,0,0,0,0,1,1,1,1,0,0,1,1,1,1,1,0,1,1,0,0,1,1,1,0,1,0,1,0,1,0,1,1,1,1,1,0,1,1,1,0,0,1,1,0,0,0,0,0,1,1,0,0,0,0,1,0,1,1,0,1,1,1,1,1,0,1,0,0,0,0,1,1,0,0,1,0,1,0,1,0,0,0,1,1,1,1,0,0,1,1,0,0,1,1,1,1,0,0,1,1,0,0,0,1,1,1,0,0,0,1,1,0,0,1,1,1,0,0,1,1,0,1,0,0,1,1,1,1,0,0,1,0,1,1,0,1,1,1,0,0,0,0,0,0,0,0,0,1,1,0,1,1,0,1,0,0,1,1,0,1,1,1,0,1,1,0,0,0,0,1,0,0,1,1,0,0,0,0,0,0,0,0,1,0,0,1,0,0,0,1,1,1,0,1,0,1,0,1,0,0,0,0,0,0,0,0,1,1,0,0,1,0,1,0,1,0,1,0,0,0,0,1,0,1,0,1,0,0,1,1,0,1,0,0,0,0,0,0,0,0,0,0,1,1,1,0,0,0,0,0,1,0,1,1,0,1,0,1,0,1,1,1,0,1,0,0,0,1,0,1,1,0,0,0,1,0,0,1,1,0,1,1,0,0,1,1,1,0,1,0,0,0,0,1,0,1,1,0,1,0,1,0,0,1,1,1,0,1,0,0,0,1,1,0,0,0,1,1,0,0,0,0,0,1,1,0,1,1,1,1,0,1,1,1,1,0,0,1,0,1,1,1,0,0,1,0,0,1,0,0,1,1,0,1,1,0,0,0,0,0,1,1,1,0,1,1,1,0,0,1,0,1,1,0,1,0,1,1,0,0,0,0,0,0,1,0,0,0,1,0,0,0,1,0,0,1,0,0,1,1,1,0,1,1,0,1,1,1,0,1,0,0,1,1,1,0,1,0,1,0,1,1,1,0,1,1,1,1,0,1,1,1,1,0,1,1,0,1,0,0,1,0,0,0,1,1,1,0,1,0,1,1,1,1,1,0,1,1,0,0,1,0,0,1,1,1,1,1,1,1,1,1,1,0,1,0,0,0,1,1,1,1,1,0,0,0,1,1,0,1,0,1,1,0,1,1,1,0,1,1,0,0,0,0,1,0,0,1,1,0]},__routerFilterDynamic:{numItems:7,errorRate:1e-4,numBits:135,numHashes:14,bitArray:[0,1,1,0,0,1,0,1,0,0,1,0,0,1,0,1,0,0,0,0,1,0,1,1,1,1,0,0,1,0,0,0,1,1,1,1,1,0,1,0,1,1,1,0,0,0,1,1,1,1,1,0,1,0,0,1,1,1,1,0,1,0,0,1,1,1,1,0,1,1,1,1,1,0,0,0,0,1,0,0,1,0,1,0,0,0,1,0,1,1,1,0,0,1,0,0,0,0,1,0,0,0,0,0,0,0,0,1,1,1,1,1,0,1,1,0,0,0,0,0,1,0,0,1,1,1,1,1,0,0,1,0,1,0,1]},sortedPages:["/_app"]},self.__BUILD_MANIFEST_CB&&self.__BUILD_MANIFEST_CB();