v0.8.0：条目归档外置＋知识提炼路由＋团队git协作＋工作台页签

整合 0.7.17 以来的四大功能批次＋两处修复。这个版本围绕四个日常使用中真实发生的痛点：

痛点一：审核历史越滚越肥，每次 AI 处理都全量带入

痛点：需求变更／缺陷记录以时间戳条目内联在开发文档里，规范上「只进不出、不回改」——文档越用越长（实测最热文档审核区已占全文 30%）。而每次 调整/变更/整改，AI 读文档时这些已完成条目的全文（原始诉求＋合入说明＋落实说明三层）都被白白带进上下文，真正要处理的未完成条目往往只有一两条。

方案：条目归档外置。条目由 变更/整改 在填完「落实／整改」的同一时刻原样搬入 docs/归档/<模块>/<文档名>-归档.md（只进不出、不回改），正文节尾只留一行 > 已完成条目归档：[[…]] 指针。平时所有命令不读归档，作者点名追历史时循双链载入——正文永久只含未处理条目，已完成条目的 token 成本归零。与面板统计、撤回、状态漂移检查完全兼容（指针必须是 > 引用行、条目结构不变，均已代码级验证）。

痛点二：条目处理完，经验跟着一起"死"了

痛点：缺陷的根因、变更里沉淀的硬规则，是这些记录里最值钱的部分——但它们埋在过程细节里，正文一瘦就没了着落；不加治理，同一个坑会反复踩。

方案：提炼路由。条目完成时顺带提炼：根因进模块卡「缺陷史」（回归清单照旧）；会再犯的硬规则提议补进概念卡「规则」字段（作者定夺才落卡）；同形重复实现提议抽组件（走 需求 流程）。归档是纯冷存储，活知识都在能力层。配套卡规则去重：卡落盘后，正文需求描述／验收里与卡重复的规则删掉，只留本页特有的位置与范围＋[[概念]] 双链——规则单源在卡上，读卡即得全部。

痛点三：vault 进 git 团队开发后，本机状态污染仓库

痛点：vault 本体就是 git 仓库时，插件撤回栈（data.json）、桥接意见（.ai-review/）都是本机状态——进了 git 会被队友覆盖、互相冲突；桥接 JSON 被队友的 AI 当素材处理，等于别人代做你的决定。

