# dsh-provider-usage 分层重构遗留跟踪(#670 收尾后) ## 背景 #670「重构 dsh-provider-usage 分层架构(契约基线 v4 实施:阶段零→收尾)」已全部合入并关闭(PR #671/#675/#677/#679/#680)。本 issue 汇总重构过程中明确记录、但不在 #670 范围内的遗留项,逐项跟踪;各单项可拆独立 issue 处理。 ## 遗留清单 ### A. 变异/测试健康度(建议优先) - [ ] **A1 · 装配段变异覆盖强化**:apply/sanitize 段单段 covered ~30%(阶段二既有状况;CI 按包聚合判分 71.41% ≥ 60 不卡)。方向:apply.ts 接线面、sanitize 边界补单元/集成断言。验收:两段 covered 显著回升。 - [ ] **A2 · aggregator 内部出错点直连错误面**:阶段三 B 的 `src/domain2/common/errsurf.ts` 已提供 `LayerErrorSurface.record` 接口 + `makeNoopLayerErrorSurface` 空参实现,但 aggregator 内部记账/rollup 结构性异常尚未经 `record` 上报(现仅经 TrendTracker.warn 出口间接覆盖)。验收:aggregator 内部异常进错误面计数。 - [ ] **A3 · aggregate 层真实故障崩溃注入冒烟**:压实/刷盘失败的端到端注入未做(需 store 故障注入桩);现以模块级注入 + apply 集成断言覆盖,执行器/调度器为真实出口。验收:故障注入后错误面记录生效且 /health layerErrors 反映。 ### B. 架构收口(需评审) - [ ] **B1 · client→shared 直引根治**:`src/client/**` 直引 shared 实现文件 8 条(core.ts×2、index.tsx、settings×2、providers×2、trend-math.ts),因 client 走 `shared/interface.ts` 会把 `node:fs`/schemastery 拉进 browser bundle 而豁免(门禁 client from 侧豁免 + shared/interface.ts 头部 why 注释)。方向:拆 client-safe 子面(超出 #670 计划树,需方案评审)。 - [ ] **B2 · verify-dir-imports 子层静态强制评估**:跨目录判定按 src 顶层目录(apply/domain1/domain2/shared 间);`domain1/*`、`domain2/*` 层间直引已人工收口但无门禁兜底;符号存在性解析器为务实正则(极端形态如条件导出不保证)。方向:评估子层纳入静态检查或固化软报告。 ### C. 文档(低优先) - [x] **C1 · 内部计划/架构文档过期描述同步**(✅ PR #686):plan 改写为「架构现状与决策记录」、next-session 交接文档归档 docs/archive/、layer-architecture 契约基线同步目录化后「文件·符号」路径(24+ 处)并补 D-17;另按用户要求完成源码注释清理(66 文件去 #NNN/阶段标记只留技术 why) ## 备注(不跟踪) - 变异基线路径对齐重建由 observe 夜间四班次自动执行(#670 阶段四 mutate 路径变化,covered 不变)。 - stryker `excludes "!src/types.ts"` 无效路径为历史遗留、无功能影响,处理时避免越界改变异口径。 - 本会话本地 worktree/分支为一次性资源,不入库跟踪。 ## 关联 - 上游:wingsky-1/dsh-plugin-hub#670(已关闭) - 标签:tech-debt
Activity
wingsky-1 commentedon Sep 10, 2026
C1 完成 + 注释清理:PR #686
layer-architecture-next-session.md归档(docs/archive/);refactor-implementation-plan.md改写为「架构现状与决策记录」(删除阶段零→收尾实施计划/评审过程/实施跟踪);layer-architecture.md契约基线同步目录化后「文件·符号」路径(24+ 处)+ 去评审过程痕迹 + 补 D-17fix(dsh-provider-usage): 恢复三处 dsh-gate:allow-homedir 豁免注释的 issue 编号(#681
chore(dsh-provider-usage): 过期文档以当前架构为准清理 + 源码注释去过程标记(#681) (#686)
wingsky-1 commentedon Sep 10, 2026
C1 + 注释清理合入确认(PR #686)
dsh-gate:allow-homedir豁免注释的#NNN(forbid-homedir-src 的 EXEMPT_RE 要求豁免注释必须携带 issue 编号,该编号是豁免登记格式而非过程标记);已恢复 apply.ts([feature] [meta] dsh-verify-isolated 隔离验证 skill 演进(Meta) #517)/path-resolve.ts(fix(dsh-provider-usage): 适配器添加链路三处缺陷——~路径误拦/输入框纵向撑爆/慢远端并发占满(超时收紧2s) #87)/provider-config.ts(refactor(shared): 抽 shared/dsh-home 单一事实源——4 包 9 处 DSH_HOME 解析收敛(#517) #525) 并复验 OK + 自测 18/18wingsky-1 commentedon Sep 11, 2026
归属指针(#690 正文阶段表为单一权威)
本 issue 保留根因锚点与验收细节;条目的阶段归属与勾选统一以 #690 正文的阶段表为准(见该 issue 的「遗留容器 → 阶段」对照表,评论 2026-09-11 提案 / 待并入正文)。
不再要求在本 issue 内逐条勾选:对应阶段 PR 合并时一次性关单。已落地部分见 #713 的 S2b 回填评论(链接)。
wingsky-1 commentedon Sep 13, 2026
关闭记录(2026-09-13 维护者决定)
本 issue 作为 issue 载体关闭,遗留项随 0.2.5 重构推进(工作项 #768)。