Repository navigation
Description
Goal and scope
Deliver an installable OpenDirector desktop client for Windows, macOS and Linux under roadmap #265. Users can install, create/edit a project, export, reopen and update without preparing a development environment. Coordinate HarmonyOS delivery with existing #252.
Design
Use an Electron shell as the proposed baseline, reusing the existing Web UI and shared Python business services. Bundle the Python environment, FFmpeg and required built-in Agent runtime. Manage backend readiness, authenticated loopback connections, failures and shutdown from the desktop application.
Keep application resources separate from projects, credentials, logs and caches. Desktop and CLI share project identity, locking and revision rules. Restrict native capabilities to validated IPC operations and isolated renderers.
Reference DeepSeek Harness Desktop for shell/Host lifecycle and distribution patterns. Adapt them to OpenDirector's Python and media dependencies.
Delivery
Create six work items for the desktop application, macOS distribution, Windows distribution, Linux distribution automatic updates and the download landing page. Platform packages depend on the shared application; update coordination integrates with each platform installer.
Each task owns its relevant build checks and acceptance evidence. Coordinate Agent lifecycle with #261 and release gates with #273.
Acceptance criteria
- Declare tested OS versions, architectures and Linux distributions, plus package formats, bundled runtime versions and signing status.
- On each supported clean environment, install → create a project → run an Agent-assisted workflow → edit → export → reopen → update.
- Preserve projects and credentials during updates and the documented uninstall flow; handle startup failure, running-task interruption and update failure with actionable messages.
- Verify Chinese and English UI, file operations and diagnostics.
- State client participation required by export and background tasks.
Decisions to confirm
Initial OS/architecture matrix, Linux package format, signing credentials and update hosting/channel policy.
Work items
| Task | Issue | Dependencies |
|---|---|---|
| D1 · Desktop application | #363 | Shared foundation |
| D2 · macOS distribution | #364 | #363 |
| D3 · Windows distribution | #365 | #363 |
| D4 · Linux distribution | #366 | #363 |
| D5 · Automatic updates | #367 | #363; installer integration with #364, #365, #366 |
| D6 · Download landing page | #369 | Website #368; installers #364, #365, #366 |
Activity
Add downloadable OpenDirector desktop app for Windows