Skip to content

bestdeejay-design/agent-skills / skills/dsh-runner

dsh-runner

Verified

Запуск автономных агентных задач через DeepSeek Harness (dsh) — изолированные workspace, JSONL-логи сессий, параллельные прогоны. Скрипт dsh_task.py генерирует конфиг и запускает агента через Python SDK (jsonrpc-agent): задача → workspace → harness.run(prompt) → отчёт с final_response и логом. Режимы: headless-задача одной командой, Web UI (npx @deepseek-ai/dsh web), сравнение моделей. Ключ: DEEPSEEK_API_KEY (env) или автоматически из auth.json opencode (провайдер deepseek), либо OpenAI-совместимый endpoint через DEEPSEEK_BASE_URL. Триггеры: 'dsh', 'deepseek harness', 'агент в песочнице', 'изолированный агент', 'запусти агента на репо', 'агентная задача', 'агент-исполнитель', 'harness run', 'agent harness', 'запустить dsh', 'автономная задача агентом', 'параллельные агенты', 'сравнить модели на задаче', 'jsonrpc-agent'.

FileKindSize
SKILL.mdskill md8.9 KB
references/runbook.mdmarkdown4.8 KB
scripts/dsh_task.pyscript5.0 KB
skill.jsonconfig2.4 KB

scripts/dsh_task.py

View on GitHub
#!/usr/bin/env python3
"""dsh_task.py — запуск одной агентной задачи через DeepSeek Harness SDK.

Требует: deepseek-harness-sdk (pip install), DEEPSEEK_API_KEY или
DEEPSEEK_BASE_URL (OpenAI-совместимый endpoint).

Ключ ищется в таком порядке:
  1. env DEEPSEEK_API_KEY
  2. auth.json opencode (провайдер `deepseek`) — ~/.local/share/opencode/auth.json,
     затем ~/.config/opencode/auth.json

Пример:
  DEEPSEEK_API_KEY=sk-... python3 dsh_task.py \
    --workspace /tmp/ws/repo --session-root /tmp/sessions \
    --session-id fix-001 "Почини падающий тест."

Exit codes: 0 = задача завершена (final_response есть), 2 = ошибка запуска.
"""
from __future__ import annotations

import argparse
import json
import os
import sys
from pathlib import Path


OPENCODE_AUTH_CANDIDATES = (
    Path.home() / ".local" / "share" / "opencode" / "auth.json",
    Path.home() / ".config" / "opencode" / "auth.json",
)


def load_deepseek_key_from_opencode() -> str | None:
    """Читает ключ DeepSeek из auth.json opencode (без вывода в логи)."""
    for auth_path in OPENCODE_AUTH_CANDIDATES:
        try:
            data = json.loads(auth_path.read_text(encoding="utf-8"))
        except (OSError, json.JSONDecodeError):
            continue
        provider = data.get("deepseek") or {}
        key = provider.get("key")
        if isinstance(key, str) and key.strip():
            return key.strip()
    return None


def resolve_api_key() -> str | None:
    """Возвращает ключ из env или auth.json opencode, либо None."""
    env_key = os.environ.get("DEEPSEEK_API_KEY")
    if env_key and env_key.strip():
        return env_key.strip()
    if os.environ.get("DEEPSEEK_BASE_URL"):
        return None
    return load_deepseek_key_from_opencode()


def parse_args() -> argparse.Namespace:
    p = argparse.ArgumentParser(description="Run a single agent task via DeepSeek Harness SDK")
    p.add_argument("--workspace", required=True, help="absolute path to the task workspace (agent's cwd)")
    p.add_argument("--session-root", required=True, help="absolute path where session logs are stored")
    p.add_argument("--session-id", default="task-001", help="unique session id (per task)")
    p.add_argument("--model", default=None, help="model id; default from DSH_MODEL or deepseek-v4-flash")
    p.add_argument("--provider", default=None, help="provider id; default 'deepseek-official'")
    p.add_argument("--max-tokens", type=int, default=49152, help="max model tokens per task")
    p.add_argument("--cordis", default=None, help="path to cordis composition yml (jsonrpc-agent minimal by default)")
    p.add_argument("prompt", help="the task prompt for the agent")
    return p.parse_args()


def main() -> int:
    args = parse_args()
    workspace = Path(args.workspace).resolve()
    session_root = Path(args.session_root).resolve()
    session_root.mkdir(parents=True, exist_ok=True)

    if not workspace.is_dir():
        print(f"[dsh_task] workspace does not exist: {workspace}", file=sys.stderr)
        return 2

    api_key = resolve_api_key()
    if not api_key and not os.environ.get("DEEPSEEK_BASE_URL"):
        print(
            "[dsh_task] no DEEPSEEK_API_KEY found: set the env var, or run "
            "`opencode auth login` / add the `deepseek` provider to opencode auth.json",
            file=sys.stderr,
        )
        return 2
    if api_key:
        source = "env" if os.environ.get("DEEPSEEK_API_KEY") else "opencode auth.json"
        os.environ["DEEPSEEK_API_KEY"] = api_key
        print(f"[dsh_task] DEEPSEEK_API_KEY from {source}")

    model = args.model or os.environ.get("DSH_MODEL", "deepseek-v4-flash")
    provider = args.provider or os.environ.get("DSH_PROVIDER", "deepseek-official")

    try:
        from deepseek_harness import DeepSeekHarness  # type: ignore
    except ImportError:
        print("[dsh_task] pip install deepseek-harness-sdk first", file=sys.stderr)
        return 2

    kwargs: dict = {
        "provider": provider,
        "model": model,
        "max_tokens": args.max_tokens,
        "cwd": str(workspace),
        "session_root": str(session_root),
    }
    if args.cordis:
        kwargs["cordis"] = args.cordis

    print(f"[dsh_task] workspace={workspace} model={model} session_id={args.session_id}")
    try:
        with DeepSeekHarness(**kwargs) as harness:
            result = harness.run(args.prompt, session_id=args.session_id)
    except Exception as exc:  # SDK is preview; surface raw error
        print(f"[dsh_task] harness error: {exc}", file=sys.stderr)
        return 2

    report = {
        "session_id": getattr(result, "session_id", args.session_id),
        "final_response": getattr(result, "final_response", ""),
        "finish_reason": getattr(result, "finish_reason", None),
        "session_root": str(session_root),
    }
    print(json.dumps(report, ensure_ascii=False, indent=2))
    return 0


if __name__ == "__main__":
    sys.exit(main())
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall