soloforge 1.1.46 → 1.1.48

package/templates/verify//344/274/232/350/257/235/346/201/242/345/244/215.md

@@ -1,46 +0,0 @@
----
-id: ka-checklist-会话恢复
-kind: artifact
-title: 会话恢复
-sync_policy: copy_to_project
-status: active
-extra:
-  name: session-recovery
-  type: artifact
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  domain: verify
-  verification_layer: L2
-  stage: verify
-  owner_mechanism: mc-task-context-lifecycle
----
-
-## 适用场景
-
-每次新会话启动时，AI 必须首先执行上下文对齐，防止在失忆状态下产生无效交付。
-
-## 步骤
-
-1. 调用 sf_task action=query 扫描 .soloforge/state/ 目录获取任务状态
-2. 若 resumed=true：播报中断工单的 task_id、阶段、已完成的产出，询问人类是否继续
-3. 若 resumed=false：工作区干净，正常进入分类流程
-4. 恢复时读取 docs/ 下的前序产出文件
-5. 基于 state/current-task.json 中的 snapshot 字段恢复上下文
-
-## 检查点
-
-- [ ] 已通过 sf_task action=query 获取 resumed 状态
-- [ ] resumed=true 时已向人类展示中断进度
-- [ ] 恢复后的任务阶段与 state 记录一致
-- [ ] 前序产出文件存在且可读
-
-## 注意事项
-
-- AI 禁止在未执行上下文对齐的情况下直接开始新任务
-- 状态文件格式为 JSON，包含 task_id、phase、snapshot、created_at 字段
-- 若 state 文件损坏，标记为 dirty 并向人类报告，不自动忽略

package/templates/verify//345/206/263/347/255/226/345/256/214/346/225/264/346/200/247/345/256/241/346/237/245.md

@@ -1,71 +0,0 @@
----
-id: ka-review-rule-决策完整性审查规则
-kind: guidance
-title: 决策完整性审查
-sync_policy: copy_to_project
-status: active
-triggers:
-  - design
-  - 架构决策
-  - decision review
-extra:
-  name: decision-completeness-review
-  type: constraint
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.2.0
-  last_reviewed: '2026-06-04'
-  domain: verify
-  verification_layer: L2
-  stage: verify
-  owner_mechanism: mc-architecture-decision-workshop
----
-
-# 决策完整性审查规则
-
-## DEC-01: 六域决策覆盖完整性
-
-check_hint: 业务流程、数据、安全、后端、前端、基础设施六域必须有决策记录
-severity: warning
-check_type: semantic
-scope: [backend, frontend]
-description: 每个域至少有一个明确的决策点；与当前需求无关的域可以标注"不适用"但不得留空
-evidence_required:
-  - "六域决策覆盖列表"
-  - "每域决策记录路径或不适标注"
-
-## DEC-02: 每个决策有量化依据
-
-check_hint: 决策记录必须包含选型理由、对比方案和量化指标
-severity: warning
-check_type: semantic
-scope: [backend, frontend]
-description: 决策不得仅写"选择 X"，必须包含：为什么选 X、对比了哪些方案、用什么指标衡量的
-evidence_required:
-  - "决策记录路径"
-  - "选型理由+对比方案+量化指标确认"
-
-## DEC-03: 用户确认证据存在
-
-check_hint: 每个关键决策必须有用户确认记录
-severity: warning
-check_type: semantic
-scope: [backend, frontend]
-description: 涉及架构、技术栈、数据结构、API 设计的关键决策，必须有用户确认的证据（确认文本或审批记录）
-evidence_required:
-  - "用户确认记录路径"
-  - "确认时间+确认内容"
-
-## DEC-04: 决策可追溯
-
-check_hint: 每个决策必须关联到具体的需求点
-severity: warning
-check_type: semantic
-scope: [backend, frontend]
-description: 决策不能凭空产生，必须能追溯到触发它的需求或问题；无需求对应的决策标注为"技术优化"
-evidence_required:
-  - "决策-需求追溯映射表"

package/templates/verify//345/210/206/351/241/265/346/237/245/350/257/242.md

@@ -1,41 +0,0 @@
----
-id: ka-pattern-api-pagination
-kind: knowledge
-title: 分页查询
-sync_policy: copy_to_project
-status: active
-extra:
-  name: api-pagination
-  scope:
-    - backend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  domain: verify
-  verification_layer: L2
-  stage: verify
-  owner_mechanism: mc-backend-pattern
----
-
-## 决策规则
-- 必须使用数据库分页查询（LIMIT/OFFSET），禁止内存 subList 分页
-- 必须限制最大 pageSize（不超过 100）
-- 排序字段必须使用白名单校验，禁止直接拼接用户输入
-- 深分页（page > 1000）必须使用游标分页替代 OFFSET
-- 分页响应必须包含 total、page、size、totalPages 字段
-- 深分页（offset > 10000）必须使用游标分页或子查询优化，禁止直接 OFFSET
-- 分页查询禁止使用 SELECT *，必须指定所需字段
-- 排序字段必须是索引列，禁止对非索引列排序导致全表扫描
-- 前端分页控件必须显示总条数和页码跳转
-
-## 验收项
-- [AC-01] page >= 1 且 1 <= size <= 100
-- [AC-02] 使用数据库分页而非内存分页
-- [AC-03] 响应含 total/page/size/totalPages
-- [AC-04] 排序字段白名单校验
-- [AC-05] 深分页有优化策略
-- [AC-06] 排序字段使用索引列
-- [AC-07] 前端有页码跳转

package/templates/verify//345/211/215/347/253/257/351/241/265/351/235/242.md

@@ -1,40 +0,0 @@
----
-id: ka-artifact_template-frontend-page
-kind: artifact
-title: 前端页面
-sync_policy: copy_to_project
-status: active
-extra:
-  name: frontend-page
-  scope:
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: artifact
-  domain: verify
-  stage: verify
-  owner_mechanism: mc-artifact-contract
----
-
-## 验收项
-- [AC-01] 组件有明确的 Props 类型定义，无 any 类型 (check: grep -c 'any\b' {file})
-- [AC-02] API 调用封装在 service 层，不直接在组件中 fetch (check: grep -c 'fetch\|axios\.\|httpClient\.' {file})
-- [AC-03] 表单有校验规则（必填/长度/格式） (check: grep -c 'required\|validator\|rules' {file})
-- [AC-04] 列表页面有 loading 状态和空数据提示 (check: grep -c 'loading\|empty\|暂无数据\|skeleton' {file})
-- [AC-05] 错误状态有用户友好提示，不直接展示技术错误信息 (check: grep -c 'message\.error\|notification\|Toast\|错误提示' {file})
-- [AC-06] 分页列表使用服务端分页，无全量加载 (check: grep -c 'pagination\|pageSize\|current\|pageNum' {file})
-- [AC-07] 无硬编码的 URL 或魔法字符串，API 路径使用常量管理 (check: grep -c "'/api/" {file})
-- [AC-08] useEffect 依赖数组完整，无遗漏依赖警告 (check: grep -A1 'useEffect' {file} | grep -c '\[\]')
-- [AC-09] 事件处理函数有类型注解 (check: grep -c 'React.MouseEvent\|React.ChangeEvent\|event:' {file})
-- [AC-10] 生产代码无 console.log 调试输出 (check: grep -c 'console\.log' {file})
-- [AC-11] 页面是否处理 loading/empty/error 三态 (check: grep -c 'loading\|empty\|error\|Spin\|Empty\|ErrorBoundary' {file})
-- [AC-12] 接口调用是否有错误提示（toast/notification） (check: grep -c 'message\.error\|notification\.error\|Toast\|showError' {file})
-- [AC-13] 表单是否有输入校验和错误提示 (check: grep -c 'form\.validate\|getFieldError\|validateFields\|help\|validateStatus' {file})
-- [AC-14] 危险操作（删除/清空）是否有二次确认弹窗 (check: grep -c 'confirm\|Modal\.confirm\|popconfirm\|二次确认' {file})
-- [AC-15] 列表页是否有分页（非一次性全量加载） (check: grep -c 'Pagination\|pagination\|onChange.*page\|onPageChange' {file})
-- [AC-16] 是否支持响应式布局（移动端适配） (check: grep -c 'media\|responsive\|@media\|flex-wrap\|grid' {file})
-- [AC-17] 图片是否有懒加载（大量图片场景） (check: grep -c 'lazy\|LazyLoad\|loading="lazy"\|IntersectionObserver' {file})
-- [AC-18] 是否有无障碍支持（键盘导航、颜色对比度） (check: grep -c 'aria-\|role=\|tabIndex\|alt=\|htmlFor' {file})

