dsh-unity-mcp 0.0.1 → 0.0.2

package/README.md

@@ -34,9 +34,17 @@
 
 配置为空时插件仅提供加载入口，并提示如何连接。它不会启动 Unity / Tuanjie 编辑器。连接配置完成后，DSH 启动上游 Node stdio 桥接进程，由桥接进程连接引擎端服务。
 
+## 通过对话配置工程（0.0.2 起）
+
+可以直接告诉 Agent：“把 Unity MCP 连接到 `C:/Projects/MyUnityProject`。”Agent 先调用 `unity_load_tools`，再调用 `unity_configure_project`，传入工程绝对路径 `projectPath`；只有自动发现失败时才需要补充 `serverPath`。未连接引擎时也能加载配置工具。
+
+工具检查工程的 `Assets`、`ProjectSettings` 和已构建的 CoderGamester 服务器入口，再通过 DSH 官方配置服务保存并重载插件。**保存影响当前 profile 的所有会话；会清空旧的 host、port、authTokenPath 覆盖项，改用新工程设置。** 其他配置保留。路径校验失败不会保存；并发修改连接字段时会要求重试。保存成功仅表示配置已应用，仍需重新加载工具并做只读场景查询，确认引擎在线。
+
+工具不会安装引擎包、构建服务器或启动编辑器。也可以继续在插件配置中手工设置路径。
+
 ## 工具懒加载
 
-每个 Agent 初始只看到 `unity_load_tools`。需要编辑器能力时，调用一次即可把当前服务器提供的 `mcp__unity__*` 工具加载到该 Agent；其他 Agent 仍保持未加载。场景、GameObject、组件、材质、资源、控制台和测试等工具的参数与结果沿用上游，插件不维护另一套工具清单。
+每个 Agent 初始只看到 `unity_load_tools`。调用后先获得 `unity_configure_project`，并加载当前服务器提供的 `mcp__unity__*` 工具；未连接时只有配置工具。其他 Agent 仍保持未加载。场景、GameObject、组件、材质、资源、控制台和测试等工具的参数与结果沿用上游，插件不维护另一套工具清单。
 
 加载动作不会修改工程。**加载后的编辑器操作可能创建、删除资源，修改场景、执行菜单或安装包。请先提交或备份工程，并检查每次调用的范围。** 如需立即暴露全部工具，把 `lazyTools` 设为 `false`。实际工具数量随上游版本变化。
 

package/index.mjs

@@ -2,8 +2,9 @@ import z from '@deepseek-ai/schemastery';
 import * as mcp from '@deepseek-ai/dsh-mcp-client';
 import { connectionConfig } from './lib/connection.mjs';
 import { installLazyTools } from './lib/lazy-tools.mjs';
+import { configurationTool } from './lib/configure-project.mjs';
 export const name = 'dsh-unity-mcp';
-export const inject = ['tools', 'agents'];
+export const inject = ['tools', 'agents', 'configEditor'];
 export const Config = z.object({
   projectPath: z.string().default('').description('Unity / Tuanjie 项目绝对路径 / Absolute project directory'),
   serverPath: z.string().default('').description('CoderGamester Server~/build/index.js 绝对路径；留空从项目发现 / Built server path; blank discovers in project'),
@@ -15,7 +16,7 @@ export const Config = z.object({
 });
 export async function apply(ctx, config) {
   // Install the loader even before configuration, so discovery explains setup.
-  installLazyTools(ctx, config.lazyTools);
+  installLazyTools(ctx, config.lazyTools, [configurationTool(ctx)]);
   if (!config.projectPath && !config.serverPath) {
     ctx.logger.info('Unity MCP: configure projectPath or serverPath to connect CoderGamester/mcp-unity.');
     return;

package/lib/configure-project.mjs

@@ -0,0 +1,36 @@
+import path from 'node:path';
+import { stat } from 'node:fs/promises';
+import { connectionConfig } from './connection.mjs';
+
+export function configurationTool(ctx) {
+  return {
+    name: 'unity_configure_project',
+    description: 'Save the Unity/Tuanjie project connection for this DSH profile and reconnect. Affects all sessions and clears host/port/auth-file overrides to use the selected project settings. Validates local paths before saving; does not start or modify the engine project. Requires CoderGamester/mcp-unity in the engine.',
+    parameters: { type: 'object', properties: {
+      projectPath: { type: 'string', description: 'Absolute Unity/Tuanjie project directory containing Assets and ProjectSettings.' },
+      serverPath: { type: 'string', description: 'Optional absolute built CoderGamester Server~/build/index.js. Omit or empty to auto-discover in the selected project.' }
+    }, required: ['projectPath'], additionalProperties: false },
+    output: { schema: { type: 'object', properties: { projectPath: { type: 'string' }, serverPath: { type: 'string' }, saved: { type: 'boolean' }, message: { type: 'string' } }, required: ['projectPath', 'serverPath', 'saved', 'message'], additionalProperties: false }, render: (_, value) => [{ type: 'text', text: JSON.stringify(value) }] },
+    execute: async ({ projectPath, serverPath = '' }) => {
+      if (typeof projectPath !== 'string' || !path.isAbsolute(projectPath)) throw Error('projectPath must be an absolute Unity/Tuanjie project path.');
+      for (const directory of ['Assets', 'ProjectSettings']) {
+        if (!(await stat(path.join(projectPath, directory))).isDirectory()) throw Error('Not a Unity/Tuanjie project: missing ' + directory);
+      }
+      const entries = ctx.configEditor.entries().filter(entry => entry.options.name === 'dsh-unity-mcp');
+      if (entries.length !== 1) throw Error('Expected exactly one dsh-unity-mcp configuration entry; resolve duplicate/missing plugin entries first.');
+      const entry = entries[0];
+      const snapshot = ctx.configEditor.configuration().find(row => row.entry === entry);
+      if (!snapshot) throw Error('Unity configuration changed; retry.');
+      const patch = { projectPath, serverPath, host: '', port: 0, authTokenPath: '' };
+      const current = { ...snapshot.inherited, ...snapshot.override };
+      await connectionConfig({ ...current, ...patch });
+      await ctx.configEditor.edit(entry, raw => {
+        for (const key of ['projectPath', 'serverPath', 'host', 'port', 'authTokenPath']) {
+          if (JSON.stringify(raw[key]) !== JSON.stringify(current[key])) throw Error('Unity connection configuration changed during validation; retry.');
+        }
+        return { ...raw, ...patch };
+      });
+      return { projectPath, serverPath, saved: true, message: 'Configuration saved and Loader reconciliation completed. Host/port/auth overrides cleared to use this project settings. Load Unity tools again; tool discovery alone does not prove the editor is online.' };
+    }
+  };
+}

package/lib/lazy-tools.mjs

@@ -1,8 +1,9 @@
 const PREFIX = 'mcp__unity__';
 const empty = { type: 'object', properties: {}, additionalProperties: false };
-export function installLazyTools(ctx, lazy = true) {
+export function installLazyTools(ctx, lazy = true, setupTools = []) {
   const states = new Map();
-  const definitions = () => ctx.tools.schemas().filter(tool => tool.name.startsWith(PREFIX)).map(tool => ctx.tools.get(tool.name)).filter(Boolean);
+  const definitions = () => [...setupTools, ...ctx.tools.schemas().filter(tool => tool.name.startsWith(PREFIX)).map(tool => ctx.tools.get(tool.name)).filter(Boolean)];
+  if (!lazy) for (const tool of setupTools) ctx.tools.register(tool);
   function attach(agent) {
     if (states.has(agent)) return;
     const state = { loaded: !lazy, signature: '', disposers: [], tools: [] };
@@ -11,7 +12,8 @@ export function installLazyTools(ctx, lazy = true) {
       if (signature === state.signature) return;
       for (const dispose of state.tools.splice(0).reverse()) dispose();
       if (state.mask) { state.mask(); state.mask = undefined; }
-      if (lazy && defs.length) state.mask = agent.ctx.tools.restrict({ deny: defs.map(tool => tool.name) });
+      const engineNames = defs.filter(tool => tool.name.startsWith(PREFIX)).map(tool => tool.name);
+      if (lazy && engineNames.length) state.mask = agent.ctx.tools.restrict({ deny: engineNames });
       if (state.loaded && lazy) {
         const installed = [];
         try { for (const definition of defs) installed.push(agent.ctx.tools.register({ ...definition })); }
@@ -30,7 +32,7 @@ export function installLazyTools(ctx, lazy = true) {
     states.set(agent, state);
     if (lazy) state.disposers.push(agent.ctx.tools.register({
       name: 'unity_load_tools',
-      description: 'Load Unity and Tuanjie editor tools for this agent: scenes, GameObjects, components, assets, materials, tests and console. Requires CoderGamester/mcp-unity installed and running in the engine. Loading does not modify the project; subsequent editor actions may.',
+      description: 'Load Unity/Tuanjie tools for this agent, including project connection setup even when disconnected. Editor tools cover scenes, GameObjects, assets and console; they require CoderGamester/mcp-unity in the engine. Loading itself changes no configuration or project.',
       parameters: empty,
       output: { schema: { type: 'object', properties: { tools: { type: 'array', items: { type: 'string' } } }, required: ['tools'], additionalProperties: false }, render: (_, value) => [{ type: 'text', text: JSON.stringify(value) }] },
       execute: async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-unity-mcp",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Unity and Tuanjie editor tools for DSH, powered by CoderGamester/mcp-unity with per-agent lazy loading.",
   "type": "module",
   "license": "MIT",
@@ -38,7 +38,7 @@
     }
   },
   "scripts": {
-    "check": "node --check index.mjs && node --check lib/connection.mjs && node --check lib/lazy-tools.mjs",
+    "check": "node --check index.mjs && node --check lib/connection.mjs && node --check lib/lazy-tools.mjs && node --check lib/configure-project.mjs",
     "test": "node --test test/*.test.mjs",
     "build": "npm run check",
     "pack:check": "npm pack --dry-run --json"
@@ -53,6 +53,7 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.5",
+    "@deepseek-ai/dsh-config-editor": "^0.2.1-rc.3",
     "@deepseek-ai/dsh-scope": "^0.2.1-rc.3",
     "@deepseek-ai/dsh-tools": "^0.2.1-rc.3"
   }