DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

zz-zhi54 /

zz-zhi54/dsh-plugins

Topic repository only

This plugin has no description yet.

★ 2 Stars0 Forks1 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@5c2f4009

dsh-plugins

English

个人维护的 DeepSeek Harness(DSH)插件仓库,以 pnpm workspace 组织。目前只维护系统通知插件。

这是个人维护的非官方社区项目,不隶属于 DeepSeek AI 或 DeepSeek Harness 官方团队。

本 README 负责安装方式和仓库结构;插件 README 记录具体行为和限制。实际版本、DSH 兼容关系及发布记录请以 CHANGELOG.md 和插件的 package.json 为准。

项目总览

当前已验证的开发基线为 DeepSeek Harness 官方已发布的 DSH v0.2.2-rc.1。这只是开发验证环境记录,不是安装版本限制。通知插件通过 Host 提供的 API 工作,不声明 engines.dsh 或 Host peer 版本约束;DSH 仅更新版本号时无需修改插件,实际事件契约变化时再做兼容适配。历史 tag 保留各自原有的版本声明。

插件 包名 用途 详细说明
packages/system-notification dsh-system-notification-plugin 旁路监听任务状态和审批事件,发送 macOS / Windows 原生系统通知 README

我目前已使用 Magpie,它能够满足我原先使用 Codex 登录、Codex 额度和 Session 费用插件的需求,因此停止维护并移除这三个插件,只保留系统通知。历史实现保留在 Git 历史和旧版本 tag 中。

设计原则

  • 最小依赖、最少代码:只引入完成目标所需的依赖,优先复用 DSH 已提供的服务和扩展点。
  • 轻量、稳定:围绕实际使用场景提供小而明确的能力,优先控制维护成本。
  • 最小侵入:插件以独立 Profile layer 接入,不修改 DSH 核心,不接管 Agent 循环或审批流程。
  • 开放协作:欢迎通过 Issue 和 Pull Request 提交问题、建议、文档、测试或实现。
  • 稳定优先:保持现有行为和公开契约;通知失败时,不应影响 DSH 主流程。
  • 上游优先、可撤销:当 DSH 官方提供等价能力时,对应插件会停止维护并删除。

参与贡献

欢迎提交 Issue 或 Pull Request。贡献应保持功能边界清晰,优先使用 DSH 公开服务和扩展点,同步必要的测试和文档,并说明验证方式。

安装、卸载与更新

无需 clone 仓库或预装其他插件。桌面端安装、更新或卸载时,将命令中的 --profile web 改为 --profile desktop。

安装和更新

直接跟随 main 安装系统通知插件:

dsh plugin --profile web add 'github:zz-zhi54/dsh-plugins#main&path:packages/system-notification'

需要获取 main 的后续更新时,重新执行上述 add 命令或通过插件管理器更新;分支安装不会实时同步代码到正在运行的 DSH。

需要固定到已发布的 v0.2.2-rc.1.2 时,使用:

dsh plugin --profile web add 'github:zz-zhi54/dsh-plugins#v0.2.2-rc.1.2&path:packages/system-notification'

该版本已移除 Host 版本限制;历史 tag 保留原有的兼容约束。

安装后检查 Profile:

dsh --profile web --dump-config

卸载

dsh plugin --profile web remove dsh-system-notification-plugin

如果安装过已移除的旧插件,可按实际安装情况执行:

dsh plugin --profile web remove dsh-codex-login-plugin
dsh plugin --profile web remove dsh-codex-usage-plugin
dsh plugin --profile web remove dsh-session-cost-plugin

系统通知的行为、平台限制和手动验证步骤见插件 README。

开发

依赖安装和检查都从仓库根目录执行,并使用 pnpm:

pnpm install
pnpm check
pnpm -r --if-present run test
git diff --check

单独检查系统通知插件:

pnpm --filter dsh-system-notification-plugin run check
pnpm --filter dsh-system-notification-plugin run test

依赖解析统一维护在根目录 pnpm-lock.yaml,保留 pnpm 默认的 peer 自动安装行为。不要在子项目中使用 npm/yarn 单独安装依赖。

仓库结构与文档分工

  • packages/system-notification:通知插件的运行时代码、Profile patch、图标、测试和说明。
  • CHANGELOG.md:版本、兼容关系和发布记录。
  • docs/compatibility:各次上游兼容审计记录。
  • AGENTS.md:面向编码 Agent 的项目约束。
  • dsh/:部署到用户全局 ~/.dsh/ 的 DSH 源文件,不属于 pnpm workspace。

插件通过自身 package.json 的 dsh.bundle.patch 指向 patch 文件;patch 只描述组件 ID 和 package 名称,业务实现留在插件内,不需要组合层或递归依赖。

许可证

本项目代码采用 Apache License 2.0。第三方依赖及 DeepSeek Harness 本身仍以各自的许可证和条款为准。

—/ 5

No ratings yet

Manifest verification required

Commit 5c2f4009d26f

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout