Dsh-dev

English

面向 DeepSeek Harness 外部插件开发的 轻量工作区控制层：给人和 Agent 提供可复用的开发技能、上游源码锁定、版本漂移检查、 插件门禁与会话诊断工具。

DeepSeek Harness 仍处于 developer preview，会发生破坏性变化。本仓库用 upstream/deepseek-harness.lock.json 固定已分析的 上游 commit；不要把最新文档和旧版依赖混着使用。

它解决什么

DeepSeek Harness 的核心不是一个等你打补丁的内核，而是一棵由 Cordis 插件和配置层 组合出的运行树。这个工作区把上游原则变成插件开发时可执行的约束：

• 一切能力都通过插件、服务、事件和可撤销 effect 接入；
• profile 与 bundle 通过有序 patch 层组合，不直接修改上游源码；
• 模型可见内容必须能从追加式会话日志重建；
• 工具输出先设计成稳定的程序化值，再独立设计模型渲染和 UI 展示；
• 每次开发先确认目标 Harness 版本，再按目标版本的文档和 .d.ts 编译；
• 插件仓库各自拥有 Git 历史，本仓库只维护共享工作流。

快速开始

要求：Git、Python 3.11+、Node.js 22.19+；开发真实插件时还需要 pnpm 和 dsh。

git clone https://github.com/vimalinx/Dsh-dev.git
cd Dsh-dev

# 克隆并切到本仓库已分析的上游 commit
python3 tools/harness_upstream.py sync --locked

# 查看上游 checkout、锁文件和本地插件依赖是否一致
python3 tools/check-harness-drift.py

把独立插件仓库放在根目录的 dsh-<name>/ 下即可；它们会被根仓库忽略：

python3 tools/find-dsh-plugins.py --query terminal
python3 tools/check-plugin.py dsh-my-plugin --conformance
python3 tools/check-plugin.py dsh-my-plugin

目录

.
├── .claude/skills/               dsh 插件开发技能
├── tools/
│   ├── harness_upstream.py       克隆/刷新/锁定 DeepSeek Harness 源码
│   ├── check-harness-drift.py    报告上游与插件依赖版本漂移
│   ├── find-dsh-plugins.py       从 npm / GitHub 查真实 dsh 插件
│   ├── check-plugin.py           运行插件声明的门禁并报告缺口
│   └── session-log-repair/       会话日志离线诊断与审慎修复工具
├── upstream/                     可公开、可审计的上游锁信息
└── dsh-*/                        本地独立插件仓库（不纳入本仓库）

vendor/deepseek-harness/ 是第三方源码 checkout，vendor/dsh-docs/ 是历史派生镜像； 两者都不会进入本仓库历史。.ai/、scratch/、本机插件清单和真实会话内容同样默认 不公开。

Agent 使用

先读 CLAUDE.md，再按任务触发 .claude/skills/ 中对应技能。涉及 上游事实时必须先用 dsh-docs-lookup，涉及真实 ~/.dsh 时必须先用 dsh-local-verify。

本次上游对照的架构结论与工作区取舍见 docs/deepseek-harness-analysis.zh.md。

上游与许可

本仓库不是 DeepSeek 官方项目，也不分发 DeepSeek Harness 源码。DeepSeek Harness 由 DeepSeek 以 MIT 许可证发布；它自己的许可和第三方声明以 上游仓库 为准。本仓库的原创核心内容 使用 MIT License。

社区

本项目在 LINUX DO 开源社区推广，感谢社区的讨论、反馈与建议。