dsh-git-push 0.0.0-stage → 2.8.6

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 (279) hide show
  1. package/.auditignore +30 -0
  2. package/.gitignore +39 -0
  3. package/LICENSE +21 -0
  4. package/README.md +1486 -2
  5. package/cli.mjs +360 -0
  6. package/cordis.patch.yml +14 -0
  7. package/lib/ARCHITECTURE.md +34 -0
  8. package/lib/BUGFIX-NOTES-2026-09-14.md +278 -0
  9. package/lib/app/apply.js +275 -0
  10. package/lib/app/audit-api.js +158 -0
  11. package/lib/app/command-registry.js +266 -0
  12. package/lib/app/constants.js +16 -0
  13. package/lib/app/handlers/account.js +166 -0
  14. package/lib/app/handlers/clone.js +168 -0
  15. package/lib/app/handlers/http-constants.js +9 -0
  16. package/lib/app/handlers/identity-rewrite.js +94 -0
  17. package/lib/app/handlers/meta.js +175 -0
  18. package/lib/app/handlers/npm.js +169 -0
  19. package/lib/app/handlers/repo-actions.js +143 -0
  20. package/lib/app/handlers/repos.js +231 -0
  21. package/lib/app/handlers/settings.js +62 -0
  22. package/lib/app/host-doc-checks.js +25 -0
  23. package/lib/app/http-handlers.js +131 -0
  24. package/lib/app/index.js +30 -0
  25. package/lib/app/inject-text.js +192 -0
  26. package/lib/app/scan-root.js +23 -0
  27. package/lib/app/schema.js +150 -0
  28. package/lib/app/settings-bridge.js +167 -0
  29. package/lib/app/slash-commands.js +395 -0
  30. package/lib/app/slot-stats.js +35 -0
  31. package/lib/app/tool-call.js +672 -0
  32. package/lib/app/tools.js +34 -0
  33. package/lib/ast/brace.js +105 -0
  34. package/lib/ast/callgraph.js +135 -0
  35. package/lib/ast/code-lines.js +114 -0
  36. package/lib/ast/consts.js +12 -0
  37. package/lib/ast/control-flow.js +461 -0
  38. package/lib/ast/credential.js +199 -0
  39. package/lib/ast/dataflow.js +274 -0
  40. package/lib/ast/dup-code.js +165 -0
  41. package/lib/ast/index.js +36 -0
  42. package/lib/ast/io-risk-const.js +95 -0
  43. package/lib/ast/io-risk-fn.js +208 -0
  44. package/lib/ast/io-risk-loop.js +308 -0
  45. package/lib/ast/io-risk.js +314 -0
  46. package/lib/ast/lang.js +156 -0
  47. package/lib/ast/line-count.js +52 -0
  48. package/lib/ast/magic-number.js +272 -0
  49. package/lib/ast/naming.js +284 -0
  50. package/lib/ast/perf.js +472 -0
  51. package/lib/ast/scope.js +241 -0
  52. package/lib/ast/shell.js +131 -0
  53. package/lib/ast/size.js +378 -0
  54. package/lib/ast/symbol-index.js +399 -0
  55. package/lib/ast/tokenizer.js +341 -0
  56. package/lib/audit/analysis-coverage.js +98 -0
  57. package/lib/audit/audit-file.js +182 -0
  58. package/lib/audit/checks.js +17 -0
  59. package/lib/audit/client-entry.js +93 -0
  60. package/lib/audit/collector.js +477 -0
  61. package/lib/audit/ext-runner.js +80 -0
  62. package/lib/audit/file-context.js +138 -0
  63. package/lib/audit/finding.js +50 -0
  64. package/lib/audit/gitignore-match.js +113 -0
  65. package/lib/audit/glob.js +63 -0
  66. package/lib/audit/history-report.js +100 -0
  67. package/lib/audit/history.js +126 -0
  68. package/lib/audit/ignore-blind.js +101 -0
  69. package/lib/audit/index.js +33 -0
  70. package/lib/audit/orchestrate.js +476 -0
  71. package/lib/audit/public.js +24 -0
  72. package/lib/audit/repo-level.js +30 -0
  73. package/lib/audit/report-yaml.js +86 -0
  74. package/lib/audit/slot.js +65 -0
  75. package/lib/audit-defaults.js +18 -0
  76. package/lib/audit-rules/audit-rules-comment.yml +247 -0
  77. package/lib/audit-rules/audit-rules-cpp.yml +22 -0
  78. package/lib/audit-rules/audit-rules-docs.yml +32 -0
  79. package/lib/audit-rules/audit-rules-dsh.yml +162 -0
  80. package/lib/audit-rules/audit-rules-filehealth.yml +42 -0
  81. package/lib/audit-rules/audit-rules-folder.yml +99 -0
  82. package/lib/audit-rules/audit-rules-frontend.yml +335 -0
  83. package/lib/audit-rules/audit-rules-go.yml +22 -0
  84. package/lib/audit-rules/audit-rules-i18n.yml +45 -0
  85. package/lib/audit-rules/audit-rules-java.yml +105 -0
  86. package/lib/audit-rules/audit-rules-nodejs.yml +647 -0
  87. package/lib/audit-rules/audit-rules-npm.yml +187 -0
  88. package/lib/audit-rules/audit-rules-paths.yml +92 -0
  89. package/lib/audit-rules/audit-rules-performance.yml +215 -0
  90. package/lib/audit-rules/audit-rules-php.yml +22 -0
  91. package/lib/audit-rules/audit-rules-private.yml +24 -0
  92. package/lib/audit-rules/audit-rules-python.yml +106 -0
  93. package/lib/audit-rules/audit-rules-robustness.yml +27 -0
  94. package/lib/audit-rules/audit-rules-rust.yml +22 -0
  95. package/lib/audit-rules/audit-rules-structure.yml +159 -0
  96. package/lib/audit-rules/audit-rules-swift.yml +22 -0
  97. package/lib/audit-rules/audit-rules-template.yml +108 -0
  98. package/lib/checks/button-bind.js +276 -0
  99. package/lib/checks/common.js +170 -0
  100. package/lib/checks/credential-file.js +43 -0
  101. package/lib/checks/dataflow.js +40 -0
  102. package/lib/checks/dispatch.js +112 -0
  103. package/lib/checks/dup-code.js +69 -0
  104. package/lib/checks/dup-const.js +232 -0
  105. package/lib/checks/file-health.js +150 -0
  106. package/lib/checks/filter.js +137 -0
  107. package/lib/checks/folder.js +173 -0
  108. package/lib/checks/hardcoded-path.js +98 -0
  109. package/lib/checks/index.js +46 -0
  110. package/lib/checks/io.js +66 -0
  111. package/lib/checks/magic-number.js +42 -0
  112. package/lib/checks/npm-json.js +273 -0
  113. package/lib/checks/private.js +63 -0
  114. package/lib/checks/regex.js +256 -0
  115. package/lib/checks/semantic.js +134 -0
  116. package/lib/checks/structural.js +274 -0
  117. package/lib/cli/commands-account.mjs +107 -0
  118. package/lib/cli/commands-audit.mjs +144 -0
  119. package/lib/cli/commands-doc.mjs +127 -0
  120. package/lib/cli/commands-vcs.mjs +175 -0
  121. package/lib/client/index.js +162 -0
  122. package/lib/client-parts/00-loader.js +33 -0
  123. package/lib/client-parts/01-const.js +207 -0
  124. package/lib/client-parts/02-utils.js +62 -0
  125. package/lib/client-parts/03-icons.js +12 -0
  126. package/lib/client-parts/10-account.js +83 -0
  127. package/lib/client-parts/11-browser.js +95 -0
  128. package/lib/client-parts/20-repo.js +374 -0
  129. package/lib/client-parts/21-audit.js +301 -0
  130. package/lib/client-parts/22-settings.js +146 -0
  131. package/lib/client-parts/23-npm.js +383 -0
  132. package/lib/client-parts/30-page.js +56 -0
  133. package/lib/client-parts/40-controller.js +1092 -0
  134. package/lib/client-parts/41-actions.js +279 -0
  135. package/lib/client-parts/99-apply.js +72 -0
  136. package/lib/client.js +3195 -0
  137. package/lib/commit-push.js +148 -0
  138. package/lib/context/index.js +363 -0
  139. package/lib/core/atomic-json.js +98 -0
  140. package/lib/core/config.js +40 -0
  141. package/lib/core/credentials.js +274 -0
  142. package/lib/core/endpoints.js +109 -0
  143. package/lib/core/exec.js +162 -0
  144. package/lib/exempt/index.js +292 -0
  145. package/lib/fs/edit-after-read.js +103 -0
  146. package/lib/fsx.js +87 -0
  147. package/lib/git/account-status.js +140 -0
  148. package/lib/git/account.js +233 -0
  149. package/lib/git/api.js +136 -0
  150. package/lib/git/atomic-json.js +6 -0
  151. package/lib/git/browse.js +38 -0
  152. package/lib/git/clone-download.js +397 -0
  153. package/lib/git/clone-history-mode.js +143 -0
  154. package/lib/git/clone-history.js +175 -0
  155. package/lib/git/clone-jobs.js +250 -0
  156. package/lib/git/clone-replay-io.js +172 -0
  157. package/lib/git/clone-replay.js +275 -0
  158. package/lib/git/clone.js +445 -0
  159. package/lib/git/cloud.js +46 -0
  160. package/lib/git/commit-message.js +141 -0
  161. package/lib/git/config.js +6 -0
  162. package/lib/git/cred-env.js +88 -0
  163. package/lib/git/credentials.js +6 -0
  164. package/lib/git/endpoints.js +6 -0
  165. package/lib/git/exec.js +6 -0
  166. package/lib/git/identity-rewrite.js +297 -0
  167. package/lib/git/identity.js +150 -0
  168. package/lib/git/ignore.js +69 -0
  169. package/lib/git/index.js +41 -0
  170. package/lib/git/module-splitter.js +47 -0
  171. package/lib/git/post-push.js +101 -0
  172. package/lib/git/push-diagnose.js +142 -0
  173. package/lib/git/push.js +476 -0
  174. package/lib/git/remote-resolve.js +146 -0
  175. package/lib/git/remote.js +128 -0
  176. package/lib/git/repo-index.js +512 -0
  177. package/lib/git/repos.js +235 -0
  178. package/lib/git/scan-runner.js +159 -0
  179. package/lib/git/sensitive.js +134 -0
  180. package/lib/git/transport.js +430 -0
  181. package/lib/git/visibility.js +35 -0
  182. package/lib/git/wrapped-git.js +68 -0
  183. package/lib/http/index.js +170 -0
  184. package/lib/index.js +24 -0
  185. package/lib/link-check/index.js +187 -0
  186. package/lib/npm/account.js +64 -0
  187. package/lib/npm/install.js +211 -0
  188. package/lib/npm/npmrc.js +56 -0
  189. package/lib/npm/publish.js +171 -0
  190. package/lib/npm/registry.js +168 -0
  191. package/lib/plugin/auto-detect.js +92 -0
  192. package/lib/plugin/auto-push.js +154 -0
  193. package/lib/plugin/index.js +250 -0
  194. package/lib/readme-templates/readme.yml +38 -0
  195. package/lib/rule/compilers/credential.js +62 -0
  196. package/lib/rule/compilers/dataflow.js +38 -0
  197. package/lib/rule/compilers/file-health.js +75 -0
  198. package/lib/rule/compilers/frontend.js +86 -0
  199. package/lib/rule/compilers/func.js +35 -0
  200. package/lib/rule/compilers/helpers.js +71 -0
  201. package/lib/rule/compilers/index.js +29 -0
  202. package/lib/rule/compilers/link-semantic.js +45 -0
  203. package/lib/rule/compilers/list-kinds.js +12 -0
  204. package/lib/rule/compilers/numeric-kinds.js +66 -0
  205. package/lib/rule/compilers/regex.js +78 -0
  206. package/lib/rule/compilers/structure.js +80 -0
  207. package/lib/rule/compilers.js +17 -0
  208. package/lib/rule/homoglyph.js +45 -0
  209. package/lib/rule/loader.js +270 -0
  210. package/lib/rule/registry.js +115 -0
  211. package/lib/rule/scope.js +67 -0
  212. package/lib/score/docs-score.js +166 -0
  213. package/lib/score/index.js +140 -0
  214. package/lib/self/index.js +196 -0
  215. package/lib/skip-dirs.js +64 -0
  216. package/lib/tool-probes.json +50 -0
  217. package/lib/user-requirements.json +14 -0
  218. package/lib/vendor/js-yaml/LICENSE +21 -0
  219. package/lib/vendor/js-yaml/js-yaml.mjs +3073 -0
  220. package/package.json +95 -4
  221. package/scripts/__pycache__/module-splitter.cpython-38.pyc +0 -0
  222. package/scripts/audit-ext/_example-readme-present.mjs +34 -0
  223. package/scripts/audit-ext/variable-min-length.mjs +102 -0
  224. package/scripts/audit-runner.mjs +35 -0
  225. package/scripts/audit-runtime-check.mjs +129 -0
  226. package/scripts/browser-page-probe.mjs +271 -0
  227. package/scripts/build-client.mjs +119 -0
  228. package/scripts/check.mjs +88 -0
  229. package/scripts/clean-date-comments.py +102 -0
  230. package/scripts/cpu-sample.mjs +188 -0
  231. package/scripts/doc-drift.mjs +200 -0
  232. package/scripts/doc-func.mjs +212 -0
  233. package/scripts/doc-tree.mjs +456 -0
  234. package/scripts/doc-version.mjs +220 -0
  235. package/scripts/frontend-preview-check.mjs +124 -0
  236. package/scripts/hot-path-probe-cjs.cjs +71 -0
  237. package/scripts/hot-path-probe-fs-shim.mjs +28 -0
  238. package/scripts/hot-path-probe-fsp-shim.mjs +31 -0
  239. package/scripts/hot-path-probe.mjs +153 -0
  240. package/scripts/module-splitter.py +800 -0
  241. package/scripts/platform-scan.mjs +168 -0
  242. package/scripts/preview-gen.mjs +489 -0
  243. package/scripts/preview-local-runner.mjs +55 -0
  244. package/scripts/preview-server-direct.mjs +116 -0
  245. package/scripts/preview-server.mjs +305 -0
  246. package/scripts/preview-slot-data.mjs +123 -0
  247. package/scripts/probe-recheck.mjs +47 -0
  248. package/scripts/readme-gen.mjs +268 -0
  249. package/scripts/rename-locator.mjs +97 -0
  250. package/scripts/rule-switch.mjs +97 -0
  251. package/scripts/rules-solo-audit.mjs +173 -0
  252. package/scripts/scan-file-io.mjs +713 -0
  253. package/scripts/scan-hardcoded-paths.mjs +125 -0
  254. package/scripts/scan-repos.mjs +167 -0
  255. package/scripts/scan-version.mjs +122 -0
  256. package/scripts/scrub-user-wording.mjs +420 -0
  257. package/scripts/symbol-index.mjs +85 -0
  258. package/scripts/sync-plugin-install.mjs +223 -0
  259. package/scripts/sync-plugin.mjs +279 -0
  260. package/scripts/verify-prestep.mjs +100 -0
  261. package/skills/dev/audit-rule-authoring.md +58 -0
  262. package/skills/dev/dsh-git-push.md +323 -0
  263. package/skills/dev/git-push-live-fix.md +45 -0
  264. package/skills/dsh-repo-index.md +35 -0
  265. package/skills/guide/guide-audit.md +167 -0
  266. package/skills/guide/guide-cli-scripts.md +104 -0
  267. package/skills/guide/guide-clone-repos.md +173 -0
  268. package/skills/guide/guide-commit-push.md +156 -0
  269. package/skills/guide/guide-inject-ui.md +166 -0
  270. package/skills/guide/guide-slash-completion.md +118 -0
  271. package/skills/workflow/README.md +21 -0
  272. package/skills/workflow/git-commit-discipline.md +68 -0
  273. package/skills/workflow/git-project-startup.md +85 -0
  274. package/skills/workflow/git-rebuild-process.md +57 -0
  275. package/skills/workflow/github-operations.md +91 -0
  276. package/skills/workflow/readme-sync-git-md.md +28 -0
  277. package/skills/workflow/task-completion-report.md +73 -0
  278. package/skills/workflow/tool-json-add-ask.md +35 -0
  279. package/skills/workflow/versioning-rule.md +211 -0
