dsh-stm32 0.1.0 → 0.1.1

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 (67) hide show
  1. package/README.md +85 -16
  2. package/README_EN.md +84 -17
  3. package/client/client.js +682 -0
  4. package/docs/development-notes.md +920 -2
  5. package/docs/logic-audit.md +607 -0
  6. package/lib/client.js +682 -0
  7. package/lib/commands/register.js +165 -12
  8. package/lib/data/cmsis-sources.js +147 -0
  9. package/lib/data/firmware-packages.js +352 -0
  10. package/lib/data/install-guides.js +190 -0
  11. package/lib/data/search-roots.js +135 -15
  12. package/lib/data/toolchain-config.js +310 -0
  13. package/lib/engine/build.js +6 -0
  14. package/lib/engine/cache.js +280 -0
  15. package/lib/engine/code-patch.js +18 -6
  16. package/lib/engine/debug-session.js +163 -4
  17. package/lib/engine/debug.js +9 -9
  18. package/lib/engine/fetch.js +143 -0
  19. package/lib/engine/firmware-install.js +668 -0
  20. package/lib/engine/flash.js +51 -10
  21. package/lib/engine/fs-longpath.js +107 -0
  22. package/lib/engine/generate-cache.js +118 -0
  23. package/lib/engine/generate-script.js +30 -8
  24. package/lib/engine/generate.js +285 -14
  25. package/lib/engine/ioc-plan.js +19 -6
  26. package/lib/engine/msys2-install.js +1599 -0
  27. package/lib/engine/probe.js +57 -6
  28. package/lib/engine/register-template.js +378 -0
  29. package/lib/engine/regs.js +18 -4
  30. package/lib/engine/route-plan.js +553 -0
  31. package/lib/engine/scaffold.js +225 -70
  32. package/lib/engine/subprocess-runner.js +2 -0
  33. package/lib/engine/tar.js +250 -0
  34. package/lib/engine/text-file.js +150 -0
  35. package/lib/engine/thirdparty.js +243 -0
  36. package/lib/engine/tool-env.js +51 -0
  37. package/lib/engine/toolchain-gate.js +386 -0
  38. package/lib/engine/vscode-config.js +99 -0
  39. package/lib/engine/web-api.js +375 -0
  40. package/lib/engine/web-routes.js +100 -0
  41. package/lib/engine/xcube-catalog.js +102 -0
  42. package/lib/engine/xcube.js +254 -0
  43. package/lib/index.js +42 -2
  44. package/lib/skill/stm32-workflow.js +1 -1
  45. package/lib/tools/build.js +43 -3
  46. package/lib/tools/cache.js +219 -0
  47. package/lib/tools/code-patch.js +29 -2
  48. package/lib/tools/debug-session.js +56 -14
  49. package/lib/tools/debug.js +36 -2
  50. package/lib/tools/doctor.js +5 -1
  51. package/lib/tools/env-install.js +472 -0
  52. package/lib/tools/env-probe.js +6 -2
  53. package/lib/tools/firmware-install.js +255 -0
  54. package/lib/tools/flash.js +38 -2
  55. package/lib/tools/generate.js +96 -10
  56. package/lib/tools/ioc-apply.js +27 -11
  57. package/lib/tools/ioc-inspect.js +4 -2
  58. package/lib/tools/ioc-plan.js +14 -7
  59. package/lib/tools/project-create.js +204 -21
  60. package/lib/tools/project-dir.js +95 -0
  61. package/lib/tools/regs.js +82 -7
  62. package/lib/tools/route-plan.js +467 -0
  63. package/package.json +7 -2
  64. package/templates/register/CMakeLists.txt +39 -0
  65. package/templates/register/Core/Src/main.c +63 -0
  66. package/templates/scaffold/vscode/launch.json +8 -6
  67. package/templates/scaffold/vscode/settings.json +5 -11
@@ -1,25 +1,33 @@
1
1
  /**
2
2
  * 工具链搜索配置。
3
3
  *
4
- * 设计约定:路径是数据,不是逻辑。候选按优先级来自三处:
4
+ * 设计约定:路径是数据,不是逻辑。候选按优先级来自四处:
5
5
  * 1. 工具参数(binDirs / cubeMxRoots)—— 调用方显式指定,最高优先;
6
- * 2. 环境变量(STM32_BIN_DIRS / STM32_CUBEMX_ROOT)—— **整份替换**默认值,不合并;
7
- * 3. 默认候选表(DEFAULT_BIN_DIRS / DEFAULT_CUBEMX_ROOTS,本机常见安装位置)。
6
+ * 2. 环境变量(STM32_BIN_DIRS / STM32_CUBEMX_ROOT)—— **整份替换**下面的值,不合并;
7
+ * 3. 用户配置文件(toolchain-config:stm32_env_install 装好后自己写的,见下)——
8
+ * 也整份替换默认值,但排在环境变量之后(环境变量是临时/脚本场景的活开关);
9
+ * 4. 默认候选表(DEFAULT_BIN_DIRS / DEFAULT_CUBEMX_ROOTS,本机常见安装位置)。
8
10
  * 之后再把**自动发现到的**安装目录追加到尾部:只做兜底,不覆盖上面任何一处,
9
11
  * 这样别人把 MSYS2 装在 E:\\msys64、CubeMX 装在 F:\\tools 也能直接跑。
10
- * 设 STM32_NO_DISCOVER=1 可关掉自动发现(CI / 单测里避免扫盘)。
12
+ * 设 STM32_NO_DISCOVER=1 可关掉自动发现(CI / 单测里避免扫盘);
13
+ * 设 DSH_STM32_NO_CONFIG=1 可让第 3 档失效(单测里保证不读本机配置)。
11
14
  */
12
15
  import { execFileSync } from "node:child_process";
13
16
  import { existsSync, readdirSync } from "node:fs";
14
- /** 默认二进制目录:用户已确认的偏好是 msys64 优先。 */
17
+ import { binDirsFromConfig, configReadingDisabled, cubeMxRootsFromConfig, readToolchainConfig } from "./toolchain-config.js";
18
+ /**
19
+ * 默认二进制目录:只放**任何 Windows 机器上都可能存在**的位置。
20
+ *
21
+ * 这里绝不能出现开发机专属路径(D:/app/msys64 之类):插件是给别人下载的,
22
+ * 那些路径在别人机器上必然搜不到,还会把「查过哪些地方」的文案污染成别人看不懂的样子。
23
+ * 装在别处的情况由自动发现兜底(扫盘符 msys64/app/msys64/tools 等常见布局)。
24
+ */
15
25
  export const DEFAULT_BIN_DIRS = [
16
- "D:/app/msys64/ucrt64/bin",
17
26
  "C:/msys64/ucrt64/bin",
18
27
  "C:/msys64/mingw64/bin",
19
28
  ];
20
- /** 默认 CubeMX 安装根目录候选(6.x)。 */
29
+ /** 默认 CubeMX 安装根目录候选(6.x 的 Windows 默认安装位置)。 */
21
30
  export const DEFAULT_CUBEMX_ROOTS = [
22
- "D:/app/STM32CubeMX",
23
31
  "C:/Program Files/STMicroelectronics/STM32Cube/STM32CubeMX",
24
32
  ];
