Apache-2.0 的 Rust CLI，为 Agent 和人类提供覆盖终端输出与 AI 会话（含本地 Dsh 会话）的统一可搜索记忆，通过 MCP 工具与 shell 钩子接入。
DSH 适配
兼容
作者声明
安全审计
未审计
最后核验
2026-08-21
许可证
Apache-2.0
01它能帮你完成什么？
Give DeepSeek Harness (Dsh) workflows a searchable agent memory over terminal output and AI sessions
Searchable WorkRecords — local Dsh sessions, terminal commands with stdout/stderr, exit codes and durations — reachable by agents via sivtr_search / sivtr_show / sivtr_zoom / sivtr_filter / sivtr_status
Developers running Dsh and other coding agents who want the agent to recall local evidence instead of re-pasting logs
Let the agent fix recent failures and resume interrupted work without pasting logs
Agent-driven fixes and resumable context based on exact local records, addressed to every hit via stable refs (show / zoom / filter)
Developers whose agents repeatedly rebuild already-existing context from terminal errors, test output and previous AI sessions
02如何接入 DeepSeek Harness？
前置条件
- A supported shell: Bash, Zsh, PowerShell or Nushell (shell hooks capture command output)
- No Rust toolchain required for the prebuilt CLI (`cargo binstall sivtr` or the install script); Rust is only needed for `cargo install sivtr` from source
- Node/npx only if you add the optional sivtr-memory skill (`npx skills add Ariestar/sivtr --skill sivtr-memory -g`)
安装步骤
- 01
Install the CLI: `cargo binstall sivtr` (prebuilt), or `curl -fsSL https://raw.githubusercontent.com/Ariestar/sivtr/main/install.sh | sh` on Linux/macOS/WSL, or `irm https://raw.githubusercontent.com/Ariestar/sivtr/main/install.ps1 | iex` on Windows PowerShell
$ curl -fsSL https://raw.githubusercontent.com/Ariestar/sivtr/main/install.sh | sh
- 02
Run `sivtr setup` for one-shot configuration (env detection + shell hooks + MCP host + sivtr-memory skill + smoke check), or stepwise: `sivtr init bash|zsh|powershell|nushell`, `sivtr mcp install`, `npx skills add Ariestar/sivtr --skill sivtr-memory -g -y`
$ npx skills add Ariestar/sivtr --skill sivtr-memory -g -y
- 03
Use `sivtr mcp install -p <hosts>` to register MCP with specific hosts; Dsh is one of the supported local sources whose agent sessions become searchable
验证接入成功
- Run `sivtr doctor` to diagnose and auto-fix binary/config/hooks/providers; `sivtr setup` itself ends with a smoke check
03DSH 适配与能力边界
MCP-first agent memory CLI: register MCP tools for agent hosts via `sivtr mcp install`, and index local Dsh (DeepSeek Harness) agent sessions as searchable memory
MCP-first agent memory
local terminal output + all registered agent provider sessions (incl. Dsh)→agent-callable tools sivtr_search / sivtr_show / sivtr_zoom / sivtr_filter / sivtr_status
modifies agent host configuration to register the MCP server (`sivtr mcp install`)Shell history with output capture
commands run in Bash, Zsh, PowerShell or Nushell→records of command, stdout/stderr, exit code, directory and duration
installs hooks into your shell profile to capture command output (on Windows the hook is written only into the PowerShell profile, no registry changes)Named memory variables & TUI search
search results and command outputs→saved variables like @last / @failures usable in pipelines (`@`, `@failures[1,3..5]`), plus search/show/filter/nav CLI and a TUI workspace browser
Cross-device sharing & groups
local workspaces→read-only shares browsed via `desk:...` refs; multi-device groups with automatic sync
data leaves the machine during share/group sync (opt-in, read-only, common secrets redacted by default); an iroh daemon is started automatically when needed
04适合谁？何时不该用？
适合
- Developers running Dsh and other coding agents who want the agent to recall local evidence instead of re-pasting logs
- Developers whose agents repeatedly rebuild already-existing context from terminal errors, test output and previous AI sessions
05兼容性、维护与安全提示
- On Windows, `sivtr init powershell` may report that the profile is not loaded; you need to run `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` once to raise the current user's execution policy. The hook is written only into the PowerShell profile — no registry changes.
- Memory is local-first, but cross-device sharing and group sync send data off-machine over encrypted iroh (opt-in, read-only, with common secrets redacted before leaving the machine), and a daemon starts automatically when needed.
- `sivtr setup` / `sivtr init` modify your shell configuration by installing hooks into your shell profile so command output can be captured; `sivtr doctor --fix` is provided to diagnose and repair hooks.
Apache-2.0 · actively maintained (latest release v0.5.1, 2026-08-18)
06常见问题
sivtr 如何接入 DeepSeek Harness（Dsh）？
Dsh 是 sivtr 支持的数据来源之一：本地 Dsh agent 会话会被索引，与终端输出和其他 Agent 会话一起可搜索。Agent 工作流建议用 `sivtr mcp install` 注册 MCP，并可选装内置 sivtr-memory skill。
是 dsh 原生插件还是走 MCP？
以 MCP 为主：执行 `sivtr mcp install` 后，Agent 直接调用 sivtr_search / sivtr_show / sivtr_zoom / sivtr_filter / sivtr_status。人也可以随时用 CLI 和 TUI 浏览器自己查。
安装前需要准备什么？
只需要一个受支持的 shell。`cargo binstall sivtr` 或安装脚本安装的是预编译二进制，无需 Rust 工具链；仅当添加可选的 sivtr-memory skill 时才需要 Node/npx。
数据会离开本机吗？
记忆默认保存在本地 workspace。跨设备分享是 opt-in 且只读，数据离开本机前默认脱敏常见密钥，传输走加密 iroh，必要时自动启动 daemon。
有什么已知限制？
Windows 上 `sivtr init powershell` 可能需要先执行一次 `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`。钩子只写入 shell profile（不改注册表），配置异常可用 `sivtr doctor --fix` 自动修复。
07相关的 DSH 工作流
deepseek-reasonix
作者 esengine
专为 DeepSeek 打造的终端 AI 编程智能体，围绕前缀缓存稳定性设计，可常驻运行。
mnemon
作者 mnemon-dev
LLM 监督的持久记忆系统，基于图结构召回、跨会话知识共享，单个二进制文件，兼容 DeepSeek Harness 等运行时。
phi
作者 pulseaiclub
来自 pi 的编码智能体，支持无限提供方、子智能体、行内编辑与权限门控。
deepseek-harness-docker
作者 runzhliu
社区 Docker 与 Kubernetes 打包，含加固镜像、Compose、Helm、Web UI 与无头 CLI。
08数据与来源
| Dsh | 本地 Dsh agent sessions. |
**一个搜索面覆盖本地工作**：终端输出 + 所有已注册 Agent provider（Codex / Claude Code / Cursor / Dsh / Gemini / Goose / Hermes / OpenCode / Op…
Agent 工作流建议安装 `sivtr` CLI，用 `sivtr mcp install` 注册 MCP，并可选用内置 `sivtr-memory` skill。
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-08-21。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。