🔄 Sync from private repository - 2026-03-09 09:44:38

Author: github-actions[bot]

API.en.md

@@ -1373,6 +1373,20 @@ Open app settings page
 
 ---
 
+### `app.restartDaemon`
+
+![Not Supported](https://img.shields.io/badge/Trigger-None-red)
+
+**Signature:** `restartDaemon()`
+
+Restart the TrollScript HUD daemon process
+
+**Returns:** `boolean`
+
+*Whether the restart request was issued successfully*
+
+---
+
 ### `app.list`
 
 ![Full Support](https://img.shields.io/badge/Trigger-Full-brightgreen)

API.md

@@ -1372,6 +1372,20 @@ Ping 主机
 
 ---
 
+### `app.restartDaemon`
+
+![Not Supported](https://img.shields.io/badge/Trigger-None-red)
+
+**Signature:** `restartDaemon()`
+
+重启 TrollScript HUD Daemon 进程
+
+**Returns:** `boolean`
+
+*是否成功发起重启请求*
+
+---
+
 ### `app.list`
 
 ![Full Support](https://img.shields.io/badge/Trigger-Full-brightgreen)

TrollScript-Private

@@ -1 +1 @@
-Subproject commit 8d62064482a141a19ebf5cdda034c2785bfaa973
+Subproject commit b5ff5d6fc3621149e3fc469bd29b953d96b08b34

npm/index.d.ts

@@ -584,6 +584,12 @@ interface App {
      */
     openSettings(): boolean;
 
+    /**
+     * 重启 TrollScript HUD Daemon 进程
+     * @returns 是否成功发起重启请求
+     */
+    restartDaemon(): boolean;
+
     /**
      * 获取所有已安装应用列表 (TrollStore 权限)
      * @returns 应用信息数组，包含 bundleIdentifier, name, version, type 等字段

templates/API/App.md

@@ -12,6 +12,7 @@ App 模块提供了应用相关的操作功能，包括获取应用信息、打
 - [API 参考](#api-参考)
   - [应用信息](#应用信息)
   - [URL 操作](#url-操作)
+  - [Daemon 控制](#daemon-控制)
   - [日志管理](#日志管理)
   - [崩溃报告](#崩溃报告)
   - [性能监控](#性能监控)
@@ -83,6 +84,47 @@ app.open('shortcuts://run-shortcut?name=MyShortcut');
 
 ---
 
+### Daemon 控制
+
+#### `app.restartDaemon()`
+重启 TrollScript HUD Daemon 进程。**返回:** `boolean`
+
+```javascript
+const ok = app.restartDaemon();
+console.log(`重启请求: ${ok ? '已发送' : '失败'}`);
+```
+
+> 说明:
+> - 这是一个 **App 侧能力**，用于请求重启 TrollScript 的 HUD/Daemon 进程。
+> - 该方法会确保 `schedulerEnabled = true` 后再发起重启流程。
+> - 适合在脚本里做“自恢复”或更新后重启守护进程。
+
+```javascript
+// 示例：重启 Daemon 后等待恢复
+function restartDaemonAndWait() {
+  console.log('准备重启 Daemon...');
+
+  const requested = app.restartDaemon();
+  if (!requested) {
+    console.error('重启请求发送失败');
+    return false;
+  }
+
+  console.log('重启请求已发送，等待守护进程恢复...');
+
+  // 简单等待 watchdog / daemon 拉起
+  setTimeout(() => {
+    console.log('Daemon 应该已经开始恢复，可继续后续逻辑');
+  }, 2000);
+
+  return true;
+}
+
+restartDaemonAndWait();
+```
+
+---
+
 ### 用户交互
 
 #### `app.vibrate()`

templates/API/Location.md

@@ -36,6 +36,9 @@ console.log(results[0]);
 #### `location.requestAccess()`
 请求定位权限。**返回:** `void`
 
+#### `location.requestAccessAsync()`
+异步请求定位权限。**返回:** `Promise<void>`
+
 #### `location.getAccessStatus()`
 获取权限状态。**返回:** `'authorized'` | `'denied'` | `'restricted'` | `'notDetermined'` | `'unknown'`
 
@@ -57,18 +60,27 @@ console.log(results[0]);
 
 **注意:** 需要 TrollStore 权限
 
+#### `location.setLocationServicesEnabledAsync(enabled)`
+异步开关系统定位服务。**参数:** `enabled` (boolean) **返回:** `Promise<{ success, enabled?, message? }>`
+
 #### `location.toggleLocationServices()`
 切换定位服务状态。**返回:** `{ success, enabled?, message? }`
 
 **注意:** 需要 TrollStore 权限
 
+#### `location.toggleLocationServicesAsync()`
+异步切换定位服务状态。**返回:** `Promise<{ success, enabled?, message? }>`
+
 ---
 
 ### 位置获取
 
 #### `location.getCurrent()`
 获取当前位置。**返回:** `{ lat, lng, alt, course, speed, accuracy, timestamp } | null`
 
+#### `location.getCurrentAsync()`
+异步获取当前位置。**返回:** `Promise<{ lat, lng, alt, course, speed, accuracy, timestamp } | null>`
+
 **返回值字段:**
 - `lat` - 纬度
 - `lng` - 经度
@@ -107,6 +119,9 @@ if (results.length > 0) {
 }
 ```
 
+#### `location.geocodeAsync(address)`
+异步地址转坐标。**参数:** `address` (string) **返回:** `Promise<[{ lat, lng, name }]>`
+
 #### `location.reverseGeocode(lat, lng, locale?)`
 坐标转地址。**参数:** `lat` (number), `lng` (number), `locale` (string, 可选) **返回:** `[{ name, country, locality, ... }]`
 
@@ -133,6 +148,9 @@ const enResults = location.reverseGeocode(39.9, 116.4, 'en_US');
 const zhResults = location.reverseGeocode(39.9, 116.4, 'zh_CN');
 ```
 
+#### `location.reverseGeocodeAsync(lat, lng, locale?)`
+异步坐标转地址。**参数:** `lat` (number), `lng` (number), `locale` (string, 可选) **返回:** `Promise<[{ name, country, locality, ... }]>`
+
 ---
 
 ## 完整示例