@winking-r/dsh-uniterminal 0.2.16 → 0.2.17

package/CHANGELOG.md

@@ -0,0 +1,57 @@
+# 更新日志
+
+遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+`0.x` 阶段：**次要版本可能包含不兼容变更**（配置项与插件 API 仍可能调整），补丁版本只修缺陷。
+
+## [Unreleased]
+
+## [0.2.17] - 2026-10-29
+
+### 修复
+
+- **行尾「更多操作」按钮的菜单被面板右边缘裁掉**：锚点靠右时菜单仍向右伸展，伸出面板后被宿主的
+  `overflow` 裁掉，「移入分组…」「测试连接」只显示半截。现在锚点过半宽时改为**右对齐、向左展开**；
+  鼠标右键、`Shift+F10`/菜单键、「⋯」按钮三条入口共用同一套判定（`src/client/menu-anchor.ts`）。
+
+### 文档
+
+- 新增 `CONTRIBUTING.md`：源码断言的约定（改 CSS/文案要同步更新断言、不要删断言）、
+  DOM 测试模板（`// @vitest-environment jsdom` + `afterEach(cleanup)`）、CSS 契约、
+  以及**禁止用固定字符数切源码**这条踩过两次的坑。
+- README 补「右栏承载」一节：装了 `DSH-better-sidebar` 优先注册到 `ctx.betterSidebar`，
+  否则回落官方 `sidebarRightTabs`。
+
+## [0.2.16] - 2026-10-29
+
+首个公开发布版本（MIT）。
+
+### 新增
+
+- SSH 终端（xterm.js）、SFTP 文件管理、端口转发（`-L` / `-R` / `-D`）、跳板链、分组管理、外观设置。
+- 一个侧边栏标签装多条会话，顶部会话栏切换；同一主机连两次显示 `#2`；刷新页面自动接回会话。
+- **凭据交给操作系统密码箱**（Windows 凭据管理器 / macOS 钥匙串 / Linux Secret Service），
+  插件自身不实现任何加密；只有机器没有系统密码箱时才回落明文文件（0600 + 原子写），并在界面如实说明。
+- 失败提示区分 7 类原因（超时 / 拒绝 / DNS / 不可达 / 主机指纹 / 认证 / 未知）并给出下一步动作；
+  内部字段名不再出现在界面上（细节只进 diag）。
+
+### 无障碍
+
+- 右键菜单与确认弹框：打开即聚焦、方向键/Home/End、`Tab` 焦点陷阱、关闭后**把焦点还给触发元素**。
+- 提示条改为常驻 live region（成功 `status/polite`、失败 `alert/assertive`），读屏能听见错误。
+- SFTP 文件行支持键盘选中（`aria-pressed`）；主机行「连接 / 测试」的可访问名带主机名。
+
+### 设计
+
+- 引入 token 层（字号 13/14/16 三级阶梯、圆角 4/6/10/999、灰阶与遮罩、语义色单一来源）。
+- 内联样式收敛 66%（541 → 182 条声明）；重复选择器 4 组 → 0 组。
+
+### 质量
+
+- 严格 TypeScript（`strict` + `noUncheckedIndexedAccess`）：`:any` 与 `@ts-ignore` 均为 0。
+- 64 个测试文件 / 915 个用例（含 jsdom 真实交互用例）；`pnpm audit --prod` 零已知漏洞。
+- `prepublishOnly` 强制跑 typecheck + test + build，过不了发不出去。
+
+[Unreleased]: https://github.com/WinKing-R/dsh-uniterminal/compare/v0.2.17...HEAD
+[0.2.17]: https://github.com/WinKing-R/dsh-uniterminal/compare/v0.2.16...v0.2.17
+[0.2.16]: https://github.com/WinKing-R/dsh-uniterminal/releases/tag/v0.2.16

package/README.md

@@ -1,5 +1,9 @@
 # UniTerminal · DSH 远程终端插件
 
