linkitty-desktop 0.19.0 → 0.19.1

package/README.md

@@ -4,24 +4,28 @@ English · [简体中文](README.zh-CN.md)
 
 The desktop manager shares one background connection service with the Linkitty CLI. Install matching CLI and desktop packages from npm, then launch:
 
-## Install and upgrade 0.19.0
+## Install and upgrade 0.19.1
 
 On macOS, the desktop manager is a physical `~/Applications/Linkitty.app` and shares `~/Applications/Linkitty Runtime.app` with CLI. Permission controls and QR scanning delegate to Runtime through its installed helper. The default profile retains the previous ad-hoc signing method; a rebuilt Runtime may need local authorization again.
 
-Desktop 0.19.0 targets macOS Apple Silicon and requires Node.js 22+. It installs the exact `linkitty=0.19.0` dependency:
+Desktop 0.19.1 targets macOS Apple Silicon and requires Node.js 22+. It installs the exact `linkitty=0.19.1` dependency:
 
 ```sh
-npm install -g linkitty-desktop@0.19.0
+npm install -g --allow-scripts=linkitty,linkitty-desktop linkitty-desktop@0.19.1
 ```
 
 For existing installations upgraded with npm12, update and rebuild both components:
 
 ```sh
-npm install -g linkitty@0.19.0 linkitty-desktop@0.19.0
+npm install -g --allow-scripts=linkitty,linkitty-desktop linkitty@0.19.1 linkitty-desktop@0.19.1
 npm rebuild -g linkitty linkitty-desktop --allow-scripts=linkitty,linkitty-desktop
 ```
 
-Use the same custom `--prefix` for installation and rebuilding. New npm12 installations verify/extract on first native use or desktop launch. Keep CLI and desktop versions matched.
+Use the same custom `--prefix` for installation and rebuilding. Keep CLI and desktop versions matched and finish active tasks before upgrading.
+
+Starting with 0.19.1: on macOS, npm installation scripts verify the installed Runtime signature and automatically register/start the shared background service. If npm skips the scripts, the first native CLI operation or desktop launch performs the same installation initialization. Normal users do not need a separate `linkitty service install` step; use a matching release containing this change.
+
+If macOS requests background-service approval, complete the reported System Settings step before expecting the service to run. Installation does not request Screen Recording, Accessibility/input or camera permissions. Check `linkitty service status`; `linkitty service install` remains a repair command when indicated, without bypassing system approval.
 
 ```sh
 linkitty-desktop
@@ -44,3 +48,5 @@ linkitty connect remote
 Approve Screen Recording and Accessibility locally and install the matching signed Emergency desktop plugin. Viewing and control have separate grants; control additionally requires an explicit action. The current Mac login's primary display is accessible, including other applications. Keep macOS 14+ awake, logged in and online. Emergency desktop uses up to 3 JPEG snapshots per second; Windows/Linux hosts, audio, clipboard/file transfer, login screens and unattended startup are outside this version. See the [CLI guide](../linkitty/README.md#emergency-mac-desktop) for authorization and connection details.
 
 Native distribution currently targets macOS Apple Silicon. Linux and Windows desktop builds require verification on those systems; missing payloads fail explicitly. The current macOS profile remains ad-hoc signed with no Apple notarization claim. Fixed installation and one Runtime permission owner are retained, but upgrades may report that local authorization is required again; affected operations remain denied until granted. Developer ID remains an optional separate profile with notarization/Gatekeeper checks. Keep system security protections enabled.
+
+After granting a system permission that requires a restart, finish active tasks and run `linkitty service restart`. Remote access briefly disconnects; enabled connections then recover with account and session data preserved. This requires a CLI release containing the restart command.

package/README.zh-CN.md

@@ -4,24 +4,28 @@
 
 桌面管理端与 Linkitty CLI 共用一个后台连接服务。从 npm 安装匹配的 CLI 和桌面包，然后启动：
 
-## 安装与升级 0.19.0
+## 安装与升级 0.19.1
 
 macOS 桌面管理端实际安装在 `~/Applications/Linkitty.app`，与 CLI 共用 `~/Applications/Linkitty Runtime.app`；权限入口和二维码摄像头通过已安装助手交给 Runtime。默认沿用旧版 ad-hoc 临时签名，重新构建后 Runtime 仍可能需要本地重新授权。
 
-桌面包 0.19.0 面向 macOS Apple Silicon，需要 Node.js 22+，自动安装精确的 `linkitty=0.19.0` 依赖：
+桌面包 0.19.1 面向 macOS Apple Silicon，需要 Node.js 22+，自动安装精确的 `linkitty=0.19.1` 依赖：
 
 ```sh
-npm install -g linkitty-desktop@0.19.0
+npm install -g --allow-scripts=linkitty,linkitty-desktop linkitty-desktop@0.19.1
 ```
 
 已有安装使用npm12升级时同步更新并重建两项组件：
 
 ```sh
