@akasha-book/gate 1.4.2 → 1.4.3

package/README.md

@@ -37,7 +37,7 @@
 
 ```powershell
 cd <LOCAL_PATH>
-F:\h\all\Nodejs\npm.cmd pack
+<LOCAL_PATH> pack
 # 然后：plugin_manager install_bundle <tgz 绝对路径>（新 bundle 会 HMR 热生效）
 ```
 

package/cordis.patch.yml

@@ -1,3 +1,6 @@
+# ⚠ 安装前必改：把 <AKASHA_DIR> / <LOCAL_PATH> 换成你的实际路径（Windows 路径建议用单引号包住）。
+#   五个插件都会检测未替换的占位符并**直接报错**（fail closed）——不再静默降级。
+#   也可以删掉这些路径字段，改用 AKASHA_DIR 环境变量（插件默认从它推导）。
 - insert:
     - id: akasha-gate
       name: '@akasha-book/gate'

package/index.js

@@ -38,6 +38,39 @@ export function expandHome(p) {
   if (p.startsWith('~/') || p.startsWith('~\\')) return join(homedir(), p.slice(2));
   return p;
 }
+// ── 占位符守卫（2026-10-19 发布面 P0）──────────────────────────────
+// OSS 的 `cordis.patch.yml` 用 `<AKASHA_DIR>` / `<LOCAL_PATH>` 作示例字面量。用户照抄不改时，
+// config 里的字面量**优先于** AKASHA_DIR 环境变量默认值（见下面 apply 里的三元判断）⇒ 插件指向不存在的路径：
+// 门控写保护空转、日志写不进去，而且全是静默的。这里**明确抛错**（fail closed），让配置错误在启动时说话。
+const PLACEHOLDER_TOKEN = /<[A-Za-z][A-Za-z0-9_]{2,}>/;   // 大小写都认（2026-10-19 审计 B：小写/混合形态此前漏检）
+/** 递归找配置里的未替换占位符（只认全大写尖括号 token，不误伤普通文本）。 */
+export function findPlaceholders(value, path = 'config', depth = 0) {
+  if (depth > 8) return [];
+  if (typeof value === 'string') {
+    const m = value.match(PLACEHOLDER_TOKEN);
+    return m ? [{ field: path, token: m[0] }] : [];
+  }
+  if (Array.isArray(value)) return value.flatMap((v, i) => findPlaceholders(v, `${path}[${i}]`, depth + 1));
+  if (!value || typeof value !== 'object') return [];
+  return Object.entries(value).flatMap(([k, v]) => findPlaceholders(v, `${path}.${k}`, depth + 1));
+}
+export function assertNoPlaceholders(config) {
+  const hits = findPlaceholders(config);
+  // 2026-10-19（审计 B）：环境变量路线此前完全没设防——AKASHA_DIR='<AKASHA_DIR>' 时插件事先不知道。
+  const envVal = process.env.AKASHA_DIR;
+  if (typeof envVal === 'string' && envVal.trim() !== '') {
+    const m = envVal.match(PLACEHOLDER_TOKEN);
+    if (m) hits.push({ field: 'AKASHA_DIR(环境变量)', token: m[0] });
+  }
+  if (!hits.length) return;
+  const fields = [...new Set(hits.map((h) => h.field))].join('、');
+  throw new Error(
+    `akasha-gate: 配置里还有未替换的占位符 ${hits[0].token}（${fields}）。` +
+    '请先把 cordis.patch.yml 里的 <AKASHA_DIR> / <LOCAL_PATH> 改成你的实际路径；' +
+    '或删掉这些字段，改用 AKASHA_DIR 环境变量。' +
+    '（宁可启动失败，也不静默降级——照抄占位符会让门控指向不存在的库。）'
+  );
+}
 const WRITE_TOOLS = new Set(['edit', 'write', 'apply_patch', 'ops_replace']);
 // 命令类工具：能间接写盘的**全部**入口（2026-10-10 人读复查补 dsh_wsl 与 codex 系；
 // 2026-10-12 窗口 4 再补 ops_bash——dsh-ops 落地后它是新的间接写盘入口，漏了就是真盲区）。
@@ -356,8 +389,9 @@ export function apply(ctx, config = {}) {
     try { (ctx.logger?.info ?? (() => {}))('gate: abOff=true（A/B 关闭臂）——本插件不注册任何面'); } catch { /* 静默 */ }
     return;
   }
+  assertNoPlaceholders(config);
   const logPath = typeof config.log === 'string' && config.log.trim() !== '' ? expandHome(config.log) : DEFAULT_LOG;
-  // 路径用 Node 自己的 resolve（2026-10 复查）。此前把 '/' 一律换成 '\\' 再 join，
+  // 路径用 Node 自己的 resolve（2026-10 复查）。此前把 '/' 一律换成反斜杠再 join，
   // 在 POSIX 上不再是绝对路径，require 核心库失败，用法条永远停在兜底。
   const dataDir = typeof config.dataDir === 'string' && config.dataDir.trim() !== '' ? expandHome(config.dataDir) : DEFAULT_DATA_DIR;
   const akashaDir = typeof config.akashaDir === 'string' && config.akashaDir.trim() !== '' ? expandHome(config.akashaDir) : DEFAULT_AKASHA_DIR;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akasha-book/gate",
-  "version": "1.4.2",
+  "version": "1.4.3",
   "engines": {
     "node": ">=18"
   },
@@ -28,11 +28,11 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Ersith/akasha-book.git",
-    "directory": "dsh-akasha-gate"
+    "directory": "plugins/akasha-gate"
   },
   "scripts": {
     "test": "node selftest.test.mjs",
-    "check": "node --check lib/index.js"
+    "check": "node --check index.js"
   },
   "publishConfig": {
     "access": "public"