@justlovepl/desktop-bridge 0.0.0-stage → 0.2.6

package/dist/client/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "desktop-bridge-client-runtime",
+  "version": "0.2.6",
+  "private": true,
+  "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.32.1",
+    "@wonderwhy-er/desktop-commander": "0.3.0",
+    "ws": "8.22.0"
+  },
+  "overrides": {
+    "md-to-pdf": {
+      "chokidar": "^4.0.3"
+    },
+    "exceljs": {
+      "uuid": "^11.1.1"
+    },
+    "argparse": "^2.0.1"
+  }
+}

package/dist/client/runner.mjs

@@ -0,0 +1,38 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import {fork,spawn} from 'node:child_process';
+import {acquireLock,releaseLock} from './lifecycle.mjs';
+if(!process.argv[2])throw new Error('Usage: node runner.mjs client-data-directory');
+const root=path.resolve(process.argv[2]),flag=path.join(root,'maintenance.flag'),lock=path.join(root,'runner-lock');
+if(fs.existsSync(flag)||!acquireLock(lock))process.exit(0);
+process.on('exit',()=>releaseLock(lock));
+const launch=JSON.parse(fs.readFileSync(path.join(root,'launch.json'),'utf8').replace(/^\uFEFF/,''));
+let child,stopping=false,restartTimer,forceTimer,childStarted=0,childStopping=false;
+function killTree(processChild){
+ if(process.platform==='win32'){const killer=spawn('taskkill.exe',['/PID',String(processChild.pid),'/T','/F'],{stdio:'ignore'});killer.on('error',()=>processChild.kill('SIGKILL'));}
+ else try{process.kill(-processChild.pid,'SIGKILL');}catch{processChild.kill('SIGKILL');}
+}
+function stopChild(){
+ if(!child||childStopping)return;childStopping=true;
+ if(child.connected)try{child.send({type:'stop'},()=>{});}catch{}
+ forceTimer=setTimeout(()=>{if(child)killTree(child);},10000);
+}
+function stop(){if(stopping)return;stopping=true;clearTimeout(restartTimer);if(child)stopChild();else process.exit(0);}
+process.on('message',message=>{if(message?.type==='stop')stop();});
+if(process.connected)process.on('disconnect',stop);
+for(const signal of ['SIGTERM','SIGINT','SIGHUP'])process.on(signal,stop);
+const watch=setInterval(()=>{
+ if(fs.existsSync(flag))return stop();
+ if(!child||childStopping)return;
+ let timestamp=childStarted;
+ try{const heartbeat=JSON.parse(fs.readFileSync(path.join(root,'heartbeat.json'),'utf8'));if(heartbeat.pid===child.pid&&Number.isFinite(heartbeat.time))timestamp=heartbeat.time;}catch{}
+ if(Date.now()-timestamp>90000)stopChild();
+},1000);watch.unref();
+function start(){
+ if(stopping||fs.existsSync(flag))return stop();
+ childStarted=Date.now();childStopping=false;
+ child=fork(launch.agent,[launch.config],{execPath:process.execPath,cwd:root,detached:process.platform!=='win32',stdio:['ignore','ignore','ignore','ipc']});
+ child.on('error',()=>{});
+ child.once('exit',()=>{clearTimeout(forceTimer);if(process.platform!=='win32')try{process.kill(-child.pid,'SIGKILL');}catch{}child=null;if(stopping)process.exit(0);restartTimer=setTimeout(start,10000);});
+}
+start();

package/dist/client/start.sh

@@ -0,0 +1,3 @@
+#!/bin/sh
+SOURCE=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+exec /bin/sh "$SOURCE/launch.sh" start "$@"

package/dist/client/startup.mjs

@@ -0,0 +1,60 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import {spawn} from 'node:child_process';
+import {run,startupFile,removeStartup,stopClient,livePid} from './lifecycle.mjs';
+export const shellQuote=value=>"'"+String(value).replace(/'/g,"'\\''")+"'";
+export const powershellQuote=value=>"'"+String(value).replace(/'/g,"''")+"'";
+const xml=s=>String(s).replace(/[&<>"']/g,c=>({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&apos;'}[c]));
+const desktopQuote=s=>'"'+String(s).replace(/(["\\`$])/g,'\\$1').replace(/%/g,'%%')+'"';
+export function commandFor(node,root,action,platform=process.platform) {
+ const argv=[node,path.join(root,'control.mjs'),...action.split(' ')];
+ return platform==='win32'?'& '+argv.map(powershellQuote).join(' '):argv.map(shellQuote).join(' ');
+}
+export function startupContent(node,root,platform=process.platform) {
+ if(platform==='darwin')return `<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict><key>Label</key><string>de.desktopbridge.agent</string><key>ProgramArguments</key><array>${[node,path.join(root,'runner.mjs'),root].map(s=>'<string>'+xml(s)+'</string>').join('')}</array><key>RunAtLoad</key><true/><key>KeepAlive</key><dict><key>SuccessfulExit</key><false/></dict><key>WorkingDirectory</key><string>${xml(root)}</string></dict></plist>`;
+ if(platform==='linux')return `[Desktop Entry]\nType=Application\nName=Desktop Bridge\nExec=${[node,path.join(root,'runner.mjs'),root].map(desktopQuote).join(' ')}\nTerminal=false\nX-GNOME-Autostart-enabled=true\n`;
+ throw new Error('Use the Windows startup shortcut helper.');
+}
+export async function registerStartup(node,root) {
+ const file=startupFile(root);fs.mkdirSync(path.dirname(file),{recursive:true});
+ if(process.platform==='win32'){
+  const ps=powershellQuote;
+  // Target Node directly. Routing through cmd.exe would expand % and ! in paths.
+  const quote=value=>'"'+value.replace(/(\\*)"/g,'$1$1\\"').replace(/(\\+)$/,'$1$1')+'"';
+  const argv=[path.join(root,'runner.mjs'),root].map(quote).join(' ');
+  await run('powershell.exe',['-NoProfile','-NonInteractive','-Command',`$s=(New-Object -ComObject WScript.Shell).CreateShortcut(${ps(file)});$s.TargetPath=${ps(node)};$s.Arguments=${ps(argv)};$s.WorkingDirectory=${ps(root)};$s.WindowStyle=7;$s.Save()`]);
+ }else{
+  fs.writeFileSync(file,startupContent(node,root));
+  if(process.platform==='darwin'){
+   try{await run('launchctl',['bootout','gui/'+process.getuid(),file],{stdio:'ignore'});}catch{}
+   try{await run('launchctl',['bootstrap','gui/'+process.getuid(),file],{stdio:'ignore'});}catch{console.log('登录自启设置已保存，下次登录图形界面时生效。');}
+  }
+ }
+}
+export function writeInstructions(root,node,mode,privilege='standard') {
+ const contents=`Desktop Bridge 0.2.6 使用说明\n\n权限：${privilege==='administrator'?'管理员（操作将由系统提示授权；后台使用受保护系统服务）':'当前用户'}\n当前模式：${mode==='manual'?'手动 manual':'后台 background'}\n${mode==='manual'?'使用时运行启动命令，保持窗口，按 Ctrl+C 或关闭窗口结束。客户端与本地工具进程会一起停止。未设置登录自启。':'客户端现在后台运行，登录系统后自动启动。这是当前用户登录后自启，不是登录前的系统服务。'}\n\n${process.platform==='win32'?'请将以下命令复制到 PowerShell。':'请将以下命令复制到终端。'}\n\n启动：\n${commandFor(node,root,'start')}\n\n停止：\n${commandFor(node,root,'stop')}\n\n状态：\n${commandFor(node,root,'status')}\n\n切换为手动模式（停止后台实例，移除登录自启）：\n${commandFor(node,root,'mode manual')}\n\n切换为后台模式（现在启动，登录系统后自动启动）：\n${commandFor(node,root,'mode background')}\n\n本目录中的快捷入口：${process.platform==='win32'?'Start.cmd / Stop.cmd':process.platform==='darwin'?'Start.command / Stop.command':'start.sh / stop.sh'}。\n启动、停止和切换模式使用已安装的私有环境，不会重新安装依赖。\n\n重新配对（旧 Token 失效时）：\n${commandFor(node,root,'pair')}\n${process.platform==='win32'?'或双击 RePair.cmd。':'在终端执行上述命令。'}\n配对必须由用户在网页重新确认。\n如果出现 authStatus=re_pair_required，请先重新配对。\n\n请保留本目录，其中保存设备凭据、日志与可恢复的任务结果。停止不会删除这些数据。\n`;
+ fs.writeFileSync(path.join(root,'START-HERE.txt'),contents+(privilege==='administrator'?'\n管理员模式下，普通用户不能修改后台程序文件。系统隐私、Google 登录与 ChatGPT 工具确认仍需分别授权。\n':''),{mode:0o600});
+}
+export async function startBackground(root,node) {
+ let auth={};try{auth=JSON.parse(fs.readFileSync(path.join(root,'auth-status.json'),'utf8'));}catch{}
+ if(auth.authStatus==='re_pair_required')throw new Error('设备需要重新配对。请先执行 RePair.cmd 或 control.mjs pair。');
+ if(livePid(path.join(root,'runner-lock','pid'))){console.log('Client is already running.');return;}
+ fs.rmSync(path.join(root,'maintenance.flag'),{force:true});
+ const child=spawn(node,[path.join(root,'runner.mjs'),root],{detached:true,stdio:'ignore'});
+ await new Promise((resolve,reject)=>{child.once('spawn',resolve);child.once('error',reject);});child.unref();
+}
+export async function setMode(root,node,mode) {
+ if(!['manual','background'].includes(mode))throw new Error('Mode must be manual or background');
+ await stopClient(root);
+ await removeStartup(root);
+ const settings={mode,version:'0.2.6'};
+ fs.writeFileSync(path.join(root,'client-settings.json.tmp'),JSON.stringify(settings,null,2),{mode:0o600});
+ fs.renameSync(path.join(root,'client-settings.json.tmp'),path.join(root,'client-settings.json'));
+ writeInstructions(root,node,mode);
+ if(mode==='background'){
+   await registerStartup(node,root);
+   let auth={};try{auth=JSON.parse(fs.readFileSync(path.join(root,'auth-status.json'),'utf8'));}catch{}
+   if(auth.authStatus!=='re_pair_required')await startBackground(root,node);
+   else console.log('启动模式已保存，但授权已撤销。请先运行 RePair.cmd 重新配对。');
+ }
+}

package/dist/client/stop.sh

@@ -0,0 +1,3 @@
+#!/bin/sh
+SOURCE=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+exec /bin/sh "$SOURCE/launch.sh" stop "$@"

package/dist/client/uninstall.ps1

@@ -0,0 +1,6 @@
+param([switch]$Purge,[string]$DataDirectory)
+$ErrorActionPreference = 'Stop'
+$argsForInstaller = @{'Uninstall'=$true}
+if ($Purge) { $argsForInstaller['Purge']=$true }
+if ($DataDirectory) { $argsForInstaller['DataDirectory']=$DataDirectory }
+& (Join-Path $PSScriptRoot 'install.ps1') @argsForInstaller

package/package.json

@@ -1,6 +1,28 @@
-{
-  "name": "@justlovepl/desktop-bridge",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+  "name": "@justlovepl/desktop-bridge",
+  "version": "0.2.6",
+  "description": "Cross-platform Desktop Bridge agent installer and lifecycle CLI",
+  "type": "module",
+  "license": "MIT",
+  "homepage": "https://mcp.ilovestudy.de/start.html",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bb-boy/desktop-bridge.git",
+    "directory": "npm-installer"
+  },
+  "bin": {
+    "desktop-bridge": "./bin/desktop-bridge.mjs"
+  },
+  "files": ["bin/", "dist/", "README.md", "THIRD_PARTY_NOTICES.md"],
+  "engines": {
+    "node": ">=24 <25"
+  },
+  "scripts": {
+    "prepack": "node scripts/stage-client.mjs",
+    "test": "node --test test/*.test.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": ["desktop-bridge", "mcp", "remote-desktop", "agent", "command-line"]
+}