Miku196/dsh-tokensave

DSH插件:tokensave 语义图 CLI 直连——自动索引 + 更新检测,让AI用语义查询替代暴力grep/读文件,大幅节省token。

Project Overview项目介绍

dsh-tokensaver is a DSH plugin that wires the tokensave local semantic-graph engine into DeepSeek Harness. Via direct CLI bridging it exposes 80+ tools (search, callers, callees, dead_code, circular, etc.) and injects system-prompt guidance so agents explore code through semantic queries instead of brute grep/file reads, saving tokens. Use it for code navigation, call-chain analysis, and dead-code or circular-dependency detection. It requires the tokensave binary preinstalled; since 0.2.0 only CLI mode is supported and MCP mode has been removed.

dsh-tokensaver 是把 tokensave 本地语义图引擎接入 DeepSeek Harness 的插件,通过 CLI 直连提供 80+ 语义工具(search、callers、callees、dead_code 等),并注入系统提示词引导 agent 用语义查询代替 grep/读文件以省 token。适用于代码探索、调用链分析、死代码与循环依赖检测。需预装 tokensave 二进制;0.2.0 起仅支持 CLI,MCP 模式已移除。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

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

CLI Install命令行安装

dsh plugin --profile web add github:Miku196/dsh-tokensave

把 Miku196/dsh-tokensave 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-tokensaver

DeepSeek Harness 移植版 pi-tokensaver(Pi coding agent 扩展)—— 把 tokensave 的本地语义图引擎接进 DSH,让 agent 用语义查询代替暴力 grep/读文件,大幅省 token。

license version dsh-plugin

它做什么

pi-tokensaver 阶段 DSH 中的实现
1. tokensave sync + .gitignore 卫生 本插件(apply 时执行 init/sync)
2. 工具桥接 cli 直连(0.2.0 起 MCP 模式已移除):tokensave tool <name> --args <json>,无 serve 进程、无 MCP,工具名 tokensave_*
3. 系统提示词注入 本插件(ctx.systemPrompt.section)
4. teardown 杀进程 无长驻进程,无需处理

装好后模型会自动获得 80+ 个语义图工具(search / callers / callees / body / entities / status / dead_code / circular …),并在系统提示词中被引导优先使用它们探索代码——一次语义查询省 900–2000 token。

安装(web profile 示例)

前置条件:

  1. tokensave 已安装(cargo install tokensave,或从 GitHub Releases 下载 tokensave-vX.Y.Z-x86_64-windows.zip 解压后放入 PATH)。
  2. dsh 可用,且 profile 目录有 pnpm(dsh plugin 依赖)。

从 GitHub 安装(推荐)

dsh plugin --profile web add github:Miku196/dsh-tokensave

本地开发安装

dsh plugin --profile web add file:/path/to/dsh-tokensave

挂载配置(默认零配置,不用改任何文件)

dsh-tokensaver 是 bundle 插件(自带 cordis.patch.yml 声明,安装后即注册)。安装后无需修改任何配置——cordis.patch.yml 里不需要(也不应该)出现 tokensaver 条目:

  • ❌ 不要 insert 同名条目——重复声明会导致 dsh 崩溃;
  • ✅ 工具调用自动跟随会话工作目录、向上找最近索引、全新目录自动 init(见下"索引定位")。

仅在特殊需求时(如 headless/无会话场景需要固定操作根),在 $DSH_HOME/profiles/web/cordis.patch.yml 里按 id 定位的 config override 覆盖:

- id: tokensaver
  config:
    binary: tokensave            # 可执行文件路径或 PATH 上的命令名(默认)
    cwd: /path/to/your/project   # 可选:固定操作根(默认跟随会话工作目录)
    autoSync: true               # 默认:启动时 init(无索引)/ sync(有索引)

config 是整体替换:未写出的字段回落到插件的 schema 默认值。 0.2.0 起仅支持 cli 直连,MCP 模式(bridge: "mcp" + dsh-mcp-client 行)已移除。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev mindspace-dsh-local-rag 下一个 Next dsh-agent-notify →