项目介绍
dsh-claude-compat 是一个社区维护的 DeepSeek Harness 插件,目标是让已有 Claude Code 配置在 DSH 中继续发挥作用。它会发现项目与用户目录中的 skills、commands、rules、agents、hooks、MCP、已安装插件和历史会话,并映射到 DSH 能理解的注册表、消息与生命周期机制。它不是无权限的格式转换器:hooks 能执行 shell,MCP 可启动进程或访问网络,插件管理和会话迁移也会写入用户目录。更适合先在独立 profile 与测试仓库中审查、最小化启用,再决定是否连接真实配置。
核心功能
Skills、commands 与 rules 桥接
扫描项目和用户 Claude 目录,把 SKILL.md 与命令文件注册为 DSH skills,并按大小上限把 rules 注入消息上下文;项目同名内容优先。
Hooks 生命周期映射
将 PreToolUse、PostToolUse、UserPromptSubmit、SessionStart 与 SessionEnd 映射到 DSH 事件,使用 shell 执行配置命令,并按退出码翻译决策。
MCP 配置挂载
读取项目 .mcp.json,把命令式服务器转为 stdio,把 URL 服务器转为 streamable HTTP,并通过 dsh-mcp-client 逐项挂载。
Claude 插件管理与发现
发现已安装 Claude 插件的 skills、commands、agents 与可选 MCP;管理命令优先调用 claude CLI,缺失时直接维护 JSON 和 git marketplace。
会话导入与 Skill 导出
读取 Claude 会话 JSONL 并写成 DSH 事件日志,也能将 DSH-native skills 导出到 .claude/skills;两种操作都应先备份目标。
安装与使用
使用独立的 DSH web profile 固定安装 v0.8.0,先关闭高风险兼容项,只用无副作用的 skill 或 command 验证发现机制,再逐项审查 hooks、MCP、插件管理和会话迁移。
让 AI Agent 帮你安装
把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。
请帮我安全评估并安装 dsh-claude-compat v0.8.0。
项目地址:https://github.com/biedongbin/dsh-claude-compat
先阅读 README.md、package.json、LICENSE、CHANGELOG.md、src/hooks.js、src/mcp.js、src/plugin-manager.js、scripts/cc-resume.mjs 与 scripts/dsh-restart.sh。确认 DSH profile、Node.js 20+、pnpm、目标项目和备份状态。只在独立 web profile 中执行 dsh plugin --profile web add dsh-claude-compat@0.8.0。先列出将读取的项目 .claude、.mcp.json 与用户 ~/.claude 路径,不要执行 shell hooks、挂载 MCP、管理插件、导入会话、导出 skill 或运行重启脚本。启动后只验证一个无副作用的测试 skill 是否被发现。任何写入 ~/.claude、~/.dsh、项目文件,任何网络 MCP、环境变量传递、Git marketplace 操作或进程终止都必须先停下征得确认。最后报告实际命令、文件变化、读取范围、验证结果和未验证项。- DeepSeek Harness 与一个可写的独立 profile
- Node.js 20 或更高版本
- pnpm 在 PATH 中
- 准备好可回滚的测试项目,不直接复用生产 ~/.claude
- 如需 /cc-resume,系统 PATH 中还要有 zstd
dsh plugin --profile web add dsh-claude-compat@0.8.0- 1隔离 profile 与测试配置
准备独立 web profile 和测试项目,只放一个无副作用的示例 skill;备份现有 ~/.claude 与 ~/.dsh 数据。
- 2固定版本安装
确认 Node.js 20+ 与 pnpm 后,执行 dsh plugin --profile web add dsh-claude-compat@0.8.0,不跟随 main。
- 3先验证发现和优先级
启动 dsh web,确认测试 skill 或 command 出现,并验证项目 .claude 优先于 DSH 原生和用户 ~/.claude;暂不启用 hooks 与 MCP。
- 4逐项审查可执行配置
检查 settings.json 每条 hook 命令和 .mcp.json 的 command、args、env、cwd、url 与 headers,只启用来源和权限都明确的项目。
- 5单独审批写入功能
使用 /cc-plugin、/cc-resume 或 /cc-export 前分别确认 ~/.claude、~/.dsh 和项目目标路径,保留备份并检查 overwrite 行为。
- 6记录未覆盖差异
验证 Claude 与 DSH 的实际行为差异,尤其是 hook 超时放行、agent shim、MCP 启动生命周期与 plugin skill runtime layer 问题。
安装后运行 dsh web,确认 skill picker 中只出现预期的测试 skill 或 command,并核对优先级。不要先执行 hooks 或连接 MCP。若继续测试,逐个检查 settings.json command、.mcp.json 的 env/headers/cwd 和写入目录;本页未完成这些实测。
- 包声明 dsh.bundle,正常安装无需手工编辑 cordis.patch.yml
- 先固定 0.8.0,而不是直接跟随 main;仓库没有正式 GitHub Release
- 插件 MCP 默认关闭,修改 .mcp.json 后必须重启 DSH
- 不要把 dsh-claude-compat-restart 当成常规安装步骤;它会修改依赖并管理进程
使用场景
迁移已有 Claude Skills
在不复制多套 skill 文档的情况下,让项目与用户 Claude skill 在 DSH 的 skill picker 中被发现。
复用项目自动化约定
把经过审查的 commands、rules 和部分 hooks 接入 DSH,同时保留项目级配置优先级。
连接现有 MCP 配置
把项目 .mcp.json 中的 stdio 或 HTTP 服务转交给 DSH MCP client,但需重新核对网络、凭据与子进程边界。
迁移对话与双向维护 Skills
选择性导入 Claude 历史会话到 DSH,或把 DSH skills 导出回 .claude 目录,适合明确接受格式损失的个人工作流。
使用评价
dsh-claude-compat 解决了一个具体且现实的迁移问题:让 Claude Code 配置不必全部重写就能进入 DSH。文档、双语说明、源码分层、版本日志与测试目录都比较完整,安装命令也清楚。它的价值同时伴随较宽的本地权限面:shell hooks、MCP、插件市场、会话导入和 skill 导出分别触及命令执行、网络、凭据、用户数据和文件写入。仓库仍很年轻、社区规模有限、没有 SECURITY.md 与正式 Release,近期活跃度还混有自动更新统计图的提交。本次只验证公开资料,没有安装或运行。
值得一试的地方
- 覆盖 skills、commands、rules、agents、hooks、MCP、插件与会话的迁移链路
- 中英文 README、CHANGELOG、安装 Skill、源码与测试证据结构完整
- 冲突优先级、超时行为、MCP 生命周期和已知问题写得明确
- MIT 许可,版本 tag 与 npm package 版本一致
使用前要知道
- 本次没有安装、执行测试或验证任何真实 Claude/DSH 配置
- shell hooks 与 MCP 会扩大命令、网络、环境变量和凭据暴露面
- 写入与重启辅助功能可能覆盖文件、重写会话或终止进程
- 项目新、Stars 少、无 SECURITY.md、无正式 GitHub Release,长期稳定性未知
README
dsh-claude-compat
Overview
把项目与用户目录中的 Claude Code skills、commands、rules、hooks、agents、MCP、插件和会话接入 DeepSeek Harness 的社区插件。 将 Claude Code 的 .claude 配置、hooks、MCP、插件和会话桥接到 DeepSeek Harness 的社区插件。
Getting started
- 使用独立的 DSH web profile 固定安装 v0.8.0,先关闭高风险兼容项,只用无副作用的 skill 或 command 验证发现机制,再逐项审查 hooks、MCP、插件管理和会话迁移。
- 插件按项目 .claude、DSH 原生内容、用户 ~/.claude 的顺序解决同名内容冲突。Skills 与 commands 进入 DSH skill registry,rules 作为 user-role system-reminder 消息注入;agents 被转换成可调用的委派 shim,而不是原生 Claude 子 Agent。
- 项目与用户 settings.json 中的一部分 hooks 会映射到 DSH 事件。PreToolUse、PostToolUse 与 UserPromptSubmit 可以影响执行或上下文;SessionStart 与 SessionEnd 以 best-effort 方式运行。命令统一通过 /bin/sh -c 执行,因此信任边界是 hook 配置本身,而不是插件名。
- 安装后运行 dsh web,确认 skill picker 中只出现预期的测试 skill 或 command,并核对优先级。不要先执行 hooks 或连接 MCP。若继续测试,逐个检查 settings.json command、.mcp.json 的 env/headers/cwd 和写入目录;本页未完成这些实测。
Configuration
dsh plugin --profile web add dsh-claude-compat@0.8.0在 GitHub 阅读完整 README →