@qt4798/pi-web 0.9.3

package/README.ja.md

@@ -0,0 +1,150 @@
+# Pi Web
+
+[English](./README.en.md) | [简体中文](./README.md) | [Русский](./README.ru.md)
+
+[pi コーディングエージェント](https://github.com/badlogic/pi-mono) のローカル Web UI です。Pi Web はローカルの pi セッションファイルを読み込み、セッションの閲覧、リアルタイムチャット、モデル設定、スキル管理、プロジェクトファイルのプレビューを行えるブラウザワークスペースを提供します。
+
+![Pi Web では、CLI と同じ pi セッションを、構造化された Markdown、ツール呼び出し、プロジェクトナビゲーションとともに表示できます](https://raw.githubusercontent.com/agegr/pi-web/main/docs/screenshot2.png)
+
+CLI と Pi Web で同じ pi セッションを利用できます。構造化されたツール呼び出し、読みやすい Markdown、セッション閲覧、整理された結果表示を備えています。
+
+## クイックスタート
+
+Pi Web には Node.js 22.19.0 以降が必要です。現在のバージョンは `node --version` で確認できます。
+
+**インストールせずに実行：**
+
+```bash
+npx @agegr/pi-web@latest
+```
+
+**またはグローバルにインストール：**
+
+```bash
+npm install -g @agegr/pi-web
+pi-web
+```
+
+続いて [http://127.0.0.1:30141](http://127.0.0.1:30141) を開きます。サーバーの準備が整うと、CLI はブラウザを自動的に開こうとします。Pi Web はデフォルトで `127.0.0.1` のみをリッスンします。
+
+**オプション：**
+
+```bash
+pi-web --port 8080              # カスタムポート
+pi-web --hostname 0.0.0.0       # 信頼できるネットワークに公開
+pi-web -p 8080 -H 0.0.0.0       # オプションを組み合わせる
+pi-web --no-open                # ブラウザを自動的に開かない
+
+PORT=8080 pi-web                # 環境変数にも対応
+PI_WEB_HOSTNAME=0.0.0.0 pi-web  # ネットワーク公開を明示的に有効化
+PI_WEB_ALLOWED_HOSTS=pi-web.internal pi-web  # プロキシまたはカスタムホスト名を許可
+PI_WEB_PASSWORD='十分に長いランダムなパスワード' pi-web  # Basic Auth を有効化（ユーザー名: pi）
+PI_WEB_NO_OPEN=1 pi-web         # バックグラウンドサービスとして実行する場合に便利
+```
+
+`PI_WEB_PASSWORD` を設定すると、Web インターフェースとすべての API エンドポイントが HTTP Basic Auth で保護されます。ユーザー名は常に `pi` です。未設定または空の場合、認証は無効です。
+
+Pi Web は高権限のエージェントを呼び出せます。Basic Auth は転送中のパスワードを暗号化しないため、平文 HTTP をインターネットに公開しないでください。リモートアクセスには、信頼できるリバースプロキシによる HTTPS または信頼できる VPN を使用してください。
+API リクエストでは、loopback 名、IP リテラル、選択したバインドホスト名、および `PI_WEB_ALLOWED_HOSTS` にカンマ区切りで指定した完全一致のホスト名のみを受け入れます。信頼できるリバースプロキシが異なる外部ホスト名を使用する場合は、この変数を設定してください。
+
+## HTTP プロキシ
+
+Pi Web は、サーバー側のモデルリクエストと API リクエストに標準の `HTTP_PROXY`、`HTTPS_PROXY`、`NO_PROXY` 環境変数を使用します。
+
+macOS または Linux：
+
+```bash
+HTTP_PROXY=http://127.0.0.1:7890 \
+HTTPS_PROXY=http://127.0.0.1:7890 \
+NO_PROXY=localhost,127.0.0.1 \
+npx @agegr/pi-web@latest
+```
+
+Windows PowerShell：
+
+```powershell
+$env:HTTP_PROXY = "http://127.0.0.1:7890"
+$env:HTTPS_PROXY = "http://127.0.0.1:7890"
+$env:NO_PROXY = "localhost,127.0.0.1"
+npx @agegr/pi-web@latest
+```
+
+## 機能
+
+- **作業をすぐに再開**：セッションのパスやターミナル履歴を探さずに、プロジェクトごとに過去の pi の会話を閲覧できます。
+- **別の方向性を安全に試す**：以前のメッセージから続けるか、セッションをフォークして別の進め方を試せます。
+- **ブランチをまたいで作業**：サイドバーから Git worktree を切り替えると、新しいセッションと Explorer が選択したチェックアウトに追従します。
+- **プロジェクトを見ながらチャット**：エージェントの作業中に、左側でファイルを閲覧し、右側でソース、ドキュメント、画像、音声、PDF をプレビューできます。
+- **セッションの状態を明確に把握**：コンテキスト使用量、コスト、コンパクション状態、システムプロンプトの詳細をトップバーで確認できます。
+- **ターミナルでの設定を削減**：モデル、ログイン／API キー、モデルテスト、スキルの切り替えを Web UI から管理できます。
+
+## 注意事項
+
+- **データディレクトリ**：Pi Web はデフォルトで `~/.pi/agent/sessions` を読み込みます。別の pi エージェントディレクトリを指定するには `PI_CODING_AGENT_DIR` を設定してください。
+- **セッションファイル**：ファイルは `~/.pi/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl` に保存されます。
+- **モデル設定**：Models パネルは pi エージェントディレクトリ内の `models.json` を読み書きします。モデルの一覧とデフォルト値は pi の設定から取得されます。
+- **ファイルアクセス**：ファイルの閲覧とプレビューは、選択したプロジェクトディレクトリとセッションに含まれる作業ディレクトリに限定されます。
+- **Git worktree**：切り替え機能が表示される条件、新しい worktree の作成方法、削除時の動作については、[Pi Web の Worktree](./docs/worktrees.md) を参照してください。
+- **Fork とセッション内ブランチの違い**：Fork は新しい `.jsonl` ファイルを作成します。"Edit from here" は同じセッションファイル内に別のブランチを作成します。
+
+## 開発
+
+```bash
+npm install
+npm run dev
+```
+
+ローカル開発サーバーは [http://127.0.0.1:30141](http://127.0.0.1:30141) で動作します。
+
+よく使うチェック：
+
+```bash
+node_modules/.bin/tsc --noEmit
+npm run lint
+```
+
+ローカル開発中は `next build` / `npm run build` を実行しないでください。`.next/` に書き込みが行われ、開発サーバーに影響する可能性があります。ビルドはリリース作業に任せてください。
+
+## プロジェクト構成
+
+```text
+app/
+  api/
+    agent/          # AgentSession を作成・操作し、SSE イベントを公開
+    auth/           # OAuth と API キーの管理
+    cwd/validate/   # カスタム作業ディレクトリの検証
+    default-cwd/    # pi のデフォルト作業ディレクトリを取得
+    files/          # ファイルの一覧、読み込み、プレビュー、監視
+    home/           # 現在のユーザーのホームディレクトリ
+    models/         # 利用可能なモデル、デフォルトモデル、思考レベル
+    models-config/  # models.json の読み書きとモデルのテスト
+    sessions/       # セッションの読み込み、名前変更、削除、コンテキスト、HTML エクスポート
+    skills/         # スキルの一覧、検索、インストール、有効化／無効化
+components/
+  AppShell.tsx        # メインレイアウト、URL 状態、上部パネル、ファイルタブ
+  SessionSidebar.tsx  # プロジェクト選択、セッションツリー、Explorer
+  ChatWindow.tsx      # メッセージ、SSE、画像のドラッグ＆ドロップ、ミニマップ
+  ChatInput.tsx       # 入力欄、モデル／ツール／思考／コンパクション／スラッシュコントロール
+  MessageView.tsx     # メッセージ、思考、ツール呼び出し／結果の表示
+  ModelsConfig.tsx    # モデルと認証の設定パネル
+  SkillsConfig.tsx    # スキル管理パネル
+  FileExplorer.tsx    # ファイルツリー
+  FileViewer.tsx      # ソース、差分、画像、音声、PDF、DOCX のプレビュー
+lib/
+  http-dispatcher.ts  # サーバー側 fetch の HTTP(S) プロキシ設定
+  rpc-manager.ts      # AgentSessionWrapper のライフサイクルとグローバルレジストリ
+  session-reader.ts   # .jsonl セッションファイルとブランチコンテキストの解析
+  normalize.ts        # toolCall フィールド名の正規化
+  file-access.ts      # ファイル読み込みの安全境界
+  file-paths.ts       # ファイルパスのエンコードと相対パスのヘルパー
+  markdown.ts         # Markdown／Mermaid／KaTeX プラグインの設定
+  pi-types.ts         # pi 関連の型
+hooks/
+  useAgentSession.ts  # セッションの読み込み、コマンド送信、SSE ステートマシン
+  useAudio.ts         # 完了通知音
+  useDragDrop.ts      # 画像のドラッグ＆ドロップ
+  useTheme.ts         # テーマの切り替え
+bin/
+  pi-web.js           # npm CLI エントリポイント
+instrumentation.ts    # サーバー HTTP ディスパッチャーの初期化
+```

package/README.md

@@ -0,0 +1,175 @@
+<div align="center">
+
+# Pi Web
+
+**Pi coding agent 的纯网页工作台**
+
+读取本机 Pi 会话，提供实时对话、项目文件浏览、模型/技能/插件配置、Git Worktree 与移动端界面。该仓库只发布 Web 服务，不再提供 Electron 桌面应用或安装包。
+
+[English](./README.en.md)
+
+![Node](https://img.shields.io/badge/node-%3E%3D22.19.0-green)
+![Next.js](https://img.shields.io/badge/Next.js-16-black)
+![License](https://img.shields.io/badge/license-MIT-yellow)
+
+</div>
+
+## 界面预览
+
+![Pi Web 网页工作台](./docs/screenshots/web-workspace.png)
+
+<p align="center">
+  <img src="./docs/screenshots/mobile-web.png" alt="Pi Web 移动端界面" width="320" />
+</p>
+
+## 功能
+
+| 能力 | 说明 |
+| --- | --- |
+| 实时对话 | 通过 SSE 显示 Pi Agent 的流式输出、工具调用、思考过程与错误状态。 |
+| 会话管理 | 按项目查看会话，支持会话内分支、Fork、重命名、删除、AI 自动生成标题与 HTML 导出。 |
+| 项目与文件 | 通过目录选择器加载项目，浏览文件、Diff、图片、音频、PDF、DOCX。 |
+| 模型与认证 | 在网页中管理模型、OAuth/API Key、连通性测试和默认模型；支持从供应商自动获取模型列表与 models.dev 定价预设一键填入。 |
+| 技能与插件 | 查询、安装、启停 Skills 与 package 插件。 |
+| Git Worktree | 在同一项目下创建、切换和移除 Worktree。 |
+| 主题与语言 | 支持 Pi TUI 主题、亮暗模式及中文/English。 |
+| 移动端 | 适配 Safari/Chrome 窄屏布局；模型选择和发送操作保持可见。 |
+
+## 最新更新（2026-08-04）
+
+- **供应商获取模型**：模型配置中可直接从供应商的 Base URL 拉取模型列表（支持 OpenAI / Anthropic / Google 等协议），筛选、多选后一键添加，无需手写模型 ID。
+- **models.dev 定价预设**：填写模型 ID 后一键从 models.dev 拉取名称、上下文窗口、价格等字段填入，支持撤销；价格来源与可信度一目了然。
+- **对话滚动跟随**：修复 agent 运行时消息列表跳到底部空白的问题；流式输出期间停留在列表底部则自动跟随，滚到上方查看历史不被打断，且最后一条消息与输入框之间保留间距。
+- **快捷操作**：文件标签页支持中间键关闭；会话删除支持 Shift+点击跳过确认；Markdown 中的本地图片可直接预览。
+- **URL 直达目录**：通过 `?cwd=<路径>` 参数打开网页时直接校验并进入指定目录的新会话。
+
+## 最新更新（2026-08-03）
+
+- **Web-only 基线**：界面和运行代码已统一为 `pi-web-desktop` 的网页基线；Electron 主进程、桌面端打包、PWA Service Worker 与 tag 驱动的桌面 Release 工作流已移除。
+- **目录选择器**：侧栏“选择文件夹”改为可逐级浏览的目录弹窗，选择“此文件夹”后直接加载项目，不再要求手动输入路径。
+- **移动端可用性**：当前模型和发送按钮始终显示；项目名、Git 仓库/Worktree 名在窄屏缩小并省略，避免横向滚动。
+- **模型下拉稳定性**：展开或收起供应商二级模型列表时，面板外框保持固定高度，只有结果列表滚动，不再上下跳动。
+- **QT 固定主题**：显示设置重新提供 Gruvbox、Nord、Tokyo Night、Solarized、One Dark、Dracula 与 Catppuccin；它们和 Pi JSON 自定义主题共存，均支持浅色、深色与跟随系统。
+- **移动端输入区**：聊天输入框提高到 52px；保持 16px 防止 iOS Safari 聚焦缩放，同时以更紧凑的行高和字距降低文字视觉体积。
+- **运行与渲染修复**：生产服务不再依赖 Turbopack 开发 chunk；Markdown 表格行引用保持合法 DOM 结构，避免 hydration 报错。
+
+## 快速开始
+
+### 前置条件
+
+- Node.js **22.19.0 或更高版本**
+- 已配置可用的 Pi 模型/认证信息
+
+### 从 npm 安装（推荐）
+
+```bash
+npx @qt4798/pi-web@latest
+```
+
+或全局安装：
+
+```bash
+npm install -g @qt4798/pi-web
+pi-web
+```
+
+然后打开 [http://127.0.0.1:30141](http://127.0.0.1:30141)。CLI 会在服务就绪后自动打开浏览器。默认只监听 `127.0.0.1`。
+
+**常用选项：**
+
+```bash
+pi-web --port 8080              # 自定义端口
+pi-web --hostname 0.0.0.0       # 暴露在局域网
+pi-web -p 8080 -H 0.0.0.0       # 组合使用
+pi-web --no-open                # 不自动打开浏览器
+
+PORT=8080 pi-web                # 也可通过环境变量设置端口
+PI_WEB_HOSTNAME=0.0.0.0 pi-web  # 显式设置监听地址
+PI_WEB_ALLOWED_HOSTS=piweb.example.com pi-web  # 允许反向代理域名
+PI_WEB_PASSWORD='随机长密码' pi-web           # 启用 HTTP Basic Auth（用户名 pi）
+PI_WEB_NO_OPEN=1 pi-web         # 后台服务不自动打开浏览器
+```
+
+设置 `PI_WEB_PASSWORD` 后，所有网页接口和 API 端点都需要 HTTP Basic Auth 认证，用户名为 `pi`。不设或留空则禁用认证。
+
+> Basic Auth 不加密传输中的密码。请勿将纯 HTTP 直接暴露到公网，通过可信反向代理启用 HTTPS 或使用可信 VPN 进行远程访问。
+
+### 从源码运行
+
+```bash
+git clone https://github.com/t479842598/pi-web-QT.git
+cd pi-web-QT
+npm ci
+npm run dev
+```
+
+浏览器打开 `http://127.0.0.1:30141`。
+
+开发服务器默认只监听本机。局域网调试可使用：
+
+```bash
+npm run dev:lan
+```
+
+## 生产部署
+
+完整部署步骤见 [docs/deployment.md](./docs/deployment.md)。最小流程：
+
+```bash
+npm ci
+npm run build
+PI_WEB_PASSWORD='替换为随机长密码' \
+PI_WEB_ALLOWED_HOSTS='piweb.example.com' \
+node bin/pi-web.js -H 127.0.0.1 -p 30141 --no-open
+```
+
+生产环境建议：
+
+1. 让 Pi Web 仅监听 `127.0.0.1`。
+2. 用 Caddy、Nginx 或 Cloudflare Tunnel 对外提供 HTTPS。
+3. 设置 `PI_WEB_PASSWORD` 与精确的 `PI_WEB_ALLOWED_HOSTS`。
+4. 用 systemd 或 launchd 守护 `node bin/pi-web.js` 进程。
+
+### 环境变量
+
+| 变量 | 用途 |
+| --- | --- |
+| `PI_WEB_PASSWORD` | 启用 HTTP Basic Auth；用户名固定为 `pi`。 |
+| `PI_WEB_ALLOWED_HOSTS` | 以逗号分隔的外部允许域名，例如 `piweb.example.com`。 |
+| `PI_CODING_AGENT_DIR` | 指向另一套 Pi 数据目录；默认使用 `~/.pi/agent`。 |
+| `HTTP_PROXY` / `HTTPS_PROXY` / `NO_PROXY` | 为服务端模型/API 请求设置代理。 |
+| `PI_WEB_NO_OPEN=1` | 禁止 CLI 在服务启动后自动打开浏览器。 |
+
+## 目录选择与移动端
+
+- 侧栏的“选择文件夹”会打开目录浏览器；逐层进入目录后，点击“选择此文件夹”加载项目。
+- 移动端底部始终保留当前模型名称与发送按钮；思考、工具、压缩和提示音收纳在“更多控件”中。
+- 长项目路径、仓库名和 Worktree 名会省略显示，避免窄屏横向滚动。
+
+## 开发与验证
+
+```bash
+node_modules/.bin/tsc --noEmit
+npm run lint
+```
+
+本地开发不要运行 `npm run build`；它会改写 `.next/` 并干扰 `npm run dev`。生产部署或 CI 可运行构建。
+
+## 项目结构
+
+```text
+app/            Next.js App Router 与 API 路由
+components/     会话、聊天、目录选择、文件预览和设置界面
+hooks/          会话、主题、音频、移动端等前端状态
+lib/            Pi SDK、会话读取、文件边界、Worktree 与配置逻辑
+bin/pi-web.js   生产 Web 服务 CLI 入口
+docs/           部署说明、截图与功能文档
+```
+
+## Web-only 说明
+
+本仓库不含 Electron 主进程、安装向导、桌面端打包依赖或 GitHub Release 打包工作流。请使用浏览器访问部署后的 Pi Web 服务。
+
+## 许可证
+
+[MIT](./LICENSE)

package/README.ru.md

@@ -0,0 +1,155 @@
+# Pi Web
+
+[English](./README.en.md) | [中文文档](./README.md) | [日本語](./README.ja.md)
+
+Локальный веб-интерфейс для [pi coding agent](https://github.com/badlogic/pi-mono). Pi Web читает локальные файлы сессий pi и предоставляет рабочее пространство в браузере для просмотра сессий, общения с агентом в реальном времени, настройки моделей, управления навыками и предварительного просмотра файлов проекта.
+
+![Pi Web показывает одну и ту же сессию pi рядом с CLI: структурированный Markdown, вызовы инструментов и навигация по проекту](https://raw.githubusercontent.com/agegr/pi-web/main/docs/screenshot2.png)
+
+Одна и та же сессия pi в CLI и Pi Web: структурированные вызовы инструментов, удобочитаемый Markdown, просмотр сессий и наглядные результаты.
+
+## Быстрый старт
+
+Для работы Pi Web требуется Node.js **22.19.0** или новее. Проверьте версию командой `node --version`.
+
+**Запуск без установки:**
+
+```bash
+npx @agegr/pi-web@latest
+```
+
+**Или глобальная установка:**
+
+```bash
+npm install -g @agegr/pi-web
+pi-web
+```
+
+Затем откройте [http://127.0.0.1:30141](http://127.0.0.1:30141). После запуска сервера CLI попытается автоматически открыть браузер. По умолчанию Pi Web прослушивает только `127.0.0.1`.
+
+**Параметры:**
+
+```bash
+pi-web --port 8080              # другой порт
+pi-web --hostname 0.0.0.0       # доступ в доверенной сети
+pi-web -p 8080 -H 0.0.0.0       # сочетание параметров
+pi-web --no-open                # не открывать браузер автоматически
+
+PORT=8080 pi-web                # порт также можно задать переменной окружения
+PI_WEB_HOSTNAME=0.0.0.0 pi-web  # явное разрешение сетевого доступа
+PI_WEB_ALLOWED_HOSTS=pi-web.internal pi-web  # точное имя прокси или другого хоста
+PI_WEB_PASSWORD='длинный-случайный-пароль' pi-web  # Basic Auth (имя пользователя: pi)
+PI_WEB_NO_OPEN=1 pi-web         # удобно для фоновой службы
+```
+
+Задайте `PI_WEB_PASSWORD`, чтобы защитить веб-интерфейс и все конечные точки API с помощью HTTP Basic Auth. Имя пользователя всегда `pi`. Если переменная не задана или пуста, аутентификация отключена.
+
+Pi Web может вызывать агента с широкими полномочиями. Basic Auth не шифрует пароль при передаче, поэтому не публикуйте обычный HTTP-сервер в интернете. Для удалённого доступа используйте HTTPS через доверенный обратный прокси или надёжное VPN-подключение.
+API-запросы принимаются для loopback-имён, IP-адресов, выбранного имени хоста и точных имён из `PI_WEB_ALLOWED_HOSTS`, разделённых запятыми. Задайте эту переменную, если доверенный обратный прокси использует другое внешнее имя хоста.
+
+## HTTP-прокси
+
+Для серверных запросов к моделям и API Pi Web использует стандартные переменные окружения `HTTP_PROXY`, `HTTPS_PROXY` и `NO_PROXY`.
+
+В macOS и Linux:
+
+```bash
+HTTP_PROXY=http://127.0.0.1:7890 \
+HTTPS_PROXY=http://127.0.0.1:7890 \
+NO_PROXY=localhost,127.0.0.1 \
+npx @agegr/pi-web@latest
+```
+
+В Windows PowerShell:
+
+```powershell
+$env:HTTP_PROXY = "http://127.0.0.1:7890"
+$env:HTTPS_PROXY = "http://127.0.0.1:7890"
+$env:NO_PROXY = "localhost,127.0.0.1"
+npx @agegr/pi-web@latest
+```
+
+## Возможности
+
+- **Продолжайте работу с прежнего места**: просматривайте предыдущие разговоры с pi по проектам, не разыскивая их в истории терминала или путях к сессиям.
+- **Безопасно пробуйте разные подходы**: продолжайте диалог с более раннего сообщения или создавайте отдельный форк сессии.
+- **Работайте с разными ветками**: переключайте Git worktree в боковой панели, чтобы новые сессии и Explorer следовали за выбранным рабочим деревом.
+- **Общайтесь с агентом рядом с проектом**: просматривайте файлы слева, а исходный код, документы, изображения, аудио и PDF — справа, пока агент работает.
+- **Следите за состоянием сессии**: в верхней панели видны использование контекста, стоимость, состояние сжатия и сведения о системном промпте.
+- **Реже обращайтесь к терминалу**: управляйте моделями, учётными данными для входа и API, тестированием моделей и переключателями навыков в веб-интерфейсе.
+- **Используйте удобный язык интерфейса**: переключайтесь между поддерживаемыми языками в верхней панели.
+
+## Примечания
+
+- **Каталог данных**: по умолчанию Pi Web читает `~/.pi/agent/sessions`. Чтобы указать другой каталог агента pi, задайте `PI_CODING_AGENT_DIR`.
+- **Файлы сессий**: файлы хранятся по пути `~/.pi/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl`.
+- **Настройка моделей**: панель Models читает и записывает `models.json` в каталоге агента pi. Список моделей и модель по умолчанию берутся из конфигурации pi.
+- **Доступ к файлам**: просмотр файлов ограничен выбранным каталогом проекта и рабочими каталогами, которые встречаются в сессиях.
+- **Git worktree**: условия отображения переключателя, создание новых рабочих деревьев и их удаление описаны в документе [Worktrees in Pi Web](./docs/worktrees.md).
+- **Форк и ветка внутри сессии**: Fork создаёт новый файл `.jsonl`, а «Edit from here» — другую ветку внутри того же файла сессии.
+- **Интернационализация**: использование переводов и добавление языков или текстов интерфейса описаны в документе [Internationalization](./docs/i18n.md).
+
+## Разработка
+
+```bash
+npm install
+npm run dev
+```
+
+Локальный сервер разработки доступен по адресу [http://127.0.0.1:30141](http://127.0.0.1:30141).
+
+Основные проверки:
+
+```bash
+node_modules/.bin/tsc --noEmit
+npm run lint
+```
+
+Не запускайте `next build` / `npm run build` во время локальной разработки. Эта команда записывает данные в `.next/` и может помешать работе сервера разработки; выполняйте сборку только при подготовке релиза.
+
+## Структура проекта
+
+```text
+app/
+  api/
+    agent/          # создание и управление AgentSession, события SSE
+    auth/           # управление OAuth и ключами API
+    cwd/browse/     # просмотр каталогов на сервере
+    cwd/validate/   # проверка пользовательского рабочего каталога
+    default-cwd/    # рабочий каталог pi по умолчанию
+    files/          # список, чтение, просмотр и отслеживание файлов
+    home/           # домашний каталог текущего пользователя
+    models/         # доступные модели, модель по умолчанию, уровни рассуждения
+    models-config/  # чтение и запись models.json, проверка моделей
+    sessions/       # чтение, переименование, удаление, контекст и экспорт сессий в HTML
+    skills/         # список, поиск, установка, включение и отключение навыков
+components/
+  AppShell.tsx        # основной макет, состояние URL, верхние панели, вкладки файлов
+  SessionSidebar.tsx  # выбор проекта, дерево сессий, Explorer
+  DirectoryPicker.tsx # просмотр и изменение рабочего каталога
+  ChatWindow.tsx      # сообщения, SSE, перетаскивание изображений, мини-карта
+  ChatInput.tsx       # модели, инструменты, рассуждение, сжатие и слеш-команды
+  MessageView.tsx     # сообщения, рассуждения, вызовы инструментов и результаты
+  ModelsConfig.tsx    # настройка моделей и аутентификации
+  SkillsConfig.tsx    # управление навыками
+  FileExplorer.tsx    # дерево файлов
+  FileViewer.tsx      # просмотр кода, diff, изображений, аудио, PDF и DOCX
+lib/
+  directory-browser.ts # нормализация каталогов и безопасный просмотр
+  http-dispatcher.ts  # настройка HTTP(S)-прокси для серверных запросов
+  rpc-manager.ts      # жизненный цикл AgentSessionWrapper и глобальный реестр
+  session-reader.ts   # разбор файлов сессий .jsonl и контекста веток
+  normalize.ts        # нормализация имён полей toolCall
+  file-access.ts      # границы безопасного чтения файлов
+  file-paths.ts       # кодирование путей и работа с относительными путями
+  markdown.ts         # настройка плагинов Markdown, Mermaid и KaTeX
+  pi-types.ts         # типы, связанные с pi
+hooks/
+  useAgentSession.ts  # загрузка сессии, команды и автомат состояний SSE
+  useAudio.ts         # звук завершения
+  useDragDrop.ts      # перетаскивание изображений
+  useTheme.ts         # переключение темы
+bin/
+  pi-web.js           # точка входа npm CLI
+instrumentation.ts    # инициализация HTTP-диспетчера сервера
+```

package/bin/pi-web-options.js

@@ -0,0 +1,30 @@
+"use strict";
+
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { parseArgs } = require("util");
+
+const TRUE_VALUES = new Set(["1", "true", "yes", "on"]);
+
+function isEnabled(value) {
+  return typeof value === "string" && TRUE_VALUES.has(value.trim().toLowerCase());
+}
+
+function parseLaunchOptions(args = process.argv.slice(2), env = process.env) {
+  const { values: cliArgs } = parseArgs({
+    args,
+    options: {
+      port:      { type: "string", short: "p" },
+      hostname:  { type: "string", short: "H" },
+      "no-open": { type: "boolean" },
+    },
+    strict: false,
+  });
+
+  return {
+    port: cliArgs.port ?? env.PORT ?? "30141",
+    hostname: cliArgs.hostname ?? env.PI_WEB_HOSTNAME ?? "127.0.0.1",
+    openBrowser: !cliArgs["no-open"] && !isEnabled(env.PI_WEB_NO_OPEN),
+  };
+}
+
+module.exports = { parseLaunchOptions };

package/bin/pi-web.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+"use strict";
+
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { spawn } = require("child_process");
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const path = require("path");
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const fs = require("fs");
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { parseLaunchOptions } = require("./pi-web-options");
+
+const pkgDir = path.join(__dirname, "..");
+const nextDir = path.join(pkgDir, ".next");
+
+// Resolve next's CLI entry directly to avoid relying on .bin symlinks (which
+// may not exist when installed via npx).
+let nextBin;
+try {
+  nextBin = require.resolve("next/dist/bin/next", { paths: [pkgDir] });
+} catch {
+  // Fallback: locate next package root and derive the bin path manually.
+  try {
+    const nextPkg = require.resolve("next/package.json", { paths: [pkgDir] });
+    nextBin = path.join(path.dirname(nextPkg), "dist", "bin", "next");
+  } catch {
+    nextBin = path.join(pkgDir, "node_modules", "next", "dist", "bin", "next");
+  }
+}
+
+const { port, hostname, openBrowser } = parseLaunchOptions();
+
+if (!fs.existsSync(nextDir)) {
+  console.error("Build artifacts not found. Please report this issue.");
+  process.exit(1);
+}
+
+const nextArgs = ["start", "-p", port, "-H", hostname];
+
+// Always run next's JS entry with node directly — avoids .bin symlink issues
+// and path-with-spaces problems on Windows when shell: true is used.
+const child = spawn(process.execPath, [nextBin, ...nextArgs], {
+  cwd: pkgDir,
+  stdio: ["inherit", "pipe", "inherit"],
+  env: { ...process.env, PI_WEB_HOSTNAME: hostname },
+});
+
+if (hostname !== "127.0.0.1" && hostname !== "localhost" && hostname !== "::1") {
+  if (process.env.PI_WEB_PASSWORD) {
+    console.warn("Pi Web is exposed beyond loopback. HTTP Basic Auth does not encrypt credentials; use HTTPS or a trusted VPN.");
+  } else {
+    console.warn("Pi Web is exposed beyond loopback without authentication. Use only on a trusted network.");
+  }
+}
+
+let browserOpened = false;
+const url = `http://${hostname}:${port}`;
+
+child.stdout.on("data", (chunk) => {
+  const text = chunk.toString();
+  process.stdout.write(text);
+  if (openBrowser && !browserOpened && text.includes("Ready")) {
+    browserOpened = true;
+    const isWindows = process.platform === "win32";
+    const isMac = process.platform === "darwin";
+    const openCmd = isWindows ? "start" : isMac ? "open" : "xdg-open";
+    const opener = spawn(openCmd, [url], {
+      shell: isWindows,
+      stdio: "ignore",
+      detached: true,
+    });
+
+    opener.on("error", (error) => {
+      console.warn(`Could not open browser automatically: ${error.message}`);
+    });
+
+    opener.unref();
+  }
+});
+
+child.on("exit", (code) => process.exit(code ?? 0));

package/next.config.ts

@@ -0,0 +1,42 @@
+import type { NextConfig } from "next";
+import { readFileSync } from "fs";
+import { join } from "path";
+
+const { version } = JSON.parse(readFileSync(join(__dirname, "package.json"), "utf8")) as { version: string };
+const allowedDevOrigins = (process.env.PI_WEB_ALLOWED_HOSTS?.split(",") ?? [])
+  .map((host) => host.trim())
+  .filter(Boolean);
+let piVersion = "unknown";
+try {
+  const piPkgPath = join(__dirname, "node_modules/@earendil-works/pi-coding-agent/package.json");
+  piVersion = (JSON.parse(readFileSync(piPkgPath, "utf8")) as { version: string }).version;
+} catch { /* package not found, use default */ }
+
+const nextConfig: NextConfig = {
+  allowedDevOrigins,
+  devIndicators: false,
+  serverExternalPackages: [
+    "@earendil-works/pi-agent-core",
+    "@earendil-works/pi-coding-agent",
+    "@earendil-works/pi-ai",
+    "@earendil-works/pi-tui",
+    "undici",
+  ],
+  async headers() {
+    return [
+      {
+        source: "/",
+        headers: [
+          { key: "Cache-Control", value: "private, no-cache, max-age=0, must-revalidate" },
+        ],
+      },
+
+    ];
+  },
+  env: {
+    NEXT_PUBLIC_APP_VERSION: version,
+    NEXT_PUBLIC_PI_VERSION: piVersion,
+  },
+};
+
+export default nextConfig;