如何基于 AnyDesk 接口定制专属远程助手？开发者 API 调优与插件开发避坑指南

+-----------------------------------------------------------------------+
|                       AnyDesk 开发者集成架构                           |
+-----------------------------------------------------------------------+
| 1. REST API (my.anydesk)   --> 账号/资产管理、会话历史、Address Book 审计 |
| 2. CLI 命令 (Command Line) --> 本地静默拉起、密码注入、系统参数配置    |
| 3. Custom Client (Builds)  --> 定制客户端 UI、UI锁死、策略与权限预设     |
+-----------------------------------------------------------------------+

import time
import hmac
import hashlib
import requests

class AnyDeskAdminClient:
    def __init__(self, license_id: str, api_password: str):
        self.license_id = license_id
        self.api_password = api_password
        self.base_url = "https://v1.api.anydesk.com"

    def _generate_auth_header(self) -> dict:
        timestamp = str(int(time.time()))
        # 拼接签名原串
        sign_base = f"{self.license_id}:{timestamp}:{self.api_password}"
        
        # 计算 HMAC-SHA1
        signature = hmac.new(
            self.api_password.encode('utf-8'),
            sign_base.encode('utf-8'),
            hashlib.sha1
        ).hexdigest()

        return {
            "Authorization": f"AnyDesk {self.license_id}:{timestamp}:{signature}",
            "Content-Type": "application/json"
        }

    def get_online_clients(self):
        """拉取账号下所有客户端状态"""
        headers = self._generate_auth_header()
        resp = requests.get(f"{self.base_url}/clients", headers=headers, timeout=8)
        if resp.status_code == 200:
            return resp.json()
        raise Exception(f"API Error {resp.status_code}: {resp.text}")

# 增量拉取上一次同步之后的数据
params = {"from": last_synced_timestamp}
resp = requests.get(f"{self.base_url}/sessions", headers=headers, params=params)

:: 通过管道直接注入自主访问密码
echo YOUR_TARGET_PASSWORD | "C:\Program Files (x86)\AnyDesk\AnyDesk.exe" 987654321 --with-password

[ ] 1. 密钥与鉴权安全
    [ ] API Password 与 Client Key 绝对未硬编码在前端（React/Vue/Electron）代码中。
    [ ] REST API 请求全量走后端 Server 代理中转与签名。

[ ] 2. 进程管理与清理
    [ ] 助手调起 AnyDesk 进程后，建立了 Process Watchdog（进程看门狗）。
    [ ] 远程会话结束后，助手自动清理了内存及注册表中留存的临时 Token。

[ ] 3. 性能与限流保护
    [ ] 后端已部署 Redis 缓存，防止频繁请求 AnyDesk /clients 接口导致 429。
    [ ] 大批量拉取 Session History 时使用了增量时间戳（from/to）。

[ ] 4. 客户端安全防护
    [ ] Custom Build 已禁用 Settings（设置界面被锁死）。
    [ ] 预设了 ACL (Access Control List)，仅允许企业内部指定 AnyDesk ID 进行连接。