25
33
  /**
@@ -121,6 +129,61 @@ export function discoverCubeMxRoots(probe) {
121
129
  }
122
130
  return dedupePaths(found);
123
131
  }
132
+ /** 解码失败的痕迹:非法字节被换成 U+FFFD。 */
133
+ const REPLACEMENT_CHAR = "\u{FFFD}";
134
+ /**
135
+ * 把 reg.exe 的输出(原始字节,或已经被宿主解码过的字符串)变成可用文本。
136
+ *
137
+ * 为什么必须有这一步:reg.exe 是控制台程序,输出到管道/文件时用的是系统 ANSI 代码页
138
+ * (中文 Windows 是 936/GBK),而宿主按 UTF-8 解码子进程 stdout。中文用户名下的安装路径
139
+ * 于是变成一串 U+FFFD:existsSync 必然失败(CubeMX 发现退化成目录扫描),更糟的是这串乱码
140
+ * 会被当成"用户原来的 PATH 旧值"原样写回注册表,把用户原有的中文条目永久写坏。
141
+ *
142
+ * 为什么按顺序探测而不是先读代码页:零依赖下拿不到 GetConsoleOutputCP / GetACP,而
143
+ * "UTF-8 严格解码失败才回落 GB18030"对纯 ASCII 输出永远成立(两种编码对 ASCII 等价),
144
+ * 只有真的有非 ASCII 字节时才需要判断,判断依据也就只有"解不解得出来"。
145
+ * 两种都解不出来就返回 ok:false —— 宁可让用户手写一条,也不把乱码写进注册表。
146
+ *
147
+ * 备选方案(没采用):用 powershell 先把 [Console]::OutputEncoding 设成 UTF8 再调 reg.exe。
148
+ * 不用的原因:多一层 PowerShell 启动开销与引号转义,而且字节其实已经拿到了,直接探测更短。
149
+ */
150
+ export function decodeRegistryText(value, label = "reg.exe 输出") {
151
+ if (value === null || value === undefined) {
152
+ return { ok: false, text: "", encoding: "", error: label + "是空的(什么都没读到)" };
153
+ }
154
+ if (typeof value === "string") {
155
+ // 宿主已经用 UTF-8 解过一遍:真乱码在这里就已经变成 U+FFFD 了,原始字节救不回来。
156
+ if (value.includes(REPLACEMENT_CHAR)) {
157
+ return {
158
+ ok: false,
159
+ text: "",
160
+ encoding: "",
161
+ error: label + "里有无法解码的字节(已被替换成乱码字符),系统代码页可能不是 UTF-8",
162
+ };
163
+ }
164
+ return { ok: true, text: value, encoding: "utf-8", error: "" };
165
+ }
166
+ if (value.length === 0) {
167
+ return { ok: false, text: "", encoding: "", error: label + "是空的(什么都没读到)" };
168
+ }
169
+ for (const encoding of ["utf-8", "gb18030"]) {
170
+ try {
171
+ const text = new TextDecoder(encoding, { fatal: true }).decode(value);
172
+ if (text.includes(REPLACEMENT_CHAR))
173
+ continue;
174
+ return { ok: true, text, encoding, error: "" };
175
+ }
176
+ catch {
177
+ // 这个编码解不出来,试下一个
178
+ }
179
+ }
180
+ return {
181
+ ok: false,
182
+ text: "",
183
+ encoding: "",
184
+ error: label + "既不是合法 UTF-8 也不是合法 GB18030(系统代码页可能不是中文/英文)",
185
+ };
186
+ }
124
187
  /** 读注册表里 ST 记下的安装位置;没有这些键是最常见的情况,不算错误。 */