+[![npm](https://img.shields.io/npm/v/@winking-r/dsh-uniterminal.svg)](https://www.npmjs.com/package/@winking-r/dsh-uniterminal)
+[![license](https://img.shields.io/npm/l/@winking-r/dsh-uniterminal.svg)](LICENSE)
+[![GitHub](https://img.shields.io/badge/GitHub-WinKing--R%2Fdsh--uniterminal-blue)](https://github.com/WinKing-R/dsh-uniterminal)
+
 SSH / SFTP / 端口转发，挂在 DSH 右侧栏里。**一个侧边栏标签里装多条会话**（顶部会话栏切换；同一台主机连两次显示 `#2`），
 每条会话的终端、文件、隧道三视图并列。
 
@@ -7,7 +11,7 @@ SSH / SFTP / 端口转发，挂在 DSH 右侧栏里。**一个侧边栏标签里
 
 | 项 | 值 |
 |---|---|
-| 版本 | `0.2.16`（`0.x`：API 与配置项仍可能变，按语义化版本升号） |
+| 版本 | `0.2.17`（`0.x`：API 与配置项仍可能变，按语义化版本升号；变更见 [CHANGELOG](CHANGELOG.md)） |
 | 许可证 | **MIT**（见 [LICENSE](LICENSE)）——可自由使用、修改、商用，保留版权声明即可 |
 | 环境 | DSH `>=0.2.1-rc.2`、Node `>=20` |
 
@@ -25,14 +29,30 @@ SSH / SFTP / 端口转发，挂在 DSH 右侧栏里。**一个侧边栏标签里
 前提：DSH `>=0.2.1-rc.2`（见本包 `package.json` 的 `dsh.engines`）、Node `>=20`。
 从源码装还需要 pnpm；用打好的 `tgz` 安装则**不需要**自己构建。
 
+### 右栏承载：官方 `sidebarRight` 或第三方 `DSH-better-sidebar`
+
+本插件**双注册 + 运行时探测**（`src/client/right-pane.ts`）：
+
+| 你的 DSH 里装了 | 插件注册到 | 结果 |
+|---|---|---|
+| [`DSH-better-sidebar`](https://github.com/omdsh-dev/DSH-better-sidebar) | `ctx.betterSidebar`（**优先**） | 右栏像 IDE 那样多标签并存，本插件占一个标签 |
+| 只有官方 `@deepseek-ai/dsh-client-ui-sidebar-right` | `ctx.sidebarRightTabs` | 回落到官方右栏标签 |
+
+两种都能用；**没有 better-sidebar 也能跑**（会自动回落）。
+若右栏始终不出现本插件，先确认这两者至少有一个已启用——诊断见
+[`docs/acceptance-m0.md`](docs/acceptance-m0.md)（`target=none` 表示两套注册表都不可用）。
+
 ```bash
 # 在 DSH 的 desktop profile 目录下执行
 cd ~/.dsh/profiles/desktop
 
-# 方式一：从源码链接（改代码即生效，开发用）
+# 方式一：从 npm 安装（推荐，不需要 Node 工具链）
+pnpm add @winking-r/dsh-uniterminal
+
+# 方式二：从源码链接（改代码即生效，开发用）
 pnpm add "link:<你的本仓库绝对路径>"
 
-# 方式二：从目录安装（用打包好的 tgz，无需 Node 工具链）
+# 方式三：从目录安装（用打包好的 tgz）
 pnpm add "file:<tgz 的绝对路径>"
 ```
 

package/lib/client.js

@@ -1404,6 +1404,7 @@ window.__ModuleLoader__.load({
 				"aria-label": props.label,
 				style: {
 					left: props.left,
+					right: props.right,
 					top: props.top
 				},
 				onMouseDown: (event) => event.stopPropagation(),
@@ -1426,6 +1427,23 @@ window.__ModuleLoader__.load({
 				}, item.label))
 			});
 		}
+		// src/client/menu-anchor.ts
+		/**
+		* @param anchorX 锚点的横向位置（相对面板左边缘，像素）
+		* @param anchorY 锚点的纵向位置（相对面板上边缘，像素）
+		* @param paneWidth 面板宽度；0 或未知时退回左对齐（总比跑到面板外好）
+		*/
+		function menuAnchor(anchorX, anchorY, paneWidth) {
+			const top = Math.max(0, anchorY);
+			if (paneWidth > 0 && anchorX > paneWidth / 2) return {
+				right: Math.max(0, paneWidth - anchorX),
+				top
+			};
+			return {
+				left: Math.max(0, anchorX),
+				top
+			};
+		}
 		// src/client/host-filter.ts
 		/**
 		* 主机/分组搜索。
@@ -2270,11 +2288,9 @@ window.__ModuleLoader__.load({
 			*/
 			function anchorOf(element) {
 				const rect = element.getBoundingClientRect();
-				const pane = paneRef.current?.getBoundingClientRect();
-				return {
-					left: rect.left - (pane?.left ?? 0),
-					top: rect.bottom - (pane?.top ?? 0)
-				};
+				const pane = paneRef.current;
+				const paneRect = pane?.getBoundingClientRect();
+				return menuAnchor(rect.right - (paneRect?.left ?? 0), rect.bottom - (paneRect?.top ?? 0), pane?.clientWidth ?? 0);
 			}
 			/** 打开主机菜单：trigger 既当锚点，也是关闭后焦点要回的元素。 */
 			function openRowMenu(trigger, profileId) {
@@ -2316,10 +2332,10 @@ window.__ModuleLoader__.load({
 						},
 						onContextMenu: (event) => {
 							event.preventDefault();
-							const rect = paneRef.current?.getBoundingClientRect();
+							const pane = paneRef.current;
+							const rect = pane?.getBoundingClientRect();
 							setMenu({
-								left: event.clientX - (rect?.left ?? 0),
-								top: event.clientY - (rect?.top ?? 0),
+								...menuAnchor(event.clientX - (rect?.left ?? 0), event.clientY - (rect?.top ?? 0), pane?.clientWidth ?? 0),
 								profileId: profile.id,
 								trigger: event.currentTarget
 							});
@@ -2754,10 +2770,10 @@ window.__ModuleLoader__.load({
 										},
 										onContextMenu: (event) => {
 											event.preventDefault();
-											const rect = paneRef.current?.getBoundingClientRect();
+											const pane = paneRef.current;
+											const rect = pane?.getBoundingClientRect();
 											setGroupMenu({
-												left: event.clientX - (rect?.left ?? 0),
-												top: event.clientY - (rect?.top ?? 0),
+												...menuAnchor(event.clientX - (rect?.left ?? 0), event.clientY - (rect?.top ?? 0), pane?.clientWidth ?? 0),
 												groupId: node.id,
 												trigger: event.currentTarget
 											});
@@ -2904,6 +2920,7 @@ window.__ModuleLoader__.load({
 						if (target === void 0) return null;
 						return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ContextMenu, {
 							left: menu.left,
+							right: menu.right,
 							top: menu.top,
 							label: "主机 " + target.name + " 的操作",
 							returnFocusTo: menu.trigger,
@@ -2937,6 +2954,7 @@ window.__ModuleLoader__.load({
 						if (node === void 0) return null;
 						return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ContextMenu, {
 							left: groupMenu.left,
+							right: groupMenu.right,
 							top: groupMenu.top,
 							label: "分组 " + node.path.join(" / ") + " 的操作",
 							returnFocusTo: groupMenu.trigger,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@winking-r/dsh-uniterminal",
-  "version": "0.2.16",
+  "version": "0.2.17",
   "description": "在 DSH 右侧栏里提供 SSH 终端、SFTP 文件管理与端口转发的插件；密码交给操作系统密码箱保管，插件自身不实现加密。",
   "keywords": [
     "dsh",
@@ -36,6 +36,7 @@
     "lib",
     "cordis.patch.yml",
     "README.md",
+    "CHANGELOG.md",
     "docs/SECURITY.md"
   ],
   "publishConfig": {