1 概览

• 接着 8 月 9 日的上次介绍，看看 bensz-notes 从 v2.0.5 到 v2.1.10 的 14 次版本更新，给日常使用带来了什么。
• 笔记支持置顶，自己的常用资料和公开主页的阅读入口，都可以由作者安排。
• 中文排版、标题层级和手机阅读进一步打磨；复杂图表可以全屏放大，读起来更舒服。
• 控制台切换更连贯，导航记得你的折叠习惯，站点品牌在不同页面也保持一致。
• 更新流程补上自动检查，让这些已经打磨好的体验，在后续迭代中更有机会被保留下来。

2 前言

8 月 9 日，我在这里写过一篇《bensz-notes v2：从共同工作台，到可长期托付的笔记空间》。那次聊得比较多的是用户空间、管理边界、订阅体系和访问保护。当时的版本是 v2.0.5，产品已经把长期使用需要的基本秩序搭了起来。

这次继续往后看。当前仓库最新提交对应 v2.1.10，最后一次版本更新在 8 月 26 日。从上次介绍到这里，一共又走过了 14 次版本更新。

翻一遍这些记录，会发现一个挺有意思的变化：开发的注意力越来越多地落在每天都会遇到的小动作上。找一篇常用笔记、从后台切到另一个页面、在手机上读一段中文、看清一张很大的流程图……这些事情单独拿出来，好像都不值得开一场发布会，但它们累积起来，能明显影响一个人愿不愿意长期把资料放在这里。

这轮进步，我最看重的是日常体验的完整度：重要内容有了位置，阅读更清楚，操作也更连贯。 今天就从这些实际感受聊起，小伙伴们不用先补一堆技术名词，哈哈。

3 重要的笔记，可以有一个固定的位置

笔记多起来以后，我们通常会遇到两种需求：看看最近写了什么，以及随时找到那几篇最重要的内容。

上次介绍时，列表主要跟着更新时间走。这个逻辑适合追踪进展，但一份经常查阅的工作手册、一篇项目总览，或者给新读者准备的入门说明，未必需要天天修改。只要继续写新笔记，它们就会慢慢往下沉。

v2.1.0 加入了笔记置顶。现在可以把常用内容固定在前面，置顶区内部仍按更新时间排列，其余笔记继续按原来的更新顺序展示。这项安排同时作用于内部笔记列表和公开列表，也支持由有写入权限的 AI 协作者操作。

对自己来说，它意味着常用资料更容易找到。对公开分享来说，它还多了一层价值：作者终于可以安排读者进入这个空间的第一站。比如把“从这里开始”置顶，再在里面串起几个专题，公开主页就能形成一个清楚的阅读入口。

我挺喜欢这类功能。它没有要求你重新学习一套复杂的知识管理方法，却给了内容明确的轻重缓急。最近更新的内容有时间顺序，值得长期阅读的内容也有自己的位置。

4 一篇认真写的长文，值得被认真地呈现

bensz-notes 一直保留着一个我很在意的方向：Markdown 写好以后，可以直接成为一篇能分享给别人阅读的网页。因此，公开阅读页的质量，本身就是产品质量的一部分。

这次对长文的照顾更细了。标题从一级到六级重新建立了清楚的字号层级，直接相邻的父子标题减少了不必要的留白。读者扫一眼，就更容易知道自己正在读哪一层内容。手机上的长链接和行内代码也调整了换行方式，尽量保持词语完整；图片则改为居中呈现，让图文之间的秩序更统一。

还有一个写中文的小伙伴可能很有共鸣的问题：加粗内容以中文冒号、引号或破折号收尾，后面紧接正文时，以前有些写法会露出星号，没能正确加粗。v2.1.3 和 v2.1.7 分别补上了相关兼容。

比如“**注意事项：**后面接着说明”，这是再自然不过的中文表达。现在这类文字可以按预期呈现，写作者不用为了排版去迁就标点。

这些改动的价值，会随着文章变长而放大。短笔记里，一个标题或一次换行不太显眼；到了研究梳理、操作手册和专题文章，层级是否清楚、强调是否有效、手机上是否容易阅读，就直接影响信息能不能被读懂。

从写作者手里的 Markdown，到读者眼前的页面，这条路变得更顺了。 对一个同时承担记录和分享的笔记应用来说，这是很实在的进步。

