先说结论 #

写作现在分成两条路:手机管速记,电脑管精修。手机上打开就能写,写下的东西先当碎片存着,攒够了整理成文章发出去;电脑上打开管理台,像填表一样改标题、日期、标签,正文用编辑器写,存一下就生效,改完 push 就上线。Markdown 文件还在,但你已经不太需要直接面对它了。

手机上:打开就写 #

入口没变,还是 /write/。但现在进去第一眼就是一个输入框,没有别的。

  • 写就行:停手 1.5 秒自动保存,右下角显示「已保存到云端」。标题、日期这些都不用管,碎片不需要它们。
  • #标签:随手打 #灵感 这样的标记,空格之后自动变成高亮,之后整理成文章时会自动挑出来当标签。
  • 图片:点「图片」拍照或选图,会自动压缩后上传,插进文字里。直接把图粘贴进编辑器也行。
  • 断网也能写:没信号时文字先存手机本机、图片存本地数据库,恢复网络自动补传,不用管。所以地铁里、飞机上尽管写。
  • 整理成文章:碎片攒够了,点「选择」勾上几条,按「整理成文章」,它们会按时间顺序拼成正文,补个标题和摘要就能发布。发布就是提交到 GitHub,几分钟后自动上线。

草稿存在「草稿」标签页里,没发出去的都在那。旧文章的修改不在手机上做了——改文章去电脑,手机只负责抓住念头。

电脑上:不再手写 md #

npm run dev

然后打开 http://localhost:4321/keystatic。这就是新的日记管理台(基于开源的 Keystatic):

  • 左边是文章列表,点进去全是表单:标题、日期、摘要、前言、标签、封面、草稿开关,不用再对着 YAML 缩进。
  • 正文是编辑器:Markdown 语法高亮,[[双链]] 和 ==高亮== 会着色,可以随时切预览看真实效果。
  • 图片直接拖进来或粘贴,自动存进 public/images/notes/ 并插好引用(这一步需要同时开着工具台,见下)。
  • 改「地址」就是改文件名:以前改 slug 要手动改文件名怕改坏,现在改个输入框就行。
  • 保存直接写本地文件,右边 localhost:4321 刷新就能看到效果。改完 git push,发布流程和以前一样。

手机发过的文章带着一个「发布标记」字段,管理台会原样保留它,不会弄丢。

工具台:npm run dev:admin #

一条命令同时起站点和本机工具台(http://127.0.0.1:4322),也可以只跑 npm run admin:

  • 云端碎片:在电脑上也能看手机记的碎片,勾选整理成文章(需要在 .env 里配 Cloudflare 的 D1 令牌,README 有写)。
  • 标签管理:看所有标签的分布,一键批量改名。
  • 图片库:浏览 public/images/ 里的图,点一下复制路径。
  • 构建发布:一键跑 npm run build 看检查结果,还能起预览。

背后的分工 #

说到底就一句话:Markdown 文件还是唯一真身,存在 Git 仓库里。手机记的碎片暂存在云端数据库里(Cloudflare D1,图片在 R2),整理成文章后就汇入正轨;发布永远是 git push,GitHub Actions 构建上线。两条路最后都通向同一个仓库,只是上山的路不同。

还没说完的 #

手机端的断网补传和真机发布还没在手机上完整验收过,发现问题再修。另外这次踩到一个坑记下来:Astro 7 里用函数形式写配置文件会在构建时丢掉 site 配置,整站 canonical 全挂,只能写回对象形式——以后升级要留意。

写作工具的终极目标只有一个:让「写下一句话」这件事的阻力小到可以忽略。希望这次近了一点。