From 99ccc206862af7bd9695be68a480436c7762e5da Mon Sep 17 00:00:00 2001 From: TianyeDong Date: Sun, 16 Aug 2026 17:23:13 -0400 Subject: [PATCH] add portuguese localization --- README.md | 4 +- READMEs/README.es-ES.md | 4 +- READMEs/README.ja-JP.md | 4 +- READMEs/README.ko-KR.md | 4 +- READMEs/README.pt-BR.md | 392 ++++++++++++++++++ READMEs/README.ru-RU.md | 4 +- READMEs/README.tr-TR.md | 4 +- READMEs/README.zh-CN.md | 4 +- READMEs/README.zh-TW.md | 4 +- .../locales/__tests__/localeRegistry.test.ts | 15 + .../packages/dashboard/src/locales/index.ts | 7 +- .../packages/dashboard/src/locales/pt.ts | 310 ++++++++++++++ .../skills/understand/SKILL.md | 2 +- .../skills/understand/locales/pt.md | 49 +++ 14 files changed, 788 insertions(+), 19 deletions(-) create mode 100644 READMEs/README.pt-BR.md create mode 100644 understand-anything-plugin/packages/dashboard/src/locales/__tests__/localeRegistry.test.ts create mode 100644 understand-anything-plugin/packages/dashboard/src/locales/pt.ts create mode 100644 understand-anything-plugin/skills/understand/locales/pt.md diff --git a/README.md b/README.md index 04efe8311..3ea2d6f6b 100644 --- a/README.md +++ b/README.md @@ -17,7 +17,7 @@

- English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский + English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский | Português

@@ -135,7 +135,7 @@ A multi-agent pipeline scans your project, extracts every file, function, class, # Generate Chinese content (知识图节点描述和 Dashboard UI) /understand --language zh -# Supported languages: en (default), zh, zh-TW, ja, ko, ru +# Supported languages: en (default), zh, zh-TW, ja, ko, ru, pt ``` On the **first run** in a project — when you don't pass `--language` and no language is stored yet — `/understand` detects the language you're conversing in. If it isn't English, it asks you to confirm (or override) before generating; English conversations are unaffected. Your choice is saved to `.ua/config.json` and reused on every later run. diff --git a/READMEs/README.es-ES.md b/READMEs/README.es-ES.md index 69a6e2d65..0a89946e8 100644 --- a/READMEs/README.es-ES.md +++ b/READMEs/README.es-ES.md @@ -10,7 +10,7 @@

- English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский + English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский | Português

@@ -125,7 +125,7 @@ Un pipeline multi-agente escanea tu proyecto, extrae cada archivo, función, cla # Genera contenido en el idioma preferido (descripciones de nodos y UI del dashboard) /understand --language en -# Idiomas soportados: en (default), zh, zh-TW, ja, ko, ru +# Idiomas soportados: en (default), zh, zh-TW, ja, ko, ru, pt ``` El parámetro `--language` afecta: diff --git a/READMEs/README.ja-JP.md b/READMEs/README.ja-JP.md index 0cb341654..900298391 100644 --- a/READMEs/README.ja-JP.md +++ b/READMEs/README.ja-JP.md @@ -17,7 +17,7 @@

- English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский + English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский | Português

