在工具输出进入模型之前,经本机 `rtk` CLI 压缩 shell 输出:母开关未显式设置时跟随 rtk 可用性,`prefix` 形态按 agent 遮蔽 `bash` 并向 `rtk rewrite` 要等价命令,需显式开启的 `pipe` 形态在命令跑完后用 `rtk pipe` 过滤结果;复合命令逐段改写,过小或省得太少的输出原样放行,守卫拒绝空结果、原文有失败却宣称成功、丢了 commit hash、条目折进 `+N more` 标记,而 stderr 与退出标记按原样回填;任何失败都回退到原命令与原输出;设置卡通过官方 Typert Remote 命名空间给出调用数、节省 token 与按过滤器的图表。需要 `PATH` 上有 `rtk` 1.0+;缺失时插件照常装载、不压缩任何输出。
安装
# npm 包(预构建)
dsh plugin --profile web add @jayyuen66/dsh-rtk
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:JayYuen666/dsh-rtk
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。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
一个把本机 rtk 二进制放到 shell 工具与模型之间的 dsh 插件。rtk 本身留在你的机器上;插件只负责调度它。
目录
它做什么
- 两种压缩形态;总开关跟随 rtk 就绪状态。
prefix按 agent 遮蔽bash、先过一遍rtk rewrite;pipe把已完成的 shell 结果喂给rtk pipe -f <filter>,只替换模型可见的那段文本。未显式设置enabled时,检测到受支持的 rtk 才默认开启;prefix是默认形态,pipe需要显式打开。 - 复合命令逐段改写。
cd <仓库> && cargo test这种多仓开发时最常见的形状会被拆成独立段,只换掉承载输出的那一段(cd <仓库> && rtk cargo test);拆不开的构造(命令替换、重定向、后台&、引号不配对)仍然整条原样执行。 - 不值得压的一律不压。 小于
minBytes(256)的输出、压缩率不足minGainRatio(0.95)的改写,全部原样放行。插件不报它没做到的节省。 - 失败用例保住原文。 护栏会拒绝任何丢掉失败断言、file:line 或退出码 marker 的压缩——一条看不出为什么挂的失败比不压缩更糟。
- 处处 fail-open。 rtk 没装、rtk 太旧、改写会破坏语义、命令不适合改写:原命令照跑、原文照样送达、什么都不丢。
- 一张设置卡。 命令数、省下的 token 与节省率,外加一张按 filter 的 token 收益条形图,经官方 Typert Remote 命名空间从宿主 storage domain 读出。
安装
dsh plugin --profile web add @jayyuen66/dsh-rtk
撤除用 dsh plugin --profile web remove @jayyuen66/dsh-rtk。包在公共 npm 上,不需要凭据,也不需要 scoped registry 那行。
- Node.js
>= 24.9(纯 ESM;这个地板正是require()一个 ESM 入口能成立的前提,所以engines.node写它)。 - 宿主
dsh在0.2.x这条线上、且不低于0.2.2-rc.2。 宿主读engines.dsh(^0.2.2-rc.2)且单独决定——该字段在场时兼容性先于peerDependencies判定,prerelease 参与比较。0.2.x里凡不低于0.2.2-rc.2的都通过宿主装载门;0.2.2-rc.1及更早的不通过。npm 的严格 peer 解析同样不接受低于0.2.2-rc.2的版本,且 prerelease 一侧只收0.2.2这一元组的(0.2.2-rc.2起)——更高小版本的预发布(如0.2.3-rc.1)要等它的正式版。0.3.0及以上需要风险授权dsh plugin --profile <p> allow-version <pkg>@<ver> --dsh-version <确切版本> --accept-risk。支持窗口是滚动的:本包在发布时把窗口内的每个已发布宿主版本逐版取证(判据是宿主--dump-config里本包的层行;设置卡与它的命名空间调用另在发布基线上全量取证一次),窗口滚动后重新取证,不把这一句里的版本号当长期承诺。 dependencies里没有@deepseek-ai/*,这是契约(test/publish-manifest.test.ts)。profile 用nodeLinker: hoisted+autoInstallPeers: false安装,放进去的宿主包会变成实打实的第二份副本;@deepseek-ai/dsh-tools用普通Symbol给调度器做键,于是那个 profile 里每次原生工具调用都会抛,而 build、typecheck、覆盖率全绿。@deepseek-ai/dsh*peer 携带同一个支持窗口(^0.2.2-rc.2),而devDependencies里的精确钉版是编译期纪律,不是「宿主会读它」的声明。PATH上要有rtk >= 1.0.0。 这是 npm 之外唯一的运行时依赖:macOS/Linux 用brew install rtk,Windows 用winget install rtk-ai.rtk。没有它插件照常装载,所有压缩路径 fail-open。- 随包发布的内容:
host.js、client.js、cordis.patch.yml、icon.svg、双份 README、CHANGELOG.md、THIRD_PARTY_NOTICES.md、locale/zh.json+locale/en.json,以及docs/(两份 DETAIL)。产物由prepack重建,从不入库。
验证它真的生效了
- 层进了栈。
dsh --profile web --dump-config末尾有# == @jayyuen66/dsh-rtk与- id: rtk。这条命令是唯一被接受的判据,且不是只读的——层行要从 stdout 读,同时另外检查 stderr;# == <层>与# == <层>, patched by <路径>两种形状都要认。 - rtk 被找到了。 卡片的就绪行会写出解析到的二进制与它的版本。那里显示
rtk not found说明宿主进程的PATH与你的 shell 不同。 - 某条命令被压了。
enabled: true且卡片计数为零时,让模型跑一次构建或测试套件:下一次卡片刷新里会出现那条调用与字节差。 - 卡片画得出来。 设置页会列出「rtk 输出压缩」(或它的英文标题);改一个值 + 保存 回 200 且脏态清空。
它不提供什么
- 没有自己的 HTTP 路由。 卡片的数据面是官方 Typert Remote 命名空间,经宿主
/api网关;认证、Host/DNS 重绑定/Origin 判据、body 上限都由网关承担。 - 没有 CLI 子命令。
dsh rtk …不存在。 - 不捆绑 rtk 代码。 插件把
rtk命令当子进程调用、消费它的 stdout。用的是 rtk 的 Apache-2.0 面;BUSL engine 里没有任何东西被链接或再分发。 - 不改写工具入参。 dsh 刻意禁止
tools/pre-execute改写工具调用的参数(参数已经被记录与渲染)。所以prefix形态靠按 agent 遮蔽bash实现,而不是去改一次已发生的调用。 - 需要的服务面:
settings/tools/subprocess(都在inject里)。spillStore与storageDomain经ctx.get()现读,缺席时优雅降级。
在 dsh 里启用
dsh.bundle.patch指向cordis.patch.yml,它的insert:块含一条- id: dsh-plugin-shared供应行(必须保持开启;停用后卡片会失去 shared 组件供应),再加一条- id: rtk、name: "@jayyuen66/dsh-rtk"——裸包名才让宿主去扫客户端那一半。卡片组件来自 shared 的客户端行,以@jayyuen66/dsh-plugin-shared/client外置;宿主模块表提供react、zod与这条 shared 供应。- 缺任何一个注入面都会让 cordis 不激活该条目(启动诊断:
pending (waiting for service: …));ctx 形状不对则应用 apply 时抛required services … missing。 - 部署默认值写在注册行的
config:上;优先级是卡片运行值 > 注册行 config > schema.default()。enabled没有静态.default():未设置时按 rtk 版本探测结果兜底。 - 总开关跟随 rtk 就绪状态。 未显式设置
enabled时,rtk 缺失或低于支持下限就保持关闭,检测到受支持版本才默认开启。prefix是默认形态;手动关掉或打开会固定你的选择。开关与形态选择都在下一次工具调用时生效。
两种形态
| prefix | pipe | |
|---|---|---|
| 时机 | 命令执行之前 | shell 结果已存在之后 |
| 做法 | 按 agent 遮蔽 bash,问 rtk rewrite,跑改写后的形态 |
把捕获到的 stdout 喂给 rtk pipe -f <filter> |
| 模型看到什么 | 改写后命令的压缩输出 | 压缩输出,原始 marker 与退出码保持不变 |
| 失败形态 | 改写被拒 → 原命令执行 | filter 不可用 → 原文送达 |
| 复合命令 | 逐段改写:只换承载输出的那一段 | 整条命令的输出一起压 |
| 默认 | enabled 打开时启用 |
关闭(等 rtk 覆盖更多形态) |
prefix 的复合命令处理值得单独说一句:rtk 自己就是逐段改写的(discover/registry.rs 的 rewrite_compound),实测 cd /tmp && cargo test 的产物是 cd /tmp && rtk cargo test。插件把原命令与产物各拆成若干段,要求分隔符序列逐一相同、并让每一段各自通过 P1~P4 校验(没被动过的段逐字符不变,被动过的那段只允许「在开头多一个 rtk 」)。改成别的形状一律拒绝、原命令执行。
设置项
| 键 | 默认值 | 含义 |
|---|---|---|
enabled |
未设置 | 总开关;未设置时检测到受支持的 rtk 才默认开启 |
enabledForms |
['prefix'] |
允许生效的形态;下一次工具调用即生效 |
denyCommands |
[] |
额外永不被改写的命令模式 |
enabledFilters |
['cargo-test','pytest','ctest'] |
允许生效的 pipe filter |
minBytes |
256 |
小于它的输出永不压缩 |
minGainRatio |
0.95 |
压缩后仍占 ≥95% 字节的,丢弃 |
stdoutCapBytes |
64000 |
filter 回执的字节上限:压缩后的正文截尾到这个字节数(退出标记保留) |
warnHint |
true |
cargo test 之后追加编译警告提示行 |
rewriteHostEnv |
'' |
写进 RTK_REWRITE_HOST 的值;空串表示不设 |
pipeTimeoutMs |
3000 |
重启生效 |
rewriteTimeoutMs |
2000 |
重启生效 |
rewriteCacheSize |
256 |
重启生效 |
vitestMaxMajor |
5 |
重启生效;vitest 达到该主版本就不压 |
logFilterMode |
'off' |
重启生效 |
配置 schema 共 14 个字段;其中 13 个带内置默认值,enabled 在显式设置前跟随 rtk 就绪状态。其中卡上那 9 枚是 volatile —— 设置卡写它们,下一次工具调用就生效,enabledForms 也在其中。剩下的非 volatile 部署值,共 5 枚,在装配时读一次,改完要重启。前缀形态会写 rtk 自己的 history.db——真正跑的是改写后的那条命令。
支持面
engines.dsh 与 @deepseek-ai/dsh* peer 是 ^0.2.2-rc.2(单条线,无并集);@deepseek-ai/schemastery peer 是 ^3.19.0;engines.node 是 >=24.9.0。
外部依赖
本仓里每一条结论都是在 rtk 1.2.0 上量出来的。插件要求 >= 1.0.0;低于它时插件报出读到的版本,什么都不做。
数据与隐私
- 命令文本只以 argv 的形式离开宿主进程,交给你自己那个
rtk二进制。 本插件不发起任何网络请求。 - 计数存在宿主的 storage domain 里(
<DSH_HOME>/storages/),每个 filter 一条记录加一条汇总;记录里有命令数、前后字节、前后 token。别的什么都不落盘。 - token 由宿主的
tokenMeter估算(服务缺席时按bytes / 4,与 rtk 官方estimate_tokens_from_len同一口径)。改写形态看不到原始输出,它省下的量只能看rtk gain;统计卡里的数字全部来自结果压缩形态。 - 被压缩的原文可能落进宿主的 spill 区——当它超过内联预算时,走的是宿主每个工具都在用的那套机制,同样的按会话分区。
已知边界
rtk rewrite分不清某个 flag 是不是在要更多细节。 它把cargo test -- --nocapture和pytest -vv跟安静形态一样改写,细节随后被压掉。插件拒绝改写任何带详情 flag 的命令;真压的时候,损失由护栏兜住,不由 rtk 兜。npm run <script>永不被改写。 rtk 把脚本名映射成工具名(npm run lint→rtk lint),那会跑 ESLint 而不是你的脚本。插件会丢掉任何「从原命令里拿掉了某个词」的改写。- listing 类命令会折叠。
ls、find、grep/rg可能把长列表换成+N more标记;护栏识别这一族标记并拒绝压缩,所以折叠后的列表不会经本插件到达模型。 - 审批看到的是你请求的命令,不是改写后的命令。 遮蔽层在
execute里改args.command,而execute跑在管线的tools/pre-execute之后。所以通用命令审批(auto-review、danger-guard、Claude Code 风格的 hooks)求值的是冻结的原始参数(cargo test),实际跑的是改写形态(rtk cargo test)。沙箱升档审批在orig.execute之内,原样保留——插件从不自己 spawn 命令。补在这道缝前面的三样减法由插件负责:信息损失拒绝表(git diff/git log/git show <ref>/ls/find/grep/rg/cargo clippy/aws)、P1~P4 改写校验(只允许剥前缀、不许丢脚本运行词)、以及 vitest 主版本门控。危险命令(rm -rf、git push --force)根本不在 rtk 的改写面里,因此原样执行、原样受审——danger-guard 没有被绕过。 - 复合命令里任意一段命中拒绝表,整条都原样执行。 拒绝表(
git diff/git log/ls/find/grep/rg/cargo clippy/aws等)与 vitest 主版本门控都按段判,因为cd x && git diff的首词是cd——按整条判会让整张表失效。但命中之后不拆开执行:用户敲cd X && git status时预期是一次完整执行,替他把前半段交出去、后半段自己拼不是插件该做的事。 rtk pipe处理失败的 pytest 时保住用例名,但不一定保住断言正文。 护栏检查「有没有成功声明」与「失败行还在不在」;一个两者都过、却仍然丢了细节的 filter 输出,是 filter 的已知边界,不是护栏的。
开发
pnpm install --ignore-scripts
pnpm run check # typecheck + lint + build + test + fmt:check
在伞工作区里跑 pnpm run smoke @jayyuen66/dsh-rtk 会把包装进沙箱 DSH_HOME;被接受的判据是 --dump-config 的层行。
反馈
欢迎提 issue 和 PR:https://github.com/JayYuen666/dsh-rtk/issues。
插件启动失败时,请附上 dsh 宿主版本、profile 安装形态和浏览器控制台原文。missed the module table 这一行尤其有用:它能直接说明 shared 客户端供应行有没有被物化。
许可证
本插件 MIT。rtk 的命令行与命令过滤器是本插件使用的部分,为 Apache-2.0;见 THIRD_PARTY_NOTICES.md。
链接
同类插件
Tencent/WeKnora#dsh-weknora★ 37546
把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己带引用的 RAG 或 ReAct agent 回答(含可续聊的 session id)。
DayuanJiang/next-ai-draw-io#dsh-plugin★ 36997
dsh 的 draw.io 绘图插件:通过 next-ai-drawio MCP 服务器作图,点回复里的链接在右侧栏打开实时预览,可以手动修改图,AI 的每次修改都是可以恢复的版本。需 Node.js 18+,首次使用由 npx 下载 MCP 服务器。
superdesigndev/treg★ 8164
给 Agent 的工具目录:按「要做的事」检索约 2,600 个外部接口(SEO 与 SERP、外链、社交、人物与公司信息补全、广告库、抓取),查看参数与单次调用价格后直接调用,凭据由服务端注入。附带技能,MCP 行在未设置 TREG_TOKEN 前保持禁用。
T-Auto/dsh-ops★ 5864
为 Windows 的 DSH 提供 bash、PowerShell 7 及 Rust 高性能工具,减少 token 消耗。
sixtysevenlf/dsh-blender-plugin★ 2147
让 DSH agent 通过直连 TCP 通道驱动本地 Blender,提供 15 个工具:视口帧、自定义视角渲染、Python 执行、无头与作业卸载、事务回滚,以及 34 个 family / 228 个 op 的规划层。
helloHub1212/dsh-windows-mcp★ 1456
通过官方 MCP 客户端桥接层把 CursorTouch/Windows-MCP 桌面自动化服务器接入 DSH,把截屏、UI 树快照、鼠标键盘输入、剪贴板、进程与注册表等工具注册成 mcp__windows__* 供模型调用,并附带 windows_mcp_doctor 诊断工具;Computer Use 默认关闭,需在插件面板里打开。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。