$ cat ~/map/pi-chat.md

Pi Chat

pi 的极简本地网页聊天端：流式回复、持久会话，并可从 pi 内启动。

tools✓ 9月14日

事实速查

安装

npm install 后 npm run dev（服务器仅监听本机回环地址）；把 extension/pi-chat.ts 链接进 ~/.pi/agent/extensions 即可获得 pi 内斜杠命令

## 速览

极简本地网页聊天端：复用既有 Pi SDK、凭据、工具与持久会话，经类型化 WebSocket 协议流式呈现回复。

$由既有 Pi SDK、凭据、工具与持久会话驱动——第一条提示会创建标准的持久 Pi 会话，已有凭据与配置从正常的 Pi agent 目录加载。
$服务器持有权威会话状态：类型化、运行时校验的 WebSocket 协议；每次连接与刷新都用快照替换浏览器状态；后续事件使用单调递增的序列号；Pi SDK 的事件形状不越过网络边界；provider 凭据只留在服务器侧。
$Slice 0/1 演示包含提示与中断控制、实时助手文本流、当前项目的持久会话与极简响应式聊天界面；Markdown/KaTeX、工具卡片、项目/会话选择、斜杠补全与文件引用列为后续切片。
$extension/pi-chat.ts 在 pi 内加入斜杠命令——/pi-chat-start 支持 --port、--cwd 与 --no-open，另有 /pi-chat-stop、/pi-chat-restart 与查询状态的 /pi-chat——安装方式是把该文件链接进 ~/.pi/agent/extensions。
$PI_CHAT_MODEL 按 Pi CLI 的同款拼写选定模型，在扩展加载之后解析，因此扩展注册的 provider 也能命中，未知名称会在启动时快速失败；PI_CHAT_CWD 指向别的工作目录；npx tsx scripts/list-models.ts 列出当前凭据可用的模型。
$传输层测试跑在假运行时上、不花 token；npm test 覆盖协议、聊天状态 reducer、消息映射与传输集成。

Q 会话和凭据放在哪里？

都在 pi 的常规位置——第一条提示创建标准的持久会话文件，已有凭据与配置从正常的 Pi agent 目录加载；浏览器只与本机服务器通信。

Q 浏览器会直接接触 Pi SDK 的事件类型吗？

不会——Pi SDK 的事件形状不越过网络边界；服务器把它们映射到类型化的 WebSocket 协议上，另有假运行时适配器承担确定性的传输测试。