minecraft-dev-starter 0.1.1 → 0.1.3

package/AGENTS.md

@@ -73,6 +73,7 @@ node <npm>/@deepseek-ai/dsh/lib/bin.js --profile m0test --port 3499 --no-open
 | 中文日志乱码 | `.bat` 输出按 GBK 编码 | `decodeLine`：先按 UTF-8 解，失败再按 GBK |
 | 工具报 "value is not lossless JSON" | 返回值里带了 `undefined` | 只放存在的字段；测试里用 `assertLossless()` |
 | 改 profile 后启动失败 | `package.json` 写入了 BOM | 用无 BOM 的 UTF-8 写；改完必须重启 DSH |
+| 仓库的 `node_modules` 神秘消失 | 在某个 profile 里把 `link:` 依赖换成 `file:`/npm 包时，pnpm 解链会**删掉被链接目录的 `node_modules`**（实测：`plugin add link:` → 在 → `plugin add file:tgz` → 没了） | 别在同一 profile 里来回切换安装方式；tarball/registry 验证用独立 profile；发现消失就 `npm install --ignore-scripts` 重装 |
 | 侧栏标签打不开 | `openTab` 的展开是异步的 | 打开后等一帧再断言 `isExpanded()` |
 
 其他约定：
@@ -158,9 +159,26 @@ server：`Done (…s)!`）；状态落盘并做重启后对账。顺带修了 GB
 - 面板改名「MC 工程」→「Mod Dev」（功能名，不是名词描述），浮层表头/标签/详情页统一。
 - 单工程工作区跳过工程列表：表头直接承担工程身份（名字 + loader/版本 + 路径）。
 
+## 发布记录
+
+- `0.1.0` → 首版。
+- `0.1.1` → 修「最小 profile 起不来」：`webServer` 从 `inject` 里拿掉，改用
+  `ctx.inject(['webServer'], …)` 可选等待。原来在没有 web 层的 profile（只有 `dsh-base`）里会
+  `pending (waiting for service: webServer)`，整个 plugin tree 加载失败。
+- `0.1.2` → 修「装 0.1.1 却打印 0.1.0」：`VERSION` 改为启动时读 `package.json`。
+
+发版注意：
+
+- 账号用的是 **granular token（只允许暂存）**，直接 `npm publish` 会被拒为 `E_STAGE_REQUIRED`。
+  流程是 `npm stage publish` → `npm stage list`（等 `status: validated`）→
+  `npm stage approve <stage-id>`（人工过 2FA）。token 不能批准，批准必须是人。
+- 发布前必须 `npm run build`：`lib/client.js` 是提交进仓库的产物，忘了构建就会发出旧客户端。
+- 新版本发出去后，用干净 profile 装一次并看启动日志里的 `host ready (x.y.z)`，
+  这条同时验证了「版本号读对了」与「包结构完整」。
+
 ## 还没做的事
 
 - **M6 通用启动器**：HMCL 实例库 + 直启 java，让面板也能起非 Gradle 工程（估 5–8 天）。
-- **发布**：目前只在本地 `link:` 安装。发布流程见 README 的「发布」一节。
 - 跨 profile 共用 `~/.dsh/mc-dev-starter/state.json`：不同 profile 的实例记录会混在一起，
   日志标签已按工程过滤，暂不影响使用，但值得按 profile 分目录。
+- 桌面版目前仍用 `link:` 安装（改代码即时生效）；切到 npm 版本需要每次改完都发版。

package/README.md

@@ -105,6 +105,18 @@ DSH 插件的分发就是 npm 包 + 一份清单声明，没有单独的注册
 3. **自检**：`npm test`，`npm pack --dry-run` 看包里有没有多余文件（`files` 字段已限定
    `src`、`lib`、`cordis.patch.yml`、README、AGENTS）。
 4. **发布**：`npm publish --access public`。版本号走 semver，破坏性改动升主版本。
+
+   如果用的是 granular token（只允许暂存），会被拒为 `E_STAGE_REQUIRED`，改走两步：
+
+   ```powershell
+   npm stage publish                 # 提交到暂存区，拿到 stage-id
+   npm stage list                   # 看到 status: validated 再批准
+   npm stage approve <stage-id>      # 需要人工过 2FA（网页确认）
+   ```
+
+   暂存 → 人工批准是 npm 的设计：机器提交、人确认，token 泄露也发不出正式版本。
+   批准后 `latest` 自动指向新版本，通常十几秒内可从 registry 拉到。
+
 5. **兼容性**：宿主 API 会演进（本插件按 0.2.1-rc.3 的 `dsh-tools` 开发）。发布前把
    `dependencies` 里的 `@deepseek-ai/dsh-tools` 与 `peerDependencies` 的 cordis 范围对齐
    目标运行时；跨大版本时最好发两个版本而不是硬兼容。

