主题=topic(权威版文档名);版本=version(V1/V2/…,文件名带版本号);文件=file(磁盘文件名,可直接取原文);大小=size(字节);归档=history.length(_archive/ 内旧版数量);接口行:方法=method、路径=path、分组=group、说明=desc。
/api/zt/docs/versions · 权威版清单(GET,含 topic/version/file/size/at/history)|/api/zt/docs/api-full.json · 接口索引(GET,509 条带 method/path/group/desc)|/api/zt/norms/list · 规范目录(GET,返回实际扫描目录 dir 与条目)|/api/zt/docs/latest?topic= · 单主题最新版(GET)|/api/zt/ui/version · 版本徽标(GET)|/api/zt/time/now · 北京时间(GET)
每个主题只保留 1 份权威版;任何修改 = 版本号 +1;旧版归档 _archive/;文件名必须带版本号;文内必须有变更记录;变更后必须广播(type=规约)。
加载态:接口未返回或不足 300ms(骨架屏≥300ms);空态:搜索/分类无命中,给原因 +「看全部」动作;错误态:fetch 失败显示「—」+ 重试,不显示假数据。
① 看「权威版规范」确认要用的主题当前是 V 几;② 点主题行取 .md 原文,不用旧版;③ 找接口时切「接口文档」,按分组或路径搜索,命中后直接复制 path 调。
P1 TARGET 首行 + TASK 次行;P3 真实接口 ≥5(本页 5 路 fetch);P8 details≥6;P9 card≥6(9 个分区全打 card);P4/P5 @media 1024 与 520 两段;tokens?v=1.1.0 且 meta dt-tokens=1.1.0;body 不裁切(无 overflow 隐藏);字号 11/13/16/20/26 五级;间距 8 倍数;行高 1.6(标题 1.25)。