Skip to content

[feat] desktop: add a bundled application and collapsible sidebar - #397

Open
FayeSpica wants to merge 3 commits into
ThinkFlowLab:mainfrom
FayeSpica:feat/desktop-host
Open

FayeSpica wants to merge 3 commits into
ThinkFlowLab:mainfrom
FayeSpica:feat/desktop-host

Conversation

@FayeSpica

@FayeSpica FayeSpica commented Nov 18, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Add an Electron application with bundled Python, FFmpeg and Agent runtime, reusing the existing Web UI and project services. The shell owns an authenticated dynamic-port Host, preserves work when the window is hidden, and checks active tasks before quitting.

On macOS, integrate window controls into the toolbar and add a collapsible native-vibrancy project sidebar. The new-project action appears in the sidebar when expanded and beside the sidebar toggle when collapsed. Include terminal-command installation, bilingual UI and build documentation.

For macOS arm64, the release workflow builds an unsigned DMG, smoke-tests the app from the mounted disk image, and attaches the DMG and its SHA-256 checksum to a draft GitHub release. It runs on version tags or by manual dispatch.

Linked issue

Refs #363. Developer ID signing, notarization, and updates remain separate work.

Labels

  • type:feat, area:desktop, area:ci

Test plan

Reproduction commands
  • Frontend: npm test
  • Python API: PYTHONPATH=packages/core/src:apps/api/src python -m pytest tests/test_desktop_host.py tests/test_creation_api.py -q
  • Desktop shell and packaged Host: OPENDIRECTOR_DESKTOP_RUNTIME="$PWD/apps/desktop/runtime" npm test --prefix apps/desktop
  • Build: npm run build
  • Bilingual strings: npm run check:i18n
  • Release workflow: actionlint .github/workflows/desktop-release.yml
  • PR static checks: uvx --from pre-commit==4.5.1 pre-commit run --from-ref upstream/main --to-ref HEAD
  • Packaged UI: node apps/desktop/scripts/smoke.mjs apps/desktop/build/mac-arm64/OpenDirector.app/Contents/MacOS/OpenDirector

Prepare the bundled runtime and application using docs/development/desktop.md before packaged checks.

Test result

Validation of ae2e3d3c on macOS arm64:

  • Frontend: 833 passed.
  • Python API: 17 passed.
  • Desktop shell and packaged Host: 7 passed, including real bundled-Python startup, authentication, EOF shutdown and owned-session cleanup.
  • Build: passed.
  • Bilingual strings: 3,035 keys, no issues.
  • Release workflow: actionlint passed for b58ae368. The GitHub Actions release run is pending.
  • PR static checks: passed for ae2e3d3c.
  • Packaged UI: failed at fullscreen synchronization; the native window did not enter fullscreen. Sidebar states were inspected, but the complete smoke check is not passing.

Keep this PR draft. Clean-machine Agent-assisted creation, editing, export, recovery and other platforms remain unverified. Developer ID signing and notarization are not configured; current builds are not ready for public distribution.

Evidence that it works

English desktop screenshots from a local build.

App
image

Sidebar collapsed

Sidebar collapsed

Sidebar expanded

Sidebar expanded

Provider verification

  • No real-provider verification is claimed.

Bilingual UI

  • New UI and native-menu text includes zh-CN and en-US.

Signed-off-by: Weiming Liao <liaowm5@gmail.com>
@FayeSpica FayeSpica added type:feat New capability or behaviour area:ci Continuous integration and checks area:desktop Desktop integration / 桌面集成 labels Nov 18, 2026
Comment thread apps/desktop/src/command.mjs Fixed
Signed-off-by: Weiming Liao <liaowm5@gmail.com>
@FayeSpica
FayeSpica marked this pull request as ready for review November 18, 2026 11:45
Signed-off-by: Weiming Liao <liaowm5@gmail.com>
@github-actions github-actions Bot added area:docs Documentation / 文档 area:timeline Timeline, subtitles and export labels Nov 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:ci Continuous integration and checks area:desktop Desktop integration / 桌面集成 area:docs Documentation / 文档 area:timeline Timeline, subtitles and export type:feat New capability or behaviour

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants