dsh-git-push 3.0.0 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/README.md +76 -48
  2. package/cli.mjs +4 -3
  3. package/lib/app/apply.js +11 -9
  4. package/lib/app/command-registry.js +4 -2
  5. package/lib/app/handlers/http-constants.js +8 -0
  6. package/lib/app/handlers/preprocess.js +3 -6
  7. package/lib/app/handlers/repo-actions.js +0 -1
  8. package/lib/app/handlers/repos.js +137 -10
  9. package/lib/app/handlers/settings.js +34 -15
  10. package/lib/app/index.js +1 -1
  11. package/lib/app/inject-text.js +3 -18
  12. package/lib/app/schema.js +20 -10
  13. package/lib/app/settings-bridge.js +60 -8
  14. package/lib/app/tool-call.js +26 -22
  15. package/lib/cli/commands-vcs.mjs +35 -1
  16. package/lib/cli/shared.mjs +1 -1
  17. package/lib/client/index.js +11 -16
  18. package/lib/client-parts/git/account.js +21 -12
  19. package/lib/client-parts/git/actions.js +23 -77
  20. package/lib/client-parts/git/apply.js +8 -2
  21. package/lib/client-parts/git/browser.js +1 -1
  22. package/lib/client-parts/git/const.js +33 -1
  23. package/lib/client-parts/git/controller.js +175 -176
  24. package/lib/client-parts/git/icons.js +1 -1
  25. package/lib/client-parts/git/loader.js +1 -1
  26. package/lib/client-parts/git/npm.js +56 -37
  27. package/lib/client-parts/git/page.js +53 -1
  28. package/lib/client-parts/git/repo.js +8 -1
  29. package/lib/client-parts/git/settings.js +13 -1
  30. package/lib/client-parts/git/state.js +237 -0
  31. package/lib/client-parts/git/utils.js +1 -1
  32. package/lib/client.js +631 -312
  33. package/lib/commit-push/pre-commit-engine.js +584 -32
  34. package/lib/commit-push.js +63 -47
  35. package/lib/context/index.js +7 -5
  36. package/lib/core/config.js +1 -27
  37. package/lib/core/exec.js +2 -11
  38. package/lib/git/identity-rewrite.js +1 -1
  39. package/lib/git/index.js +1 -1
  40. package/lib/git/push.js +2 -17
  41. package/lib/git/repo-index.js +8 -3
  42. package/lib/npm/install.js +1 -1
  43. package/lib/npm/registry.js +2 -2
  44. package/lib/plugin/auto-push.js +3 -6
  45. package/lib/preprocess/providers.js +5 -1
  46. package/lib/self/index.js +1 -1
  47. package/package.json +4 -7
  48. package/skills/dev/dsh-git-push.md +9 -9
  49. package/skills/guide/guide-commit-push.md +11 -13
  50. package/skills/workflow/README.md +0 -1
  51. package/skills/workflow/task-completion-report.md +2 -2
  52. package/.auditignore +0 -30
  53. package/.gitignore +0 -43
  54. package/lib/BUGFIX-NOTES-2026-09-14.md +0 -278
  55. package/lib/app/schema-preprocess.js +0 -42
  56. package/lib/user-requirements.json +0 -15
  57. package/scripts/build-client.mjs +0 -133
  58. package/scripts/bump-version.mjs +0 -178
  59. package/scripts/check.mjs +0 -205
  60. package/scripts/doc-func.mjs +0 -212
  61. package/scripts/doc-tree.mjs +0 -458
  62. package/scripts/doc-version.mjs +0 -149
  63. package/scripts/local-registry.mjs +0 -38
  64. package/scripts/scan-version.mjs +0 -125
  65. package/scripts/version-source.mjs +0 -173
package/lib/app/index.js CHANGED
@@ -20,7 +20,7 @@ export { Config } from './schema.js';
20
20
  export { MSG_REPO_REQUIRED, name, GIT_PUSH_SETTINGS_NS } from './constants.js';
21
21
  export { setLastSlotHitStats, getLastSlotHitStats, getLastSlotHitMeta } from './slot-stats.js';
22
22
  export { listTools } from './tools.js';
23
- export { README_CHECK_HINT, buildRequirementsInjectionText, formatAuditBlock } from './inject-text.js';
23
+ export { README_CHECK_HINT, buildIdentityInjectionText, formatAuditBlock } from './inject-text.js';
24
24
  export { callTool } from './tool-call.js';
25
25
  export { adaptHttpHandler, listRuleSlots, handleHttp } from './http-handlers.js';
26
26
  export { apply } from './apply.js';
@@ -3,14 +3,13 @@
3
3
  *
4
4
  * FUNCTION_USAGE_HINT(插件功能用法注入——每个工具怎么用 + 凭据由插件托管,见需求:
5
5
  * 「注入系统提示词可以注入插件每个功能怎么用,发现好多不用插件还到处找凭据的」)、
6
- * buildRequirementsInjectionText(开发者要求清单注入,挂审计开关子开关)、
6
+ * buildIdentityInjectionText(身份告知注入,避免 AI 猜错项目归属)、
7
7
  * formatAuditBlock(审计结果块)、README_CHECK_HINT(提交前 README 核对提醒)。
8
8
  * 这些是「写进系统提示词/工具返回」的文本,与业务逻辑分开便于单独校对措辞。
9
9
  */
10
10
 
11
11
  import { networkInterfaces } from 'node:os';
12
12
  import { join } from 'node:path';
13
- import { loadRequirements } from '../git/index.js';
14
13
  import { readAccountStatus } from '../git/account-status.js';
15
14
  import { identityHintText, resolveCommitIdentity } from '../git/identity.js';
16
15
 
@@ -26,8 +25,8 @@ import { identityHintText, resolveCommitIdentity } from '../git/identity.js';
26
25
  export const FUNCTION_USAGE_HINT = [
27
26
  '【dsh-git-push 功能用法】本插件的 git 操作请直接调用下列工具,不要手敲 git/curl 绕过(插件自带审计门禁、凭据管理、推送通道选择);**工作区没有改动 / 没有新提交时也照常调用,不会报错**(详见 git_commit_push 说明),不要因为「怕它报错」而绕开插件:',
28
27
  '· git_scan —— 列工作区(含额外路径)所有 git 仓库:分支/remote/未提交与未推送数/最近活动。找「哪个仓库要提交」先用它。',
29
- '· git_commit_push —— 一键提交并推送(一次调用 = 审计(可关)→ **有改动才** commit → **有可推内容才** push;审计同步拦截,通过后 commit+push 走宿主官方后台 job,立即返回 async:true + jobId,结果完成会自动返回、无需特意查询,可继续干别的)。参数:repo=仓库绝对路径、message=提交信息(必填,但**零改动时不会被用到**)、audit、dryRun、push、force、ignorePatterns;调用前逐条核对开发者特殊要求,达标才传 requirementsConfirmed=true(**只要配置里存在开发者要求清单,任何调用都要带——与有没有改动、是否推送无关**)。如需主动查结果:job_output <jobId>(job_list/job_kill 同理)。',
30
- ' **零改动 = 正常成功路径,不是失败**(可以放心调用):工作区没改动 ⇒ 返回 ok:true + committed:false(job 状态 completed,文案写明「无需提交(正常)」);远端已最新 ⇒ ok:true + pushed:false;而「本地领先远端」的已提交内容**照样会推上去**。所以任何时候都直接用它,不要因为「没东西可提交」改去手敲 git。(**唯一例外**:配置里存在开发者要求清单时,仍要按上文带上 `requirementsConfirmed:true`——那是要求门禁,与「有没有改动」无关。)',
28
+ '· git_commit_push —— 一键提交并推送(一次调用 = 审计(可关)→ **有改动才** commit → **有可推内容才** push;审计同步拦截,通过后 commit+push 走宿主官方后台 job,立即返回 async:true + jobId,结果完成会自动返回、无需特意查询,可继续干别的)。参数:repo=仓库绝对路径、message=提交信息(必填,但**零改动时不会被用到**)、audit、dryRun、push、force、ignorePatterns。如需主动查结果:job_output <jobId>(job_list/job_kill 同理)。',
29
+ ' **零改动 = 正常成功路径,不是失败**(可以放心调用):工作区没改动 ⇒ 返回 ok:true + committed:false(job 状态 completed,文案写明「无需提交(正常)」);远端已最新 ⇒ ok:true + pushed:false;而「本地领先远端」的已提交内容**照样会推上去**。所以任何时候都直接用它,不要因为「没东西可提交」改去手敲 git。',
31
30
  '· code_audit —— 审计仓库(L0 静态检查 + 质量评分):语法/敏感信息/凭据/大文件/文档措辞;scope=full 全量;可传 ruleset 自定规则目录、weights 覆盖权重。',
32
31
  '· git_account_check —— 校验 GitHub 账号与凭据(token 在线校验 + SSH 公钥指纹),返回登录态/用户名/公钥数/套餐。想知道「现在能不能推、以谁的身份」,用它,不要自己去翻 token 文件。',
33
32
  '· git_identity_rewrite —— 提交身份历史改写:把仓库里非规范身份(工具/AI 产生的 agent@dsh.local / eightfs@local / v2-clone@local,以及账号 noreply 的旧变体)统一成登录账号规范身份。默认 dryRun 只报告;真改写要传 dryRun:false(先建备份引用,自检通过才改写),要推远端再加 push:true(force-with-lease,远端动过自动拒绝)。只处理 origin 属于登录账号的仓库。',
@@ -58,7 +57,6 @@ export const README_CHECK_HINT = [
58
57
  * 构造「开发者特殊要求」注入正文(systemPrompt 段,需开启提交前审计 + 本子开关)。
59
58
  *
60
59
  * 价值:清单常驻系统提示词,AI 一次读到即可持续遵守,不必走「提交被门禁拦截 →
61
- * 读拦截信息里的清单 → 带 requirementsConfirmed 重试」的失败往返(每次省一轮工具调用)。
62
60
  * 清单为空/未找到时返回空串(空段不注入)。
63
61
  *
64
62
  * @returns {string} 注入正文;无清单时返回空串
@@ -83,19 +81,6 @@ export function buildIdentityInjectionText() {
83
81
  + '**不要擅自改写历史**;用户要统一历史时走 git_identity_rewrite(默认 dry-run 先预览)。';
84
82
  }
85
83
 
86
- export function buildRequirementsInjectionText() {
87
- const req = loadRequirements();
88
- const identityLine = buildIdentityInjectionText();
89
- // 没有开发者要求清单时也把身份行注入(它是「AI 别猜身份」的唯一告知途径)
90
- if (!req.found || !req.items.length) return identityLine;
91
- const L = [
92
- `【dsh-git-push 开发者要求(${req.user})】调用 git_commit_push / git_remote_create 前逐条核对,全部达标才传 requirementsConfirmed: true:`,
93
- ];
94
- req.items.forEach((it, i) => L.push(`${i + 1}. ${it}`));
95
- L.push('(需要**推送**且未核对时才会被门禁拦截;零改动、或 push=false 只提交时不受影响。清单可用插件配置目录的 requirements.json 外挂覆盖)');
96
- if (identityLine) L.push(identityLine);
97
- return L.join('\n');
98
- }
99
84
 
100
85
  /**
101
86
  * 审计结果格式化为可直接说给用户的总结块(对齐 git_account_check 的 block 模式)。
package/lib/app/schema.js CHANGED
@@ -9,8 +9,6 @@
9
9
 
10
10
  import { createRequire } from 'node:module';
11
11
 
12
- // 审计侧设置键单独成文件(文件隔离阶段;展开合并后仍是同一个 Config 对象)
13
- import { auditConfigShape } from './schema-preprocess.js';
14
12
  // 引擎默认超时取单一来源(与运行期兜底共用),避免 schema 默认值漂移
15
13
  import { PRE_COMMIT_TIMEOUT_MS_DEFAULT } from './constants.js';
16
14
 
@@ -87,18 +85,30 @@ export const Config = Schema.object({
87
85
  workspaceRoot: Schema.string().default('').description('扫描根目录(空=DSH workspaceRoot)'),
88
86
  extraRepos: Schema.array(Schema.string()).default([]).description('额外仓库路径(数组)'),
89
87
  extraReposFile: Schema.string().default('').description('额外仓库清单文件(每行一个绝对路径,# 注释;运行时实时读取)'),
90
- // —— 审计侧设置键(集中在 lib/app/schema-preprocess.js,此处展开合并)——
91
- ...auditConfigShape(Schema),
92
88
  maxCloneFileMB: Schema.number().default(10).description('clone 单文件体积上限(MB),0=不限'),
93
89
  cloneConcurrency: Schema.number().default(6).description('clone 并发下载数'),
94
- // —— 提交前预处理引擎(可替换审计引擎,解耦方案 §2.1)——
95
- // 三项刻意都是「空 = 内置」而不是「空 = 关闭」:门禁不能因为漏配字段就悄悄不审计。
96
- // 注意本项是**高级文件配置**,不进 UI 设置项;解析顺序见 pre-commit-engine.js 的 resolvePreCommitConfig。
90
+ // —— 提交前预处理(可替换的预处理实现,解耦方案 §2.1)——
91
+ // 这里**只剩「跑不跑 + 用哪个引擎」**:预处理开不开是宿主自己的门禁策略,
92
+ // 而「怎么审」(扫描范围 / 权重 / 规则槽位 / 文件上限)属于预处理实现自己的配置,
93
+ // 不在本插件配置里(拆包后审计配置住在 audit-sluice 自己的 config.json)。
94
+ // 三项 command/args/timeoutMs 刻意都是「空 = 内置」而不是「空 = 关闭」:
95
+ // 门禁不能因为漏配字段就悄悄不跑。enable 才决定跑不跑。
96
+ // 解析顺序见 pre-commit-engine.js 的 resolvePreCommitConfig / resolvePreCommitEnabled。
97
97
  preCommit: Schema.object({
98
- command: Schema.string().default('').description('审计引擎命令(空=内置 node;走 PATH 自探测,找不到会显式报错而不是静默降级)'),
99
- args: Schema.array(Schema.string()).default([]).description('引擎参数(空=审计包 CLI);相对路径按插件根解析'),
98
+ enabled: Schema.boolean().default(false).description('提交前预处理(默认关):开启后提交前调用预处理实现做门禁;关闭时提交照常,不做任何静态检查'),
99
+ // ── 有序阶段链(新):数组顺序 = 执行顺序 ──
100
+ // 空数组 = 不启用阶段链 ⇒ 走下面的旧单命令字段(行为与升级前逐字段一致)。
101
+ // 每阶段:provider = provider 注册表里的 id;onFail 留空 ⇒ 用 provider 自己声明的
102
+ // defaultOnFail ⇒ 再缺省 'block'(宿主不按 provider 名字猜语义)。
103
+ stages: Schema.array(Schema.object({
104
+ provider: Schema.string().default('').description('provider id(providers.js 注册表里的 id,如 audit)'),
105
+ onFail: Schema.string().default('').description("该阶段失败怎么办:block(中断并拒绝提交)| warn(记警告继续)| skip(静默跳过);空=用 provider 声明的 defaultOnFail,再缺省 block"),
106
+ timeoutMs: Schema.number().default(0).description('该阶段超时毫秒(0=用 provider/全局默认)'),
107
+ })).default([]).description('有序阶段链:按数组顺序执行;空=用单命令模式(command/args)'),
108
+ command: Schema.string().default('').description('预处理引擎命令(单命令模式;空=内置 node;走 PATH 自探测,找不到会显式报错而不是静默降级)'),
109
+ args: Schema.array(Schema.string()).default([]).description('引擎参数(空=预处理实现 CLI);相对路径按插件根解析'),
100
110
  timeoutMs: Schema.number().default(PRE_COMMIT_TIMEOUT_MS_DEFAULT).description('引擎超时毫秒(超时按执行失败处理,fail-closed)'),
101
- }).description('提交前预处理引擎(空=内置;换引擎只改这里)'),
111
+ }).description('提交前预处理(开/关 + 阶段链或单命令;空 engine = 内置预处理实现)'),
102
112
  pushMethod: Schema.string().default('ssh').description('推送通道:ssh(默认,推本地 HEAD、远端 sha 与本地一致)| api(Git Data API 重建提交)| auto(有私钥走 ssh,否则 api)'),
103
113
  // 推送门禁(类似会话指挥家写操作拦截)——开启后 AI 推送必须带 pushConfirmed:true
104
114
  // (已显式放行 pushConfirmed:true),否则 git_commit_push 拦截推送步骤(commit 可做,push 被挡)。
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * 设置读写桥 · settings-bridge
3
3
  *
4
- * 背景(大坑,见 lib/BUGFIX-NOTES-2026-09-14.md「Bug 3」):
4
+ * 背景(历史大坑:无 Origin 的桌面端请求曾被 403 挡住,表现为「页面能开、保存永不生效」):
5
5
  * DSH web GUI 的 settings 持久化由 client 侧 `ctx.remote.$host.isLoopback` 决定(ui-settings
6
6
  * src/client/index.ts:58):经反代地址访问时 isLoopback=false → persistence='memory' →
7
7
  * 前端 scope.set 只改页面内存、不发 wire、不写盘、重启全丢;且公共 settings.yaml 存在
@@ -36,18 +36,47 @@ import { readJson, writeJsonAtomic, updateJsonAtomic } from '../git/atomic-json.
36
36
  */
37
37
  // 设置键映射表(模块级常量:与每次调用无关,放外面避免重复构造,也让 applySettingsToCfg 更短)
38
38
  // 语义:类型收窄 / 枚举白名单 / 数字钳制,与 SETTINGS_SCHEMA 声明同步。
39
- const BOOL_KEYS = ['injectSystemPrompt', 'auditEnabled', 'injectRequirements', 'pushGate', 'autoPushEnabled'];
40
- const ENUM_KEYS = { auditScanScope: ['diff', 'full'], pushMethod: ['ssh', 'api', 'auto'], autoPushScope: ['session', 'all'] };
41
- const STR_KEYS = ['weightOverrides', 'autoPushTriggerText', 'autoPushMessage', 'npmRegistry'];
39
+ // 边界:本表只收**本插件自己的设置键**。「怎么审」(扫描范围/权重/规则包/文件上限)
40
+ // 归预处理实现自己的配置,不在这里;宿主只保留「提交前预处理开不开」
41
+ // (preCommit.enabled,见下方 applyPreCommitBlock)。
42
+ const BOOL_KEYS = ['injectSystemPrompt', 'pushGate', 'autoPushEnabled'];
43
+ const ENUM_KEYS = { pushMethod: ['ssh', 'api', 'auto'], autoPushScope: ['session', 'all'] };
44
+ const STR_KEYS = ['autoPushTriggerText', 'autoPushMessage', 'npmRegistry'];
42
45
  const STR_TRIM_KEYS = ['githubToken', 'sshPub', 'npmToken'];
43
- const ARR_KEYS = ['auditRuleOrder', 'auditDisabledSlots'];
44
- const NUM_KEYS = ['maxScanFiles'];
45
46
  // 数值钳制:min/max 边界,floor 先取整(clone 并发数不高于 16)
46
47
  const CLAMP_KEYS = {
47
48
  maxCloneFileMB: { min: 0 },
48
49
  cloneConcurrency: { min: 1, max: 16, floor: true },
49
50
  };
50
51
 
52
+ /**
53
+ * 嵌套块 `preCommit` 的键级合并(只认已知子键 + 类型守卫)。
54
+ *
55
+ * 为什么单独处理:`preCommit` 是嵌套对象,若走「整键覆盖」的通用路径,
56
+ * 前端只改 `enabled` 这一项时会把同块的 `command` / `args` / `timeoutMs` 一起抹掉
57
+ * (用户手配的引擎位置凭空消失,而且看不出是被谁清的)。
58
+ *
59
+ * 两个入口都给同一件事赋值,来源不同不能互相覆盖:
60
+ * · `patch.preCommitEnabled` —— settings-set 单键写入(前端开关,扁平键名)
61
+ * · `patch.preCommit` —— 启动时把整份 config.json 合并进 cfg(嵌套原样)
62
+ * 单键写入优先:它是用户刚做的动作,文件里的旧嵌套值是更早的状态。
63
+ */
64
+ function applyPreCommitBlock(cfg, patch) {
65
+ const flatEnabled = typeof patch.preCommitEnabled === 'boolean' ? patch.preCommitEnabled : null;
66
+ const block = (patch.preCommit && typeof patch.preCommit === 'object') ? patch.preCommit : null;
67
+ const blockEnabled = typeof block?.enabled === 'boolean' ? block.enabled : null;
68
+ const enabled = flatEnabled ?? blockEnabled;
69
+ const cur = (cfg.preCommit && typeof cfg.preCommit === 'object') ? cfg.preCommit : {};
70
+ const next = { ...cur };
71
+ if (enabled !== null) next.enabled = enabled;
72
+ if (typeof block?.command === 'string') next.command = block.command;
73
+ if (Array.isArray(block?.args)) next.args = block.args.map((rawArg) => String(rawArg));
74
+ if (typeof block?.timeoutMs === 'number' && Number.isFinite(block.timeoutMs)) next.timeoutMs = block.timeoutMs;
75
+ if (enabled === null && blockEnabled === null && typeof block?.command !== 'string'
76
+ && !Array.isArray(block?.args) && typeof block?.timeoutMs !== 'number') return;
77
+ cfg.preCommit = next;
78
+ }
79
+
51
80
  /**
52
81
  * 按类型把 patch 里的键写进 cfg(布尔 / 枚举 / 字符串 / 去空白字符串 / 数组 / 有限数字)。
53
82
  *
@@ -61,8 +90,6 @@ function applyTypedKeys(cfg, patch) {
61
90
  }
62
91
  for (const k of STR_KEYS) if (typeof patch[k] === 'string') cfg[k] = patch[k];
63
92
  for (const k of STR_TRIM_KEYS) if (typeof patch[k] === 'string' && patch[k].trim()) cfg[k] = patch[k].trim();
64
- for (const k of ARR_KEYS) if (Array.isArray(patch[k])) cfg[k] = patch[k];
65
- for (const k of NUM_KEYS) if (typeof patch[k] === 'number' && Number.isFinite(patch[k])) cfg[k] = patch[k];
66
93
  }
67
94
 
68
95
  /** 数值键钳制:非有限数字跳过;floor 先取整,再按 min/max 收敛。 */
@@ -81,6 +108,7 @@ export function applySettingsToCfg(cfg, patch) {
81
108
  if (!cfg || !patch || typeof patch !== 'object') return out;
82
109
  applyTypedKeys(cfg, patch);
83
110
  applyClampedNumbers(cfg, patch);
111
+ applyPreCommitBlock(cfg, patch);
84
112
  if (typeof patch.injectSystemPrompt === 'boolean') out.changedSystemPrompt = patch.injectSystemPrompt;
85
113
  return out;
86
114
  }
@@ -215,4 +243,28 @@ export async function writeSettingsKey(key, jsonValue, env = {}) {
215
243
  } catch (e) {
216
244
  return { ok: false, code: 'WRITE_FAIL', error: `配置写入失败: ${e?.message || e}` };
217
245
  }
246
+ }
247
+
248
+ /**
249
+ * 写「提交前预处理」总开关(`preCommit.enabled`,嵌套块里的**单个子键**)。
250
+ *
251
+ * 为什么不复用 writeSettingsKey:那条是「整键覆盖」,key 写 `preCommit` 会把同块的
252
+ * command / args / timeoutMs 一起换掉——用户手配的引擎位置会凭空消失且无提示。
253
+ * 这里做键级合并(atomic 读改写,不引入第二条写路径)。
254
+ * @param {boolean} enabled
255
+ * @param {{workspaceRoot?:string}} [env]
256
+ * @returns {{ok:boolean, code?:string, error?:string}}
257
+ */
258
+ export async function writePreCommitEnabled(enabled, env = {}) {
259
+ if (typeof enabled !== 'boolean') return { ok: false, code: 'BAD_VALUE', error: 'preCommit.enabled 只接受布尔值' };
260
+ try {
261
+ const file = settingsFilePath(env);
262
+ const updated = updateJsonAtomic(file, (cur) => {
263
+ const block = (cur && typeof cur.preCommit === 'object' && cur.preCommit !== null) ? cur.preCommit : {};
264
+ return { ...cur, preCommit: { ...block, enabled } };
265
+ });
266
+ return updated.ok ? { ok: true, file: updated.file } : { ok: false, code: 'WRITE_FAIL', error: `配置写入失败: ${updated.error || '未知'}` };
267
+ } catch (e) {
268
+ return { ok: false, code: 'WRITE_FAIL', error: `配置写入失败: ${e?.message || e}` };
269
+ }
218
270
  }
@@ -20,12 +20,17 @@ import {
20
20
  scanReposAsync, scanRepos, checkGithubAccount, formatGithubAccountBlock, generateSshKey, persistSshPub,
21
21
  refreshAccountStatus,
22
22
  } from '../git/index.js';
23
- import { runAudit } from '../commit-push.js';
23
+ import { runPreprocess } from '../commit-push.js';
24
+ // 提交前预处理开关(preCommit.enabled,含旧版开关键的一次性兼容读取)
25
+ import { resolvePreCommitEnabled } from '../commit-push/pre-commit-engine.js';
24
26
  // 审计能力统一经客户端调审计包(拆包后审计实现不在本仓库;此处只做参数映射与结果转交)
25
27
  import * as auditClient from './preprocess-client.js';
26
28
 
27
29
  /* ───────── 工具调用常量 ───────── */
28
30
  import { defaultConfig } from '../client/index.js';
31
+
32
+ /** 等 CI 结果的默认超时(秒):GitHub Actions 常见 3~8 分钟,15 分钟是安全上界。 */
33
+ const CI_WAIT_TIMEOUT_SEC_DEFAULT = 900;
29
34
  import { callIdentityRewrite } from './handlers/identity-rewrite.js';
30
35
  import { MSG_REPO_REQUIRED } from './constants.js';
31
36
  import { setLastSlotHitStats } from './slot-stats.js';
@@ -57,7 +62,6 @@ async function pushWithPostSteps(args, env, cfg) {
57
62
  push: args.push !== false,
58
63
  dryRun: args.dryRun === true,
59
64
  customIgnorePatterns: args.ignorePatterns || '',
60
- requirementsConfirmed: args.requirementsConfirmed === true,
61
65
  force: args.force === true,
62
66
  pushMethod: cfg.pushMethod || 'ssh',
63
67
  // 推送目标 remote(多 remote/fork 场景;缺省 origin);推送与核验使用同一 remote
@@ -68,11 +72,12 @@ async function pushWithPostSteps(args, env, cfg) {
68
72
  // 推送后等 CI 结果(默认不等):按推到远端的那个 sha 查 Actions,
69
73
  // 全绿=通过、任一失败=ciFailed、超时/无 CI 如实回报(都不改变推送本身成功的事实)
70
74
  waitCi: args.waitCi === true || cfg.waitCi === true,
71
- ciTimeoutSec: Number(args.ciTimeoutSec) > 0 ? Number(args.ciTimeoutSec) : 900,
75
+ ciTimeoutSec: Number(args.ciTimeoutSec) > 0 ? Number(args.ciTimeoutSec) : CI_WAIT_TIMEOUT_SEC_DEFAULT,
72
76
  // 精确 add 路径(逗号分隔,相对 repo);空 = git add -A 全量
73
77
  paths: String(args.paths || ''),
74
- // 敏感文件扫描与审计同一开关:审计关闭 ⇒ 不扫(此前无条件全仓扫,属特权步骤)
75
- scanSensitive: cfg.auditEnabled !== false,
78
+ // 敏感文件扫描与「提交前预处理」同一个开关:预处理关闭 ⇒ 不扫。
79
+ // 扫描属提交门禁的一部分,随门禁一起开关,不单独占一个配置位。
80
+ scanSensitive: resolvePreCommitEnabled(cfg).enabled,
76
81
  });
77
82
  // ── 鼓励使用结构化提交信息(messageItems):提醒 + 采用率留痕 ──────────────────
78
83
  // 为什么需要:默认路径(单串 message)更省事,结构化参数长期无人用 ⇒ 两件事互补:
@@ -226,7 +231,7 @@ function startHostJob(jobs, spec, owner) {
226
231
  }
227
232
 
228
233
  /**
229
- * git_clone 工具实现(2026-10-02 功能:clone 注册宿主后台 job):
234
+ * git_clone 工具实现:clone 注册宿主后台 job。
230
235
  * 大仓库下载注册为宿主官方后台 job(ctx.jobs)——工具立即返回 jobId(如 git-clone-1),
231
236
  * AI 用宿主 job_output/job_list/job_kill 查询/中止;宿主无 job 控制器时同步执行保底。
232
237
  * clone 是只读操作无需审计门禁(与 git_commit_push 的差异点)。
@@ -304,7 +309,7 @@ async function callNpmPublishJob(args = {}, jobs, exec, log, env = {}, cfg = {})
304
309
  /**
305
310
  * 把发包结果映射成宿主 job 的 {status, detail, output} —— **成功也必须给 detail**。
306
311
  *
307
- * 历史缺陷(2026-10-16 实测):成功分支只写了 `output`(JSON 字符串),没写 `detail`
312
+ * 注意:成功分支也必须写 `detail`(曾只写 `output`,`job_output` 读出来是「(no new output)」)。
308
313
  * ⇒ 宿主 job 的完成回执里没有可读结果,`job_output` 读出来是「(no new output)」✗,
309
314
  * 只能去翻插件日志与 registry 侧面确认(clone / commit+push 都有 detail ⇒ 只有 npm 空 ✗)。
310
315
  *
@@ -394,18 +399,21 @@ async function callCommitPush(args, env, cfg, log, jobs, exec) {
394
399
  // blocker 命中 → 立即返回拦截、不执行任何 git 操作;审计通过 → commit+push
395
400
  // +索引重建注册为宿主官方后台 job(ctx.jobs,dsh-jobs-local),工具立即返回
396
401
  // jobId(如 git-push-1),AI 用宿主自带 job_output/job_list/job_kill 查询。
397
- const auditGate = await runAudit({
402
+ const preprocessGate = await runPreprocess({
398
403
  repoPath: repo,
399
404
  audit: args.audit,
400
405
  // 不再透传 auditLevel——审计固定走完整流程(正则初筛 + AST 语义检查)
401
406
  rulesetDir: args.ruleset,
402
- slots: undefined, // auditRuleOrder 是「加载顺序」不是白名单 ✗(详见 lib/commit-push.js 注释;禁用槽位用 auditDisabledSlots ✓)
407
+ // 扫描范围/权重/规则槽位/文件上限不再从宿主配置取:它们是预处理实现自己的配置,
408
+ // 由审计包读自己的 config.json 当默认值(本工具参数里的显式值仍优先)。
403
409
  cfg,
404
410
  // 本次提交的按文件临时豁免(不落盘):列入的文件 finding 不参与拦截判定(含 blocker)
405
411
  auditExemptPaths: Array.isArray(args.auditExemptPaths) ? args.auditExemptPaths : [],
406
412
  auditExemptReason: args.auditExemptReason,
413
+ // 本次调用的预处理链(优先级 > 配置文件里的 stages)
414
+ stages: Array.isArray(args.preprocessStages) && args.preprocessStages.length ? args.preprocessStages : null,
407
415
  });
408
- if (!auditGate.ok) return auditGate; // { ok:false, blocked:true, audit }
416
+ if (!preprocessGate.ok) return preprocessGate; // { ok:false, blocked:true, audit }
409
417
  const doPush = () => pushWithPostSteps(args, env, cfg);
410
418
  // 宿主未提供 ctx.jobs(如脱离 DSH 的 CLI/测试环境)→ 同步执行保底
411
419
  if (!jobs || typeof jobs.start !== 'function') {
@@ -432,12 +440,12 @@ async function callCommitPush(args, env, cfg, log, jobs, exec) {
432
440
  return { ok: true, async: false, jobFallback: true, jobFallbackReason: started.error, result: r };
433
441
  }
434
442
  }
435
- return { ok: true, async: true, jobId, audit: auditGate.audit, hint: '已注册宿主后台 job(结果完成会自动返回,无需特意查询);如需主动查:job_output ' + jobId };
443
+ return { ok: true, async: true, jobId, audit: preprocessGate.audit, hint: '已注册宿主后台 job(结果完成会自动返回,无需特意查询);如需主动查:job_output ' + jobId };
436
444
  }
437
445
 
438
446
  /**
439
447
  * code_audit 工具实现(从 callTool switch 抽出):
440
- * 权重 = 显式传参 > cfg.weightOverrides > 默认;history 走宿主后台 job(无控制器同步降级);
448
+ * 权重 = 显式传参(未传则用审计包自己的配置);history 走宿主后台 job(无控制器同步降级);
441
449
  * 结果带 block 可读总结 + slotStats 供侧边栏规则包命中数。
442
450
  */
443
451
  /**
@@ -448,9 +456,8 @@ function buildAuditOpts(args, cfg, scope) {
448
456
  return {
449
457
  scope,
450
458
  rulesetDir: args.ruleset || '',
451
- maxScanFiles: cfg.maxScanFiles,
452
- slots: undefined, // auditRuleOrder 是「加载顺序」不是白名单 ✗(详见 lib/commit-push.js 注释;禁用槽位用 auditDisabledSlots ✓)
453
- disabledSlots: Array.isArray(cfg.auditDisabledSlots) ? cfg.auditDisabledSlots : [],
459
+ // maxScanFiles / disabledSlots / slots 刻意不传:它们归审计包自己的配置
460
+ // (lib/config/load.js),宿主再传一份就等于两个包共享同一份配置。
454
461
  includeIgnored: args.includeIgnored === true,
455
462
  // 分析覆盖率信息项(默认开;coverage:false 关闭——大仓库省一次读取+解析)
456
463
  coverage: args.coverage !== false,
@@ -497,9 +504,9 @@ async function runHistoryAuditTool(args, env, cfg, jobs, exec, weights) {
497
504
  async function callCodeAudit(args, env, cfg, log, jobs, exec) {
498
505
  const repo = args.repo;
499
506
  if (!repo) return { ok: false, error: MSG_REPO_REQUIRED };
500
- // 修复:权重来源 = 工具参数显式传参 > 侧边栏保存的 cfg.weightOverrides(config.json
501
- // 回读)> 默认权重表。此前只认 args.weights——侧边栏权重设置保存了但审计完全无视(假保存)。
502
- const weightSrc = args.weights || (typeof cfg.weightOverrides === 'string' ? cfg.weightOverrides : '');
507
+ // 权重来源 = 工具参数显式传参;未传则交给审计包(它读自己的权重覆盖配置)。
508
+ // 宿主不再持有审计权重:那属于「怎么审」,归审计包配置。
509
+ const weightSrc = args.weights || '';
503
510
  let weights = {};
504
511
  if (weightSrc) {
505
512
  try { weights = JSON.parse(weightSrc); } catch { /* 非法 JSON 回退默认权重 */ }
