dsh-rtk-tools

Name: dsh-rtk-tools
Availability: InStock
Author: pharaohnie

DSH plugin: expose rtk (Rust Token Killer) as wide-category Tools — save 60-90% tokens on shell output with softRewriteBash routing

Stars: 0
Language: TypeScript
Created: Aug 25, 2026
Updated: Aug 25, 2026

Auth

GitHub repo

Introduction

dsh-rtk-tools

DSH 插件：把 rtk (Rust Token Killer) 的 60+ 个 token 优化子命令暴露成模型可调用的 Tool，shell 输出节省 60-90% token（filter / grouping / truncation / dedup 四大策略，由 rtk 二进制实现）。

安装

# 1. 先安装 rtk（本插件不打包二进制）
brew install rtk
# 或: curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/master/install.sh | sh
# 或: cargo install --git https://github.com/rtk-ai/rtk

# 2. 挂载插件（web profile）
dsh plugin --profile web add <path-to-this-directory>
# 重启 DSH 生效

工具（10 个）

工具	用途	args 示例
`rtk_git`	任意 git 子命令（59-80% 节省）	`["status"]`、`["log","--oneline","-n","20"]`
`rtk_search`	ls/tree/read/grep/rg/find/wc/env/json/log/deps/summary/format/smart（60-75%）	`["grep","TODO","."]`、`["read","file.ts"]`
`rtk_build`	cargo/tsc/lint/next/prettier/ruff/golangci-lint/rubocop/mvn/gradlew/sbt/dotnet/php 系（70-87%）	`["cargo","build"]`、`["tsc"]`
`rtk_test`	jest/vitest/pytest/go/cargo/rake/rspec/playwright/mvn/gradlew/sbt/dotnet/php 系（60-99.5%）	`["vitest"]`、`["pytest"]`
`rtk_pkg`	pnpm/npm/npx/pip/uv/cargo/prisma（70-90%）	`["pnpm","list"]`
`rtk_infra`	docker/kubectl/oc/aws/glab/gt/pulumi（26-85%）	`["docker","ps"]`
`rtk_cloud`	curl/wget/psql（65-70%）	`["curl","-s","https://..."]`
`rtk_err`	任意命令只看 errors/warnings（70-90%）	`["npm","install"]`
`rtk_summary`	任意命令 2 行智能摘要（70-90%）	`["npm","test"]`
`rtk_doctor`	诊断 rtk 安装状态	`{}`

不暴露（安全设计）：rtk run（sh -c 透传，会绕过 DSH 沙箱）及 15 个元命令（init/hook/discover/config/rewrite/trust/telemetry 等）--如确需运行请直接使用 bash 工具。

设计要点

执行通道：主路径 ctx.shell.run（参数经 POSIX 单引号转义拼 command 字符串），自动继承 DSH 沙箱/审批/spill/jobs 治理；shell 服务异常时降级 execFile 直接 argv spawn。
白名单校验：无前缀工具的 args[0] 必须命中该类别白名单（真实 rtk 子命令）；全局黑名单硬拒绝元命令。
canonical output：{ stdout, stderr, exitCode(number|null), timedOut, truncated, spillPath?, durationMs, rtkCommand, rtkVersion }；截断输出 spill 到磁盘，模型可用 read 工具读 spillPath。
与 dsh-context-mode 正交：一个管大文件检索/知识库，一个管 shell 输出压缩，可共存。

配置

# dsh profile 配置（可选）
- id: rtk-tools
  name: dsh-rtk-tools
  # config:
  #   rtkPath: /opt/homebrew/bin/rtk
  #   defaultTimeoutMs: 30000
  #   stdoutMaxBytes: 200000
  #   injectSystemPromptSection: true
  #   enabledTools: [git, search, test, doctor]

环境变量：RTK_BIN（路径覆盖）、RTK_DEFAULT_TIMEOUT_MS、RTK_STDOUT_MAX_BYTES。

验证

cd <path-to-this-directory>
node scripts/smoke.ts        # 冒烟测试（resolveRtkPath / shQuote / 白名单 / schema）

License

本插件：Apache License 2.0
rtk 二进制：Apache License 2.0（本插件不分发 rtk 二进制，用户自行安装）