尧图网页设计 
DeepSeek Harness 移除 SDK 项目工具链一次面向真实消费方的架构收敛实践【免费下载链接】deepseek-harnessDeepSeek Harness: Everything is a Plugin.项目地址: https://gitcode.com/gh_mirrors/de/deepseek-harness本篇文章以 DeepSeek Harness 仓库中的已实施 Agent Note 移除 SDK 项目工具链 为核心讲解仓库如何识别并删除一套从未发布、没有任何消费方的开发者项目产品create-sdk、dsh-scripts、dsh-helper、dsh-telemetry同时完整保留并迁移运行时 SDK 协议栈dsh-sdk-protocol、dsh-sdk-client、dsh-sdk-jsonrpc-server。读完本文你将理解DeepSeek Harness 中 SDK 一词的唯一仓库含义、项目工具链与运行时协议栈的边界划分依据、删除决策的替代方案权衡以及重新引入这类产品的前提条件。背景与问题一套没有消费者的开发者项目产品在本次简化之前仓库的scaffold/分组里同时存在两类性质完全不同的东西SDK 项目工具链一套面向生成可编辑的独立开发者项目的未发布产品运行时 SDK 协议栈Python SDK、dsh-sdksubagent 提供方和 JSON-RPC 示例实际依赖的 JSON-RPC 客户端/服务器协议。问题出在前者。工具链由四个包组成各司其职包名职责deepseek-ai/create-sdk生成可编辑的 Cordis 项目初始化器deepseek-ai/dsh-scripts提供dsh-sdk的开发、构建、启动、配置和插件安装命令deepseek-ai/dsh-helper协调功能定义与多文件项目编辑deepseek-ai/dsh-telemetry上报启动器活动这套设计的目标是让生成的项目保持可编辑同时让项目创建与后续配置共用同一份定义——包括依赖、Cordis 配置项cordis.yml、环境变量占位符和归属文件避免两套配置漂移。然而记录显示没有任何项目是通过公开发布版创建的当前仓库和外部消费方也都不需要这套生命周期。继续保留它意味着同时维护4 个包、2 套交互式命令产品、项目模板、包管理器适配器、配置调和configuration reconciliation逻辑、启动器遥测、1 个仓库级 skill以及对应的测试和文档——却没有证据表明这条产品边界应当存在。这正是本 Agent Note 的核心判断依据没有真实消费方的产品边界本身就是一种负债。可以推断仓库维护者判断保留一份无人使用的完整支持图比删除它的成本更高尤其是考虑后续每次依赖升级、打包改动都要连带更新这组包。决策删除工具链保留运行时 SDK删什么deepseek-ai/create-sdk、deepseek-ai/dsh-scripts、deepseek-ai/dsh-helper、deepseek-ai/dsh-telemetry四个包被整体删除且不提供替代实现或兼容层。与之绑定的一切随之移除二进制文件与测试项目模板功能目录feature catalog项目编辑模型包管理器支持package-manager adapters启动器遥测仓库项目创建 skillworkspace、构建、打包、文档生成器、vendoring rescope 和依赖记录。被取消的开发者项目、项目编辑和后续能力提案也一并删除而不是保留为 active 或 rejected 记录。本 Agent Note 作为唯一的权威记录保留了它们的共同动机、不交付该产品的决策、放弃的能力以及重新考虑的条件。已冻结的归档 Agent Note 则作为历史快照保留不做修改。留什么三个运行时 SDK 包原样迁移与工具链同处scaffold/分组、但独立使用的运行时协议栈被完整保留。三个包从packages/scaffold/原样迁移至 packages/sdk/npm 名称与协议交互行为wire behavior均不改变包名角色deepseek-ai/dsh-sdk-protocol换行分隔的 JSON-RPC 2.0 传输层 全部命名请求/结果/通知类型protocol READMEdeepseek-ai/dsh-sdk-clientTypeScript 客户端spawn 运行时子进程并驱动 agent 轮次client READMEdeepseek-ai/dsh-sdk-jsonrpc-server在 stdio 上服务 SDK 客户端的jsonrpc插件由外置cordis.yml作为普通插件选中server README迁移后的消费方式保持不变消费方提供一个可执行文件 一份外置cordis.ymlJSON-RPC 服务器仍是由该配置选择的普通插件。也就是说这套运行时协议完全不依赖被删除的生成项目或启动器——这正是它可以独立存活的结构性原因。为什么是packages/sdk/让 SDK 只有一个含义删除后scaffold/分组已没有任何搭建项目的内容继续保留该目录名会名不副实。迁移到packages/sdk/直接陈述了幸存者的职责。这一点与仓库的另一份已实施决策 仓库命名约定与发布前重命名台账 相互配合该命名约定规定SDK在仓库中只有一个含义受支持的 Python 与 TypeScript SDK 所使用的 JSON-RPC 客户端/服务器协议DeepSeek Harness 本身不是 SDK 项目被删除的项目生成器、启动器、helper 和遥测包保持缺席命名台账保留deepseek-ai/dsh-sdk-client、deepseek-ai/dsh-sdk-protocol以及 wire 身份deepseek-harness-sdk-runtime并明确排除四个被删除的包。从 协议包 README 可以看到这条边界的实际形态serverInfo.name保持 wire 稳定的deepseek-harness-sdk-runtime方法集只有 3 个客户端到服务器请求initialize、session/prompt、shutdown和 4 个服务器到客户端通知session.event、session.status、subagent.started、subagent.finished——一个纯粹、狭窄、边界清晰的运行时协议与生成项目毫无关系。考虑过的替代方案为什么最终选择全删Agent Note 记录了四个被否决的方案每个都对应一种少删一点的诱惑值得作为架构决策的参考只删除初始化器create-sdk——否决。因为dsh-sdk、共享项目模型和启动器遥测的存在意义就是操作该初始化器创建的项目没有现存项目需要它们只删初始化器等于留下器官却摘掉宿主。保留仅用于报错的包或命令别名tombstone——否决。这些命令从未公开发布不存在兼容义务墓碑只会无谓地保留包与可执行文件的接口面积。连运行时 SDK 栈一起删除——否决。Python SDK、进程外 Harness subagent 提供方和 JSON-RPC 示例是协议、客户端和服务器当前的真实消费方。把运行时栈继续留在packages/scaffold/——否决。分组名必须反映幸存者的实际职责。方案 2 背后的原则尤其值得注意兼容层只应该为真实存在的兼容义务而存在。一个从未发布的命令产品不欠任何用户迁移路径保留别名或错误提示包是在用未来的虚构需求为当前每个读者和每次构建付费。验证用仓库级门禁固定删除已完成Agent Note 的 Verification 部分展示了这次删除不是手工清理而是由仓库基础设施共同断言的结果。删除后workspace 中不存在四个被删包名也不存在两套被移除的命令产品包聚合配置、源码路径映射、包元数据、测试收集配置、发布约束、生成目录、依赖声明文件依赖声明和锁文件lockfile只解析packages/sdk/下的 3 个运行时 SDK 包运行时 SDK 包的测试、已构建服务器的冒烟测试、TypeScript 消费方、仓库文档门禁、构建与 hygiene 检查共同钉死了幸存行为并确保不存在陈旧的包路径引用。结合命名台账的验证章节可以推断仓库的 CI 门禁如pnpm run check:ci覆盖的源码类型检查、构建、包卫生、生成引用检查、文档同步与 lint会持续检查包名与路径的一致性——任何试图引用已删除包名或旧路径的改动都会被拦截。这正是删除类重构能被长期维持的机制不是靠一次提交而是靠持续运行的门禁。后果与重新引入的条件能力上的明确收缩删除之后DeepSeek Harness不再创建或管理独立的开发者 SDK 项目。以下能力被有意移除自动项目生成功能树配置本地插件脚手架项目本地的开发/构建/启动命令面向开发周期的启动器遥测。与此同时普通应用和运行时分发继续通过各自归属的包和cordis.yml文件组合插件——这是 DeepSeek Harness 一贯的插件组合方式Everything is a Plugin并没有被削弱。不复活死格式仓库删除的是完整的支持图而不是保留休眠抽象。重新引入项目工具链有两个硬性前提必须先有真实消费方——一个新的产品必须有实际使用它工作流的人或项目必须基于该消费方的工作流提出新提案——而不是复活这四包或它们已删除的、不承诺兼容的格式。这意味着默认情况下被删除的包名、命令和项目格式不会复活任何重新引入都需要走全新的提案流程从真实需求出发重新设计。小结从这次简化中学到什么这份 Agent Note 浓缩了 DeepSeek Harness 团队在删除这件事上的完整方法论可以提炼为三条可迁移的判断准则产品边界必须有真实消费方。没有消费方的生命周期无论设计多精致都是需要持续支付维护成本的结构负债。删除要彻底不要留墓碑。对从未公开发布的能力别名、错误提示包和兼容层只会保留无意义的接口面积文档记录替代墓碑承载动机、决策与重开条件。保留与删除的边界要由真实依赖决定。运行时 SDK 之所以幸存不是因为它与工具链同处一个目录而是因为 Python SDK、subagent 提供方和 JSON-RPC 示例真实地在消费它迁移到packages/sdk/只是让目录名与真实职责重新对齐。如果你想进一步深入幸存者可以继续阅读 packages/sdk/ 组 README 以及三份子包文档protocol、client、server如果你想理解 SDK 一词在仓库中的唯一含义与命名契约参见 仓库命名约定与发布前重命名台账若需要查看 JSON-RPC 服务器所有可接受配置字段的权威清单可查阅 配置目录。【免费下载链接】deepseek-harnessDeepSeek Harness: Everything is a Plugin.项目地址: https://gitcode.com/gh_mirrors/de/deepseek-harness创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 DeepSeek Harness 移除 SDK 项目工具链：一次面向真实消费方的架构收敛实践
DeepSeek Harness 移除 SDK 项目工具链一次面向真实消费方的架构收敛实践【免费下载链接】deepseek-harnessDeepSeek Harness: Everything is a Plugin.项目地址: https://gitcode.com/gh_mirrors/de/deepseek-harness本篇文章以 DeepSeek Harness 仓库中的已实施 Agent Note 移除 SDK 项目工具链 为核心讲解仓库如何识别并删除一套从未发布、没有任何消费方的开发者项目产品create-sdk、dsh-scripts、dsh-helper、dsh-telemetry同时完整保留并迁移运行时 SDK 协议栈dsh-sdk-protocol、dsh-sdk-client、dsh-sdk-jsonrpc-server。读完本文你将理解DeepSeek Harness 中 SDK 一词的唯一仓库含义、项目工具链与运行时协议栈的边界划分依据、删除决策的替代方案权衡以及重新引入这类产品的前提条件。背景与问题一套没有消费者的开发者项目产品在本次简化之前仓库的scaffold/分组里同时存在两类性质完全不同的东西SDK 项目工具链一套面向生成可编辑的独立开发者项目的未发布产品运行时 SDK 协议栈Python SDK、dsh-sdksubagent 提供方和 JSON-RPC 示例实际依赖的 JSON-RPC 客户端/服务器协议。问题出在前者。工具链由四个包组成各司其职包名职责deepseek-ai/create-sdk生成可编辑的 Cordis 项目初始化器deepseek-ai/dsh-scripts提供dsh-sdk的开发、构建、启动、配置和插件安装命令deepseek-ai/dsh-helper协调功能定义与多文件项目编辑deepseek-ai/dsh-telemetry上报启动器活动这套设计的目标是让生成的项目保持可编辑同时让项目创建与后续配置共用同一份定义——包括依赖、Cordis 配置项cordis.yml、环境变量占位符和归属文件避免两套配置漂移。然而记录显示没有任何项目是通过公开发布版创建的当前仓库和外部消费方也都不需要这套生命周期。继续保留它意味着同时维护4 个包、2 套交互式命令产品、项目模板、包管理器适配器、配置调和configuration reconciliation逻辑、启动器遥测、1 个仓库级 skill以及对应的测试和文档——却没有证据表明这条产品边界应当存在。这正是本 Agent Note 的核心判断依据没有真实消费方的产品边界本身就是一种负债。可以推断仓库维护者判断保留一份无人使用的完整支持图比删除它的成本更高尤其是考虑后续每次依赖升级、打包改动都要连带更新这组包。决策删除工具链保留运行时 SDK删什么deepseek-ai/create-sdk、deepseek-ai/dsh-scripts、deepseek-ai/dsh-helper、deepseek-ai/dsh-telemetry四个包被整体删除且不提供替代实现或兼容层。与之绑定的一切随之移除二进制文件与测试项目模板功能目录feature catalog项目编辑模型包管理器支持package-manager adapters启动器遥测仓库项目创建 skillworkspace、构建、打包、文档生成器、vendoring rescope 和依赖记录。被取消的开发者项目、项目编辑和后续能力提案也一并删除而不是保留为 active 或 rejected 记录。本 Agent Note 作为唯一的权威记录保留了它们的共同动机、不交付该产品的决策、放弃的能力以及重新考虑的条件。已冻结的归档 Agent Note 则作为历史快照保留不做修改。留什么三个运行时 SDK 包原样迁移与工具链同处scaffold/分组、但独立使用的运行时协议栈被完整保留。三个包从packages/scaffold/原样迁移至 packages/sdk/npm 名称与协议交互行为wire behavior均不改变包名角色deepseek-ai/dsh-sdk-protocol换行分隔的 JSON-RPC 2.0 传输层 全部命名请求/结果/通知类型protocol READMEdeepseek-ai/dsh-sdk-clientTypeScript 客户端spawn 运行时子进程并驱动 agent 轮次client READMEdeepseek-ai/dsh-sdk-jsonrpc-server在 stdio 上服务 SDK 客户端的jsonrpc插件由外置cordis.yml作为普通插件选中server README迁移后的消费方式保持不变消费方提供一个可执行文件 一份外置cordis.ymlJSON-RPC 服务器仍是由该配置选择的普通插件。也就是说这套运行时协议完全不依赖被删除的生成项目或启动器——这正是它可以独立存活的结构性原因。为什么是packages/sdk/让 SDK 只有一个含义删除后scaffold/分组已没有任何搭建项目的内容继续保留该目录名会名不副实。迁移到packages/sdk/直接陈述了幸存者的职责。这一点与仓库的另一份已实施决策 仓库命名约定与发布前重命名台账 相互配合该命名约定规定SDK在仓库中只有一个含义受支持的 Python 与 TypeScript SDK 所使用的 JSON-RPC 客户端/服务器协议DeepSeek Harness 本身不是 SDK 项目被删除的项目生成器、启动器、helper 和遥测包保持缺席命名台账保留deepseek-ai/dsh-sdk-client、deepseek-ai/dsh-sdk-protocol以及 wire 身份deepseek-harness-sdk-runtime并明确排除四个被删除的包。从 协议包 README 可以看到这条边界的实际形态serverInfo.name保持 wire 稳定的deepseek-harness-sdk-runtime方法集只有 3 个客户端到服务器请求initialize、session/prompt、shutdown和 4 个服务器到客户端通知session.event、session.status、subagent.started、subagent.finished——一个纯粹、狭窄、边界清晰的运行时协议与生成项目毫无关系。考虑过的替代方案为什么最终选择全删Agent Note 记录了四个被否决的方案每个都对应一种少删一点的诱惑值得作为架构决策的参考只删除初始化器create-sdk——否决。因为dsh-sdk、共享项目模型和启动器遥测的存在意义就是操作该初始化器创建的项目没有现存项目需要它们只删初始化器等于留下器官却摘掉宿主。保留仅用于报错的包或命令别名tombstone——否决。这些命令从未公开发布不存在兼容义务墓碑只会无谓地保留包与可执行文件的接口面积。连运行时 SDK 栈一起删除——否决。Python SDK、进程外 Harness subagent 提供方和 JSON-RPC 示例是协议、客户端和服务器当前的真实消费方。把运行时栈继续留在packages/scaffold/——否决。分组名必须反映幸存者的实际职责。方案 2 背后的原则尤其值得注意兼容层只应该为真实存在的兼容义务而存在。一个从未发布的命令产品不欠任何用户迁移路径保留别名或错误提示包是在用未来的虚构需求为当前每个读者和每次构建付费。验证用仓库级门禁固定删除已完成Agent Note 的 Verification 部分展示了这次删除不是手工清理而是由仓库基础设施共同断言的结果。删除后workspace 中不存在四个被删包名也不存在两套被移除的命令产品包聚合配置、源码路径映射、包元数据、测试收集配置、发布约束、生成目录、依赖声明文件依赖声明和锁文件lockfile只解析packages/sdk/下的 3 个运行时 SDK 包运行时 SDK 包的测试、已构建服务器的冒烟测试、TypeScript 消费方、仓库文档门禁、构建与 hygiene 检查共同钉死了幸存行为并确保不存在陈旧的包路径引用。结合命名台账的验证章节可以推断仓库的 CI 门禁如pnpm run check:ci覆盖的源码类型检查、构建、包卫生、生成引用检查、文档同步与 lint会持续检查包名与路径的一致性——任何试图引用已删除包名或旧路径的改动都会被拦截。这正是删除类重构能被长期维持的机制不是靠一次提交而是靠持续运行的门禁。后果与重新引入的条件能力上的明确收缩删除之后DeepSeek Harness不再创建或管理独立的开发者 SDK 项目。以下能力被有意移除自动项目生成功能树配置本地插件脚手架项目本地的开发/构建/启动命令面向开发周期的启动器遥测。与此同时普通应用和运行时分发继续通过各自归属的包和cordis.yml文件组合插件——这是 DeepSeek Harness 一贯的插件组合方式Everything is a Plugin并没有被削弱。不复活死格式仓库删除的是完整的支持图而不是保留休眠抽象。重新引入项目工具链有两个硬性前提必须先有真实消费方——一个新的产品必须有实际使用它工作流的人或项目必须基于该消费方的工作流提出新提案——而不是复活这四包或它们已删除的、不承诺兼容的格式。这意味着默认情况下被删除的包名、命令和项目格式不会复活任何重新引入都需要走全新的提案流程从真实需求出发重新设计。小结从这次简化中学到什么这份 Agent Note 浓缩了 DeepSeek Harness 团队在删除这件事上的完整方法论可以提炼为三条可迁移的判断准则产品边界必须有真实消费方。没有消费方的生命周期无论设计多精致都是需要持续支付维护成本的结构负债。删除要彻底不要留墓碑。对从未公开发布的能力别名、错误提示包和兼容层只会保留无意义的接口面积文档记录替代墓碑承载动机、决策与重开条件。保留与删除的边界要由真实依赖决定。运行时 SDK 之所以幸存不是因为它与工具链同处一个目录而是因为 Python SDK、subagent 提供方和 JSON-RPC 示例真实地在消费它迁移到packages/sdk/只是让目录名与真实职责重新对齐。如果你想进一步深入幸存者可以继续阅读 packages/sdk/ 组 README 以及三份子包文档protocol、client、server如果你想理解 SDK 一词在仓库中的唯一含义与命名契约参见 仓库命名约定与发布前重命名台账若需要查看 JSON-RPC 服务器所有可接受配置字段的权威清单可查阅 配置目录。【免费下载链接】deepseek-harnessDeepSeek Harness: Everything is a Plugin.项目地址: https://gitcode.com/gh_mirrors/de/deepseek-harness创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考