@@ -517,9 +524,6 @@ async function runStandardAuditTool(args, env, cfg, log, weights) {
517
524
  scope: args.scope === 'full' ? 'full' : 'diff',
518
525
  weights,
519
526
  rulesetDir: args.rulesetDir || '',
520
- maxScanFiles: cfg?.maxScanFiles,
521
- slots: Array.isArray(args.slots) ? args.slots : undefined,
522
- disabledSlots: Array.isArray(cfg?.auditDisabledSlots) ? cfg.auditDisabledSlots : undefined,
523
527
  includeFindings: args.includeFindings !== false && args.summaryOnly !== true,
524
528
  // 覆盖率是信息项(不影响 summary/quality);工具参数 coverage:false 时关掉
525
529
  ...(args.coverage === false ? { coverage: false } : {}),
@@ -569,7 +573,7 @@ export async function callTool(toolName, args = {}, env = {}, cfg = defaultConfi
569
573
  }
570
574
  case 'git_clone': {
571
575
  if (!args.target) return { ok: false, error: 'target 必填' };
572
- // 2026-10-02 功能:clone 注册宿主后台 job(同 git_commit_push)——大仓库下载
576
+ // clone 注册宿主后台 job(同 git_commit_push)——大仓库下载
573
577
  // 不阻塞工具调用,立即返回 jobId;宿主 job 完成自动回传。宿主无 job 控制器时同步执行保底。
574
578
  // env/cfg 必须传下去:clone 要按仓库解析 token(否则走匿名 API,私有库失败、公开库吃限流)
575
579
  // 与统一体积上限(与 HTTP 路径同口径)。
@@ -9,6 +9,7 @@
9
9
  * (与插件工具同源)。
10
10
  */
11
11
 
12
+ import { readFileSync } from 'node:fs';
12
13
  import { scanRepos } from '../git/repos.js';
13
14
  import { updateRepoIndex } from '../git/repo-index.js';
14
15
  import { runWrappedGit } from '../git/wrapped-git.js';
@@ -87,11 +88,43 @@ export async function cmdGit(args = []) {
87
88
  return r.ok ? 0 : (typeof r.status === 'number' ? r.status : 1);
88
89
  }
89
90
 
91
+ /**
92
+ * 解析 `--preprocess-stages` 的取值:内联 JSON 或 `@路径.json`。
93
+ *
94
+ * 为什么支持 @文件:阶段链带 args 数组,命令行里容易超长/被 shell 改写;写文件更稳。
95
+ * 解析失败立刻报错(在任何 git 操作之前),错误信息指出第几项哪个字段不对。
96
+ * @param {string} raw 原始取值
97
+ * @returns {{stages: Array|null, error?: string}}
98
+ */
99
+ function parsePreprocessStagesFlag(raw) {
100
+ const text = String(raw == null ? '' : raw).trim();
101
+ if (!text) return { stages: null };
102
+ let json = text;
103
+ if (text.startsWith('@')) {
104
+ const file = text.slice(1).trim();
105
+ try { json = readFileSync(file, 'utf8'); } catch (e) { return { stages: null, error: `读不到 --preprocess-stages 文件:${file}(${e && e.message ? e.message : e})` }; }
106
+ }
107
+ let parsed;
108
+ try { parsed = JSON.parse(json); } catch (e) { return { stages: null, error: `--preprocess-stages 不是合法 JSON:${e && e.message ? e.message : e}` }; }
109
+ if (!Array.isArray(parsed)) return { stages: null, error: '--preprocess-stages 需要是数组(每项 {command,args?} 或 {provider})' };
110
+ for (let i = 0; i < parsed.length; i += 1) {
111
+ const stageEntry = parsed[i];
112
+ if (!stageEntry || typeof stageEntry !== 'object') return { stages: null, error: `--preprocess-stages 第 ${i + 1} 项不是对象` };
113
+ const hasProvider = !!String(stageEntry.provider || '').trim();
114
+ const hasCommand = !!String(stageEntry.command || '').trim();
115
+ if (hasProvider === hasCommand) return { stages: null, error: `--preprocess-stages 第 ${i + 1} 项必须且只能给 provider 或 command 之一` };
116
+ }
117
+ return { stages: parsed };
118
+ }
119
+
90
120
  /** 子命令:commit — 审计门禁 → 提交(默认只 commit 不 push;--push 推远端;--force 强推)。 */
91
121
  export async function cmdCommit(root, flags) {
92
122
  const repo = root || '';
93
123
  if (!repo || !(await pathExists(join(repo, '.git')))) { console.error(`不是 git 仓库: ${repo || '(空)'}`); return 1; }
94
124
  if (!String(flags.message || '').trim()) { console.error('缺少 -m <commit message>'); return 1; }
125
+ // 阶段链参数先校验(配置写错要在动 git 之前失败)
126
+ const stageFlag = parsePreprocessStagesFlag(flags.preprocessStages);
127
+ if (stageFlag.error) { console.error(stageFlag.error); return 2; }
95
128
  // 推送门禁开关取插件配置(config.json pushGate,与侧边栏同一真源);CLI 未确认时会被拦截
96
129
  const cfg = cliPluginConfig();
97
130
  // 审计门禁:blocker 拦截(v2 审计独立调用——与 DSH 工具 git_commit_push 同一实现 commitWithAudit)
@@ -100,13 +133,14 @@ export async function cmdCommit(root, flags) {
100
133
  message: flags.message,
101
134
  push: flags.push === true,
102
135
  dryRun: flags.dryRun === true,
103
- requirementsConfirmed: flags.reqConfirm === true,
104
136
  force: flags.force === true,
105
137
  // 推送门禁(设置侧边栏开关)——CLI 对应 --push-gate-confirmed(用户已确认)
106
138
  pushGate: cfg.pushGate === true,
107
139
  pushConfirmed: flags.pushGateConfirmed === true,
108
140
  // 精确 add 路径(逗号分隔,相对 repo);空 = git add -A
109
141
  paths: String(flags.paths || ''),
142
+ // 本次调用的预处理链(覆盖配置文件里的 preCommit.stages)
143
+ stages: stageFlag.stages,
110
144
  });
111
145
  if (commitOutcome.blocked) {
112
146
  console.error(`审计拦截(${commitOutcome.error || 'blocker'}),提交中止:`);
@@ -88,7 +88,7 @@ export function allCommands() {
88
88
  * lib/app + lib/client,与审计实现无关——放在 here 可以让 git 侧不必为了读配置 import 审计模块。
89
89
  *
90
90
  * 注意:applySettingsToCfg 是**原地修改** cfg,返回的是状态对象({changedSystemPrompt}),
91
- * 绝不能把返回值当 cfg 用——那会让 auditEnabled/maxScanFiles/weightOverrides 全变 undefined。
91
+ * 绝不能把返回值当 cfg 用——那会让 preCommit/开关类字段全变 undefined。
92
92
  * @returns {object} 运行期配置
93
93
  */
94
94
  export function cliPluginConfig() {
@@ -15,18 +15,18 @@
15
15
  * - collectExternalRefs():零外部资源自检(列出所有外链引用,应为空)
16
16
  */
17
17
 
18
- /** 审计/推送开关默认值(关键:默认关)。 */
19
- const MAX_SCAN_FILES_DEFAULT = 3000; // 全量审计文件数上限默认值
20
-
18
+ /**
19
+ * 前端配置默认值(**只含本插件自己的开关**)。
20
+ *
21
+ * 「怎么审」(扫描范围 / 权重 / 规则槽位 / 文件数上限)不在这里:那些是预处理实现
22
+ * (audit-sluice)自己的配置,住在它自己的 config.json 里。本插件只保留
23
+ * 「提交前预处理开不开」这一个决定权(preCommitEnabled)。
24
+ */
21
25
  export const DEFAULT_CONFIG = {
22
- auditEnabled: false, // 审计开关默认关
23
- injectSystemPrompt: true, // 注入总开关:系统提示词(用法/提醒)+ 上下文(环境信息;默认开)
24
- auditScanScope: 'diff', // diff | full
25
- maxScanFiles: MAX_SCAN_FILES_DEFAULT, // 全量审计文件数上限(0=不限);超限按变动优先截断,弱机防卡死
26
+ preCommitEnabled: false, // 提交前预处理开关(默认关)
27
+ injectSystemPrompt: true, // 注入总开关:系统提示词(用法/提醒)+ 上下文(环境信息;默认开)
26
28
  maxCloneFileMB: 10, // clone 单文件体积上限(MB);超过则跳过并如实告知(0=不限制)
27
29
  cloneConcurrency: 6, // clone 并发下载数;1=串行最慢,过高会撞 GitHub 风控
28
- auditRuleOrder: [], // 槽位加载顺序(空=默认偏好顺序;private 恒末尾强制)
29
- weightOverrides: '', // 权重覆盖 JSON(空=默认权重表)
30
30
  pushMethod: 'ssh', // 推送通道:ssh(默认)| api | auto
31
31
  // defaultScanRoot/commitMessage 设置移除——默认扫描路径复用本地仓库列表
32
32
  // 选择路径(前端 localStorage dshgp-scan-path → repos-local?path=),提交信息留空由调用方生成。
@@ -34,20 +34,15 @@ export const DEFAULT_CONFIG = {
34
34
 
35
35
  /** 设置项声明(UI 单一事实源:侧边栏与配置读写共用)。 */
36
36
  export const SETTINGS_SCHEMA = [
37
- { key: 'auditEnabled', type: 'boolean', default: false, label: '审计开关', hint: '开启后提交前自动审计(默认关)' },
37
+ { key: 'preCommitEnabled', type: 'boolean', default: false, label: '提交前预处理', hint: '开启后提交前调用预处理实现做门禁(默认关);具体的检查规则与范围属于预处理实现自己的配置' },
38
38
  // 任务完成自动推送:开关默认为关,检测文本可自定义(门禁开关旁)。
39
- { key: 'autoPushEnabled', type: 'boolean', default: false, label: '自动推送(✅任务完成)', hint: '开启后 AI 回复含指定完成文案即自动 commit+push(复用审计门禁,默认关;建议与审计开关同开)' },
39
+ { key: 'autoPushEnabled', type: 'boolean', default: false, label: '自动推送(✅任务完成)', hint: '开启后 AI 回复含指定完成文案即自动 commit+push(复用提交前预处理门禁,默认关;建议与预处理开关同开)' },
40
40
  { key: 'autoPushTriggerText', type: 'string', default: '✅任务完成', label: '自动推送触发文本', hint: '检测「任务完成」的文本/正则(默认「✅任务完成」),可自定义如 ✅(任务完成|已解答);在门禁开关旁设置' },
41
41
  { key: 'autoPushScope', type: 'enum', values: ['session', 'all'], default: 'session', label: '自动推送范围', hint: 'session=仅会话 cwd 所在仓库(默认,最安全);all=workspace 全部有变更仓库' },
42
42
  { key: 'injectSystemPrompt', type: 'boolean', default: true, label: '注入系统提示词/上下文', hint: '系统提示词:插件功能用法/README 提醒/要求清单(每步);上下文:工作区目录 + 工具安装路径 + skill 总入口(每个 agent 首次 step 注入一次;工具按 lib/tool-probes.json 模板探测,路径生成到 <配置目录>/tools.json)。关=完全不注入。修改即时保存' },
43
- { key: 'auditScanScope', type: 'enum', values: ['diff', 'full'], default: 'diff', label: '审计扫描范围', hint: 'diff=仅本次变动;full=全量' },
44
43
  { key: 'pushMethod', type: 'enum', values: ['ssh', 'api', 'auto'], default: 'ssh', label: '推送通道', hint: 'ssh=推本地 HEAD(远端 sha 与本地一致,默认);api=Git Data API 重建提交(远端 sha 与本地不同);auto=有私钥走 ssh' },
45
- { key: 'maxScanFiles', type: 'number', default: MAX_SCAN_FILES_DEFAULT, label: '全量扫描文件上限', hint: '全量审计最多扫多少个文件(0=不限);超限时按「变动文件优先」截断,避免弱机扫几万文件卡死' },
46
44
  { key: 'maxCloneFileMB', type: 'number', default: 10, label: 'clone 单文件上限(MB)', hint: '克隆时跳过超过该大小的文件并在结果中列出(0=不限制)。仓库里的二进制/媒体大文件常达几十 MB,逐个下载会把请求拖到超时' },
47
45
  { key: 'cloneConcurrency', type: 'number', default: 6, label: 'clone 并发数', hint: '同时下载的文件数。1=串行(最慢但最温和);过高会触发 GitHub 风控。受限网络建议 3~6' },
48
- { key: 'auditRuleOrder', type: 'list', default: [], label: '槽位加载顺序', hint: '逗号分隔槽位名;后加载覆盖先加载;private 恒末尾强制;空=默认偏好顺序' },
49
- { key: 'auditDisabledSlots', type: 'list', default: [], label: '禁用的规则包', hint: '逗号分隔槽位名;nodejs/private 不可禁用' },
50
- { key: 'weightOverrides', type: 'string', default: '', label: '权重覆盖 JSON', hint: '如 {"安全性":100};空=默认权重表' },
51
46
  ];
52
47
 
53
48
  /** 默认配置(由 SETTINGS_SCHEMA 派生,保证 UI 与默认值永不脱节)。 */
@@ -1,4 +1,4 @@
1
- /* ─── 第 5/13 片 · 账号信息 Tab(AcctHead/AccountCard/AccountTab) ─────────────────── */
1
+ /* ─── 第 6/14 片 · 账号信息 Tab(AcctHead/AccountCard/AccountTab) ─────────────────── */
2
2
  /** 账号卡片头部:GitHub 图标 + 标题 + 状态徽标。 */
3
3
  function dshgp_AcctHead(props) {
4
4
  return jsx.jsxs('div', {
@@ -20,13 +20,19 @@
20
20
  function dshgp_AccountCard(props) {
21
21
  const s = props.state;
22
22
  const loggedIn = !!s.accountLoggedIn;
23
- const loading = !!s.accountLoading;
24
- const statCls = loggedIn ? 'dshgp_acctstat_ok' : (loading ? 'dshgp_acctstat_warn' : 'dshgp_acctstat_err');
25
- const statTxt = loggedIn ? '已连接' : (loading ? '检测中' : '未连接');
26
- const blockCls = loggedIn ? 'dshgp_acctblock2_ok' : (loading ? 'dshgp_acctblock2_loading' : 'dshgp_acctblock2_err');
23
+ // 「还没读 / 读失败」必须与「读到了、确实没配」分开:前者不能渲染成确定性的否定结论
24
+ const info = (s.uiStatus && s.uiStatus.account) || { state: 'idle', error: '' };
25
+ const unread = info.state === 'idle' || info.state === 'loading';
26
+ const errored = info.state === 'error';
27
+ const loading = !!s.accountLoading || unread;
28
+ const statCls = errored ? 'dshgp_acctstat_warn' : (loggedIn ? 'dshgp_acctstat_ok' : (loading ? 'dshgp_acctstat_warn' : 'dshgp_acctstat_err'));
29
+ const statTxt = errored ? '读取失败' : (loading ? '检测中' : (loggedIn ? '已连接' : '未连接'));
30
+ const blockCls = loggedIn ? 'dshgp_acctblock2_ok' : (loading || errored ? 'dshgp_acctblock2_loading' : 'dshgp_acctblock2_err');
27
31
  const blockBody = s.accountBlock
28
32
  ? s.accountBlock
29
- : (loading ? '正在检测 Token / SSH 公钥…' : '未配置 Token / SSH 公钥——请到「设置」选项卡填写凭据');
33
+ : (unread ? '正在读取账号状态…'
34
+ : (errored ? '账号状态读取失败(可点下方「重试」)'
35
+ : '未配置 Token / SSH 公钥——请到「设置」选项卡填写凭据'));
30
36
  // 两条凭据各自独立——Token 与 SSH 可以是**不同 GitHub 用户**;明细(用户名/校验时间/
31
37
  // 配额)统一由凭据块(block,后端生成)逐行给出,页面不再另列重复的分项行。
32
38
  // 两凭据属不同用户时如实提示:推送实际走 SSH 通道
@@ -36,6 +42,11 @@
36
42
  className: 'dshgp_acctpanel',
37
43
  children: [
38
44
  jsx.jsx(dshgp_AcctHead, { statCls, statTxt }),
45
+ jsx.jsx(dshgp_ResourceNotice, {
46
+ info: info,
47
+ what: '账号状态',
48
+ onRetry: errored && props.retryResource ? () => props.retryResource('account') : null,
49
+ }),
39
50
  jsx.jsx('pre', { className: 'dshgp_acctblock2 ' + blockCls, children: blockBody }),
40
51
  // Token / SSH 公钥的登录名与校验时间已在**凭据块内**逐行给出(Token 那行还带 API 配额后缀),
41
52
  // 此处不再另列一遍分项行——同一份登录信息展示两遍正是之前的重复问题。
@@ -65,12 +76,10 @@
65
76
 
66
77
  /** 选项卡一:账号信息(拆卡片:渐变面板 AccountCard + 本地/云端 RepoManagerCard)。 */
67
78
  function dshgp_AccountTab(props) {
68
- // 账号信息/本地仓库列表的读取时机已收敛到三种(不再每次切 tab 重读):
69
- // ①插件启动时(apply 里一次性读:refreshAccount + scanLocalRepos)
70
- // ②云端 push 完成时(pushLocalRepo 成功后顺延重读)
71
- // ③本地仓库手动「扫描」完成索引重建后(扫描按钮 rebuild=true 自带重读)
72
- // 因此这里**不再**挂载时刷新——条件渲染(tab==='account')每次切回都重挂载,
73
- // 若在此触发会「一直刷新」;读取全部改由 Controller 层显式调用。
79
+ // §三:条件渲染(tab==='account')每切回都重挂载 ⇒ 挂载即视为「面板重建」:
80
+ // 补读没读过/已过期的资源(幂等,不产生重复请求)+ 按当前值重放显示态。
81
+ // 这样「切 tab 回来看到空数据」不再需要用户手动点刷新。
82
+ react.useEffect(() => { if (props.panelRebuilt) props.panelRebuilt(); }, []);
74
83
  return jsx.jsxs('div', {
75
84
  className: 'dshgp_section',
76
85
  children: [