zeionl博客

返回

Pure Studio 的交互式终端与全局日志界面Pure Studio 的交互式终端与全局日志界面

(本文为AI生成,我是真不会写文章😢)

写博客的人大概都有过这样的时刻:文章不多,但每次发布前都要在编辑器、文件管理器、终端和浏览器之间来回切换。改一个标题、换一张头图、检查一次 frontmatter,动作都不难,重复起来却很消耗注意力。

Pure Studio 就是从这些重复动作里长出来的。它不是要替代编辑器,也不是要重做一套博客系统,而是想把“写完之后、发布之前”的那段路缩短一点。

这篇文章记录的,是这个小工具从想法到可用版本的探索路程:做过什么、推翻过什么、在哪些地方绕了远路,以及最后为什么停在这里。

起点:我不想再记住每一条命令#

本站使用 Astro Pure 搭建,内容以 Markdown 和 frontmatter 的形式保存。这样的结构很自由,但日常管理会遇到几个具体问题:

  • 文章和文档分散在 src/content/blog、src/content/docs 中,新增一篇文章要手动建目录、写头部字段。
  • 头图、封面、社交卡片都属于素材,散落在不同目录里,选择时很难预览。
  • 站点标题、作者、社交链接、页脚、版权协议、二维码这些信息,分别藏在配置文件和组件里。
  • 发布前要打开终端,运行 bun run build,再确认 Git 状态,最后推送。

这些问题单独看都不算麻烦,合在一起就变成了一套需要记忆的流程。于是我开始想:能不能做一个只在本地运行的桌面工作台,把文件操作、预览、配置和 Git 都放在一个窗口里?

第一版:先把高频操作做顺手#

第一版的目标很克制:不做复杂的 CMS,只解决文章管理。

技术选型最后落在 Tauri 2 + Vue 3.5。原因并不复杂:

  • 博客内容就在本地文件系统里,桌面应用可以直接读写,不需要再搭后端。
  • Tauri 的体积和启动速度比 Electron 更适合一个轻量工具。
  • Vue 的组件化方式足够快,适合把文章列表、编辑器、素材库这些界面拆开。

第一版实现了几件基础能力:

  • 扫描工作区中的文章与文档,读取 frontmatter 和目录结构。
  • 新建、编辑、重命名、删除文章;删除时先放进回收站,而不是直接销毁。
  • 按 Astro Pure 的 schema 生成 frontmatter 表单,避免手写 YAML 时漏字段。
  • Markdown 编辑、工具栏和实时预览。
  • 媒体库预览图片,并支持把图片插入文章。

这一步之后,我已经可以在 Studio 里完成大部分写作动作。但它仍然只是一个“文章管理器”,离“工作台”还有距离。

真正的转折:从文章配置到全站信息#

第一版之后,我开始反复修改站点信息。标题、作者、简介、头像、社交链接,这些字段在 site.config.ts 里;页脚版权、文章底部的协议声明、二维码文案,又在别的地方。

于是第二阶段的重点变成了:让所有和站点内容有关的信息都能在 Studio 里编辑,并且真的写回博客工程。

这个目标听起来简单,实际踩了几个坑:

1. 配置文件不能只靠正则修改#

最初想过直接用字符串替换 site.config.ts。但配置里有嵌套对象、数组、注释和默认值,简单替换很容易把文件改坏。

最后的做法是同时维护两类文件:

  • 保留 site.config.ts 的默认导出,用它保存标题、作者、描述、语言、头像、社交链接等站点信息。
  • 生成独立的 src/site-content.ts,保存页脚、版权协议、文末声明和二维码设置;页面组件从它读取内容。

这样,站点配置仍然是一份可读的源码文件,文本内容也有了自己清晰的边界。

2. 小改动会牵动整条数据链#

“把二维码加到文章底部”看起来只是加一个组件,实际上牵动了:

  • Studio 的数据结构与 Rust 序列化。
  • 博客端 Copyright.astro 的渲染。
  • 二维码的本地生成,避免运行时依赖外部 CDN。
  • 旧配置的兼容:没有新字段时不能报错,也不能把旧数据覆盖成空值。

我最后的处理方式是:所有新增字段都给默认值,读取时做兼容,保存时只写非破坏性的内容。这套做法后来也用在了终端和 Git 功能上。

3. 默认值要和用户的真实内容对齐#

“示例值”很容易变成“看起来很合理,但不是我想要的内容”。所以在第一次打开工作区时,Studio 会优先读取现有配置;只有在字段确实缺失时才使用默认值。

此时,页面顶部、页脚、文章底部和二维码都能在 Studio 里调整。对一个个人博客来说,这种“所见即所得”的配置体验比多十个高级功能更有价值。

继续扩展:素材库、Git 和终端#

当文章和站点信息都能管理之后,剩下的重复劳动集中在两个地方:素材和发布。

素材库:不只接受图片#

最早只支持 png、jpg、webp 这类图片。后来发现,文章里也会放视频、音频、PDF,甚至字体文件。于是素材库扩展成按类型识别:

  • 图片:png、jpg、jpeg、webp、gif、avif、svg、bmp、ico、tif、tiff。
  • 视频:mp4、webm、mov、m4v、ogv。
  • 音频:mp3、wav、ogg、m4a、flac、aac。
  • 文档:pdf、txt、json。
  • 字体:woff、woff2、ttf、otf。

