Blog / Paseo + DeepSeek Harness

Orchestrating DeepSeek Harness (DSH) with Paseo: Inside the 100% Sovereign Multi-Agent Software Studio

AgDex Systems & Architecture Team November 2, 2026 15 min read Multi-Agent Architecture & Sovereign Studios
Orchestrating DeepSeek Harness (DSH) with Paseo: Inside the 100% Sovereign Multi-Agent Software Studio
Executive Technical Brief

Running autonomous coding agents in isolation is obsolete. This architectural deep-dive explores how combining Paseo’s local daemon and managed Git Worktrees with DeepSeek Harness’s (DSH) Cordis plugin runtime provides an open-source, 100% self-hosted multi-agent development studio. Learn how native Direct Provider communication unlocks streaming reasoning effort, interactive question cards, and 83.2% to 92.8% compute cost deflation (saving up to 95%+ against proprietary frontier flagships).

Table of Contents

1. The Terminal Bottleneck: Why Solo-Agent CLI Workflows Break at Scale

Throughout 2025 and 2026, autonomous software engineering agents powered by frontier foundation models—from Claude Code (powered by Claude Opus 5.5 and Sonnet 5.5) to OpenAI Operator / Codex (GPT 6.1 SOL), Google Antigravity (Gemini 4 Argon), Cursor, and Aider—reshaped developer workflows. However, as developers attempt to delegate entire sprints rather than single functions, a severe architectural bottleneck has emerged: the single-terminal, single-working-directory constraint.

When an engineer spins up multiple agent processes inside a single Git repository, file-system chaos ensues. Background build watchers crash, file changes stomp on uncommitted code, and concurrent Git operations trigger fatal .git/index.lock contention. While developers attempt to mitigate this by manually managing dozens of tmux panes and shell tabs, the mental burden of context switching and command approvals renders parallel development unmanageable.

Furthermore, proprietary cloud IDEs lock developers into closed ecosystems with steep per-seat licenses, mandatory telemetry, and opaque token markups. While proprietary frontier models like Claude opus 5.5, GPT 6.1 SOL, and Gemini 4 Argon provide powerful reasoning, executing continuous multi-agent loop sprints exclusively through commercial cloud endpoints rapidly becomes financially unsustainable. The industry demands an open, self-hosted, multi-agent control center that provides physical workspace isolation, multi-device accessibility, and deterministic tool execution without cloud dependency.

2. Paseo Architecture: Local-First Daemon & Managed Git Worktrees

Paseo (github.com/getpaseo/paseo) solves this coordination problem through a distributed, local-first control plane. At its core runs a lightweight TypeScript daemon that supervises agent lifecycles, manages process I/O, and exposes an end-to-end encrypted (E2EE) WebSocket relay for desktop (Electron), web, and mobile (Expo iOS/Android) clients. 

+─────────────────────────────────────────────────────────────────────────────────────────────────+
|               PASEO + DEEPSEEK HARNESS (DSH) MULTI-AGENT ARCHITECTURE                           |
+─────────────────────────────────────────────────────────────────────────────────────────────────+
|                                                                                                 |
|   [ CLIENT ACCESS MATRIX ]                                                                      |
|   • Desktop (Electron)      • Web Dashboard          • Mobile App (Expo / iOS / Android)        |
|                                       │ (E2EE WebSocket Relay)                                  |
|                                       ▼                                                         |
|   [ PASEO LOCAL CONTROL DAEMON ] (Node / TypeScript)                                            |
|   • Workspace Manager       • Process Supervisor     • Diff / Stream Review Engine              |
|                                       │                                                         |
|               ┌───────────────────────┼────────────────────────┐                                |
|               ▼                       ▼                        ▼                                |
|   [ WORKSPACE: feat/auth ]  [ WORKSPACE: feat/db ]  [ WORKSPACE: test/e2e ]                     |
|   • Worktree: slug-auth     • Worktree: slug-db      • Worktree: slug-tests                     |
|   • Branch: feature/auth    • Branch: feature/db     • Branch: test/e2e                         |
|   • Hook: paseo.json        • Hook: paseo.json       • Hook: paseo.json                         |
|               │                       │                        │                                |
|               ▼ (Direct Provider IPC) ▼ (Direct Provider IPC)  ▼ (Direct Provider IPC)          |
|   [ DEEPSEEK HARNESS (DSH) ] [ DEEPSEEK HARNESS (DSH) ] [ DEEPSEEK HARNESS (DSH) ]             |
|   • Preset: PTC (Reasoning) • Preset: Standard (CRUD) • Preset: Minimal (Test Suite)            |
|   • Cordis Plugin Kernel    • Cordis Plugin Kernel   • Cordis Plugin Kernel                     |
|   • Reversible Registers    • Reversible Registers   • Reversible Registers                     |
|                                                                                                 |
+─────────────────────────────────────────────────────────────────────────────────────────────────+

Instead of spinning up heavy virtual machines or running unisolated subshells, Paseo anchors workspace isolation around Managed Git Worktrees stored deterministically under $PASEO_HOME/worktrees/<hash>/<slug>/.

  • Automatic Branch Provisioning: Workspaces can branch off from origin/main or check out existing pull requests into a fully isolated directory sharing the common .git object database.
  • Automated Lifecycle Hooks: Through paseo.json, each worktree automatically triggers environment setup scripts (e.g., dependency installation, .env creation) and teardown routines upon archiving.
  • Zero VM Memory Overhead: Unlike Docker containers that consume 1.5GB to 3GB of RAM per instance, a Git Worktree incurs less than 50MB of disk delta and spins up in under 180 milliseconds.

This architecture enables a developer to run 3, 5, or 10 agents concurrently against the same codebase without risking index locking, file stomping, or memory exhaustion.

3. Inside DeepSeek Harness (DSH): The Cordis Plugin Kernel

While Paseo provides the orchestrator and workspace isolation, DeepSeek Harness (DSH) (@deepseek-ai/dsh) supplies the autonomous reasoning and tool execution engine. DeepSeek approaches agent design through the foundational principle: “Agent = Model + Harness”.

Traditional agent frameworks hardcode tool definitions and state loops into monolithic abstractions. In contrast, DeepSeek Harness is built on top of Cordis, an advanced meta-framework designed around spatiotemporal composability where everything is a plugin:

  • Model Adapters: Modular connectors interfacing with DeepSeek V4 Pro, Flash, or self-hosted vLLM/Ollama endpoints.
  • Agent Loops: Pluggable control loops governing planning, reflection, and iterative tool dispatch.
  • Tools & Skills: Dynamic toolsets covering AST parsing, filesystem modifications, Bash execution, and MCP interoperability.
  • Sessions & Storage: Append-only event logs guaranteeing strict auditability and zero state corruption across turns.

The defining engineering breakthrough of the Cordis kernel is Reversible Registrations. When a plugin or tool unmounts, all event listeners, prompt templates, and middleware hooks are automatically rolled back. This prevents ghost tools, context pollution, and zombie processes from accumulating across long-running tasks.

DSH packages these capabilities into four specialized presets: Standard (balanced general development), PTC (Program-Time Compute) (extended reasoning and deep architectural refactoring), Minimal (sandboxed low-token test loops), and Creator (rapid greenfield prototyping).

4. Direct Provider vs. ACP: The Communication Bridge

Connecting an external agent runtime into an orchestrator typically relies on the Agent Client Protocol (ACP). However, empirical testing reveals that ACP acts as a narrow bottleneck: it flattens streaming thought processes, strips structured interactive UI cards, and restricts runtime steering.

To overcome these limitations, the open-source community created paseo-dsh-direct (by Jecvay), a native Direct Provider bridge connecting DSH directly into Paseo's internal IPC channel:

  1. Real-Time Reasoning Effort Slider: Directly streams and visualizes DeepSeek V4’s internal chain-of-thought tokens without collapsing them into generic markdown strings.
  2. Interactive ask_user_question Cards: Renders structured choice cards and confirmation modals in Paseo’s UI, allowing developers to clarify ambiguous requirements with a single click.
  3. Build vs. Plan Pre-Flight Gate: Forces the agent to output a formal execution plan for developer approval before invoking destructive shell commands or deleting directories.
  4. In-Flight Mid-Turn Steering: Allows engineers to interrupt and redirect an agent mid-thought without tearing down the existing context window or restarting the session.

Additionally, paseo-dsh-direct provides native session persistence, allowing developers to import historical runs directly from ~/.dsh/sessions or replay previous debugging traces inside Paseo's diff visualizer.

5. Empirical Benchmarks: Hardware Footprint & The 90% Cost Deflation

To validate the operational efficiency of Paseo and DSH, we conducted a rigorous benchmark simulating an enterprise multi-agent sprint: refactoring a FastAPI microservice, upgrading Pydantic schemas, and authoring end-to-end integration tests across 4 concurrent agents. 

+─────────────────────────────────────────────────────────────────────────────────────────────────+
|            Table 1: Multi-Agent Concurrency & Isolation Benchmark (4 Concurrent Agents)         |
+──────────────────────────┬──────────────┬──────────────────┬──────────────┬─────────────────────+
| Concurrency Strategy     | Cold Latency | Resident RAM (4x)| Disk Delta   | Merge & Git Safety  |
+──────────────────────────┼──────────────┼──────────────────┼──────────────┼─────────────────────+
| Single Directory (Raw)   | Instant (0s) | ~220 MB          | 0 MB         | ❌ 100% Lock Fail   |
| Docker / MicroVM (e2b)   | 4.2s ~ 7.8s  | 7.4 GB ~ 12.0 GB | 4.8 GB       | ⚠️ Complex Remote   |
| Paseo Managed Worktree   | < 180 ms     | < 340 MB (Shared)| ~120 MB      | ✅ Native Clean PR  |
+──────────────────────────┴──────────────┴──────────────────┴──────────────┴─────────────────────+

As shown in Table 1, Paseo's Git Worktree isolation achieves a 23x faster startup latency and consumes 95% less RAM than containerized microVM alternatives while completely eliminating Git lock contention. 

+─────────────────────────────────────────────────────────────────────────────────────────────────+
|               Table 2: 3-Agent Parallel Sprint Financial ROI (4.5M Total Tokens)                |
+──────────────────────────┬───────────────┬────────────────┬───────────────┬─────────────────────+
| Model / Harness Setup    | Input Tokens  | Output Tokens  | Total Cost    | Effective Savings   |
+──────────────────────────┼───────────────┼────────────────┼───────────────┼─────────────────────+
| Claude Opus 5.5 (CLI)    | $14.00 (3.5M) | $20.00 (1.0M)  | $34.00        | Baseline (0%)       |
| DeepSeek V4 Pro via DSH  | $0.75 (3.5M)  | $4.95 (1.0M)   | $5.70         | 83.2% Reduction     |
| DeepSeek V4 Flash Hybrid | $0.35 (3.5M)  | $2.10 (1.0M)   | $2.45         | 92.8% Reduction     |
+──────────────────────────┴───────────────┴────────────────┴───────────────┴─────────────────────+

On the economics side (Table 2), running 4.5M tokens across multi-turn coding loops via Claude Opus 5.5 totals \$34.00 (or \$17.00 with Claude Sonnet 5.5, while escalating above \$120 on frontier reasoning flagships like GPT 6.1 SOL). By deploying DeepSeek V4 Pro via DSH with prompt caching, the total sprint cost drops to \$5.70—an immediate 83.2% cost reduction against Opus 5.5. When utilizing DeepSeek Flash for secondary test generation and boilerplate refactoring, total cost drops to \$2.45, achieving up to 92.8% savings (and over 97% savings compared to proprietary frontier cloud titans).

6. Step-by-Step Production Guide: A 3-Agent Parallel Sprint

Deploying a sovereign multi-agent studio requires minimal configuration. First, define project-level isolation hooks in paseo.json at your repository root: 

{
  "worktrees": {
    "root": "~/.paseo/worktrees"
  },
  "hooks": {
    "setup": "pnpm install && cp .env.example .env",
    "teardown": "pnpm test:clean"
  },
  "services": {
    "dev": {
      "command": "pnpm dev",
      "port": 3000,
      "proxy": true
    }
  }
}

With the configuration in place, launch three concurrent worktrees using the Paseo CLI: paseo workspace create --isolation worktree --mode branch-off --new-branch feat/auth --worktree-slug auth-service --base origin/main. Repeat for database migrations and test suites.

In the Paseo desktop UI, assign the PTC (Program-Time Compute) preset to the authentication agent for high-depth reasoning, while assigning Standard presets to the migration and test agents. As the agents work simultaneously in isolated directories, developers can monitor unified diffs on desktop or review pull requests remotely via the Expo mobile client.

7. Sovereign Studios & AgDex Indexation

The synthesis of Paseo, DeepSeek Harness, and paseo-dsh-direct demonstrates that the future of AI-assisted engineering does not belong to closed, proprietary cloud editors. Modular, self-hosted orchestration delivers superior speed, complete privacy, and unparalleled cost advantages:

  • Complete Data Sovereignty: Code, Git histories, and credentials never leave your local infrastructure or enterprise VPC.
  • Model Interchangeability: Seamlessly switch between frontier cloud APIs (Claude opus 5.5, GPT 6.1 SOL, Gemini 4 Argon) and offline local models without changing editor interfaces.
  • Zero SaaS Lock-In: Eliminate recurring monthly IDE seat taxes while scaling developer concurrency arbitrarily.

The AgDex.ai Directory indexes this complete software stack alongside our interactive 3-Step Stack Finder, providing verified starter templates, telemetry benchmarks, and architecture comparisons for engineering tools like Claude Code and DeepSeek to empower software teams deploying sovereign multi-agent swarms.

References & Verified Open-Source Repositories

All tools and plugins referenced in this architectural retrospective are open-source and publicly verifiable:

• Paseo Orchestration Platform: github.com/getpaseo/paseo (Official Site: paseo.sh)
• DeepSeek Harness (DSH): github.com/deepseek-ai/deepseek-harness (npm: @deepseek-ai/dsh)
• Direct Provider Plugin (Jecvay): github.com/Jecvay/paseo-dsh-direct
• Cordis Plugin Kernel: cordis.moe

Frequently Asked Questions (FAQ)

Q1: How do Git Worktrees in Paseo compare to Docker containers for agent isolation?

Git Worktrees create lightweight physical directories sharing the underlying .git database without virtualization. They spin up in under 180ms, consume zero extra RAM, and allow instant local branch switching, whereas Docker containers require gigabytes of base images and complex volume mounting.

Q2: Why use paseo-dsh-direct instead of the generic Agent Client Protocol (ACP)?

Generic ACP strips advanced provider-specific controls. paseo-dsh-direct provides native IPC access to DeepSeek V4’s real-time streaming reasoning slider, interactive question cards with clickable UI choices, and build-vs-plan pre-flight execution approvals.

Q3: Can I run this multi-agent setup completely offline without cloud APIs?

Yes. Both Paseo and DeepSeek Harness are 100% self-hosted. By pairing DSH with local LLM runners like vLLM or Ollama serving quantized DeepSeek or Qwen coder models, you can run an entirely air-gapped, zero-cost development studio.

Q4: How does Paseo handle mobile review and steering while away from my desk?

Paseo includes an optional end-to-end encrypted WebSocket relay connecting the local daemon to the Expo mobile app (iOS/Android). Developers can inspect live diffs, approve question cards, and steer running agents securely over cellular data.

Orquestando DeepSeek Harness (DSH) con Paseo: Dentro del Estudio Multi-Agente 100% Soberano

Equipo de Sistemas y Arquitectura de AgDex 2 de noviembre de 2026 15 min de lectura Arquitectura Multi-Agente y Estudios Soberanos
Orquestando DeepSeek Harness (DSH) con Paseo
Resumen Técnico Ejecutivo

Ejecutar agentes de programación de forma aislada ha quedado obsoleto. Este análisis arquitectónico profundo explora cómo la combinación del demonio local y los Git Worktrees gestionados de Paseo con el runtime de plugins Cordis de DeepSeek Harness (DSH) proporciona un estudio de desarrollo multi-agente de código abierto y 100% autoalojado. Descubra cómo la comunicación Direct Provider desbloquea pensamiento en streaming, tarjetas interactivas de decisión y una reducción de costos de cómputo del 83.2% al 92.8% (ahorrando más del 95% frente a buques insignia comerciales).

Tabla de Contenidos

1. El Cuello de Botella del Terminal: Por Qué Fallan los Flujos de Trabajo CLI con Agentes Individuales

Durante 2025 y 2026, los agentes autónomos de ingeniería de software impulsados por modelos de frontera—desde Claude Code (con Claude Opus 5.5 y Sonnet 5.5) hasta OpenAI Operator / Codex (GPT 6.1 SOL), Google Antigravity (Gemini 4 Argon), Cursor y Aider—transformaron la productividad técnica. Sin embargo, a medida que los ingenieros intentan delegar sprints completos en lugar de funciones aisladas, ha surgido un cuello de botella arquitectónico severo: la restricción del terminal único y el directorio de trabajo compartido.

Cuando un desarrollador ejecuta múltiples procesos de agentes dentro de un único repositorio de Git, se desata el caos en el sistema de archivos. Los observadores de compilación en segundo plano colapsan, los cambios de archivos sobrescriben código sin confirmar y las operaciones simultáneas de Git desencadenan bloqueos fatales por contención en .git/index.lock. Aunque los desarrolladores intentan mitigar esto gestionando manualmente decenas de paneles en tmux, la sobrecarga cognitiva del cambio de contexto y la aprobación de comandos vuelve inmanejable el desarrollo en paralelo.

Además, los entornos en la nube propietarios atrapan a los equipos en ecosistemas cerrados con costosas licencias por usuario, telemetría obligatoria y recargos opacos en los tokens. Si bien modelos de frontera como Claude opus 5.5, GPT 6.1 SOL y Gemini 4 Argon ofrecen una capacidad de razonamiento sobresaliente, ejecutar bucles continuos de sprints multi-agente exclusivamente a través de endpoints comerciales agota rápidamente cualquier presupuesto de API. La industria demanda un centro de control multi-agente abierto, autoalojado y local que ofrezca aislamiento físico del espacio de trabajo, accesibilidad multidispositivo y ejecución determinista sin dependencias de la nube.

2. Arquitectura de Paseo: Demonio Local y Git Worktrees Gestionados

Paseo (github.com/getpaseo/paseo) resuelve este desafío de coordinación mediante un plano de control distribuido y prioritario en local. En su núcleo opera un demonio ligero en TypeScript que supervisa el ciclo de vida de los agentes, administra la E/S de los procesos y expone un enlace WebSocket con cifrado de extremo a extremo (E2EE) para clientes de escritorio (Electron), web y móviles (Expo iOS/Android). 

+─────────────────────────────────────────────────────────────────────────────────────────────────+
|               PASEO + DEEPSEEK HARNESS (DSH) MULTI-AGENT ARCHITECTURE                           |
+─────────────────────────────────────────────────────────────────────────────────────────────────+
|                                                                                                 |
|   [ CLIENT ACCESS MATRIX ]                                                                      |
|   • Desktop (Electron)      • Web Dashboard          • Mobile App (Expo / iOS / Android)        |
|                                       │ (E2EE WebSocket Relay)                                  |
|                                       ▼                                                         |
|   [ PASEO LOCAL CONTROL DAEMON ] (Node / TypeScript)                                            |
|   • Workspace Manager       • Process Supervisor     • Diff / Stream Review Engine              |
|                                       │                                                         |
|               ┌───────────────────────┼────────────────────────┐                                |
|               ▼                       ▼                        ▼                                |
|   [ WORKSPACE: feat/auth ]  [ WORKSPACE: feat/db ]  [ WORKSPACE: test/e2e ]                     |
|   • Worktree: slug-auth     • Worktree: slug-db      • Worktree: slug-tests                     |
|   • Branch: feature/auth    • Branch: feature/db     • Branch: test/e2e                         |
|   • Hook: paseo.json        • Hook: paseo.json       • Hook: paseo.json                         |
|               │                       │                        │                                |
|               ▼ (Direct Provider IPC) ▼ (Direct Provider IPC)  ▼ (Direct Provider IPC)          |
|   [ DEEPSEEK HARNESS (DSH) ] [ DEEPSEEK HARNESS (DSH) ] [ DEEPSEEK HARNESS (DSH) ]             |
|   • Preset: PTC (Reasoning) • Preset: Standard (CRUD) • Preset: Minimal (Test Suite)            |
|   • Cordis Plugin Kernel    • Cordis Plugin Kernel   • Cordis Plugin Kernel                     |
|   • Reversible Registers    • Reversible Registers   • Reversible Registers                     |
|                                                                                                 |
+─────────────────────────────────────────────────────────────────────────────────────────────────+

En lugar de desplegar pesadas máquinas virtuales o ejecutar subshell sin aislamiento, Paseo fundamenta el aislamiento de los espacios de trabajo en Git Worktrees gestionados, almacenados de manera determinista bajo $PASEO_HOME/worktrees/<hash>/<slug>/.

  • Aprovisionamiento Automático de Ramas: Los espacios de trabajo pueden bifurcarse desde origin/main o descargar pull requests existentes en un directorio completamente aislado que comparte la base de datos de objetos .git.
  • Ganchos de Ciclo de Vida Automatizados: Mediante paseo.json, cada worktree activa automáticamente scripts de configuración del entorno (instalación de dependencias, generación de .env) y rutinas de limpieza al archivarse.
  • Cero Sobrecarga de Memoria de Máquinas Virtuales: A diferencia de los contenedores Docker que consumen entre 1.5GB y 3GB de RAM por instancia, un Git Worktree incurre en menos de 50MB de delta de disco y se inicializa en menos de 180 milisegundos.

Esta arquitectura permite a un ingeniero ejecutar 3, 5 o 10 agentes simultáneamente sobre la misma base de código sin riesgo de bloqueos de índice, sobreescrituras accidentales o saturación de memoria.

3. Dentro de DeepSeek Harness (DSH): El Núcleo de Plugins Cordis

Mientras que Paseo proporciona el orquestador y el aislamiento del espacio de trabajo, DeepSeek Harness (DSH) (@deepseek-ai/dsh) aporta el motor de razonamiento autónomo y ejecución de herramientas. DeepSeek aborda el diseño de agentes bajo el principio fundamental: «Agente = Modelo + Harness».

Los frameworks tradicionales codifican definiciones de herramientas y bucles de estado en abstracciones monolíticas. En cambio, DeepSeek Harness está construido sobre Cordis, un meta-framework avanzado diseñado en torno a la componibilidad espaciotemporal donde todo es un plugin:

  • Adaptadores de Modelos: Conectores modulares compatibles con DeepSeek V4 Pro, Flash o endpoints locales autoalojados vía vLLM u Ollama.
  • Bucles de Agente: Bucles de control conectables que rigen la planificación, reflexión y despacho iterativo de herramientas.
  • Herramientas y Habilidades: Conjuntos dinámicos que abarcan análisis AST, modificaciones del sistema de archivos, ejecución Bash e interoperabilidad MCP.
  • Sesiones y Almacenamiento: Registros de eventos de solo adición que garantizan una estricta auditabilidad y cero corrupción de estado entre turnos.

El gran hito de ingeniería del núcleo Cordis son los Registros Reversibles (Reversible Registrations). Cuando un plugin o herramienta se desmonta, todos los oyentes de eventos, plantillas de prompts y middleware asociados se revierten automáticamente, evitando herramientas fantasma, contaminación de contexto y procesos zombi.

DSH empaqueta estas capacidades en cuatro configuraciones predefinidas: Standard (desarrollo equilibrado), PTC (Program-Time Compute) (razonamiento profundo y refactorización arquitectónica), Minimal (bucles de pruebas aislados de bajo consumo) y Creator (prototipado rápido).

4. Direct Provider vs. ACP: El Puente de Comunicación

Conectar un runtime de agentes externo a un orquestador suele depender del Agent Client Protocol (ACP). Sin embargo, las pruebas empíricas revelan que ACP actúa como un cuello de botella restrictivo: aplana los procesos de pensamiento en streaming, elimina las tarjetas interactivas estructuradas y restringe la intervención en tiempo real.

Para superar estas limitaciones, la comunidad de código abierto desarrolló paseo-dsh-direct (por Jecvay), un puente Direct Provider nativo que conecta DSH directamente con el canal IPC interno de Paseo:

  1. Deslizador de Esfuerzo de Razonamiento en Tiempo Real: Transmite y visualiza directamente la cadena interna de pensamiento de DeepSeek V4 sin colapsarla en texto plano.
  2. Tarjetas Interactivas ask_user_question: Muestra tarjetas de opciones estructuradas y ventanas modales de confirmación en la interfaz de Paseo para resolver ambigüedades con un solo clic.
  3. Control Previo de Compilación vs. Planificación: Exige al agente presentar un plan de ejecución formal para aprobación antes de invocar comandos destructivos en la shell.
  4. Intervención Durante el Turno (In-Flight Steer): Permite a los desarrolladores interrumpir y redirigir al agente a mitad de pensamiento sin reiniciar la sesión ni destruir el contexto.

Además, paseo-dsh-direct proporciona persistencia nativa de sesiones, lo que permite importar ejecuciones históricas desde ~/.dsh/sessions o reproducir trazas de depuración dentro del visualizador de diferencias de Paseo.

5. Benchmarks Empíricos: Rendimiento de Hardware y Deflación de Costos del 90%

Para evaluar la eficiencia operativa de Paseo y DSH, realizamos una comparativa rigurosa simulando un sprint empresarial multi-agente: refactorización de microservicios FastAPI, actualización de esquemas Pydantic y creación de pruebas de integración extremo a extremo con 4 agentes concurrentes. 

+─────────────────────────────────────────────────────────────────────────────────────────────────+
|            Table 1: Multi-Agent Concurrency & Isolation Benchmark (4 Concurrent Agents)         |
+──────────────────────────┬──────────────┬──────────────────┬──────────────┬─────────────────────+
| Concurrency Strategy     | Cold Latency | Resident RAM (4x)| Disk Delta   | Merge & Git Safety  |
+──────────────────────────┼──────────────┼──────────────────┼──────────────┼─────────────────────+
| Single Directory (Raw)   | Instant (0s) | ~220 MB          | 0 MB         | ❌ 100% Lock Fail   |
| Docker / MicroVM (e2b)   | 4.2s ~ 7.8s  | 7.4 GB ~ 12.0 GB | 4.8 GB       | ⚠️ Complex Remote   |
| Paseo Managed Worktree   | < 180 ms     | < 340 MB (Shared)| ~120 MB      | ✅ Native Clean PR  |
+──────────────────────────┴──────────────┴──────────────────┴──────────────┴─────────────────────+

Como se aprecia en la Tabla 1, el aislamiento mediante Git Worktree de Paseo alcanza un tiempo de inicio 23 veces más rápido y consume un 95% menos de memoria RAM que las alternativas basadas en microVMs en contenedores, eliminando por completo los bloqueos de Git. 

+─────────────────────────────────────────────────────────────────────────────────────────────────+
|               Table 2: 3-Agent Parallel Sprint Financial ROI (4.5M Total Tokens)                |
+──────────────────────────┬───────────────┬────────────────┬───────────────┬─────────────────────+
| Model / Harness Setup    | Input Tokens  | Output Tokens  | Total Cost    | Effective Savings   |
+──────────────────────────┼───────────────┼────────────────┼───────────────┼─────────────────────+
| Claude Opus 5.5 (CLI)    | $14.00 (3.5M) | $20.00 (1.0M)  | $34.00        | Baseline (0%)       |
| DeepSeek V4 Pro via DSH  | $0.75 (3.5M)  | $4.95 (1.0M)   | $5.70         | 83.2% Reduction     |
| DeepSeek V4 Flash Hybrid | $0.35 (3.5M)  | $2.10 (1.0M)   | $2.45         | 92.8% Reduction     |
+──────────────────────────┴───────────────┴────────────────┴───────────────┴─────────────────────+

En el aspecto económico (Tabla 2), ejecutar 4.5M de tokens en bucles de codificación multiturno con Claude Opus 5.5 suma $34.00 (o $17.00 empleando Claude Sonnet 5.5, escalando a más de $120 en buques insignia de razonamiento como GPT 6.1 SOL). Al emplear DeepSeek V4 Pro mediante DSH con almacenamiento en caché de prompts, el costo total del sprint se reduce a $5.70, lo que representa un ahorro inmediato del 83.2% frente a Opus 5.5. Al aprovechar DeepSeek Flash para la generación secundaria de pruebas y código repetitivo, el gasto desciende a $2.45, alcanzando una reducción de hasta el 92.8% (y superior al 97% frente a los titanes en la nube).

6. Guía de Producción Paso a Paso: Sprint Paralelo de 3 Agentes

El despliegue de un estudio multi-agente soberano requiere una configuración mínima. En primer lugar, defina los ganchos de aislamiento en paseo.json en la raíz de su repositorio: 

{
  "worktrees": {
    "root": "~/.paseo/worktrees"
  },
  "hooks": {
    "setup": "pnpm install && cp .env.example .env",
    "teardown": "pnpm test:clean"
  },
  "services": {
    "dev": {
      "command": "pnpm dev",
      "port": 3000,
      "proxy": true
    }
  }
}

Una vez configurado, inicie tres worktrees simultáneos mediante la CLI de Paseo: paseo workspace create --isolation worktree --mode branch-off --new-branch feat/auth --worktree-slug auth-service --base origin/main. Repita el proceso para migraciones de bases de datos y suites de pruebas.

En la interfaz de escritorio de Paseo, asigne el perfil PTC (Program-Time Compute) al agente de autenticación para un razonamiento profundo, y el perfil Standard a los agentes de migración y pruebas. Mientras los agentes trabajan simultáneamente en directorios aislados, los ingenieros pueden revisar diferencias unificadas en el escritorio o validar pull requests desde el móvil con Expo.

7. Estudios Soberanos e Indexación en AgDex

La convergencia de Paseo, DeepSeek Harness y paseo-dsh-direct demuestra que el futuro del desarrollo asistido por IA no pertenece a los editores cerrados en la nube. La orquestación modular y autoalojada ofrece mayor velocidad, privacidad total y ventajas económicas incomparables:

  • Soberanía Total de Datos: El código, los historiales de Git y las credenciales jamás abandonan su infraestructura local o VPC corporativa.
  • Intercambiabilidad de Modelos: Alterne sin esfuerzo entre APIs de frontera en la nube (Claude opus 5.5, GPT 6.1 SOL, Gemini 4 Argon) y modelos locales sin cambiar de entorno de desarrollo.
  • Cero Dependencia de Suscripciones SaaS: Elimine pagos recurrentes por licencias de usuario mientras escala la concurrencia a voluntad.

El Directorio de AgDex.ai indexa esta pila tecnológica completa junto con nuestro interactivo 3-Step Stack Finder, proporcionando plantillas de inicio verificadas, telemetría de rendimiento y comparativas para herramientas como Claude Code y DeepSeek para potenciar equipos de ingeniería que despliegan enjambres multi-agente soberanos.

Referencias y Repositorios Abiertos Verificados

Todas las herramientas y plugins referenciados en este análisis técnico son de código abierto y verificables públicamente:

• Plataforma de Orquestación Paseo: github.com/getpaseo/paseo (Sitio Oficial: paseo.sh)
• DeepSeek Harness (DSH): github.com/deepseek-ai/deepseek-harness (npm: @deepseek-ai/dsh)
• Plugin Direct Provider (Jecvay): github.com/Jecvay/paseo-dsh-direct
• Núcleo de Plugins Cordis: cordis.moe

Preguntas Frecuentes (FAQ)

P1: ¿Cómo se comparan los Git Worktrees de Paseo frente a los contenedores Docker para aislar agentes?

Los Git Worktrees crean directorios físicos ligeros que comparten la base de datos .git sin sobrecarga de virtualización. Se inicializan en menos de 180 ms, consumen cero RAM adicional y permiten cambios instantáneos de rama, mientras que Docker requiere gigabytes en imágenes base y montajes complejos.

P2: ¿Por qué usar paseo-dsh-direct en lugar del protocolo genérico Agent Client Protocol (ACP)?

El protocolo ACP estándar suprime controles avanzados propios del proveedor. paseo-dsh-direct brinda acceso IPC nativo al control de esfuerzo de razonamiento de DeepSeek V4, tarjetas interactivas con opciones clicables y aprobaciones previas al plan de ejecución.

P3: ¿Puedo ejecutar este entorno multi-agente de forma completamente desconectada de Internet?

Sí. Tanto Paseo como DeepSeek Harness son 100% autoalojables. Al emparejar DSH con ejecutores locales como vLLM u Ollama con modelos cuantizados de DeepSeek o Qwen Coder, puede operar un estudio de desarrollo totalmente aislado y con cero costo recurrente.

P4: ¿Cómo gestiona Paseo la revisión móvil cuando el desarrollador está fuera del escritorio?

Paseo incluye un relay WebSocket opcional con cifrado de extremo a extremo que conecta el demonio local con la aplicación móvil Expo (iOS/Android). Esto permite a los ingenieros inspeccionar diferencias en vivo, responder preguntas del agente y redirigir tareas de forma segura desde redes móviles.

DeepSeek Harness (DSH) mit Paseo orchestrieren: Im 100 % souveränen Multi-Agenten-Entwicklungsstudio

AgDex System- & Architektur-Team 2. November 2026 15 Min. Lesezeit Multi-Agenten-Architektur & Souveräne Studios
DeepSeek Harness (DSH) mit Paseo orchestrieren
Technisches Management-Briefing

Die isolierte Ausführung autonomer Coding-Agenten im einzelnen Terminal stößt an harte Grenzen. Diese architektonische Tiefenanalyse zeigt, wie die Kombination aus Paseos lokalem Daemon und verwalteten Git Worktrees mit der Cordis-Plugin-Laufzeitumgebung von DeepSeek Harness (DSH) ein vollständig quelloffenes, selbst gehostetes Multi-Agenten-Studio schafft. Erfahren Sie, wie die native Direct-Provider-Kommunikation Denkprozesse in Echtzeit, interaktive Entscheidungskarten und eine Rechenkosten-Reduktion von 83,2 % bis 92,8 % ermöglicht (über 95 % Ersparnis gegenüber proprietären Flaggschiffen).

Inhaltsverzeichnis

1. Der Terminal-Engpass: Warum Solo-Agent-CLI-Workflows bei Skalierung scheitern

Im Verlauf der Jahre 2025 und 2026 haben autonome Coding-Agenten auf Basis von Frontier-Modellen – von Claude Code (betrieben mit Claude Opus 5.5 und Sonnet 5.5) über OpenAI Operator / Codex (GPT 6.1 SOL), Google Antigravity (Gemini 4 Argon) bis hin zu Cursor und Aider – die Softwareentwicklung revolutioniert. Sobald Entwickler jedoch versuchen, ganze Entwicklungs-Sprints statt einzelner Funktionen zu delegieren, zeigt sich ein gravierender Architektur-Engpass: die Beschränkung auf ein einziges Terminal und ein gemeinsames Arbeitsverzeichnis.

Startet ein Entwickler mehrere Agenten-Prozesse innerhalb eines einzigen Git-Repositorys, entsteht Dateisystem-Chaos. Build-Watcher stürzen ab, parallele Schreibzugriffe überschreiben ungesicherten Code und gleichzeitige Git-Operationen lösen fatale .git/index.lock-Konflikte aus. Versuche, dies mit Dutzenden manuellen tmux-Panels zu umgehen, scheitern an der enormen kognitiven Belastung durch ständige Kontextwechsel.

Zudem sperren proprietäre Cloud-IDEs Teams in geschlossene Ökosysteme mit hohen Lizenzgebühren, verpflichtender Telemetrie und intransparenten Token-Aufschlägen ein. Obwohl Frontier-Modelle wie Claude opus 5.5, GPT 6.1 SOL und Gemini 4 Argon herausragende Einzelschritt-Logik bieten, führt die exklusive Ausführung kontinuierlicher Multi-Agenten-Sprints über kommerzielle Cloud-APIs unweigerlich zur Explosion von Entwicklungsbudgets. Die Industrie verlangt nach einer offenen, lokal gehosteten Multi-Agenten-Schaltzentrale mit physischer Arbeitsplatz-Isolation, Multi-Device-Fähigkeit und deterministischer Tool-Ausführung ohne Cloud-Zwang.

2. Paseo-Architektur: Lokaler Daemon & Verwaltete Git Worktrees

Paseo (github.com/getpaseo/paseo) löst diese Koordinationsherausforderung durch eine verteilte, primär lokale Steuerungsebene. Im Zentrum arbeitet ein leichtgewichtiger TypeScript-Daemon, der Agenten-Lebenszyklen überwacht, Prozess-Ein-/Ausgaben koordiniert und ein Ende-zu-Ende-verschlüsseltes (E2EE) WebSocket-Relay für Desktop- (Electron), Web- und Mobil-Clients (Expo iOS/Android) bereitstellt. 

+─────────────────────────────────────────────────────────────────────────────────────────────────+
|               PASEO + DEEPSEEK HARNESS (DSH) MULTI-AGENT ARCHITECTURE                           |
+─────────────────────────────────────────────────────────────────────────────────────────────────+
|                                                                                                 |
|   [ CLIENT ACCESS MATRIX ]                                                                      |
|   • Desktop (Electron)      • Web Dashboard          • Mobile App (Expo / iOS / Android)        |
|                                       │ (E2EE WebSocket Relay)                                  |
|                                       ▼                                                         |
|   [ PASEO LOCAL CONTROL DAEMON ] (Node / TypeScript)                                            |
|   • Workspace Manager       • Process Supervisor     • Diff / Stream Review Engine              |
|                                       │                                                         |
|               ┌───────────────────────┼────────────────────────┐                                |
|               ▼                       ▼                        ▼                                |
|   [ WORKSPACE: feat/auth ]  [ WORKSPACE: feat/db ]  [ WORKSPACE: test/e2e ]                     |
|   • Worktree: slug-auth     • Worktree: slug-db      • Worktree: slug-tests                     |
|   • Branch: feature/auth    • Branch: feature/db     • Branch: test/e2e                         |
|   • Hook: paseo.json        • Hook: paseo.json       • Hook: paseo.json                         |
|               │                       │                        │                                |
|               ▼ (Direct Provider IPC) ▼ (Direct Provider IPC)  ▼ (Direct Provider IPC)          |
|   [ DEEPSEEK HARNESS (DSH) ] [ DEEPSEEK HARNESS (DSH) ] [ DEEPSEEK HARNESS (DSH) ]             |
|   • Preset: PTC (Reasoning) • Preset: Standard (CRUD) • Preset: Minimal (Test Suite)            |
|   • Cordis Plugin Kernel    • Cordis Plugin Kernel   • Cordis Plugin Kernel                     |
|   • Reversible Registers    • Reversible Registers   • Reversible Registers                     |
|                                                                                                 |
+─────────────────────────────────────────────────────────────────────────────────────────────────+

Statt schwerfällige virtuelle Maschinen zu starten oder unisolierte Subshells zu betreiben, basiert Paseos Arbeitsplatz-Isolation auf verwalteten Git Worktrees, die deterministisch unter $PASEO_HOME/worktrees/<hash>/<slug>/ gespeichert werden.

  • Automatisches Branch-Provisioning: Workspaces können direkt von origin/main abzweigen oder bestehende Pull Requests in ein vollständig isoliertes Verzeichnis auschecken, das die gemeinsame .git-Objektdatenbank nutzt.
  • Automatisierte Lifecycle-Hooks: Über paseo.json führt jeder Worktree automatisch Setup-Skripte (z. B. Paketinstallation, .env-Erstellung) und Aufräumroutinen bei der Archivierung aus.
  • Null VM-Speicher-Overhead: Während Docker-Container 1,5 bis 3 GB RAM pro Instanz belegen, verursacht ein Git Worktree weniger als 50 MB Festplattendelta und startet in unter 180 Millisekunden.

Diese Architektur erlaubt es Software-Ingenieuren, 3, 5 oder 10 Agenten gleichzeitig auf derselben Codebasis auszuführen, ohne Index-Sperren, Code-Kollisionen oder Speichermangel befürchten zu müssen.

3. DeepSeek Harness (DSH): Der Cordis-Plugin-Kernel

Während Paseo die Orchestrierung und Arbeitsplatz-Isolation übernimmt, liefert DeepSeek Harness (DSH) (@deepseek-ai/dsh) die autonome Reasoning- und Tool-Ausführungs-Engine. DeepSeek folgt dabei dem Leitsatz: „Agent = Modell + Harness“.

Herkömmliche Frameworks programmieren Werkzeugdefinitionen und Zustandsschleifen starr in monolithische Klassen ein. DeepSeek Harness baut hingegen auf Cordis auf – einem fortschrittlichen Meta-Framework für raum-zeitliche Komponierbarkeit, in dem alles ein Plugin ist:

  • Modell-Adapter: Modulare Konnektoren für DeepSeek V4 Pro, Flash oder selbst gehostete vLLM/Ollama-Instanzen.
  • Agent-Loops: Austauschbare Kontrollschleifen für Planung, Reflexion und iterativen Werkzeugaufruf.
  • Tools & Skills: Dynamische Toolsets für AST-Parsing, Dateisystem-Mutationen, Bash-Ausführung und MCP-Interoperabilität.
  • Sessions & Storage: Append-only Event-Logs, die strikte Auditierbarkeit und fehlerfreie Zustandserhaltung garantieren.

Der entscheidende Durchbruch des Cordis-Kerns liegt in den Reversiblen Registrierungen (Reversible Registrations). Wird ein Plugin entladen, werden sämtliche Event-Listener, Prompt-Fragmente und Middleware-Hooks automatisch restlos zurückgerollt, was Tool-Leaks und Kontextverschmutzung verhindert.

DSH bietet vier spezialisierte Vorkonfigurationen: Standard (ausgewogene Entwicklung), PTC (Program-Time Compute) (tiefes architektonisches Reasoning), Minimal (token-sparende Testschleifen) und Creator (schnelles Prototyping).

4. Direct Provider vs. ACP: Die Kommunikationsbrücke

Die Anbindung externer Agenten an einen Orchestrator erfolgt häufig über das Agent Client Protocol (ACP). Praxistests zeigen jedoch, dass ACP als Nadelöhr wirkt: Es nivelliert Denkströme, eliminiert strukturierte UI-Elemente und behindert dynamische Steuerungseingriffe.

Um diese Hürden zu beseitigen, entwickelte die Open-Source-Community paseo-dsh-direct (von Jecvay) – eine native Direct-Provider-Bridge, die DSH direkt mit dem internen IPC-Kanal von Paseo verbindet:

  1. Echtzeit-Reasoning-Slider: Streamt die interne Gedankenkette von DeepSeek V4 direkt in die Benutzeroberfläche.
  2. Interaktive ask_user_question-Karten: Rendert strukturierte Auswahloptionen in Paseo, sodass unklare Anforderungen mit einem Klick beantwortet werden können.
  3. Build-vs-Plan-Freigabestufe: Verpflichtet den Agenten, vor der Ausführung destruktiver Shell-Befehle einen formalen Ausführungsplan vorzulegen.
  4. In-Flight Steer (Laufzeit-Intervention): Erlaubt Entwicklern, mitten im Denkprozess einzugreifen und den Agenten umzulenken, ohne den Sitzungskontext zu zerstören.

Darüber hinaus bietet paseo-dsh-direct native Sitzungspersistenz, sodass historische Läufe direkt aus ~/.dsh/sessions importiert und in Paseos Diff-Viewer nachvollzogen werden können.

5. Empirische Benchmarks: Hardware-Footprint & 90 % Kostenersparnis

Um die Effizienz von Paseo und DSH zu messen, führten wir einen anspruchsvollen Benchmark durch: Refactoring eines FastAPI-Microservices, Schema-Upgrades in Pydantic und Erstellung von End-to-End-Tests über 4 parallele Agenten. 

+─────────────────────────────────────────────────────────────────────────────────────────────────+
|            Table 1: Multi-Agent Concurrency & Isolation Benchmark (4 Concurrent Agents)         |
+──────────────────────────┬──────────────┬──────────────────┬──────────────┬─────────────────────+
| Concurrency Strategy     | Cold Latency | Resident RAM (4x)| Disk Delta   | Merge & Git Safety  |
+──────────────────────────┼──────────────┼──────────────────┼──────────────┼─────────────────────+
| Single Directory (Raw)   | Instant (0s) | ~220 MB          | 0 MB         | ❌ 100% Lock Fail   |
| Docker / MicroVM (e2b)   | 4.2s ~ 7.8s  | 7.4 GB ~ 12.0 GB | 4.8 GB       | ⚠️ Complex Remote   |
| Paseo Managed Worktree   | < 180 ms     | < 340 MB (Shared)| ~120 MB      | ✅ Native Clean PR  |
+──────────────────────────┴──────────────┴──────────────────┴──────────────┴─────────────────────+

Wie Tabelle 1 veranschaulicht, erreicht Paseos Git-Worktree-Isolation eine 23-mal schnellere Startzeit und verbraucht 95 % weniger Arbeitsspeicher als containerisierte MicroVMs bei absoluter Git-Sperrfreiheit. 

+─────────────────────────────────────────────────────────────────────────────────────────────────+
|               Table 2: 3-Agent Parallel Sprint Financial ROI (4.5M Total Tokens)                |
+──────────────────────────┬───────────────┬────────────────┬───────────────┬─────────────────────+
| Model / Harness Setup    | Input Tokens  | Output Tokens  | Total Cost    | Effective Savings   |
+──────────────────────────┼───────────────┼────────────────┼───────────────┼─────────────────────+
| Claude Opus 5.5 (CLI)    | $14.00 (3.5M) | $20.00 (1.0M)  | $34.00        | Baseline (0%)       |
| DeepSeek V4 Pro via DSH  | $0.75 (3.5M)  | $4.95 (1.0M)   | $5.70         | 83.2% Reduction     |
| DeepSeek V4 Flash Hybrid | $0.35 (3.5M)  | $2.10 (1.0M)   | $2.45         | 92.8% Reduction     |
+──────────────────────────┴───────────────┴────────────────┴───────────────┴─────────────────────+

Aus ökonomischer Sicht (Tabelle 2) schlagen 4,5 Mio. Tokens über iterative Coding-Zyklen mit Claude Opus 5.5 mit 34,00 $ zu Buche (bzw. 17,00 $ mit Claude Sonnet 5.5; bei Reasoning-Flaggschiffen wie GPT 6.1 SOL steigt dieser Betrag auf über 120 $). Durch den Einsatz von DeepSeek V4 Pro via DSH mit Prompt-Caching sinken die Gesamtkosten des Sprints auf 5,70 $ – eine unmittelbare Kostenreduktion von 83,2 % gegenüber Opus 5.5. Wird für sekundäre Tests und Boilerplate-Generierung DeepSeek Flash eingesetzt, sinken die Ausgaben auf 2,45 $, was einer Einsparung von bis zu 92,8 % entspricht (und über 97 % im Vergleich zu proprietären Cloud-Flaggschiffen).

6. Schritt-für-Schritt-Anleitung: Paralleler 3-Agenten-Sprint

Das Aufsetzen des souveränen Multi-Agenten-Studios erfordert minimale Konfiguration. Definieren Sie zunächst die Isolations-Hooks in paseo.json im Root-Verzeichnis Ihres Repositories: 

{
  "worktrees": {
    "root": "~/.paseo/worktrees"
  },
  "hooks": {
    "setup": "pnpm install && cp .env.example .env",
    "teardown": "pnpm test:clean"
  },
  "services": {
    "dev": {
      "command": "pnpm dev",
      "port": 3000,
      "proxy": true
    }
  }
}

Erstellen Sie anschließend drei parallele Worktrees über die Paseo-CLI: paseo workspace create --isolation worktree --mode branch-off --new-branch feat/auth --worktree-slug auth-service --base origin/main. Wiederholen Sie dies für DB-Migrationen und Test-Suites.

Weisen Sie in der Paseo-Desktop-Oberfläche dem Auth-Agenten das PTC (Program-Time Compute)-Preset für tiefes Reasoning zu, während die Migrations- und Test-Agenten mit dem Standard-Preset laufen. Entwickler können Änderungen gebündelt prüfen oder unterwegs auf dem Smartphone freigeben.

7. Souveräne Studios & AgDex-Indexierung

Das Zusammenspiel von Paseo, DeepSeek Harness und paseo-dsh-direct belegt eindrucksvoll: Die Zukunft der Softwareentwicklung gehört nicht geschlossenen Cloud-Editoren. Modulare, selbst gehostete Orchestrierung bietet überlegene Geschwindigkeit, absolute Privatsphäre und unschlagbare Kostenvorteile:

  • Vollständige Datensouveränität: Quellcode, Git-Historien und Secrets verbleiben stets auf Ihrer lokalen Infrastruktur.
  • Modell-Austauschbarkeit: Wechseln Sie flexibel zwischen Cloud-Frontier-APIs (Claude opus 5.5, GPT 6.1 SOL, Gemini 4 Argon) und lokalen Offline-Modellen im selben Interface.
  • Keine SaaS-Abo-Abhängigkeit: Skalieren Sie die Entwickler-Parallelität ohne wiederkehrende monatliche Lizenzgebühren.

Das AgDex.ai-Verzeichnis indexiert diesen vollständigen Software-Stack zusammen mit unserem interaktiven 3-Step Stack Finder und liefert verifizierte Starter-Blueprints, Benchmark-Telemetrie und Systemvergleiche für Engineering-Tools wie Claude Code und DeepSeek, um Softwareteams bei der Bereitstellung souveräner Multi-Agenten-Swarms zu unterstützen.

Referenzen & Verifizierte Open-Source-Repositories

Alle in dieser Architektur-Analyse genannten Tools und Plugins sind quelloffen und öffentlich prüfbar:

• Paseo Orchestrierungs-Plattform: github.com/getpaseo/paseo (Offizielle Website: paseo.sh)
• DeepSeek Harness (DSH): github.com/deepseek-ai/deepseek-harness (npm: @deepseek-ai/dsh)
• Direct Provider Plugin (Jecvay): github.com/Jecvay/paseo-dsh-direct
• Cordis Plugin Kernel: cordis.moe

Häufig gestellte Fragen (FAQ)

F1: Wie schneiden Git Worktrees in Paseo im Vergleich zu Docker-Containern ab?

Git Worktrees erstellen leichtgewichtige physische Verzeichnisse, die auf dieselbe .git-Datenbank zugreifen. Sie starten in unter 180 ms, benötigen keinen zusätzlichen RAM und ermöglichen sofortiges Branch-Switching, während Docker Gigabytes an Image-Daten und komplexe Mounts verlangt.

F2: Warum sollte man paseo-dsh-direct dem Standard-ACP-Protokoll vorziehen?

Das Standard-ACP-Protokoll filtert modellspezifische Kontrollmechanismen heraus. paseo-dsh-direct bietet nativen IPC-Zugriff auf DeepSeeks Denkzeit-Regler, interaktive Entscheidungskarten und Vorabfreigaben für Ausführungspläne.

F3: Kann diese Multi-Agenten-Umgebung komplett offline betrieben werden?

Ja. Sowohl Paseo als auch DeepSeek Harness sind zu 100 % selbst gehostet. In Kombination mit lokalen Inferenz-Servern wie vLLM oder Ollama lässt sich ein vollständig abgeschottetes, gebührenfreies Entwicklungsstudio betreiben.

F4: Wie unterstützt Paseo mobile Code-Reviews von unterwegs?

Paseo verfügt über ein Ende-zu-Ende-verschlüsseltes WebSocket-Relay, das den lokalen Daemon mit der mobilen Expo-App verbindet. Entwickler können Diffs prüfen, Fragen des Agenten beantworten und Aufgaben direkt über das Smartphone freigeben.

Paseo と DeepSeek Harness (DSH) で構築する：100% 自律管理型マルチエージェント開発スタジオの深層

AgDex システム＆アーキテクチャチーム 2026年11月2日 読了目安 15分 マルチエージェント設計＆データ主権
Paseo と DeepSeek Harness によるマルチエージェント開発スタジオ
技術エグゼクティブ・サマリー

単一のターミナル内でコーディングエージェントを孤立して動かす時代は終わりました。本稿では、Paseo のローカルデーモンおよび管理型 Git Worktree と、DeepSeek Harness (DSH) の Cordis プラグイン実行基盤を統合し、完全セルフホストのオープンソース・マルチエージェント開発工坊を構築する方法を徹底解剖します。Direct Provider 通信による思考プロセスのリアルタイム可視化、対話型質問カード、そして計算コスト 83.2%〜92.8% 削減（商用フラッグシップ比では 95% 以上の削減）の実証データを公開します。

目次

1. ターミナルの限界：なぜ単一エージェントの CLI 運用はスケールで破綻するのか

2025年から2026年にかけて、最先端基盤モデルに支えられた自律型コーディングエージェント群——Claude Code（Claude Opus 5.5 / Sonnet 5.5 搭載）から OpenAI Operator / Codex（GPT 6.1 SOL 搭載）、Google Antigravity（Gemini 4 Argon 搭載）、Cursor、Aider に至るまで——は開発者の生産性を飛躍的に高めました。しかし、単機能の生成にとどまらず複数タスクにわたる大規模スプリントを並行処理させようとした途端、深刻なボトルネックに直面します。それは「単一ターミナルかつ単一作業ディレクトリの制約」です。

エンジニアが1つの Git リポジトリ内で複数のエージェントプロセスを立ち上げると、ファイルシステムは大混乱に陥ります。バックグラウンドのビルドウォッチャーがクラッシュし、未コミットのコードが別エージェントに上書きされ、並行実行された Git コマンドが致命的な .git/index.lock 競合を頻発させます。手動で大量の tmux ペインを立ち上げて回避しようとしても、コンテキスト切り替えの認知的負荷は限界に達します。

さらに、商用のプロプライエタリなクラウド環境は、高額なシート課金や不透明なトークン手数料、強制的なテレメトリ送信で開発組織を囲い込みます。Claude opus 5.5、GPT 6.1 SOL、Gemini 4 Argon といった最先端商用モデルは単一タスクで卓越した推論力を発揮するものの、多重エージェントによる連続的なスプリントループを商用クラウド API だけで回し続けることは、組織の API 予算を急速に逼迫させます。現場が真に求めているのは、物理的な作業領域の隔離、複数デバイスからの遠隔操作、そして外部クラウドに依存しない安全な自律型マルチエージェント管理ハブです。

2. Paseo アーキテクチャ：ローカルファースト・デーモンと管理型 Git Worktree

Paseo（github.com/getpaseo/paseo）は、分散型ローカルコントロールプレーンによってこの並行制御の課題を根本から解決します。核となる軽量 TypeScript デーモンが各エージェントのライフサイクルを監視し、プロセスI/Oを統括し、デスクトップ（Electron）、Web、モバイル（Expo iOS/Android）へエンドツーエンド暗号化（E2EE）WebSocket を介してリアルタイム中継します。 

+─────────────────────────────────────────────────────────────────────────────────────────────────+
|               PASEO + DEEPSEEK HARNESS (DSH) MULTI-AGENT ARCHITECTURE                           |
+─────────────────────────────────────────────────────────────────────────────────────────────────+
|                                                                                                 |
|   [ CLIENT ACCESS MATRIX ]                                                                      |
|   • Desktop (Electron)      • Web Dashboard          • Mobile App (Expo / iOS / Android)        |
|                                       │ (E2EE WebSocket Relay)                                  |
|                                       ▼                                                         |
|   [ PASEO LOCAL CONTROL DAEMON ] (Node / TypeScript)                                            |
|   • Workspace Manager       • Process Supervisor     • Diff / Stream Review Engine              |
|                                       │                                                         |
|               ┌───────────────────────┼────────────────────────┐                                |
|               ▼                       ▼                        ▼                                |
|   [ WORKSPACE: feat/auth ]  [ WORKSPACE: feat/db ]  [ WORKSPACE: test/e2e ]                     |
|   • Worktree: slug-auth     • Worktree: slug-db      • Worktree: slug-tests                     |
|   • Branch: feature/auth    • Branch: feature/db     • Branch: test/e2e                         |
|   • Hook: paseo.json        • Hook: paseo.json       • Hook: paseo.json                         |
|               │                       │                        │                                |
|               ▼ (Direct Provider IPC) ▼ (Direct Provider IPC)  ▼ (Direct Provider IPC)          |
|   [ DEEPSEEK HARNESS (DSH) ] [ DEEPSEEK HARNESS (DSH) ] [ DEEPSEEK HARNESS (DSH) ]             |
|   • Preset: PTC (Reasoning) • Preset: Standard (CRUD) • Preset: Minimal (Test Suite)            |
|   • Cordis Plugin Kernel    • Cordis Plugin Kernel   • Cordis Plugin Kernel                     |
|   • Reversible Registers    • Reversible Registers   • Reversible Registers                     |
|                                                                                                 |
+─────────────────────────────────────────────────────────────────────────────────────────────────+