方案：环境检测＋本机状态默认不进 git。技能首进项目先判定环境：git 有远端＝团队开发，施行「动文档前 pull、处理完尽快 commit、同一文档同时只一人处理、状态与预期不符即停下问」的协作纪律；无 git／无远端＝单机，纪律跳过。.ai-review/、.obsidian/plugins/*/data.json、.obsidian/workspace*.json 任何 git 操作默认不添加；检测到未隔离时列出该补的 ignore 行与 rm --cached 清单，作者确认后代改，不擅自动仓库。

痛点四：新资产在工作台没有入口，指令按钮越堆越多

痛点：归档和概念卡成了两类一等公民，工作台面板却看不到、点不进；顶部复制指令按钮堆到 4 个，视觉噪音大。

方案：同级页签＋下拉收敛。dev 模式在功能按钮行下方新增 文档（n）｜概念卡（n）｜归档（n） 页签，专注哪块划到哪块：概念卡页悬停显示卡内「定义」首行；归档页按模块分组，每行条目数徽章＋「原文档」一键跳回。复制类按钮收敛为一个下拉「复制指令…」，选中即复制并复位（小说模式 2 项／dev 模式 4 项）。

顺带修复

• 撤回吞指针：条目全部归档后再记新条目、随即撤回，会把「已完成条目归档」指针行一并删掉（原删除边界到节尾）。已修：指针行现在是删除边界，撤回只删条目本身。
• 模板说明不再遗留正文：开发文档里「不要另开文档」之类的节用途括注只存在于创建模板，不再落进定稿正文（技能模板与插件内置模板同步去除）。

升级：覆盖安装后重载 Obsidian；install:vault 用户自动分发到全部库。归档与概念卡按目录自动识别（docs/归档/、docs/公用配置/），无新增设置项。

v0.7.17：页面卡层＋检测报告闭环＋布局草图标记＋技能拆分

整合 0.7.10 以来的全部功能批次＋布局草图标记＋技能结构拆分：

• 页面卡层：docs/页面文档/<模块>/<页面名>.md 一页一卡——编号槽位草图＋四要素图例（编号｜位置｜作用｜组件，组件列三态），业务↔页面双向双链；组件解析 建卡、组件影响/交付/整合织链 保鲜
• 两个检测命令（报告闭环）：组件比对 [模块|整改] 注册表健康检测（缺卡/孤儿卡/槽位漂移/链健康/织链欠账）＋ 文档检查 [模块|整改] 开发文档规范检查（基本信息六字段/交付日期预填/条目格式/状态漂移/死链）；均覆盖重写报告、分「AI 可修/作者定夺」两组、修完勾选、全清删报告
• 微改：小改动的轻量入口（四节精简模板），状态机与审批门和需求完全一致；交付日期不可预填（防跳过审核门）
• 添加 BUG|变更|补充：记录入口指令（面板按钮等价），分钟级时间戳最新在前；调整/整改/变更只认已记录条目，变更遇调整中硬停
• 布局草图标记语法：占位 <full>/<50%>/<max>、间距 <v10>/<h10>、行分布行首 <right>/<center>/<between>/<evenly>、└ 子行、Column 宽度规矩（不标=通栏，故意≠Flutter 默认）——AI 重建布局只读行结构＋标记
• 技能渐进披露拆分：dev-review SKILL.md 566 行单体瘦到 235 行核心（路径/状态机/子命令路由/纪律），模板与细则拆 references/ 四文件按需读
• 面板：新增 缺陷/需求变更/补充需求 记录按钮与状态机配套

v0.7.16：整合织链必做

修复整合不默认织双链的问题（用户实测反馈）：

• 织链从从句升级为独立必做步骤：每份被更新的业务文档必须有「页面 / 组件双链清单」小节（放「边界与非目标」之后；页面类名双链，组件只链注册表里真实存在的卡；新页入链、废弃页移除；顺带反查核对组件卡使用方）
• 完成标准：没有织链 = 没整合完，不许跳过、不许另开清单拖延
• 汇报必含织链情况：新增/更新了哪些双链小节

v0.7.15：业务→页面→组件 分级影响链

业务文档结构化升级，改动影响可沿链定级：

• 业务文档双链化：「页面与入口」每个页面 [[页面名]]（建议=类名）＋每页关键组件 [[组件名]]（以组件注册表为准，未入册写文件名）；主流程步骤引用页面
• 组件影响 升级：接受组件名 / 页面名 / 路径——代码反查受影响的页面、组件、模块 → grep 业务文档的 [[页面]]/[[组件]] 双链命中 → 各模块缺陷史回归提示；可生成「组件/页面变更」需求
• 钩子：修改既有业务的需求，从其业务文档的页面/组件清单取受影响面写进边界；整合 时维护双链清单（新页入链、废弃页移除）
• 原则：文档链做导航预览与 Obsidian 图谱，影响分析以代码反查为最终依据（防链路腐化漏报）
• 存量业务文档自然过渡：下次 整合/深度拆解 更新 时顺带结构化，不专门跑改造

v0.7.14：组件影响＋布局图

组件文档两项增强：

/dev-review 组件影响 <组件名或路径>——改组件前反向映射

• 代码反查为准（全项目搜引用），组件卡「使用方」交叉核对：新增的补进卡、失效的标废弃
• 影响清单：受影响模块/页面 → 业务文档 → 各模块缺陷史（每个使用方都要回归）
• 可生成「组件变更」需求（待审核）：影响面写进边界、每个使用方一条验收点；落地后 组件登记 刷新卡、整合 并回业务文档
• 文档里的 [[组件]] 双链在组件卡反向链接面板可见
• 钩子：需求改共享组件先跑影响分析；开工波及共享组件先反查、逐一回归

组件卡新增布局草图

• 读组件 build / Widget 树画区域级 ASCII 草图（代码块内框出分区与子元素位置，不抠像素）；单一控件写「无内部布局」
• 组件解析/组件登记 建卡时画；组件布局改了重画

v0.7.13：组件标签化定位

解决组件多了不好定位、该选哪个的问题：

• 双维受控标签：_标签.md 词表登记两维合法值——能力（干什么）/ 场景（用在哪），治理同概念卡：作者定标签，AI 只能从表里取、缺的提议
• Obsidian 原生层级标签：组件卡带 #能力/xx #场景/yy，可全局搜索、标签面板过滤
• 索引按能力分组：翻开 _索引.md 按能力标签找候选，不用一个个翻文件
• 组件查 标签优先：需求描述 → 能力/场景关键词 → 标签命中缩小范围 → 读卡定夺 → 推荐＋最小用法

v0.7.12：组件子命令（复用注册表）

新增组件复用能力，防止 AI 重复造轮子：

• /dev-review 组件解析 [模块]：扫描组件目录（Flutter presentation/widgets/＋lib/shared/widgets/；iOS View 目录）建组件卡（路径/职责/参数 API/最小示例/使用方）＋ _索引.md；不同模块功能雷同的组件不直接重构——生成「组件抽取」需求文档走审核-开工流程
• /dev-review 组件查 <需求描述>：写 UI 前按描述推荐复用哪个组件＋最小用法；没有合适的直说
• /dev-review 组件登记 <路径>：新交付的可复用组件补卡入库
• 流程钩子：需求阶段标注「优先复用：[[组件]]」；开工写 UI 前必查组件文档；交付新组件时登记

至此知识资产三层齐了：概念卡（业务语义）＋接口文档（后端契约）＋组件文档（UI 复用）。

v0.7.11：整合子命令（业务文档保鲜）

新增 /dev-review 整合 [模块]：把已完结任务的改动增量并回业务文档，解决「深度拆解快照过期」问题。

• 收集增量：模块下 完结/已交付 且无「已整合」标记的任务文档（需求＋交付内容＋缺陷根因）
• 原地更新：按目标目录与业务名匹配业务线文档，更新受影响章节（主流程/业务规则/分支异常/数据依赖），缺章节补一节；矛盾列待人工确认，不硬改
• 盖戳：任务文档加「已整合」时间戳、模块卡更新「业务整合」
• 欠账可见：状态 命令显示各模块未整合任务数；面板点「完结」的提示里也带整合指引
• 与 深度拆解 更新 分工：整合用任务意图做增量（便宜），重拆从代码取事实基准（贵但准）

v0.7.10：接口摄取产出质量

按作者反馈修正摄取产出：

• 缺失字段填「暂无」，不再写「原文未提供」；参数栏为空写「无参数」
• 接口名称 / 说明 / HTTP Method 缺失时可推断：从函数名、路径、参数或既有代码调用推断合理值，逐条列给作者确认后写入；不确认的填「暂无」
• 响应 JSON 一律格式化：json 代码块、2 空格缩进、每字段一行；原文截断的示例排版到可读并注明「原文截断」；散文说明不再塞进代码块

v0.7.9：接口子命令（摄取/变动/比对/列表）

新增外部接口文档能力（每服务一份总汇）：

• /dev-review 接口摄取 <来源> [服务名]：网页 / 表格 / txt / word / 粘贴 等任意格式 → 规范化成 docs/接口文档/<服务>/_接口.md（分组分节、参数表格）；原文没有的标「原文未提供」不编造；原始快照存 _源.<ext>
• /dev-review 接口变动 <服务>：按记录的来源重新获取 → 字段级变动清单（新增/删除/变更）→ 更新接口文档与 _索引.md；问询后可在开发文档里生成适配需求（待审核，走审核-开工流程）
• /dev-review 接口比对 <服务> [模块]：接口文档对照代码调用点与开发文档，报告：文档有代码未用 / 代码在用文档没有 / 参数路径漂移
• /dev-review 接口列表：刷新并展示 _索引.md，Obsidian 打开即可总览全部服务

接口文档是 vault 普通 markdown（搜索/阅读/双链可用），不在任务面板做状态流转；接口命令不改业务代码（一律走 需求/变更）。新增中英直达入口 ×8。