DSH 插件 · 社区项目

dsh-claude-compat

把项目与用户目录中的 Claude Code skills、commands、rules、hooks、agents、MCP、插件和会话接入 DeepSeek Harness 的社区插件。

11 StarsMITJavaScript今天更新
01

项目介绍

dsh-claude-compat 是一个社区维护的 DeepSeek Harness 插件,目标是让已有 Claude Code 配置在 DSH 中继续发挥作用。它会发现项目与用户目录中的 skills、commands、rules、agents、hooks、MCP、已安装插件和历史会话,并映射到 DSH 能理解的注册表、消息与生命周期机制。它不是无权限的格式转换器:hooks 能执行 shell,MCP 可启动进程或访问网络,插件管理和会话迁移也会写入用户目录。更适合先在独立 profile 与测试仓库中审查、最小化启用,再决定是否连接真实配置。

02

核心功能

01

Skills、commands 与 rules 桥接

扫描项目和用户 Claude 目录,把 SKILL.md 与命令文件注册为 DSH skills,并按大小上限把 rules 注入消息上下文;项目同名内容优先。

02

Hooks 生命周期映射

将 PreToolUse、PostToolUse、UserPromptSubmit、SessionStart 与 SessionEnd 映射到 DSH 事件,使用 shell 执行配置命令,并按退出码翻译决策。

03

MCP 配置挂载

读取项目 .mcp.json,把命令式服务器转为 stdio,把 URL 服务器转为 streamable HTTP,并通过 dsh-mcp-client 逐项挂载。

04

Claude 插件管理与发现

发现已安装 Claude 插件的 skills、commands、agents 与可选 MCP;管理命令优先调用 claude CLI,缺失时直接维护 JSON 和 git marketplace。

05

会话导入与 Skill 导出

读取 Claude 会话 JSONL 并写成 DSH 事件日志,也能将 DSH-native skills 导出到 .claude/skills;两种操作都应先备份目标。

03

安装与使用

使用独立的 DSH web profile 固定安装 v0.8.0,先关闭高风险兼容项,只用无副作用的 skill 或 command 验证发现机制,再逐项审查 hooks、MCP、插件管理和会话迁移。

AI AGENT INSTALL

让 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 操作或进程终止都必须先停下征得确认。最后报告实际命令、文件变化、读取范围、验证结果和未验证项。
01开始前准备
  • DeepSeek Harness 与一个可写的独立 profile
  • Node.js 20 或更高版本
  • pnpm 在 PATH 中
  • 准备好可回滚的测试项目,不直接复用生产 ~/.claude
  • 如需 /cc-resume,系统 PATH 中还要有 zstd
02复制安装命令或配置
dsh plugin --profile web add dsh-claude-compat@0.8.0
03按步骤完成安装
  1. 1
    隔离 profile 与测试配置

    准备独立 web profile 和测试项目,只放一个无副作用的示例 skill;备份现有 ~/.claude 与 ~/.dsh 数据。

  2. 2
    固定版本安装

    确认 Node.js 20+ 与 pnpm 后,执行 dsh plugin --profile web add dsh-claude-compat@0.8.0,不跟随 main。

  3. 3
    先验证发现和优先级

    启动 dsh web,确认测试 skill 或 command 出现,并验证项目 .claude 优先于 DSH 原生和用户 ~/.claude;暂不启用 hooks 与 MCP。

  4. 4
    逐项审查可执行配置

    检查 settings.json 每条 hook 命令和 .mcp.json 的 command、args、env、cwd、url 与 headers,只启用来源和权限都明确的项目。

  5. 5
    单独审批写入功能

    使用 /cc-plugin、/cc-resume 或 /cc-export 前分别确认 ~/.claude、~/.dsh 和项目目标路径,保留备份并检查 overwrite 行为。

  6. 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 当成常规安装步骤;它会修改依赖并管理进程
04

使用场景

SCENARIO 01

迁移已有 Claude Skills

在不复制多套 skill 文档的情况下,让项目与用户 Claude skill 在 DSH 的 skill picker 中被发现。

SCENARIO 02

复用项目自动化约定

把经过审查的 commands、rules 和部分 hooks 接入 DSH,同时保留项目级配置优先级。

SCENARIO 03

连接现有 MCP 配置

把项目 .mcp.json 中的 stdio 或 HTTP 服务转交给 DSH MCP client,但需重新核对网络、凭据与子进程边界。

SCENARIO 04

迁移对话与双向维护 Skills

选择性导入 Claude 历史会话到 DSH,或把 DSH skills 导出回 .claude 目录,适合明确接受格式损失的个人工作流。

05

使用评价

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,长期稳定性未知
06

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