dsh-git-push 2.10.5 → 2.12.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.
Files changed (35) hide show
  1. package/.auditignore +2 -4
  2. package/README.md +78 -1487
  3. package/lib/app/inject-text.js +0 -1
  4. package/lib/app/tool-call.js +2 -2
  5. package/lib/ast/io-risk-loop.js +1 -1
  6. package/lib/ast/tokenizer.js +76 -1
  7. package/lib/ast/treesitter.js +78 -14
  8. package/lib/audit/collector.js +9 -1
  9. package/lib/audit/finding.js +8 -1
  10. package/lib/audit/report-yaml.js +5 -1
  11. package/lib/audit-rules/audit-rules-comment.yml +0 -68
  12. package/lib/audit-rules/audit-rules-csharp.yml +82 -0
  13. package/lib/audit-rules/audit-rules-structure.yml +2 -3
  14. package/lib/git/push.js +1 -1
  15. package/lib/rule/loader.js +5 -1
  16. package/lib/self/index.js +1 -1
  17. package/lib/skip-dirs.js +6 -3
  18. package/package.json +6 -1
  19. package/scripts/doc-tree.mjs +4 -2
  20. package/scripts/doc-version.mjs +4 -4
  21. package/scripts/{readme-gen.mjs → version-source.mjs} +8 -153
  22. package/skills/dev/dsh-git-push.md +3 -11
  23. package/skills/guide/guide-cli-scripts.md +0 -2
  24. package/assets/tree-sitter/LICENSE +0 -21
  25. package/assets/tree-sitter/README.md +0 -69
  26. package/assets/tree-sitter/VERSIONS.txt +0 -1
  27. package/assets/tree-sitter/tree-sitter-javascript.wasm +0 -0
  28. package/assets/tree-sitter/tree-sitter-python.wasm +0 -0
  29. package/assets/tree-sitter/tree-sitter-typescript.wasm +0 -0
  30. package/assets/tree-sitter/tree-sitter.js +0 -3980
  31. package/assets/tree-sitter/tree-sitter.wasm +0 -0
  32. package/lib/readme-templates/readme.yml +0 -38
  33. package/lib/vendor/js-yaml/LICENSE +0 -21
  34. package/lib/vendor/js-yaml/js-yaml.mjs +0 -3073
  35. package/scripts/scrub-user-wording.mjs +0 -420
