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 | Implementation and status |
|---|---|---|---|
| D1 · Desktop application | #363 | Shared foundation | #397 merged; packaged Agent creation/edit/export/reopen acceptance on clean environments remains |
| D2 · macOS distribution | #364 | #363 | #397 merged; v0.1.5 Apple Silicon ad-hoc DMG published; notarization and full installation/upgrade acceptance remain |
| D3 · Windows distribution | #365 | #363 | #397 merged; v0.1.5 unsigned x64 installer published; signing and full clean-machine workflow/upgrade acceptance remain |
| D4 · Linux distribution | #366 | #363 | Open; no Linux installer in v0.1.5 |
| D5 · Automatic updates | #367 | #363; installer integration with #364, #365, #366 | Open; not delivered by #397 |
| D6 · Download landing page | #369 | Website #368; installers #364, #365, #366 | #413 merged; Pages deployed with v0.1.5 macOS/Windows links; post-release download acceptance pending |
Activity
Add downloadable OpenDirector desktop app for Windows