dsh-vscode-mode 0.12.0 → 0.13.0

package/unity/com.dsh.editor/Editor/DshCodeEditor.cs

@@ -1,19 +1,8 @@
-// DshCodeEditor.cs — DSH 文件编辑 Unity 外部脚本编辑器集成。
-// 机制：[InitializeOnLoad] 注册 IExternalCodeEditor，Preferences → External Tools 的
-// External Script Editor 下拉出现「DSH 文件编辑」（虚拟安装，无本地 exe）。
-// OpenProject：优先把打开请求移交 host（edrv.external.handoff）——已打开的 DSH 页面
-// （3s 移交轮询）就地执行打开规则，不重复开新页；无活跃页面/2s 未领取（页面刚关）则
-// 回退 Application.OpenURL 深链。移交全程后台线程（不阻塞编辑器主线程），
-// 回退开浏览器经 EditorApplication.delayCall 切回主线程。
-// 深链契约见插件 src/shared/externalOpen.ts（edrvOpen/edrvPaths/edrvLine/edrvColumn）。
-// 过滤：Unity 对双击的任何资产（含 prefab/scene）都会回调 OpenProject；仅放行文本/代码类
-// 扩展名（白名单 + Project Settings 用户扩展），其余返回 false 交还 Unity 原生处理
-// （双击预制体进预制体模式、双击场景开场景），对齐 DefaultExternalCodeEditor 行为。
-// 作者 ddj 2026-09-08
+// DSH external editor: current-user private OPEN REQUEST/ACK queue.
+// Unity API and preferences stay on the main thread; the worker uses the installed producer.
+// @author ddj 2026-09-28
 using System;
 using System.IO;
-using System.Net;
-using System.Text;
 using System.Threading;
 using UnityEditor;
 using UnityEngine;
@@ -26,11 +15,10 @@ namespace Dsh.EditorIntegration
     {
         private const string EditorName = "DSH 文件编辑";
         private const string VirtualPath = "dsh-editor://vscode-mode";
-        private const string BaseUrlPref = "DshEditor.BaseUrl";
-        private const string DefaultBaseUrl = "http://127.0.0.1:3080";
-        private const string DshVersion = "0.2.4";
+        private const string DshVersion = "0.3.0";
         internal const string VersionText = DshVersion;
 
+        /// <summary>Register this editor without changing the user's selection. @author ddj 2026-09-28</summary>
         static DshCodeEditor()
         {
             try
@@ -38,20 +26,16 @@ namespace Dsh.EditorIntegration
                 CodeEditor.Register(new DshCodeEditor());
                 Debug.Log("[DshCodeEditor] 已注册为 Unity 外部脚本编辑器（v" + DshVersion + "）");
             }
-            catch (Exception e)
-            {
-                Debug.LogError("[DshCodeEditor] 注册失败：" + e);
-            }
+            catch (Exception error) { Debug.LogError("[DshCodeEditor] 注册失败：" + error); }
         }
 
         public CodeEditor.Installation[] Installations
         {
-            // Path 指向真实存在的 Unity.exe：部分 Unity 版本会过滤「路径不存在」的安装条目；
-            // 打开逻辑全在本类（OpenProject），该路径仅作占位与选中态回读。
             get { return new[] { new CodeEditor.Installation { Name = EditorName, Path = RealPath() } }; }
         }
 
-        /// <summary>本包声明的安装路径（真实存在的 Unity.exe；取不到时回退虚拟路径）。</summary>
+        /// <summary>Use a real installation path for Unity's dropdown. @author ddj 2026-09-28</summary>
+        /// <returns>Unity executable or the legacy virtual identifier.</returns>
         internal static string RealPath()
         {
             try
@@ -59,31 +43,36 @@ namespace Dsh.EditorIntegration
                 var path = EditorApplication.applicationPath;
                 return string.IsNullOrEmpty(path) ? VirtualPath : path;
             }
-            catch (Exception)
-            {
-                return VirtualPath;
-            }
+            catch (Exception) { return VirtualPath; }
         }
 
-        public void Initialize(string editorInstallationPath)
-        {
-        }
+        /// <summary>Unity callback; no project mutation is needed. @author ddj 2026-09-28</summary>
+        /// <param name="editorInstallationPath">Unity-selected installation.</param>
+        public void Initialize(string editorInstallationPath) { }
 
