dsh-claude-compat
English | 中文
Background: DeepSeek Harness
DeepSeek Harness (dsh) is the open-source agent harness from DeepSeek AI, where nearly every capability is a plugin on Cordis. It is in developer preview and iterating fast, so expect compatibility-breaking changes (docs, 0.1.7-alpha.*); this plugin is a standalone third-party package that resolves @deepseek-ai/* from the running host.
The problem this plugin solves
Skills, memory files and path-scoped rules kept in the Claude Code .claude/ layout are invisible to a DSH session; this plugin loads all three and gives each one a switch in 设置 → Claude 兼容.
Screenshots
Screenshots pending — this plugin has no captured UI yet.
Install
npx @deepseek-ai/dsh plugin --profile web add @guowenzhang/dsh-claude-compat
From the npm registry: https://www.npmjs.com/package/@guowenzhang/dsh-claude-compat — restart the host afterwards; local checkouts, git sources and troubleshooting are in AGENTS.md.
Usage
Open the settings page
The plugin adds one section to the settings page: 设置 → Claude 兼容. It holds three switches — 加载技能, 加载记忆, and 加载规则 — and each row lists what that switch loads and when, so the page states the compatibility surface itself instead of pointing at a README. All three are on by default, and a flipped switch is a live setting: it reaches the running plugin without restarting the host.
Load Claude Code skills
加载技能 adds two roots to the session skill catalog: the project's <project root>/.claude/skills/** and the user's ~/.claude/skills/**. The project root is the nearest ancestor containing .git; without one, the working directory is used instead. A skill is <root>/.claude/skills/<name>/SKILL.md, or a flat <name>.md, carrying name and description frontmatter. A same-named DSH skill wins a duplicate. Discovery happens when the catalog is listed, so an added, renamed, or deleted skill is picked up on the next discovery rather than immediately.
Load memory files
加载记忆 folds the files Claude Code loads, broad to specific, into the request:
| Memory file | Where it comes from | When it folds |
|---|
| Managed policy | The platform's managed policy CLAUDE.md | Session start |
| User | ~/.claude/CLAUDE.md | Session start |
| Project | CLAUDE.md, .claude/CLAUDE.md, and CLAUDE.local.md in every directory from the project root down to the working directory | Session start |
| Nested | The same three names for a directory under the working directory | The request after the read tool touches a file under it |
| Auto memory | ~/.claude/projects/<repository>/memory/MEMORY.md | Session start; only the index, capped at its first 200 lines or 25 KB |
@path imports expand in place, relative to the importing file, up to four hops; a token that names no readable file stays literal, which is what leaves an @mention or an email address alone. CLAUDE.md and CLAUDE.local.md are the two names this plugin takes over: their sections are removed from the host's own workspace-instruction messages, so those files load here, under Claude Code's rules, exactly once. AGENTS.md is untouched and keeps loading from the host.
Load scoped rules
加载规则 folds .claude/rules/** for the project and ~/.claude/rules/** for the user. A rule with no paths: in its frontmatter is always-on and folds at session start, like CLAUDE.md. A rule with a paths: glob list is path-scoped: it folds into the request that follows a read of a file matching one of its globs, matched against the project-root-relative path, and at most once per session. Reading is the only trigger — write and edit never activate a scoped rule.
Know the defaults
| Setting | Default |
|---|
| 加载技能 | on — .claude/skills/** and ~/.claude/skills/** are in the catalog |
| 加载记忆 | on — the memory files and the auto-memory index fold at session start |
| 加载规则 | on — always-on rules fold at session start, a paths: rule after a matching read |
Notes and caveats
- No skill watcher.
.claude/skills is discovered when the catalog is listed; an add, rename, or delete is picked up on the next discovery.
- Memory folds once per session, not after every edit. The memory files are read when they first enter the request; later edits are not re-read mid-session. A subdirectory's memory is read once, the first time the agent reads a file under it. Compaction is the exception: a memory message it shadowed folds again from disk.
- A repo with
CLAUDE.md and no AGENTS.md keeps an intro-only reminder. The host loader's message is kept — minus the sections this plugin owns — so it stays a visible baseline and is not recomposed on every step, which leaves its one-line "the following workspace instructions may be relevant" intro with nothing after it.
- Nested memory triggers on
read only. A nested CLAUDE.md folds when the read tool touches a file in its directory; write and edit do not trigger it.
- Path-scoped rules trigger on
read only. write and edit do not activate them.
- Auto memory is read, never written.
MEMORY.md and its topic files reach the model as context, but the harness does not append new memories to them the way Claude Code does.
- Claude Code's
settings.json is not consulted. autoMemoryDirectory there is ignored; set the plugin's own autoMemoryDirectory field instead.
- Imports are not approval-gated. Claude Code asks before a project memory file imports a path outside the working directory; this plugin resolves such an import directly.
AGENTS.md is not the loader's fallback. Claude Code's default reads AGENTS.md only when no CLAUDE.md or CLAUDE.local.md exists in the working directory or above it. Here the host's workspace-instruction loader keeps reading AGENTS.md on its own terms, alongside the CLAUDE.md this plugin loads.
License
Apache License 2.0 — see LICENSE. This product includes MIT-licensed portions derived from DeepSeek Harness; see NOTICE. Not affiliated with or endorsed by Claude Code or its owners.
Further reading
- AGENTS.md — install variants, the full field table, the build, deployment and live-update semantics, release steps, and troubleshooting.
- docs/implementation.md — the package reference: discovery rules, memory and rule folding, and Model Experience.
- tests/README.md — the spec commands and which suites each one covers.
- @guowenzhang/dsh-mcp-manager — the sibling plugin that owns MCP server management (authoring rows, on-demand loading, tool filters); this repository contains no MCP code.
- DeepSeek Harness documentation.
