@linkdesk/plugin-sdk 0.1.32 → 0.1.34

package/package.json

@@ -1,68 +1,68 @@
-{
-  "name": "@linkdesk/plugin-sdk",
-  "version": "0.1.32",
-  "description": "@linkdesk/plugin-sdk——LinkDesk 插件作者 SDK（对标 @types/vscode）：window.linkdesk.* 类型 + 一键 build(.linkdesk-plugin) + dev 宿主 + plugin.json 验证 + eslint 门禁（E6#54d）。作者 npm i 后零壳源码依赖。",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    },
-    "./eslint": {
-      "types": "./dist/eslint/index.d.ts",
-      "default": "./dist/eslint/index.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "dist",
-    "schemas",
-    "dev-host"
-  ],
-  "sideEffects": false,
-  "bin": {
-    "linkdesk-plugin-sdk": "./dist/bin.js"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "prepack": "tsc -p tsconfig.build.json"
-  },
-  "dependencies": {
-    "@linkdesk/contracts": "^0.1.1",
-    "@typescript-eslint/eslint-plugin": "^8.0.0",
-    "@typescript-eslint/parser": "^8.0.0",
-    "@vitejs/plugin-react": "^4.3.4",
-    "ajv": "^8.17.1",
-    "eslint": "^9.0.0",
-    "eslint-import-resolver-typescript": "^4.4.5",
-    "eslint-plugin-import-x": "^4.17.1",
-    "eslint-plugin-react-hooks": "^7.1.1",
-    "i18next": "^26.3.6",
-    "jsonc-parser": "^3.3.1",
-    "jszip": "^3.10.1",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
-    "react-i18next": "^17.0.10",
-    "vite": "^6.0.0"
-  },
-  "devDependencies": {
-    "@types/node": "^24.0.0",
-    "typescript": "^5.9.0"
-  },
-  "keywords": [
-    "linkdesk",
-    "plugin",
-    "sdk",
-    "vite"
-  ],
-  "license": "MIT"
-}
+{
+  "name": "@linkdesk/plugin-sdk",
+  "version": "0.1.34",
+  "description": "@linkdesk/plugin-sdk——LinkDesk 插件作者 SDK（对标 @types/vscode）：window.linkdesk.* 类型 + 一键 build(.linkdesk-plugin) + dev 宿主 + plugin.json 验证 + eslint 门禁（E6#54d）。作者 npm i 后零壳源码依赖。",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./eslint": {
+      "types": "./dist/eslint/index.d.ts",
+      "default": "./dist/eslint/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "schemas",
+    "dev-host"
+  ],
+  "sideEffects": false,
+  "bin": {
+    "linkdesk-plugin-sdk": "./dist/bin.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepack": "tsc -p tsconfig.build.json"
+  },
+  "dependencies": {
+    "@linkdesk/contracts": "^0.1.1",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "@vitejs/plugin-react": "^4.3.4",
+    "ajv": "^8.17.1",
+    "eslint": "^9.0.0",
+    "eslint-import-resolver-typescript": "^4.4.5",
+    "eslint-plugin-import-x": "^4.17.1",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "i18next": "^26.3.6",
+    "jsonc-parser": "^3.3.1",
+    "jszip": "^3.10.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-i18next": "^17.0.10",
+    "vite": "^6.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.9.0"
+  },
+  "keywords": [
+    "linkdesk",
+    "plugin",
+    "sdk",
+    "vite"
+  ],
+  "license": "MIT"
+}

package/schemas/host-reserved.json

@@ -1,5 +1,6 @@
 {
-  "$comment": "宿主保留面账（生成式·定稿 E6#111b／1.32）——插件不得占用这些名字；改动本账 = 一次公共面决策，改完壳仓命令/设置/协议面必须重跑 scripts/gen-host-reserved.mjs（npm run audit:plugin-scope:regen）。⚠️ configKeys 含**退役键**（曾被宿主使用、现已不再写入的键）：退役键**不腾出保留面**——老 settings.json 里可能还留着值，插件此刻占它 = 顶掉的是宿主的历史数据（且迁移代码仍会读它）。",
+  "$comment": "宿主保留面账（生成式·E6#111b／1.32 定稿，1.49 补 version）——插件不得占用这些名字。消费方有**两条腿，互不覆盖**：① **壳腿** = 壳仓 `scripts/audit-plugin-scope.mjs`（跨容器普查，读本账 ＋ 反向核对实况）与 `src/core/registry/host-reserved.generated.ts`（壳**运行时**仲裁读的生成副本）；② **SDK 腿** = `@linkdesk/plugin-sdk` 的四个 `check-*-ownership`（随包下发本账的副本 `schemas/host-reserved.json`，在**插件仓 CI** 判红）。为什么必须两条腿：壳腿看不见插件仓的源码，SDK 腿看不见壳的运行时——各自的射程都到不了对面。**改本表 = 一次公共面决策**：动手前先问「**这是公共面，还是漏网的借用？**」——公共面（多人正当读写、按约定共享）该进本账的设计里单列，借用（某插件用了宿主的名字）一律判红、不许宽恕；**新增条目要在这一段或对应家族的 why 里写明判据**，别只加一个名字。改完必须重跑生成器 `npm run audit:plugin-scope:regen`（scripts/gen-host-reserved.mjs）——账 ＋ SDK 副本 ＋ 运行时副本**三份同源**，手改任一份都会被判漂。**双向对账门禁在哪**：`node scripts/gen-host-reserved.mjs --check`（四向：实况→账 ／ 账→实况 ／ SDK 副本逐字节 ／ 运行时副本逐元素），已接在 `npm run check` 里；实况多一条报 `ledger-missing`、账多一条报 `ledger-stale`、家族整段缺失/为空另有专门的报警。`version` = 本账**形状**的修订号（见生成器 `LEDGER_VERSION` 的抬版规则），不是 settings 迁移版本。⚠️ configKeys 含**退役键**（曾被宿主使用、现已不再写入的键）：退役键**不腾出保留面**——老 settings.json 里可能还留着值，插件此刻占它 = 顶掉的是宿主的历史数据（且迁移代码仍会读它）。",
+  "version": 1,
   "commandPrefixes": [
     "app.",
     "core.",
@@ -50,19 +51,21 @@
     "appearance",
     "update"
   ],
-  "contextKeys": [
+  "contextKeysHostOnly": [
     "activeEditor",
     "editorCount",
     "editorHasSelection",
     "inputFocus",
-    "settingFollowTheme",
-    "settingKey",
-    "settingModified",
-    "settingResetsToDefault",
     "sidebarPosition",
     "updateActionable",
     "updateButtonLabel"
   ],
+  "contextKeysPublic": [
+    "settingFollowTheme",
+    "settingKey",
+    "settingModified",
+    "settingResetsToDefault"
+  ],
   "appearanceRecipeIds": [
     "dark",
     "light"