Skip to content

[RFC] desktop: Cross-platform client and bundled runtime #362

Open
0 of 6 issues completed
Open

Description

@FayeSpica

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:desktopDesktop integration / 桌面集成area:installInstall, startup and environment support

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions