vimalinx/Dsh-dev

README 摘要

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。 把独立插件仓库放在根目录的 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 开源社区推广，感谢社区的讨论、反馈与建议。

分类