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-02 | Ardot 可编辑画板与本地可点击原型 | 已交付 | 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。 - 仓库中的项目、文章与笔记包含明确标记的示例内容,需要由站主逐步替换为真实资料。