DeepSeek Harness 插件

dsh-repo-context

把 git 状态与仓库规范动态注入 system prompt:分支/脏文件数/最近提交 + 仓库规范指引(官方 system-prompt section/context/variable 缝隙插件)(英文原文)

跳到安装方式

来源信息

GitHub 仓库
qing3a/dsh-repo-context
最近更新
2026年8月14日
分类
工具与能力
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/qing3a/dsh-repo-context
插件名:dsh-repo-context
作者:qing3a

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器2 个文件
README.md来源说明 · 只读预览

dsh-repo-context

> 把 git 状态与仓库规范 动态注入 system prompt——DSH 的 system-prompt 缝隙插件 > (官方 docs/subsystems/system-prompt.md 能力,生态真空位)。

模型每轮组装 prompt 时,自动带上当前仓库的分支/脏文件/最近提交,以及"遵循仓库规范"的指引——不用人肉重复,也不污染历史(走 durable context,变化才记录)。

安装 / 卸载

# 安装(web profile 示例)
dsh plugin --profile web add @qing3a/dsh-repo-context
# 卸载
dsh plugin --profile web remove @qing3a/dsh-repo-context

重启 DSH 后生效。源码安装:dsh plugin add link:<本仓库路径>

Quick start

默认配置即用:在任意 git 仓库内运行,插件自动注入分支/脏文件数/最近提交 + 仓库规范指引。

dsh web --profile web
# 会话中模型即可看到 "Git repository: branch `main`, working tree clean, last commit ..."

Configuration

配置默认说明
enabledtrue总开关
gitContexttrue注入 git 状态 context(分支/脏文件/最近提交)
repoRulestrue注入仓库规范指引 section
refreshSeconds0git 状态缓存刷新间隔(秒),0 = 仅启动时取一次
recentCommits1最近提交展示条数
# profile 的 cordis.patch.yml 覆盖
- update:
    - id: dsh-repo-context
      config:
        refreshSeconds: 60

Permissions & data

  • 只读:仅执行 git rev-parse / git status --porcelain / git log,不写文件、不改配置、无网络请求
  • git 信息只在进程内缓存,不持久化、不外发

Compatibility

  • DSH mainline 47f94385(rc.5 + npm-public 后)实测通过
  • 依赖 ctx.systemPrompt@deepseek-ai/dsh-system-prompt,base bundle 默认挂载)

Verification

dsh-plugin-verify 0.1.2(mock 平台感知修正后)实测:

✅ 通过 | 捕获事件: 13 | waterfall: 7/7 | tools/result: 是
R1-entry-shape ✓  R2-patch-yaml ✓  R3-tools-result ✓(工具真实执行成功,isError:false)

报告:https://github.com/qing3a/dsh-plugin-verify/blob/main/reports/repo-context-2026-08-14.json (判定站已收录 ✅ Verified:https://github.com/qing3a/dsh-plugin-verify)

Development

pnpm install        # 或 npm install
pnpm build          # tsc → lib/

源码要点:text/variable provider 是官方同步签名,git 状态在 apply 时预取缓存(refreshSeconds 定时刷新);变量名 git_branch 满足官方 ^[a-z][a-z0-9_]*$ 约束;namespace 入口无 export default(postmortem 0001)。

License

MIT