-npm install -g linkitty@0.19.0 linkitty-desktop@0.19.0
+npm install -g --allow-scripts=linkitty,linkitty-desktop linkitty@0.19.1 linkitty-desktop@0.19.1
 npm rebuild -g linkitty linkitty-desktop --allow-scripts=linkitty,linkitty-desktop
 ```
 
-安装和重建的自定义 `--prefix` 必须相同。npm12新装在首次原生操作或桌面启动时校验解压。CLI 和桌面版本须保持一致。
+安装和重建的自定义 `--prefix` 必须相同。CLI 和桌面版本须保持一致，升级前完成正在执行的任务。
+
+从 0.19.1 开始：macOS 的 npm 安装脚本校验已安装 Runtime 的签名后，自动注册并启动共享后台；npm 跳过脚本时，首次原生 CLI 操作或桌面启动执行同一安装初始化。正常用户无需另行执行 `linkitty service install`，请使用包含此改动的匹配发行版。
+
+若 macOS 要求批准后台服务，按提示到系统设置完成后才能预期后台运行。安装不会请求录屏、辅助功能／输入或摄像头权限。先通过 `linkitty service status` 检查；提示需要修复安装时仍可用 `linkitty service install`，不会绕过系统批准。
 
 ```sh
 linkitty-desktop
@@ -44,3 +48,5 @@ linkitty connect remote
 在本机授予屏幕录制和辅助功能权限，并安装匹配的签名应急远控插件。查看和操作分别授权，操作还需主动启用。访问范围为当前 Mac 登录用户的主显示器，包括其他应用。要求 macOS 14 及以上并保持唤醒、登录和联网；应急模式最高每秒 3 张 JPEG 快照，不支持 Windows/Linux 被控端、音频、剪贴板/文件传输、登录界面及无人值守启动。授权和接入细节见 [CLI 指南](../linkitty/README.zh-CN.md#mac-应急远控)。
 
 原生发行目前面向 macOS Apple Silicon；Linux 和 Windows 桌面构建需对应系统验证，缺少制品时明确失败。当前 macOS 分支继续采用 ad-hoc 临时签名，不宣称 Apple 公证。固定安装路径与 Runtime 统一权限主体保留，但升级后仍可能提示本地重新授权；未获准前相关敏感操作继续拒绝。Developer ID 保留为独立可选分支，仍需公证／Gatekeeper 检查。请保持系统安全保护开启。
+
+完成系统授权后，如提示需要重启，请先结束正在执行的任务，再运行 `linkitty service restart`。远程访问会短暂断开，随后恢复已启用的连接；账号和原有会话保留。需使用包含重启命令的 CLI 版本。

package/artifacts.json

@@ -1,12 +1,12 @@
 {
   "darwin-arm64": {
     "archive": "payload/darwin-arm64.tgz",
-    "sha256": "6f2a8909854e59a3e2a775c7e103b9373e19dc170f8d153172fd558339597a43",
-    "source_commit": "622e9296be3e7d5cf9c2e95ebac52a846cad1109",
-    "source_tree": "582841fc8cb2ef789c88bb38f9d7d0312ecb15c0",
+    "sha256": "4c6e5d0489965065ad8cf635593ac81c59718e4cdaf24b1df9b658b12ef8dad9",
+    "source_commit": "c03bea393a67b31df3698ac86a71f4bc37a17be6",
+    "source_tree": "77452abd5224b4b638ada65b023a28939e3d4774",
     "signing_profile": "adhoc",
-    "requirement": "cdhash H\"574bfab7d7639f131adc17e8c21b558a4c634fa4\" or cdhash H\"f53d00d902e7f7d23abe59b54ff8a5e294d0c600\"",
-    "runtime_requirement": "cdhash H\"d48cff38813313cd9a49fad6cd424b339d2f14e4\"",
+    "requirement": "cdhash H\"f825f151bb84ab51fbcf55c3938ae8defb72f7c9\" or cdhash H\"29ccbf88adb7c44131111fa331d9712b0f2474f4\"",
+    "runtime_requirement": "cdhash H\"59f7ca411a5089b2cdcd521b661f6aac13b74b75\"",
     "executable": "Linkitty.app"
   }
 }

package/lib/install.cjs

@@ -1,6 +1,8 @@
 'use strict';
 const {t}=require("linkitty/lib/i18n.cjs");
 try{
-  require('linkitty').install(require('node:path').resolve(__dirname,'..'),'linkitty-desktop');
+  const result=require('linkitty').install(require('node:path').resolve(__dirname,'..'),'linkitty-desktop');
   console.log(t('Linkitty Desktop 已安装。运行 linkitty-desktop 打开。'));
+  if(result.background_approval_required)console.log(t('请在系统设置 → 通用 → 登录项与扩展中允许 Linkitty Runtime 在后台运行，然后重试。'));
+  else if(result.background_ready===false)console.log(t('后台尚未就绪，请运行 linkitty service install 后重试；如系统要求，请允许后台运行。'));
 }catch(error){console.error(error.message);process.exitCode=1;}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linkitty-desktop",
-  "version": "0.19.0",
+  "version": "0.19.1",
   "description": "Linkitty 桌面管理客户端与本机服务接入",
   "license": "UNLICENSED",
   "engines": {
@@ -23,6 +23,6 @@
     "postinstall": "node lib/install.cjs"
   },
   "dependencies": {
-    "linkitty": "0.19.0"
+    "linkitty": "0.19.1"
   }
 }