Paseo は重量級の仮想マシンを起動する代わりに、管理型 Git Worktree（決定論的に $PASEO_HOME/worktrees/<hash>/<slug>/ 配下に配置）を作業空間の隔離基盤として採用しています。

  • 自動ブランチプロビジョニング: origin/main からの自動分岐や個別プルリクエストのチェックアウトを、共通の .git オブジェクトデータベースを共有しながら即座に実行します。
  • 自動化されたライフサイクルフック: paseo.json を定義することで、各 Worktree 作成時の依存関係インストールや .env 生成、アーカイブ時の自動クリーンアップを自動化します。
  • 仮想マシンのメモリオーバーヘッド皆無: 1インスタンスあたり 1.5GB〜3GB を消費する Docker コンテナとは異なり、Git Worktree のディスク差分はわずか 50MB 未満、起動時間は 180 ミリ秒以下です。

このアーキテクチャにより、Git インデックスのロックやコードの衝突、メモリ不足に悩まされることなく、同一リポジトリ上で 3台、5台、10台のエージェントを同時に安定稼働させることが可能になります。

3. DeepSeek Harness (DSH)：Cordis プラグインカーネルの全貌

Paseo がオーケストレーターと作業領域の隔離を担う一方、自律的な推論とツール実行エンジンを提供するのが DeepSeek Harness (DSH)（@deepseek-ai/dsh）です。DeepSeek はエージェント設計において「Agent = Model + Harness」という明快な哲学を掲げています。

従来のフレームワークはツール定義やステートループを単一の巨大なクラスに固定しがちでした。これに対し、DeepSeek Harness は時空間の構成可能性を追求した先進的メタフレームワーク Cordis を採用しており、あらゆる構成要素がプラグインとして設計されています：

  • モデルアダプタ: DeepSeek V4 Pro、Flash、あるいは vLLM や Ollama でローカル配信されるオープンモデルを柔軟に切り替え可能。
  • エージェントループ: 計画立案、内省、反復的なツールディスパッチを司る交換可能な制御ループ。
  • ツール＆スキル: AST構文解析、ファイル変更、Bash実行、MCP連携を含む動的な拡張機能群。
  • セッション＆ストレージ: ターン間の状態破壊を防止し、厳格な監査証跡を保証する追記専用イベントログ。

Cordis カーネル最大の工学的強みは「可逆的登録（Reversible Registrations）」です。プラグインやツールがアンマウントされると、関連するイベントリスナー、プロンプト定義、ミドルウェアが自動的に完全ロールバックされ、メモリリークやゴーストツールの残留を根本から遮断します。

DSH はこれらの機能を4つの特化型プリセットにパッケージングしています：Standard（汎用コーディング）、PTC (Program-Time Compute)（深い推論と大規模リファクタリング）、Minimal（トークン消費を抑えた自動テスト）、Creator（高速プロトタイピング）。

4. Direct Provider 対 ACP：高速通信ブリッジの優位性

外部エージェントランタイムをオーケストレーターに接続する際、標準の Agent Client Protocol (ACP) が使われるケースが一般的です。しかし実測検証の結果、ACP は帯域幅の狭い隘路となってしまい、ストリーミング思考の表現力喪失や対話型UIカードの欠落といった制限をもたらすことが判明しました。

この制約を打開するため、オープンソースコミュニティの Jecvay 氏によって開発されたのが paseo-dsh-direct です。DSH を Paseo の内部 IPC 通信路に直接ネイティブ Provider として結合します：

  1. リアルタイム推論深度（Reasoning Effort）スライダー: DeepSeek V4 の内部思考プロセスを平坦なテキストに潰すことなく、ストリーミング形式で忠実に描画。
  2. 対話型 ask_user_question カード: 曖昧な要件が発生した際、Paseo の UI 上に選択式カードや確認モーダルを直接提示し、1クリックで意思決定を完了。
  3. Build vs. Plan 実行前ゲートウェイ: 破壊的なシェルコマンドの実行前に、エージェントへ明確な手順計画の提示を義務付け、人間が事前承認。
  4. インフライト・ステアリング（In-flight Steer）: エージェントの思考途中であっても、セッションを破棄することなく介入して指示を軌道修正可能。

さらに paseo-dsh-direct はセッションの完全永続化に対応しており、~/.dsh/sessions から過去の実行ログを取り込んで Paseo の Diff ビューア上でデバッグの経緯を即座に再生できます。

5. 実証ベンチマーク：フットプリント測定と開発コスト 90% 削減の実態

Paseo と DSH の実用性を検証するため、実戦的な開発スプリントを想定したストレステストを実施しました：FastAPI マイクロサービスのリファクタリング、Pydantic スキーマの更新、および 4台の並行エージェントによる E2E 統合テストの自動作成です。 

+─────────────────────────────────────────────────────────────────────────────────────────────────+
|            Table 1: Multi-Agent Concurrency & Isolation Benchmark (4 Concurrent Agents)         |
+──────────────────────────┬──────────────┬──────────────────┬──────────────┬─────────────────────+
| Concurrency Strategy     | Cold Latency | Resident RAM (4x)| Disk Delta   | Merge & Git Safety  |
+──────────────────────────┼──────────────┼──────────────────┼──────────────┼─────────────────────+
| Single Directory (Raw)   | Instant (0s) | ~220 MB          | 0 MB         | ❌ 100% Lock Fail   |
| Docker / MicroVM (e2b)   | 4.2s ~ 7.8s  | 7.4 GB ~ 12.0 GB | 4.8 GB       | ⚠️ Complex Remote   |
| Paseo Managed Worktree   | < 180 ms     | < 340 MB (Shared)| ~120 MB      | ✅ Native Clean PR  |
+──────────────────────────┴──────────────┴──────────────────┴──────────────┴─────────────────────+

表1 の測定値が示す通り、Paseo の Git Worktree はコンテナ型 MicroVM と比較して起動速度が23倍高速であり、RAM消費量を95%削減しながら、Git インデックスロックを完全に解消しています。 

+─────────────────────────────────────────────────────────────────────────────────────────────────+
|               Table 2: 3-Agent Parallel Sprint Financial ROI (4.5M Total Tokens)                |
+──────────────────────────┬───────────────┬────────────────┬───────────────┬─────────────────────+
| Model / Harness Setup    | Input Tokens  | Output Tokens  | Total Cost    | Effective Savings   |
+──────────────────────────┼───────────────┼────────────────┼───────────────┼─────────────────────+
| Claude Opus 5.5 (CLI)    | $14.00 (3.5M) | $20.00 (1.0M)  | $34.00        | Baseline (0%)       |
| DeepSeek V4 Pro via DSH  | $0.75 (3.5M)  | $4.95 (1.0M)   | $5.70         | 83.2% Reduction     |
| DeepSeek V4 Flash Hybrid | $0.35 (3.5M)  | $2.10 (1.0M)   | $2.45         | 92.8% Reduction     |
+──────────────────────────┴───────────────┴────────────────┴───────────────┴─────────────────────+

コスト面（表2）においては、Claude Opus 5.5 で 450万トークンのマルチターンコーディングを回すと 34.00 ドルを要します（Claude Sonnet 5.5 では 17.00 ドル、GPT 6.1 SOL などの最先端推論フラッグシップでは 120 ドル以上に急騰します）。一方、プロンプトキャッシュを併用した DeepSeek V4 Pro（DSH経由）では、スプリント全体の総費用はわずか 5.70 ドル（Opus 5.5 比 83.2% のコスト削減） に圧縮されます。さらに、テストコード生成や定型処理に DeepSeek Flash をハイブリッド投入した場合、費用は 2.45 ドル にまで低下し、最大 92.8%（商用フラッグシップ比では 97% 以上）のコスト圧縮を達成します。

6. 実践プロダクションガイド：3エージェント並行スプリントの立ち上げ

自律管理型マルチエージェントスタジオの導入は極めてシンプルです。まず、リポジトリのルートに paseo.json を作成し、隔離環境のフックを設定します： 

{
  "worktrees": {
    "root": "~/.paseo/worktrees"
  },
  "hooks": {
    "setup": "pnpm install && cp .env.example .env",
    "teardown": "pnpm test:clean"
  },
  "services": {
    "dev": {
      "command": "pnpm dev",
      "port": 3000,
      "proxy": true
    }
  }
}

設定完了後、Paseo CLI から3つの Worktree を瞬時に立ち上げます：paseo workspace create --isolation worktree --mode branch-off --new-branch feat/auth --worktree-slug auth-service --base origin/main。データベース移行とテスト作成用にも同様に実行します。

Paseo デスクトップ UI から、認証エージェントには深い推論を行う PTC プリセットを、DB移行とテスト作成には Standard プリセットを割り当てます。各エージェントが隔離された作業ディレクトリで同時にコードを生成する間、開発者はデスクトップ上で差分を統括レビューするか、外出先から Expo モバイルアプリ経由で PR を承認できます。

7. 自律管理型スタジオの未来と AgDex 連携

Paseo、DeepSeek Harness、そして paseo-dsh-direct の融合は、AI支援開発の主導権が閉鎖的な商用クラウドエディタから開発者自身の手元へ戻りつつあることを証明しています。オープンで自律管理型の編排は、比類なき処理速度、データ主権、そして圧倒的な経済合理性をもたらします：

  • 完全なデータ主権: ソースコード、Git の履歴、APIシークレットがローカルPCや社内VPCの外部へ漏洩するリスクを完全に遮断。
  • 柔軟なモデル選択: エディタ環境を変えることなく、最先端のクラウドAPI（Claude opus 5.5, GPT 6.1 SOL, Gemini 4 Argon）とオフラインのローカルLLMをシームレスに併用。
  • SaaS課金の排除: 毎月の高額な座席サブスクリプションに縛られることなく、エージェントの並行数を自由に拡張。

AgDex.ai ディレクトリ では、インタラクティブな 3-Step Stack Finder と連動して本ソフトウェアスタックを網羅しており、Claude Code や DeepSeek などのエンジニアリングツールの検証済みスターターテンプレート、実測テレメトリ、比較ベンチマークを提供して、自律型マルチエージェント群を配備する開発チームを支援しています。

参考情報および検証済みオープンソースリポジトリ

本稿で解説したすべてのツールおよびプラグインはオープンソースとして公開されており、誰でも検証可能です：

• Paseo オーケストレーション基盤: github.com/getpaseo/paseo（公式サイト: paseo.sh）
• DeepSeek Harness (DSH): github.com/deepseek-ai/deepseek-harness（npm: @deepseek-ai/dsh）
• Direct Provider プラグイン (Jecvay 氏): github.com/Jecvay/paseo-dsh-direct
• Cordis プラグインカーネル: cordis.moe

よくある質問（FAQ）

Q1: Paseo の Git Worktree は Docker コンテナと比較して何が優れていますか？

Git Worktree は仮想化を行わず、基底の .git データベースを共有する軽量な物理ディレクトリを作成します。起動時間は180ミリ秒未満、追加のRAM消費はゼロであり、Docker のように数ギガバイトのイメージ容量や複雑なボリュームマウントを必要としません。

Q2: 標準の ACP プロトコルではなく paseo-dsh-direct を使う理由は？

汎用の ACP プロトコルはモデル固有の高度な制御機能を切り捨ててしまいます。paseo-dsh-direct を利用することで、DeepSeek V4 のリアルタイム推論深度スライダー、選択肢付き質問カード、および実行前計画承認ゲートウェイにネイティブ IPC 経由でアクセスできます。

Q3: 外部クラウド API を使わず、完全オフラインで動作させることは可能ですか？

はい、可能です。Paseo と DeepSeek Harness はどちらも 100% セルフホスト対応です。vLLM や Ollama でローカル配信される量子化版 DeepSeek や Qwen Coder モデルを DSH に接続することで、完全にエアギャップされた無償の開発環境を構築できます。

Q4: 開発デスクから離れている間、どのようにモバイルからレビューや指示を行いますか？

Paseo はローカルデーモンと Expo モバイルアプリ（iOS/Android）を結ぶエンドツーエンド暗号化 WebSocket 中継を備えています。開発者は外出先のモバイル回線から安全にリアルタイムのコード差分を確認し、質問に回答してタスクを承認できます。

تنسيق DeepSeek Harness (DSH) مع Paseo: داخل استوديو البرمجة متعدد الوكلاء السيادي بنسبة 100%

فريق النظم والمعمارية في AgDex 2 نوفمبر 2026 وقت القراءة: 15 دقيقة معمارية الوكلاء المتعددين والسيادة الرقمية
تنسيق DeepSeek Harness مع Paseo
موجز تقني تنفيذي

أصبح تشغيل وكلاء البرمجة الذاتيين في عزلة داخل سطر الأوامر أمراً قديماً. يستكشف هذا التحليل المعماري المعمق كيف يؤدي دمج خادم Paseo المحلي ومساحات Git Worktrees المدارة مع بيئة تشغيل إضافات Cordis في DeepSeek Harness (DSH) إلى بناء استوديو تطوير مفتوح المصدر ومستضاف محلياً بالكامل. تعرّف على كيفية فتح الاتصال المباشر Direct Provider لتدفقات التفكير الحي، وبطاقات الأسئلة التفاعلية، وخفض تكاليف الحوسبة بنسبة 83.2% إلى 92.8% (مع توفير يتجاوز 95% مقارنة بنماذج السحابة الرائدة).

فهرس المحتويات

1. عنق زجاجة الطرفية: لماذا تفشل مسارات عمل وكيل سطر الأوامر الفردي عند التوسع

خلال عامي 2025 و2026، أعادت وكلاء هندسة البرمجيات الذاتية المدعومة بالنماذج التأسيسية الرائدة—بدءاً من Claude Code (المعزز بنموذجي Claude Opus 5.5 و Sonnet 5.5) و OpenAI Operator / Codex (المستند إلى GPT 6.1 SOL) و Google Antigravity (بنواة Gemini 4 Argon) وصولاً إلى Cursor و Aider—صياغة إنتاجية المطورين بالكامل. ومع ذلك، عندما يحاول المهندسون تفويض دورات عمل كاملة (Sprints) بدلاً من دوال برمجية معزولة، يظهر عنق زجاجة معماري حاد: قيد الطرفية الواحدة ودليل العمل المشترك.

عندما يشغّل المطور عمليات متعددة للوكلاء داخل مستودع Git واحد، تسود الفوضى نظام الملفات؛ حيث تنهار مراقبات البناء في الخلفية، وتقوم تعديلات الملفات بالكتابة فوق أكواد غير مثبتة، وتؤدي عمليات Git المتزامنة إلى إطلاق أخطاء قفل قاتلة في .git/index.lock. ورغم محاولات المطورين تخفيف ذلك بإدارة العشرات من أجزاء tmux يدوياً، فإن العبء الذهني لتبديل السياق والموافقة على الأوامر يجعل التطوير المتوازي مستحيلاً عملياً.

علاوة على ذلك، تحاصر بيئات التطوير السحابية الاحتكارية الفرق داخل منظومات مغلقة باشتراكات شهرية باهظة وهوامش ربح غامضة على التوكينات وتتبع إلزامي للبيانات. وعلى الرغم من أن نماذج القمة الرائدة مثل Claude opus 5.5 و GPT 6.1 SOL و Gemini 4 Argon تقدم قدرات استدلال استثنائية في المهام الفردية، إلا أن تنفيذ جولات عمل مستمرة لفرق الوكلاء المتعددين عبر واجهات السحابة التجارية وحدها يستنزف ميزانيات واجهات برمجة التطبيقات بشكل غير مستدام. تفرض الصناعة اليوم حاجة ملحة لمركز تحكم مفتوح ومستضاف محلياً يوفر عزلاً مادياً لمساحات العمل، وإمكانية الوصول عبر أجهزة متعددة، وتنفيذاً حتمياً للأدوات دون أي تبعية للسحابة.

2. معمارية Paseo: خادم محلي أولاً ومساحات Git Worktrees المدارة

يحل Paseo (github.com/getpaseo/paseo) معضلة التنسيق هذه من خلال طبقة تحكم موزعة تعمل محلياً أولاً. يعمل في صميمه خادم خفيف بلغة TypeScript يشرف على دورات حياة الوكلاء، ويدير مدخلات ومخرجات العمليات، ويوفر قناة ترحيل مشفرة بالكامل من طرف إلى طرف (E2EE) عبر WebSocket لتطبيقات سطح المكتب (Electron) والويب والهاتف المحمول (Expo iOS/Android). 

+─────────────────────────────────────────────────────────────────────────────────────────────────+
|               PASEO + DEEPSEEK HARNESS (DSH) MULTI-AGENT ARCHITECTURE                           |
+─────────────────────────────────────────────────────────────────────────────────────────────────+
|                                                                                                 |
|   [ CLIENT ACCESS MATRIX ]                                                                      |
|   • Desktop (Electron)      • Web Dashboard          • Mobile App (Expo / iOS / Android)        |
|                                       │ (E2EE WebSocket Relay)                                  |
|                                       ▼                                                         |
|   [ PASEO LOCAL CONTROL DAEMON ] (Node / TypeScript)                                            |
|   • Workspace Manager       • Process Supervisor     • Diff / Stream Review Engine              |
|                                       │                                                         |
|               ┌───────────────────────┼────────────────────────┐                                |
|               ▼                       ▼                        ▼                                |
|   [ WORKSPACE: feat/auth ]  [ WORKSPACE: feat/db ]  [ WORKSPACE: test/e2e ]                     |
|   • Worktree: slug-auth     • Worktree: slug-db      • Worktree: slug-tests                     |
|   • Branch: feature/auth    • Branch: feature/db     • Branch: test/e2e                         |
|   • Hook: paseo.json        • Hook: paseo.json       • Hook: paseo.json                         |
|               │                       │                        │                                |
|               ▼ (Direct Provider IPC) ▼ (Direct Provider IPC)  ▼ (Direct Provider IPC)          |
|   [ DEEPSEEK HARNESS (DSH) ] [ DEEPSEEK HARNESS (DSH) ] [ DEEPSEEK HARNESS (DSH) ]             |
|   • Preset: PTC (Reasoning) • Preset: Standard (CRUD) • Preset: Minimal (Test Suite)            |
|   • Cordis Plugin Kernel    • Cordis Plugin Kernel   • Cordis Plugin Kernel                     |
|   • Reversible Registers    • Reversible Registers   • Reversible Registers                     |
|                                                                                                 |
+─────────────────────────────────────────────────────────────────────────────────────────────────+

بدلاً من تشغيل أجهزة افتراضية ثقيلة أو تشغيل قذائف فرعية غير معزولة، يؤسس Paseo عزل مساحات العمل حول مساحات Git Worktrees المدارة والمخزنة حتمياً تحت المسار $PASEO_HOME/worktrees/<hash>/<slug>/.

  • توفير تلقائي للفروع: تتفرع مساحات العمل مباشرة من origin/main أو تقوم بتنزيل طلبات السحب في دليل معزول تماماً يتشارك قاعدة بيانات كائنات .git الأصلية.
  • خطافات دورة حياة مؤتمتة: من خلال ملف paseo.json، يشغّل كل Worktree تلقائياً نصوص تهيئة البيئة (مثل تثبيت التبعيات وإنشاء .env) وإجراءات التنظيف عند الأرشفة.
  • انعدام استهلاك الذاكرة الخاص بالأجهزة الافتراضية: على عكس حاويات Docker التي تستهلك بين 1.5 إلى 3 جيجابايت من الذاكرة العشوائية لكل حاوية، لا يتطلب Git Worktree سوى أقل من 50 ميجابايت من مساحة القرص ويبدأ في أقل من 180 مللي ثانية.

تتيح هذه المعمارية للمهندس تشغيل 3 أو 5 أو 10 وكلاء بالتوازي على نفس الكود البرمجي دون أي مخاطرة بقفل الفهرس أو تعارض الملفات أو استنزاف الذاكرة.

3. داخل DeepSeek Harness (DSH): نواة إضافات Cordis

بينما يوفر Paseo العزل والتنسيق لمساحات العمل، يوفر DeepSeek Harness (DSH) (@deepseek-ai/dsh) محرك الاستدلال الذاتي وتنفيذ الأدوات. يتعامل DeepSeek مع تصميم الوكلاء وفق المبدأ الأساسي: «الوكيل = النموذج + الحزام (Harness)».

تعتمد الأطر التقليدية على برمجة تعريفات الأدوات وحلقات الحالة بشكل جامد داخل فئات أحادية. في المقابل، بُني DeepSeek Harness فوق Cordis، وهو إطار وصفي متقدم قائم على القابلية للتركيب الزماني والمكاني حيث كل شيء عبارة عن إضافة (Plugin):

  • محولات النماذج: موصلات معيارية تدعم DeepSeek V4 Pro وFlash أو خوادم vLLM وOllama المحلية المستضافة ذاتياً.
  • حلقات الوكيل: حلقات تحكم قابلة للتبديل تدير التخطيط والتأمل والاستدعاء التكراري للأدوات.
  • الأدوات والمهارات: حزم ديناميكية تغطي تحليل شجرة الصرف (AST)، وتعديل نظام الملفات، وتنفيذ أوامر Bash، والتكامل مع بروتوكول MCP.
  • الجلسات والتخزين: سجلات أحداث مقتصرة على الإضافة فقط لضمان التدقيق الصارم وعدم تلف الحالة بين التفاعلات.

يتمثل الإنجاز الهندسي الأبرز لنواة Cordis في التسجيلات القابلة للعكس (Reversible Registrations)؛ فعند إلغاء تحميل أي إضافة أو أداة، يتم التراجع تلقائياً عن كافة مستمعي الأحداث وقوالب التوجيه، مما يمنع تراكم الأدوات الشبحية وتلوث السياق.

يحزم DSH هذه القدرات في 4 إعدادات مسبقة متخصصة: Standard (التطوير العام المتوازن)، وPTC (Program-Time Compute) (الاستدلال المعمق وإعادة الهيكلة المعمارية)، وMinimal (حلقات الاختبار المعزولة منخفضة التوكينات)، وCreator (بناء النماذج الأولية السريعة).

4. مزود Direct مقابل ACP: جسر الاتصال فائق السرعة

يعتمد ربط بيئات تشغيل الوكلاء الخارجية عادةً على بروتوكول عميل الوكيل (ACP). ومع ذلك، تكشف الاختبارات العملية أن بروتوكول ACP يشكل عنق زجاجة ضيقاً؛ حيث يسطح عمليات التفكير المتدفقة، ويحذف بطاقات واجهة المستخدم التفاعلية، ويقيد التوجيه أثناء التشغيل.

لتجاوز هذه العقبات، طوّر مجتمع المصادر المفتوحة إضافة paseo-dsh-direct (بواسطة Jecvay)، وهو جسر مباشر يربط DSH مباشرة بقناة الاتصال الداخلي (IPC) في Paseo:

  1. مؤشر جهد الاستدلال في الوقت الفعلي: يعرض ويدفق سلسلة التفكير الداخلية لنموذج DeepSeek V4 دون ضغطها في نصوص عادية.
  2. بطاقات الأسئلة التفاعلية ask_user_question: تعرض بطاقات خيارات منظمة ونوافذ تأكيد في واجهة Paseo لتوضيح المتطلبات بنقرة واحدة.
  3. بوابة التخطيط المسبق للبناء (Build vs. Plan): تلزم الوكيل بتقديم خطة تنفيذ رسمية لموافقة المطور قبل تشغيل أوامر الطرفية الحساسة.
  4. التوجيه أثناء التنفيذ (In-Flight Steer): يتيح للمهندسين مقاطعة وتوجيه الوكيل أثناء تفكيره دون إعادة ضبط الجلسة أو تدمير السياق.

بالإضافة إلى ذلك، يوفر paseo-dsh-direct استمرارية أصلية للجلسات، مما يتيح استيراد سجلات التشغيل السابقة مباشرة من ~/.dsh/sessions وإعادة عرضها في عارض الفروق في Paseo.

5. المقاييس المعيارية: بصمة العتاد وانخفاض تكاليف الحوسبة بنسبة 90%

للتحقق من الكفاءة التشغيلية لمزيج Paseo وDSH، أجرينا اختبارات معيارية تحاكي دورة عمل حقيقية في بيئة مؤسسية: إعادة هيكلة خدمات FastAPI المصغرة، وتحديث مخططات Pydantic، وكتابة اختبارات التكامل الشاملة عبر 4 وكلاء متزامنين. 

+─────────────────────────────────────────────────────────────────────────────────────────────────+
|            Table 1: Multi-Agent Concurrency & Isolation Benchmark (4 Concurrent Agents)         |
+──────────────────────────┬──────────────┬──────────────────┬──────────────┬─────────────────────+
| Concurrency Strategy     | Cold Latency | Resident RAM (4x)| Disk Delta   | Merge & Git Safety  |
+──────────────────────────┼──────────────┼──────────────────┼──────────────┼─────────────────────+
| Single Directory (Raw)   | Instant (0s) | ~220 MB          | 0 MB         | ❌ 100% Lock Fail   |
| Docker / MicroVM (e2b)   | 4.2s ~ 7.8s  | 7.4 GB ~ 12.0 GB | 4.8 GB       | ⚠️ Complex Remote   |
| Paseo Managed Worktree   | < 180 ms     | < 340 MB (Shared)| ~120 MB      | ✅ Native Clean PR  |
+──────────────────────────┴──────────────┴──────────────────┴──────────────┴─────────────────────+

كما يوضح الجدول رقم 1، يحقق عزل Git Worktree في Paseo سرعة بدء أسرع بـ 23 ضعفاً ويستهلك ذاكرة وصول عشوائي أقل بنسبة 95% مقارنة بحاويات MicroVM الافتراضية مع القضاء التام على أقفال Git. 

+─────────────────────────────────────────────────────────────────────────────────────────────────+
|               Table 2: 3-Agent Parallel Sprint Financial ROI (4.5M Total Tokens)                |
+──────────────────────────┬───────────────┬────────────────┬───────────────┬─────────────────────+
| Model / Harness Setup    | Input Tokens  | Output Tokens  | Total Cost    | Effective Savings   |
+──────────────────────────┼───────────────┼────────────────┼───────────────┼─────────────────────+
| Claude Opus 5.5 (CLI)    | $14.00 (3.5M) | $20.00 (1.0M)  | $34.00        | Baseline (0%)       |
| DeepSeek V4 Pro via DSH  | $0.75 (3.5M)  | $4.95 (1.0M)   | $5.70         | 83.2% Reduction     |
| DeepSeek V4 Flash Hybrid | $0.35 (3.5M)  | $2.10 (1.0M)   | $2.45         | 92.8% Reduction     |
+──────────────────────────┴───────────────┴────────────────┴───────────────┴─────────────────────+

من الناحية الاقتصادية (الجدول رقم 2)، يكلف تشغيل 4.5 مليون توكين عبر جولات البرمجة المتكررة باستخدام Claude Opus 5.5 ما مجموعه 34.00 دولاراً (أو 17.00 دولاراً باستخدام Claude Sonnet 5.5، بينما يرتفع ليتجاوز 120 دولاراً مع نماذج الاستدلال الرائدة مثل GPT 6.1 SOL). بينما يؤدي تشغيل DeepSeek V4 Pro عبر DSH مع التخزين المؤقت للمطالبات إلى خفض التكلفة الإجمالية إلى 5.70 دولاراً فقط — بانخفاض فوري قدره 83.2% مقارنة بنموذج Opus 5.5. وعند استخدام DeepSeek Flash لاختبارات الوحدات والكود الروتيني، تنخفض النفقات إلى 2.45 دولاراً، محققة وفورات تصل إلى 92.8% (وأكثر من 97% مقارنة بنماذج السحابة الرائدة).

6. دليل الإنتاج خطوة بخطوة: دورة عمل متوازية لـ 3 وكلاء

يتطلب نشر استوديو الوكلاء السيادي الحد الأدنى من التهيئة؛ قم أولاً بتعريف خطافات العزل في ملف paseo.json في جذر المستودع الخاص بك: 

{
  "worktrees": {
    "root": "~/.paseo/worktrees"
  },
  "hooks": {
    "setup": "pnpm install && cp .env.example .env",
    "teardown": "pnpm test:clean"
  },
  "services": {
    "dev": {
      "command": "pnpm dev",
      "port": 3000,
      "proxy": true
    }
  }
}

بعد اكتمال التهيئة، أنشئ ثلاث مساحات عمل متزامنة باستخدام أداة سطر أوامر Paseo: paseo workspace create --isolation worktree --mode branch-off --new-branch feat/auth --worktree-slug auth-service --base origin/main، وكرر الأمر لترحيل قواعد البيانات وكتابة الاختبارات.

في واجهة سطح المكتب لـ Paseo، عيّن الوضع المسبق PTC (Program-Time Compute) لوكيل المصادقة للاستدلال المعمق، بينما تعيّن الوضع Standard لوكلاء الترحيل والاختبار. وأثناء عمل الوكلاء بالتوازي في أدلة معزولة، يمكن للمطورين مراجعة الفروق المجمعة أو الموافقة على طلبات السحب عن بعد عبر تطبيق الهاتف المحمول Expo.

7. مستقبل الاستوديوهات السيادية وفهرسة AgDex

يثبت التكامل بين Paseo وDeepSeek Harness وpaseo-dsh-direct أن مستقبل هندسة البرمجيات المدعومة بالذكاء الاصطناعي لا ينتمي إلى محررات السحابة الاحتكارية المغلقة. إن التنسيق المعياري والمستضاف محلياً يوفر سرعة فائقة، وخصوصية مطلقة، ومزايا اقتصادية لا تقارن:

  • سيادة كاملة على البيانات: الكود البرمجي وسجلات Git والبيانات السرية لا تغادر أبداً البنية التحتية المحلية أو شبكة الشركة الافتراضية.
  • قابلية تبديل النماذج: التبديل بسهولة بين واجهات البرمجة السحابية الرائدة (Claude opus 5.5 و GPT 6.1 SOL و Gemini 4 Argon) والنماذج المحلية دون الحاجة لتغيير بيئة التطوير.
  • التخلص من اشتراكات SaaS الإلزامية: القضاء على رسوم الاشتراكات الشهرية المتكررة لكل مستخدم مع إمكانية زيادة عدد الوكلاء بحرية تامة.

يقوم دليل AgDex.ai بفهرسة هذه الحزمة البرمجية الكاملة إلى جانب مستكشف المعماريات التفاعلي 3-Step Stack Finder، موفراً قوالب بدء موثوقة وقياسات أداء مقارنة لأدوات برمجية مثل Claude Code و DeepSeek لتمكين فرق الهندسة من نشر أسراب الوكلاء المتعددين المستقلة بنجاح.

المراجع والمستودعات مفتوحة المصدر المعتمدة

جميع الأدوات والإضافات المشار إليها في هذا التحليل المعماري مفتوحة المصدر ومتاحة للمراجعة العامة:

• منصة تنسيق Paseo: github.com/getpaseo/paseo (الموقع الرسمي: paseo.sh)
• حزام DeepSeek Harness (DSH): github.com/deepseek-ai/deepseek-harness (npm: @deepseek-ai/dsh)
• إضافة Direct Provider (بواسطة Jecvay): github.com/Jecvay/paseo-dsh-direct
• نواة إضافات Cordis: cordis.moe

الأسئلة الشائعة (FAQ)

س1: كيف تقارن مساحات Git Worktrees في Paseo بحاويات Docker لعزل الوكلاء؟

تنشئ Git Worktrees أدلة مادية خفيفة تشترك في قاعدة بيانات .git دون أي محاكاة افتراضية. تبدأ في أقل من 180 مللي ثانية ولا تستهلك أي ذاكرة إضافية، بينما تتطلب حاويات Docker مساحات تخزين ضخمة لصور النظام وعمليات ربط معقدة للأقراص.

س2: لماذا نستخدم paseo-dsh-direct بدلاً من بروتوكول ACP العام؟

يقوم بروتوكول ACP القياسي بتجريد عناصر التحكم المتقدمة الخاصة بالنموذج. يوفر paseo-dsh-direct وصولاً أصلياً لضبط زمن الاستدلال في DeepSeek V4، وبطاقات الأسئلة التفاعلية بخيارات قابلة للنقر، وبوابات الموافقة المسبقة على خطة التنفيذ.

س3: هل يمكن تشغيل بيئة الوكلاء المتعددين هذه بشكل كامل دون اتصال بالإنترنت؟

نعم. كل من Paseo وDeepSeek Harness مستضافان ذاتياً بنسبة 100%. ومن خلال ربط DSH بخوادم استدلال محلية مثل vLLM أو Ollama بنماذج DeepSeek أو Qwen Coder المكممة، يمكنك تشغيل استوديو تطوير معزول تماماً ومجاني التكلفة.

س4: كيف يدعم Paseo المراجعة والتوجيه عبر الهاتف المحمول أثناء الابتعاد عن المكتب؟

يتضمن Paseo قناة ترحيل مشفرة بالكامل من طرف إلى طرف عبر WebSocket تربط الخادم المحلي بتطبيق الهاتف المحمول Expo (iOS/Android). يمكن للمطورين فحص الفروق المباشرة، والإجابة على استفسارات الوكيل، وتوجيه المهام بأمان عبر شبكات الهاتف المحمول.