truelove-dreamer/dsh-plugin-git-workflow

Name: truelove-dreamer/dsh-plugin-git-workflow
Author: truelove-dreamer

插件Plugin 原生Native ⭐ 3 代理编排Agent Orchestration 编程Coding 安全Security

DeepSeek Harness插件：为模型提供一流的Git工作流工具——仓库状态、差异、带验证消息的提交创建、最近历史记录及分支。无裸shell git调用；每次调用均为无shell的execFile，并带有路径和消息验证。

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

DSH 插件,把 Git 封装为结构化工具集,提供 git_status、git_diff、git_log、git_commit、git_branch 五个工具,取代裸 shell 调用。核心能力:porcelain 解析、参数逐项转义、路径词法校验、JSON schema 输出。适用于模型需要查看状态、diff、规范提交或浏览分支的场景,常见于代码任务自动化中。需注意:依赖 git 自身约束符号链接,commit 要求已配置 user.name/email,read-only 会话无法写入,且暂不含 push/pull/rebase 等网络操作。

A DSH plugin that exposes Git as structured tools: git_status, git_diff, git_log, git_commit, and git_branch, replacing raw shell calls. Core capability: porcelain parsing, per-argument shell escaping, lexical path validation, and JSON schema output. Use it when models need repository status, diffs, conventional commits, or branch listings during automated coding tasks. Caveat: symbolic-link traversal depends on Git itself, commits require configured user.name/email, write operations fail in read-only sessions, and network ops like push/pull/rebase are not included.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-plugin-git-workflow】【https://github.com/truelove-dreamer/dsh-plugin-git-workflow】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add dsh-plugin-git-workflow

把 truelove-dreamer/dsh-plugin-git-workflow 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

3.2 KB · 缓存于 2026-08-25 04:53:46 · 3.2 KB

dsh-plugin-git-workflow

DeepSeek Harness 插件:给模型提供一等公民的 Git 工作流工具 —— 仓库状态、diff、规范 commit、历史、分支,不再需要裸 bash/pwsh 手搓 git。

背景

DSH 内置没有任何 git 工具。模型只能通过 bash/pwsh 调用 git,输出原始、易错、难解析,还容易把用户输入拼进 shell 命令(注入风险)。这个插件把 Git 变成结构化、安全、可解析的工具集。

工具

工具	作用
`git_status`	分支、upstream、ahead/behind、staged / unstaged / untracked / conflicts 清单(porcelain 解析)
`git_diff`	工作区 diff 或 staged diff(`--cached`),支持 `--stat` 摘要、路径过滤、行数截断
`git_log`	最近提交(hash/日期/subject),可选 `files` 列出每个提交改动的文件
`git_commit`	校验 message 后 `git add`(可选路径)+ `git commit -m`;清晰报出 "nothing to commit"
`git_branch`	本地分支列表,标记当前分支

安装

dsh plugin --profile web add dsh-plugin-git-workflow

挂载(profile cordis.patch.yml 或 agent preset):

- insert:
    - id: git-workflow
      name: dsh-plugin-git-workflow

使用

git_status                        # 看当前仓库状态
git_diff                          # 看未暂存改动
git_diff staged: true             # 看已暂存改动
git_commit message: "fix: ..."    # 提交(全部已暂存内容)
git_commit message: "feat: ..." paths: ["src/a.js"]   # 先 add 再提交
git_log count: 20 files: true     # 最近 20 条 + 改动文件
git_branch                        # 分支列表

所有工具都接受 workdir(默认会话工作目录,相对路径按会话目录解析)。

设计说明

零 shell 注入:所有 git 调用经 harness 的 shell 执行器(ctx.shell)运行,参数逐个引号转义,用户输入不可能被解释为 shell 语法——同时继承沙箱与审批语义(read-only 会话无法 commit)。
输入校验:commit message 非空、≤2000 字符、无 NUL;路径拒绝绝对路径与 .. 穿越(反斜杠归一化后检查),保证不越出仓库。
纯逻辑可单测:解析(porcelain / diff-stat / log / branch)与校验全部在 lib/git.js 纯函数里,npm test 零依赖。
结构化输出:每个工具返回带 schema 的 JSON,render 输出可读文本;失败返回 { ok:false, exitCode, message } 而非裸报错。

诚实边界

git 调用经 harness 的 shell 执行器(ctx.shell)运行,继承沙箱与审批语义;路径校验是词法级的,符号链接/工作树外路径依赖 git 自身约束。read-only 模式下写操作(git add / commit)会被沙箱拒绝。
commit 需要仓库已配置 user.name/user.email(git 自身报错会透传)。
git_log 的 files 解析假设 --name-status 输出格式;非常规编码的路径可能显示不完整。
不含 push / pull / rebase 等网络操作(后续版本可加,需审批语义配合)。

本地开发

cd plugins/dsh-plugin-git-workflow
npm test          # node --test,零依赖

接线集成测试(需 harness checkout 的 Cordis):见仓库根 test-wiring.mjs。

渲染基于仓库 truelove-dreamer/dsh-plugin-git-workflow 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install