[{"data":1,"prerenderedAt":1675},["ShallowReactive",2],{"blog-taxonomies":3,"blog-stats":507,"post-2026\u002F2026-07-20-关于技术写作-设计文档":1083},[4,11,16,21,25,29,36,39,44,47,52,58,63,66,71,76,80,84,87,93,96,101,105,110,113,117,122,127,132,136,141,143,146,151,155,157,162,165,169,173,176,179,183,186,190,193,197,200,205,208,211,214,219,222,228,234,237,239,245,249,253,256,260,266,271,276,281,283,287,290,293,298,301,304,306,308,311,314,316,318,321,327,332,337,342,347,352,354,356,358,361,365,367,369,371,374,376,378,381,386,390,393,396,400,404,407,411,413,415,417,421,423,425,428,431,433,435,437,439,441,443,446,448,450,454,456,459,461,463,465,467,469,471,473,477,483,486,488,491,493,495,497,499,501,503,505],{"category":5,"tags":6},"笔记",[7,8,9,10],"QQ","插件","LiteLoader","美化",{"category":12,"tags":13},"其他",[14,15,10],"博客","IP签名",{"category":17,"tags":18},"杂谈",[19,20],"互联网","观点",{"category":5,"tags":22},[14,23,24],"GitHub","数据可视化",{"category":5,"tags":26},[14,27,28],"访问统计","不蒜子",{"category":30,"tags":31},"工具",[32,33,34,35],"Python","爬虫","选课脚本","广州大学",{"category":5,"tags":37},[38,5],"数学分析",{"category":40,"tags":41},"算法",[42,40,43],"数据结构","线性表",{"category":40,"tags":45},[42,46],"复习",{"category":5,"tags":48},[49,50,51],"高等代数","线性代数","知识点",{"category":5,"tags":53},[14,54,55,56,57],"Typora","PicGo","图床","Markdown",{"category":30,"tags":59},[60,61,62],"Jupyter","工具配置","中文",{"category":30,"tags":64},[65,61,10],"VSCode",{"category":30,"tags":67},[68,69,70,35],"路由器","OpenWrt","校园网",{"category":12,"tags":72},[73,74,75],"网络协议","Wireshark","DEVP2P",{"category":5,"tags":77},[73,74,78,79],"Lua","解码器",{"category":5,"tags":81},[82,5,83],"常微分方程","数学",{"category":5,"tags":85},[86,5,83],"概率论",{"category":30,"tags":88},[89,90,91,92],"Docker","WSL","Windows","磁盘清理",{"category":30,"tags":94},[32,33,95,35],"课程表",{"category":5,"tags":97},[14,98,99,100],"Hexo","Gitalk","评论系统",{"category":5,"tags":102},[14,103,98,104],"Obsidian","写作工具",{"category":12,"tags":106},[107,108,109],"课题研究","泊松分布","参数估计",{"category":12,"tags":111},[107,108,109,112],"组会",{"category":12,"tags":114},[109,115,108,116],"IM模型","统计学",{"category":17,"tags":118},[119,120,121],"软考","网络规划","信息系统项目管理",{"category":30,"tags":123},[124,125,126],"Arch Linux","AppImage","Linux",{"category":5,"tags":128},[129,130,131],"编程语言","计算机科学","内存管理",{"category":5,"tags":133},[134,135],"Canvas","前端",{"category":5,"tags":137},[14,138,139,140],"GitHub Actions","Vite","部署",{"category":5,"tags":142},[135],{"category":5,"tags":144},[135,145],"系统设计",{"category":5,"tags":147},[135,148,149,150],"安全","XSS","CSRF",{"category":152,"tags":153},"项目",[134,154],"PixiJS",{"category":152,"tags":156},null,{"category":40,"tags":158},[42,159,160,161],"栈","队列","JavaScript",{"category":40,"tags":163},[42,164,161],"哈希表",{"category":5,"tags":166},[167,161,168],"ES6","Set",{"category":40,"tags":170},[40,171,172],"动态规划","背包问题",{"category":40,"tags":174},[40,175],"滑动窗口",{"category":40,"tags":177},[42,178,161],"链表",{"category":40,"tags":180},[40,181,161,182],"ACM","面试",{"category":40,"tags":184},[40,161,185],"数据类型转换",{"category":40,"tags":187},[42,188,178,189],"顺序表","TypeScript",{"category":5,"tags":191},[135,154,134,192],"渲染",{"category":5,"tags":194},[135,195,134,196],"富文本编辑","wangEditor",{"category":40,"tags":198},[199,40,178],"力扣",{"category":5,"tags":201},[202,203,204,91],"DNS","加密","网络安全",{"category":5,"tags":206},[135,207],"Axios",{"category":5,"tags":209},[135,207,189,210],"接口封装",{"category":5,"tags":212},[135,213,145],"JWT",{"category":152,"tags":215},[134,216,217,154,218],"画布","React","项目开发",{"category":17,"tags":220},[221],"日志",{"category":5,"tags":223},[224,225,226,227],"Neo4j","图数据库","中心度分析","PageRank",{"category":12,"tags":229},[230,231,232,233],"论文","机器学习","随机森林","保险欺诈",{"category":5,"tags":235},[236],"人工智能",{"category":5,"tags":238},[231,40,32],{"category":12,"tags":240},[241,242,243,244],"共识算法","最长链","区块链","算法设计",{"category":5,"tags":246},[161,247,248,135],"闭包","作用域",{"category":5,"tags":250},[14,138,251,252],"RSS","自动化",{"category":30,"tags":254},[89,90,91,255],"安装",{"category":30,"tags":257},[258,91,259],"MSYS2","开发环境",{"category":5,"tags":261},[262,263,264,265],"团队协作","Git","Commit规范","代码审查",{"category":30,"tags":267},[268,269,270],"oh-my-posh","终端美化","CLI",{"category":5,"tags":272},[273,274,275],"上下文工程","Agent","RAG",{"category":5,"tags":277},[278,279,280],"前端工程化","技术选型","工程基建",{"category":5,"tags":282},[275],{"category":5,"tags":284},[285,286],"SDD","规格驱动开发",{"category":5,"tags":288},[289],"neovim",{"category":5,"tags":291},[292],"技术写作",{"category":5,"tags":294},[295,32,296,89,297],"FastAPI","后端","工程实践",{"category":152,"tags":299},[274,300],"Harness Engineering",{"category":5,"tags":302},[303],"RFC",{"category":152,"tags":305},[274,300,275],{"category":152,"tags":307},[274],{"category":40,"tags":309},[199,40,161,310],"两数之和",{"category":40,"tags":312},[199,40,161,313],"双指针",{"category":40,"tags":315},[199,40,161,178],{"category":40,"tags":317},[199,40,161,175],{"category":40,"tags":319},[199,40,161,320],"回溯",{"category":5,"tags":322},[323,324,325,326],"分布式处理与计算","Spark","Scala","RDD",{"category":5,"tags":328},[323,329,330,331],"线性回归","逻辑回归","监督学习",{"category":5,"tags":333},[323,334,335,336],"数值优化","牛顿法","收敛性",{"category":5,"tags":338},[323,339,340,341],"PCA","数据降维","正则化",{"category":5,"tags":343},[323,344,345,346],"聚类","层次聚类","K-Means",{"category":5,"tags":348},[323,349,350,351],"随机模拟","统计推断","EM算法",{"category":5,"tags":353},[24],{"category":5,"tags":355},[24],{"category":5,"tags":357},[24],{"category":40,"tags":359},[42,360],"图论",{"category":40,"tags":362},[42,363,364],"树","二叉树",{"category":40,"tags":366},[42,160],{"category":40,"tags":368},[42],{"category":40,"tags":370},[42,159],{"category":40,"tags":372},[42,40,373],"复杂度分析",{"category":40,"tags":375},[42,43,178],{"category":40,"tags":377},[42,43,188],{"category":40,"tags":379},[42,380],"基础概念",{"category":17,"tags":382},[383,384,385],"随记","照片","高中",{"category":17,"tags":387},[383,388,389],"团建","战地",{"category":17,"tags":391},[383,392],"生活",{"category":17,"tags":394},[383,395],"文学",{"category":17,"tags":397},[383,398,399],"SCP","模因",{"category":17,"tags":401},[383,402,403],"画集","艺术",{"category":17,"tags":405},[14,406,383],"写作",{"category":17,"tags":408},[383,409,410],"音乐","摇滚",{"category":17,"tags":412},[383,392],{"category":17,"tags":414},[383,409],{"category":17,"tags":416},[383,35,392],{"category":17,"tags":418},[383,419,420],"同人","手书",{"category":17,"tags":422},[383,392],{"category":17,"tags":424},[383,392],{"category":17,"tags":426},[383,427],"植物",{"category":17,"tags":429},[383,430],"读书",{"category":17,"tags":432},[383,392],{"category":17,"tags":434},[383,392],{"category":17,"tags":436},[383,392],{"category":17,"tags":438},[383,392],{"category":17,"tags":440},[383,392],{"category":17,"tags":442},[383,392],{"category":17,"tags":444},[14,445,383],"一周年",{"category":17,"tags":447},[383,392],{"category":17,"tags":449},[383,392],{"category":17,"tags":451},[35,452,453],"开源组织","SITE-193",{"category":17,"tags":455},[383,392],{"category":17,"tags":457},[383,458],"年末",{"category":17,"tags":460},[383,392],{"category":17,"tags":462},[383,392],{"category":17,"tags":464},[14,17],{"category":17,"tags":466},[383,392],{"category":17,"tags":468},[383,392],{"category":17,"tags":470},[383,392],{"category":17,"tags":472},[383,392],{"category":17,"tags":474},[383,475,476],"游戏","Control",{"category":30,"tags":478},[479,480,481,482],"Quadim","图像处理","四叉树","Rust",{"category":17,"tags":484},[14,485],"上线纪念",{"category":17,"tags":487},[383,395],{"category":30,"tags":489},[203,490],"测试",{"category":17,"tags":492},[383],{"category":17,"tags":494},[383,392],{"category":17,"tags":496},[383],{"category":5,"tags":498},[40],{"category":5,"tags":500},[40],{"category":5,"tags":502},[40],{"category":5,"tags":504},[40],{"category":5,"tags":506},[40],[508,512,516,520,524,528,532,536,540,544,548,552,556,560,564,568,572,576,579,583,587,590,594,598,602,606,610,614,618,622,626,630,634,638,642,646,650,654,658,662,666,670,674,678,682,686,690,694,698,702,706,710,714,718,722,726,730,734,738,742,746,750,754,758,762,766,770,774,778,782,786,790,794,798,801,805,809,813,817,821,825,829,833,837,841,845,849,853,857,861,865,869,873,877,881,885,889,893,897,901,904,907,911,915,919,923,927,930,934,938,942,946,950,954,957,961,965,969,973,977,981,984,988,992,996,1000,1004,1007,1011,1015,1019,1023,1027,1031,1035,1039,1043,1047,1051,1055,1059,1063,1067,1071,1075,1079],{"path":509,"words":510,"published":511,"date":156},"\u002Fposts\u002F2024\u002F2024-06-25-liteloaderqqnt",1296,"2024-06-25 11:03:08",{"path":513,"words":514,"published":515,"date":156},"\u002Fposts\u002F2024\u002F2024-06-26-ip签名",0,"2024-06-26 22:53:53",{"path":517,"words":518,"published":519,"date":156},"\u002Fposts\u002F2024\u002F2024-06-29-何加盐中文互联网正在加速崩塌",4853,"2024-06-29 00:47:13",{"path":521,"words":522,"published":523,"date":156},"\u002Fposts\u002F2024\u002F2024-07-12-github-chart",270,"2024-07-12 20:02:50",{"path":525,"words":526,"published":527,"date":156},"\u002Fposts\u002F2024\u002F2024-07-14-访客数统计",192,"2024-07-24 01:34:28",{"path":529,"words":530,"published":531,"date":156},"\u002Fposts\u002F2024\u002F2024-07-26-广大选课脚本",110,"2024-07-26 01:34:28",{"path":533,"words":534,"published":535,"date":156},"\u002Fposts\u002F2024\u002F2024-07-26-数学分析笔记其二",14,"2024-07-26 23:54:02",{"path":537,"words":538,"published":539,"date":156},"\u002Fposts\u002F2024\u002F2024-07-26-数据结构复习其二",12856,"2024-07-26 02:48:08",{"path":541,"words":542,"published":543,"date":156},"\u002Fposts\u002F2024\u002F2024-07-26-数据结构复习相关",32856,"2024-07-26 02:24:14",{"path":545,"words":546,"published":547,"date":156},"\u002Fposts\u002F2024\u002F2024-07-26-线性代数与空间解析几何知识点全汇总",6110,"2024-07-26 03:27:55",{"path":549,"words":550,"published":551,"date":156},"\u002Fposts\u002F2024\u002F2024-07-31-typora-picgo-兰空图床打造markdown写作环境",311,"2024-07-31 12:56:23",{"path":553,"words":554,"published":555,"date":156},"\u002Fposts\u002F2024\u002F2024-09-02-jupyter配置中文",441,"2024-09-02 23:49:05",{"path":557,"words":558,"published":559,"date":156},"\u002Fposts\u002F2024\u002F2024-09-02-自定义vscode背景图片",100,"2024-09-02 23:39:00",{"path":561,"words":562,"published":563,"date":156},"\u002Fposts\u002F2024\u002F2024-09-03-制作gzhu校园网路由器",1423,"2024-09-03 23:43:18",{"path":565,"words":566,"published":567,"date":156},"\u002Fposts\u002F2024\u002F2024-09-26-09-25-2024",136,"2024-09-26 00:49:26",{"path":569,"words":570,"published":571,"date":156},"\u002Fposts\u002F2024\u002F2024-11-04-创建一个网络包解码器分析devp2p协议",1943,"2024-11-04 16:45:19",{"path":573,"words":574,"published":575,"date":156},"\u002Fposts\u002F2024\u002F2025-03-09-2024一些笔记常微分",16,"2024-12-09 22:51:00",{"path":577,"words":574,"published":578,"date":156},"\u002Fposts\u002F2024\u002F2025-03-09-2024一些笔记概率论","2025-03-09 22:51:00",{"path":580,"words":581,"published":582,"date":156},"\u002Fposts\u002F2025\u002F2025-03-01-windows下释放docker占用的wsl空间",164,"2025-03-01 13:54:15",{"path":584,"words":585,"published":586,"date":156},"\u002Fposts\u002F2025\u002F2025-03-01-爬虫实战-爬取广州大学课程表",774,"2025-03-01 14:55:48",{"path":588,"words":530,"published":589,"date":156},"\u002Fposts\u002F2025\u002F2025-04-03-hexo集成gitalk的问题","2025-04-03 14:26:34",{"path":591,"words":592,"published":593,"date":156},"\u002Fposts\u002F2025\u002F2025-09-22-记一次配置obsidian配合hexo写博客",92,"2025-09-22 16:47:52",{"path":595,"words":596,"published":597,"date":156},"\u002Fposts\u002F2025\u002F2025-10-24-10-20课题",204,"2025-10-24 08:15:01",{"path":599,"words":600,"published":601,"date":156},"\u002Fposts\u002F2025\u002F2025-11-02-组会朝花夕拾",501,"2025-11-02 18:56:59",{"path":603,"words":604,"published":605,"date":156},"\u002Fposts\u002F2025\u002F2025-11-05-基于随机加权推断模型im的参数估计算法",481,"2025-11-05 20:51:41",{"path":607,"words":608,"published":609,"date":156},"\u002Fposts\u002F2025\u002F2025-11-09-关于软考高项网规",884,"2025-11-09 19:54:52",{"path":611,"words":612,"published":613,"date":156},"\u002Fposts\u002F2025\u002F2025-11-17-arch-linux运行appimage相关",365,"2025-11-17 09:59:59",{"path":615,"words":616,"published":617,"date":156},"\u002Fposts\u002F2025\u002F2025-11-19-相关概念",2058,"2025-11-19 11:06:20",{"path":619,"words":620,"published":621,"date":156},"\u002Fposts\u002F2025\u002F2025-11-21-web可视化实践canvas",6393,"2025-11-21 14:50:48",{"path":623,"words":624,"published":625,"date":156},"\u002Fposts\u002F2025\u002F2025-11-22-使用-github-actions-自动部署基于vite的项目到-github-pages",272,"2025-11-23 01:59:24",{"path":627,"words":628,"published":629,"date":156},"\u002Fposts\u002F2025\u002F2025-11-22-关于前端包管理器npmpnpmyarn和bun",4890,"2025-11-22 21:21:15",{"path":631,"words":632,"published":633,"date":156},"\u002Fposts\u002F2025\u002F2025-11-23-undo-redo-机制具体实现",7839,"2025-11-23 19:15:00",{"path":635,"words":636,"published":637,"date":156},"\u002Fposts\u002F2025\u002F2025-11-27-前端安全-关于xss与crsf",1866,"2025-11-28 02:05:25",{"path":639,"words":640,"published":641,"date":156},"\u002Fposts\u002F2025\u002F2025-12-05-现代协同-2d-画布编辑器pixijs-v8",4285,"2025-12-05 02:00:16",{"path":643,"words":644,"published":645,"date":156},"\u002Fposts\u002F2025\u002F2025-12-07-杂谈-课题组系统设计",3710,"2025-12-07 21:09:33",{"path":647,"words":648,"published":649,"date":156},"\u002Fposts\u002F2025\u002F2025-12-25-javascript中的数组方法与栈stack和队列queue的实现",474,"2025-11-29 16:58:15",{"path":651,"words":652,"published":653,"date":156},"\u002Fposts\u002F2025\u002F2025-12-25-关于javascript-实现哈希表",189,"2025-11-27 11:31:39",{"path":655,"words":656,"published":657,"date":156},"\u002Fposts\u002F2025\u002F2025-12-25-关于javascript的set方法",332,"2025-12-25 15:26:18",{"path":659,"words":660,"published":661,"date":156},"\u002Fposts\u002F2025\u002F2025-12-25-关于动态规划(背包问题为例)",1238,"2025-11-17 18:24:04",{"path":663,"words":664,"published":665,"date":156},"\u002Fposts\u002F2025\u002F2025-12-25-关于滑动窗口",712,"2025-11-20 15:04:40",{"path":667,"words":668,"published":669,"date":156},"\u002Fposts\u002F2025\u002F2025-12-25-关于链表(javascript)",500,"2025-11-25 13:00:48",{"path":671,"words":672,"published":673,"date":156},"\u002Fposts\u002F2025\u002F2025-12-25-面试算法acm模式构建构建输入输出模板",2051,"2025-12-25 23:09:45",{"path":675,"words":676,"published":677,"date":156},"\u002Fposts\u002F2025\u002F2025-12-26-javascript-数字数组字符串的处理",483,"2025-12-26 11:20:25",{"path":679,"words":680,"published":681,"date":156},"\u002Fposts\u002F2025\u002F2025-12-26-javascripttypescript-的顺序表链表实现",446,"2025-12-26 12:16:12",{"path":683,"words":684,"published":685,"date":156},"\u002Fposts\u002F2025\u002F2025-12-27-前端画布设计vol-1-实现基础yuan素渲染和状态控制",2136,"2025-12-28 01:23:08",{"path":687,"words":688,"published":689,"date":156},"\u002Fposts\u002F2025\u002F2025-12-27-前端画布设计vol-2-实现富文本编辑",1838,"2025-12-28 02:58:47",{"path":691,"words":692,"published":693,"date":156},"\u002Fposts\u002F2025\u002F2025-12-27-算法刷题-关于链表操作",2135,"2025-12-27 16:12:42",{"path":695,"words":696,"published":697,"date":156},"\u002Fposts\u002F2025\u002F2025-12-27-配置dnscrypt-proxy实现加密dns服务windows",1899,"2025-11-15 01:06:37",{"path":699,"words":700,"published":701,"date":156},"\u002Fposts\u002F2025\u002F2025-12-28-前端-关于网络请求xhrajaxfetchaxios",7788,"2025-10-28 15:48:46",{"path":703,"words":704,"published":705,"date":156},"\u002Fposts\u002F2025\u002F2025-12-28-前端-接口封装与请求规范axios为例",2373,"2025-12-29 01:01:18",{"path":707,"words":708,"published":709,"date":156},"\u002Fposts\u002F2025\u002F2025-12-28-前端-身份验证管理-基于-jwt-token-的实现",2709,"2025-11-23 22:04:41",{"path":711,"words":712,"published":713,"date":156},"\u002Fposts\u002F2025\u002F2025-12-29-记canvas画布项目开发",6254,"2025-12-29 04:52:15",{"path":715,"words":716,"published":717,"date":156},"\u002Fposts\u002F2025\u002Fabout-site",116,"2025-03-31 16:44:24",{"path":719,"words":720,"published":721,"date":156},"\u002Fposts\u002F2025\u002F使用neo4j图数据科学库gds进行中心度分析",143,"2025-04-02 23:37:24",{"path":723,"words":724,"published":725,"date":156},"\u002Fposts\u002F2026\u002F2026-01-03-论文实训草稿",10445,"2026-01-03 14:10:49",{"path":727,"words":728,"published":729,"date":156},"\u002Fposts\u002F2026\u002F2026-01-06-人工智能导论",11461,"2026-01-07 03:25:49",{"path":731,"words":732,"published":733,"date":156},"\u002Fposts\u002F2026\u002F2026-01-07-机器学习相关算法",82,"2026-01-08 02:28:13",{"path":735,"words":736,"published":737,"date":156},"\u002Fposts\u002F2026\u002F2026-01-16-关于低复杂度最长链共识算法设计",4466,"2026-01-16 10:33:23",{"path":739,"words":740,"published":741,"date":156},"\u002Fposts\u002F2026\u002F2026-01-19-杂记2026-01-19",5754,"2026-01-20 01:03:26",{"path":743,"words":744,"published":745,"date":156},"\u002Fposts\u002F2026\u002F2026-01-22-github-action-自动同步博客到-github-主页",1069,"2026-01-22 16:31:47",{"path":747,"words":748,"published":749,"date":156},"\u002Fposts\u002F2026\u002F2026-03-01-windows-wsl安装docker",257,"2026-03-01 20:55:31",{"path":751,"words":752,"published":753,"date":156},"\u002Fposts\u002F2026\u002F2026-03-14-关于-msys2",701,"2026-03-15 03:05:04",{"path":755,"words":756,"published":757,"date":156},"\u002Fposts\u002F2026\u002F2026-03-28-团队项目协作规范随记",2419,"2026-03-29 05:33:50",{"path":759,"words":760,"published":761,"date":156},"\u002Fposts\u002F2026\u002F2026-03-29-oh-my-posh配置分享",104,"2026-03-29 16:34:43",{"path":763,"words":764,"published":765,"date":156},"\u002Fposts\u002F2026\u002F2026-06-13-从上下文工程到-agent-harness-engineering",8840,"2026-06-13 21:06:20",{"path":767,"words":768,"published":769,"date":156},"\u002Fposts\u002F2026\u002F2026-07-13-简谈前端基建质量标准与ai友好建设",3814,"2026-07-13 21:06:20",{"path":771,"words":772,"published":773,"date":156},"\u002Fposts\u002F2026\u002F2026-07-15-agentic-rag-系统实践",13357,"2026-07-15 21:06:20",{"path":775,"words":776,"published":777,"date":156},"\u002Fposts\u002F2026\u002F2026-07-18-简谈sdd规范驱动开发-copy",4476,"2026-07-18 11:06:20",{"path":779,"words":780,"published":781,"date":156},"\u002Fposts\u002F2026\u002F2026-07-20-个人neovim配置分享",366,"2026-07-22 13:46:50",{"path":783,"words":784,"published":785,"date":156},"\u002Fposts\u002F2026\u002F2026-07-20-关于技术写作-设计文档",6763,"2026-07-20 13:46:50",{"path":787,"words":788,"published":789,"date":156},"\u002Fposts\u002F2026\u002F2026-07-29-fastapi-工程实践随记",3417,"2026-07-29 04:58:34",{"path":791,"words":792,"published":793,"date":156},"\u002Fposts\u002Frfc_agentic_project\u002F2026-06-19-rfc-liskin_code_agent",3563,"2026-06-19 15:18:20",{"path":795,"words":796,"published":797,"date":156},"\u002Fposts\u002Frfc_agentic_project\u002F2026-07-25-rfc-glushkov_ogas",13461,"2026-07-28 23:46:50",{"path":799,"words":800,"published":793,"date":156},"\u002Fposts\u002Frfc_agentic_project\u002F2026-08-03-adr-ogas-arkhiv",2698,{"path":802,"words":803,"published":804,"date":156},"\u002Fposts\u002Frfc_agentic_project\u002Frag\u002F2026-08-12-arkhiv_rag-vol-1",4366,"2026-08-12 15:18:20",{"path":806,"words":807,"published":808,"date":156},"\u002Fposts\u002Fleetcode\u002F2025-12-25-力扣百题速练javascripttypescriptvol-1",3108,"2025-12-25 13:57:08",{"path":810,"words":811,"published":812,"date":156},"\u002Fposts\u002Fleetcode\u002F2025-12-26-力扣百题速练javascripttypescriptvol-2",3185,"2025-12-26 13:57:08",{"path":814,"words":815,"published":816,"date":156},"\u002Fposts\u002Fleetcode\u002F2025-12-28-力扣百题速练javascripttypescriptvol-3",2533,"2025-12-29 02:15:44",{"path":818,"words":819,"published":820,"date":156},"\u002Fposts\u002Fleetcode\u002F2026-01-17-力扣百题速练javascripttypescriptvol-4",3024,"2026-01-17 22:53:01",{"path":822,"words":823,"published":824,"date":156},"\u002Fposts\u002Fleetcode\u002F2026-01-19-力扣百题速练javascripttypescriptvol-5",293,"2026-01-19 15:15:12",{"path":826,"words":827,"published":828,"date":156},"\u002Fposts\u002F分布式处理与计算\u002F分布式处理与计算spark系统与scala语言",4320,"2026-07-06 14:10:49",{"path":830,"words":831,"published":832,"date":156},"\u002Fposts\u002F分布式处理与计算\u002F分布式处理与计算分类与回归分析",2081,"2026-07-07 12:40:29",{"path":834,"words":835,"published":836,"date":156},"\u002Fposts\u002F分布式处理与计算\u002F分布式处理与计算数值优化方法",2182,"2026-07-07 13:50:29",{"path":838,"words":839,"published":840,"date":156},"\u002Fposts\u002F分布式处理与计算\u002F分布式处理与计算数据降维",1583,"2026-07-07 21:50:29",{"path":842,"words":843,"published":844,"date":156},"\u002Fposts\u002F分布式处理与计算\u002F分布式处理与计算聚类分析",1882,"2026-07-07 16:50:29",{"path":846,"words":847,"published":848,"date":156},"\u002Fposts\u002F分布式处理与计算\u002F分布式处理与计算随机模拟与统计推断",2433,"2026-07-06 22:40:29",{"path":850,"words":851,"published":852,"date":156},"\u002Fposts\u002F数据可视化\u002F2026-06-14-数据可视化-基本图像",10011,"2026-06-14 20:18:20",{"path":854,"words":855,"published":856,"date":156},"\u002Fposts\u002F数据可视化\u002F2026-06-14-数据可视化-概论",10030,"2026-06-14 15:18:20",{"path":858,"words":859,"published":860,"date":156},"\u002Fposts\u002F数据可视化\u002F2026-06-15-数据可视化-可视化库",2032,"2026-06-15 20:18:20",{"path":862,"words":863,"published":864,"date":156},"\u002Fposts\u002F数据结构\u002F2025-09-29-数据结构-图",5451,"2025-04-15 20:48:06",{"path":866,"words":867,"published":868,"date":156},"\u002Fposts\u002F数据结构\u002F2025-09-29-数据结构-树",4211,"2025-04-30 02:19:06",{"path":870,"words":871,"published":872,"date":156},"\u002Fposts\u002F数据结构\u002F2025-09-29-数据结构-队列",921,"2025-04-11 15:30:08",{"path":874,"words":875,"published":876,"date":156},"\u002Fposts\u002F数据结构\u002F关于数据结构的一些想法",456,"2025-04-04 19:13:49",{"path":878,"words":879,"published":880,"date":156},"\u002Fposts\u002F数据结构\u002F数据结构-栈",920,"2025-04-18 00:17:37",{"path":882,"words":883,"published":884,"date":156},"\u002Fposts\u002F数据结构\u002F数据结构-算法复杂度",2153,"2025-04-05 16:09:55",{"path":886,"words":887,"published":888,"date":156},"\u002Fposts\u002F数据结构\u002F数据结构-线性表链表",4572,"2025-04-06 00:24:40",{"path":890,"words":891,"published":892,"date":156},"\u002Fposts\u002F数据结构\u002F数据结构-线性表顺序表",4191,"2025-04-05 22:09:59",{"path":894,"words":895,"published":896,"date":156},"\u002Fposts\u002F数据结构\u002F数据结构-绪论",2881,"2025-04-05 11:31:22",{"path":898,"words":899,"published":156,"date":900},"\u002Fposts\u002F杂记\u002F2023-12-26-2023年12月26日",7,"2023-12-26 23:51:33",{"path":902,"words":899,"published":156,"date":903},"\u002Fposts\u002F杂记\u002F2024-01-01-2024团建","2024-01-01 01:51:27",{"path":905,"words":581,"published":156,"date":906},"\u002Fposts\u002F杂记\u002F2024-01-09-随记","2024-01-09 20:50:35",{"path":908,"words":909,"published":156,"date":910},"\u002Fposts\u002F杂记\u002F2024-03-12-花名",5275,"2024-03-12 16:04:23",{"path":912,"words":913,"published":156,"date":914},"\u002Fposts\u002F杂记\u002F2024-04-15-逆模因",1353,"2024-04-15 00:26:16",{"path":916,"words":917,"published":156,"date":918},"\u002Fposts\u002F杂记\u002F2024-05-03-艺作",27,"2024-05-03 00:01:00",{"path":920,"words":921,"published":156,"date":922},"\u002Fposts\u002F杂记\u002F2024-05-21-关于博客",1720,"2024-02-21 23:21:11",{"path":924,"words":925,"published":156,"date":926},"\u002Fposts\u002F杂记\u002F2024-06-20-dnvrc维克多崔专访-2023",2036,"2024-06-20 00:28:39",{"path":928,"words":760,"published":156,"date":929},"\u002Fposts\u002F杂记\u002F2024-06-25-6月25日随记","2024-06-25 12:46:36",{"path":931,"words":932,"published":156,"date":933},"\u002Fposts\u002F杂记\u002F2024-06-25-歌名-想見星星",148,"2024-06-25 22:47:59",{"path":935,"words":936,"published":156,"date":937},"\u002Fposts\u002F杂记\u002F2024-07-11-桂花岗",6,"2024-07-11 00:28:17",{"path":939,"words":940,"published":156,"date":941},"\u002Fposts\u002F杂记\u002F2024-07-15-rolling-bocci",9,"2024-07-15 21:25:56",{"path":943,"words":944,"published":156,"date":945},"\u002Fposts\u002F杂记\u002F2024-07-22-七月九日",34,"2024-07-09 17:54:23",{"path":947,"words":948,"published":156,"date":949},"\u002Fposts\u002F杂记\u002F2024-07-22-六月随记",1052,"2024-07-22 01:03:19",{"path":951,"words":952,"published":156,"date":953},"\u002Fposts\u002F杂记\u002F2024-07-22-石菖蒲",41,"2024-07-10 01:26:05",{"path":955,"words":514,"published":156,"date":956},"\u002Fposts\u002F杂记\u002F2024-07-23-新书","2024-07-23 01:05:49",{"path":958,"words":959,"published":156,"date":960},"\u002Fposts\u002F杂记\u002F2024-07-29-年前",74,"2024-07-29 23:59:07",{"path":962,"words":963,"published":156,"date":964},"\u002Fposts\u002F杂记\u002F2024-07-30-周边",138,"2024-07-30 02:03:23",{"path":966,"words":967,"published":156,"date":968},"\u002Fposts\u002F杂记\u002F2024-07-31-2024-7-31日",185,"2024-07-31 01:21:52",{"path":970,"words":971,"published":156,"date":972},"\u002Fposts\u002F杂记\u002F2024-08-02-八月",1710,"2024-08-30 00:31:02",{"path":974,"words":975,"published":156,"date":976},"\u002Fposts\u002F杂记\u002F2024-09-01-九月",1484,"2024-09-26 16:30:15",{"path":978,"words":979,"published":156,"date":980},"\u002Fposts\u002F杂记\u002F2024-09-08-2024年9月8日",97,"2024-09-08 13:59:36",{"path":982,"words":514,"published":156,"date":983},"\u002Fposts\u002F杂记\u002F2024-09-19-博客站的一周年","2024-09-18 23:36:24",{"path":985,"words":986,"published":156,"date":987},"\u002Fposts\u002F杂记\u002F2024-10-03-十月",1028,"2024-10-31 23:54:27",{"path":989,"words":990,"published":156,"date":991},"\u002Fposts\u002F杂记\u002F2024-11-04-十一月",2134,"2024-11-30 00:04:39",{"path":993,"words":994,"published":156,"date":995},"\u002Fposts\u002F杂记\u002F2024-11-10-gzhu-site-193",80,"2024-11-10 19:19:12",{"path":997,"words":998,"published":156,"date":999},"\u002Fposts\u002F杂记\u002F2024-12-01-十二月",455,"2024-12-30 23:13:47",{"path":1001,"words":1002,"published":156,"date":1003},"\u002Fposts\u002F杂记\u002F2024-12-21-年末",23,"2024-12-21 23:21:49",{"path":1005,"words":522,"published":156,"date":1006},"\u002Fposts\u002F杂记\u002F2025-01-30-一月","2025-01-30 23:44:41",{"path":1008,"words":1009,"published":156,"date":1010},"\u002Fposts\u002F杂记\u002F2025-03-01-二月",224,"2025-02-28 00:11:08",{"path":1012,"words":1013,"published":156,"date":1014},"\u002Fposts\u002F杂记\u002F2025-03-01-博客杂谈",344,"2025-03-01 16:03:18",{"path":1016,"words":1017,"published":156,"date":1018},"\u002Fposts\u002F杂记\u002F2025-03-05-三月",2090,"2025-03-05 19:17:28",{"path":1020,"words":1021,"published":156,"date":1022},"\u002Fposts\u002F杂记\u002F2025-07-10-七月",361,"2025-07-10 22:04:32",{"path":1024,"words":1025,"published":156,"date":1026},"\u002Fposts\u002F杂记\u002F2025-09-21-九月",781,"2025-09-21 20:53:37",{"path":1028,"words":1029,"published":156,"date":1030},"\u002Fposts\u002F杂记\u002F2025-10-09-十月",591,"2025-10-09 00:35:07",{"path":1032,"words":1033,"published":156,"date":1034},"\u002Fposts\u002F杂记\u002Fcontrol",13,"2023-09-25 13:03:59",{"path":1036,"words":1037,"published":156,"date":1038},"\u002Fposts\u002F杂记\u002Fquadim四叉树图像处理",1094,"2023-10-21 11:27:06",{"path":1040,"words":1041,"published":156,"date":1042},"\u002Fposts\u002F杂记\u002Fsuccess",24,"2023-09-22 15:59:07",{"path":1044,"words":1045,"published":156,"date":1046},"\u002Fposts\u002F杂记\u002F三光年",295,"2023-11-18 04:18:40",{"path":1048,"words":1049,"published":156,"date":1050},"\u002Fposts\u002F杂记\u002F加密测试",961,"2023-11-21 14:24:01",{"path":1052,"words":1053,"published":156,"date":1054},"\u002Fposts\u002F杂记\u002F啊啊啊啊啊啊啊",54,"2023-09-20 17:29:33",{"path":1056,"words":1057,"published":156,"date":1058},"\u002Fposts\u002F杂记\u002F杂谈",124,"2023-09-25 23:11:32",{"path":1060,"words":1061,"published":156,"date":1062},"\u002Fposts\u002F杂记\u002F艹",25,"2023-10-21 17:40:43",{"path":1064,"words":1065,"published":1066,"date":156},"\u002Fposts\u002F神经网络\u002F神经网络与深度学习卷积神经网络",3168,"2026-06-07 11:23:08",{"path":1068,"words":1069,"published":1070,"date":156},"\u002Fposts\u002F神经网络\u002F神经网络与深度学习循环神经网络",2348,"2026-06-07 11:33:08",{"path":1072,"words":1073,"published":1074,"date":156},"\u002Fposts\u002F神经网络\u002F神经网络与深度学习改进学习方法",3360,"2026-06-07 10:13:08",{"path":1076,"words":1077,"published":1078,"date":156},"\u002Fposts\u002F神经网络\u002F神经网络与深度学习深度生成模型",2727,"2026-06-07 11:43:08",{"path":1080,"words":1081,"published":1082,"date":156},"\u002Fposts\u002F神经网络\u002F神经网络与深度学习神经网络基础",3205,"2026-06-07 10:03:08",{"id":1084,"title":1085,"abbrlink":156,"body":1086,"category":5,"cover":1244,"date":156,"description":1664,"extension":1665,"mathjax":1666,"meta":1667,"navigation":1666,"path":783,"published":785,"readingMinutes":1002,"seo":1671,"stem":1672,"sticky":156,"swiper_index":156,"tags":1673,"updated":156,"words":784,"__hash__":1674},"posts\u002Fposts\u002F2026\u002F2026-07-20-关于技术写作-设计文档.md","2026-07-20-技术写作-关于设计文档",{"type":1087,"value":1088,"toc":1631},"minimark",[1089,1094,1098,1101,1104,1107,1111,1133,1136,1150,1153,1156,1159,1162,1165,1168,1171,1174,1177,1180,1212,1215,1218,1221,1232,1235,1239,1245,1248,1251,1254,1257,1260,1266,1269,1273,1276,1282,1285,1289,1292,1303,1309,1312,1315,1318,1321,1324,1327,1330,1333,1336,1339,1342,1356,1359,1362,1365,1368,1371,1374,1377,1381,1384,1388,1391,1394,1397,1400,1403,1410,1416,1421,1424,1427,1430,1433,1443,1457,1463,1466,1473,1479,1485,1492,1502,1508,1518,1524,1528,1535,1542,1546,1553,1556,1559,1562,1569,1576,1579,1582,1588,1594,1600,1606,1610,1613,1616,1619,1625,1628],[1090,1091,1093],"h1",{"id":1092},"tldr","TLDR",[1095,1096,1097],"p",{},"软件设计是软件工程中的一个重要环节。沟通软件设计决策的基础工具——但沟通本身很难，写设计文档也一样难。",[1095,1099,1100],{},"在确立了我们要构建的产品或系统的需求之后，我们要制定计划、做出决策，考虑如何用软件最好地实现这些需求。如何用一份设计文档来推动就软件设计达成一致的过程，并为当前及未来的实现者、维护者以及该软件的其他相关方把这份设计记录下来是很重要的一环。",[1095,1102,1103],{},"即使是AI时代，文档写作也仍然是一个很重要的能力。这里主要关于设计文档的方法论与过程论开展",[1090,1105,1106],{"id":1106},"设计文档的方法论",[1108,1109,1110],"h2",{"id":1110},"写作目标",[1112,1113,1114,1118,1121,1124,1127,1130],"ul",{},[1115,1116,1117],"li",{},"记录软件设计。",[1115,1119,1120],{},"澄清正在解决的问题。",[1115,1122,1123],{},"充当进一步细化设计的讨论平台。",[1115,1125,1126],{},"解释这些决策背后的推理，以及在决策中做出的权衡。",[1115,1128,1129],{},"列出备选设计，以及它们为何没有被选中。",[1115,1131,1132],{},"帮助未来的维护者及其他相关方理解为什么当初选择了这个设计。",[1108,1134,1135],{"id":1135},"非目标",[1112,1137,1138,1141,1144,1147],{},[1115,1139,1140],{},"确立软件的非技术性需求。",[1115,1142,1143],{},"让一个完全不了解该软件背景的人也能独立看懂（但文中的链接应当引导读者去获取所缺的背景知识）。",[1115,1145,1146],{},"充当产品或系统的用户文档。",[1115,1148,1149],{},"适用于记录非软件类的设计，比如\"设计文档\"本身的设计。",[1108,1151,1152],{"id":1152},"概述",[1095,1154,1155],{},"主要的设计思想是：用一份文档来非正式地描述软件设计。",[1095,1157,1158],{},"在选定实现方案之前多走这一步，是因为实践已经证明，用一个完整可运行的实现去逐步演进早期的软件设计，效率很低。出于类似的原因，那些试图理解一个既有软件系统的维护者，往往很难仅凭阅读源代码就搞清楚那些根本性的设计决策。",[1095,1160,1161],{},"写一份设计文档，开篇先解释这个软件设计的目标、它如何融入更宏观的图景，以及为什么手头这个问题复杂到值得写一份设计文档。之所以明确列出目标与非目标，是为了促使人们去认真思考它们。",[1095,1163,1164],{},"文档接着要给出一段简短的设计概述，不铺陈所有细节。概述之后是详细设计部分，那里包含了大部分内容，描述为什么选择了这个设计，以及这个软件设计究竟是什么。",[1095,1166,1167],{},"然后是若干关于横切关注点（比如隐私和安全）的章节，会从各自的视角直接阐述设计与它们的关系。",[1095,1169,1170],{},"最后我们简要说明考虑过哪些备选方案，以及它们为什么没被选中。",[1095,1172,1173],{},"综上所述，设计文档可以被设计成一个高效的设计文档记录与讨论平台，作者可以在实际内容和形式上有很大的自由发挥空间，以最好地表达其设计。",[1108,1175,1176],{"id":1176},"详细设计",[1095,1178,1179],{},"设计软件的过程，理想情况下应当具备以下特性：",[1112,1181,1182,1185,1188,1191,1194,1197,1200,1203,1206,1209],{},[1115,1183,1184],{},"汲取团队内部及周边领域专家的经验。",[1115,1186,1187],{},"能灵活应对软件需求的变化。",[1115,1189,1190],{},"为初始实现产出一份指南。",[1115,1192,1193],{},"为实际落地的软件产出一份准确的设计文档。",[1115,1195,1196],{},"产出一个在既定约束（如时间和资源）内可实现的设计。",[1115,1198,1199],{},"快速确立某个选定的设计是可行的。",[1115,1201,1202],{},"快速确立某个选定的设计不可行，进而产出一个可行的设计。",[1115,1204,1205],{},"降低设计不可行的风险。",[1115,1207,1208],{},"产出简单的设计。",[1115,1210,1211],{},"如果情况合适，得出\"已存在现成方案、无需再做设计\"的结论。",[1095,1213,1214],{},"有些要求看似冗余，但其中有些是无法同时达成的。",[1095,1216,1217],{},"要证明一个系统能否被实现，最直接的方式就是把它实现出来（MVP）；但这可能耗时太久，来不及快速确立什么才是正确的设计，而且等你在旧需求下证明了设计可行时，需求可能早已变了。",[1095,1219,1220],{},"在这个权衡空间里，设计文档扮演着关键角色——它既易于协作、形式非正式，又相对详尽、并能随时间更新：",[1112,1222,1223,1226,1229],{},[1115,1224,1225],{},"借助现代协作软件（如 Google Docs），团队内外的专家都能协作完成最终文档。",[1115,1227,1228],{},"非正式的特性使得内容和形式可以针对手头的设计问题量身定制，从而成为一种高效的设计记录方式。",[1115,1230,1231],{},"同样的非正式性降低了\"修改成本\"。",[1095,1233,1234],{},"软件设计的工具箱里还有诸如\"概念验证（proof of concept）\"\"微基准测试（micro benchmark）\"\"白板讨论（white board discussion）\"之类的东西。虽然逐一解释它们超出了本设计文档的范围，但它们理应被视为软件设计过程的一部分。例如，在设计文档里指向一个概念验证，就是确立设计可行性的绝佳方式。",[1236,1237,1238],"h3",{"id":1238},"设计文档与其他系统的关系",[1095,1240,1241],{},[1242,1243],"img",{"alt":1238,"src":1244},"https:\u002F\u002Fpic1.zhimg.com\u002F80\u002Fv2-48bf613091109811bbe13f6da90259b6_720w.webp",[1095,1246,1247],{},"设计文档是作为软件设计开发工作的一部分而写就的。它通过软件设计的其他环节——比如白板讨论和设计评审——得到信息补充与反复打磨。",[1095,1249,1250],{},"软件设计主要由项目需求驱动，如果适用的话，也由用户界面设计驱动。需求（无论以何种形式表达）定义了一段软件应该做什么，而设计确立了如何实现以及为什么选择那个设计。设计进而指导实现，实现又反过来反馈给设计（当设计遭遇现实时，通过更新设计来体现）。",[1108,1252,1253],{"id":1253},"结构",[1095,1255,1256],{},"元信息 > 背景、范围与目标 > 概述 > 详细设计 > 横切关注点 > 备选方案",[1095,1258,1259],{},"设计文档的结构要让读者能够高效且有效地深入主题。文档从相对高层的内容开始，然后逐渐深入到设计的细节。",[1095,1261,1262],{},[1242,1263],{"alt":1264,"src":1265},"阅读结构","https:\u002F\u002Fpic2.zhimg.com\u002F80\u002Fv2-676e9bafceaeec34f8b22ec8caa8fbe1_720w.webp",[1095,1267,1268],{},"这样就让读者能够快速评估设计的背景、范围和目标，并对设计有一个基本的理解；然后可以选择是否通读整篇文档。",[1236,1270,1272],{"id":1271},"metadata","Metadata",[1095,1274,1275],{},"设计文档应当始终有一个标题，并立即注明作者作为主要联系人，以及最后更新日期。注明状态有助于给读者设定预期，让他们知道文档的完整程度和确定程度。有用的状态包括：",[1095,1277,1278],{},[1279,1280,1281],"code",{},"enum[ ] DesignDocState { UNKNOWN = 0; INCOHERENT_RAMBLING = 1; DRAFT = 2; FINAL = 3; IMPLEMENTED = 4; OBSOLETE = 5; };",[1095,1283,1284],{},"（未知；语无伦次的胡言乱语；草稿；终稿；已实现；已废弃。上面这段代码片段是特意插进来的，用以进一步说明后文的观点——复制粘贴无关的代码片段并不是个好主意。）",[1236,1286,1288],{"id":1287},"背景范围与目标","背景、范围与目标",[1095,1290,1291],{},"文档应当首先确立设计的背景和范围。这可以用一段或多段文字来完成。这一部分应当包含\"目标\"和\"非目标\"的要点列表，理由有三：",[1112,1293,1294,1297,1300],{},[1115,1295,1296],{},"这是一种高效的方式，让读者迅速搞清楚设计想要达成什么、又不想达成什么。",[1115,1298,1299],{},"它可以用来评估详细设计是否确实说清了那些目标是如何达成的。",[1115,1301,1302],{},"它迫使作者真正对范围做出决断。",[1095,1304,1305],{},[1242,1306],{"alt":1307,"src":1308},"我不会去发明一个新的存储系统","https:\u002F\u002Fpic2.zhimg.com\u002Fv2-f2818dc606af919bada442c477a23323_r.jpg",[1236,1310,1152],{"id":1311},"概述-1",[1095,1313,1314],{},"接下来，文档给出设计的概述。这能帮助读者理解整体思路，从而更容易评估各种细节是如何与设计相关联的。要认识到很重要的一点：设计文档不应当在从头读到尾的过程中\"制造悬念\"。恰恰相反，信息应当尽可能快地给出，结构上应当力求避免把相关信息分隔得太远。",[1236,1316,1176],{"id":1317},"详细设计-1",[1095,1319,1320],{},"这一部分酌情解释设计、它的各种权衡以及带来的后果。具体内容在很大程度上取决于所设计的东西是什么，并且会因系统、API、前端等各种类型而差异极大。作者被明确授权去选择最契合其设计的形式。关于详细设计部分应包含哪些内容，参见下文的\"详略程度\"。",[1236,1322,1323],{"id":1323},"横切关注点",[1095,1325,1326],{},"可以有一个或多个章节，从各自特定的视角谈论特定的关注点。虽然整个设计都应把它们纳入考量，但专门的章节能确保它们被正视，并凸显设计是如何应对它们的。这类关注点的例子有：隐私、安全、可扩展性和监控。",[1236,1328,1329],{"id":1329},"考虑过的备选方案",[1095,1331,1332],{},"这一部分是文档结构中固定的组成部分，因为它迫使作者去思考：为达成设计目标，还有哪些备选路径可用。备选方案可以是其他可能的设计，也可以是使用某个几乎能满足需求的既有系统、购买某款标准软件，或者干脆什么都不做。",[1236,1334,1335],{"id":1335},"详略程度",[1095,1337,1338],{},"如前所述，设计文档应当是一个高效的设计讨论与记录平台。文档越长，就越难以消化和修改。因此文档应当\"能多短就多短，但该多长就多长\"。",[1095,1340,1341],{},"关于文档何时过于详细，无法给出确切的指导原则，但有一些迹象表明它可能过头了：",[1112,1343,1344,1347,1350,1353],{},[1115,1345,1346],{},"规定了那些对设计并非至关重要的 API。",[1115,1348,1349],{},"复制粘贴了只与设计部分相关的源代码。",[1115,1351,1352],{},"原始数据。",[1115,1354,1355],{},"要点列表里为了凑数而多出一项、并无正当理由（比如为了自我指涉地玩梗）。",[1095,1357,1358],{},"给定一份设计文档，一个在该主题上已有经验、或愿意投入去获取该经验的软件工程师，应当能够据此实现这份设计。同理，一个在该主题上有经验的\"讲道理的软件工程师\"，应当能够读懂设计为什么这样选，哪怕他并不认同其结论。",[1095,1360,1361],{},"设计文档本身并不负责为任何读者（无论其先前经验如何）提供进入该主题的全部背景，但它应当提供链接，使读者能够建立起跟上后文所需的完整背景。",[1108,1363,1364],{"id":1364},"生命周期",[1236,1366,1367],{"id":1367},"文档创建",[1095,1369,1370],{},"在设计文档生命周期的早期，重大改动比后期更可能发生——后期设计更加稳定。因此文档的早期迭代应当尽可能轻量，好让修改迅速、让作者对修改的抵触降到最低。",[1095,1372,1373],{},"在文档早期阶段，可以采用白板讨论、用要点列表勾勒章节等技巧。",[1095,1375,1376],{},"虽然文档本身是非正式的，但初始搭建可以通过使用模板来加速，或者用那个久经考验的技巧——把自己上一次写的设计文档复制粘贴过来。使用这些模板有助于确保最低限度的内容覆盖，并减少样板式的重复劳动。",[1236,1378,1380],{"id":1379},"canary-rollout","Canary rollout",[1095,1382,1383],{},"当文档趋于稳定后，明智的做法是先把它分享给一小批\"金丝雀读者\"。这些人往往是参与过早期白板讨论和设计探讨的同伴。通过把他们的反馈吸收进设计文档，我们能确保没有重大问题被遗漏，并在向更大范围传阅之前确保设计总体上是站得住脚的。",[1236,1385,1387],{"id":1386},"正式发布rollout","正式发布（Rollout）",[1095,1389,1390],{},"此时，文档被分享给更大范围的团队及其他相关方法。鼓励读者通过行内评论提问和提建议，作者则予以回复。如有必要，应更新文档以回应这些反馈。",[1095,1392,1393],{},"最终，设计被宣布为终稿。这往往是非正式地发生的——其标志常常是：人们开始动手实现这个设计了。",[1108,1395,1396],{"id":1396},"安全与隐私考量",[1095,1398,1399],{},"设计文档应该设有专门的章节来阐述安全与隐私考量，以及其他适用的横切关注点，以确保它们得到充分的处理。",[1108,1401,1402],{"id":1402},"其他考虑",[1095,1404,1405,1409],{},[1406,1407,1408],"strong",{},"白板讨论","\n系统往往过于复杂，无法通过一次白板讨论来表达，而那些没有亲自参与讨论的人可能会缺少背景。话虽如此，白板讨论仍是个很好的开端，能在真正动笔写下来之前，以一个轻量的流程勾勒出设计的要点。",[1095,1411,1412,1415],{},[1406,1413,1414],{},"敏捷","\n\"做那件能行得通的最简单的事\"通常是个好主意，但当这件事包含大量样板、或者累积起来复杂到人人都跟不上进展时，它就不再有趣了。如果\"能行得通的最简单的事\"本身仍然很复杂，那么设计文档或许能帮你把这件\"最简单的事\"记录下来。",[1095,1417,1418,1420],{},[1406,1419,303],{},"\n写一堆想法让人来拷打（",[1090,1422,1423],{"id":1423},"设计文档的具体写作",[1095,1425,1426],{},"在真正动手写代码之前,工程师通常会先写一份非正式的文档,用来描述这套系统或应用的设计思路。它记录的是高层次的实现策略,以及背后那些关键的设计权衡,重点放在需要做取舍的地方。",[1095,1428,1429],{},"写作的过程本身,会促使作者在动手编码前就把那些原本模糊的问题想清楚。而这份文档一旦写成,又能确保所有相关的人和团队都认可这套设计。同时,它也充当了一座桥梁,把系统当下的样貌和未来可能演进的方向连接起来,让后来者能顺着它理解一段历史。",[1108,1431,1432],{"id":1432},"一份设计文档里通常有什么",[1095,1434,1435,1438,1439,1442],{},[1406,1436,1437],{},"上下文与范围(Context and scope)","。这一节要给读者一个大致的印象:这个系统是被造出来的,它所处的环境是什么样的,又要解决什么。这里说的是",[1406,1440,1441],{},"现状与约束",",而不是需求。它应该尽量简短、客观——因为读者往往对项目背景已经有所了解,只是需要一个快速的复习,以及一份可以引用的信息源。",[1095,1444,1445,1448,1449,1452,1453,1456],{},[1406,1446,1447],{},"目标与非目标(Goals and non-goals)","。用一个简短的清单列出系统的目标。有时候更有用的,是同时列出那些",[1406,1450,1451],{},"明确不在目标之内","的事情——注意,非目标不是\"负目标\"(比如\"系统不能崩溃\"),而是那些本来看起来合理、值得做,但你",[1406,1454,1455],{},"有意选择不做","的事情(比如\"不追求强一致性\")。",[1095,1458,1459,1462],{},[1406,1460,1461],{},"真正的设计(The actual design)","。",[1095,1464,1465],{},"这里做技术选型的调研，项目架构，业务流程，都可以详细说明，最好画个图。",[1095,1467,1468,1469,1472],{},"不同的项目,这一节的样貌千差万别。写作对象是读者,而不是自己,所以要照顾读者能理解的程度;要",[1406,1470,1471],{},"聚焦在权衡与取舍","上,而不是罗列所有细节;要诚实地面对那些还没想清楚、或者可能出错的地方。",[1095,1474,1475,1478],{},[1406,1476,1477],{},"系统上下文图(System-context-diagram)","。很多文档里,一张系统上下文图是极其有价值的。它把你要造的系统放在它所处的更大生态里,展示出这个系统和周边其他系统之间的关系与边界。",[1095,1480,1481],{},[1242,1482],{"alt":1483,"src":1484},"系统上下文图示例:展示目标系统与其上下游系统之间的依赖与数据流关系的方框","https:\u002F\u002Fpic1.zhimg.com\u002Fv2-c741e6deab79ae67b3b43abe38ebd8ca_r.jpg",[1095,1486,1487,1488,1491],{},"这类图往往用方框和箭头就能画出来。关键是,它展示的是",[1406,1489,1490],{},"系统与外部世界的边界",",而不是系统内部的模块划分。",[1095,1493,1494,1497,1498,1501],{},[1406,1495,1496],{},"API","。如果你正在设计的系统对外暴露 API,那么把这些接口的样子勾勒出来通常是值得的。但要克制:不要把完整的接口定义原样贴进来,因为那些内容通常可以用代码本身来表达,而且很容易过时。真正该写进文档的,是",[1406,1499,1500],{},"为什么这样设计接口",",以及这些设计如何影响使用者。",[1095,1503,1504,1507],{},[1406,1505,1506],{},"数据存储(Data storage)","。如果系统要存储数据,同样值得聊聊你打算怎么存、用什么形式存。这里的原则和 API 一样:不要贴出完整的 schema 定义,而要讲清楚背后的取舍——为什么选这种存储、这种数据模型,它带来了什么代价。",[1095,1509,1510,1513,1514,1517],{},[1406,1511,1512],{},"代码与伪代码(Code and pseudo-code)","。设计文档里一般应该",[1406,1515,1516],{},"避免","贴大段代码或伪代码。只有当你要展示某个新颖的算法,或者某段代码本身就是设计的核心创新时,贴一小段才有意义。",[1095,1519,1520,1523],{},[1406,1521,1522],{},"约束的程度(Degree of constraint)","。设计文档的一个重要维度,是它给后续实现留出了多大的自由度。这跨越了一个很宽的光谱:一端是\"绿地\"项目(greenfield)——从零开始,几乎没有任何约束,你可以自由发挥;另一端则是那种约束极强的系统——它要接入一个成熟庞大的既有体系,你的设计空间被压缩得很小,大量决策其实早已被现状锁定。有意思的是,后者往往比前者更难设计,因为你要在密密麻麻的约束缝隙里找出一条可行的路。这两类项目的设计文档,写法和侧重点都会很不一样。",[1108,1525,1527],{"id":1526},"备选方案alternatives-considered","备选方案(Alternatives considered)",[1095,1529,1530,1531,1534],{},"这一节列出你",[1406,1532,1533],{},"认真考虑过、但最终没有采用","的其他设计方案,并说明它们各自的优劣,以及你为什么最后选了现在这个方案。",[1095,1536,1537,1538,1541],{},"在很多设计文档里,这往往是",[1406,1539,1540],{},"最重要","的一节。它最能体现出你确实做过扎实的权衡,考虑过多种可能性,而不是撞上第一个能用的方案就一头扎进去。它也让评审者能够顺着你的思路,判断你的取舍是否合理——甚至提出一个你没想到的、更好的选项。",[1108,1543,1545],{"id":1544},"横切关注点cross-cutting-concerns","横切关注点(Cross-cutting concerns)",[1095,1547,1548,1549,1552],{},"几乎每个组织都有一些",[1406,1550,1551],{},"贯穿所有系统","的关注点,比如安全、隐私、日志、国际化、合规等等。这些议题通常有专门的团队和专家在把关。",[1095,1554,1555],{},"在设计文档里专门开一节,说明你的设计如何影响这些横切关注点,又是如何应对它们的,是一种很好的实践。这样做,一方面强迫作者真正去思考这些问题——而不是等到系统上线才追悔莫及;另一方面,也给了相关领域的专家一个入口,让他们能够审视你的设计,及早发现隐患。这些议题的关键在于:它们几乎不可能在事后被廉价地补上,越晚处理代价越高。",[1108,1557,1558],{"id":1558},"设计文档应该多长",[1095,1560,1561],{},"一份设计文档的篇幅,某种程度上反映了它所描述系统的复杂度。",[1095,1563,1564,1565,1568],{},"大型项目往往要一份",[1406,1566,1567],{},"10 到 20 页","的文档，足够长,能覆盖真正重要的设计决策;又足够短,能让人真的坐下来读完。如果你发现自己写出了一份远超这个长度的文档——比如几十上百页的\"巨型设计文档\",那通常是个信号:也许这个问题的范围还没有被拆解到足够小,应该考虑把它切分成几个可以独立解决的子问题,分别成文。",[1095,1570,1571,1572,1575],{},"另一端,对于那些改动不大、但仍然值得记录的决策,可以写一份",[1406,1573,1574],{},"1 到 3 页的迷你设计文档(mini design doc)","。它保留了设计文档的核心价值——逼你把问题想清楚、让相关的人达成共识——但省去了大部头文档的仪式感和重量。迷你文档在敏捷、快速迭代的团队里尤其常见。",[1108,1577,1578],{"id":1578},"设计文档的生命周期",[1095,1580,1581],{},"一份设计文档会经历几个相对固定的阶段。",[1095,1583,1584,1587],{},[1406,1585,1586],{},"创建与快速迭代(Creation and rapid iteration)","。文档的第一版,通常由一位或几位作者快速写就。在这个阶段,它常常还很粗糙,充满了不确定和待填的空白。作者一般要在这时和多人来快速地迭代打磨，补上遗漏的部分、推翻不成立的假设。这是文档变化最剧烈的时期。",[1095,1589,1590,1593],{},[1406,1591,1592],{},"评审(Review)","。当文档稳定下来,就进入更广泛的评审阶段。这时它会被分享给更大范围的相关方——包括各个横切关注点的专家、会受这套设计影响的其他团队,以及资深的工程师。评审可以以多种形式进行:文档内的评论、面对面的设计评审会议,或者两者结合。评审的目标,是让这套设计尽可能多地经受住不同视角的检验,在动手写代码之前把问题暴露出来。",[1095,1595,1596,1599],{},[1406,1597,1598],{},"实现与迭代(Implementation and iteration)","。设计被认可后,团队开始按照它来实现系统。在真正动手的过程中,几乎必然会冒出一些当初没预料到的问题。这时,原来的设计需要相应地调整。一个健康的做法是:让文档跟着这些重大的、非预期的偏离一起更新——至少要把那些偏离设计的关键决策记录下来。",[1095,1601,1602,1605],{},[1406,1603,1604],{},"维护与学习(Maintenance and learning)","。系统上线并运行一段时间后,现实会告诉你当初的设计哪些成立、哪些不成立。这时,回到当初的设计文档,把实际结果和当初的预期对照一下,是极有价值的学习机会。这不仅让作者本人成长,也让整个组织在下一次面对类似问题时,能做出更好的判断。设计文档,由此成为组织长期记忆的一部分。",[1090,1607,1609],{"id":1608},"ed","ED",[1095,1611,1612],{},"设计文档记录的是高层次的实现策略，以及背后那些关键的设计权衡，重点放在需要做取舍的地方。写作的过程本身，会促使作者在动手编码前就把那些原本模糊的问题想清楚。而这份文档一旦写成，又能确保所有相关的人和团队都认可这套设计，它也充当了一座桥梁，把系统当下的样貌和未来可能演进的方向连接起来，让后来者能顺着它理解一段历史，减少沟通对齐的成本。",[1095,1614,1615],{},"可能会有人想：如今大模型已经能帮我们生成代码、补全接口、甚至起草文档的初稿，那认认真真写设计文档这件事，是不是正在变得过时？",[1095,1617,1618],{},"个人觉得恰恰相反。在 AI 时代，写文档反而更重要了。AI 让 \"写代码\" 这一环的成本急剧下降，反而把真正稀缺的东西凸显了出来 —— 清晰地想清楚要做什么、为什么这么做，以及在众多可能性中如何取舍。这正是设计文档从头到尾在训练的能力。当生成一段实现只需要几秒钟，决定 \"该不该实现它、该以什么形态实现\" 的判断力就成了工程师最核心的价值所在。",[1095,1620,1621,1622,1462],{},"从更实际的层面看，AI 也让文档写作的意义发生了双向的加强。一方面，大模型可以承担初稿、润色、查漏这些机械的部分，把作者从 \"憋字数\" 里解放出来，让人能把精力集中在把设计中的权衡讲透、把备选方案比清楚、把风险摊开来。另一方面，一份结构清晰、意图明确的设计文档，本身就是喂给 AI 的最好的上下文: 把目标、约束和边界写明白，AI 实现时就越不容易跑偏。",[1406,1623,1624],{},"所以会写文档的人，往往也更会用 AI",[1095,1626,1627],{},"更根本的一点是，设计文档承载了判断、共识与记忆。AI 能生成看似合理的文字，但它无法替你和团队达成真正的认同，无法替一个组织沉淀出 \"我们当初为什么这样选\" 的集体记忆，也无法替你承担一个决策错了之后的代价。",[1095,1629,1630],{},"工具在变，但把一件复杂的事情想清楚、说明白、并让别人信服，我觉得这项能力很难过时。",{"title":1632,"searchDepth":1633,"depth":1633,"links":1634},"",4,[1635,1637,1638,1639,1643,1652,1657,1658,1659,1660,1661,1662,1663],{"id":1110,"depth":1636,"text":1110},2,{"id":1135,"depth":1636,"text":1135},{"id":1152,"depth":1636,"text":1152},{"id":1176,"depth":1636,"text":1176,"children":1640},[1641],{"id":1238,"depth":1642,"text":1238},3,{"id":1253,"depth":1636,"text":1253,"children":1644},[1645,1646,1647,1648,1649,1650,1651],{"id":1271,"depth":1642,"text":1272},{"id":1287,"depth":1642,"text":1288},{"id":1311,"depth":1642,"text":1152},{"id":1317,"depth":1642,"text":1176},{"id":1323,"depth":1642,"text":1323},{"id":1329,"depth":1642,"text":1329},{"id":1335,"depth":1642,"text":1335},{"id":1364,"depth":1636,"text":1364,"children":1653},[1654,1655,1656],{"id":1367,"depth":1642,"text":1367},{"id":1379,"depth":1642,"text":1380},{"id":1386,"depth":1642,"text":1387},{"id":1396,"depth":1636,"text":1396},{"id":1402,"depth":1636,"text":1402},{"id":1432,"depth":1636,"text":1432},{"id":1526,"depth":1636,"text":1527},{"id":1544,"depth":1636,"text":1545},{"id":1558,"depth":1636,"text":1558},{"id":1578,"depth":1636,"text":1578},"即使是AI时代，文档写作也仍然是一个很重要的能力。这里主要关于设计文档的方法论与过程论开坑","md",true,{"uuid":1668,"abblink":1669,"slots":1670},"b8d70910-c4f4-11f4-21bd-26018b9748b8","f722131e451",{},{"title":1085,"description":1664},"posts\u002F2026\u002F2026-07-20-关于技术写作-设计文档",[292],"XAZY8qsaA4SfHbkeNLsnhZ2UhZKEKugnG9_NVeG3pxA",1790443282689]