+        /// <summary>Select bridge metadata independently for each project. @author ddj 2026-09-28</summary>
         public void OnGUI()
         {
-            var url = EditorGUILayout.TextField("DSH 服务地址", EditorPrefs.GetString(BaseUrlPref, DefaultBaseUrl));
-            if (GUI.changed) EditorPrefs.SetString(BaseUrlPref, url.Trim().TrimEnd('/'));
-            if (GUILayout.Button("测试：在 DSH 中打开当前项目")) BeginOpen(ResolveAbsolute(Application.dataPath), 0, 0);
+            string key = ConfigKey();
+            string selected = EditorPrefs.GetString(key, string.Empty);
+            string value = EditorGUILayout.TextField("DSH 桥接配置", selected);
+            if (value != selected) EditorPrefs.SetString(key, value.Trim());
+            EditorGUILayout.HelpBox("留空时自动读取本项目 UserSettings/dsh-editor.ini；没有安装提示时使用 DSH_HOME 中的旧 shell 配置。填写绝对路径可覆盖自动选择。请求须收到 ACK 才确认成功。", MessageType.Info);
+            if (GUILayout.Button("测试：在 DSH 中打开当前项目")) BeginOpen(ProjectRoot(), 0, 0);
         }
 
-        public void SyncAll()
-        {
-        }
+        /// <summary>Unity callback; DSH does not generate project files. @author ddj 2026-09-28</summary>
+        public void SyncAll() { }
 
-        public void SyncIfNeeded(string[] addedFiles, string[] deletedFiles, string[] movedFiles, string[] movedFromFiles, string[] importedFiles)
-        {
-        }
+        /// <summary>Unity callback; no generated solution needs synchronization. @author ddj 2026-09-28</summary>
+        /// <param name="addedFiles">Added assets.</param><param name="deletedFiles">Deleted assets.</param>
+        /// <param name="movedFiles">Moved assets.</param><param name="movedFromFiles">Previous paths.</param>
+        /// <param name="importedFiles">Imported assets.</param>
+        public void SyncIfNeeded(string[] addedFiles, string[] deletedFiles, string[] movedFiles, string[] movedFromFiles, string[] importedFiles) { }
 
