minecraft-dev-starter 0.0.0-stage → 0.1.1

package/src/client/styles.js

@@ -0,0 +1,329 @@
+/**
+ * 样式：一次性注入 <style>，**只使用 DSH 的设计 token**（`--dsw-*`）。
+ *
+ * 规则来自系统自身：颜色一律走 `--dsw-alias-*`，字号走 `--dsw-font-*`，
+ * 控件高度对齐 24/28、圆角 3/4/8。不写死任何色值——跟随主题与皮肤切换，
+ * 也不会在亮色主题下突然出现一块深色面板。
+ *
+ * 这条约束由测试守护：`test/styles.test.js` 会拒绝出现原始色值的声明。
+ * @module minecraft-dev-starter/client/styles
+ */
+
+export const STYLE_ID = 'mcdev-styles'
+
+export const CSS = `
+.mcdev-anchor { position: relative; display: inline-flex; }
+.mcdev-capsule { display: inline-flex; align-items: center; gap: 4px; }
+
+/* 标题栏胶囊：与系统控件同高同圆角，默认无底色 */
+.mcdev-pill {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  height: 24px;
+  max-width: 220px;
+  padding: 0 8px;
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 999px;
+  background: transparent;
+  color: var(--dsw-alias-label-primary);
+  font: var(--dsw-font-xxs-12);
+  cursor: pointer;
+}
+.mcdev-pill:hover { background: var(--dsw-alias-interactive-bg-hover); }
+/* 窄的时候让工程名让步：目标名永远完整显示 */
+.mcdev-pill-text { display: flex; align-items: center; min-width: 0; }
+.mcdev-pill-project {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  color: var(--dsw-alias-label-secondary);
+}
+.mcdev-pill-sep { flex: none; padding: 0 4px; color: var(--dsw-alias-label-tertiary); }
+.mcdev-pill-target { flex: none; white-space: nowrap; }
+
+.mcdev-dot {
+  width: 7px;
+  height: 7px;
+  flex: none;
+  border-radius: 50%;
+  background: var(--dsw-alias-label-tertiary);
+}
+.mcdev-dot[data-state="ok"] { background: var(--dsw-alias-state-success-primary); }
+.mcdev-dot[data-state="warn"] { background: var(--dsw-alias-state-warn-primary); }
+.mcdev-dot[data-state="error"] { background: var(--dsw-alias-state-error-primary); }
+
+/* 浮层：三层结构（表头 / 列表 / 选择区），选工程时列表高度不变 */
+.mcdev-flyout {
+  position: absolute;
+  top: 30px;
+  right: 0;
+  z-index: 60;
+  display: flex;
+  flex-direction: column;
+  width: 340px;
+  max-height: 60vh;
+  padding: 0;
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 8px;
+  background: var(--dsw-alias-bg-layer-2);
+  color: var(--dsw-alias-label-primary);
+  font: var(--dsw-font-xxs-12);
+  box-shadow: 0 8px 24px var(--dsw-alias-bg-mask-1);
+  overflow: hidden;
+}
+.mcdev-flyout-head {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  flex: none;
+  padding: 10px 10px 8px;
+  border-bottom: 1px solid var(--dsw-alias-hairline);
+}
+.mcdev-flyout-list {
+  flex: 1 1 auto;
+  min-height: 0;
+  overflow: auto;
+  padding: 6px;
+}
+.mcdev-flyout-pane {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  flex: none;
+  padding: 8px 10px 10px;
+  border-top: 1px solid var(--dsw-alias-hairline);
+}
+
+/* 列表行：一行一个工程，高度恒定 */
+.mcdev-list-row {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  width: 100%;
+  height: 30px;
+  padding: 0 8px;
+  border: 0;
+  border-radius: 4px;
+  background: transparent;
+  color: var(--dsw-alias-label-primary);
+  font: var(--dsw-font-xxs-12);
+  text-align: left;
+  cursor: pointer;
+}
+.mcdev-list-row:hover { background: var(--dsw-alias-interactive-bg-hover); }
+.mcdev-list-row[data-current="true"] { background: var(--dsw-alias-interactive-bg-hover); }
+.mcdev-list-row[data-current="true"] .mcdev-list-name { font: var(--dsw-font-xxs-strong-12); }
+.mcdev-list-name { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.mcdev-list-meta { flex: none; color: var(--dsw-alias-label-tertiary); font: var(--dsw-font-xxxs-11); }
+.mcdev-ellipsis { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+
+.mcdev-title { font: var(--dsw-font-xxs-strong-12); }
+.mcdev-sub { color: var(--dsw-alias-label-secondary); }
+.mcdev-muted { color: var(--dsw-alias-label-tertiary); }
+.mcdev-code { font-family: var(--dsw-font-mono); font-size: 11px; }
+.mcdev-warn { color: var(--dsw-alias-state-warn-primary); }
+.mcdev-error { color: var(--dsw-alias-state-error-primary); }
+
+.mcdev-row { display: flex; align-items: baseline; gap: 8px; }
+.mcdev-key { flex: none; width: 78px; color: var(--dsw-alias-label-tertiary); }
+
+.mcdev-mini {
+  display: inline-flex;
+  align-items: center;
+  gap: 3px;
+  height: 22px;
+  padding: 0 8px;
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 4px;
+  background: transparent;
+  color: var(--dsw-alias-label-secondary);
+  font: var(--dsw-font-xxxs-11);
+  cursor: pointer;
+}
+.mcdev-mini:hover { background: var(--dsw-alias-interactive-bg-hover); color: var(--dsw-alias-label-primary); }
+.mcdev-mini-icon { width: 22px; padding: 0; justify-content: center; }
+
+/* 目标标签：中性徽标，不是按钮——M2 之前没有可点的动作 */
+.mcdev-badges { display: flex; flex-wrap: wrap; gap: 6px; margin-top: 6px; }
+.mcdev-badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  height: 20px;
+  padding: 0 6px;
+  border: 1px solid var(--dsw-alias-border-l1);
+  border-radius: 4px;
+  background: var(--dsw-alias-bg-layer-3);
+  color: var(--dsw-alias-label-secondary);
+  font: var(--dsw-font-xxxs-11);
+}
+.mcdev-badge[data-guessed="true"] {
+  border-style: dashed;
+  background: transparent;
+  color: var(--dsw-alias-label-tertiary);
+}
+.mcdev-badge-tag { color: var(--dsw-alias-label-tertiary); }
+
+.mcdev-hint { color: var(--dsw-alias-label-tertiary); font: var(--dsw-font-xxxs-11); }
+
+/* 运行按钮：系统尺寸（24 高、4 圆角），中性底色 */
+.mcdev-actions { display: flex; flex-wrap: wrap; gap: 6px; margin-top: 6px; }
+.mcdev-run {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  height: 24px;
+  padding: 0 8px;
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 4px;
+  background: transparent;
+  color: var(--dsw-alias-label-primary);
+  font: var(--dsw-font-xxs-12);
+  cursor: pointer;
+}
+.mcdev-run:hover:not(:disabled) { background: var(--dsw-alias-interactive-bg-hover); }
+.mcdev-run:disabled { opacity: 0.4; cursor: default; }
+.mcdev-run[data-tone="stop"] { color: var(--dsw-alias-danger); border-color: var(--dsw-alias-danger); }
+.mcdev-run-icon { width: 24px; padding: 0; justify-content: center; }
+
+/* 目标单选列表：一行一个，模块名做小标题 */
+.mcdev-options { display: flex; flex-direction: column; gap: 2px; margin-top: 6px; }
+.mcdev-option-group { display: flex; flex-direction: column; gap: 2px; }
+.mcdev-option-module { margin-top: 4px; color: var(--dsw-alias-label-tertiary); font: var(--dsw-font-xxxs-11); }
+.mcdev-option {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  height: 22px;
+  padding: 0 4px;
+  border-radius: 4px;
+  cursor: pointer;
+}
+.mcdev-option:hover { background: var(--dsw-alias-interactive-bg-hover); }
+.mcdev-option.is-disabled { opacity: 0.5; cursor: default; }
+.mcdev-radio { margin: 0; accent-color: var(--dsw-alias-accent); }
+.mcdev-option-label { font: var(--dsw-font-xxs-12); }
+
+.mcdev-status { margin-top: 6px; color: var(--dsw-alias-state-success-primary); font: var(--dsw-font-xxxs-11); }
+.mcdev-inline-status {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  margin-left: 8px;
+  color: var(--dsw-alias-state-success-primary);
+  font: var(--dsw-font-xxxs-11);
+}
+
+/* 日志尾部：等宽、可滚，底色用系统层级 3 */
+.mcdev-logs {
+  max-height: 220px;
+  margin: 8px 0 0;
+  padding: 8px;
+  overflow: auto;
+  border: 1px solid var(--dsw-alias-border-l1);
+  border-radius: 4px;
+  background: var(--dsw-alias-bg-layer-3);
+  color: var(--dsw-alias-label-secondary);
+  font-family: var(--dsw-font-mono);
+  font-size: 11px;
+  line-height: 1.5;
+  white-space: pre-wrap;
+}
+
+/* 运行日志标签：顶部一条控制带，下面是整块日志 */
+.mcdev-logtab { display: flex; flex-direction: column; height: 100%; min-height: 0; padding: 8px 10px 10px; }
+.mcdev-log-head { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; padding-bottom: 8px; }
+.mcdev-select {
+  height: 24px;
+  max-width: 220px;
+  padding: 0 6px;
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 4px;
+  background: var(--dsw-alias-bg-layer-2);
+  color: var(--dsw-alias-label-primary);
+  font: var(--dsw-font-xxxs-11);
+}
+.mcdev-follow { display: inline-flex; align-items: center; gap: 4px; color: var(--dsw-alias-label-tertiary); font: var(--dsw-font-xxxs-11); }
+.mcdev-diagnosis {
+  margin-bottom: 8px;
+  padding: 8px;
+  border: 1px solid var(--dsw-alias-state-error-primary);
+  border-radius: 4px;
+  background: var(--dsw-alias-bg-layer-2);
+}
+.mcdev-diagnosis-hint { color: var(--dsw-alias-state-error-primary); font: var(--dsw-font-xxs-strong-12); }
+.mcdev-logs-full { flex: 1 1 auto; min-height: 0; max-height: none; margin: 0; }
+
+.mcdev-section { margin-top: 12px; }
+.mcdev-section > h4 {
+  margin: 0 0 4px;
+  color: var(--dsw-alias-label-tertiary);
+  font: var(--dsw-font-xxxs-strong-11);
+  letter-spacing: 0.04em;
+  text-transform: uppercase;
+}
+
+.mcdev-table { width: 100%; border-collapse: collapse; font: var(--dsw-font-xxxs-11); }
+.mcdev-table th,
+.mcdev-table td { padding: 3px 6px 3px 0; text-align: left; vertical-align: top; }
+.mcdev-table thead th {
+  color: var(--dsw-alias-label-tertiary);
+  font: var(--dsw-font-xxxs-strong-11);
+  border-bottom: 1px solid var(--dsw-alias-hairline);
+}
+
+.mcdev-detail { padding: 12px; font: var(--dsw-font-xxs-12); color: var(--dsw-alias-label-primary); }
+.mcdev-stack { display: flex; flex-direction: column; gap: 4px; }
+.mcdev-icon { display: inline-flex; align-items: center; justify-content: center; flex: none; }
+.mcdev-icon-text { display: inline-flex; align-items: center; gap: 4px; }
+
+/* 动效：短、克制；系统开了"减少动态效果"就全部关掉 */
+@keyframes mcdev-pop-in {
+  from { opacity: 0; transform: translateY(-4px); }
+  to { opacity: 1; transform: none; }
+}
+@keyframes mcdev-pulse {
+  0%, 100% { opacity: 1; }
+  50% { opacity: 0.45; }
+}
+.mcdev-flyout { animation: mcdev-pop-in 120ms ease-out; }
+.mcdev-dot[data-pulse="true"] { animation: mcdev-pulse 1.6s ease-in-out infinite; }
+.mcdev-pill,
+.mcdev-run,
+.mcdev-mini,
+.mcdev-option { transition: background-color 120ms ease, color 120ms ease, border-color 120ms ease; }
+
+/* 骨架：扫描/加载中的占位，避免一片空白 */
+.mcdev-skeleton { display: flex; flex-direction: column; gap: 6px; margin-top: 8px; }
+.mcdev-skeleton-row {
+  height: 10px;
+  border-radius: 3px;
+  background: var(--dsw-alias-interactive-bg-hover);
+  animation: mcdev-pulse 1.4s ease-in-out infinite;
+}
+.mcdev-skeleton-row:nth-child(2) { width: 72%; }
+.mcdev-skeleton-row:nth-child(3) { width: 46%; }
+
+@media (prefers-reduced-motion: reduce) {
+  .mcdev-flyout,
+  .mcdev-dot[data-pulse="true"],
+  .mcdev-skeleton-row { animation: none; }
+  .mcdev-pill,
+  .mcdev-run,
+  .mcdev-mini,
+  .mcdev-option { transition: none; }
+}
+`
+
+/** 注入一次；重复调用无副作用。 */
+export function ensureStyles() {
+  if (typeof document === 'undefined') return
+  if (document.getElementById(STYLE_ID) !== null) return
+  const style = document.createElement('style')
+  style.id = STYLE_ID
+  style.textContent = CSS
+  document.head.appendChild(style)
+}

