Sunqy 文档库

主题

doc ​

个人技术知识库。按「域 → 专题 → 内容类别」组织，用于系统性学习与工作查阅。

已建成：前端 28 篇 · Flutter 44 篇 · AI 23 篇（正文 14 + 附录 1 + 实操 8）· 后端 23 篇 · 数据库 11 篇 · 网络 12 篇 · 通用基本功 5 篇 · 运维 DevOps 8 篇 · 安全 7 篇 · 工程方法论 7 篇 · 产品与设计 6 篇 · 速查 13 · 踩坑 6 · 面试 11 类（共 204 篇）；全部计划域已建成，候选池清空 — 见 PLAN.md。

目录速览 ​

doc/
├── docs/                项目自身的文档（非知识内容）
│   ├── GUIDE.md         使用与写作规范（唯一权威）
│   ├── PLAN.md          内容总计划
│   ├── PROGRESS.md      进度日志
│   ├── AUDIT.md         体检报告（一致性检查 + 分类缺口分析，建议每季度跑一次）
│   ├── deploy.md        部署说明
│   └── plan/            各类别计划：frontend / flutter / ai / backend / network / security / database / interview
├── pages/               知识内容（内容文档）
│   ├── frontend/        A · 前端
│   ├── flutter/         B · Flutter · 移动端
│   ├── AI/              G · AI
│   ├── basic/           E · 通用基本功
│   ├── backend/         C · 后端（已建 23 篇）
│   ├── devops/          D · 运维 DevOps（已建 8 篇）
│   ├── methodology/     F · 工程方法论（已建 7 篇）
│   ├── product/         H · 产品与设计（已建 6 篇）
│   ├── database/        DB · 数据库与存储（已建 11 篇）
│   ├── network/         N · 网络与通信（已建 12 篇）
│   ├── security/        S · 安全（已建 7 篇）
│   ├── cheatsheets/     速查区（横切形态区）
│   ├── troubleshooting/ 踩坑区（横切形态区）
│   └── interview/       面试题区（横切形态区，聚合入口）
├── README.md
└── index.md             站点首页

两层区分：docs/ 装的是关于这个库的文档（怎么维护、写了什么、怎么部署）； pages/ 装的是学到的知识（内容文档）。

从哪开始 ​

你要做什么去哪
看这个库有哪些内容、分别写了没PLAN.md — 域清单 + 候选池，各类别计划在 docs/plan/
写新文档 / 了解规范GUIDE.md — 项目怎么用 + 文档怎么写（唯一权威）
看最近做了什么PROGRESS.md — 倒序进度日志
部署站点deploy.md

现有内容 ​

域目录类别计划说明
A · 前端frontend/plan/frontend.mdReact/Vue/TS 与浏览器体系，28 篇（规划内已全部完成）
B · Flutter · 移动端flutter/plan/flutter.mdHaierEnergy 项目体系化教程，44 篇
G · AIAI/plan/ai.md知识正文 14 篇 + 实操 8 篇 + 速查附录
E · 通用基本功basic/plan/basic.md跨语言长效基础，5 篇：Python 迁移 / 工程化 / 异步并发 / 算法 / 设计模式
速查区cheatsheets/—13 篇：Flutter / Dart / Git / Shell / 正则 / Riverpod / GoRouter / Freezed / Flutter CLI / TypeScript / Python / SQL / Docker
踩坑区troubleshooting/—6 篇：构建打包 / 运行时 / 原生真机 / 工具链 / 前端 / AI
面试题区interview/plan/interview.md聚合入口：按分类链各域文章 + 少量内联。12 类已全部交付（前端 / Flutter / AI / 算法 / 场景题 / 软技能 / 网络 / 计算机基础 / 后端 / 安全 / 数据库）+ 总览
C · 后端backend/plan/backend.md23 篇（C00~C22）：全景 / 运行时 / API / 鉴权 / 语言上手 / 架构 / 异步 / AI 服务端落地全系列
D · 运维 DevOpsdevops/plan/devops.md8 篇（D01~D08）：Docker / CI/CD / 镜像优化 / Linux / 可观测性 / K8s / 云成本 / 故障演练（前端视角，纵深于 C17）
F · 工程方法论methodology/plan/f.md7 篇（F01~F07）：全景 / 需求拆解 / 方案写作 / 技术选型 / 调试 / Code Review / 性能优化（跨域通用方法论）
H · 产品与设计product/plan/h.md6 篇（H01~H06）：全景 / 产品思维 / UI·UX / 设计稿还原 / 可访问性 / 埋点与数据（研发上游语境）
N · 网络与通信network/plan/network.md12 篇（N01~N12）：分层 / TCP / DNS / HTTP/HTTPS / TLS / Cookie / WebSocket / gRPC / 代理网关 / CDN / 抓包 / IO 模型
S · 安全security/plan/security.md7 篇（S01~S07）：Web 应用安全 / 认证授权 / 密码学 / TLS 实践 / 合规 / 运维安全 / 供应链
DB · 数据库与存储database/plan/database.md11 篇（DB01~DB11）：关系模型 / 索引 / 事务 / Schema / 缓存 / NoSQL / 分片 / 搜索 / 迁移 / 向量检索

各域的详细篇目与待写清单，见对应的 docs/plan/<域>.md。 后端、数据库、通用基本功三个域均于 2026-10-01 开域（此前目录不存在）。 后端、数据库、网络、安全、运维 DevOps 均已建成；工程方法论（F）与产品与设计（H）已于 2026-10-14 开域并各补齐 7 / 6 篇建成，全部计划域至此完成，候选池清空。

规范 ​

全部规范集中在 GUIDE.md，包括：文件命名、目录与编号、frontmatter、文章骨架、写作原则、状态与优先级定义、新增域流程、给 AI 助手的指令。

新增一篇文档的 5 步流程见 GUIDE.md 第一节。

本站即知识库站点（VitePress） ​

源码在 Gitee（dev 开发 / master 稳定），页面由 Cloudflare Pages 托管。多端可访问、带全文搜索。

项值
生产地址https://sunqy-doc.pages.dev
构建产物.vitepress/dist（由 wrangler 直传，不走 Git 分支）
本地预览npm run docs:dev → http://localhost:5173/

⚠️ main 分支（早期 Gitee Pages 用的产物分支）已废弃，可忽略或删除。

提交 ≠ 部署。 日常只提交源码；部署需先本地验证通过，再手动执行 npm run deploy。 完整命令与说明见 GUIDE.md 与 deploy.md。

最后更新: