返回版本档案

Released

v0.0.1

个人主站的首个本地可用预览版,包含公开内容站、私人学习工作台与数据恢复闭环。

目录

v0.0.1 预览版

发布日期:2026-09-13。

本版目标

完成一个可长期演进的本地主站起点:公开展示项目、博客、知识笔记、资源和版本记录,同时用仅限本机的私人工作台管理学习路线、任务与复盘。需求基线见需求规格。

实际交付

  • 使用 Nuxt 4、Vue 3 和 TypeScript 实现首页、项目、博客、笔记、资源、关于、版本档案、中文搜索和 404 页面。
  • 公开内容使用 Markdown 和结构化 JSON 管理;项目、文章、笔记及资源均使用稳定 ID,示例内容显式标注。
  • 私人工作台支持路线、阶段、任务、内容关联、资源与成果链接、完成/撤销、归档/恢复及复盘编辑。
  • 工作台使用 Drizzle ORM 与 Node 24 内置 SQLite;种子只初始化一次,默认任务全部未完成,用户修改不会被启动流程覆盖。
  • 数据页支持版本化 JSON 导出、10 MiB 输入限制、结构与关联校验、恢复前原子备份及事务恢复。
  • 工作台页面和接口仅允许回环地址访问;写请求校验同源 Origin 与 JSON Content-Type。私人数据、备份、草稿和密钥不进入 Git 或公开构建。
  • 提供独立 Node 24 启动脚本、固定依赖锁文件、统一检查命令、内容与文档检查器、初始数据库迁移和维护说明。
  • 设计阶段已完成 27 张生成图、17 张入选参考、25 个 Ardot 正式画板、11 个组件、36 个变量,以及覆盖 17 个入口和 7 条流程的本地可点击原型。

交付与验收矩阵

需求实际交付状态证据
DESIGN-01生成图、提示词、哈希与选择记录已交付设计方向
DESIGN-02Ardot 可编辑画板与本地可点击原型已交付Ardot 原型、点击原型
DESIGN-03桌面、小笔记本和手机实际应用核验已通过应用证据
PUB-01—PUB-07首页、项目、博客、笔记、资源、关于和版本档案已交付Chrome E2E 与正式预览测试
PUB-08中文公开内容搜索与类型过滤已交付Chrome E2E
PUB-09—PUB-10键盘焦点、跳转链接、状态页面与集中站点配置已交付Chrome E2E、类型检查
LEARN-01—LEARN-04总览、路线、阶段、任务、关联与复盘已交付Chrome E2E、数据库集成测试
LEARN-05刷新和进程重启后的真实持久化已通过数据库集成测试、Chrome E2E
DATA-01导出、校验、备份、恢复与失败保护已通过数据库集成测试、Chrome E2E
DATA-02私人数据、草稿、备份和公开构建隔离已通过隐私构建检查、Chrome E2E
DATA-03稳定 ID、重复项、固定链接和内部关联检查已交付内容检查器
ENG-01可复现安装、开发、构建与正式预览已通过锁文件、Node 24 入口、统一检查
ENG-02维护文档、版本记录、ADR 与统一质量检查已交付维护指南、CHANGELOG、ADR-0001—0004

测试与证据

  • 5 个单元测试通过,覆盖输入模式与本地访问判定。
  • 4 个数据库集成测试通过,覆盖种子保护、进程重启持久化、导出恢复往返、备份写入失败和事务回滚。
  • 11 个 Chrome E2E 场景通过,覆盖公开筛选与搜索、阅读复制、键盘入口、任务失败保留输入、关联跳转、复盘、状态切换、路线阶段任务创建、恢复和本地请求边界。
  • Nuxt 正式构建、公开产物隐私扫描和 1 个正式预览浏览器场景通过;正式预览验证页面 hydration、搜索和工作台 API。
  • 1440×900、1366×768 和 390×844 的 4 张实际应用截图均返回 HTTP 200,横向溢出为 0,console error 与 page error 为 0。见结构化结果。

统一检查命令为 ./run-node24.ps1 check。本档案只记录已经执行的结果。

数据迁移与回退

初始数据库迁移为 drizzle/0000_initial.sql,同一 SQL 编译进 Nitro 服务端包,文档检查会拒绝两个副本不一致。首次启动在 .data/workspace.sqlite 创建数据并仅执行一次种子初始化。

升级或回退前,先从工作台数据页导出 JSON。代码可从 Git 标签 v0.0.1 恢复;私人数据库不在 Git 中,需使用导出文件或 backups/ 中的恢复前备份还原。恢复会先校验完整数据,再在单一事务中替换现有记录;失败保持原数据不变。

当前限制

  • 本版本仅供本机使用,没有账号与线上授权机制;不得把 /workspace 直接暴露到公网。
  • 未实现 AI 对话、Agent 运行器、云端同步、在线 Markdown 编辑器、自动定时备份或 GCP 部署。
  • Drizzle ORM 当前使用 1.0.0 RC;升级前需要重新运行数据库集成测试和恢复演练。
  • 工作台依赖 Node 24 的内置 SQLite,Nuxt Content 的内部索引另使用固定版本的 better-sqlite3;边界见 ADR-0004。
  • 仓库中的项目、文章与笔记包含明确标记的示例内容,需要由站主逐步替换为真实资料。