前言¶
在 DeepSeek Harness(DSH)里用插件扩展行为时,常会同时装社区插件、私有插件,并依赖官方对代码改动的约束。若缺少统一的「私有插件优先」与「代码保护」规则,模型或工具链可能误改不应动的文件,或在多机同步时把不该进仓库的内容写进 profile。
下面介绍的插件不替你做业务逻辑,而是把上述规则以配置层形式写进 DSH profile,让 harness 在运行时有明确的源码保护指引。社区目录 SkillHub 将其归类为「记忆」类插件;仓库由 vb2250158 维护,当前 GitHub 星标为 0,许可证为 MIT。
这是什么¶
dsh-source-preservation-guidance(界面英文名为 Source preservation guidance,中文为 源码保护指引)是一条开源 DSH 插件。README 中的定位是:将私有插件优先和官方代码保护规则注入 DSH。
插件包在 package.json 中声明 dsh.bundle,安装后会把 cordis.patch.yml 对应的配置层合并进所选 profile,而不是单独跑一个外部服务。
环境与版本¶
本发行版要求 DSH 0.2.1-alpha.1 或与 0.2 系列兼容的版本。更细的兼容说明见仓库内 docs/dsh-0.2-compatibility.md。插件自身版本在 package 中为 0.1.5。
核心功能¶
依据 README,已核实的能力包括:
- 规则注入:向 DSH 注入私有插件优先策略与官方代码保护相关规则(具体条目以仓库内 patch 与文档为准)。
- Profile 配置层:通过
dsh.bundle.patch指向./cordis.patch.yml,安装后该层进入 profile。 - 展示元数据:插件列表标题与描述随 DSH 界面语言切换,资源来自
locale/en.json、locale/zh.json;图标为自包含的icon.svg(改编自 Lucide,见ICON_LICENSE.txt)。
README 未展开每条规则的业务语义;使用前应在 GitHub 阅读 cordis.patch.yml 及 docs/ 下说明。
安装与启用¶
公开仓库需先锁定要安装的 Git 提交,再通过 DSH 官方 CLI 安装。资料中的命令如下(将 <commit> 换为实际提交哈希):
pnpm dsh plugin --profile web add github:vb2250158/dsh-source-preservation-guidance#<commit>
说明:--profile web 表示把插件加到名为 web 的 profile;若你使用其他 profile 名称,应改成对应值。安装完成后,插件声明的配置层会并入该 profile。
配置与多机同步¶
插件相关配置保存在 DSH profile 的 cordis.patch.yml 中。README 强调:用于多电脑同步的仓库通常只保存插件仓库地址、固定提交、启停状态及配置,不保存本插件仓库的完整源码。规划同步策略时,应区分「profile 元数据」与「插件源码 checkout」。
维护者自测命令¶
仓库 README 给出的本地验证步骤(面向插件开发者或审阅源码者):
npm test
npm pack --dry-run
其中 npm test 对应 node --test tests/*.test.mjs。普通用户仅安装插件时,以 DSH 侧安装与 profile 生效为准即可。
适用场景与注意¶
适合谁:已在 DSH 0.2.x 上使用 profile / 插件体系,并希望默认带上「私有插件优先 + 代码保护」指引的开发者或团队。
安装前建议:
- 插件随 当前 dsh 进程权限 运行,安装前应自行审查 GitHub 仓库 源码与 MIT 许可证。
- 安装命令必须使用资料原文形式(含
#<commit>),不要省略提交锁定。 - SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系;插件来源以 GitHub 与安装时的 commit 为准。
结尾¶
dsh-source-preservation-guidance 的价值在于用一条可版本化的插件,把源码保护相关规则写进 DSH profile,减少误改与同步策略上的歧义。目录页:https://www.skillhub.cn/plugins/vb2250158/dsh-source-preservation-guidance;源码与 README:https://github.com/vb2250158/dsh-source-preservation-guidance。