@@ -35,7 +35,6 @@ export const FUNCTION_USAGE_HINT = [
35
35
  '· git_remote_create —— 按项目文件夹在 GitHub 建远端仓库(已存在则复用),并把 origin 指向它。',
36
36
  '· git_set_visibility —— 切换仓库 public/private。',
37
37
  '· git_clone —— 从 GitHub clone 到本地(走 GitHub API,不直连 github.com)。',
38
- ' (README 生成已抽为独立脚本:`node scripts/readme-gen.mjs <repo> [--write <path>]`,见插件 skill 文档组织节)',
39
38
  '· link_check —— 检查文档内链接有效性(只报 warning,不拦截)。',
40
39
  '· npm_publish —— npm 发包(**后台 job**,返回 jobId 可用 job_output 查):默认 dryRun=true 只体检 + `npm publish --dry-run`(不写 registry ✗);真发必须同时传 confirm=true 与 dryRun=false(不可撤销,先 dryRun 看包内容)。参数:dir(目标包目录,缺省工作区)/ tag(默认 latest)/ otp(2FA)/ dryRun / confirm。',
41
40
  '· git_sluice —— 浅包装 git 透传工具(AI 直接调用任意 git 命令,凭据自动注入):args 传与 git 完全一致的参数串(空格分隔,路径含空格用引号);例:git_sluice({args:"status --short"}) / git_sluice({args:"log --oneline -5"}) / git_sluice({args:"branch -a"})。返回 status + stdout/stderr。git 的其余能力(log/diff/branch/tag/remote 等)用它;高频写操作仍走 git_commit_push/git_clone 等专用工具(自带审计/门禁)。',
@@ -580,8 +580,8 @@ export async function callTool(toolName, args = {}, env = {}, cfg = defaultConfi
580
580
  case 'code_audit':
581
581
  return callCodeAudit(args, env, cfg, log, jobs, exec);
582
582
  case 'git_gen_readme': {
583
- // README 生成已抽为独立脚本 scripts/readme-gen.mjs,插件不再内置此工具。
584
- return { ok: false, error: 'git_gen_readme 已移除:请用 `node scripts/readme-gen.mjs <repo> [--write <path>]`(见插件 skill 文档组织节)' };
583
+ // README 生成能力已整体下线(README 由 readme-spec 手工维护,不再按模板渲染)。
584
+ return { ok: false, error: 'git_gen_readme 已移除:README 由使用手册规范手工维护,不再提供模板生成' };
585
585
  }
586
586
  case 'git_clone': {
587
587
  if (!args.target) return { ok: false, error: 'target 必填' };
@@ -35,7 +35,7 @@ export function isSmallLiteralCallee(tokens, methodIdx) {
35
35
  * 识别 `const candidates = ['a']; if (x) candidates.push(b); for (const f of candidates)`
36
36
  * 这类**候选路径探测**——它规模确定(≤ SMALL_FIXED_LOOP_MAX)、执行次数极少,
37
37
  * 与字面量数组同义;不识别会导致「循环内 I/O 高风险」误报(实测 config.js /
38
- * readme-gen / credentials.js 共 8 处候选探测全被误判)。
38
+ * 文档生成脚本 / credentials.js 共 8 处候选探测全被误判)。
39
39
  *
40
40
  * 保守策略:只要出现字面量数组**之外**的写入方式(concat/splice/展开赋值等),
41
41
  * 即视为规模未知,返回 false(宁可保守报高风险,也不放过真问题)。
@@ -179,7 +179,10 @@ function tokenizeUncached(text = '') {
179
179
  // `const css = ` 后面紧跟换行(反引号正好在行尾)时,token 值就是**单个反引号**,
180
180
  // endsWith('`') 为真 ⇒ 旧判据漏置跨行状态 ⇒ 模板正文(CSS/帮助文本)整段被当代码,
181
181
  // CSS 里的 #141518 / #888 / 1.5 被 readability/magic-number-smart 当魔数误报。
182
- if (lastTok && lastTok.type === 'tmpl' && String(lastTok.value).indexOf('`', 1) === -1) inTemplate = true;
182
+ // 判据补 startsWith('`'):C# 插值串产物同为 tmpl 但不含反引号,
183
+ // 不收紧会把其后所有行并进模板(实测整段被吞成一个 tmpl token)。
184
+ if (lastTok && lastTok.type === 'tmpl' && String(lastTok.value).startsWith('`')
185
+ && String(lastTok.value).indexOf('`', 1) === -1) inTemplate = true;
183
186
  i = res; continue;
184
187
  }
185
188
  // 标点 / 其他(单字符)
@@ -246,6 +249,11 @@ const REGEX_AFTER_KEYWORD = /^(?:return|typeof|case|in|of|new|delete|void|do|els
246
249
  * 分支密集,全部内联在 while 里无法维护;按词素类型抽独立函数,主循环只做分派。
247
250
  */
248
251
  function consumeLexeme(src, i, n, ch, next, tokens, push) { // dsh-skip-complexity: 词素分派器(六类词素分派分支为结构必然,拆分后职责单一)
252
+ // C# 插值串($"…" / $@"…" / @$"…")→ tmpl,须先于普通字符串与标识符分支判定
253
+ if (ch === '$' || ch === '@') {
254
+ const cs = consumeCsharpInterpolated(src, i, n, push);
255
+ if (cs) return cs;
256
+ }
249
257
  // 字符串(' ")——普通单引号字符串;三引号(""" ''')由主循环专门处理
250
258
  if (ch === '"' || ch === "'") return consumeString(src, i, n, ch, push);
251
259
  // 模板字符串(`)——嵌套 ${} 简化处理:遇未闭合 ` 归并到行尾
@@ -284,6 +292,73 @@ function consumeLexeme(src, i, n, ch, next, tokens, push) { // dsh-skip-complexi
284
292
  return 0;
285
293
  }
286
294
 
295
+ /**
296
+ * C# 插值串(`$"…"` / `$@"…"` / `@$"…"`)—— 产出 `tmpl` 类型。
297
+ *
298
+ * 为什么:插值串里的 `{expr}` 是**表达式**而不是文本。若按普通字符串(`str`)处理,
299
+ * 「重复硬编码文本」统计会把表达式当成硬编码值参与计数(C# 语料实测 10/41 由此误报,
300
+ * 如 `$"<error: {ex.Message}>"` 被提成 `<error: {ex.Message}>`)。它在语义上与 JS 模板串
301
+ * 同类,故复用既有 `tmpl` 口径(该规则的提取器已刻意排除 `tmpl`)。
302
+ * 边界:
303
+ * · `@"…"`(verbatim 但**不插值**)是纯字面量,仍按 `str`,不在此处理;
304
+ * · verbatim 串内连续两个 `""` 表示一个转义引号,不构成闭合;
305
+ * · 插值洞 `{…}` 里可以再出现字符串(`$"{(c ? a : "null")}, "`),洞内的 `"` **不**结束
306
+ * 整个插值串,故必须按花括号深度判定——否则会在洞内第一个引号处截断,残留 `)}, "` 片段
307
+ * 又被当成普通字符串参与统计(实测该形态仍误报);
308
+ * · 转义的大括号 `{{` / `}}` 是字面量括号,不改变深度。
309
+ * @returns {number} 消费后的新下标;非插值串返回 0(交其它词素处理)
310
+ */
311
+ function consumeCsharpInterpolated(src, i, n, push) { // dsh-skip-complexity: 三前缀组合 + 洞内嵌套串 + verbatim 转义
312
+ const three = src.slice(i, i + 3);
313
+ const two = src.slice(i, i + 2);
314
+ let quoteAt = -1;
315
+ if (three === '$@"' || three === '@$"') quoteAt = i + 2;
316
+ else if (two === '$"') quoteAt = i + 1;
317
+ if (quoteAt < 0) return 0;
318
+ const verbatim = src.slice(i, quoteAt).includes('@');
319
+ let j = quoteAt + 1;
320
+ let str = src.slice(i, quoteAt + 1);
321
+ let depth = 0;
322
+ const pushChar = () => { str += src[j]; j++; };
323
+ while (j < n) {
324
+ const ch = src[j];
325
+ if (depth > 0) {
326
+ // 洞内:花括号调节深度;字符串整段跳过(不参与闭合判定)
327
+ if (ch === '"') {
328
+ pushChar();
329
+ while (j < n) {
330
+ if (src[j] === '\\') { pushChar(); if (j < n) pushChar(); continue; }
331
+ const c2 = src[j];
332
+ pushChar();
333
+ if (c2 === '"') break;
334
+ }
335
+ continue;
336
+ }
337
+ if (ch === '{') { depth++; pushChar(); continue; }
338
+ if (ch === '}') { depth--; pushChar(); continue; }
339
+ pushChar();
340
+ continue;
341
+ }
342
+ if (!verbatim && ch === '\\') { pushChar(); if (j < n) pushChar(); continue; }
343
+ if (ch === '{') {
344
+ if (src[j + 1] === '{') { pushChar(); pushChar(); continue; } // {{ 转义,不计深度
345
+ depth++; pushChar(); continue;
346
+ }
347
+ if (ch === '}') {
348
+ if (src[j + 1] === '}') { pushChar(); pushChar(); continue; } // }} 转义,不计深度
349
+ pushChar(); continue;
350
+ }
351
+ if (ch === '"') {
352
+ if (verbatim && src[j + 1] === '"') { pushChar(); pushChar(); continue; }
353
+ pushChar();
354
+ break;
355
+ }
356
+ pushChar();
357
+ }
358
+ push('tmpl', str);
359
+ return j;
360
+ }
361
+
287
362
  /** 字符串字面量(' ")——遇转义 \ 跳两字符;未闭合归并到行尾。 */
288
363
  function consumeString(src, i, n, ch, push) {
289
364
  let j = i + 1;
@@ -8,8 +8,12 @@
8
8
  * 为什么这么设计:审计是提交门禁的一部分,**不能因为增强件坏了就整体失效** ✗。
9
9
  * 回退不是异常路径,而是常态路径之一 ✓。
10
10
  *
11
- * 资产:assets/tree-sitter/(web-tree-sitter@0.27.1 + 各语言预编译 grammar;MIT)
12
- * 来源、版本、sha256、可复现下载命令见该目录 README.md ✓
11
+ * 来源:**npm 依赖**——`web-tree-sitter@0.25.10`(运行时 + 它的 tree-sitter.wasm)与
12
+ * `tree-sitter-wasms@0.1.13`(各语言预编译 grammar,MIT)。仓库内不再保存任何 vendored 副本。
13
+ * 两者**必须精确锁版**:实测 web-tree-sitter@0.27.1 与本套语法 ABI 不兼容
14
+ * (在 getDylinkMetadata 处报空消息错误)⇒ 升版会让 AST 全线静默降级。
15
+ * 解析顺序(三级):`DSH_GIT_PUSH_TS_ASSETS` env 覆盖 → npm 包目录 → 两者都拿不到即返回「不可用」,
16
+ * 由调用方回退 token 级判定。
13
17
  *
14
18
  * 语言口径(既定口径):**加载哪些语言 = lib/audit-rules/ 里存在哪些语言规则包**
15
19
  * (**空占位包也算**:cpp/go/php/rust/swift)。语法文件不存在时该语言自动走回退 ✓。
@@ -19,17 +23,59 @@ import { createHash } from 'node:crypto';
19
23
  import { fileURLToPath, pathToFileURL } from 'node:url';
20
24
  import { dirname, join } from 'node:path';
21
25
 
22
- /** 资产目录(插件根/assets/tree-sitter)——本文件在 lib/ast/,故上溯两级。
23
- * 可用 env `DSH_GIT_PUSH_TS_ASSETS` 覆盖:**回退路径测试**把它指向不存在的目录即可
24
- * (测试禁止改动真实资产目录 ✗)。注意:本常量在**模块加载时**求值,测试需用子进程改 env ✓ */
25
- export const ASSETS_DIR = process.env.DSH_GIT_PUSH_TS_ASSETS
26
- || join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'assets', 'tree-sitter');
26
+ /** env 覆盖的外部目录:内含 tree-sitter.js / tree-sitter.wasm / tree-sitter-<lang>.wasm。
27
+ * **回退路径测试**把它指向不存在的目录即可(测试不碰真实依赖 ✗);运维也可用它把资产指到别处。
28
+ * 在模块加载时求值,测试需用子进程改 env ✓ */
29
+ export const ASSETS_DIR = process.env.DSH_GIT_PUSH_TS_ASSETS || '';
30
+
31
+ /** 包目录(解析失败为空串 ⇒ 上层按「不可用」回退)。 */
32
+ let runtimeDir = null;
33
+ let grammarsDir = null;
34
+
35
+ /**
36
+ * 定位两个依赖包目录。
37
+ *
38
+ * 用 `import.meta.resolve` 而不是 `require.resolve`:本模块是 ESM,且 require 需要 createRequire 垫片。
39
+ * web-tree-sitter 有 exports 字段,`resolve('web-tree-sitter')` 拿到的是 **ESM 入口**
40
+ * tree-sitter.js(实测),取其 dirname 即包目录,`tree-sitter.wasm` 就在同级 ✓;
41
+ * `web-tree-sitter/package.json` 反而**不在 exports 白名单里**(ERR_PACKAGE_PATH_NOT_EXPORTED)⇒
42
+ * 想拿包目录只能由入口路径回溯,不要改成解析 package.json。
43
+ * tree-sitter-wasms 无 exports 字段 ⇒ 子路径可自由解析(这里解析一个必然存在的语法作为锚)。
44
+ * @returns {{runtimeDir: string, grammarsDir: string}}
45
+ */
46
+ function resolveDirs() {
47
+ if (runtimeDir !== null && grammarsDir !== null) return { runtimeDir, grammarsDir };
48
+ const pick = (spec) => {
49
+ try { return dirname(fileURLToPath(import.meta.resolve(spec))); } catch { return ''; }
50
+ };
51
+ if (runtimeDir === null) runtimeDir = pick('web-tree-sitter');
52
+ if (grammarsDir === null) grammarsDir = pick('tree-sitter-wasms/out/tree-sitter-javascript.wasm');
53
+ // env 覆盖优先:指向一个「runtime 与语法同级」的目录(回退实验与运维换源都走这里)
54
+ if (ASSETS_DIR) { runtimeDir = ASSETS_DIR; grammarsDir = ASSETS_DIR; }
55
+ return { runtimeDir, grammarsDir };
56
+ }
27
57
 
28
58
  /** 扩展名 → 语法名(grammar)。没有映射的扩展名一律走回退 ✓。 */
29
59
  export const EXT_TO_GRAMMAR = {
30
60
  js: 'javascript', mjs: 'javascript', cjs: 'javascript', jsx: 'javascript',
31
61
  ts: 'typescript', tsx: 'typescript', mts: 'typescript', cts: 'typescript',
32
62
  py: 'python',
63
+ // ── 规则包早已存在、此前一直无语法树(走 token 级回退)的语言 ──
64
+ // 语法名以 tree-sitter-wasms@0.1.13 的 out/ 里**实际存在的文件名**为准(逐个核对过,不凭记忆写)。
65
+ // C# 的内部名带下划线:写成 csharp 会去找不存在的 wasm ⇒ 静默回退,规则表现成「看起来接不通」。
66
+ cs: 'c_sharp',
67
+ c: 'c',
68
+ cpp: 'cpp', cc: 'cpp', cxx: 'cpp', hpp: 'cpp', hh: 'cpp', hxx: 'cpp',
69
+ // .h 归属取 cpp 而非 c:C 与 C++ 共用该扩展名,cpp 语法是 C 的超集。
70
+ // 交给 c 语法时,合法 C++ 头文件会解析出 ERROR ⇒ 整棵树作废退回 token 级(等于白接);
71
+ // 反过来把纯 C 头交给 cpp 语法不会报错(C 是子集)。
72
+ h: 'cpp',
73
+ go: 'go',
74
+ java: 'java',
75
+ kt: 'kotlin',
76
+ php: 'php', phtml: 'php',
77
+ rs: 'rust',
78
+ swift: 'swift',
33
79
  };
34
80
 
35
81
  /** 单文件解析预算(字符数):超此长度不解析,直接回退(避免大文件拖慢审计)。 */
@@ -47,14 +93,20 @@ const treeCache = new Map(); // hash → tree(简单 FIFO 淘汰)
47
93
  /** 资产是否就位(供调用方与自检使用)。 */
48
94
  export function treesitterAvailable() {
49
95
  try {
50
- return existsSync(join(ASSETS_DIR, 'tree-sitter.js')) && existsSync(join(ASSETS_DIR, 'tree-sitter.wasm'));
96
+ const { runtimeDir: rd } = resolveDirs();
97
+ if (!rd) return false;
98
+ // env 覆盖模式下 runtime 是目录里的 tree-sitter.js;npm 模式下入口由 exports 决定
99
+ // (tree-sitter.js / tree-sitter.mjs 都可能),故只校验「能拿到 ESM 入口 + 同级 wasm」。
100
+ return existsSync(join(rd, 'tree-sitter.wasm'));
51
101
  } catch { return false; }
52
102
  }
53
103
 
54
104
  /** 当前资产里实际可用的语法名列表(按目录里存在的 wasm 推断)。 */
55
105
  export function availableGrammars() {
56
106
  try {
57
- return readdirSync(ASSETS_DIR)
107
+ const { grammarsDir: gd } = resolveDirs();
108
+ if (!gd) return [];
109
+ return readdirSync(gd)
58
110
  .map((f) => /^tree-sitter-(.+)\.wasm$/.exec(f))
59
111
  .filter(Boolean)
60
112
  .map((m) => m[1])
@@ -73,7 +125,15 @@ export function grammarForExt(ext = '') {
73
125
  * tree-sitter-wasms@0.1.13 的语法不兼容 —— 实测 0.27.1 在 getDylinkMetadata 处报空消息错误 ✗)。 */
74
126
  async function loadModule() {
75
127
  if (!modPromise) {
76
- modPromise = import(pathToFileURL(join(ASSETS_DIR, 'tree-sitter.js')).href);
128
+ // 两种布局:
129
+ // · npm 依赖 → 裸 specifier,让 ESM loader 按包的 exports 取 ESM 入口(0.25.10 → ./tree-sitter.js);
130
+ // · vendored / env 覆盖目录 → 目录里就有 tree-sitter.js,必须按文件路径加载,
131
+ // 否则在「只拷了插件目录、没装 dependencies」的部署端会 import 失败(实测过:语法读得到、runtime 拿不到)。
132
+ const { runtimeDir: rd } = resolveDirs();
133
+ const vendoredRuntime = rd ? join(rd, 'tree-sitter.js') : '';
134
+ modPromise = vendoredRuntime && existsSync(vendoredRuntime)
135
+ ? import(pathToFileURL(vendoredRuntime).href)
136
+ : import('web-tree-sitter');
77
137
  }
78
138
  return modPromise;
79
139
  }
@@ -83,8 +143,11 @@ async function ensureInit() {
83
143
  if (!initPromise) {
84
144
  initPromise = (async () => {
85
145
  const { Parser } = await loadModule();
86
- // locateFile:告诉运行时去哪里取 web-tree-sitter.wasm(默认会按 URL 猜,容器里不可靠)
87
- await Parser.init({ locateFile: (f) => join(ASSETS_DIR, f) });
146
+ // locateFile:告诉运行时去哪里取 web-tree-sitter.wasm(默认会按 URL 猜,容器里不可靠)。
147
+ // 目录来自 resolveDirs()(npm 包目录或 env 覆盖目录)——不能写死 ASSETS_DIR:
148
+ // 无 env 覆盖时它是空串,join('', f) 会退化成相对路径 ⇒ ENOENT(改这行时踩过)。
149
+ const { runtimeDir: rd } = resolveDirs();
150
+ await Parser.init({ locateFile: (f) => (rd ? join(rd, f) : f) });
88
151
  return true;
89
152
  })().catch(() => null);
90
153
  }
@@ -93,7 +156,8 @@ async function ensureInit() {
93
156
 
94
157
  /** 取(并缓存)某语言的 Parser;不可用返回 null。 */
95
158
  async function getParser(grammar) {
96
- if (!grammar || !existsSync(join(ASSETS_DIR, `tree-sitter-${grammar}.wasm`))) return null;
159
+ const { grammarsDir: gd } = resolveDirs();
160
+ if (!grammar || !gd || !existsSync(join(gd, `tree-sitter-${grammar}.wasm`))) return null;
97
161
  if (parserCache.has(grammar)) return parserCache.get(grammar);
98
162
  try {
99
163
  if (!(await ensureInit())) return null;
@@ -102,7 +166,7 @@ async function getParser(grammar) {
102
166
  if (!lang) {
103
167
  // 传**字节**而不是路径:0.27.x 的 load(路径) 会静默失败(Node 分支虽会 readFile,但 dylink 不兼容);
104
168
  // 字节是唯一被实测验证可用的入口(0.25.10 ✓)
105
- lang = await Language.load(readFileSync(join(ASSETS_DIR, `tree-sitter-${grammar}.wasm`)));
169
+ lang = await Language.load(readFileSync(join(gd, `tree-sitter-${grammar}.wasm`)));
106
170
  langCache.set(grammar, lang);
107
171
  }
108
172
  const parser = new Parser();
@@ -17,7 +17,7 @@ import { GIT_GLOBAL_ARGS } from '../core/exec.js';
17
17
  /** 跳过目录集合 = 硬编码基线(node_modules/.git) ∪ yml 黑名单关键词(加载一次缓存)。 */
18
18
  const SKIP_DIRS = getSkipSet();
19
19
 
20
- const TEXT_EXT = new Set([
20
+ export const TEXT_EXT = new Set([
21
21
  'js', 'mjs', 'cjs', 'ts', 'tsx', 'jsx', 'json', 'yml', 'yaml', 'md', 'txt', 'html', 'css',
22
22
  'sh', 'py', 'rb', 'go', 'rs', 'java', 'c', 'cpp', 'h', 'hpp', 'xml', 'toml', 'ini', 'cfg',
23
23
  'conf', 'env', 'gitignore', 'npmrc', 'properties', 'sql', 'vue', 'svelte',
@@ -25,6 +25,14 @@ const TEXT_EXT = new Set([
25
25
  // ⇒ 这两个语言的文件从来没进过审计管道,规则写了也永远 0 命中(实测合成样例 0 命中定位到此处)。
26
26
  // phtml 是 PHP 模板扩展名(同 PHP 槽位 exts),kt 与 java 槽位共用一个包。
27
27
  'php', 'phtml', 'swift', 'kt',
28
+ // 2026-10-29 补:C# 与 C/C++ 的其余常见扩展名。
29
+ // .cs 此前不在白名单 ⇒ C# 文件**完全不进审计管道**(668 个 .cs 的全量审计只收到 26 个非 .cs 文件);
30
+ // cc/cxx/hh/hxx 同理——EXT_TO_GRAMMAR 里映射了语法,但白名单不放行的话文件根本到不了解析那一步。
31
+ // 这两处必须同时改:只补映射 = 语法永远用不上,只补白名单 = 一直走 token 级回退。
32
+ 'cs', 'cc', 'cxx', 'hh', 'hxx',
33
+ // mts/cts 是 TypeScript 的模块变体扩展名:EXT_TO_GRAMMAR 早已映射到 typescript 语法,
34
+ // 但这里一直没放行 ⇒ 文件不进管道(与 .cs 同一类缺口)。wasms 里没有独立语法,复用 typescript 即可。
35
+ 'mts', 'cts',
28
36
  ]);
29
37
  /** git 探活 / 忽略清单批量判定 / 单目录判定 的超时(毫秒)。 */
30
38
  const GIT_PROBE_TIMEOUT_MS = 10_000;
@@ -90,4 +90,11 @@ export function summarize(findings = []) {
90
90
  }
91
91
 
92
92
  /** 代码文件扩展名(residue/style 类检查只对代码生效,修规则定义/文档自举假阳性)。 */
93
- export const CODE_EXTS = new Set(['js', 'mjs', 'cjs', 'ts', 'tsx', 'jsx', 'py', 'go', 'rs', 'java', 'kt', 'swift', 'php', 'rb', 'sh', 'bash']);
93
+ export const CODE_EXTS = new Set([
94
+ 'js', 'mjs', 'cjs', 'ts', 'tsx', 'jsx', 'py', 'go', 'rs', 'java', 'kt', 'swift', 'php', 'rb', 'sh', 'bash',
95
+ // C / C++ / C#:这些扩展名早就在 collect 的 TEXT_EXT 白名单里、也已有 cpp 规则包,
96
+ // 但一直没进本表 ⇒ audit-file 判它们为「非代码文件」、semantic 类检查直接整体跳过,
97
+ // 等于把 C/C++/C# 当文档审(既有缺口,不是本轮新引入)。
98
+ // phtml 是 PHP 模板(php 已在表内,同语言不同扩展名不能只放一半)。
99
+ 'c', 'cc', 'cxx', 'cpp', 'h', 'hpp', 'hh', 'hxx', 'cs', 'phtml',
100
+ ]);
@@ -5,7 +5,11 @@
5
5
  * 供 CLI --json / 插件工具 code_audit 返回体携带,便于人读与机器解析。
6
6
  */
7
7
 
8
- import { dump as yamlDump } from '../vendor/js-yaml/js-yaml.mjs';
8
+ // js-yaml 走 npm 依赖(仓库内不保存副本)。
9
+ // 这里**故意用静态 import**:规则加载是启动关键路径,依赖没装上就应当在模块加载期
10
+ // 抛 ERR_MODULE_NOT_FOUND(错误里带包名,够响亮),而不是被 try/catch 吞成「0 条规则」
11
+ // 继续跑——静默无规则比启动失败更危险(口径见 docs/2026-10-28-弃零依赖引入npm与AST优先规则方案.MD D5)。
12
+ import { dump as yamlDump } from 'js-yaml';
9
13
 
10
14
  /** 拦截级别顺序(聚合时按此排布;未知级别归入其他)。 */
11
15
  const SEVERITY_ORDER = ['blocker', 'warning', 'notice', 'info'];
@@ -156,74 +156,6 @@ rules:
156
156
  - "@date"
157
157
  fixable: false
158
158
 
159
- # ----- 清洗改写表(scrub-user-wording.mjs 读取;审计不消费)-----
160
- # 顺序敏感:先特例后通配。match 为 JS 正则源码(脚本加 g 标志)。
161
- # replace 为替换模板:$1/$2… 对应捕获组;空串=删除。
162
- rewrites:
163
- # 1) 括注「用户原话」→ 删除括注,后续冒号保留
164
- - match: "(用户原话)"
165
- replace: ""
166
- - match: "\\(用户原话\\)"
167
- replace: ""
168
- # 2) 日期 + 措辞 → 只留日期
169
- - match: "(\\d{4}-\\d{2}-\\d{2}) 用户要求("
170
- replace: "$1("
171
- - match: "(\\d{4}-\\d{2}-\\d{2}) 用户要求加回"
172
- replace: "$1 加回"
173
- - match: "(\\d{4}-\\d{2}-\\d{2}) 用户要求:"
174
- replace: "$1:"
175
- - match: "(\\d{4}-\\d{2}-\\d{2}) 用户要求"
176
- replace: "$1"
177
- - match: "(\\d{4}-\\d{2}-\\d{2}) 用户原话:"
178
- replace: "$1:"
179
- - match: "(\\d{4}-\\d{2}-\\d{2}) 用户约定:"
180
- replace: "$1:"
181
- - match: "(\\d{4}-\\d{2}-\\d{2}) 用户确立"
182
- replace: "$1"
183
- - match: "(\\d{4}-\\d{2}-\\d{2}) 用户确认"
184
- replace: "$1"
185
- - match: "(\\d{4}-\\d{2}-\\d{2}) 用户同意"
186
- replace: "$1"
187
- # 3) 措辞 + 「内容」 → 「内容」(引号内容保留)
188
- - match: "用户原话[::]?「"
189
- replace: "「"
190
- - match: "用户原话「"
191
- replace: "「"
192
- # 4) (用户要求…) → (…
193
- - match: "(用户要求[::]?"
194
- replace: "("
195
- - match: "\\(用户要求[::]?"
196
- replace: "("
197
- # 5) 「用户要求恢复此形态」→ 删除
198
- - match: "用户要求恢复此形态"
199
- replace: ""
200
- # 6) 孤立措辞 → 删除
201
- - match: "用户要求[::]?"
202
- replace: ""
203
- - match: "用户原话[::]?"
204
- replace: ""
205
- - match: "用户约定[::]?"
206
- replace: ""
207
- - match: "用户规定[::]?"
208
- replace: ""
209
- - match: "用户明确[::]?"
210
- replace: ""
211
- - match: "用户拍板[::]?"
212
- replace: ""
213
- - match: "用户确立[::]?"
214
- replace: ""
215
- - match: "用户确认[::]?"
216
- replace: ""
217
- - match: "用户同意[::]?"
218
- replace: ""
219
- - match: "用户许可[::]?"
220
- replace: ""
221
- - match: "用户说[::]?"
222
- replace: ""
223
- - match: "用户:"
224
- replace: ""
225
-
226
- # ----- 严重级别 -----
227
159
  severity_map:
228
160
  info: "info"
229
161
 
@@ -0,0 +1,82 @@
1
+ # ============================================================
2
+ # C# 代码审计规则集(首版 · 语言专项)
3
+ # 版本:0.1.0
4
+ # 适用:C# 项目(.cs)
5
+ # 描述:本槽位首版规则。选型依据是真实 C# 语料上的**两档计数**(正则初筛命中 / 精筛后命中),
6
+ # 只收「精筛后仍是真命中且形态可静态确认」的项;靠正则数量堆砌的候选一律不收。
7
+ # 未收清单与理由见 docs/2026-10-29-多语言AST接通实测记录.MD「M3-B 收规则与不收清单」。
8
+ # 口径:exts 只认 .cs;astConfirm 走 token 级行列判定(注释/字符串里的同名文本不算代码)。
9
+ # ============================================================
10
+
11
+ metadata:
12
+ name: "C# 审计规则集(首版 · 语言专项)"
13
+ version: "0.1.0"
14
+ language: "csharp"
15
+ author: "DeepSeek"
16
+ description: "C# 项目语言专用规则(首版:throw ex / 抛通用 Exception / 显式 GC.Collect / lock(this|typeof))"
17
+ last_updated: "2026-10-29"
18
+
19
+ rules:
20
+ # ----- 1. 健壮性 -----
21
+
22
+ - id: csharp/throw-ex
23
+ name: "C# 重抛异常不要用 throw ex"
24
+ category: "robustness"
25
+ severity: "warning"
26
+ dimensions: ["健壮性"]
27
+ description: "`throw ex;` 会把异常栈重置到当前行,原始抛出点丢失;应写 `throw;` 保留栈,或包成带 innerException 的新异常"
28
+ # astConfirm + astConfirmSpan:行级 + **列级**双重判定。
29
+ # 只写 astConfirm 时按「行」判,`const string S = "throw ex;";` 这种行仍是代码行 ⇒ 字符串里的文本会被报出来;
30
+ # 加 astConfirmSpan 后按命中列判(有语法树时用 c_sharp 树,无树时回退 token 列级),才算真排除。
31
+ astConfirm: true
32
+ astConfirmSpan: true
33
+ patterns:
34
+ - "\\bthrow\\s+[A-Za-z_]\\w*\\s*;"
35
+ exts: ["cs"]
36
+ exclude_paths:
37
+ - "test/"
38
+ - "tests/"
39
+ - "examples/"
40
+ - "example/"
41
+ fixable: false
42
+
43
+ - id: csharp/generic-exception
44
+ name: "C# 不要抛通用 Exception"
45
+ category: "robustness"
46
+ severity: "warning"
47
+ dimensions: ["健壮性"]
48
+ description: "抛 `System.Exception` 让调用方无法按类型区分处置,且容易与框架异常混淆;应抛具体异常类型(ArgumentException/InvalidOperationException 或自定义异常)"
49
+ # 只匹配直接 new 通用 Exception 的形态:new ArgumentException(...) 等子类不在命中范围
50
+ # astConfirmSpan:同 throw-ex,字符串/注释里的示例文本按列级排除
51
+ astConfirm: true
52
+ astConfirmSpan: true
53
+ patterns:
54
+ - "throw\\s+new\\s+(?:System\\s*\\.\\s*)?Exception\\s*\\("
55
+ exts: ["cs"]
56
+ exclude_paths:
57
+ - "test/"
58
+ - "tests/"
59
+ - "examples/"
60
+ - "example/"
61
+ fixable: false
62
+
63
+ # ----- 3. 并发安全 -----
64
+
65
+ - id: csharp/lock-on-self-or-type
66
+ name: "C# 不要在 this / typeof(T) 上加锁"
67
+ category: "robustness"
68
+ severity: "warning"
69
+ dimensions: ["健壮性"]
70
+ description: "锁 this 或 typeof(T) 会和外部代码共享同一把锁(外部也能锁同一个对象/类型),易造成死锁与不可控争用;应使用私有 readonly 锁对象"
71
+ astConfirm: true
72
+ astConfirmSpan: true
73
+ patterns:
74
+ - "lock\\s*\\(\\s*this\\s*\\)"
75
+ - "lock\\s*\\(\\s*typeof\\s*\\("
76
+ exts: ["cs"]
77
+ exclude_paths:
78
+ - "test/"
79
+ - "tests/"
80
+ - "examples/"
81
+ - "example/"
82
+ fixable: false
@@ -31,7 +31,7 @@ decisions:
31
31
  reason: "现有 docs/(复数)已建立索引习惯,改名纯成本;新增目录一律单数,存量 docs/ 作为历史约定保留"
32
32
  - item: "script/ config/ dist/ log/"
33
33
  keep: false
34
- reason: "无构建步骤(源码即产物);配置走 settings 机制 + lib/ 内 yml 规则数据(audit-rules/ readme-templates/ 同源部署,不抽顶层)"
34
+ reason: "无构建步骤(源码即产物);配置走 settings 机制 + lib/ 内 yml 规则数据(audit-rules/ 同源部署,不抽顶层)"
35
35
  - item: "skills/"
36
36
  keep: true
37
37
  reason: "DSH 插件特性:注入给 AI 的手册(dsh-git-push.md / dsh-git-push-functions.md / git-workflow-gitpush/),通用规范未覆盖"
@@ -46,7 +46,7 @@ principles:
46
46
  - "一致性优先于花哨:同类文件放同目录,同目录命名风格统一"
47
47
  - "统一单数:所有功能目录用单数(tool/、test/、doc/、lib/),不用复数(tools/、tests/、docs/、libs/)"
48
48
  - "工具与源码同库:cli.mjs 根级 + lib/plugin-tools.js 注册 agent 工具,不建空 tool/ 目录"
49
- - "规则数据随代码:audit-rules/*.yml、readme-templates/*.yml 放 lib/ 子目录(files 白名单 + 相对路径解析依赖)"
49
+ - "规则数据随代码:audit-rules/*.yml 放 lib/ 子目录(files 白名单 + 相对路径解析依赖)"
50
50
  - "最小可用:不预设未来需求,目录按需添加"
51
51
 
52
52
  # ============================================================
@@ -86,7 +86,6 @@ directory_roles:
86
86
  - "audit.js - 审计引擎(L0 静态 + 规则执行)"
87
87
  - "rule-packs.js - YAML 规则装载/编译"
88
88
  - "audit-rules/ - 规则数据(nodejs/frontend/comment/dsh/npm/version/template/private/structure)"
89
- - "readme-templates/ - README 模板 yml"
90
89
  - "plugin-*.js - 装配层(host 等价:工具注册/HTTP/设置/审计服务接线)"
91
90
  - "client.js viewer.js- 客户端 UI(DSH 命名空间内)"
92
91
  dependencies: "模块间单向依赖、无环(拆分时保证);装配层依赖业务模块,业务模块不依赖装配层"
package/lib/git/push.js CHANGED
@@ -426,7 +426,7 @@ export function readmeCheckHint(repoPath) {
426
426
  const hasReadme = ['README.md', 'readme.md', 'README', 'readme'].some((n) => existsSync(join(repoPath, n)));
427
427
  return hasReadme
428
428
  ? { needed: true, hasReadme: true, hint: '提交前核对 README:功能表/版本记录/用法与本次改动一致,过时先改 README 再提交' }
429
- : { needed: true, hasReadme: false, hint: '仓库无 README,提交前先补(可用脚本 `node scripts/readme-gen.mjs <repo> [--write README.md]` 生成,或按 docs/ 文档模板写)' };
429
+ : { needed: true, hasReadme: false, hint: '仓库无 README,提交前先补(按 README 使用手册规范手工撰写)' };
430
430
  }
431
431
 
432
432
  /**
@@ -9,7 +9,11 @@ import { readFileSync, readdirSync, existsSync, writeFileSync } from 'node:fs';
9
9
  import { normalizeScopeRules } from './scope.js';
10
10
  import { join, dirname } from 'node:path';
11
11
  import { fileURLToPath } from 'node:url';
12
- import { load as yamlLoad } from '../vendor/js-yaml/js-yaml.mjs';
12
+ // js-yaml 走 npm 依赖(仓库内不保存副本)。
13
+ // 这里**故意用静态 import**:规则加载是启动关键路径,依赖没装上就应当在模块加载期
14
+ // 抛 ERR_MODULE_NOT_FOUND(错误里带包名,够响亮),而不是被 try/catch 吞成「0 条规则」
15
+ // 继续跑——静默无规则比启动失败更危险(口径见 docs/2026-10-28-弃零依赖引入npm与AST优先规则方案.MD D5)。
16
+ import { load as yamlLoad } from 'js-yaml';
13
17
 
14
18
  const __dirname = dirname(fileURLToPath(import.meta.url));
15
19
  export const RULE_YAML_DIR = join(__dirname, '..', 'audit-rules');
package/lib/self/index.js CHANGED
@@ -9,7 +9,7 @@
9
9
  */
10
10
 
11
11
 
12
- export const VERSION = '2.10.5'; // 2.10.5:隐私/凭据类规则只对自有仓库生效(他人仓库等同关闭):克隆的第三方仓库里第三方 LICENSE/ReadMe 的作者邮箱不再成片报 blocker(实测某 Unity 项目 3 条 blocker 全由此而来);判不出归属时照旧生效(保守)。归属探测放装配层 lib/app/repo-ownership.js(依赖 git 层),审计层 lib/audit/ownership.js 只留纯函数并消费注入的归属字符串,守住『lib/audit 不依赖 lib/git』边界;CLI 与插件工具同参注入,保证两边结果一致。新增 scripts/bump-version.mjs:一键升版(默认 dry-run、--apply 才写盘),把散在三处的版本号收口,并自动重生成派生文档。另含 2.10.4 的 CIFS 克隆修复。。历史:2.10.4:修掉「克隆到 CIFS/SMB 挂载失败」——根因是 git init 要把 core.filemode 写进 .git/config,而写 config 走 config.lock→chmod→rename,挂载带 nounix 时 chmod 恒 EPERM ⇒ git 直接 fatal(留下未初始化的空 .git,整体克隆失败)。新增 lib/git/init-compat.js:真去 chmod 一个临时文件探测能力,不支持时手工搭最小 .git 结构(HEAD + config[filemode=false] + 空 objects/refs/info;remote 段一并手写,因 git remote add 同样要写 config),绕开 git 的 config 写入流程;实测降级后 add/commit/log/status/remote 全部正常。三处 init 调用点(clone.js / clone-history-mode.js / clone-replay-io.js)统一走该兼容层,deps 可注入 chmodOk 便于测试。新增 test/test-init-compat.mjs(6 例,含「降级结构必须是真仓库」与自证)。实测:katboi01/UmaViewer(157MB)经插件成功克隆到 CIFS 挂载,HEAD 与远端一致、脏文件 0。。2.10.3:忽略链路端到端回归。
12
+ export const VERSION = '2.12.3'; // 2.12.3:M4 移除 vendored 包袱:删除 assets/tree-sitter(3.7MB,含 runtime js+wasm 与 3 个语法)与 lib/vendor/js-yaml(108KB),运行时统一走 npm 依赖;配套删掉已成死代码的迁移期兜底、把「vendored 运行时已落库」断言改为「npm 包可解析且版本锁定 0.25.10」、订正三处指向已删路径的注释与 .auditignore 条目。发布体积 1.4MB/6.5MB/291 → 911.4kB/2.6MB/281。。历史:2.12.2:M3:新建 audit-rules-csharp.yml,按实证口径收 3 条 C# 规则(throw-ex 4/4、generic-exception 38→37、lock-on-self-or-type 2/2,全走 astConfirm+astConfirmSpan 列级精筛);评估后不收 11 项并记入文档(含第一版误收又撤回的 GC.Collect)。语料 findings 453→496、blocker 不变。另修文档计数口径:澄清 168 条为声明数、默认实际加载 164 条(i18n 槽位 disabled、template 槽位需显式开启)。。。2.12.1:修 C# 插值串被当硬编码文本(M3 前置阻塞):tokenizer 识别 $\"…\" / $@\"…\" / @$\"…\" 为插值串、产出 tmpl(与 JS 模板串同口径),洞内按花括号深度判定并跳过嵌套字符串,避免在洞内引号处截断;@\"…\"(verbatim 不插值)仍为 str 照常统计。实测 C# 语料 no-repeated-hardcoded-literals 41→31(少掉的 10 条全是插值表达式,如 {musicId}.csv、<error: {ex.Message}>),4 条纯字面量真命中(Change Joint Limits / Open File / Position Weight / Mouse X)仍报;本仓库自身审计 889 条与改前完全一致(JS 侧零回归)。新增 test-repeated-strings-cs.mjs(5 例,回退 tokenizer 即 3 红)。。
13
13
  // 实测后果:该目录有 package.json ⇒ npm 去打包整棵 DSH 树、输出 2.1MB > spawnSync 默认 maxBuffer 1MB ⇒ ENOBUFS(npm_publish 的体检与真发全部失败);
14
14
  // 该目录没有 package.json 时报 ENOENT。现 publish 的两个调用点显式传 cwd=目标包目录,并给 runNpm 加 16MB maxBuffer。
15
15
  // 2.8.3:文案修正——「零改动 / 无新提交」明确为**正常成功路径**(注入用法、工具描述、README、skill 同批改),并修 job 输出自相矛盾(cleanSkipCommit 路径补 committed:false,不再显示「已提交,未推送」)
package/lib/skip-dirs.js CHANGED
@@ -10,13 +10,16 @@
10
10
  * 白名单(gitignore negation)不受影响:collector walk 对「被忽略目录」按前缀跳过,
11
11
  * 但 gitignore 白名单恢复的目录仍会进入(黑名单初筛 + 白名单补充)。
12
12
  *
13
- * 消费方:lib/audit/collector.js(审计文件收集)、lib/git/sensitive.js(敏感扫描)、
14
- * scripts/scrub-user-wording.mjs(沟通措辞清洗)。
13
+ * 消费方:lib/audit/collector.js(审计文件收集)、lib/git/sensitive.js(敏感扫描)。
15
14
  */
16
15
  import { existsSync, readFileSync, readdirSync } from 'node:fs';
17
16
  import { join, dirname } from 'node:path';
18
17
  import { fileURLToPath } from 'node:url';
19
- import { load as yamlLoad } from './vendor/js-yaml/js-yaml.mjs';
18
+ // js-yaml 走 npm 依赖(仓库内不保存副本)。
19
+ // 这里**故意用静态 import**:规则加载是启动关键路径,依赖没装上就应当在模块加载期
20
+ // 抛 ERR_MODULE_NOT_FOUND(错误里带包名,够响亮),而不是被 try/catch 吞成「0 条规则」
21
+ // 继续跑——静默无规则比启动失败更危险(口径见 docs/2026-10-28-弃零依赖引入npm与AST优先规则方案.MD D5)。
22
+ import { load as yamlLoad } from 'js-yaml';
20
23
 
21
24
  /** 硬编码基线:只许这两个(勿改)。 */
22
25
  export const SKIP_DIRS = new Set(['node_modules', '.git']);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-git-push",
3
- "version": "2.10.5",
3
+ "version": "2.12.3",
4
4
  "description": "DSH git 自动提交推送插件——统一函数入口架构(规则/审计/git/自身/侧边栏/评分/豁免/上下文/HTTP/测试十大总入口)",
5
5
  "type": "module",
6
6
  "main": "lib/index.js",
@@ -92,5 +92,10 @@
92
92
  "check": "node scripts/check.mjs",
93
93
  "scan-version": "node scripts/scan-version.mjs",
94
94
  "check:drift": "node scripts/doc-drift.mjs"
95
+ },
96
+ "dependencies": {
97
+ "js-yaml": "4.1.0",
98
+ "tree-sitter-wasms": "0.1.13",
99
+ "web-tree-sitter": "0.25.10"
95
100
  }
96
101
  }
@@ -300,8 +300,10 @@ function applyBlock(text, newTree) {
300
300
 
301
301
  /* ───────────────────────── check:漂移对比 ───────────────────────── */
302
302
 
303
- export function checkDrift({ readmePath = DEFAULT_README, root = ROOT } = {}) {
304
- const text = readReadme(readmePath);
303
+ export function checkDrift({ readmePath = '', root = ROOT } = {}) {
304
+ // 树宿主可迁移(README 拆出后落到 docs/ 下带标记块的 md)⇒ 与 apply 同用 resolveTargetMd
305
+ // 自动探测,而不是写死 README。显式传 readmePath 时行为不变。
306
+ const text = readReadme(resolveTargetMd(root, readmePath));
305
307
  const block = findBlock(text);
306
308
  const real = buildTreeText(gitLsFiles(root), loadMapping(root), basename(root));
307
309
  const map = loadMapping(root);