package/src/index.js

@@ -0,0 +1,193 @@
+/**
+ * 宿主入口：挂 `/mcdev/api` 路由，把请求交给方法表。
+ *
+ * 工作区根从"最近一个活跃会话的 cwd"取——HTTP 请求本身不带会话，
+ * 而模型工具那条路径有 `exec.agent.session.header.cwd`；两条路径最终都落到同一个扫描器。
+ * @module minecraft-dev-starter
+ */
+
+import { createApi } from './lib/api.js'
+import { createLaunchService } from './lib/launches.js'
+import { applyTools } from './tools.js'
+
+/** Cordis 插件名。 */
+export const name = 'mcdev-host'
+
+/** 依赖的宿主服务。 */
+/**
+ * 必需服务：会话（取工作区）与工具注册表。
+ *
+ * `webServer` 不在这里——它是可选的（纯 CLI profile 没有 web 层），
+ * 由 `apply` 里的 `ctx.inject(['webServer'], …)` 单独等。
+ */
+export const inject = ['sessions', 'tools']
+
+/** 插件版本；客户端会显示，用来确认两边同一份代码。 */
+const VERSION = '0.1.0'
+
+/**
+ * @param {import('node:http').IncomingMessage} req
+ * @returns {Promise<unknown>}
+ */
+function readJsonBody(req) {
+  return new Promise((resolve, reject) => {
+    let raw = ''
+    req.setEncoding('utf8')
+    req.on('data', (chunk) => {
+      raw += chunk
+      if (raw.length > 1024 * 1024) reject(new Error('body too large'))
+    })
+    req.on('end', () => {
+      if (raw.trim() === '') return resolve(undefined)
+      try {
+        resolve(JSON.parse(raw))
+      } catch (error) {
+        reject(error)
+      }
+    })
+    req.on('error', reject)
+  })
+}
+
+/**
+ * @param {import('node:http').ServerResponse} res
+ * @param {number} status
+ * @param {unknown} value
+ */
+function writeJson(res, status, value) {
+  const body = JSON.stringify(value)
+  res.writeHead(status, {
+    'content-type': 'application/json; charset=utf-8',
+    'cache-control': 'no-store',
+    'content-length': Buffer.byteLength(body),
+  })
+  res.end(body)
+}
+
+/**
+ * 活跃会话的工作目录清单。
+ *
+ * 面板切会话时由客户端把 cwd 显式传下来；这里是"没传时"的兜底与启动校验的依据。
+ * `MCDEV_WORKSPACE` 是测试/固定工作区的逃生门。
+ * @param {import('@deepseek-ai/cordis').Context} ctx
+ * @returns {string[]}
+ */
+function sessionCwds(ctx) {
+  const pinned = process.env.MCDEV_WORKSPACE
+  if (typeof pinned === 'string' && pinned !== '') return [pinned]
+  /** @type {string[]} */
+  const roots = []
+  try {
+    for (const session of ctx.sessions.list()) {
+      const cwd = session?.header?.cwd
+      if (typeof cwd === 'string' && cwd !== '' && !roots.includes(cwd)) roots.push(cwd)
+    }
+  } catch {
+    /* 没有会话服务时退回进程 cwd */
+  }
+  if (roots.length === 0) roots.push(process.cwd())
+  return roots
+}
+
+/**
+ * 最近一个活跃会话的工作目录（扫描默认值）。
+ * @param {import('@deepseek-ai/cordis').Context} ctx
+ * @returns {string | undefined}
+ */
+function resolveWorkspaceRoot(ctx) {
+  return sessionCwds(ctx).at(-1)
+}
+
+/** 部署配置默认值；patch 行的 `config` 会覆盖同名项。 */
+const DEFAULTS = {
+  autoOpenLogTab: true,
+  readyTimeoutMs: 90_000,
+  logRingLines: 2_000,
+}
+
+/**
+ * @param {import('@deepseek-ai/cordis').Context} ctx
+ * @param {Record<string, unknown>} [config]
+ */
+export function apply(ctx, config = {}) {
+  const settings = { ...DEFAULTS, ...(config ?? {}) }
+  const api = createApi({
+    version: VERSION,
+    resolveRoot: () => resolveWorkspaceRoot(ctx),
+    resolveRoots: () => sessionCwds(ctx),
+    config: { autoOpenLogTab: settings.autoOpenLogTab !== false },
+    launchService: createLaunchService({
+      readyTimeoutMs: Number(settings.readyTimeoutMs) || DEFAULTS.readyTimeoutMs,
+      maxLogLines: Number(settings.logRingLines) || DEFAULTS.logRingLines,
+    }),
+  })
+
+  // 面板与模型共用同一套服务；工具只是薄封装（M5）
+  applyTools(ctx, { api })
+
+  // 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) => {
+          const { pathname } = new URL(req.url ?? '/', 'http://dsh.internal')
+
+          if (req.method === 'GET' && pathname === '/mcdev/api/ping') {
+            writeJson(res, 200, { ok: true, version: VERSION, pid: process.pid })
+            return
+          }
+          if (req.method !== 'POST') {
+            writeJson(res, 405, { ok: false, error: { code: 'method', message: 'use POST' } })
+            return
+          }
+
+          const method = pathname.startsWith('/mcdev/api/') ? pathname.slice('/mcdev/api/'.length) : ''
+          if (method === '' || method.includes('/')) {
+            writeJson(res, 404, { ok: false, error: { code: 'not-found', message: `unknown method "${method}"` } })
+            return
+          }
+          const handler = Object.hasOwn(api, method) ? api[method] : undefined
+          if (typeof handler !== 'function') {
+            writeJson(res, 404, { ok: false, error: { code: 'not-found', message: `unknown method "${method}"` } })
+            return
+          }
+
+          try {
+            const payload = await readJsonBody(req)
+            const result = await handler(payload)
+            writeJson(res, 200, { ok: true, result })
+          } catch (error) {
+            const message = error instanceof Error ? error.message : String(error)
+            console.warn(`[mcdev] ${method} failed: ${message}`)
+            writeJson(res, 500, { ok: false, error: { code: 'internal', message } })
+          }
+        },
+      })
+      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}`)
+}