+        /// <summary>Recognize the real or legacy virtual installation. @author ddj 2026-09-28</summary>
+        /// <param name="editorPath">Selected path.</param><param name="installation">Matching entry.</param>
+        /// <returns>Whether this editor owns the selection.</returns>
         public bool TryGetInstallationForPath(string editorPath, out CodeEditor.Installation installation)
         {
             if (string.Equals(editorPath, VirtualPath, StringComparison.OrdinalIgnoreCase)
@@ -96,25 +85,22 @@ namespace Dsh.EditorIntegration
             return false;
         }
 
+        /// <summary>Dispatch supported text assets; empty paths open the project. @author ddj 2026-09-28</summary>
+        /// <param name="path">Asset path or empty project request.</param><param name="line">One-based line.</param>
+        /// <param name="column">One-based column.</param><returns>Whether the asset belongs to this editor.</returns>
         public bool OpenProject(string path, int line, int column)
         {
-            // Open C# Project（Assets 菜单）传入空路径：视为打开 Unity 项目根（按文件夹规则路由）
             if (string.IsNullOrEmpty(path))
             {
                 BeginOpen(ProjectRoot(), line, column);
                 return true;
             }
-
-            // 非文本/代码文件（prefab/scene/asset/模型/纹理等）不交 DSH：返回 false 交还 Unity 原生
-            // 处理（双击预制体进预制体模式、双击场景开场景），否则 Unity 双击资产会被本编辑器劫持。
-            var absPath = ResolveAbsolute(path);
-            if (!IsSupportedFile(absPath)) return false;
-
-            BeginOpen(absPath, line, column);
+            string absolute = ResolveAbsolute(path);
+            if (!IsSupportedFile(absolute)) return false;
+            BeginOpen(absolute, line, column);
             return true;
         }
 
-        /// <summary>文本/代码类扩展名白名单：官方 DefaultExternalCodeEditor 支持集 + 常见文本/脚本类型。</summary>
         private static readonly string[] SupportedExtensions =
         {
             "cs", "txt", "log", "json", "xml", "md", "yaml", "yml", "meta", "ini", "csv", "tsv",
@@ -124,190 +110,100 @@ namespace Dsh.EditorIntegration
             "asmdef", "asmref", "uxml", "uss"
         };
 
-        /// <summary>
-        /// 判定文件是否支持交 DSH 打开：白名单命中，或 Unity Project Settings 用户自定义扩展命中。
-        /// @author ddj 2026年09月22号
-        /// </summary>
-        /// <param name="absPath">资产绝对路径</param>
-        /// <returns>true = 支持 DSH 打开；false = 交还 Unity 原生处理</returns>
-        private static bool IsSupportedFile(string absPath)
-        {
-            var ext = Path.GetExtension(absPath);
-            if (string.IsNullOrEmpty(ext)) return false;
-            ext = ext.Substring(1).ToLowerInvariant();
-            if (Array.IndexOf(SupportedExtensions, ext) >= 0) return true;
-
-            var userExts = EditorSettings.projectGenerationUserExtensions;
-            if (userExts == null) return false;
-            foreach (var userExt in userExts)
+        /// <summary>Keep native prefab/scene handling and the existing text whitelist. @author ddj 2026-09-28</summary>
+        /// <param name="absolute">Absolute asset path.</param><returns>True for supported text assets.</returns>
+        private static bool IsSupportedFile(string absolute)
+        {
+            string extension = Path.GetExtension(absolute);
+            if (string.IsNullOrEmpty(extension)) return false;
+            extension = extension.Substring(1).ToLowerInvariant();
+            if (extension == "prefab" || extension == "unity") return false;
+            if (Array.IndexOf(SupportedExtensions, extension) >= 0) return true;
+            var custom = EditorSettings.projectGenerationUserExtensions;
+            if (custom == null) return false;
+            foreach (string value in custom)
             {
-                if (string.Equals(userExt, ext, StringComparison.OrdinalIgnoreCase)) return true;
-                if (string.Equals(userExt, "." + ext, StringComparison.OrdinalIgnoreCase)) return true;
+                if (string.Equals(value, extension, StringComparison.OrdinalIgnoreCase)
+                    || string.Equals(value, "." + extension, StringComparison.OrdinalIgnoreCase)) return true;
             }
             return false;
         }
 
-        /// <summary>
-        /// 后台线程执行移交/回退（不阻塞编辑器主线程）。
-        /// ⚠️ EditorPrefs 仅主线程可读：baseUrl 必须在主线程（BeginOpen 调用点）读好后闭包捕获，
-        /// 后台线程只做网络 IO 与纯计算。
-        /// @author ddj 2026年09月08号
-        /// </summary>
-        private static void BeginOpen(string absPath, int line, int column)
+        /// <summary>Capture preferences on the main thread before starting disk IO. @author ddj 2026-09-28</summary>
+        /// <param name="path">Absolute target.</param><param name="line">One-based line.</param><param name="column">One-based column.</param>
+        private static void BeginOpen(string path, int line, int column)
         {
-            string baseUrl = BaseUrl();
-            var thread = new Thread(() =>
-            {
-                try
-                {
-                    if (HandoffToOpenPage(baseUrl, absPath, line, column)) return;
-                    OpenUrlOnMain(BuildOpenUrl(baseUrl, absPath, line, column));
-                }
-                catch (Exception)
-                {
-                    OpenUrlOnMain(BuildOpenUrl(baseUrl, absPath, line, column));
-                }
-            }) { IsBackground = true };
+            string config = EditorPrefs.GetString(ConfigKey(), string.Empty);
+            var worker = new DshOpenWorker(config, path, line, column, ProjectRoot(), LegacyConfig());
+            var thread = new Thread(worker.Run) { IsBackground = true };
             thread.Start();
         }
 
-        /// <summary>移交到已打开页面；返回 true = 已确认由页面执行。无活跃页面/2s 未领取 → false。</summary>
-        private static bool HandoffToOpenPage(string baseUrl, string absPath, int line, int column)
-        {
-            string resp = PostRpc(baseUrl, "edrv.external.handoff", HandoffArgs(absPath, line, column));
-            if (ExtractInt(resp, "clients") <= 0) return false;
-            Thread.Sleep(2000);
-            string token = ExtractString(resp, "token");
-            string state = PostRpc(baseUrl, "edrv.external.pendingState",
-                "{\"token\":" + JsonEscape(token) + ",\"take\":true}");
-            return ExtractBool(state, "delivered");
-        }
+        /// <summary>Derive a project-specific preference key. @author ddj 2026-09-28</summary>
+        /// <returns>Project-local editor preference key.</returns>
+        private static string ConfigKey() { return "DshEditor.Config." + ProjectRoot(); }
 
-        /// <summary>移交载荷：行列仅在有值时附带（与 URL 深链契约一致）。</summary>
-        private static string HandoffArgs(string absPath, int line, int column)
-        {
-            var json = "{\"paths\":[" + JsonEscape(absPath) + "]";
-            if (line > 0) json += ",\"line\":" + line;
-            if (column > 0) json += ",\"column\":" + column;
-            return json + "}";
-        }
-
-        /// <summary>POST /edrv/rpc；失败返回 null（调用方回退深链，不阻塞）。</summary>
-        private static string PostRpc(string baseUrl, string method, string argsJson)
+        /// <summary>Read the project's installed profile hint on the worker. @author ddj 2026-09-28</summary>
+        /// <param name="root">Project root captured on the main thread.</param><param name="fallback">Legacy shell INI.</param>
+        /// <returns>The hinted absolute INI, or legacy path only when the hint is absent.</returns>
+        /// <exception cref="InvalidDataException">The installed hint is malformed.</exception>
+        internal static string DefaultConfig(string root, string fallback)
         {
+            string hint = Path.Combine(Path.Combine(root, "UserSettings"), "dsh-editor.ini");
             try
             {
-                var req = (HttpWebRequest)WebRequest.Create(baseUrl.TrimEnd('/') + "/edrv/rpc");
-                req.Method = "POST";
-                req.ContentType = "application/json";
-                req.Timeout = 4000;
-                req.Proxy = null;
-                byte[] body = Encoding.UTF8.GetBytes("{\"method\":\"" + method + "\",\"args\":" + argsJson + "}");
-                req.ContentLength = body.Length;
-                using (var stream = req.GetRequestStream()) stream.Write(body, 0, body.Length);
-                using (var res = req.GetResponse())
-                using (var reader = new StreamReader(res.GetResponseStream(), Encoding.UTF8))
-                    return reader.ReadToEnd();
+                if (new FileInfo(hint).Length > 65536) throw new InvalidDataException("DSH project bridge hint exceeds 64 KiB.");
+                foreach (string text in File.ReadAllLines(hint))
+                {
+                    int equal = text.IndexOf('=');
+                    if (equal < 0 || !string.Equals(text.Substring(0, equal).Trim(), "config", StringComparison.OrdinalIgnoreCase)) continue;
+                    string value = text.Substring(equal + 1).Trim();
+                    if (string.IsNullOrEmpty(value) || !Path.IsPathRooted(value))
+                        throw new InvalidDataException("DSH project bridge hint requires an absolute config path.");
+                    return Path.GetFullPath(value);
+                }
+                throw new InvalidDataException("DSH project bridge hint is missing config=. Reinstall the DSH Unity bridge or select an explicit configuration.");
             }
-            catch (Exception) { return null; }
-        }
-
-        /// <summary>回退开浏览器需主线程：经 delayCall 切回。</summary>
-        private static void OpenUrlOnMain(string url)
-        {
-            EditorApplication.delayCall += () => Application.OpenURL(url);
+            catch (FileNotFoundException) { return fallback; }
+            catch (DirectoryNotFoundException) { return fallback; }
         }
 
-        /// <summary>拼深链 URL（行列仅在有值时附带）。</summary>
-        private static string BuildOpenUrl(string baseUrl, string absPath, int line, int column)
+        /// <summary>Honor custom DSH_HOME for legacy installations. @author ddj 2026-09-28</summary>
+        /// <returns>Legacy installed shell INI path, without filesystem IO.</returns>
+        private static string LegacyConfig()
         {
-            var url = baseUrl.TrimEnd('/') + "/?edrvOpen=1&edrvPaths=" + Uri.EscapeDataString(absPath);
-            if (line > 0) url += "&edrvLine=" + line;
-            if (column > 0) url += "&edrvColumn=" + column;
-            return url;
+            string home = Environment.GetEnvironmentVariable("DSH_HOME");
+            if (string.IsNullOrEmpty(home)) home = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.UserProfile), ".dsh");
+            return Path.Combine(Path.Combine(Path.Combine(home, "dsh-vscode-mode"), "shell"), "dsh-open.ini");
         }
 