5 复杂的图，终于可以慢慢看清楚

上次介绍时，bensz-notes 已经支持 Mermaid 图表，也已经具备原始尺寸和全屏查看。这轮更新继续把“看图”这件事做完整。

先是修复了公开短链接导航和 Safari 刷新时的图表问题：有些情况下，图表会停在加载状态，或者刚显示出来又闪回源码。对于读者来说，这种来回变化很打断思路。v2.0.7 和 v2.0.8 对这些具体场景做了处理，让图表的展示更稳定。

接着，v2.1.4 给全屏查看器加入了 50%—300% 的缩放。可以用工具栏缩小、放大，也可以在全屏中按住 Ctrl 或 ⌘ 配合滚轮调整。

想象一下，一篇研究笔记里有一张分支很多的流程图。你先看整体关系，再放大其中一段，读清节点和连线上的文字，最后回到全局继续理解。现在这几个动作可以在阅读页面里完成。

这对我想做的笔记产品很重要。资料里有些信息适合用文字讲，有些关系用图表达更清楚；当图逐渐复杂，阅读工具也应该跟得上。能放进笔记的内容，应该尽量让读者看得清。

顺带一提，公开文章里的标签和主题搜索也修复了短链接下“明明有内容，却提示没有匹配项”的问题。读到感兴趣的主题，可以继续沿着它找下去，阅读路径也更连贯了。

6 工作台开始记得你的节奏

上次的 v2 已经整理过侧栏、账户入口和页面过渡。这一轮又往前推进了一步：把连续操作时的体验真正接起来。

v2.1.5 和 v2.1.6 对控制台导航做了集中优化。鼠标在目标入口稳定停留，或通过键盘聚焦时，系统会提前准备相关内容；快速扫过菜单，则尽量避免触发无用的加载。最近访问过的页面可以先恢复已有内容，再在后台更新。原来点击后的一段固定等待也被移除了。

对用户而言，最值得关心的是：在笔记工作台的相关页面之间切换时，编辑器、侧栏和当前空间的状态可以被保留；浏览器前进、后退仍然可用，未保存的修改也继续有确认提醒。如果局部请求失败，有些页面还能保留已经展示的内容，给你留住上下文。

这类体验适合放在一个很普通的使用场景里理解：你正在整理笔记，中途查看一下使用记录，再回到工作台继续写。你希望这几步顺手完成，也希望回来的时候，仍然认得刚才那个界面。

导航本身也更体贴了。管理员区和用户区的折叠状态会在切换后保留，分组标题的层级更清楚。桌面端重复的账户入口被收拢，小屏幕仍然保留必要入口。站点名称和自定义 Logo 在仪表盘、工作台、设置页之间保持同步，尺寸与展示方式也统一了。

页面的熟悉感来自这些细节：常用位置稳定，自己的选择被记住，切换时少一些突然变化。对于一个每天要打开很多次的工作台，这种熟悉感很有分量。

7 打磨好的体验，也需要留得住

还有一项进展，用户可能不会在界面上直接看见：v2.1.9 补上了更系统的自动检查，包括关键行为测试，以及两类浏览器环境下的阅读页回归检查。

这里不展开测试工具和工程原理。它的产品意义其实很好理解：一处刚刚修好的排版、一条已经顺手的导航，后面的更新需要继续照顾到。新功能往前走，已有体验也要有人看着。

自动检查当然不能保证所有环境都没有问题，但它能让一部分重复出现的缺陷更早被发现。前面那些看图、阅读和操作的改进，也因此多了一层持续维护的支撑。

我对“成熟”的理解一直很朴素：用户逐渐建立起来的使用习惯，应该受到后续更新的尊重。 这轮开发开始更认真地为这件事做准备。

8 小结

从上次的 v2.0.5 到当前提交的 v2.1.10，bensz-notes 的进步集中在日常使用的完整度上：置顶让常用资料和公开入口有了位置，中文排版与图表缩放让长文更容易读懂，控制台则逐步保留用户的操作状态和导航习惯。自动检查也开始帮助这些成果在后续更新中延续。我仍然希望它是一款轻量的 Markdown 笔记应用，让人和 AI 一起整理资料，再把值得分享的内容清楚地交给读者。这一轮更新，把这条路径上的许多小阻碍逐一清理了。它们累积起来，就是我眼中最实在的产品进步。