PuppyOne 富文件编辑器深度指南：Markdown、CSV 表格、PDF、3D 与数据库预览一次讲透-开发者社区

【免费下载链接】puppyone

Context drive for your AI agents

项目地址：https://gitcode.com/gh_mirrors/pu/puppyone

PuppyOne 是一款本地优先（local-first）的富文件编辑器，为人类与 AI 智能体共同设计。它最大的亮点，是把Markdown 编辑、CSV 表格编辑、PDF 预览、3D 模型预览、数据库预览全部内置进同一个工作区——打开一个文件，就能直接看、直接改，无需在多个工具间来回切换。本文带你快速掌握这五类最常用的富文件能力。

为什么值得先了解富文件编辑器

传统编辑器往往只能处理文本，遇到表格、PDF、模型、数据库就得交给外部软件。PuppyOne 用一套统一的「查看器（Viewer）」体系，让不同格式的文件各归其位：文本类可编辑，二进制类可预览。你可以在同一个窗口里左边写文档、右边看数据，效率大大提升。

整个能力由一份集中的清单定义，每种格式的能力、边界一目了然，参见 presetViewerManifest.json。

Markdown 编辑：从写作到演示一气呵成

Markdown 是 PuppyOne 的主力文档格式，不仅支持.md，还覆盖.mdx、.mdown以及.agent.md等 AI 指令文件。

核心能力：

📝实时预览：边写边看渲染效果，无需手动刷新。
🧭标题大纲：通过层级标题快速跳转长文档。
✋块级拖拽：段落、列表、代码块可像卡片一样拖拽重排。
🤖AI 协同：直接对 Markdown 内容发起 AI 修改并审阅改动。

相关实现集中在 MarkdownViewer.tsx，编辑内核与实时预览逻辑分别位于 MarkdownCodeMirrorEditor.tsx 与 MarkdownPresentationPreview.tsx。

CSV 表格编辑：像电子表格一样改数据

处理数据时，.csv/.tsv文件会以网格（table）形式呈现，而不是密密麻麻的原始逗号文本。你可以在单元格里直接输入、调整列宽，甚至让智能体帮你批量整理数据。

表格查看器支持「表格视图」与「源码视图」自由切换，关键组件包括 CsvTableEditor.tsx（网格编辑）与 CsvSourceEditor.tsx（原始文本编辑），单元格编辑逻辑见 CsvCellEditor.tsx。

💡 小提示：DOCX 与 XLSX 等 Office 文档则由独立的分页预览查看器呈现，无需安装 Word 或 Excel 即可查看排版效果。

PDF 预览：分页、可缩放的高清阅读

PuppyOne 内置了高性能的PDF 预览查看器，特点是分页显示、可缩放、支持滚动，且采用独立的浏览器引擎渲染，能稳定处理数百 MB 的大文件，阅读合同、论文、手册都毫无压力。

该查看器在清单中被标注为pdf-preview，特性包含paginated（分页）、zoomable（可缩放）、scrollable（可滚动），定义位于 presetViewerManifest.json。

3D 预览：在编辑器里直接看模型

需要查看 3D 模型时，PuppyOne 通过插件化的Viewer Pack机制提供支持。开箱即用的 GLB Viewer Pack 能直接打开.glb文件，并覆盖.gltf、.obj、.stl、.fbx等常见 3D 格式。

这套设计强调安全与隔离：3D 预览只申请「读取当前文件」的最小权限，不联网、不读取无关文件，具体见 viewer-packs/glb/manifest.json。产品、工业设计、游戏资源，在写代码的间隙随手就能瞄一眼。

数据库预览：直接打开 SQLite 与 DuckDB 文件

这是富文件编辑器里相当硬核的一项能力。PuppyOne 能直接打开.sqlite、.sqlite3、.db、.duckdb等数据库文件，无需额外客户端。

它的工程亮点在于「隔离与自愈」：

🔌独立进程：每个数据库会话运行在独立进程中，查询卡死可被单独终止，不会拖垮整个编辑器。
🧱只读安全：预览以只读事务打开，避免误改线上数据。
📊双视图：提供「数据」与「结构（Schema）」两个标签页，既能看表内容，也能看表结构。

支持的引擎定义在 registry.mjs，前端表格界面见 DatabaseViewer.tsx。

快速上手：安装并打开你的第一个文件

PuppyOne 通过命令行全局安装，安装后即可启动：

npm install --global puppyone

puppyone

启动后打开任意文件夹，即可在工作区里双击 Markdown、CSV、PDF、3D 或数据库文件，对应查看器会自动加载。若想贡献或研究源码，可克隆仓库：

git clone https://gitcode.com/gh_mirrors/pu/puppyone

小结

PuppyOne 的富文件编辑器，把「写文档、看数据、读 PDF、瞄模型、查数据库」整合到一处，真正做到打开即用、改完即走。无论你是内容创作者、数据分析师，还是和 AI 智能体协作的开发者，它都能显著减少工具切换成本。建议先从一个 Markdown 文档和一个 CSV 表格开始体验，很快你就会体会到「富文件编辑器」带来的顺畅感。