@@ -0,0 +1,211 @@
1
+ ---
2
+ name: versioning-rule
3
+ description: 版本号规则(X.Y.Z 语义 + **版本号只在提交时变化** + **0.x 合法开发期、1.0 稳定线**(2026-10-02 修订,对齐 SemVer 2.0.0 §4 + Go/Cargo 官方)+ **大版本换代判定:结构不同 = 大版本+1**)——适用于本机所有 DSH 自研插件(dsh-*)与 gamebanana-mods-downloader(gbmd)三组件。涉及任何版本号更新、发版、打包、CRX 命名、新建插件、判断新旧版本/自更新时加载;约束所有 AI 所有会话一律遵守。
4
+ whenToUse: 更新任意 DSH 自研插件或 gbmd 组件的版本号、打包 CRX、写更新日志版本号、统计提交版本、新建 dsh-* 插件项目(package.json 写 version)、自更新/版本比对、判断远端是否为新版本时。
5
+ generatedBy: deepseek-official/deepseek-v4-flash + EIGHTfs 2026-08-20(补充大版本换代判定)+ 2026-08-21(确立:版本只在提交时变化)+ 2026-10-02(修订:0.x 合法开发期——调研 SemVer 2.0.0 §4、Go v0、Cargo 0.y.z 语义后重设计)
6
+ ---
7
+
8
+ # 版本号规则(versioning-rule)
9
+
10
+ > **权威源 = dsh-git-push 插件项目 skills/**(版本控制 skill 归 dsh-git-push 插件权威,2026-08-21 确立);公用目录 .dsh/skills 与 ai-work-archive 为副本。(X.Y.Z 语义 + 版本只在提交时变化 + 0.x 合法开发期/1.0 稳定线 + 大版本换代判定)
11
+
12
+ > 适用范围(2026-08-18 扩展):**本机所有 DSH 自研插件(dsh-*)** + gamebanana-mods-downloader 三组件(浏览器扩展/Server/画廊)。
13
+ > ⚠️ **版本线(2026-10-02 修订,原「1 开头硬规则」废弃)**:**0.x 是合法开发期**(SemVer 2.0.0 §4:主版本号为零的软件处于开发初始阶段,一切都可能随时被改变);**1.0.0 是稳定线**(正式环境使用 / 公共 API 稳定被依赖 / 开始担心向下兼容时升 1.0)。禁止把 0.x 当「不合规」强制修正——0.x 序列合法,达到稳定才升 1.0。
14
+
15
+ ## 零、⭐ 核心规则:版本号只在提交时变化(2026-08-21 确立,最高优先)
16
+
17
+ > **原话**:「版本控制只在提交时变化,比如 2.0.0 哪怕开发 10 几个功能,也只是提交一次,保存 2.1.0」
18
+
19
+ - **版本号只在提交(commit)时变化**:开发过程中无论做了多少功能、改了多少代码,版本号一律不动
20
+ - **一次提交 = 一个小版本**:提交一次保存时,版本号升一个小版本(**2.0.0 → 2.1.0**)
21
+ - **功能个数不决定版本号**:哪怕开发 10 几个功能,只要只提交一次,版本号也只升一个小版本(2.1.0),**绝不按功能数逐个升**
22
+ - 一句话:**版本号指向「提交存档」而非「功能进度」**——Y = 第几次提交存档,不是第几个功能
23
+
24
+ ### 落地细则
25
+
26
+ 1. **开发期(未提交)**:`package.json` 等版本字段保持当前值不变,不随功能开发逐个改动
27
+ 2. **提交时**:先把版本号 Y+1(Z 归 0),再提交;提交信息里的版本号与 package.json 一致
28
+ 3. **一次提交内含的功能数不限**:版本号只反映提交存档次序,不反映功能数量
29
+ 4. **子功能新增/修复提交**:同一提交版本存档后,新增子功能(全新或修复/更新)→ Y 不变、Z 累加(仍只在提交时变化)
30
+ 5. **大版本换代**(结构不同 X+1,见第三节)仍按提交时变化执行——一次提交内可同时完成 X+1
31
+ 6. **0.x 开发期同样遵守**:模块版本只在提交时变化(0.1.0 → 0.2.0 也是一次提交)
32
+
33
+ ### ⭐ 项目级覆盖示例:dsh-git-push 重构版(2026-09 用户绑定,不改变通用规则)
34
+
35
+ > 适用项目 = **dsh-git-push 重构版(workspace 下重建的 v2 项目)**。此项目用户明确要求:
36
+ > **版本号只在提交时变化 + bug 修复只动第三位(1.0.x)+ 1.1.0 仅在已知 bug 全部修完时才有资格**。
37
+ > 这是对「第零节提交节奏」的本项目特例覆盖,其他 dsh-* 项目仍按通用规则(提交升 Y)。
38
+
39
+ - **bug 修复**:1.0.3 → 1.0.4(**第三位** +1,Y 不动)——每修一批 bug、通过双扫描 + 测试,提交一次
40
+ - **1.1.0(Y+1)**:**仅当「已知 bug 已全部修完」** 才允许(不是改了点东西就升 1.1.0)
41
+ - **阶段**:当前处于 1.0.x(修 bug 集),1.1.0 是「已知 bug 清零」里程碑
42
+ - **提交纪律**(本项目):commit msg 格式 `<版本> <入口名>:做了什么`;本地 master 提交,**不推送远端**(除非用户另行授权)
43
+ - **验证门槛**(本项目每次提交前):npm test 全绿 + 双扫描 0 blocker + README/WORKBOARD 版本行同步
44
+
45
+ ### 正反例
46
+
47
+ - ✅ 2.0.0 开发了 10 几个功能,只提交一次 → 存档为 **2.1.0**(不管功能数)
48
+ - ❌ 2.0.0 每开发一个功能就升一次版本(2.0.0 → 2.1.0 → 2.2.0 → 2.3.0…)——**禁止**,版本不按功能数升
49
+ - ✅ 2.1.0 提交后修了 3 次 bug,3 次补丁提交 → 2.1.3
50
+ - ✅ 项目重构为新结构,一次提交 → 大版本 +1(如 2.1.0 → 3.0.0)
51
+
52
+ ## 一、规则(X.Y.Z 语义)
53
+
54
+ - 格式:**X.Y.Z**(三个小数段)
55
+ - **X** = 大版本(重大重构/不兼容变更才 +1;**X 从 0 起合法**——0.x 为开发初始阶段,SemVer §4;达到稳定后 X ≥ 1)
56
+ - **Y** = 提交版本序号(**每次提交 +1**;一次提交可含任意多个功能)
57
+ - **Z** = **新增子功能数量**(全新的子功能 + 子功能的修复及更新都计入;2026-08-21 更清晰定义)
58
+ - 版本号指向**当前最新提交的存档进度**(不是功能数/全局累计)
59
+ - **1.0.0(Y=0)默认含义**:**不含代码**的架构设计文档 + 任务清单 + README 文档(项目初始交付物,还没有任何功能代码;第一个功能提交落地才升到 1.1.0)
60
+
61
+ ## 二、⭐ 版本线:0.x 合法开发期 → 1.0 稳定线(2026-10-02 修订,原「1 开头硬规则」废弃)
62
+
63
+ > 依据调研(2026-10-02,来源记录见 ai-work-archive/开发者文档/版本号设计调研-SemVer与业界实践-20261002.md):
64
+ > - **SemVer 2.0.0 §4**:主版本号为零(0.y.z)的软件处于开发初始阶段,一切都可能随时被改变;
65
+ > - **SemVer FAQ**:0.y.z 阶段以 0.1.0 起步、每次发行递增次版本号;主版本号为零就是为了做快速开发;
66
+ > - **Go 官方**:v0 = 开发中不稳定、无兼容承诺;v1+ 允许对 v0 用户做不兼容变更;
67
+ > - **Cargo**:0.y.z 中 y 变化按 major 处理、z 变化按 minor 处理、0.0.z 永远算 major。
68
+
69
+ ### 落地规则
70
+
71
+ 1. **0.x = 合法开发期**:新插件/项目可从 `0.1.0` 起步(开发中、API 未定型、无稳定承诺),**不强制 1 开头**
72
+ 2. **0.x 阶段语义**(对齐 Cargo 压缩版):
73
+ - `0.Y` 递增 = **不兼容/大变更**(相当于 1.x 的 major bump)——开发期 API 随便改,bump 次版本即可
74
+ - `0.Z` 递增 = **兼容新增**(相当于 minor)
75
+ - `0.0.Z` 递增 = **重大变化**(0.0.x 是最早原型期,任何改动都是破坏性的)
76
+ 3. **1.0.0 = 稳定线**(SemVer FAQ + Go):达到以下任一即应升 1.0——
77
+ - 软件被用于**正式环境**
78
+ - 公共 API **稳定且被使用者依赖**
79
+ - 开始**担心向下兼容**问题
80
+ 4. **升 1.0 后**:X ≥ 1,完整 major/minor/patch 语义(不兼容变更 X+1、兼容新增 Y+1、修复 Z+1)
81
+ 5. **0.x 不当作「不合规」**:禁止「0.x → 1.x 强制修正」(0.2.0 → 1.2.0 之类除非用户明确要求)
82
+ 6. **例外场景**:内置模块(待 burn-in)0.x 起步照旧(本就在 0.x 合法范围内);第三方依赖版本由上游决定不改
83
+
84
+ ### 反面教材(2026-08-18 旧规,保留作历史)
85
+
86
+ > 旧规曾把 dsh-session-manager 0.1.0→0.10.0 序列强制修正为 1.x(0.10.0 → 1.10.0)。
87
+ > **2026-10-02 修订后此为历史教训而非现行做法**:0.x 序列本身合法,无需修正;
88
+ > 真正该做的是——项目达到稳定(正式环境/稳定 API)时**主动规划升 1.0**,而不是把 0.x 当错误强改。
89
+
90
+ ### ⭐ 例外:内置模块版本从 0 开始(2026-08-19 补充,与 0.x 合法化一致)
91
+
92
+ - **内置模块** = 独立开发、最终 **burn-in 内置进正式插件**的小模块(如 dsh-workflow-audit → 并入 dsh-session-manager;开发模式见 dsh-link-bridge skill)
93
+ - 这类模块**独立阶段版本从 0 开始**:`v0.1.0` 起步(0.x = 待内置、未并入主插件)
94
+ - **内置成功后**:模块不再有独立版本,随主插件版本走(主插件 1.x)
95
+ - 适用示例:**dsh-workflow-audit v0.1.0**(2026-08-19 起)
96
+ - **版本只在提交时变化同样适用**:模块开发期版本不动,提交时 0.1.0 → 0.2.0(见第零节)
97
+
98
+ ### 1.0.0 vs 0.1.0 的对应关系(2026-08-19 补充,⚠️ 必读)
99
+
100
+ - **插件主版本 `1.0.0`** = 无代码文档版:架构设计 + **模块设计思路** + 任务清单 + README(还没有任何功能代码)
101
+ - **功能模块实际写出来**(开始有代码)→ 该模块版本 = **`0.1.0`**(第一个功能,待内置)
102
+ - **每个功能模块都从 `0.1.0` 开始**(不是按模块序号排:第二个模块也是 0.1.0 起步)
103
+ - **模块内部有新功能/完善 → 提交时升 0.2**:0.1.0 → 0.2.0 → 0.3.0...(Y = 该模块的第几次提交存档,Z = 新增子功能数量;版本只在提交时变化)
104
+ - 全部内置完成后:插件升 1.1.0(首个功能落地),后续模块内置随插件版本走
105
+
106
+ ## 三、⭐ 大版本换代判定(2026-08-20 确立,自更新/版本比对必读)
107
+
108
+ > **结构不同 = 大版本换代(大版本 + 1)**。这条规则用于「判断远端版本是否真的是可自动更新的新版本」。
109
+
110
+ ### 核心规则
111
+
112
+ 1. **结构不同(structureMismatch)= 本地已处于新大版本结构(旧系列大版本 + 1)**
113
+ 2. 旧结构的版本号(即使数字更高,如 1.13.0)属于**旧大版本系列**,**永远不构成"可自动更新的新版本"**
114
+ 3. 新旧结构切换必须**人工处理**或等待新版本(同结构)正式提交——**禁止自动用旧结构覆盖新代码**
115
+
116
+ ### 判定示例(dsh-git-rescue 实测,2026-08-20)
117
+
118
+ | 本地 | 远端 | 远端结构 | 判定 | 处理 |
119
+ |------|------|----------|------|------|
120
+ | 2.0.0(新根级结构) | 1.13.0(旧 components/ 子树) | 旧 | updateAvailable=true(版本号更高是事实)但 majorUpgrade=true | **不自动更新**,人工/等新版本提交 |
121
+ | 2.0.0 | 2.0.0(根级) | 同 | updateAvailable=false | 已是最新 |
122
+ | 2.0.0 | 2.1.0(根级) | 同 | updateAvailable=true + majorUpgrade=false | 可自动更新 |
123
+
124
+ ### 落地(dsh-git-rescue 自更新)
125
+
126
+ - `lib/self-update.js` 的 `checkForUpdate()`:
127
+ - 版本来源探测:根级 `package.json` 优先,旧位置 `components/git-rescue/package.json` 回退(**如实报告远端版本号**)
128
+ - 结构校验:远端根必须存在 `lib/index.js`(新大版本结构)→ `structureMismatch` + `majorUpgrade`
129
+ - 返回 `{ updateAvailable, structureMismatch, majorUpgrade, detail }`
130
+ - `applyUpdate()`:遇 `structureMismatch`/`majorUpgrade` **拒绝执行**(防旧结构覆盖新代码)
131
+ - 单测:T9/T9.5/T9.6(compareVersions / allowlist 路径 / 真实远端结构判定)
132
+
133
+ ### 操作指引(遇到版本比对/自更新判断时)
134
+
135
+ 1. 读远端 `package.json` 版本号(根级优先,旧位置回退)——**如实报告**
136
+ 2. 检查远端结构是否与本地一致(根级 `lib/` 是否存在)——**结构不同 = 大版本换代**
137
+ 3. 结构相同才允许自动更新;结构不同 → 人工处理 / 等新版本提交
138
+
139
+ ## 三·补、⭐ 子功能版本线(2026-08-21 确立,权威)
140
+
141
+ > 子功能(插件内 git 版本管理 / guardian / 自动更新等)独立计版本,两条规则线:
142
+
143
+ | 子功能版本 | 含义 | 递增规则 |
144
+ |-----------|------|---------|
145
+ | **0 开头**(0.x) | 目录结构不兼容(不能覆盖实现更新)| 换代/不兼容即用 0 开头;**功能缺失导致救援(插件设计目的)失败 +1** |
146
+ | **1 开头**(1.x) | 结构兼容,正常功能演进 | **新增几种功能 +几**(每新增一种子功能版本 +1) |
147
+
148
+ - **0 开头场景**:子功能结构不兼容(无法简单覆盖更新)→ 从 0 重新计;期间每补一个"功能缺失导致救援失败"的漏洞 Z+1
149
+ - **1 开头场景**:新增子功能(全新)→ 版本 +1;子功能的修复/更新也计入(Z 累加)
150
+ - 示例(dsh-git-rescue 重建实测):git 版本管理 0.1.2(0 起步 + 2 次修复)、guardian 自动救援 0.1(0 起步 1 功能)、自动更新 1.1(1 起步新增 1 功能)
151
+
152
+ ## 四、示例(已实测确认)
153
+
154
+ | 场景 | 版本 | 说明 |
155
+ |---|---|---|
156
+ | 2.2.3 | 第 2 次提交存档 | 该提交版本修了 3 次 bug |
157
+ | 2.5.1 | 第 5 次提交存档 | 该提交版本修了 1 次 bug |
158
+ | 1.4.0 | 第 4 次提交存档 | 该提交版本还没修过 bug |
159
+ | 1.0.0 | 初始版本 | 默认=不含代码:架构设计 + 任务清单 + README |
160
+ | 2.0.0 → 2.1.0 | 开发 10 几个功能、只提交一次 | 不管功能数,一次提交只升一个小版本(2026-08-21 确立) |
161
+
162
+ ## 五、DSH 自研插件当前版本基线(2026-08-18 检修后均为 1.x;2026-10-02 修订:0.x 合法,此表为历史现状参考)
163
+
164
+ | 插件 | 版本 | 插件 | 版本 |
165
+ |---|---|---|---|
166
+ | dsh-session-manager | 1.10.0 | dsh-git-rescue | **2.0.0(2026-08-20 重构,旧 1.13.0 → 新大版本 2.0.0)** |
167
+ | dsh-whale-musume | 1.3.0 | dsh-bili-publisher | 1.2.0 |
168
+ | dsh-shift-router-src | 1.5.0 | dsh-session-search | 1.0.0 |
169
+ | dsh-ai-work-archive / dsh-git-push / dsh-image-preview / dsh-header-layout / dsh-model-router-v2 / dsh-session-group / dsh-task-completion / dsh-test-env-entry / dsh-test-sync-plugin | 1.0.0 | | |
170
+
171
+ ## 六、落地位置
172
+
173
+ - **DSH 插件**:`package.json` 的 `version` 字段(唯一权威位置;插件加载信息、client bundle rev 均以它为准)
174
+ - gbmd 扩展:`extension/manifest.json` 的 `version`(MV3 要求 X.Y.Z 三段)
175
+ - gbmd Server:`server/package.json` + `server/app.js` 启动日志(`gbmd-server vX.Y.Z 已启动`)
176
+ - gbmd 画廊:`gallery/server.js` 头部注释(`gbmd-gallery vX.Y.Z`)
177
+ - README:更新日志标题(新功能提交必须整理 README 版本记录,见 release-docs-rule)
178
+ - CRX 打包名:`gamebanana-mods-downloader-vX.Y.Z.crx`
179
+
180
+ ## 七、更新步骤(每次发版 / 改版本)
181
+
182
+ 1. **确认当前版本号**(开发期版本号一律不动,见第零节)
183
+ 2. **有功能/变更待提交** → 版本号升一个小版本:Y+1、Z 归 0(提交一次一个小版本,不按功能数升)
184
+ 3. **数清该提交版本修了几次 bug Z**(bug 补丁提交 Y 不变、Z+1)
185
+ 4. **检查版本是否达到 1.0 稳定线**——0.x 合法(开发期);若已正式环境使用/稳定 API 被依赖,则规划升 1.0(见第二节)
186
+ 5. **判断是否大版本换代**(结构是否变化)——结构变了则 X+1(见第三节)
187
+ 6. 改对应文件的 version 字段(DSH 插件=package.json;gbmd=各自位置)
188
+ 7. 同步 README 更新日志标题(release-docs-rule:新功能必须整理 README)
189
+ 8. 部署副本同步(主实例 `~/.dsh/profiles/web/node_modules/<插件>/package.json`、测试实例 `node_modules_local`)
190
+ 9. 提交(**提交即存档新版本号**;推送另按提交推送纪律)
191
+
192
+ ## 八、检修清单(发现/怀疑版本号问题时)
193
+
194
+ - [ ] 扫 `package.json` version 是否 0.x(`grep '"version"' */package.json | grep '"0\.'`)——**0.x 合法(开发期)**,核对是否已达稳定线该升 1.0;不达稳定继续 0.x 即可,不做强制修正
195
+ - [ ] 已达稳定(正式环境/稳定 API)→ 升 1.0.0(同步主实例/测试实例部署副本)
196
+ - [ ] 第三方依赖(@deepseek-ai/@dsh-external)跳过
197
+ - [ ] 0.x 项目核对稳定线(正式环境/稳定 API)——达标则升 1.0;未达标保持 0.x(合法开发期)
198
+ - [ ] 结构是否变化(自更新是否会被旧结构版本误导)——结构不同 = 大版本换代
199
+ - [ ] **版本号是否只在提交时变化**——开发期乱升版本号(按功能数逐个升)要修正为提交时一次性升
200
+
201
+ ## 九、注意
202
+
203
+ - **版本只在提交时变化(2026-08-21 确立)**:开发多少功能都不升版本,提交一次升一个小版本(2.0.0 → 2.1.0);功能个数不决定版本号
204
+ - 功能"加→改→移除→恢复"算 **1 个功能**;移除+恢复合计算 1 次改动(功能计数只在整理 README 时用,不决定版本号)
205
+ - 合并类提交(如"gameIdFixes 合并")算独立功能还是子步骤,按功能主题判断(只影响 README 描述,不影响版本号规则)
206
+ - 无法确定时,读 git log 按提交主题归类,或问用户
207
+ - 看到 **1.0.0** 一律按「无代码文档版」处理(架构设计+任务清单+README),不要误以为有功能;有代码的第一个功能提交落地从 1.1.0 起
208
+ - **看到旧结构高版本号(如 1.13.0)不要误判为可自动更新的新版本**——结构不同 = 大版本换代(第三节)
209
+
210
+ ## 相关
211
+