How mini-yifan/deepseek-harness-orb works
DeepSeek Orb is a desktop AI assistant with two distinct task tracks: visible Computer Use in a floating ball and background coding sessions. The main window provides the broader dsh interface for sessions, plugins, and model settings; selection tools and platform services extend the desktop experience. The README establishes the user-facing workflow and capabilities. Source excerpts are limited, so internal links are included only where the index or excerpts show a relationship; other documented product branches are left unconnected where their wiring is not shown.
Main entry points: manager.ts Background sessions · route.ts Computer Use · floating-window.ts Floating ball · main.ts Main Web UI
Components 19
Desktop shell
- Desktop entry
apps/desktop/src/main.ts - Floating ball
apps/desktop/src/floating-window.ts - Main Web UI
apps/web/src/main.ts - Desktop IPC
apps/desktop/src/ipc.ts - Desktop Host services
apps/desktop-host/src/desktop-plugin-services.ts - Update coordinator
apps/desktop/src/update-coordinator.ts
Agent tracks
- Computer Use
packages/experimental/tool-computer-use/src/route.ts - Background sessions
packages/api/session-controller/src/client/sessions/manager.ts
Sessions and settings
- Session lifecycle
packages/api/session-controller/src/client/sessions/session.ts - Session service
packages/api/session-controller/src/client/sessions/service.ts - Session projections
packages/api/session-controller/src/client/sessions/projection-store.ts - Session notifier
packages/api/session-controller/src/client/sessions/notifier.ts - Session persistence
packages/session/session-persistence-jsonl/src/storage.ts - Plugin manager UI
packages/client/ui-plugin-manager/src/client/PluginManagerPage.tsx - Subagent model settings
packages/client/ui-settings-subagent/src/client/subagent-model-selection-card-controller.ts
Desktop interactions
- Selection toolbar
apps/desktop/src/selection-toolbar-controller.ts - Selection monitor
apps/desktop/src/selection-monitor.ts - Observation window
apps/desktop/src/observation-frame-window.ts
Other components
- User
Connections 19
- User → Floating ball: sends task
README.md - Floating ball → Computer Use: runs foreground
README.md - Computer Use → Desktop Host services: uses desktop tools
- Computer Use → Background sessions: dispatches complex work
README.md - Background sessions → Floating ball: returns completion
README.md - User → Main Web UI: opens main window
README.md - Main Web UI → Plugin manager UI: manages plugins
README.md - Main Web UI → Subagent model settings: configures models
README.md - Background sessions → Session lifecycle: manages instances
packages/api/session-controller/src/client/sessions/manager.ts - Background sessions → Session service: uses service
packages/api/session-controller/src/client/sessions/manager.ts - Background sessions → Session projections: loads projections
packages/api/session-controller/src/client/sessions/manager.ts - Session projections → Session notifier: marks dirty
packages/api/session-controller/src/client/sessions/projection-store.ts - Session lifecycle → Session persistence: stores history
- User → Selection toolbar: selects text
README.md - Selection toolbar → Selection monitor: starts monitor
apps/desktop/src/selection-toolbar-controller.ts - Selection toolbar → Floating ball: prompts overlay
apps/desktop/src/selection-toolbar-controller.ts - Desktop entry → Desktop IPC: configures IPC
- Desktop entry → Update coordinator: coordinates updates
- Computer Use → Observation window: observes screen