td-atlas RU·EN Try it

Tool reference

Перевод английской документации от 29.09·English

Имена и описания в таблице стоят по-английски, как их видит агент.

Every td_ name here is an MCP tool the agent calls on the artist's behalf. A person at a terminal has a separate surface, td-atlas, with its own page.

47 MCP tools in three groups. tests/test_skill_reference.py compares every name, every parameter list and that count against the server.

Index — offline, no running TouchDesigner

Tool	Arguments	Use it for
tool `td_search_operators`	arguments query, family, limit	use it for Find an operator by what it does. Plain language. `family` narrows to TOP/CHOP/SOP/DAT/MAT/COMP/POP. A few algorithm names no operator page uses (marching cubes, isosurface, metaball, SDF, dilate/erode) put the operators that do the job first, with a `technique` line saying how.
tool `td_operator_schema`	arguments op_type, page, include_hidden	use it for Exact parameter names, defaults, menu options, ranges, connector counts, path to a shipped example. Menu options print as `value — Label` where the label says more than the value, which is where costs like "(GPU)" live.
tool `td_search_parameters`	arguments query, limit	use it for Which operator has a parameter doing X. How `alwayscook` gets found.
tool `td_python_api`	arguments name, query	use it for Members and methods of a class, with inherited ones resolved.
tool `td_docs`	arguments query, page, limit	use it for 2,060 wiki pages — concepts, techniques, tutorials, not just operators.
tool `td_glossary`	arguments term, limit	use it for 185 glossary entries: Cook, Time Slice, Clone, Perform Mode.
tool `td_palette`	arguments query, category, limit	use it for 277 ready-made components shipped with TouchDesigner.
tool `td_expression_help`	arguments query, limit	use it for Expression and command syntax.
tool `td_example`	arguments op_type, depth	use it for A real working network for an operator, from the shipped snippet library.

Live — acting on a running instance

Tool	Arguments	Use it for
tool `td_status`	arguments	use it for Is the bridge up, what project is open, and is the timeline playing: `timeline: frame 851 (playing) \| start 1 end 994 \| range 1–994 \| rate 60 \| abs 1284807`. Check it before trusting a live CHOP between two of your calls. `abs` is `absTime.frame`, an application count that does not follow the timeline's frame and stands still while the root timeline is paused; waits count `tick` (`op.TDResources.time.frame`) instead. `(!)` on the range means playback stops short of `end`.
tool `td_log`	arguments limit, failures, summary, method	use it for Your own trail: every bridge call this host made, how long it took and what it refused with. A call that changed the project shows what it changed — `tx = 0.5 (was 0.2)`, `ty = expr ...`, each td_build step, parameters and flags with their old value, the head of a td_exec's code — so "put it back the way it was" is `method="par_set"` (or `"batch"`, `"exec"`) and reading, not reconstructing. `td_status` reports no call history at all; this survives the session and answers "what did I break yesterday". `failures=True` for the refusals alone with the repair for the latest; `summary=True` for which methods refuse and which are slow. Offline tools never dial the bridge and leave no trace here.
tool `td_instances`	arguments	use it for Every running TouchDesigner that registered a bridge, and which one these tools reach. Check it before believing an edit landed in the project you meant.
tool `td_doctor`	arguments	use it for Every link — install, index, probe pass, bridge, this server — with the command that fixes each. Catches the index built from another TouchDesigner build, which raises nothing. The read cache is a CLI-only concern: `td-atlas doctor` on a terminal also says how many unpacked projects it holds and `td-atlas doctor --clear-cache` empties it, neither of which this tool reports or does — deleting a user's cache is not something a tool call should do on its own.
tool `td_health`	arguments path, interval	use it for The silent-failure detector: what TouchDesigner never flags. Operators it does flag are only named here; for the message attached to each error and warning, `td_errors`. Run after building anything. Besides dead branches, disabled outputs, shader and callback errors and slow cooks, it flags a cook time left from long before the check (named by the frame it was measured on, so it is not blamed for the frame rate); feedback loops that `cook(force=True)` does not advance; bypassed gain operators (Level, Math, HSV Adjust), which pass their input through instead of switching it off; Level TOPs that can output negative floats into an Add; and reads of `absTime` or an unseeded random generator, which keep a render from reproducing. `interval` is clamped, so a long wait comes back sooner than asked and says so. Read the reply for the two ways it can be partial — a truncated walk and script errors it could not read; see When a reply is cut short below.
tool `td_network`	arguments path, depth	use it for What is inside a component and how it is wired. A network too large for one reply comes back cut, and every cut is named; see When a reply is cut short below. A TOP whose viewer flag is off is marked `[viewer off]` — its tile is empty on purpose, not broken.
tool `td_op_info`	arguments path	use it for One operator: type, wiring, live parameter values, errors.
tool `td_build`	arguments operations, undo_name, owner	use it for Multi-step edits as one atomic, undoable block. Validated first. A created node with no `position` is given a free spot, and one wired inside its own `op_create` lands to the right of its source, so a batch reads left to right. `op_create` takes a `text` key for a DAT's contents, so shader and script source needs no separate `td_exec`. A step key the bridge would not read (`input_index` for `index`) is refused with the right one, not ignored.
tool `td_set_params`	arguments path, pars, op_type, owner	use it for Set parameters on an existing operator. Names and `../` OP references are checked against the index first; without `op_type` the operator's type is asked of the bridge in the same call that resolves the references. With no index built, or a node the bridge cannot type, the write goes out unchecked.
tool `td_palette_load`	arguments name, parent, rename, position, category, owner	use it for Install a palette component by the name `td_palette` reports. Checks the .tox is on disk first, and reports the name TouchDesigner actually gave the node.
tool `td_extension_add`	arguments class_name, code, path, parent, name, extension_name, promote, index, position, owner	use it for Attach a Python class to a COMP as an extension — DAT, three Extensions parameters and the re-init in one call. Parses the code here first, and reads the result back: a class that fails to instantiate leaves the COMP reporting nothing at all.
tool `td_annotate`	arguments text, parent, title, name, path, size, color, position, font_size, mode, owner	use it for Leave a note in the network saying what you built and why — a coloured box beside the nodes it describes. Pass `path` to rewrite a note instead of adding another.
tool `td_annotations`	arguments path, depth	use it for Read the notes in a network, including a brief a person left for you, with the nodes each note's box sits over. Invisible to every other tool here.
tool `td_flags`	arguments path	use it for The flags that decide whether a node runs and what is visible: `display`, `render`, `bypass`, `lock`, `expose`, `viewer`, `activeViewer`, `cloneImmune`, `allowCooking`, `selected`, `pickable`, and which of them this operator does not have. Cooking is `allowCooking`; there is no flag named `cooking`. Check it when a correct-looking network produces nothing.
tool `td_set_flags`	arguments path, flags, owner	use it for Turn those flags on or off. Every write is read back, so a flag the family will not take comes back as a refusal.
tool `td_render`	arguments path, width, height, save_to, settle_frames, overwrite	use it for A TOP's image, returned to you. `save_to` writes the PNG to a file and answers in text instead, and refuses a file already there unless `overwrite=True`; `settle_frames` waits that many TouchDesigner frames first, since a render right after an edit can show the frame from before it.
tool `td_timeline_run`	arguments path, frames, output, save, tiles, from_start, settle, render, hold	use it for Walk the timeline frame by frame and save a TOP's frames, as a job that returns its id at once — for anything with history (live audio, Feedback TOPs, trails), where a `td_exec` loop hits the 30 s limit. `frames="1..994"` is the walk, `save="92..217,459..541"` the frames written (default: all), `output="/renders/f{frame:04d}.png"` the template. It pauses the timeline and gives the play mode back, walks every frame consecutively (from the start of `frames` when `from_start`, else from the first frame to save), and waits `settle` application frames per step; 2 was measured repeatable for live audio. Without `output` it only advances — warm history up to frame N, then the timeline is held paused at N for `td_render`. `tiles=2` renders 2x2 quarters past the 1280 cap by cropping the Render TOP(s) in `render`: put `{tile}` in `output` (0 top left, 1 top right, 2 bottom left, 3 bottom right); each quarter is a whole walk of its own, since a Feedback TOP builds a quarter's history only under its crop. Nothing resets a Feedback TOP between passes, so a quarter's first frames carry the previous quarter's tail: a decaying trail forgets it within the walk, an accumulator does not — reset it yourself or start the walk early enough. The crop goes back to 0..1 however the job ends.
tool `td_record`	arguments path, file, seconds, frames, audio, start, codec, reset, reset_path, overwrite, hold, wait	use it for Record a TOP, with a CHOP's sound (`audio`), to a `.mov` in one call. It pulses `resetpulse` on everything under `reset_path` (default: the TOP's parent) — Trigger, Speed, Count, Lag, Feedback — pauses at `start` (default: the timeline's first frame), turns realTime off, builds a fresh Movie File Out with a keep-alive, starts it a step later, plays, and ends when the recorder goes idle at the length; realTime, play mode and the helper nodes go back. Waits up to `wait` seconds and answers with frames written of frames asked and the sound samples; a longer take stays a job for `td_timeline_status`. ProRes by default: H.264/H.265 is refused on Non-Commercial. A file already there needs `overwrite`.
tool `td_timeline_status`	arguments job	use it for Progress of that job: frame, pass, saved N of M (or a profile's table so far), errors, and `stalled` when no step has run for seconds. Without `job`, the latest.
tool `td_timeline_cancel`	arguments job	use it for Stop the walk now; the crop and play mode go back, written files stay.
tool `td_timeline_profile`	arguments path, frames, limit, settle	use it for Who spends the frame: walks `frames` (e.g. `"3000..3009"`) as a job in the same slot as `td_timeline_run`, and on every frame forces each TOP/CHOP/SOP/POP under `path` (up to `limit`) to cook, upstream first, timed with the GPU waited for — a `td_exec` loop of `cook(force=True)` reads ~0 ms for a TOP that costs 80, because the cook only queues GPU work. `td_timeline_status` shows mean and max ms per frame, costliest first; a row marked "did not cook on its own" is not part of the frame (the stale-`cookTime` trap), and one cooked inside an earlier measurement shares its cost with that operator. The play mode goes back at the end.
tool `td_errors`	arguments path	use it for Only what TouchDesigner itself flags: operators reporting an error or warning, with its message, at and under `path` — the project by default. For the failures it stays silent about (a branch that never cooks, an output switched off, stale feedback, negative floats), `td_health`. Do not ask for `/`: the walk is breadth-first and bounded, and TouchDesigner's own `/ui` and `/sys` are thousands of operators wide near the top, so the budget runs out before anything of yours is reached (measured: 5000 nodes from `/` covered 3,979 of `/ui` and 954 of `/sys`, and missed a warning planted inside the project). The reply names the subtree it walked and says when the walk stopped early; see When a reply is cut short below.
tool `td_trace`	arguments path, depth	use it for Why is this TOP black? Walks up every wired input from `path` (`depth` hops, at most 40 nodes), reads each image's min / mean / max over R, G, B and the alpha mean, and marks where the signal was lost: `dropped here` (the image goes black while an input still carried something, or an Add is fed a negative input and subtracts it), `negative values start here` (a float Level with no clamp and with contrast above 1, inlow above 0 or outlow below 0), `alpha goes to 0 here` (colour left under an alpha of 0) or `NaN/Inf start here`, with the reason when the node's settings show it — bypass, opacity 0, a black level (which cuts to 0, not below), an empty input, an error. `?` on a mark means an input could not be read. It forces no cook, but reading an image that is out of date makes TouchDesigner cook that node once — on a Feedback TOP, one step of the loop. A node that never cooked is not read; it, a non-TOP, or one past the time or download budget says so instead of reporting zeros. Wires only — an image a Select or Render TOP reaches through a parameter is not followed.
tool `td_exec`	arguments code	use it for Arbitrary Python inside TouchDesigner. Last resort. An edit `td_build` cannot express still belongs in one undo step: wrap it in `ui.undo.startBlock('name')` … `ui.undo.endBlock()`, which works from here, and the artist's Ctrl+Z takes it back whole.
tool `td_undo`	arguments redo	use it for Undo or redo, including whole `td_build` batches. Cannot be a step inside `td_build` — that is refused, because two of them in a row reach past the batch into the artist's own history.
tool `td_snapshot`	arguments label, path	use it for A COMP of the running instance, edits not yet saved included, written to a `.tox`; for a file on disk, restorable, `td_variant_save`. Keep every parameter of a branch before changing it: `path` is the branch's COMP. Snapshot again after the edits under another label (a reused label replaces the file), and `td_project_diff` of the two files lists each changed parameter, expression and custom parameter included. The reply names both next calls with the file path.
tool `td_claim_scope`	arguments path, owner, ttl_seconds	use it for Announce a subtree as yours before a run of edits, when another agent or session may be in the same project. Covers everything below `path`; lapses on its own. It guards against every unnamed caller including you, so carry the same `owner` into each write that follows.
tool `td_release_scope`	arguments path, owner	use it for Hand a claimed subtree back as soon as you are done. Until you do, the next agent waits out the claim.
tool `td_scopes`	arguments	use it for Which subtrees are claimed, by whom, until when. Check before editing a project someone else may be in.

Project files — on disk

Tool	Arguments	Use it for
tool `td_project_read`	arguments file, path, depth, params	use it for Operator tree of a .toe/.tox without TouchDesigner: names, types, wiring, the first line of each DAT. For every parameter, flag and whole DAT as JSON, `td_project_text`.
tool `td_project_text`	arguments file, path, max_bytes	use it for The whole network as JSON — every parameter, wire, flag and DAT line, in the form `td_project_write` takes back. Reach for it when `td_project_read`'s tree is not enough; narrow with `path`, since a big network is refused.
tool `td_project_write`	arguments file, text, output	use it for The return leg of `td_project_text`: write an edited dump into a new `.toe`/`.tox`, no instance running. `file` must still be the original — the dump covers five of the forty-odd kinds of file a `.toe` holds and the rest are copied from it — and `output` must not exist. Read the gaps in the reply: anything that could not be written is listed, not approximated.
tool `td_project_grep`	arguments file, pattern, limit	use it for Search the Python and GLSL inside DATs.
tool `td_project_diff`	arguments before, after, show_moves, include_text	use it for Semantic comparison of any two files by path, two `td_snapshot` files of one branch included; two saved variants by label, `td_variant_diff`. A parameter line shows its constant or its expression text with no mark saying which, so take values to put back from `td_project_text` of the before file, which keeps `{"expr": ...}`.
tool `td_variant_save`	arguments file, label, note, path	use it for Keep a `.toe`/`.tox` file on disk, as last saved, before trying a direction; for a branch of the running instance, edits not yet saved included, `td_snapshot`. A variant is the network text plus a byte copy of the file, under `~/.td-atlas/variants` — the text alone cannot rebuild a `.toe`, and the copy costs a median 19% on top of the text. A label already in use is refused, never overwritten.
tool `td_variant_list`	arguments file	use it for What has been saved — of one project, or of every project that has any. Says whether the original has changed since each save; that is information, not a warning, because a restore reads the variant's own copy.
tool `td_variant_restore`	arguments file, label, output	use it for Write a saved state back out. A copy, not a repack: `toecollapse` never runs, so nothing of the user's is moved aside to a `.bkp1` file. `output` must not exist; a directory keeps the saved file name.
tool `td_variant_diff`	arguments file, before, after, show_moves, include_text	use it for Compare two `td_variant_save` states of one file by label; any two files by path, `td_project_diff`, which runs the same semantic diff.

When a reply is cut short

Every call below is bounded in the work it may do. It runs on TouchDesigner's main thread during a cook, and a reply that reached a bound names the bound it reached.

td_network marks four separate cuts. childrenHidden is printed under the component whose listing was shortened, gives the number left out, and is printed even where nothing was listed at all. Over the whole reply, truncated with hidden says how many operators were dropped against the overall budget. limit and maxChildren say which two bounds applied. depthLimited carries the depth you asked for, when it was reduced to the deepest this tool walks. A component sitting at the depth you asked for is listed with the number of direct children it has that were not walked. That count is a floor, since what hangs below those children was never looked at. The repair is the same for all four cuts, and it is to ask again with a narrower path or a larger depth.

td_errors and td_health bound their walk by node count, and both take the subtree to walk as path. scanned is how many operators were actually looked at, the named subtree's own root included, so it never exceeds limit. notScanned is how many were not, truncated marks that it happened, and limit is the bound. notScanned is a floor, counting operators the walk had already found and not visited, and never what hangs below them. Read "nothing is wrong" as covering scanned operators at and under the subtree the reply names, and no others.

td_health also reports scriptErrorsUnread. It names the places where reading TouchDesigner's own script errors raised, and gives the reason. Read those places as unknown, and note that they arrive as a finding in the report.

Frame capture, used by the contact sheet below, has a byte budget as well as a frame count. A capture call answers captured: true while it is collecting. It answers full: true once the buffer is at its limit, and limit and maxFrames name the bounds. The sheet stops sampling on that flag.

When a tool refuses

Every refusal comes back with the state it observed and then three lines. A dead bridge, a path that does not exist, a parameter name the index rejects and an index that was never built all arrive in this shape:

shell

cause: no operator exists at that path in the running project
fix: list what is actually there before retrying — paths are case-sensitive ...
continue with: td_network, td_op_info

continue with: names tools and td-atlas subcommands that exist, and acting on that line beats repeating the call. Where the connector has no mapped recovery for the exception, it says fix: none known and names nothing. The message above it is then the whole answer, and something has to change before the retry.

Not exposed over MCP

A contact sheet needs repeated sampling over wall-clock time, which one tool call cannot do. It shows what the composition does while it plays; frames that must be the same on every run come from td_timeline_run, which walks timeline frames. Use the Python helper:

python

from td_atlas.bridge.client import BridgeClient
from td_atlas.bridge.filmstrip import contact_sheet
contact_sheet(BridgeClient.discover(), "/project1/out", "sheet.png",
              frames=12, interval=0.11, columns=4, width=280)

Setup

bash

td-atlas build     # offline index, 13-16 s
td-atlas install   # stage the bridge, print the bootstrap line
# paste that line into TouchDesigner's textport, once per project
td-atlas probe     # runtime facts: defaults, ranges, menus, type aliases

Инструмент	Аргументы	Для чего
инструмент `td_search_operators`	аргументы query, family, limit	для чего Находит оператор по тому, что он делает. Обычными словами. `family` сужает до TOP/CHOP/SOP/DAT/MAT/COMP/POP. Несколько названий алгоритмов, которых нет ни на одной странице операторов (marching cubes, isosurface, metaball, SDF, dilate/erode), ставят первыми операторы, которые это делают, со строкой `technique` о том, как.
инструмент `td_operator_schema`	аргументы op_type, page, include_hidden	для чего Точные имена параметров, значения по умолчанию, пункты меню, границы, счёт входов и выходов, путь к примеру из поставки. Пункты меню печатаются как `value — Label`, и подпись говорит больше значения: цена вроде "(GPU)" стоит там.
инструмент `td_search_parameters`	аргументы query, limit	для чего У какого оператора есть параметр, который делает X. Так находят `alwayscook`.
инструмент `td_python_api`	аргументы name, query	для чего Поля и методы класса, вместе с теми, что достались от родителей.
инструмент `td_docs`	аргументы query, page, limit	для чего 2,060 страниц вики: понятия, приёмы, уроки и операторы.
инструмент `td_glossary`	аргументы term, limit	для чего 185 статей глоссария: Cook, Time Slice, Clone, Perform Mode.
инструмент `td_palette`	аргументы query, category, limit	для чего 277 готовых компонентов, которые идут вместе с TouchDesigner.
инструмент `td_expression_help`	аргументы query, limit	для чего Синтаксис выражений и команд.
инструмент `td_example`	аргументы op_type, depth	для чего Рабочая сеть для оператора, из библиотеки примеров в поставке.

Инструмент	Аргументы	Для чего
инструмент `td_status`	аргументы	для чего Поднят ли мост, какой проект открыт и играет ли таймлайн: `timeline: frame 851 (playing) \| start 1 end 994 \| range 1–994 \| rate 60 \| abs 1284807`. Смотрите сюда, прежде чем верить живому CHOP между двумя своими вызовами. `abs` — `absTime.frame`, счётчик приложения, который не следует кадру таймлайна и на паузе корневого таймлайна стоит; ожидания считают по `tick` (`op.TDResources.time.frame`). `(!)` у диапазона значит, что проигрывание встанет раньше `end`.
инструмент `td_log`	аргументы limit, failures, summary, method	для чего Ваш след: каждый вызов моста с этой стороны, сколько он занял и чем отказал. Вызов, который менял проект, показан с тем, что он поменял: `tx = 0.5 (was 0.2)`, `ty = expr ...`, каждый шаг td_build, параметры и флаги с прежним значением, начало кода td_exec, — так что «верни как было» это `method="par_set"` (или `"batch"`, `"exec"`) и чтение, а не реконструкция. `td_status` истории вызовов не показывает совсем; этот след переживает сессию и отвечает на вопрос «что я вчера сломал». `failures=True` даёт одни отказы и починку для самого свежего; `summary=True` даёт, какие методы отказывают и какие медлят. Офлайновые инструменты мост не набирают и следа здесь не оставляют.
инструмент `td_instances`	аргументы	для чего Все запущенные TouchDesigner, которые зарегистрировали мост, и тот, до которого дотягиваются эти инструменты. Загляните сюда, прежде чем поверить, что правка легла в тот проект, который вы имели в виду.
инструмент `td_doctor`	аргументы	для чего Каждое звено: установка, индекс, проход пробы, мост, этот сервер, и команда, которая чинит каждое. Ловит индекс, собранный на другой сборке TouchDesigner, о чём иначе никто не скажет. Кеш чтения живёт только в CLI: `td-atlas doctor` в терминале ещё говорит, сколько распакованных проектов он держит, а `td-atlas doctor --clear-cache` его очищает. Этот инструмент ни того, ни другого не делает: стирать кеш пользователя вызов инструмента сам по себе не должен.
инструмент `td_health`	аргументы path, interval	для чего Ловит тихие поломки: то, чего TouchDesigner не отмечает. Операторы, которые он отмечает, здесь только названы; за сообщением при каждой ошибке и предупреждении идите в `td_errors`. Зовите после любой стройки. Кроме мёртвых веток, выключенных выходов, ошибок шейдеров и обратных вызовов и медленной готовки, отмечает время готовки, оставшееся с давнего кука (оно названо кадром, на котором измерено, и в падении частоты кадров его не винят); петли обратной связи, которые `cook(force=True)` не продвигает; выключенные через bypass операторы усиления (Level, Math, HSV Adjust), которые пропускают вход насквозь, а не гасят его; Level TOP, способные отдать в Add отрицательные float; и чтения `absTime` или генератора случайных чисел без seed, из-за которых рендер не повторяется. `interval` зажат сверху, поэтому долгое ожидание вернётся раньше, чем просили, и скажет об этом. В ответе ищите две причины неполноты: обрезанный обход и ошибки скриптов, которые прочитать не удалось; смотрите Когда ответ обрезан ниже.
инструмент `td_network`	аргументы path, depth	для чего Что внутри компонента и как он связан проводами. Сеть, которая в один ответ не влезла, приходит обрезанной, и каждая обрезка названа; смотрите Когда ответ обрезан ниже. TOP с выключенным флагом viewer помечен `[viewer off]`: его плитка пуста нарочно, а не сломана.
инструмент `td_op_info`	аргументы path	для чего Один оператор: тип, провода, живые значения параметров, ошибки.
инструмент `td_build`	аргументы operations, undo_name, owner	для чего Правки в несколько шагов одним блоком, целиком и с откатом. Сначала проверяет. Узел без `position` получает свободное место, а узел, которому провод задали прямо в его `op_create`, встаёт справа от источника, поэтому пачка читается слева направо. `op_create` берёт ключ `text` для содержимого DAT, поэтому исходник шейдера и скрипта обходится без отдельного `td_exec`. Ключ шага, который мост не прочитает (`input_index` вместо `index`), отвергается с верным именем, а не пропускается молча.
инструмент `td_set_params`	аргументы path, pars, op_type, owner	для чего Ставит параметры на уже существующий оператор. Имена и ссылки `../` на операторы сначала сверяются с индексом; без `op_type` тип оператора спрашивается у моста тем же вызовом, что разбирает ссылки. Без собранного индекса или для узла, чей тип мост назвать не может, запись уходит непроверенной.
инструмент `td_palette_load`	аргументы name, parent, rename, position, category, owner	для чего Ставит компонент палитры по имени, которое печатает `td_palette`. Сначала проверяет, что .tox лежит на диске, и сообщает имя, которое TouchDesigner дал узлу на самом деле.
инструмент `td_extension_add`	аргументы class_name, code, path, parent, name, extension_name, promote, index, position, owner	для чего Вешает класс Python на COMP расширением: DAT, три параметра Extensions и повторный запуск одним вызовом. Сначала разбирает код здесь, а результат читает обратно: класс, который не создаётся, оставляет COMP вообще без сообщений.
инструмент `td_annotate`	аргументы text, parent, title, name, path, size, color, position, font_size, mode, owner	для чего Оставляет в сети записку о том, что вы построили и зачем: цветная рамка рядом с узлами, о которых она говорит. Передайте `path`, чтобы переписать записку поверх старой.
инструмент `td_annotations`	аргументы path, depth	для чего Читает записки в сети, в том числе задание от человека, вместе с узлами, на которых лежит рамка каждой записки. Остальным инструментам отсюда эти записки не видны.
инструмент `td_flags`	аргументы path	для чего Флаги, от которых зависит, работает ли узел и что видно: `display`, `render`, `bypass`, `lock`, `expose`, `viewer`, `activeViewer`, `cloneImmune`, `allowCooking`, `selected`, `pickable`, и какие из них у этого оператора отсутствуют. Готовку включает `allowCooking`; флага с именем `cooking` нет. Загляните сюда, когда правильная на вид сеть ничего не даёт.
инструмент `td_set_flags`	аргументы path, flags, owner	для чего Включает и выключает эти флаги. Каждая запись читается обратно, поэтому флаг, которого семейство не принимает, приходит отказом.
инструмент `td_render`	аргументы path, width, height, save_to, settle_frames, overwrite	для чего Отдаёт вам картинку TOP. `save_to` пишет PNG в файл и отвечает текстом, а файл, который там уже лежит, заменяет только при `overwrite=True`; `settle_frames` сначала ждёт столько кадров TouchDesigner, потому что рендер сразу после правки может показать кадр до неё.
инструмент `td_timeline_run`	аргументы path, frames, output, save, tiles, from_start, settle, render, hold	для чего Пройти таймлайн кадр за кадром и сохранить кадры TOP заданием, которое сразу отдаёт свой номер, — для всего, что зависит от истории (живой звук, Feedback TOP, шлейфы), где цикл в `td_exec` упирается в предел 30 с. `frames="1..994"` — проход, `save="92..217,459..541"` — какие кадры писать (по умолчанию все), `output="/renders/f{frame:04d}.png"` — шаблон имени. Ставит таймлайн на паузу и возвращает режим проигрывания, проходит все кадры подряд (с начала `frames` при `from_start`, иначе с первого сохраняемого кадра) и ждёт `settle` кадров приложения на шаг; для живого звука повторяемым измерено 2. Без `output` только продвигает: прогреть историю до кадра N, после чего таймлайн держится на паузе на N для `td_render`. `tiles=2` рендерит четвертинки 2x2 сверх потолка 1280, обрезая Render TOP из `render`: поставьте `{tile}` в `output` (0 левый верх, 1 правый верх, 2 левый низ, 3 правый низ); каждая четвертинка — отдельный целый проход, потому что Feedback TOP копит историю четвертинки только под её обрезкой. Между проходами Feedback TOP никто не сбрасывает, поэтому первые кадры четвертинки несут хвост предыдущей: затухающий шлейф забывает его за проход, накопитель нет — сбросьте его сами или начните проход раньше. Обрезка возвращается к 0..1, чем бы задание ни кончилось.
инструмент `td_record`	аргументы path, file, seconds, frames, audio, start, codec, reset, reset_path, overwrite, hold, wait	для чего Записать TOP со звуком CHOP (`audio`) в `.mov` одним вызовом. Дёргает `resetpulse` у всего под `reset_path` (по умолчанию — родитель TOP): Trigger, Speed, Count, Lag, Feedback; ставит паузу на `start` (по умолчанию — первый кадр таймлайна), выключает realTime, строит свежий Movie File Out с держателем, включает запись шагом позже, проигрывает и кончает, когда запись встаёт на длине; realTime, режим проигрывания и служебные узлы возвращаются. Ждёт до `wait` секунд и отвечает, сколько кадров записано из заказанных и сколько сэмплов звука; длинный дубль остаётся заданием для `td_timeline_status`. По умолчанию ProRes: H.264/H.265 на Non-Commercial отвергается. Файл, который уже есть, требует `overwrite`.
инструмент `td_timeline_status`	аргументы job	для чего Ход этого задания: кадр, проход, сохранено N из M (или таблица профиля на сейчас), ошибки и `stalled`, когда шаг не шёл несколько секунд. Без `job` — последнее.
инструмент `td_timeline_cancel`	аргументы job	для чего Остановить проход сейчас; обрезка и режим проигрывания возвращаются, записанные файлы остаются.
инструмент `td_timeline_profile`	аргументы path, frames, limit, settle	для чего Кто тратит кадр: проходит `frames` (например, `"3000..3009"`) заданием в том же слоте, что `td_timeline_run`, и на каждом кадре заставляет кукать каждый TOP/CHOP/SOP/POP под `path` (не больше `limit`), сначала верхние по течению, и засекает время, дождавшись GPU. Цикл `cook(force=True)` в `td_exec` показывает ~0 мс у TOP, который стоит 80: кук только ставит работу в очередь GPU. `td_timeline_status` показывает среднее и максимум в мс за кадр, дорогие сверху; строка с пометкой «did not cook on its own» в кадр не входит (ловушка устаревшего `cookTime`), а узел, откуканный внутри чужого замера, делит стоимость с тем узлом. Режим проигрывания в конце возвращается.
инструмент `td_errors`	аргументы path	для чего Только то, что отмечает сам TouchDesigner: операторы с ошибкой или предупреждением и его сообщением, на `path` и ниже; без `path` берётся проект. О поломках, о которых он молчит (ветка, которая не готовится, выключенный выход, застывшая обратная связь, отрицательные float), скажет `td_health`. За `/` не ходите: обход идёт в ширину и ограничен числом узлов, а собственные `/ui` и `/sys` TouchDesigner у самого верха шириной в тысячи операторов, поэтому бюджет кончается раньше, чем обход доберётся до вашего (замер: 5000 узлов от `/` накрыли 3,979 в `/ui` и 954 в `/sys` и пропустили предупреждение, подложенное внутрь проекта). Ответ называет поддерево, которое обошли, и говорит, если обход кончился раньше времени; смотрите Когда ответ обрезан ниже.
инструмент `td_trace`	аргументы path, depth	для чего Почему этот TOP чёрный? Идёт вверх по всем проводным входам от `path` (`depth` шагов, не больше 40 узлов), снимает у каждой картинки мин / среднее / макс по R, G, B и среднее альфы и отмечает, где пропал сигнал: `dropped here` (картинка чернеет, хотя вход ещё что-то нёс, или в Add приходит отрицательный вход и вычитается), `negative values start here` (Level во float без клампа и с contrast больше 1, inlow больше 0 или outlow меньше 0), `alpha goes to 0 here` (цвет под альфой 0) или `NaN/Inf start here` — с причиной, если её видно из настроек узла: bypass, opacity 0, black level (он срезает до 0, а не ниже), пустой вход, ошибка. `?` у пометки значит, что вход прочитать не удалось. Готовку не форсирует, но чтение устаревшей картинки заставляет TouchDesigner приготовить этот узел один раз — у Feedback TOP это шаг петли. Узел, который ни разу не готовился, не читается; он, не-TOP или узел за бюджетом времени либо скачивания так и называется, а не показывает нули. Только провода: картинка, которую Select или Render TOP берёт через параметр, не прослеживается.
инструмент `td_exec`	аргументы code	для чего Произвольный Python внутри TouchDesigner. Последнее средство. Правка, которую `td_build` выразить не может, всё равно должна лечь одним шагом отмены: оберните её в `ui.undo.startBlock('name')` … `ui.undo.endBlock()`, это работает отсюда, и Ctrl+Z художника снимет её целиком.
инструмент `td_undo`	аргументы redo	для чего Откат и возврат, включая целые пачки `td_build`. Шагом внутри `td_build` быть не может: такой шаг отклоняется, потому что два подряд уходят за границу пачки в собственную историю художника.
инструмент `td_snapshot`	аргументы label, path	для чего COMP запущенного экземпляра, вместе с несохранёнными правками, записанный в `.tox`; для файла на диске, который можно восстановить, есть `td_variant_save`. Сохраняет компонент, чтобы позже сравнить.
инструмент `td_claim_scope`	аргументы path, owner, ttl_seconds	для чего Объявляет поддерево вашим перед серией правок, когда в том же проекте может сидеть другой агент или другая сессия. Накрывает всё ниже `path`; заявка истекает сама. Она закрывает поддерево от любого безымянного вызова, включая ваш, поэтому носите тот же `owner` в каждую следующую запись.
инструмент `td_release_scope`	аргументы path, owner	для чего Возвращает занятое поддерево, как только вы закончили. Пока этого нет, следующий агент ждёт, когда заявка истечёт.
инструмент `td_scopes`	аргументы	для чего Какие поддеревья заняты, кем и до какого срока. Загляните сюда, прежде чем править проект, в котором может сидеть кто-то ещё.

Инструмент	Аргументы	Для чего
инструмент `td_project_read`	аргументы file, path, depth, params	для чего Дерево операторов .toe/.tox без TouchDesigner: имена, типы, провода, первая строка каждого DAT. Каждый параметр, флаг и весь DAT в JSON даёт `td_project_text`.
инструмент `td_project_text`	аргументы file, path, max_bytes	для чего Вся сеть в JSON: каждый параметр, провод, флаг и строка DAT, в том виде, который принимает обратно `td_project_write`. Берите, когда дерева из `td_project_read` мало; сужайте `path`, потому что большую сеть инструмент отклоняет.
инструмент `td_project_write`	аргументы file, text, output	для чего Обратный ход `td_project_text`: пишет правленый дамп в новый `.toe`/`.tox`, без запущенной программы. В `file` по-прежнему подаётся оригинал, потому что дамп покрывает пять из четырёх с лишним десятков видов файлов внутри `.toe`, а остальное копируется оттуда; `output` существовать не должен. Читайте в ответе список пропусков: всё, что записать не вышло, там перечислено.
инструмент `td_project_grep`	аргументы file, pattern, limit	для чего Ищет по Python и GLSL внутри DAT.
инструмент `td_project_diff`	аргументы before, after, show_moves, include_text	для чего Сравнивает по смыслу любые два файла по пути, в том числе два файла `td_snapshot` одной ветки; два сохранённых варианта по метке сравнивает `td_variant_diff`.
инструмент `td_variant_save`	аргументы file, label, note, path	для чего Откладывает файл `.toe`/`.tox` с диска, каким он был сохранён, перед тем, как пробовать направление; для ветки запущенного экземпляра вместе с несохранёнными правками есть `td_snapshot`. Вариант хранит текст сети и побайтную копию файла в `~/.td-atlas/variants`: по одному тексту `.toe` не собрать. Копия стоит сверх текста медианных 19%. Метку, которая уже занята, инструмент отклоняет и ничего не переписывает.
инструмент `td_variant_list`	аргументы file	для чего Что сохранено: по одному проекту или по всем, у кого есть хоть что-то. Говорит, менялся ли оригинал после каждого сохранения. Читайте это как справку: восстановление берёт собственную копию варианта.
инструмент `td_variant_restore`	аргументы file, label, output	для чего Выписывает сохранённое состояние обратно. Пишет копию: `toecollapse` не запускается, поэтому ничего пользовательского не сдвигается в файл `.bkp1`. `output` существовать не должен; для каталога берётся имя сохранённого файла.
инструмент `td_variant_diff`	аргументы file, before, after, show_moves, include_text	для чего Сравнивает два состояния одного файла из `td_variant_save` по метке; любые два файла по пути сравнивает `td_project_diff`, тем же смысловым разбором.

Tool reference

Index — offline, no running TouchDesigner

Live — acting on a running instance

Project files — on disk

When a reply is cut short

When a tool refuses

Not exposed over MCP

Setup

Справочник инструментов

Индекс: офлайн, без запущенного TouchDesigner

Живые: действие в запущенной программе

Файлы проекта: на диске

Когда ответ обрезан

Когда инструмент отказывает

Что не выведено в MCP

Установка

Tool reference

#Index — offline, no running TouchDesigner

#Live — acting on a running instance

#Project files — on disk

#When a reply is cut short

#When a tool refuses

#Not exposed over MCP

#Setup

Справочник инструментов

#Индекс: офлайн, без запущенного TouchDesigner

#Живые: действие в запущенной программе

#Файлы проекта: на диске

#Когда ответ обрезан

#Когда инструмент отказывает

#Что не выведено в MCP

#Установка

Index — offline, no running TouchDesigner

Live — acting on a running instance

Project files — on disk

When a reply is cut short

When a tool refuses

Not exposed over MCP

Setup

Индекс: офлайн, без запущенного TouchDesigner

Живые: действие в запущенной программе

Файлы проекта: на диске

Когда ответ обрезан

Когда инструмент отказывает

Что не выведено в MCP

Установка