linkitty-desktop 0.17.5 → 0.19.0

package/README.md

@@ -4,22 +4,24 @@ 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:
 
-## Published npm 0.17.5 and upgrades
+## Install and upgrade 0.19.0
 
-The immutable macOS Apple Silicon desktop package 0.17.5 is published and requires Node.js 22+. It installs the exact `linkitty=0.17.5` dependency:
+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:
 
 ```sh
-npm install -g linkitty-desktop@0.17.5
+npm install -g linkitty-desktop@0.19.0
 ```
 
 For existing installations upgraded with npm12, update and rebuild both components:
 
 ```sh
-npm install -g linkitty@0.17.5 linkitty-desktop@0.17.5
+npm install -g linkitty@0.19.0 linkitty-desktop@0.19.0
 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. See publication acceptance. New source features require a matching verified release. Use matching verified CLI and desktop payloads.
+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.
 
 ```sh
 linkitty-desktop
@@ -28,8 +30,17 @@ linkitty-desktop --lang en
 
 Sign in, connect a local service and manage plugins, access and sharing. The interface supports Chinese, English, Japanese and Russian. `--lang zh|en|ja|ru` saves a preference shared with the CLI; an existing application reads it at next launch. Account region is configured separately.
 
-On macOS, installation creates a managed link at `~/Applications/Linkitty.app` without overwriting unrelated applications. Closing the window leaves the background connection running; sleep, network loss or stopping the service makes the computer unavailable.
+On macOS, installation places the verified application at `~/Applications/Linkitty.app` without replacing an unrelated application. Closing the window leaves the shared background connection running; sleep, network loss or stopping the service makes the computer unavailable.
 
 Codex session sharing supports macOS. Finish tasks and quit independently running Codex before the first connection; open it normally after success. Model sign-in and existing agent permissions remain with your agent.
 
-Native distribution currently targets macOS Apple Silicon. Linux and Windows desktop builds require verification on those systems; missing payloads fail explicitly. The macOS App is ad-hoc signed and not notarized. Keep system security protections enabled.
+The shared Runtime includes the emergency desktop adapter and its native backend. On the Mac being controlled, run:
+
+```sh
+linkitty permissions setup
+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.

package/README.zh-CN.md

@@ -4,22 +4,24 @@
 
 桌面管理端与 Linkitty CLI 共用一个后台连接服务。从 npm 安装匹配的 CLI 和桌面包，然后启动：
 
-## 已发布的 npm 0.17.5 与升级
+## 安装与升级 0.19.0
 
-macOS Apple Silicon 桌面包0.17.5不可变包已发布，需要Node.js 22+，自动安装精确的 `linkitty=0.17.5` 依赖：
+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` 依赖：
 
 ```sh
-npm install -g linkitty-desktop@0.17.5
+npm install -g linkitty-desktop@0.19.0
 ```
 
 已有安装使用npm12升级时同步更新并重建两项组件：
 
 ```sh
-npm install -g linkitty@0.17.5 linkitty-desktop@0.17.5
+npm install -g linkitty@0.19.0 linkitty-desktop@0.19.0
 npm rebuild -g linkitty linkitty-desktop --allow-scripts=linkitty,linkitty-desktop
 ```
 
-安装和重建的自定义 `--prefix` 必须相同。npm12新装在首次原生操作或桌面启动时校验解压，见发行验收。新源码功能须使用相匹配的已验证发行，CLI和桌面须使用匹配的已验证制品。
+安装和重建的自定义 `--prefix` 必须相同。npm12新装在首次原生操作或桌面启动时校验解压。CLI 和桌面版本须保持一致。
 
 ```sh
 linkitty-desktop
@@ -28,8 +30,17 @@ linkitty-desktop --lang zh
 
 登录后接入本机服务，管理插件、授权和分享。界面支持中文、英文、日文、俄文。`--lang zh|en|ja|ru` 保存与 CLI 共用的语言，已有应用下次启动时读取；账号地域单独配置。
 
-macOS 安装在 `~/Applications/Linkitty.app` 创建受管理链接，不覆盖无关应用。关闭窗口后后台连接继续；休眠、断网或停止服务时不可达。
+macOS 将校验后的应用实际安装到 `~/Applications/Linkitty.app`，不替换无关应用。关闭窗口后共享后台连接继续；休眠、断网或停止服务时不可达。
 
 Codex 会话共用支持 macOS。首次接入前完成任务并退出独立运行的 Codex，成功后正常打开。模型登录和既有执行权限仍由 Agent 管理。
 
-原生发行目前面向 macOS Apple Silicon；Linux 和 Windows 桌面构建需对应系统验证，缺少制品时明确失败。macOS App 采用临时签名，尚未公证，请保持系统安全保护开启。
+共享 Runtime 包含应急远控适配器及原生后端。在被控 Mac 本机运行：
+
+```sh
+linkitty permissions setup
+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 检查。请保持系统安全保护开启。

package/artifacts.json

@@ -1,7 +1,12 @@
 {
   "darwin-arm64": {
     "archive": "payload/darwin-arm64.tgz",
-    "sha256": "b9a3980a3f610f8f32cbaf40dec5d047cbc5aa68cfce1193318b9330b582de3d",
+    "sha256": "6f2a8909854e59a3e2a775c7e103b9373e19dc170f8d153172fd558339597a43",
+    "source_commit": "622e9296be3e7d5cf9c2e95ebac52a846cad1109",
+    "source_tree": "582841fc8cb2ef789c88bb38f9d7d0312ecb15c0",
+    "signing_profile": "adhoc",
+    "requirement": "cdhash H\"574bfab7d7639f131adc17e8c21b558a4c634fa4\" or cdhash H\"f53d00d902e7f7d23abe59b54ff8a5e294d0c600\"",
+    "runtime_requirement": "cdhash H\"d48cff38813313cd9a49fad6cd424b339d2f14e4\"",
     "executable": "Linkitty.app"
   }
 }

package/bin/linkitty-desktop.cjs

@@ -6,6 +6,7 @@ const path=require('node:path');
 const {spawn}=require('node:child_process');
 const {ensureInstalled}=require('linkitty');
 try{
+  if(process.argv.includes('--recover')){console.log(JSON.stringify(require('linkitty/lib/installed-runtime.cjs').recoverDesktop()));process.exit(0);}
   const languageIndex=process.argv.indexOf('--lang');
   if(languageIndex>=0)setLanguage(process.argv[languageIndex+1]);
   if(process.argv.includes('--version')){console.log(require('../package.json').version);process.exit(0);}

package/package.json

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