项目定位#
Pi Studio Dev 是我基于 earendil-works/pi 维护的独立社区 fork。它保留上游的 Agent 运行时、Coding Agent CLI、统一模型 API 和终端界面，在此基础上增加一套面向 Windows 的 Electron 桌面工作台。
这个项目不是给 Pi 套一层聊天窗口。它要解决的是任务真正变长以后出现的管理问题：多个 Agent 怎样并行运行、同一仓库怎样避免互相覆盖、本地与远程项目怎样共用一套流程，以及 Git、产物、权限和会话状态应该放在哪里。
并行任务与托管 worktree#
每个运行中的任务都有独立后端进程和会话文件。切换任务时，界面重新读取该任务的状态，而不是停止后再启动；后台任务可以继续流式执行，完成后通过未读状态、通知和摘要提醒我回来处理。
当同一个 Git 仓库需要同时运行多个任务时，Pi Studio Dev 会为新增任务创建独立分支和托管 worktree。不同 Agent 因此不会写进同一份工作目录。任务停止时，程序只自动清理干净的 worktree；存在改动的目录会保留，分支也不会被强制删除。
本地、SSH 与 WSL 工作区#
桌面端可以打开本地目录、WSL 发行版和保存过的 SSH 主机。三种环境共用任务、Git、worktree、产物预览、项目可信状态和会话恢复流程，不需要为远程项目再维护另一套操作习惯。
远程环境缺少运行时的时候，应用可以在确认后安装校验过的 Node.js 与匹配版本的 Pi 包，文件放在用户目录，不使用 sudo，也不修改系统现有运行时。远程项目里的扩展、Skills 和设置仍然默认不受信任，需要明确授权后才会加载。
Git、产物与自动化#
应用内的 Git 面板覆盖状态检查、diff、暂存、提交、推送、分支切换和 Pull Request 流程。这里的重点不是替代完整 Git 客户端，而是让 Agent 产生的改动可以在当前任务旁边直接审查和收束。
工作台还可以预览文本、Markdown、HTML、图片、PDF 和表格文件，并提供终端标签页、会话导入导出、计划与目标、定时任务和持续心跳会话。任务结束后留下的不只是聊天记录，还包括分支、文件、产物和可恢复的会话状态。
自带模型接口#
Pi Studio Dev 面向使用自有模型接口的开发者。桌面后端不附带供应商目录，也不依赖第一方 OAuth；可在设置中添加 OpenAI 兼容接口或自定义端点，并使用 DeepSeek、通义千问和 Moonshot 等快速预设。
这是刻意保留的边界。应用负责运行 Agent、组织任务和保护工作区，不替用户托管账号，也不在后台刷新一份不可见的模型目录。模型地址、认证方式和可用模型仍由使用者自己决定。
架构与安全边界#
项目采用三进程结构：React 渲染界面、Electron 主进程和由 Bun 编译的 Pi 后端。桌面端通过严格 IPC 白名单连接主进程，主进程再使用基于标准输入输出的 JSONL RPC 管理每个任务的后端进程。
渲染进程启用沙箱和上下文隔离，项目资源默认不可信；工具审批、路径约束、远程命令参数校验和文件真实路径检查集中在明确的边界上。它不能把 Agent 变成绝对安全的程序，但会把工作区代码、界面和系统能力之间的通道收窄到可以检查的位置。
与上游的边界#
桌面产品层主要集中在 packages/desktop，其余包只保留桌面 RPC 和自定义模型接口所需的少量兼容改动。上游更新通过定期快照合并进入 fork，原项目及其贡献仍归功于 Earendil Works。
Pi Studio Dev 与 Earendil Works 没有隶属关系，也不代表上游官方版本。保持这个说明，是为了让桌面端的产品选择和 Pi 本身的运行时能力不被混为一谈。
当前状态#
当前公开开发版为 v0.83.0-dev.1，提供面向 64 位 Windows 10/11 的便携式可执行文件。下载后无需安装，但版本暂未代码签名，Windows SmartScreen 可能提示未知发布者；Release 同时提供 SHA256SUMS 用于校验文件。
代码签名、自动更新、安装器和 macOS/Linux 版本仍在明确延后。现阶段先把 Windows 上的并行任务、远程工作区、Git 流程和会话恢复做成一条可靠链路，再决定哪些平台能力值得继续扩展。