125
188
  function readRegistryInstallDirs() {
126
189
  if (process.platform !== "win32")
@@ -134,14 +197,20 @@ function readRegistryInstallDirs() {
134
197
  const out = [];
135
198
  for (const entry of keys) {
136
199
  try {
137
- const text = execFileSync("reg.exe", ["query", entry.key, "/v", entry.value], {
138
- encoding: "utf8",
200
+ // 按 buffer 收:reg.exe 写的是系统代码页的字节(中文系统是 GBK),交给宿主按 UTF-8
201
+ // 解会把中文安装路径变成乱码,existsSync 随后必然失败。
202
+ const raw = execFileSync("reg.exe", ["query", entry.key, "/v", entry.value], {
203
+ encoding: "buffer",
139
204
  timeout: 4000,
140
205
  windowsHide: true,
141
206
  // 键不存在时 reg 会往 stderr 写字;默认继承会让这堆噪音漏到调用方终端里。
142
207
  stdio: ["ignore", "pipe", "pipe"],
143
208
  });
144
- for (const line of text.split(/\r?\n/u)) {
209
+ const decoded = decodeRegistryText(raw, "reg query " + entry.key + " /v " + entry.value);
210
+ // 解不出来就当这条没读到:一串乱码路径交给 existsSync 只是污染"查过哪些地方"的说明。
211
+ if (!decoded.ok)
212
+ continue;
213
+ for (const line of decoded.text.split(/\r?\n/u)) {
145
214
  const trimmed = line.trim();
146
215
  if (!trimmed.startsWith(entry.value))
147
216
  continue;
@@ -217,22 +286,73 @@ export function describeSearchScope(paths, tail) {
217
286
  return tail === undefined ? list : list + ",以及 " + tail;
218
287
  }
219
288
  /**
220
- * 环境变量或显式参数覆盖默认搜索配置。
289
+ * 只读检查:配置/环境变量里点名的目录在这台机器上到底有没有。
290
+ *
291
+ * 为什么需要这一层:插件是给别人下载的,配置也可能从别的机器拷过来(D:/app/msys64 这种
292
+ * 开发机专属路径)。这种路径不会让程序崩,但会让用户以为"我明明配了却没生效"。
293
+ * 这里**只报告、不删条目**:路径可能是还没装(装完就存在),删掉反而抹掉用户意图。
294
+ */
295
+ export function searchConfigWarnings(env = process.env, exists = existsSync) {
296
+ const warnings = [];
297
+ const seen = new Set();
298
+ const push = (source, raw) => {
299
+ const path = normalizePathEntry(raw);
300
+ if (path === "" || seen.has(path.toLowerCase()) || exists(path))
301
+ return;
302
+ seen.add(path.toLowerCase());
303
+ warnings.push({
304
+ source,
305
+ path,
306
+ message: (source === "config" ? "配置文件里的 " : "环境变量里的 ") +
307
+ path +
308
+ " 在本机不存在(配置可能是从别的机器拷来的),这一条搜不到工具;换机器后重跑 stm32_env_install,或手改 " +
309
+ (source === "config" ? "~/.dsh-stm32/config.json(DSH_STM32_CONFIG 可改位置)" : "STM32_BIN_DIRS / STM32_CUBEMX_ROOT"),
310
+ });
311
+ };
312
+ for (const dir of splitList(env["STM32_BIN_DIRS"]))
313
+ push("env", dir);
314
+ for (const dir of splitList(env["STM32_CUBEMX_ROOT"]))
315
+ push("env", dir);
316
+ const config = configReadingDisabled(env) ? null : readToolchainConfig(env).config;
317
+ if (config !== null) {
318
+ if (config.msys64 !== "")
319
+ push("config", config.msys64);
320
+ for (const dir of config.binDirs)
321
+ push("config", dir);
322
+ if (config.cubeMxRoot !== "")
323
+ push("config", config.cubeMxRoot);
324
+ }
325
+ return warnings;
326
+ }
327
+ /**
328
+ * 显式参数 / 环境变量 / 用户配置覆盖默认搜索配置。
221
329
  *
222
- * 优先级:显式参数 > 环境变量(整份替换,分号分隔)> 默认常量。
330
+ * 优先级:显式参数 > 环境变量(整份替换,分号分隔)> 用户配置文件(整份替换)> 默认常量。
223
331
  * 自动发现的安装只追加在"没给显式参数"的那一档尾部:用参数点名目录时说明调用方
224
332
  * 心里有确切位置,再混进别处的同名工具会让"我明明指定了"变成假的。
333
+ *
334
+ * 用户配置文件在这里读,是因为**这一层是唯一的汇聚点**:所有工具/引擎都经过它,
335
+ * 装完工具链后不必改任何调用方就能立即生效(不需要重启 DSH:路径是我们自己读的)。
225
336
  */
226
337
  export function resolveSearchConfig(env = process.env, overrides = {},
227
338
  /** 单测注入用;生产代码不要传。 */
228
339
  discoveredOverride) {
229
340
  const binFromEnv = splitList(env["STM32_BIN_DIRS"]);
230
341
  const rootsFromEnv = splitList(env["STM32_CUBEMX_ROOT"]);
342
+ const userConfig = configReadingDisabled(env) ? null : readToolchainConfig(env).config;
343
+ const binFromConfig = binDirsFromConfig(userConfig);
344
+ const rootsFromConfig = cubeMxRootsFromConfig(userConfig);
231
345
  const discovered = discoveryDisabled(env)
232
346
  ? { binDirs: [], cubeMxRoots: [] }
233
347
  : (discoveredOverride ?? discoverInstalls());
234
- const binBase = overrides.binDirs ?? (binFromEnv.length > 0 ? binFromEnv : [...DEFAULT_BIN_DIRS]);
235
- const rootsBase = overrides.cubeMxRoots ?? (rootsFromEnv.length > 0 ? rootsFromEnv : [...DEFAULT_CUBEMX_ROOTS]);
348
+ const binBase = overrides.binDirs
349
+ ?? (binFromEnv.length > 0
350
+ ? binFromEnv
351
+ : (binFromConfig.length > 0 ? binFromConfig : [...DEFAULT_BIN_DIRS]));
352
+ const rootsBase = overrides.cubeMxRoots
353
+ ?? (rootsFromEnv.length > 0
354
+ ? rootsFromEnv
355
+ : (rootsFromConfig.length > 0 ? rootsFromConfig : [...DEFAULT_CUBEMX_ROOTS]));
236
356
  return {
237
357
  binDirs: dedupePaths([...binBase, ...(overrides.binDirs === undefined ? discovered.binDirs : [])]),
238
358
  cubeMxRoots: dedupePaths([...rootsBase, ...(overrides.cubeMxRoots === undefined ? discovered.cubeMxRoots : [])]),
@@ -0,0 +1,310 @@
1
+ /**
2
+ * 用户级工具链配置:插件自己记住"这台机器把工具装在哪"。
3
+ *
4
+ * 为什么要有它:以前只认三个写死的候选目录 + 两个环境变量,用户把 MSYS2 装在
5
+ * E:/msys64 时,每次都得自己去设 STM32_BIN_DIRS,还得重开 DSH 才生效。这里把
6
+ * 路径落到一个纯文本 JSON 里,插件每次自己读——装完立刻能用,与进程环境变量无关。
7
+ *
8
+ * 位置:%USERPROFILE%/.dsh-stm32/config.json;DSH_STM32_CONFIG 可整体改指到别处
9
+ * (单测与多工程隔离用)。DSH_STM32_NO_CONFIG=1 让所有读配置的地方当它不存在。
10
+ *
11
+ * 文件是可选增强,不是前提:读不到、写坏了都只是"没配置",不抛异常给调用方。
12
+ */
13
+ import { randomBytes } from "node:crypto";
14
+ import { existsSync, mkdirSync, readFileSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
15
+ import { homedir } from "node:os";
16
+ import { dirname, isAbsolute } from "node:path";
17
+ export const TOOLCHAIN_CONFIG_VERSION = 1;
18
+ let cache = null;
19
+ function envValue(env, key) {
20
+ const value = env[key];
21
+ return value === undefined ? "" : value.trim();
22
+ }
23
+ /** 用户主目录:Windows 上 USERPROFILE 最准,其余退回 os.homedir()。 */
24
+ function homeDir(env) {
25
+ const userProfile = envValue(env, "USERPROFILE");
26
+ if (userProfile !== "")
27
+ return userProfile;
28
+ const home = envValue(env, "HOME");
29
+ if (home !== "")
30
+ return home;
31
+ return homedir();
32
+ }
33
+ /** 配置文件路径。DSH_STM32_CONFIG 优先(相对路径按当前工作目录解析)。 */
34
+ export function toolchainConfigPath(env = process.env) {
35
+ const override = envValue(env, "DSH_STM32_CONFIG");
36
+ if (override !== "")
37
+ return isAbsolute(override) ? override : homeDir(env) + "/" + override;
38
+ return toPosix(homeDir(env)) + "/.dsh-stm32/config.json";
39
+ }
40
+ /** 关掉配置读取(单测 / 想完全走环境变量时用)。 */
41
+ export function configReadingDisabled(env = process.env) {
42
+ const flag = envValue(env, "DSH_STM32_NO_CONFIG");
43
+ return flag === "1" || flag === "true";
44
+ }
45
+ function toPosix(value) {
46
+ return value.replace(/\\/gu, "/").replace(/\/+$/u, "");
47
+ }
48
+ function asString(value) {
49
+ return typeof value === "string" ? value.trim() : "";
50
+ }
51
+ function asStringArray(value) {
52
+ if (!Array.isArray(value))
53
+ return [];
54
+ const out = [];
55
+ for (const item of value) {
56
+ if (typeof item !== "string")
57
+ continue;
58
+ const trimmed = item.trim();
59
+ if (trimmed !== "")
60
+ out.push(toPosix(trimmed));
61
+ }
62
+ return out;
63
+ }
64
+ function dedupe(values) {
65
+ const seen = new Set();
66
+ const out = [];
67
+ for (const value of values) {
68
+ const key = value.toLowerCase();
69
+ if (seen.has(key))
70
+ continue;
71
+ seen.add(key);
72
+ out.push(value);
73
+ }
74
+ return out;
75
+ }
76
+ export function defaultToolchainConfig() {
77
+ return {
78
+ version: TOOLCHAIN_CONFIG_VERSION,
79
+ msys64: "",
80
+ binDirs: [],
81
+ packages: [],
82
+ cubeMxRoot: "",
83
+ updatedAt: "",
84
+ };
85
+ }
86
+ /** 把任意 JSON 归一成合法配置:未知字段丢掉,类型不对的字段按空处理并记一条 errors。 */
87
+ export function normalizeToolchainConfig(raw, errors) {
88
+ const base = defaultToolchainConfig();
89
+ if (raw === null || typeof raw !== "object") {
90
+ errors.push("配置内容不是对象,已按空配置处理");
91
+ return base;
92
+ }
93
+ const record = raw;
94
+ const version = typeof record["version"] === "number" ? record["version"] : TOOLCHAIN_CONFIG_VERSION;
95
+ if (typeof record["version"] !== "number")
96
+ errors.push("version 不是数字,按 " + String(TOOLCHAIN_CONFIG_VERSION));
97
+ const msys64 = toPosix(asString(record["msys64"]));
98
+ const binDirs = dedupe(asStringArray(record["binDirs"]));
99
+ const packages = dedupe(asStringArray(record["packages"]));
100
+ const cubeMxRoot = toPosix(asString(record["cubeMxRoot"]));
101
+ return {
102
+ version,
103
+ msys64,
104
+ binDirs,
105
+ packages,
106
+ cubeMxRoot,
107
+ updatedAt: asString(record["updatedAt"]),
108
+ };
109
+ }
110
+ /** 读配置;坏文件不抛异常,返回 config=null + errors,并把原文错误写进 errors。 */
111
+ export function readToolchainConfig(env = process.env) {
112
+ const path = toolchainConfigPath(env);
113
+ if (configReadingDisabled(env)) {
114
+ return { path, exists: false, config: null, errors: [], mtimeMs: 0 };
115
+ }
116
+ let mtimeMs = 0;
117
+ let size = -1;
118
+ try {
119
+ const stat = statSync(path);
120
+ mtimeMs = stat.mtimeMs;
121
+ size = stat.size;
122
+ }
123
+ catch {
124
+ cache = null;
125
+ return { path, exists: false, config: null, errors: [], mtimeMs: 0 };
126
+ }
127
+ if (cache !== null && cache.path === path && cache.mtimeMs === mtimeMs && cache.size === size) {
128
+ return cache.read;
129
+ }
130
+ let text = "";
131
+ try {
132
+ text = readFileSync(path, "utf8");
133
+ }
134
+ catch (error) {
135
+ const read = {
136
+ path,
137
+ exists: true,
138
+ config: null,
139
+ errors: ["配置文件读不了:" + describeError(error)],
140
+ mtimeMs,
141
+ };
142
+ cache = { path, mtimeMs, size, read };
143
+ return read;
144
+ }
145
+ const errors = [];
146
+ let parsed = null;
147
+ try {
148
+ parsed = text.trim() === "" ? null : JSON.parse(text);
149
+ }
150
+ catch (error) {
151
+ const read = {
152
+ path,
153
+ exists: true,
154
+ config: null,
155
+ errors: ["配置文件不是合法 JSON:" + describeError(error) + ";已按未配置处理(重新写入会覆盖它)"],
156
+ mtimeMs,
157
+ };
158
+ cache = { path, mtimeMs, size, read };
159
+ return read;
160
+ }
161
+ const config = parsed === null ? defaultToolchainConfig() : normalizeToolchainConfig(parsed, errors);
162
+ const read = { path, exists: true, config, errors, mtimeMs };
163
+ cache = { path, mtimeMs, size, read };
164
+ return read;
165
+ }
166
+ function describeError(error) {
167
+ return error instanceof Error ? error.message : String(error);
168
+ }
169
+ /** 写前快照:mtime + 文件里记的 updatedAt,用来判断"读完之后有没有别人动过"。 */
170
+ function snapshotConfig(path) {
171
+ let mtimeMs = 0;
172
+ try {
173
+ mtimeMs = statSync(path).mtimeMs;
174
+ }
175
+ catch {
176
+ // 文件不存在:和 readToolchainConfig 一样给 0,两边才能对上
177
+ return { mtimeMs: 0, updatedAt: "" };
178
+ }
179
+ let updatedAt = "";
180
+ try {
181
+ const parsed = JSON.parse(readFileSync(path, "utf8"));
182
+ if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
183
+ const value = parsed["updatedAt"];
184
+ updatedAt = typeof value === "string" ? value : "";
185
+ }
186
+ }
187
+ catch {
188
+ // 坏 JSON 的 updatedAt 当空串;要不要算冲突交给 mtime 判断
189
+ }
190
+ return { mtimeMs, updatedAt };
191
+ }
192
+ function conflictOf(current, expect) {
193
+ if (expect.mtimeMs !== undefined && current.mtimeMs !== expect.mtimeMs)
194
+ return true;
195
+ if (expect.updatedAt !== undefined && current.updatedAt !== expect.updatedAt)
196
+ return true;
197
+ return false;
198
+ }
199
+ /**
200
+ * 原子写入:先写同目录 tmp 再 rename。
201
+ * 半截写入比没有配置更糟(下次启动直接坏 JSON),所以不做原地覆盖。
202
+ * 给了 options.expect 就先做一次 CAS:读完之后别人改过,宁可这次不写也不把对方的内容整段覆盖掉。
203
+ */
204
+ export function writeToolchainConfig(config, env = process.env, options = {}) {
205
+ const path = toolchainConfigPath(env);
206
+ if (options.expect !== undefined && conflictOf(snapshotConfig(path), options.expect)) {
207
+ return {
208
+ ok: false,
209
+ path,
210
+ error: "配置文件在读完之后被别处改过:为免覆盖对方的内容,这次没有写",
211
+ conflict: true,
212
+ };
213
+ }
214
+ const normalized = {
215
+ version: TOOLCHAIN_CONFIG_VERSION,
216
+ msys64: toPosix(config.msys64),
217
+ binDirs: dedupe(config.binDirs.map(toPosix)),
218
+ packages: dedupe(config.packages.map((name) => name.trim()).filter((name) => name !== "")),
219
+ cubeMxRoot: toPosix(config.cubeMxRoot),
220
+ updatedAt: new Date().toISOString(),
221
+ };
222
+ const body = JSON.stringify(normalized, null, 2) + "\n";
223
+ // tmp 名带随机后缀:多个 DSH 窗口同时写时不会挤同一个临时文件(pid 在 Windows 上复用很快)。
224
+ const tmpPath = path + ".tmp-" + String(process.pid) + "-" + randomBytes(4).toString("hex");
225
+ try {
226
+ mkdirSync(dirname(path), { recursive: true });
227
+ writeFileSync(tmpPath, body, "utf8");
228
+ renameSync(tmpPath, path);
229
+ }
230
+ catch (error) {
231
+ try {
232
+ if (existsSync(tmpPath))
233
+ unlinkSync(tmpPath);
234
+ }
235
+ catch {
236
+ // 清理失败不影响主错误
237
+ }
238
+ cache = null;
239
+ return { ok: false, path, error: "写配置失败:" + describeError(error), conflict: false };
240
+ }
241
+ cache = null;
242
+ return { ok: true, path, error: "", conflict: false };
243
+ }
244
+ /**
245
+ * 只改一部分字段(其余保持原样)。读不到原配置时按默认值起步。
246
+ * 带 options.expect 时先 CAS;一旦发现别人在这中间写过,就重读、把 patch 叠到新内容上再写一次
247
+ * (attempts=2)。安装器耗时几分钟,期间用户完全可能在另一个窗口改配置,直接覆盖会丢对方的设置。
248
+ */
249
+ export function updateToolchainConfig(patch, env = process.env, options = {}) {
250
+ let read = readToolchainConfig(env);
251
+ let expect = options.expect;
252
+ let attempts = 0;
253
+ for (;;) {
254
+ attempts += 1;
255
+ const base = read.config ?? defaultToolchainConfig();
256
+ const next = {
257
+ version: TOOLCHAIN_CONFIG_VERSION,
258
+ msys64: patch.msys64 ?? base.msys64,
259
+ binDirs: patch.binDirs ?? base.binDirs,
260
+ packages: patch.packages ?? base.packages,
261
+ cubeMxRoot: patch.cubeMxRoot ?? base.cubeMxRoot,
262
+ updatedAt: base.updatedAt,
263
+ };
264
+ const written = writeToolchainConfig(next, env, expect === undefined ? {} : { expect });
265
+ if (written.conflict && attempts === 1) {
266
+ resetToolchainConfigCache();
267
+ read = readToolchainConfig(env);
268
+ expect = { mtimeMs: read.mtimeMs, updatedAt: read.config?.updatedAt ?? "" };
269
+ continue;
270
+ }
271
+ return { ok: written.ok, path: written.path, error: written.error, config: next, attempts };
272
+ }
273
+ }
274
+ /**
275
+ * 配置里认的工具链 bin 目录。
276
+ * binDirs 为空但有 msys64 时按 MSYS2 的 UCRT64 布局推导——这是安装器写配置的唯一形状。
277
+ */
278
+ export function binDirsFromConfig(config) {
279
+ if (config === null)
280
+ return [];
281
+ if (config.binDirs.length > 0)
282
+ return [...config.binDirs];
283
+ if (config.msys64 !== "")
284
+ return [config.msys64 + "/ucrt64/bin"];
285
+ return [];
286
+ }
287
+ /** 配置里认的 CubeMX 安装根。 */
288
+ export function cubeMxRootsFromConfig(config) {
289
+ if (config === null || config.cubeMxRoot === "")
290
+ return [];
291
+ return [config.cubeMxRoot];
292
+ }
293
+ /** 单测用:清掉 mtime 缓存。 */
294
+ export function resetToolchainConfigCache() {
295
+ cache = null;
296
+ }
297
+ /** 给报告 / 命令卡片用的一句话描述。 */
298
+ export function describeToolchainConfig(read) {
299
+ if (!read.exists)
300
+ return "还没有配置(没有 " + read.path + ")";
301
+ if (read.config === null)
302
+ return "配置读不了:" + (read.errors[0] ?? "未知原因");
303
+ const parts = [];
304
+ parts.push(read.config.msys64 === "" ? "MSYS2 未配置" : "MSYS2 " + read.config.msys64);
305
+ if (read.config.packages.length > 0)
306
+ parts.push("包 " + String(read.config.packages.length) + " 个");
307
+ if (read.config.cubeMxRoot !== "")
308
+ parts.push("CubeMX " + read.config.cubeMxRoot);
309
+ return parts.join(";") + "(" + read.path + ")";
310
+ }
@@ -9,6 +9,7 @@ import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
9
9
  import { join, resolve } from "node:path";
10
10
  import { resolveSearchConfig } from "../data/search-roots.js";
11
11
  import { runStreaming } from "./subprocess-runner.js";
12
+ import { envWithBinDirs } from "./tool-env.js";
12
13
  const DEFAULT_TIMEOUT_MS = 300_000;
13
14
  function toBytes(value, unit) {
14
15
  const parsed = Number.parseFloat(value);
@@ -192,6 +193,9 @@ export async function runBuild(subprocess, request) {
192
193
  return fail(request, "工程目录不存在:" + projectDir);
193
194
  const config = resolveSearchConfig(process.env, request.binDirs === undefined ? {} : { binDirs: request.binDirs });
194
195
  const cmake = resolveCmake(subprocess, config.binDirs);
196
+ // 子进程带上 binDirs 组成的 PATH:cmake 会再去调 arm-none-eabi-gcc / ninja / objcopy,
197
+ // 只把这些目录用于"找 cmake 本身"是不够的(宿主进程的 PATH 可能还是安装前的旧值)。
198
+ const childEnv = envWithBinDirs(config.binDirs);
195
199
  const progress = request.onProgress ?? (() => undefined);
196
200
  const preNotes = [];
197
201
  let buildDir = request.buildDir === undefined ? detectBuildDir(projectDir) : resolve(projectDir, request.buildDir);
@@ -210,6 +214,7 @@ export async function runBuild(subprocess, request) {
210
214
  cwd: projectDir,
211
215
  timeoutMs: request.timeoutMs ?? DEFAULT_TIMEOUT_MS,
212
216
  maxBytes: 1024 * 1024,
217
+ env: childEnv,
213
218
  ...(request.signal === undefined ? {} : { signal: request.signal }),
214
219
  onOutput: (stream, text) => {
215
220
  for (const line of text.split(/\r?\n/u)) {
@@ -260,6 +265,7 @@ export async function runBuild(subprocess, request) {
260
265
  cwd: projectDir,
261
266
  timeoutMs: request.timeoutMs ?? DEFAULT_TIMEOUT_MS,
262
267
  maxBytes: 2 * 1024 * 1024,
268
+ env: childEnv,
263
269
  ...(request.signal === undefined ? {} : { signal: request.signal }),
264
270
  onOutput: (stream, text) => {
265
271
  for (const line of text.split(/\r?\n/u)) {