mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
db9217a481
Adds the Detailed design block: the mode/set vocabulary (no provenance field — cause is log-adjacent; bare-string mode names), ModeConfig with an explicit resolve step, the cursor-cached fold + ctx.modes service with turn/start|step/end pending flush, the computed mode:policy section (order 50) + post-next() assembly filter (exit_plan_mode visible IFF plan mode — what keeps default-mode assemblies byte-identical), the fold-only gate with its ask on exit_plan_mode (no dsh-approval dependency — the registry routes), the exit tool contract and render intent, dependency edges and the stdio/ACP surfaces, the input.json setMode op + plan-mode/plan-mode-reject scenarios (mode set before turn 1 → the initial header snapshot is already in plan shape; the widening delta appears at exit), and the mechanical tail. Consistency fixes: the plan allowlist names real tools (no grep tool exists); the re-widen risk now states the post-next() mechanism instead of a listener-order convention.
DeepSeek Harness
English | 中文
The DeepSeek Harness SDK is a plugin-based SDK for building agent harnesses.
Development
This monorepo is built on the Cordis framework (vendored as source under vendor/), microkernel-style: everything is a plugin.
pnpm install
pnpm run test # vitest
pnpm run demo:repl # REPL agent demo (needs DEEPSEEK_API_KEY)
pnpm run demo:acp # ACP server agent demo (needs DEEPSEEK_API_KEY)
For humans, start with the development guide for local setup, hooks, environment variables, and quality gates, then read the architecture design and documentation graph index before package work. Local context lives in packages/ and vendor/.
For agents, follow AGENTS.md.