dsh-git-push 2.9.4 → 2.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (80) hide show
  1. package/README.md +42 -39
  2. package/lib/app/apply.js +8 -1
  3. package/lib/app/audit-api.js +4 -1
  4. package/lib/app/command-registry.js +18 -11
  5. package/lib/app/handlers/meta.js +38 -0
  6. package/lib/app/handlers/repo-actions.js +3 -1
  7. package/lib/app/handlers/repos.js +18 -2
  8. package/lib/app/handlers/settings.js +0 -0
  9. package/lib/app/http-handlers.js +3 -1
  10. package/lib/app/schema.js +0 -0
  11. package/lib/app/settings-bridge.js +0 -0
  12. package/lib/app/tool-call.js +32 -23
  13. package/lib/ast/brace.js +15 -0
  14. package/lib/ast/control-flow.js +12 -3
  15. package/lib/ast/size.js +73 -3
  16. package/lib/audit/audit-file.js +4 -2
  17. package/lib/audit/collector.js +13 -4
  18. package/lib/audit/file-context.js +89 -0
  19. package/lib/audit/finding.js +16 -2
  20. package/lib/audit/ignore-blind.js +5 -4
  21. package/lib/audit/index.js +2 -2
  22. package/lib/audit/orchestrate.js +2 -1
  23. package/lib/audit-rules/audit-rules-frontend.yml +4 -4
  24. package/lib/checks/button-bind.js +84 -13
  25. package/lib/checks/dispatch.js +1 -1
  26. package/lib/checks/private.js +2 -1
  27. package/lib/checks/structural.js +10 -3
  28. package/lib/client-parts/{10-account.js → account.js} +1 -1
  29. package/lib/client-parts/{41-actions.js → actions.js} +3 -2
  30. package/lib/client-parts/{99-apply.js → apply.js} +2 -1
  31. package/lib/client-parts/{21-audit.js → audit.js} +5 -5
  32. package/lib/client-parts/{11-browser.js → browser.js} +15 -4
  33. package/lib/client-parts/{01-const.js → const.js} +11 -5
  34. package/lib/client-parts/{40-controller.js → controller.js} +4 -4
  35. package/lib/client-parts/{03-icons.js → icons.js} +1 -1
  36. package/lib/client-parts/{00-loader.js → loader.js} +1 -0
  37. package/lib/client-parts/{23-npm.js → npm.js} +3 -2
  38. package/lib/client-parts/{30-page.js → page.js} +1 -1
  39. package/lib/client-parts/{20-repo.js → repo.js} +2 -2
  40. package/lib/client-parts/{22-settings.js → settings.js} +1 -1
  41. package/lib/client-parts/{02-utils.js → utils.js} +1 -1
  42. package/lib/client.js +51 -30
  43. package/lib/commit-push.js +20 -2
  44. package/lib/context/index.js +2 -1
  45. package/lib/core/atomic-json.js +1 -1
  46. package/lib/core/exec.js +6 -4
  47. package/lib/exempt/index.js +7 -2
  48. package/lib/exempt/tool.js +198 -0
  49. package/lib/git/clone-history-mode.js +24 -5
  50. package/lib/git/index-format.js +182 -0
  51. package/lib/git/index.js +1 -0
  52. package/lib/git/push.js +28 -13
  53. package/lib/git/repo-index.js +41 -30
  54. package/lib/git/scan-runner.js +1 -1
  55. package/lib/git/transport.js +49 -17
  56. package/lib/git/visibility.js +93 -9
  57. package/lib/npm/publish.js +30 -1
  58. package/lib/npm/registry.js +5 -2
  59. package/lib/self/index.js +1 -1
  60. package/package.json +2 -4
  61. package/scripts/build-client.mjs +19 -14
  62. package/scripts/picker-repro.mjs +115 -0
  63. package/skills/dev/dsh-git-push.md +1 -2
  64. package/skills/dsh-repo-index.md +1 -1
  65. package/skills/guide/guide-audit.md +77 -3
  66. package/skills/guide/guide-cli-scripts.md +4 -4
  67. package/skills/guide/guide-clone-repos.md +2 -2
  68. package/skills/guide/guide-inject-ui.md +6 -6
  69. package/skills/workflow/README.md +1 -1
  70. package/assets/minihost.sh +0 -35
  71. package/assets/preview.html +0 -36703
  72. package/lib/fs/edit-after-read.js +0 -142
  73. package/scripts/frontend-preview-check.mjs +0 -124
  74. package/scripts/preview-gen.mjs +0 -489
  75. package/scripts/preview-local-runner.mjs +0 -55
  76. package/scripts/preview-server-direct.mjs +0 -116
  77. package/scripts/preview-server.mjs +0 -305
  78. package/scripts/preview-slot-data.mjs +0 -123
  79. package/scripts/sync-plugin-install.mjs +0 -286
  80. package/scripts/sync-plugin.mjs +0 -284
package/README.md CHANGED
@@ -64,7 +64,7 @@ DSH(DeepSeek Harness)git 提交推送与代码审计插件——提交前自
64
64
 
65
65
  | 文档 | 讲什么 |
66
66
  |---|---|
67
- | [docs/SPEC.md](docs/SPEC.md) | **当前有效规格唯一入口**:身份 / 18 个工具 / 35 条 HTTP 接口 / 20 个设置键 / 4 个数据文件 / 审计规则体系 / 文档产物 / 版本纪律 / 测试基线 |
67
+ | [docs/SPEC.md](docs/SPEC.md) | **当前有效规格唯一入口**:身份 / 18 个工具 / 36 条 HTTP 接口 / 20 个设置键 / 4 个数据文件 / 审计规则体系 / 文档产物 / 版本纪律 / 测试基线 |
68
68
  | [docs/功能-审计规则体系.md](docs/功能-审计规则体系.md) | 22 个规则槽位 / 165 条规则的组织方式、作用域字段、三层结构、运行入口、结果怎么读、怎么豁免 |
69
69
  | [docs/功能-历史提交审计.md](docs/功能-历史提交审计.md) | 逐提交回放审计:解决什么、怎么跑、与普通审计的差异与成本 |
70
70
  | [docs/功能-文档与结构追踪.md](docs/功能-文档与结构追踪.md) | tree-doc / doc-func / doc-version 三份自动生成文档怎么更新、漂移怎么办 |
@@ -371,20 +371,20 @@ dsh-git-push/
371
371
  │ ├── client/ — 客户端配置(DEFAULT_CONFIG + SETTINGS_SCHEMA 侧边栏设置项定义)
372
372
  │ │ ├── index.js — 侧边栏设置 UI 总入口(DEFAULT_CONFIG + SETTINGS_SCHEMA)
373
373
  │ ├── client-parts/ — 客户端分片源码(13 片,拼接成 lib/client.js;产物不入库)
