dsh-git-push 2.8.6 → 2.9.3
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 +24 -5
- package/assets/minihost.sh +35 -0
- package/assets/preview.html +36703 -0
- package/assets/start.sh +396 -0
- package/assets/tree-sitter/LICENSE +21 -0
- package/assets/tree-sitter/README.md +69 -0
- package/assets/tree-sitter/VERSIONS.txt +1 -0
- package/assets/tree-sitter/tree-sitter-javascript.wasm +0 -0
- package/assets/tree-sitter/tree-sitter-python.wasm +0 -0
- package/assets/tree-sitter/tree-sitter-typescript.wasm +0 -0
- package/assets/tree-sitter/tree-sitter.js +3980 -0
- package/assets/tree-sitter/tree-sitter.wasm +0 -0
- package/lib/app/apply.js +15 -2
- package/lib/app/command-registry.js +2 -1
- package/lib/app/handlers/workspace-paths.js +107 -0
- package/lib/app/http-handlers.js +19 -2
- package/lib/app/inject-text.js +1 -1
- package/lib/app/tool-call.js +60 -8
- package/lib/ast/code-lines.js +52 -0
- package/lib/ast/fs-hotspots.js +154 -0
- package/lib/ast/index.js +1 -1
- package/lib/ast/perf.js +26 -10
- package/lib/ast/tokenizer.js +7 -2
- package/lib/ast/treesitter.js +208 -0
- package/lib/audit/audit-file.js +3 -3
- package/lib/audit/collector.js +4 -0
- package/lib/audit/orchestrate.js +41 -1
- package/lib/audit-rules/audit-rules-cpp.yml +106 -14
- package/lib/audit-rules/audit-rules-go.yml +95 -14
- package/lib/audit-rules/audit-rules-nodejs.yml +2 -2
- package/lib/audit-rules/audit-rules-paths.yml +1 -1
- package/lib/audit-rules/audit-rules-performance.yml +39 -9
- package/lib/audit-rules/audit-rules-php.yml +93 -14
- package/lib/audit-rules/audit-rules-rust.yml +101 -14
- package/lib/audit-rules/audit-rules-swift.yml +91 -14
- package/lib/checks/dispatch.js +3 -3
- package/lib/checks/fs-scanner.js +57 -0
- package/lib/checks/index.js +1 -0
- package/lib/checks/regex.js +19 -4
- package/lib/core/workspace-paths.js +108 -0
- package/lib/fs/edit-after-read.js +39 -0
- package/lib/rule/compilers/numeric-kinds.js +7 -0
- package/lib/rule/registry.js +7 -0
- package/lib/self/index.js +1 -1
- package/lib/user-requirements.json +2 -1
- package/package.json +2 -1
- package/scripts/doc-version.mjs +19 -90
- package/scripts/readme-gen.mjs +72 -22
- package/scripts/scan-fs-hotspots.mjs +107 -0
- package/scripts/sync-plugin-install.mjs +84 -21
- package/scripts/sync-plugin.mjs +14 -9
- package/skills/dev/dsh-git-push.md +18 -1
- package/skills/guide/guide-cli-scripts.md +1 -1
- package/skills/guide/guide-commit-push.md +33 -0
package/README.md
CHANGED
|
@@ -64,8 +64,8 @@ DSH(DeepSeek Harness)git 提交推送与代码审计插件——提交前自
|
|
|
64
64
|
|
|
65
65
|
| 文档 | 讲什么 |
|
|
66
66
|
|---|---|
|
|
67
|
-
| [docs/SPEC.md](docs/SPEC.md) | **当前有效规格唯一入口**:身份 / 18 个工具 /
|
|
68
|
-
| [docs/功能-审计规则体系.md](docs/功能-审计规则体系.md) | 22 个规则槽位 /
|
|
67
|
+
| [docs/SPEC.md](docs/SPEC.md) | **当前有效规格唯一入口**:身份 / 18 个工具 / 35 条 HTTP 接口 / 20 个设置键 / 4 个数据文件 / 审计规则体系 / 文档产物 / 版本纪律 / 测试基线 |
|
|
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 三份自动生成文档怎么更新、漂移怎么办 |
|
|
71
71
|
| [docs/功能-仓库索引与账号状态.md](docs/功能-仓库索引与账号状态.md) | `dsh-repo-index.json` 与 `account-status.json` 的写入时机、读取入口、统一收口约定 |
|
|
@@ -88,7 +88,7 @@ DSH(DeepSeek Harness)git 提交推送与代码审计插件——提交前自
|
|
|
88
88
|
|
|
89
89
|
| 功能块 | 做什么 | 入口 |
|
|
90
90
|
|---|---|---|
|
|
91
|
-
| **提交前审计门禁** | 提交前自动审计,blocker 拦截;22 个规则槽位
|
|
91
|
+
| **提交前审计门禁** | 提交前自动审计,blocker 拦截;22 个规则槽位 165 条规则、10 维度质量评分、豁免机制、链接检查、**三层审计管线(L1 正则初筛 / L2 AST 数据流 / L3 运行时检测)** | `code_audit` 工具 / CLI / 侧边栏 / 输入框 `/git-audit` |
|
|
92
92
|
| **审计结果 API** | `/api/git-push/audit`——请求时自定义聚合审计结果:按**规则类型 / 文件名 / 严重级 / 规则包**分组,`severity` 白名单过滤,`top` 截断,`withFindings` 附明细 | HTTP `GET/POST /api/git-push/audit` |
|
|
93
93
|
|
|
94
94
|
## 一、提交推送
|
|
@@ -272,7 +272,7 @@ dsh-git-push/
|
|
|
272
272
|
│ │ ├── slot-stats.js — 规则槽位命中统计(模块级状态)
|
|
273
273
|
│ │ ├── tool-call.js — 工具调用分发(git_scan/commit_push/audit/status 等全部工具)
|
|
274
274
|
│ │ ├── tools.js — 工具定义清单(名称/描述/参数 schema)
|
|
275
|
-
│ │ └── …(
|
|
275
|
+
│ │ └── …(10 个更深文件)
|
|
276
276
|
│ ├── ast/ — AST 实现层(token 级判定:括号/控制流/数据流/凭据/魔数/命名/规模/分词)
|
|
277
277
|
│ │ ├── brace.js — 括号配对与区间包含工具
|
|
278
278
|
│ │ ├── callgraph.js — 调用链追踪(单文件调用图 + isInRequestPath,io-risk 请求路径判定升级)
|
|
@@ -282,6 +282,7 @@ dsh-git-push/
|
|
|
282
282
|
│ │ ├── credential.js — 凭据标识符判定(硬编码/引用/类型检查)
|
|
283
283
|
│ │ ├── dataflow.js — 数据流检查(清空后访问,三层审计 L2)
|
|
284
284
|
│ │ ├── dup-code.js — (待注释)
|
|
285
|
+
│ │ ├── fs-hotspots.js — (待注释)
|
|
285
286
|
│ │ ├── index.js — AST 层统一出口
|
|
286
287
|
│ │ ├── io-risk-const.js — IO 风险分级·常量与档位工具:fs 调用名集/操作类别/风险标签/搜索窗口与阈值 + raise 升档
|
|
287
288
|
│ │ ├── io-risk-fn.js — IO 风险分级·函数边界识别与 token 配对:认普通/箭头/方法简写/类方法,圆括号花括号方括号前后向配对
|
|
@@ -297,6 +298,7 @@ dsh-git-push/
|
|
|
297
298
|
│ │ ├── size.js — 规模检查(函数长度/文件长度/重复字符串)
|
|
298
299
|
│ │ ├── symbol-index.js — (待注释)
|
|
299
300
|
│ │ ├── tokenizer.js — 分词器(token 流 + LRU 缓存)
|
|
301
|
+
│ │ ├── treesitter.js — (待注释)
|
|
300
302
|
│ ├── audit/ — 审计编排层(文件收集/逐文件检查/槽位聚合/审计出口)
|
|
301
303
|
│ │ ├── analysis-coverage.js — (待注释)
|
|
302
304
|
│ │ ├── audit-file.js — 单文件审计执行(跑检查+豁免)
|
|
@@ -351,6 +353,7 @@ dsh-git-push/
|
|
|
351
353
|
│ │ ├── file-health.js — 文件健康度(行数/字节/行长三维打分)
|
|
352
354
|
│ │ ├── filter.js — 规则作用域过滤(exts/exclude_paths)
|
|
353
355
|
│ │ ├── folder.js — 目录级检查(文件夹数/单目录文件数/解包特征)
|
|
356
|
+
│ │ ├── fs-scanner.js — (待注释)
|
|
354
357
|
│ │ ├── hardcoded-path.js — (待注释)
|
|
355
358
|
│ │ ├── index.js — 检查层统一出口
|
|
356
359
|
│ │ ├── io.js — IO 风险分级包装:checkIoRisk → lib/ast/io-risk.js(转 warning finding,取代 quality/sync-fs)
|
|
@@ -390,6 +393,7 @@ dsh-git-push/
|
|
|
390
393
|
│ │ ├── credentials.js — (待注释)
|
|
391
394
|
│ │ ├── endpoints.js — (待注释)
|
|
392
395
|
│ │ ├── exec.js — (待注释)
|
|
396
|
+
│ │ ├── workspace-paths.js — (待注释)
|
|
393
397
|
│ ├── exempt/ — 豁免机制(dsh-skip-* 注释标记解析与文件头/行内语义)
|
|
394
398
|
│ │ ├── index.js — 豁免注册表(dsh-skip-* 全标记消费)
|
|
395
399
|
│ ├── fs/ — (待注释)
|
|
@@ -491,6 +495,7 @@ dsh-git-push/
|
|
|
491
495
|
│ ├── rule-switch.mjs — 规则槽位手动启停 CLI
|
|
492
496
|
│ ├── rules-solo-audit.mjs — 规则单启控制变量扫描(基准全关+逐规则单启+全量对照,报告供 AI/人工审规则有效性与局限,按需运行非常驻)
|
|
493
497
|
│ ├── scan-file-io.mjs — 文件读写扫描器(列出所有 fs 读写调用位置 + 路径参数)
|
|
498
|
+
│ ├── scan-fs-hotspots.mjs — (待注释)
|
|
494
499
|
│ ├── scan-hardcoded-paths.mjs — (待注释)
|
|
495
500
|
│ ├── scan-repos.mjs — (待注释)
|
|
496
501
|
│ ├── scan-version.mjs — 版本一致性校验脚本
|
|
@@ -505,6 +510,15 @@ dsh-git-push/
|
|
|
505
510
|
├── assets/ — 预览页与配图(preview.html 交互模拟页 + 面板截图)
|
|
506
511
|
│ ├── minihost.sh — (待注释)
|
|
507
512
|
│ ├── start.sh — 预览服务器启停脚本(start/stop/restart/status + --port + PID/日志/健康检查 /preview-ping)
|
|
513
|
+
│ ├── tree-sitter/ — (待注释)
|
|
514
|
+
│ │ ├── LICENSE — (待注释)
|
|
515
|
+
│ │ ├── README.md — (待注释)
|
|
516
|
+
│ │ ├── VERSIONS.txt — (待注释)
|
|
517
|
+
│ │ ├── tree-sitter-javascript.wasm — (待注释)
|
|
518
|
+
│ │ ├── tree-sitter-python.wasm — (待注释)
|
|
519
|
+
│ │ ├── tree-sitter-typescript.wasm — (待注释)
|
|
520
|
+
│ │ ├── tree-sitter.js — (待注释)
|
|
521
|
+
│ │ ├── tree-sitter.wasm — (待注释)
|
|
508
522
|
├── test/ — node:test 全量单元测试(541+ 条,覆盖审计/推送/账号/HTTP/后台任务)
|
|
509
523
|
│ ├── .test — 空文件豁免标记(目录级豁免 .test 目录)
|
|
510
524
|
│ ├── e2e-npm-tab-render.mjs — (待注释)
|
|
@@ -513,6 +527,7 @@ dsh-git-push/
|
|
|
513
527
|
│ ├── test-account-refresh-on-push.mjs — (待注释)
|
|
514
528
|
│ ├── test-account-ssh.mjs — 账号检查 + SSH 密钥测试
|
|
515
529
|
│ ├── test-analysis-coverage.mjs — (待注释)
|
|
530
|
+
│ ├── test-ast-confirm-span.mjs — (待注释)
|
|
516
531
|
│ ├── test-audit-api-http.mjs — (待注释)
|
|
517
532
|
│ ├── test-audit-api.mjs — (待注释)
|
|
518
533
|
│ ├── test-audit-bad-file.mjs — 审计拦截门禁测试(硬编码密码/API key/.env 凭据文件)
|
|
@@ -568,6 +583,7 @@ dsh-git-push/
|
|
|
568
583
|
│ ├── test-file-health.mjs — 文件健康度矩阵评分测试
|
|
569
584
|
│ ├── test-filter-ext.mjs — (待注释)
|
|
570
585
|
│ ├── test-folder-scope.mjs — 目录级审计作用域回归测试
|
|
586
|
+
│ ├── test-fs-hotspots.mjs — (待注释)
|
|
571
587
|
│ ├── test-func-doc-drift.mjs — (待注释)
|
|
572
588
|
│ ├── test-generated-html-artifact.mjs — (待注释)
|
|
573
589
|
│ ├── test-git-api-tool.mjs — (待注释)
|
|
@@ -639,14 +655,17 @@ dsh-git-push/
|
|
|
639
655
|
│ ├── test-tool-probes.mjs — (待注释)
|
|
640
656
|
│ ├── test-tools-e2e.mjs — (待注释)
|
|
641
657
|
│ ├── test-tree-doc.mjs — README 目录树脚本测试(gen/check/apply 闭环)
|
|
658
|
+
│ ├── test-treesitter.mjs — (待注释)
|
|
642
659
|
│ ├── test-version-metrics.mjs — (待注释)
|
|
643
660
|
│ ├── test-visibility-unified.mjs — (待注释)
|
|
661
|
+
│ ├── test-workspace-paths.mjs — (待注释)
|
|
644
662
|
│ ├── fixtures/ — (待注释)
|
|
645
663
|
│ │ ├── TimeZoneComboBox-CRnoCikG.js — Pawchive 混淆产物样本(hash 文件名——跳过判定 fixture)
|
|
646
664
|
│ ├── helpers/ — (待注释)
|
|
647
665
|
│ │ ├── test-cache.mjs — (待注释)
|
|
648
666
|
│ │ ├── tmp-dir.mjs — (待注释)
|
|
649
667
|
├── docs/ — 开发文档
|
|
668
|
+
│ ├── 2.9.0-design.md — (待注释)
|
|
650
669
|
│ ├── 2026-10-09-审计插件性能优化.MD — (待注释)
|
|
651
670
|
│ ├── 2026-10-11-单一真源与文档漂移治理方案.MD — (待注释)
|
|
652
671
|
│ ├── 2026-10-11-硬编码路径改造为审计引擎方案.MD — (待注释)
|
|
@@ -1422,7 +1441,7 @@ node scripts/audit-runtime-check.mjs --all <目录>
|
|
|
1422
1441
|
- `scripts/audit-runtime-check.mjs`:三层审计的 L3 运行时检测(见「独立脚本:运行时检测」)
|
|
1423
1442
|
- `scripts/scrub-user-wording.mjs`:清洗注释里的沟通残留措辞(见「独立脚本:清洗用户沟通措辞」)
|
|
1424
1443
|
- `scripts/check.mjs`:全仓语法检查(`node --check` 批量)
|
|
1425
|
-
- `scripts/sync-plugin.mjs`:源码仓库 →
|
|
1444
|
+
- `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/<插件>`
|
|
1426
1445
|
- `scripts/sync-plugin-install.mjs`:上一条里安装形态/HMR 自检的实现模块(被 `sync-plugin.mjs` 引用,非独立入口)
|
|
1427
1446
|
- **测试**:`npm test` 一条命令复现全绿(2026-10-09 实测 1195 用例 / 1193 通过 / 0 失败,2 跳过)
|
|
1428
1447
|
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# dsh-plugin mini-host 一键启动 —— 本地跑本插件服务端代码,**改完代码刷新页面即生效**,
|
|
3
|
+
# 既不用重启 DSH 宿主、也不用重启本服务(每个请求 fork 一次性子进程,插件模块天然新鲜)。
|
|
4
|
+
#
|
|
5
|
+
# 依赖通用工具:dsh-plugin-minihost.mjs(+ dsh-plugin-minihost-child.mjs)
|
|
6
|
+
# 位置:技能仓库 ai-work-archive/skills/,或运行时目录 <DSH_HOME>/skills/
|
|
7
|
+
# 用法:
|
|
8
|
+
# bash assets/minihost.sh # 默认端口 31100
|
|
9
|
+
# bash assets/minihost.sh --port 31200 # 换端口(其余参数透传给 mini-host)
|
|
10
|
+
# 环境变量:
|
|
11
|
+
# DSH_SKILLS_DIR 指定含通用工具的 skills 目录(默认 $DSH_HOME/skills 或 ~/.dsh/skills)
|
|
12
|
+
# PORT 默认端口(默认 31100)
|
|
13
|
+
# NODE_BIN 指定 node(默认 PATH 里的 node)
|
|
14
|
+
set -uo pipefail
|
|
15
|
+
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
|
16
|
+
SKILLS_DIR="${DSH_SKILLS_DIR:-${DSH_HOME:-$HOME/.dsh}/skills}"
|
|
17
|
+
TOOL="$SKILLS_DIR/dsh-plugin-minihost.mjs"
|
|
18
|
+
if [ ! -f "$TOOL" ]; then
|
|
19
|
+
echo "找不到通用工具:$TOOL"
|
|
20
|
+
echo "请设置 DSH_SKILLS_DIR 指向含 dsh-plugin-minihost.mjs 的 skills 目录"
|
|
21
|
+
exit 2
|
|
22
|
+
fi
|
|
23
|
+
ARGS=(--plugin "$ROOT" --port "${PORT:-31100}")
|
|
24
|
+
# 预览页是**生成产物**(.gitignore 已忽略,不入库):缺失时先自动生成一次,
|
|
25
|
+
# 否则 --preview 分支会**静默跳过**(页面打开是 404/无预览页,且没有任何报错)。
|
|
26
|
+
PREVIEW_HTML="$ROOT/assets/preview.html"
|
|
27
|
+
PREVIEW_GEN="$ROOT/scripts/preview-gen.mjs"
|
|
28
|
+
if [ ! -f "$PREVIEW_HTML" ] && [ -f "$PREVIEW_GEN" ]; then
|
|
29
|
+
echo "[minihost] 预览页缺失,先生成一次:node scripts/preview-gen.mjs"
|
|
30
|
+
"${NODE_BIN:-node}" "$PREVIEW_GEN" >/dev/null 2>&1 \
|
|
31
|
+
|| echo "[minihost] 预览页生成失败(继续启动,但不带预览页)"
|
|
32
|
+
fi
|
|
33
|
+
[ -f "$PREVIEW_HTML" ] && ARGS+=(--preview "$PREVIEW_HTML")
|
|
34
|
+
[ -d "$ROOT/lib" ] && ARGS+=(--static "$ROOT/lib")
|
|
35
|
+
exec "${NODE_BIN:-node}" "$TOOL" "${ARGS[@]}" "$@"
|