@@ -135,7 +135,7 @@ Understand Anything は [Claude Code Plugin](https://code.claude.com/docs/en/plu # 日本語でコンテンツを生成（ナレッジグラフのノード説明とダッシュボードUI） /understand --language ja -# サポート言語：en（デフォルト）、zh、zh-TW、ja、ko、ru +# サポート言語：en（デフォルト）、zh、zh-TW、ja、ko、ru、pt ``` プロジェクトでの**初回実行時**に `--language` を指定せず、保存済みの言語設定もない場合、`/understand` は会話で使われている言語を検出します。英語以外が検出された場合は、生成前にその言語を使用するか、別の言語へ変更するかを確認します。英語での会話には影響しません。選択結果は `.ua/config.json` に保存され、以降の実行でも再利用されます。 diff --git a/READMEs/README.ko-KR.md b/READMEs/README.ko-KR.md index 1d0185e97..417fe780e 100644 --- a/READMEs/README.ko-KR.md +++ b/READMEs/README.ko-KR.md @@ -10,7 +10,7 @@

- English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский + English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский | Português

@@ -125,7 +125,7 @@ Understand Anything은 [Claude Code Plugin](https://code.claude.com/docs/en/plug # 한국어로 내용 생성 (지식 그래프 노드 설명과 대시보드 UI) /understand --language ko -# 지원 언어: en(기본값), zh, zh-TW, ja, ko, ru +# 지원 언어: en(기본값), zh, zh-TW, ja, ko, ru, pt ``` `--language` 매개변수는 다음에 영향합니다: diff --git a/READMEs/README.pt-BR.md b/READMEs/README.pt-BR.md new file mode 100644 index 000000000..011dd7065 --- /dev/null +++ b/READMEs/README.pt-BR.md @@ -0,0 +1,392 @@ +

Understand Anything

+ +

+ Transforme qualquer base de código, base de conhecimento ou documentação em um grafo de conhecimento interativo que você pode explorar, pesquisar e questionar. +
+ Funciona com Claude Code, Codex, Cursor, Copilot, Gemini CLI e muito mais. +

+ +

+ Understand Anything. Understand Anyone. +
+ A IA deve ajudar as pessoas, não substituí-las. +

+ +

+ Understand Anything | Trendshift +

+ +

+ English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский | Português +

+ +

+ Quick Start + License: MIT + Claude Code + Codex + Copilot + Copilot CLI + Gemini CLI + OpenCode + Vibe CLI + Trae + Homepage + Live Demo + Understand Anyone +

+ +

+ Understand Anything — Transforme qualquer base de código em um grafo de conhecimento interativo +

+ +

+ An open-source project from Egonex +
+ Originally created by Lum1104. +

+ +--- + +**Você acabou de entrar em um novo time. A base de código tem 200 mil linhas. Por onde começar?** + +O Understand Anything é um [plugin do Claude Code](https://code.claude.com/docs/en/plugins-reference#plugins-reference) que analisa seu projeto com um pipeline multiagente, constrói um grafo de conhecimento com todos os arquivos, funções, classes e dependências e, então, oferece um dashboard interativo para explorar tudo visualmente. Pare de ler código no escuro. Comece a enxergar o panorama completo. + +> **O objetivo não é um grafo que impressiona pela complexidade da sua base de código — é um grafo que ensina, discretamente, como cada peça se encaixa.** + +--- + +## ✨ Recursos + +> [!NOTE] +> **Quer pular a leitura?** Experimente a [demo ao vivo](https://understand-anything.com/demo/) no nosso [site](https://understand-anything.com/) — um dashboard totalmente interativo que você pode mover, ampliar, pesquisar e explorar direto no navegador. + +### Explore o grafo estrutural + +Navegue pela sua base de código como um grafo de conhecimento interativo — cada arquivo, função e classe é um nó em que você pode clicar, pesquisar e explorar. Selecione qualquer nó para ver resumos em linguagem simples, relações e tours guiados. + +### Entenda a lógica de negócio + +Alterne para a visão de domínio e veja como seu código se relaciona com processos de negócio reais — domínios, fluxos e etapas dispostos em um grafo horizontal. + +### Analise bases de conhecimento + +Aponte o `/understand-knowledge` para um [wiki de LLM no padrão Karpathy](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) e obtenha um grafo de conhecimento force-directed com clusterização por comunidade. O parser determinístico extrai wikilinks e categorias do `index.md`; em seguida, agentes de LLM descobrem relações implícitas, extraem entidades e evidenciam afirmações — transformando seu wiki em um grafo navegável de ideias interconectadas. + + + + + + + + + + + + + + +
+

🧭 Tours guiados

+

Passo a passo da arquitetura gerado automaticamente e ordenado por dependência. Aprenda a base de código na ordem certa.

+ 		+

🔍 Busca aproximada e semântica

+

Encontre qualquer coisa por nome ou por significado. Busque "quais partes cuidam de autenticação?" e receba resultados relevantes em todo o grafo.

+
+

📊 Análise de impacto de diff

+

Veja quais partes do sistema suas mudanças afetam antes de fazer o commit. Entenda os efeitos em cadeia pela base de código.

+ 		+

🎭 UI adaptável ao perfil

+

O dashboard ajusta o nível de detalhe conforme quem está usando — pessoa dev júnior, PM ou usuário avançado.

+
+

🏗️ Visualização por camadas

+

Agrupamento automático por camada arquitetural — API, Serviço, Dados, UI, Utilitários — com legenda colorida.

+ 		+

📚 Conceitos de linguagem

+

12 padrões de programação (generics, closures, decorators etc.) explicados no contexto em que aparecem.

+
+ +--- + +## 🚀 Início rápido + +### 1. Instale o plugin + +```bash +/plugin marketplace add Egonex-AI/Understand-Anything +/plugin install understand-anything +``` + +> **Usa um modelo local?** Para cenários de privacidade ou corporativos, aponte sua plataforma para um provedor de modelo local como o [Ollama](https://docs.ollama.com/integrations) — siga o guia de integração deles para trocar o provedor de modelo. + +### 2. Analise sua base de código + +```bash +/understand +``` + +Um pipeline multiagente varre seu projeto, extrai todos os arquivos, funções, classes e dependências e então constrói um grafo de conhecimento salvo em `.ua/knowledge-graph.json`. (Projetos que já têm um diretório `.understand-anything/` continuam usando ele — quando presente, ele permanece o diretório de dados, então não é preciso migrar nada.) + +> **Atenção ao consumo de tokens:** o `/understand` inicial analisa toda a sua base de código e pode consumir uma quantidade significativa de tokens em projetos grandes. Recomendamos executá-lo com um plano/assinatura de tokens, ou usar um modelo local (veja acima) para a inicialização. As execuções seguintes são incrementais por padrão — apenas os arquivos alterados são reanalisados —, então consomem muito menos tokens. + +**Saída localizada:** use `--language` para gerar conteúdo no idioma da sua preferência: + +```bash +# Gerar conteúdo em português do Brasil (descrições dos nós do grafo e UI do dashboard) +/understand --language pt + +# Idiomas suportados: en (padrão), zh, zh-TW, ja, ko, ru, pt +``` + +Na **primeira execução** em um projeto — quando você não passa `--language` e nenhum idioma foi salvo ainda — o `/understand` detecta o idioma em que você está conversando. Se não for inglês, ele pede confirmação (ou uma troca) antes de gerar; conversas em inglês não são afetadas. Sua escolha é salva em `.ua/config.json` e reutilizada em todas as execuções seguintes. + +O parâmetro `--language` afeta: +- Resumos e descrições dos nós no grafo de conhecimento +- Rótulos, botões e tooltips da UI do dashboard +- Explicações dos tours guiados + +### 3. Explore o dashboard + +```bash +/understand-dashboard +``` + +Um dashboard web interativo abre com sua base de código visualizada como um grafo — colorido por camada arquitetural, pesquisável e clicável. Selecione qualquer nó para ver seu código, suas relações e uma explicação em linguagem simples. + +### 4. Continue aprendendo + +```bash +# Pergunte qualquer coisa sobre a base de código +/understand-chat Como funciona o fluxo de pagamento? + +# Analise o impacto das suas mudanças atuais +/understand-diff + +# Aprofunde-se em um arquivo ou função específicos +/understand-explain src/auth/login.ts + +# Gere um guia de onboarding para novas pessoas no time +/understand-onboard + +# Extraia conhecimento de domínio de negócio (domínios, fluxos, etapas) +/understand-domain + +# Analise uma base de conhecimento wiki de LLM no padrão Karpathy +/understand-knowledge ~/caminho/para/wiki + +# Rode novamente quando quiser — incremental por padrão (só reanalisa arquivos alterados) +/understand + +# Atualize automaticamente a cada commit via hook post-commit +/understand --auto-update + +# Limite a análise a um subdiretório (para monorepos enormes) +/understand src/frontend +``` + +--- + +## 🌐 Instalação multiplataforma + +O Understand-Anything funciona em várias plataformas de programação com IA. + +### Claude Code (nativo) + +```bash +/plugin marketplace add Egonex-AI/Understand-Anything +/plugin install understand-anything +``` + + +### Instalação em uma linha (Codex / OpenCode / OpenClaw / Antigravity / Gemini CLI / Pi Agent / Vibe CLI / VS Code Copilot / Hermes / Cline / KIMI CLI / Trae / Nanobot / Kiro) + + +**macOS / Linux:** +```bash +curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash +# ou pule o prompt informando a plataforma: +curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash -s codex +``` + +**Windows (PowerShell):** +```powershell +iwr -useb https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.ps1 | iex +``` + +O instalador clona o repositório em `~/.understand-anything/repo` e cria os symlinks corretos para a plataforma escolhida. Reinicie sua CLI/IDE depois. + +> **Sobre como invocar as skills:** o prefixo de invocação varia por plataforma. A maioria usa comandos de barra (`/understand`), mas o **Codex usa `$`** — digite `$understand`, não `/understand`. Se nenhum dos prefixos for reconhecido na sua plataforma, basta pedir em linguagem natural: *"Use a skill understand para analisar este projeto."* + +- Valores de `` suportados: `gemini`, `codex`, `opencode`, `pi`, `openclaw`, `antigravity`, `vibe`, `vscode`, `hermes`, `cline`, `kimi`, `trae`, `nanobot`, `kiro` +- Atualizar depois: `./install.sh --update` +- Desinstalar: `./install.sh --uninstall ` + +### Cursor + +O Cursor descobre o plugin automaticamente via `.cursor-plugin/plugin.json` quando este repositório é clonado. Não é preciso instalar nada manualmente — basta clonar e abrir no Cursor. + +Se a descoberta automática não funcionar, instale manualmente: abra **Cursor Settings → Plugins**, cole `https://github.com/Egonex-AI/Understand-Anything` no campo de busca e adicione a partir dali. + +### VS Code + GitHub Copilot + +O VS Code com GitHub Copilot (v1.108+) descobre o plugin automaticamente via `.copilot-plugin/plugin.json` quando este repositório é clonado. Não é preciso instalar nada manualmente — basta clonar e abrir no VS Code. + +Para skills pessoais (disponíveis em todos os projetos), execute o `install.sh` acima com a plataforma `vscode`. + +### Copilot CLI + +```bash +copilot plugin install Egonex-AI/Understand-Anything:understand-anything-plugin +``` + +### Kiro CLI / IDE + +```bash +curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash -s kiro +``` + +Após a instalação: +- **Kiro CLI**: `kiro-cli chat --agent understand "Analise este projeto"` +- **Kiro IDE**: as skills são vinculadas por symlink em `~/.kiro/skills/` e o agente `understand` é gravado em `~/.kiro/agents/understand.json`, então ambos ficam disponíveis após reiniciar a IDE. + +Para skills pessoais (disponíveis em todos os projetos), execute o `install.sh` acima com a plataforma `kiro`. + +### Compatibilidade de plataformas + +| Plataforma | Status | Método de instalação | +|----------|--------|----------------| +| Claude Code | ✅ Nativo | Marketplace de plugins | +| Cursor | ✅ Suportado | Descoberta automática | +| VS Code + GitHub Copilot | ✅ Suportado | Descoberta automática | +| Copilot CLI | ✅ Suportado | Instalação de plugin | +| Codex | ✅ Suportado | `install.sh codex` | +| OpenCode | ✅ Suportado | `install.sh opencode` | +| OpenClaw | ✅ Suportado | `install.sh openclaw` | +| Antigravity | ✅ Suportado | `install.sh antigravity` | +| Gemini CLI | ✅ Suportado | `install.sh gemini` | +| Pi Agent | ✅ Suportado | `install.sh pi` | +| Vibe CLI | ✅ Suportado | `install.sh vibe` | +| Hermes | ✅ Suportado | `install.sh hermes` | +| Cline | ✅ Suportado | `install.sh cline` | +| KIMI CLI | ✅ Suportado | `install.sh kimi` | +| Trae | ✅ Suportado | `install.sh trae` | +| Nanobot | ✅ Suportado | `install.sh nanobot` | +| Kiro CLI / IDE | ✅ Suportado | `install.sh kiro` | + + +--- + +## 📦 Compartilhe o grafo com seu time + +O grafo é apenas JSON — **faça o commit uma vez e o time inteiro pula o pipeline**. Ótimo para onboarding, revisões de PR e docs-as-code. + +> **Exemplo:** [GoogleCloudPlatform/microservices-demo](https://github.com/GoogleCloudPlatform/microservices-demo) — referência em Go / Java / Python / Node com um grafo commitado. + +**O que commitar:** tudo em `.ua/` *exceto* `intermediate/` e `diff-overlay.json` (esses são rascunhos locais). (Projetos legados usam `.understand-anything/` — substitua o nome do diretório abaixo se for esse o presente.) + +```gitignore +.ua/intermediate/ +.ua/diff-overlay.json +``` + +**Mantenha atualizado:** habilite o `/understand --auto-update` — um hook post-commit aplica patches incrementais no grafo, de modo que cada commit chegue com um grafo correspondente. Ou rode `/understand` manualmente antes dos releases. + +**Grafos grandes (10 MB+):** versione com **git-lfs**. + +```bash +git lfs install +git lfs track ".ua/*.json" +git add .gitattributes .ua/ +``` + +### Veja o dashboard sem o Claude Code + +Depois que um grafo é gerado e commitado, qualquer pessoa do time pode abri-lo com um único comando — sem Claude Code, sem LLM, sem chave de API. Só é necessário Node.js (>= 18): + +```bash +npx https://github.com/Egonex-AI/Understand-Anything/releases/latest/download/understand-anything-viewer.tgz /caminho/para/projeto/analisado +``` + +O terminal imprime uma URL com token (`http://127.0.0.1:5173/?token=…`) e abre o dashboard interativo completo no seu navegador. O diretório do projeto (padrão: diretório atual) precisa conter o diretório de dados commitado (`.ua/` ou o legado `.understand-anything/`). Tudo é servido em modo somente leitura a partir do disco local — sem chamadas de LLM, nenhum dado sai da sua máquina. + +Trabalhando a partir de um clone? `pnpm install && pnpm --filter @understand-anything/core build` e depois `GRAPH_DIR=/caminho/para/projeto/analisado pnpm dev:dashboard` fazem o mesmo via servidor de desenvolvimento do Vite. + +--- + +## 🔧 Por baixo dos panos + +### Híbrido tree-sitter + LLM + +Análise estática e LLMs fazem, cada um, o que fazem de melhor: + +- **Tree-sitter (determinístico)** — faz o parsing do código-fonte em uma árvore sintática concreta e extrai fatos estruturais: imports, exports, definições de funções/classes, pontos de chamada, herança. Tudo é pré-resolvido em um `importMap` durante a fase de varredura e passado aos file-analyzers, para que eles não precisem rederivar os imports do código-fonte. Mesma entrada → mesma saída, em toda execução. Também alimenta a detecção de mudanças por fingerprint usada nas atualizações incrementais. +- **LLM (semântico)** — lê a estrutura já parseada junto com o código-fonte original para produzir o que parsers não conseguem: resumos em linguagem simples, tags, atribuição de camadas arquiteturais, mapeamento de domínio de negócio, tours guiados e destaques de conceitos de linguagem. + +Essa divisão é o motivo de o grafo ser reprodutível no lado estrutural (o mesmo código sempre gera as mesmas arestas) e, ao mesmo tempo, capturar intenção no lado semântico (para que um arquivo *serve*, não apenas o que ele importa). + +### Pipeline multiagente + +O comando `/understand` orquestra 5 agentes especializados, e o `/understand-domain` acrescenta um 6º: + +| Agente | Papel | +|-------|------| +| `project-scanner` | Descobre arquivos, detecta linguagens e frameworks | +| `file-analyzer` | Extrai funções, classes e imports; produz nós e arestas do grafo | +| `architecture-analyzer` | Identifica camadas arquiteturais | +| `tour-builder` | Gera tours guiados de aprendizado | +| `graph-reviewer` | Valida a completude do grafo e a integridade referencial (roda inline por padrão; use `--review` para a revisão completa por LLM) | +| `domain-analyzer` | Extrai domínios de negócio, fluxos e etapas de processo (usado pelo `/understand-domain`) | +| `article-analyzer` | Extrai entidades, afirmações e relações implícitas de artigos de wiki (usado pelo `/understand-knowledge`) | + +Os file-analyzers rodam em paralelo (até 5 simultâneos, 20-30 arquivos por lote). Há suporte a atualizações incrementais — só são reanalisados os arquivos que mudaram desde a última execução. + +--- + +## 🎥 Comunidade + +Um passo a passo feito pela comunidade, por **Better Stack**. + +

+ Community walkthrough by Better Stack — watch on YouTube +
+ Assista no YouTube → +

+ +Fez um vídeo, post de blog ou tutorial? Abra uma issue ou PR — teremos prazer em destacá-lo aqui. + +--- + +## 🤝 Contribuindo + +Contribuições são bem-vindas! Veja como começar: + +1. Faça um fork do repositório +2. Crie uma branch de feature (`git checkout -b feature/minha-feature`) +3. Rode os testes (`pnpm --filter @understand-anything/core test`) +4. Faça o commit das suas mudanças e abra um pull request + +Para mudanças grandes, abra uma issue primeiro para discutirmos a abordagem. + +--- + +

+ Pare de ler código no escuro. Comece a entender tudo. +

+ +## Histórico de estrelas + + + + + + Star History Chart + + + +

+ Obrigado a todas as pessoas que usaram e contribuíram — saber que isso economiza tempo de gente real é o que fez valer a pena construir. +

+ +

+ MIT License © Yuxiang Lin and Infinite Universe, Inc. +

diff --git a/READMEs/README.ru-RU.md b/READMEs/README.ru-RU.md index a13dfc893..dde61cc71 100644 --- a/READMEs/README.ru-RU.md +++ b/READMEs/README.ru-RU.md @@ -11,7 +11,7 @@

- English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский + English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский | Português

@@ -126,7 +126,7 @@ Understand Anything — это [плагин для Claude Code](https://code.cl # Генерация контента на русском (описания узлов графа знаний и UI панели) /understand --language ru -# Поддерживаемые языки: en (по умолчанию), zh, zh-TW, ja, ko, ru +# Поддерживаемые языки: en (по умолчанию), zh, zh-TW, ja, ko, ru, pt ``` Параметр `--language` влияет на: diff --git a/READMEs/README.tr-TR.md b/READMEs/README.tr-TR.md index e1fb6c80b..ac37dfb4a 100644 --- a/READMEs/README.tr-TR.md +++ b/READMEs/README.tr-TR.md @@ -11,7 +11,7 @@

- English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский + English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский | Português

@@ -126,7 +126,7 @@ Alan görünümüne geçin ve kodunuzun gerçek iş süreçleriyle nasıl eşle # İstediğiniz dilde içerik oluştur (düğüm açıklamaları ve dashboard UI) /understand --language en -# Desteklenen diller: en (varsayılan), zh, zh-TW, ja, ko, ru +# Desteklenen diller: en (varsayılan), zh, zh-TW, ja, ko, ru, pt ``` `--language` parametresi şunları etkiler: diff --git a/READMEs/README.zh-CN.md b/READMEs/README.zh-CN.md index d3ba928fe..262170367 100644 --- a/READMEs/README.zh-CN.md +++ b/READMEs/README.zh-CN.md @@ -10,7 +10,7 @@

- English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский + English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский | Português

@@ -125,7 +125,7 @@ Understand Anything 是一个 [Claude Code Plugin](https://code.claude.com/docs/ # 生成中文内容（知识图节点描述和 Dashboard UI） /understand --language zh -# 支持的语言：en（默认）、zh、zh-TW、ja、ko、ru +# 支持的语言：en（默认）、zh、zh-TW、ja、ko、ru、pt ``` `--language` 参数会影响： diff --git a/READMEs/README.zh-TW.md b/READMEs/README.zh-TW.md index f7b145fc1..03abd397f 100644 --- a/READMEs/README.zh-TW.md +++ b/READMEs/README.zh-TW.md @@ -10,7 +10,7 @@

- English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский + English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский | Português

@@ -125,7 +125,7 @@ Understand Anything 是一個 [Claude Code Plugin](https://code.claude.com/docs/ # 產生繁體中文內容（知識圖節點描述和 Dashboard UI） /understand --language zh-TW -# 支援的語言：en（預設）、zh、zh-TW、ja、ko、ru +# 支援的語言：en（預設）、zh、zh-TW、ja、ko、ru、pt ``` `--language` 參數會影響： diff --git a/understand-anything-plugin/packages/dashboard/src/locales/__tests__/localeRegistry.test.ts b/understand-anything-plugin/packages/dashboard/src/locales/__tests__/localeRegistry.test.ts new file mode 100644 index 000000000..f246d7575 --- /dev/null +++ b/understand-anything-plugin/packages/dashboard/src/locales/__tests__/localeRegistry.test.ts @@ -0,0 +1,15 @@ +import { describe, expect, it } from "vitest"; +import { getLocale, locales, resolveLocaleKey } from "../index"; + +describe("locale registry", () => { + it("registers Portuguese locale strings", () => { + expect(locales.pt).toBeDefined(); + expect(getLocale("pt")).toBe(locales.pt); + }); + + it("resolves Portuguese language variants to the shared locale", () => { + expect(resolveLocaleKey("pt")).toBe("pt"); + expect(resolveLocaleKey("pt-BR")).toBe("pt"); + expect(resolveLocaleKey("portuguese")).toBe("pt"); + }); +}); diff --git a/understand-anything-plugin/packages/dashboard/src/locales/index.ts b/understand-anything-plugin/packages/dashboard/src/locales/index.ts index 27f022ca5..bd6487a1d 100644 --- a/understand-anything-plugin/packages/dashboard/src/locales/index.ts +++ b/understand-anything-plugin/packages/dashboard/src/locales/index.ts @@ -4,8 +4,9 @@ import zhTW from "./zh-TW"; import ja from "./ja"; import ko from "./ko"; import ru from "./ru"; +import pt from "./pt"; -export type LocaleKey = "en" | "zh" | "zh-TW" | "ja" | "ko" | "ru"; +export type LocaleKey = "en" | "zh" | "zh-TW" | "ja" | "ko" | "ru" | "pt"; export type Locale = typeof en; export const locales: Record = { @@ -15,6 +16,7 @@ export const locales: Record = { ja, ko, ru, + pt, }; export function getLocale(key: LocaleKey): Locale { @@ -29,7 +31,8 @@ export function resolveLocaleKey(lang: string | undefined): LocaleKey { if (normalized === "ja" || normalized === "japanese") return "ja"; if (normalized === "ko" || normalized === "korean") return "ko"; if (normalized === "ru" || normalized === "russian" || normalized === "ru-ru") return "ru"; + if (normalized === "pt" || normalized === "portuguese" || normalized === "pt-br") return "pt"; return "en"; } -export { en, zh, zhTW as "zh-TW", ja, ko, ru }; +export { en, zh, zhTW as "zh-TW", ja, ko, ru, pt }; diff --git a/understand-anything-plugin/packages/dashboard/src/locales/pt.ts b/understand-anything-plugin/packages/dashboard/src/locales/pt.ts new file mode 100644 index 000000000..ddc736700 --- /dev/null +++ b/understand-anything-plugin/packages/dashboard/src/locales/pt.ts @@ -0,0 +1,310 @@ +export const pt = { + common: { + loading: "Carregando projeto...", + computingGraphLayout: "Calculando o layout do grafo...", + forceLayoutFallback: "Layout de força indisponível; exibindo uma grade alternativa.", + noGraphLoaded: "Nenhum grafo carregado", + selectNode: "Selecione um nó para ver os detalhes", + back: "Voltar", + focus: "Focar", + unfocus: "Desfocar", + openCode: "Abrir código", + file: "Arquivo", + tags: "Tags", + connections: "Conexões", + filter: "Filtrar", + resetAll: "Limpar tudo", + analyzed: "Analisado", + startGuidedTour: "Iniciar tour guiado", + truncated: "(truncado)", + preview: "Prévia", + doubleClickToOpen: "clique duplo para abrir", + appName: "Understand Anything", + pressKeyboard: "Pressione ? para ver os atalhos", + path: "Caminho", + theme: "Tema", + }, + projectOverview: { + nodes: "Nós", + edges: "Arestas", + layers: "Camadas", + types: "Tipos", + fileTypes: "Tipos de arquivo", + code: "Código", + config: "Config", + docs: "Docs", + infra: "Infra", + data: "Dados", + domain: "Domínio", + knowledge: "Conhecimento", + languages: "Linguagens", + frameworks: "Frameworks", + nodeTypeDistribution: "Distribuição por tipo de nó", + complexityDistribution: "Distribuição de complexidade", + simple: "Simples", + moderate: "Moderado", + complex: "Complexo", + mostConnectedNodes: "Nós mais conectados", + avgConnectionsPerNode: "Média de conexões por nó", + }, + nodeInfo: { + definedInThisFile: "Definido neste arquivo", + languageConcepts: "Conceitos da linguagem", + category: "Categoria", + wikilinks: "Wikilinks", + backlinks: "Backlinks", + entities: "Entidades", + businessRules: "Regras de negócio", + crossDomain: "Entre domínios", + flows: "Fluxos", + entryPoint: "Ponto de entrada", + steps: "Etapas", + implementation: "Implementação", + }, + fileExplorer: { + analyzedFiles: "Arquivos analisados", + filesFromGraph: "arquivos do grafo de conhecimento atual", + noFilePathsFound: "Nenhum caminho de arquivo encontrado.", + }, + filterPanel: { + nodeTypes: "Tipos de nó", + complexity: "Complexidade", + layers: "Camadas", + edgeCategories: "Categorias de aresta", + }, + personaSelector: { + overview: "Visão geral", + overviewDesc: "Visão da arquitetura em alto nível", + learn: "Aprender", + learnDesc: "Dashboard completo com aprendizado guiado", + deepDive: "Aprofundar", + deepDiveDesc: "Focado no código, com chat", + }, + sidebar: { + info: "Info", + files: "Arquivos", + }, + mobile: { + graph: "Grafo", + info: "Info", + files: "Arquivos", + }, + drawer: { + controls: "Controles", + dashboard: "Dashboard", + role: "Perfil", + view: "Visão", + diffOverlay: "Sobreposição de diff", + nodeTypes: "Tipos de nó", + layers: "Camadas", + tools: "Ferramentas", + path: "Caminho", + help: "Ajuda", + structural: "Estrutural", + domain: "Domínio", + }, + domainView: { + backToDomains: "Voltar aos domínios", + }, + detailLevel: { + filesTitle: "Somente arquivos — dependências no nível da arquitetura (rápido)", + classesTitle: "Arquivos + Classes — estrutura do código com herança", + files: "Arquivos", + classes: "+Classes", + fnTitle: "Alternar nós de função (pode deixar a renderização mais lenta)", + fn: "fn", + }, + nodeTypeLabels: { + all: "Todos", + code: "Código", + config: "Config", + docs: "Docs", + infra: "Infra", + data: "Dados", + domain: "Domínio", + knowledge: "Conhecimento", + }, + tokenGate: { + validating: "Validando...", + continue: "Continuar", + }, + diffToggle: { + hideOverlay: "Ocultar sobreposição de diff", + showOverlay: "Mostrar sobreposição de diff", + noData: "Nenhum dado de diff carregado", + changed: "Alterado", + affected: "Afetado", + }, + learnPanel: { + finish: "Concluir", + next: "Próximo", + prev: "Anterior", + noTour: "Nenhum tour disponível", + noTourHint: "Gere um tour a partir do seu grafo de conhecimento para ter um passo a passo guiado", + projectTour: "Tour do projeto", + steps: "etapas", + stepsTitle: "Etapas", + guidedWalkthrough: "Passo a passo guiado pelo código", + startTour: "Iniciar tour", + tour: "Tour", + exitTour: "Sair do tour", + }, + layer: { + defaultName: "Camada", + label: "camadas", + }, + breadcrumb: { + projectOverview: "Visão geral do projeto", + project: "Projeto", + escBack: "Esc para voltar", + }, + warningBanner: { + dropped: "Descartado", + fatal: "Fatal", + }, + themePicker: { + changeTheme: "Alterar tema", + theme: "Tema", + accentColor: "Cor de destaque", + headingFont: "Fonte dos títulos", + serif: "Serifada", + sans: "Sem serifa", + mono: "Mono", + }, + codeViewer: { + fullFile: "Arquivo completo", + lines: "Linhas", + linesLabel: "linhas", + noFile: "Nenhum arquivo selecionado", + loading: "Carregando código...", + openLarger: "Abrir visualizador de código maior", + closeExpanded: "Fechar visualizador expandido", + closeViewer: "Fechar visualizador de código", + sourceUnavailable: "Código-fonte indisponível", + rendered: "Renderizado", + source: "Fonte", + }, + customNode: { + tested: "Testado", + hasTests: "Possui testes", + }, + ariaLabels: { + openMenu: "Abrir menu", + closeMenu: "Fechar menu", + settings: "Configurações", + hideSearch: "Ocultar busca", + showSearch: "Mostrar busca", + }, + nodeTypeFilter: { + hide: "Ocultar", + show: "Mostrar", + nodesLabel: "nós", + }, + keyboardShortcuts: { + showHelp: "Mostrar atalhos de teclado", + general: "Geral", + navigation: "Navegação", + tour: "Tour", + view: "Visão", + focusSearch: "Focar a barra de busca", + nextStep: "Próxima etapa do tour", + prevStep: "Etapa anterior do tour", + toggleDiff: "Alternar modo diff", + toggleFilter: "Alternar painel de filtros", + toggleExport: "Alternar menu de exportação", + openPathFinder: "Abrir localizador de caminhos", + title: "Atalhos de teclado", + toggleHint: "Pressione ? a qualquer momento para abrir esta ajuda", + closeHint: "Pressione ESC para fechar", + escapeDesc: "Fechar painéis e modais / voltar à visão geral", + }, + search: { + placeholder: "Buscar nós por nome, resumo ou tags...", + fuzzy: "Aproximada", + semantic: "Semântica", + result: "resultado", + }, + export: { + label: "Exportar", + title: "Exportar grafo (E)", + asPNG: "Exportar como PNG", + asSVG: "Exportar como SVG", + asJSON: "Exportar como JSON", + }, + edgeLabels: { + imports: { forward: "importa", backward: "importado por" }, + exports: { forward: "exporta para", backward: "exportado por" }, + contains: { forward: "contém", backward: "contido em" }, + inherits: { forward: "herda de", backward: "herdado por" }, + implements: { forward: "implementa", backward: "implementado por" }, + calls: { forward: "chama", backward: "chamado por" }, + subscribes: { forward: "assina", backward: "assinado por" }, + publishes: { forward: "publica em", backward: "consumido por" }, + middleware: { forward: "middleware de", backward: "usa middleware" }, + reads_from: { forward: "lê de", backward: "lido por" }, + writes_to: { forward: "escreve em", backward: "escrito por" }, + transforms: { forward: "transforma", backward: "transformado por" }, + validates: { forward: "valida", backward: "validado por" }, + depends_on: { forward: "depende de", backward: "dependência de" }, + tested_by: { forward: "testado por", backward: "testa" }, + configures: { forward: "configura", backward: "configurado por" }, + related: { forward: "relacionado a", backward: "relacionado a" }, + similar_to: { forward: "similar a", backward: "similar a" }, + deploys: { forward: "implanta", backward: "implantado por" }, + serves: { forward: "serve", backward: "servido por" }, + migrates: { forward: "migra", backward: "migrado por" }, + documents: { forward: "documenta", backward: "documentado por" }, + provisions: { forward: "provisiona", backward: "provisionado por" }, + routes: { forward: "roteia para", backward: "roteado de" }, + defines_schema: { forward: "define schema de", backward: "schema definido por" }, + triggers: { forward: "aciona", backward: "acionado por" }, + contains_flow: { forward: "contém fluxo", backward: "fluxo em" }, + flow_step: { forward: "etapa do fluxo", backward: "etapa de" }, + cross_domain: { forward: "entre domínios para", backward: "entre domínios de" }, + cites: { forward: "cita", backward: "citado por" }, + contradicts: { forward: "contradiz", backward: "contradito por" }, + builds_on: { forward: "baseia-se em", backward: "base para" }, + exemplifies: { forward: "exemplifica", backward: "exemplificado por" }, + categorized_under: { forward: "categorizado em", backward: "categoriza" }, + authored_by: { forward: "de autoria de", backward: "autor de" }, + }, + pathFinder: { + title: "Encontrar caminho entre nós (P)", + }, + onboarding: { + header: "UNDERSTAND-ANYTHING · COMECE AQUI", + skipForever: "Não mostrar novamente", + prev: "Anterior", + next: "Próximo", + finish: "Começar a explorar", + steps: [ + { + title: "Bem-vindo ao grafo de conhecimento", + body: "Os pontos e as linhas que você vê são entidades e relações que o Understand-Anything extraiu deste projeto. Um nó pode ser um arquivo, uma classe ou uma função do código — ou um conceito, uma entidade ou uma afirmação de um wiki de conhecimento.", + hint: "Cinco passos para cobrir as operações essenciais", + }, + { + title: "Três visões no topo", + body: "Visão geral mostra o panorama (force-directed). Aprender segue um caminho de aprendizado predefinido. Aprofundar mostra estatísticas de tipo e complexidade. Cada visão responde a uma pergunta diferente.", + hint: "Defina o que você quer saber antes de trocar de visão", + }, + { + title: "Busque e clique em um nó", + body: "A caixa de busca no topo faz correspondência aproximada por nome, resumo ou tags do nó. Clique em qualquer nó e o painel da direita abre com resumo, vizinhos e Abrir artigo.", + hint: "A busca centraliza e destaca; clicar em um nó destaca as arestas dele", + }, + { + title: "Troca de camada e Tour do projeto", + body: "As abas de camada ao lado de Todos filtram o grafo para uma única categoria, com base no index.md. O Tour do projeto, à direita, guia você pela sequência predefinida do editor.", + hint: "Use Camada quando os nós estiverem densos demais; comece pelo Tour quando não tiver um ponto de partida", + }, + { + title: "Mais recursos escondidos", + body: "A barra superior também tem Filtrar (por tipo ou complexidade), Exportar (exportar o grafo), Caminho (encontrar um caminho entre dois nós) e Tema. Pressione Shift + ? para ver todos os atalhos de teclado.", + hint: "Explore-os conforme a necessidade — não precisa memorizar tudo de uma vez", + }, + ], + }, +}; + +export default pt; diff --git a/understand-anything-plugin/skills/understand/SKILL.md b/understand-anything-plugin/skills/understand/SKILL.md index f13012e0e..a89d2d396 100644 --- a/understand-anything-plugin/skills/understand/SKILL.md +++ b/understand-anything-plugin/skills/understand/SKILL.md @@ -149,7 +149,7 @@ Determine whether to run a full analysis or incremental update. - Parse `$ARGUMENTS` for `--language ` flag. If found, extract the language code. - **Language code normalization:** Map friendly names to ISO codes: - `chinese` → `zh`, `japanese` → `ja`, `korean` → `ko`, `english` → `en`, `spanish` → `es`, `french` → `fr`, `german` → `de`, `portuguese` → `pt`, `russian` → `ru`, `arabic` → `ar`, etc. - - Locale variants: `zh-TW`, `zh-HK`, `zh-CN`, `pt-BR`, etc. are preserved as-is. + - Locale variants: `zh-TW`, `zh-HK`, `zh-CN`, etc. are preserved as-is; `pt-BR`, `pt-PT` → `pt` (one Portuguese translation covers both). - If `--language` is NOT specified: - **Stored preference wins.** If `$UA_DIR/config.json` has an `outputLanguage` field, set `$OUTPUT_LANGUAGE` to it and skip the rest. - **Otherwise detect (first run only).** Infer the predominant language of the user's conversation as an ISO 639-1 code (`$DETECTED_LANG`). If it is `en` or cannot be confidently determined, set `$OUTPUT_LANGUAGE=en` and proceed silently — no prompt (English users see no change). diff --git a/understand-anything-plugin/skills/understand/locales/pt.md b/understand-anything-plugin/skills/understand/locales/pt.md new file mode 100644 index 000000000..236577807 --- /dev/null +++ b/understand-anything-plugin/skills/understand/locales/pt.md @@ -0,0 +1,49 @@ +# Guia de saída em português (Portuguese) + +Este arquivo contém as diretrizes de idioma para gerar o conteúdo do grafo de conhecimento em português. + +## Convenções de tags + +Use tags em português ou termos técnicos consagrados em inglês: + +| Padrão | Tags recomendadas | +|--------|-------------------| +| Ponto de entrada | `ponto-de-entrada`, `barrel`, `exports` ou `entry-point` | +| Funções utilitárias | `utilitarios`, `helpers`, `common` ou `utility` | +| Handlers de API | `api-handler`, `controlador`, `endpoint` | +| Modelos de dados | `modelo-de-dados`, `entity`, `schema` ou `data-model` | +| Arquivos de teste | `testes`, `unit-test`, `test` | +| Arquivos de configuração | `configuracao`, `build-system`, `settings` ou `configuration` | +| Infraestrutura | `infraestrutura`, `deployment`, `conteinerizacao` ou `infrastructure` | +| Documentação | `documentacao`, `guia`, `documentation` | + +**Estratégia mista:** mantenha em inglês os termos técnicos consagrados (por exemplo, `middleware`, `api-handler`) e escreva em português as tags descritivas. + +## Estilo dos resumos + +Escreva resumos de 1 a 2 frases em português: +- Descreva o **propósito** e o **papel** do arquivo +- Use voz ativa ("fornece...", "processa...", "gerencia...") +- Evite repetir o nome do arquivo + +**Exemplos:** +- Bom: "Fornece funções auxiliares para formatação de datas e sanitização de strings, amplamente usadas na camada de API." +- Ruim: "O arquivo utils contém funções utilitárias." + +## Termos técnicos + +Recomenda-se manter os termos a seguir em inglês (não há tradução consagrada): +- `middleware`, `hook`, `barrel`, `entry-point` +- `ORM`, `REST API`, `CI/CD`, `CRUD` +- `singleton`, `factory`, `observer` +- `interceptor`, `guard`, `deploy`, `build` + +## Nomes de camadas + +Use nomes de camada em português: +- `Camada de API`, `Camada de Serviços`, `Camada de Dados`, `Camada de UI` +- `Infraestrutura`, `Configuração`, `Documentação` +- `Camada de Utilitários`, `Camada de Middleware`, `Camada de Testes` + +Ou mantenha os nomes em inglês (conforme a convenção da equipe): +- `API Layer`, `Service Layer`, `Data Layer`