@kkutysllb/dsh-terminal 1.0.1 → 1.1.1

package/README.md

@@ -4,6 +4,43 @@
 
 自 KCoder 内置包独立发布的 dsh 插件（v1.0.0 起独立版本线）。
 
+## QiLin 双通道适配（v1.1.0 起）
+
+manifest 同时声明 `qilin` 与 `dsh` 两个通道的 `bundle.patch` / `client`：
+QiLin（dsh alpha.2 合并后）的插件管理器只认原生键 `qilin.bundle.patch`
+（缺失会报"没有声明组合包"），DSH 宿主仍读 `dsh.*`；两通道指向同一份
+`cordis.patch.yml` 与 client 交付物，行为完全一致。
+
+## QiLin 引擎安装
+
+```bash
+# npm registry（推荐：版本可被插件管理检测，用户手动更新）
+# npm registry (recommended: version detection with manual updates)
+qilin plugin --profile qilin add @kkutysllb/dsh-terminal
+
+# GitHub 直装 / install straight from GitHub
+qilin plugin --profile qilin add github:kkutysllb/dsh-terminal
+```
+
+装完在 QiLin 设置 → 内置插件里可见、可启停；终端面板经标题栏
+"切换内嵌终端"开关展开。
+
+### 注意事项（QiLin）
+
+- **必须经 `qilin plugin add` 装进 profile**：包会落到 profile 私有的
+  `~/.qilin/profiles/<name>/node_modules`——裸包名原生解析的第一跳。
+  **不要**手工把包目录放进共享的 `~/.qilin/profiles/node_modules`：
+  dsh alpha.2 合并后的 runtime+enforce 解析把该目录划为安装保留区，
+  放那里的 bundle 层包激活时直接 `failed to import`。
+- **引擎版本**：运行需要带 dsh 兼容层的 QiLin 3.0.0+；插件**管理**
+  （设置页展示/启停）要求 3.0.2+（alpha.2 合并后只认
+  `qilin.bundle.patch` 原生键）。
+- **node-pty 依赖**：契约 `^1.1.0`，与引擎生态共享同一物理包；不可解
+  析时插件保持挂载并渲染降级卡（`/dsh-terminal/api/deps` 给出 cause
+  与可粘贴修复命令），不拖垮宿主。
+- **OpenKylin 桌面端**：内置终端由产品启动脚本自动物化（vendor 直提 +
+  bundle 注册，同样落 profile 私有锚），无需手动安装。
+
 ## 真实终端语义（模式平移自 dsh-coding-sidebar 的 pty-deps / pty-manager）
 
 - **内核级伪终端**：node-pty `spawn`（macOS/Linux 走 forkpty，Windows 走
@@ -21,14 +58,24 @@
   Windows `DSH_TERMINAL_SHELL` → pwsh 探测链（PATH + 已知安装目录）→
   `powershell.exe`；POSIX 以登录 shell 启动（读 profile 文件）。
 
-node-pty 版本契约：`^1.1.0`，与 DSH core（`@deepseek-ai/dsh-subprocess-local`）
-同 range——同 range 同 integrity 让 pnpm 两侧解析到同一物理包（一份
-native 绑定，无漂移）。
+node-pty 版本契约：`^1.1.0`（v1.1.1 起声明于 dependencies），与 DSH core
+（`@deepseek-ai/dsh-subprocess-local`）同 range——同 range 同 integrity 让
+pnpm 两侧解析到同一物理包（一份 native 绑定，无漂移）。dsh 0.1.6-alpha.2
+起依赖解析默认运行时模式且共享保留区（`profiles/node_modules`）被排除，
+未声明的提升副本不再可解析——声明依赖是唯一稳定入口。
 
 ## 安装
 
 ```bash
-dsh plugin install @kkutysllb/dsh-terminal
+# npm registry（推荐：版本可被插件管理检测，用户手动更新）
+# npm registry (recommended: version detection with manual updates)
+dsh plugin --profile web add @kkutysllb/dsh-terminal
+
+# GitHub 直装 / install straight from GitHub
+dsh plugin --profile web add github:kkutysllb/dsh-terminal
+
+# 或从 dsh-plugins 真源仓 / or from the dsh-plugins monorepo
+dsh plugin --profile web add github:kkutysllb/dsh-plugins#dsh-terminal
 ```
 
 ## 形态

package/client.js

@@ -830,18 +830,38 @@ body[data-ds-dark-theme] #${BTN_ID}{color:rgba(232,234,237,.8)}
       /* ---- 窗口 resize → 重排（view 时代 win.on('resize') 的等价物） ---- */
       window.addEventListener('resize', () => layout())
 
-      /* ---- 右侧栏宽度探针（better-sidebar 浮层；面板右边界让位） ---- */
-      // better-sidebar 把面板实时宽度写在根变量 --dsh-sidebar-width
-      //（展开/拖宽 setProperty、收起 removeProperty）。监听 style 属性
-      // 变化即得右边界，无变量时视作收起（0）。
+      /* ---- 右侧栏宽度探针（面板右边界让位） ---- */
+      // KCoder better-sidebar 把面板实时宽度写在根变量 --dsh-sidebar-width
+      //（展开/拖宽 setProperty、收起 removeProperty），监听 style 属性变
+      // 化即得右边界。QiLin AppFrame 右栏不写该变量 → 回退为直接量
+      // [data-rightbar-col] 列宽，开合/拖宽由 ResizeObserver 驱动重排，
+      // 终端面板右边界精确停在右侧栏左缘，不侵占其下方区域。
       let rightPanelW = 0
