dsh-git-push 2.18.2 → 2.20.17
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/.gitignore +4 -0
- package/README.md +12 -5
- package/cli-audit.mjs +141 -0
- package/cli-tool.mjs +86 -0
- package/cli.mjs +116 -324
- package/lib/ARCHITECTURE.md +3 -0
- package/lib/app/audit-api.js +1 -1
- package/lib/app/command-registry.js +16 -3
- package/lib/app/constants.js +9 -0
- package/lib/app/handlers/clone.js +12 -3
- package/lib/app/handlers/http-constants.js +11 -2
- package/lib/app/handlers/npm.js +4 -2
- package/lib/app/handlers/repos.js +10 -1
- package/lib/app/handlers/settings.js +9 -1
- package/lib/app/http-handlers.js +24 -3
- package/lib/app/inject-text.js +1 -0
- package/lib/app/schema-audit.js +42 -0
- package/lib/app/schema.js +19 -19
- package/lib/app/scope-check.js +69 -0
- package/lib/app/settings-bridge.js +51 -0
- package/lib/app/tool-call.js +56 -7
- package/lib/ast/credential.js +130 -14
- package/lib/ast/dataflow.js +127 -10
- package/lib/ast/index.js +2 -0
- package/lib/ast/naming.js +9 -1
- package/lib/ast/scope-collisions.js +228 -0
- package/lib/ast/treesitter.js +142 -1
- package/lib/audit/history.js +1 -1
- package/lib/audit/orchestrate.js +93 -6
- package/lib/audit/scope-policy.js +110 -0
- package/lib/audit-rules/audit-rules-dsh.yml +16 -1
- package/lib/audit-rules/audit-rules-nodejs.yml +21 -6
- package/lib/audit-rules/audit-rules-paths.yml +7 -1
- package/lib/audit-ui-sdk/contract.js +117 -0
- package/lib/audit-ui-sdk/index.js +17 -0
- package/lib/checks/common.js +4 -4
- package/lib/checks/dispatch.js +5 -0
- package/lib/checks/index.js +2 -0
- package/lib/checks/regex.js +8 -3
- package/lib/checks/scope-collision.js +68 -0
- package/lib/cli/commands-audit.mjs +13 -18
- package/lib/cli/commands-tool.mjs +93 -0
- package/lib/cli/commands-vcs.mjs +2 -1
- package/lib/cli/shared.mjs +448 -0
- package/lib/client-parts/{account.js → git/account.js} +1 -1
- package/lib/client-parts/{actions.js → git/actions.js} +26 -11
- package/lib/client-parts/{apply.js → git/apply.js} +1 -1
- package/lib/client-parts/{browser.js → git/browser.js} +1 -1
- package/lib/client-parts/{const.js → git/const.js} +6 -1
- package/lib/client-parts/{controller.js → git/controller.js} +23 -11
- package/lib/client-parts/{icons.js → git/icons.js} +1 -1
- package/lib/client-parts/{loader.js → git/loader.js} +1 -1
- package/lib/client-parts/{npm.js → git/npm.js} +1 -1
- package/lib/client-parts/{page.js → git/page.js} +11 -21
- package/lib/client-parts/{repo.js → git/repo.js} +1 -1
- package/lib/client-parts/{settings.js → git/settings.js} +1 -1
- package/lib/client-parts/{utils.js → git/utils.js} +1 -1
- package/lib/client.js +75 -354
- package/lib/commit-push/pre-commit-engine.js +388 -0
- package/lib/commit-push.js +44 -17
- package/lib/exempt/index.js +5 -2
- package/lib/git/ignore.js +6 -4
- package/lib/git/init-compat.js +83 -4
- package/lib/git/push.js +25 -2
- package/lib/git/sensitive.js +30 -1
- package/lib/git/transport.js +31 -10
- package/lib/http/index.js +82 -10
- package/lib/lint-adapter/detect.js +161 -0
- package/lib/lint-adapter/index.js +50 -0
- package/lib/lint-adapter/runner.js +133 -0
- package/lib/npm/npmrc.js +22 -5
- package/lib/rule/compilers/structure.js +24 -0
- package/lib/score/index.js +36 -4
- package/lib/self/index.js +1 -1
- package/package.json +25 -2
- package/scripts/audit-gate.mjs +235 -0
- package/scripts/build-client.mjs +15 -8
- package/scripts/bump-version.mjs +20 -5
- package/scripts/check-js-scope.mjs +87 -0
- package/scripts/check.mjs +51 -4
- package/scripts/scan-file-io.mjs +5 -1
- package/scripts/scan-version.mjs +10 -7
- package/skills/dev/dsh-git-push.md +70 -2
- package/skills/guide/guide-audit.md +11 -11
- package/skills/guide/guide-cli-scripts.md +3 -3
- package/skills/guide/guide-commit-push.md +2 -2
- package/skills/guide/guide-inject-ui.md +0 -16
- package/assets/start.sh +0 -396
- package/scripts/scan-hardcoded-paths.mjs +0 -125
- /package/lib/client-parts/{audit.js → audit/audit.js} +0 -0
package/lib/cli/commands-vcs.mjs
CHANGED
|
@@ -20,7 +20,8 @@ import { DEFAULT_MAX_FILE_MB } from '../git/clone-download.js';
|
|
|
20
20
|
import { resolveToken } from '../git/credentials.js';
|
|
21
21
|
import { access } from 'node:fs/promises';
|
|
22
22
|
import { join } from 'node:path';
|
|
23
|
-
|
|
23
|
+
// cliPluginConfig 从公共层取(git 侧实现不该为了读配置去 import 审计实现)
|
|
24
|
+
import { cliPluginConfig } from './shared.mjs';
|
|
24
25
|
|
|
25
26
|
/** git-sluice repos 子命令默认列出上限。 */
|
|
26
27
|
const REPOS_DEFAULT_MAX = 200;
|
|
@@ -0,0 +1,448 @@
|
|
|
1
|
+
// CLI 公共层(三个入口共用:git-sluice / audit-sluice / tool-sluice)
|
|
2
|
+
//
|
|
3
|
+
// 为什么抽这一层:三入口如果各写一份 parseArgv / 结果打印 / 帮助渲染,迟早三份行为不一致——
|
|
4
|
+
// 同一个 `--depth 3` 在不同 CLI 里解析结果不同,是最难查的那类 bug。
|
|
5
|
+
// 所以「怎么解析」「怎么打印」「怎么分发」只在这里写一次;入口文件只留
|
|
6
|
+
// 「自己的命令表 + 自己的 HELP + 自己的副作用 import」。
|
|
7
|
+
//
|
|
8
|
+
// 切割线(命令 → 归哪个 CLI)也在这里**单处定义**:CLI_ENTRIES 是唯一真相,
|
|
9
|
+
// 入口的命令表、跨侧提示、测试的归属断言都从它推。改切割线只改这一处。
|
|
10
|
+
//
|
|
11
|
+
// 跨侧命令的策略:**明确报错 + 给出可直接照抄的替代命令**,不做静默转发。
|
|
12
|
+
// 静默转发会让「两个 CLI」名不副实,也让后续拆分永远收敛不了。
|
|
13
|
+
|
|
14
|
+
import { readFileSync, realpathSync } from 'node:fs';
|
|
15
|
+
import { fileURLToPath } from 'node:url';
|
|
16
|
+
|
|
17
|
+
import { VERSION } from '../self/index.js';
|
|
18
|
+
import { registryByCli, parseRegistryArgs } from '../app/command-registry.js';
|
|
19
|
+
import { callTool } from '../app/tool-call.js';
|
|
20
|
+
import { readSettings, applySettingsToCfg } from '../app/settings-bridge.js';
|
|
21
|
+
import { defaultConfig } from '../client/index.js';
|
|
22
|
+
|
|
23
|
+
/** 三个入口的名字(也是 bin 名)。 */
|
|
24
|
+
export const CLI_GIT = 'git-sluice';
|
|
25
|
+
export const CLI_AUDIT = 'audit-sluice';
|
|
26
|
+
export const CLI_TOOL = 'tool-sluice';
|
|
27
|
+
|
|
28
|
+
/**
|
|
29
|
+
* 三入口的切割线(唯一真相)。
|
|
30
|
+
* commands:该 CLI 独占的命令名(含注册表驱动与 COMMANDS 表两种来源);
|
|
31
|
+
* fallback:未知命令的处置——只有 git 侧把未知命令透传给 git(`git-sluice status` = `git status`),
|
|
32
|
+
* 另外两侧遇到未知命令必须报错(审计/工具 CLI 不该悄悄执行 git 命令)。
|
|
33
|
+
*/
|
|
34
|
+
export const CLI_ENTRIES = {
|
|
35
|
+
[CLI_GIT]: {
|
|
36
|
+
intro: 'dsh-git-push git 侧 CLI(提交/推送/克隆/账号/仓库扫描;脱离 DSH 运行)',
|
|
37
|
+
fallback: 'git-passthrough',
|
|
38
|
+
commands: [
|
|
39
|
+
'scan', 'commit', 'clone', 'clone-preview', 'remote-create', 'rename', 'set-visibility',
|
|
40
|
+
'identity-rewrite', 'account-check', 'cred-env', 'gen-ssh-key', 'git', 'api', 'repos', 'index',
|
|
41
|
+
'npm-publish', 'unpublish',
|
|
42
|
+
],
|
|
43
|
+
},
|
|
44
|
+
[CLI_AUDIT]: {
|
|
45
|
+
intro: 'dsh-git-push 审计侧 CLI(审计/规则/评分/静态检查;脱离 DSH 运行)',
|
|
46
|
+
fallback: 'error',
|
|
47
|
+
commands: ['audit', 'ruleset', 'file-io', 'link-check', 'scope-check', 'functions', 'tree-doc'],
|
|
48
|
+
},
|
|
49
|
+
[CLI_TOOL]: {
|
|
50
|
+
intro: 'dsh-git-push 工具链 CLI(拆分/模板/自检;不含 git 与审计命令)',
|
|
51
|
+
fallback: 'error',
|
|
52
|
+
commands: ['module-splitter', 'yaml-template', 'readme-template', 'self-check'],
|
|
53
|
+
},
|
|
54
|
+
};
|
|
55
|
+
|
|
56
|
+
/** 命令 → 所属 CLI(未登记返回空串)。 */
|
|
57
|
+
export function commandOwner(command) {
|
|
58
|
+
const name = String(command || '');
|
|
59
|
+
for (const [cliName, entry] of Object.entries(CLI_ENTRIES)) {
|
|
60
|
+
if (entry.commands.includes(name)) return cliName;
|
|
61
|
+
}
|
|
62
|
+
return '';
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/** 全部命令(三侧并集,供测试/文档核对完整性)。 */
|
|
66
|
+
export function allCommands() {
|
|
67
|
+
return Object.values(CLI_ENTRIES).flatMap((entry) => entry.commands);
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/**
|
|
71
|
+
* 读插件同一份配置(config.json)→ 运行期 cfg(与插件启动回读同一映射)。
|
|
72
|
+
*
|
|
73
|
+
* 为什么放在 CLI 公共层:三个入口的注册表驱动命令都要「和插件同口径」的配置
|
|
74
|
+
* (审计开关/扫描上限/权重覆盖/规则槽位…),各写一份必然漂移;而它本身只依赖
|
|
75
|
+
* lib/app + lib/client,与审计实现无关——放在 here 可以让 git 侧不必为了读配置 import 审计模块。
|
|
76
|
+
*
|
|
77
|
+
* 注意:applySettingsToCfg 是**原地修改** cfg,返回的是状态对象({changedSystemPrompt}),
|
|
78
|
+
* 绝不能把返回值当 cfg 用——那会让 auditEnabled/maxScanFiles/weightOverrides 全变 undefined。
|
|
79
|
+
* @returns {object} 运行期配置
|
|
80
|
+
*/
|
|
81
|
+
export function cliPluginConfig() {
|
|
82
|
+
const cfg = defaultConfig();
|
|
83
|
+
try {
|
|
84
|
+
const saved = readSettings({});
|
|
85
|
+
applySettingsToCfg(cfg, saved || {}); // 原地改 cfg,忽略返回值
|
|
86
|
+
} catch {
|
|
87
|
+
/* 配置缺失/损坏 → 保留 defaultConfig(与插件首启一致) */
|
|
88
|
+
}
|
|
89
|
+
return cfg;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/** 版本行(三入口共用格式,只有 CLI 名不同)。 */
|
|
93
|
+
export function versionLine(cliName) {
|
|
94
|
+
return `${cliName} v${VERSION} — dsh-git-push(统一函数入口架构)`;
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
/**
|
|
98
|
+
* 跨侧命令的报错提示(必须可照抄:给出完整替代命令,不能只报「不支持」)。
|
|
99
|
+
* @param {object} p { command, argvRest?: string[], fromCli?: string }
|
|
100
|
+
* @returns {string}
|
|
101
|
+
*/
|
|
102
|
+
export function buildCrossCliHint({ command = '', argvRest = [], fromCli = '' } = {}) {
|
|
103
|
+
const targetCli = commandOwner(command);
|
|
104
|
+
const tail = argvRest.length ? ` ${argvRest.join(' ')}` : '';
|
|
105
|
+
const lines = [
|
|
106
|
+
`✗ "${command}" 属于 ${targetCli},不在 ${fromCli} 里。`,
|
|
107
|
+
` 请改用:${targetCli} ${command}${tail}`,
|
|
108
|
+
];
|
|
109
|
+
if (argvRest.length) lines.push(` (你把原命令 ${fromCli} ${command}${tail} 里的 CLI 名换成 ${targetCli} 即可)`);
|
|
110
|
+
lines.push(` 三入口:${Object.keys(CLI_ENTRIES).join(' / ')};各自 help 看本侧全部命令`);
|
|
111
|
+
return lines.join('\n');
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
// ── 参数解析(三入口共用;白名单必须与各自 HELP 文本一致,由 self-check / 测试机器比对)──
|
|
115
|
+
|
|
116
|
+
/** 布尔开关 flag → flags 字段名(出现即为 true)。 */
|
|
117
|
+
const BOOL_FLAGS = {
|
|
118
|
+
'--full': 'full',
|
|
119
|
+
'--history': 'history',
|
|
120
|
+
'--include-ignored': 'includeIgnored',
|
|
121
|
+
'--dry-run': 'dryRun',
|
|
122
|
+
'--force': 'force',
|
|
123
|
+
'--req-confirm': 'reqConfirm',
|
|
124
|
+
'--push-gate-confirmed': 'pushGateConfirmed',
|
|
125
|
+
'--json': 'json',
|
|
126
|
+
'--offline': 'offline',
|
|
127
|
+
'--summary': 'summary',
|
|
128
|
+
'--write': 'write',
|
|
129
|
+
'--preview': 'preview',
|
|
130
|
+
'--skip-empty': 'skipEmpty',
|
|
131
|
+
'--no-check-ssh': null, // 特殊:置 false 而非 true(见下 applyBoolFlag)
|
|
132
|
+
};
|
|
133
|
+
|
|
134
|
+
/** 取值 flag → [flags 字段名, 缺值提示, 转换函数?]。 */
|
|
135
|
+
const VALUE_FLAGS = {
|
|
136
|
+
'--depth': ['depth', '--depth 缺值(用法: --depth N)', Number],
|
|
137
|
+
'--max': ['max', '--max 缺值(用法: --max N)', Number],
|
|
138
|
+
'--owner': ['owner', '--owner 缺值(用法: --owner <账号>)'],
|
|
139
|
+
'--ruleset': ['ruleset', '--ruleset 缺值'],
|
|
140
|
+
'--weights': ['weights', '--weights 缺值'],
|
|
141
|
+
'-m': ['message', '-m 缺值(用法: -m <提交信息>)'],
|
|
142
|
+
'--root': ['root', '--root 缺值(用法: --root <目录>)'],
|
|
143
|
+
'--readme': ['readme', '--readme 缺值(用法: --readme <README路径>)'],
|
|
144
|
+
'--type': ['type', '--type 缺值(用法: --type sync|async)'],
|
|
145
|
+
'--kind': ['kind', '--kind 缺值(用法: --kind read|write|delete|rename)'],
|
|
146
|
+
'--risk': ['risk', '--risk 缺值(用法: --risk high|medium|low)'],
|
|
147
|
+
'--op': ['op', '--op 缺值(用法: --op writeFileSync)'],
|
|
148
|
+
'--dest': ['dest', '--dest 缺值(用法: --dest <目录>)'],
|
|
149
|
+
'--branch': ['branch', '--branch 缺值(用法: --branch <分支名>)'],
|
|
150
|
+
'--max-file-mb': ['maxFileMB', '--max-file-mb 缺值(用法: --max-file-mb N)', Number],
|
|
151
|
+
'--concurrency': ['concurrency', '--concurrency 缺值(用法: --concurrency N)', Number],
|
|
152
|
+
'--visibility': ['visibility', '--visibility 缺值(用法: --visibility public|private)'],
|
|
153
|
+
'--email': ['email', '--email 缺值(用法: --email x@y.z)'],
|
|
154
|
+
'--token': ['token', '--token 缺值(用法: --token <ghp_...>)'],
|
|
155
|
+
'--since': ['since', '--since 缺值(用法: --since <起始提交 sha/ref>)'],
|
|
156
|
+
'--until': ['until', '--until 缺值(用法: --until <结束提交 sha/ref>)'],
|
|
157
|
+
'--out': ['out', '--out 缺值(用法: --out <报告保存目录>)'],
|
|
158
|
+
};
|
|
159
|
+
|
|
160
|
+
/** 默认值(每次调用新建,避免跨调用串状态)。 */
|
|
161
|
+
function defaultFlags() {
|
|
162
|
+
return {
|
|
163
|
+
depth: undefined, full: false, ruleset: undefined, weights: undefined, includeIgnored: false,
|
|
164
|
+
push: undefined, dryRun: false, force: false, reqConfirm: false, pushGateConfirmed: false,
|
|
165
|
+
message: undefined, json: false, max: undefined, owner: undefined, offline: false,
|
|
166
|
+
summary: false, write: false, type: undefined, kind: undefined, risk: undefined, op: undefined,
|
|
167
|
+
dest: undefined, branch: undefined, preview: false, maxFileMB: undefined, concurrency: undefined,
|
|
168
|
+
visibility: undefined, email: undefined, checkSsh: true, token: undefined,
|
|
169
|
+
};
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
/** 布尔开关落值:--no-check-ssh 语义是「关掉」而非「开启」;--push/--no-push 是同一字段两态。 */
|
|
173
|
+
function applyBoolFlag(flags, token) {
|
|
174
|
+
if (token === '--no-check-ssh') { flags.checkSsh = false; return; }
|
|
175
|
+
if (token === '--push') { flags.push = true; return; }
|
|
176
|
+
if (token === '--no-push') { flags.push = false; return; }
|
|
177
|
+
flags[BOOL_FLAGS[token]] = true;
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
/** 取值 flag 落值。 */
|
|
181
|
+
function applyValueFlag(flags, token, rawValue) {
|
|
182
|
+
const [field, , convert] = VALUE_FLAGS[token];
|
|
183
|
+
flags[field] = convert ? convert(rawValue) : rawValue;
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
/**
|
|
187
|
+
* 解析命令行参数(表驱动:加 flag 只加表项,函数长度不随 flag 数增长)。
|
|
188
|
+
* 三入口共用同一张表(超集)——某个 CLI 不用某个 flag 只是「不写进它的 HELP」,
|
|
189
|
+
* 解析器认不认与「有没有写进 HELP」由各侧 KNOWN_FLAGS 分别约束(self-check 比对)。
|
|
190
|
+
* @param {string[]} argv
|
|
191
|
+
* @returns {{flags: object, positional: string[]} | {error: string}}
|
|
192
|
+
*/
|
|
193
|
+
export function parseArgv(argv = []) {
|
|
194
|
+
const flags = defaultFlags();
|
|
195
|
+
const positional = [];
|
|
196
|
+
for (let index = 0; index < argv.length; index++) {
|
|
197
|
+
const token = argv[index];
|
|
198
|
+
if (token === '--push' || token === '--no-push' || token === '--no-check-ssh' || token in BOOL_FLAGS) {
|
|
199
|
+
applyBoolFlag(flags, token);
|
|
200
|
+
} else if (token in VALUE_FLAGS) {
|
|
201
|
+
const rawValue = argv[++index];
|
|
202
|
+
if (rawValue === undefined || rawValue.startsWith('--')) return { error: VALUE_FLAGS[token][1] };
|
|
203
|
+
applyValueFlag(flags, token, rawValue);
|
|
204
|
+
} else if (token.startsWith('--')) {
|
|
205
|
+
return { error: `未知参数: ${token}` };
|
|
206
|
+
} else {
|
|
207
|
+
positional.push(token);
|
|
208
|
+
}
|
|
209
|
+
}
|
|
210
|
+
return { flags, positional };
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
/** 解析后直接跑命令(三入口共用的「先 parseArgv 再调实现」包装)。 */
|
|
214
|
+
export function parseVia(run) {
|
|
215
|
+
return (rest) => {
|
|
216
|
+
const { flags, positional, error } = parseArgv(rest);
|
|
217
|
+
if (error) {
|
|
218
|
+
console.error(error);
|
|
219
|
+
// 参数错 = 用法错误,必须让调用方能判定失败。
|
|
220
|
+
// 此前只 console.error 不设退出码 ⇒ 退出码 0,门禁脚本会把 `audit --bogus`
|
|
221
|
+
// 当成「审计通过」(2026-11-13 由审阅发现,属拆分前既有缺陷)。
|
|
222
|
+
process.exitCode = 2;
|
|
223
|
+
return;
|
|
224
|
+
}
|
|
225
|
+
return run(flags, positional);
|
|
226
|
+
};
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
/**
|
|
230
|
+
* 工具返回的统一文本输出(注册表驱动命令共用)。
|
|
231
|
+
* 默认文本化 summary/quality/lines;--json 直出完整返回(完整返回可能很大,只给显式要的人)。
|
|
232
|
+
* @param {object} result 工具返回
|
|
233
|
+
* @param {boolean} asJson 是否直出 JSON
|
|
234
|
+
*/
|
|
235
|
+
export function printToolResult(result, asJson) {
|
|
236
|
+
if (asJson) { console.log(JSON.stringify(result, null, 2)); return; }
|
|
237
|
+
if (!result) return;
|
|
238
|
+
if (result.error) { console.error(result.error); return; }
|
|
239
|
+
if (result.apiGuide) { console.log(result.apiGuide); return; }
|
|
240
|
+
const lines = readableResultLines(result);
|
|
241
|
+
console.log(lines.length ? lines.join('\n') : JSON.stringify(result));
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
/**
|
|
245
|
+
* 把工具返回里的可读片段摊成文本行(summary / quality / count / 工具自带 lines)。
|
|
246
|
+
* 拆出来的理由:printToolResult 只剩「选哪条输出通道」,不再塞满条件分支。
|
|
247
|
+
* @param {object} result 工具返回
|
|
248
|
+
* @returns {string[]}
|
|
249
|
+
*/
|
|
250
|
+
function readableResultLines(result) {
|
|
251
|
+
const lines = [];
|
|
252
|
+
if (result.summary) lines.push(`summary: ${JSON.stringify(result.summary)}`);
|
|
253
|
+
if (result.quality) lines.push(`quality: ${result.quality.score ?? '?'}/${result.quality.level ?? '?'}`);
|
|
254
|
+
if (result.count != null) lines.push(`count: ${result.count}`);
|
|
255
|
+
// lines:工具自备的可读文本行(逐文件结论、命中明细等)——避免为此另造输出通道
|
|
256
|
+
if (Array.isArray(result.lines) && result.lines.length) lines.push(...result.lines);
|
|
257
|
+
return lines;
|
|
258
|
+
}
|
|
259
|
+
|
|
260
|
+
/** 子命令:version(三入口同一实现)。 */
|
|
261
|
+
export function printVersion(cliName) {
|
|
262
|
+
console.log(versionLine(cliName));
|
|
263
|
+
}
|
|
264
|
+
|
|
265
|
+
/**
|
|
266
|
+
* 纯分发决策(不执行任何命令):把 argv 判成「该走哪条」。
|
|
267
|
+
* 为什么要单独抽出来:真实执行命令会碰网络/磁盘(account-check 校验证书、scan 扫目录),
|
|
268
|
+
* 而「命令归属哪个 CLI」这件事必须能被无副作用地测(28 个命令 × 3 个入口全覆盖)。
|
|
269
|
+
* @param {object} p { cliName, argv, commands }
|
|
270
|
+
* @returns {{kind: 'help'|'version'|'cross'|'registry'|'command'|'git-passthrough'|'unknown',
|
|
271
|
+
* command?: string, targetCli?: string, hint?: string, entry?: object, handler?: Function, error?: string}}
|
|
272
|
+
*/
|
|
273
|
+
export function resolveDispatch({ cliName = CLI_GIT, argv = [], commands = new Map() } = {}) {
|
|
274
|
+
const [command, ...rest] = argv;
|
|
275
|
+
const knownCli = Object.prototype.hasOwnProperty.call(CLI_ENTRIES, cliName);
|
|
276
|
+
if (!knownCli) return { kind: 'unknown', error: `内部错误:未登记的 CLI 名 ${cliName}` };
|
|
277
|
+
if (!command || command === 'help' || command === '--help' || command === '-h') return { kind: 'help' };
|
|
278
|
+
if (command === 'version' || command === '-v' || command === '--version') return { kind: 'version' };
|
|
279
|
+
const owner = commandOwner(command);
|
|
280
|
+
// ① 跨侧:明确报错并给出可照抄的替代命令(绝不静默转发)
|
|
281
|
+
if (owner && owner !== cliName) {
|
|
282
|
+
return { kind: 'cross', command, targetCli: owner, hint: buildCrossCliHint({ command, argvRest: rest, fromCli: cliName }) };
|
|
283
|
+
}
|
|
284
|
+
// ② 本侧 COMMANDS 表优先:它是「CLI 自己怎么执行」的显式实现,
|
|
285
|
+
// 注册表只是「与插件工具同实现」的镜像。两者都有的命令(目前只有 `git`)必须走 COMMANDS——
|
|
286
|
+
// `git-sluice git <任意 git 参数>` 要原样透传,而注册表解析器只认声明过的参数,
|
|
287
|
+
// 会把 `git log --oneline` 里的 --oneline 当「未知参数」拒掉(实测)。
|
|
288
|
+
const handler = commands.get(command);
|
|
289
|
+
if (handler) return { kind: 'command', command, handler };
|
|
290
|
+
// ③ 注册表驱动命令(与插件工具同实现;只有属于本侧时才走)
|
|
291
|
+
const registryEntry = registryByCli(command);
|
|
292
|
+
if (registryEntry && (!owner || owner === cliName)) return { kind: 'registry', command, entry: registryEntry };
|
|
293
|
+
// ④ 未知命令
|
|
294
|
+
if (CLI_ENTRIES[cliName].fallback === 'git-passthrough') return { kind: 'git-passthrough', command, argv };
|
|
295
|
+
return {
|
|
296
|
+
kind: 'unknown',
|
|
297
|
+
command,
|
|
298
|
+
error: [
|
|
299
|
+
`✗ 未知命令:${command}(${cliName} 没有这个命令)`,
|
|
300
|
+
` ${cliName} help 看本侧全部命令`,
|
|
301
|
+
` 若是 git 操作,请用 ${CLI_GIT}(例:${CLI_GIT} ${command})。`,
|
|
302
|
+
].join('\n'),
|
|
303
|
+
};
|
|
304
|
+
}
|
|
305
|
+
|
|
306
|
+
/**
|
|
307
|
+
* 注册表命令的布尔**否定形式**归一化:`--no-<参数>` ⇒ 该布尔参数置 false。
|
|
308
|
+
*
|
|
309
|
+
* 为什么需要:注册表解析器(lib/app/command-registry.js)只认 `--<参数>`(出现即 true),
|
|
310
|
+
* 没有否定形式。而 HELP 里 `[--push|--no-push]` 这种写法用户天天照抄——不认就报
|
|
311
|
+
* 「未知参数 --no-push」,属于「文档写着、抄了必失败」。这里在进解析器之前翻译:
|
|
312
|
+
* 删掉 `--no-x` token,解析完再把该参数显式置 false(与 parseArgv 的 --no-check-ssh 同一语义)。
|
|
313
|
+
* ⚠️ 若 `--no-x` 本身就是已声明的参数名(如 npm-publish 的 --no-dry-run),原样放行不翻译。
|
|
314
|
+
* @param {string[]} rest 命令后的参数表
|
|
315
|
+
* @param {object[]} params 该命令的注册表参数
|
|
316
|
+
* @returns {{argv: string[], negated: object[]}}
|
|
317
|
+
*/
|
|
318
|
+
export function normalizeRegistryArgv(rest = [], params = []) {
|
|
319
|
+
const byFlag = new Map(params.map((param) => [param.flag, param]));
|
|
320
|
+
const declaredFlags = new Set(params.map((param) => `--${String(param.flag).replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}`));
|
|
321
|
+
const argv = [];
|
|
322
|
+
const negated = [];
|
|
323
|
+
for (const token of rest) {
|
|
324
|
+
const raw = String(token);
|
|
325
|
+
const isNegation = raw.startsWith('--no-') && !declaredFlags.has(raw);
|
|
326
|
+
const single = isNegation ? raw.slice('--no-'.length) : '';
|
|
327
|
+
const param = isNegation ? (byFlag.get(single) || byFlag.get(single.replace(/-([a-z])/g, (match, letter) => letter.toUpperCase()))) : null;
|
|
328
|
+
if (param && param.type === 'boolean') { negated.push(param); continue; }
|
|
329
|
+
argv.push(raw);
|
|
330
|
+
}
|
|
331
|
+
return { argv, negated };
|
|
332
|
+
}
|
|
333
|
+
|
|
334
|
+
/**
|
|
335
|
+
* 跑一个 CLI 入口(三入口共用的 main 实现)。
|
|
336
|
+
* @param {object} p
|
|
337
|
+
* cliName : 入口名(同时决定跨侧提示文案与 fallback 行为)
|
|
338
|
+
* argv : 参数表(缺省 process.argv.slice(2))
|
|
339
|
+
* commands : 本侧 COMMANDS 表(Map<命令名, handler(rest)>)
|
|
340
|
+
* helpText : 本侧 HELP 文本
|
|
341
|
+
* config : 可选 { cliPluginConfig } 注入(CLI 独立运行时的插件配置)
|
|
342
|
+
* passthroughGit : fallback=git-passthrough 时调用(由 git 入口注入,避免 audit/tool 侧依赖 git 层)
|
|
343
|
+
* @returns {Promise<number|undefined>} 退出码(number 时由入口赋给 process.exitCode)
|
|
344
|
+
*/
|
|
345
|
+
export async function runCli({
|
|
346
|
+
cliName = CLI_GIT, argv = process.argv.slice(2), commands = new Map(), helpText = '',
|
|
347
|
+
passthroughGit = null, getConfig = () => undefined,
|
|
348
|
+
} = {}) {
|
|
349
|
+
const plan = resolveDispatch({ cliName, argv, commands });
|
|
350
|
+
if (plan.kind === 'help') { console.log(helpText); return; }
|
|
351
|
+
if (plan.kind === 'version') { printVersion(cliName); return; }
|
|
352
|
+
if (plan.kind === 'cross') { console.error(plan.hint); process.exitCode = 1; return 1; }
|
|
353
|
+
if (plan.kind === 'unknown') { console.error(plan.error); process.exitCode = 1; return 1; }
|
|
354
|
+
if (plan.kind === 'command') return await plan.handler(argv.slice(1));
|
|
355
|
+
if (plan.kind === 'registry') {
|
|
356
|
+
const { argv: normalizedArgv, negated } = normalizeRegistryArgv(argv.slice(1), plan.entry.params);
|
|
357
|
+
const { args, error } = parseRegistryArgs(normalizedArgv, plan.entry.params);
|
|
358
|
+
// 参数错统一 exit 2(与 parseVia 一致、符合「用法错误」惯例);
|
|
359
|
+
// 其余失败(执行/网络/跨侧指引)保持 1,两者语义不同。
|
|
360
|
+
if (error) { console.error(error); process.exitCode = 2; return 2; }
|
|
361
|
+
// --no-<布尔参数>:解析器给的是默认值/true,这里显式覆盖成 false
|
|
362
|
+
for (const param of negated) args[param.flag] = false;
|
|
363
|
+
try {
|
|
364
|
+
const toolResult = await callTool(plan.entry.name, args, { workspaceRoot: process.cwd() }, getConfig(), console, null, null);
|
|
365
|
+
printToolResult(toolResult, args.json === true);
|
|
366
|
+
// 退出码如实反映结果:ok:false = 命令失败(门禁/脚本据此判失败)。
|
|
367
|
+
// ok:true 但 committed:false / pushed:false 这类「零改动正常路径」仍是 0。
|
|
368
|
+
return toolResult && toolResult.ok === false ? 1 : 0;
|
|
369
|
+
} catch (e) {
|
|
370
|
+
console.error(String((e && e.message) || e));
|
|
371
|
+
process.exitCode = 1;
|
|
372
|
+
return 1;
|
|
373
|
+
}
|
|
374
|
+
}
|
|
375
|
+
// git 透传(只有 git 侧会走到)
|
|
376
|
+
if (plan.kind === 'git-passthrough') {
|
|
377
|
+
if (typeof passthroughGit !== 'function') {
|
|
378
|
+
console.error(`✗ 未知命令:${plan.command}(本入口未接线 git 透传)`);
|
|
379
|
+
process.exitCode = 1;
|
|
380
|
+
return 1;
|
|
381
|
+
}
|
|
382
|
+
const wrapped = await passthroughGit(plan.argv);
|
|
383
|
+
if (wrapped && wrapped.ok) return 0;
|
|
384
|
+
process.exitCode = typeof wrapped?.status === 'number' ? wrapped.status : 1;
|
|
385
|
+
return process.exitCode;
|
|
386
|
+
}
|
|
387
|
+
return 1;
|
|
388
|
+
}
|
|
389
|
+
|
|
390
|
+
/**
|
|
391
|
+
* 判断「本模块是不是被直接执行」(被 import 时不执行入口逻辑)。
|
|
392
|
+
* 为什么不能用字符串比较:bin 是符号链接(PATH 里 git-sluice → cli.mjs),
|
|
393
|
+
* process.argv[1] 是链接路径、import.meta.url 是真实路径,直接比会判成「非直接执行」→
|
|
394
|
+
* 入口静默不跑、exit 0 无输出;相对/绝对路径混用时同理。故两边都 realpath 归一化再比。
|
|
395
|
+
* @param {string} moduleUrl 入口模块的 import.meta.url
|
|
396
|
+
* @returns {boolean}
|
|
397
|
+
*/
|
|
398
|
+
export function isDirectRun(moduleUrl) {
|
|
399
|
+
const entry = process.argv[1];
|
|
400
|
+
if (!entry) return false;
|
|
401
|
+
try {
|
|
402
|
+
return realpathSync(fileURLToPath(moduleUrl)) === realpathSync(entry);
|
|
403
|
+
} catch {
|
|
404
|
+
return false;
|
|
405
|
+
}
|
|
406
|
+
}
|
|
407
|
+
|
|
408
|
+
/**
|
|
409
|
+
* 入口薄壳:直接执行时跑 main 并把 number 返回值落成退出码。
|
|
410
|
+
* @param {string} moduleUrl import.meta.url
|
|
411
|
+
* @param {Function} main 返回 Promise<number|undefined>
|
|
412
|
+
*/
|
|
413
|
+
export function runAsEntry(moduleUrl, main) {
|
|
414
|
+
if (!isDirectRun(moduleUrl)) return;
|
|
415
|
+
// 顶层 await:main 已异步,未 await 时 rejection 会变成 unhandled rejection
|
|
416
|
+
// (进程静默退出、退出码不对)。命令函数有的返回业务对象/数组,只有 number 才赋 exitCode
|
|
417
|
+
// —— 否则 `process.exitCode = 对象` 抛 ERR_INVALID_ARG_TYPE。
|
|
418
|
+
main().then((code) => {
|
|
419
|
+
if (typeof code === 'number' && Number.isInteger(code)) process.exitCode = code;
|
|
420
|
+
}).catch((e) => {
|
|
421
|
+
console.error(String((e && e.stack) || e));
|
|
422
|
+
process.exitCode = 1;
|
|
423
|
+
});
|
|
424
|
+
}
|
|
425
|
+
|
|
426
|
+
/**
|
|
427
|
+
* 读入口源码(self-check 用:跨入口核对 HELP 与 KNOWN_FLAGS,不 import 入口)。
|
|
428
|
+
* 为什么读源码而不 import 三个入口:入口 import 会连带加载全部命令实现(含网络/凭据模块),
|
|
429
|
+
* 而自检只需要两张文本表;读源码既零副作用,又核对到「文件里真正写着的那份」。
|
|
430
|
+
* @param {string} relPath 相对插件根的路径(如 'cli-audit.mjs')
|
|
431
|
+
* @returns {string}
|
|
432
|
+
*/
|
|
433
|
+
export function readEntrySource(relPath) {
|
|
434
|
+
return readFileSync(new URL(`../../${relPath}`, import.meta.url), 'utf8');
|
|
435
|
+
}
|
|
436
|
+
|
|
437
|
+
/**
|
|
438
|
+
* 从入口源码里取 HELP 与 KNOWN_FLAGS。
|
|
439
|
+
* @param {string} sourceText 入口文件全文
|
|
440
|
+
* @returns {{help: string, flags: string[]}}
|
|
441
|
+
*/
|
|
442
|
+
export function parseEntrySourceMeta(sourceText = '') {
|
|
443
|
+
const text = String(sourceText);
|
|
444
|
+
const helpMatch = text.match(/const HELP = `([\s\S]*?)`;/);
|
|
445
|
+
const flagsMatch = text.match(/const KNOWN_FLAGS = \[([\s\S]*?)\];/);
|
|
446
|
+
const flags = flagsMatch ? [...flagsMatch[1].matchAll(/'(--[a-z0-9-]+)'/g)].map((match) => match[1]) : [];
|
|
447
|
+
return { help: helpMatch ? helpMatch[1] : '', flags };
|
|
448
|
+
}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
/* ─── 第 13
|
|
1
|
+
/* ─── 第 12/13 片 · Controller 动作注入(接 controller.js 的类体,方法声明不可拆出类外) ─────────────────── */
|
|
2
2
|
setStatus(msg) {
|
|
3
3
|
this.statusMsg = String(msg || '');
|
|
4
4
|
if (this.statusTimer) clearTimeout(this.statusTimer);
|
|
@@ -66,28 +66,33 @@
|
|
|
66
66
|
// persistSshPub 另有 isMaskedValue 拦截,这里是 UI 侧提前拦住不发请求)。
|
|
67
67
|
if (key === 'githubToken' || key === 'sshPub') {
|
|
68
68
|
const sv = String(value ?? '').trim();
|
|
69
|
-
if (!sv) return;
|
|
69
|
+
if (!sv) return Promise.resolve(false); // 空值:不动该键(留空=保持不变)
|
|
70
70
|
if (sv.includes('…') || sv.includes('****') || /^gh[pous]_…/.test(sv)) {
|
|
71
71
|
this.failed = true;
|
|
72
72
|
this.flashSaved('❌ 拒绝写入:这是脱敏显示值,请输入完整凭据');
|
|
73
73
|
this.publish();
|
|
74
|
-
return;
|
|
74
|
+
return Promise.resolve(false);
|
|
75
75
|
}
|
|
76
76
|
}
|
|
77
77
|
// UI 提交调试日志(浏览器控制台可见;服务端另有 settings-ui.log 持久留痕)
|
|
78
78
|
if (typeof console !== 'undefined' && console.debug) {
|
|
79
79
|
try { console.debug('[dsh-git-push] UI 提交', key, '=', String(value).slice(0, dshgp_LOG_TRUNCATE) + (String(value).length > dshgp_LOG_TRUNCATE ? '…' : '')); } catch { /* 控制台不可用时跳过调试输出 */ }
|
|
80
80
|
}
|
|
81
|
-
|
|
81
|
+
// 返回 promise<boolean>:调用方若需要「先确认成功再提示」就 await 它。
|
|
82
|
+
// 多数调用方(开关/下拉)不 await —— 它们只关心最终状态,失败时 UI 有 failed 标记;
|
|
83
|
+
// 凭据保存(save)必须 await,否则会先弹「已保存」再失败,误导用户(外部报告已实测踩到)。
|
|
84
|
+
return dshgp_postJson('/api/git-push/settings-set', { key, value }).then((data) => {
|
|
82
85
|
if (data && data.ok) {
|
|
83
86
|
if (okMsg) this.flashSaved(okMsg);
|
|
84
|
-
|
|
85
|
-
this.failed = true;
|
|
86
|
-
this.publish();
|
|
87
|
+
return true;
|
|
87
88
|
}
|
|
89
|
+
this.failed = true;
|
|
90
|
+
this.publish();
|
|
91
|
+
return false;
|
|
88
92
|
}).catch(() => {
|
|
89
93
|
this.failed = true;
|
|
90
94
|
this.publish();
|
|
95
|
+
return false;
|
|
91
96
|
});
|
|
92
97
|
}
|
|
93
98
|
|
|
@@ -178,16 +183,26 @@
|
|
|
178
183
|
// 凭据持久化走 persistSetting(纯 HTTP /settings-set → 服务端
|
|
179
184
|
// writeSettingsKey 写 config.json + persistGithubToken/persistSshPub 落插件目录,
|
|
180
185
|
// 不 scope.set——scope.set 会把凭据写进公共 settings.yaml 明文,反代下还不落盘)。
|
|
181
|
-
|
|
182
|
-
|
|
186
|
+
// 先**等**两次写入各自有结果,再决定提示什么。
|
|
187
|
+
// 旧实现不 await 就 flashSaved('✅ 凭据已保存'):写失败(如桌面端 403)时
|
|
188
|
+
// 用户先看到成功、随后才看到失败,正是「已保存但没生效」这一误解的来源。
|
|
189
|
+
const writeResults = [];
|
|
190
|
+
if (raw) writeResults.push(await this.persistSetting('githubToken', raw));
|
|
191
|
+
if (pub) writeResults.push(await this.persistSetting('sshPub', pub));
|
|
192
|
+
const allOk = writeResults.length > 0 && writeResults.every((okFlag) => okFlag === true);
|
|
183
193
|
this.text = '';
|
|
184
194
|
this.sshPub = '';
|
|
185
195
|
this.saving = false;
|
|
186
196
|
// 保存后**刷新凭据与密钥的「已填写」状态**——此前只在写入 token 时本地置位
|
|
187
197
|
// tokenConfigured、sshConfigured 从不置位(保存公钥后徽标仍显示未填写),且本地置位
|
|
188
198
|
// 无法反映服务端规范化/落盘失败。统一走 refresh('account') 从 account-status 真源读回。
|
|
189
|
-
//
|
|
190
|
-
|
|
199
|
+
// 顺序:先给保存结果提示,再异步读回状态(读回过程不遮挡保存反馈)。
|
|
200
|
+
if (allOk) {
|
|
201
|
+
this.flashSaved('✅ 凭据已保存');
|
|
202
|
+
} else {
|
|
203
|
+
this.failed = true;
|
|
204
|
+
this.flashSaved('❌ 保存失败:请求未写入(详情见 http-rejects.log / settings-ui.log)');
|
|
205
|
+
}
|
|
191
206
|
await this.refresh('account');
|
|
192
207
|
} catch (_e) {
|
|
193
208
|
this.saving = false;
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
/* ─── 第
|
|
1
|
+
/* ─── 第 13/13 片 · 收尾:注册 settings.section + factory 返回(必须末片) ─────────────────── */
|
|
2
2
|
function apply(ctx) {
|
|
3
3
|
// 【常驻诊断 · 前端接线失败可见化】apply 整体包一层 try/catch,把真实异常打到控制台。
|
|
4
4
|
// 背景:cordis 只把失败的 client entry 标成 failed(页面仅显示
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
/* ─── 第 6/
|
|
1
|
+
/* ─── 第 6/13 片 · 目录选择器(browseEnsureDom/browseLoad/browseOpen/browseClose/browseAttach) ─────────────────── */
|
|
2
2
|
let dshgp_browseTarget = null; // 当前打开的输入框(null = 走 onPick 回调)
|
|
3
3
|
// 移植 gamebanana-mods-downloader 的 path-picker 小模块:一行接入 📂 按钮 // 当前打开的输入框(null = 走 onPick 回调)
|
|
4
4
|
let dshgp_browseOpt = null; // { onPick } 确认回调(clone 场景)
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
/* ─── 第 2/
|
|
1
|
+
/* ─── 第 2/13 片 · 常量区(NS/维度表/样式串) ─────────────────── */
|
|
2
2
|
// 面板「忙碌中」状态键的前缀(clone / vis / push 三类操作共用**同一出处**)。
|
|
3
3
|
// 此前这三个字面量散落在组件与类方法里各写一遍,改一处不会同步另一处;
|
|
4
4
|
// 命名带 dshgp_ 前缀,符合本文件的形态铁律(防 combo 拼接撞名)。
|
|
@@ -26,6 +26,11 @@
|
|
|
26
26
|
// 现在 repo-clone 提交即返回 202、下载在服务端后台跑,提交本身是快操作,
|
|
27
27
|
// 故该长超时常量已删除——提交用下面的短超时,进度与终态由轮询接管。
|
|
28
28
|
const dshgp_SCAN_WAIT_MAX_ROUNDS = 600; // 后台扫描等待循环上限(每次挂起等新进度)
|
|
29
|
+
// 扫描长轮询的**单个请求**超时:必须**大于**服务端单次挂起上限(SCAN_WAIT_TIMEOUT_MS=20s,
|
|
30
|
+
// 服务端到点返回 {timeout:true} 而非失败),又**不超过**默认 fetch 超时(30s)。
|
|
31
|
+
// 三层关系(服务端挂起 < 本值 ≤ 默认超时)由 test/test-repos-live-budget.mjs 断言守着:
|
|
32
|
+
// 任一层漂移都会让长轮询变成「客户端先 abort」的假失败(实测就是这么踩到的)。
|
|
33
|
+
const dshgp_SCAN_WAIT_FETCH_MS = 25_000;
|
|
29
34
|
const dshgp_SAVED_MSG_MS = 4000; // 「已保存」提示显示时长
|
|
30
35
|
const dshgp_LOG_TRUNCATE = 40; // 调试日志 value 截断长度
|
|
31
36
|
|