dsh-vscode-mode 0.1.52 → 0.1.53

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

@@ -0,0 +1,267 @@
+// 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）。
+// 作者 ddj 2026-09-08
+using System;
+using System.IO;
+using System.Net;
+using System.Text;
+using System.Threading;
+using UnityEditor;
+using UnityEngine;
+using Unity.CodeEditor;
+
+namespace Dsh.EditorIntegration
+{
+    [InitializeOnLoad]
+    public class DshCodeEditor : IExternalCodeEditor
+    {
+        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.3";
+        internal const string VersionText = DshVersion;
+
+        static DshCodeEditor()
+        {
+            try
+            {
+                CodeEditor.Register(new DshCodeEditor());
+                Debug.Log("[DshCodeEditor] 已注册为 Unity 外部脚本编辑器（v" + DshVersion + "）");
+            }
+            catch (Exception e)
+            {
+                Debug.LogError("[DshCodeEditor] 注册失败：" + e);
+            }
+        }
+
+        public CodeEditor.Installation[] Installations
+        {
+            // Path 指向真实存在的 Unity.exe：部分 Unity 版本会过滤「路径不存在」的安装条目；
+            // 打开逻辑全在本类（OpenProject），该路径仅作占位与选中态回读。
+            get { return new[] { new CodeEditor.Installation { Name = EditorName, Path = RealPath() } }; }
+        }
+
+        /// <summary>本包声明的安装路径（真实存在的 Unity.exe；取不到时回退虚拟路径）。</summary>
+        internal static string RealPath()
+        {
+            try
+            {
+                var path = EditorApplication.applicationPath;
+                return string.IsNullOrEmpty(path) ? VirtualPath : path;
+            }
+            catch (Exception)
+            {
+                return VirtualPath;
+            }
+        }
+
+        public void Initialize(string editorInstallationPath)
+        {
+        }
+
+        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);
+        }
+
+        public void SyncAll()
+        {
+        }
+
+        public void SyncIfNeeded(string[] addedFiles, string[] deletedFiles, string[] movedFiles, string[] movedFromFiles, string[] importedFiles)
+        {
+        }
+
+        public bool TryGetInstallationForPath(string editorPath, out CodeEditor.Installation installation)
+        {
+            if (string.Equals(editorPath, VirtualPath, StringComparison.OrdinalIgnoreCase)
+                || string.Equals(editorPath, RealPath(), StringComparison.OrdinalIgnoreCase))
+            {
+                installation = Installations[0];
+                return true;
+            }
+            installation = new CodeEditor.Installation();
+            return false;
+        }
+
+        public bool OpenProject(string path, int line, int column)
+        {
+            // Open C# Project（Assets 菜单）传入空路径：视为打开 Unity 项目根（按文件夹规则路由）
+            var target = string.IsNullOrEmpty(path) ? ProjectRoot() : ResolveAbsolute(path);
+            BeginOpen(target, line, column);
+            return true;
+        }
+
+        /// <summary>
+        /// 后台线程执行移交/回退（不阻塞编辑器主线程）。
+        /// ⚠️ EditorPrefs 仅主线程可读：baseUrl 必须在主线程（BeginOpen 调用点）读好后闭包捕获，
+        /// 后台线程只做网络 IO 与纯计算。
+        /// @author ddj 2026年09月08号
+        /// </summary>
+        private static void BeginOpen(string absPath, 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 };
+            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>移交载荷：行列仅在有值时附带（与 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)
+        {
+            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();
+            }
+            catch (Exception) { return null; }
+        }
+
+        /// <summary>回退开浏览器需主线程：经 delayCall 切回。</summary>
+        private static void OpenUrlOnMain(string url)
+        {
+            EditorApplication.delayCall += () => Application.OpenURL(url);
+        }
+
+        /// <summary>拼深链 URL（行列仅在有值时附带）。</summary>
+        private static string BuildOpenUrl(string baseUrl, string absPath, int line, int column)
+        {
+            var url = baseUrl.TrimEnd('/') + "/?edrvOpen=1&edrvPaths=" + Uri.EscapeDataString(absPath);
+            if (line > 0) url += "&edrvLine=" + line;
+            if (column > 0) url += "&edrvColumn=" + column;
+            return url;
+        }
+
+        /// <summary>相对路径 → 绝对路径（基于 Unity 项目根补全）。</summary>
+        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);
+        }
+
+        /// <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>
+    /// 注册兜底：独立类的 InitializeOnLoadMethod——主类静态构造异常导致注册缺失时补注册。
+    /// @author ddj 2026-09-08
+    /// </summary>
+    internal static class DshCodeEditorBoot
+    {
+        [InitializeOnLoadMethod]
+        private static void EnsureRegistered()
+        {
+            EditorApplication.delayCall += () =>
+            {
+                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);
+                }
+            };
+        }
+    }
+}

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

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 535b840f1c4b5eb48afd36de1e42938b
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/unity/com.dsh.editor/Editor/com.dsh.editor.asmdef

