@pricening/pi-web 0.9.8 → 0.9.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.next/BUILD_ID +1 -1
- package/.next/app-path-routes-manifest.json +12 -12
- package/.next/build-manifest.json +2 -2
- package/.next/prerender-manifest.json +3 -3
- package/.next/required-server-files.js +2 -2
- package/.next/required-server-files.json +2 -2
- package/.next/server/app/_global-error/page_client-reference-manifest.js +1 -1
- package/.next/server/app/_global-error.html +1 -1
- package/.next/server/app/_global-error.rsc +1 -1
- package/.next/server/app/_global-error.segments/_full.segment.rsc +1 -1
- package/.next/server/app/_global-error.segments/_global-error/__PAGE__.segment.rsc +1 -1
- package/.next/server/app/_global-error.segments/_tree.segment.rsc +1 -1
- package/.next/server/app/_not-found/page_client-reference-manifest.js +1 -1
- package/.next/server/app/_not-found.html +1 -1
- package/.next/server/app/_not-found.rsc +3 -3
- package/.next/server/app/_not-found.segments/_full.segment.rsc +3 -3
- package/.next/server/app/_not-found.segments/_not-found/__PAGE__.segment.rsc +3 -3
- package/.next/server/app/_not-found.segments/_tree.segment.rsc +2 -2
- package/.next/server/app/api/agent/[id]/events/route.js +2 -2
- package/.next/server/app/api/app-update/route.js +1 -1
- package/.next/server/app/api/auth/api-key/[provider]/route.js +1 -1
- package/.next/server/app/api/auth/login/[provider]/route.js +2 -2
- package/.next/server/app/api/auth/logout/[provider]/route.js +1 -1
- package/.next/server/app/api/auth/providers/route.js +1 -1
- package/.next/server/app/api/models/route.js +1 -1
- package/.next/server/app/api/plugins/check/route.js +1 -1
- package/.next/server/app/api/plugins/route.js +1 -1
- package/.next/server/app/api/provider-usage/query/route.js +1 -1
- package/.next/server/app/api/sessions/[id]/auto-name/route.js +4 -3
- package/.next/server/app/api/sessions/[id]/auto-name/route.js.nft.json +1 -1
- package/.next/server/app/api/sessions/[id]/route.js +1 -1
- package/.next/server/app/api/skills/install/route.js +1 -1
- package/.next/server/app/api/skills/search/route.js +1 -1
- package/.next/server/app/api/skills/update/route.js +1 -1
- package/.next/server/app/index.html +1 -1
- package/.next/server/app/index.rsc +5 -5
- package/.next/server/app/index.segments/__PAGE__.segment.rsc +5 -5
- package/.next/server/app/index.segments/_full.segment.rsc +5 -5
- package/.next/server/app/index.segments/_tree.segment.rsc +2 -2
- package/.next/server/app/login/page_client-reference-manifest.js +1 -1
- package/.next/server/app/login.html +1 -1
- package/.next/server/app/login.rsc +4 -4
- package/.next/server/app/login.segments/_full.segment.rsc +4 -4
- package/.next/server/app/login.segments/_tree.segment.rsc +2 -2
- package/.next/server/app/login.segments/login/__PAGE__.segment.rsc +4 -4
- package/.next/server/app/page.js +20 -20
- package/.next/server/app/page_client-reference-manifest.js +1 -1
- package/.next/server/app-paths-manifest.json +12 -12
- package/.next/server/chunks/2243.js +1 -1
- package/.next/server/chunks/3573.js +1 -1
- package/.next/server/chunks/4353.js +1 -0
- package/.next/server/chunks/5582.js +2 -2
- package/.next/server/chunks/6429.js +7 -5
- package/.next/server/instrumentation.js +1 -1
- package/.next/server/instrumentation.js.nft.json +1 -1
- package/.next/server/middleware-build-manifest.js +1 -1
- package/.next/server/next-font-manifest.js +1 -1
- package/.next/server/next-font-manifest.json +1 -1
- package/.next/server/pages/404.html +1 -1
- package/.next/server/pages/500.html +1 -1
- package/.next/server/server-reference-manifest.json +1 -1
- package/.next/static/chunks/1278-3bb20200f46a509d.js +1 -0
- package/.next/static/chunks/app/layout-815fddea152adfd1.js +1 -0
- package/.next/static/chunks/app/page-5d1e39cad0da02b2.js +283 -0
- package/.next/static/css/{f4a799a04a7a8a76.css → bcb1a8e544e62fd8.css} +1 -1
- package/.next/trace +40 -39
- package/.next/trace-build +1 -1
- package/README.ja.md +7 -130
- package/README.md +51 -123
- package/README.ru.md +7 -130
- package/README.zh-CN.md +51 -77
- package/bin/pi-web-node-args.js +11 -0
- package/bin/pi-web.js +3 -1
- package/next.config.ts +7 -0
- package/package.json +2 -2
- package/public/sw.js +23 -2
- package/public/sw.test.mjs +107 -1
- package/.next/server/chunks/2349.js +0 -1
- package/.next/static/chunks/1278-4e101e127edaae15.js +0 -1
- package/.next/static/chunks/app/layout-defc84c8112fb814.js +0 -1
- package/.next/static/chunks/app/page-89f22c7c0fc4ff07.js +0 -283
- /package/.next/static/{v2ujhGjLkjIUa9TUL8cVR → SW_diFgxch2hiN4O6LYY0}/_buildManifest.js +0 -0
- /package/.next/static/{v2ujhGjLkjIUa9TUL8cVR → SW_diFgxch2hiN4O6LYY0}/_ssgManifest.js +0 -0
package/.next/trace-build
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
[{"name":"run-webpack","duration":
|
|
1
|
+
[{"name":"run-webpack","duration":32242823,"timestamp":205465434,"id":14,"parentId":1,"tags":{},"startTime":1789904772716,"traceId":"d2e3398af39774d1"},{"name":"run-typescript","duration":13556892,"timestamp":237712073,"id":8491,"parentId":1,"tags":{},"startTime":1789904804962,"traceId":"d2e3398af39774d1"},{"name":"static-check","duration":2458517,"timestamp":251283669,"id":8494,"parentId":1,"tags":{},"startTime":1789904818534,"traceId":"d2e3398af39774d1"},{"name":"static-generation","duration":5633017,"timestamp":254055350,"id":8624,"parentId":1,"tags":{},"startTime":1789904821306,"traceId":"d2e3398af39774d1"},{"name":"collect-build-traces","duration":40345027,"timestamp":253745159,"id":8621,"parentId":1,"tags":{},"startTime":1789904820995,"traceId":"d2e3398af39774d1"},{"name":"telemetry-flush","duration":63,"timestamp":294093626,"id":8633,"parentId":1,"tags":{},"startTime":1789904861344,"traceId":"d2e3398af39774d1"},{"name":"next-build","duration":88797634,"timestamp":205296068,"id":1,"tags":{"buildMode":"default","version":"16.3.5","bundler":"webpack","has-custom-webpack-config":"false","use-build-worker":"true"},"startTime":1789904772546,"traceId":"d2e3398af39774d1"}]
|
package/README.ja.md
CHANGED
|
@@ -1,134 +1,11 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @pricening/pi-web
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
This repository is a **personal fork** of [agegr/pi-web](https://github.com/agegr/pi-web).
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Please read:
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
- [README.md](./README.md) (English)
|
|
8
|
+
- [README.zh-CN.md](./README.zh-CN.md) (简体中文)
|
|
9
|
+
- Maintenance rules: [docs/FORK.md](./docs/FORK.md)
|
|
8
10
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
- **セッションワークスペース**:プロジェクトごとに会話を閲覧、再開、名前変更、エクスポート、削除し、実行状態、コンテキスト使用量、コスト、コンパクション情報を確認できます。
|
|
12
|
-
- **2 種類の分岐**:**New session** は以前のメッセージから独立したセッションファイルを作成し、**Edit from here** は現在のセッション内にブランチを作成します。
|
|
13
|
-
- **プロジェクトファイルツール**:ファイルの閲覧とアップロード、Git Diff の確認、ソース、Markdown、画像、音声、PDF、DOCX のプレビューに対応し、変更時は自動更新されます。
|
|
14
|
-
- **Git worktree**:同じリポジトリのセッションをまとめたまま、サイドバーからチェックアウトを切り替えられます。
|
|
15
|
-
- **Web での設定**:Pi Web を離れずに、Provider のログインと API Key、モデル、モデルテスト、プラグインパッケージ、スキルを管理できます。
|
|
16
|
-
- **英語、簡体字中国語、繁体字中国語の UI**:初回はブラウザーの言語に従い、トップバーから言語を切り替えられます。
|
|
17
|
-
|
|
18
|
-
## クイックスタート
|
|
19
|
-
|
|
20
|
-
Pi Web には Node.js 22.19.0 以降が必要です。`node --version` でバージョンを確認してから、次を実行します:
|
|
21
|
-
|
|
22
|
-
```bash
|
|
23
|
-
npx @agegr/pi-web@latest
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
サーバーの準備が整うと、CLI はブラウザーを自動的に開こうとします。開かない場合は [http://127.0.0.1:30141](http://127.0.0.1:30141) にアクセスしてください。Pi Web はデフォルトで `127.0.0.1` のみをリッスンします。
|
|
27
|
-
|
|
28
|
-
モデル Provider が未設定の場合は、**Models** パネルを開いてログインするか API Key を追加してください。
|
|
29
|
-
|
|
30
|
-
`pi-web` コマンドをグローバルにインストールする場合:
|
|
31
|
-
|
|
32
|
-
```bash
|
|
33
|
-
npm install -g @agegr/pi-web@latest
|
|
34
|
-
pi-web
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
更新時は、実行中のプロセスを `Ctrl+C` で停止してから同じインストールコマンドを再実行します。アンインストールするには `npm uninstall -g @agegr/pi-web` を実行します。
|
|
38
|
-
|
|
39
|
-
## 設定
|
|
40
|
-
|
|
41
|
-
ポートとホスト名では、コマンドラインオプションが対応する環境変数より優先されます。`--no-open` と `PI_WEB_NO_OPEN=1` は、どちらを指定してもブラウザーの自動起動が無効になります。`pi-web --help`(または `-h`)で起動オプションを表示して終了します。未知のオプションはエラーで終了します。
|
|
42
|
-
|
|
43
|
-
| オプションまたは環境変数 | 用途 | デフォルト |
|
|
44
|
-
| --- | --- | --- |
|
|
45
|
-
| `--help`、`-h` | 起動オプションを表示して終了 | — |
|
|
46
|
-
| `--port <port>`、`-p <port>`、または `PORT` | サーバーポート | `30141` |
|
|
47
|
-
| `--hostname <host>`、`-H <host>`、または `PI_WEB_HOSTNAME` | バインドするホスト名 | `127.0.0.1` |
|
|
48
|
-
| `--no-open` または `PI_WEB_NO_OPEN=1` | ブラウザーを自動的に開かない | 自動的に開く |
|
|
49
|
-
| `PI_WEB_ALLOWED_HOSTS` | 追加で許可するプロキシまたはカスタムホスト名。複数指定はカンマ区切りで完全一致 | 未設定 |
|
|
50
|
-
| `PI_WEB_PASSWORD` | ブラウザーのパスワードログインを有効化。API はユーザー名 `pi` の Basic Auth も利用可能 | 認証なし |
|
|
51
|
-
|
|
52
|
-
例:
|
|
53
|
-
|
|
54
|
-
```bash
|
|
55
|
-
pi-web --help
|
|
56
|
-
pi-web -p 8080 -H 0.0.0.0 --no-open
|
|
57
|
-
```
|
|
58
|
-
|
|
59
|
-
### リモートアクセス
|
|
60
|
-
|
|
61
|
-
ループバック以外のアドレスにバインドすると、高い権限の操作を実行できるエージェントがネットワークに公開されます。信頼できる LAN で使用する場合も、十分に長いランダムなパスワードを設定してください:
|
|
62
|
-
|
|
63
|
-
```bash
|
|
64
|
-
PI_WEB_PASSWORD='十分に長いランダムなパスワード' pi-web --hostname 0.0.0.0
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
パスワード認証は接続を暗号化しません。平文 HTTP で Pi Web をインターネットに公開せず、信頼できるリバースプロキシによる HTTPS または信頼できる VPN を使用してください。リバースプロキシが外部ホスト名を転送する場合は、その名前を完全一致で `PI_WEB_ALLOWED_HOSTS` に追加します。この許可リストは Pi Web のバインド先を変更しません。
|
|
68
|
-
|
|
69
|
-
### HTTP プロキシ
|
|
70
|
-
|
|
71
|
-
サーバー側のモデルリクエストと API リクエストは、標準の `HTTP_PROXY`、`HTTPS_PROXY`、`NO_PROXY` 環境変数を使用します。
|
|
72
|
-
|
|
73
|
-
macOS または Linux:
|
|
74
|
-
|
|
75
|
-
```bash
|
|
76
|
-
HTTP_PROXY=http://127.0.0.1:7890 \
|
|
77
|
-
HTTPS_PROXY=http://127.0.0.1:7890 \
|
|
78
|
-
NO_PROXY=localhost,127.0.0.1 \
|
|
79
|
-
npx @agegr/pi-web@latest
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
Windows PowerShell:
|
|
83
|
-
|
|
84
|
-
```powershell
|
|
85
|
-
$env:HTTP_PROXY = "http://127.0.0.1:7890"
|
|
86
|
-
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
|
|
87
|
-
$env:NO_PROXY = "localhost,127.0.0.1"
|
|
88
|
-
npx @agegr/pi-web@latest
|
|
89
|
-
```
|
|
90
|
-
|
|
91
|
-
## 注意事項
|
|
92
|
-
|
|
93
|
-
- **エージェントデータ**:Pi Web はデフォルトで `~/.pi/agent` の pi データを読み込みます。セッションファイルは `sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl` にあります。別の pi エージェントディレクトリを使用するには `PI_CODING_AGENT_DIR` を設定してください。
|
|
94
|
-
- **ファイルシステムへのアクセス**:Pi Web はエージェントデータディレクトリと、セッションに記録された作業ディレクトリを読み取れる必要があります。既存の pi セッションを共有する場合は、pi と同じファイルシステム環境で Pi Web を実行してください。
|
|
95
|
-
- **共有設定**:Models パネルは pi のモデル、設定、認証情報ストレージを使用するため、変更は両方のインターフェースに反映されます。
|
|
96
|
-
- **ファイルアクセスの範囲**:ファイルブラウザーは、Pi Web で選択した作業ディレクトリと、既知のプロジェクトまたはセッションルートに限定されます。汎用のファイルシステムブラウザーではありません。
|
|
97
|
-
- **Git worktree**:スイッチャーの表示条件、worktree の作成、削除時の動作については [Worktrees in Pi Web](./docs/worktrees.md) を参照してください。
|
|
98
|
-
|
|
99
|
-
## 開発
|
|
100
|
-
|
|
101
|
-
```bash
|
|
102
|
-
npm install
|
|
103
|
-
npm run dev
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
開発サーバーは [http://127.0.0.1:30141](http://127.0.0.1:30141) で動作します。一般的なチェックは次のコマンドで実行します:
|
|
107
|
-
|
|
108
|
-
```bash
|
|
109
|
-
npm test
|
|
110
|
-
node_modules/.bin/tsc --noEmit
|
|
111
|
-
npm run lint
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
通常の開発中は `next build` または `npm run build` を実行しないでください。`.next/` に書き込まれ、開発サーバーに影響する可能性があります。ビルドはリリース作業時にのみ実行してください。
|
|
115
|
-
|
|
116
|
-
コントリビューター向けガイド:[Internationalization](./docs/i18n.md) と [Release process](./docs/release.md)。
|
|
117
|
-
|
|
118
|
-
## リポジトリ構成
|
|
119
|
-
|
|
120
|
-
```text
|
|
121
|
-
app/ Next.js UI と API ルート
|
|
122
|
-
components/ React UI コンポーネント
|
|
123
|
-
hooks/ クライアントの状態と操作に関する hooks
|
|
124
|
-
lib/ セッション、エージェント、モデル、ファイル、Git、セキュリティのロジック
|
|
125
|
-
public/ 静的アセットと PWA ファイル
|
|
126
|
-
bin/ npm CLI エントリポイントと起動オプションの解析
|
|
127
|
-
docs/ ユーザーおよびコントリビューター向けの個別ガイド
|
|
128
|
-
```
|
|
129
|
-
|
|
130
|
-
アーキテクチャの説明と詳細なファイルマップについては [AGENTS.md](./AGENTS.md) を参照してください。
|
|
131
|
-
|
|
132
|
-
## ライセンス
|
|
133
|
-
|
|
134
|
-
[MIT](./LICENSE)
|
|
11
|
+
npm package: **`@pricening/pi-web`** (not `@agegr/pi-web`).
|
package/README.md
CHANGED
|
@@ -1,44 +1,59 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @pricening/pi-web
|
|
2
2
|
|
|
3
|
-
[
|
|
3
|
+
[简体中文](./README.zh-CN.md)
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
A **personal fork** of [agegr/pi-web](https://github.com/agegr/pi-web), the local browser UI for the [pi coding agent](https://github.com/earendil-works/pi).
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
## Why this fork exists
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
Upstream Pi Web is excellent and very active. This repository exists so I can add **advanced features I actually use** without waiting for (or expecting) them to land upstream — historically, session-organization PRs such as pin/favorite have been closed in favor of a planned redesign.
|
|
10
10
|
|
|
11
|
-
|
|
12
|
-
- **Two ways to branch**: **New session** creates an independent session file from an earlier message; **Edit from here** creates a branch inside the current session.
|
|
13
|
-
- **Project file tools**: browse and upload files, inspect Git diffs, and preview source, Markdown, images, audio, PDFs, and DOCX files with automatic refresh.
|
|
14
|
-
- **Git worktrees**: switch checkouts from the sidebar while keeping sessions from the same repository grouped together.
|
|
15
|
-
- **Web-based configuration**: manage provider login and API keys, models, model tests, plugin packages, and skills without leaving Pi Web.
|
|
16
|
-
- **English, Simplified Chinese, and Traditional Chinese UI**: Pi Web follows the browser language initially and provides a language switcher in the top bar.
|
|
11
|
+
The fork is meant to **keep following upstream**, not to replace it:
|
|
17
12
|
|
|
18
|
-
|
|
13
|
+
| | |
|
|
14
|
+
|---|---|
|
|
15
|
+
| Upstream | [agegr/pi-web](https://github.com/agegr/pi-web) — fetch only |
|
|
16
|
+
| This repo | [PriceNing/pi-web](https://github.com/PriceNing/pi-web) |
|
|
17
|
+
| npm package | **`@pricening/pi-web`** (not `@agegr/pi-web`) |
|
|
18
|
+
| Upstream baseline | `package.json` → `forkedFrom` |
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
Install the official package if you want an unmodified Pi Web. Install this package only if you want the extra features below.
|
|
21
21
|
|
|
22
|
-
|
|
23
|
-
npx @agegr/pi-web@latest
|
|
24
|
-
```
|
|
22
|
+
How we stay in sync, version, and publish: **[docs/FORK.md](./docs/FORK.md)** (the maintenance spec).
|
|
25
23
|
|
|
26
|
-
|
|
24
|
+
## Extra features (this fork)
|
|
27
25
|
|
|
28
|
-
|
|
26
|
+
- **Server-side pins** for projects and sessions. Pins live under `~/.pi/agent/pi-web/pins.json`, so every browser hitting the same server (PC / phone / tablet) sees the same order. Pinned items sort first; within a group they stay ordered by recent activity.
|
|
27
|
+
- **Project archive**. The sidebar “project” row is only a grouping of sessions, not a first-class pi object. Archive hides that group from the sidebar without moving session files. Manage / unarchive / bulk-delete those chats from **Settings → Archives**. Deleting sessions never deletes the code folder on disk.
|
|
28
|
+
|
|
29
|
+
Everything else is upstream Pi Web: same `~/.pi/agent` sharing with the local pi CLI, same session files, same models/auth/skills.
|
|
30
|
+
|
|
31
|
+
## Quick start
|
|
29
32
|
|
|
30
|
-
|
|
33
|
+
Requires Node.js 22.19.0 or newer (`node --version`).
|
|
31
34
|
|
|
32
35
|
```bash
|
|
33
|
-
npm install -g @
|
|
36
|
+
npm install -g @pricening/pi-web@latest --registry=https://registry.npmjs.org/
|
|
34
37
|
pi-web
|
|
35
38
|
```
|
|
36
39
|
|
|
37
|
-
|
|
40
|
+
Or without a global install:
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
npx @pricening/pi-web@latest --registry=https://registry.npmjs.org/
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
The CLI opens a browser when the server is ready. If it does not, open [http://127.0.0.1:30141](http://127.0.0.1:30141). By default Pi Web listens only on `127.0.0.1`.
|
|
47
|
+
|
|
48
|
+
If no model provider is configured yet, open the **Models** panel to sign in or add an API key.
|
|
49
|
+
|
|
50
|
+
To update, stop the running process (`Ctrl+C`) and install the same package again. To uninstall: `npm uninstall -g @pricening/pi-web`.
|
|
51
|
+
|
|
52
|
+
Production machines should pin an exact version (`PI_WEB_PIN` on Windows, or a systemd unit that does not run `npm update`). Do not blindly follow `@latest` on every box; see [docs/FORK.md §7](./docs/FORK.md).
|
|
38
53
|
|
|
39
54
|
## Configuration
|
|
40
55
|
|
|
41
|
-
|
|
56
|
+
Command-line options override the matching environment variables. `--no-open` or `PI_WEB_NO_OPEN=1` skips opening a browser. `pi-web --help` prints startup options and exits.
|
|
42
57
|
|
|
43
58
|
| Option or environment variable | Purpose | Default |
|
|
44
59
|
| --- | --- | --- |
|
|
@@ -47,104 +62,31 @@ For port and hostname, command-line options override the corresponding environme
|
|
|
47
62
|
| `--hostname <host>`, `-H <host>`, or `PI_WEB_HOSTNAME` | Bind hostname | `127.0.0.1` |
|
|
48
63
|
| `--no-open` or `PI_WEB_NO_OPEN=1` | Do not open a browser automatically | Browser opens |
|
|
49
64
|
| `PI_WEB_SKIP_VERSION_CHECK=1` | Disable Pi Web update checks | Unset |
|
|
50
|
-
| `PI_WEB_ALLOWED_HOSTS` |
|
|
51
|
-
| `PI_WEB_PASSWORD` |
|
|
52
|
-
| `PI_WEB_IDLE_TIMEOUT_MS` | Session idle timeout in
|
|
53
|
-
|
|
54
|
-
For example:
|
|
65
|
+
| `PI_WEB_ALLOWED_HOSTS` | Extra exact proxy/custom hostnames, comma-separated | Unset |
|
|
66
|
+
| `PI_WEB_PASSWORD` | Browser password login; API clients may use Basic Auth as user `pi` | Auth disabled |
|
|
67
|
+
| `PI_WEB_IDLE_TIMEOUT_MS` | Session idle timeout in ms; `0` disables idle shutdown | `600000` (10 min) |
|
|
55
68
|
|
|
56
69
|
```bash
|
|
57
70
|
pi-web --help
|
|
58
71
|
pi-web -p 8080 -H 0.0.0.0 --no-open
|
|
59
72
|
```
|
|
60
73
|
|
|
61
|
-
### Remote
|
|
74
|
+
### Remote access
|
|
62
75
|
|
|
63
|
-
Binding to a non-loopback address exposes an agent that can
|
|
76
|
+
Binding to a non-loopback address exposes an agent that can run high-privilege actions. On a trusted LAN, set a long random password:
|
|
64
77
|
|
|
65
78
|
```bash
|
|
66
79
|
PI_WEB_PASSWORD='a-long-random-password' pi-web --hostname 0.0.0.0
|
|
67
80
|
```
|
|
68
81
|
|
|
69
|
-
Password
|
|
70
|
-
|
|
71
|
-
### HTTP Proxy
|
|
72
|
-
|
|
73
|
-
Server-side model and API requests honor the standard `HTTP_PROXY`, `HTTPS_PROXY`, and `NO_PROXY` environment variables.
|
|
74
|
-
|
|
75
|
-
On macOS or Linux:
|
|
76
|
-
|
|
77
|
-
```bash
|
|
78
|
-
HTTP_PROXY=http://127.0.0.1:7890 \
|
|
79
|
-
HTTPS_PROXY=http://127.0.0.1:7890 \
|
|
80
|
-
NO_PROXY=localhost,127.0.0.1 \
|
|
81
|
-
npx @agegr/pi-web@latest
|
|
82
|
-
```
|
|
83
|
-
|
|
84
|
-
On Windows PowerShell:
|
|
85
|
-
|
|
86
|
-
```powershell
|
|
87
|
-
$env:HTTP_PROXY = "http://127.0.0.1:7890"
|
|
88
|
-
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
|
|
89
|
-
$env:NO_PROXY = "localhost,127.0.0.1"
|
|
90
|
-
npx @agegr/pi-web@latest
|
|
91
|
-
```
|
|
82
|
+
Password auth does not encrypt the connection. Do not put Pi Web on the public internet over plain HTTP.
|
|
92
83
|
|
|
93
84
|
## Notes
|
|
94
85
|
|
|
95
|
-
- **Agent data**:
|
|
96
|
-
- **
|
|
97
|
-
- **
|
|
98
|
-
- **
|
|
99
|
-
- **Git worktrees**: see [Worktrees in Pi Web](./docs/worktrees.md) for switcher visibility, worktree creation, and removal behavior.
|
|
100
|
-
|
|
101
|
-
### Downstream Session Context Menu
|
|
102
|
-
|
|
103
|
-
Electron wrappers and other downstream integrations can provide a session-row
|
|
104
|
-
context menu without patching `SessionSidebar`. Listen for the cancelable
|
|
105
|
-
`pi-web:session-row-contextmenu` browser event and call `preventDefault()`
|
|
106
|
-
synchronously when the integration will handle it:
|
|
107
|
-
|
|
108
|
-
```js
|
|
109
|
-
window.addEventListener("pi-web:session-row-contextmenu", (event) => {
|
|
110
|
-
event.preventDefault();
|
|
111
|
-
const { id, path, cwd, name, clientX, clientY, refresh } = event.detail;
|
|
112
|
-
|
|
113
|
-
void openSessionMenu({ id, path, cwd, name, clientX, clientY }).then((changed) => {
|
|
114
|
-
if (changed) refresh();
|
|
115
|
-
});
|
|
116
|
-
});
|
|
117
|
-
```
|
|
118
|
-
|
|
119
|
-
The detail object contains `id`, `path`, `cwd`, optional `name`, pointer
|
|
120
|
-
coordinates, and a `refresh()` callback for actions that change the session
|
|
121
|
-
list. If no listener cancels the extension event, Pi Web preserves the
|
|
122
|
-
browser's native context menu. This hook is browser-side and independent of
|
|
123
|
-
Pi agent extensions.
|
|
124
|
-
|
|
125
|
-
### Extension Session Liveness
|
|
126
|
-
|
|
127
|
-
Server-side Pi extensions with detached work can prevent automatic idle
|
|
128
|
-
session eviction through the versioned global registry:
|
|
129
|
-
|
|
130
|
-
```js
|
|
131
|
-
const liveness = globalThis[Symbol.for("@agegr/pi-web/session-liveness/v1")];
|
|
132
|
-
const release = liveness?.version === 1
|
|
133
|
-
? liveness.register({
|
|
134
|
-
name: "my-extension",
|
|
135
|
-
sessionId,
|
|
136
|
-
sessionFile: sessionFile || undefined,
|
|
137
|
-
isActive: () => detachedJobs.size > 0,
|
|
138
|
-
})
|
|
139
|
-
: () => {};
|
|
140
|
-
```
|
|
141
|
-
|
|
142
|
-
Register once per active extension session and call the returned idempotent
|
|
143
|
-
`release` function on session shutdown, replacement, or reload. `isActive`
|
|
144
|
-
must be synchronous, cheap, and scoped to the supplied exact session id or
|
|
145
|
-
file. Provider errors fail safe by preserving that session. This lease only
|
|
146
|
-
affects automatic idle eviction; explicit shutdown and Stop fallback cleanup
|
|
147
|
-
still take precedence.
|
|
86
|
+
- **Agent data**: reads `~/.pi/agent` by default (session files under `sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl`). Override with `PI_CODING_AGENT_DIR`.
|
|
87
|
+
- **Shared with local pi**: models, settings, and credentials are pi’s files. This fork only writes extra state under `~/.pi/agent/pi-web/` (`pins.json`, `archives.json`). It does not rewrite `settings.json` / `auth.json` / session jsonl content.
|
|
88
|
+
- **File access** is limited to known project/session roots; it is not a general filesystem browser.
|
|
89
|
+
- **Git worktrees**: [Worktrees in Pi Web](./docs/worktrees.md).
|
|
148
90
|
|
|
149
91
|
## Development
|
|
150
92
|
|
|
@@ -153,7 +95,7 @@ npm install
|
|
|
153
95
|
npm run dev
|
|
154
96
|
```
|
|
155
97
|
|
|
156
|
-
|
|
98
|
+
Dev server: [http://127.0.0.1:30141](http://127.0.0.1:30141). Checks:
|
|
157
99
|
|
|
158
100
|
```bash
|
|
159
101
|
npm test
|
|
@@ -161,24 +103,10 @@ node_modules/.bin/tsc --noEmit
|
|
|
161
103
|
npm run lint
|
|
162
104
|
```
|
|
163
105
|
|
|
164
|
-
Do not run `next build`
|
|
165
|
-
|
|
166
|
-
Contributor guides: [Internationalization](./docs/i18n.md) and [Release process](./docs/release.md).
|
|
167
|
-
|
|
168
|
-
## Repository Layout
|
|
169
|
-
|
|
170
|
-
```text
|
|
171
|
-
app/ Next.js UI and API routes
|
|
172
|
-
components/ React UI components
|
|
173
|
-
hooks/ Client state and interaction hooks
|
|
174
|
-
lib/ Session, agent, model, file, Git, and security logic
|
|
175
|
-
public/ Static assets and PWA files
|
|
176
|
-
bin/ npm CLI entrypoint and launch option parsing
|
|
177
|
-
docs/ Focused user and contributor guides
|
|
178
|
-
```
|
|
106
|
+
Do **not** run `next build` / `npm run build` during normal development — it pollutes `.next/` and can break `npm run dev`. Builds belong in CI.
|
|
179
107
|
|
|
180
|
-
|
|
108
|
+
Patch discipline, versioning, and upstream sync: [docs/FORK.md](./docs/FORK.md). Architecture map: [AGENTS.md](./AGENTS.md).
|
|
181
109
|
|
|
182
110
|
## License
|
|
183
111
|
|
|
184
|
-
[MIT](./LICENSE)
|
|
112
|
+
[MIT](./LICENSE), same as upstream.
|
package/README.ru.md
CHANGED
|
@@ -1,134 +1,11 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @pricening/pi-web
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
This repository is a **personal fork** of [agegr/pi-web](https://github.com/agegr/pi-web).
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Please read:
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
- [README.md](./README.md) (English)
|
|
8
|
+
- [README.zh-CN.md](./README.zh-CN.md) (简体中文)
|
|
9
|
+
- Maintenance rules: [docs/FORK.md](./docs/FORK.md)
|
|
8
10
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
- **Рабочее пространство сессий**: просмотр, продолжение, переименование, экспорт и удаление диалогов, сгруппированных по проектам, с отображением состояния выполнения, использования контекста, стоимости и сведений о сжатии.
|
|
12
|
-
- **Два способа создать ветку**: **New session** создаёт независимый файл сессии из более раннего сообщения, а **Edit from here** создаёт ветку внутри текущей сессии.
|
|
13
|
-
- **Инструменты для файлов проекта**: просмотр и загрузка файлов, проверка Git Diff, предпросмотр исходного кода, Markdown, изображений, аудио, PDF и DOCX с автоматическим обновлением.
|
|
14
|
-
- **Git worktree**: переключение рабочих деревьев в боковой панели с сохранением общей группы сессий одного репозитория.
|
|
15
|
-
- **Настройка через Web**: управление входом в Provider и API Key, моделями, тестами моделей, пакетами плагинов и навыками без выхода из Pi Web.
|
|
16
|
-
- **Интерфейс на английском, упрощённом и традиционном китайском**: при первом запуске Pi Web учитывает язык браузера, а затем язык можно переключить в верхней панели.
|
|
17
|
-
|
|
18
|
-
## Быстрый старт
|
|
19
|
-
|
|
20
|
-
Для работы Pi Web требуется Node.js 22.19.0 или новее. Проверьте версию командой `node --version`, затем выполните:
|
|
21
|
-
|
|
22
|
-
```bash
|
|
23
|
-
npx @agegr/pi-web@latest
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
Когда сервер будет готов, CLI попытается открыть браузер автоматически. Если этого не произошло, откройте [http://127.0.0.1:30141](http://127.0.0.1:30141). По умолчанию Pi Web прослушивает только `127.0.0.1`.
|
|
27
|
-
|
|
28
|
-
Если Provider модели ещё не настроен, откройте панель **Models**, войдите в учётную запись или добавьте API Key.
|
|
29
|
-
|
|
30
|
-
Чтобы установить команду `pi-web` глобально:
|
|
31
|
-
|
|
32
|
-
```bash
|
|
33
|
-
npm install -g @agegr/pi-web@latest
|
|
34
|
-
pi-web
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
Для обновления остановите запущенный процесс с помощью `Ctrl+C` и повторите ту же команду установки. Для удаления выполните `npm uninstall -g @agegr/pi-web`.
|
|
38
|
-
|
|
39
|
-
## Настройка
|
|
40
|
-
|
|
41
|
-
Для порта и имени хоста параметры командной строки имеют приоритет над соответствующими переменными окружения. И `--no-open`, и `PI_WEB_NO_OPEN=1` отключают автоматическое открытие браузера независимо друг от друга. `pi-web --help` (или `-h`) выводит параметры запуска и завершает работу без старта сервера. Неизвестные параметры завершают процесс с ошибкой.
|
|
42
|
-
|
|
43
|
-
| Параметр или переменная окружения | Назначение | Значение по умолчанию |
|
|
44
|
-
| --- | --- | --- |
|
|
45
|
-
| `--help`, `-h` | Показать параметры запуска и выйти | — |
|
|
46
|
-
| `--port <port>`, `-p <port>` или `PORT` | Порт сервера | `30141` |
|
|
47
|
-
| `--hostname <host>`, `-H <host>` или `PI_WEB_HOSTNAME` | Имя хоста для привязки | `127.0.0.1` |
|
|
48
|
-
| `--no-open` или `PI_WEB_NO_OPEN=1` | Не открывать браузер автоматически | Браузер открывается |
|
|
49
|
-
| `PI_WEB_ALLOWED_HOSTS` | Дополнительные точные имена прокси или пользовательских хостов через запятую | Не задано |
|
|
50
|
-
| `PI_WEB_PASSWORD` | Включить вход по паролю в браузере; API также поддерживает Basic Auth с именем `pi` | Аутентификация отключена |
|
|
51
|
-
|
|
52
|
-
Пример:
|
|
53
|
-
|
|
54
|
-
```bash
|
|
55
|
-
pi-web --help
|
|
56
|
-
pi-web -p 8080 -H 0.0.0.0 --no-open
|
|
57
|
-
```
|
|
58
|
-
|
|
59
|
-
### Удалённый доступ
|
|
60
|
-
|
|
61
|
-
Привязка к адресу, отличному от loopback, открывает сетевой доступ к агенту, способному выполнять операции с широкими полномочиями. Даже в доверенной локальной сети используйте длинный случайный пароль:
|
|
62
|
-
|
|
63
|
-
```bash
|
|
64
|
-
PI_WEB_PASSWORD='длинный-случайный-пароль' pi-web --hostname 0.0.0.0
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
Парольная аутентификация не шифрует соединение. Не публикуйте Pi Web в интернете по обычному HTTP; используйте HTTPS через доверенный обратный прокси или надёжное VPN-подключение. Если обратный прокси передаёт внешнее имя хоста, добавьте это точное имя в `PI_WEB_ALLOWED_HOSTS`. Этот список разрешённых имён не меняет адрес, к которому привязывается Pi Web.
|
|
68
|
-
|
|
69
|
-
### HTTP-прокси
|
|
70
|
-
|
|
71
|
-
Для серверных запросов к моделям и API используются стандартные переменные окружения `HTTP_PROXY`, `HTTPS_PROXY` и `NO_PROXY`.
|
|
72
|
-
|
|
73
|
-
В macOS и Linux:
|
|
74
|
-
|
|
75
|
-
```bash
|
|
76
|
-
HTTP_PROXY=http://127.0.0.1:7890 \
|
|
77
|
-
HTTPS_PROXY=http://127.0.0.1:7890 \
|
|
78
|
-
NO_PROXY=localhost,127.0.0.1 \
|
|
79
|
-
npx @agegr/pi-web@latest
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
В Windows PowerShell:
|
|
83
|
-
|
|
84
|
-
```powershell
|
|
85
|
-
$env:HTTP_PROXY = "http://127.0.0.1:7890"
|
|
86
|
-
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
|
|
87
|
-
$env:NO_PROXY = "localhost,127.0.0.1"
|
|
88
|
-
npx @agegr/pi-web@latest
|
|
89
|
-
```
|
|
90
|
-
|
|
91
|
-
## Примечания
|
|
92
|
-
|
|
93
|
-
- **Данные агента**: по умолчанию Pi Web читает данные pi из `~/.pi/agent`, включая файлы сессий в `sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl`. Чтобы использовать другой каталог агента pi, задайте `PI_CODING_AGENT_DIR`.
|
|
94
|
-
- **Доступ к файловой системе**: Pi Web должен иметь доступ для чтения к каталогу данных агента и рабочим каталогам, записанным в сессиях. При совместном использовании существующих сессий запускайте Pi Web в той же файловой среде, что и pi.
|
|
95
|
-
- **Общие настройки**: панель Models использует хранилища моделей, настроек и учётных данных pi, поэтому изменения видны в обоих интерфейсах.
|
|
96
|
-
- **Граница доступа к файлам**: файловый браузер ограничен рабочими каталогами, выбранными в Pi Web, и уже известными корнями проектов или сессий; это не универсальный файловый менеджер.
|
|
97
|
-
- **Git worktree**: условия отображения переключателя, создание рабочих деревьев и их удаление описаны в документе [Worktrees in Pi Web](./docs/worktrees.md).
|
|
98
|
-
|
|
99
|
-
## Разработка
|
|
100
|
-
|
|
101
|
-
```bash
|
|
102
|
-
npm install
|
|
103
|
-
npm run dev
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
Сервер разработки доступен по адресу [http://127.0.0.1:30141](http://127.0.0.1:30141). Основные проверки запускаются командами:
|
|
107
|
-
|
|
108
|
-
```bash
|
|
109
|
-
npm test
|
|
110
|
-
node_modules/.bin/tsc --noEmit
|
|
111
|
-
npm run lint
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
Не запускайте `next build` или `npm run build` во время обычной разработки. Эти команды записывают данные в `.next/` и могут помешать работе сервера разработки; выполняйте сборку только при подготовке релиза.
|
|
115
|
-
|
|
116
|
-
Руководства для участников: [Internationalization](./docs/i18n.md) и [Release process](./docs/release.md).
|
|
117
|
-
|
|
118
|
-
## Структура репозитория
|
|
119
|
-
|
|
120
|
-
```text
|
|
121
|
-
app/ UI Next.js и маршруты API
|
|
122
|
-
components/ Компоненты интерфейса React
|
|
123
|
-
hooks/ Состояние клиента и обработчики взаимодействий
|
|
124
|
-
lib/ Логика сессий, агента, моделей, файлов, Git и безопасности
|
|
125
|
-
public/ Статические ресурсы и файлы PWA
|
|
126
|
-
bin/ Точка входа npm CLI и разбор параметров запуска
|
|
127
|
-
docs/ Тематические руководства для пользователей и участников
|
|
128
|
-
```
|
|
129
|
-
|
|
130
|
-
Описание архитектуры и подробная карта файлов приведены в [AGENTS.md](./AGENTS.md).
|
|
131
|
-
|
|
132
|
-
## Лицензия
|
|
133
|
-
|
|
134
|
-
[MIT](./LICENSE)
|
|
11
|
+
npm package: **`@pricening/pi-web`** (not `@agegr/pi-web`).
|