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/lib/ast/tokenizer.js
CHANGED
|
@@ -43,7 +43,7 @@ let TOKEN_CACHE_BYTES = 0;
|
|
|
43
43
|
* 返回的是**共享数组**——调用方只读,禁止原地修改(push/splice/sort)。
|
|
44
44
|
*
|
|
45
45
|
* @param {string} text 文件全文
|
|
46
|
-
* @returns {Array<{type:string, value:string, line:number}>}
|
|
46
|
+
* @returns {Array<{type:string, value:string, line:number, col:number}>}
|
|
47
47
|
* type: ident / punct / str / tmpl / comment / num / ws / other
|
|
48
48
|
*/
|
|
49
49
|
export function tokenize(text = '') {
|
|
@@ -103,7 +103,12 @@ function tokenizeUncached(text = '') {
|
|
|
103
103
|
const src = raw;
|
|
104
104
|
let i = 0;
|
|
105
105
|
const n = src.length;
|
|
106
|
-
|
|
106
|
+
// col = token 起始列(1-based,行内)。用途:**列级精筛** —— 行级判定只能回答
|
|
107
|
+
// 「这一行有没有代码」,回答不了「正则命中的那一处是不是落在字符串/注释里」
|
|
108
|
+
// (实测遗留误报:`{ script: 'while (true) {}' }` 里的 while(true) 被当真实死循环)。
|
|
109
|
+
// ⚠️ 跨行 token(三引号 / 多行块注释)的 col 是**续行内位置**、不是 token 真实起点 ⇒
|
|
110
|
+
// 消费方必须跳过 value 含换行的 token(见 lib/ast/code-lines.js 的区间构造)。
|
|
111
|
+
const push = (type, value) => tokens.push({ type, value, line, col: i + 1 });
|
|
107
112
|
while (i < n) {
|
|
108
113
|
const ch = src[i];
|
|
109
114
|
const next = src[i + 1];
|
|
@@ -0,0 +1,208 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AST 实现层 · tree-sitter(真语法树 · WASM)
|
|
3
|
+
*
|
|
4
|
+
* 定位:**可选增强,绝不是必需依赖**。任何一步失败(资产缺失 / wasm 加载失败 / 无对应语法 /
|
|
5
|
+
* 解析出语法错误 / 超出预算)都返回「未使用」信号,由调用方**回退**到
|
|
6
|
+
* lib/ast/code-lines.js 的 token 级判定(行级 + 列级,2.8.9 已落地)。
|
|
7
|
+
*
|
|
8
|
+
* 为什么这么设计:审计是提交门禁的一部分,**不能因为增强件坏了就整体失效** ✗。
|
|
9
|
+
* 回退不是异常路径,而是常态路径之一 ✓。
|
|
10
|
+
*
|
|
11
|
+
* 资产:assets/tree-sitter/(web-tree-sitter@0.27.1 + 各语言预编译 grammar;MIT)
|
|
12
|
+
* 来源、版本、sha256、可复现下载命令见该目录 README.md ✓
|
|
13
|
+
*
|
|
14
|
+
* 语言口径(既定口径):**加载哪些语言 = lib/audit-rules/ 里存在哪些语言规则包**
|
|
15
|
+
* (**空占位包也算**:cpp/go/php/rust/swift)。语法文件不存在时该语言自动走回退 ✓。
|
|
16
|
+
*/
|
|
17
|
+
import { existsSync, readdirSync, readFileSync } from 'node:fs';
|
|
18
|
+
import { createHash } from 'node:crypto';
|
|
19
|
+
import { fileURLToPath, pathToFileURL } from 'node:url';
|
|
20
|
+
import { dirname, join } from 'node:path';
|
|
21
|
+
|
|
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');
|
|
27
|
+
|
|
28
|
+
/** 扩展名 → 语法名(grammar)。没有映射的扩展名一律走回退 ✓。 */
|
|
29
|
+
export const EXT_TO_GRAMMAR = {
|
|
30
|
+
js: 'javascript', mjs: 'javascript', cjs: 'javascript', jsx: 'javascript',
|
|
31
|
+
ts: 'typescript', tsx: 'typescript', mts: 'typescript', cts: 'typescript',
|
|
32
|
+
py: 'python',
|
|
33
|
+
};
|
|
34
|
+
|
|
35
|
+
/** 单文件解析预算(字符数):超此长度不解析,直接回退(避免大文件拖慢审计)。 */
|
|
36
|
+
const MAX_PARSE_CHARS = Number(process.env.DSH_GIT_PUSH_TS_MAX_CHARS || 400000) || 400000;
|
|
37
|
+
/** 语法树缓存条数上限(按内容 hash 命中)。 */
|
|
38
|
+
const TREE_CACHE_MAX = Number(process.env.DSH_GIT_PUSH_TS_TREE_CACHE || 64) || 64;
|
|
39
|
+
|
|
40
|
+
/** 惰性状态(模块级):web-tree-sitter 模块 / 初始化 Promise / 语言与解析器缓存。 */
|
|
41
|
+
let modPromise = null;
|
|
42
|
+
let initPromise = null;
|
|
43
|
+
const langCache = new Map();
|
|
44
|
+
const parserCache = new Map();
|
|
45
|
+
const treeCache = new Map(); // hash → tree(简单 FIFO 淘汰)
|
|
46
|
+
|
|
47
|
+
/** 资产是否就位(供调用方与自检使用)。 */
|
|
48
|
+
export function treesitterAvailable() {
|
|
49
|
+
try {
|
|
50
|
+
return existsSync(join(ASSETS_DIR, 'tree-sitter.js')) && existsSync(join(ASSETS_DIR, 'tree-sitter.wasm'));
|
|
51
|
+
} catch { return false; }
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/** 当前资产里实际可用的语法名列表(按目录里存在的 wasm 推断)。 */
|
|
55
|
+
export function availableGrammars() {
|
|
56
|
+
try {
|
|
57
|
+
return readdirSync(ASSETS_DIR)
|
|
58
|
+
.map((f) => /^tree-sitter-(.+)\.wasm$/.exec(f))
|
|
59
|
+
.filter(Boolean)
|
|
60
|
+
.map((m) => m[1])
|
|
61
|
+
.sort();
|
|
62
|
+
} catch { return []; }
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/** 由扩展名(可带点)取语法名;无映射返回 ''。 */
|
|
66
|
+
export function grammarForExt(ext = '') {
|
|
67
|
+
const e = String(ext).toLowerCase().replace(/^\./, '');
|
|
68
|
+
return EXT_TO_GRAMMAR[e] || '';
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/** 懒加载 web-tree-sitter 运行时(ESM 具名导出:Parser / Language / Query)。
|
|
72
|
+
* 文件名用上游原名:0.25.10 是 `tree-sitter.js` / `tree-sitter.wasm`(0.27.x 才是 web-tree-sitter.* ✗ 且与
|
|
73
|
+
* tree-sitter-wasms@0.1.13 的语法不兼容 —— 实测 0.27.1 在 getDylinkMetadata 处报空消息错误 ✗)。 */
|
|
74
|
+
async function loadModule() {
|
|
75
|
+
if (!modPromise) {
|
|
76
|
+
modPromise = import(pathToFileURL(join(ASSETS_DIR, 'tree-sitter.js')).href);
|
|
77
|
+
}
|
|
78
|
+
return modPromise;
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
/** 初始化一次(定位运行时 wasm)。失败返回 null(调用方回退)。 */
|
|
82
|
+
async function ensureInit() {
|
|
83
|
+
if (!initPromise) {
|
|
84
|
+
initPromise = (async () => {
|
|
85
|
+
const { Parser } = await loadModule();
|
|
86
|
+
// locateFile:告诉运行时去哪里取 web-tree-sitter.wasm(默认会按 URL 猜,容器里不可靠)
|
|
87
|
+
await Parser.init({ locateFile: (f) => join(ASSETS_DIR, f) });
|
|
88
|
+
return true;
|
|
89
|
+
})().catch(() => null);
|
|
90
|
+
}
|
|
91
|
+
return initPromise;
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
/** 取(并缓存)某语言的 Parser;不可用返回 null。 */
|
|
95
|
+
async function getParser(grammar) {
|
|
96
|
+
if (!grammar || !existsSync(join(ASSETS_DIR, `tree-sitter-${grammar}.wasm`))) return null;
|
|
97
|
+
if (parserCache.has(grammar)) return parserCache.get(grammar);
|
|
98
|
+
try {
|
|
99
|
+
if (!(await ensureInit())) return null;
|
|
100
|
+
const { Parser, Language } = await loadModule();
|
|
101
|
+
let lang = langCache.get(grammar);
|
|
102
|
+
if (!lang) {
|
|
103
|
+
// 传**字节**而不是路径:0.27.x 的 load(路径) 会静默失败(Node 分支虽会 readFile,但 dylink 不兼容);
|
|
104
|
+
// 字节是唯一被实测验证可用的入口(0.25.10 ✓)
|
|
105
|
+
lang = await Language.load(readFileSync(join(ASSETS_DIR, `tree-sitter-${grammar}.wasm`)));
|
|
106
|
+
langCache.set(grammar, lang);
|
|
107
|
+
}
|
|
108
|
+
const parser = new Parser();
|
|
109
|
+
parser.setLanguage(lang);
|
|
110
|
+
parserCache.set(grammar, parser);
|
|
111
|
+
return parser;
|
|
112
|
+
} catch {
|
|
113
|
+
return null; // 任何异常都退化为「不可用」⇒ 调用方回退 ✓
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
/** 解析文本(按内容 hash 缓存语法树);失败返回 null。 */
|
|
118
|
+
export async function parseText(text, grammar) {
|
|
119
|
+
const src = String(text ?? '');
|
|
120
|
+
if (!grammar || src.length > MAX_PARSE_CHARS) return null;
|
|
121
|
+
const hash = `${grammar}:${createHash('sha1').update(src).digest('hex')}`;
|
|
122
|
+
if (treeCache.has(hash)) return treeCache.get(hash);
|
|
123
|
+
const parser = await getParser(grammar);
|
|
124
|
+
if (!parser) return null;
|
|
125
|
+
try {
|
|
126
|
+
const tree = parser.parse(src);
|
|
127
|
+
if (!tree || !tree.rootNode || tree.rootNode.hasError) return null; // 语法错误 ⇒ 不信任该树,回退 ✓
|
|
128
|
+
treeCache.set(hash, tree);
|
|
129
|
+
while (treeCache.size > TREE_CACHE_MAX) treeCache.delete(treeCache.keys().next().value);
|
|
130
|
+
return tree;
|
|
131
|
+
} catch {
|
|
132
|
+
return null;
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
/** 节点或其祖先是否属于「不透明」构造(字符串/注释/模板/正则字面量)。 */
|
|
137
|
+
export function isOpaqueNode(node) {
|
|
138
|
+
for (let n = node; n; n = n.parent) {
|
|
139
|
+
const t = String(n.type || '');
|
|
140
|
+
if (/^(string|string_fragment|template_string|comment|line_comment|block_comment|regex|regex_pattern|interpreted_string_literal|raw_string_literal)$/.test(t)) return true;
|
|
141
|
+
if (/comment|string/.test(t)) return true; // 各语言命名差异的兜底
|
|
142
|
+
}
|
|
143
|
+
return false;
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
/**
|
|
147
|
+
* 用语法树确认一批命中是否为**真实代码**。
|
|
148
|
+
*
|
|
149
|
+
* @param {{text:string, ext?:string, grammar?:string, hits:Array<{line:number, col:number}>}} p
|
|
150
|
+
* @returns {Promise<{used:boolean, keep:boolean[], reason?:string}>}
|
|
151
|
+
* used=false ⇒ **调用方必须回退**到 token 级判定(keep 无意义);
|
|
152
|
+
* used=true ⇒ keep[i] 表示第 i 个命中是否为真代码(true=保留上报)。
|
|
153
|
+
*/
|
|
154
|
+
export async function confirmHits({ text, ext = '', grammar = '', hits = [] } = {}) {
|
|
155
|
+
const g = grammar || grammarForExt(ext);
|
|
156
|
+
if (!g || !hits.length) return { used: false, keep: [], reason: 'no-grammar-or-hits' };
|
|
157
|
+
const tree = await parseText(text, g);
|
|
158
|
+
if (!tree) return { used: false, keep: [], reason: 'parse-unavailable' };
|
|
159
|
+
try {
|
|
160
|
+
const keep = hits.map((h) => {
|
|
161
|
+
const line = Number(h?.line);
|
|
162
|
+
const col = Number(h?.col);
|
|
163
|
+
if (!Number.isFinite(line) || line < 1) return true; // 拿不到位置 ⇒ 不拦(宁可放行不误杀)
|
|
164
|
+
const column = Number.isFinite(col) && col > 0 ? col - 1 : 0;
|
|
165
|
+
const node = tree.rootNode.descendantForPosition({ row: line - 1, column });
|
|
166
|
+
if (!node) return true;
|
|
167
|
+
return !isOpaqueNode(node);
|
|
168
|
+
});
|
|
169
|
+
return { used: true, keep };
|
|
170
|
+
} catch {
|
|
171
|
+
return { used: false, keep: [], reason: 'confirm-failed' };
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
/**
|
|
176
|
+
* 把已解析的语法树包成**同步**确认函数(供同步的检查器 lib/checks/* 调用)。
|
|
177
|
+
*
|
|
178
|
+
* 为什么需要:检查器是同步的,而解析是异步的 —— 由编排层(async)**预解析**后,
|
|
179
|
+
* 把同步闭包传下去,避免把整条检查链改成 async ✗。
|
|
180
|
+
*
|
|
181
|
+
* @param {object|null} tree parseText 的返回值
|
|
182
|
+
* @returns {null|((line:number, col:number)=>boolean|null)} 返回 null 表示「无法判定」,
|
|
183
|
+
* 调用方应回退到 token 级判定(行级 + 列级)✓
|
|
184
|
+
*/
|
|
185
|
+
export function makeSyncConfirmer(tree) {
|
|
186
|
+
if (!tree || !tree.rootNode) return null;
|
|
187
|
+
return (line, col) => {
|
|
188
|
+
try {
|
|
189
|
+
const l = Number(line);
|
|
190
|
+
if (!Number.isFinite(l) || l < 1) return null;
|
|
191
|
+
const c = Number(col);
|
|
192
|
+
const column = Number.isFinite(c) && c > 0 ? c - 1 : 0;
|
|
193
|
+
const node = tree.rootNode.descendantForPosition({ row: l - 1, column });
|
|
194
|
+
if (!node) return null;
|
|
195
|
+
return !isOpaqueNode(node);
|
|
196
|
+
} catch {
|
|
197
|
+
return null;
|
|
198
|
+
}
|
|
199
|
+
};
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
/** 清空全部缓存(测试与长驻进程内存回收用)。 */
|
|
203
|
+
export function resetTreeSitterCache() { modPromise = null;
|
|
204
|
+
initPromise = null;
|
|
205
|
+
langCache.clear();
|
|
206
|
+
parserCache.clear();
|
|
207
|
+
treeCache.clear();
|
|
208
|
+
}
|
package/lib/audit/audit-file.js
CHANGED
|
@@ -119,7 +119,7 @@ export function auditFile({ file, relPath, text, grouped }, opts = {}) {
|
|
|
119
119
|
&& !/no-empty-catch/.test(String(r?.id || '')));
|
|
120
120
|
if (keep.length) scoped[kind] = keep;
|
|
121
121
|
}
|
|
122
|
-
let findings = runChecks({ file, relPath, text, grouped: scoped }, { level: opts?.level, repoHasJsYamlImport: opts?.repoHasJsYamlImport, repoLevelRules: opts?.repoLevelRules, repoPath: opts?.repoPath });
|
|
122
|
+
let findings = runChecks({ file, relPath, text, grouped: scoped }, { level: opts?.level, repoHasJsYamlImport: opts?.repoHasJsYamlImport, repoLevelRules: opts?.repoLevelRules, repoPath: opts?.repoPath, treeConfirm: opts?.treeConfirm });
|
|
123
123
|
// 产物超长是属性非问题;内置行级检查(quality/empty-catch 等)与残余行级规则也屏蔽——
|
|
124
124
|
// 混淆单行 10万+ 字符上 catch{} 等模式天然密集,非真实缺陷。
|
|
125
125
|
const keepRule = /^secret-|^cred|security\/no-hardcoded-credentials|security\/no-path-traversal/; // 构建/混淆产物:健康度(行长/大小)是产物属性非问题,只留凭据/路径安全
|
|
@@ -132,7 +132,7 @@ export function auditFile({ file, relPath, text, grouped }, opts = {}) {
|
|
|
132
132
|
const isTestFile = /(^|[/\\])(test|tests|__tests__|spec)[/\\]|\.(test|spec)\.(js|mjs|cjs|ts)$/i.test(String(relPath || file));
|
|
133
133
|
const maintainabilityScoped = !isCode || isTestFile;
|
|
134
134
|
const scopedGrouped = maintainabilityScoped ? { ...grouped, 'repeated-string': undefined, 'min-occurrences': undefined } : grouped;
|
|
135
|
-
let findings = runChecks({ file, relPath, text, grouped: scopedGrouped }, { level: opts?.level, repoHasJsYamlImport: opts?.repoHasJsYamlImport, repoLevelRules: opts?.repoLevelRules, repoPath: opts?.repoPath });
|
|
135
|
+
let findings = runChecks({ file, relPath, text, grouped: scopedGrouped }, { level: opts?.level, repoHasJsYamlImport: opts?.repoHasJsYamlImport, repoLevelRules: opts?.repoLevelRules, repoPath: opts?.repoPath, treeConfirm: opts?.treeConfirm });
|
|
136
136
|
const isRuleDefFile = /(^|[/\\])audit-rules-[a-z0-9-]+\.ya?ml$/i.test(String(relPath || file));
|
|
137
137
|
const fileLines = String(text || '').split('\n');
|
|
138
138
|
// 语义级豁免:纯 regex 规则看不到的上下文在此兜底——
|
|
@@ -145,7 +145,7 @@ export function auditFile({ file, relPath, text, grouped }, opts = {}) {
|
|
|
145
145
|
// 规则定义文件:规则驱动命中(secret/regex/path-regex/func-lines 等 yml 规则)全豁免
|
|
146
146
|
if (isRuleDefFile && f.rule !== 'quality/empty-catch' && f.rule !== 'robustness/io-risk') return false;
|
|
147
147
|
// 技能/规则文档豁免:skills/ 下的 skill 文档与 rules/ 文档里的
|
|
148
|
-
//
|
|
148
|
+
// 文档用语是「触发场景/规则描述」设计文本(如 whenToUse 触发场景描述),非代码残留——comment 规则不拦;
|
|
149
149
|
// version 规则同理:版本规则文档自身描述 0.x 例外(如 versioning-rule §二「内置模块从 0 开始」),
|
|
150
150
|
// 文档里的版本号示例是规则文本而非违规版本标记
|
|
151
151
|
const isSkillDoc = /(^|[/\\])skills([/\\]|$)/.test(String(relPath || file));
|
package/lib/audit/collector.js
CHANGED
|
@@ -20,6 +20,10 @@ const TEXT_EXT = new Set([
|
|
|
20
20
|
'js', 'mjs', 'cjs', 'ts', 'tsx', 'jsx', 'json', 'yml', 'yaml', 'md', 'txt', 'html', 'css',
|
|
21
21
|
'sh', 'py', 'rb', 'go', 'rs', 'java', 'c', 'cpp', 'h', 'hpp', 'xml', 'toml', 'ini', 'cfg',
|
|
22
22
|
'conf', 'env', 'gitignore', 'npmrc', 'properties', 'sql', 'vue', 'svelte',
|
|
23
|
+
// 2026-10-16 补:PHP / Swift / Kotlin——此前只补了占位规则包 yml,**收集白名单没放行** ✗
|
|
24
|
+
// ⇒ 这两个语言的文件从来没进过审计管道,规则写了也永远 0 命中(实测合成样例 0 命中定位到此处)。
|
|
25
|
+
// phtml 是 PHP 模板扩展名(同 PHP 槽位 exts),kt 与 java 槽位共用一个包。
|
|
26
|
+
'php', 'phtml', 'swift', 'kt',
|
|
23
27
|
]);
|
|
24
28
|
/** git 探活 / 忽略清单批量判定 / 单目录判定 的超时(毫秒)。 */
|
|
25
29
|
const GIT_PROBE_TIMEOUT_MS = 10_000;
|
package/lib/audit/orchestrate.js
CHANGED
|
@@ -3,10 +3,11 @@ import { execFileSync } from 'node:child_process';
|
|
|
3
3
|
import { join, relative } from 'node:path';
|
|
4
4
|
import { collectTextFiles, readText, isGitRepo, collectChangedFiles, isTextFile } from './collector.js';
|
|
5
5
|
import { computeAnalysisCoverage } from './analysis-coverage.js';
|
|
6
|
-
import { groupByKind, HINT_QUALITY, checkFolderRules, checkPrivateFiles, checkDuplicateCode, checkDuplicateConst } from './checks.js';
|
|
6
|
+
import { groupByKind, HINT_QUALITY, checkFolderRules, checkPrivateFiles, checkDuplicateCode, checkDuplicateConst, checkMultiFileScanners } from './checks.js';
|
|
7
7
|
import { loadRuleFiles } from '../rule/loader.js';
|
|
8
8
|
import { compileAllRules } from '../rule/registry.js';
|
|
9
9
|
import { auditFile } from './audit-file.js';
|
|
10
|
+
import { grammarForExt, parseText, makeSyncConfirmer } from '../ast/treesitter.js';
|
|
10
11
|
import { detectRepoJsYamlImport } from './file-context.js';
|
|
11
12
|
import { decorateTestExemptHint, makeFinding, summarize } from './finding.js';
|
|
12
13
|
import { pickRepoLevelAnchorFile, repoLevelSemanticRuleIds } from './repo-level.js';
|
|
@@ -105,6 +106,39 @@ function appendIgnoreBlindSpot(findings, repoPath, scanned) {
|
|
|
105
106
|
* @param {Array<{path?:string, rel?:string, full:string, status?:string}>} files 待审计文件(path 优先,rel 兜底)
|
|
106
107
|
* @param {object} opts { scope, compiled, slots, rulesetDir, disabledSlots, auditLevel, privateFiles, visibility, truncated }
|
|
107
108
|
*/
|
|
109
|
+
/**
|
|
110
|
+
* 为单个文件准备 tree-sitter 的**同步**确认函数(编排层是 async,检查器是同步)。
|
|
111
|
+
*
|
|
112
|
+
* 何时才解析(性能纪律,别把所有文件都解析 ✗):
|
|
113
|
+
* ① 该文件扩展名有可用语法(grammarForExt ✓)
|
|
114
|
+
* ② 该文件的规则集里**确实存在**声明 astConfirmSpan 的规则(否则解析纯属浪费 ✓)
|
|
115
|
+
* 任何失败(无语法 / 资产缺失 / 解析出错 / 超预算)都返回 null
|
|
116
|
+
* ⇒ 检查器自动回退 token 级判定(2.8.9 行为)✓ —— 回退是常态路径,不是异常路径 ✓
|
|
117
|
+
*
|
|
118
|
+
* @returns {Promise<null|((line:number, col:number)=>boolean|null)>}
|
|
119
|
+
*/
|
|
120
|
+
async function buildTreeConfirmer(relPath, text, grouped) {
|
|
121
|
+
try {
|
|
122
|
+
// ⚠️ 取**扩展名**(不是整条路径)——grammarForExt 收的是扩展名 ✓
|
|
123
|
+
// 按 basename 的最后一个点取:避免 `docs/.vitepress/theme/index.ts` 这类**带点目录**踩坑 ✗
|
|
124
|
+
// (本项目 lib/checks/filter.js 已因同类写法修过一次 ✓)
|
|
125
|
+
const base = String(relPath || '').split(/[\\/]/).pop();
|
|
126
|
+
const ext = base.includes('.') ? base.slice(base.lastIndexOf('.') + 1) : '';
|
|
127
|
+
const grammar = grammarForExt(ext);
|
|
128
|
+
if (!grammar) return null;
|
|
129
|
+
let need = false;
|
|
130
|
+
for (const rules of Object.values(grouped || {})) {
|
|
131
|
+
if (!Array.isArray(rules)) continue;
|
|
132
|
+
if (rules.some((r) => r?.astConfirmSpan === true)) { need = true; break; }
|
|
133
|
+
}
|
|
134
|
+
if (!need) return null;
|
|
135
|
+
const tree = await parseText(text, grammar);
|
|
136
|
+
return tree ? makeSyncConfirmer(tree) : null;
|
|
137
|
+
} catch {
|
|
138
|
+
return null;
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
|
|
108
142
|
async function auditFiles(repoPath, files, opts = {}) {
|
|
109
143
|
// 归一化:full 收集项用 path,changed 用 rel → 统一取 path
|
|
110
144
|
const normFiles = files.map((f) => ({ path: f.path ?? f.rel, full: f.full, status: f.status }));
|
|
@@ -182,15 +216,21 @@ async function auditFiles(repoPath, files, opts = {}) {
|
|
|
182
216
|
const text = readText(f.full);
|
|
183
217
|
fileTexts.push({ path: f.path, text });
|
|
184
218
|
const skipRepoLevel = repoLevelRules.size > 0 && f.path !== repoLevelAnchor;
|
|
219
|
+
// tree-sitter 预解析(异步):有语法 + 本文件规则集确实要 astConfirmSpan 才解析;
|
|
220
|
+
// 拿不到语法树 ⇒ treeConfirm 为 null ⇒ 检查器回退 token 级判定 ✓
|
|
221
|
+
const treeConfirm = await buildTreeConfirmer(f.path, text, grouped);
|
|
185
222
|
findings.push(...auditFile({ file: f.path, relPath: f.path, text, grouped }, {
|
|
186
223
|
level: opts.auditLevel, repoHasJsYamlImport, repoPath,
|
|
187
224
|
repoLevelRules: skipRepoLevel ? repoLevelRules : null,
|
|
225
|
+
treeConfirm,
|
|
188
226
|
}));
|
|
189
227
|
}
|
|
190
228
|
// 跨文件重复代码检测(maintainability/no-duplicate-code,该抽公共函数)。
|
|
191
229
|
// 放在逐文件循环后:需要全部文件文本才能跨文件聚合「同一结构 ≥3 处」。severity 恒 warning。
|
|
192
230
|
if (grouped['duplicate-code']) {
|
|
193
231
|
findings.push(...checkDuplicateCode(fileTexts, grouped['duplicate-code']));
|
|
232
|
+
// 逐文件扫描实现过多(仓库级,2026-10-16):同一函数里既 readdir 又 stat 的实现 > 阈值 ⇒ notice
|
|
233
|
+
findings.push(...checkMultiFileScanners(fileTexts, grouped['multi-file-scanners']));
|
|
194
234
|
}
|
|
195
235
|
// 跨文件同名常量重复定义检测(maintainability/duplicate-constant-def)——DRY 信号:
|
|
196
236
|
// 同一阈值/长度/窗口常量散落多个模块(MAX_MSG_PREVIEW=80 三处实测),改一处漏多处——
|
|
@@ -1,22 +1,114 @@
|
|
|
1
1
|
# ============================================================
|
|
2
|
-
# C/C++
|
|
3
|
-
# 版本:0.
|
|
2
|
+
# C/C++ 代码审计规则集(首版 · 语言专项)
|
|
3
|
+
# 版本:0.2.0
|
|
4
4
|
# 适用:C / C++ 项目(含单片机/嵌入式)
|
|
5
|
-
#
|
|
6
|
-
#
|
|
7
|
-
#
|
|
8
|
-
#
|
|
9
|
-
# 待办(补规则时):① AST 层 lang.js 的 LANG_FUNC_RANGES.cpp 实现函数范围收集
|
|
10
|
-
# (类型+函数名( 签名 + 花括号配对,排除控制流与调用);② 本槽位按 python/java 先例
|
|
11
|
-
# 写规则,exts: ["c", "cc", "cpp", "cxx", "h", "hpp"](头文件函数声明不计数——只有 .c/.cpp 实现)。
|
|
5
|
+
# 描述:本槽位首版语言专项规则(**纯 pattern 层**,不依赖 AST 函数范围)。
|
|
6
|
+
# 规则依据:对真实 C++ 仓(jarro2783/cxxopts 等样本仓)实测各候选模式的出现次数后选型。
|
|
7
|
+
# (AST 层的 min_length/max_lines/max_complexity/magic-number 仍待补 LANG_FUNC_RANGES.cpp)
|
|
8
|
+
# 口径:exts 覆盖实现与头文件;第三方/构建产物目录排除(生成代码里的 new/strcpy 不该报)。
|
|
12
9
|
# ============================================================
|
|
13
10
|
|
|
14
11
|
metadata:
|
|
15
|
-
name: "C/C++
|
|
16
|
-
version: "0.
|
|
12
|
+
name: "C/C++ 审计规则集(首版 · 语言专项)"
|
|
13
|
+
version: "0.2.0"
|
|
17
14
|
language: "cpp"
|
|
18
15
|
author: "DeepSeek"
|
|
19
|
-
description: "C/C++
|
|
20
|
-
last_updated: "2026-10-
|
|
16
|
+
description: "C/C++ 项目语言专用规则(pattern 层首版:using namespace/裸 new/不安全 C 串函数/malloc-free/catch-all)"
|
|
17
|
+
last_updated: "2026-10-16"
|
|
21
18
|
|
|
22
|
-
rules:
|
|
19
|
+
rules:
|
|
20
|
+
# ----- 1. 可维护性 -----
|
|
21
|
+
|
|
22
|
+
- id: cpp/using-namespace
|
|
23
|
+
name: "C/C++ 头文件里避免 using namespace"
|
|
24
|
+
category: "maintainability"
|
|
25
|
+
severity: "warning"
|
|
26
|
+
description: "using namespace 把整棵命名空间的名字引入作用域,头文件里会污染所有包含者并引发重载歧义;应写限定名或只 using 具体符号"
|
|
27
|
+
patterns:
|
|
28
|
+
- "using\\s+namespace\\s+[A-Za-z_]"
|
|
29
|
+
exts: ["c", "cc", "cpp", "cxx", "h", "hh", "hpp", "hxx"]
|
|
30
|
+
exclude_paths:
|
|
31
|
+
- "test/"
|
|
32
|
+
- "tests/"
|
|
33
|
+
- "third_party/"
|
|
34
|
+
- "vendor/"
|
|
35
|
+
- "external/"
|
|
36
|
+
- "examples/"
|
|
37
|
+
- "example/"
|
|
38
|
+
fixable: false
|
|
39
|
+
|
|
40
|
+
- id: cpp/raw-new
|
|
41
|
+
name: "C++ 用智能指针替代裸 new"
|
|
42
|
+
category: "maintainability"
|
|
43
|
+
severity: "warning"
|
|
44
|
+
description: "裸 new 的所有权不表达在类型里,异常/提前 return 都会泄漏;应直接用 make_unique/make_shared 或容器"
|
|
45
|
+
# 负向环视排除 `new[]`、`operator new`、`->new` 以及注释里的普通词
|
|
46
|
+
# astConfirm:行级代码判定——实测 cxxopts 命中过注释里的 "start a new line" ✗(`new ` + 普通词)
|
|
47
|
+
astConfirm: true
|
|
48
|
+
patterns:
|
|
49
|
+
- "(?<![\\w.>:])new\\s+[A-Za-z_:]"
|
|
50
|
+
exts: ["c", "cc", "cpp", "cxx", "h", "hh", "hpp", "hxx"]
|
|
51
|
+
exclude_paths:
|
|
52
|
+
- "test/"
|
|
53
|
+
- "tests/"
|
|
54
|
+
- "third_party/"
|
|
55
|
+
- "vendor/"
|
|
56
|
+
- "external/"
|
|
57
|
+
- "examples/"
|
|
58
|
+
- "example/"
|
|
59
|
+
fixable: false
|
|
60
|
+
|
|
61
|
+
# ----- 2. 安全 -----
|
|
62
|
+
|
|
63
|
+
- id: cpp/unsafe-c-string
|
|
64
|
+
name: "C/C++ 避免不检查边界的 C 串函数"
|
|
65
|
+
category: "security"
|
|
66
|
+
severity: "error"
|
|
67
|
+
description: "strcpy/strcat/sprintf/gets 不做边界检查,是栈溢出的经典来源;应用 snprintf/std::string/strncpy_s 等有界替代"
|
|
68
|
+
patterns:
|
|
69
|
+
- "(?<![\\w.>])(?:strcpy|strcat|sprintf|gets|scanf)\\s*\\("
|
|
70
|
+
exts: ["c", "cc", "cpp", "cxx", "h", "hh", "hpp", "hxx"]
|
|
71
|
+
exclude_paths:
|
|
72
|
+
- "test/"
|
|
73
|
+
- "tests/"
|
|
74
|
+
- "third_party/"
|
|
75
|
+
- "vendor/"
|
|
76
|
+
- "examples/"
|
|
77
|
+
- "example/"
|
|
78
|
+
fixable: false
|
|
79
|
+
|
|
80
|
+
- id: cpp/malloc-free
|
|
81
|
+
name: "C/C++ 手工 malloc/free 需成对且有所有权说明"
|
|
82
|
+
category: "security"
|
|
83
|
+
severity: "warning"
|
|
84
|
+
description: "裸 malloc/free(含 calloc/realloc)不表达所有权,容易漏 free/重复 free;C++ 里应优先容器与智能指针,C 里需明确释放责任"
|
|
85
|
+
patterns:
|
|
86
|
+
- "(?<![\\w.>])(?:malloc|calloc|realloc|free)\\s*\\("
|
|
87
|
+
exts: ["c", "cc", "cpp", "cxx"]
|
|
88
|
+
exclude_paths:
|
|
89
|
+
- "test/"
|
|
90
|
+
- "tests/"
|
|
91
|
+
- "third_party/"
|
|
92
|
+
- "vendor/"
|
|
93
|
+
- "examples/"
|
|
94
|
+
- "example/"
|
|
95
|
+
fixable: false
|
|
96
|
+
|
|
97
|
+
# ----- 3. 健壮性 -----
|
|
98
|
+
|
|
99
|
+
- id: cpp/catch-all
|
|
100
|
+
name: "C++ 避免 catch(...) 吞掉一切异常"
|
|
101
|
+
category: "robustness"
|
|
102
|
+
severity: "notice"
|
|
103
|
+
description: "catch(...) 会连内存不足等不可恢复异常一起吞掉,且无法记录原因;应捕获具体类型,确需兜底时要记录并重新抛出"
|
|
104
|
+
patterns:
|
|
105
|
+
- "catch\\s*\\(\\s*\\.\\.\\.\\s*\\)"
|
|
106
|
+
exts: ["c", "cc", "cpp", "cxx", "h", "hh", "hpp", "hxx"]
|
|
107
|
+
exclude_paths:
|
|
108
|
+
- "test/"
|
|
109
|
+
- "tests/"
|
|
110
|
+
- "third_party/"
|
|
111
|
+
- "vendor/"
|
|
112
|
+
- "examples/"
|
|
113
|
+
- "example/"
|
|
114
|
+
fixable: false
|
|
@@ -1,22 +1,103 @@
|
|
|
1
1
|
# ============================================================
|
|
2
|
-
# Go
|
|
3
|
-
# 版本:0.
|
|
2
|
+
# Go 代码审计规则集(首版 · 语言专项)
|
|
3
|
+
# 版本:0.2.0
|
|
4
4
|
# 适用:Go 项目
|
|
5
|
-
#
|
|
6
|
-
#
|
|
7
|
-
#
|
|
8
|
-
#
|
|
9
|
-
#
|
|
10
|
-
# (func 关键字 + 花括号配对);② 本槽位按 python/java 先例写 min_length/
|
|
11
|
-
# max_depth/max_lines/max_complexity/magic-number 规则,exts: ["go"]。
|
|
5
|
+
# 描述:本槽位首版语言专项规则(**纯 pattern 层**,不依赖 AST 函数范围)。
|
|
6
|
+
# 规则依据:对真实 Go 仓(spf13/cobra 等样本仓)实测各候选模式的出现次数后选型——
|
|
7
|
+
# 只收「高信号 + 可判事实」的形态,避免静态扫 Go 时满屏噪音。
|
|
8
|
+
# (AST 层的 min_length/max_lines/max_complexity/magic-number 仍待补 LANG_FUNC_RANGES.go)
|
|
9
|
+
# 口径:exts 只认 .go;测试与示例目录用 exclude_paths 排除(测试里 panic/exit 是常态)。
|
|
12
10
|
# ============================================================
|
|
13
11
|
|
|
14
12
|
metadata:
|
|
15
|
-
name: "Go
|
|
16
|
-
version: "0.
|
|
13
|
+
name: "Go 审计规则集(首版 · 语言专项)"
|
|
14
|
+
version: "0.2.0"
|
|
17
15
|
language: "go"
|
|
18
16
|
author: "DeepSeek"
|
|
19
|
-
description: "Go
|
|
20
|
-
last_updated: "2026-10-
|
|
17
|
+
description: "Go 项目语言专用规则(pattern 层首版:panic/os.Exit/fmt.Print/context.TODO/unsafe)"
|
|
18
|
+
last_updated: "2026-10-16"
|
|
21
19
|
|
|
22
|
-
rules:
|
|
20
|
+
rules:
|
|
21
|
+
# ----- 1. 健壮性 -----
|
|
22
|
+
|
|
23
|
+
- id: go/panic-outside-init
|
|
24
|
+
name: "Go 避免在库代码里 panic"
|
|
25
|
+
category: "robustness"
|
|
26
|
+
severity: "warning"
|
|
27
|
+
description: "库代码 panic 会把调用方进程直接带走;应由调用方决定错误处置(返回 error 或 os.Exit 在 main 里做)"
|
|
28
|
+
# 负向环视避免命中 `x.panic(` 这类方法调用;测试/示例目录排除(测试里 panic 是断言手段)
|
|
29
|
+
patterns:
|
|
30
|
+
- "(?<![\\w$.])panic\\s*\\("
|
|
31
|
+
# 注:exclude_paths 是**路径前缀**匹配 ⇒ 无法表达 "_test.go" 这类后缀;
|
|
32
|
+
# 同目录的测试文件仍会命中(报告里给了目录级豁免提示)。此前这里写过一条
|
|
33
|
+
# "_test.go" 是**死条目**(永不生效 ✗),2026-10-16 已删。
|
|
34
|
+
exts: ["go"]
|
|
35
|
+
exclude_paths:
|
|
36
|
+
- "test/"
|
|
37
|
+
- "tests/"
|
|
38
|
+
- "testdata/"
|
|
39
|
+
- "example/"
|
|
40
|
+
- "examples/"
|
|
41
|
+
fixable: false
|
|
42
|
+
|
|
43
|
+
- id: go/os-exit-in-library
|
|
44
|
+
name: "Go 库代码避免 os.Exit"
|
|
45
|
+
category: "robustness"
|
|
46
|
+
severity: "warning"
|
|
47
|
+
description: "os.Exit 跳过 defer 清理(文件/锁/连接不会释放),且让调用方无法拦截;只在 main 或 CLI 入口使用"
|
|
48
|
+
patterns:
|
|
49
|
+
- "(?<![\\w$.])os\\.Exit\\s*\\("
|
|
50
|
+
exts: ["go"]
|
|
51
|
+
exclude_paths:
|
|
52
|
+
- "test/"
|
|
53
|
+
- "tests/"
|
|
54
|
+
- "example/"
|
|
55
|
+
- "examples/"
|
|
56
|
+
- "cmd/"
|
|
57
|
+
fixable: false
|
|
58
|
+
|
|
59
|
+
# ----- 2. 可维护性 -----
|
|
60
|
+
|
|
61
|
+
- id: go/fmt-print-debug
|
|
62
|
+
name: "Go 避免用 fmt.Print* 输出日志"
|
|
63
|
+
category: "maintainability"
|
|
64
|
+
severity: "notice"
|
|
65
|
+
description: "fmt.Print/Printf/Println 输出到 stdout 且无级别/时间戳,生产环境应走 log/slog 或项目日志器"
|
|
66
|
+
patterns:
|
|
67
|
+
- "(?<![\\w$.])fmt\\.Print(?:f|ln)\\s*\\("
|
|
68
|
+
- "(?<![\\w$.])fmt\\.Print\\s*\\("
|
|
69
|
+
exts: ["go"]
|
|
70
|
+
exclude_paths:
|
|
71
|
+
- "test/"
|
|
72
|
+
- "tests/"
|
|
73
|
+
- "example/"
|
|
74
|
+
- "examples/"
|
|
75
|
+
fixable: false
|
|
76
|
+
|
|
77
|
+
- id: go/context-todo
|
|
78
|
+
name: "Go 生产代码避免 context.TODO()"
|
|
79
|
+
category: "maintainability"
|
|
80
|
+
severity: "notice"
|
|
81
|
+
description: "context.TODO() 表示「还没想好」——生产路径应传调用方 context(可取消/带超时),否则请求链路无法取消"
|
|
82
|
+
patterns:
|
|
83
|
+
- "context\\.TODO\\s*\\(\\s*\\)"
|
|
84
|
+
exts: ["go"]
|
|
85
|
+
exclude_paths:
|
|
86
|
+
- "test/"
|
|
87
|
+
- "tests/"
|
|
88
|
+
- "example/"
|
|
89
|
+
- "examples/"
|
|
90
|
+
fixable: false
|
|
91
|
+
|
|
92
|
+
# ----- 3. 安全 -----
|
|
93
|
+
|
|
94
|
+
- id: go/unsafe-pointer
|
|
95
|
+
name: "Go 慎用 unsafe.Pointer"
|
|
96
|
+
category: "security"
|
|
97
|
+
severity: "error"
|
|
98
|
+
description: "unsafe 绕过 Go 类型安全与 GC 保证,跨版本/跨架构易出内存错误;确需使用时必须注释清楚不变量"
|
|
99
|
+
patterns:
|
|
100
|
+
- "unsafe\\.Pointer"
|
|
101
|
+
- "(?<![\\w$.])unsafe\\.(?:Sizeof|Offsetof|Alignof)\\s*\\("
|
|
102
|
+
exts: ["go"]
|
|
103
|
+
fixable: false
|
|
@@ -427,8 +427,8 @@ rules:
|
|
|
427
427
|
name: "真实邮箱入库(隐私泄漏)"
|
|
428
428
|
category: "security"
|
|
429
429
|
severity: "error"
|
|
430
|
-
description: "疑似真实个人邮箱硬编码/入库(隐私信息),请确认——示例域(example.com)、GitHub 匿名邮箱(users.noreply.github.com)、SSH 地址(git@github.com / git@ssh.github.com)、GitHub token 前缀用户名(ghp_/gho_/ghu_/ghs_/ghr_/github_pat_ 开头的用户名 + github.com 域;token 本体由 secret-github-pat 规则拦截)、本地虚拟域(.local/.lan/.internal/.test)豁免;真实邮箱(如 QQ 号@qq.com
|
|
431
|
-
pattern: "\\b(?!git@(?:ssh\\.)?github\\.com\\b|(?:gh[opsur]_|github_pat_)[A-Za-z0-9_]+@github\\.com\\b)[A-Za-z0-9._%+-]+@(?!example\\.com\\b|users\\.noreply\\.github\\.com\\b|[A-Za-z0-9-]+\\.(?:local|lan|internal|test|invalid|localhost)\\b)[A-Za-z0-9-]+\\.[A-Za-z]{2,}\\b"
|
|
430
|
+
description: "疑似真实个人邮箱硬编码/入库(隐私信息),请确认——示例域(example.com)、GitHub 匿名邮箱(users.noreply.github.com)、SSH 地址(git@github.com / git@ssh.github.com)、GitHub token 前缀用户名(ghp_/gho_/ghu_/ghs_/ghr_/github_pat_ 开头的用户名 + github.com 域;token 本体由 secret-github-pat 规则拦截)、本地虚拟域(.local/.lan/.internal/.test)豁免;真实邮箱(如 QQ 号@qq.com 等)一旦进公开仓库可被爬取,招致营销骚扰/社工;确需提交(公开联系方式/测试夹具/版权声明等)时可临时关闭审计再推送(插件设置 →「提交前审计」auditEnabled=false)"
|
|
431
|
+
pattern: "\\b(?!git@(?:ssh\\.)?github\\.com\\b|(?:gh[opsur]_|github_pat_)[A-Za-z0-9_]+@github\\.com\\b)[A-Za-z0-9._%+-]+@(?!example\\.com\\b|users\\.noreply\\.github\\.com\\b|[A-Za-z0-9-]+\\.(?:local|lan|internal|test|invalid|localhost)\\b|[A-Za-z0-9-]+\\.(?:png|jpe?g|gif|webp|svg|avif|ico|bmp|js|mjs|cjs|ts|tsx|jsx|css|scss|less|html?|json|ya?ml|md|markdown|txt|zip|gz|tgz|mp[34]|webm|pdf|woff2?|ttf|eot)\\b)[A-Za-z0-9-]+\\.[A-Za-z]{2,}\\b"
|
|
432
432
|
fixable: false
|
|
433
433
|
mitigation: "真实邮箱不写进代码/文档;示例一律用 your-name@example.com 占位;GitHub 匿名邮箱 users.noreply.github.com 豁免(git 提交默认 author);已入库的用 git filter 清历史"
|
|
434
434
|
- id: credfile-common
|
|
@@ -44,7 +44,7 @@ rules:
|
|
|
44
44
|
name: "路径穿越防护"
|
|
45
45
|
category: "security"
|
|
46
46
|
severity: "error"
|
|
47
|
-
description: "
|
|
47
|
+
description: "人工核查提示:请核对本仓库是否存在「用户输入直接拼进文件路径」的目录遍历风险(本规则是**人工核查占位**,不指向具体行;命中行号仅作锚点)"
|
|
48
48
|
fixable: false
|
|
49
49
|
mitigation: "使用 path.resolve + startsWith 白名单校验"
|
|
50
50
|
|