返回项目

开发中

MBlogs

个人门户、公开内容与本地学习工作台。

2026.09.13Nuxt 4 / Vue 3 / TypeScript / SQLite
目录

背景

MBlogs 用于集中维护项目、博客、知识笔记、资源、版本记录和个人学习进度。公开内容需要跟随仓库迁移,私人任务与复盘不能进入公开索引或客户端产物。

职责

  • 需求拆分、交互原型与视觉系统
  • Nuxt 4、Vue 3 与 TypeScript 前端实现
  • 本地工作台、SQLite 持久化和恢复流程
  • 测试矩阵、版本记录与架构决策

约束

  • 公开内容与私人数据采用不同存储边界
  • 本地工作台只允许回环地址和同源写请求
  • 稳定 ID 维持项目、文章、笔记和学习任务之间的关联
  • 每个发布版本都要提供实际交付、验收证据和回退说明

过程

首版先完成需求、分区生成图、Ardot 可编辑原型和本地可点击原型,再进入应用实现。设计内容只使用真实项目、界面、版本和测试记录,不使用虚构 KPI 或自我评分。

架构

公开内容使用 Markdown 与结构化文件,私人学习数据使用 SQLite。Nuxt Content 索引是可以从公开文件重建的发布索引,不具备私人任务需要的事务、关联约束和独立备份能力,因此不能用来保存工作台任务。页面通过服务层访问工作台数据;备份恢复先执行完整校验,再在事务中替换数据。公开内容查询逐步下沉到 Nitro API,避免阅读路由携带内容数据库客户端。

已交付结果

  • 公开项目、博客、笔记、资源和版本档案
  • 仅限本机的学习路线、任务、复盘与数据恢复
  • 版本文档、变更日志和架构决策记录
  • 公开构建隐私扫描、数据库往返恢复测试和浏览器验收
  • 可观察 RAG 实验台、公开案例、固定评测和脱敏模型验收

证据

反思

本地工作台与公开内容分离后,v0.2.0 继续把同一边界用于 RAG:Python 只消费公开 DTO,生产站只发布归档证据。Agent 仍保持计划状态,等工具失败、人工确认和回放边界完成后再交付。

关联内容