-        /// <summary>相对路径 → 绝对路径（基于 Unity 项目根补全）。</summary>
+        /// <summary>Resolve asset paths from the Unity project root. @author ddj 2026-09-28</summary>
+        /// <param name="path">Asset path.</param><returns>Absolute path.</returns>
         private static string ResolveAbsolute(string path)
         {
-            return Path.IsPathRooted(path) ? path : Path.GetFullPath(Path.Combine(ProjectRoot(), path));
-        }
-
-        /// <summary>Unity 项目根（Assets 的父目录）。</summary>
-        private static string ProjectRoot()
-        {
-            return Directory.GetParent(Application.dataPath).FullName;
-        }
-
-        /// <summary>读取 EditorPrefs 的 DSH 服务地址（空回退默认）。</summary>
-        private static string BaseUrl()
-        {
-            var stored = EditorPrefs.GetString(BaseUrlPref, DefaultBaseUrl);
-            return string.IsNullOrEmpty(stored) ? DefaultBaseUrl : stored;
-        }
-
-        /// <summary>极简 JSON int 字段提取（缺失/失败 → -1）。起点 = 匹配串长度 key.Length+3（"key":）。</summary>
-        private static int ExtractInt(string json, string key)
-        {
-            if (string.IsNullOrEmpty(json)) return -1;
-            int at = json.IndexOf("\"" + key + "\":", StringComparison.Ordinal);
-            if (at < 0) return -1;
-            at += key.Length + 3;
-            int end = at;
-            while (end < json.Length && (char.IsDigit(json[end]) || (end == at && json[end] == '-'))) end++;
-            int value;
-            return int.TryParse(json.Substring(at, end - at), out value) ? value : -1;
-        }
-
-        /// <summary>极简 JSON string 字段提取（缺失/失败 → null）。起点 = 匹配串长度 key.Length+4（"key":"）。</summary>
-        private static string ExtractString(string json, string key)
-        {
-            if (string.IsNullOrEmpty(json)) return null;
-            int at = json.IndexOf("\"" + key + "\":\"", StringComparison.Ordinal);
-            if (at < 0) return null;
-            at += key.Length + 4;
-            int end = json.IndexOf('"', at);
-            return end < 0 ? null : json.Substring(at, end - at);
+            return Path.GetFullPath(Path.IsPathRooted(path) ? path : Path.Combine(ProjectRoot(), path));
         }
 