374
- │ │ ├── 00-loader.js — 首片:__ModuleLoader__.load + factory 头 + require + NS
375
- │ │ ├── 01-const.js — [1] 常量区(忙碌状态键/10 维度表/超时/样式串)
376
- │ │ ├── 02-utils.js — [2] 工具区(ensureCss/getJson/postJson/localGet/copyText)
377
- │ │ ├── 03-icons.js — [3] 图标区
378
- │ │ ├── 10-account.js — [4] 账号信息 Tab
379
- │ │ ├── 11-browser.js — [5] 目录选择器(browse*)
380
- │ │ ├── 20-repo.js — [6] 仓库管理卡(本地/云端仓库、推送、可见性)
381
- │ │ ├── 21-audit.js — [7] 审计 Tab(权重/规则行/规则包/注入开关)
382
- │ │ ├── 22-settings.js — [8] 设置 Tab(token/SSH/邮箱)
383
- │ │ ├── 23-npm.js — (待注释)
384
- │ │ ├── 30-page.js — [9] 页面装配(GitPushPage 三选项卡聚合)
385
- │ │ ├── 40-controller.js — [10] Controller:状态机 + 数据加载(884 行,跨两片)
386
- │ │ ├── 41-actions.js — [10] Controller:动作注入(269 行)
387
- │ │ ├── 99-apply.js — 末片:apply/inject 导出 + factory 返回
374
+ │ │ ├── account.js — (待注释)
375
+ │ │ ├── actions.js — (待注释)
376
+ │ │ ├── apply.js — (待注释)
377
+ │ │ ├── audit.js — (待注释)
378
+ │ │ ├── browser.js — (待注释)
379
+ │ │ ├── const.js — (待注释)
380
+ │ │ ├── controller.js — (待注释)
381
+ │ │ ├── icons.js — (待注释)
382
+ │ │ ├── loader.js — (待注释)
383
+ │ │ ├── npm.js — (待注释)
384
+ │ │ ├── page.js — (待注释)
385
+ │ │ ├── repo.js — (待注释)
386
+ │ │ ├── settings.js — (待注释)
387
+ │ │ ├── utils.js — (待注释)
388
388
  │ ├── context/ — 上下文注入(给 AI 会话注入环境:目录映射/工具路径/skill 入口)
389
389
  │ │ ├── index.js — 上下文注入入口(环境注入文本)
390
390
  │ ├── core/ — (待注释)
@@ -396,8 +396,7 @@ dsh-git-push/
396
396
  │ │ ├── workspace-paths.js — (待注释)
397
397
  │ ├── exempt/ — 豁免机制(dsh-skip-* 注释标记解析与文件头/行内语义)
398
398
  │ │ ├── index.js — 豁免注册表(dsh-skip-* 全标记消费)
399
- │ ├── fs/ — (待注释)
400
- │ │ ├── edit-after-read.js — (待注释)
399
+ │ │ ├── tool.js — (待注释)
401
400
  │ ├── git/ — Git 执行层(runGit/账号/API/克隆/凭据/推送/扫描/索引维护/敏感扫描/传输通道)
402
401
  │ │ ├── account-status.js — (待注释)
403
402
  │ │ ├── account.js — 账号校验(token 在线 + SSH 公钥指纹,输出账号状态块)
@@ -421,6 +420,7 @@ dsh-git-push/
421
420
  │ │ ├── identity-rewrite.js — (待注释)
422
421
  │ │ ├── identity.js — (待注释)
423
422
  │ │ ├── ignore.js — .gitignore 兜底(DEFAULT_IGNORE_PATTERNS 补齐)
423
+ │ │ ├── index-format.js — (待注释)
424
424
  │ │ ├── index.js — Git 执行层统一出口
425
425
  │ │ ├── module-splitter.js — (待注释)
426
426
  │ │ ├── post-push.js — 推送后增强(remote-tracking ref/aux remote/tag)
@@ -477,18 +477,13 @@ dsh-git-push/
477
477
  │ ├── doc-func.mjs — (待注释)
478
478
  │ ├── doc-tree.mjs — (待注释)
479
479
  │ ├── doc-version.mjs — (待注释)
480
- │ ├── frontend-preview-check.mjs — (待注释)
481
480
  │ ├── hot-path-probe-cjs.cjs — (待注释)
482
481
  │ ├── hot-path-probe-fs-shim.mjs — (待注释)
483
482
  │ ├── hot-path-probe-fsp-shim.mjs — (待注释)
484
483
  │ ├── hot-path-probe.mjs — (待注释)
485
484
  │ ├── module-splitter.py — 巨型单文件按顶层块拆分脚本(analyze/split/verify 三命令,python3 零依赖;module_splitter 工具与 CLI 的底层实现)
485
+ │ ├── picker-repro.mjs — (待注释)
486
486
  │ ├── platform-scan.mjs — (待注释)
487
- │ ├── preview-gen.mjs — (待注释)
488
- │ ├── preview-local-runner.mjs — (待注释)
489
- │ ├── preview-server-direct.mjs — (待注释)
490
- │ ├── preview-server.mjs — 本地真实后端测试服务(preview.html 接真实 handleHttp)
491
- │ ├── preview-slot-data.mjs — (待注释)
492
487
  │ ├── probe-recheck.mjs — 探针:「重新检测」按钮链路实测(在线校验 token/SSH)
493
488
  │ ├── readme-gen.mjs — README 生成独立脚本(git_gen_readme 抽出:模板渲染/版本表/目录)
494
489
  │ ├── rename-locator.mjs — 变量重命名位置定位工具(按作用域聚合引用——单字母变量人工重命名辅助)
@@ -501,14 +496,11 @@ dsh-git-push/
501
496
  │ ├── scan-version.mjs — 版本一致性校验脚本
502
497
  │ ├── scrub-user-wording.mjs — 清理「用户沟通措辞」独立脚本
503
498
  │ ├── symbol-index.mjs — (待注释)
504
- │ ├── sync-plugin-install.mjs — 插件安装形态与免重启热重载自检(被 sync-plugin.mjs 引用)
505
- │ ├── sync-plugin.mjs — 双副本同步脚本(源仓库 → 部署安装副本)
506
499
  │ ├── verify-prestep.mjs — 上下文注入自检脚本(真实触发 agent/pre-step 验证注入)
507
500
  │ ├── audit-ext/ — (待注释)
508
501
  │ │ ├── _example-readme-present.mjs — 审计扩展契约示例(_ 前缀:演示不参与实际审计)
509
502
  │ │ ├── variable-min-length.mjs — 审计扩展:variable-min-length(内置规则抽出试点——统一动态入口)
510
503
  ├── assets/ — 预览页与配图(preview.html 交互模拟页 + 面板截图)
511
- │ ├── minihost.sh — (待注释)
512
504
  │ ├── start.sh — 预览服务器启停脚本(start/stop/restart/status + --port + PID/日志/健康检查 /preview-ping)
513
505
  │ ├── tree-sitter/ — (待注释)
514
506
  │ │ ├── LICENSE — (待注释)
@@ -533,7 +525,9 @@ dsh-git-push/
533
525
  │ ├── test-audit-bad-file.mjs — 审计拦截门禁测试(硬编码密码/API key/.env 凭据文件)
534
526
  │ ├── test-audit-defaults.mjs — (待注释)
535
527
  │ ├── test-audit-empty.mjs — (待注释)
528
+ │ ├── test-audit-exempt-paths.mjs — 提交时按文件临时豁免审计(auditExemptPaths)回归
536
529
  │ ├── test-audit-ext.mjs — 审计扩展自动接入测试(契约加载/降级/match/auditFull 并入)
530
+ │ ├── test-audit-false-positive-guards.mjs — (待注释)
537
531
  │ ├── test-audit-git-boundary.mjs — (待注释)
538
532
  │ ├── test-audit-npm-publish-rules.mjs — (待注释)
539
533
  │ ├── test-audit-push-boundary.mjs — (待注释)
@@ -544,6 +538,7 @@ dsh-git-push/
544
538
  │ ├── test-auto-push.mjs — 任务完成自动推送测试(检测纯函数 + registerAutoPush 门控监听注册)
545
539
  │ ├── test-build-artifact-skip.mjs — 构建/混淆产物跳过专项测试(Pawchive 样本 fixture)
546
540
  │ ├── test-build-client.mjs — 分片构建门禁测试(产物一致/幂等/形态铁律/dshgp_ 前缀)
541
+ │ ├── test-button-bind-events.mjs — (待注释)
547
542
  │ ├── test-button-bind.mjs — 按钮绑定交叉比对(jsx 工厂形态/注释过滤/行号归属)
548
543
  │ ├── test-cli-audit-parity.mjs — CLI 与源码全量审计一致性测试(audit --full --json vs 直接 auditFull,含忽略排除)
549
544
  │ ├── test-cli-help-registry-sync.mjs — (待注释)
@@ -573,11 +568,11 @@ dsh-git-push/
573
568
  │ ├── test-dup-code.mjs — (待注释)
574
569
  │ ├── test-dup-const-idiom.mjs — (待注释)
575
570
  │ ├── test-dup-const.mjs — duplicate-const 规则测试(多语言提取 JS/Kotlin/Java/Go/Rust/Python、模块级过滤、跨文件聚合、test 目录排除、同值不同名不报)
576
- │ ├── test-edit-after-read.mjs — (待注释)
577
571
  │ ├── test-empty-catch-promise.mjs — (待注释)
578
572
  │ ├── test-empty-catch-single-source.mjs — (待注释)
579
573
  │ ├── test-exempt-hint-classify.mjs — (待注释)
580
574
  │ ├── test-exempt-hint-effective.mjs — (待注释)
575
+ │ ├── test-exempt-tool.mjs — (待注释)
581
576
  │ ├── test-exempt.mjs — 豁免总入口测试(7 标记 + 位置语义)
582
577
  │ ├── test-ext-variable-min-length.mjs — (待注释)
583
578
  │ ├── test-false-positive-fixes.mjs — 误报修复回归测试
@@ -591,11 +586,13 @@ dsh-git-push/
591
586
  │ ├── test-git-bin-plan.mjs — (待注释)
592
587
  │ ├── test-git-identity-rewrite.mjs — (待注释)
593
588
  │ ├── test-git-identity.mjs — (待注释)
589
+ │ ├── test-git-path-args.mjs — (待注释)
594
590
  │ ├── test-git.mjs — git 总入口测试(runGit/commitAndPush/凭据/克隆)
595
591
  │ ├── test-gitignore-match.mjs — gitignore 兜底匹配(与真 git 对拍 + 非 git 端到端)
596
592
  │ ├── test-gitignore-nongit-dir.mjs — (待注释)
597
593
  │ ├── test-history-audit.mjs — (待注释)
598
594
  │ ├── test-http.mjs — HTTP 总入口测试(Origin/CSRF/413/路由)
595
+ │ ├── test-index-jsonl.mjs — (待注释)
599
596
  │ ├── test-inject-switch.mjs — 注入开发者要求清单子开关回归
600
597
  │ ├── test-inject-system-prompt.mjs — 注入系统提示词回归
601
598
  │ ├── test-io-risk.mjs — IO 风险分级测试(四级判定/字段完整性/汇总/排序/finding 转换)
@@ -609,6 +606,7 @@ dsh-git-push/
609
606
  │ ├── test-mirror-gates.mjs — (待注释)
610
607
  │ ├── test-module-splitter-multiline.mjs — (待注释)
611
608
  │ ├── test-module-splitter.mjs — module_splitter 工具 + CLI 接入测试(契约 + 行为 + 脚本随插件发布)
609
+ │ ├── test-multi-remote.mjs — (待注释)
612
610
  │ ├── test-name-length-scope.mjs — (待注释)
613
611
  │ ├── test-npm-enobufs.mjs — (待注释)
614
612
  │ ├── test-npm-install.mjs — (待注释)
@@ -618,6 +616,7 @@ dsh-git-push/
618
616
  │ ├── test-perf-loop-collection.mjs — (待注释)
619
617
  │ ├── test-perf-repeat-call.mjs — (待注释)
620
618
  │ ├── test-persist-credentials.mjs — 凭据持久化测试
619
+ │ ├── test-picker-layout.mjs — (待注释)
621
620
  │ ├── test-platform-scan.mjs — (待注释)
622
621
  │ ├── test-plugin.mjs — 插件接线测试(入口导出/工具清单/双副本同步)
623
622
  │ ├── test-private-gate.mjs — (待注释)
@@ -632,9 +631,9 @@ dsh-git-push/
632
631
  │ ├── test-remote-resolve.mjs — (待注释)
633
632
  │ ├── test-rename-locator.mjs — rename-locator 测试(同名不同作用域分组/模块级/过滤)
634
633
  │ ├── test-repo-list.mjs — 仓库列表测试(本地扫描/索引读写/HTTP 端点/远端状态)
634
+ │ ├── test-repos-live-budget.mjs — (待注释)
635
635
  │ ├── test-rule-include-paths.mjs — (待注释)
636
636
  │ ├── test-rule-packs.mjs — 规则总入口测试(编译注册/字段指派)
637
- │ ├── test-rule-slots-render.mjs — 规则包列表统计渲染回归
638
637
  │ ├── test-scan-hardcoded-paths.mjs — (待注释)
639
638
  │ ├── test-scope.mjs — 作用域最小实验测试(分类器/机制/magic 接入)
640
639
  │ ├── test-scrub-conv-wording.mjs — (待注释)
@@ -642,13 +641,11 @@ dsh-git-push/
642
641
  │ ├── test-settings-persistence.mjs — 设置侧边栏持久化专项测试(L1 提交/L2 白名单/L3 回读/L4 消费四层断言)
643
642
  │ ├── test-settings-roundtrip.mjs — (待注释)
644
643
  │ ├── test-sidebar-interaction.mjs — 侧边栏规则包列表交互自检
645
- │ ├── test-sidebar-state.mjs — 设置侧边栏状态自检(设置键回读/凭据已填写判断/统一刷新入口/产物同步)
646
644
  │ ├── test-slash-commands.mjs — 用户输入框 /git-audit 斜杠命令(解析/接线/对本仓库跑 quick)
647
645
  │ ├── test-smart-hint.mjs — 扫描智能提示 + 评分对数衰减测试
648
646
  │ ├── test-status-secret.mjs — token 明文不下发安全回归
649
647
  │ ├── test-symbol-index.mjs — (待注释)
650
648
  │ ├── test-symlink-resolution.mjs — 软链安装依赖解析回归测试(默认失败/--preserve-symlinks/NODE_PATH/真实副本四种场景)
651
- │ ├── test-sync-plugin-install.mjs — (待注释)
652
649
  │ ├── test-task-queue.mjs — 后台化回归测试(官方 job 注册 / 无 jobs 同步保底 / blocker 拦截)
653
650
  │ ├── test-test-cache.mjs — (待注释)
654
651
  │ ├── test-tokenizer-multiline-template.mjs — (待注释)
@@ -705,6 +702,13 @@ dsh-git-push/
705
702
  │ │ ├── task-completion-report.md — (待注释)
706
703
  │ │ ├── tool-json-add-ask.md — (待注释)
707
704
  │ │ ├── versioning-rule.md — (待注释)
705
+ ├── .github/ — (待注释)
706
+ │ ├── workflows/ — (待注释)
707
+ │ │ ├── test.yml — (待注释)
708
+ ├── audit-samples/ — (待注释)
709
+ │ ├── .samples — (待注释)
710
+ │ ├── js-bad.js — (待注释)
711
+ │ ├── py-bad.py — (待注释)
708
712
  ├── .auditignore — 审计豁免清单(不影响 git 入库,仅跳过审计扫描)——排除内置第三方代码
709
713
  ├── .gitignore — 忽略规则(node_modules/产物/备份/回收站等)
710
714
  ├── CONTRIBUTING.md — (待注释)
@@ -973,14 +977,14 @@ console.log(x); // dsh-skip-residue: 本行为刻意保留的调试输出样本
973
977
 
974
978
  ## 界面预览页(assets/preview.html,真实后端数据)
975
979
 
976
- `assets/preview.html` 由 `scripts/preview-gen.mjs` 生成(内联真实 `client.js`,只垫片宿主环境 `window.__ModuleLoader__`/`react`/`settingsScope`/`fetch`,界面与真实插件一致);**用 `assets/start.sh` 启动本地反代服务访问**(服务入口 `scripts/preview-server.mjs`;产物属生成物、不入库,缺失时生成器与 minihost 会自动生成一次):
980
+ `assets/preview.html` 由 **dsh-useful-tools** 的 `preview` 工具生成(`action=gen`)(内联真实 `client.js`,只垫片宿主环境 `window.__ModuleLoader__`/`react`/`settingsScope`/`fetch`,界面与真实插件一致);**用 `assets/start.sh` 启动本地反代服务访问**(服务入口 ``preview` 工具 action=serve(dsh-useful-tools)`;产物属生成物、不入库,缺失时生成器与 minihost 会自动生成一次):
977
981
 
978
982
  ```
979
983
  ./assets/start.sh start [--port 31000] # 启动(默认 30999;已有项目占用时用 --port 错开)
980
984
  ./assets/start.sh status / restart / stop
981
985
  ```
982
986
 
983
- - **完全真实后端数据**:`scripts/preview-server.mjs` 反向代理——`/api/git-push/*` 全部转发到 DSH 真实后端(默认 http://127.0.0.1:30800 反代,`--dsh` 可覆盖),并自动完成 token 认证(`--token` > 环境变量 `DSH_PREVIEW_TOKEN` > 解析 `dsh-proxy.log` 兜底)。预览里的账号信息 / 本地仓库 / 云端仓库 / 规则包 / 审计结果 / 设置**全部来自真实后端**(读取与写入都真实)。
987
+ - **完全真实后端数据**:**dsh-useful-tools** 的 `preview` 工具(`action=serve`)反向代理——`/api/git-push/*` 全部转发到 DSH 真实后端(默认 http://127.0.0.1:30800 反代,`--dsh` 可覆盖),并自动完成 token 认证(`--token` > 环境变量 `DSH_PREVIEW_TOKEN` > 解析 `dsh-proxy.log` 兜底)。预览里的账号信息 / 本地仓库 / 云端仓库 / 规则包 / 审计结果 / 设置**全部来自真实后端**(读取与写入都真实)。
984
988
  - **离线调试**:URL 加 `?mock=1` 切回内置假数据(改动只留页面内、不写文件);跨后端实测用 `?backend=http://127.0.0.1:端口`。
985
989
  - **全部可点**:三选项卡切换 · 审计开关 · **注入系统提示词开关** · 「注入开发者要求清单」子开关(含置灰联动)· 规则包启停与 ↑↓ 调序 · 权重编辑 · token/SSH 保存 · 邮箱一键生成 SSH 并回填
986
990
  - 健康检查 `GET /preview-ping`(start.sh 启动判定);PID 落 `dsh-git-push.pid`(插件根);日志 `assets/preview-server.log`(超 10MB 轮转)
@@ -1012,7 +1016,7 @@ lib/client-parts/00-loader.js loader + factory 头 + require + NS(必须
1012
1016
  语法只对拼起来的产物才有意义)
1013
1017
  ② npm run build:client 按 PART_ORDER 拼接 → 写 lib/client.js(幂等:分片不变则产物逐字节不变)
1014
1018
  ③ npm run check 语法检查(跳过 client-parts)+ **产物新鲜度校验**:client.js 必须与分片拼出来的一致
1015
- ④ node scripts/preview-gen.mjs 用产物重生成预览页,实际点三选项卡确认渲染与交互
1019
+ ④ (用 dsh-useful-tools 的 preview 工具 action=gen 重生成预览页),实际点三选项卡确认渲染与交互
1016
1020
  ```
1017
1021
 
1018
1022
  - **不要手改 `lib/client.js`**:它是构建产物,下次构建即被覆盖,改动静默丢失;`npm run check` 会直接报「产物与分片不一致」。
@@ -1032,7 +1036,7 @@ lib/client-parts/00-loader.js loader + factory 头 + require + NS(必须
1032
1036
 
1033
1037
  ```
1034
1038
  npm run build:client # 先拼产物
1035
- node scripts/preview-gen.mjs # 再用产物重生成预览页
1039
+ (用 dsh-useful-tools 的 preview 工具 action=gen 重生成预览页)
1036
1040
  ```
1037
1041
 
1038
1042
  渲染自检(改了客户端代码或预览生成器后必跑;把「改前端必须真的看一眼」变成一条命令):
@@ -1160,7 +1164,6 @@ token 与 GitHub token 存**同一份** `config.json`(0600,写入走原子
1160
1164
  · git_account_check —— 校验 GitHub 账号与凭据(token 在线校验 + SSH 公钥指纹)
1161
1165
  · git_identity_rewrite —— 提交身份历史改写(非规范身份→登录账号规范身份;默认 dry-run,
1162
1166
  真改写先建备份引用、自检通过才改写,push 用 force-with-lease;只处理本人远端仓库)
1163
- · edit_after_read —— 读改合一编辑(自己读当前文件 → 校验 → 字面替换 → 写回;比宿主编辑守卫更严:读后文件被改动则拒绝写入、old 默认必须唯一匹配、按字面匹配不做正则解释)。**参数名与宿主编辑工具对齐**:path/file_path、old/old_string、new/new_string、all/replace_all 两套都认;**new 必传** —— 缺参数只报错、绝不把内容删掉(删除须显式传空串)
1164
1167
  · git_sluice —— 浅包装 git 透传(AI 直接调用任意 git 命令,凭据自动注入):args 传与 git 一致的参数串,返回 status + stdout/stderr;git 的 log/diff/branch/tag 等其余能力用它
1165
1168
  · git_clone / link_check —— git_clone 从 GitHub 拉仓库:target=owner/repo、dest=目标目录、branch=分支。
1166
1169
  **默认带真实历史**:用 git fetch 取回原始对象,克隆结果与远端 HEAD 逐字节一致(可推回远端、可 git log 读演进),
@@ -1274,7 +1277,7 @@ node scripts/rule-switch.mjs disable comment # 禁用安装版本的 comment
1274
1277
  node scripts/rule-switch.mjs enable comment # 重新启用
1275
1278
  ```
1276
1279
 
1277
- 边界:`nodejs` / `private` 属安全红线强制槽位,禁用会被拦截(返回错误、不写 yml),与 UI 行为一致。注意与 `scripts/sync-plugin.mjs --write` 的协作:同步会按工作区规则文件覆盖部署副本的 disabled 状态(工作区文件里没有 disabled 行则同步后恢复启用)。
1280
+ 边界:`nodejs` / `private` 属安全红线强制槽位,禁用会被拦截(返回错误、不写 yml),与 UI 行为一致。注意与 ``sync_plugin` 工具(write:true)` 的协作:同步会按工作区规则文件覆盖部署副本的 disabled 状态(工作区文件里没有 disabled 行则同步后恢复启用)。
1278
1281
 
1279
1282
  ## 用户输入框斜杠命令
1280
1283
 
@@ -1436,14 +1439,14 @@ node scripts/audit-runtime-check.mjs --all <目录>
1436
1439
  已被 `.gitignore` 忽略。安装/拉取后若该文件缺失,跑一次 `npm run build:client` 即可补齐
1437
1440
  (`package.json` 的 **`prepare`** 会在 npm 安装与装 git 依赖时自动构建,**`prepack`** 覆盖打包/发布;
1438
1441
  `cli.mjs` 与 `lib/**` 都不依赖该产物——缺了只影响设置页 UI)。
1439
- - **随插件发布的脚本**:`scripts/` 在发布白名单内(`package.json` 的 `files` 与 `scripts/sync-plugin.mjs` 的 `SYNC_ENTRIES` 两处一致,由 `test-self.mjs` 的「SYNC_ENTRIES 覆盖 files 白名单」测试守住),装好插件后 7 个脚本在**安装副本目录内**同样可直接运行(零外部依赖,只用 node 内置模块):
1442
+ - **随插件发布的脚本**:`scripts/` 在发布白名单内(`package.json` 的 `files` 的 `SYNC_ENTRIES` 两处一致,由 `test-self.mjs` 的「SYNC_ENTRIES 覆盖 files 白名单」测试守住),装好插件后 7 个脚本在**安装副本目录内**同样可直接运行(零外部依赖,只用 node 内置模块):
1440
1443
  - `scripts/build-client.mjs`:客户端分片拼接(PART_ORDER 顺序拼接 + `--check` 一致性门禁 + 形态铁律自检;见「客户端分片构建」)
1441
1444
  - `scripts/scan-version.mjs`:版本一致性自检(lib/self 的 VERSION ↔ `package.json` `version` ↔ README 版本列表 ↔ cli HELP 模板),不一致 exit 1
1442
1445
  - `scripts/audit-runtime-check.mjs`:三层审计的 L3 运行时检测(见「独立脚本:运行时检测」)
1443
1446
  - `scripts/scrub-user-wording.mjs`:清洗注释里的沟通残留措辞(见「独立脚本:清洗用户沟通措辞」)
1444
1447
  - `scripts/check.mjs`:全仓语法检查(`node --check` 批量)
1445
- - `scripts/sync-plugin.mjs`:源码仓库 → 安装副本的同步(默认 dry-run,`--write` 才写)。**安装位置 = `local-plugins/<插件>`(真源)**;`node_modules/<插件>` 只是解析入口,由 DSH/pnpm 安装流程按 profile 的 `file:local-plugins/<插件>` 声明生成——**本脚本不建链、不改链**(并会报警「node_modules 下的副本内容与真源不一致」这种会顶掉真源的形态,实测过旧副本顶掉新版;与真源同 inode 的硬链接副本属正常安装产物、不报警)。2026-10-09 起同时做**部署形态与免重启热重载自检**:`--profile <名>` 指定 profile(多 profile 时必须显式给,否则报所有候选而不是默默取首个)、`--fix` 只修 `local-plugins` 侧形态(解软链 / 建真实目录);每次都报告「该插件改代码能否免重启热重载」(读 profile 的 `cordis.patch.yml` 里 `id: hmr` 的 `base`/`root`)以及 profile 依赖声明是否该写 `file:local-plugins/<插件>`
1446
- - `scripts/sync-plugin-install.mjs`:上一条里安装形态/HMR 自检的实现模块(被 `sync-plugin.mjs` 引用,非独立入口)
1448
+ - 同步与安装自检能力已迁往 **dsh-useful-tools**(`sync_plugin` 工具,默认 dry-run)。**安装位置 = `local-plugins/<插件>`(真源)**;`node_modules/<插件>` 只是解析入口,由 DSH/pnpm 安装流程按 profile 的 `file:local-plugins/<插件>` 声明生成——**本脚本不建链、不改链**(并会报警「node_modules 下的副本内容与真源不一致」这种会顶掉真源的形态,实测过旧副本顶掉新版;与真源同 inode 的硬链接副本属正常安装产物、不报警)。2026-10-09 起同时做**部署形态与免重启热重载自检**:`--profile <名>` 指定 profile(多 profile 时必须显式给,否则报所有候选而不是默默取首个)、`--fix` 只修 `local-plugins` 侧形态(解软链 / 建真实目录);每次都报告「该插件改代码能否免重启热重载」(读 profile 的 `cordis.patch.yml` 里 `id: hmr` 的 `base`/`root`)以及 profile 依赖声明是否该写 `file:local-plugins/<插件>`
1449
+ - 安装形态/HMR 自检实现随同迁移(`dsh-useful-tools/lib/core/plugin-sync/`);引用,非独立入口)
1447
1450
  - **测试**:`npm test` 一条命令复现全绿(2026-10-09 实测 1195 用例 / 1193 通过 / 0 失败,2 跳过)
1448
1451
 
1449
1452
  ### 测试缓存(未变更的纯本地测试自动跳过)
package/lib/app/apply.js CHANGED
@@ -71,12 +71,19 @@ export async function apply(ctx, config = {}) {
71
71
  const defineTool = await loadDefineTool(log);
72
72
  // 宿主官方后台 job 服务(dsh-jobs-local):ctx.get 防御式读取,缺失时 git_commit_push 同步执行
73
73
  const jobs = ctx?.get?.('jobs');
74
+ // fs 服务上下文(用于给宿主观测台账补发「已读」事件,见 lib/fs/observe.js)——
75
+ // 必须走 ctx.inject(['fs']):project 内直接 ctx.get('fs') 会抛 "without inject"(本文件早前踩过)。
76
+ let fsCtx = null;
77
+ try {
78
+ ctx.inject(['fs'], (c) => { fsCtx = c; });
79
+ } catch { fsCtx = null; }
74
80
  const toolCount = registerTools(ctx, {
75
81
  defineTool,
76
82
  tools: listTools(),
77
83
  // 透传 exec(宿主执行工具时注入 exec.agent)——callTool 用它作 jobs.start 的
78
84
  // owner(owner 对上了 scoped job 控制器才会放行,否则 start 抛 no controller serves)。
79
- invoke: (toolName, args, exec) => callTool(toolName, args, env, cfg, log, jobs, exec),
85
+ // 末位透传 fsCtx:工具成功后据此补发 fs/observed(actor=本次 exec ✓)
86
+ invoke: (toolName, args, exec) => callTool(toolName, args, env, cfg, log, jobs, exec, fsCtx),
80
87
  log,
81
88
  });
82
89
 
@@ -11,6 +11,7 @@
11
11
  * 与 auditFull/auditWithScope 解耦——本层只消费它们的返回。
12
12
  */
13
13
  import { buildRuleSlotMap } from '../audit/slot.js';
14
+ import { isBlockerFinding } from '../audit/index.js';
14
15
  import { MAX_MSG_PREVIEW } from './constants.js';
15
16
 
16
17
  /** 支持的聚合维度(非法值回落 rule)。 */
@@ -149,7 +150,9 @@ export async function runAuditApi(repo, params = {}, cfg = {}) {
149
150
  exemptStats: exemptStatsOf(auditResult.findings),
150
151
  groupByTypes: GROUP_BY_KEYS,
151
152
  blocked: auditResult.findings
152
- .filter((f) => f.severity === 'blocker')
153
+ // 统一口径:error 也属拦截级(与 summarize 一致)——此前只筛 'blocker',
154
+ // 导致「summary.blocker(10) vs 枚举(7)」差额(差的正是 3 条 error 级)✗
155
+ .filter(isBlockerFinding)
153
156
  .map((f) => ({ file: f.file, line: f.line, rule: f.rule, message: String(f.message || '').slice(0, MAX_MSG_PREVIEW) })),
154
157
  };
155
158
  if (params.withFindings === true) out.findings = auditResult.findings;
@@ -39,6 +39,23 @@ export const TOOL_REGISTRY = [
39
39
  { flag: 'requirementsConfirmed', type: 'boolean', desc: '已核对开发者要求' },
40
40
  { flag: 'pushConfirmed', type: 'boolean', desc: '推送门禁放行' },
41
41
  { flag: 'paths', type: 'string', desc: '精确 add 路径(逗号分隔)' },
42
+ { flag: 'auditExemptPaths', type: 'array', desc: '本次提交按文件临时豁免审计(数组,相对仓库根):所列文件的 finding 不参与拦截判定(含 blocker);仅本次有效,不落盘、不改 .auditignore' },
43
+ { flag: 'auditExemptReason', type: 'string', desc: '豁免理由(可选,仅回显,不作拦截条件)' },
44
+ { flag: 'remote', type: 'string', desc: '推送目标 remote(多 remote / fork 场景;缺省 origin)。推送与核验使用同一 remote' },
45
+ ],
46
+ },
47
+ {
48
+ name: 'exempt', description: '注释豁免工具:给文件加/删 dsh-skip-* 豁免注释(自动选标记、校验真生效)。action=add/remove/list/check;path 相对仓库根(支持数组);scope=header|line;rule 用于推导标记(写错会拒绝并给正确标记)',
49
+ params: [
50
+ { flag: 'action', type: 'string', required: true, enum: ['add', 'remove', 'list', 'check'], desc: '动作:add 加 / remove 删 / list 盘点 / check 校验' },
51
+ { flag: 'repo', type: 'string', desc: '仓库根(缺省当前工作目录)' },
52
+ { flag: 'path', type: 'array', desc: '目标文件(相对仓库根;数组支持多文件,多文件时不允许 line)' },
53
+ { flag: 'line', type: 'number', desc: '1-based 行号(scope=line 且单文件时必填)' },
54
+ { flag: 'scope', type: 'string', enum: ['header', 'line'], desc: 'header=文件头前 3 行 / line=该行行尾' },
55
+ { flag: 'rule', type: 'string', desc: '规则名(如 maintainability/max-complexity),用于推导正确标记' },
56
+ { flag: 'marker', type: 'string', desc: '显式指定 dsh-skip-*(与 rule 推导冲突时报错)' },
57
+ { flag: 'reason', type: 'string', desc: '写进注释的理由(可选)' },
58
+ { flag: 'dryRun', type: 'boolean', desc: '只预览不写盘' },
42
59
  ],
43
60
  },
44
61
  {
@@ -103,6 +120,7 @@ export const TOOL_REGISTRY = [
103
120
  { flag: 'otp', type: 'string', desc: '2FA 一次性口令(可选)' },
104
121
  { flag: 'confirm', type: 'boolean', desc: '真发确认(dryRun=false 时必填)' },
105
122
  { flag: 'no-dry-run', type: 'boolean', desc: '关闭 dry-run(= dryRun:false;真发还需 --confirm)' },
123
+ { flag: 'waitVisible', type: 'boolean', desc: '发布后等待 registry 可见(默认 false:上传成功即为成功,可见延迟是已知现象;true 时每分钟查一次、最多 5 分钟)' },
106
124
  { flag: 'json', type: 'boolean', desc: 'JSON 输出(CLI 用;与其它工具同口径)' },
107
125
  ],
108
126
  },
@@ -119,17 +137,6 @@ export const TOOL_REGISTRY = [
119
137
  { flag: 'path', type: 'string', positional: 0, desc: '文件或目录(默认工作区)' },
120
138
  ],
121
139
  },
