纸墨档案 · 编选版

2026-09-06。保留 Astro、静态托管、纸墨配色和原有内容，更新整站阅读路径。

已落地

• 首页：紧凑自述、卷首文章、真实摄影、混合最近记录、兴趣片段、往年入口。
• 导航：手机单行页眉，全站菜单、常驻搜索、系统 / 日光 / 夜读主题。键盘可展开菜单并用 Escape 关闭。
• 兴趣：真实封面与短评，美食显示较大照片，音乐使用方形封面，可选填收听地址。空栏目不再展示维护说明。
• 文章：渲染器生成的目录锚点、章节高亮、手机折叠目录、代码语言和复制反馈、横向表格、本机阅读进度、正文图片放大、关联记录、相关长文和 RSS 出口。
• 档案：独立年度总入口，每年按实际日期整理文字与生活片段，每条记录都有准确链接与计数。
• 搜索：按文章、收藏、闪念、此间建立独立记录，分类筛选、日期和摘要、URL 保存查询、加载失败重试与无结果出口。导航、侧栏和小工具不进入搜索。
• 数据：行情按自选股、指数和板块分别标注保存时间，已有失败状态及超过 72 小时的记录均明确提示。72 小时只是数据年龄提示，不推断交易日或行情是否收盘。
• 兼容：保留旧闪念日期锚点；新链接与 RSS 使用记录 ID 区分同日不同条目。生产站统一使用域名根路径。

作者可以填写的地方

卷首

src/data/editorial.json 的 openingEssay 是手动置顶的文章 ID，首页与博客共用，与发布日期无关。Studio 的“首页设置”提供公开文章选择器。openingNote 可留空，noteKind 区分摘句与编者按。取消置顶后首页显示“最近文章”，不会把最新文章称为卷首；博客按时间列出全部文章。

想法如何长成文章

同文件的 thoughtLinks 只接受真实关联：

{ spark: '闪念 ID', essay: '文章 ID', note: '简短、真实的关联说明' }

配置后两端会互相链接；构建检查这两条内容存在且公开。当前没有替作者填写这些关系，也没有自动生成年度感想。

补记与收听

文章支持可选 updatedDate、updateNote；收藏支持可选 url（完整收听或来源地址）。Studio 已同步提供这些字段。补记日期不会自动填入今天；从收藏编辑关联长文时保留原有补记与标签。

内容仍保存在原来的 Markdown 集合中，不需要更换写作方式。食物可以只有照片和两句话，不强制写成长食谱。

数据来源的边界

本次解决的是旧数据误导和失败状态的呈现，没有更换行情供应商，也没有修复上游可用性。稳定抓取和多来源切换仍需单独实现、验证数据口径与日期，不能把一次页面构建成功当作行情更新成功。

验证

• npm run check
• npm run build
• npm test（含 tests/editorial.mjs 跨页回归）
• npm run test:visual（桌面 / 手机，亮色 / 暗色）
• 以 SITE_URL=https://www.doyouhang.live SITE_BASE=/ 构建并执行浏览器回归。

macOS 默认使用 Microsoft Edge；非标准安装位置设置 BROWSER_PATH='/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge'。默认 4321 端口占用时，设置 SMOKE_PORT=4351。