PuppyOne：开源本地优先AI智能体桌面编辑器

AI新闻 人工智能研究所
109

一、PuppyOne是什么

PuppyOne是 puppyone‑ai 团队开源的本地优先AI智能体桌面编辑器，核心定位是给开发者、内容创作者提供一套本地运行的工作台。

它不强制依赖云端服务，所有文件、项目数据默认保存在本机磁盘，同时原生支持AI Agent编码代理，打通文档编辑、文件预览、版本控制、终端命令执行能力，既可以当作多格式文档阅读器编辑器，也可以作为AI编码智能体的本地运行工作台。

项目采用Electron跨端架构，支持桌面端运行，代码完全开源，同时配套可选PuppyOne Cloud云服务，用于备份、托管、团队协作，云服务属于可选组件，不影响基础本地功能使用。

Puppyone（图1）

二、功能特色

  1. 全格式文件编辑预览
    原生支持Markdown、HTML、DOCX、XLSX、CSV、JSON、PDF，同时兼容音视频、3D模型等文件的预览查看，一份客户端即可处理多种类型文件，无需切换多款软件。

  2. 本地优先数据架构
    所有项目、文档默认存储在本地磁盘，不会自动上传服务器；云端备份、同步功能需要用户手动开启，从架构层面保障用户数据隐私。

  3. 原生Git版本集成
    客户端内置Git能力，可视化查看文件变更记录，维护项目版本历史，不需要额外打开Git客户端，在编辑器内完成版本管理操作。

  4. 内置终端 + AI Agent编码支持
    集成本地终端环境，可对接Claude Code、Cursor、OpenCode、Codex等主流AI编码代理，让AI智能体直接读写本地项目文件、执行命令，完成代码编写、文件修改工作流。

  5. 可选云端与团队协作
    PuppyOne Cloud为附加服务，提供项目托管、数据备份、MCP/CLI常驻访问，支持多人团队项目协作，属于非必需模块。

  6. 多语言国际化支持
    项目内置locales多语言目录，支持多语言界面适配，适配不同地区用户使用习惯。

三、技术细节

  • 项目语言占比：TypeScript为主（62.4%），JavaScript（28.3%），CSS（9.3%）

  • 核心框架：Electron实现跨平台桌面端；Vite做构建工具；Tailwind CSS负责界面样式。

  • 仓库模块划分

    1. electron：Electron桌面主程序，处理窗口、系统交互、本地文件读写

    2. local‑api：本地后端接口层，承接Agent调用、文件、Git、终端能力

    3. packages：通用组件公共包，业务能力抽离复用

    4. locales：国际化多语言资源

    5. docs：项目文档

    6. benchmarks：性能测试相关代码

  • 开源协议：代码部分 Apache‑2.0开源协议；项目logo、名称等商标资产不受Apache‑2.0协议约束，参考TRADEMARK.md文件。

  • 版本迭代：最新版本v0.3.5，迭代重点为分栏编辑器、UI设置优化、HTML幻灯片新建、桌面稳定性修复。

  • 运行方式：支持npm全局CLI命令启动，也可以本地编译源码构建桌面客户端。

四、应用场景

  1. 开发者本地AI Agent工作台：本地运行AI编码智能体，AI直接读写本机项目，搭配内置终端与Git，完成代码开发、调试、版本回溯。

  2. 多格式文档统一工作台：日常处理Markdown、Office文档、PDF、CSV，一套软件完成预览简单编辑，减少软件切换。

  3. 注重隐私的内容创作者：不希望文档数据上传第三方服务器，全部文件保存在本地磁盘，需要的时候手动开启云备份。

  4. 小型团队轻量协作：开启PuppyOne Cloud，实现项目托管、团队成员协同编辑项目文件。

  5. 本地文件批量处理：搭配内置终端，对本地各类文件执行脚本处理，结合AI做文件解析、内容改写。

五、使用方法

方式1：npm CLI快速启动（推荐）

