mirror of
https://github.com/UNITRONIX/BetterDesk.git
synced 2026-09-10 17:45:42 +00:00
dd0889e3d6
Introduce a SessionManager for relay-based remote sessions in the Tauri MGMT client: new SessionCommand API, start/stop/session input routing, clipboard/recording/quality controls, and notification read/dismiss state. Wire AppState with new mutexes and show main window on startup. CI: add SBOM generation (anchore) and Trivy vulnerability scan steps. Misc: change console Docker DB path, large README/CHANGELOG updates (chat E2E, unattended access/WOL, i18n expansion, CDAP/SDK docs), and many web-nodejs assets/locales/routes/views/services and server-side changes.
2.3 KiB
2.3 KiB
CDAP SDK Studio Guide
Status: The SDK Studio visual builder is planned for Phase 14 of the BetterDesk 3.0 roadmap. This document describes the intended feature set and workflow.
Overview
CDAP SDK Studio is a browser-based visual tool for creating CDAP agents and bridges without writing code. It generates ready-to-deploy Python or Node.js projects.
Planned Features
Widget Designer
- Drag-and-drop widget palette (8 widget types)
- Visual property editor (label, group, unit, thresholds)
- Live preview of widget rendering
- Widget grouping and layout
Capability Builder
- Toggle available capabilities (telemetry, commands, terminal, file_transfer, clipboard, audio)
- Per-capability configuration forms
- Dependency warnings (e.g., terminal requires shell access)
Command Editor
- Define custom commands with parameters
- Set confirmation requirements and cooldown periods
- Map commands to widget interactions (button → command)
Code Generator
- Generates complete project structure (Python or Node.js)
- Includes: main script, config.json, requirements.txt / package.json, systemd unit / NSSM script
- Download as ZIP or push directly to Git repository
- Code is fully editable after generation
Test Sandbox
- Connect generated agent to a test CDAP gateway
- Simulate widget state updates
- Send test commands and verify responses
- View message log in real time
Workflow
- Create — Open Studio, name the agent, pick language
- Design — Add widgets, configure capabilities, define commands
- Preview — See live widget rendering in browser
- Generate — Download project ZIP
- Deploy — Run agent on target machine, verify in panel
File Structure (Generated Python Project)
my-agent/
├── main.py # Agent entry point
├── config.json # Server URL, device ID, API key
├── requirements.txt # betterdesk-cdap + dependencies
└── install.sh # systemd service installer
File Structure (Generated Node.js Project)
my-agent/
├── index.js # Agent entry point
├── config.json # Server URL, device ID, API key
├── package.json # betterdesk-cdap + dependencies
└── install.ps1 # NSSM service installer (Windows)