+      let rightbarWatched = null
+      const armRightbarWatcher = () => {
+        const el = document.querySelector('[data-rightbar-col]')
+        if (el === null) return null
+        if (rightbarRo !== null && rightbarWatched !== el) { rightbarRo.observe(el); rightbarWatched = el }
+        return el
+      }
       const readRightPanel = () => {
-        const w = Number.parseFloat(document.documentElement.style.getPropertyValue('--dsh-sidebar-width'))
+        let w = Number.parseFloat(document.documentElement.style.getPropertyValue('--dsh-sidebar-width'))
+        if (!Number.isFinite(w) || w <= 0) {
+          const el = armRightbarWatcher()
+          w = el !== null ? el.getBoundingClientRect().width : 0
+        }
         const next = Number.isFinite(w) && w > 0 ? Math.round(w) : 0
         if (next !== rightPanelW) { rightPanelW = next; layout() }
       }
+      const rightbarRo = typeof ResizeObserver !== 'undefined' ? new ResizeObserver(readRightPanel) : null
       readRightPanel()
       new MutationObserver(readRightPanel).observe(document.documentElement, { attributes: true, attributeFilter: ['style'] })
+      // 右栏列晚于本脚本初始化（React 挂载在后）：DOM 变化兜底重探，
+      // 探到即交棒 ResizeObserver 并停表，避免常驻监听
+      const rightbarMountMo = new MutationObserver(() => {
+        if (armRightbarWatcher() !== null) { readRightPanel(); rightbarMountMo.disconnect() }
+      })
+      if (rightbarWatched === null) rightbarMountMo.observe(document.body, { childList: true, subtree: true })
 
       /* ---- 标题栏按钮（theme-watcher 注入宿主，时序不保证 → 轮询等待） ---- */
       const injectBtn = () => {

package/entry.js

@@ -15,11 +15,13 @@
  * 安全边界与 dsh-git-panel 同款：isTrusted（loopback 放行 +
  * webRuntime.trustedHosts）；写操作 POST-only；SSE 为只读推送。
  *
- * pty 引擎：node-pty（VS Code 同款，内核级伪终端 openpty/ConPTY），经
- * createRequire 从运行时 node_modules 解析（bundle 物化在 profile 的
- * node_modules 下，向上可达 profiles/node_modules/node-pty——dsh-tool-bash
- * 已带）。真实终端健壮性（模式平移自 dsh-coding-sidebar 的 pty-deps/
- * pty-manager）：
+ * pty 引擎：node-pty（VS Code 同款，内核级伪终端 openpty/ConPTY），
+ * package.json dependencies 声明 ^1.1.0——profile 安装图内的合法包，
+ * 经 createRequire 从插件自身解析（dsh 0.1.6-alpha.2 起运行时解析
+ * enforce：候选在共享保留区 profiles/node_modules 前截断，向上的
+ * 提升副本不再是解析来源；声明依赖即入 generation，隔离/hoisted
+ * 布局都解析得到）。真实终端健壮性（模式平移自 dsh-coding-sidebar
+ * 的 pty-deps/pty-manager）：
  * - 懒加载永不抛错：模块导入不触发 native 绑定加载；加载失败缓存原因，
  *   插件保持挂载（降级态），deps 路由给出修复命令，不拖垮宿主；
  * - ensureSpawnHelper：补回包管理器剥掉的 spawn-helper 可执行位（缺失
@@ -141,14 +143,15 @@ function isProfileRoot(dir) {
 
 /**
  * 探测本插件安装所在的 profile 目录：插件模块的最近双证祖先（profile
- * 根，插件从其 node_modules 解析）；探测不到回退 $DSH_HOME/profiles/web
- * （标准 web profile）；仍不像则 null。
+ * 根，插件从其 node_modules 解析）；探测不到回退 <宿主 home>/profiles/web
+ * （$QILIN_HOME → $DSH_HOME → ~/.dsh，标准 web profile）；仍不像则 null。
  */
 export function findProfileDir(fromFile = fileURLToPath(import.meta.url)) {
   const detected = walkUp(realDir(fromFile), isProfileRoot)
   if (detected !== null) return detected
-  const home = process.env.DSH_HOME !== undefined && process.env.DSH_HOME.trim() !== ''
-    ? process.env.DSH_HOME
+  const configured = process.env.QILIN_HOME ?? process.env.DSH_HOME
+  const home = configured !== undefined && configured.trim() !== ''
+    ? configured
     : join(homedir(), '.dsh')
   const web = join(home, 'profiles', 'web')
   return isProfileRoot(web) ? realpathSync(web) : null
@@ -163,7 +166,7 @@ export function buildRepairCommand(options = {}) {
   const profileDir = options.profileDir !== undefined ? options.profileDir : findProfileDir()
   const name = profileDir !== null ? basename(profileDir) : 'web'
   return {
-    command: 'dsh plugin --profile "' + name + '" install',
+    command: 'dsh plugin --profile "' + name + '" add @kkutysllb/dsh-terminal@latest',
     note: "If pnpm 11 blocked node-pty's build script, ensure allowBuilds: node-pty: true"
       + " in the profile's pnpm-workspace.yaml, then rerun the install command.",
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kkutysllb/dsh-terminal",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "description": "dsh-external in-box dsh bundle: embedded terminal panel (node-pty backed multi-tab shells, per-workspace buckets, xterm.js UI) as a bottom dock inside the dsh web page, replacing the retired Electron host terminal-panel.",
   "license": "MIT",
   "type": "module",
@@ -42,5 +42,17 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "qilin": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [],
+      "platform": "web"
+    }
+  },
+  "dependencies": {
+    "node-pty": "^1.1.0"
   }
 }