#全局安装puppyone CLI工具
npm install --global puppyone
#直接唤起桌面客户端
puppyone

方式2：源码本地编译运行

  1. clone项目仓库到本地
    git clone https://github.com/puppyone-ai/puppyone-desktop.git

  2. 安装项目依赖，执行构建脚本，启动Electron桌面程序。

    提示：源码编译需要本地具备Node.js开发环境。

基础操作流程

  1. 打开客户端，新建或者导入本地项目文件夹；

  2. 直接打开各类格式文件进行预览、编辑；

  3. 需要版本管控开启Git视图查看变更；

  4. 调用AI Agent，配置对应的编码代理服务，即可让AI操作本地文件；

  5. 需要备份再手动开启PuppyOne Cloud云端同步。

六、竞品对比

对比项 PuppyOne Cursor Obsidian
产品定位 本地优先AI智能体桌面编辑器，兼顾文档+代码工作台 AI优先代码编辑器，面向软件开发 本地优先Markdown知识库笔记软件
本地优先 ✅ 默认全部数据本地存储，云端可选 ⚠️部分AI能力依赖云端，本地模式有限 ✅全部笔记本地存储，同步为可选插件
内置Git可视化 ✅原生集成 ❌需要Git客户端，无内置可视化视图 ❌需要第三方插件实现Git
内置终端 ✅原生内置终端 ✅内置终端 ❌无原生终端
AI Agent编码代理 ✅原生对接多款编码Agent，操作本地文件 ✅内置AI编码，偏向代码补全 ❌以笔记AI插件为主，不支持代码Agent执行命令
多格式文档预览 ✅支持Office、PDF、3D模型、音视频等 仅代码、markdown 主要支持Markdown，其他格式依赖插件

七、常见问题解答

Q：PuppyOne必须联网才能使用吗？

A：不需要，基础的文件编辑、Git、终端、本地Agent能力完全离线可用。联网仅用于开启PuppyOne Cloud云同步，或者调用外部AI大模型接口，不开启则全程本地运行。

Q：项目开源协议是Apache‑2.0，是不是代表logo、项目名字也可以随便使用？

A：不是。Apache‑2.0协议仅针对仓库内代码，项目名称、Logo等商标资产有单独约束，具体查看仓库TRADEMARK.md文件，商标资产不在开源许可范围内。

Q：PuppyOne可以替代Cursor做代码开发吗？

A：可以作为备选工作台。它支持Agent编码、终端、Git，但是代码编辑器深度、代码补全生态弱于Cursor，更适合需要文档+代码混合工作流，重视本地数据隐私的用户。

Q：Windows、Mac、Linux都支持吗？

A：基于Electron跨平台架构，三大桌面操作系统都支持，使用npm CLI启动或者编译源码都可以。

Q：PuppyOne Cloud是必须付费使用的吗？

A：PuppyOne Cloud属于附加可选服务，本地全部核心功能不需要开通云服务，云相关的托管备份、团队协作才需要使用该服务。

Q：可以直接打开Word、Excel文件编辑吗？

A：支持DOCX、XLSX格式预览与基础编辑，不是完整Office套件，复杂排版编辑建议使用专业Office软件。

八、相关链接

九、总结

PuppyOne是一套开源的本地优先桌面工作台，将多格式文件处理、Git版本管理、内置终端、AI编码Agent能力整合到Electron客户端，坚持数据本地存储优先的设计思路，兼顾文档处理与AI代码工作流，适合看重隐私安全的开发者与内容创作者，云服务作为附加能力不强制绑定，开发者既可以直接使用成品，也可以下载源码二次修改构建。

AI智能体 开源项目
打赏

版权及免责申明：本文由@人工智能研究所原创发布。该文章观点仅代表作者本人，不代表本站立场。本站不承担任何相关法律责任。

如若转载，请注明出处：https://www.aipuzi.cn/ai-news/puppyone.html

THE END
作者头像
人工智能研究所
发现AI神器，探索AI技术！