dsh-stm32 0.1.2 → 0.1.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 +92 -40
- package/README_EN.md +85 -36
- package/assets/README.md +85 -0
- package/assets/VERSION +1 -0
- package/assets/device/c0/chips.json +1108 -0
- package/assets/device/f0/chips.json +1570 -0
- package/assets/device/f1/chips.json +1238 -0
- package/assets/device/f1/svd/100.json +943 -0
- package/assets/device/f1/svd/101.json +901 -0
- package/assets/device/f1/svd/102.json +522 -0
- package/assets/device/f1/svd/103.json +1139 -0
- package/assets/device/f1/svd/105.json +1117 -0
- package/assets/device/f1/svd/107.json +1195 -0
- package/assets/device/f2/chips.json +674 -0
- package/assets/device/f3/chips.json +1318 -0
- package/assets/device/f4/chips.json +2942 -0
- package/assets/device/f7/chips.json +1710 -0
- package/assets/device/g0/chips.json +2102 -0
- package/assets/device/g4/chips.json +2494 -0
- package/assets/device/h5/chips.json +898 -0
- package/assets/device/h7/chips.json +1948 -0
- package/assets/device/l0/chips.json +2494 -0
- package/assets/device/l1/chips.json +1234 -0
- package/assets/device/l4/chips.json +2130 -0
- package/assets/device/l4+/chips.json +856 -0
- package/assets/device/l5/chips.json +226 -0
- package/assets/device/u0/chips.json +688 -0
- package/assets/device/u3/chips.json +310 -0
- package/assets/device/u5/chips.json +884 -0
- package/assets/device/wba/chips.json +506 -0
- package/assets/device/wl/chips.json +184 -0
- package/assets/headers/f1/stm32f100xb.h +5972 -0
- package/assets/headers/f1/stm32f100xe.h +6587 -0
- package/assets/headers/f1/stm32f101x6.h +5315 -0
- package/assets/headers/f1/stm32f101xb.h +5446 -0
- package/assets/headers/f1/stm32f101xe.h +6503 -0
- package/assets/headers/f1/stm32f101xg.h +6713 -0
- package/assets/headers/f1/stm32f102x6.h +6448 -0
- package/assets/headers/f1/stm32f102xb.h +6570 -0
- package/assets/headers/f1/stm32f103x6.h +10109 -0
- package/assets/headers/f1/stm32f103xb.h +10240 -0
- package/assets/headers/f1/stm32f103xe.h +11767 -0
- package/assets/headers/f1/stm32f103xg.h +11951 -0
- package/assets/headers/f1/stm32f105xc.h +14340 -0
- package/assets/headers/f1/stm32f107xc.h +15253 -0
- package/assets/headers/f1/stm32f1xx.h +273 -0
- package/assets/headers/f1/system_stm32f1xx.h +96 -0
- package/assets/ioc/family/C0.ioc +82 -0
- package/assets/ioc/family/F0.ioc +71 -0
- package/assets/ioc/family/F2.ioc +91 -0
- package/assets/ioc/family/F3.ioc +94 -0
- package/assets/ioc/family/F4.ioc +91 -0
- package/assets/ioc/family/F7.ioc +102 -0
- package/assets/ioc/family/G0.ioc +90 -0
- package/assets/ioc/family/G4.ioc +110 -0
- package/assets/ioc/family/H5.ioc +116 -0
- package/assets/ioc/family/H7.ioc +133 -0
- package/assets/ioc/family/L0.ioc +92 -0
- package/assets/ioc/family/L1.ioc +87 -0
- package/assets/ioc/family/L4+.ioc +92 -0
- package/assets/ioc/family/L4.ioc +93 -0
- package/assets/ioc/family/L5.ioc +91 -0
- package/assets/ioc/family/U0.ioc +103 -0
- package/assets/ioc/family/U3.ioc +113 -0
- package/assets/ioc/family/U5.ioc +102 -0
- package/assets/ioc/family/WBA.ioc +100 -0
- package/assets/ioc/family/WL.ioc +93 -0
- package/assets/ioc/minimal/STM32F100C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F100RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101C4Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101RFTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F102C4Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F102C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103C4Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103RFTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F105RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F107RCTx.ioc +113 -0
- package/assets/ld/f1/STM32F100C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F100RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101C4Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101RFTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F102C4Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F102C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103C4Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103RFTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F105RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F107RCTx_FLASH.ld +249 -0
- package/assets/manifest.json +1130 -0
- package/assets/startup/f1/startup_stm32f100xb.s +407 -0
- package/assets/startup/f1/startup_stm32f100xe.s +449 -0
- package/assets/startup/f1/startup_stm32f101x6.s +322 -0
- package/assets/startup/f1/startup_stm32f101xb.s +338 -0
- package/assets/startup/f1/startup_stm32f101xe.s +423 -0
- package/assets/startup/f1/startup_stm32f101xg.s +439 -0
- package/assets/startup/f1/startup_stm32f102x6.s +330 -0
- package/assets/startup/f1/startup_stm32f102xb.s +346 -0
- package/assets/startup/f1/startup_stm32f103x6.s +348 -0
- package/assets/startup/f1/startup_stm32f103xb.s +364 -0
- package/assets/startup/f1/startup_stm32f103xe.s +470 -0
- package/assets/startup/f1/startup_stm32f103xg.s +466 -0
- package/assets/startup/f1/startup_stm32f105xc.s +463 -0
- package/assets/startup/f1/startup_stm32f107xc.s +472 -0
- package/assets/templates/family/C0.ioc +82 -0
- package/assets/templates/family/F0.ioc +71 -0
- package/assets/templates/family/F2.ioc +91 -0
- package/assets/templates/family/F3.ioc +94 -0
- package/assets/templates/family/F4.ioc +91 -0
- package/assets/templates/family/F7.ioc +102 -0
- package/assets/templates/family/G0.ioc +90 -0
- package/assets/templates/family/G4.ioc +110 -0
- package/assets/templates/family/H5.ioc +116 -0
- package/assets/templates/family/H7.ioc +133 -0
- package/assets/templates/family/L0.ioc +92 -0
- package/assets/templates/family/L1.ioc +87 -0
- package/assets/templates/family/L4+.ioc +92 -0
- package/assets/templates/family/L4.ioc +93 -0
- package/assets/templates/family/L5.ioc +91 -0
- package/assets/templates/family/U0.ioc +103 -0
- package/assets/templates/family/U3.ioc +113 -0
- package/assets/templates/family/U5.ioc +102 -0
- package/assets/templates/family/WB.ioc +81 -0
- package/assets/templates/family/WBA.ioc +100 -0
- package/assets/templates/family/WL.ioc +93 -0
- package/docs/reading-guide.md +94 -71
- package/lib/data/chips.js +38 -51
- package/lib/data/clock-db.js +830 -0
- package/lib/data/clock-f1.js +12 -45
- package/lib/data/cmsis-sources.js +264 -17
- package/lib/data/db-presets.js +252 -0
- package/lib/data/device-facts.js +274 -0
- package/lib/data/family.js +515 -0
- package/lib/data/firmware-packages.js +562 -0
- package/lib/data/install-guides.js +2 -2
- package/lib/data/ioc-presets.js +248 -0
- package/lib/data/ioc-schema.js +1058 -0
- package/lib/data/rm-topics/stm32c0.json +227 -0
- package/lib/data/rm-topics.js +103 -0
- package/lib/data/search-roots.js +42 -1
- package/lib/data/stm32f1.js +95 -150
- package/lib/data/svd.js +643 -0
- package/lib/data/toolchain-config.js +0 -14
- package/lib/engine/assets.js +659 -0
- package/lib/engine/breakpoints.js +297 -0
- package/lib/engine/clock-derived.js +101 -0
- package/lib/engine/clock-direct.js +313 -0
- package/lib/engine/clock-plan.js +96 -52
- package/lib/engine/clock-pllmn.js +319 -0
- package/lib/engine/cmake-sources.js +67 -13
- package/lib/engine/cube-mx-guard.js +44 -0
- package/lib/engine/cube-programmer.js +137 -0
- package/lib/engine/cubemx-db.js +273 -0
- package/lib/engine/debug-session.js +576 -22
- package/lib/engine/debug.js +99 -46
- package/lib/engine/doctor.js +162 -19
- package/lib/engine/facts-acquire.js +416 -0
- package/lib/engine/facts.js +134 -0
- package/lib/engine/firmware-install.js +176 -5
- package/lib/engine/firmware-official.js +451 -0
- package/lib/engine/flash.js +317 -76
- package/lib/engine/gdb-mi.js +476 -0
- package/lib/engine/generate.js +9 -2
- package/lib/engine/hal-chip.js +124 -41
- package/lib/engine/ioc-plan.js +1247 -63
- package/lib/engine/ioc-rules.js +698 -0
- package/lib/engine/ioc-verify.js +706 -0
- package/lib/engine/ioc.js +43 -4
- package/lib/engine/msys2-install.js +4 -4
- package/lib/engine/probe-error.js +231 -0
- package/lib/engine/probe-session.js +347 -0
- package/lib/engine/probe.js +18 -3
- package/lib/engine/register-clock.js +41 -0
- package/lib/engine/register-gpio.js +115 -0
- package/lib/engine/register-linker.js +12 -7
- package/lib/engine/register-template.js +130 -45
- package/lib/engine/regs.js +43 -8
- package/lib/engine/rm-extract.js +144 -0
- package/lib/engine/rm-sources.js +360 -0
- package/lib/engine/rm-text.js +56 -0
- package/lib/engine/rtt.js +758 -0
- package/lib/engine/scaffold.js +185 -18
- package/lib/engine/toolchain-gate.js +0 -4
- package/lib/engine/watch.js +227 -0
- package/lib/index.js +12 -2
- package/lib/skill/stm32-workflow.js +2 -2
- package/lib/tools/assets.js +272 -0
- package/lib/tools/cache.js +8 -0
- package/lib/tools/debug-session.js +41 -6
- package/lib/tools/debug.js +41 -11
- package/lib/tools/doctor.js +65 -4
- package/lib/tools/firmware-install.js +31 -6
- package/lib/tools/flash.js +47 -10
- package/lib/tools/generate.js +25 -0
- package/lib/tools/ioc-apply.js +2 -0
- package/lib/tools/ioc-inspect.js +2 -0
- package/lib/tools/ioc-plan.js +59 -2
- package/lib/tools/ioc-verify.js +237 -0
- package/lib/tools/project-create.js +63 -3
- package/lib/tools/regs.js +453 -61
- package/lib/tools/route-plan.js +3 -0
- package/lib/tools/rtt.js +470 -0
- package/lib/tools/watch.js +256 -0
- package/package.json +5 -4
- package/templates/openocd/stm32c0x.cfg +83 -0
- package/templates/openocd/stm32u0x.cfg +64 -0
- package/templates/register/CMakeLists.txt +8 -2
- package/templates/register/Core/Inc/rtt.h +138 -0
- package/templates/register/Core/Src/main.c +42 -25
- package/templates/register/Core/Src/rtt.c +373 -0
- package/templates/scaffold/RTT.md +90 -0
- package/templates/scaffold/STM32F103XX_FLASH.ld +3 -0
- package/templates/scaffold/cmake/user/CMakeLists.txt +7 -0
- package/templates/scaffold/openocd.cfg +5 -3
- package/templates/scaffold/vscode/launch.json +8 -4
- package/docs/development-notes.md +0 -2116
- package/docs/dsh-stm32-plugin-/350/247/204/346/240/274.md +0 -673
- package/docs/logic-audit.md +0 -607
- package/lib/data/f1-ram.generated.js +0 -34
|
@@ -0,0 +1,659 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 内置资源层:assets/ 随插件包发布,读 manifest + 逐文件 sha256 校验。
|
|
3
|
+
*
|
|
4
|
+
* 2026-11 之前资源放在独立仓库 dsh-stm32-assets,第一次用要联网下载到 ~/.dsh-stm32/assets/<version>/。
|
|
5
|
+
* 资产总共 12.5 MB,拆两个仓库的维护成本(发版要对齐、下载会失败、离线不可用)大于收益,于是整体并入插件:
|
|
6
|
+
* · 默认根 = 插件包内的 assets/(flat:manifest.json 与 device/、ioc/ 同层);
|
|
7
|
+
* · DSH_STM32_ASSETS 仍可覆盖(测试夹具、以及老用户留着旧版本缓存时继续可读);
|
|
8
|
+
* · 老布局 <root>/<version>/install.json 继续认,flat 优先。
|
|
9
|
+
*
|
|
10
|
+
* 关键约定:
|
|
11
|
+
* · 不再有网络下载器:ensureAssets 是纯本地检查,缺文件只可能是插件安装不完整;
|
|
12
|
+
* · sha256 仍逐文件校验(verify):内置不等于可信,装坏/被杀软改过要能查出来;
|
|
13
|
+
* · 失败不抛:都变成 ok:false + 人话原因,工具卡片照常渲染;
|
|
14
|
+
* · prune 绝不删内置 flat 根,只清 DSH_STM32_ASSETS 下的历史版本目录。
|
|
15
|
+
*
|
|
16
|
+
* 零运行时依赖:只用 node:fs / node:path / node:crypto / node:url。
|
|
17
|
+
*/
|
|
18
|
+
import { createHash } from "node:crypto";
|
|
19
|
+
import fs from "node:fs";
|
|
20
|
+
import path from "node:path";
|
|
21
|
+
import { fileURLToPath } from "node:url";
|
|
22
|
+
export const ASSETS_MANIFEST_FILE = "manifest.json";
|
|
23
|
+
/** 老版本安装布局的标记文件(flat 内置资源没有它)。 */
|
|
24
|
+
export const ASSETS_INSTALL_FILE = "install.json";
|
|
25
|
+
/** 设备事实在资源根里的相对路径(插件唯一的芯片事实来源)。 */
|
|
26
|
+
export const ASSETS_DEVICE_FACTS_FILE = "device/f1/chips.json";
|
|
27
|
+
/** 缺资源时对用户说的那句话(工具卡片、错误、note 都复用它,避免各写一套)。 */
|
|
28
|
+
export const ASSETS_REFRESH_HINT = "资源随插件内置(assets/):缺文件说明插件安装不完整,重装插件后重试;stm32_assets verify 可定位缺了哪些";
|
|
29
|
+
/** 只给 core / full;空串按 core 处理,别的值返回 null(由调用方给可读报错,不瞎猜)。 */
|
|
30
|
+
export function normalizeProfile(value) {
|
|
31
|
+
const text = (value ?? "core").trim().toLowerCase();
|
|
32
|
+
if (text === "")
|
|
33
|
+
return "core";
|
|
34
|
+
if (text === "core" || text === "full")
|
|
35
|
+
return text;
|
|
36
|
+
return null;
|
|
37
|
+
}
|
|
38
|
+
/** 插件包内的 assets/:lib/engine/assets.js 往上两级就是包根。 */
|
|
39
|
+
export function bundledAssetsRoot() {
|
|
40
|
+
const here = path.dirname(fileURLToPath(import.meta.url));
|
|
41
|
+
return path.resolve(here, "..", "..", "assets");
|
|
42
|
+
}
|
|
43
|
+
function expandHome(value, env) {
|
|
44
|
+
if (value === "~" || value.startsWith("~/") || value.startsWith("~\\")) {
|
|
45
|
+
const home = (env.USERPROFILE ?? env.HOME ?? "").trim();
|
|
46
|
+
if (home !== "")
|
|
47
|
+
return path.join(home, value.slice(1));
|
|
48
|
+
}
|
|
49
|
+
return value;
|
|
50
|
+
}
|
|
51
|
+
/** 资源根目录:DSH_STM32_ASSETS 覆盖,默认插件包内 assets/。 */
|
|
52
|
+
export function assetsRootInfo(env = process.env) {
|
|
53
|
+
const override = (env.DSH_STM32_ASSETS ?? "").trim();
|
|
54
|
+
if (override !== "") {
|
|
55
|
+
return { root: path.resolve(expandHome(override, env)), origin: "DSH_STM32_ASSETS(覆盖内置资源)" };
|
|
56
|
+
}
|
|
57
|
+
return { root: bundledAssetsRoot(), origin: "插件内置(assets/)" };
|
|
58
|
+
}
|
|
59
|
+
/** 资源根(不含版本号)。测试里用 DSH_STM32_ASSETS 指到临时目录,绝不碰真实 assets/。 */
|
|
60
|
+
export function localAssetsRoot(env = process.env) {
|
|
61
|
+
return assetsRootInfo(env).root;
|
|
62
|
+
}
|
|
63
|
+
/** 老布局里某个版本的安装目录:<root>/<version>/。 */
|
|
64
|
+
export function versionDir(version, env = process.env) {
|
|
65
|
+
return path.join(localAssetsRoot(env), version);
|
|
66
|
+
}
|
|
67
|
+
const SHA256_RE = /^[0-9a-f]{64}$/u;
|
|
68
|
+
function isRecord(value) {
|
|
69
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
70
|
+
}
|
|
71
|
+
export function sha256Hex(buffer) {
|
|
72
|
+
return createHash("sha256").update(buffer).digest("hex");
|
|
73
|
+
}
|
|
74
|
+
export function errText(error) {
|
|
75
|
+
if (error instanceof Error) {
|
|
76
|
+
const cause = error.cause;
|
|
77
|
+
if (cause !== undefined && cause !== null && cause !== "") {
|
|
78
|
+
const causeText = cause instanceof Error ? cause.message : String(cause);
|
|
79
|
+
return error.message + "(" + causeText + ")";
|
|
80
|
+
}
|
|
81
|
+
return error.message;
|
|
82
|
+
}
|
|
83
|
+
return String(error);
|
|
84
|
+
}
|
|
85
|
+
function shortHash(value) {
|
|
86
|
+
return value.length > 16 ? value.slice(0, 16) + "…" : value;
|
|
87
|
+
}
|
|
88
|
+
/**
|
|
89
|
+
* 解析并校验 manifest。校验不过返回 error,不抛异常。
|
|
90
|
+
* 为什么严:manifest 是"有哪些文件、该是什么内容"的唯一事实来源,少一个 sha256 就等于放弃校验。
|
|
91
|
+
*/
|
|
92
|
+
export function parseManifest(text) {
|
|
93
|
+
let parsed;
|
|
94
|
+
try {
|
|
95
|
+
parsed = JSON.parse(text);
|
|
96
|
+
}
|
|
97
|
+
catch (error) {
|
|
98
|
+
return { manifest: null, error: "manifest.json 不是合法 JSON:" + errText(error) };
|
|
99
|
+
}
|
|
100
|
+
if (!isRecord(parsed))
|
|
101
|
+
return { manifest: null, error: "manifest.json 顶层不是对象" };
|
|
102
|
+
const version = parsed["version"];
|
|
103
|
+
if (typeof version !== "string" || version.trim() === "") {
|
|
104
|
+
return {
|
|
105
|
+
manifest: null,
|
|
106
|
+
error: "manifest.json 缺 version。资源现在随插件内置,正常安装不会缺;用 scripts/assets/build-assets.mjs 重新生成。",
|
|
107
|
+
};
|
|
108
|
+
}
|
|
109
|
+
const rawFiles = parsed["files"];
|
|
110
|
+
if (!Array.isArray(rawFiles))
|
|
111
|
+
return { manifest: null, error: "manifest.json 缺 files 数组" };
|
|
112
|
+
const files = [];
|
|
113
|
+
const seen = new Set();
|
|
114
|
+
for (let index = 0; index < rawFiles.length; index += 1) {
|
|
115
|
+
const item = rawFiles[index];
|
|
116
|
+
const where = "files[" + String(index) + "]";
|
|
117
|
+
if (!isRecord(item))
|
|
118
|
+
return { manifest: null, error: where + " 不是对象" };
|
|
119
|
+
const relPath = item["path"];
|
|
120
|
+
if (typeof relPath !== "string" || relPath.trim() === "") {
|
|
121
|
+
return { manifest: null, error: where + " 缺 path" };
|
|
122
|
+
}
|
|
123
|
+
const normalized = normalizeAssetPath(relPath);
|
|
124
|
+
if (normalized === null)
|
|
125
|
+
return { manifest: null, error: where + " 的 path 不合法(必须是资源根内的相对路径):" + relPath };
|
|
126
|
+
if (seen.has(normalized))
|
|
127
|
+
return { manifest: null, error: "manifest.json 里 path 重复:" + normalized };
|
|
128
|
+
seen.add(normalized);
|
|
129
|
+
const sha256 = item["sha256"];
|
|
130
|
+
if (typeof sha256 !== "string" || !SHA256_RE.test(sha256.toLowerCase())) {
|
|
131
|
+
return { manifest: null, error: where + "(" + normalized + ")缺 sha256 或不是 64 位十六进制;没有哈希就无法校验" };
|
|
132
|
+
}
|
|
133
|
+
const bytes = item["bytes"];
|
|
134
|
+
if (typeof bytes !== "number" || !Number.isFinite(bytes) || bytes < 0) {
|
|
135
|
+
return { manifest: null, error: where + "(" + normalized + ")的 bytes 不是非负数" };
|
|
136
|
+
}
|
|
137
|
+
const profile = typeof item["profile"] === "string" && item["profile"] !== "" ? item["profile"] : "core";
|
|
138
|
+
const source = typeof item["source"] === "string" ? item["source"] : "";
|
|
139
|
+
files.push({ path: normalized, bytes, sha256: sha256.toLowerCase(), source, profile });
|
|
140
|
+
}
|
|
141
|
+
const profiles = {};
|
|
142
|
+
const rawProfiles = parsed["profiles"];
|
|
143
|
+
if (isRecord(rawProfiles)) {
|
|
144
|
+
for (const [key, value] of Object.entries(rawProfiles)) {
|
|
145
|
+
if (!Array.isArray(value))
|
|
146
|
+
return { manifest: null, error: "manifest.json 的 profiles." + key + " 不是数组" };
|
|
147
|
+
const globs = [];
|
|
148
|
+
for (const glob of value) {
|
|
149
|
+
if (typeof glob !== "string" || glob.trim() === "") {
|
|
150
|
+
return { manifest: null, error: "manifest.json 的 profiles." + key + " 里有非字符串 glob" };
|
|
151
|
+
}
|
|
152
|
+
globs.push(glob);
|
|
153
|
+
}
|
|
154
|
+
profiles[key] = globs;
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
const skipped = Array.isArray(parsed["skipped"]) ? parsed["skipped"].filter((item) => typeof item === "string") : [];
|
|
158
|
+
const name = typeof parsed["name"] === "string" ? parsed["name"] : "dsh-stm32-assets";
|
|
159
|
+
const schema = typeof parsed["schema"] === "number" ? parsed["schema"] : 1;
|
|
160
|
+
return { manifest: { ...parsed, name, version, schema, profiles, files, skipped }, error: "" };
|
|
161
|
+
}
|
|
162
|
+
/** 相对路径规整:反斜杠转正斜杠、拒绝绝对路径/盘符/.. —— 防止 manifest 把文件指到资源根以外。 */
|
|
163
|
+
export function normalizeAssetPath(raw) {
|
|
164
|
+
const text = raw.split("\\").join("/").trim();
|
|
165
|
+
if (text === "" || text.startsWith("/") || /^[A-Za-z]:/u.test(text))
|
|
166
|
+
return null;
|
|
167
|
+
const parts = text.split("/").filter((part) => part !== "" && part !== ".");
|
|
168
|
+
if (parts.length === 0)
|
|
169
|
+
return null;
|
|
170
|
+
if (parts.some((part) => part === ".."))
|
|
171
|
+
return null;
|
|
172
|
+
return parts.join("/");
|
|
173
|
+
}
|
|
174
|
+
/** glob → 正则:** 跨目录,* 不跨目录,? 单字符。manifest 的 profiles 就靠它筛文件。 */
|
|
175
|
+
function globToRegExp(pattern) {
|
|
176
|
+
let out = "^";
|
|
177
|
+
let index = 0;
|
|
178
|
+
while (index < pattern.length) {
|
|
179
|
+
const ch = pattern.charAt(index);
|
|
180
|
+
if (ch === "*") {
|
|
181
|
+
if (pattern.charAt(index + 1) === "*") {
|
|
182
|
+
const followedBySlash = pattern.charAt(index + 2) === "/";
|
|
183
|
+
out += followedBySlash ? "(?:[^/]+/)*" : ".*";
|
|
184
|
+
index += followedBySlash ? 3 : 2;
|
|
185
|
+
continue;
|
|
186
|
+
}
|
|
187
|
+
out += "[^/]*";
|
|
188
|
+
index += 1;
|
|
189
|
+
continue;
|
|
190
|
+
}
|
|
191
|
+
if (ch === "?") {
|
|
192
|
+
out += "[^/]";
|
|
193
|
+
index += 1;
|
|
194
|
+
continue;
|
|
195
|
+
}
|
|
196
|
+
out += ch.replace(/[.*+?^$()|[\]\\]/gu, "\\$&");
|
|
197
|
+
index += 1;
|
|
198
|
+
}
|
|
199
|
+
return new RegExp(out + "$", "u");
|
|
200
|
+
}
|
|
201
|
+
/**
|
|
202
|
+
* profile 里的文件。优先用 manifest.profiles 的 glob(v2 的标准做法);
|
|
203
|
+
* 老 manifest 没有 profiles 时退回每条的 profile 字段(full 包含 core)。
|
|
204
|
+
*/
|
|
205
|
+
export function profileFiles(manifest, profile) {
|
|
206
|
+
const globs = manifest.profiles[profile];
|
|
207
|
+
if (globs !== undefined) {
|
|
208
|
+
const patterns = globs.map((glob) => globToRegExp(glob));
|
|
209
|
+
return manifest.files.filter((file) => patterns.some((pattern) => pattern.test(file.path)));
|
|
210
|
+
}
|
|
211
|
+
return manifest.files.filter((file) => file.profile === profile || (profile === "full" && file.profile === "core"));
|
|
212
|
+
}
|
|
213
|
+
/* ------------------------------ 本地安装 ------------------------------ */
|
|
214
|
+
function scanDirStats(dir, skipNames = []) {
|
|
215
|
+
let files = 0;
|
|
216
|
+
let bytes = 0;
|
|
217
|
+
const walk = (current) => {
|
|
218
|
+
let entries;
|
|
219
|
+
try {
|
|
220
|
+
entries = fs.readdirSync(current, { withFileTypes: true });
|
|
221
|
+
}
|
|
222
|
+
catch {
|
|
223
|
+
return;
|
|
224
|
+
}
|
|
225
|
+
for (const entry of entries) {
|
|
226
|
+
if (skipNames.includes(entry.name))
|
|
227
|
+
continue;
|
|
228
|
+
const abs = path.join(current, entry.name);
|
|
229
|
+
if (entry.isDirectory()) {
|
|
230
|
+
walk(abs);
|
|
231
|
+
continue;
|
|
232
|
+
}
|
|
233
|
+
try {
|
|
234
|
+
const stat = fs.statSync(abs);
|
|
235
|
+
files += 1;
|
|
236
|
+
bytes += stat.size;
|
|
237
|
+
}
|
|
238
|
+
catch {
|
|
239
|
+
// 读不到就跳过,不因为一个坏文件让整份统计失败。
|
|
240
|
+
}
|
|
241
|
+
}
|
|
242
|
+
};
|
|
243
|
+
walk(dir);
|
|
244
|
+
return { files, bytes };
|
|
245
|
+
}
|
|
246
|
+
function readInstallRecord(dir) {
|
|
247
|
+
try {
|
|
248
|
+
const raw = fs.readFileSync(path.join(dir, ASSETS_INSTALL_FILE), "utf8");
|
|
249
|
+
const parsed = JSON.parse(raw);
|
|
250
|
+
if (!isRecord(parsed))
|
|
251
|
+
return null;
|
|
252
|
+
const version = parsed["version"];
|
|
253
|
+
if (typeof version !== "string" || version === "")
|
|
254
|
+
return null;
|
|
255
|
+
const profiles = Array.isArray(parsed["profiles"])
|
|
256
|
+
? parsed["profiles"].filter((item) => typeof item === "string")
|
|
257
|
+
: [];
|
|
258
|
+
return {
|
|
259
|
+
version,
|
|
260
|
+
profiles,
|
|
261
|
+
installedAt: typeof parsed["installedAt"] === "string" ? parsed["installedAt"] : "",
|
|
262
|
+
source: typeof parsed["source"] === "string" ? parsed["source"] : "",
|
|
263
|
+
schema: typeof parsed["schema"] === "number" ? parsed["schema"] : 0,
|
|
264
|
+
fileCount: typeof parsed["fileCount"] === "number" ? parsed["fileCount"] : 0,
|
|
265
|
+
totalBytes: typeof parsed["totalBytes"] === "number" ? parsed["totalBytes"] : 0,
|
|
266
|
+
};
|
|
267
|
+
}
|
|
268
|
+
catch {
|
|
269
|
+
return null;
|
|
270
|
+
}
|
|
271
|
+
}
|
|
272
|
+
/** 版本比较:按数字段比(2026.10.30-1 > 2026.9.1),非数字段按字典序。 */
|
|
273
|
+
export function compareVersions(a, b) {
|
|
274
|
+
const tokenize = (value) => value.match(/\d+|[A-Za-z]+/gu) ?? [];
|
|
275
|
+
const left = tokenize(a);
|
|
276
|
+
const right = tokenize(b);
|
|
277
|
+
const length = Math.max(left.length, right.length);
|
|
278
|
+
for (let index = 0; index < length; index += 1) {
|
|
279
|
+
const l = left[index];
|
|
280
|
+
const r = right[index];
|
|
281
|
+
if (l === undefined)
|
|
282
|
+
return r === undefined ? 0 : -1;
|
|
283
|
+
if (r === undefined)
|
|
284
|
+
return 1;
|
|
285
|
+
const ln = /^\d+$/u.test(l);
|
|
286
|
+
const rn = /^\d+$/u.test(r);
|
|
287
|
+
if (ln && rn) {
|
|
288
|
+
const diff = Number(l) - Number(r);
|
|
289
|
+
if (diff !== 0)
|
|
290
|
+
return diff;
|
|
291
|
+
continue;
|
|
292
|
+
}
|
|
293
|
+
if (l !== r)
|
|
294
|
+
return l < r ? -1 : 1;
|
|
295
|
+
}
|
|
296
|
+
return 0;
|
|
297
|
+
}
|
|
298
|
+
/** 读 flat 资源根的 manifest(有文件但坏了与根本没装要分开报)。 */
|
|
299
|
+
function readFlatManifest(dir) {
|
|
300
|
+
const manifestPath = path.join(dir, ASSETS_MANIFEST_FILE);
|
|
301
|
+
if (!fs.existsSync(manifestPath))
|
|
302
|
+
return { manifest: null, error: "", present: false };
|
|
303
|
+
let text;
|
|
304
|
+
try {
|
|
305
|
+
text = fs.readFileSync(manifestPath, "utf8");
|
|
306
|
+
}
|
|
307
|
+
catch (error) {
|
|
308
|
+
return { manifest: null, error: "内置资源 manifest 读不了(" + manifestPath + "):" + errText(error), present: true };
|
|
309
|
+
}
|
|
310
|
+
const parsed = parseManifest(text);
|
|
311
|
+
if (parsed.manifest === null) {
|
|
312
|
+
return { manifest: null, error: "内置资源 manifest 坏了(" + manifestPath + "):" + parsed.error, present: true };
|
|
313
|
+
}
|
|
314
|
+
return { manifest: parsed.manifest, error: "", present: true };
|
|
315
|
+
}
|
|
316
|
+
/**
|
|
317
|
+
* 扫描本地有哪些资源版本(有新到旧)。flat 内置根排第一(current=true),
|
|
318
|
+
* 然后是 DSH_STM32_ASSETS 下带 install.json 的历史版本目录(半成品不算)。
|
|
319
|
+
*/
|
|
320
|
+
export function listInstalledVersions(env = process.env, root) {
|
|
321
|
+
const base = root !== undefined && root !== "" ? root : localAssetsRoot(env);
|
|
322
|
+
const found = [];
|
|
323
|
+
const flat = readFlatManifest(base);
|
|
324
|
+
if (flat.manifest !== null) {
|
|
325
|
+
const stats = scanDirStats(base, [ASSETS_MANIFEST_FILE]);
|
|
326
|
+
found.push({
|
|
327
|
+
version: flat.manifest.version,
|
|
328
|
+
dir: base,
|
|
329
|
+
profiles: Object.keys(flat.manifest.profiles).length > 0 ? Object.keys(flat.manifest.profiles) : ["core"],
|
|
330
|
+
installedAt: "插件内置",
|
|
331
|
+
fileCount: stats.files,
|
|
332
|
+
totalBytes: stats.bytes,
|
|
333
|
+
current: true,
|
|
334
|
+
bundled: true,
|
|
335
|
+
});
|
|
336
|
+
}
|
|
337
|
+
let entries;
|
|
338
|
+
try {
|
|
339
|
+
entries = fs.readdirSync(base, { withFileTypes: true });
|
|
340
|
+
}
|
|
341
|
+
catch {
|
|
342
|
+
return found;
|
|
343
|
+
}
|
|
344
|
+
const older = [];
|
|
345
|
+
for (const entry of entries) {
|
|
346
|
+
if (!entry.isDirectory())
|
|
347
|
+
continue;
|
|
348
|
+
if (entry.name.startsWith("."))
|
|
349
|
+
continue;
|
|
350
|
+
if (entry.name.includes(".tmp-"))
|
|
351
|
+
continue;
|
|
352
|
+
const dir = path.join(base, entry.name);
|
|
353
|
+
const record = readInstallRecord(dir);
|
|
354
|
+
if (record === null)
|
|
355
|
+
continue;
|
|
356
|
+
const stats = scanDirStats(dir, [ASSETS_MANIFEST_FILE, ASSETS_INSTALL_FILE]);
|
|
357
|
+
older.push({
|
|
358
|
+
version: record.version,
|
|
359
|
+
dir,
|
|
360
|
+
profiles: record.profiles.length > 0 ? record.profiles : ["core"],
|
|
361
|
+
installedAt: record.installedAt,
|
|
362
|
+
fileCount: stats.files,
|
|
363
|
+
totalBytes: stats.bytes,
|
|
364
|
+
current: found.length === 0,
|
|
365
|
+
bundled: false,
|
|
366
|
+
});
|
|
367
|
+
}
|
|
368
|
+
older.sort((left, right) => {
|
|
369
|
+
const byVersion = compareVersions(right.version, left.version);
|
|
370
|
+
if (byVersion !== 0)
|
|
371
|
+
return byVersion;
|
|
372
|
+
return right.installedAt.localeCompare(left.installedAt);
|
|
373
|
+
});
|
|
374
|
+
if (found.length === 0) {
|
|
375
|
+
const first = older[0];
|
|
376
|
+
if (first !== undefined)
|
|
377
|
+
first.current = true;
|
|
378
|
+
}
|
|
379
|
+
return [...found, ...older];
|
|
380
|
+
}
|
|
381
|
+
/**
|
|
382
|
+
* 读本地资源 manifest(默认内置 flat;指定 version 时到历史版本目录里找)。
|
|
383
|
+
* 读不到/坏 JSON 不抛:返回 error 文本,调用方把「装坏了」讲清楚。
|
|
384
|
+
*/
|
|
385
|
+
export function readLocalManifest(env = process.env, version) {
|
|
386
|
+
const info = assetsRootInfo(env);
|
|
387
|
+
const wanted = (version ?? "").trim();
|
|
388
|
+
const flat = readFlatManifest(info.root);
|
|
389
|
+
const flatMatches = flat.manifest !== null && (wanted === "" || flat.manifest.version === wanted);
|
|
390
|
+
if (flatMatches) {
|
|
391
|
+
return {
|
|
392
|
+
manifest: flat.manifest,
|
|
393
|
+
install: null,
|
|
394
|
+
root: info.root,
|
|
395
|
+
version: flat.manifest?.version ?? "",
|
|
396
|
+
versionDir: info.root,
|
|
397
|
+
error: "",
|
|
398
|
+
bundled: true,
|
|
399
|
+
};
|
|
400
|
+
}
|
|
401
|
+
if (flat.present && wanted === "" && flat.manifest === null) {
|
|
402
|
+
return {
|
|
403
|
+
manifest: null,
|
|
404
|
+
install: null,
|
|
405
|
+
root: info.root,
|
|
406
|
+
version: "",
|
|
407
|
+
versionDir: info.root,
|
|
408
|
+
error: flat.error + "。" + ASSETS_REFRESH_HINT,
|
|
409
|
+
bundled: true,
|
|
410
|
+
};
|
|
411
|
+
}
|
|
412
|
+
const versions = listInstalledVersions(env, info.root);
|
|
413
|
+
const picked = wanted === "" ? versions[0] : versions.find((item) => item.version === wanted) ?? null;
|
|
414
|
+
if (picked === undefined || picked === null) {
|
|
415
|
+
return {
|
|
416
|
+
manifest: null,
|
|
417
|
+
install: null,
|
|
418
|
+
root: info.root,
|
|
419
|
+
version: "",
|
|
420
|
+
versionDir: "",
|
|
421
|
+
error: wanted === "" ? "找不到资源:" + info.root + " 下没有 manifest.json(" + ASSETS_REFRESH_HINT + ")" : "本地没有资源版本 " + wanted + "(action=list 看已装版本)",
|
|
422
|
+
bundled: false,
|
|
423
|
+
};
|
|
424
|
+
}
|
|
425
|
+
const manifestPath = path.join(picked.dir, ASSETS_MANIFEST_FILE);
|
|
426
|
+
let text;
|
|
427
|
+
try {
|
|
428
|
+
text = fs.readFileSync(manifestPath, "utf8");
|
|
429
|
+
}
|
|
430
|
+
catch (error) {
|
|
431
|
+
return {
|
|
432
|
+
manifest: null,
|
|
433
|
+
install: null,
|
|
434
|
+
root: info.root,
|
|
435
|
+
version: picked.version,
|
|
436
|
+
versionDir: picked.dir,
|
|
437
|
+
error: "资源 manifest 读不了(" + manifestPath + "):" + errText(error) + "。" + ASSETS_REFRESH_HINT,
|
|
438
|
+
bundled: picked.bundled,
|
|
439
|
+
};
|
|
440
|
+
}
|
|
441
|
+
const parsed = parseManifest(text);
|
|
442
|
+
if (parsed.manifest === null) {
|
|
443
|
+
return {
|
|
444
|
+
manifest: null,
|
|
445
|
+
install: null,
|
|
446
|
+
root: info.root,
|
|
447
|
+
version: picked.version,
|
|
448
|
+
versionDir: picked.dir,
|
|
449
|
+
error: "资源 manifest 坏了(" + manifestPath + "):" + parsed.error + "。" + ASSETS_REFRESH_HINT,
|
|
450
|
+
bundled: picked.bundled,
|
|
451
|
+
};
|
|
452
|
+
}
|
|
453
|
+
return {
|
|
454
|
+
manifest: parsed.manifest,
|
|
455
|
+
install: picked.bundled ? null : readInstallRecord(picked.dir),
|
|
456
|
+
root: info.root,
|
|
457
|
+
version: picked.version,
|
|
458
|
+
versionDir: picked.dir,
|
|
459
|
+
error: "",
|
|
460
|
+
bundled: picked.bundled,
|
|
461
|
+
};
|
|
462
|
+
}
|
|
463
|
+
/**
|
|
464
|
+
* 设备事实的就绪保证:读内置 assets/manifest.json,确认 device/f1/chips.json 真在磁盘上。
|
|
465
|
+
*
|
|
466
|
+
* 三条硬约定:
|
|
467
|
+
* · 不发网络请求(资源随包发布,没有任何需要下载的东西);
|
|
468
|
+
* · 缺文件返回 ok:false + status="missing",message 里一定有 ASSETS_REFRESH_HINT;
|
|
469
|
+
* · 只有 manifest 可读并且 device/f1/chips.json 确实落盘才算 ok。
|
|
470
|
+
*/
|
|
471
|
+
export async function ensureAssets(options = {}) {
|
|
472
|
+
const env = options.env ?? process.env;
|
|
473
|
+
const normalizedProfile = normalizeProfile(options.profile) ?? "core";
|
|
474
|
+
const state = readLocalManifest(env);
|
|
475
|
+
const base = {
|
|
476
|
+
root: state.root === "" ? assetsRootInfo(env).root : state.root,
|
|
477
|
+
version: state.version,
|
|
478
|
+
versionDir: state.versionDir,
|
|
479
|
+
profile: normalizedProfile,
|
|
480
|
+
source: state.bundled ? "bundled" : "cache",
|
|
481
|
+
attempts: [],
|
|
482
|
+
};
|
|
483
|
+
if (state.manifest === null) {
|
|
484
|
+
return {
|
|
485
|
+
ok: false,
|
|
486
|
+
status: "missing",
|
|
487
|
+
...base,
|
|
488
|
+
filePath: "",
|
|
489
|
+
message: "读不到内置资源:" + (state.error === "" ? "assets/manifest.json 不存在" : state.error) + "。" + ASSETS_REFRESH_HINT + "。",
|
|
490
|
+
};
|
|
491
|
+
}
|
|
492
|
+
const filePath = path.join(state.versionDir, ASSETS_DEVICE_FACTS_FILE);
|
|
493
|
+
if (!fs.existsSync(filePath)) {
|
|
494
|
+
return {
|
|
495
|
+
ok: false,
|
|
496
|
+
status: "missing",
|
|
497
|
+
...base,
|
|
498
|
+
filePath: "",
|
|
499
|
+
message: "内置资源 " + state.version + " 里没有 " + ASSETS_DEVICE_FACTS_FILE + "(profile=" + normalizedProfile +
|
|
500
|
+
",资源目录 " + state.versionDir + "):插件安装不完整。" + ASSETS_REFRESH_HINT + "。",
|
|
501
|
+
};
|
|
502
|
+
}
|
|
503
|
+
return {
|
|
504
|
+
ok: true,
|
|
505
|
+
status: "cache",
|
|
506
|
+
...base,
|
|
507
|
+
filePath,
|
|
508
|
+
message: "设备事实来自" + (state.bundled ? "插件内置资源" : "本地资源缓存") + " " + state.version + "(" + filePath + ")",
|
|
509
|
+
};
|
|
510
|
+
}
|
|
511
|
+
/**
|
|
512
|
+
* 把"profile + 相对路径"解析成本地文件:要判断三件事——资源在不在、这份文件属不属于该 profile、
|
|
513
|
+
* 本地文件在不在。三者都过才返回路径,否则给一句能照着修的话。
|
|
514
|
+
*/
|
|
515
|
+
export function resolveAssetFile(profile, relPath, env = process.env) {
|
|
516
|
+
const empty = (error) => ({ ok: false, path: "", version: "", bytes: 0, error });
|
|
517
|
+
const normalizedProfile = normalizeProfile(profile);
|
|
518
|
+
if (normalizedProfile === null)
|
|
519
|
+
return empty("不认识的 profile:" + String(profile) + "(只有 core / full)");
|
|
520
|
+
const normalized = normalizeAssetPath(relPath);
|
|
521
|
+
if (normalized === null)
|
|
522
|
+
return empty("路径不合法:" + String(relPath) + "(必须是资源根内的相对路径)");
|
|
523
|
+
const state = readLocalManifest(env);
|
|
524
|
+
if (state.manifest === null)
|
|
525
|
+
return empty(state.error === "" ? "找不到内置资源" : state.error);
|
|
526
|
+
const entry = state.manifest.files.find((file) => file.path === normalized);
|
|
527
|
+
if (entry === undefined)
|
|
528
|
+
return empty("资源清单里没有这个文件:" + normalized + "(action=list 看这一版有哪些文件)");
|
|
529
|
+
const allowed = profileFiles(state.manifest, normalizedProfile).some((file) => file.path === normalized);
|
|
530
|
+
if (!allowed) {
|
|
531
|
+
return empty("文件 " + normalized + " 不在 profile=" + normalizedProfile + " 里(它属于 profile=" + entry.profile + ");用 profile=full 查一次。");
|
|
532
|
+
}
|
|
533
|
+
const localPath = path.join(state.versionDir, normalized);
|
|
534
|
+
try {
|
|
535
|
+
const stat = fs.statSync(localPath);
|
|
536
|
+
if (!stat.isFile())
|
|
537
|
+
return empty("本地路径不是文件:" + localPath + "。" + ASSETS_REFRESH_HINT);
|
|
538
|
+
return { ok: true, path: localPath, version: state.version, bytes: stat.size, error: "" };
|
|
539
|
+
}
|
|
540
|
+
catch {
|
|
541
|
+
return empty("本地缺这个文件:" + localPath + "(资源 " + state.version + ")。" + ASSETS_REFRESH_HINT);
|
|
542
|
+
}
|
|
543
|
+
}
|
|
544
|
+
/** 逐文件 sha256 复核本地资源。缺文件算 missing,哈希/大小不对算 changed。 */
|
|
545
|
+
export function verifyInstalled(request = {}) {
|
|
546
|
+
const env = request.env ?? process.env;
|
|
547
|
+
const profile = normalizeProfile(request.profile);
|
|
548
|
+
const info = assetsRootInfo(env);
|
|
549
|
+
const state = readLocalManifest(env, request.version);
|
|
550
|
+
const common = {
|
|
551
|
+
root: info.root,
|
|
552
|
+
version: state.version,
|
|
553
|
+
versionDir: state.versionDir,
|
|
554
|
+
profile: profile ?? (request.profile ?? "").trim(),
|
|
555
|
+
files: [],
|
|
556
|
+
fileCount: 0,
|
|
557
|
+
totalBytes: 0,
|
|
558
|
+
};
|
|
559
|
+
if (profile === null)
|
|
560
|
+
return { ...common, ok: false, message: "不认识的 profile:" + String(request.profile) + "(只有 core / full)。" };
|
|
561
|
+
if (state.manifest === null)
|
|
562
|
+
return { ...common, ok: false, message: state.error + (state.error === "" ? "" : "。") };
|
|
563
|
+
const targets = profileFiles(state.manifest, profile);
|
|
564
|
+
let bad = 0;
|
|
565
|
+
for (const target of targets) {
|
|
566
|
+
const localPath = path.join(state.versionDir, target.path);
|
|
567
|
+
let buffer;
|
|
568
|
+
try {
|
|
569
|
+
buffer = fs.readFileSync(localPath);
|
|
570
|
+
}
|
|
571
|
+
catch {
|
|
572
|
+
bad += 1;
|
|
573
|
+
common.files.push({ path: target.path, bytes: 0, sha256: "", status: "missing", detail: "本地缺这个文件(重装插件修复)" });
|
|
574
|
+
continue;
|
|
575
|
+
}
|
|
576
|
+
const actual = sha256Hex(buffer);
|
|
577
|
+
if (actual !== target.sha256 || (target.bytes > 0 && buffer.byteLength !== target.bytes)) {
|
|
578
|
+
bad += 1;
|
|
579
|
+
common.files.push({
|
|
580
|
+
path: target.path,
|
|
581
|
+
bytes: buffer.byteLength,
|
|
582
|
+
sha256: actual,
|
|
583
|
+
status: "changed",
|
|
584
|
+
detail: "sha256 对不上(期望 " + shortHash(target.sha256) + ",实际 " + shortHash(actual) + ")",
|
|
585
|
+
});
|
|
586
|
+
continue;
|
|
587
|
+
}
|
|
588
|
+
common.files.push({ path: target.path, bytes: buffer.byteLength, sha256: actual, status: "ok", detail: "" });
|
|
589
|
+
common.totalBytes += buffer.byteLength;
|
|
590
|
+
}
|
|
591
|
+
common.fileCount = common.files.length;
|
|
592
|
+
return {
|
|
593
|
+
...common,
|
|
594
|
+
ok: bad === 0 && common.files.length > 0,
|
|
595
|
+
message: "校验 " + state.version + "(profile=" + profile + "):" + String(common.files.length) + " 个文件里 " +
|
|
596
|
+
String(bad) + " 个有问题" + (bad === 0 ? ",全部对得上。" : "。重装插件即可恢复(内置资源不能被 refresh 改写)。"),
|
|
597
|
+
};
|
|
598
|
+
}
|
|
599
|
+
/**
|
|
600
|
+
* 只清 DSH_STM32_ASSETS 下 .tmp-* 与超出 keep 的历史版本目录;内置 flat 根永不删。
|
|
601
|
+
* 版本按版本号排序,不按目录名,避免 "2026.9.1" 排到 "2026.10.30" 后面。
|
|
602
|
+
*/
|
|
603
|
+
export function pruneOldVersions(env = process.env, keep = 2, root) {
|
|
604
|
+
const info = assetsRootInfo(env);
|
|
605
|
+
const base = root !== undefined && root !== "" ? root : info.root;
|
|
606
|
+
const bundledRoot = path.resolve(bundledAssetsRoot());
|
|
607
|
+
if (path.resolve(base) === bundledRoot) {
|
|
608
|
+
return {
|
|
609
|
+
removed: [],
|
|
610
|
+
kept: [],
|
|
611
|
+
reclaimedBytes: 0,
|
|
612
|
+
message: "资源随插件内置(" + base + "),没有可清理的历史版本;内置文件不会被删除。",
|
|
613
|
+
};
|
|
614
|
+
}
|
|
615
|
+
const versions = listInstalledVersions(env, base).filter((item) => !item.bundled);
|
|
616
|
+
const keepCount = Math.max(1, Math.floor(keep));
|
|
617
|
+
const removed = [];
|
|
618
|
+
const kept = [];
|
|
619
|
+
let reclaimedBytes = 0;
|
|
620
|
+
versions.forEach((item, index) => {
|
|
621
|
+
if (index < keepCount) {
|
|
622
|
+
kept.push(item.version);
|
|
623
|
+
return;
|
|
624
|
+
}
|
|
625
|
+
const stats = scanDirStats(item.dir);
|
|
626
|
+
try {
|
|
627
|
+
fs.rmSync(item.dir, { recursive: true, force: true });
|
|
628
|
+
removed.push(item.version);
|
|
629
|
+
reclaimedBytes += stats.bytes;
|
|
630
|
+
}
|
|
631
|
+
catch {
|
|
632
|
+
// 删不掉的版本保留在磁盘上,但也不谎报 removed。
|
|
633
|
+
}
|
|
634
|
+
});
|
|
635
|
+
try {
|
|
636
|
+
for (const entry of fs.readdirSync(base, { withFileTypes: true })) {
|
|
637
|
+
if (!entry.isDirectory() || !entry.name.includes(".tmp-"))
|
|
638
|
+
continue;
|
|
639
|
+
const dir = path.join(base, entry.name);
|
|
640
|
+
const stats = scanDirStats(dir);
|
|
641
|
+
try {
|
|
642
|
+
fs.rmSync(dir, { recursive: true, force: true });
|
|
643
|
+
reclaimedBytes += stats.bytes;
|
|
644
|
+
}
|
|
645
|
+
catch {
|
|
646
|
+
// 同上。
|
|
647
|
+
}
|
|
648
|
+
}
|
|
649
|
+
}
|
|
650
|
+
catch {
|
|
651
|
+
// 根目录不存在:没什么可清的。
|
|
652
|
+
}
|
|
653
|
+
const message = versions.length === 0
|
|
654
|
+
? "DSH_STM32_ASSETS 下没有历史版本,没什么可清理的(内置资源不受影响)。"
|
|
655
|
+
: removed.length === 0
|
|
656
|
+
? "保留 " + kept.join("、") + "(不超过 " + String(keepCount) + " 个版本),没有旧版本要删。"
|
|
657
|
+
: "删掉 " + String(removed.length) + " 个旧版本(" + removed.join("、") + "),回收 " + String(reclaimedBytes) + " 字节;保留 " + kept.join("、") + "。";
|
|
658
|
+
return { removed, kept, reclaimedBytes, message };
|
|
659
|
+
}
|