ling-kong-ran/pisper: Multi-agent app for parallel sessions, tools, memory, workflows, desktop, terminal, and mobile.

简体中文 · English

跨桌面、终端与手机的多 Agent 应用：像管理代码分支一样管理 Agent 的思路，从任意已完成 Turn 长出分支，并行推进。

移动端下载 · App Releases

项目主页 · 使用教程 · 三分钟上手 · 能力地图 · 数据安全 · English

✨ 为什么是 Pisper

• 对话也能开分支。 在任意已完成 Turn 衍生新会话，继承上下文，源会话一字不改；稳定 Turn 标签把关键节点钉成可检索的锚点 —— 像 Git，但给 Agent 用。
• 多 Agent 真并行。 每个会话独享模型、上下文、工作目录与权限；拖动标签四面分屏，进度同屏可见。
• 工具冷热分明。 核心工具常驻上下文；插件、MCP 与技能经 discover/call 网关按需激活、用完即退 —— 能力再丰富，也不把上下文塞成杂物间。
• 前缀稳，缓存才热。 工具定义稳定化排序、提示词形态哈希诊断，尽量吃满 Provider 的 prompt cache —— 长会话更快、更省。
• 缺什么能力，直接说。 Pisper 会自己编写、校验并安装本地插件，下一轮对话就能调用。
• 手机能独立，也能接桌面。 Android / iOS App 内置与桌面同源的 Node/Pisper Runtime、标准会话和 React 界面，并按设备实际能力关闭不可用入口；也可扫码连接桌面，优先 LAN、离开局域网后自动回退 Iroh P2P。远程链路继续使用 TLS 指纹与设备 Bearer 令牌。
• 数据默认不出机。 Runtime 默认只听 127.0.0.1，敏感格式自动脱敏，记忆先审后用 —— 你的上下文，你说了算。

🗺️ 能力地图

| 🌿 并行与分叉 | 🧩 能力扩展 | | --- | --- | | 并行会话分屏 · 追忆分支树 · 稳定 Turn 标签 · Ctrl+K 跨会话直达 · 会话级模型/目录/权限 | 本地插件自动生成 · 接入外部 MCP 服务 · 内置 MCP 服务供本机其他 Agent 调用 · 技能中心 · 多 Provider 模型配置 | | ⚡ 自动化与通知 | 🖥️ 终端与桌面一体 | | 可视化工作流 · 定时任务 · 飞书 / 个人微信双向渠道 · 星忆项目记忆 · Git 与 SVN 工作区 | Ratatui TUI 与桌面共用 Runtime · Android / iOS 同源本机 Runtime 或桌面连接 · 桌面宠物（Petdex）· Desktop / TUI / Runtime / App 独立更新 |

语音输入 对话模式

需要让同一台电脑上的其他 Agent 调用 Pisper？在 MCP 页面自行开启内置服务，复制连接配置。支持会话、记忆、工作流等能力；连接需要令牌。查看内置 MCP 使用说明。

🧠 基于 Pi Coding Agent 深度构建

Pisper 以 Pi Coding Agent 作为底层 Agent Runtime。在 Pi 提供的模型接入与工具执行基础上，Pisper 围绕真实的多 Agent 工作持续做深度产品化与优化：

• 运行时与会话编排：把独立会话、并行执行、Turn 分支、工作目录与权限策略组织成可持续运行的多 Agent 系统。
• 上下文与性能：通过工具冷热分层、discover/call 按需加载、稳定工具定义与提示词形态诊断，减少上下文占用并提高 Provider prompt cache 命中率。
• 完整产品层：提供 Desktop、Ratatui TUI 与移动端体验；手机本机模式运行同一套 Node/Pisper Agent、Provider、会话、HTTP/SSE 与 React，并按 embedded Node 的实际能力清单关闭当前设备无法承载的入口。

🎬 宣传视频

在线观看 · 下载 MP4 · 素材说明

📸 界面预览

并行会话：拖标签，四面分屏	追忆：在任意已完成 Turn 接回原分支
工作流：把重复工作连成流程	TUI：离开桌面，上下文不走

更多界面与交互演示见 项目主页。新增预览：对话模式 · 语音输入 · 流式渲染。

🚀 三分钟上手

需要更详细的图文说明？见 使用教程。

方式一：桌面版（推荐）

从 Releases 下载对应平台安装包，自带 TUI 与 Runtime，无需安装 Node.js。

可在下载页按系统和架构选择：

| 系统 | 安装包与离线条件 | | --- | --- | | Windows x64 普通包（推荐） | *-setup.exe（不含 -offline-）：体积较小，复用已有 WebView2；缺失时联网安装。已有 WebView2 的内网电脑也可使用。 | | Windows x64 完整离线包 | *-offline-setup.exe：额外包含完整 WebView2 安装器，适合缺少该运行时或无法确认的离线电脑；因此体积明显更大。 | | macOS | 按 Apple Silicon / Intel 选择 DMG，使用系统 WKWebView，无需额外分发浏览器内核。 | | Linux x64 | AppImage 可能需要 FUSE；Debian / Ubuntu 可选 DEB。离线部署需提前准备发行版所需系统库，DEB 可能依赖 WebKitGTK 等包。 |

Windows 自动更新使用普通包，已有 WebView2 无需随每次更新重复下载。完整离线包不包含按需下载的本地语音模型；各平台的模型、MCP 外部程序和扩展仍需单独准备，模型对话需要可达的模型服务（可以是内网服务）。旧版本未提供两种 Windows 包时，以 Release 实际资产为准。详见离线部署说明。

普通安装包检测到 WebView2 缺失时，会先说明依赖用途、联网要求和离线包选项；失败时显示修复方向及安装错误码。桌面启动时发现随包文件缺失或 Runtime 初始化失败，也会显示原生错误提示。Linux 在程序执行前发生的系统库错误，请从终端启动查看具体库名，见上方离线部署说明。

