penecho/penecho

PenEcho – AI 增强的视觉画布

是什么 – PenEcho 是一个开源的桌面/网页应用程序，将巨大的无限尺寸绘图区域（20,000 × 20,000 像素）转变为交互式工作区，您可以在其中书写、绘图、粘贴文档，并让大型语言模型（LLM）在您的笔迹旁直接生成解释、公式、图表、示意图或其他视觉组件。AI 作为“代理”运行，能够读取文件、浏览网页，并在不离开画布的情况下迭代优化视觉输出。

核心功能

• PenEcho 代理 – 多步骤工作流，可导入 PDF、Word、PowerPoint、Excel、图像、代码或只读文件夹，结合网络搜索与当前画布内容，生成并编辑视觉草稿。
• 视觉探索器 – 将密集的研究材料转化为响应式、分层的视觉地图，包含概览、细节和证据面板，减少复制粘贴和工具切换。
• 空间 AI 交互 – 您在画布任意位置写下问题、方程或示意图；模型读取周围标记后，在其旁边作出回应。
• 可编辑的 AI 组件 – 生成的 HTML、专业图表、动画或实时数据插件以可移动对象形式出现，可通过增量差分编辑在原地优化。
• 多模型后端支持 – 支持最多十个连接（Kimi、Claude、OpenAI、DeepSeek、GLM 等），每个请求可选择不同模型；配置通过 penecho configure 或简单 env 文件完成。
• PenEcho 云服务（可选） – 在设备间同步私有项目，共享公开的“作品”（称为 Echoes），并获取远程 LAN 访问中继，同时将 API 密钥保留在主机上。
• 安全优先设计 – API 密钥从不离开服务器进程；每个会话由六位数 LAN 代码保护；除非用户选择启用云同步，否则所有数据均保留在用户设备上。

如何工作

1. 浏览器仅发送用户选择的笔迹裁剪区域及几何元数据。
2. 本地 Node.js 服务器验证请求，转发至所选执行器（API 调用或本地 CLI），接收结构化草稿。
3. 草稿以可移动组件形式返回；用户可在其变为永久笔迹前接受、丢弃或编辑。
4. 画布将笔迹存储为稀疏的 512 × 512 瓦片，因此即使逻辑画布巨大，仍保持轻量。

快速上手

• 桌面二进制文件 – 从 GitHub Releases 页面下载最新版本并运行。
• npm 安装 – npm install -g penecho，然后运行 penecho configure 选择模型源（API 密钥或已认证的 Kimi/Codex/Claude CLI）。使用 penecho 启动，并打开 http://localhost:3888。
• 从源码构建 – git clone https://github.com/penecho/penecho.git && npm install && npm start。

模型推荐（来自 README） – Claude Opus 4.8/5.0、Kimi K3、gpt-5.6 系列、DeepSeek-v4-flash-vision-exp、GLM-5.3-flash 均针对画布工作负载进行了优化。README 中的表格列出了努力等级（低/中/高/X高）和典型令牌使用量。

许可证 – AGPL-v3（闭源分发可选商业许可证）。所有代码、资产及名称/Logo 均受项目商标和贡献者协议保护。

适用人群 – 研究人员、教育工作者、工程师，或任何希望在不频繁切换聊天窗口与绘图工具的情况下，融合手写笔记与 AI 生成视觉内容的人。