Puppyone CLI v0.1.0 — 新版本更新
2026年4月12日Guantum @puppyone
Puppyone 是什么？
Puppyone 是一个为多智能体协作打造的文件工作区。你可以把它想象成 GitHub，但存放的不是代码仓库，而是 上下文（Context）——AI 智能体工作所需的文档、数据和配置文件。
它解决的问题是：你的信息散落在 Gmail、Notion、GitHub、Google Drive、本地文件夹等几十个地方。AI 智能体很难统一访问这些数据。Puppyone 把所有内容汇聚到一个工作区，然后通过标准协议 MUT（Managed Unified Tree，类似 Git，但专为 AI 设计）让任意智能体（Claude、GPT、Cursor 或你自己开发的 Bot）对这个工作区进行读写。
Puppyone CLI（puppyone）是用来在终端中管理这一切的命令行工具。
v0.1.0 有什么新变化？
三个大改动：终端直接操作远程文件系统、统一的数据连接命令，以及用显式同步替代旧的后台守护进程。
1. puppyone data — 在终端操作你的云端工作区
这是什么：Puppyone 把你的数据存储在云端文件系统里（文件夹、JSON、Markdown 等）。以前只能通过网页界面浏览和编辑，现在终端里就能搞定一切。
为什么重要：Claude Code 和 Cursor 这类 AI 编码工具在终端里工作，脚本在终端里运行，CI/CD 流水线在终端里执行。现在它们都可以直接读写你的 Puppyone 工作区了。
puppyone data ls /docs # 列出文件夹内容
puppyone data cat /docs/readme.md # 查看文件
puppyone data write /config.json '{"model": "gpt-4"}' # 创建或更新文件
puppyone data mkdir /new-folder # 创建文件夹
puppyone data tree / # 查看完整目录树
puppyone data cp /src/a.md /backup/ # 复制
puppyone data mv /old /new # 移动或重命名
puppyone data trash /temp.json # 软删除（可恢复）
puppyone data restore /temp.json # 撤销删除
所有命令都支持 --json 参数，输出结构化数据，方便脚本处理或提供给 AI 智能体：
puppyone data ls /docs --json | jq '.entries[].name'
完整命令列表：ls、cat、tree、stat、write、touch、mkdir、cp、mv、rm、trash、restore。
2. puppyone access — 一条命令连接一切
这是什么：Puppyone 可以从 15+ 个平台拉取数据（Gmail、GitHub、Notion、Google Drive 等），同步本地文件夹，创建 AI 智能体，暴露 MCP 端点，运行沙箱环境。这些统称为「Access Point（接入点）」——数据进出工作区的通道。
以前这些功能分散在不同命令里。现在统一为一条命令：puppyone access。
# 连接数据源
puppyone access add gmail # 拉取邮件到工作区
puppyone access add github --set repo=myorg/myrepo # 同步 GitHub 仓库
puppyone access add notion # 导入 Notion 页面
# 同步本地文件夹（双向，通过 MUT 协议）
puppyone access add filesystem /code # 关联本地目录
# 创建 AI 智能体和端点
puppyone access add agent "Research Bot" # 创建 AI 智能体
puppyone access add mcp "My API" # 创建 MCP 端点
puppyone access add sandbox "Runner" # 创建隔离的执行环境
# 统一管理
puppyone access ls # 总览所有连接
puppyone access info <id> # 查看接入点详情
puppyone access pause <id> # 暂停同步
puppyone access resume <id> # 恢复同步
puppyone access rm <id> # 移除连接
你也可以查看支持哪些平台以及如何配置：
puppyone access providers # 列出所有支持的连接器
puppyone access schema gmail # 查看 Gmail 接受的配置字段
3. 告别后台守护进程
变了什么：v0.0.2 中，本地文件夹同步通过一个后台守护进程实现——一个持续运行的进程，监视文件变化并自动同步。它脆弱、难以调试，而且经常静默崩溃。
现在的方式：文件系统同步直接使用 MUT 协议。创建文件系统接入点后，用简单明确的命令操作：
mut clone <url> --credential <key> # 一次性配置：克隆工作区到本地
mut commit -m "updated docs" && mut push # 推送本地更改到云端
mut pull # 从云端拉取更改
没有后台进程，没有神秘状态。准备好了就 push，需要同步就 pull。跟 Git 一样简单。
面向开发者和智能体开发者
如果你在 Puppyone 之上构建应用或将其集成到 AI 智能体工作流中：
- 所有命令支持
--json— 输出可以 pipe 到jq，喂给智能体，或用于 CI - 内置 OAuth 流程 —
puppyone access auth github会打开浏览器完成 OAuth，无需手动处理 Token - 配置 Schema 自省 —
puppyone access schema <provider>告诉你所有可用字段、类型和默认值 - 统一 API 接口 — 每种接入点（Gmail、GitHub、文件系统、智能体、MCP、沙箱）都使用相同的 CRUD 命令：
add、ls、info、update、pause、resume、rm
从 v0.0.2 升级
npm install -g puppyone@latest
| v0.0.2 | v0.1.0 |
|---|---|
puppyone connect add filesystem /path | puppyone access add filesystem /path |
puppyone status（显示守护进程状态） | puppyone access ls（显示所有接入点） |
| 后台守护进程自动同步文件 | mut push / mut pull（你来控制节奏） |
| 无法在终端读写云端文件 | puppyone data ls、cat、write、tree 等 |
开始使用
npm install -g puppyone
puppyone auth login
puppyone project use "My Project"
puppyone data ls /
了解更多：puppyone.ai