[工程化/环境] 测试与构建脚本执行强依赖特定 Node.js 运行时：引入 tsx 解决跨平台与 CI 无法运行 TypeScript 脚本 #12

New Issue

troytt · 2026-09-14T07:01:33Z

troytt commented

2026-09-14 07:01:33 +00:00

Parent Issue: #7 ([Code Review] 整体代码质量、架构缺陷与技术债务全景审查报告)

模块位置

package.json, scripts/

问题背景与现象

package.json 中的所有测试命令（verify:*）直接配置为 node scripts/*.ts。
这强依赖了特定官方预编译 Node.js v22 二进制附带的实验性 amaro 剥离特性。
在许多 Linux 发行版（如 Debian/Ubuntu apt 官方源）安装的标准 Node.js 环境或部分 Docker 容器中，直接崩溃报 ERR_UNKNOWN_FILE_EXTENSION: Unknown file extension ".ts" 或 ERR_NO_TYPESCRIPT: Node.js is not compiled with TypeScript support。

造成的影响

开发者在干净环境或不同发行版上拉取仓库后，无法直接运行 npm run verify:all；
限制了 CI/CD 流水线的基础镜像选型。

解决建议

在 devDependencies 中添加 tsx: "^4.x"（或利用现有的 esbuild / vite-node）；
将 package.json 中的 node scripts/*.ts 命令统一更新为 tsx scripts/*.ts；
在 README.md 与开发文档中移除对特定 Node 二进制编译特性的限制说明。

> **Parent Issue**: #7 ([Code Review] 整体代码质量、架构缺陷与技术债务全景审查报告) ## 模块位置 `package.json`, `scripts/` ## 问题背景与现象 - `package.json` 中的所有测试命令（`verify:*`）直接配置为 `node scripts/*.ts`。 - 这强依赖了特定官方预编译 Node.js v22 二进制附带的实验性 `amaro` 剥离特性。 - 在许多 Linux 发行版（如 Debian/Ubuntu apt 官方源）安装的标准 Node.js 环境或部分 Docker 容器中，直接崩溃报 `ERR_UNKNOWN_FILE_EXTENSION: Unknown file extension ".ts"` 或 `ERR_NO_TYPESCRIPT: Node.js is not compiled with TypeScript support`。 ## 造成的影响 1. 开发者在干净环境或不同发行版上拉取仓库后，无法直接运行 `npm run verify:all`； 2. 限制了 CI/CD 流水线的基础镜像选型。 ## 解决建议 1. 在 `devDependencies` 中添加 `tsx: "^4.x"`（或利用现有的 `esbuild` / `vite-node`）； 2. 将 `package.json` 中的 `node scripts/*.ts` 命令统一更新为 `tsx scripts/*.ts`； 3. 在 `README.md` 与开发文档中移除对特定 Node 二进制编译特性的限制说明。

troytt added a new dependency 2026-09-14 07:01:38 +00:00

#7 [Code Review] 整体代码质量、架构缺陷与技术债务全景审查报告

troytt referenced this issue

2026-09-14 07:01:39 +00:00

[Code Review] 整体代码质量、架构缺陷与技术债务全景审查报告 #7

troytt referenced this issue from a commit

2026-09-14 13:28:11 +00:00

chore(scripts): 使用 tsx 运行 TypeScript 脚本，解除对特定 Node 运行时的依赖 (fixes #12)

troytt closed this issue

2026-09-14 13:28:11 +00:00

troytt commented

2026-09-14 13:28:20 +00:00

已修复 — `chore(scripts): 使用 tsx 运行 TypeScript 脚本` (`63b3962`)

package.json 中所有 node scripts/*.ts 的调用已全部改为通过 tsx 运行，并把原先零散的 npx tsx 写法统一规范化。tsx 作为 devDependency 引入，因此不违反本项目「运行时零依赖」的硬性约束。

README / HANDOVER 中「需要特定 Node 运行时 / --experimental-strip-types」的说法已改写为：任何 Node >= 18 均可。

验证： 冷装 (rm -rf node_modules && npm ci) 后 npm run verify:all 全链路通过，不再出现 ERR_UNKNOWN_FILE_EXTENSION。

### 已修复 — `chore(scripts): 使用 tsx 运行 TypeScript 脚本` (63b3962) `package.json` 中所有 `node scripts/*.ts` 的调用已全部改为通过 `tsx` 运行，并把原先零散的 `npx tsx` 写法统一规范化。`tsx` 作为 **devDependency** 引入，因此不违反本项目「运行时零依赖」的硬性约束。 README / HANDOVER 中「需要特定 Node 运行时 / `--experimental-strip-types`」的说法已改写为：任何 Node >= 18 均可。 **验证：** 冷装 (`rm -rf node_modules && npm ci`) 后 `npm run verify:all` 全链路通过，不再出现 `ERR_UNKNOWN_FILE_EXTENSION`。

troytt referenced this issue

2026-09-22 02:40:01 +00:00

[Skill #012] [AMA] Multiple Shot (1.13c Parity) #166

troytt referenced this issue

2026-09-22 03:36:40 +00:00

[Skill #012] [AMA] Multiple Shot (1.13c Parity) #166

troytt referenced this issue from a commit

2026-09-22 03:38:15 +00:00

feat(skills): implement 1.13c Multiple Shot [Skill #012] (fixes #166)

troytt referenced this issue

2026-09-24 19:27:29 +00:00

[Milestone M12] Amazon Bow and Crossbow Skills Tree (Skills 6, 7, 11, 12, 16, 21, 22, 26, 27, 31) #459