package/templates/verify//345/216/206/345/217/262/346/225/260/346/215/256/346/270/205/346/264/227/350/204/232/346/234/254.md

@@ -1,55 +0,0 @@
----
-id: 历史数据清洗脚本
-kind: artifact
-title: 历史数据清洗脚本
-sync_policy: copy_to_project
-status: active
-extra:
-  name: historical-data-cleanup-script
-  type: artifact
-  scope:
-    - '*'
-  domain: verify
-  lifecycle_status: active
-  stage: verify
-  owner_mechanism: mc-existing-system-artifact
----
-
-# 历史数据清洗脚本
-
-## 1. 清洗目的
-<!-- 为什么要做数据清洗 -->
-
-## 2. 清洗范围
-- 目标表：<!-- 表名 -->
-- 数据条件：<!-- 清洗条件 -->
-
-## 3. 清洗逻辑
-
-```sql
--- 清洗脚本
--- 注意：执行前备份目标表
-
--- 备份
-CREATE TABLE <!-- 表名 -->_backup_YYYYMMDD AS SELECT * FROM <!-- 表名 -->;
-
--- 清洗
-<!-- 清洗SQL -->
-
--- 验证
-SELECT COUNT(*) FROM <!-- 表名 --> WHERE <!-- 条件 -->;
-
--- 验证通过标准
--- 预期影响行数：<!-- N 行 -->
--- 允许偏差：± <!-- X% -->
--- 执行超时：<!-- 如 30 分钟 -->
-
-```
-
-## 4. 回滚方案
-```sql
--- 回滚
-INSERT INTO <!-- 表名 --> SELECT * FROM <!-- 表名 -->_backup_YYYYMMDD;
-
--- 回滚前确认：备份表行数 = 清洗前原表行数
-```

package/templates/verify//345/217/221/345/270/203/345/220/216/345/256/241/346/237/245.md

@@ -1,73 +0,0 @@
----
-id: ka-review-rule-发布后审查规则
-kind: guidance
-title: 发布后审查
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 发布后
-  - 上线观察
-  - post-release review
-extra:
-  name: post-release-review
-  type: constraint
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.2.0
-  last_reviewed: '2026-06-04'
-  domain: verify
-  verification_layer: L2
-  stage: verify
-  owner_mechanism: mc-delivery-gate
----
-
-# 发布后审查规则
-
-## REL-01: 监控指标在阈值内
-
-check_hint: 发布后关键监控指标必须在正常范围内
-severity: error
-check_type: deterministic
-scope: [backend, frontend]
-description: 错误率、响应时间、吞吐量等关键指标在发布后 30 分钟内必须在历史基线 ±20% 范围内。监控指标必须通过，不得为建议项。
-evidence_required:
-  - "监控指标报告路径"
-  - "错误率/响应时间/吞吐量数值"
-  - "与基线对比结果（须在 ±20% 范围内）"
-
-## REL-02: 无新增告警
-
-check_hint: 发布后不得产生新的异常告警
-severity: warning
-check_type: deterministic
-scope: [backend, frontend]
-description: 发布后检查告警系统，不得有因本次发布新增的错误日志或异常告警
-evidence_required:
-  - "告警系统检查结果"
-  - "新增告警列表（须为空）"
-
-## REL-03: 回滚预案已验证
-
-check_hint: 回滚操作必须在发布前验证过
-severity: warning
-check_type: deterministic
-scope: [backend, frontend]
-description: 回滚预案必须经过实际演练或自动化验证，确认回滚操作可在 5 分钟内完成
-evidence_required:
-  - "回滚预案文档路径"
-  - "演练/验证记录"
-
-## REL-04: 数据一致性确认
-
-check_hint: 发布后必须验证数据一致性
-severity: warning
-check_type: deterministic
-scope: backend
-description: 涉及数据库变更的发布，发布后必须验证新老数据的一致性（数据校验脚本通过）
-evidence_required:
-  - "数据一致性校验脚本路径"
-  - "校验结果（须通过）"

