From 2d073a2413c0cd28494ebd8e42a6cd2dbd8f87d6 Mon Sep 17 00:00:00 2001 From: QQ597901027 Date: Thu, 22 Oct 2026 11:00:52 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=A2=9E=E5=8A=A0=20DSH=20=E6=A1=8C?= =?UTF-8?q?=E9=9D=A2=E7=89=88=EF=BC=88Electron/desktop=20profile=EF=BC=89?= =?UTF-8?q?=E5=AE=89=E8=A3=85=E8=AF=B4=E6=98=8E=E4=B8=8E=E5=B7=B2=E7=9F=A5?= =?UTF-8?q?=E5=B7=AE=E5=BC=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 19 +++++++++++++++++++ package.json | 2 +- 2 files changed, 20 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 3ff379c..48e00e7 100644 --- a/README.md +++ b/README.md @@ -58,6 +58,25 @@ profile 的 `package.json`： 改完执行 `pnpm install`（关闭 DSH 后执行最稳，避免 Windows 上正在使用的原生模块被占用），再启动。 +### 方式三：DSH 桌面版（Electron） + +桌面版也是 DSH，插件机制相同，但 profile 名是**保留的 `desktop`**，且由桌面应用自己管理。要点： + +1. **前提版本**：桌面版需基于 DSH **≥ 0.2.1-rc.2**（本插件 `dsh.engines.dsh` 的要求；0.1.x 不支持预设声明行机制）。 +2. **安装入口**：用**桌面版自带的插件管理界面**（设置 → 插件 / Plugin Manager）安装本仓库目录作为 bundle； + ```text + install_bundle target = <本仓库克隆目录的绝对路径> + ``` + 或安装一个可解析的包 / Git 仓库地址。 + ⚠️ 不要用 npm 全局安装的 `dsh` CLI 去管 `desktop` profile——CLI 会拒绝桌面版 profile 的启动与插件管理请求，必须使用桌面安装自带的命令运行时。 +3. **依赖**：`@nefevcore/abap-adt-dsh-plugin` 会随包安装；桌面版的插件操作会使用其安装的包管理器（需能访问 npm registry）。 +4. **重启桌面应用** → 新建会话选「ABAP 工作台」→ 设置 → ABAP ADT 配置目的地/模式（用法与 Web 版一致）。 +5. **已知差异/注意**： + - 桌面版的 Web UI 同样加载本插件的 Client 半（设置页「ABAP ADT」+ 会话状态徽章），但 `dsh.client` 支持取决于桌面版是否加载第三方 client 插件；若设置页没有出现 ABAP ADT，先确认桌面版版本与插件是否真的激活。 + - 内置 mock `demo` 会在 `127.0.0.1` 随机端口监听，桌面版可能弹一次防火墙提示（仅本机回环，放行即可/拒绝也不影响真实 SAP 目的地）。 + - 工作区是普通目录，目的地/模式配置仍写在工作区 `.dsh-abap-adt/`，与 Web 版一致。 + - Host 半只用 Node 内置模块；`@nefevcore` core 通过扫描 `~/.dsh/profiles/*` 定位，桌面版 profile 在 `~/.dsh/profiles/desktop` 下同样适用。 + ### 安装后 1. **重启 DSH**； diff --git a/package.json b/package.json index 31f22ff..95e68bb 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "dsh-abap-workbench", - "version": "0.1.2", + "version": "0.1.3", "private": false, "description": "SAP ABAP 工作台：一个 DSH bundle，内含 ABAP 预设（只读/调试/更改，按工作区策略切换）、可视化配置页（目的地、连接测试、运行模式、可写白名单）和会话状态徽章。依赖 @nefevcore/abap-adt-dsh-plugin 提供 adt_* 工具。", "type": "module",