dsh-plugin-guide

English

面向 DeepSeek Harness 的仓库级插件开发 skill。

它帮助 Codex 理解 Harness 架构，并按照 Cordis 的约定开发和维护 workspace package、模型工具、能力 Provider、LLM Adapter、Web Client 插件、Bundle、Profile、Session Event 以及相关文档和验证流程。

覆盖范围

• Cordis 插件导出、依赖注入、effect、卸载和热更新
• Service Definition / Provider / Consumer 能力 seam
• 新建 @deepseek-ai/dsh-* workspace package
• 类型化工具、规范 JSON 输出、后台任务和 UI render intent
• LLM Adapter 的流式协议和 replay 约定
• Host/Client 包边界和 Web Client 组合方式
• Session Event、模型可见状态、配置、Bundle 和 Profile
• Snapshot、真实入口、e2e、构建、目录生成和文档验证

目录结构

deepseek-harness-plugin/
├── SKILL.md
├── agents/
│   └── openai.yaml
└── references/
    ├── package-and-config.md
    ├── plugin-recipes.md
    └── testing-and-docs.md

SKILL.md 保存主工作流；参考文件按任务需要加载，分别覆盖包与配置、插件实现配方、验证与文档要求。

安装

将 deepseek-harness-plugin 目录复制到 Codex skills 目录：

cp -R deepseek-harness-plugin "${CODEX_HOME:-$HOME/.codex}/skills/"

未设置 CODEX_HOME 时，Codex 默认使用 ~/.codex/skills。

将本项目发布到 GitHub 后，可以直接安装：

npx skills add HarcoChen/dsh-plugin-guide --skill deepseek-harness-plugin -g -a codex

安装后可以显式调用：

Use $deepseek-harness-plugin to add a new DeepSeek Harness plugin.

验证

使用 skill-creator 提供的官方验证脚本：

python3 "${CODEX_HOME:-$HOME/.codex}/skills/.system/skill-creator/scripts/quick_validate.py" \
  deepseek-harness-plugin

如果提示缺少 yaml 模块，先安装 PyYAML：

python3 -m pip install pyyaml

该脚本检查 skill 的 frontmatter、必需元数据和命名规则。本项目另外检查文件末尾换行、尾随空格和相对引用完整性。

资料来源

本 skill 根据 DeepSeek Harness 仓库内容整理，主要参考：

• AGENTS.md
• docs/architecture.md
• docs/cookbook/adding-a-package.md
• docs/cookbook/adding-a-tool.md
• docs/cookbook/adding-an-llm-adapter.md
• docs/testing.md

当参考摘要与 checkout 中的最新源码或仓库规则不一致时，以源码和仓库规则为准。