dsh-mobile-access 1.0.0 → 1.0.2

package/README.md

@@ -30,20 +30,38 @@ dsh web authentication required; reopen the URL printed by dsh web.
 
 ## 安装
 
-本目录就是可安装的 bundle 目录。构建并验证后，由 DSH 插件管理器安装：
+推荐使用官方 DSH CLI 一次安装。已发布到 npm；下面是**可复现**的精确版本命令：
+
+```bash
+dsh plugin --profile web add dsh-mobile-access@1.0.2
+```
+
+也可以使用 `@latest`，但 pnpm 的元数据缓存/镜像可能暂时仍解析到旧版；需要最新版时优先使用上面的精确版本，或显式指定官方 registry：
+
+```bash
+dsh plugin --profile web add dsh-mobile-access@latest --registry=https://registry.npmjs.org/
+```
+
+本机 2026-10-24 的实测结果：默认 registry 下 `@latest` 仍解析到 `1.0.0`，精确版本可正确安装；指定 npmjs 后 `@latest` 也解析到最新版。`1.0.0` 已包含 Safari 配对修复；`1.0.1` 只增加安装文档和发布元数据；`1.0.2` 增加 iPhone 自带键盘换行。
+
+`dsh plugin` 会在 profile 目录执行 pnpm 安装，并自动把声明了 `dsh.bundle.patch` 的包追加到 `dsh.profile.bundles`；不需要手工编辑 `cordis.patch.yml` 或 bundle 列表。
+
+从本目录安装（开发机、未发布版本或离线环境）：
 
 ```bash
 cd /Users/open/Documents/Stocks/plugins/dsh-mobile-access
 npm run verify
+dsh plugin --profile web add /Users/open/Documents/Stocks/plugins/dsh-mobile-access
 ```
 
-安装目录（绝对路径）：
+也可以使用 `npm pack` 生成 tgz 后安装：
 
-```text
-/Users/open/Documents/Stocks/plugins/dsh-mobile-access
+```bash
+npm pack
+dsh plugin --profile web add /absolute/path/to/dsh-mobile-access-1.0.2.tgz
 ```
 
-在 DSH 的插件管理入口执行 `install_bundle`，目标为上面的绝对路径。新 bundle 通常可以 HMR 生效；如果插件管理器提示 `restart-required`，**不要自行重启**，按项目约定通知用户手工重启 DSH，用户确认「已重启」后再继续。
+如果 DSH 正在运行，安装后的 host bundle 可能需要重启才能加载；插件管理器提示 `restart-required` 时，**不要自行重启**，按项目约定通知用户手工重启 DSH，用户确认「已重启」后再继续。已有环境也可以继续使用 DSH 插件管理入口的 `install_bundle`，目标为本目录的绝对路径；两种方式等价。
 
 ## 使用
 
@@ -66,7 +84,8 @@ npm run verify
 4. 成功后进入完整 DSH Web。建议：
    - 点 Safari 分享按钮 → 「添加到主屏幕」。
    - 以后从主屏幕图标进入；如果登录过期，重新打开一次 `/m` 配对即可。
-5. 若面板显示 `window.isSecureContext === false`，这是 HTTP 局域网的正常现象；本插件只对 iOS/iPadOS 安装一个窄范围的剪贴板回退，其他平台不会改动全局对象。
+5. **iPhone 自带键盘换行**：在输入框内按 Return 是换行，不会直接发送；发送请点输入框右侧的发送按钮。Mac 上保持 Enter 发送、Shift+Enter 换行；外接键盘可用 Cmd+Enter 发送。
+6. 若面板显示 `window.isSecureContext === false`，这是 HTTP 局域网的正常现象；本插件只对 iOS/iPadOS 安装一个窄范围的剪贴板回退，其他平台不会改动全局对象。
 
 ## 路由与权限
 
@@ -100,6 +119,7 @@ npm run verify
 - 不注册 Service Worker，不缓存或改写现有请求。
 - 不启动后台轮询；面板只在挂载、窗口聚焦、页面可见时读取一次状态。
 - 全局剪贴板回退只在 **iOS/iPadOS 且非安全上下文** 时安装，并在插件销毁时恢复原 descriptor。
+- Return 换行监听只在 **iOS/iPadOS** 上安装，只作用于带有 `data-composer-input` 的官方输入框；Mac 和非 Apple 平台不会安装该监听。
 - 插件注册失败只影响本插件自身；所有路由、slot、监听器和定时器都有清理路径。
 
 ## 开发与验证

package/client.js

@@ -54,6 +54,44 @@ async function copyText(value) {
     }
     return legacyCopy(value);
 }
+/**
+ * On iPhone/iPad the software keyboard has no Shift+Return. The official
+ * composer treats a plain Enter as "send", so a narrow capture-phase listener
+ * makes the event look like Shift+Enter to Lexical: the composer then keeps
+ * its native line break and does not submit. Mac and non-Apple platforms are
+ * never touched. The visible send button remains the send path.
+ */
+function installIOSReturnNewline() {
+    if (!isAppleMobile())
+        return () => undefined;
+    const doc = document;
+    const onKeyDown = (event) => {
+        if (event.key !== 'Enter' || event.defaultPrevented)
+            return;
+        if (event.shiftKey || event.altKey || event.ctrlKey || event.metaKey)
+            return;
+        if (event.isComposing || event.keyCode === 229)
+            return;
+        const target = event.target;
+        if (target === null || typeof target.closest !== 'function')
+            return;
+        if (target.closest('[data-composer-input]') === null)
+            return;
+        if (doc.querySelector('[data-composer-overlay] [role="listbox"]') !== null)
+            return;
+        try {
+            Object.defineProperty(event, 'shiftKey', { configurable: true, value: true });
+        }
+        catch {
+            event.preventDefault();
+            event.stopImmediatePropagation();
+            if (!doc.execCommand('insertLineBreak'))
+                doc.execCommand('insertText', false, '\n');
+        }
+    };
+    doc.addEventListener('keydown', onKeyDown, true);
+    return () => doc.removeEventListener('keydown', onKeyDown, true);
+}
 /**
  * On iOS an HTTP LAN page has no `navigator.clipboard`. A few existing DSH
  * controls call it directly, so install a narrowly scoped fallback there only.
@@ -358,6 +396,12 @@ function factory(require) {
                 catch (error) {
                     ctx.logger?.warn?.(`[mobile-access] clipboard fallback unavailable: ${String(error)}`);
                 }
+                try {
+                    cleanups.push(installIOSReturnNewline());
+                }
+                catch (error) {
+                    ctx.logger?.warn?.(`[mobile-access] iOS Return newline unavailable: ${String(error)}`);
+                }
                 return () => {
                     for (const cleanup of cleanups.reverse()) {
                         try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mobile-access",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Independent DSH bundle that pairs iPhones and iPads with the official DeepSeek Harness Web GUI over the local network.",
   "type": "module",
   "license": "MIT",