DeepSeek Harness 插件

qinghuidaqzp/dsh-change-tour

Star 数 ★ 0 分类 开发与运行时 收录于 2026-11-20

基于 dsh 自带的工作区改动记录,在右侧栏按轮列出 Agent 改了什么:改动的文件、行数和逐行对比;在本地按规则标出新加的密钥、.env 文件、安装脚本、删除的文件、大段删除、删掉或跳过的测试、依赖/CI/数据库迁移改动和工作区以外的文件;点按钮时请这个会话的模型用大白话讲一遍,给出总结、每个文件一句话和值得亲自检查的地方。

安装

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:qinghuidaqzp/dsh-change-tour

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

English | 中文

DeepSeek Harness(dsh)右侧栏插件:用大白话看懂 Agent 每一轮改了什么。

Agent 一轮可能改十几个文件。会写代码的人要逐个看 diff,不会写代码的人就只能凭感觉点"接受"。改动导游把每一轮的改动整理成一张"导游图":

  • 改了哪些文件:每个文件是新建、修改还是删除,加了几行、删了几行。点"看改动"能展开逐行对比。
  • 哪些地方值得多看一眼:在你的电脑上按规则检查,不联网、不花钱,自动标出下面这些情况。
  • 大白话讲解(可选):点"用大白话讲讲这一轮",插件会把这一轮的改动发给你在 dsh 里用的模型讲一遍。讲解包括一段总结、每个文件一句话,以及"值得你亲自检查"的地方。

改动导游在 dsh 右侧栏里

截图来自测试环境:Agent 往配置文件里写了一个假的 API Key,并删掉了一个测试文件。讲解文字来自测试用的本地模型替身(test/mockseek.mjs),用真实模型时内容会更具体。

会标出哪些情况

标记 级别 什么时候出现
疑似写进了密钥 要当心 新加的内容里有很像 API Key、GitHub 令牌、AWS 密钥、私钥或 password = "…" 的字符串
改了 .env 环境变量 要当心 改了 .env、.env.local 这类文件
加了安装时自动运行的脚本 要当心 package.json 里新加了 install / postinstall / prepare 脚本
删除了文件 值得看看 整个文件被删掉
删了 N 行 值得看看 一个文件删了 80 行以上,或删的远多于加的
删了测试 / 少了 N 个测试 值得看看 测试文件被删,或测试用例变少
跳过了测试 值得看看 新加了 .skip、xit、@pytest.mark.skip、.only 等
依赖变了 值得看看 改了 package.json、requirements.txt、go.mod、Cargo.toml 等
改了 CI / 自动部署 值得看看 改了 .github/workflows、.gitlab-ci.yml 等
数据库结构 值得看看 改了 migrations/ 下的文件或 .sql
工作区以外的文件 值得看看 改动发生在当前工作区外面
新文件、配置文件、锁文件、二进制文件 提示 只是告诉你,不算问题

每一轮会根据最严重的标记显示"要当心""值得看看"或"没发现问题"。

讲解要花钱吗

风险标记完全在本地完成,不花钱。

大白话讲解会调用一次模型。默认用这个会话最近一次用的模型,也可以在配置里指定。插件最多发送 24,000 个字符的改动内容,最多让模型输出 1,200 个 token。用 deepseek-flash 讲一轮,通常花费不到一分钱。

默认只在你点按钮时才讲解;如果想每轮自动讲解,可以打开 autoExplain。

怎么做到的

dsh 自带一个记录工作区改动的模块(Web 和桌面版默认开启):每轮结束后,它会记下这一轮改了哪些文件、各改了多少行,还能给出逐行对比。改动导游读取这些记录,所以:

  • 不用自己跑 git,也不会修改你的任何文件;
  • Agent 用文件工具改的、用命令行改的,都能看到(命令行改的需要电脑上装有 git、并且工作区是 git 仓库;否则只能看到用文件工具改的);
  • 逐行对比只在会话还开着时可以看,dsh 重启后,旧记录只保留文件列表、标记和讲解。

安装

需要 dsh ≥ 0.2.0,在 0.2.2-rc.1 上实测过。

dsh plugin --profile web add github:qinghuidaqzp/dsh-change-tour

装好后重启 dsh,在右侧栏的引导页里点 改动导游。

配置

键 默认值 说明
stateFile dsh 主目录下的 change-tour/tours.json 记录保存在哪里;留空只存在内存里
autoExplain false 每轮结束后自动讲解(每次花一点钱)
language zh 自动讲解用的语言;手动讲解跟随界面语言
provider / model 空 讲解用的模型;留空用这个会话最近一次用的模型
maxOutputTokens 1200 讲解最多输出多少 token
budget 24000 一次最多发给模型多少字符的改动
maxAnalyzedFiles 60 每轮最多读多少个文件的逐行改动来做检查

隐私

  • 风险检查在本地完成,插件自己不联网。
  • 只有你点"讲讲"(或打开了自动讲解)时,这一轮的改动内容才会发给模型,走的是你在 dsh 里配置的同一个模型和账号。注意:如果改动里真的有密钥,讲解时它也会被发给模型。
  • 记录文件里保存文件名、行数、标记和讲解文字,不保存改动的具体内容。

局限

  • 标记是按规则判断的:会有误报(比如测试数据里的假密钥),也会有漏报(比如换了写法的密钥)。它帮你决定先看哪里,不能代替代码审查。
  • 讲解是模型写的,可能出错;重要的改动还是要看"看改动"里的原文。
  • 界面只在 Web 界面(包括桌面版)里显示。

开发

npm install
npm test

test/mockseek.mjs 是一个本地的 DeepSeek 替身,不需要 API Key:用户消息里写 SCRIPT: <命令> 时,它会让 Agent 用 bash 执行这条命令(用来真的改文件);收到改动导游的讲解请求时,它会回一段格式正确的 JSON。

许可证

MIT

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。