@@ -0,0 +1,15 @@
+{
+    "name": "Dsh.Editor",
+    "references": [],
+    "includePlatforms": [
+        "Editor"
+    ],
+    "excludePlatforms": [],
+    "allowUnsafeCode": false,
+    "overrideReferences": false,
+    "precompiledReferences": [],
+    "autoReferenced": true,
+    "defineConstraints": [],
+    "versionDefines": [],
+    "noEngineReferences": false
+}

package/unity/com.dsh.editor/Editor/com.dsh.editor.asmdef.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: f8a8c068130205a439952c93ae5ee330
+AssemblyDefinitionImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

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

@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 108f0429dc15b5e488cad9dbfc50946a
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

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

@@ -0,0 +1,33 @@
+# com.dsh.editor — DSH 文件编辑（Unity 外部脚本编辑器集成）
+
+把 DSH 的 `dsh-vscode-mode`（VSCodeMode）编辑器注册为 Unity 外部脚本编辑器：
+双击脚本 / Console 报错跳转时，优先把打开请求**移交已打开的 DSH 页面**就地执行（不重复开新页）；
+无活跃页面时回退经默认浏览器深链打开对应文件并定位行列。
+
+## 安装方式一：DSH 设置页一键安装（推荐）
+
+1. 打开 DSH Web GUI → 设置 → VSCodeMode → 通用 →「系统集成」。
+2. 在 Unity 集成区添加你的 Unity 项目根（包含 `Assets/` 与 `ProjectSettings/` 的目录）。
+3. 点「安装」—— 包会复制为 `<项目>/Packages/com.dsh.editor`（Unity 内嵌包，自动发现）。
+4. 切回 Unity 窗口（或下次启动 Unity）自动生效。
+
+后续插件更新后，同一按钮即为一键更新（整目录替换，列表里会显示「可更新」徽标）。
+
+## 安装方式二：Package Manager 手动安装
+
+- Unity → Window → Package Manager → 左上角 `+` → **Add package from disk** →
+  选择插件目录下的 `unity/com.dsh.editor`（含本 README 的目录）。
+
+## 使用
+
+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 报错双击会带上行列。
+
+## 说明
+
+- 本包为虚拟外部编辑器：不需要本地可执行文件。打开优先走「移交」：POST 到 DSH host 的
+  `edrv.external.handoff`，已打开页面 3s 轮询领取并执行打开规则（文件夹/文件的智能路由见插件 README）；
+  无活跃页面或 2s 未领取时回退 `Application.OpenURL` 深链。移交在后台线程执行，不阻塞编辑器。
+- 编辑器内查看任意绝对路径文件；保存受 DSH 会话沙箱策略约束（工作区外保存会被拒绝，属预期安全行为）。
+- 卸载：删除 `<项目>/Packages/com.dsh.editor` 目录，并在 External Script Editor 换回其他编辑器。

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

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: c79a492d8cd437d4886d9e82c0a1710e
+TextScriptImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/unity/com.dsh.editor/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "com.dsh.editor",
+  "displayName": "DSH 文件编辑",
+  "description": "DSH（dsh-vscode-mode）编辑器集成：把「DSH 文件编辑」注册为 Unity 外部脚本编辑器，双击脚本或 Console 报错跳转时，优先把打开请求移交已打开的 DSH 页面就地执行（不重复开新页），无活跃页面时回退经默认浏览器深链打开对应文件与行列。支持从 DSH 设置页一键安装/更新（内嵌包方式，无需手动改 manifest.json）。",
+  "version": "0.2.3",
+  "unity": "2019.4"
+}

package/unity/com.dsh.editor/package.json.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 0492601e37ba44841a6b80250376e608
+PackageManifestImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: