Плагины — rtok docs

Каждый метод сокращения токенов в rtok — это плагин за одним трейтом. Плагины — встроенные модули за фичами Cargo: никакого демона, никаких подпроцессов, никакого WASM в v0.1.

Столбец заменяет — это цель спецификации, а не зависимость: rtok реализует поведение заново, с нуля, и никогда не запускает, не линкует и не читает названный инструмент.

Плагин	Заменяет (только спецификация)	Интерфейс
`measure`	rtk gain, headroom savings, lean-ctx gain	`stats`, `bench`, прокси
`cmd`	rtk hook, ctx_shell, bash_compress	PreToolUse(Bash) → `rtok run`
`read`	lean-ctx read/search/tree, read_cache	MCP `read`
`json_tree`	—	proxy, MCP
`archive`	CCR	`expand`, хранилище
`proxy`	caveman-proxy	`ANTHROPIC_BASE_URL`, `OPENAI_BASE_URL`
`inject`	caveman/ponytail, lean-ctx	SessionStart, UserPromptSubmit
`guard`	—	PreToolUse
`memory`	claude-mem	MCP, PreCompact
`graph`	codebase-memory-mcp	MCP
`toon`	—	MCP

Отключение плагинов

Во время работы, в ~/.rtok/config.toml:

[plugins.cmd]
enabled = false

Или при сборке, чтобы код вообще не компилировался:

cargo build --no-default-features --features cmd,read

Каталог каждого плагина

Файл	Что содержит
`README.md`	что делает плагин и зачем — на него ссылается таблица выше
`AGENTS.md`	инварианты и правила задач для тех, кто над ним работает
`PLAN.md`	собственный план разработки плагина

Как написать свой: написание плагинов.

Формат экспорта графа

rtok graph export и MCP-инструмент graph_export выдают один JSON-документ, "schema": "rtok.graph.v1", описанный файлом docs/schemas/rtok.graph.v1.schema.json (он генерируется из типов Rust и проверяется тестом). Ключи верхнего уровня:

Ключ	Содержит
`projects`	`id`, `name`, `root`, `origin`, `backend` (`tags`, `lsp` или `text`), `health` (`ok`, `stale`, `not indexed`, `missing`), `indexed_at`
`links`	`from`, `to`, `kind` (`manual` или `auto`), `reason`, `references` (ссылки-вызовы из `from` в `to`)
`nodes`	`id`, `project`, `kind`, `name`, `path` (относительно проекта), `line`; пуст на уровне `overview`
`edges`	`from`, `to` (id узлов), `kind`
`meta`	`scope`, `level` (`overview`, `symbols` или `focus`), `focus`, `depth`, `exported_at`, `rtok_version`, `redacted`, `partial`, `notes`

Абсолютные пути, домашний каталог и имя пользователя скрываются, если не указан --no-redact (graph_export скрывает всегда); исходный текст не включается никогда, имена файлов и символов включаются. Вызов, чьё имя имеет больше восьми определений, ребра не рисует. --from FILE показывает сохранённый экспорт, не читая и не меняя реестр и индекс.

Картинки

rtok graph export --format svg рисует тот же экспорт картинкой, а --format png растрирует эту картинку (нужен -o FILE, --scale от 1 до 4 — кратность размера SVG). Картинка зависит только от экспорта, поэтому --from FILE рисует сохранённый экспорт точно так же, как живую область. Проекты — панели, символы — точки на спирали (самые связанные в центре; круг — функция, квадрат — тип, ромб — модуль), сплошная стрелка — вызов внутри проекта, пунктирная — вызов между проектами, толстая линия — связь проектов. Рисуется не больше 200 узлов; подвал говорит, сколько скрыто, а JSON всегда содержит все. В подвале также проекты с бэкендом и indexed_at, область, версия rtok, время экспорта и, если проект не смог ответить, пометка PARTIAL. Для PNG на машине нужен шрифт; без него команда так и скажет, а не нарисует картинку без текста. MCP graph_export остаётся JSON.

На странице Graph

На странице Graph есть кнопка Export и выбор файла «open an export». Кнопка открывает панель, где сказано, что в файл попадают имена файлов и символов (исходный текст никогда) и что домашний каталог, имя пользователя и абсолютные пути заменены; затем можно выбрать обзор, граф символов открытого проекта и, если выбрана функция, подграф вокруг неё, в формате JSON, SVG или PNG. Файл пишет сервер той же функцией, что вызывает rtok graph export, поэтому JSON совпадает с выводом CLI байт в байт, кроме exported_at; страница только сохраняет его. Картинки живого кадра в этом меню нет. Выбор файла отправляет сохранённый JSON-экспорт серверу текстом; сервер проверяет его как export::read и возвращает: страница показывает его только для чтения под надписью «viewing export from FILE» и ничего не пишет в реестр и индекс. В rtok tui те же действия появятся в T329.41.