minecraft-dev-starter 0.1.0 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecraft-dev-starter",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "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",

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'
@@ -14,10 +15,31 @@ import { applyTools } from './tools.js'
 export const name = 'mcdev-host'
 
 /** 依赖的宿主服务。 */
-export const inject = ['webServer', 'sessions', 'tools']
+/**
+ * 必需服务：会话（取工作区）与工具注册表。
+ *
+ * `webServer` 不在这里——它是可选的（纯 CLI profile 没有 web 层），
+ * 由 `apply` 里的 `ctx.inject(['webServer'], …)` 单独等。
+ */
+export const inject = ['sessions', 'tools']
+
+/**
+ * 插件版本；客户端会显示，用来确认两边同一份代码。
+ *
+ * 从 package.json 读，不再手写——手写的常量在发版后必然忘记同步，
+ * 面板上就会出现"装了 0.1.1、显示 0.1.0"的假版本。
+ */
+const VERSION = readPackageVersion()
 
-/** 插件版本；客户端会显示，用来确认两边同一份代码。 */
-const VERSION = '0.1.0'
+/** @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
@@ -119,9 +141,14 @@ export function apply(ctx, config = {}) {
   // 面板与模型共用同一套服务；工具只是薄封装（M5）
   applyTools(ctx, { api })
 
-  ctx.effect(
-    () =>
-      ctx.webServer.register({
+  // webServer 是**可选**的：纯 CLI / headless profile 里没有它，
+  // 这时插件应当照常激活（工具可用），只是没有 HTTP 路由。
+  // 早期把它写进 inject 会让整个 profile 加载失败（"pending: waiting for service"）。
+  ctx.effect(() => {
+    const mount = (scoped) => {
+      const webServer = scoped?.webServer
+      if (webServer === undefined || typeof webServer.register !== 'function') return undefined
+      const dispose = webServer.register({
         kind: 'prefix',
         path: '/mcdev/api',
         handler: async (req, res) => {
@@ -157,9 +184,26 @@ export function apply(ctx, config = {}) {
             writeJson(res, 500, { ok: false, error: { code: 'internal', message } })
           }
         },
-      }),
-    'mcdev: /mcdev/api routes',
-  )
+      })
+      console.log('[mcdev] http routes mounted at /mcdev/api')
+      return () => {
+        try {
+          dispose?.()
+        } catch {
+          /* 已经在卸载 */
+        }
+      }
+    }
+
+    if (typeof ctx.inject === 'function') {
+      return ctx.inject(['webServer'], (scoped) => mount(scoped))
+    }
+    try {
+      return mount(ctx)
+    } catch {
+      return undefined
+    }
+  }, 'mcdev: /mcdev/api routes')
 
   console.log(`[mcdev] host ready (${VERSION}) — /mcdev/api/{projects.scan,projects.detail,state.info}`)
 }