@oversk7/pi-web-dsh-style 1.1.1 → 1.1.2
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/README.md +37 -125
- package/docs/guide.md +152 -0
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -1,156 +1,68 @@
|
|
|
1
|
-
|
|
1
|
+
<div align="center">
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
# Pi Web
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
**Your agent. Your workspace. Any screen.**
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
为 [Pi Coding Agent](https://pi.dev) 打开一个浏览器窗口。
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
[](https://www.npmjs.com/package/@oversk7/pi-web-dsh-style)
|
|
10
|
+
[](#quick-start)
|
|
11
|
+
[](LICENSE)
|
|
10
12
|
|
|
11
|
-
|
|
13
|
+
[快速开始](#quick-start) · [使用指南](https://github.com/oversk7/pi-web-dsh-style/blob/main/docs/guide.md) · [Pi 扩展目录](https://pi.dev/packages/@oversk7/pi-web-dsh-style) · [反馈与建议](https://github.com/oversk7/pi-web-dsh-style/issues)
|
|
12
14
|
|
|
13
|
-
|
|
14
|
-
pi install npm:@oversk7/pi-web-dsh-style
|
|
15
|
-
```
|
|
15
|
+
</div>
|
|
16
16
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
```powershell
|
|
20
|
-
pi install C:\path\to\pi-web
|
|
21
|
-
```
|
|
17
|
+
---
|
|
22
18
|
|
|
23
|
-
|
|
19
|
+
灵感来自 DeepSeek Harness 的界面，熟悉的 Pi 工作流。
|
|
20
|
+
在桌面展开工作区，在手机接着看进度。模型、工具和会话仍运行在自己的电脑上。
|
|
24
21
|
|
|
25
|
-
##
|
|
22
|
+
## Highlights
|
|
26
23
|
|
|
27
|
-
|
|
24
|
+
- **并行工作** — 多工作区、多会话，随时切换正在进行的任务。
|
|
25
|
+
- **保留上下文** — 浏览会话分支，回到之前的检查点，继续探索。
|
|
26
|
+
- **看清过程** — 流式回答、工具调用、思考过程和文件预览。
|
|
27
|
+
- **随处接入** — 桌面与手机，共用同一套会话；支持局域网和自托管中转。
|
|
28
|
+
- **延续习惯** — 模型切换、斜杠命令、扩展与技能，融入浏览器界面。
|
|
29
|
+
- **自己的风格** — 明暗主题、配色与自定义背景。
|
|
28
30
|
|
|
29
|
-
|
|
30
|
-
pi --web
|
|
31
|
-
```
|
|
31
|
+
## Quick start
|
|
32
32
|
|
|
33
|
-
|
|
33
|
+
需要 **Windows 10/11**、**Node.js ≥ 22.19** 和 **Pi ≥ 0.85.0**。
|
|
34
34
|
|
|
35
|
-
```
|
|
36
|
-
/web
|
|
37
|
-
/web --no-open
|
|
38
|
-
/web --port 18789
|
|
39
|
-
/web --lan
|
|
40
|
-
/web --relay
|
|
41
|
-
/web --local
|
|
42
|
-
/web --stop
|
|
35
|
+
```powershell
|
|
36
|
+
pi install npm:@oversk7/pi-web-dsh-style
|
|
43
37
|
```
|
|
44
38
|
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
输入 `/` 可查看当前可用命令。Web 内置命令包括 `/settings`、`/model`、`/thinking`、`/export`、`/copy`、`/name`、`/session`、`/new`、`/resume`、`/rewind`、`/tree`、`/compact` 和 `/reload`。
|
|
48
|
-
|
|
49
|
-
- `/model provider/model` 精确匹配时切换模型；未唯一匹配时打开带搜索词的模型选择器。`/thinking high` 切换当前模型支持的思考强度，两者不带参数时打开选择器。
|
|
50
|
-
- `/compact 压缩要求` 会将要求传给 Pi；`/name 名称` 修改会话名称，不带参数时显示当前名称。
|
|
51
|
-
- `/resume` 打开侧栏会话搜索；`/export` 下载 HTML 到浏览器下载目录，暂不接受导出路径或 JSONL 格式参数。
|
|
52
|
-
- 网页会话中的 `/reload` 只重载当前会话的扩展与配置。要重载整个 Web 服务，请使用设置中的“重新加载”或在宿主 Pi 终端执行 `/reload`。
|
|
53
|
-
|
|
54
|
-
扩展命令、提示词模板和 `/skill:名称` 由当前会话的 Pi RPC 进程执行。未知命令会报错并保留草稿，不会作为普通消息发送给模型；普通消息需要避免以 `/` 开头。
|
|
55
|
-
|
|
56
|
-
`/scoped-models`、`/import`、`/share`、`/fork`、`/clone`、`/trust`、`/changelog`、`/hotkeys`、`/login`、`/logout` 和 `/quit` 尚未提供对应的 Web 操作，输入时会显示说明。需要这些 Pi 功能时请使用终端。
|
|
57
|
-
|
|
58
|
-
### 手机通过局域网访问
|
|
59
|
-
|
|
60
|
-
电脑和手机连接同一 Wi-Fi，在电脑本机网页“设置 → 手机访问”中选择“局域网”并保存。也可以执行 `/web --lan`，或直接以 `pi --web-lan` 启动。首次使用时，在同一设置中设置固定密码；之后手机打开显示的地址，输入该密码即可登录。界面只显示一个手机访问地址，优先使用 Wi-Fi，并过滤 WSL、Hyper-V 等虚拟网卡。
|
|
61
|
-
|
|
62
|
-
手机登录状态保留 30 天。密码在服务重启后继续有效，可在电脑本机网页中修改；修改密码后，已登录的手机需要重新登录。
|
|
63
|
-
|
|
64
|
-
手机与电脑共用工作区和会话，可各自切换、发送消息、停止生成及回答扩展提问。手机上点击左上角按钮展开会话列表；输入框回车换行，点击发送按钮提交；图片按钮选择手机图片。手机切回前台或网络重连时会刷新会话内容。
|
|
65
|
-
|
|
66
|
-
设置面板及 `/web --lan`、`/web --relay`、`/web --local` 会保存模式并切换正在运行的服务，保留后台会话进程。切换时浏览器实时连接会重新连接。执行 `/reload` 会保留端口和访问模式；重载或重启服务会保留密码和未过期的登录状态。
|
|
67
|
-
|
|
68
|
-
首次开启时，如 Windows 弹出防火墙提示，请允许 Node.js 在当前可信网络上接收连接。若手机仍无法打开，检查防火墙是否允许该端口，以及 Wi-Fi 是否启用了客户端隔离。电脑需要保持运行且未休眠。
|
|
69
|
-
|
|
70
|
-
局域网直连使用 HTTP，请只在可信局域网内使用。
|
|
71
|
-
|
|
72
|
-
### 通过服务器中转
|
|
39
|
+
重启 Pi，然后启动：
|
|
73
40
|
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
1. 从 [frp 官方 Releases](https://github.com/fatedier/frp/releases) 下载电脑对应架构的 Windows 版本，将 `frpc.exe` 解压到固定位置。客户端和服务器建议使用相同版本（已验证 0.70.1）。
|
|
77
|
-
2. 在电脑网页“设置 → 手机访问”选择“服务器中转”，填写服务器域名或 IPv4、frps 端口（默认 `7000`）、frps 认证密钥、手机 HTTPS 入口（如 `https://web.example.com`），以及 `frpc.exe` 路径。路径留空时从 PATH 查找 `frpc`；相对路径以状态目录为基准。认证密钥留空会保留已保存的值。
|
|
78
|
-
3. 保存后，下载设置中生成的 `frps.toml`、`visitor.toml` 和 `nginx.conf`。隧道名称和私有密钥自动生成；隧道名称及服务器内部端口可在高级配置中调整。将域名 DNS 指向服务器，并为该域名准备有效的 HTTPS 证书。
|
|
79
|
-
4. 服务器安装原生 frp 和 Nginx。新服务器使用 `frps -c frps.toml`，访问端使用 `frpc -c visitor.toml`，并用 systemd 等服务管理器保持运行。已有 frps 时复用现有端口和认证密钥，保留其配置。把生成的 Nginx 配置中的证书路径替换成实际证书路径，再安装到 Nginx 的站点配置目录，执行 `nginx -t` 验证并重载。
|
|
80
|
-
|
|
81
|
-
手机打开显示的 HTTPS 地址，输入原有固定密码即可使用。设置会显示 frpc 的连接或错误状态；服务器暂时不可达时 frpc 自动重连，本机网页仍可使用。后续执行 `pi --web` 会自动恢复保存的中转模式；也可以用 `pi --web-relay` 或 `/web --relay` 明确启用已配置的中转。
|
|
82
|
-
|
|
83
|
-
服务器需开放 HTTPS 端口和 frps 控制端口；生成的 STCP 访问端仅监听服务器 `127.0.0.1`，无须开放其内部端口。Nginx 配置保留域名 Host、附加代理密钥、限制登录请求速率，并关闭缓冲以支持实时消息。公网访问由扩展直接验证来源和固定密码，登录 Cookie 带有 `Secure` 标记。中转模式下，电脑 Web 服务仅监听本机回环地址。
|
|
84
|
-
|
|
85
|
-
网络配置和服务器配置下载仅对电脑本机网页开放。更换服务器域名、隧道名称、认证密钥或服务器内部端口后，需要同步部署重新下载的服务器配置。电脑上的 Pi Web 需要保持运行且未休眠。
|
|
86
|
-
|
|
87
|
-
## 功能
|
|
88
|
-
|
|
89
|
-
- 多工作区、多会话和后台会话并行运行。
|
|
90
|
-
- 按需启动 Pi RPC 进程，最多保留一个空闲进程。
|
|
91
|
-
- Windows 会话使用 Job Object 托管进程树：停止 Web 或宿主退出时，清理 RPC 及其启动的后台服务、子进程和孙进程。
|
|
92
|
-
- 模型、思考等级、中断、压缩和扩展交互对话框。
|
|
93
|
-
- 运行中逐条显示待处理消息，可单条撤回并重新编辑；`Alt+Q` 可将全部队列消息恢复到输入框。
|
|
94
|
-
- 会话历史保留完整分支与检查点，支持回溯后返回切换前的位置，以及 `pi-rewind` 文件恢复。
|
|
95
|
-
- Windows 系统剪贴板图片和文本粘贴；手机支持选择或粘贴本机图片。
|
|
96
|
-
- 会话中的本地文件链接可在右侧分栏预览，支持语法高亮、行定位和拖拽调整宽度。
|
|
97
|
-
- 设置面板内更新扩展并热重载 Pi 运行时，无需退出 Web UI。
|
|
98
|
-
- 会话 HTML 导出。
|
|
99
|
-
|
|
100
|
-
## 进程生命周期
|
|
101
|
-
|
|
102
|
-
`/web --stop`、宿主 Pi 退出或运行时重载会关闭扩展托管的 frpc 和 Web 会话进程及其后代，包括 detached 后台进程；即使宿主被强制结束，Windows 托管进程也会检测到宿主退出并清理整棵进程树。不会扫描或结束工作区外独立启动的进程，也不会结束其他 Pi 实例。
|
|
103
|
-
|
|
104
|
-
单个 RPC 进程退出、异常终止或被空闲进程回收时，它启动的后台进程也会一起结束。需要独立于会话长期运行的服务，应从 Web 会话之外的终端启动。通过系统服务管理器、计划任务等外部机制启动的进程不属于此进程树。
|
|
105
|
-
|
|
106
|
-
只关闭浏览器标签页不会停止 Web 服务或后台会话；要结束它们，请执行 `/web --stop` 或退出宿主 Pi。进程托管依赖 Windows 10/11 自带的 Windows PowerShell 和 Win32 Job Object；如果无法建立托管，RPC 启动会失败，不会回退为无托管进程。
|
|
107
|
-
|
|
108
|
-
## 数据与升级
|
|
109
|
-
|
|
110
|
-
运行状态保存在：
|
|
111
|
-
|
|
112
|
-
```text
|
|
113
|
-
~/.pi/agent/pi-web/state.json
|
|
41
|
+
```powershell
|
|
42
|
+
pi --web
|
|
114
43
|
```
|
|
115
44
|
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
访问模式及中转配置保存在同一目录的 `network.json` 中。中转所需的 frps 认证密钥、STCP 私有密钥和代理密钥保存在此文件；普通设置响应不返回这些密钥，服务器配置下载会包含部署所需的密钥。配置文件不属于发布包。运行时的 frpc 配置写入状态目录下的 `runtime/`，正常停止时清理。
|
|
119
|
-
|
|
120
|
-
从旧版目录安装首次升级时，如果新位置尚无状态文件，扩展会从扩展目录中的旧 `state.json` 原样复制并继续使用。旧文件不会被删除或改写，可作为迁移备份。
|
|
45
|
+
也可以在已有 Pi 终端中输入 `/web`。
|
|
121
46
|
|
|
122
|
-
|
|
47
|
+
手机访问从 **设置 → 手机访问** 开始。更多配置见[使用指南](https://github.com/oversk7/pi-web-dsh-style/blob/main/docs/guide.md)。
|
|
123
48
|
|
|
124
|
-
|
|
125
|
-
- `PI_WEB_STATE_FILE`：覆盖状态文件。
|
|
126
|
-
- `PI_WEB_LEGACY_STATE_FILE`：指定迁移来源。
|
|
127
|
-
- `PI_WEB_RPC_ENTRY`：覆盖 Pi 的公开 RPC 入口文件。
|
|
128
|
-
- `PI_WEB_PI_CLI`：兼容旧版的 Pi CLI 路径覆盖。
|
|
129
|
-
- `PI_WEB_POWERSHELL`：覆盖用于剪贴板读取的 `powershell.exe`。
|
|
49
|
+
## Contributing
|
|
130
50
|
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
## 开发验证
|
|
51
|
+
欢迎 Issue 和 PR。Bug、想法、使用体验，都可以从[这里](https://github.com/oversk7/pi-web-dsh-style/issues)开始。
|
|
134
52
|
|
|
135
53
|
```powershell
|
|
54
|
+
git clone https://github.com/oversk7/pi-web-dsh-style.git
|
|
55
|
+
cd pi-web-dsh-style
|
|
136
56
|
npm install
|
|
137
57
|
npm run verify
|
|
138
|
-
npm pack --dry-run
|
|
139
|
-
```
|
|
140
|
-
|
|
141
|
-
发布正式版：
|
|
142
|
-
|
|
143
|
-
```powershell
|
|
144
|
-
npm login --registry=https://registry.npmjs.org
|
|
145
|
-
npm publish --access public --tag latest
|
|
146
58
|
```
|
|
147
59
|
|
|
148
|
-
##
|
|
60
|
+
## Credits
|
|
149
61
|
|
|
150
|
-
|
|
62
|
+
Built on [Pi](https://pi.dev). Inspired by [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness).
|
|
151
63
|
|
|
152
|
-
|
|
64
|
+
这是一个社区扩展，与 Pi 和 DeepSeek 官方无隶属关系。
|
|
153
65
|
|
|
154
|
-
|
|
66
|
+
另一个小工具：[pi-pwsh-notify](https://github.com/oversk7/pi-pwsh-notify) — 为 Pi 带来 PowerShell 7 与后台任务通知。
|
|
155
67
|
|
|
156
|
-
|
|
68
|
+
[MIT](LICENSE) · [Third-party notices](THIRD_PARTY_NOTICES.md)
|
package/docs/guide.md
ADDED
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
# 使用指南
|
|
2
|
+
|
|
3
|
+
[← 返回项目首页](../README.md)
|
|
4
|
+
|
|
5
|
+
## 安装
|
|
6
|
+
|
|
7
|
+
需要 Node.js 22.19 或更高版本，以及 Pi Coding Agent 0.85.0 或更高版本。
|
|
8
|
+
|
|
9
|
+
```powershell
|
|
10
|
+
pi install npm:@oversk7/pi-web-dsh-style
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
也可以从源码目录安装：
|
|
14
|
+
|
|
15
|
+
```powershell
|
|
16
|
+
pi install C:\path\to\pi-web
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
安装后重启 Pi，或执行 `/reload`。
|
|
20
|
+
|
|
21
|
+
## 使用
|
|
22
|
+
|
|
23
|
+
直接启动：
|
|
24
|
+
|
|
25
|
+
```powershell
|
|
26
|
+
pi --web
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
也可以在 Pi 终端中执行：
|
|
30
|
+
|
|
31
|
+
```text
|
|
32
|
+
/web
|
|
33
|
+
/web --no-open
|
|
34
|
+
/web --port 18789
|
|
35
|
+
/web --lan
|
|
36
|
+
/web --relay
|
|
37
|
+
/web --local
|
|
38
|
+
/web --stop
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
### 网页会话中的斜杠命令
|
|
42
|
+
|
|
43
|
+
输入 `/` 可查看当前可用命令。Web 内置命令包括 `/settings`、`/model`、`/thinking`、`/export`、`/copy`、`/name`、`/session`、`/new`、`/resume`、`/rewind`、`/tree`、`/compact` 和 `/reload`。
|
|
44
|
+
|
|
45
|
+
- `/model provider/model` 精确匹配时切换模型；未唯一匹配时打开带搜索词的模型选择器。`/thinking high` 切换当前模型支持的思考强度，两者不带参数时打开选择器。
|
|
46
|
+
- `/compact 压缩要求` 会将要求传给 Pi；`/name 名称` 修改会话名称，不带参数时显示当前名称。
|
|
47
|
+
- `/resume` 打开侧栏会话搜索；`/export` 下载 HTML 到浏览器下载目录，暂不接受导出路径或 JSONL 格式参数。
|
|
48
|
+
- 网页会话中的 `/reload` 只重载当前会话的扩展与配置。要重载整个 Web 服务，请使用设置中的“重新加载”或在宿主 Pi 终端执行 `/reload`。
|
|
49
|
+
|
|
50
|
+
扩展命令、提示词模板和 `/skill:名称` 由当前会话的 Pi RPC 进程执行。未知命令会报错并保留草稿，不会作为普通消息发送给模型；普通消息需要避免以 `/` 开头。
|
|
51
|
+
|
|
52
|
+
`/scoped-models`、`/import`、`/share`、`/fork`、`/clone`、`/trust`、`/changelog`、`/hotkeys`、`/login`、`/logout` 和 `/quit` 尚未提供对应的 Web 操作，输入时会显示说明。需要这些 Pi 功能时请使用终端。
|
|
53
|
+
|
|
54
|
+
### 手机通过局域网访问
|
|
55
|
+
|
|
56
|
+
电脑和手机连接同一 Wi-Fi，在电脑本机网页“设置 → 手机访问”中选择“局域网”并保存。也可以执行 `/web --lan`，或直接以 `pi --web-lan` 启动。首次使用时，在同一设置中设置固定密码；之后手机打开显示的地址，输入该密码即可登录。界面只显示一个手机访问地址，优先使用 Wi-Fi，并过滤 WSL、Hyper-V 等虚拟网卡。
|
|
57
|
+
|
|
58
|
+
手机登录状态保留 30 天。密码在服务重启后继续有效，可在电脑本机网页中修改；修改密码后，已登录的手机需要重新登录。
|
|
59
|
+
|
|
60
|
+
手机与电脑共用工作区和会话，可各自切换、发送消息、停止生成及回答扩展提问。手机上点击左上角按钮展开会话列表；输入框回车换行，点击发送按钮提交；图片按钮选择手机图片。手机切回前台或网络重连时会刷新会话内容。
|
|
61
|
+
|
|
62
|
+
设置面板及 `/web --lan`、`/web --relay`、`/web --local` 会保存模式并切换正在运行的服务，保留后台会话进程。切换时浏览器实时连接会重新连接。执行 `/reload` 会保留端口和访问模式；重载或重启服务会保留密码和未过期的登录状态。
|
|
63
|
+
|
|
64
|
+
首次开启时，如 Windows 弹出防火墙提示，请允许 Node.js 在当前可信网络上接收连接。若手机仍无法打开，检查防火墙是否允许该端口，以及 Wi-Fi 是否启用了客户端隔离。电脑需要保持运行且未休眠。
|
|
65
|
+
|
|
66
|
+
局域网直连使用 HTTP，请只在可信局域网内使用。
|
|
67
|
+
|
|
68
|
+
### 通过服务器中转
|
|
69
|
+
|
|
70
|
+
电脑运行扩展和原生 `frpc`，服务器运行 `frps`、作为 STCP 访问端的 `frpc` 以及 Nginx。手机通过服务器的 HTTPS 域名访问，适用于校园网客户端隔离等无法直连的网络。电脑上的 `frpc` 由扩展启动和关闭，中转请求直接进入扩展的 Web 服务。
|
|
71
|
+
|
|
72
|
+
1. 从 [frp 官方 Releases](https://github.com/fatedier/frp/releases) 下载电脑对应架构的 Windows 版本，将 `frpc.exe` 解压到固定位置。客户端和服务器建议使用相同版本（已验证 0.70.1）。
|
|
73
|
+
2. 在电脑网页“设置 → 手机访问”选择“服务器中转”，填写服务器域名或 IPv4、frps 端口（默认 `7000`）、frps 认证密钥、手机 HTTPS 入口（如 `https://web.example.com`），以及 `frpc.exe` 路径。路径留空时从 PATH 查找 `frpc`；相对路径以状态目录为基准。认证密钥留空会保留已保存的值。
|
|
74
|
+
3. 保存后，下载设置中生成的 `frps.toml`、`visitor.toml` 和 `nginx.conf`。隧道名称和私有密钥自动生成；隧道名称及服务器内部端口可在高级配置中调整。将域名 DNS 指向服务器，并为该域名准备有效的 HTTPS 证书。
|
|
75
|
+
4. 服务器安装原生 frp 和 Nginx。新服务器使用 `frps -c frps.toml`，访问端使用 `frpc -c visitor.toml`，并用 systemd 等服务管理器保持运行。已有 frps 时复用现有端口和认证密钥，保留其配置。把生成的 Nginx 配置中的证书路径替换成实际证书路径，再安装到 Nginx 的站点配置目录，执行 `nginx -t` 验证并重载。
|
|
76
|
+
|
|
77
|
+
手机打开显示的 HTTPS 地址，输入原有固定密码即可使用。设置会显示 frpc 的连接或错误状态；服务器暂时不可达时 frpc 自动重连，本机网页仍可使用。后续执行 `pi --web` 会自动恢复保存的中转模式；也可以用 `pi --web-relay` 或 `/web --relay` 明确启用已配置的中转。
|
|
78
|
+
|
|
79
|
+
服务器需开放 HTTPS 端口和 frps 控制端口；生成的 STCP 访问端仅监听服务器 `127.0.0.1`，无须开放其内部端口。Nginx 配置保留域名 Host、附加代理密钥、限制登录请求速率，并关闭缓冲以支持实时消息。公网访问由扩展直接验证来源和固定密码，登录 Cookie 带有 `Secure` 标记。中转模式下，电脑 Web 服务仅监听本机回环地址。
|
|
80
|
+
|
|
81
|
+
网络配置和服务器配置下载仅对电脑本机网页开放。更换服务器域名、隧道名称、认证密钥或服务器内部端口后，需要同步部署重新下载的服务器配置。电脑上的 Pi Web 需要保持运行且未休眠。
|
|
82
|
+
|
|
83
|
+
## 功能
|
|
84
|
+
|
|
85
|
+
- 多工作区、多会话和后台会话并行运行。
|
|
86
|
+
- 按需启动 Pi RPC 进程，最多保留一个空闲进程。
|
|
87
|
+
- Windows 会话使用 Job Object 托管进程树：停止 Web 或宿主退出时，清理 RPC 及其启动的后台服务、子进程和孙进程。
|
|
88
|
+
- 模型、思考等级、中断、压缩和扩展交互对话框。
|
|
89
|
+
- 运行中逐条显示待处理消息，可单条撤回并重新编辑；`Alt+Q` 可将全部队列消息恢复到输入框。
|
|
90
|
+
- 会话历史保留完整分支与检查点，支持回溯后返回切换前的位置，以及 `pi-rewind` 文件恢复。
|
|
91
|
+
- Windows 系统剪贴板图片和文本粘贴；手机支持选择或粘贴本机图片。
|
|
92
|
+
- 会话中的本地文件链接可在右侧分栏预览，支持语法高亮、行定位和拖拽调整宽度。
|
|
93
|
+
- 设置面板内更新扩展并热重载 Pi 运行时，无需退出 Web UI。
|
|
94
|
+
- 会话 HTML 导出。
|
|
95
|
+
|
|
96
|
+
## 进程生命周期
|
|
97
|
+
|
|
98
|
+
`/web --stop`、宿主 Pi 退出或运行时重载会关闭扩展托管的 frpc 和 Web 会话进程及其后代，包括 detached 后台进程；即使宿主被强制结束，Windows 托管进程也会检测到宿主退出并清理整棵进程树。不会扫描或结束工作区外独立启动的进程，也不会结束其他 Pi 实例。
|
|
99
|
+
|
|
100
|
+
单个 RPC 进程退出、异常终止或被空闲进程回收时，它启动的后台进程也会一起结束。需要独立于会话长期运行的服务，应从 Web 会话之外的终端启动。通过系统服务管理器、计划任务等外部机制启动的进程不属于此进程树。
|
|
101
|
+
|
|
102
|
+
只关闭浏览器标签页不会停止 Web 服务或后台会话；要结束它们，请执行 `/web --stop` 或退出宿主 Pi。进程托管依赖 Windows 10/11 自带的 Windows PowerShell 和 Win32 Job Object；如果无法建立托管，RPC 启动会失败，不会回退为无托管进程。
|
|
103
|
+
|
|
104
|
+
## 数据与升级
|
|
105
|
+
|
|
106
|
+
运行状态保存在：
|
|
107
|
+
|
|
108
|
+
```text
|
|
109
|
+
~/.pi/agent/pi-web/state.json
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
访问密码的加盐哈希和登录签名密钥保存在同一目录的 `auth.json` 中，不保存明文密码。
|
|
113
|
+
|
|
114
|
+
访问模式及中转配置保存在同一目录的 `network.json` 中。中转所需的 frps 认证密钥、STCP 私有密钥和代理密钥保存在此文件；普通设置响应不返回这些密钥，服务器配置下载会包含部署所需的密钥。配置文件不属于发布包。运行时的 frpc 配置写入状态目录下的 `runtime/`，正常停止时清理。
|
|
115
|
+
|
|
116
|
+
从旧版目录安装首次升级时，如果新位置尚无状态文件，扩展会从扩展目录中的旧 `state.json` 原样复制并继续使用。旧文件不会被删除或改写，可作为迁移备份。
|
|
117
|
+
|
|
118
|
+
可用环境变量：
|
|
119
|
+
|
|
120
|
+
- `PI_WEB_STATE_DIR`：覆盖状态目录。
|
|
121
|
+
- `PI_WEB_STATE_FILE`：覆盖状态文件。
|
|
122
|
+
- `PI_WEB_LEGACY_STATE_FILE`：指定迁移来源。
|
|
123
|
+
- `PI_WEB_RPC_ENTRY`：覆盖 Pi 的公开 RPC 入口文件。
|
|
124
|
+
- `PI_WEB_PI_CLI`：兼容旧版的 Pi CLI 路径覆盖。
|
|
125
|
+
- `PI_WEB_POWERSHELL`：覆盖用于剪贴板读取的 `powershell.exe`。
|
|
126
|
+
|
|
127
|
+
截图会临时写入系统临时目录，并在 24 小时后或服务停止时清理。Pi 会话内容仍由 Pi 自身保存在其会话目录中。
|
|
128
|
+
|
|
129
|
+
## 开发验证
|
|
130
|
+
|
|
131
|
+
```powershell
|
|
132
|
+
npm install
|
|
133
|
+
npm run verify
|
|
134
|
+
npm pack --dry-run
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
发布正式版：
|
|
138
|
+
|
|
139
|
+
```powershell
|
|
140
|
+
npm login --registry=https://registry.npmjs.org
|
|
141
|
+
npm publish --access public --tag latest
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
## 反馈与相关扩展
|
|
145
|
+
|
|
146
|
+
欢迎通过 [GitHub Issues](https://github.com/oversk7/pi-web-dsh-style/issues) 反馈问题、提出建议，或分享使用场景。报告问题时，请附上扩展版本、Pi 版本、Windows 版本和复现步骤；涉及手机访问时，请说明使用的是局域网还是服务器中转。
|
|
147
|
+
|
|
148
|
+
同一作者的 [pi-pwsh-notify](https://github.com/oversk7/pi-pwsh-notify) 为 Pi 提供 Windows PowerShell 7 工具，以及后台任务完成自动通知功能。
|
|
149
|
+
|
|
150
|
+
## 许可证
|
|
151
|
+
|
|
152
|
+
原创代码使用 MIT License。Web UI 的部分样式和设计 token 改编自 DeepSeek Harness，字体资源来自 KaTeX，代码高亮使用 highlight.js。完整归属与许可证见 [THIRD_PARTY_NOTICES.md](../THIRD_PARTY_NOTICES.md)。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@oversk7/pi-web-dsh-style",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.2",
|
|
4
4
|
"description": "An unofficial DSH-styled Windows browser UI for pi coding agent with configurable LAN and native frp relay access",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -48,6 +48,7 @@
|
|
|
48
48
|
"windows-clipboard.ts",
|
|
49
49
|
"windows-rpc-job.ps1",
|
|
50
50
|
"web/",
|
|
51
|
+
"docs/",
|
|
51
52
|
"README.md",
|
|
52
53
|
"LICENSE",
|
|
53
54
|
"THIRD_PARTY_NOTICES.md"
|