package/lib/client.js

@@ -868,7 +868,7 @@ function DetailTab() {
           )
         )
       ],
-      h("div", { className: "mcdev-hint", style: { marginTop: 6 } }, "\u5E26 ? \u7684\u4EFB\u52A1\u662F\u6309 loader \u60EF\u4F8B\u63A8\u6D4B\u7684\uFF0C\u672A\u7ECF\u9A8C\u8BC1\uFF1B\u542F\u52A8\u80FD\u529B\u5728 M2 \u63A5\u5165\u3002")
+      h("div", { className: "mcdev-hint", style: { marginTop: 6 } }, "\u5E26 ? \u7684\u4EFB\u52A1\u662F\u6309 loader \u60EF\u4F8B\u63A8\u6D4B\u7684\uFF0C\u5C1A\u672A\u771F\u5B9E\u8FD0\u884C\u9A8C\u8BC1\uFF1B\u53EF\u4EE5\u76F4\u63A5\u542F\u52A8\u8BD5\uFF0C\u5931\u8D25\u65F6\u65E5\u5FD7\u91CC\u4F1A\u7ED9\u51FA\u539F\u56E0\u3002")
     ]),
     section(
       "\u8BC1\u636E",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecraft-dev-starter",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "private": false,
   "description": "DSH plugin that detects Minecraft mod projects and launches the client from the session header, with live logs in the sidebar",
   "type": "module",
@@ -44,13 +44,20 @@
     "test": "node --test \"test/*.test.js\""
   },
   "license": "MIT",
-  "dependencies": {
-    "@deepseek-ai/dsh-tools": "0.2.1-rc.3"
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Chemiofitor4096/minecraft-dev-starter.git"
+  },
+  "homepage": "https://github.com/Chemiofitor4096/minecraft-dev-starter#readme",
+  "bugs": {
+    "url": "https://github.com/Chemiofitor4096/minecraft-dev-starter/issues"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1"
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-tools": "^0.2.1-rc.1"
   },
   "devDependencies": {
+    "@deepseek-ai/dsh-tools": "0.2.1-rc.3",
     "esbuild": "^0.28.2"
   }
 }

package/src/client/DetailTab.js

@@ -158,7 +158,7 @@ export function DetailTab() {
               ),
             ),
           ]),
-      h('div', { className: 'mcdev-hint', style: { marginTop: 6 } }, '带 ? 的任务是按 loader 惯例推测的，未经验证；启动能力在 M2 接入。'),
+      h('div', { className: 'mcdev-hint', style: { marginTop: 6 } }, '带 ? 的任务是按 loader 惯例推测的，尚未真实运行验证；可以直接启动试，失败时日志里会给出原因。'),
     ]),
 
     section(

package/src/index.js

@@ -6,6 +6,7 @@
  * @module minecraft-dev-starter
  */
 
+import { readFileSync } from 'node:fs'
 import { createApi } from './lib/api.js'
 import { createLaunchService } from './lib/launches.js'
 import { applyTools } from './tools.js'
@@ -22,8 +23,23 @@ export const name = 'mcdev-host'
  */
 export const inject = ['sessions', 'tools']
 
-/** 插件版本；客户端会显示，用来确认两边同一份代码。 */
-const VERSION = '0.1.0'
+/**
+ * 插件版本；客户端会显示，用来确认两边同一份代码。
+ *
+ * 从 package.json 读，不再手写——手写的常量在发版后必然忘记同步，
+ * 面板上就会出现"装了 0.1.1、显示 0.1.0"的假版本。
+ */
+const VERSION = readPackageVersion()
+
+/** @returns {string} */
+function readPackageVersion() {
+  try {
+    const url = new URL('../package.json', import.meta.url)
+    return String(JSON.parse(readFileSync(url, 'utf8')).version)
+  } catch {
+    return '0.0.0-unknown'
+  }
+}
 
 /**
  * @param {import('node:http').IncomingMessage} req