dsh-git-push 2.9.9 → 2.10.4
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 +26 -15
- package/assets/tree-sitter/LICENSE +0 -0
- package/assets/tree-sitter/README.md +0 -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 +0 -0
- package/assets/tree-sitter/tree-sitter.wasm +0 -0
- package/lib/ARCHITECTURE.md +27 -0
- package/lib/app/apply.js +0 -0
- package/lib/app/command-registry.js +1 -0
- package/lib/app/handlers/repos.js +18 -2
- package/lib/app/handlers/settings.js +0 -0
- package/lib/app/handlers/workspace-paths.js +0 -0
- package/lib/app/schema.js +0 -0
- package/lib/app/settings-bridge.js +0 -0
- package/lib/app/tool-call.js +6 -2
- package/lib/ast/brace.js +15 -0
- package/lib/ast/code-lines.js +0 -0
- package/lib/ast/fs-hotspots.js +0 -0
- package/lib/ast/index.js +0 -0
- package/lib/ast/size.js +68 -1
- package/lib/ast/tokenizer.js +0 -0
- package/lib/ast/treesitter.js +0 -0
- package/lib/audit/collector.js +13 -4
- package/lib/audit/ignore-blind.js +5 -4
- package/lib/audit/orchestrate.js +2 -1
- package/lib/audit-rules/audit-rules-frontend.yml +4 -4
- package/lib/checks/button-bind.js +61 -13
- package/lib/checks/dispatch.js +1 -1
- package/lib/checks/fs-scanner.js +0 -0
- package/lib/checks/private.js +2 -1
- package/lib/checks/regex.js +0 -0
- package/lib/checks/structural.js +10 -3
- package/lib/client-parts/{10-account.js → account.js} +1 -1
- package/lib/client-parts/{41-actions.js → actions.js} +3 -2
- package/lib/client-parts/{99-apply.js → apply.js} +2 -1
- package/lib/client-parts/{21-audit.js → audit.js} +5 -5
- package/lib/client-parts/{11-browser.js → browser.js} +15 -4
- package/lib/client-parts/{01-const.js → const.js} +11 -5
- package/lib/client-parts/{40-controller.js → controller.js} +4 -4
- package/lib/client-parts/{03-icons.js → icons.js} +1 -1
- package/lib/client-parts/{00-loader.js → loader.js} +1 -0
- package/lib/client-parts/{23-npm.js → npm.js} +3 -2
- package/lib/client-parts/{30-page.js → page.js} +1 -1
- package/lib/client-parts/{20-repo.js → repo.js} +2 -2
- package/lib/client-parts/{22-settings.js → settings.js} +1 -1
- package/lib/client-parts/{02-utils.js → utils.js} +1 -1
- package/lib/client.js +51 -30
- package/lib/context/index.js +2 -1
- package/lib/core/atomic-json.js +1 -1
- package/lib/core/workspace-paths.js +0 -0
- package/lib/exempt/index.js +7 -2
- package/lib/exempt/tool.js +0 -0
- package/lib/git/clone-history-mode.js +22 -9
- package/lib/git/clone-replay-io.js +10 -4
- package/lib/git/clone.js +8 -2
- package/lib/git/commit-message.js +0 -0
- package/lib/git/index-format.js +182 -0
- package/lib/git/index.js +1 -0
- package/lib/git/init-compat.js +118 -0
- package/lib/git/push-diagnose.js +0 -0
- package/lib/git/repo-index.js +41 -30
- package/lib/git/scan-runner.js +1 -1
- package/lib/npm/publish.js +14 -12
- package/lib/self/index.js +1 -1
- package/package.json +1 -1
- package/scripts/build-client.mjs +19 -14
- package/scripts/check.mjs +68 -0
- package/scripts/cpu-sample.mjs +0 -0
- package/scripts/picker-repro.mjs +115 -0
- package/scripts/scan-fs-hotspots.mjs +0 -0
- package/skills/dsh-repo-index.md +1 -1
- package/skills/guide/guide-audit.md +106 -3
- package/skills/guide/guide-cli-scripts.md +1 -1
- package/skills/guide/guide-clone-repos.md +2 -2
- package/skills/guide/guide-inject-ui.md +2 -2
- package/skills/workflow/README.md +1 -1
package/lib/npm/publish.js
CHANGED
|
@@ -117,6 +117,8 @@ function appendPublishLog(line, { workspaceRoot = '' } = {}) {
|
|
|
117
117
|
export async function publishPackage({
|
|
118
118
|
dir = '', registry = DEFAULT_REGISTRY, workspaceRoot = '',
|
|
119
119
|
dryRun = true, tag = 'latest', otp = '', confirm = false, timeoutMs = PUBLISH_TIMEOUT_MS,
|
|
120
|
+
// 可选:发布成功后等待 registry 可见。默认 false —— 上传成功即为成功(可见延迟是已知现象)
|
|
121
|
+
waitVisible = false,
|
|
120
122
|
} = {}) {
|
|
121
123
|
const info = readPackageInfo(dir);
|
|
122
124
|
if (!info.ok) return { ok: false, error: info.error };
|
|
@@ -156,19 +158,19 @@ export async function publishPackage({
|
|
|
156
158
|
// 否则会去发布宿主 cwd 下的包(或不存在的包)—— 这是发包类操作里最危险的一种错。
|
|
157
159
|
const r = runNpm(args, { timeoutMs, env: { NO_UPDATE_NOTIFIER: '1' }, cwd: info.dir });
|
|
158
160
|
appendPublishLog(`publish END dryRun=${dryRun} ok=${r.ok} code=${r.code} err=${String(r.error || '').slice(0, 200)}`, { workspaceRoot });
|
|
159
|
-
//
|
|
160
|
-
|
|
161
|
+
// 成功判定 = npm publish 上传成功(返回码 0),不看 registry 是否已可见——
|
|
162
|
+
// 发布后 registry 可见常有几分钟延迟(已知现象,不是失败)。
|
|
163
|
+
// 轮询只作**附加信息**:若提前可见就记 visible=true,让调用方知道「已可安装」。
|
|
164
|
+
let visible = false;
|
|
161
165
|
let polled = 0;
|
|
162
|
-
|
|
163
|
-
if (r.ok && !dryRun) {
|
|
166
|
+
if (r.ok && !dryRun && waitVisible) {
|
|
164
167
|
for (let i = 0; i < PUBLISH_POLL_MAX; i += 1) {
|
|
165
168
|
await sleep(PUBLISH_POLL_INTERVAL_MS);
|
|
166
169
|
polled += 1;
|
|
167
170
|
const now = await fetchPublishedVersions({ name: info.name, registry: reg, timeoutMs: NPM_TIMEOUT_MS });
|
|
168
|
-
if (now.ok && now.versions.includes(info.version)) {
|
|
171
|
+
if (now.ok && now.versions.includes(info.version)) { visible = true; break; }
|
|
169
172
|
}
|
|
170
|
-
|
|
171
|
-
appendPublishLog(`publish POLL verified=${verified} polled=${polled} timeout=${pollTimeout}`, { workspaceRoot });
|
|
173
|
+
appendPublishLog(`publish POLL visible=${visible} polled=${polled}`, { workspaceRoot });
|
|
172
174
|
}
|
|
173
175
|
return {
|
|
174
176
|
ok: !!r.ok,
|
|
@@ -180,12 +182,12 @@ export async function publishPackage({
|
|
|
180
182
|
packList: pack.files,
|
|
181
183
|
packSize: pack.size,
|
|
182
184
|
tarball: pack.filename,
|
|
183
|
-
published: !dryRun && !!r.ok,
|
|
184
|
-
//
|
|
185
|
-
|
|
185
|
+
published: !dryRun && !!r.ok, // 成功判定:npm 上传成功即为成功(不要求 registry 已可见)
|
|
186
|
+
// 附加信息(不影响 published):registry 是否已能看到新版本;发布延迟(几分钟)是已知现象
|
|
187
|
+
visible,
|
|
186
188
|
polled,
|
|
187
|
-
|
|
188
|
-
|
|
189
|
+
visibleNote: visible ? 'registry 已可见'
|
|
190
|
+
: (waitVisible ? 'registry 暂未可见(发布延迟属正常,不是失败)' : '发布成功(registry 可见可能有几分钟延迟,属正常现象)'),
|
|
189
191
|
registryQuery: { ok: pub.ok, error: pub.error || '' },
|
|
190
192
|
stdout: String(r.stdout || '').slice(-4000),
|
|
191
193
|
stderr: String(r.stderr || '').slice(-4000),
|
package/lib/self/index.js
CHANGED
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
*/
|
|
10
10
|
|
|
11
11
|
|
|
12
|
-
export const VERSION = '2.
|
|
12
|
+
export const VERSION = '2.10.4'; // 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:忽略链路端到端回归。
|
|
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/package.json
CHANGED
package/scripts/build-client.mjs
CHANGED
|
@@ -32,22 +32,27 @@ export const OUT_FILE = join(ROOT, 'lib', 'client.js');
|
|
|
32
32
|
* 拼接顺序 = 依赖顺序(先定义后使用)。
|
|
33
33
|
* 函数声明会提升、但 `const`/`let` 不会——顺序错会在**运行时**才炸(静态查不出),
|
|
34
34
|
* 所以这里与 client.js 的分节标记 `[N]` 一一对应,改分片必须同步改本表。
|
|
35
|
+
*
|
|
36
|
+
* 命名约定:分片文件名**不带数字序号**(顺序只由本表这一处权威声明)。
|
|
37
|
+
* 序号前缀看似方便,实则会漂移——重排/插片时新旧序号并存,扫目录看到的顺序
|
|
38
|
+
* 与真实拼接顺序不一致,比没有序号更坏。顺序信息集中在 PART_ORDER +
|
|
39
|
+
* 每个分片头注释的「第 N/14 片」锚点,改序只改这两处。
|
|
35
40
|
*/
|
|
36
41
|
export const PART_ORDER = [
|
|
37
|
-
'
|
|
38
|
-
'
|
|
39
|
-
'
|
|
40
|
-
'
|
|
41
|
-
'
|
|
42
|
-
'
|
|
43
|
-
'
|
|
44
|
-
'
|
|
45
|
-
'
|
|
46
|
-
'
|
|
47
|
-
'
|
|
48
|
-
'
|
|
49
|
-
'
|
|
50
|
-
'
|
|
42
|
+
'loader.js', // [1] loader + factory 头 + require + NS(必须首片)
|
|
43
|
+
'const.js', // [2] 常量区(BUSY/维度表/超时/样式串)
|
|
44
|
+
'utils.js', // [3] 工具区(ensureCss/getJson/postJson/tokenConfigured/localGet…)
|
|
45
|
+
'icons.js', // [4] 图标区
|
|
46
|
+
'account.js', // [5] 账号信息 Tab
|
|
47
|
+
'browser.js', // [6] 目录选择器
|
|
48
|
+
'repo.js', // [7] 仓库管理卡
|
|
49
|
+
'npm.js', // [7续] NPM 面板(账号卡 + 装包表单 + npm 凭据字段)
|
|
50
|
+
'audit.js', // [8] 审计 Tab
|
|
51
|
+
'settings.js', // [9] 设置 Tab
|
|
52
|
+
'page.js', // [10] 页面装配(GitPushPage)
|
|
53
|
+
'controller.js', // [11] Controller:状态机 + 数据加载
|
|
54
|
+
'actions.js', // [11续] Controller:动作注入
|
|
55
|
+
'apply.js', // [12] 收尾:注册 settings.section + factory 返回(必须末片)
|
|
51
56
|
];
|
|
52
57
|
|
|
53
58
|
/** 读出全部分片内容(缺片直接报错,避免拼出半份产物当成功)。 */
|
package/scripts/check.mjs
CHANGED
|
@@ -83,6 +83,74 @@ try {
|
|
|
83
83
|
console.error(`✗ 分片构建校验失败:${e.message}`);
|
|
84
84
|
}
|
|
85
85
|
|
|
86
|
+
// ── 层边界门禁(2026-10-24)────────────────────────────────────────────
|
|
87
|
+
// 背景:审计引擎与提交推送**决定不拆成两个 npm 包**(拆包的持续成本——双包版本同步、
|
|
88
|
+
// 固定发布顺序、依赖范围——换不到真实收益:外部使用者要的是「提交前拦截」这个整体,
|
|
89
|
+
// 而「脱离 DSH 跑审计」已由 cli.mjs 的独立 CLI 覆盖)。
|
|
90
|
+
// 但不拆包不等于放弃边界:审计层对 git 层是**实测零依赖**,这个事实一旦被顺手 import
|
|
91
|
+
// 侵蚀就再也回不来(历史包袱太重 = 不可逆)。所以把它钉成门禁。
|
|
92
|
+
// 不变量:
|
|
93
|
+
// ① 审计层任何文件都不得 import git/npm/commit-push 层(方向唯一:git → audit);
|
|
94
|
+
// ② 反向接缝数量有预算上限——允许存在(提交门禁必须调审计),但要能看见它在膨胀。
|
|
95
|
+
const AUDIT_DIRS = new Set(['ast', 'audit', 'audit-rules', 'checks', 'exempt', 'rule', 'score']);
|
|
96
|
+
const GIT_DIRS = new Set(['git', 'npm']);
|
|
97
|
+
const GIT_TOP = new Set(['commit-push.js']);
|
|
98
|
+
const AUDIT_TOP = new Set(['audit-defaults.js', 'skip-dirs.js']);
|
|
99
|
+
/** 反向接缝预算:实测 7 处(commit-push 3 + git/{ignore,repos,sensitive} 4);上调需写明理由。 */
|
|
100
|
+
const SEAM_BUDGET = 7;
|
|
101
|
+
|
|
102
|
+
const layerOf = (rel) => {
|
|
103
|
+
const top = rel.split('/')[0];
|
|
104
|
+
if (rel.includes('/') && AUDIT_DIRS.has(top)) return 'AUDIT';
|
|
105
|
+
if (rel.includes('/') && GIT_DIRS.has(top)) return 'GIT';
|
|
106
|
+
if (!rel.includes('/') && GIT_TOP.has(rel)) return 'GIT';
|
|
107
|
+
if (!rel.includes('/') && AUDIT_TOP.has(rel)) return 'AUDIT';
|
|
108
|
+
return 'OTHER';
|
|
109
|
+
};
|
|
110
|
+
|
|
111
|
+
let boundaryViolations = 0;
|
|
112
|
+
const seams = [];
|
|
113
|
+
for (const f of files) {
|
|
114
|
+
const rel = f.replace(ROOT + '/', '');
|
|
115
|
+
if (!rel.startsWith('lib/')) continue;
|
|
116
|
+
const inner = rel.slice('lib/'.length);
|
|
117
|
+
if (layerOf(inner) !== 'AUDIT') continue;
|
|
118
|
+
let src = '';
|
|
119
|
+
try { src = readFileSync(f, 'utf8'); } catch { continue; }
|
|
120
|
+
for (const m of src.matchAll(/from\s+['"](\.[^'"]+)['"]/g)) {
|
|
121
|
+
const target = join(dirname(f), m[1]).replace(ROOT + '/lib/', '');
|
|
122
|
+
if (layerOf(target) === 'GIT') {
|
|
123
|
+
boundaryViolations++;
|
|
124
|
+
console.error(`✗ 层边界违规:审计层 lib/${inner} import 了 git 层 ${m[1]}(审计引擎解耦)`);
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
// 反向接缝统计(允许,但要可见)
|
|
129
|
+
for (const f of files) {
|
|
130
|
+
const rel = f.replace(ROOT + '/', '');
|
|
131
|
+
if (!rel.startsWith('lib/')) continue;
|
|
132
|
+
const inner = rel.slice('lib/'.length);
|
|
133
|
+
if (layerOf(inner) !== 'GIT') continue;
|
|
134
|
+
let src = '';
|
|
135
|
+
try { src = readFileSync(f, 'utf8'); } catch { continue; }
|
|
136
|
+
for (const m of src.matchAll(/from\s+['"](\.[^'"]+)['"]/g)) {
|
|
137
|
+
const target = join(dirname(f), m[1]).replace(ROOT + '/lib/', '');
|
|
138
|
+
if (layerOf(target) === 'AUDIT') seams.push(`${inner} → ${target}`);
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
if (boundaryViolations) {
|
|
142
|
+
fail += boundaryViolations;
|
|
143
|
+
console.error(`✗ 层边界:${boundaryViolations} 处违规——审计层不得依赖 git/npm/commit-push`);
|
|
144
|
+
} else {
|
|
145
|
+
console.log(`✔ 层边界:审计层对 git 层 0 依赖(解耦成立)`);
|
|
146
|
+
}
|
|
147
|
+
if (seams.length > SEAM_BUDGET) {
|
|
148
|
+
fail++;
|
|
149
|
+
console.error(`✗ 反向接缝 ${seams.length} 处 > 预算 ${SEAM_BUDGET}:提交门禁调审计是必需的,但膨胀说明边界在糊掉——要么收敛,要么改预算并写明理由`);
|
|
150
|
+
} else {
|
|
151
|
+
console.log(`✔ 反向接缝(git → audit,唯一耦合面):${seams.length}/${SEAM_BUDGET} 处`);
|
|
152
|
+
}
|
|
153
|
+
|
|
86
154
|
console.log(`\n${files.length - fail}/${files.length} 文件语法通过`);
|
|
87
155
|
console.log(`${jsonFiles.length - jsonFail}/${jsonFiles.length} 个 JSON 可解析`);
|
|
88
156
|
process.exitCode = (fail > 0 || jsonFail > 0) ? 1 : 0;
|
package/scripts/cpu-sample.mjs
CHANGED
|
File without changes
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
// dsh-skip-quality: 本文件只生成**静态自检页**(用真实 CSS 拼一个最小复现,供人目测布局),
|
|
2
|
+
// 其中的按钮是布局样本、不承担交互,未绑事件属预期(规则判定无误,属「判对但不需要」)。
|
|
3
|
+
/**
|
|
4
|
+
* 目录选择器布局自检页生成器(无依赖、离线)。
|
|
5
|
+
*
|
|
6
|
+
* 为什么需要:选择器弹窗的「条目多时被压扁」是**纯布局缺陷**——CSS 文本看着没问题
|
|
7
|
+
* (`max-height` + `overflow-y:auto` 都在),只有真实渲染才暴露。实测 73 条目录在
|
|
8
|
+
* 1080px 视口下,行高从应有的 27px 被压到 10px、容器根本不滚动,而任何
|
|
9
|
+
* 「断言 CSS 里有某条声明」的单元测试都会通过。
|
|
10
|
+
*
|
|
11
|
+
* 本脚本用**真实 CSS**(直接从 lib/client-parts/const.js 抽取 .dshgp_* 规则)拼一个
|
|
12
|
+
* 最小复现页:只有 mask/dialog/path/up/list/foot 六层与 N 个目录行。
|
|
13
|
+
* 在浏览器里打开即可目测;配合一段测量脚本可拿到行高/可滚动性等硬指标。
|
|
14
|
+
*
|
|
15
|
+
* 用法:
|
|
16
|
+
* node scripts/picker-repro.mjs # 生成 /tmp/dshgp-picker-repro.html(默认 73 条)
|
|
17
|
+
* node scripts/picker-repro.mjs --count 300 # 指定条目数
|
|
18
|
+
* node scripts/picker-repro.mjs --out <路径>
|
|
19
|
+
* node scripts/picker-repro.mjs --serve # 生成后用本机 http 起服务并打印地址
|
|
20
|
+
*
|
|
21
|
+
* 判读标准(在浏览器控制台跑 MEASURE_SNIPPET):
|
|
22
|
+
* rowHeight 应 ≈ 26-28px(12px 字 + 上下 5px padding + 行高)
|
|
23
|
+
* listScrollable true(条目超容器时必须能滚,而不是压扁)
|
|
24
|
+
* footerInViewport true(「选择当前目录」必须留在视口内)
|
|
25
|
+
*/
|
|
26
|
+
import { readFileSync, writeFileSync } from 'node:fs';
|
|
27
|
+
import { join, dirname } from 'node:path';
|
|
28
|
+
import { fileURLToPath } from 'node:url';
|
|
29
|
+
import { createServer } from 'node:http';
|
|
30
|
+
|
|
31
|
+
const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
|
|
32
|
+
const CONST_FILE = join(ROOT, 'lib', 'client-parts', 'const.js');
|
|
33
|
+
const DEFAULT_OUT = '/tmp/dshgp-picker-repro.html';
|
|
34
|
+
const DEFAULT_COUNT = 73;
|
|
35
|
+
|
|
36
|
+
/** 从 const.js 抽取全部 .dshgp_* 规则原文(保证自检页与真实样式同源)。 */
|
|
37
|
+
export function extractCss(src = readFileSync(CONST_FILE, 'utf8')) {
|
|
38
|
+
return [...src.matchAll(/'\.(dshgp_[a-z0-9_]+)\{([^}]*)\}'/g)]
|
|
39
|
+
.map((m) => `.${m[1]}{${m[2]}}`)
|
|
40
|
+
.join('\n');
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/** 生成复现页 HTML。 */
|
|
44
|
+
export function buildReproHtml({ count = DEFAULT_COUNT, css = extractCss() } = {}) {
|
|
45
|
+
const rows = Array.from({ length: count }, (_, i) => {
|
|
46
|
+
const name = `项目目录-${String(i + 1).padStart(2, '0')}-很长的中文目录名用于测试挤压`;
|
|
47
|
+
return `<div class="dshgp_browsedir" data-path="/x/${name}">📁 ${name}</div>`;
|
|
48
|
+
}).join('');
|
|
49
|
+
// 暗色变量只是为了目测接近真实主题,不参与布局判定
|
|
50
|
+
const vars = ':root{--dsw-alias-border-l4:#444;--dsw-alias-border-l2:#333;'
|
|
51
|
+
+ '--dsw-alias-bg-layer-3:#1b1b2a;--dsw-alias-bg-layer-2:#222;--dsw-alias-bg-base:#111;'
|
|
52
|
+
+ '--dsw-alias-label-primary:#eee;--dsw-alias-label-secondary:#aaa;'
|
|
53
|
+
+ '--dsw-alias-label-tertiary:#888;--dsw-alias-brand-primary:#7c5cff}';
|
|
54
|
+
return '<!doctype html><meta charset="utf-8"><title>picker repro</title>'
|
|
55
|
+
+ `<style>${vars}${css}</style>`
|
|
56
|
+
+ '<body style="margin:0;height:100vh;background:#0d0d14">'
|
|
57
|
+
+ '<div class="dshgp_browsemask"><div class="dshgp_browsedialog">'
|
|
58
|
+
+ '<div class="dshgp_browsehead"><span class="dshgp_browsetitle">选择目录</span>'
|
|
59
|
+
+ '<button type="button" class="dshgp_browseclose">✕</button></div>'
|
|
60
|
+
+ '<div class="dshgp_browsepath">/volume1/VirtualDSM/DeepSeekHarness/工作区</div>'
|
|
61
|
+
+ '<div class="dshgp_browseup">⬆ 上级目录</div>'
|
|
62
|
+
+ `<div class="dshgp_browselist" id="list">${rows}</div>`
|
|
63
|
+
+ '<div class="dshgp_browsefoot"><button type="button" class="dshgp_keybtn">选择当前目录</button></div>'
|
|
64
|
+
+ '</div></div></body>';
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
/** 浏览器控制台测量脚本(返回硬指标 JSON)。 */
|
|
68
|
+
export const MEASURE_SNIPPET = `(() => {
|
|
69
|
+
const list = document.getElementById('list');
|
|
70
|
+
const rows = [...list.children];
|
|
71
|
+
const lb = list.getBoundingClientRect();
|
|
72
|
+
const f = rows[0].getBoundingClientRect();
|
|
73
|
+
const foot = document.querySelector('.dshgp_browsefoot').getBoundingClientRect();
|
|
74
|
+
return {
|
|
75
|
+
rows: rows.length,
|
|
76
|
+
rowHeight: Math.round(f.height * 10) / 10,
|
|
77
|
+
rowFlexShrink: getComputedStyle(rows[0]).flexShrink,
|
|
78
|
+
listClientH: list.clientHeight,
|
|
79
|
+
listScrollH: list.scrollHeight,
|
|
80
|
+
listScrollable: list.scrollHeight > list.clientHeight,
|
|
81
|
+
visibleRows: Math.round(lb.height / f.height),
|
|
82
|
+
footerInViewport: foot.bottom <= innerHeight,
|
|
83
|
+
};
|
|
84
|
+
})()`;
|
|
85
|
+
|
|
86
|
+
function argOf(name, def) {
|
|
87
|
+
const i = process.argv.indexOf(name);
|
|
88
|
+
return i >= 0 && process.argv[i + 1] ? process.argv[i + 1] : def;
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
function main() {
|
|
92
|
+
const count = Number(argOf('--count', String(DEFAULT_COUNT))) || DEFAULT_COUNT;
|
|
93
|
+
const out = argOf('--out', DEFAULT_OUT);
|
|
94
|
+
const html = buildReproHtml({ count });
|
|
95
|
+
writeFileSync(out, html, 'utf8');
|
|
96
|
+
console.log(`✅ 已生成复现页:${out}(${count} 条目录,${html.length} 字节)`);
|
|
97
|
+
console.log('');
|
|
98
|
+
console.log('浏览器打开后,控制台粘贴以下脚本取硬指标:');
|
|
99
|
+
console.log(MEASURE_SNIPPET);
|
|
100
|
+
console.log('');
|
|
101
|
+
console.log('判读:rowHeight≈26-28px · listScrollable=true · footerInViewport=true');
|
|
102
|
+
if (!process.argv.includes('--serve')) return 0;
|
|
103
|
+
const port = Number(argOf('--port', '31399'));
|
|
104
|
+
const server = createServer((req, res) => {
|
|
105
|
+
res.writeHead(200, { 'content-type': 'text/html; charset=utf-8' });
|
|
106
|
+
res.end(html);
|
|
107
|
+
});
|
|
108
|
+
server.listen(port, '127.0.0.1', () => console.log(`\n服务已启动:http://127.0.0.1:${port}/(Ctrl+C 结束)`));
|
|
109
|
+
return null; // 挂起,等待手动结束
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
|
|
113
|
+
const code = main();
|
|
114
|
+
if (code !== null) process.exitCode = code;
|
|
115
|
+
}
|
|
File without changes
|
package/skills/dsh-repo-index.md
CHANGED
|
@@ -12,7 +12,7 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
|
|
|
12
12
|
|
|
13
13
|
## 一、权威文件
|
|
14
14
|
|
|
15
|
-
插件配置目录下的 `git-push/dsh-repo-index.
|
|
15
|
+
插件配置目录下的 `git-push/dsh-repo-index.jsonl`(JSONL,每行一个仓库;解析顺序:`DSH_HOME/git-push/` → `~/.dsh/git-push/`)
|
|
16
16
|
|
|
17
17
|
| 事实 | 说明 |
|
|
18
18
|
|------|------|
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: guide-audit
|
|
3
|
-
description: dsh-git-push 代码审计:三个入口、审计范围、10
|
|
4
|
-
whenToUse: 要审计仓库、看质量分与问题明细、加停审计规则、豁免误报、查审计 API
|
|
5
|
-
updated: 2026-10-
|
|
3
|
+
description: dsh-git-push 代码审计:三个入口、审计范围、10 维度评分、规则包槽位、豁免机制、严重级与报告聚合,以及低成本整改(提取公共函数一次动作多规则清零)。处理代码审计/质量评分/整改提分类请求时加载。
|
|
4
|
+
whenToUse: 要审计仓库、看质量分与问题明细、加停审计规则、豁免误报、查审计 API 时;要把审计分从 B 提到 A、低成本消 warning、规划重构整改时。
|
|
5
|
+
updated: 2026-10-18
|
|
6
6
|
generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -144,6 +144,45 @@ console.log(x); // dsh-skip-residue: 本行为刻意保留的调试输出样本
|
|
|
144
144
|
- `groupBy` 四维度:`rule`(规则类型,默认)/ `file` / `severity` / `slot`(规则包);`groups` 按条数降序,每组带一条 `sample`;`severity` 白名单过滤 + `top` 截断(`0` = 全部),过滤后条数见 `filtered`。
|
|
145
145
|
- `exemptStats` 输出本次被豁免的类型与数量;`blocked` 直接列出 blocker 明细(文件 / 行 / 规则 / 消息);YAML 报告:HTTP `withYaml=true` → `yaml` 字段,工具 `includeFindings=true` 时含 `yaml`。
|
|
146
146
|
|
|
147
|
+
### 13. 低成本整改:提取公共函数 = 一次动作多规则清零
|
|
148
|
+
|
|
149
|
+
**先看计分口径(决定性价比)**
|
|
150
|
+
|
|
151
|
+
| 口径 | 事实 | 含义 |
|
|
152
|
+
|---|---|---|
|
|
153
|
+
| 计数去重 | warning/info 按「规则 × 维度 × 文件」每文件每规则只计 1 次(blocker 每次计 2) | 同一文件同类问题修**一个代表点**,该文件对该规则的扣分即清零;warning 列表条数不受去重影响(想清空列表要逐条修或逐条豁免) |
|
|
154
|
+
| scoreImpact | `0` 的 finding 不计分(魔数、嵌套深度、重复字面量、低风险 io-risk 等) | 冲分先修 `scoreImpact=1` 的规则;`0` 的只影响 warning 条数 |
|
|
155
|
+
| 豁免等价 | 豁免标记会让 finding 直接消失、不计数 | 「修代码」与「加豁免」在**计分上等价**;区别只在代码质量本身与列表展示 |
|
|
156
|
+
| 对数衰减 | 单维度 `max(0.1, 10 - k·ln(1+问题数))`(k:安全 1.5 / 可读·可维护·健壮 1.3 / 性能 1.1) | 计数从 20 降到 10 的收益远大于 10 降到 0;先处理计数高的维度 |
|
|
157
|
+
|
|
158
|
+
**为什么提取公共函数最划算**
|
|
159
|
+
|
|
160
|
+
函数太长 / 嵌套太深 / 圈复杂度高 / 重复调用 / 重复代码,根因都是「没抽出公共函数」。抽一次,多条规则同时消失:
|
|
161
|
+
|
|
162
|
+
| 规则 | 覆盖方式 |
|
|
163
|
+
|---|---|
|
|
164
|
+
| max-cyclomatic-complexity、max-nesting-depth、max-function-length | 直接:拆成子函数 + 早返回 |
|
|
165
|
+
| repeat-identical-call | 直接:重复调用合并进一个 helper |
|
|
166
|
+
| vague-function-name、variable-min-length、vague-variable-name | 顺带:提取时给函数/参数/局部变量起具名;契约要求导出名不变时用 `export { 具名实现 as run }`(模块仍只导出约定名) |
|
|
167
|
+
| magic-number-smart、duplicate-constant-def、no-repeated-hardcoded-literals | 顺带:提取时把字面量提成命名常量 |
|
|
168
|
+
| mkdir-before-write | 顺带:写操作移进公共函数后,写目标来自形参 ⇒ 规则语义豁免 |
|
|
169
|
+
| comment/no-date、hardcoded-absolute-path、io-risk、memory-bomb | **不覆盖**:需单独处理(删日期 / 提候选常量+行级豁免 / 异步化或行级豁免 / 接受) |
|
|
170
|
+
|
|
171
|
+
实测(一次全量整改,29 文件):评分 83.0/B → 97.9/A,warning 99 → 5;其中「提取函数 + 顺带命名/常量化」覆盖约 55/99 条,其余 44 条是注释/路径/IO/内存类。
|
|
172
|
+
|
|
173
|
+
**危险级不高的前提(照做才安全)**
|
|
174
|
+
|
|
175
|
+
1. 只搬运结构、不改行为:判断、异常、短路 return、错误处理边界保持原样。
|
|
176
|
+
2. 三类**不拆、改豁免**:
|
|
177
|
+
- 跨回调共享闭包状态(如子进程 stdout/stderr/error/close/超时五路共享 settled 标志);
|
|
178
|
+
- 字符级扫描器(字符串/注释/括号三态一次遍历,拆开反而割裂状态机);
|
|
179
|
+
- 单调用点且拆完没有更清楚(过度抽象)。
|
|
180
|
+
3. 同步改异步会外溢:io-risk 真修成 async 会波及整条同步调用链(CLI/测试),多数场景行级 `dsh-skip-residue` 更划算。
|
|
181
|
+
4. 拆完必须复跑审计:新函数名/变量名可能触发新规则(实测:`handleXxxCommand` 被 io-risk 判成「请求处理路径」,把整文件同步 IO 从 low 升到 medium/high;局部变量取通用词名(如 result)会触发 vague-variable-name)。改名(如 `dispatchXxxCommand` / `actionResult`)后恢复。
|
|
182
|
+
5. 验证闭环:`node --test` + 重新全量审计,确认分数只升不降、无新 blocker。
|
|
183
|
+
|
|
184
|
+
**操作顺序**:`groupBy=rule` 看明细 → 按「文件 × 规则」挑代表点 → 提取函数/常量/改名 → 复跑审计 → 只剩 `scoreImpact=1` 的顽固项时才逐条修或逐条豁免。
|
|
185
|
+
|
|
147
186
|
## 三、边界与坑
|
|
148
187
|
|
|
149
188
|
| 现象 | 原因 | 处理 |
|
|
@@ -165,3 +204,67 @@ console.log(x); // dsh-skip-residue: 本行为刻意保留的调试输出样本
|
|
|
165
204
|
| skills/guide/guide-cli-scripts.md | 独立 CLI 与脚本(含 `git-sluice`、`rule-switch`) |
|
|
166
205
|
| skills/guide/guide-slash-completion.md | 输入框斜杠命令(`/git-audit`、`/link-check`) |
|
|
167
206
|
| skills/guide/guide-clone-repos.md | 克隆仓库与本地仓库扫描 |
|
|
207
|
+
|
|
208
|
+
## 14. 按插件架构修订规则,且按性价比取舍误报
|
|
209
|
+
|
|
210
|
+
规则不是通用前端 linter:它主要服务于 **DSH 插件**这种架构,判定要贴合插件真实形态,
|
|
211
|
+
否则「按通用项目写的判据」在插件上系统性失真。
|
|
212
|
+
|
|
213
|
+
**已按插件架构落地的适配**
|
|
214
|
+
|
|
215
|
+
| 插件架构事实 | 通用判据为何失真 | 规则怎么改 |
|
|
216
|
+
|---|---|---|
|
|
217
|
+
| 客户端是**构建产物**(`dsh.client` 指向单文件) | 产物行数天然超阈值 | `dsh-client-entry` 作用域降级为 info(仍报不扣分,不用 exempt 藏掉事实) |
|
|
218
|
+
| 源码按**分片**维护(`lib/client-parts/**` → 拼接) | 分片是片段,单文件语法都不成立;创建元素与绑定事件可能在不同分片 | 标准 `client-parts/` 由 exclude_dirs 跳过且规模规则按 `dsh-client-fragment` 降级;自定义分片目录由 button-bind 降级 info(完整判定交给产物) |
|
|
219
|
+
| 插件 UI 常用**事件委托** + 原生触发(label.click() 开文件框) | 只认 `addEventListener('click')` ⇒ 表单控件/文件框全被判未绑 | 按元素类型分流:button 要 click 类;input 接受 change/input/submit 等;`type=file` 有程序化触发即视为原生接好 |
|
|
220
|
+
| 测试聚合文件(每条 `rec(...)` 一个用例) | 「文件长」被判臃肿,且只认 `function` ⇒ 箭头用例全部计 0 行 | 识别箭头/方法简写/asynс 体;最大函数≤阈值 → 聚合型 info;无函数时文案改成「顶层语句堆叠」而不是「藏着超大函数」 |
|
|
221
|
+
|
|
222
|
+
**性价比取舍(不追求零误报)**
|
|
223
|
+
|
|
224
|
+
先算「修判定的成本 vs 这类误报的出现频率与危害」,再决定:
|
|
225
|
+
|
|
226
|
+
- **值得修**:判定明确、可静态判定、且形态高频——如上面四类(事件类型、函数形态、产物/分片、聚合型文案)。
|
|
227
|
+
这类修一次,整类消失。
|
|
228
|
+
- **不值得修(用豁免兜底)**:需要数据流/跨文件调用图才能证伪的判定——例如「事件委托是否真的覆盖某个
|
|
229
|
+
`createElement` 出来的按钮」、跨文件(非分片)绑定、运行时动态注入。做精确分析的成本远超收益,
|
|
230
|
+
保留启发式判定 + `dsh-skip-quality` 文件头豁免。
|
|
231
|
+
- **不算误报**:规则判对了事实、只是不想改(如自包含 151 行组件、静态自检页的装饰按钮)——
|
|
232
|
+
走豁免,不要改判定逻辑(否则会连带放过真问题)。
|
|
233
|
+
|
|
234
|
+
**豁免的前提**:标记必须**真能生效**。历史上多次出现「规则 exemptHint 写着 `dsh-skip-quality`,
|
|
235
|
+
但该 kind 不在任何标记的 blocked 里」⇒ 用户按提示写了完全不生效(button-bind 就是 2026-10-24 补上的)。
|
|
236
|
+
新增 kind 时同步检查 `exemptHintForFinding({kind})` 是否返回标记。
|
|
237
|
+
|
|
238
|
+
**判定引用范围时 grep 要 `-i`**:同一概念会以 `camelCase`/`PascalCase`/`SCREAMING_CASE`/`snake_case`
|
|
239
|
+
多种形态出现,小写搜会漏(实测:搜 `partFilter` 漏掉 `setPartFilter`,误判「零引用」而删掉底层实现)。
|
|
240
|
+
注意这只针对「人工核查引用」;规则内部的**标识符匹配必须保持大小写敏感**(JS/Python 本身区分大小写,
|
|
241
|
+
放宽只会引入新误报)。
|
|
242
|
+
|
|
243
|
+
## 15. 忽略链路(.gitignore / .auditignore)的测试纪律
|
|
244
|
+
|
|
245
|
+
**这块历史上反复回归,而且每次都不是判定逻辑写错,而是接线层断掉。** 已知三次形态:
|
|
246
|
+
|
|
247
|
+
| 回归形态 | 症状 | 为什么内部函数测试挡不住 |
|
|
248
|
+
|---|---|---|
|
|
249
|
+
| 以**空 stdin** 调 `check-ignore`,从未传文件路径 | 忽略集恒空 ⇒ 全仓文件都进审计 | `buildIgnoreSet` 内部逻辑没改,改的是它的输入 |
|
|
250
|
+
| 大仓库降级:枚举全部文件被改成目录级判定 | 文件级规则(单个文件名)失效 | 降级是**性能分支**,内部单测仍走全量分支 |
|
|
251
|
+
| 调用方**漏传 `gitIgnoreRoot`** | 函数默认值 `null` = 不判定忽略 ⇒ 忽略完全不生效 | 函数行为没变,变的是调用参数 |
|
|
252
|
+
|
|
253
|
+
**纪律**:
|
|
254
|
+
|
|
255
|
+
- 忽略相关改动必须跑**端到端**(`auditFull` / `runAudit`),不能只测 `collectTextFiles`。
|
|
256
|
+
既有 `test-collector-ignore.mjs` / `test-auditignore.mjs` 都只测内部函数,对上面三类天然失明;
|
|
257
|
+
端到端守门员是 `test/test-ignore-e2e.mjs`(三条链路 + 对照组)。
|
|
258
|
+
- **必须有对照组**:断言「忽略的文件没出现」时,同时断言「该被审的文件出现了」。
|
|
259
|
+
否则「全部文件都被排除」也会让测试假通过。
|
|
260
|
+
- 三条链路各自要有一条用例:full(走 `gitIgnoreRoot`)、diff(走 `collectChangedFiles` 独立路径)、
|
|
261
|
+
非 git 目录(git check-ignore 不可用,靠 `parseGitignore` 纯 JS 兜底)。
|
|
262
|
+
- 样本要**入库**为固定 fixture(`test/fixtures/ignore-e2e/`),不要测试里现造:
|
|
263
|
+
现造样本会随实现漂移,也让「什么叫被忽略」没有唯一答案。
|
|
264
|
+
样本文件名用 `.js.fixture` / `.rules` 后缀——若直接叫 `gib.js` 且同目录放 `.gitignore`,
|
|
265
|
+
这两份样本自己就会被忽略而**无法入库**(自我反噬)。
|
|
266
|
+
- 新增/修改忽略相关代码后,用「把 `gitIgnoreRoot` 强制改 `null`」自证测试会红——这是最容易复发的接线断点。
|
|
267
|
+
|
|
268
|
+
**排查时的第一个坑(我踩过)**:直接调 `collectTextFiles(dir, { repoPath: dir })` 会得到
|
|
269
|
+
「忽略全失效」的假象——因为参数名是 `gitIgnoreRoot`,传错就等于显式关掉忽略判定。
|
|
270
|
+
复现前先确认自己的探针参数与真实调用方一致(见 `lib/audit/orchestrate.js` 的调用处)。
|
|
@@ -20,7 +20,7 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
|
|
|
20
20
|
| `ruleset [槽位...]` | 编译规则包并输出统计 | 槽位名(可多个) |
|
|
21
21
|
| `scan <root>` | 全量扫描目录(非 git 目录也能查) | `--depth N` |
|
|
22
22
|
| `repos <root>` | 扫描本地 git 仓库(尊重 `.gitignore`,被忽略目录整棵跳过) | `--depth N`、`--max N`、`--json` |
|
|
23
|
-
| `index <root>` | 重建仓库索引 `dsh-repo-index.
|
|
23
|
+
| `index <root>` | 重建仓库索引 `dsh-repo-index.jsonl` | `--owner <账号>`、`--depth N`、`--max N`、`--offline`、`--json` |
|
|
24
24
|
| `audit <root>` | 审计并输出质量评分与 findings | `--full`、`--level quick\|standard\|deep`、`--ruleset <目录>`、`--weights <JSON>`、`--include-ignored`、`--json` |
|
|
25
25
|
| `commit <repo>` | 提交(可选推送) | `-m <msg>`、`--push`/`--no-push`、`--dry-run`、`--force`、`--req-confirm`、`--json` |
|
|
26
26
|
| `link-check <路径>` | 检查 md/文本里的链接有效性(只 warning) | — |
|
|
@@ -22,7 +22,7 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
|
|
|
22
22
|
| 本地仓库扫描 | `git_scan` 逐层下钻列仓库:分支 / 远端(脱敏)/ 未提交数 / 最近提交 / 领先落后 |
|
|
23
23
|
| 远端仓库管理 | `git_remote_create` 建仓(默认 private,已存在则复用并设 origin);`git_set_visibility` 切 public/private |
|
|
24
24
|
| 账号与配额 | 账号状态(离线读快照)/ 在线校验 / API 配额查询(`/rate_limit`,不消耗配额) |
|
|
25
|
-
| 仓库索引 | 推送成功、云端加载、本地扫描时维护 `dsh-repo-index.
|
|
25
|
+
| 仓库索引 | 推送成功、云端加载、本地扫描时维护 `dsh-repo-index.jsonl`;本地仓库列表据此标注每个仓库的 GitHub 归属 |
|
|
26
26
|
|
|
27
27
|
## 二、怎么用(工具 + HTTP 接口参数表与返回字段)
|
|
28
28
|
|
|
@@ -169,5 +169,5 @@ git_set_visibility({ repo: "<本地仓库路径>", visibility: "private" })
|
|
|
169
169
|
| `git_commit_push` | 克隆完成后的提交推送(审计门禁 + 凭据注入);推送成功会重建仓库索引 |
|
|
170
170
|
| `git_sluice` | 在克隆下来的仓库里执行 log/diff/branch 等 git 命令(凭据自动注入) |
|
|
171
171
|
| `git_account_check` / `git_cred_env` | 克隆私有库前先确认 token/SSH 可用;外部命令取凭据环境前缀 |
|
|
172
|
-
| `dsh-repo-index.
|
|
172
|
+
| `dsh-repo-index.jsonl` | 仓库索引(权威源码索引,存插件配置目录 `DSH_HOME/git-push/`):记录每个项目的仓库地址、可见性、恢复命令 `cloneCmd`、skills 与本地 `path`,`version` 恒为 1、`generatedAt` 每次刷新;源码丢失时按它 `git_clone` 恢复,本地列表据此标注仓库归属 |
|
|
173
173
|
| 侧边栏「账号信息 → 仓库管理」 | 本地子选项卡按索引标注归属并可 `push`;云端子选项卡「加载仓库列表」选目录后走同一套后台克隆 |
|
|
@@ -107,7 +107,7 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
|
|
|
107
107
|
|
|
108
108
|
| 时机 | 账号信息 | 本地仓库列表 |
|
|
109
109
|
|---|---|---|
|
|
110
|
-
| 插件启动(侧边栏加载) | 离线读 `account-status.json` | 离线读 `dsh-repo-index.
|
|
110
|
+
| 插件启动(侧边栏加载) | 离线读 `account-status.json` | 离线读 `dsh-repo-index.jsonl` |
|
|
111
111
|
| 云端 push 完成后 | 离线读(push 时已在线更新 json) | 离线读(push 时已重建索引) |
|
|
112
112
|
| 手动刷新 | `重新检测` = 在线校验写 json,再离线读回 | `扫描` = 独立进程后台离线扫描,逐条追加 |
|
|
113
113
|
|
|
@@ -137,7 +137,7 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
|
|
|
137
137
|
|---|---|
|
|
138
138
|
| `config.json` | 全部设置与凭据真源(0600):开关、扫描范围、文件上限、权重覆盖、规则包顺序、推送通道/门禁、自动推送、`githubToken`、`sshPub`,以及可选的 `injectUsageText` |
|
|
139
139
|
| `account-status.json` | 账号快照:登录名、是否登录、token/SSH 各自有效性与校验时间 |
|
|
140
|
-
| `dsh-repo-index.
|
|
140
|
+
| `dsh-repo-index.jsonl` | 仓库索引:本地/云端仓库的归属、可见性、路径、默认分支、领先/落后等(自动生成,请勿手改) |
|
|
141
141
|
| `scan-live.json` | 本地扫描进度:`version` / 已发现仓库 / 是否完成 |
|
|
142
142
|
| `tools.json` | 工具探测结果(工具名 → 本机实测路径) |
|
|
143
143
|
| `settings-ui.log` | 侧边栏每次保存设置的追加日志(凭据值打码) |
|
|
@@ -18,4 +18,4 @@ generatedBy: deepseek-official/deepseek-v4-flash · EIGHTfs 2026-10-02
|
|
|
18
18
|
## 已内置化
|
|
19
19
|
|
|
20
20
|
- 开发者要求清单 → `lib/user-requirements.json`(随插件分发;v2 未移植,待验收)
|
|
21
|
-
- 仓库索引 → 废弃 md 表格,改用 JSON 索引(生成于插件配置目录的 `dsh-repo-index.
|
|
21
|
+
- 仓库索引 → 废弃 md 表格,改用 JSON 索引(生成于插件配置目录的 `dsh-repo-index.jsonl`)
|