package/templates/verify//345/220/216/347/253/257API.md

@@ -1,39 +0,0 @@
----
-id: ka-artifact_template-backend-api
-kind: artifact
-title: 后端API
-sync_policy: copy_to_project
-status: active
-extra:
-  name: backend-api
-  scope:
-    - backend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: artifact
-  domain: verify
-  stage: verify
-  owner_mechanism: mc-backend-implementation-contract
----
-
-## 验收项
-- [AC-01] Controller 层无业务逻辑（无 if/else 分支、计算、状态机） (check: grep -rn 'if\s*(.*>.*)\|if\s*(.*< .*)' {file} --include='*Controller.java')
-- [AC-02] DTO 与 Entity 分离，请求/响应使用 DTO，不直接暴露 Entity (check: grep -c 'Entity\|@Table' {file} && grep -c 'class.*DTO\|class.*Request\|class.*Response' {file})
-- [AC-03] 写操作 Service 方法有 @Transactional 注解 (check: grep -B2 'public.*save\|public.*update\|public.*delete\|public.*create' {file} | grep -c '@Transactional')
-- [AC-04] 批量操作使用 batch SQL，无循环内逐条调用 (check: grep -A5 'for\s*(' {file} | grep -c 'mapper\.\|repository\.\|dao\.')
-- [AC-05] 删除操作记录操作人和原因 (check: grep -A5 'delete\|remove' {file} | grep -c 'operator\|reason\|操作人')
-- [AC-06] 所有异常经全局异常处理器返回，无散落 try-catch 吞异常 (check: grep -c 'catch\s*(.*Exception\s*\w*)\s*\{\s*\}' {file})
-- [AC-07] 接口有 @Valid 或手动参数校验，不信任外部输入 (check: grep -c '@Valid\|@NotNull\|@NotBlank\|@Size\|validate' {file})
-- [AC-08] 关键写操作有 INFO 级别审计日志（操作者/时间/对象） (check: grep -c 'log\.info\|auditLog\|操作日志' {file})
-- [AC-09] 日志中无敏感信息（密码/token/身份证号） (check: grep -ic 'password\|token\|secret\|idcard\|身份证' {file})
-- [AC-10] 权限检查注解到位（@PreAuthorize 或自定义鉴权） (check: grep -c '@PreAuthorize\|@RequiresPermissions\|checkPermission' {file})
-- [AC-11] API 是否有版本号路径前缀（/api/v1/） (check: grep -c '@RequestMapping.*"/api/v[0-9]' {file})
-- [AC-12] 写接口是否有幂等设计（幂等键或唯一约束） (check: grep -c 'Idempotent\|幂等\|idempotent' {file})
-- [AC-13] 分页接口是否返回标准分页结构（total、list、pageNum、pageSize） (check: grep -c 'PageResult\|PageInfo\|PageResponse\|total.*list' {file})
-- [AC-14] 是否有全局统一错误码体系 (check: grep -c 'ErrorCode\|BizCode\|ResultCode\|错误码' {file})
-- [AC-15] 接口文档是否与实现同步（Swagger/OpenAPI 注解完整） (check: grep -c '@ApiOperation\|@Schema\|summary' {file})
-- [AC-16] 是否有速率限制保护 (check: grep -c '@RateLimit\|RateLimiter\|限流\|rate' {file})
-- [AC-17] 批量操作是否有数量上限（≤ 500 条） (check: grep -c '@Size.*max\|MAX_BATCH\|batchSize\|批量上限' {file})

