BrambleXu/dsh-revdiff 预览 preview

BrambleXu/dsh-revdiff

Native interactive Git diff review for DeepSeek Harness with structured annotations sent back to the current Agent session. 深度求索工具链原生交互式 Git diff 审查,支持结构化批注回传至当前 Agent 会话。

Project Overview项目介绍

dsh-revdiff is a native plugin built exclusively for DeepSeek Harness that enables interactive Git diff review directly within the DSH terminal interface. It reads Git unified diff output, parses it into structured data for files, hunks, and line positions, and renders its own interactive terminal UI for review. To install the plugin, users clone the repository and run the DSH CLI command dsh plugin --profile <profile-name> add ./dsh-revdiff to add it to their Harness profile. The only external dependency required is a working Git installation accessible to the DSH runtime.

This plugin is designed for developers who want to keep their entire diff review workflow within an existing DeepSeek Harness session, eliminating the context break that comes from reviewing diffs in an external tool. Users trigger reviews with the /revdiff command, and can add flags to review only staged changes, only unstaged changes, or compare against a specified base revision. Path filters can be added after a -- flag to narrow the review to specific files. Users navigate between files, hunks, and lines with keyboard shortcuts, and can add, edit, or delete annotations for issues, suggestions, questions, or praise.

dsh-revdiff requires Node.js version 22.19 or higher, and is developed using TypeScript 5.9. It is released under the permissive open-source MIT license, so users can modify, use, and redistribute it freely for any purpose. Currently, it only supports textual changes tracked by Git diff, and does not yet support untracked files, binary patches, side-by-side rendering, mouse input, or browser-based review interfaces. Users can configure multiple aspects of the plugin, including the Git binary path, diff context lines, diff size and time limits, and maximum comment length, by overriding the plugin entry in a Harness configuration patch layer.

dsh-revdiff 是一款专为 DeepSeek Harness 开发的原生插件,用于在 DSH 的终端交互界面中完成 Git 差异评审工作。它可以读取 Git 统一差异格式,将其解析为文件、代码块和行位置信息,提供原生终端交互评审界面,并将用户提交的评审注释作为后续任务排入代理会话队列。安装方式为通过 DSH CLI 将本地检出后的仓库添加到指定配置文件中完成加载。

该插件面向需要在 DeepSeek Harness 会话内完成代码差异评审的开发者,解决了使用外部工具评审导致的上下文和会话连接断裂问题。用户可以通过 /revdiff 命令触发不同类型的差异评审,支持查看工作区、暂存区、未暂存区的变更,也支持对比指定基础分支或按路径过滤变更。用户可在交互界面中导航不同文件、代码块,添加、编辑或删除各类评审注释。

该插件仅依赖运行环境中可访问的 Git 工具,要求 Node.js 版本为 ^22.19 或 >=24,使用 TypeScript 5.9 开发,采用 MIT 许可开源,可免费使用和修改。目前暂不支持未追踪文件、二进制补丁、并排渲染、鼠标输入和浏览器端托管的评审界面,现有功能仅聚焦于 Git diff 生成的文本变更评审。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

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

CLI Install命令行安装

dsh plugin --profile web add github:BrambleXu/dsh-revdiff

把 BrambleXu/dsh-revdiff 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-revdiff

dsh-revdiff hero

MIT license Node.js ^22.19 or >=24 TypeScript 5.9 Tests with Vitest

awesome · DSH plugin · development

English | 中文

Native interactive diff review for DeepSeek Harness. The plugin reads a Git unified diff, parses it into files, hunks, and line locations, presents its own terminal review interface, and queues submitted annotations as the Agent's next durable follow-up turn.

Why this exists 💡

Reviewing a diff in a separate tool breaks the connection between the change, the review context, and the Agent that will act on the feedback. dsh-revdiff keeps review inside Harness, so annotations are created against the actual Git diff and returned to the same durable session.

Features ✨

  • Review tracked working-tree, staged, unstaged, or base-revision changes with optional path filters.
  • Navigate between files, hunks, and diff lines from an interactive terminal.
  • Add, edit, and delete issue, suggestion, question, or praise annotations.
  • Submit structured annotations to the current Agent through agent.followup() with message provenance.
  • Configure Git execution, diff context, size and time limits, terminal grace period, and comment length.

Install 📦

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-companion 下一个 Next dsh-sidebar-mode →