dsh-alpha
主控 agent 统一编排：dsh 插件形式的多机多 agent 指挥层
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:songofhawk/dsh-alpha#9d39b0328f9ee53c201610dac65e852e5c64237a
Alpha 以 dsh-alpha 发布，当前版本为 0.2.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
正在加载相关插件…
English | 简体中文 · Live site · Architecture
A control plane for dispatching coding work across machines and agent runtimes from one DSH conversation.
The demo uses an isolated environment. Machine, workspace, and path information is redacted.
The square launch film on the project site was rendered locally with the open-source HyperFrames framework.
Coding agents are useful on their own, but real work quickly spreads across laptops, build hosts, GPU machines, and repositories that live at different paths. dsh-alpha adds the missing control plane:
dsh-alpha is a plugin for DSH (DeepSeek Harness). It coordinates existing provider CLIs; it does not replace their installation, authentication, or security controls.
DSH Web / headless master
├─ global workspace inventory
├─ agent capability and load catalog
├─ task / approval / recovery state
└─ reverse WebSocket gateway
├─ Worker A → Codex / Claude Code
├─ Worker B → Kimi Code / ZCode
└─ Worker C → OpenCode / Qoder / WorkBuddy
Workers connect outward to the master, so they do not need public IP addresses. Repository identity is separated from machine-local paths, and execution remains constrained to each Worker's explicit allowed roots.
| Capability | What it changes |
|---|---|
| Global workspace inventory | One repository can be recognized across several machines and local paths. |
| Repository-aware scheduling | Prefer a Worker that already has the repository; clone on demand only inside an allowed root. |
| Per-turn Worker controls | Select Agent, model, reasoning effort, and permission mode without leaving the conversation. |
| Event-driven results | Dispatch once, wait on events, and resume with the same durable task ID after interruption. |
| Approval handoff | Worker approval requests return to the active Alpha session instead of hanging invisibly. |
| Reverse gateway | Workers connect to the master through authenticated WebSocket sessions and reconnect automatically. |
| Operational tooling | Web sidebar, headless runner, status CLI, Worker doctor, and multi-device acceptance checklist. |
0.1.0-rc.8 or newerdsh plugin)dsh --version
pnpm --version
dsh plugin --profile web add dsh-alpha
node ~/.dsh/profiles/web/node_modules/dsh-alpha/scripts/install-preset.mjs
dsh web
Open Alpha master from the Web sidebar, choose a workspace or keep automatic routing enabled, then start a conversation.
dsh plugin --profile alpha add dsh-alpha
node ~/.dsh/profiles/alpha/node_modules/dsh-alpha/scripts/install-alpha-profile.mjs
dsh --profile alpha "Use list_agents, dispatch a short task, and report the result."
The installer updates only the dsh-alpha managed block and preserves configuration outside it.
git clone https://github.com/songofhawk/dsh-alpha.git
cd dsh-alpha
npm install
npm run setup
npm test
Configure one token per Worker on the master:
export DSH_ALPHA_GATEWAY_HOST=0.0.0.0
export DSH_ALPHA_GATEWAY_PORT=4310
export DSH_ALPHA_GATEWAY_TOKENS='build-1:replace-with-a-long-random-token'
Install and start the Worker on the target machine:
npm install dsh-alpha
export DSH_ALPHA_HUB_URL='ws://<master>:4310/'
export DSH_ALPHA_WORKER_MACHINE_ID='build-1'
export DSH_ALPHA_WORKER_TOKEN='replace-with-a-long-random-token'
export DSH_ALPHA_WORKER_ALLOWED_ROOTS='/work'
./node_modules/.bin/dsh-alpha-worker-doctor
./node_modules/.bin/dsh-alpha-worker
Use wss:// and network-level source restrictions outside a trusted LAN or VPN. Keep tokens out of repositories, URLs, screenshots, and process logs.
The default set is Codex, Claude Code, and Kimi Code. Optional runtimes must be enabled explicitly.
| Provider ID | Runtime | Default |
|---|---|---|
codex | Codex app server / CLI | Enabled |
claude-code | Claude Code headless | Enabled |
kimi-code | Kimi ACP | Enabled |
zcode | Zhipu ZCode headless | Opt-in |
opencode | OpenCode ACP | Opt-in |
qoder | Qoder headless | Opt-in |
workbuddy | Tencent WorkBuddy via codebuddy | Opt-in |
Each runtime is installed and authenticated independently. mock exists for tests and local diagnostics only.
list_workspaces resolves the logical repository and its machine locations.list_agents exposes availability, capabilities, load, and workspace affinity.dispatch_task returns a durable taskId; wait_task follows the event stream without busy polling.agent_approve or agent_cancel resolves Worker approvals in the current Alpha session.task_status and task_result recover disconnected or historical work.The Web workspace selector can create a hard machine/workspace constraint. With no manual selection, the scheduler may choose a matching Worker and clone the Git workspace into its allowed root.
dsh-alpha status
dsh-alpha web
dsh-alpha run "summarize the current workspace"
dsh-alpha-worker-doctor
dsh-alpha-worker
npm test
Current public source version: 0.2.1. The repository covers local orchestration, reverse-gateway Workers, repository-aware scheduling, recursive masters, approval forwarding, global workspace selection, durable task recovery, and seven production runtime integrations.
Before upgrading a running installation, rerun the matching preset/profile installer and execute the acceptance checklist for every connected machine.