package/templates/verify//345/242/236/345/210/240/346/224/271/346/237/245.md

@@ -1,45 +0,0 @@
----
-id: ka-pattern-crud-operation
-kind: knowledge
-title: 增删改查
-sync_policy: copy_to_project
-status: active
-extra:
-  name: crud-operation
-  scope:
-    - backend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  domain: verify
-  verification_layer: L2
-  stage: verify
-  owner_mechanism: mc-backend-pattern
----
-
-## 决策规则
-- 必须遵循 Controller → Service → Mapper/Repository 三层分离
-- 禁止 Controller 包含业务逻辑（if/else 分支、计算、状态机）
-- 禁止 DTO 和 Entity 混用，外部请求不可直接操作数据库字段
-- 批量操作禁止在循环中逐条调用数据库
-- 写操作 Service 方法必须有 @Transactional 注解
-- 删除操作必须记录操作人和原因
-- 列表查询接口必须返回分页结构（total、list、pageNum、pageSize），禁止返回全量数据
-- 创建/更新接口必须返回完整实体或 ID，禁止返回 void
-- 逻辑删除必须使用统一字段（如 is_deleted），禁止物理删除业务数据
-- 并发更新场景必须使用乐观锁（version 字段或更新时间条件），防止数据覆盖
-- 批量更新/删除操作必须有数量上限（如 ≤ 500 条），防止大批量锁表
-
-## 验收项
-- [AC-01] Controller 无业务逻辑
-- [AC-02] DTO/Entity 分离
-- [AC-03] 写操作有事务注解
-- [AC-04] 批量操作使用 batch SQL
-- [AC-05] 删除有审计记录
-- [AC-06] 列表查询返回分页结构
-- [AC-07] 创建/更新返回完整数据
-- [AC-08] 逻辑删除而非物理删除
-- [AC-09] 并发更新有乐观锁保护

package/templates/verify//345/244/226/351/203/250/344/276/235/350/265/226.md

@@ -1,43 +0,0 @@
----
-id: ka-pattern-external-dependency
-kind: knowledge
-title: 外部依赖
-sync_policy: copy_to_project
-status: active
-extra:
-  name: external-dependency
-  scope:
-    - backend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  domain: verify
-  verification_layer: L2
-  stage: verify
-  owner_mechanism: mc-backend-pattern
----
-
-## 决策规则
-- 每个外部依赖调用必须定义超时时间，禁止无限等待
-- 需要重试时必须同时定义幂等或去重策略，避免重复副作用
-- 需要降级时必须定义：降级行为、用户提示、恢复条件
-- 新增配置项必须文档化：默认值、环境差异、灰度方式、回滚策略
-- 外部调用失败必须有区别于业务异常的错误码和用户提示
-- 外部依赖必须设置合理的超时时间（连接超时 + 读超时），禁止无限等待
-- 外部依赖调用必须有熔断保护，连续失败 N 次自动熔断
-- 外部依赖必须有降级策略（返回缓存数据/默认值），不能因为依赖故障拖垮主流程
-- 第三方库版本必须锁定（package-lock.json / Gradle version），禁止使用 latest 或范围版本
-- 外部依赖的健康检查必须纳入监控，响应时间/成功率异常时触发告警
-
-## 验收项
-- [AC-01] 外部调用有超时配置
-- [AC-02] 重试操作有幂等/去重策略
-- [AC-03] 降级场景有用户提示和恢复条件
-- [AC-04] 外部调用失败有独立错误码
-- [AC-05] 外部调用有超时配置
-- [AC-06] 有熔断和降级策略
-- [AC-07] 依赖版本锁定
-- [AC-08] 依赖健康检查有监控

package/templates/verify//345/245/221/347/272/246/345/205/274/345/256/271.md

@@ -1,42 +0,0 @@
----
-id: ka-pattern-contract-compatibility
-kind: knowledge
-title: 契约兼容
-sync_policy: copy_to_project
-status: active
-extra:
-  name: contract-compatibility
-  scope:
-    - backend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  domain: verify
-  verification_layer: L2
-  stage: verify
-  owner_mechanism: mc-backend-pattern
----
-
-## 决策规则
-- API 契约是前后端对齐的唯一信源，每次变更必须有 diff 记录和版本说明
-- 变更必须前向兼容，破坏性变更必须标记 deprecated 并提供至少一个完整版本的过渡期
-- 新增必填请求字段、删除字段、改变字段类型、修改路径、改变错误码含义均为破坏性变更，需要废弃流程
-- 每次契约变更必须同步更新接口文档和 schema 定义
-- 禁止前后端口头约定替代正式契约变更
-- 新增可选字段必须设默认值，保证旧客户端兼容
-- 枚举类型新增值必须评估对所有消费方的影响
-- 删除字段必须分阶段：先标记 @Deprecated → 确认无消费方 → 下版本移除
-- 数据库字段变更必须兼容旧代码（先加新字段 → 迁移数据 → 再删旧字段）
-- API 路径变更必须保留旧路径并重定向，给予消费方充足迁移时间
-
-## 验收项
-- [AC-01] 接口变更有 diff 记录
-- [AC-02] 破坏性变更有 deprecated 过渡期
-- [AC-03] 文档与 schema 同步更新
-- [AC-04] 无口头约定的非正式变更
-- [AC-05] 新字段有默认值
-- [AC-06] 删除字段分阶段进行
-- [AC-07] 数据库变更兼容旧代码

package/templates/verify//345/256/232/346/227/266/344/273/273/345/212/241.md

@@ -1,39 +0,0 @@
----
-id: ka-pattern-scheduled-task
-kind: knowledge
-title: 定时任务
-sync_policy: copy_to_project
-status: active
-extra:
-  name: scheduled-task
-  scope:
-    - backend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  domain: verify
-  verification_layer: L2
-  stage: verify
-  owner_mechanism: mc-backend-pattern
----
-
-## 决策规则
-- 多实例部署的定时任务必须使用分布式锁，禁止裸 @Scheduled
-- 每次执行必须记录状态（开始/结束时间、结果、错误信息）
-- 执行失败必须有告警通知（钉钉/邮件/Slack）
-- 任务执行时间不得超过调度间隔的一半，防止堆积
-- 失败任务必须有重试机制（建议最多 3 次）
-- 定时任务必须配置超时时间，防止任务卡死影响后续调度
-- 定时任务禁止使用固定间隔执行长事务，必须拆分为小批次处理
-- 定时任务必须有手动触发入口（管理后台或 API），便于紧急修复数据
-
-## 验收项
-- [AC-01] 分布式锁防重复执行
-- [AC-02] 每次执行记录状态
-- [AC-03] 失败有告警通知
-- [AC-04] 执行时间不超调度间隔一半
-- [AC-05] 任务有超时配置
-- [AC-06] 有手动触发入口

package/templates/verify//345/256/236/346/227/266/346/216/250/351/200/201.md

@@ -1,48 +0,0 @@
----
-id: ka-pattern-websocket-realtime
-kind: knowledge
-title: 实时推送
-sync_policy: copy_to_project
-status: active
-extra:
-  name: websocket-realtime
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  domain: verify
-  verification_layer: L2
-  stage: verify
-  owner_mechanism: mc-general-pattern
----
-
-## 决策规则
-- WebSocket 连接必须有心跳机制（建议 30s），检测断线并自动重连
-- 重连必须使用指数退避策略（1s/2s/4s/8s/max 30s），禁止无限重试
-- 消息必须有序号或时间戳，消费端处理乱序和去重
-- 连接异常断开时，未确认消息必须有补偿机制（重新拉取 / 离线消息队列）
-- 后端推送频率必须有熔断保护，防止消息风暴压垮客户端
-- 单向推送优先使用 SSE（更简单），双向通信才使用 WebSocket
-- 生产环境 WebSocket 必须通过 Nginx 反向代理，配置超时和连接数限制
-- 前端组件卸载时必须关闭 WebSocket 连接，防止内存泄漏
-- WebSocket 连接必须有自动重连机制（指数退避策略），断线后自动恢复
-- 推送消息必须携带消息 ID 和时间戳，支持客户端去重和排序
-- 服务端必须实现消息缓冲，用户短暂离线后重连可获取未读消息
-- 推送消息体必须精简（≤ 4KB），大数据通过接口拉取，不通过推送传输
-- 必须支持优雅降级（WebSocket → SSE → 轮询），兼容不同网络环境
-
-## 验收项
-- [AC-01] 有心跳和自动重连机制
-- [AC-02] 重连使用指数退避
-- [AC-03] 消息有去重处理
-- [AC-04] 组件卸载关闭连接
-- [AC-05] 未确认消息有补偿机制
-- [AC-06] 自动重连机制
-- [AC-07] 消息去重和排序
-- [AC-08] 离线消息缓冲
-- [AC-09] 降级策略（WS→SSE→轮询）

package/templates/verify//345/256/241/346/237/245/346/221/230/350/246/201.md

@@ -1,58 +0,0 @@
----
-id: ka-artifact_template-审查摘要
-kind: artifact
-title: 审查摘要
-sync_policy: copy_to_project
-status: active
-extra:
-  name: review-summary
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.2.0
-  last_reviewed: '2026-06-04'
-  type: artifact
-  domain: verify
-  stage: verify
-  owner_mechanism: mc-verifier
----
-
-## 摘要格式规范
-
-每个白盒审查项必须生成压缩摘要，格式为:
-`[文件名:行号] 维度: 标题`
-
-示例:
-```text
-[llm_gateway.ts:156] security: Token 预算未检查
-[evolver.ts:42] quality: 知识提取逻辑缺失空值守卫
-```
-
-## 维度覆盖
-维度覆盖: 安全✅ 性能✅ 并发✅ 架构✅ SOLID✅ 契约✅ 可维护性✅ 交付✅ 决策❌ 交叉验证✅
-AI 盲区维度: [列出未覆盖维度及建议补充方式]
-
-## 汇报格式
-
-```text
-审查结果: X 项发现
-- 白盒 (可跳过): N 项 — [一句话汇总]
-- 灰盒 (需签署): N 项 — [逐项展示 + 抽检回溯摘要流]
-- 黑盒 (强制签署): N 项 — [逐项展示 + 等待 [Human-Audit: APPROVED]]
-```
-
-## 抽检哨兵规则
-
-- 每处理 10 个白盒项，强制随机升级 1 个为灰盒
-- 升级时自动渲染前置白盒摘要流（spot_check_backtrace）
-- 摘要流格式: 连续的白盒项摘要，供人类快速回溯
-- 人类审计时随机提问: 基于任务摘要生成是/否问题，校验审计真实性
-
-## 回溯链路
-
-1. 白盒项分类时自动缓存到 summaryCache（模块级 Map）
-2. 抽检哨兵触发时从缓存渲染所有白盒摘要
-3. renderSummaryBacktrace(taskId) 支持回溯任意历史任务
-4. 回溯摘要附加到 CodeReviewResult.spot_check_backtrace