npm - @hybridlabor-api/aos - Versions diffs - 4.3.0 → 4.4.1 - Mend

@hybridlabor-api/aos 4.3.0 → 4.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1052) hide show

package/mcps/tdmcp/docs/pt/guide/body-tracking.md DELETED Viewed

@@ -1,175 +0,0 @@
----
-description: "Rastreamento de corpo e pose no TouchDesigner com o tdmcp — esqueletos e visuais reativos ao corpo a partir de uma webcam via MediaPipe, com um modo sintético que dispensa câmera."
----
-# Rastreamento de corpo e pose
-Rastreie uma pessoa só com uma webcam e transforme o movimento dela em visual —
-um esqueleto brilhante, pontos que seguem mãos e pés, rastros que arrastam atrás
-do corpo. O tdmcp monta tudo isso a partir de linguagem natural, do mesmo jeito
-que monta qualquer outra coisa.
-Sem Kinect, sem câmera de profundidade, sem hardware só-Windows: o rastreamento
-vem do [MediaPipe](https://github.com/torinmb/mediapipe-touchdesigner), o modelo
-de pose gratuito do Google, que roda no macOS e no Windows com uma webcam comum.
-::: tip Dá para testar antes de instalar qualquer coisa
-Toda ferramenta de rastreamento usa por padrão uma fonte **sintética** — uma
-figura animada autossuficiente — então a rede monta e dá preview na hora, sem
-câmera e sem plugin. Use para ajustar o visual e depois troque a fonte pela sua
-webcam.
-:::
-## 1. Teste agora (sem câmera, sem plugin)
-No seu assistente de IA:
-> *"Monte um esqueleto de pose e me mostre um preview."*
-Você recebe uma figura de palito — 33 pontos (cabeça, ombros, cotovelos, pulsos,
-quadris, joelhos, tornozelos) ligados por linhas brilhantes — se mexendo sozinha.
-Depois itere:
-- *"Deixe as linhas magenta e mais grossas."*
-- *"Agora me dê pontos brilhantes reativos ao corpo."*
-- *"Adicione rastros de movimento."*
-## 2. Instale o plugin do MediaPipe (para um performer de verdade)
-Para rastrear uma pessoa real você precisa do plugin gratuito do MediaPipe
-(acelerado por GPU, roda no Mac e no PC). O tdmcp baixa pra você — num terminal:
-```bash
-npx --yes --package=@dpantani/tdmcp tdmcp install mediapipe-touchdesigner
-```
-O `tdmcp install <lib>` prepara bibliotecas da comunidade a partir de manifestos seguros; aqui
-ele pega o pacote MIT
-[torinmb/mediapipe-touchdesigner](https://github.com/torinmb/mediapipe-touchdesigner)
-e extrai em `~/.tdmcp/packages`.
-Depois, com o TouchDesigner aberto, peça ao assistente:
-> *"configure o rastreamento de corpo"*
-A tool **setup_body_tracking** carrega o plugin no seu projeto, acha o CHOP de
-landmarks de pose e já fia o `create_pose_tracking` mais um esqueleto ao vivo — você
-só escolhe sua webcam no novo componente `mediapipe_pose` e liga **Pose**.
-Prefere na mão? Abra o `MediaPipe TouchDesigner.toe` (ou arraste um `.tox` de
-do pacote preparado em `~/.tdmcp/packages`) para o seu projeto, ligue
-**Pose**, e aponte o `mediapipe_chop_path` de uma tool para o CHOP de landmarks do
-plugin (33 samples, canais `tx`/`ty`/`tz`).
-::: warning Permissão de câmera no macOS
-Na primeira vez que o TouchDesigner lê a webcam, o macOS abre um diálogo de
-permissão. **Clique em Permitir** — até você clicar, o TouchDesigner pode parecer
-travado. Veja a [Solução de problemas](/pt/guide/troubleshooting).
-:::
-## 3. Aponte os visuais para o seu corpo
-Peça ao assistente para usar o plugin como fonte:
-> *"Monte um esqueleto de pose a partir do plugin do MediaPipe em
-> `/project1/mediapipe1/select_pose` e mostre um preview."*
-> *"Crie rastros reativos ao corpo a partir da minha pose na webcam."*
-O assistente define o `source` da ferramenta como `mediapipe` e aponta o
-`mediapipe_chop_path` para o CHOP de pose do plugin. Todo o resto — esqueleto,
-pontos, rastros — funciona igualzinho ao modo sintético.
-## 4. O que dá para construir
-Três ferramentas cobrem o fluxo; a IA escolhe por você, mas ajuda conhecer o
-vocabulário:
-| Ferramenta | O que faz |
-| --- | --- |
-| **create_pose_tracking** | A base. Um sinal de pose limpo (33 pontos) mais canais escalares prontos para ligar, como `r_wrist_y`, `hand_span`, `height`. Suavização e espelho embutidos. |
-| **create_pose_skeleton** | O esqueleto de palito clássico renderizado num TOP — linhas brilhantes ligando os pontos. |
-| **create_body_reactive** | Marcas brilhantes que seguem o corpo, em três estilos: **points** (pontos nítidos), **glow** (pontos com bloom), **trails** (rastros de movimento). |
-Dá para encadear: monte o `create_pose_tracking` uma vez e aponte tanto o
-esqueleto quanto o visual reativo para a saída dele, compartilhando um só corpo
-rastreado.
-## 5. Ligue seu corpo a qualquer coisa
-O `create_pose_tracking` também expõe um CHOP de **keypoints** com canais
-escalares simples, então você pode controlar *qualquer* parâmetro com uma parte do
-corpo:
-- *"Faça a quantidade de blur seguir a altura da minha mão direita."*
-- *"Mapeie o quão abertos estão meus braços para a quantidade de feedback."*
-- *"Quando eu agachar, diminua as luzes."* (o canal `height` encolhe)
-Ligue um parâmetro a `op('…/pose_tracking/keypoints')['r_wrist_y']` (ou
-`hand_span`, `hips_x`, `height`, …) e ele acompanha seu movimento ao vivo.
-## 6. Coloque um holograma na sua mão
-As mãos não servem só como dados de controle. `create_hand_hologram` monta um
-sistema visual completo em que a palma aberta revela um cubo translúcido
-flutuando logo acima da mão. O visual começa com uma fonte sintética de duas
-mãos, então dá para pré-visualizar o look antes de usar a webcam:
-> *"Monte um cubo holográfico futurista flutuando acima da minha palma aberta.
-> Comece com preview sintético, deixe transparente em ciano com acento violeta e
-> faça uma pinça da outra mão aumentar o cubo."*
-Por baixo, `create_hand_hologram` cria um `create_hand_gesture_bus` aninhado. Esse
-bus publica canais estáveis como `float_x`, `float_y`, `palm_size`,
-`pinch_power`, `light_gain` e `audio_level`. O shader do holograma lê esses
-canais em vez dos landmarks crus do MediaPipe, então o mesmo bus pode depois
-guiar lasers, partículas, cues de projeção ou controles de áudio.
-Quando estiver pronto para usar a mão real, troque a fonte:
-> *"Recrie o holograma de mão com MediaPipe hands da minha webcam, mantenha ele
-> mais alto acima da palma e mande o áudio futurista para meu device de áudio."*
-`audio_mode` começa em `none`; use `synth` para um sinal interno ou `device_out`
-quando quiser explicitamente um Audio Device Out CHOP.
-## 7. Use as mãos como controles de filtro no Ableton
-As mãos também podem virar um controlador de Ableton em quatro canais quando você
-usa TDAbleton. A ferramenta `create_hand_ableton_mapper` monta o lado
-TouchDesigner: mãos do MediaPipe na entrada, overlay de esqueleto com estrelinhas
-nas juntas e um CHOP `mapper_send` para o TDAbleton. AbletonMCP não é necessário
-para esta receita.
-Mapeamento padrão:
-| Slot do mapper | Gesto |
-| --- | --- |
-| `map1` | Distância polegar/indicador da mão esquerda |
-| `map2` | Distância polegar/indicador da mão direita |
-| `map3` | Rotação do punho esquerdo |
-| `map4` | Rotação do punho direito |
-No `TDA_Mapper` do TDAbleton, aponte o CHOP de entrada para
-`/project1/hand_ableton_mapper/mapper_send`, defina `Reorder` como
-`map1 map2 map3 map4`, deixe `Bypass1..4` desligado e mapeie os quatro slots
-manualmente para frequência do Auto Filter, resonance, drive ou macros de rack
-dentro do Ableton.
-Se os valores se mexem no TouchDesigner mas o Ableton não muda, rode
-`diagnose_tdableton_mapper`. Ele confere o caminho real do mapper, CHOP de
-entrada, `Reorder`, bypasses, ranges `Min/Max` e canais `map1..map4` ausentes.
-Isso pega o problema comum de alvo antigo, quando o mapper parece saudável mas
-aponta para a track ou device errado.
-## Receitas prontas
-Dois modelos navegáveis vêm na galeria de receitas — peça *"liste as receitas"* ou
-veja a [Galeria de receitas](/pt/guide/recipes):
-- **Pose Skeleton (MediaPipe)** — o esqueleto de palito a partir de uma webcam ao
-  vivo.
-- **MediaPipe Body Dots** — pontos brilhantes rastreando cada articulação.
-Os dois esperam o plugin do MediaPipe; aponte o Select CHOP `posein` deles para o
-CHOP de landmarks de pose.

package/mcps/tdmcp/docs/pt/guide/codex.md DELETED Viewed

@@ -1,113 +0,0 @@
----
-title: Codex + TouchDesigner
-description: "Conecte o OpenAI Codex CLI ao TouchDesigner com o tdmcp — o servidor MCP para TouchDesigner. Monte redes de nós de verdade a partir de prompts em linguagem natural no Codex, com um ciclo criar → verificar → visualizar."
----
-# Codex + TouchDesigner
-O **tdmcp** conecta o **Codex CLI** ao TouchDesigner pelo
-[Model Context Protocol](https://modelcontextprotocol.io). Depois de conectado,
-você descreve um visual em linguagem natural dentro do Codex e ele monta a rede de
-operadores de verdade no seu projeto — depois confere se há erros e te mostra um
-preview.
-Se você também usa Claude ou Cursor, a ideia é a mesma; esta página é o caminho
-específico do Codex. Para o quadro completo, veja [Instalação](/pt/guide/install).
-## O que você precisa
-- **[TouchDesigner](https://derivative.ca/download)** — a edição gratuita
-  (não comercial) serve.
-- **[Node.js 20+](https://nodejs.org)** — o Codex roda o servidor tdmcp como um
-  processo `node` local via stdio.
-- O **Codex CLI** instalado e funcionando (`codex --version`).
-## Conecte o tdmcp ao Codex
-Você pode registrar o tdmcp a partir do pacote npm publicado (sem clonar) ou de um
-build local. De qualquer forma, o Codex o inicia como um servidor MCP via stdio.
-::: tip Deixe o Codex fazer por você
-Cole isto no Codex e ele instala e conecta tudo sozinho, parando só na única linha
-do TouchDesigner:
-```text
-Install and connect tdmcp for me using the official install guide:
-https://pantani.github.io/tdmcp/pt/guide/install
-Do every step yourself; only stop when you need me to do the TouchDesigner bridge step.
-```
-:::
-### Opção A — pelo npm (sem clonar)
-Adicione o tdmcp ao `~/.codex/config.toml` (juntando a qualquer `[mcp_servers.*]`
-existente):
-```toml
-[mcp_servers.tdmcp]
-command = "npx"
-args = ["--yes", "--package=@dpantani/tdmcp", "tdmcp"]
-```
-### Opção B — a partir de um build local
-Clone e compile, depois aponte o Codex para `dist/index.js`:
-```bash
-git clone https://github.com/Pantani/tdmcp.git
-cd tdmcp
-npm run setup   # instala, compila e imprime a linha exata para conectar
-```
-Depois rode `codex mcp add tdmcp -- node <project-path>/dist/index.js`
-(`<project-path>` é a pasta clonada — rode `pwd` nela), ou adicione ao
-`~/.codex/config.toml` na mão:
-```toml
-[mcp_servers.tdmcp]
-command = "node"
-args = ["<project-path>/dist/index.js"]
-```
-**Reinicie sua sessão do Codex** depois, para ele carregar o novo servidor.
-## Ligue a ponte no TouchDesigner
-O tdmcp precisa de uma pequena ponte rodando *dentro* do TouchDesigner. O jeito
-mais fácil é arrastar o `.tox` do release — sem Textport
-([veja Instalação](/pt/guide/install#drag-in-tox)). Prefere uma linha? Abra o
-**Textport** (**Dialogs → Textport and DATs**), cole esta única linha e aperte
-Enter:
-```python
-import urllib.request; exec(urllib.request.urlopen("https://github.com/Pantani/tdmcp/raw/v0.12.0/td/bootstrap.py").read().decode())
-```
-Você deve ver `[tdmcp] bridge running on port 9980`. Este é o único passo que tem
-que acontecer dentro do TouchDesigner — veja
-[Instalação](/pt/guide/install#turn-on-the-bridge) para os detalhes e como remover
-depois.
-## Crie algo
-Com o TouchDesigner aberto e a ponte ligada, peça ao Codex em linguagem natural:
-> *"Crie uma galáxia de partículas reativa ao áudio e me mostre um preview."*
-Ele monta a rede, confere se há erros e devolve uma miniatura. Continue em
-linguagem natural — *"deixa mais quente", "adiciona um rastro de feedback", "manda
-em tela cheia".* Mais ideias nas [receitas de prompt](/pt/guide/prompt-cookbook), e
-[Seu primeiro visual](/pt/guide/first-visual) percorre um do começo ao fim.
-## Não conecta?
-- Confirme que a ponte está ligada: `curl http://127.0.0.1:9980/api/info` deve
-  devolver JSON.
-- **Reinicie a sessão do Codex** depois de editar o `~/.codex/config.toml` — os
-  servidores MCP são carregados no início.
-- A [Solução de problemas](/pt/guide/troubleshooting) completa cobre os casos
-  comuns.
-Para host/porta, variáveis de ambiente e o CLI do copiloto local, veja a
-[referência do CLI](/reference/cli) (em inglês) e as
-[variáveis de ambiente](/pt/reference/environment).

package/mcps/tdmcp/docs/pt/guide/components.md DELETED Viewed

@@ -1,129 +0,0 @@
----
-description: "Transforme uma rede do TouchDesigner feita com o tdmcp num componente .tox reutilizável, parametrizável e scriptável — adicione knobs como parâmetros customizados, crie uma classe de extensão em Python e salve como um .tox que você solta em qualquer projeto."
----
-# Componentes reutilizáveis
-Uma rede que você montou com o tdmcp é ótima para um show — mas para reutilizá-la
-entre projetos você quer três coisas: **knobs** para ajustar, **comportamento**
-que você chama pelo nome, e um único arquivo **`.tox`** que você solta em qualquer
-lugar. Três tools cobrem a história toda:
-| Passo | Tool | O que faz |
-|-------|------|-----------|
-| Montar | (qualquer gerador) | Cria a rede — ex.: um túnel de feedback. |
-| Knobs | `add_custom_parameters` | Adiciona uma página de parâmetros customizados (sliders, toggles, menus, pulses, RGB/XYZ). |
-| Comportamento | `scaffold_extension` | Dá ao COMP uma classe de extensão em Python com métodos que você pode chamar. |
-| Empacotar | `manage_component` | Salva o COMP como um `.tox` reutilizável (ou carrega um de volta, com link ao vivo). |
-Você pode conduzir cada passo em linguagem natural. Aqui está o arco completo.
-## 1. Monte a rede
-> *"Crie um túnel de feedback a partir de ruído com blur e displace, embrulhe num
-> container e me mostre um preview."*
-Digamos que o container ficou em `/project1/tunnel`. Tudo abaixo ajusta **esse
-COMP** para que ele vire um widget autônomo e reutilizável.
-## 2. Adicione knobs (`add_custom_parameters`)
-> *"Em `/project1/tunnel`, adicione uma página 'Controls' com um knob Feedback
-> (0–1, padrão 0.9), um knob Zoom (0.5–2), um knob Spin (−180 a 180) e um pulse
-> Reset."*
-Isso adiciona uma página de parâmetros customizados para que o componente exponha
-uma superfície de controle limpa, em vez de obrigar o próximo a fuçar nos nós
-internos. Um parâmetro que já existe é **pulado com um aviso**, nunca
-sobrescrito, então rodar de novo para acrescentar mais um knob é seguro.
-::: tip Conecte os knobs ao trabalho
-Os knobs são só entradas até você apontá-los para algo. Peça para
-*"conectar o knob Feedback ao brightness do level de feedback"* (isso é o
-[`create_control_panel`](/reference/tools) / `create_macro` por baixo), ou leia
-eles a partir da classe de extensão que você vai adicionar a seguir.
-:::
-## 3. Adicione comportamento (`scaffold_extension`)
-Knobs guardam valores; uma **classe de extensão** dá ao componente métodos de
-verdade:
-> *"Crie uma classe de extensão `TunnelExt` em `/project1/tunnel` com os métodos
-> `Reset` e `Randomize`, e promova ela."*
-Isso cria um Text DAT dentro do COMP contendo:
-```python
-class TunnelExt:
-    def __init__(self, ownerComp):
-        self.ownerComp = ownerComp
-    def Reset(self):
-        pass
-    def Randomize(self):
-        pass
-```
-…conecta no slot de extensão do COMP e **promove**, então os métodos ficam
-chamáveis direto no componente — `op('/project1/tunnel').Reset()`. Preencha os
-stubs (peça à IA, ou edite o DAT) e o componente passa a *fazer* coisas, não só
-*guardar* valores.
-::: tip Promovido = chamável pelo nome
-Membros promovidos (capitalizados, como `Reset`) ficam acessíveis direto no COMP.
-Os nomes dos parâmetros de extensão ficam na página **Extensions** embutida do
-COMP; o tdmcp sonda eles para continuar funcionando entre builds do TouchDesigner.
-:::
-## 4. Salve como um `.tox` (`manage_component`)
-> *"Salve `/project1/tunnel` como `/Users/me/td-components/tunnel.tox`."*
-Agora você tem um único arquivo que carrega a rede, os knobs e a classe de
-extensão. Solte em qualquer projeto:
-> *"Carregue `/Users/me/td-components/tunnel.tox` em `/project1` como uma instância com
-> link ao vivo."*
-Uma instância com link ao vivo (`externaltox`) relê o arquivo sempre que ele muda,
-então corrigir o componente uma vez atualiza todo show que o usa.
-## A mesma coisa pelo terminal
-Cada passo tem um comando `tdmcp-agent`, então você pode empacotar um componente
-num script:
-```bash
-# 2. knobs
-tdmcp-agent add-params --params '{
-  "comp_path": "/project1/tunnel",
-  "page": "Controls",
-  "params": [
-    { "name": "Feedback", "type": "Float", "default": 0.9, "min": 0, "max": 1 },
-    { "name": "Reset", "type": "Pulse" }
-  ]
-}'
-# 3. comportamento
-tdmcp-agent scaffold-ext --params '{
-  "comp_path": "/project1/tunnel",
-  "class_name": "TunnelExt",
-  "methods": ["Reset", "Randomize"]
-}'
-# 4. empacotar
-tdmcp-agent component --params '{
-  "action": "save",
-  "comp_path": "/project1/tunnel",
-  "file_path": "/Users/me/td-components/tunnel.tox"
-}'
-```
-## Para onde ir agora
-- [Receitas de prompt](/pt/guide/prompt-cookbook) — prompts prontos para montar a
-  rede que você vai transformar em componente.
-- [Tools reference (em inglês)](/reference/tools) — o schema de entrada completo de
-  `add_custom_parameters`, `scaffold_extension` e `manage_component`.

package/mcps/tdmcp/docs/pt/guide/dashboard-foh.md DELETED Viewed

@@ -1,95 +0,0 @@
----
-description: "Construa uma superfície de controle de front-of-house para o seu show no TouchDesigner com o tdmcp — um cockpit web, um painel de touchscreen, um controle pelo celular e scopes de vídeo/áudio ao vivo."
----
-# Dashboard de front-of-house
-Uma vez que o show está construído, você precisa *rodá-lo* — da cabine, de um
-celular na plateia, de um touchscreen na boca do palco. Esta trilha é a camada de
-front-of-house (FOH): superfícies de controle e monitores que ficam sobre a rede e
-dão ao operador botões de cue, faders, um botão de pânico e uma visão do que o sinal
-realmente está fazendo.
-Use estas ferramentas quando o build estiver pronto e você estiver pensando na
-performance: quem toca o quê, em qual tela, com quantos segundos de aviso.
-## O cockpit web: `create_stage_dashboard`
-`create_stage_dashboard` (Layer 2) é a ferramenta principal de FOH — um cockpit
-unificado baseado em web servido por um Web Server DAT dentro do TouchDesigner e
-acessível de qualquer navegador ou celular na rede. Ele dá botões de disparo de
-cue, faders master, um VU meter, um indicador de beat e um controle de segurança
-PANIC (Blackout / Freeze).
-Tem dois layouts, escolhidos com `layout`:
-- **`v1`** — o cockpit original.
-- **`v2`** (a passada "dashboard-v2") — adiciona um VU estéreo, um display de BPM,
-  uma faixa de timeline de cues (dirigida por `cue_times` e um `tempo_channel`), um
-  overlay de FPS/tempo de cook e uma barra PANIC fixa de confirmação por toque, para
-  você não apagar a sala por engano.
-> *"Construa um stage dashboard v2 para `/project1/mainstage` com meus quatro cues
-> de cena, um fader master e o display de BPM, na porta 9982."*
-Como roda inteiro dentro do TD, não há app separado para instalar — abra a URL que
-ele imprime e você está dirigindo o show.
-## Superfícies compactas
-Quando você não quer um navegador:
-- **`create_control_surface`** (Layer 2) constrói um Container COMP jogável de
-  faders verticais e botões de cue, feito para abrir em modo Perform/Panel num
-  touchscreen ou segundo monitor. Os faders dirigem parâmetros ao vivo; os botões
-  recuperam ou morpham para cues nomeados (de `manage_cue`) com crossfade opcional.
-- **`create_phone_remote`** (Layer 2) serve um controle web mobile de página única
-  que descobre automaticamente os parâmetros customizados numéricos de um COMP e os
-  renderiza como sliders de faixa — o jeito mais rápido de colocar alguns knobs ao
-  vivo no seu bolso.
-- **`create_control_panel`** (Layer 2) é o bloco genérico: uma página de parâmetros
-  customizados (sliders, toggles, menus, swatches RGB, botões de pulso) ligada por
-  expressão para dirigir parâmetros de nós. Muitas ferramentas Layer 1 a chamam
-  internamente para expor os próprios controles.
-> *"Coloque uma control surface de touchscreen na minha mix master: quatro botões de
-> cue de cena e faders para blur, feedback e brilho master."*
-## Veja o sinal: scopes & meters
-FOH também é *ver* o que está saindo:
-- **`create_video_scopes`** (Layer 1) constrói um monitor estilo broadcast com até
-  quatro painéis — waveform (luma), RGB parade, vectorscope e histograma —
-  compostos num único TOP. A fonte padrão é um test pattern sintético, então
-  constrói sem permissão de câmera; opte por `device` para a câmera ao vivo.
-- **`create_waveform`** (Layer 1) é o osciloscópio de áudio no domínio do tempo — o
-  sinal cru rolando da esquerda para a direita — e alimenta as leituras de áudio do
-  dashboard.
-> *"Adicione um monitor de video scope 2×2 na saída master para eu checar os níveis
-> antes da abertura das portas."*
-## Segurança mora aqui também
-O controle PANIC do dashboard e o
-[`create_safety_blackout_chain`](/pt/guide/show-timelines#seguranca-ao-vivo) do show
-são duas pontas da mesma ideia: um botão de pânico que o operador sempre alcança.
-Conecte o blackout na saída master, exponha o toggle dele no dashboard, e a cabine
-tem um jeito garantido de cortar para o preto.
-## Como tudo se encaixa
-Construa o show ([Timelines & setlists de show](/pt/guide/show-timelines)) e então
-coloque uma superfície nele: `create_stage_dashboard` para o cockpit web em rede,
-`create_control_surface` para um touchscreen com fio, `create_phone_remote` para um
-bolso de sliders. Adicione `create_video_scopes` / `create_waveform` para monitorar
-o sinal, e mantenha o caminho de pânico a um toque de distância.
-## Veja também
-- [Performance ao vivo & controle](/pt/guide/prompt-cookbook#performance-ao-vivo-controle)
-  e [Saída & mapeamento](/pt/guide/prompt-cookbook#saida-mapeamento) no cookbook de
-  prompts.
-- [Timelines & setlists de show](/pt/guide/show-timelines) para os cues e o
-  transporte que o dashboard dirige.

package/mcps/tdmcp/docs/pt/guide/faq.md DELETED Viewed

@@ -1,62 +0,0 @@
----
-title: FAQ — servidor MCP para TouchDesigner
-titleTemplate: false
-description: "FAQ do tdmcp, o servidor MCP para TouchDesigner: existe um MCP para TouchDesigner, o Claude ou o Cursor conseguem controlá-lo, é gratuito, quais clientes funcionam e como funciona."
----
-# Perguntas frequentes
-## Existe um servidor MCP para o TouchDesigner?
-Sim — o **tdmcp** é um servidor open-source (MIT) de Model Context Protocol para o
-[TouchDesigner](https://derivative.ca). Ele conecta assistentes de IA como Claude,
-Cursor e Codex ao TouchDesigner, que então montam redes de nós de verdade a partir
-de comandos em linguagem natural.
-## O Claude ou o Cursor conseguem controlar o TouchDesigner?
-Sim. Com o tdmcp conectado, você descreve um visual em linguagem natural e o
-assistente cria, conecta, inspeciona e dá preview dos operadores de verdade dentro
-do seu projeto do TouchDesigner.
-## Preciso saber programar, ou quais operadores usar?
-Não. Você descreve o resultado que quer; o tdmcp carrega uma referência embutida
-dos operadores reais do TouchDesigner, então a IA escolhe e conecta eles por você.
-Veja [O que é o tdmcp?](/pt/guide/what-is-tdmcp).
-## O tdmcp é gratuito?
-Sim — é gratuito e open-source sob a licença MIT, e funciona com a edição
-não-comercial gratuita do TouchDesigner.
-## Quais assistentes de IA funcionam com o tdmcp?
-Claude Desktop (o mais fácil, [instalação em um clique](/pt/guide/install)), Claude
-Code, Codex e Cursor — qualquer cliente compatível com MCP.
-## Funciona offline, sem API paga?
-Ele inclui um [copiloto LLM local](/reference/cli) (`tdmcp chat`) que resolve
-tarefas simples com um modelo local, e o servidor continua usável mesmo com o
-TouchDesigner fechado.
-## O tdmcp roda no macOS e no Windows?
-Sim, nos dois — onde quer que o TouchDesigner e o Node.js 20+ rodem.
-## É seguro rodar?
-A ponte roda dentro do seu próprio TouchDesigner, em localhost. Para redes não
-confiáveis você pode exigir um token e desativar os endpoints de execução de
-código — veja [Security](/reference/architecture#security) (em inglês).
-## Como o tdmcp é diferente de outras tentativas de MCP para TouchDesigner?
-Ele combina uma base de conhecimento dos operadores reais com uma ponte que executa
-dentro do TouchDesigner num ciclo criar → verificar → visualizar — então a IA usa
-operadores de verdade e corrige os próprios erros em vez de chutar.
-::: tip English
-This page is also available in English — [see the FAQ](/guide/faq).
-:::

package/mcps/tdmcp/docs/pt/guide/first-visual.md DELETED Viewed

@@ -1,81 +0,0 @@
----
-description: "Crie seu primeiro visual com o tdmcp, o servidor MCP para TouchDesigner — peça em linguagem natural e veja a rede de nós se montar, conferir e dar preview sozinha."
----
-# Seu primeiro visual
-Você já [instalou o tdmcp](/pt/guide/install) e viu `bridge running` no Textport
-do TouchDesigner. Agora vamos criar algo.
-## 1. Peça
-Na sua IA, digite uma descrição do que você quer. Tente isto:
-> *"Crie um túnel de feedback a partir de ruído com blur e displace, adicione
-> bloom e me mostre um preview."*
-A IA vai montar a rede no seu projeto do TouchDesigner, conferir erros e te
-mostrar uma miniatura do resultado. Volte ao TouchDesigner e você verá os nós
-aparecerem, conectados e bem organizados.
-::: tip Confira a ponte primeiro
-Se for seu primeiro prompt da sessão, a IA pode rodar uma checagem rápida
-(`get_td_info`) para garantir que o TouchDesigner está acessível. Se disser que
-não consegue acessar o TouchDesigner, veja
-[Solução de problemas](/pt/guide/troubleshooting).
-:::
-## 2. Itere em linguagem natural
-Você não recomeça — só diz o que mudar:
-- *"Deixe mais quente."*
-- *"Adicione um rastro de feedback."*
-- *"Diminua a velocidade do movimento."*
-- *"Mais contraste, e aumente o blur."*
-- *"Adicione um glitch sutil."*
-Cada pedido ajusta a rede existente. Dê preview quando quiser ver onde está:
-*"me mostre um preview."*
-## 3. Faça reagir ao som
-> *"Crie uma galáxia de partículas reativa ao áudio que responda à minha música,
-> e me mostre um preview."*
-::: warning macOS: permissão de microfone
-Na primeira vez que um visual escuta o microfone, o macOS abre um diálogo de
-permissão. **Clique em Permitir** — até você responder, o TouchDesigner pode
-parecer travado. Se preferir não usar o mic enquanto testa, peça uma fonte de
-*tom de teste*. Detalhes em
-[Solução de problemas](/pt/guide/troubleshooting#macos-microphone-camera-permission).
-:::
-Muitos sistemas já chegam **tocáveis** — vêm com um painelzinho de controle (um
-botão de Feedback, um de Sensibilidade, Arrasto/Turbulência/Gravidade das
-partículas, uma Velocidade de evolução) que você pode pegar e ajustar ao vivo no
-TouchDesigner.
-## 4. Mostre em tela cheia
-Quando gostar:
-> *"Mande para uma janela em tela cheia no meu segundo monitor."*
-Você também pode pedir para gravar, enviar via NDI/Syphon para outros programas,
-ou mapear num projetor. Veja a [galeria de receitas](/pt/guide/recipes) e as
-[receitas de prompt](/pt/guide/prompt-cookbook) para mais.
-## 5. Salve seu visual
-- *"Salve estas configurações de controle como um preset chamado 'abertura'."*
-- *"Salve esta rede inteira como uma receita reutilizável."*
-## Para onde ir agora
-- [Receitas de prompt](/pt/guide/prompt-cookbook) — prompts prontos agrupados pelo
-  que você quer criar.
-- [Galeria de receitas](/pt/guide/recipes) — sistemas prontos que você pede pelo
-  nome.
-- [Glossário](/pt/guide/glossary) — definições em linguagem simples das palavras
-  do TouchDesigner que você vai ouvir.