deepseek-ai/deepseek-harness
48.8
Weak · 21 October 2026
484.2k
lines of production code
TypeScript
primary language
3
measurements over time
What this system is
This system is the DeepSeek Harness, a modular, cross-platform agent runtime that manages the lifecycle of AI agents through a plugin-based architecture. It provides a unified CLI and desktop interface to execute agent profiles, handling session persistence, tool execution, and sandboxed process confinement across Linux, macOS, and Windows. The platform supports diverse interaction modes, including web, headless, and programmatic automation via ACP and SDKs, while enforcing strict performance budgets and security constraints.
Features
Add active-stream-reconnect benchmark for Node.js client performance
A new benchmark suite has been added to measure the performance of the production Client during a reconnect event while an active Assistant stream is in progress. Specifically, it measures the time and memory impact of reconstructing a 100,000-delta reasoning prefix using the private \ClientAssistantStream.replace()\ adapter in a Node.js environment. The benchmark enforces a 125 ms time budget and a 30 MiB retained heap budget, ensuring that reconnect operations remain efficient without impacting browser rendering metrics.
benchmarks/active-stream-reconnect · high confidence
Add macOS and Windows packaging configuration templates
Added example environment configuration files for macOS and Windows desktop packaging workflows. These templates (macos-signing.env, production.env, test.env, and windows-signing.env) define the necessary variables for code signing, notarization, auto-update origins, and signature caching, enabling developers to configure and run signed CI packaging locally or on self-hosted runners.
apps/desktop/config · high confidence
Desktop Host runtime and CLI integration
The Desktop Host now runs as a standalone Node.js process that launches the Web UI and communicates with the Electron shell via IPC. This change introduces a bundled CLI entry point that uses the Desktop's internal pnpm to manage plugins and profiles, and adds a module hook to resolve the bundled LibreOffice engine from the ASAR archive so native child processes can access it. The host also implements update and quit inspections, allowing the shell to check for active tasks and scheduled reminders before applying updates or quitting, and publishes platform session credentials to the shell for account sign-in.
apps/desktop-host/src · high confidence
Desktop build configuration and documentation
The desktop application now includes example environment files for macOS and Windows to configure build-time settings such as signing identities, notarization proxies, and update origins, alongside a comprehensive bilingual README documenting the application's architecture, installation, and development workflows.
apps/desktop · high confidence
Document the ACP subagent backend and subagent package family
This change adds the English and Chinese README documentation for the \subagent\ package group and the \@deepseek-ai/dsh-subagent-acp\ out-of-process backend. The package-level README introduces the subagent capability family, detailing the delegation service, in-process and out-of-process backends, and model-facing tools. The ACP-specific README provides configuration instructions, explains the process isolation model, and outlines the provider's limitations, such as the lack of optional start-time capabilities and the requirement for a fresh process per run.
packages/subagent · high confidence
Documentation site with Markdown actions and fullscreen media viewers
The website directory now hosts a VitePress-based documentation site that includes a publication manifest for routing and sidebar generation, a custom build script that cleans output safely, and a default theme extending VitePress. The theme adds page-level Markdown actions (copy the current page as Markdown or view it as raw text), a shared fullscreen media viewer for images and Mermaid diagrams with pan/zoom controls, and fixes for code-group rendering in MPA builds and search excerpts.
website · high confidence
Establishes the standalone Web application shell and build configuration
The \apps/web\ directory now contains the core entry point for the web interface, including \index.html\ with media-qualified dark/light favicons and a PWA manifest, alongside a \vite.config.ts\ that configures the build for ES2022, splits heavy rendering dependencies (KaTeX, Shiki, Markdown parsers) into a cached vendor chunk, and enforces that the app is served only through the host environment. A new \product-isolation.ts\ plugin ensures build integrity by capturing chunk inputs and verifying that no experimental or unauthorized assets are included in the final bundle.
apps/web · high confidence
Exclusive provider registration for computer-use capability
The \packages/computer-use\ group now provides a shared registration service (\@deepseek-ai/dsh-computer-use\) that enforces a single-provider model: only one desktop provider can be registered at a time, and attempts to register a second provider will fail. This registry manages the lifecycle of the provider slot, ensuring that resources are properly released when a provider unloads, while keeping the actual provider implementations (such as the Cua Driver variants) in the experimental group.
packages/computer-use · high confidence
Initialize repository infrastructure and documentation
The repository is initialized with the foundational tooling and documentation required for development. This includes setting up the monorepo structure with pnpm workspaces, configuring Oxlint for TypeScript linting, and establishing git hooks via lefthook to enforce translation pairing, linting, and type-checking. Standard documentation files such as README, CONTRIBUTING, SAFETY, and Brand Guidelines are added in both English and Chinese, alongside configuration for text encoding (.editorconfig, .gitattributes) and code duplication detection (.jscpd.json).
(repo-wide) · high confidence
Introduce @deepseek-ai/dsh-agent-instructions plugin for workspace guidance
The \packages/context\ group now includes the \agent-instructions\ plugin, which loads user-global and project-level \AGENTS.md\/\CLAUDE.md\ files as durable, model-visible context. The plugin injects a baseline instruction message on the first request and dynamically updates the context when files are added, changed, or removed, all while respecting a configurable byte budget (\maxBytes\) to manage token usage. This behavior is enabled by default in the \dsh-base\ profile but can be customized or disabled by users.
packages/context · high confidence
Introduce @deepseek-ai/dsh-subprocess-local provider with native containment and bilingual documentation
The \packages/subprocess\ area now includes the \@deepseek-ai/dsh-subprocess-local\ package, which serves as the local host provider for the shared subprocess service. This provider enables OS-owned managed ranges for child processes and real terminal sessions on supported platforms: it uses transient user-systemd scopes on Linux and Windows Job objects on Windows, falling back to detached process groups or \taskkill\ on unsupported hosts. It features credential-scrubbed environments, bounded output collection with spill-file recovery, and a private runner for native execution. The package also ships with comprehensive English and Chinese documentation (\README.md\ / \README.zh.md\) and a script to ensure the \node-pty\ spawn-helper executable bit is set correctly.
packages/subprocess · high confidence
Introduce @deepseek-ai/dsh-tool-todo for session-level task planning
The \packages/todo\ area now includes the \@deepseek-ai/dsh-tool-todo\ package, which provides the \todo\_write\ tool for agents to maintain a structured, session-level task list. The tool allows agents to add tasks, mark them as pending, in progress, or completed, and updates the list via whole-list replacement on every call. A required configuration flag, \allowParallelInProgress\, lets deployments choose whether multiple tasks can be in progress simultaneously. The tool persists state through a \todos\ session projection and logs \todo/write\ events, ensuring the plan survives across turns and session restarts. Documentation and bilingual translation records for the package and tool have also been added.
packages/todo · high confidence
Introduce @deepseek-ai/node-addon-system for prebuilt Landlock confinement and POSIX flock
The native workspace now includes the \@deepseek-ai/node-addon-system\ package family, providing a prebuilt Linux \landlock-run\ executable for subprocess confinement and a Node-API \system.node\ binding for asynchronous POSIX \flock\ (exclusive, non-blocking) file locking. Consumers can use the \./landlock-run\ entry to resolve the launcher path, build grant arguments, and probe kernel enforcement, or the \./flock\ entry to acquire locks without triggering installation-time compilation. The package ships separate platform binaries for Linux (glibc and musl) and macOS, ensuring that native payloads are installed and verified without requiring a local C compiler.
native · high confidence
Introduce Agent Note tree validation and repository scripts documentation
Added a new \scripts/agent-note-tree.ts\ module that walks the \.agents/notes/\ directory to validate the structure of Agent Notes, enforcing strict lifecycle and class folder rules, date-based filename formats, and rejecting unknown folders or centralized indexes. This is accompanied by a new \scripts/AGENTS.md\ file documenting the repository's gate scripts, their platform-agnostic glob path normalization, and execution policies for specs running in forked workers.
scripts · high confidence
Introduce DeepSeek Harness Python SDK and bundled runtime distribution
The Python area now includes the DeepSeek Harness Python SDK (\deepseek-harness-sdk\) and its platform-specific runtime wheel (\deepseek-harness-runtime-bin\). The SDK communicates with a bundled \dsh\ CLI executable over newline-delimited JSON-RPC on stdio, requiring an explicit \dsh\_home\ and never silently reading \\~/.dsh\. The runtime package ships native executables for Linux x64/arm64, macOS arm64/x64, and Windows x64, including necessary sidecars like the Office kit and spawn helpers, ensuring SDK use requires no system Node.js. Documentation, bilingual translation records, and a runnable minimal example are provided to guide users through installation, profile selection, and plugin customization.
python · high confidence
Introduce DeepSeek Harness SDK for model and Office operations
Added the deepseek-harness Python SDK, providing data models for server communication (models.py) and a synchronous interface for local Office file conversion and image rendering via the runtime CLI (office.py).
deepseek-harness-sdk · high confidence
Introduce DeepSeek request extension registry and separate account/API-key authentication routes
The \packages/llm\ area now includes three new packages: \deepseek-llm-api-extensions\ provides a registry for provider plugins to contribute lifecycle-owned top-level fields to official DeepSeek requests; \llm-deepseek-account\ handles authentication and model discovery using account tokens (mapping 401s to \ACCOUNT\_TOKEN\_INVALID\ and quota errors to \ACCOUNT\_QUOTA\); and \llm-deepseek-api-key\ manages API-key based authentication for the official route. These changes separate credential handling into distinct, independently configurable routes while allowing extensible request metadata injection.
packages/llm · high confidence
Introduce MCP client plugin with automatic reconnection and server-qualified tool naming
The \packages/mcp\ area now includes the \dsh-mcp-client\ plugin, which connects to external Model Context Protocol (MCP) servers and exposes their tools to the model under stable, server-qualified names (e.g., \mcp\_\github\\_create\_issue\). The plugin supports both \stdio\ and \streamable-http\ transports, automatically reconnects after connection drops using a bounded exponential backoff policy (configurable initial delay, max delay, and attempt limits), and ensures that tool definitions are swapped atomically to prevent partial tool leaks. It also registers server instructions as literal text in the system prompt and provides shared resource discovery capabilities.
packages/mcp · high confidence
Introduce Node PTC runtime with persistent in-memory REPL mode
The \ptc-runtime-node\ package now supports an opt-in \persistent-in-memory\ execution mode alongside the default \per-call\ mode. In persistent mode, the runtime retains a confined Node.js REPL across multiple \run\_code\ calls for a specific state owner, preserving top-level variables, functions, and imported modules until the owner is explicitly released or the process exits. This allows model-written code to maintain state between turns, while the default mode continues to start fresh, isolated processes for each execution.
packages/ptc-runtime · high confidence
Introduce POSIX SSH remote execution providers
This change adds the \packages/ssh\ family of providers (\dsh-ssh\, \dsh-fs-ssh\, \dsh-subprocess-ssh\, and \dsh-sandbox-ssh\) that enable running files, processes, terminals, and sandbox enforcement on a remote POSIX SSH host while the Harness remains local. The \dsh-ssh\ package manages the shared OpenSSH connection, authentication, and helper lifecycle, while the companion packages expose \ctx.fs\, \ctx.subprocess\, and \ctx.sandbox\ interfaces that delegate operations to the remote helper. The implementation includes bilingual documentation (English and Chinese) and tests to verify remote filesystem semantics, subprocess stream handling, and sandbox policy enforcement.
packages/ssh · high confidence
Introduce TypeScript SDK client for out-of-process Harness runtime
The \packages/sdk/client\ directory now contains the \@deepseek-ai/dsh-sdk-client\ package, providing a TypeScript interface to drive a DeepSeek Harness runtime from a separate process. It exposes \DeepSeekHarness\ for high-level agent turn execution and \HarnessClient\ for direct JSON-RPC protocol control over stdio. The client manages the lifecycle of the runtime subprocess, including a robust teardown ladder (stdin EOF, SIGTERM, SIGKILL) and typed error handling for transport, timeout, and protocol failures.
packages/sdk · high confidence
Introduce \`dsh\` as the unified Node application launcher
The \dsh\ command is now the sole supported Node application launcher, replacing previous entry points. It boots profiles—ordered stacks of plugin-bundle patch layers with user overrides—rather than separate public binaries for SDK or ACP. The CLI parses only its own flags and forwards remaining arguments to the booted profile, supporting entry modes like \web\, \headless\, \sdk\, \sdk-minimal\, and \acp\. Profiles can be created from shipped templates using \--from-default-profile\, and plugin management is handled via \dsh plugin\ (forwarding to pnpm). Configuration trees can be inspected without booting using \--dump-config\ or \--dump-default-config\, and JSON Schema for configuration entries is available via \--dump-config-schema\.
apps/cli · high confidence
Introduce adaptive directory-picker chooser and browse backend documentation
The \packages/host\ area now includes the \directory-picker-auto\ package, which acts as an adaptive chooser that resolves the correct directory-picking backend at boot time. It inspects the host environment—checking for loopback-only binding, SSH launch status, and display session availability—to mount either the \native\ backend (for local OS dialogs) or the \browse\ backend (for in-app browsing). This entry documents the chooser's resolution logic, the \browse\ backend's capabilities for remote clients, and the overall \host/\ package group structure, ensuring users understand how the system selects the appropriate directory-picking interaction based on the deployment context.
packages/host · high confidence
Introduce authorization seam for human-guided credential acquisition
The \credentials/\ package group now includes a new \authorization\ sub-package that enables plugins to obtain credentials requiring human interaction, such as OAuth sign-ins or code entry. This seam allows a plugin to register a flow for a specific credential key, which then guides the user through prompts and notices via the \AuthorizationSession\. The system ensures that a credential is only reported as authorized after the flow has successfully committed the record to the store, and it enforces a one-attempt-per-key lifecycle to prevent race conditions. This change provides a structured way to handle credentials that cannot be supplied purely through configuration files or environment variables.
packages/credentials · high confidence
Introduce backend continuation performance benchmarks
Added a new benchmark suite in \benchmarks/agent-continuation\ to measure long-history request processing, cold tool-heavy continuation, and inactive fork-child discovery. The suite includes workers for request history, tool continuation, and child catalog operations, alongside an end-to-end SDK profile benchmark that exercises real file reads through the \sdk-minimal\ profile. It enforces specific performance budgets (e.g., 297 ms for request history, 1,125 ms for tool continuation) and validates that synthetic session histories correctly preserve system heads during continuation.
benchmarks/agent-continuation · high confidence
Introduce bash-local and bash-sandbox executors with bilingual documentation
The shell package now includes the \@deepseek-ai/dsh-bash-local\ and \@deepseek-ai/dsh-bash-sandbox\ executors, providing POSIX command execution via \bash -c\ (unconfined) and confined through the sandbox capability, respectively. These executors register under \ctx.shell\ and support configurable budgets for timeouts, output caps, and spill files, with runtime-adjustable settings. The change also adds comprehensive English and Chinese README documentation for these packages, along with bilingual-pair consistency records to ensure translation integrity.
packages/shell · high confidence
Introduce declarative agent preset registry with composition auditing
The \packages/preset\ area now includes the \agent-preset-registry\ package, which manages the selection and runtime revisions of agent capabilities through declarative YAML configurations. This registry allows a single process to run multiple agent compositions, retaining the specific composition for existing agents while applying new definitions to new sessions. It includes robust activation auditing to detect import failures, missing services, and service leaks, ensuring that failed definitions remain visible in the roster without breaking the system. The package also provides bilingual documentation (English and Chinese) and a translation consistency record to maintain documentation integrity.
packages/preset · high confidence
Introduce dsh profile bundles for base, ACP, headless, and SDK surfaces
The \packages/bundle\ area now ships a set of installable profile bundles (\dsh-base\, \dsh-acp-app\, \dsh-headless\, \dsh-web-app\, \dsh-sdk-app\, and \dsh-sdk-minimal\) that define the plugin layers for each \dsh --profile\ surface. \dsh-base\ provides the shared core (model access, tools, durable sessions, and safety defaults), while the other bundles layer surface-specific behavior on top of it. The \acp-app\ bundle configures an automation-only ACP stdio application with a coding-agent persona, while \headless\ provides a one-shot task runner with JSON event streaming and session adoption. Each bundle is declared via a \dsh.bundle.patch\ manifest field pointing to a \cordis.patch.yml\ file, and includes bilingual documentation and tests to verify the patch structure and platform-specific shell gating.
packages/bundle · high confidence
Introduce dual-face client module system with HMR and lazy loading
The client module system is now a dual-face package: the Node half scans for \dsh.client\ declarations, composes a \window.\_\_DSH\BOOT\\_\ graph, and serves combo scripts, while the browser half implements a lazy CJS module table with code replacement and style cleanup. This enables Hot Module Replacement (HMR) for plugins, lazy-loading of split bundles on demand, and recovery from failed batch scripts with import error recording.
packages/client/modules/src · high confidence
Introduce durable local image and file attachment storage
The \packages/attachment\ area now includes the \@deepseek-ai/dsh-attachment-local\ package, which provides durable, content-addressed storage for image and generic file attachments below \DSH\_HOME\. Images are validated against admission limits (up to 20 MiB per image, 64M pixels, 8192px per side), normalized to a provider-independent 8-bit sRGB format (WebP for alpha, JPEG for opaque) using a shared quality ladder, and stored with fsync durability and deduplication. Generic files are stored verbatim with integrity verification. The package exposes configuration for storage paths, admission limits, normalization policies, and compression concurrency, and includes comprehensive bilingual documentation (English and Chinese) detailing usage, implementation internals, and known limitations.
packages/attachment · high confidence
Introduce durable, host-owned scheduled reminders
The \packages/schedule\ package now provides a host-owned scheduling system that persists one-shot, fixed-rate, daily, weekly, and cron reminders across host restarts. These reminders are delivered as follow-up messages within the original conversation session rather than via external channels. The package includes the core scheduling service, a tool layer for managing tasks (create, list, update, delete), and documentation detailing the new task management capabilities and delivery contracts.
packages/schedule · high confidence
Introduce exclusive provider registration for browser and computer-use capabilities
Added \@deepseek-ai/dsh-browser-use\ and \@deepseek-ai/dsh-computer-use\ packages to manage exclusive provider registration for web and desktop automation. These services enforce a single-provider-per-session constraint, ensuring that only one browser or computer-use backend is active at a time. They provide typed identity brands (\BrowserUseProviderName\, \ComputerUseProviderName\) and lifecycle-aware disposers that automatically release the registration slot when a provider plugin unloads.
packages/core · high confidence
Introduce experimental Agent Teams collaboration bundle
The \@deepseek-ai/dsh-experimental-agent-team-profile\ package is now available in the experimental group. This bundle enables Agent Teams collaboration, tools, and Web UI in a single layer. It replaces the standard subagent delegation tools (\subagent\, \subagent\_fork\) with Team-scoped tools (\spawn\_teammate\, \list\_agents\, \send\_message\, \interrupt\_agent\) and provides a shared task board and direct messaging between named teammates. The bundle ships disabled by default and must be explicitly enabled via the Plugins page or profile configuration.
packages/experimental · high confidence
Introduce human \`/goal\` command and same-session goal-round driver
This change adds the \@deepseek-ai/dsh-command-goal\ package, which provides a \/goal\ slash command for users to create, edit, pause, resume, clear, and inspect the current goal directly in the UI without consuming a model turn. It also introduces the \@deepseek-ai/dsh-goal-round-driver\ package, which automatically continues an active goal in the same session by scheduling sequential rounds while the agent is idle, subject to a configured round cap. The entry includes the implementation and bilingual documentation (English and Chinese) for both packages, as well as the group-level README for \packages/goal\.
packages/goal · high confidence
Introduce local filesystem backend with atomic writes and Windows DACL preservation
The \packages/fs\ area now includes the \@deepseek-ai/dsh-fs-local\ package, providing a host-filesystem implementation for the \ctx.fs\ contract. This backend supports reading, listing, watching, and atomically writing or editing files, with relative paths resolving from a configurable base directory. It enforces per-file concurrency via a FIFO lock to serialize mutations and preserves file permissions and Windows DACLs during atomic replacements. The package also introduces a \diffBasisMaxBytes\ configuration option to bound the size of overwrite diffs, and includes bilingual documentation (English and Chinese) for the package group and the local backend.
packages/fs · high confidence
Introduce local per-platform sandbox backends for Linux, macOS, and Windows
The \packages/sandbox\ area now includes the \@deepseek-ai/dsh-sandbox-local\ package, which provides the platform-specific runners for process confinement. On Linux, it selects between \bwrap\ and Landlock; on macOS, it uses Seatbelt; and on Windows, it mounts the new \sandbox-windows-acl\ restricted-token runner. The provider automatically probes available runners, reports enforcement completeness (full vs. partial), and fails closed with \SANDBOX\_UNAVAILABLE\ if no backend is usable. This change also adds bilingual documentation (English and Chinese) for the sandbox package group and its local backend, along with integration tests for the Linux runners.
packages/sandbox · high confidence
Introduce local spill backend with startup cleanup and bilingual documentation
The spill package now includes a local filesystem backend (\@deepseek-ai/dsh-spill-local\) that saves oversized text to private, session-scoped files and provides a one-shot startup cleanup to reclaim expired files. This backend registers as the \ctx.spillStore\ service and is accompanied by comprehensive English and Chinese documentation (\README.md\ and \README.zh.md\) along with translation consistency records (\README.i18n.yaml\).
packages/spill · high confidence
Introduce native desktop account backend and command management infrastructure
The desktop application now includes a dedicated native account backend that manages sign-in attempts, credential state, and WebSocket-based state streaming without exposing credentials to the renderer. A new backend controller serializes child process startup and teardown, ensuring stable availability reporting. Additionally, a command management system has been added to handle reversible installation of CLI command links on macOS and Windows, including ownership verification, backup preservation, and native dialog presentation for user confirmation.
apps/desktop/src · high confidence
Introduce native welcome window and embedded mandatory update dialogs
The desktop renderer now uses a dedicated native welcome window (welcome.html) with React-based UI and shared assets, replacing the previous web-based welcome flow. Additionally, mandatory update prompts are now rendered as embedded HTML/JS dialogs (mandatory-update.html) within the main window, featuring a local loading placeholder (policy-login-loading.html) to prevent blank screens during policy login, and a separate generic update dialog (update-dialog.html) for non-mandatory updates.
apps/desktop/renderer · high confidence
Introduce persistent interactive shell backend with bounded output and readiness detection
The \packages/terminal\ area now includes the \@deepseek-ai/dsh-terminal-bash\ package, which provides a persistent interactive shell backend supporting both bash (POSIX) and pwsh (Windows). This backend allows agents to maintain interactive shell and REPL sessions across tool calls, preserving state such as the working directory, environment variables, and running child processes. It features a line-oriented output contract with bounded reads, a heuristic readiness model that detects when the shell is ready for input (using prompt markers and output silence), and incremental scrollback retention. The implementation includes a streaming control-sequence sanitizer, a sandbox-mode fence to prevent permission downgrades while sessions are active, and configuration options for timeouts, polling intervals, and output bounds.
packages/terminal · high confidence
Introduce plan mode for pre-execution agent planning and review
The \packages/plan\ area now provides a plan mode feature that guides the agent to explore and design before executing. Users can enter this mode with the \/plan\ command (optionally with instructions, images, or files) and leave it with \/plan off\. When the agent has a finished plan, it calls the \exit\_plan\_mode\ tool, which presents the plan for user review; the user can approve to proceed or request further planning. The mode is configured via a deployment-owned guidance section, persists across session resumes and forks, and is tracked via a durable session projection.
packages/plan · high confidence
Introduce process-local background job registry with bounded output retention
The \jobs\ package now includes \@deepseek-ai/dsh-jobs-local\, a process-local implementation of the background-job registry that allows agents to run long-running tools without blocking their own turn. This registry manages job lifecycle, concurrency limits (defaulting to 10 per owner), and bounded output retention (256 KB live, 16 KB settled) using a ring buffer that preserves unread model output until the first terminal read. It features a scoped event hub for delivering completion notices and output events to specific agents or scopes, ensuring that one agent never sees another's work and that completion is delivered in-session rather than polled. The implementation is designed for in-process use, with records dying when the harness process exits.
packages/jobs · high confidence
Introduce schema-validated, change-emitting KV domains over storage backends
The \storage-domain\ package provides a typed domain layer that sits on top of the storage backends (\storage-json\, \storage-sqlite\). Host packages can now declare domains with \defineDomain\—specifying a name, version, and Zod schemas for tables and an optional global singleton—and open them via \ctx.storageDomain\. Reads are synchronous from validated in-memory state, while writes are serialized on a per-domain chain, ensuring durability before memory mutation and emitting a \domain/changed\ event. This abstraction allows consumers to work with schema-validated records without touching the underlying medium directly, supporting features like per-record layouts and backup-and-skip policies for invalid records.
packages/storage · high confidence
Introduce semantic checkpoint policy for crash recovery
The new \session-checkpoint-policy\ package ensures that model requests, top-level tool calls, and completed agent steps are durably persisted before they are dispatched or executed. By flushing the session log at these boundaries, the system prevents loss of work during hard crashes: if a crash occurs after a request is logged but before the response arrives, or after a tool call is recorded but before its side effect completes, the session can resume from the last durable state. Tool calls interrupted before dispatch return a specific \ABORTED\_BEFORE\_DISPATCH\ error, and interrupted tool calls recover with an \UNKNOWN\ outcome to prevent blind retries.
packages/session · high confidence
Introduce session-level and per-message feedback capture
Users can now record feedback about the harness's output through two independent channels: a \/feedback\ slash command for free-text session remarks, and a \messageFeedback\ service for rating and annotating individual assistant messages. The session remark is appended as a log-only event, acknowledged with the session and anonymous user IDs, and never reaches the model or changes its context. Per-message ratings, categories, and notes are stored durably with the session, survive restarts, and are also excluded from model history and telemetry. Both feedback types use a fixed category taxonomy and are available in the Web client out of the box.
packages/feedback · high confidence
Introduce shared OTel telemetry service with independent reporting channels
The \packages/telemetry/otel\ package now provides a shared Cordis service (\@deepseek-ai/dsh-otel\) that creates independent OTLP reporting channels for ordinary analytics events and Session logs. Consumers mount the service and call \createEventReporter\ for count-batched ordinary events or \createSessionLogReporter\ for byte-bounded Session logs (capped at 4,000,000 uncompressed bytes). The service does not install a global OTel provider, inherit ambient headers, or auto-collect data; instead, it relies on explicit configuration for endpoints, scopes, resource attributes, and HTTP agents, while the caller retains ownership of authorization, redaction, and channel shutdown.
packages/telemetry · high confidence
Introduce standalone plugin market index generator
A new standalone Node.js application, \@deepseek-ai/dsh-plugin-market-generator\, has been added to generate \index.json\ files for the DSH Discover page. It reads a plain-text list of npm package names and Git repository URLs, then produces a validated index without installing or running the package code. The tool supports options for custom registries, concurrency, timeouts, and icon inlining, and uses a local cache to ensure deterministic, repeatable runs.
apps/plugin-market-generator · high confidence
Introduce stdio-based local language server provider for code navigation
The \packages/lsp\ area now includes the \@deepseek-ai/dsh-lsp-stdio\ package, which allows agents to navigate code (go to definition, find references, read hover) using explicitly configured local language servers. This provider maps file extensions to language identifiers, spawns server processes on demand, and ensures queries are serialized per workspace while reading source files fresh to avoid state retention. It registers against the \ctx.lsp\ seam and exposes these capabilities to the model via the \tool-lsp\ tool, with configurable bounds for message sizes, timeouts, and process termination.
packages/lsp · high confidence
Introduce the \`ralph\` tool for fixed fresh-agent iteration loops
The \packages/workflow\ area now includes the \@deepseek-ai/dsh-tool-ralph\ package, which provides a new \ralph\ tool. This tool runs a foreground, fixed-script loop that spawns a sequence of fresh child agents against a single immutable objective. Each round passes only a bounded structured handoff (summary, evidence, next steps, and blockers) to the next child, while the shared workspace serves as long-term memory. The tool is configurable via \maxRounds\, \maxHandoffChars\, and \maxResultChars\, and it returns a terminal status of \complete\, \blocked\, or \budget-limited\. This complements the existing \workflow\ tool by offering a specialized, deployment-controlled iteration pattern for scenarios where the user explicitly requests fresh-agent loops.
packages/workflow · high confidence
Introduce web search and fetch tools with provider-agnostic configuration
The \packages/web/tool-web\ package now exposes \web\_search\ and \web\_fetch\ tools to the model, allowing agents to discover current information and retrieve page content. The tools are configured via \search\ and \fetch\ booleans (defaulting to true), with deployment-level bounds for result counts (\searchMaxResults\, \searchMaxQueries\) and timeout budgets (\fetchTimeoutMs\, \searchTimeoutMs\). HTML content is converted to Markdown using \turndown\ with GFM support, while strict limits on conversion depth and output size prevent resource exhaustion. Tools remain visible even if the underlying provider (Exa, Perplexity, or DeepSeek) is unavailable, returning structured errors instead.
packages/web · high confidence
Live plugin configuration forms with revisioned edits and secret redaction
The \@deepseek-ai/dsh-settings\ package now provides a \ctx.settings\ API that exposes schema-derived forms for editing plugin configuration fields marked as \.volatile()\. Users can edit these live settings through UI forms, with changes persisted to the active profile's Cordis patch without requiring a plugin remount. The implementation includes structural secret redaction to hide sensitive values from the wire while preserving their presence, and uses a monotonic revision system to refuse stale writes that would overwrite concurrent changes. It also handles migration of legacy \settings.yaml\ files and ensures that higher-priority home patches or command-line overlays cannot be silently overridden by form edits.
packages/settings · high confidence
Native Windows installer with custom UI and improved extraction diagnostics
The desktop installer now uses a native Windows UI instead of the default NSIS skin, featuring DPI-aware scaling, dark/light theme support, and custom-drawn controls (rounded checkboxes, branded art). It also provides more robust extraction handling: it tracks 7-Zip progress smoothly, validates installation paths (rejecting system folders, reparse points, and reserved names), and generates detailed failure reports with 7-Zip output excerpts when extraction fails.
apps/desktop/installer · high confidence
New /compact command and compaction documentation
This change introduces the \@deepseek-ai/dsh-command-compact\ package, which adds a \/compact\ command to chat UIs for on-demand conversation condensation. The command allows users to manually trigger the summarization of older history even when automatic pressure thresholds have not been met, reporting the number of condensed items and estimated tokens saved. It is designed to be backend-independent and integrates with the existing compaction seam. The diff also includes the initial English and Chinese README documentation for the \compaction/\ package group and the \command-compact\ package, detailing usage, configuration, and implementation details.
packages/compaction · high confidence
New ACP automation server package with bilingual documentation
The \packages/acp\ area introduces the \@deepseek-ai/dsh-acp\ package, an automation-only server that exposes persistent DeepSeek Harness agents to programmatic clients over the standard Agent Client Protocol (ACP) via JSON-RPC stdio. This server allows clients to create, list, resume, and close sessions, attach MCP servers, select model options, send text and image prompts, receive semantic updates, and cancel work without human intervention. The implementation includes strict content admission logic in \content.ts\ to validate and persist image attachments, a codec in \codec.ts\ to map harness turn endings to ACP stop reasons, and comprehensive English and Chinese README documentation (\README.md\, \README.zh.md\) detailing the protocol contract, configuration, and known limitations.
packages/acp · high confidence
New API package documentation and account controller implementation
The \packages/api\ area now includes comprehensive bilingual (English and Chinese) README documentation for the Remote API layers, detailing the roles of packages like \gateway\, \remotes\, and various controllers. Additionally, a new \account-controller\ package has been introduced, exposing authenticated Remote operations for account management—including state retrieval, profile/balance queries, bonus notifications, sign-in/sign-out flows, and credential expiry monitoring—along with corresponding unit tests and locale files.
packages/api · high confidence
New React-based welcome page for desktop sign-in
The desktop application now uses a standalone React renderer for the initial welcome and sign-in flow. This change introduces a new \WelcomePage\ component that manages the multi-step process (entry, API key input, and account authentication) with local state, replacing the previous implementation. It integrates with the preload API for credential handling, applies the shared design system theme (including dark mode support), and displays session expiry notices via a shared toast component.
apps/desktop/src/client · high confidence
New benchmark infrastructure for scaled performance reporting and CI budget calibration
The benchmarks/support directory now includes a complete infrastructure for running, measuring, and reporting on benchmark performance. This includes a built-worker launcher that executes compiled JavaScript workers with isolated V8 memory limits and timeouts, ensuring benchmarks run against production artifacts rather than TypeScript sources. A calibration module defines CI time budgets based on a reference machine (Apple M4 Pro) with a 2x time scale and 25% headroom for variance. Machine profiles for various laptops, cloud instances (AWS, GCP, Azure, Alibaba), and CI runners are defined with CPU scores and storage latencies to enable scaling benchmark results across different hardware. A scaling report generator collects timing and memory data, then renders an interactive HTML report that rescales endpoints to different machine profiles, allowing users to visualize performance across various hardware configurations and identify storage-bound versus CPU-bound operations.
benchmarks/support · high confidence
New bounded Office-to-PDF conversion service with configurable resource limits
The \packages/document\ area introduces the \@deepseek-ai/dsh-office-to-pdf\ provider, which converts authorized Office files (DOC, DOCX, XLS, XLSX, PPT, PPTX) into reusable PDFs on the Host. The service uses the \@deepseek-ai/libreoffice-kit\ (version ^0.1.5) and supports both native platform engines and Node WASM fallbacks. It enforces strict resource bounds, including configurable limits for concurrent conversions, input/output byte sizes, and cache retention, while managing a bounded queue with foreground/background priority. The provider exposes a \convert()\ method for direct access and a \render\ Remote method for browser-based requests, ensuring that PDFs are cached by content digest and that source version changes are detected to prevent stale conversions.
packages/document · high confidence
New deliverables subsystem: present tool and workspace-changes recorder
The \packages/deliverables\ group introduces two new Host plugins that record turn-level events for clients to render. The \tool-present\ plugin registers a \present\ tool that allows the model to declare existing files as final deliverables; it validates paths against the Session filesystem, enforces a configurable \maxFiles\ limit (default 8), and emits a durable \deliverables/presented\ session event containing file paths and descriptions without copying file contents. The \workspace-changes\ plugin summarizes files changed during each top-level turn by diffing git working-tree snapshots and capturing whole-file contents around file-tool edits; it emits a \workspace/changes\ session event and serves per-file comparisons (with line counts and diff hunks) to clients while the Session is active. Both plugins include bilingual documentation and tests.
packages/deliverables · high confidence
New desktop packaging and build infrastructure scripts
Added a suite of build scripts in \apps/desktop/scripts\ to manage the Desktop application's packaging lifecycle. This includes \desktop-auto-update-environment\ for resolving update channels and Tencent COS upload targets, \desktop-build-version\ and \desktop-build-version-discovery\ for generating and validating build version numbers, \desktop-build-paths\ for managing build directories, \desktop-build-commit\ for tracking source commit metadata, \desktop-bundle-imports\ for validating bundle dependencies, \cos-operation\ for handling COS uploads with timeouts, \build-installed-update-worker\ for building installed updates, and \command-path.ps1\ for managing the \dsh\ command on Windows PATH.
apps/desktop/scripts · high confidence
New documentation and client-side runtime for dynamic Cordis browser-half packages
The \packages/extensions\ group now includes comprehensive bilingual (English and Chinese) documentation for the extensions subsystem, specifically detailing the \@deepseek-ai/dsh-cordis-client-runner\ package. This package provides the browser-half runtime for dynamic Cordis plugins, enabling the evaluation of browser-side source code into live plugins within the web client. The entry introduces the client-side API catalog, the source evaluation engine (\evaluator.ts\), and the context guard (\guard.ts\) that enforces a whitelist of lifecycle verbs and services for dynamic packages, ensuring they operate within a controlled sandbox alongside the host-side runner.
packages/extensions · high confidence
New documentation and implementation for the slash-command registry
The \packages/interaction\ area now includes the \commands\ package, introducing a plugin-owned slash-command registry (\@deepseek-ai/dsh-commands\) that allows interactive UIs to execute commands directly against an agent without creating model messages. This package supports agent-scoped command shadowing, attachment handling (images and files), and structured lifecycle logging (\command/run\, \command/done\). The change also adds the bilingual (English and Chinese) README documentation for the entire \interaction/\ group and its sub-packages (\commands\, \permission-presets\), along with the translation-pairing consistency records required to maintain them.
packages/interaction · high confidence
New dsh CLI entry point with profile-based boot and plugin management
The CLI now uses a dedicated \dsh\ command-line interface that boots named profiles (such as \web\, \tui\, or \headless\) and forwards remaining arguments to the booted application. Users can initialize new custom profiles from shipped templates using \--from-default-profile\, apply extra configuration overlays via \--patch\, and inspect the composed configuration tree with \--dump-config\ or \--dump-default-config\. A new \plugin\ subcommand allows managing profile dependencies by forwarding arguments to pnpm, including version compatibility checks and explicit exemptions. The launcher also provides \--dump-config-schema\ to output a JSON Schema for profile configuration without mounting the profile, and ensures graceful shutdown with bounded timeouts for long-running surfaces.
apps/cli/src · high confidence
New long-session browser benchmark for 240-turn history performance
Added a new benchmark in benchmarks/long-session-browser that measures browser performance with a synthetic 240-turn session history. The benchmark validates opening, paging, and trajectory navigation against calibrated time budgets (1125 ms, 875 ms, and 650 ms respectively) and verifies that streamed replies can be typed without losing composer focus. It uses Playwright with a headless Chromium instance and a local Web scaffold to replay synthetic history and responses, ensuring that input overlap and rendering opportunities are correctly measured without relying on external models or networks.
benchmarks/long-session-browser · high confidence
New loop-hygiene guard plugins: repeat-tool-reminder and timeout-policy
The \packages/guard\ area now includes two new guard plugins to keep the agent loop productive. The \repeat-tool-reminder\ plugin detects when a model repeats the exact same tool call with identical arguments and injects an advisory reminder to change approach or finish, with configurable thresholds (default 3, 5, 8) and tool scope. The \timeout-policy\ plugin enforces cooperative time limits on tool calls that declare a \timeoutMs\, returning a clear \TOOL\_TIMEOUT\ error to the model when the limit is reached, provided the tool honors the cancellation signal. Both plugins are enabled in the \dsh\ base bundle.
packages/guard · high confidence
New package workspace documentation and build configuration
The packages directory now includes a comprehensive README (with Chinese translation) that maps all npm packages by capability group (e.g., core, shell, web, session), defines release expectations, and links to the generated dependency graph. A new AGENTS.md file establishes package-specific conventions for plugin exports, service access, testing, and documentation requirements. Additionally, a new tsdown.worker.ts utility provides a banner function to ensure the profile resolution bootstrap is loaded correctly in Node Worker bundles before other code executes.
packages · high confidence
New script to encode browser recordings into optimized GIFs
Added \encode\_gif.py\, a command-line tool that converts Playwright video files (WebM) or ordered screenshot directories into GIFs. The script supports trimming, speed adjustment, and final hold durations for videos, as well as custom frame durations for screenshots. It uses ffmpeg and ffprobe to generate a color palette and optimize the output size, enforcing a default 5MB limit. A corresponding test suite validates encoding logic, input validation, and output correctness.
.agents/skills/record-browser-gif/scripts · high confidence
New skill packages: filesystem provider and bundled badge
The \packages/skill\ area introduces two new skill providers. The \skill-filesystem\ package enables agents to discover and load reusable task instructions from local project, custom, and user directories, with support for watching these roots for real-time catalog updates. The \skill-badge\ package provides an optional, bundled 'powered by dsh' attribution skill that can be enabled to add official badges to generated content.
packages/skill · high confidence
New test-support packages and bilingual documentation for agent-loop and client testing
The \packages/test-support\ area now includes the \agent-loop-testkit\ and \client-runtime\ packages, accompanied by their English and Chinese READMEs and translation consistency records. \agent-loop-testkit\ provides a test harness that mounts standard prerequisite services and a production AgentLoop driver, exposing a production Inbox for durable event testing and a process-local mutable Inbox stub for structural tests. \client-runtime\ offers a jsdom-based slot test runtime for browser feature specs and a whole-client tier that boots the web profile's bundle roster with endpoint-named Remote mocks, enabling local DOM assertions and scripted Remote responses without a business Host. These additions establish deterministic, keyless testing infrastructure for repository tests.
packages/test-support · high confidence
New web client entry points and desktop boot integration
The web application now includes a new browser entry point (main.ts) that initializes the AppWebEntry and integrates with the desktop environment via a two-phase boot process, waiting for backend readiness before applying index injections. Additionally, a new preview entry point (preview.ts) allows for worker-host connection in preview mode, and a stub (node-module-stub.ts) prevents Node.js module loading in the browser environment.
apps/web/src · high confidence
Persistent workspace entity registry with session grouping and archival
The \packages/workspace\ package introduces a durable registry for managing an ordered list of named project directories and the sessions that ran within them. Users can create, rename, and reorder projects; sessions are automatically grouped under the project matching their working directory, with validation against stored session headers. The registry supports hiding sessions from the grouping without deleting their history, removing projects (which leaves folders and session data intact), and archiving sessions—optionally stopping active work first via a provider-based event system. A default workspace can be initialized on first use, and the system ensures data integrity through canonical path handling, serialized writes, and recovery markers for interrupted operations.
packages/workspace · high confidence
Python SDK runtime now bundles the dsh CLI and validates platform-specific assets
The Python SDK runtime package now includes the DeepSeek Harness (dsh) CLI as a bundled, platform-specific executable (with sidecars for ripgrep and LibreOffice) rather than relying on a system installation. The runtime automatically selects the correct executable for Linux, macOS, and Windows, and validates that all required authoring resources (Python/Node binaries, Office skill scripts, and metadata) are present and correctly configured before execution. A dev-only Node.js carrier is also available for local development but is excluded from production wheels.
python/sdk-runtime · high confidence
Typert package documentation and generator implementation
The \packages/typert\ area now includes the full implementation of the build-time Typert generator (\@deepseek-ai/dsh-typert-generator\) alongside its bilingual documentation. The generator analyzes TypeScript source types to produce compiler-independent models and runtime artifacts (Zod schemas and declarations) without requiring a live compiler instance at runtime. It supports opt-in publication of Host and Client face artifacts, static workspace analysis, and integration with the \tsdown\ build system. The documentation maps the four core Typert packages—generator, loader, protocol, and registry—and details the generator's capabilities, including its handling of Remote method descriptors, binary results, and Cordis catalog projections.
packages/typert · high confidence
Vendor Cordis framework source with local hardening and tooling support
The \vendor/\ directory now contains source-vendored copies of the Cordis framework and its plugins (scoped as \@deepseek-ai/\*\), replacing external npm dependencies to give the harness full ownership of the framework layer. This includes a manifest of upstream versions, regenerated build configs, and extensive local modifications: lifecycle hardening in \cordis/src/fiber.ts\ to prevent reentrant disposal gaps, resilient file refresh and patch reapplication in the \include\ plugin, module-watcher readiness fixes in \hmr\, and lazy config resolution across the loader. The vendor also exposes \applyEntryPatches\ and the \!!js\ YAML dialect for the \dsh --dump-config\ tool, supports volatile configuration updates without full restarts, and adapts the loader to Node 24.9+ internal API changes.
vendor · high confidence
Vendored Cordis framework and cosmokit utilities with native TypeScript support
The vendor/loader area now includes the Cordis framework and cosmokit utility library as native TypeScript source files, replacing previous compiled or bundled versions. This update introduces a comprehensive set of runtime helpers in cosmokit, including array manipulation (contain, intersection, difference, union, deduplicate, remove, makeArray), object utilities (filterKeys, mapValues, pick, omit, defineProperty), string formatting (capitalize, camelCase, paramCase, snakeCase, formatProperty, sanitize), time constants and parsing, and deep cloning/equality checks. The loader itself gains new configuration capabilities, such as volatile schema support for transactional config updates without full remounts, JavaScript expression interpolation in config files, and service isolation realms (local and global) to manage service implementations across entry boundaries. These changes enable more granular, efficient, and isolated plugin management within the loader.
vendor/loader · high confidence
Web session log export via ZIP download
The \session-log-export\ package introduces a new capability for the Web interface to download a complete session history as a ZIP archive. Users can trigger this export via a new 'Download session log' menu item in the Session Header's more-actions button or by typing the \/export\ slash command. The Host streams the archive, which includes the session's logical logs (as canonical JSONL), all referenced attachments (images and generic files), and sub-session data, while the browser handles the file save. The export is configurable via a \compressionLevel\ setting (default 6) and is scoped to the browser download manager, meaning the user chooses the local destination.
packages/session-query · high confidence
Architecture
Introduce TypeScript build configuration for the desktop host
The desktop-host application now includes explicit build configuration files (tsconfig.json and tsdown.config.ts) to define its compilation settings and bundling strategy. This setup establishes the project's source and output directories, declares dependencies on internal packages such as agent, jobs, workspace, and deepseek-account, and configures the build tool to produce ESM bundles for the main index and CLI entry points targeting Node.js.
apps/desktop-host · high confidence
Behavioural changes
2832 commits (1349 fixes) modifying packages/client
A change to existing behaviour in packages/client — 2832 commits (1349 fixs), 2575 files.
packages/client · medium confidence · unverified
Enhanced HMR error reporting and module dependency tracking
The HMR service now provides detailed, code-frame-formatted error logs for build failures, improving developer debugging experience. Additionally, the service implements a recursive dependency traversal to accurately classify changed files as accepted or declined for reloading, ensuring that only relevant modules are updated while avoiding unnecessary full reloads for external dependencies.
vendor/hmr · high confidence
Skills directory restructured to use a symlink
The \.claude/skills\ location is now a symbolic link pointing to \../.agents/skills\. This change moves the actual skills content to the \.agents\ directory while maintaining the previous path for compatibility, effectively restructuring where skills are stored and accessed within the project.
.claude · high confidence
Fixes
Fixes for read-only spreadsheet preview, VFS Dirent reads, and atomic native addon extraction
This update patches several dependencies to improve stability and correctness in read-only modes and packaged environments. The fortune-sheet library is patched to enable two-axis trackpad panning in read-only spreadsheets, preserve worksheet selections across OPC paths, and correctly display formula values as literal text. The @yao-pkg/pkg prelude is updated to restore support for reading Dirent objects from the virtual file system and to make native addon extraction atomic, preventing race conditions and crashes from partially written files. Additionally, the @electron/osx-sign patch switches from stat to lstat to correctly handle symbolic links during signing, and the pi-ai patch removes premature JSON parsing in streaming tool calls to prevent data corruption.
patches · high confidence
Test coverage
ACP snapshot test infrastructure and fixtures added; Add benchmarks for sent user-text credential masking performance; Add cold Session opening performance benchmarks; Add performance benchmarks for conversation history folding and tool argument preparation; Add session-corpus benchmarks for Session list, search, and fork performance; Add terminal I/O performance benchmarks to bound memory and latency; Added SDK profile end-to-end tests for dynamic tool caching, keyless runtime, and Office CLI discovery; Added client module system tests; Added desktop test coverage and verification documentation; Added desktop test fixtures for update, installation, and platform storage qualification; Added end-to-end tests for the ACP profile; Added end-to-end tests for the Web profile startup, plugin management, and scheduling; Added headless agent end-to-end test suite; Added headless test expectations for goal-tool and subagent-settlement profiles; Added headless test fixtures for CLI snapshot testing; Added headless test fixtures for goal-tools and provider-retry scenarios; Added i18n translation pairing fixtures for Office tests; Added integration tests for packed CLI profiles and official bundles; Added stress test for reasoning chunk rendering performance; Added subagent inheritance test fixtures; Added test fixtures and snapshot runner for the DSH badge skill; Added test fixtures for CLI profile initialization, startup validation, and agent tool execution; Added test fixtures for GitHub webhook real-end-to-end validation; Added test fixtures for client and write packages in the type-model generator; Added test fixtures for remote model domain and service definitions; Added test fixtures for the type-model host package; Added test snapshots for invalid and missing DeepSeek API credentials; Added tests for desktop-host Office engine resolution, session publishing, and quit inspection; Document browser e2e test lane and add preset authoring tests; Expanded CLI test coverage for profiles, boot lifecycle, and agent teams; Updated expected outputs for subagent diagnostic tests; Updated headless profile test expectations; Updated headless test expectations for session resume and semantic checkpoints.
Dependencies
Cordis framework packages vendored and rescope to @deepseek-ai
The Cordis framework packages have been vendored into the project and their package names have been rescope to @deepseek-ai. This includes the introduction of a new timer service that provides disposable timer helpers (timeout, interval, throttle, debounce) mixed into Cordis contexts, ensuring timers are automatically cleaned up when the context is disposed. The group plugin loader is also exported from the vendored group package.
vendor/group, vendor/timer · high confidence
Introduce native system primitives and Python review dependency
This update adds the \@deepseek-ai/node-addon-system\ package family (version 0.1.2), providing prebuilt Node-API bindings for POSIX flock and a Linux Landlock launcher across macOS and Linux architectures. It also adds a new \Pygments==2.19.2\ dependency to the review-ownership requirements.
(dependencies) · high confidence
Housekeeping
Document the util/ shared-utilities package group and its primitives; Documentation for the boot package group and app-boot library; Establishes benchmark infrastructure and documentation.
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 51 → 49 (-2.3)
- Rubric changed (rubric-2026.10.1 → rubric-2026.10.5) — scores are not directly comparable.
Lenses
- Code Health 76 → 69 (-6.4)
- Architecture 65 → 62 (-3.1)
- Maturity 91 → 60 (-30.7)
- Readiness 39 → 39 (+0.4)
- Security 59 → 54 (-4.6)
- Domain Modelling 100 (new)
- Accessibility 61 → 53 (-7.6)
- Performance 60 → 69 (+8.8)
Resolved (344)
- Ambiguous distinction between update and replace. Both take a namespace, a record of values, and an expected revision. Without documentation, it is unclear if replace implies a full overwrite of the namespace's content while update is a partial merge, or if they are synonyms. This is a common source of API misuse.
- ApiSessionAgentController.createOrAdopt (cognitive 16) (packages/api/session-controller/src/agent.ts)
- ApprovalPanel.ApprovalFlow (cyclomatic 24) (packages/client/ui-approval/src/client/ApprovalPanel.tsx)
- Boundary-crossing change coupling: index.ts ↔ PluginManagerPage.tsx (packages/boot/plugin-manager/src/index.ts)
- Change coupling: Rows.tsx ↔ stores.ts (packages/client/ui-workspace/src/client/rows/Rows.tsx)
- Change coupling: locales.ts ↔ Rows.tsx (packages/client/ui-workspace/src/client/locales.ts)
- Change coupling: locales.ts ↔ WorkspaceBrowser.tsx (packages/client/ui-workspace/src/client/locales.ts)
- ClassTooLong: ContinuableActivationRegistry (packages/subagent/subagent/src/continuation-activation.ts)
- ContinuableActivationRegistry.drainDescendants (cognitive 18) (packages/subagent/subagent/src/continuation-activation.ts)
- ContinuableActivationRegistry.watchSettlement (cognitive 23) (packages/subagent/subagent/src/continuation-activation.ts)
- ConversationController.sendSession (cyclomatic 18) (packages/client/ui-conversation/src/client/service.ts)
- Documentation: no project overview (packages/api/README.md)
- Documentation: no project overview (packages/boot/README.md)
- Duplicate intent for loading/creating a profile object. profile-boot.prepareProfile and profile.loadProfile both return a Profile object and accept a profile name and optional user layer flag. The signatures differ significantly in parameters (e.g., installAnchor, binName, home) suggesting they serve slightly different contexts (boot-time vs general runtime), but the core operation 'get a Profile object by name' is exposed twice with confusingly different signatures.
- Duplicated block (16–19 lines × 2) (scripts/smoke-python-runtime.py)
- EventRelationCollector.visitSource (cognitive 44) (scripts/gen-doc-graphs.ts)
- EventRelationCollector.visitSource (cyclomatic 21) (scripts/gen-doc-graphs.ts)
- FaceAnalyzer.resolvedRemoteCodecType (cognitive 51) (packages/typert/generator/src/analyzer.ts)
- FaceAnalyzer.resolvedRemoteCodecType (cyclomatic 41) (packages/typert/generator/src/analyzer.ts)
- FileTooLong: src/continuation-activation.ts (packages/subagent/subagent/src/continuation-activation.ts)
- …and 324 more
New (886)
- AXAccess.batchAttribute (cognitive 17) (packages/experimental/cua-macos/native/Sources/CuaNative/AXAccess.swift)
- AXAccess.keyboardRecipient (cognitive 43) (packages/experimental/cua-macos/native/Sources/CuaNative/AXAccess.swift)
- AXAccess.keyboardRecipient (cyclomatic 18) (packages/experimental/cua-macos/native/Sources/CuaNative/AXAccess.swift)
- AXAccess.pasteCommand (cognitive 24) (packages/experimental/cua-macos/native/Sources/CuaNative/AXAccess.swift)
- AXAccess.pasteCommand (cyclomatic 16) (packages/experimental/cua-macos/native/Sources/CuaNative/AXAccess.swift)
- AXAccess.project (cognitive 48) (packages/experimental/cua-macos/native/Sources/CuaNative/AXAccess.swift)
- AXAccess.project (cyclomatic 31) (packages/experimental/cua-macos/native/Sources/CuaNative/AXAccess.swift)
- AXAccess.project::walk (cognitive 28) (packages/experimental/cua-macos/native/Sources/CuaNative/AXAccess.swift)
- AXAccess.project::walk (cyclomatic 26) (packages/experimental/cua-macos/native/Sources/CuaNative/AXAccess.swift)
- AXHover.move (cognitive 18) (packages/experimental/cua-macos/native/Sources/CuaNative/AXHover.swift)
- AXTextFormatter.line (cognitive 50) (packages/experimental/cua-macos/native/Sources/CuaNative/AXTextFormatter.swift)
- AXTextFormatter.line (cyclomatic 45) (packages/experimental/cua-macos/native/Sources/CuaNative/AXTextFormatter.swift)
- AXWorker.execute (cognitive 131) (packages/experimental/cua-macos/native/Sources/CuaNative/AXWorker.swift)
- AXWorker.execute (cyclomatic 74) (packages/experimental/cua-macos/native/Sources/CuaNative/AXWorker.swift)
- AcpSession.settleAfterQuiescence (cognitive 29) (packages/acp/acp/src/session.ts)
- AcpSession.settleAfterQuiescence (cyclomatic 19) (packages/acp/acp/src/session.ts)
- Ambiguous entry points for application execution. runProfile executes a profile with specific options, while boot appears to be a lower-level or alternative entry point for starting the application environment. Both seem to initiate the runtime context, potentially leading to redundant usage patterns.
- ApiSessionAgentController.claim (cognitive 21) (packages/api/session-controller/src/agent.ts)
- ApiSessionAgentController.claim (cyclomatic 17) (packages/api/session-controller/src/agent.ts)
- ApplicationAccess.select (cognitive 38) (packages/experimental/cua/src/application-access.ts)
- …and 866 more
Changes since last survey
- 300 commits — 191 feature/other, 109 fixes
By area
- (repo) — 82 commits
- packages/client — 53 commits
- packages/experimental — 40 commits
- apps/desktop — 19 commits
- snapshots/session — 15 commits
- .agents/notes — 11 commits
- packages/subprocess — 10 commits
- packages/api — 9 commits
- packages/llm — 7 commits
- apps/web — 6 commits
- packages/credentials — 6 commits
- apps/cli — 4 commits
- docs/subsystems — 4 commits
- packages/boot — 4 commits
- packages/typert — 3 commits
- apps/plugin-market-generator — 2 commits
- docs/config-catalog.md — 2 commits
- packages/host — 2 commits
- packages/shell — 2 commits
- packages/subagent — 2 commits
Notable commits
- fix: Merge master into fix/shared-account-avatar
- fix: Merge origin/master into fix/bonus-notice-onboarding
- fix: Merge origin/master to include Azure native auth fix
- fix: Merge pull request #5532 from deepseek-harness/fix/bonus-notice-onboarding
- fix: Merge pull request #6054 from deepseek-harness/fix/subagent-no-sleep-wait
- fix: Merge pull request #6055 from deepseek-harness/fix/user-text-benchmark-sampling
- fix: Merge pull request #6095 from deepseek-harness/worktree/hotfix-azure-native-auth
- fix: Merge pull request #6096 from deepseek-harness/fix/office-operation-guidance
- fix: Merge pull request #6108 from deepseek-harness/fix/empty-response-text
- fix: Merge pull request #6126 from deepseek-harness/fix/macos-directory-picker-edit-menu
- fix: Merge pull request #6164 from deepseek-harness/fix/subprocess-linux-probe-once
- fix: Merge pull request #6169 from deepseek-harness/fix/account-failure-stderr
- fix: Merge pull request #6184 from deepseek-harness/fix/shared-account-avatar
- fix: Merge pull request #6227 from deepseek-harness/fix/windows-installer-file-locks
- fix: Merge pull request #6264 from deepseek-harness/fix/tool-exit-badge
- fix: Merge pull request #6272 from deepseek-harness/fix/codex-partial-answer-phase
- fix: Merge pull request #6275 from deepseek-harness/fix/skill-menu-plugin-change
- fix: Merge pull request #6348 from deepseek-harness/fix/ptc-prompt-alignment
- fix: Merge pull request #6353 from deepseek-harness/fix/sidebar-pageup-shift
- fix: fix(account): 仅在账号接口失败时输出 stderr 日志
- …and 280 more
Architecture
- 0 containers · 1 bounded contexts · 0 dependency edges (baseline)
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
deepseek-ai/deepseek-harness was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 21 October 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 687f282e8625c6b8d11ff58211a90524be2e4317 — the exact code this score is about.
- Scored under rubric-2026.10.5 — the same rubric and the same method as every other entry in this index.
- Measured by watchdog.canine.dev using codehealth-analyzer measure-2026.10.3+preprod-fddbc92cb8df.