-        /// <summary>极简 JSON bool 字段提取（缺失 → false）。起点 = 匹配串长度 key.Length+3（"key":）。</summary>
-        private static bool ExtractBool(string json, string key)
-        {
-            if (string.IsNullOrEmpty(json)) return false;
-            int at = json.IndexOf("\"" + key + "\":", StringComparison.Ordinal);
-            return at >= 0 && json.IndexOf("true", at, StringComparison.Ordinal) == at + key.Length + 3;
-        }
-
-        /// <summary>JSON 字符串转义（反斜杠 + 引号）。</summary>
-        private static string JsonEscape(string value)
-        {
-            return "\"" + (value ?? string.Empty).Replace("\\", "\\\\").Replace("\"", "\\\"") + "\"";
-        }
+        /// <summary>Read the current project root on the main thread. @author ddj 2026-09-28</summary>
+        /// <returns>Assets parent directory.</returns>
+        private static string ProjectRoot() { return Directory.GetParent(Application.dataPath).FullName; }
     }
 
-    /// <summary>
-    /// 注册兜底：独立类的 InitializeOnLoadMethod——主类静态构造异常导致注册缺失时补注册。
-    /// @author ddj 2026-09-08
-    /// </summary>
     internal static class DshCodeEditorBoot
     {
+        /// <summary>Schedule fallback registration after Unity initializes. @author ddj 2026-09-28</summary>
         [InitializeOnLoadMethod]
-        private static void EnsureRegistered()
+        private static void EnsureRegistered() { EditorApplication.delayCall += Register; }
+
+        /// <summary>Register only when another instance has not done so. @author ddj 2026-09-28</summary>
+        private static void Register()
         {
-            EditorApplication.delayCall += () =>
+            try
             {
-                try
-                {
-                    var existing = CodeEditor.Editor.GetCodeEditorForPath(DshCodeEditor.RealPath());
-                    if (existing is DshCodeEditor) return;
-                    CodeEditor.Register(new DshCodeEditor());
-                    Debug.Log("[DshCodeEditor] 兜底注册完成（v" + DshCodeEditor.VersionText + "）");
-                }
-                catch (Exception e)
-                {
-                    Debug.LogError("[DshCodeEditor] 兜底注册失败：" + e);
-                }
-            };
+                if (CodeEditor.Editor.GetCodeEditorForPath(DshCodeEditor.RealPath()) is DshCodeEditor) return;
+                CodeEditor.Register(new DshCodeEditor());
+            }
+            catch (Exception error) { Debug.LogError("[DshCodeEditor] 注册失败：" + error); }
         }
     }
 }

package/unity/com.dsh.editor/Editor/DshOpenWorker.cs