前端增加了“全部 / 图片 / 视频 / 音频 / 文档 / 字体”筛选,视频和音频可以直接预览,其他类型则显示格式信息和文件入口。这样素材库不再只是“图片库”,而是整个内容的资源池。

Git:不重新发明 Git#

发布前最常做的是查看改动、暂存、提交、推送。与其做一个复杂的 Git 客户端,不如把最常用的动作做得足够稳:

  • 显示当前分支、远程、领先/落后提交数。
  • 查看已暂存、未暂存和未跟踪文件。
  • 逐文件暂存或取消暂存。
  • 填写提交说明并提交。
  • 拉取使用 --ff-only,推送不做强制覆盖。
  • 只显示远程名称,不在界面里暴露凭据。

这个功能坚持了一个边界:Git 的复杂操作仍然交给 Git。分支切换、冲突合并、重写历史不在 Studio 的第一版范围内。工具应该减少日常摩擦,而不是把所有可能性都塞进界面。

终端:从“执行一条命令”到真正的 PTY#

终端功能经历了最大的一次返工。

第一版做的是一个“命令执行器”:输入一条命令,执行,显示输出。它足够用来跑 bun run build,但不是真正的终端:没有交互,不能运行需要持续输入的程序,也看不到实时进度。

后来我把它换成了 xterm.js + portable-pty:

  • Rust 侧启动本地 PTY,Windows 使用 PowerShell,其他平台使用 $SHELL。
  • 前端用 xterm.js 渲染终端,输入直接写入 PTY,输出轮询读取。
  • 支持调整窗口尺寸、复制、粘贴、清屏和重新连接。
  • 全局日志不再绑定某一个工作区,而是写在应用配置目录的 logs/terminal.log。
  • 每次打开终端,日志里会追加一个会话块,记录时间、工作区和 Shell。

这个改动让“终端”终于可以运行交互式命令,而不是只能当作一个漂亮的命令回显框。

探索中真正花时间的部分#

从功能列表看,这个项目像是在不断加模块;实际开发中,大部分时间花在“让模块之间的边界清楚”上。

自研构建链#

Studio 没有使用 Vite,而是维护了一套 Rollup 插件来编译 Vue SFC 和 TypeScript。这样做的好处是依赖少、构建过程完全可控;代价是每引入一种资源都要自己处理。

xterm 的 CSS 就是一个例子:Rollup 不认识从包内直接 import 的样式,最后把 CSS 复制到 src/styles/xterm.css,并加入全局样式合并流程。类似的小问题还有路径解析、SFC scoped CSS 和开发时的热更新。

权限与目录边界#

桌面应用和网页最大的区别之一,是它真的能碰到文件系统。所以每个用户路径都要经过工作区边界校验,拒绝绝对路径、.. 和内部配置目录;Git 操作只允许用户显式选择的路径;终端的日志和临时数据放在应用配置目录,而不是污染博客仓库。

这套边界在开发时经常显得“麻烦”,但它决定了工具能不能长期安全使用。

测试要覆盖真实工作区#

单元测试能验证解析、序列化、路径校验和 Git 状态解析;但“打开真实博客、改一篇文章、看页面是否正常”是另一回事。

所以除了 Rust 测试和前端类型检查,我还保留了离线的 SSR 冒烟测试,以及针对真实工作区的桌面验证。很多问题——例如某个按钮的布局、终端焦点、日志滚动——只有在真正打开窗口之后才暴露出来。

为什么停在这个版本#

Pure Studio 现在可以完成一条完整的日常路径:

  1. 打开博客工作区。
  2. 写文章或文档,编辑 frontmatter,插入素材。
  3. 在站点设置里调整页脚、版权和二维码。
  4. 到 Git 页查看改动、暂存并提交。
  5. 打开终端,运行构建命令,确认结果。
  6. 推送,等待部署。

它仍然不是万能的:没有内置图片压缩,没有完整的 Git 分支管理,没有主题市场,也没有跨平台打包验证。但这些都是“可以以后做”的事,而不是“现在不能用”的阻塞。

写在最后#

这个项目最初的动机只是少切几次窗口。做着做着,它变成了一次关于桌面工具边界的练习:哪些事情应该自动化,哪些事情应该保留给用户;哪些信息应该写进配置文件,哪些应该放在应用状态里;什么时候该自己实现,什么时候该把问题交还给 Git、Shell 和编辑器。

Pure Studio 的源码已经放在 GitHub ↗,使用 MPL-2.0 许可证。更具体的使用方式和开发说明见 Pure Studio 文档。

如果它能让下一次发布少一点重复劳动,这个探索就算有了意义。

(我说实话,对于我这个靠AI生成文章的搞这个貌似没什么必要)

从重复劳动到工作台:Pure Studio 的探索路程
https://zeionl.cn/blog/pure-studio
作者 zeionl
发布于 2026年10月18日

扫码阅读本文

也可以把二维码分享给朋友。

本文版权归 zeionl 所有,未经许可请勿转载。