dsh-change-tour
Manifest validA right-sidebar tour of what each agent turn changed, built on dsh's own workspace-changes records: changed files with line counts and diffs, local rule-based flags (secrets in added lines, .env files
dsh-change-tour · 改动导游
English | 中文
DeepSeek Harness(dsh)右侧栏插件:用大白话看懂 Agent 每一轮改了什么。
Agent 一轮可能改十几个文件。会写代码的人要逐个看 diff,不会写代码的人就只能凭感觉点"接受"。改动导游把每一轮的改动整理成一张"导游图":
- 改了哪些文件:每个文件是新建、修改还是删除,加了几行、删了几行。点"看改动"能展开逐行对比。
- 哪些地方值得多看一眼:在你的电脑上按规则检查,不联网、不花钱,自动标出下面这些情况。
- 大白话讲解(可选):点"用大白话讲讲这一轮",插件会把这一轮的改动发给你在 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
Comments
Loading…
Similar plugins
dsh的diff审核
★ 1
MIT
JavaScript
dsh plugin --profile web add dsh-diff-reviewby liuhusk
A permanent status card in the top-right corner of the DSH content area: one line for where this turn's time went (model, tools, waiting), plus collapsible to-dos with a progress bar, the session goal
★ 0
MIT
JavaScript
Nov 17, 2026
dsh plugin --profile web add @liuhusk/dsh-status-cardA sidebar panel that moves, rebuilds, merges, renames and deletes whole workspaces: a move re-publishes each session log with the new directory in its header, repairs the workspace record, refreshes t
★ 0
dsh plugin --profile web add dsh-workspace-controlby Dax233
Agent-facing control plane for the DSH right Sidebar: hierarchical tab overview, open/focus/close across browser/terminal/file kinds, and progressive disclosure (expand a tab to pull its content and t
★ 0
MIT
JavaScript
Oct 28, 2026
dsh plugin --profile web add dsh-sidebar-controlby luckyxiang6688
Read-only explorer for what the Super-agent did with each message: the sources page lists inbound events per source with where they went (admitted, decided into a ticket, filtered, or dropped at the s
★ 0
MIT
TypeScript
Nov 13, 2026
dsh plugin --profile web add dsh-superagent-traceLive change review for DeepSeek Harness: tracks write/edit tool calls per session, lists changed files above the composer and opens each file's line-level diff in a plugin-registered right-sidebar tab
★ 0
dsh plugin --profile web add dsh-change-review-live