@@ -0,0 +1,166 @@
+// Background process adapter; no Unity preference or asset API is used on this thread.
+// @author ddj 2026-09-28
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.IO;
+using System.Text;
+using UnityEditor;
+using UnityEngine;
+
+namespace Dsh.EditorIntegration
+{
+    internal sealed class DshOpenWorker
+    {
+        private readonly string configPath;
+        private readonly string targetPath;
+        private readonly string projectRoot;
+        private readonly string legacyConfig;
+        private readonly int line;
+        private readonly int column;
+
+        /// <summary>Capture immutable request data on the main thread. @author ddj 2026-09-28</summary>
+        /// <param name="config">Selected INI path.</param><param name="path">Absolute asset or project.</param>
+        /// <param name="row">One-based line.</param><param name="col">One-based column.</param>
+        /// <param name="root">Project root.</param><param name="fallback">Legacy shell INI path.</param>
+        internal DshOpenWorker(string config, string path, int row, int col, string root, string fallback)
+        {
+            configPath = config;
+            targetPath = path;
+            projectRoot = root;
+            legacyConfig = fallback;
+            line = row;
+            column = col;
+        }
+
+        /// <summary>Wait for the disk producer; failures are posted to the main thread. @author ddj 2026-09-28</summary>
+        internal void Run()
+        {
+            try { RunProducer(); }
+            catch (Exception error)
+            {
+                string message = error.Message;
+                EditorApplication.delayCall += delegate { UnityEngine.Debug.LogError("[DshCodeEditor] OPEN 未确认：" + message); };
+            }
+        }
+
+        /// <summary>Read configuration on the worker and wait for a matching ACK. @author ddj 2026-09-28</summary>
+        private void RunProducer()
+        {
+            string selected = SelectConfig();
+            Dictionary<string, string> config = ReadIni(selected);
+            string node = FilePath(config, "node");
+            string helper = FilePath(config, "helper");
+            string mode;
+            if (!config.TryGetValue("nodeMode", out mode) || (mode != "node" && mode != "electron"))
+                throw new InvalidDataException("Missing nodeMode in DSH bridge configuration.");
+            var start = new ProcessStartInfo(node, Arguments(helper, selected));
+            start.UseShellExecute = false;
+            start.CreateNoWindow = true;
+            start.RedirectStandardOutput = true;
+            start.RedirectStandardError = true;
+            if (mode == "electron") start.EnvironmentVariables["ELECTRON_RUN_AS_NODE"] = "1";
+            else start.EnvironmentVariables.Remove("ELECTRON_RUN_AS_NODE");
+            WaitProducer(start);
+        }
+
+        /// <summary>Drain diagnostic streams and dispatch only fixed wake messages. @author ddj 2026-09-28</summary>
+        /// <param name="start">Producer process configuration.</param>
+        private static void WaitProducer(ProcessStartInfo start)
+        {
+            using (var child = new Process())
+            {
+                child.StartInfo = start;
+                var errors = new StringBuilder();
+                DataReceivedEventHandler onError = delegate(object sender, DataReceivedEventArgs args)
+                {
+                    if (args.Data != null) { lock (errors) { if (errors.Length < 8192) errors.AppendLine(args.Data); } }
+                };
+                child.ErrorDataReceived += onError;
+                child.Start();
+                child.BeginErrorReadLine();
+                string message;
+                while ((message = child.StandardOutput.ReadLine()) != null) WakeMessage(message);
+                child.WaitForExit();
+                child.ErrorDataReceived -= onError;
+                if (child.ExitCode != 0) throw new IOException(errors.Length == 0 ? "Missing successful OPEN ACK." : errors.ToString());
+            }
+        }
+
+        /// <summary>Perform UI activation exclusively through Unity's main-thread delayCall. @author ddj 2026-09-28</summary>
+        /// <param name="message">Producer control line, never an asset path.</param>
+        private static void WakeMessage(string message)
+        {
+            if (!message.StartsWith("DSH_WAKE:", StringComparison.Ordinal)) return;
+            string target = message.Substring(9);
+            Uri uri;
+            if (target != "dsh://open" && (!Uri.TryCreate(target, UriKind.Absolute, out uri)
+                || (uri.Scheme != "http" && uri.Scheme != "https") || !string.IsNullOrEmpty(uri.UserInfo)
+                || !string.IsNullOrEmpty(uri.Query) || !string.IsNullOrEmpty(uri.Fragment)))
+                throw new InvalidDataException("Invalid bridge wake target.");
+            EditorApplication.delayCall += delegate { Application.OpenURL(target); };
+        }
+
+        /// <summary>Prefer the captured explicit override without reading a project hint. @author ddj 2026-09-28</summary>
+        /// <returns>Selected bridge INI path; missing or malformed hints are handled by the caller.</returns>
+        internal string SelectConfig()
+        {
+            return string.IsNullOrEmpty(configPath) ? DshCodeEditor.DefaultConfig(projectRoot, legacyConfig) : configPath;
+        }
+
+        /// <summary>Build helper arguments without routing files through a URL. @author ddj 2026-09-28</summary>
+        /// <param name="helper">Absolute JS producer.</param><param name="selected">Resolved INI.</param><returns>Process command line.</returns>
+        private string Arguments(string helper, string selected)
+        {
+            string args = Quote(helper) + " --config " + Quote(selected) + " --no-wake";
+            if (line > 0) args += " --line " + line;
+            if (column > 0) args += " --column " + column;
+            return args + " -- " + Quote(targetPath);
+        }
+
+        /// <summary>Read selected bridge metadata without guessing a profile. @author ddj 2026-09-28</summary>
+        /// <param name="selected">Resolved INI.</param><returns>Case-insensitive INI values.</returns>
+        private static Dictionary<string, string> ReadIni(string selected)
+        {
+            if (!Path.IsPathRooted(selected) || !File.Exists(selected))
+                throw new FileNotFoundException("Select an absolute, installed DSH bridge configuration in External Tools.");
+            var values = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase);
+            foreach (string text in File.ReadAllLines(selected, Encoding.UTF8))
+            {
+                int equal = text.IndexOf('=');
+                if (equal > 0) values[text.Substring(0, equal).Trim()] = text.Substring(equal + 1).Trim();
+            }
+            return values;
+        }
+
+        /// <summary>Require the stored interpreter and helper to exist. @author ddj 2026-09-28</summary>
+        /// <param name="config">INI values.</param><param name="key">Metadata key.</param><returns>Absolute file path.</returns>
+        private static string FilePath(Dictionary<string, string> config, string key)
+        {
+            string path;
+            if (!config.TryGetValue(key, out path) || !Path.IsPathRooted(path) || !File.Exists(path))
+                throw new FileNotFoundException("Missing absolute " + key + " in DSH bridge configuration.");
+            if (key == "node" && Path.DirectorySeparatorChar == '\\'
+                && !string.Equals(Path.GetExtension(path), ".exe", StringComparison.OrdinalIgnoreCase))
+                throw new InvalidDataException("A stored Node or Electron executable is required.");
+            return path;
+        }
+
+        /// <summary>Quote one argument for .NET ProcessStartInfo. @author ddj 2026-09-28</summary>
+        /// <param name="value">Literal argument.</param><returns>Escaped argument.</returns>
+        private static string Quote(string value)
+        {
+            var result = new StringBuilder("\"");
+            int slashes = 0;
+            foreach (char ch in value)
+            {
+                if (ch == '\\') { slashes++; continue; }
+                result.Append('\\', ch == '"' ? slashes * 2 + 1 : slashes);
+                result.Append(ch);
+                slashes = 0;
+            }
+            result.Append('\\', slashes * 2);
+            return result.Append('"').ToString();
+        }
+    }
+}

