CARVIN94/dsh-router-ext-rtk

Name: CARVIN94/dsh-router-ext-rtk
Author: CARVIN94

Plugin插件 Native原生 ⭐ 3 MIT Models & Routing模型与路由

Project Overview项目介绍

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

This is an RTK (Rust Token Killer) extension for dsh-router. It rewrites and compresses bash outputs invoked by agents, cutting 60-90% of tokens sent to LLMs. Use it when you need to reduce LLM token consumption for dsh-router workflows. You must install dsh-router core and local RTK binary first.

这是dsh-router的RTK（Rust Token Killer）扩展插件。核心能力是将Agent调用的bash命令改写压缩，可减少60%-90%发给大模型的token。当你需要降低大模型输入token消耗时使用，注意需先安装dsh-router核心和本地RTK二进制才能使用。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我了解并安装插件：【dsh-router-ext-rtk】【https://github.com/CARVIN94/dsh-router-ext-rtk】

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.把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。

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

CLI Install命令行安装

dsh plugin --profile web add dsh-router-core

把 CARVIN94/dsh-router-ext-rtk 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

5.9 KB · 缓存于 2026-09-16 19:39:07 · 5.9 KB

dsh-router-ext-rtk

dsh-router 的 RTK 扩展插件

快速安装 · 能力 · 与核心的分工 · 扩展开发

为 dsh-router 提供 RTK(Rust Token Killer) 真实代理:把 agent 每次 bash 工具调用改写成 rtk <cmd>(如 git status → rtk git status),削减发给 LLM 的 60–90% bash 输出。

单独装它没用——核心提供面板与开关存储,本插件提供改写与拦截。

快速安装

需要 DSH 0.1.5-rc.1 及以上。

先装核心,再装本插件,然后重启 dsh web:

dsh plugin --profile web add dsh-router-core
dsh plugin --profile web add dsh-router-ext-rtk

dsh plugin add 会在 profile 里 pnpm add,并自动把声明了 dsh.bundle.patch 的包加入 dsh.profile.bundles(本插件即声明了,见 cordis.patch.yml)。

然后在「设置 → 路由 → 扩展」页打开 RTK 开关。

前置:本机装 RTK

RTK 是 rtk-ai/rtk(Rust Token Killer), 不是 Rust Type Kit(reachingforthejack/rtk)。

brew install rtk
# 或
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh

验证:

rtk --version   # 应返回 0.x
rtk gain        # 应显示 token 节省统计(不是 command not found)

未装 rtk 时开关开不了:插件启动自检会报 ready:false,核心拒绝开启(API 409), 面板内容区红字提示原因。装上后重启 dsh web 即可。

能力

能力	说明
真实代理	每条 bash 命令经 `rtk rewrite` 改写后执行,LLM 读的是压缩后的输出。
降级安全	rtk 缺失 / 无等价改写 / spawn 失败 → 命令原样执行,绝不报错。
只拦 bash	其他工具(含 `run_code` 体内自起的子进程)不动。
开关自检	启动时探测 rtk;不可用时核心拒绝开启并给出问题描述。
开关持久化	状态存核心的 `<profile>/data/ext.json`,默认关(插件经 `router.extStore` 读写,不自己存)。

实测:ls 走代理后输出变成 rtk 树形格式(带文件大小与 ... (N filtered)), rtk gain 报 3 条命令省 280 tokens(61.9%)。

配置

环境变量	作用
`DSH_RTK_BIN`	显式指定 rtk 可执行文件路径。缺省走 `PATH`,再兜底常见安装路径(`~/.local/bin/rtk`、`/opt/homebrew/bin/rtk`、`/usr/local/bin/rtk`、`~/.cargo/bin/rtk`)。

与核心的分工

核心 = 管理面,本插件 = 执行面(2026-09 重构:拦截与裁决从核心归还插件, 核心只在一个消费者时代挂是纯亏损)。

核心负责:持有 router.ext 注册表(发现)、渲染面板与 /router/api/ext(展示)、把开关与插件数据落盘 <dataDir>/ext.json(router.extStore service)、按 getState().ready 裁决能否开启(不可用时拒 409、面板开关禁开)。

本插件负责:自己挂 tools/execute 拦截 bash、按「核心存的 enabled + 自己报的 ready」裁决、命中则用改写后的命令短路执行;rtk rewrite 退出码解读与探活也在这里。

本插件无状态:开关与数据都经 router.extStore 读写(isEnabled / readData), 不自己 file IO、没有数据目录。

src/
  index.ts       插件入口(host 半,注册 rtk 扩展器 + 挂拦截)
  intercept.ts   拦截实现(挂 tools/execute、裁决、短路)—— 无状态
  rtk.ts         RTK 扩展器实现(rewrite 退出码解读、rtk 定位/探活)—— 无状态
  contract.ts    router.ext 契约副本(自含,与 dsh-router 契约同步)
  *.test.ts      测试
cordis.patch.yml  bundle patch,把插件插入 DSH cordis bundle stack

ponytail: 天花板 —— 本插件自己挂监听,多扩展插件各自挂时顺序不可控。目前只有 rtk 一家,无所谓;第二家出现时要收敛(升级路径:核心暴露顺序委派的共享工具方法, 而不是收回拦截)。

头号坑:tools.get('bash', exec.agent) 的 agent scope 不能省 —— 不带只查全局视图,查不到 → 静默走原样、从不改写、不报错。已在 intercept.ts 文件头 + 测试锁定。

完整契约见 dsh-router 的 docs/ext.md。

`rtk rewrite` 退出码

RTK 权限默认 least-privilege,几乎没有命令会落到 Allow(0)——常见命令 (git status / ls / cat …)都返回 Ask(3)。真实代理下用户已显式开启开关 = 授权改写,所以退出码 3 也采用 stdout,不弹二次确认:

退出码	语义	行为
0	Allow,有等价改写	采用 stdout
1	无等价	放行(原样执行)
2	Deny 规则	放行(不做阻断)
3	Ask,有等价改写但默认要人工确认	采用 stdout——用户已授权
—	spawn 失败 / 超时(2s)	放行

开发

pnpm install
pnpm typecheck
pnpm test
pnpm build        # lib/index.js

致谢

rtk-ai/rtk —— Rust Token Killer,命令输出压缩器。

许可证

MIT

免责声明

本项目仅用于学习与技术研究,请勿用于商业用途。

渲染基于仓库 CARVIN94/dsh-router-ext-rtk 的 README.md。在 GitHub 查看原文 →

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