122
- {
123
- name: 'edit_after_read', cli: 'edit-after-read',
124
- description: '读改合一编辑:自己读当前文件 → 校验 → 字面替换 → 写回(比宿主守卫更严:读后文件被改动则拒绝、old 默认必须唯一匹配、按字面匹配不做正则解释)。参数名与宿主编辑工具对齐:path/file_path、old/old_string、new/new_string、all/replace_all 两套都认;new 必传(删除请显式传空串)',
125
- params: [
126
- { flag: 'path', type: 'string', positional: 0, desc: '目标文件绝对路径(别名 file_path)' },
127
- { flag: 'old', type: 'string', desc: '要被替换的字面文本(含空白,必须精确匹配;别名 old_string)' },
128
- { flag: 'new', type: 'string', desc: "替换后的文本(别名 new_string);**必传**,要删除请显式传空串 ''" },
129
- { flag: 'all', type: 'boolean', desc: '替换全部匹配(默认 false:要求唯一匹配;别名 replace_all)' },
130
- { flag: 'allowDuplicate', type: 'boolean', desc: '放行「替换后产物包含整份原文 / 原文出现多次」的写入(默认拒绝:该形态会把文档写重;确认无误再开)' },
131
- ],
132
- },
133
140
  {
134
141
  name: 'git_identity_rewrite', cli: 'identity-rewrite', description: '提交身份历史改写:把仓库里非规范身份(工具/AI 产生的 agent@dsh.local、eightfs@local、v2-clone@local,以及账号 noreply 的旧变体)的作者/committer 统一成登录账号的规范身份。默认 dryRun 只报告;真改写会先建备份引用、自检(提交数/工作树/身份全规范)通过才用 force-with-lease 强推;只处理 origin 属于登录账号的仓库。paths=仓库路径,root=扫描根',
135
142
  params: [
@@ -15,6 +15,7 @@ import { discoverRuleSlots, loadYamlRuleFile, resolveSlotOrder, setSlotDisabled,
15
15
  import { name } from '../constants.js';
16
16
  import { readAccountStatus } from '../../git/account-status.js';
17
17
  import { identityHintText, resolveCommitIdentity } from '../../git/identity.js';
18
+ import { exemptHintForFinding, exemptMarkerCovers, EXEMPT_MARKERS } from '../../exempt/index.js';
18
19
 
19
20
  /**
20
21
  * 当前提交身份(未配身份的仓库会用到的那个):登录账号可用 → 账号身份;
@@ -172,4 +173,41 @@ export function handleToggleRule(ctx) {
172
173
  const r = setSlotDisabled(slot, want);
173
174
  if (!r.ok) return { status: 400, body: { ok: false, code: 'SLOT_TOGGLE_FAIL', error: r.error || '切换失败' } };
174
175
  return { status: 200, body: { ok: true, slot, disabled: r.disabled, message: want ? '已禁用' : '已启用' } };
176
+ }
177
+
178
+ /**
179
+ * GET /api/git-push/exempt-hint —— 豁免标记查询(只读)。
180
+ *
181
+ * 入参 query:rule(规则名,如 maintainability/max-complexity)、kind(可选 finding kind)。
182
+ * 出参:{ ok, rule, kind, marker, hint, lineLevel, candidates }。
183
+ *
184
+ * 为什么要有这个端点:豁免标记注册表(EXEMPT_MARKERS)是**单一真源**,外部工具(如
185
+ * dsh-useful-tools 的 exempt 工具)需要「该写哪个标记」时来查,而不是复制一份注册表
186
+ * ——复制必然漂移(历史上「提示与实际行为不符」的 24 种组合就是这么来的)。
187
+ */
188
+ export function handleExemptHint(ctx) {
189
+ const rule = String(ctx.query?.rule || '').trim();
190
+ const kind = String(ctx.query?.kind || '').trim();
191
+ const finding = { rule, kind };
192
+ const hit = exemptHintForFinding(finding);
193
+ const meta = hit ? EXEMPT_MARKERS[hit.marker] : null;
194
+ const candidates = Object.entries(EXEMPT_MARKERS).map(([marker, m]) => ({
195
+ marker,
196
+ lineLevel: m.lineLevel === true,
197
+ dimensions: m.dimensions || [],
198
+ hint: m.hint || '',
199
+ covers: Boolean(rule || kind) && exemptMarkerCovers(marker, finding),
200
+ }));
201
+ return {
202
+ status: 200,
203
+ body: {
204
+ ok: true,
205
+ rule,
206
+ kind,
207
+ marker: hit ? hit.marker : null,
208
+ hint: hit ? hit.hint : '无任何标记可豁免该 finding(应改代码,或走 .auditignore / 豁免槽位)',
209
+ lineLevel: meta ? meta.lineLevel === true : false,
210
+ candidates,
211
+ },
212
+ };
175
213
  }
@@ -8,6 +8,7 @@ import { join } from 'node:path';
8
8
  import { pushCurrentBranch, resolveToken, githubFetch, setVisibility, refreshAccountStatus, detectRepoVisibility, runGit, parseGithubOwnerRepo } from '../../git/index.js';
9
9
  import { updateRepoIndex } from '../../git/repo-index.js';
10
10
  import { commitWithAudit } from '../../commit-push.js';
11
+ import { isBlockerFinding } from '../../audit/index.js';
11
12
 
12
13
  /* ───────── 仓库动作常量 ───────── */
13
14
  const COMMIT_SHA_MAX_LEN = 40; // commit sha 展示截断长度
@@ -110,7 +111,8 @@ export async function handleRepoCommit(ctx) {
110
111
  });
111
112
  if (!r.ok) {
112
113
  const findings = r.audit?.findings || [];
113
- const blockers = findings.filter((f) => f.severity === 'blocker').slice(0, 3)
114
+ // 统一口径:error 也属拦截级(与 summarize 一致,此前只筛 'blocker' ⇒ 枚举少于 summary)
115
+ const blockers = findings.filter(isBlockerFinding).slice(0, 3)
114
116
  .map((f) => `${f.file}:${f.line} ${f.rule}`);
115
117
  return {
116
118
  status: 200,
@@ -54,6 +54,19 @@ function buildLocalList(indexMap, root, deadline) {
54
54
  });
55
55
  }
56
56
 
57
+ /**
58
+ * 远端探测是否已超预算。
59
+ *
60
+ * `deadline` 是**绝对时间戳**(调用方算 Date.now() + 预算),所以直接与 now 比。
61
+ * 历史缺陷:判据写成 `now > probeStart + deadline`——deadline 已是绝对时刻,
62
+ * 再加一次起点等于把上限推到几十天后,判据恒为 false,预算彻底失效;
63
+ * 结果所有仓库都要串完 SSH 探测,前端 30s 超时因此频繁触发(界面报 signal timed out)。
64
+ * 抽成独立函数是为了能被测试直接断言(行为可测,而不是只比对源码文本)。
65
+ */
66
+ export function isProbeOverBudget(deadline, now = Date.now()) {
67
+ return Number.isFinite(deadline) && now > deadline;
68
+ }
69
+
57
70
  /** 并发 live 探测远端(预算内限流),把 ahead/behind/remoteHead 合并回 list。 */
58
71
  async function applyLiveRemote(list, deadline) {
59
72
  const toProbe = list.filter((r) => r.__needLive && r.path && r.branch);
@@ -69,11 +82,14 @@ async function applyLiveRemote(list, deadline) {
69
82
  }
70
83
  const results = new Map();
71
84
  let cursor = 0;
72
- const probeStart = Date.now();
73
85
  const workers = Array.from({ length: Math.min(PROBE_CONCURRENCY, toProbe.length) }, async () => {
74
86
  while (cursor < toProbe.length) {
75
87
  const repoProbe = toProbe[cursor]; cursor += 1;
76
- if (Date.now() > probeStart + deadline) { results.set(repoProbe.name, { live: { ok: false, sha: '' }, elapsed: -1 }); continue; }
88
+ // 超预算 ⇒ 该仓库标 liveSkipped(本轮不探远端状态),由下一次刷新补上
89
+ if (isProbeOverBudget(deadline)) {
90
+ results.set(repoProbe.name, { live: { ok: false, sha: '' }, elapsed: -1 });
91
+ continue;
92
+ }
77
93
  const t0 = Date.now();
78
94
  let live = { ok: false, sha: '' };
79
95
  try { live = await liveRemoteHeadAsync({ repoPath: repoProbe.path, branch: repoProbe.branch || '' }); } catch { /* 忽略 */ }
File without changes
@@ -10,7 +10,7 @@ import { checkOrigin, checkBodySize, checkWriteConfirm, readJsonBody } from '../
10
10
  import { defaultConfig } from '../client/index.js';
11
11
  import {
12
12
  handleStatus, handleScan, handleBrowse, handleTools, handleToolProbes,
13
- handleRuleSlots, handleRuleDetail, handleAudit, handleToggleRule,
13
+ handleRuleSlots, handleRuleDetail, handleAudit, handleToggleRule, handleExemptHint,
14
14
  } from './handlers/meta.js';
15
15
  import {
16
16
  handleReposLocal, handleReposLocalScan, handleReposLocalScanWait, handleReposLocalRefresh, handleReposCloud,
@@ -127,6 +127,8 @@ export async function handleHttp(req = {}, env = {}, cfg = defaultConfig()) {
127
127
  case '/api/git-push/rule-detail': return handleRuleDetail(ctx);
128
128
  case '/api/git-push/audit': return await handleAudit(ctx);
129
129
  case '/api/git-push/toggle-rule': return handleToggleRule(ctx);
130
+ // 豁免标记查询(只读):供外部工具推导「该写哪个 dsh-skip-*」,避免复制标记注册表
131
+ case '/api/git-push/exempt-hint': return handleExemptHint(ctx);
130
132
  case '/api/git-push/account-status': return handleAccountStatus(ctx);
131
133
  case '/api/git-push/npm-account': return await handleNpmAccount(ctx);
132
134
  case '/api/git-push/npm-check': return await handleNpmCheck(ctx);
package/lib/app/schema.js CHANGED
File without changes
File without changes
@@ -14,7 +14,7 @@ import { join } from 'node:path';
14
14
  import { fileURLToPath } from 'node:url';
15
15
  import { spawnSync } from 'node:child_process';
16
16
  import './host-doc-checks.js'; // 审计包边界:文档漂移检查器由宿主注入(导入即接线,见 lib/app/host-doc-checks.js)
17
- import { auditWithScope, auditFull, summarize } from '../audit/index.js';
17
+ import { auditWithScope, auditFull, summarize, isBlockerFinding } from '../audit/index.js';
18
18
  import { formatAnalysisCoverageLine } from '../audit/analysis-coverage.js';
19
19
  import { scoreQuality } from '../score/index.js';
20
20
  import {
@@ -64,6 +64,8 @@ async function pushWithPostSteps(args, env, cfg) {
64
64
  requirementsConfirmed: args.requirementsConfirmed === true,
65
65
  force: args.force === true,
66
66
  pushMethod: cfg.pushMethod || 'ssh',
67
+ // 推送目标 remote(多 remote/fork 场景;缺省 origin);推送与核验使用同一 remote
68
+ remote: String(args.remote || ''),
67
69
  // 推送门禁——开启时 push 需显式放行(pushConfirmed:true);未放行返回 PUSH_GATE 拦截
68
70
  pushGate: cfg.pushGate === true,
69
71
  pushConfirmed: args.pushConfirmed === true,
@@ -290,6 +292,8 @@ async function callNpmPublishJob(args = {}, jobs, exec, log, env = {}, cfg = {})
290
292
  tag: args.tag || 'latest',
291
293
  otp: args.otp || '',
292
294
  confirm: args.confirm === true,
295
+ // 可选:发布后等待 registry 可见(默认不等——上传成功即为成功,可见延迟是已知现象)
296
+ waitVisible: args.waitVisible === true,
293
297
  });
294
298
  /**
295
299
  * 把发包结果映射成宿主 job 的 {status, detail, output} —— **成功也必须给 detail**。
@@ -314,8 +318,10 @@ async function callNpmPublishJob(args = {}, jobs, exec, log, env = {}, cfg = {})
314
318
  ].filter(Boolean).join(' · ');
315
319
  const tail = o.dryRun
316
320
  ? '真发需同时传 confirm=true 与 dryRun=false(不可撤销)'
317
- : '⚠️ 刚发完在 registry 查不到多为**发布延迟**(等 3~5 分钟复测,不是失败);'
318
- + '若 npm 账号开了 2FA 而未带 otp,发布会进 **staged**(需在 npm 网站批准或带 otp 重发)';
321
+ : (o.visible
322
+ ? 'registry 已可见,可直接安装;'
323
+ : '上传成功即为发布成功(成功判定以 npm 返回为准);registry 可见通常有几分钟延迟,属正常现象,不是失败。')
324
+ + '若长时间不可见,再检查 npm 账号 2FA / staged 状态。';
319
325
  return { status: 'completed', detail: `${bits}。${tail}`, output: JSON.stringify(o) };
320
326
  }
321
327
  const err = String(o.error || o.blocked || 'npm publish 失败');
@@ -389,6 +395,9 @@ async function callCommitPush(args, env, cfg, log, jobs, exec) {
389
395
  rulesetDir: args.ruleset,
390
396
  slots: undefined, // auditRuleOrder 是「加载顺序」不是白名单 ✗(详见 lib/commit-push.js 注释;禁用槽位用 auditDisabledSlots ✓)
391
397
  cfg,
398
+ // 本次提交的按文件临时豁免(不落盘):列入的文件 finding 不参与拦截判定(含 blocker)
399
+ exemptPaths: Array.isArray(args.auditExemptPaths) ? args.auditExemptPaths : [],
400
+ exemptReason: args.auditExemptReason,
392
401
  });
393
402
  if (!auditGate.ok) return auditGate; // { ok:false, blocked:true, audit }
394
403
  const doPush = () => pushWithPostSteps(args, env, cfg);
@@ -505,7 +514,9 @@ async function runStandardAuditTool(args, env, cfg, log, weights) {
505
514
  // 审计后直接输出豁免类型统计 + 聚合类型 + 拦截列表(blocker 详情不用查 API)
506
515
  const exemptStats = exemptStatsOf(auditResult.findings);
507
516
  const blocked = auditResult.findings
508
- .filter((f) => f.severity === 'blocker')
517
+ // 统一口径:error 也属拦截级(与 summarize 一致)。此前只筛 'blocker' ⇒
518
+ // 出现「summary.blocker=10 但这里只枚举 7」的差额(差的正是 error 级)✗
519
+ .filter(isBlockerFinding)
509
520
  .map((f) => ({ file: f.file, line: f.line, rule: f.rule, message: String(f.message || '').slice(0, MAX_MSG_PREVIEW) }));
510
521
  // 审计输出改为「级别数量 + 评分 + API 查询用法」——审计明细由聚合 API
511
522
  // (/api/git-push/audit)查询,不再内联输出 findings/审计内容(有聚合 API 消费审计结果)。
@@ -530,7 +541,7 @@ async function runStandardAuditTool(args, env, cfg, log, weights) {
530
541
  return out;
531
542
  }
532
543
 
533
- export async function callTool(toolName, args = {}, env = {}, cfg = defaultConfig(), log = null, jobs = null, exec = null) {
544
+ export async function callTool(toolName, args = {}, env = {}, cfg = defaultConfig(), log = null, jobs = null, exec = null, fsCtx = null) {
534
545
  switch (toolName) {
535
546
  case 'git_scan': {
536
547
  const root = args.root || getDefaultScanRoot(env, { defaultScanRoot: String(cfg.defaultScanRoot || '') });
@@ -546,6 +557,22 @@ export async function callTool(toolName, args = {}, env = {}, cfg = defaultConfi
546
557
  }
547
558
  case 'git_commit_push':
548
559
  return callCommitPush(args, env, cfg, log, jobs, exec);
560
+ case 'exempt': {
561
+ // 注释豁免工具:add/remove/list/check(标记映射读同进程 EXEMPT_MARKERS,单一真源)
562
+ const { addExempt, removeExempt, listExempt, checkExempt } = await import('../exempt/tool.js');
563
+ const action = String(args.action || '');
564
+ const repoPath = String(args.repo || process.cwd());
565
+ if (action === 'add') {
566
+ return addExempt({
567
+ repoPath, path: args.path, line: args.line, scope: args.scope,
568
+ rule: args.rule, marker: args.marker, reason: args.reason, dryRun: args.dryRun === true,
569
+ });
570
+ }
571
+ if (action === 'remove') return removeExempt({ repoPath, path: args.path, marker: args.marker, dryRun: args.dryRun === true });
572
+ if (action === 'list') return listExempt({ repoPath });
573
+ if (action === 'check') return checkExempt({ repoPath });
574
+ return { ok: false, error: `未知 action:${action || '(空)'}(add/remove/list/check)` };
575
+ }
549
576
  case 'code_audit':
550
577
  return callCodeAudit(args, env, cfg, log, jobs, exec);
551
578
  case 'git_gen_readme': {
@@ -599,24 +626,6 @@ export async function callTool(toolName, args = {}, env = {}, cfg = defaultConfi
599
626
  const links = await checkLinks({ file: path, text: readTextSafe(path) });
600
627
  return { ok: true, count: links.length, penalty: sumLinkPenalty(links), findings: links };
601
628
  }
602
- case 'edit_after_read': {
603
- // 读改合一:自己读当前文件 → 校验(唯一性 / 读后是否被改动)→ 字面替换 → 写回。
604
- // 动态 import 避免在文件顶部再添一行导入(本 case 已在 async 函数内,await 可用)。
605
- // 参数名与宿主编辑工具对齐(file_path/old_string/new_string/replace_all),两套名字都认;
606
- // 注意**不要**把缺失的 new 兜成空串 —— 那会让「参数名写错」变成「内容被删除」(真实事故)。
607
- const { editAfterRead } = await import('../fs/edit-after-read.js');
608
- const r = editAfterRead({
609
- path: args.path ?? args.file_path,
610
- old: args.old ?? args.old_string,
611
- new: args.new ?? args.new_string,
612
- all: (args.all ?? args.replace_all) === true,
613
- // 逃生阀:默认拒绝「替换后产物包含整份原文 / 原文出现多次」(那种形态会把文档写重)
614
- allowDuplicate: args.allowDuplicate === true,
615
- });
616
- return r.ok
617
- ? { ok: true, path: r.path, replaced: r.replaced, bytesBefore: r.bytesBefore, bytesAfter: r.bytesAfter }
618
- : { ok: false, path: r.path, reason: r.reason };
619
- }
620
629
  case 'module_splitter': {
621
630
  // 巨型单文件拆分(复用 scripts/module-splitter.py,python3 零依赖)。
622
631
  // python3 调用逻辑抽到 lib/git/module-splitter.js(与 cli cmdModuleSplitter 共用),