package/unity/com.dsh.editor/Editor/DshOpenWorker.cs.meta

@@ -0,0 +1,2 @@
+fileFormatVersion: 2
+guid: a14fbab648774b49a7e8fd49158fb312

package/unity/com.dsh.editor/README.md

@@ -1,35 +1,26 @@
-# com.dsh.editor — DSH 文件编辑（Unity 外部脚本编辑器集成）
+# com.dsh.editor — DSH 文件编辑
 
-把 DSH 的 `dsh-vscode-mode`（VSCodeMode）编辑器注册为 Unity 外部脚本编辑器：
-双击脚本 / Console 报错跳转时，优先把打开请求**移交已打开的 DSH 页面**就地执行（不重复开新页）；
-无活跃页面时回退经默认浏览器深链打开对应文件并定位行列。
+Unity 外部脚本编辑器通过当前用户私有的 OPEN REQUEST/ACK 文件队列打开脚本或项目。收到 profile 与 requestId 匹配的成功 ACK 才确认完成；超时、拒绝或无效 ACK 会在 Unity Console 报告错误。
 
-## 安装方式一：DSH 设置页一键安装（推荐）
+## 安装
 
-1. 打开 DSH Web GUI → 设置 → VSCodeMode → 通用 →「系统集成」。
-2. 在 Unity 集成区添加你的 Unity 项目根（包含 `Assets/` 与 `ProjectSettings/` 的目录）。
-3. 点「安装」—— 包会复制为 `<项目>/Packages/com.dsh.editor`（Unity 内嵌包，自动发现）。
-4. 切回 Unity 窗口（或下次启动 Unity）自动生效。
+在 DSH 设置 → VSCodeMode → 系统集成中添加 Unity 项目并安装/更新内嵌包，或在 Unity Package Manager 中选择本包。切回 Unity 后，在 Preferences → External Tools → External Script Editor 中选择 **DSH 文件编辑**。
 
-后续插件更新后，同一按钮即为一键更新（整目录替换，列表里会显示「可更新」徽标）。
+DSH 安装 Unity 集成时会为当前 profile 准备独立的 `<profile>/dsh-vscode-mode/bridge`，并在项目的 `UserSettings/dsh-editor.ini` 写入 `config=<绝对桥接INI路径>`；无需先注册资源管理器菜单，也不会覆盖其他 profile 的菜单配置。
 
-## 安装方式二：Package Manager 手动安装
+**DSH 桥接配置**字段为每个 Unity 项目单独保存。填写绝对路径时使用该显式覆盖；留空时，后台先读取本项目的安装提示，只有提示文件不存在才回退 `$DSH_HOME/dsh-vscode-mode/shell/dsh-open.ini`。未设 `DSH_HOME` 时旧目录以用户目录中的 `.dsh` 为根。提示损坏、相对路径或目标配置不可读会通过 Unity Console 报告错误，不会猜测端口或切换 profile。清空字段可恢复自动选择。
 
-- Unity → Window → Package Manager → 左上角 `+` → **Add package from disk** →
-  选择插件目录下的 `unity/com.dsh.editor`（含本 README 的目录）。
+## 配置契约
 
-## 使用
+INI 保留 `base`，并包含 `mode=desktop|web`、绝对 `profile`、绝对 `inbox`、绝对 `node` 可执行文件、`nodeMode=node|electron` 和绝对 `helper`（安装的 `dsh-open.mjs`）。配置由 DSH 生成，Unity 不推测端口或 profile，也不创建任何队列目录。
 
-1. Unity → Edit → Preferences → External Tools → External Script Editor 下拉选择 **DSH 文件编辑**。
-2. 展开 DSH 文件编辑选项，确认「DSH 服务地址」（默认 `http://127.0.0.1:3080`，需与 DSH Web GUI 地址一致）。
-3. 双击任意脚本即可打开（有已打开 DSH 页面时直接在其页面内打开，不再新开标签）；Console 报错双击会带上行列。
+桌面模式仅唤起官方 `dsh://open`；Web 模式仅唤起所选 `base`。文件和行列只进入队列，不附加到 URL。Electron 解释器使用 `ELECTRON_RUN_AS_NODE=1`。producer 必须与 INI 一同安装，不能只复制 Unity 包后填写一个服务地址。
 
-## 说明
+## 使用与边界
 
-- 本包为虚拟外部编辑器：不需要本地可执行文件。打开优先走「移交」：POST 到 DSH host 的
-  `edrv.external.handoff`，已打开页面 3s 轮询领取并执行打开规则（文件夹/文件的智能路由见插件 README）；
-  无活跃页面或 2s 未领取时回退 `Application.OpenURL` 深链。移交在后台线程执行，不阻塞编辑器。
-- 仅文本/代码类文件（扩展名白名单 + Project Settings 用户自定义扩展）交 DSH 打开；双击预制体、
-  场景、模型、纹理等资源不受影响，仍由 Unity 原生处理（预制体编辑模式、场景打开等）。
-- 编辑器内查看任意绝对路径文件；保存受 DSH 会话沙箱策略约束（工作区外保存会被拒绝，属预期安全行为）。
-- 卸载：删除 `<项目>/Packages/com.dsh.editor` 目录，并在 External Script Editor 换回其他编辑器。
+- 双击支持的文本/代码文件，或从 Console 跳转行列。原有文本扩展名白名单及自定义文本扩展保留；prefab 和 scene 始终交回 Unity。
+- “Open C# Project” 的空路径打开 Unity 项目根；测试按钮也打开项目根。
+- 偏好读取在主线程；配置/队列 IO 与等待在后台 producer 中。界面激活通过 `EditorApplication.delayCall` 执行，不在后台调用 Unity UI。
+- 队列要求 Windows 当前用户独占 ACL，或 POSIX 目录 0700、文件 0600，并拒绝链接/重解析逃逸。目录缺失或不安全时失败，不建立宽松回退目录。
+- 请求最多 20 个绝对路径，每个至多 8192 字符，JSON 至多 64 KiB，有效期及 ACK 等待上限 60 秒。不使用 cookies 或通用 RPC。
+- 卸载时删除内嵌包并选择其他外部编辑器。个人配置保存在项目专属 EditorPrefs 键中，不修改项目资源。