不用急着做一个大项目。先连接模型，再从一个小任务开始。
到下载页面选择适合你的安装方式。桌面安装包的可用系统与版本，以 GitHub 发布页实际附件为准。
在首次设置或模型设置中添加模型服务，填写服务地址、密钥与模型名称，确认服务可用。也可以使用本地模式提供的官方账号授权入口；权限与额度以服务商为准。
选择本地项目目录，确认权限设置。建议先让 Agent 阅读代码和说明，不修改文件。
Pi-Wm先阅读这个项目的 README 和目录结构，说明启动方式与主要模块，暂时不要修改文件。项目仍处于内测阶段。请先在测试目录体验，备份重要文件；模型调用可能产生费用。
你决定使用什么模型，也决定每个任务的能力与预算。
在「已保存服务」中，点击对应服务右侧的刷新按钮，即可重新获取模型列表，再选择需要添加或更换的模型。已有服务无需重复填写 Base URL 和 API Key。
在「已添加模型」中，点击模型右侧的测试按钮（波形图标），检查该模型是否能够正常调用。若测试失败，可根据返回的信息核对服务地址、密钥、模型权限与账户额度。
模型测试会发起实际请求，可能消耗服务商额度；测试通过代表当前调用可用，不保证后续所有任务都能成功。
同名模型可能来自不同服务，选择前查看所属服务。按任务选择可用思考强度，不支持的选项不会增加模型能力。删除整组服务会移除保存的密钥及其模型，需要确认影响后再操作。
本地模式提供 Claude、ChatGPT、Grok 的账号授权入口。授权与可用模型受账号权限和服务商限制，不代表Pi-Wm提供订阅或额外额度。
不要把 API Key 填在官网、任务正文或公开问题反馈中。仅在本地应用的模型设置中配置。
从理解代码到检查结果，把一个任务完整地做下来。
选择正确的本地目录，再交代任务的目标、范围与验收方式。文件读取、修改和命令执行都应围绕你确认的项目展开。
通过文件和更改视图检查修改内容，在终端执行项目已有的测试或构建命令。保存结果前，确认没有混入密钥、配置或不相关文件。
Agent 可以通过独立的 Playwright 浏览器查看页面、操作控件、截图和检查报错。桌面端另有内置浏览器，方便你打开本地预览。
桌面预览与 Agent 浏览器相互独立，不共享页面和 Cookie，也不会自动使用个人 Chrome 或 Edge 的登录状态。
本机 Shell 命令使用你的系统权限。项目目录约束和操作审批不等于操作系统级沙箱。
当任务可以分工，让不同成员各自专注，也让协作过程看得见。
负责人组织持续运行的团队成员，通过共享任务、依赖关系和成员消息协作。你可以在工作台查看成员分工、进度与验收记录。
/team 为当前项目增加登录表单验证。请分别安排实现与回归检查，避免同时修改同一文件；保留现有改动，最后报告测试结果。子任务适合一次有边界的委派；Teams 是独立持续运行的协作。切换或归档启动会话不会停止团队，需要在团队界面处理。不要因为启动对话空闲而再次创建相同团队。成员模板是可复用配置，不是创建团队的前置要求。
交代各成员的工作范围，避免同时修改相同文件。需要复用角色时，可以保存成员模板，保留模型与工具配置。
自主规划需要真实模型，Demo 模式不会模拟模型决策。多 Agent 会增加模型调用，请关注用量和预算。
把常用方法留下，把需要的工具接进来。
使用内置技能，或从工作区目录安装、预览和管理本地技能包。安装前先阅读技能说明和附带脚本，确认其来源与作用。
当前技能安装面向本地目录，不应理解为已支持远程技能市场、仓库安装或 ZIP 安装。
在应用中添加、编辑、授权和连接 MCP 服务。保存配置不会自动授予信任，请确认工具的访问范围，再允许其执行操作。
Windows 上可显式开启桌面控制，通过 UI Automation 或截图与输入操作应用。此能力需要额外准备 Python 3 环境，当前不适用于 macOS 桌面控制。
支持一次性或固定间隔的计划任务。任务依赖本地应用保持运行，关闭应用后不会继续执行。
MCP 配置中的环境变量或请求头可能以明文保存在工作区配置中。不要把包含凭据的配置提交到仓库。
适合希望本地开发、调试或参与改进的使用者。
安装 Git 和 Node.js 22.19 或更高版本。桌面打包须使用目标平台对应的系统与芯片，并使用 Node.js 22.19+ 的 22.x 版本，不跨平台打包原生依赖。
git clone https://github.com/333-wg/pi-wm.git
cd pi-wm
npm install --legacy-peer-deps
npm run local
启动后打开
http://127.0.0.1:5173/。首次出现欢迎页时，源码开发默认口令为 wuming。
npm run desktop
此命令构建项目后启动 Electron 和本地服务。需要浏览器自动化时，可先运行
npm run test:e2e:install 安装 Chromium。
开发默认口令仅适合本机回环访问，不要把 Gateway 暴露到公网。桌面端欢迎页不是安全边界，桌面 Gateway 使用单独生成的随机令牌。
本地优先，不等于离线运行；执行审批，也不等于系统沙箱。
工作区操作和会话状态由本机服务管理。使用远程模型时，请求与相关上下文会发送给配置的服务商；MCP、媒体生成等外部服务也有各自的数据流向。使用前请检查所选服务的政策与授权范围。
本机命令使用你的系统权限。项目目录约束和操作审批不等于操作系统级隔离；需要容器隔离时，应显式配置 Docker 后端。
模型 API Key 由本地服务加密保存，但 MCP 的环境变量、请求头等仍可能明文保存在工作区配置中。不要将敏感配置提交到仓库，也不要把包含凭据的日志公开。
本官网仅提供产品介绍、使用文档和发布页入口，不收集模型密钥、不执行 Agent 任务。点击 GitHub 等外部链接后，将进入对应服务的网站。
当前版本仍在持续开发和内测中，建议备份重要数据，在测试项目上先行验证。模型、多 Agent 与媒体生成可能消耗服务商额度，请结合预算使用。
准备好了从第一个任务开始选对安装包，再开始你的第一个项目。
准备一个测试项目和可用的模型服务。桌面安装包自带 Node 与浏览器组件，普通使用不需要安装 npm；Computer Use 另需 Python 3。
Windows 在「设置 → 关于与更新」检查、下载并确认安装；需已配置更新源。Mac 暂不支持自动更新，请退出应用后手动替换。更新前保存工作，更新后核对版本、项目与模型配置，先验证一个小任务。
项目仍在持续开发 / 内测。安装包发布不等于所有系统和真实升级路径均已完成验收。
把目标、范围和完成标准说明白，让执行过程更可控。
先定位登录表单提交失败的原因，只修改相关文件。保留现有改动，补充回归测试，并报告测试结果。通过输入区附件入口选择文件，确认附件已出现在草稿中，再发送说明。图片理解和文件处理取决于模型及工具能力；上传成功不等于模型一定能理解。不要附加密钥文件或不必要的个人数据。
执行中查看工具记录、审批和错误信息。停止任务不会撤销已经写入的文件、运行过的命令或外部操作。重新尝试前先检查当前状态，不要重复提交结果未知的操作。
使用聊天搜索查找正文，打开对应会话继续。为不同目标使用清楚的会话名称；归档用于整理，不应当作备份。编辑旧消息或分叉会改变后续对话路径，不会回滚项目文件。
长任务与中断恢复 →让每次改动可检查，让命令结果可追溯。
打开终端后，它显示在右侧独立面板，保留当前对话与草稿。拖动分隔条调整宽度，或聚焦分隔条后使用方向键；双击恢复默认宽度。窄屏使用抽屉布局。
收起面板不等于结束命令。需要停止进程时，先确认当前终端任务，再使用对应的中断操作。终端与浏览器预览、运行详情面板互斥显示。
根据项目 README 和配置选择命令，不要给所有项目套用同一组 npm 命令。记录退出状态和错误；构建通过不代表交互已经验证。提交或推送前再次核对差异，并明确授权。
本机命令使用当前系统用户权限。目录约束和审批不是操作系统级隔离；不要在不了解影响时运行删除或覆盖命令。
打开页面只是开始，交互结果才是验收依据。
桌面内置浏览器用于你直接查看本地预览；Agent 使用独立的 Playwright 浏览器操作页面、截图和检查错误。两者不共享 Cookie，也不自动导入个人 Chrome / Edge 登录状态。
请启动这个项目，验证刚修改的表单。在桌面和手机尺寸分别检查成功、无效输入和取消路径，查看浏览器报错并保留截图。先确认服务仍运行、地址和端口正确，再看启动日志。源码环境缺少 Chromium 时按源码运行指南安装。证书、代理或网络策略错误应单独排查，不要关闭安全检查来伪造通过。
技能保存工作方法，不会自动授予额外权限。
packages/my-skill/
SKILL.md
references/
scripts/用户技能属于当前工作区，安装不会执行附带脚本，也不会上传到 Pi-Wm 服务。禁用后不再进入后续可用技能列表；内置技能不能通过管理器卸载。重名安装不会覆盖原技能。
目前支持工作区本地目录安装，不支持把远程仓库地址或 ZIP 当作安装目录。不要填写逃出项目的路径。媒体技能复用应用的图片 / 视频模型配置，无需另给技能一份密钥。
配置、信任和连接是不同步骤。
确认 MCP 服务的来源、启动方式、依赖和它会访问的数据。stdio 服务在本机启动进程；HTTP 服务连接指定地址。使用服务自己的说明准备参数，不要复制来源不明的配置。
命令找不到时检查依赖和可执行路径；HTTP 失败时核对地址、认证与服务状态。保存成功不等于进程已启动或工具可用。不再使用时撤销信任并断开，配置保留不代表仍被授权。
MCP 环境变量和请求头可能明文保存在本地配置中。不要提交到 Git，也不要在日志或截图中公开。
电脑执行任务，手机查看进度、继续对话与处理普通审批。
需要支持手机访问的版本、可用模型，以及 HTTPS 连接方式。电脑必须开机、联网、未休眠且 Pi-Wm 正在运行。入口默认关闭，应用重启后需要手动开启。
打开「设置 → 手机访问」。临时隧道方式需要自行安装官方 cloudflared，并填写可执行文件绝对路径；等待连接就绪，而不只是拿到域名。也可使用已有固定 HTTPS 反向代理，具体要求见下一篇。
基础接续可查看会话、发送指令、停止任务和处理普通审批。完整对话还可新建、重命名、归档及恢复会话，选择已有模型和 Skill，并上传附件。旧设备不会自动扩大权限，需要重新配对授权。
完整权限下，从左上角项目树新建对话，底部模型标签调整模型与思考，输入 / 选择电脑已安装的技能，＋ 上传附件，右上角 ⋯ 管理会话和显示偏好。每条消息最多 8 个附件，单文件最多 10 MB，还受文件类型限制。
配对后收藏不带配对片段的 /phone 地址，并使用同一普通浏览器。换浏览器、清理 Cookie、授权过期或临时域名变化后需要重新配对。电脑新增项目也需要重新配对才能纳入授权。
在电脑撤销设备或关闭入口。设备授权默认 30 天。手机不提供直接终端、模型密钥管理或完整团队管理；Computer Use 人工审批仍在电脑处理。手机指令仍能驱动已授权工具，不是只读模式或额外系统沙箱。
手机关闭页面不会主动取消电脑任务；电脑退出或休眠会停止访问。真实公网、蜂窝网络和手机系统体验需在你的设备上验证。
先区分连接、配对和授权问题，再采取对应措施。
检查 cloudflared 路径和执行权限，再查看设置中连接阶段、重试次数和错误分类。入口申请需要 HTTPS 可达，边缘连接需要 TCP / UDP 7844 至少一种可用。普通网页可打开不能证明隧道能连接。
应用不会修改系统代理、DNS、防火墙或 TLS 校验。自动重试停止后先检查网络策略和代理日志，不要反复点击开启或全局关闭安全软件。重建隧道后域名可能变化，需要新二维码。
填写完整 HTTPS origin，不带路径；选择固定手机回环端口，例如 5188。代理上游必须指向独立手机服务，而不是主 Gateway。填写域名不会自动配置 DNS、证书或内网穿透。
代理需有效证书、保留 Host 与 Origin 并支持 WebSocket upgrade。转发 /phone、/assets/*、/api/phone/*、/api/ws，以及受限附件下载和上传路径。跨机器还需另行建立受控回程网络。
/api/artifacts/:id
/api/workspaces/:id/artifacts先恢复连接并检查同一会话的历史，再决定是否重试。结果未知时不会自动重放写入。电脑执行期间可以编辑草稿，但手机发送需等待当前会话空闲；团队可能仍在独立运行。
首次配置后，用手机蜂窝网络实际验证，不能只看二维码。标准 HTTPS 隧道不是中转不可读的端到端加密，隧道服务商可能接触会话和文件内容。
保留上下文，不把恢复误解为撤销。
开启自动压缩后，系统会在一批工具完成、下一次模型请求之前检查预算，必要时摘要较早上下文并继续同一任务。最新工具调用和整批结果保留，不重放已执行工具。
上下文窗口与累计计费用量不同。压缩不是无限记忆，也不能保证所有细节永久保留。关键约束、验收标准和必要文件应明确写出；显式关闭自动压缩后，不会触发此执行中检查。
先检查上次中断后已完成的改动和测试，不重复执行结果未知的操作。然后从未完成部分继续，并说明还缺哪些验证。摘要失败、取消或压缩后仍超预算时，本轮停止后续推理，避免无限压缩。检查模型错误和上下文设置；必要时整理简短进度摘要，在新会话中明确引用相关文件继续。不要把新会话当作自动继承全部历史。
在应用里配置一次，在对话里说明创作需求。
生成一张用于个人项目首页的插画：绿色植物与书桌，留出左侧标题空间，不要文字。请使用已配置的默认图片模型。需要修改图片或图生视频时，先附加真实参考图，并说明保留哪些主体、希望如何变化。是否支持参考图及具体参数由所选服务决定，不应静默替换成无参考图生成。
视频提交后按原任务继续获取结果，不要把等待状态当作生成失败再次提交。图片已经生成但下载失败时，应恢复原结果而不是重新付费生成。生成失败先查看错误，再决定下一步。
图片和视频调用可能收费。技能复用应用已保存的媒体配置，不需要单独配置供应商脚本或把密钥写进提示词；不要上传无权使用的参考素材。
适用于本机应用操作，不替代网页浏览器工具。
Computer Use 当前仅支持 Windows，需 Python 3 和应用内显式开启。它读取本机窗口与控件，必要时使用截图和鼠标键盘输入；可能看到屏幕上的私人信息。
查看当前记事本窗口，告诉我有哪些可用控件，暂时不要输入、保存或关闭窗口。发送消息、提交、购买、删除和凭据输入需要明确授权；普通设置授权不等于批准这些动作。前台控制可能影响你正在使用的鼠标键盘，操作期间避免同时输入。结果不确定时先重新观察，不盲目重复点击。
macOS 不支持此桌面控制能力。手机不能处理 Computer Use 的本地人工审批；请回到电脑确认。
让工作台适合你，而不是改变任务的权限。
在设置中选择浅色、深色或跟随系统，以及界面语言和任务通知。通知是否显示还受操作系统权限影响；关闭通知不会停止任务。
可收藏最多 24 张壁纸。图片只保存在本机浏览器存储，不上传，也不自动跨设备同步；清除站点数据可能丢失收藏，请保留原图。
手机右上角菜单可调整深浅主题、字号以及思考和工具过程显示。它们保存在当前浏览器，不修改电脑端外观。截图中的外观与模型名称仅作示例，不代表预置服务。
根据现象找到下一步，不把重试当作唯一办法。
401 / 403 通常先核对密钥和账号权限；404 核对接口路径与模型标识；429 检查速率限制和额度，按服务提示等待。保留脱敏错误，不要反复更换协议或批量发送测试请求。
检查当前权限、待处理审批、技能启用状态和 MCP 信任状态。确认任务确实要求执行而非仅分析。不要通过降低安全设置来掩盖工具缺失；先核对所需依赖和支持平台。
区分模型等待、工具运行、审批等待和错误终止。查看最后一条状态后再停止或重试。停止不是回滚，团队也可能独立于启动会话运行；检查团队页，不要仅凭会话空闲判断完成。
安装时先核对芯片、附件和签名限制；手机问题先区分网络与设备授权；本地预览先确认服务存活和端口。不要将某个环境的成功当作所有设备都已验证。
手机连接专项排错 →不要在公开 Issue 上传整个数据目录、完整模型配置或未经检查的会话导出。