
PenEcho 桌面版使用指南macOS 与 Windows 安装、自动更新与个性化配置完整教程【免费下载链接】penechoThink with AI beyond the chat box. A shared canvas for handwriting, equations, diagrams, and spatial reasoning.项目地址: https://gitcode.com/gh_mirrors/pe/penechoPenEcho 桌面版是一款让 AI 走出聊天框的共享画布应用手写、公式、图表与空间推理都在同一块画布上完成内置 AI Agent 还能把草图直接变成专业图表和可交互组件。本指南覆盖 macOS 与 Windows 桌面版的下载安装、首次启动配置、自动更新机制与个性化设置帮你 10 分钟上手。一、获取 PenEcho 桌面版一键下载PenEcho 桌面版基于 Electron 打包内置了 Chromium 与 Node.js 运行时——你不需要安装 Node.js、Python 或任何其他依赖双击安装包即可使用。官方下载页同时提供三个入口平台文件要求macOSApple Silicon / IntelPenEcho-x-mac-arm64.dmg/mac-x64.dmgmacOS 13Windowsx64PenEcho-Setup-x-win-x64.exeWindows 10npm CLInpm install -g penecho已有 Node.js 22.19 下载时认准对应自己芯片/系统的精确文件名例如 M 系列 Mac 选arm64更新器只接受完全匹配的安装包。二、macOS 安装与首次启动下载.dmg后双击挂载将 PenEcho 拖入「应用程序」文件夹。正式发布版均经过 Apple Developer ID 签名与公证notarization首次打开如提示安全校验选择「打开」即可。首次启动会进入图形化设置页无需打开终端选择 AI 接入方式API推荐新手、Kimi、Codex CLI或Claude CLI填入 API Key 后点击「Test, save launch」应用会验证配置并实测连接最长 30 秒密钥仅保存在本机用户级凭据文件中macOS 本地压缩存储不写入钥匙串测试通过后应用自动重启并打开本地画布之后每次启动都直接进画布。不想配 API用「Install sign in」选择 Codex CLI 或 Claude Code 时可点击Install sign inPenEcho 会自动下载官方安装脚本不经过 npm、无需管理员权限、安装完成后打开浏览器登录随后自动继续连接测试。整个过程零命令行。三、Windows 安装与首次启动Windows 端使用 Squirrel 打包的 Setup 安装程序同样免依赖、免管理员下载PenEcho-Setup-x-win-x64.exe双击运行安装完成后桌面与任务栏都会生成图标首次启动同样进入图形化设置页流程与 macOS 一致选 provider → 填 Key → 测试并启动密钥通过 ElectronsafeStorage与 Windows DPAPI 加密存储只属于当前 Windows 用户后续更新会复用 Squirrel 的静默升级通道桌面快捷方式自动保持指向最新版本。四、自动更新机制省心又安全PenEcho 桌面版内置更新管理器实现见 desktop/update-manager.js行为如下自动检查启动约 20 秒后首次检查之后每 6 小时检查一次手动检查macOS 在顶部菜单「PenEcho → 检查更新…Check for Updates…」Windows 在「帮助 → 检查更新…」✅只信任正式发布仅接受已发布非草稿/预发布且文件名与当前平台、架构精确匹配的安装包通过 HTTPS 下载并校验 GitHub 提供的SHA-256 摘要摘要不符立即删除无缝替换macOS 下载 ZIP 包并在应用退出后替换.app需位于用户可写目录Windows 下载 Setup 可执行文件走静默升级。下载进度只在 PenEcho 更新窗口内显示不会打扰任务栏。若更新检查失败窗口会给出明确错误提示可稍后重试或从下载页手动获取新版。五、个性化配置设置、安全码与本地数据5.1 在哪里改设置macOS顶部菜单「PenEcho → 设置…」Windows「文件 → 设置…」或右上角齿轮图标设置契约定义在 desktop/settings-contract.js常见可选项包括配置项说明AI ProviderAPI / Kimi / Kimi CLI / Codex CLI / Claude CLI推理力度Reasoning Effortnone ~ max 六档模型超时10–600 秒图像传输格式WebP / PNG监听地址默认仅本机127.0.0.1:3888高级选项可开启局域网访问桌面版原生菜单文件/编辑/视图/AI/MCP/局域网/帮助的完整命令表见 desktop/menu.js「帮助」菜单还提供使用指南与功能导览Feature Tour第一次使用建议跑一遍。5.2 浏览器/局域网访问需要安全码桌面服务默认只监听本机。若通过浏览器打开本地地址或开启局域网访问会看到安全码输入页输入 6 位安全码即可进入。忘记密码重启 PenEcho 即会重新生成画布文件与设置不受影响。5.3 数据都在哪里桌面状态保存在系统标准应用数据目录macOS~/Library/Application Support/PenEchoWindows%APPDATA%\PenEcho个人插件也存放在该目录下而非安装包里升级不会丢失。备份这个目录即可带走全部画布与配置。六、桌面版是怎么运行的PenEcho 桌面版 原生外壳 本地服务桌面应用内嵌一个只监听本机的服务默认127.0.0.1:3888画布、内置 Agent 与 MCP Server 协同工作。第三方 AgentCodex、Claude Code 等可通过 MCP 直接在你的画布上作图你的批注它下一轮就能读到。七、常见问题FAQQ更新提示「不兼容」更新器只接受当前平台架构的精确资产mac arm64/x64、win x64。请确认下载的文件名与系统匹配。QmacOS 更新失败请确保 PenEcho 安装在用户可写的位置默认「应用程序」目录即可。QAPI 测试超时怎么办测试最长等待 30 秒超时后已保存的配置仍可直接启动使用稍后网络恢复再测即可。Q想从源码构建桌面版参考官方打包文档 docs/packaging/desktop.md构建机需要 Node.js 22.19执行npm run desktop:deps后按平台运行npm run desktop:make:mac或desktop:make:windowsElectron 打包配置见 forge.config.js。至此你已完成 PenEcho 桌面版的安装、更新与个性化配置。打开画布手写你的第一笔让 AI 把想法变成图表吧 【免费下载链接】penechoThink with AI beyond the chat box. A shared canvas for handwriting, equations, diagrams, and spatial reasoning.项目地址: https://gitcode.com/gh_mirrors/pe/penecho创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考