dsh-tokensaver

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

它做什么

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 行）已移除。

保存后 dsh web 会自动热重载（无需重启）。新会话中模型即可调用 tokensave_search、tokensave_callers 等工具。

更新插件

dsh plugin --profile web update dsh-tokensaver

配置

字段	默认	说明
binary	tokensave	可执行文件路径或 PATH 命令名
cwd	跟随会话工作目录	可选固定操作根。不配时每次工具调用自动使用当前会话工作目录（exec.agent.session.header.cwd），无需手动指定
bridge	cli	历史字段（仅 cli）：0.2.0 起 MCP 模式已移除，填 mcp 会报错
autoSync	true	启动时 init（无索引）/ sync（有索引，含祖先索引根）
syncTimeoutMs	600000	同步超时
callTimeoutMs	120000	cli 模式单次工具调用超时
updateCheck	true	启动时查 crates.io 是否有 tokensave 新版本，有则告警
updateCheckTimeoutMs	10000	更新检查网络超时
promptOrder	150	提示词 section 顺序（工具指导带 100–199）
gitignoreHygiene	true	自动把 .tokensave/ 加进 .gitignore

索引定位（零配置，不用为每个文件夹建索引）

tokensave 只在精确目录找索引（不向上/向下查找），而索引覆盖整个目录树。插件因此自动补齐：

• 每次工具调用跟随当前会话工作目录（cwd 未配置时）：目录或其任意祖先已有索引（.tokensave/tokensave.db）→ 直接使用该索引根，任何子目录、任何盘符（如 D:\geo 与 C:\...\项目）下工具都自动可用；
• 全新目录（向上找不到索引）→ 首次调用时自动 tokensave init 建索引；
• 安全保护：主目录（~）及其直接子目录（Desktop/Documents/Downloads 等）永不自动 init——在这些位置工具会给出明确提示，避免误索引整个主目录；
• ~/.tokensave（tokensave 的全局配置目录）不会被误判为项目索引。

任何失败都优雅降级：binary 缺失时只告警，不阻塞 profile 启动，也不注入提示词（避免模型调用不存在的工具）。

开发

# 1. 链接运行自测所需的依赖（schemastery / dsh-tools 来自 dsh 安装，勿提交 node_modules/）
npm install    # 或手动建 junction：见 test-cli.mjs 头部注释

# 2. cli 桥单元自测（工具发现 / --help 解析 / schema 生成 / 版本检测 / 真实调用）
#    Windows（PowerShell）：
$env:TOKENSAVE_BINARY = "C:\path\to\tokensave.exe"
$env:TOKENSAVE_CWD = "C:\path\to\indexed\project"
node test-cli.mjs

#    macOS / Linux：
#    TOKENSAVE_BINARY=/path/to/tokensave TOKENSAVE_CWD=/path/to/indexed/project node test-cli.mjs

致谢

• pi-tokensaver（MIT）— 本插件的功能原型
• tokensave — Rust 语义图引擎

License

MIT © dsh-tokensaver contributors