dsh-git-push 2.9.4 → 2.9.9
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.
- package/README.md +21 -25
- package/lib/app/apply.js +8 -1
- package/lib/app/audit-api.js +4 -1
- package/lib/app/command-registry.js +17 -11
- package/lib/app/handlers/meta.js +38 -0
- package/lib/app/handlers/repo-actions.js +3 -1
- package/lib/app/handlers/settings.js +0 -0
- package/lib/app/http-handlers.js +3 -1
- package/lib/app/schema.js +0 -0
- package/lib/app/settings-bridge.js +0 -0
- package/lib/app/tool-call.js +26 -21
- package/lib/ast/control-flow.js +12 -3
- package/lib/ast/size.js +5 -2
- package/lib/audit/audit-file.js +4 -2
- package/lib/audit/file-context.js +89 -0
- package/lib/audit/finding.js +16 -2
- package/lib/audit/index.js +2 -2
- package/lib/checks/button-bind.js +25 -2
- package/lib/commit-push.js +20 -2
- package/lib/core/exec.js +6 -4
- package/lib/exempt/tool.js +198 -0
- package/lib/git/clone-history-mode.js +24 -5
- package/lib/git/push.js +28 -13
- package/lib/git/transport.js +49 -17
- package/lib/git/visibility.js +93 -9
- package/lib/npm/publish.js +27 -0
- package/lib/npm/registry.js +5 -2
- package/lib/self/index.js +1 -1
- package/package.json +2 -4
- package/skills/dev/dsh-git-push.md +1 -2
- package/skills/guide/guide-cli-scripts.md +3 -3
- package/skills/guide/guide-inject-ui.md +4 -4
- package/assets/minihost.sh +0 -35
- package/assets/preview.html +0 -36703
- package/lib/fs/edit-after-read.js +0 -142
- package/scripts/frontend-preview-check.mjs +0 -124
- package/scripts/preview-gen.mjs +0 -489
- package/scripts/preview-local-runner.mjs +0 -55
- package/scripts/preview-server-direct.mjs +0 -116
- package/scripts/preview-server.mjs +0 -305
- package/scripts/preview-slot-data.mjs +0 -123
- package/scripts/sync-plugin-install.mjs +0 -286
- 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) | **当前有效规格唯一入口**:身份 /
|
|
67
|
+
| [docs/SPEC.md](docs/SPEC.md) | **当前有效规格唯一入口**:身份 / 17 个工具 / 35 条 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 三份自动生成文档怎么更新、漂移怎么办 |
|
|
@@ -396,8 +396,7 @@ dsh-git-push/
|
|
|
396
396
|
│ │ ├── workspace-paths.js — (待注释)
|
|
397
397
|
│ ├── exempt/ — 豁免机制(dsh-skip-* 注释标记解析与文件头/行内语义)
|
|
398
398
|
│ │ ├── index.js — 豁免注册表(dsh-skip-* 全标记消费)
|
|
399
|
-
│ ├──
|
|
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 公钥指纹,输出账号状态块)
|
|
@@ -477,18 +476,12 @@ dsh-git-push/
|
|
|
477
476
|
│ ├── doc-func.mjs — (待注释)
|
|
478
477
|
│ ├── doc-tree.mjs — (待注释)
|
|
479
478
|
│ ├── doc-version.mjs — (待注释)
|
|
480
|
-
│ ├── frontend-preview-check.mjs — (待注释)
|
|
481
479
|
│ ├── hot-path-probe-cjs.cjs — (待注释)
|
|
482
480
|
│ ├── hot-path-probe-fs-shim.mjs — (待注释)
|
|
483
481
|
│ ├── hot-path-probe-fsp-shim.mjs — (待注释)
|
|
484
482
|
│ ├── hot-path-probe.mjs — (待注释)
|
|
485
483
|
│ ├── module-splitter.py — 巨型单文件按顶层块拆分脚本(analyze/split/verify 三命令,python3 零依赖;module_splitter 工具与 CLI 的底层实现)
|
|
486
484
|
│ ├── 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
485
|
│ ├── probe-recheck.mjs — 探针:「重新检测」按钮链路实测(在线校验 token/SSH)
|
|
493
486
|
│ ├── readme-gen.mjs — README 生成独立脚本(git_gen_readme 抽出:模板渲染/版本表/目录)
|
|
494
487
|
│ ├── rename-locator.mjs — 变量重命名位置定位工具(按作用域聚合引用——单字母变量人工重命名辅助)
|
|
@@ -501,14 +494,11 @@ dsh-git-push/
|
|
|
501
494
|
│ ├── scan-version.mjs — 版本一致性校验脚本
|
|
502
495
|
│ ├── scrub-user-wording.mjs — 清理「用户沟通措辞」独立脚本
|
|
503
496
|
│ ├── symbol-index.mjs — (待注释)
|
|
504
|
-
│ ├── sync-plugin-install.mjs — 插件安装形态与免重启热重载自检(被 sync-plugin.mjs 引用)
|
|
505
|
-
│ ├── sync-plugin.mjs — 双副本同步脚本(源仓库 → 部署安装副本)
|
|
506
497
|
│ ├── verify-prestep.mjs — 上下文注入自检脚本(真实触发 agent/pre-step 验证注入)
|
|
507
498
|
│ ├── audit-ext/ — (待注释)
|
|
508
499
|
│ │ ├── _example-readme-present.mjs — 审计扩展契约示例(_ 前缀:演示不参与实际审计)
|
|
509
500
|
│ │ ├── variable-min-length.mjs — 审计扩展:variable-min-length(内置规则抽出试点——统一动态入口)
|
|
510
501
|
├── assets/ — 预览页与配图(preview.html 交互模拟页 + 面板截图)
|
|
511
|
-
│ ├── minihost.sh — (待注释)
|
|
512
502
|
│ ├── start.sh — 预览服务器启停脚本(start/stop/restart/status + --port + PID/日志/健康检查 /preview-ping)
|
|
513
503
|
│ ├── tree-sitter/ — (待注释)
|
|
514
504
|
│ │ ├── LICENSE — (待注释)
|
|
@@ -533,7 +523,9 @@ dsh-git-push/
|
|
|
533
523
|
│ ├── test-audit-bad-file.mjs — 审计拦截门禁测试(硬编码密码/API key/.env 凭据文件)
|
|
534
524
|
│ ├── test-audit-defaults.mjs — (待注释)
|
|
535
525
|
│ ├── test-audit-empty.mjs — (待注释)
|
|
526
|
+
│ ├── test-audit-exempt-paths.mjs — 提交时按文件临时豁免审计(auditExemptPaths)回归
|
|
536
527
|
│ ├── test-audit-ext.mjs — 审计扩展自动接入测试(契约加载/降级/match/auditFull 并入)
|
|
528
|
+
│ ├── test-audit-false-positive-guards.mjs — (待注释)
|
|
537
529
|
│ ├── test-audit-git-boundary.mjs — (待注释)
|
|
538
530
|
│ ├── test-audit-npm-publish-rules.mjs — (待注释)
|
|
539
531
|
│ ├── test-audit-push-boundary.mjs — (待注释)
|
|
@@ -573,11 +565,11 @@ dsh-git-push/
|
|
|
573
565
|
│ ├── test-dup-code.mjs — (待注释)
|
|
574
566
|
│ ├── test-dup-const-idiom.mjs — (待注释)
|
|
575
567
|
│ ├── test-dup-const.mjs — duplicate-const 规则测试(多语言提取 JS/Kotlin/Java/Go/Rust/Python、模块级过滤、跨文件聚合、test 目录排除、同值不同名不报)
|
|
576
|
-
│ ├── test-edit-after-read.mjs — (待注释)
|
|
577
568
|
│ ├── test-empty-catch-promise.mjs — (待注释)
|
|
578
569
|
│ ├── test-empty-catch-single-source.mjs — (待注释)
|
|
579
570
|
│ ├── test-exempt-hint-classify.mjs — (待注释)
|
|
580
571
|
│ ├── test-exempt-hint-effective.mjs — (待注释)
|
|
572
|
+
│ ├── test-exempt-tool.mjs — (待注释)
|
|
581
573
|
│ ├── test-exempt.mjs — 豁免总入口测试(7 标记 + 位置语义)
|
|
582
574
|
│ ├── test-ext-variable-min-length.mjs — (待注释)
|
|
583
575
|
│ ├── test-false-positive-fixes.mjs — 误报修复回归测试
|
|
@@ -609,6 +601,7 @@ dsh-git-push/
|
|
|
609
601
|
│ ├── test-mirror-gates.mjs — (待注释)
|
|
610
602
|
│ ├── test-module-splitter-multiline.mjs — (待注释)
|
|
611
603
|
│ ├── test-module-splitter.mjs — module_splitter 工具 + CLI 接入测试(契约 + 行为 + 脚本随插件发布)
|
|
604
|
+
│ ├── test-multi-remote.mjs — (待注释)
|
|
612
605
|
│ ├── test-name-length-scope.mjs — (待注释)
|
|
613
606
|
│ ├── test-npm-enobufs.mjs — (待注释)
|
|
614
607
|
│ ├── test-npm-install.mjs — (待注释)
|
|
@@ -634,7 +627,6 @@ dsh-git-push/
|
|
|
634
627
|
│ ├── test-repo-list.mjs — 仓库列表测试(本地扫描/索引读写/HTTP 端点/远端状态)
|
|
635
628
|
│ ├── test-rule-include-paths.mjs — (待注释)
|
|
636
629
|
│ ├── test-rule-packs.mjs — 规则总入口测试(编译注册/字段指派)
|
|
637
|
-
│ ├── test-rule-slots-render.mjs — 规则包列表统计渲染回归
|
|
638
630
|
│ ├── test-scan-hardcoded-paths.mjs — (待注释)
|
|
639
631
|
│ ├── test-scope.mjs — 作用域最小实验测试(分类器/机制/magic 接入)
|
|
640
632
|
│ ├── test-scrub-conv-wording.mjs — (待注释)
|
|
@@ -642,13 +634,11 @@ dsh-git-push/
|
|
|
642
634
|
│ ├── test-settings-persistence.mjs — 设置侧边栏持久化专项测试(L1 提交/L2 白名单/L3 回读/L4 消费四层断言)
|
|
643
635
|
│ ├── test-settings-roundtrip.mjs — (待注释)
|
|
644
636
|
│ ├── test-sidebar-interaction.mjs — 侧边栏规则包列表交互自检
|
|
645
|
-
│ ├── test-sidebar-state.mjs — 设置侧边栏状态自检(设置键回读/凭据已填写判断/统一刷新入口/产物同步)
|
|
646
637
|
│ ├── test-slash-commands.mjs — 用户输入框 /git-audit 斜杠命令(解析/接线/对本仓库跑 quick)
|
|
647
638
|
│ ├── test-smart-hint.mjs — 扫描智能提示 + 评分对数衰减测试
|
|
648
639
|
│ ├── test-status-secret.mjs — token 明文不下发安全回归
|
|
649
640
|
│ ├── test-symbol-index.mjs — (待注释)
|
|
650
641
|
│ ├── test-symlink-resolution.mjs — 软链安装依赖解析回归测试(默认失败/--preserve-symlinks/NODE_PATH/真实副本四种场景)
|
|
651
|
-
│ ├── test-sync-plugin-install.mjs — (待注释)
|
|
652
642
|
│ ├── test-task-queue.mjs — 后台化回归测试(官方 job 注册 / 无 jobs 同步保底 / blocker 拦截)
|
|
653
643
|
│ ├── test-test-cache.mjs — (待注释)
|
|
654
644
|
│ ├── test-tokenizer-multiline-template.mjs — (待注释)
|
|
@@ -705,6 +695,13 @@ dsh-git-push/
|
|
|
705
695
|
│ │ ├── task-completion-report.md — (待注释)
|
|
706
696
|
│ │ ├── tool-json-add-ask.md — (待注释)
|
|
707
697
|
│ │ ├── versioning-rule.md — (待注释)
|
|
698
|
+
├── .github/ — (待注释)
|
|
699
|
+
│ ├── workflows/ — (待注释)
|
|
700
|
+
│ │ ├── test.yml — (待注释)
|
|
701
|
+
├── audit-samples/ — (待注释)
|
|
702
|
+
│ ├── .samples — (待注释)
|
|
703
|
+
│ ├── js-bad.js — (待注释)
|
|
704
|
+
│ ├── py-bad.py — (待注释)
|
|
708
705
|
├── .auditignore — 审计豁免清单(不影响 git 入库,仅跳过审计扫描)——排除内置第三方代码
|
|
709
706
|
├── .gitignore — 忽略规则(node_modules/产物/备份/回收站等)
|
|
710
707
|
├── CONTRIBUTING.md — (待注释)
|
|
@@ -973,14 +970,14 @@ console.log(x); // dsh-skip-residue: 本行为刻意保留的调试输出样本
|
|
|
973
970
|
|
|
974
971
|
## 界面预览页(assets/preview.html,真实后端数据)
|
|
975
972
|
|
|
976
|
-
`assets/preview.html` 由 `
|
|
973
|
+
`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
974
|
|
|
978
975
|
```
|
|
979
976
|
./assets/start.sh start [--port 31000] # 启动(默认 30999;已有项目占用时用 --port 错开)
|
|
980
977
|
./assets/start.sh status / restart / stop
|
|
981
978
|
```
|
|
982
979
|
|
|
983
|
-
-
|
|
980
|
+
- **完全真实后端数据**:**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
981
|
- **离线调试**:URL 加 `?mock=1` 切回内置假数据(改动只留页面内、不写文件);跨后端实测用 `?backend=http://127.0.0.1:端口`。
|
|
985
982
|
- **全部可点**:三选项卡切换 · 审计开关 · **注入系统提示词开关** · 「注入开发者要求清单」子开关(含置灰联动)· 规则包启停与 ↑↓ 调序 · 权重编辑 · token/SSH 保存 · 邮箱一键生成 SSH 并回填
|
|
986
983
|
- 健康检查 `GET /preview-ping`(start.sh 启动判定);PID 落 `dsh-git-push.pid`(插件根);日志 `assets/preview-server.log`(超 10MB 轮转)
|
|
@@ -1012,7 +1009,7 @@ lib/client-parts/00-loader.js loader + factory 头 + require + NS(必须
|
|
|
1012
1009
|
语法只对拼起来的产物才有意义)
|
|
1013
1010
|
② npm run build:client 按 PART_ORDER 拼接 → 写 lib/client.js(幂等:分片不变则产物逐字节不变)
|
|
1014
1011
|
③ npm run check 语法检查(跳过 client-parts)+ **产物新鲜度校验**:client.js 必须与分片拼出来的一致
|
|
1015
|
-
④
|
|
1012
|
+
④ (用 dsh-useful-tools 的 preview 工具 action=gen 重生成预览页),实际点三选项卡确认渲染与交互
|
|
1016
1013
|
```
|
|
1017
1014
|
|
|
1018
1015
|
- **不要手改 `lib/client.js`**:它是构建产物,下次构建即被覆盖,改动静默丢失;`npm run check` 会直接报「产物与分片不一致」。
|
|
@@ -1032,7 +1029,7 @@ lib/client-parts/00-loader.js loader + factory 头 + require + NS(必须
|
|
|
1032
1029
|
|
|
1033
1030
|
```
|
|
1034
1031
|
npm run build:client # 先拼产物
|
|
1035
|
-
|
|
1032
|
+
(用 dsh-useful-tools 的 preview 工具 action=gen 重生成预览页)
|
|
1036
1033
|
```
|
|
1037
1034
|
|
|
1038
1035
|
渲染自检(改了客户端代码或预览生成器后必跑;把「改前端必须真的看一眼」变成一条命令):
|
|
@@ -1160,7 +1157,6 @@ token 与 GitHub token 存**同一份** `config.json`(0600,写入走原子
|
|
|
1160
1157
|
· git_account_check —— 校验 GitHub 账号与凭据(token 在线校验 + SSH 公钥指纹)
|
|
1161
1158
|
· git_identity_rewrite —— 提交身份历史改写(非规范身份→登录账号规范身份;默认 dry-run,
|
|
1162
1159
|
真改写先建备份引用、自检通过才改写,push 用 force-with-lease;只处理本人远端仓库)
|
|
1163
|
-
· edit_after_read —— 读改合一编辑(自己读当前文件 → 校验 → 字面替换 → 写回;比宿主编辑守卫更严:读后文件被改动则拒绝写入、old 默认必须唯一匹配、按字面匹配不做正则解释)。**参数名与宿主编辑工具对齐**:path/file_path、old/old_string、new/new_string、all/replace_all 两套都认;**new 必传** —— 缺参数只报错、绝不把内容删掉(删除须显式传空串)
|
|
1164
1160
|
· git_sluice —— 浅包装 git 透传(AI 直接调用任意 git 命令,凭据自动注入):args 传与 git 一致的参数串,返回 status + stdout/stderr;git 的 log/diff/branch/tag 等其余能力用它
|
|
1165
1161
|
· git_clone / link_check —— git_clone 从 GitHub 拉仓库:target=owner/repo、dest=目标目录、branch=分支。
|
|
1166
1162
|
**默认带真实历史**:用 git fetch 取回原始对象,克隆结果与远端 HEAD 逐字节一致(可推回远端、可 git log 读演进),
|
|
@@ -1274,7 +1270,7 @@ node scripts/rule-switch.mjs disable comment # 禁用安装版本的 comment
|
|
|
1274
1270
|
node scripts/rule-switch.mjs enable comment # 重新启用
|
|
1275
1271
|
```
|
|
1276
1272
|
|
|
1277
|
-
边界:`nodejs` / `private` 属安全红线强制槽位,禁用会被拦截(返回错误、不写 yml),与 UI 行为一致。注意与 `
|
|
1273
|
+
边界:`nodejs` / `private` 属安全红线强制槽位,禁用会被拦截(返回错误、不写 yml),与 UI 行为一致。注意与 ``sync_plugin` 工具(write:true)` 的协作:同步会按工作区规则文件覆盖部署副本的 disabled 状态(工作区文件里没有 disabled 行则同步后恢复启用)。
|
|
1278
1274
|
|
|
1279
1275
|
## 用户输入框斜杠命令
|
|
1280
1276
|
|
|
@@ -1436,14 +1432,14 @@ node scripts/audit-runtime-check.mjs --all <目录>
|
|
|
1436
1432
|
已被 `.gitignore` 忽略。安装/拉取后若该文件缺失,跑一次 `npm run build:client` 即可补齐
|
|
1437
1433
|
(`package.json` 的 **`prepare`** 会在 npm 安装与装 git 依赖时自动构建,**`prepack`** 覆盖打包/发布;
|
|
1438
1434
|
`cli.mjs` 与 `lib/**` 都不依赖该产物——缺了只影响设置页 UI)。
|
|
1439
|
-
- **随插件发布的脚本**:`scripts/` 在发布白名单内(`package.json` 的 `files`
|
|
1435
|
+
- **随插件发布的脚本**:`scripts/` 在发布白名单内(`package.json` 的 `files` 的 `SYNC_ENTRIES` 两处一致,由 `test-self.mjs` 的「SYNC_ENTRIES 覆盖 files 白名单」测试守住),装好插件后 7 个脚本在**安装副本目录内**同样可直接运行(零外部依赖,只用 node 内置模块):
|
|
1440
1436
|
- `scripts/build-client.mjs`:客户端分片拼接(PART_ORDER 顺序拼接 + `--check` 一致性门禁 + 形态铁律自检;见「客户端分片构建」)
|
|
1441
1437
|
- `scripts/scan-version.mjs`:版本一致性自检(lib/self 的 VERSION ↔ `package.json` `version` ↔ README 版本列表 ↔ cli HELP 模板),不一致 exit 1
|
|
1442
1438
|
- `scripts/audit-runtime-check.mjs`:三层审计的 L3 运行时检测(见「独立脚本:运行时检测」)
|
|
1443
1439
|
- `scripts/scrub-user-wording.mjs`:清洗注释里的沟通残留措辞(见「独立脚本:清洗用户沟通措辞」)
|
|
1444
1440
|
- `scripts/check.mjs`:全仓语法检查(`node --check` 批量)
|
|
1445
|
-
- `
|
|
1446
|
-
-
|
|
1441
|
+
- 同步与安装自检能力已迁往 **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/<插件>`
|
|
1442
|
+
- 安装形态/HMR 自检实现随同迁移(`dsh-useful-tools/lib/core/plugin-sync/`);引用,非独立入口)
|
|
1447
1443
|
- **测试**:`npm test` 一条命令复现全绿(2026-10-09 实测 1195 用例 / 1193 通过 / 0 失败,2 跳过)
|
|
1448
1444
|
|
|
1449
1445
|
### 测试缓存(未变更的纯本地测试自动跳过)
|
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
|
-
|
|
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
|
|
package/lib/app/audit-api.js
CHANGED
|
@@ -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
|
-
|
|
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
|
{
|
|
@@ -119,17 +136,6 @@ export const TOOL_REGISTRY = [
|
|
|
119
136
|
{ flag: 'path', type: 'string', positional: 0, desc: '文件或目录(默认工作区)' },
|
|
120
137
|
],
|
|
121
138
|
},
|
|
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
139
|
{
|
|
134
140
|
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
141
|
params: [
|
package/lib/app/handlers/meta.js
CHANGED
|
@@ -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
|
-
|
|
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,
|
|
File without changes
|
package/lib/app/http-handlers.js
CHANGED
|
@@ -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
|
package/lib/app/tool-call.js
CHANGED
|
@@ -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,
|
|
@@ -389,6 +391,9 @@ async function callCommitPush(args, env, cfg, log, jobs, exec) {
|
|
|
389
391
|
rulesetDir: args.ruleset,
|
|
390
392
|
slots: undefined, // auditRuleOrder 是「加载顺序」不是白名单 ✗(详见 lib/commit-push.js 注释;禁用槽位用 auditDisabledSlots ✓)
|
|
391
393
|
cfg,
|
|
394
|
+
// 本次提交的按文件临时豁免(不落盘):列入的文件 finding 不参与拦截判定(含 blocker)
|
|
395
|
+
exemptPaths: Array.isArray(args.auditExemptPaths) ? args.auditExemptPaths : [],
|
|
396
|
+
exemptReason: args.auditExemptReason,
|
|
392
397
|
});
|
|
393
398
|
if (!auditGate.ok) return auditGate; // { ok:false, blocked:true, audit }
|
|
394
399
|
const doPush = () => pushWithPostSteps(args, env, cfg);
|
|
@@ -505,7 +510,9 @@ async function runStandardAuditTool(args, env, cfg, log, weights) {
|
|
|
505
510
|
// 审计后直接输出豁免类型统计 + 聚合类型 + 拦截列表(blocker 详情不用查 API)
|
|
506
511
|
const exemptStats = exemptStatsOf(auditResult.findings);
|
|
507
512
|
const blocked = auditResult.findings
|
|
508
|
-
|
|
513
|
+
// 统一口径:error 也属拦截级(与 summarize 一致)。此前只筛 'blocker' ⇒
|
|
514
|
+
// 出现「summary.blocker=10 但这里只枚举 7」的差额(差的正是 error 级)✗
|
|
515
|
+
.filter(isBlockerFinding)
|
|
509
516
|
.map((f) => ({ file: f.file, line: f.line, rule: f.rule, message: String(f.message || '').slice(0, MAX_MSG_PREVIEW) }));
|
|
510
517
|
// 审计输出改为「级别数量 + 评分 + API 查询用法」——审计明细由聚合 API
|
|
511
518
|
// (/api/git-push/audit)查询,不再内联输出 findings/审计内容(有聚合 API 消费审计结果)。
|
|
@@ -530,7 +537,7 @@ async function runStandardAuditTool(args, env, cfg, log, weights) {
|
|
|
530
537
|
return out;
|
|
531
538
|
}
|
|
532
539
|
|
|
533
|
-
export async function callTool(toolName, args = {}, env = {}, cfg = defaultConfig(), log = null, jobs = null, exec = null) {
|
|
540
|
+
export async function callTool(toolName, args = {}, env = {}, cfg = defaultConfig(), log = null, jobs = null, exec = null, fsCtx = null) {
|
|
534
541
|
switch (toolName) {
|
|
535
542
|
case 'git_scan': {
|
|
536
543
|
const root = args.root || getDefaultScanRoot(env, { defaultScanRoot: String(cfg.defaultScanRoot || '') });
|
|
@@ -546,6 +553,22 @@ export async function callTool(toolName, args = {}, env = {}, cfg = defaultConfi
|
|
|
546
553
|
}
|
|
547
554
|
case 'git_commit_push':
|
|
548
555
|
return callCommitPush(args, env, cfg, log, jobs, exec);
|
|
556
|
+
case 'exempt': {
|
|
557
|
+
// 注释豁免工具:add/remove/list/check(标记映射读同进程 EXEMPT_MARKERS,单一真源)
|
|
558
|
+
const { addExempt, removeExempt, listExempt, checkExempt } = await import('../exempt/tool.js');
|
|
559
|
+
const action = String(args.action || '');
|
|
560
|
+
const repoPath = String(args.repo || process.cwd());
|
|
561
|
+
if (action === 'add') {
|
|
562
|
+
return addExempt({
|
|
563
|
+
repoPath, path: args.path, line: args.line, scope: args.scope,
|
|
564
|
+
rule: args.rule, marker: args.marker, reason: args.reason, dryRun: args.dryRun === true,
|
|
565
|
+
});
|
|
566
|
+
}
|
|
567
|
+
if (action === 'remove') return removeExempt({ repoPath, path: args.path, marker: args.marker, dryRun: args.dryRun === true });
|
|
568
|
+
if (action === 'list') return listExempt({ repoPath });
|
|
569
|
+
if (action === 'check') return checkExempt({ repoPath });
|
|
570
|
+
return { ok: false, error: `未知 action:${action || '(空)'}(add/remove/list/check)` };
|
|
571
|
+
}
|
|
549
572
|
case 'code_audit':
|
|
550
573
|
return callCodeAudit(args, env, cfg, log, jobs, exec);
|
|
551
574
|
case 'git_gen_readme': {
|
|
@@ -599,24 +622,6 @@ export async function callTool(toolName, args = {}, env = {}, cfg = defaultConfi
|
|
|
599
622
|
const links = await checkLinks({ file: path, text: readTextSafe(path) });
|
|
600
623
|
return { ok: true, count: links.length, penalty: sumLinkPenalty(links), findings: links };
|
|
601
624
|
}
|
|
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
625
|
case 'module_splitter': {
|
|
621
626
|
// 巨型单文件拆分(复用 scripts/module-splitter.py,python3 零依赖)。
|
|
622
627
|
// python3 调用逻辑抽到 lib/git/module-splitter.js(与 cli cmdModuleSplitter 共用),
|
package/lib/ast/control-flow.js
CHANGED
|
@@ -297,22 +297,31 @@ export function checkNestingDepthAst(text = '', { warn = 4, block = 6 } = {}) {
|
|
|
297
297
|
let depth = 0;
|
|
298
298
|
let maxDepth = 0;
|
|
299
299
|
let maxLine = 1;
|
|
300
|
-
|
|
300
|
+
// 归属判定:用 function 栈(起始行 + 其函数体深度),而不是「深度归零前最后一个 function 关键字」——
|
|
301
|
+
// 后者在模块级代码(不在任何函数里)时会把嵌套归到**已结束的旧函数**,整条规则误报。
|
|
302
|
+
const fnStack = []; // [{ startLine, bodyDepth }]
|
|
303
|
+
let pendingFnLine = 0; // 已见 function 关键字、等其函数体 { 入栈
|
|
301
304
|
for (let i = 0; i < tokens.length; i++) {
|
|
302
305
|
const t = tokens[i];
|
|
303
|
-
if (t.type === 'ident' && t.value === 'function')
|
|
306
|
+
if (t.type === 'ident' && t.value === 'function') pendingFnLine = t.line;
|
|
304
307
|
if (t.type === 'punct' && t.value === '{') {
|
|
305
308
|
if (isBlockBrace.get(i)) {
|
|
306
309
|
depth++;
|
|
310
|
+
if (pendingFnLine) { fnStack.push({ startLine: pendingFnLine, bodyDepth: depth }); pendingFnLine = 0; }
|
|
307
311
|
if (depth > maxDepth) { maxDepth = depth; maxLine = t.line; }
|
|
308
312
|
}
|
|
309
313
|
} else if (t.type === 'punct' && t.value === '}') {
|
|
310
314
|
// 只有块大括号才减(对象字面量的 `}` 不影响)
|
|
311
315
|
if (isBlockBrace.get(matchingOpen(tokens, i))) {
|
|
316
|
+
// 先判归属(栈顶函数此时可能正在结束,仍应归到它),再出栈
|
|
317
|
+
const endingFn = fnStack.length > 0 && fnStack[fnStack.length - 1].bodyDepth === depth;
|
|
312
318
|
depth--;
|
|
313
319
|
if (depth === 0 && maxDepth > warn) {
|
|
314
|
-
|
|
320
|
+
// 归属:有活跃函数(含正在结束的那个)→ 它的起始行;模块级代码 → 嵌套最深行(maxLine)
|
|
321
|
+
const owner = fnStack.length ? fnStack[fnStack.length - 1].startLine : maxLine;
|
|
322
|
+
out.push({ line: owner, depth: maxDepth, level: maxDepth > block ? 'blocker' : 'warning' });
|
|
315
323
|
}
|
|
324
|
+
if (endingFn) fnStack.pop();
|
|
316
325
|
if (depth <= 0) { depth = 0; maxDepth = 0; }
|
|
317
326
|
}
|
|
318
327
|
}
|
package/lib/ast/size.js
CHANGED
|
@@ -339,8 +339,11 @@ export function checkCommentDensityAst(text = '', { warn = COMMENT_DENSITY_WARN_
|
|
|
339
339
|
export function checkRepeatedStringsAst(text = '', { min = 3, ignore = [] } = {}) {
|
|
340
340
|
const tokens = tokenize(text);
|
|
341
341
|
// tokenizer 产出的字面量类型名是 str / tmpl / num(非 string/number);
|
|
342
|
-
// 类型名不匹配会让本检查永不命中,故按实际类型名收集;num
|
|
343
|
-
|
|
342
|
+
// 类型名不匹配会让本检查永不命中,故按实际类型名收集;num 刻意排除(见上)。
|
|
343
|
+
// tmpl(模板字符串)也排除:模板串常用于「生成代码/拼接文本」(如垫片 harness 里
|
|
344
|
+
// 重复出现的 ` };` 缩进),其内部重复是生成内容而非「应配置化的硬编码值」,
|
|
345
|
+
// 统计它会把生成代码的排版误报成重复字面量(2026-10-17 实测误报)。
|
|
346
|
+
const LITERAL_TYPES = new Set(['str']);
|
|
344
347
|
const ignoreSet = new Set(['', ' ', '\n', '-', '/', '0', '1', 'utf8', 'string', 'number', 'boolean', 'object', 'function', ...ignore]);
|
|
345
348
|
const counts = new Map();
|
|
346
349
|
for (const t of tokens) {
|
package/lib/audit/audit-file.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { runChecks } from './checks.js';
|
|
2
2
|
import { exemptForFinding } from '../exempt/index.js';
|
|
3
|
-
import { hasExternalCallTimeout, hasMkdirInSameFunction } from './file-context.js';
|
|
3
|
+
import { hasExternalCallTimeout, hasMkdirInSameFunction, hasForeignWriteTarget } from './file-context.js';
|
|
4
4
|
import { CODE_EXTS } from './finding.js';
|
|
5
5
|
|
|
6
6
|
/**
|
|
@@ -166,10 +166,12 @@ export function auditFile({ file, relPath, text, grouped }, opts = {}) {
|
|
|
166
166
|
// 调用处无需重复设置(纯 regex 规则看不到包装内部)
|
|
167
167
|
if (/githubFetch\s*\(/.test(fileLines[idx] || '')) return false;
|
|
168
168
|
}
|
|
169
|
-
// mkdir
|
|
169
|
+
// mkdir 语义豁免:① 写文件前同函数已建目录(ensureDataDir 模式)
|
|
170
|
+
// ② 写目标来自调用方(形参 / 形参成员 / 由形参派生的临时路径)⇒ 目录不归本函数管
|
|
170
171
|
if (f.rule === 'robustness/mkdir-before-write') {
|
|
171
172
|
const idx = Math.max(0, (Number(f.line) || 1) - 1);
|
|
172
173
|
if (hasMkdirInSameFunction(fileLines, idx)) return false;
|
|
174
|
+
if (hasForeignWriteTarget(fileLines, idx)) return false;
|
|
173
175
|
}
|
|
174
176
|
// loader 契约语义豁免:已按统一 ModuleLoader 契约注册
|
|
175
177
|
if (f.rule === 'dsh/client-module-loader-id' && hasLoaderContract) return false;
|