sudo xattr -rd com.apple.quarantine /Applications/Pisper.app

chmod +x Pisper_*_linux_x86_64.AppImage
./Pisper_*_linux_x86_64.AppImage

sudo apt install ./Pisper_*_linux_x86_64.deb

方式二：移动端 App

Android / iOS App 首次启动会直接进入内置的本机 Runtime；连接桌面端是正常 Pisper 界面中的可选设置，不会阻塞首次使用。项目主页会从 docs/latest-app.json 解析最新 App 下载地址，但页面不显示或写死具体版本号：

| 平台 | 下载 | 安装状态 | | --- | --- | --- | | Android | 下载已签名 APK | 已签名 arm64 APK，可直接安装；首次侧载时按系统提示允许安装未知来源应用。 | | iOS | 下载未签名 IPA | 未签名，不能直接安装；需使用 AltStore、Sideloadly 或自己的 Apple 开发者账号重签。 |

本机运行

连接桌面端

手机会记住当前使用的本机或远程 Runtime。完整流程、能力边界、安全模型与排障见 移动端使用指南 和 本机 Runtime 设计。

方式三：npm（Node.js 20+）

npm i -g pisper
pisper web   # 打开 Web 前端与本机配置页

首次进入使用 /provider 选择 Provider 并配置 API Key。可用命令及参数见 TUI 命令参考。

方式四：从源码运行

git clone https://github.com/ling-kong-ran/pisper.git
cd pisper
npm install
npm run dev

npm run desktop:webview:dev
npm run desktop:webview:build

数据默认保存在 ~/.pisper/agent，可通过 PISPER_AGENT_DIR 修改。

🔒 数据安全

Pisper 没有「我们的云」。日常数据默认由本机 Runtime 持有；你配置并实际调用的 Provider、外部 MCP、搜索或渠道，以及你主动开启并授权令牌的本机 MCP 客户端，才能取得相应任务所需的数据。

• 默认只听本机：桌面 Runtime 常规入口绑定 127.0.0.1；手机本机 Runtime 只监听随机回环端口。只有显式开启桌面远程访问后，才会额外启动 LAN HTTPS 与 Iroh P2P endpoint。Iroh 只承载原始加密字节，上层仍由 TLS 指纹和设备 Bearer 令牌保护。Pi 遥测默认关闭。
• 敏感先脱敏、凭据留在沙箱：常见 API Key、Bearer/JWT、私钥与连接串，在记忆落盘与摘要展示前被替换。手机本机 Provider 凭据与远程设备令牌当前保存在 App 私有目录，依赖系统沙箱与文件权限保护，尚未迁入 Android Keystore 或 iOS Keychain。
• 权限有边界：需审批、工作区写入、完全访问三档；凭据不经普通接口回显给 Agent，宿主 Shell 会移除常见凭据环境变量。
• 对外 MCP 自行开启：内置服务默认关闭，只监听 127.0.0.1，使用单独的 Bearer 令牌；持有令牌的本机客户端可以调用所有已开放工具。连接与令牌说明。
• 记忆需确认：自动推断的记忆先进入待确认区，你点头之前不参与召回。

边界说明：脱敏只识别常见敏感格式，不是完整 DLP、沙箱或端到端加密。桌面 Runtime 的 Provider 凭据仍位于本机 Agent 数据目录，请保护该目录和备份；手机安全存储也不能替代设备锁屏、系统更新与可信侧载来源。完整说明见项目主页数据安全部分。

🧩 组件与独立更新

Desktop、TUI、Runtime 与移动 App 各自独立版本、独立签名、独立更新，失败自动回退到内置版本。桌面端提供统一组件检查入口；移动 App 使用独立发布清单。

独立 UI 组件可在「设置 → 界面设置 → 独立组件」导入文件夹或 ZIP；重新加载界面后会出现在「更多工具」。游戏素材工作台不再内置，源码位于 pisper-components。自定义组件说明

📚 文档

新手从这里开始 → 使用教程：安装、模型配置、并行会话、分支、工作流、终端与移动端的完整说明。

| 文档 | 内容 | | --- | --- | | 使用教程 | 从安装到进阶的完整上手路径 | | 项目主页 | 产品介绍与界面演示 | | TUI 命令参考 | CLI、Slash command 与参数说明 | | 移动端使用指南 | 安装、本机运行、桌面配对、安全模型与排障 | | 移动端本机 Runtime | 统一 Node 架构、能力清单与供应链 | | 插件开发指南 | 编写与发布插件；另见 本地插件指南 | | 桌面宠物（Petdex） | 桌面宠物集成说明 |

🛠️ 开发

底层 Agent Runtime 基于 Pi Coding Agent 深度集成；产品层主要使用 React、TypeScript、Tauri、Rust 与 Node SEA。

npm run check   # typecheck + lint + i18n + format + 启动检查
npm test        # runtime 测试
npm run build   # 生产构建

欢迎提交 Issue 与 Pull Request。请勿提交 API Key、机器人凭据，或 ~/.pisper/agent 中的个人数据。

🙏 致谢

感谢 Pi Coding Agent、Petdex 及本项目使用的开源软件。

贡献者：

• @mik-myp — 前端 TypeScript 架构、shadcn/ui / AI Elements、Zustand 与 i18n 重构（#1）

❤️ 赞助

如果你也希望出现在这里，欢迎通过 Issue 联系我们。

如果 Pisper 对你有用，点一颗 ⭐ —— 这是让项目继续生长的最大动力。
_{也欢迎分享给每一个把 Coding Agent 当生产力工具的人。}

MIT License · © Pisper Contributors · 返回顶部 ↑