` | Número de arquivos principais para mostrar | `5` |
+
+## Exemplos
+
+```bash
+# Uso básico
+repomix
+
+# Saída personalizada
+repomix -o output.xml --style xml
+
+# Processar arquivos específicos
+repomix --include "src/**/*.ts" --ignore "**/*.test.ts"
+
+# Repositório remoto
+repomix --remote user/repo --remote-branch main
diff --git a/website/client/src/pt-br/guide/comment-removal.md b/website/client/src/pt-br/guide/comment-removal.md
new file mode 100644
index 000000000..0038ce01b
--- /dev/null
+++ b/website/client/src/pt-br/guide/comment-removal.md
@@ -0,0 +1,53 @@
+# Remoção de Comentários
+
+O Repomix pode remover automaticamente os comentários do seu código ao gerar o arquivo de saída. Isso pode ajudar a reduzir o ruído e focar no código real.
+
+## Uso
+
+Para habilitar a remoção de comentários, defina a opção `removeComments` como `true` no seu `repomix.config.json`:
+
+```json
+{
+ "output": {
+ "removeComments": true
+ }
+}
+```
+
+## Linguagens Suportadas
+
+O Repomix suporta a remoção de comentários para uma ampla gama de linguagens de programação, incluindo:
+
+- JavaScript/TypeScript (`//`, `/* */`)
+- Python (`#`, `"""`, `'''`)
+- Java (`//`, `/* */`)
+- C/C++ (`//`, `/* */`)
+- HTML (``)
+- CSS (`/* */`)
+- E muitas outras...
+
+## Exemplo
+
+Dado o seguinte código JavaScript:
+
+```javascript
+// Este é um comentário de linha única
+function test() {
+ /* Este é um
+ comentário de várias linhas */
+ return true;
+}
+```
+
+Com a remoção de comentários habilitada, a saída será:
+
+```javascript
+function test() {
+ return true;
+}
+```
+
+## Notas
+
+- A remoção de comentários é realizada antes de outras etapas de processamento, como a adição de números de linha.
+- Alguns comentários, como os comentários JSDoc, podem ser preservados dependendo da linguagem e do contexto.
diff --git a/website/client/src/pt-br/guide/configuration.md b/website/client/src/pt-br/guide/configuration.md
new file mode 100644
index 000000000..dd2f13901
--- /dev/null
+++ b/website/client/src/pt-br/guide/configuration.md
@@ -0,0 +1,84 @@
+# Configuração
+
+## Início Rápido
+
+Criar arquivo de configuração:
+```bash
+repomix --init
+```
+
+## Arquivo de Configuração
+
+`repomix.config.json`:
+```json
+{
+ "output": {
+ "filePath": "repomix-output.xml",
+ "style": "xml",
+ "headerText": "Texto de cabeçalho personalizado",
+ "instructionFilePath": "repomix-instruction.md",
+ "fileSummary": true,
+ "directoryStructure": true,
+ "removeComments": false,
+ "removeEmptyLines": false,
+ "topFilesLength": 5,
+ "showLineNumbers": false,
+ "copyToClipboard": false,
+ "includeEmptyDirectories": false
+ },
+ "include": ["**/*"],
+ "ignore": {
+ "useGitignore": true,
+ "useDefaultPatterns": true,
+ "customPatterns": ["tmp/", "*.log"]
+ },
+ "security": {
+ "enableSecurityCheck": true
+ }
+}
+```
+
+## Configuração Global
+
+Criar configuração global:
+```bash
+repomix --init --global
+```
+
+Localização:
+- Windows: `%LOCALAPPDATA%\Repomix\repomix.config.json`
+- macOS/Linux: `~/.config/repomix/repomix.config.json`
+
+## Padrões de Exclusão
+
+Ordem de prioridade:
+1. Opções de CLI (`--ignore`)
+2. .repomixignore
+3. .gitignore
+4. Padrões padrão
+
+Exemplo de `.repomixignore`:
+```text
+# Diretórios de cache
+.cache/
+tmp/
+
+# Saídas de build
+dist/
+build/
+
+# Logs
+*.log
+```
+
+## Padrões de Exclusão Padrão
+
+Padrões comuns incluídos por padrão:
+```text
+node_modules/**
+.git/**
+coverage/**
+dist/**
+```
+
+Lista completa: [defaultIgnore.ts](https://github.com/yamadashy/repomix/blob/main/src/config/defaultIgnore.ts)
diff --git a/website/client/src/pt-br/guide/custom-instructions.md b/website/client/src/pt-br/guide/custom-instructions.md
new file mode 100644
index 000000000..ece8d4327
--- /dev/null
+++ b/website/client/src/pt-br/guide/custom-instructions.md
@@ -0,0 +1,42 @@
+# Instruções Personalizadas
+
+O Repomix permite fornecer instruções personalizadas que serão incluídas no arquivo de saída. Isso pode ser útil para adicionar contexto ou diretrizes específicas para sistemas de IA que processam o repositório.
+
+## Uso
+
+Para incluir uma instrução personalizada, crie um arquivo markdown (por exemplo, `repomix-instruction.md`) na raiz do seu repositório. Em seguida, especifique o caminho para este arquivo no seu `repomix.config.json`:
+
+```json
+{
+ "output": {
+ "instructionFilePath": "repomix-instruction.md"
+ }
+}
+```
+
+O conteúdo deste arquivo será incluído na saída sob a seção "Instruction".
+
+## Exemplo
+
+```markdown
+# Instruções do Repositório
+
+Este repositório contém o código-fonte da ferramenta Repomix. Por favor, siga estas diretrizes ao analisar o código:
+
+1. Concentre-se na funcionalidade principal no diretório `src/core`.
+2. Preste atenção especial às verificações de segurança em `src/core/security`.
+3. Ignore quaisquer arquivos no diretório `tests`.
+```
+
+Isso resultará na seguinte seção na saída:
+
+```xml
+
+# Instruções do Repositório
+
+Este repositório contém o código-fonte da ferramenta Repomix. Por favor, siga estas diretrizes ao analisar o código:
+
+1. Concentre-se na funcionalidade principal no diretório `src/core`.
+2. Preste atenção especial às verificações de segurança em `src/core/security`.
+3. Ignore quaisquer arquivos no diretório `tests`.
+
diff --git a/website/client/src/pt-br/guide/development/index.md b/website/client/src/pt-br/guide/development/index.md
new file mode 100644
index 000000000..db8582fcb
--- /dev/null
+++ b/website/client/src/pt-br/guide/development/index.md
@@ -0,0 +1,42 @@
+# Contribuindo para o Repomix
+
+## Início Rápido
+
+```bash
+git clone https://github.com/yamadashy/repomix.git
+cd repomix
+npm install
+```
+
+## Comandos de Desenvolvimento
+
+```bash
+# Executar CLI
+npm run cli-run
+
+# Executar testes
+npm run test
+npm run test-coverage
+
+# Lintar código
+npm run lint
+```
+
+## Estilo de Código
+
+- Use [Biome](https://biomejs.dev/) para lintar e formatar
+- Injeção de dependência para testabilidade
+- Mantenha os arquivos com menos de 250 linhas
+- Adicione testes para novos recursos
+
+## Diretrizes para Pull Requests
+
+1. Execute todos os testes
+2. Passe nas verificações de lint
+3. Atualize a documentação
+4. Siga o estilo de código existente
+
+## Precisa de Ajuda?
+
+- [Abra uma issue](https://github.com/yamadashy/repomix/issues)
+- [Junte-se ao Discord](https://discord.gg/wNYzTwZFku)
diff --git a/website/client/src/pt-br/guide/development/setup.md b/website/client/src/pt-br/guide/development/setup.md
new file mode 100644
index 000000000..bc55c05d7
--- /dev/null
+++ b/website/client/src/pt-br/guide/development/setup.md
@@ -0,0 +1,73 @@
+# Configuração de Desenvolvimento
+
+## Pré-requisitos
+
+- Node.js ≥ 18.0.0
+- Git
+- npm
+
+## Desenvolvimento Local
+
+```bash
+# Clonar repositório
+git clone https://github.com/yamadashy/repomix.git
+cd repomix
+
+# Instalar dependências
+npm install
+
+# Executar CLI
+npm run cli-run
+```
+
+## Desenvolvimento com Docker
+
+```bash
+# Construir imagem
+docker build -t repomix .
+
+# Executar container
+docker run -v ./:/app -it --rm repomix
+```
+
+## Estrutura do Projeto
+
+```
+src/
+├── cli/ # Implementação da CLI
+├── config/ # Manipulação de configuração
+├── core/ # Funcionalidade principal
+└── shared/ # Utilitários compartilhados
+```
+
+## Testando
+
+```bash
+# Executar testes
+npm run test
+
+# Cobertura de teste
+npm run test-coverage
+
+# Linting
+npm run lint-biome
+npm run lint-ts
+npm run lint-secretlint
+```
+
+## Processo de Release
+
+1. Atualizar versão
+```bash
+npm version patch # ou minor/major
+```
+
+2. Executar testes e construir
+```bash
+npm run test-coverage
+npm run build
+```
+
+3. Publicar
+```bash
+npm publish
diff --git a/website/client/src/pt-br/guide/index.md b/website/client/src/pt-br/guide/index.md
new file mode 100644
index 000000000..cd491d19c
--- /dev/null
+++ b/website/client/src/pt-br/guide/index.md
@@ -0,0 +1,60 @@
+# Introdução ao Repomix
+
+O Repomix é uma ferramenta que compacta todo o seu repositório em um único arquivo amigável para IA. Ele foi projetado para ajudá-lo a alimentar seu código-fonte para Modelos de Linguagem Grandes (LLMs) como Claude, ChatGPT e Gemini.
+
+## Início Rápido
+
+Execute este comando no diretório do seu projeto:
+
+```bash
+npx repomix
+```
+
+É isso! Você encontrará um arquivo `repomix-output.txt` contendo todo o seu repositório em um formato amigável para IA.
+
+Você pode então enviar este arquivo para um assistente de IA com um prompt como:
+
+```
+Este arquivo contém todos os arquivos do repositório combinados em um só.
+Eu quero refatorar o código, então, por favor, revise-o primeiro.
+```
+
+A IA analisará todo o seu código-fonte e fornecerá insights abrangentes:
+
+
+
+Ao discutir mudanças específicas, a IA pode ajudar a gerar código. Com recursos como o Artifacts do Claude, você pode até receber vários arquivos interdependentes:
+
+
+
+Feliz codificação! 🚀
+
+## Principais Recursos
+
+- **Saída Otimizada para IA**: Formata seu código-fonte para fácil processamento por IA
+- **Contagem de Tokens**: Rastreia o uso de tokens para limites de contexto de LLM
+- **Consciente do Git**: Respeita seus arquivos .gitignore
+- **Focado em Segurança**: Detecta informações sensíveis
+- **Múltiplos Formatos de Saída**: Escolha entre texto simples, XML ou Markdown
+
+## O que vem a seguir?
+
+- [Guia de Instalação](installation.md): Diferentes maneiras de instalar o Repomix
+- [Guia de Uso](usage.md): Aprenda sobre recursos básicos e avançados
+- [Configuração](configuration.md): Personalize o Repomix para suas necessidades
+- [Recursos de Segurança](security.md): Aprenda sobre verificações de segurança
+
+## Comunidade
+
+Junte-se à nossa [comunidade Discord](https://discord.gg/wNYzTwZFku) para:
+- Obter ajuda com o Repomix
+- Compartilhar suas experiências
+- Sugerir novos recursos
+- Conectar-se com outros usuários
+
+## Suporte
+
+Encontrou um bug ou precisa de ajuda?
+- [Abra um problema no GitHub](https://github.com/yamadashy/repomix/issues)
+- Junte-se ao nosso servidor Discord
+- Verifique a [documentação](https://repomix.com)
diff --git a/website/client/src/pt-br/guide/installation.md b/website/client/src/pt-br/guide/installation.md
new file mode 100644
index 000000000..2742fe79f
--- /dev/null
+++ b/website/client/src/pt-br/guide/installation.md
@@ -0,0 +1,53 @@
+# Instalação
+
+## Usando npx (Nenhuma Instalação Necessária)
+
+```bash
+npx repomix
+```
+
+## Instalação Global
+
+### npm
+```bash
+npm install -g repomix
+```
+
+### Yarn
+```bash
+yarn global add repomix
+```
+
+### Homebrew (macOS)
+```bash
+brew install repomix
+```
+
+## Instalação via Docker
+
+Baixe e execute a imagem Docker:
+
+```bash
+# Diretório atual
+docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix
+
+# Diretório específico
+docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix path/to/directory
+
+# Repositório remoto
+docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix --remote yamadashy/repomix
+```
+
+## Requisitos de Sistema
+
+- Node.js: ≥ 18.0.0
+- Git: Necessário para processamento de repositório remoto
+
+## Verificação
+
+Após a instalação, verifique se o Repomix está funcionando:
+
+```bash
+repomix --version
+repomix --help
+```
diff --git a/website/client/src/pt-br/guide/output.md b/website/client/src/pt-br/guide/output.md
new file mode 100644
index 000000000..58ae0096d
--- /dev/null
+++ b/website/client/src/pt-br/guide/output.md
@@ -0,0 +1,121 @@
+# Output Formats
+
+Repomix supports three output formats:
+- Plain Text (default)
+- XML
+- Markdown
+
+## Plain Text Format
+
+```bash
+repomix --style plain
+```
+
+Output structure:
+```text
+This file is a merged representation of the entire codebase...
+
+================
+File Summary
+================
+(Metadata and AI instructions)
+
+================
+Directory Structure
+================
+src/
+ index.ts
+ utils/
+ helper.ts
+
+================
+Files
+================
+
+================
+File: src/index.ts
+================
+// File contents here
+```
+
+## XML Format
+
+```bash
+repomix --style xml
+```
+
+XML format is optimized for AI processing:
+
+```xml
+This file is a merged representation of the entire codebase...
+
+
+(Metadata and AI instructions)
+
+
+
+src/
+ index.ts
+ utils/
+ helper.ts
+
+
+
+
+// File contents here
+
+
+```
+
+::: tip Why XML?
+XML tags help AI models like Claude parse content more accurately. [Claude Documentation](https://docs.anthropic.com/en/docs/build-with-claude/prompt-engineering/use-xml-tags) recommends using XML tags for structured prompts.
+:::
+
+## Markdown Format
+
+```bash
+repomix --style markdown
+```
+
+Markdown provides readable formatting:
+
+```markdown
+This file is a merged representation of the entire codebase...
+
+# File Summary
+(Metadata and AI instructions)
+
+# Directory Structure
+```
+src/
+index.ts
+utils/
+helper.ts
+```
+
+# Files
+
+## File: src/index.ts
+```typescript
+// File contents here
+```
+```
+
+## Usage with AI Models
+
+Each format works well with AI models, but consider:
+- Use XML for Claude (best parsing accuracy)
+- Use Markdown for general readability
+- Use Plain Text for simplicity and universal compatibility
+
+## Customization
+
+Set default format in `repomix.config.json`:
+```json
+{
+ "output": {
+ "style": "xml",
+ "filePath": "output.xml"
+ }
+}
+```
diff --git a/website/client/src/pt-br/guide/prompt-examples.md b/website/client/src/pt-br/guide/prompt-examples.md
new file mode 100644
index 000000000..4d4ef5581
--- /dev/null
+++ b/website/client/src/pt-br/guide/prompt-examples.md
@@ -0,0 +1,124 @@
+# Exemplos de Prompts
+
+## Revisão de Código
+
+### Revisão de Arquitetura
+```
+Analise a arquitetura desta base de código:
+1. Avalie a estrutura geral e os padrões
+2. Identifique possíveis problemas de arquitetura
+3. Sugira melhorias para escalabilidade
+4. Observe áreas que seguem as melhores práticas
+
+Concentre-se na manutenibilidade e modularidade.
+```
+
+### Revisão de Segurança
+```
+Realize uma revisão de segurança desta base de código:
+1. Identifique possíveis vulnerabilidades de segurança
+2. Verifique se há antipadrões de segurança comuns
+3. Revise o tratamento de erros e a validação de entrada
+4. Avalie a segurança das dependências
+
+Forneça exemplos específicos e etapas de correção.
+```
+
+### Revisão de Desempenho
+```
+Revise a base de código para desempenho:
+1. Identifique gargalos de desempenho
+2. Verifique a utilização de recursos
+3. Revise a eficiência algorítmica
+4. Avalie as estratégias de cache
+
+Inclua recomendações específicas de otimização.
+```
+
+## Geração de Documentação
+
+### Documentação de API
+```
+Gere documentação abrangente da API:
+1. Liste e descreva todos os endpoints públicos
+2. Documente os formatos de solicitação/resposta
+3. Inclua exemplos de uso
+4. Observe quaisquer limitações ou restrições
+```
+
+### Guia do Desenvolvedor
+```
+Crie um guia do desenvolvedor cobrindo:
+1. Instruções de configuração
+2. Visão geral da estrutura do projeto
+3. Fluxo de trabalho de desenvolvimento
+4. Abordagem de teste
+5. Etapas comuns de solução de problemas
+```
+
+### Documentação de Arquitetura
+```
+Documente a arquitetura do sistema:
+1. Visão geral de alto nível
+2. Interações de componentes
+3. Diagramas de fluxo de dados
+4. Decisões de design e justificativa
+5. Restrições e limitações do sistema
+```
+
+## Análise e Melhoria
+
+### Análise de Dependências
+```
+Analise as dependências do projeto:
+1. Identifique pacotes desatualizados
+2. Verifique se há vulnerabilidades de segurança
+3. Sugira pacotes alternativos
+4. Revise os padrões de uso de dependências
+
+Inclua recomendações específicas de atualização.
+```
+
+### Cobertura de Testes
+```
+Revise a cobertura de testes:
+1. Identifique componentes não testados
+2. Sugira casos de teste adicionais
+3. Revise a qualidade do teste
+4. Recomende estratégias de teste
+```
+
+### Qualidade do Código
+```
+Avalie a qualidade do código e sugira melhorias:
+1. Revise as convenções de nomenclatura
+2. Verifique a organização do código
+3. Avalie o tratamento de erros
+4. Revise as práticas de comentários
+
+Forneça exemplos específicos de padrões bons e problemáticos.
+```
+
+## Dicas para Obter Melhores Resultados
+
+1. **Seja Específico**: Inclua objetivos claros e critérios de avaliação
+2. **Defina o Contexto**: Especifique sua função e o nível de especialização necessário
+3. **Formato da Solicitação**: Defina como você deseja que a resposta seja estruturada
+4. **Priorize**: Indique quais aspectos são mais importantes
+
+## Notas Específicas do Modelo
+
+### Claude
+- Use o formato de saída XML
+- Coloque instruções importantes no final
+- Especifique a estrutura da resposta
+
+### ChatGPT
+- Use o formato Markdown
+- Divida grandes bases de código em seções
+- Inclua prompts de função do sistema
+
+### Gemini
+- Funciona com todos os formatos
+- Concentre-se em áreas específicas por solicitação
+- Use análise passo a passo
diff --git a/website/client/src/pt-br/guide/remote-repository-processing.md b/website/client/src/pt-br/guide/remote-repository-processing.md
new file mode 100644
index 000000000..c0c8b12b3
--- /dev/null
+++ b/website/client/src/pt-br/guide/remote-repository-processing.md
@@ -0,0 +1,68 @@
+# Processamento de Repositório Remoto
+
+## Uso Básico
+
+Processar repositórios públicos:
+```bash
+# Usando URL completo
+repomix --remote https://github.com/user/repo
+
+# Usando atalho do GitHub
+repomix --remote user/repo
+```
+
+## Seleção de Branch e Commit
+
+```bash
+# Branch específico
+repomix --remote user/repo --remote-branch main
+
+# Tag
+repomix --remote user/repo --remote-branch v1.0.0
+
+# Hash do commit
+repomix --remote user/repo --remote-branch 935b695
+```
+
+## Requisitos
+
+- Git deve estar instalado
+- Conexão com a internet
+- Acesso de leitura ao repositório
+
+## Controle de Saída
+
+```bash
+# Local de saída personalizado
+repomix --remote user/repo -o custom-output.xml
+
+# Com formato XML
+repomix --remote user/repo --style xml
+
+# Remover comentários
+repomix --remote user/repo --remove-comments
+```
+
+## Uso com Docker
+
+```bash
+# Processar e enviar para o diretório atual
+docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix \
+ --remote user/repo
+
+# Enviar para um diretório específico
+docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix \
+ --remote user/repo
+```
+
+## Problemas Comuns
+
+### Problemas de Acesso
+- Certifique-se de que o repositório é público
+- Verifique a instalação do Git
+- Verifique a conexão com a internet
+
+### Repositórios Grandes
+- Use `--include` para selecionar caminhos específicos
+- Habilite `--remove-comments`
+- Processe branches separadamente
diff --git a/website/client/src/pt-br/guide/security.md b/website/client/src/pt-br/guide/security.md
new file mode 100644
index 000000000..1f8c573dd
--- /dev/null
+++ b/website/client/src/pt-br/guide/security.md
@@ -0,0 +1,65 @@
+# Segurança
+
+## Recurso de Verificação de Segurança
+
+O Repomix usa o [Secretlint](https://github.com/secretlint/secretlint) para detectar informações confidenciais em seus arquivos:
+- Chaves de API
+- Tokens de acesso
+- Credenciais
+- Chaves privadas
+- Variáveis de ambiente
+
+## Configuração
+
+As verificações de segurança são habilitadas por padrão.
+
+Desativar via CLI:
+```bash
+repomix --no-security-check
+```
+
+Ou em `repomix.config.json`:
+```json
+{
+ "security": {
+ "enableSecurityCheck": false
+ }
+}
+```
+
+## Medidas de Segurança
+
+1. **Exclusão de Arquivos Binários**: Arquivos binários não são incluídos na saída
+2. **Compatível com Git**: Respeita os padrões do `.gitignore`
+3. **Detecção Automatizada**: Verifica problemas de segurança comuns:
+ - Credenciais da AWS
+ - Strings de conexão de banco de dados
+ - Tokens de autenticação
+ - Chaves privadas
+
+## Quando a Verificação de Segurança Encontra Problemas
+
+Exemplo de saída:
+```bash
+🔍 Verificação de Segurança:
+──────────────────
+2 arquivo(s) suspeito(s) detectados e excluídos:
+1. config/credentials.json
+ - Chave de acesso da AWS encontrada
+2. .env.local
+ - Senha do banco de dados encontrada
+```
+
+## Melhores Práticas
+
+1. Sempre revise a saída antes de compartilhar
+2. Use `.repomixignore` para caminhos confidenciais
+3. Mantenha as verificações de segurança habilitadas
+4. Remova arquivos confidenciais do repositório
+
+## Reportando Problemas de Segurança
+
+Encontrou uma vulnerabilidade de segurança? Por favor:
+1. Não abra uma issue pública
+2. Envie um e-mail para: koukun0120@gmail.com
+3. Ou use [Avisos de Segurança do GitHub](https://github.com/yamadashy/repomix/security/advisories/new)
diff --git a/website/client/src/pt-br/guide/tips/best-practices.md b/website/client/src/pt-br/guide/tips/best-practices.md
new file mode 100644
index 000000000..a18b35e0d
--- /dev/null
+++ b/website/client/src/pt-br/guide/tips/best-practices.md
@@ -0,0 +1,35 @@
+# AI-Assisted Development Best Practices: From My Experience
+
+While I haven't successfully completed a large-scale project using AI yet, I'd like to share what I've learned so far from my experience working with AI in development.
+
+## Basic Development Approach
+
+When working with AI, attempting to implement all features at once can lead to unexpected issues and project stagnation. That's why it's more effective to start with core functionality and build each feature one at a time, ensuring solid implementation before moving forward.
+
+### The Power of Existing Code
+
+This approach is effective because implementing core functionality allows you to materialize your ideal design and coding style through actual code. The most effective way to communicate your project vision is through code that reflects your standards and preferences.
+
+By starting with core features and ensuring each component works properly before moving on, the entire project maintains consistency, making it easier for AI to generate more appropriate code.
+
+## The Modular Approach
+
+Breaking code into smaller modules is crucial. In my experience, keeping files around 250 lines of code makes it easier to give clear instructions to AI and makes the trial-and-error process more efficient. While token count would be a more accurate metric, line count is more practical for human developers to work with, so we use that as a guideline.
+
+This modularization isn't just about separating frontend, backend, and database components - it's about breaking down functionality at a much finer level. For example, within a single feature, you might separate validation, error handling, and other specific functionalities into distinct modules. Of course, high-level separation is also important, and implementing this modular approach gradually helps maintain clear instructions and enables AI to generate more appropriate code. This approach is effective not just for AI but for human developers as well.
+
+## Ensuring Quality Through Testing
+
+I consider testing to be crucial in AI-assisted development. Tests serve not only as quality assurance measures but also as documentation that clearly demonstrates code intentions. When asking AI to implement new features, existing test code effectively acts as a specification document.
+
+Tests are also an excellent tool for validating the correctness of AI-generated code. For instance, when having AI implement new functionality for a module, writing test cases beforehand allows you to objectively evaluate whether the generated code behaves as expected. This aligns well with Test-Driven Development (TDD) principles and is particularly effective when collaborating with AI.
+
+## Balancing Planning and Implementation
+
+Before implementing large-scale features, I recommend first discussing the plan with AI. Organizing requirements and considering architecture leads to smoother implementation. A good practice is to compile requirements first, then move to a separate chat session for implementation work.
+
+It's essential to have human review of AI output and make adjustments as needed. While the quality of AI-generated code is generally moderate, it still accelerates development compared to writing everything from scratch.
+
+## Conclusion
+
+By following these practices, you can leverage AI's strengths while building a consistent, high-quality codebase. Even as your project grows in size, each component remains well-defined and manageable.
diff --git a/website/client/src/pt-br/guide/usage.md b/website/client/src/pt-br/guide/usage.md
new file mode 100644
index 000000000..6240dffd5
--- /dev/null
+++ b/website/client/src/pt-br/guide/usage.md
@@ -0,0 +1,87 @@
+# Uso Básico
+
+## Início Rápido
+
+Compacte todo o seu repositório:
+```bash
+repomix
+```
+
+## Casos de Uso Comuns
+
+### Compactar Diretórios Específicos
+```bash
+repomix path/to/directory
+```
+
+### Incluir Arquivos Específicos
+Use [glob patterns](https://github.com/mrmlnc/fast-glob?tab=readme-ov-file#pattern-syntax):
+```bash
+repomix --include "src/**/*.ts,**/*.md"
+```
+
+### Excluir Arquivos
+```bash
+repomix --ignore "**/*.log,tmp/"
+```
+
+### Repositórios Remotos
+```bash
+# Usando URL do GitHub
+repomix --remote https://github.com/user/repo
+
+# Usando abreviação
+repomix --remote user/repo
+
+# Branch/tag/commit específico
+repomix --remote user/repo --remote-branch main
+repomix --remote user/repo --remote-branch 935b695
+```
+
+## Formatos de Saída
+
+### Texto Simples (Padrão)
+```bash
+repomix --style plain
+```
+
+### XML
+```bash
+repomix --style xml
+```
+
+### Markdown
+```bash
+repomix --style markdown
+```
+
+## Opções Adicionais
+
+### Remover Comentários
+```bash
+repomix --remove-comments
+```
+
+### Mostrar Números de Linha
+```bash
+repomix --output-show-line-numbers
+```
+
+### Copiar para a Área de Transferência
+```bash
+repomix --copy
+```
+
+### Desativar Verificação de Segurança
+```bash
+repomix --no-security-check
+```
+
+## Configuração
+
+Inicializar arquivo de configuração:
+```bash
+repomix --init
+```
+
+Veja o [Guia de Configuração](/pt-br/guide/configuration) para opções detalhadas.
diff --git a/website/client/src/pt-br/index.md b/website/client/src/pt-br/index.md
new file mode 100644
index 000000000..d5e233dde
--- /dev/null
+++ b/website/client/src/pt-br/index.md
@@ -0,0 +1,187 @@
+---
+layout: home
+title: Repomix
+titleTemplate: Compacte seu código-fonte em formatos amigáveis para IA
+aside: false
+editLink: false
+
+features:
+ - icon: 🤖
+ title: Otimizado para IA
+ details: Formata seu código-fonte de uma maneira fácil para a IA entender e processar.
+
+ - icon: ⚙️
+ title: Consciente do Git
+ details: Respeita automaticamente seus arquivos .gitignore.
+
+ - icon: 🛡️
+ title: Focado na Segurança
+ details: Incorpora o Secretlint para verificações de segurança robustas para detectar e prevenir a inclusão de informações confidenciais.
+
+ - icon: 📊
+ title: Contagem de Tokens
+ details: Fornece contagens de tokens para cada arquivo e para todo o repositório, útil para limites de contexto de LLM.
+
+---
+
+
+
+## Início Rápido
+
+Depois de gerar um arquivo compactado (`repomix-output.txt`) usando o Repomix, você pode enviá-lo para um assistente de IA com um prompt como:
+
+```
+Este arquivo contém todos os arquivos do repositório combinados em um.
+Eu quero refatorar o código, então, por favor, revise-o primeiro.
+```
+
+A IA analisará todo o seu código-fonte e fornecerá insights abrangentes:
+
+
+
+Ao discutir mudanças específicas, a IA pode ajudar a gerar código. Com recursos como o Artifacts do Claude, você pode até receber vários arquivos interdependentes:
+
+
+
+Feliz codificação! 🚀
+
+## Guia do Usuário Avançado
+
+Para usuários avançados que precisam de mais controle, o Repomix oferece extensas opções de personalização através de sua interface CLI.
+
+### Início Rápido
+
+Você pode experimentar o Repomix instantaneamente no diretório do seu projeto sem instalação:
+
+```bash
+npx repomix
+```
+
+Ou instale globalmente para uso repetido:
+
+```bash
+# Instalar usando npm
+npm install -g repomix
+
+# Alternativamente usando yarn
+yarn global add repomix
+
+# Alternativamente usando Homebrew (macOS)
+brew install repomix
+
+# Então execute em qualquer diretório de projeto
+repomix
+```
+
+É isso! O Repomix irá gerar um arquivo `repomix-output.txt` no seu diretório atual, contendo todo o seu repositório em um formato amigável para IA.
+
+### Uso
+
+Para compactar todo o seu repositório:
+
+```bash
+repomix
+```
+
+Para compactar um diretório específico:
+
+```bash
+repomix path/to/directory
+```
+
+Para compactar arquivos ou diretórios específicos usando [glob patterns](https://github.com/mrmlnc/fast-glob?tab=readme-ov-file#pattern-syntax):
+
+```bash
+repomix --include "src/**/*.ts,**/*.md"
+```
+
+Para excluir arquivos ou diretórios específicos:
+
+```bash
+repomix --ignore "**/*.log,tmp/"
+```
+
+Para compactar um repositório remoto:
+```bash
+repomix --remote https://github.com/yamadashy/repomix
+
+# Você também pode usar o atalho do GitHub:
+repomix --remote yamadashy/repomix
+
+# Você pode especificar o nome do branch, tag ou hash do commit:
+repomix --remote https://github.com/yamadashy/repomix --remote-branch main
+
+# Ou usar um hash de commit específico:
+repomix --remote https://github.com/yamadashy/repomix --remote-branch 935b695
+```
+
+Para inicializar um novo arquivo de configuração (`repomix.config.json`):
+
+```bash
+repomix --init
+```
+
+Depois de gerar o arquivo compactado, você pode usá-lo com ferramentas de IA Generativa como Claude, ChatGPT e Gemini.
+
+#### Uso do Docker
+
+Você também pode executar o Repomix usando o Docker 🐳
+Isso é útil se você quiser executar o Repomix em um ambiente isolado ou preferir usar contêineres.
+
+Uso básico (diretório atual):
+
+```bash
+docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix
+```
+
+Para compactar um diretório específico:
+```bash
+docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix path/to/directory
+```
+
+Processar um repositório remoto e enviar para um diretório `output`:
+
+```bash
+docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix --remote https://github.com/yamadashy/repomix
+```
+
+### Formatos de Saída
+
+Escolha seu formato de saída preferido:
+
+```bash
+# Formato XML (padrão)
+repomix --style xml
+
+# Formato Markdown
+repomix --style markdown
+
+# Formato de texto simples
+repomix --style plain
+```
+
+### Customização
+
+Crie um `repomix.config.json` para configurações persistentes:
+
+```json
+{
+ "output": {
+ "style": "markdown",
+ "filePath": "custom-output.md",
+ "removeComments": true,
+ "showLineNumbers": true,
+ "topFilesLength": 10
+ },
+ "ignore": {
+ "customPatterns": ["*.test.ts", "docs/**"]
+ }
+}
+```
+
+### Mais Exemplos
+::: tip
+💡 Confira nosso [repositório GitHub](https://github.com/yamadashy/repomix) para documentação completa e mais exemplos!
+:::
+
+
diff --git a/website/client/src/zh-cn/guide/command-line-options.md b/website/client/src/zh-cn/guide/command-line-options.md
new file mode 100644
index 000000000..9b1e69ab9
--- /dev/null
+++ b/website/client/src/zh-cn/guide/command-line-options.md
@@ -0,0 +1,72 @@
+# 命令行选项
+
+## 基本选项
+
+```bash
+repomix [directory] # 处理指定目录（默认为当前目录 "."）
+```
+
+## 输出选项
+
+| 选项 | 说明 | 默认值 |
+|--------|-------------|---------|
+| `-o, --output ` | 输出文件名 | `repomix-output.txt` |
+| `--style ` | 输出格式（`plain`, `xml`, `markdown`） | `plain` |
+| `--output-show-line-numbers` | 添加行号 | `false` |
+| `--copy` | 复制到剪贴板 | `false` |
+| `--no-file-summary` | 禁用文件概要 | `true` |
+| `--no-directory-structure` | 禁用目录结构 | `true` |
+| `--remove-comments` | 移除注释 | `false` |
+| `--remove-empty-lines` | 移除空行 | `false` |
+
+## 过滤选项
+
+| 选项 | 说明 |
+|--------|-------------|
+| `--include ` | 包含模式（逗号分隔） |
+| `-i, --ignore ` | 忽略模式（逗号分隔） |
+
+## 远程仓库
+
+| 选项 | 说明 |
+|--------|-------------|
+| `--remote ` | 处理远程仓库 |
+| `--remote-branch ` | 指定分支/标签/提交 |
+
+## 配置
+
+| 选项 | 说明 |
+|--------|-------------|
+| `-c, --config ` | 自定义配置文件路径 |
+| `--init` | 创建配置文件 |
+| `--global` | 使用全局配置 |
+
+## 安全
+
+| 选项 | 说明 | 默认值 |
+|--------|-------------|---------|
+| `--no-security-check` | 禁用安全检查 | `true` |
+
+## 其他选项
+
+| 选项 | 说明 |
+|--------|-------------|
+| `-v, --version` | 显示版本 |
+| `--verbose` | 启用详细日志 |
+| `--top-files-len ` | 显示的顶部文件数量 | `5` |
+
+## 使用示例
+
+```bash
+# 基本用法
+repomix
+
+# 自定义输出
+repomix -o output.xml --style xml
+
+# 处理特定文件
+repomix --include "src/**/*.ts" --ignore "**/*.test.ts"
+
+# 远程仓库
+repomix --remote user/repo --remote-branch main
+```
diff --git a/website/client/src/zh-cn/guide/comment-removal.md b/website/client/src/zh-cn/guide/comment-removal.md
new file mode 100644
index 000000000..165ffe02f
--- /dev/null
+++ b/website/client/src/zh-cn/guide/comment-removal.md
@@ -0,0 +1,68 @@
+# 注释移除
+
+Repomix 可以在生成输出文件时自动移除代码中的注释。这有助于减少干扰，让代码更加简洁。
+
+## 使用方法
+
+要启用注释移除，在 `repomix.config.json` 中将 `removeComments` 选项设置为 `true`：
+
+```json
+{
+ "output": {
+ "removeComments": true
+ }
+}
+```
+
+## 支持的语言
+
+Repomix 支持移除多种编程语言的注释，包括：
+
+- JavaScript/TypeScript (`//`, `/* */`)
+- Python (`#`, `"""`, `'''`)
+- Java (`//`, `/* */`)
+- C/C++ (`//`, `/* */`)
+- HTML (``)
+- CSS (`/* */`)
+- 以及更多语言...
+
+## 示例
+
+以下是 JavaScript 代码示例：
+
+```javascript
+// 这是单行注释
+function test() {
+ /* 这是
+ 多行注释 */
+ return true;
+}
+```
+
+启用注释移除后，输出将变为：
+
+```javascript
+function test() {
+ return true;
+}
+```
+
+## 注意事项
+
+- 注释移除在其他处理步骤（如行号添加）之前执行
+- 某些注释，例如 JSDoc 注释，可能会根据语言和上下文保留
+- 如果你需要保留某些重要注释，请考虑使用其他方式记录这些信息，例如使用自定义指令
+
+## 建议用法
+
+1. **选择性使用**：
+ - 对于需要向 AI 展示实现细节的代码，保留注释
+ - 对于主要关注代码结构的分析，移除注释
+
+2. **配合其他功能**：
+ - 与 `--remove-empty-lines` 选项组合使用，获得更简洁的输出
+ - 使用自定义指令提供额外的上下文信息
+
+3. **性能考虑**：
+ - 移除注释可以减少输出文件大小
+ - 对于大型代码库特别有用
diff --git a/website/client/src/zh-cn/guide/configuration.md b/website/client/src/zh-cn/guide/configuration.md
new file mode 100644
index 000000000..e176832b5
--- /dev/null
+++ b/website/client/src/zh-cn/guide/configuration.md
@@ -0,0 +1,84 @@
+# 配置
+
+## 快速开始
+
+创建配置文件：
+```bash
+repomix --init
+```
+
+## 配置文件
+
+`repomix.config.json`：
+```json
+{
+ "output": {
+ "filePath": "repomix-output.xml",
+ "style": "xml",
+ "headerText": "自定义头部文本",
+ "instructionFilePath": "repomix-instruction.md",
+ "fileSummary": true,
+ "directoryStructure": true,
+ "removeComments": false,
+ "removeEmptyLines": false,
+ "topFilesLength": 5,
+ "showLineNumbers": false,
+ "copyToClipboard": false,
+ "includeEmptyDirectories": false
+ },
+ "include": ["**/*"],
+ "ignore": {
+ "useGitignore": true,
+ "useDefaultPatterns": true,
+ "customPatterns": ["tmp/", "*.log"]
+ },
+ "security": {
+ "enableSecurityCheck": true
+ }
+}
+```
+
+## 全局配置
+
+创建全局配置：
+```bash
+repomix --init --global
+```
+
+配置文件位置：
+- Windows: `%LOCALAPPDATA%\\Repomix\\repomix.config.json`
+- macOS/Linux: `~/.config/repomix/repomix.config.json`
+
+## 忽略模式
+
+优先级顺序：
+1. 命令行选项（`--ignore`）
+2. .repomixignore 文件
+3. .gitignore 文件
+4. 默认模式
+
+`.repomixignore` 示例：
+```text
+# 缓存目录
+.cache/
+tmp/
+
+# 构建输出
+dist/
+build/
+
+# 日志文件
+*.log
+```
+
+## 默认忽略模式
+
+内置的常用模式：
+```text
+node_modules/**
+.git/**
+coverage/**
+dist/**
+```
+
+完整列表：[defaultIgnore.ts](https://github.com/yamadashy/repomix/blob/main/src/config/defaultIgnore.ts)
diff --git a/website/client/src/zh-cn/guide/custom-instructions.md b/website/client/src/zh-cn/guide/custom-instructions.md
new file mode 100644
index 000000000..70b0b86c8
--- /dev/null
+++ b/website/client/src/zh-cn/guide/custom-instructions.md
@@ -0,0 +1,78 @@
+# 自定义指令
+
+Repomix 允许你提供自定义指令，这些指令将被包含在输出文件中。这对于为处理代码库的 AI 系统提供上下文或特定指导非常有用。
+
+## 使用方法
+
+要包含自定义指令，请在仓库根目录创建一个 markdown 文件（例如 `repomix-instruction.md`）。然后，在 `repomix.config.json` 中指定该文件的路径：
+
+```json
+{
+ "output": {
+ "instructionFilePath": "repomix-instruction.md"
+ }
+}
+```
+
+该文件的内容将在输出中的"Instruction"部分中显示。
+
+## 示例
+
+```markdown
+# 仓库指令
+
+这个仓库包含了 Repomix 工具的源代码。在分析代码时请遵循以下指导原则：
+
+1. 重点关注 `src/core` 目录中的核心功能
+2. 特别注意 `src/core/security` 中的安全检查
+3. 忽略 `tests` 目录中的文件
+
+## 代码规范
+- 遵循 TypeScript 最佳实践
+- 确保所有公共 API 都有适当的文档
+- 使用依赖注入模式以便于测试
+
+## 安全考虑
+- 确保所有用户输入都经过适当验证
+- 避免在日志中记录敏感信息
+- 使用安全的依赖版本
+```
+
+这将在输出中生成以下部分：
+
+```xml
+
+# 仓库指令
+
+这个仓库包含了 Repomix 工具的源代码。在分析代码时请遵循以下指导原则：
+
+1. 重点关注 `src/core` 目录中的核心功能
+2. 特别注意 `src/core/security` 中的安全检查
+3. 忽略 `tests` 目录中的文件
+
+## 代码规范
+- 遵循 TypeScript 最佳实践
+- 确保所有公共 API 都有适当的文档
+- 使用依赖注入模式以便于测试
+
+## 安全考虑
+- 确保所有用户输入都经过适当验证
+- 避免在日志中记录敏感信息
+- 使用安全的依赖版本
+
+```
+
+## 最佳实践
+
+1. **保持简洁明确**：指令应该简短但详细
+2. **提供具体示例**：在适当的情况下添加代码示例
+3. **设置优先级**：将最重要的指令放在前面
+4. **包含上下文**：提供项目背景和重要考虑因素
+5. **结构化内容**：使用标题和列表使指令易于阅读
+
+## 注意事项
+
+- 避免在指令中包含敏感信息
+- 定期更新指令以反映项目的变化
+- 确保指令与项目的其他文档保持一致
+- 使用清晰的层次结构组织内容
diff --git a/website/client/src/zh-cn/guide/development/index.md b/website/client/src/zh-cn/guide/development/index.md
new file mode 100644
index 000000000..189f793a7
--- /dev/null
+++ b/website/client/src/zh-cn/guide/development/index.md
@@ -0,0 +1,42 @@
+# 参与 Repomix 开发
+
+## 快速开始
+
+```bash
+git clone https://github.com/yamadashy/repomix.git
+cd repomix
+npm install
+```
+
+## 开发命令
+
+```bash
+# 运行 CLI
+npm run cli-run
+
+# 运行测试
+npm run test
+npm run test-coverage
+
+# 代码检查
+npm run lint
+```
+
+## 代码风格
+
+- 使用 [Biome](https://biomejs.dev/) 进行代码检查和格式化
+- 使用依赖注入以提高可测试性
+- 保持文件不超过 250 行
+- 为新功能添加测试用例
+
+## Pull Request 提交指南
+
+1. 运行所有测试
+2. 通过代码检查
+3. 更新文档
+4. 遵循现有代码风格
+
+## 需要帮助？
+
+- [提交 Issue](https://github.com/yamadashy/repomix/issues)
+- [加入 Discord](https://discord.gg/wNYzTwZFku)
diff --git a/website/client/src/zh-cn/guide/development/setup.md b/website/client/src/zh-cn/guide/development/setup.md
new file mode 100644
index 000000000..5a19ce927
--- /dev/null
+++ b/website/client/src/zh-cn/guide/development/setup.md
@@ -0,0 +1,74 @@
+# 开发环境搭建
+
+## 前提条件
+
+- Node.js ≥ 18.0.0
+- Git
+- npm
+
+## 本地开发
+
+```bash
+# 克隆仓库
+git clone https://github.com/yamadashy/repomix.git
+cd repomix
+
+# 安装依赖
+npm install
+
+# 运行 CLI
+npm run cli-run
+```
+
+## Docker 开发环境
+
+```bash
+# 构建镜像
+docker build -t repomix .
+
+# 运行容器
+docker run -v ./:/app -it --rm repomix
+```
+
+## 项目结构
+
+```
+src/
+├── cli/ # CLI 实现
+├── config/ # 配置处理
+├── core/ # 核心功能
+└── shared/ # 共享工具
+```
+
+## 测试
+
+```bash
+# 运行测试
+npm run test
+
+# 测试覆盖率
+npm run test-coverage
+
+# 代码检查
+npm run lint-biome
+npm run lint-ts
+npm run lint-secretlint
+```
+
+## 发布流程
+
+1. 更新版本
+```bash
+npm version patch # 或 minor/major
+```
+
+2. 运行测试和构建
+```bash
+npm run test-coverage
+npm run build
+```
+
+3. 发布
+```bash
+npm publish
+```
diff --git a/website/client/src/zh-cn/guide/index.md b/website/client/src/zh-cn/guide/index.md
new file mode 100644
index 000000000..fdbe49dbf
--- /dev/null
+++ b/website/client/src/zh-cn/guide/index.md
@@ -0,0 +1,60 @@
+# Repomix 入门指南
+
+Repomix 是一个将代码库打包成单个 AI 友好文件的工具。它专为帮助你将代码提供给大型语言模型（如 Claude、ChatGPT 和 Gemini）而设计。
+
+## 快速开始
+
+在你的项目目录中运行以下命令：
+
+```bash
+npx repomix
+```
+
+就这么简单！你会在当前目录中找到一个 `repomix-output.txt` 文件，其中包含了以 AI 友好格式整理的整个代码库。
+
+然后，你可以将此文件发送给 AI 助手，并附上类似这样的提示：
+
+```
+这个文件包含了仓库中所有文件的合并内容。
+我想重构代码，请先帮我审查一下。
+```
+
+AI 将分析你的整个代码库并提供全面的见解：
+
+
+
+在讨论具体修改时，AI 可以帮助生成代码。通过像 Claude 的 Artifacts 这样的功能，你甚至可以一次性接收多个相互依赖的文件：
+
+
+
+祝你编码愉快！🚀
+
+## 核心功能
+
+- **AI 优化**：以 AI 易于理解的格式整理代码库
+- **令牌计数**：为 LLM 上下文限制提供令牌使用统计
+- **Git 感知**：自动识别并遵循 .gitignore 文件
+- **注重安全**：使用 Secretlint 进行敏感信息检测
+- **多种输出格式**：可选纯文本、XML 或 Markdown 格式
+
+## 下一步
+
+- [安装指南](installation.md)：了解安装 Repomix 的不同方式
+- [使用指南](usage.md)：学习基本和高级功能
+- [配置](configuration.md)：根据需求自定义 Repomix
+- [安全功能](security.md)：了解安全检查详情
+
+## 社区
+
+加入我们的 [Discord 社区](https://discord.gg/wNYzTwZFku)：
+- 获取 Repomix 使用帮助
+- 分享你的使用经验
+- 提出新功能建议
+- 与其他用户交流
+
+## 支持
+
+发现问题或需要帮助？
+- [在 GitHub 上提交问题](https://github.com/yamadashy/repomix/issues)
+- 加入 Discord 服务器
+- 查看[文档](https://repomix.com)
diff --git a/website/client/src/zh-cn/guide/installation.md b/website/client/src/zh-cn/guide/installation.md
new file mode 100644
index 000000000..c45d31840
--- /dev/null
+++ b/website/client/src/zh-cn/guide/installation.md
@@ -0,0 +1,53 @@
+# 安装
+
+## 使用 npx（无需安装）
+
+```bash
+npx repomix
+```
+
+## 全局安装
+
+### npm 安装
+```bash
+npm install -g repomix
+```
+
+### Yarn 安装
+```bash
+yarn global add repomix
+```
+
+### Homebrew 安装（macOS）
+```bash
+brew install repomix
+```
+
+## Docker 安装
+
+使用 Docker 是最便捷的方式之一，可以避免环境配置问题。以下是具体步骤：
+
+```bash
+# 处理当前目录
+docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix
+
+# 处理指定目录
+docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix path/to/directory
+
+# 处理远程仓库
+docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix --remote yamadashy/repomix
+```
+
+## 系统要求
+
+- Node.js: ≥ 18.0.0
+- Git: 处理远程仓库时需要
+
+## 验证安装
+
+安装完成后，可以通过以下命令验证 Repomix 是否正常工作：
+
+```bash
+repomix --version
+repomix --help
+```
diff --git a/website/client/src/zh-cn/guide/output.md b/website/client/src/zh-cn/guide/output.md
new file mode 100644
index 000000000..53042e387
--- /dev/null
+++ b/website/client/src/zh-cn/guide/output.md
@@ -0,0 +1,121 @@
+# 输出格式
+
+Repomix 支持三种输出格式：
+- 纯文本（默认）
+- XML
+- Markdown
+
+## 纯文本格式
+
+```bash
+repomix --style plain
+```
+
+输出结构：
+```text
+本文件是整个代码库的合并表示形式...
+
+================
+文件概要
+================
+（元数据和 AI 指令）
+
+================
+目录结构
+================
+src/
+ index.ts
+ utils/
+ helper.ts
+
+================
+文件
+================
+
+================
+File: src/index.ts
+================
+// 文件内容
+```
+
+## XML 格式
+
+```bash
+repomix --style xml
+```
+
+XML 格式针对 AI 处理进行了优化：
+
+```xml
+本文件是整个代码库的合并表示形式...
+
+
+（元数据和 AI 指令）
+
+
+
+src/
+ index.ts
+ utils/
+ helper.ts
+
+
+
+
+// 文件内容
+
+
+```
+
+::: tip 为什么选择 XML？
+XML 标签有助于像 Claude 这样的 AI 模型更准确地解析内容。[Claude 官方文档](https://docs.anthropic.com/en/docs/build-with-claude/prompt-engineering/use-xml-tags)推荐使用 XML 标签来构建结构化提示。
+:::
+
+## Markdown 格式
+
+```bash
+repomix --style markdown
+```
+
+Markdown 提供了易读的格式：
+
+```markdown
+本文件是整个代码库的合并表示形式...
+
+# 文件概要
+（元数据和 AI 指令）
+
+# 目录结构
+```
+src/
+index.ts
+utils/
+helper.ts
+```
+
+# 文件
+
+## File: src/index.ts
+```typescript
+// 文件内容
+```
+```
+
+## 在 AI 模型中的使用
+
+每种格式都能在 AI 模型中正常工作，但需要考虑以下几点：
+- 对 Claude 使用 XML（解析最准确）
+- 对一般可读性使用 Markdown
+- 对简单性和通用兼容性使用纯文本
+
+## 自定义设置
+
+在 `repomix.config.json` 中设置默认格式：
+```json
+{
+ "output": {
+ "style": "xml",
+ "filePath": "output.xml"
+ }
+}
+```
diff --git a/website/client/src/zh-cn/guide/prompt-examples.md b/website/client/src/zh-cn/guide/prompt-examples.md
new file mode 100644
index 000000000..3243540ec
--- /dev/null
+++ b/website/client/src/zh-cn/guide/prompt-examples.md
@@ -0,0 +1,124 @@
+# 提示示例
+
+## 代码评审
+
+### 架构评审
+```
+分析此代码库的架构：
+1. 评估整体结构和模式
+2. 识别潜在的架构问题
+3. 提出改进可扩展性的建议
+4. 标注遵循最佳实践的部分
+
+重点关注可维护性和模块化。
+```
+
+### 安全性评审
+```
+对此代码库进行安全性评审：
+1. 识别潜在的安全漏洞
+2. 检查常见的安全反模式
+3. 评审错误处理和输入验证
+4. 评估依赖项的安全性
+
+请提供具体示例和修复步骤。
+```
+
+### 性能评审
+```
+从性能角度评审代码库：
+1. 识别性能瓶颈
+2. 检查资源使用情况
+3. 评审算法效率
+4. 评估缓存策略
+
+包含具体的优化建议。
+```
+
+## 文档生成
+
+### API 文档
+```
+生成全面的 API 文档：
+1. 列出并描述所有公共端点
+2. 记录请求/响应格式
+3. 包含使用示例
+4. 说明限制和约束
+```
+
+### 开发者指南
+```
+创建包含以下内容的开发者指南：
+1. 环境搭建说明
+2. 项目结构概览
+3. 开发工作流程
+4. 测试方法
+5. 常见问题排查步骤
+```
+
+### 架构文档
+```
+记录系统架构：
+1. 高层概述
+2. 组件交互
+3. 数据流程图
+4. 设计决策及理由
+5. 系统限制和约束
+```
+
+## 分析与改进
+
+### 依赖项分析
+```
+分析项目依赖：
+1. 识别过时的包
+2. 检查安全漏洞
+3. 建议替代包
+4. 评审依赖使用模式
+
+包含具体的升级建议。
+```
+
+### 测试覆盖率
+```
+评审测试覆盖率：
+1. 识别未测试的组件
+2. 建议额外的测试用例
+3. 评审测试质量
+4. 推荐测试策略
+```
+
+### 代码质量
+```
+评估代码质量并提出改进建议：
+1. 评审命名规范
+2. 检查代码组织
+3. 评估错误处理
+4. 评审注释实践
+
+提供具体的良好和问题模式示例。
+```
+
+## 获得更好结果的技巧
+
+1. **明确具体**：包含清晰的目标和评估标准
+2. **设置上下文**：说明你的角色和所需的专业水平
+3. **请求格式**：定义期望的响应结构
+4. **设置优先级**：指出哪些方面最重要
+
+## 模型特定说明
+
+### Claude
+- 使用 XML 输出格式
+- 将重要指令放在最后
+- 指定响应结构
+
+### ChatGPT
+- 使用 Markdown 格式
+- 将大型代码库分成小节
+- 包含系统角色提示
+
+### Gemini
+- 适用于所有格式
+- 每次请求专注于特定领域
+- 使用逐步分析
diff --git a/website/client/src/zh-cn/guide/remote-repository-processing.md b/website/client/src/zh-cn/guide/remote-repository-processing.md
new file mode 100644
index 000000000..1849513ba
--- /dev/null
+++ b/website/client/src/zh-cn/guide/remote-repository-processing.md
@@ -0,0 +1,68 @@
+# 远程仓库处理
+
+## 基本用法
+
+处理公共仓库：
+```bash
+# 使用完整 URL
+repomix --remote https://github.com/user/repo
+
+# 使用 GitHub 简写
+repomix --remote user/repo
+```
+
+## 分支和提交选择
+
+```bash
+# 指定分支
+repomix --remote user/repo --remote-branch main
+
+# 指定标签
+repomix --remote user/repo --remote-branch v1.0.0
+
+# 指定提交哈希
+repomix --remote user/repo --remote-branch 935b695
+```
+
+## 系统要求
+
+- 必须安装 Git
+- 需要网络连接
+- 需要仓库的读取权限
+
+## 输出控制
+
+```bash
+# 自定义输出位置
+repomix --remote user/repo -o custom-output.xml
+
+# 使用 XML 格式
+repomix --remote user/repo --style xml
+
+# 移除注释
+repomix --remote user/repo --remove-comments
+```
+
+## Docker 使用方法
+
+```bash
+# 在当前目录处理并输出
+docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix \
+ --remote user/repo
+
+# 输出到指定目录
+docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix \
+ --remote user/repo
+```
+
+## 常见问题
+
+### 访问问题
+- 确保仓库是公开的
+- 检查 Git 是否已安装
+- 验证网络连接
+
+### 大型仓库处理
+- 使用 `--include` 选择特定路径
+- 启用 `--remove-comments`
+- 分开处理不同分支
diff --git a/website/client/src/zh-cn/guide/security.md b/website/client/src/zh-cn/guide/security.md
new file mode 100644
index 000000000..16c461b2f
--- /dev/null
+++ b/website/client/src/zh-cn/guide/security.md
@@ -0,0 +1,65 @@
+# 安全性
+
+## 安全检查功能
+
+Repomix 使用 [Secretlint](https://github.com/secretlint/secretlint) 检测文件中的敏感信息：
+- API 密钥
+- 访问令牌
+- 认证凭证
+- 私钥
+- 环境变量
+
+## 配置
+
+安全检查默认启用。
+
+通过命令行禁用：
+```bash
+repomix --no-security-check
+```
+
+或在 `repomix.config.json` 中配置：
+```json
+{
+ "security": {
+ "enableSecurityCheck": false
+ }
+}
+```
+
+## 安全措施
+
+1. **二进制文件排除**：输出中不包含二进制文件
+2. **Git 感知**：遵循 `.gitignore` 模式
+3. **自动检测**：扫描常见安全问题：
+ - AWS 凭证
+ - 数据库连接字符串
+ - 认证令牌
+ - 私钥
+
+## 安全检查发现问题时
+
+输出示例：
+```bash
+🔍 Security Check:
+──────────────────
+2 suspicious file(s) detected and excluded:
+1. config/credentials.json
+ - Found AWS access key
+2. .env.local
+ - Found database password
+```
+
+## 最佳实践
+
+1. 分享前务必检查输出内容
+2. 使用 `.repomixignore` 排除敏感路径
+3. 保持安全检查功能启用
+4. 从仓库中移除敏感文件
+
+## 报告安全问题
+
+如果发现安全漏洞，请：
+1. 不要创建公开的 Issue
+2. 发送邮件至：koukun0120@gmail.com
+3. 或使用 [GitHub 安全公告](https://github.com/yamadashy/repomix/security/advisories/new)
diff --git a/website/client/src/zh-cn/guide/tips/best-practices.md b/website/client/src/zh-cn/guide/tips/best-practices.md
new file mode 100644
index 000000000..fedf45ca5
--- /dev/null
+++ b/website/client/src/zh-cn/guide/tips/best-practices.md
@@ -0,0 +1,37 @@
+# AI 辅助开发最佳实践：从实践经验谈起
+
+虽然我还没有完成一个大型的 AI 辅助开发项目，但我想分享一下到目前为止从与 AI 合作开发中学到的经验。
+
+## 基本开发方法
+
+在与 AI 合作时，试图一次性实现所有功能可能会导致意外问题和项目停滞。因此，从核心功能开始，一步一步稳扎稳打地构建每个功能是更有效的方法。
+
+### 现有代码的重要性
+
+这种方法之所以有效，是因为通过核心功能的实现，你可以将你理想中的设计和编码风格具体化为实际代码。向 AI 传达项目愿景的最有效方式就是通过反映你的标准和偏好的代码本身。
+
+从核心功能开始，确保每个功能在进入下一个功能之前都能正常工作，这样整个项目就能保持一致性，使 AI 更容易生成更合适的代码。
+
+## 模块化方法
+
+将代码分解成更小的模块至关重要。根据经验，将文件限制在 250 行左右的代码使得向 AI 提供清晰的指示更容易，并使试错过程更有效。虽然令牌计数会是更准确的指标，但对人类开发者来说，行数更容易判断，所以我们使用行数作为参考。
+
+这不仅仅是关于前端、后端和数据库等大单元的分离，而是关于更精细层面的功能划分。例如，在一个功能内部，也要将验证、错误处理等具体功能分离成独立模块。
+
+当然，大单元的分离也很重要，逐步实施模块化方法不仅让指令更清晰，也让 AI 能生成更合适的代码。这种方法不仅对 AI，对人类开发者来说也是有效的。
+
+## 通过测试确保质量
+
+我认为测试在 AI 辅助开发中尤为重要。测试不仅作为质量保证手段，还作为清晰展示代码意图的文档。当要求 AI 实现新功能时，现有的测试代码有效地充当了规范文档。
+
+测试也是验证 AI 生成代码正确性的绝佳工具。例如，当让 AI 为某个模块实现新功能时，预先编写测试用例可以客观评估生成的代码是否符合预期。这与测试驱动开发（TDD）的理念高度契合，在与 AI 协作时特别有效。
+
+## 规划与实现的平衡
+
+在实现大规模功能之前，建议先与 AI 讨论计划。整理需求并考虑架构可以使后续实现更顺畅。先整理需求，然后在新的对话中进行实现是个好方法。
+
+此外，AI 的输出必须经过人工审查，并在必要时进行调整。虽然 AI 输出的质量通常处于中等水平，但与从头开始编写代码相比，仍然可以提高开发速度。
+
+## 结语
+
+通过实践这些方法，你可以充分发挥 AI 的优势，同时构建一个连贯的、高质量的代码库。即使项目规模增长，每个部分都能保持清晰定义和易于管理的状态。
diff --git a/website/client/src/zh-cn/guide/usage.md b/website/client/src/zh-cn/guide/usage.md
new file mode 100644
index 000000000..13dba1063
--- /dev/null
+++ b/website/client/src/zh-cn/guide/usage.md
@@ -0,0 +1,87 @@
+# 基本用法
+
+## 快速开始
+
+打包整个仓库：
+```bash
+repomix
+```
+
+## 常见使用场景
+
+### 打包指定目录
+```bash
+repomix path/to/directory
+```
+
+### 包含特定文件
+使用 [glob 模式](https://github.com/mrmlnc/fast-glob?tab=readme-ov-file#pattern-syntax)：
+```bash
+repomix --include "src/**/*.ts,**/*.md"
+```
+
+### 排除文件
+```bash
+repomix --ignore "**/*.log,tmp/"
+```
+
+### 处理远程仓库
+```bash
+# 使用 GitHub URL
+repomix --remote https://github.com/user/repo
+
+# 使用简写形式
+repomix --remote user/repo
+
+# 指定分支/标签/提交
+repomix --remote user/repo --remote-branch main
+repomix --remote user/repo --remote-branch 935b695
+```
+
+## 输出格式
+
+### 纯文本（默认）
+```bash
+repomix --style plain
+```
+
+### XML
+```bash
+repomix --style xml
+```
+
+### Markdown
+```bash
+repomix --style markdown
+```
+
+## 其他选项
+
+### 移除注释
+```bash
+repomix --remove-comments
+```
+
+### 显示行号
+```bash
+repomix --output-show-line-numbers
+```
+
+### 复制到剪贴板
+```bash
+repomix --copy
+```
+
+### 禁用安全检查
+```bash
+repomix --no-security-check
+```
+
+## 配置
+
+初始化配置文件：
+```bash
+repomix --init
+```
+
+更多详细配置选项请参阅[配置指南](/zh-cn/guide/configuration)。
diff --git a/website/client/src/zh-cn/index.md b/website/client/src/zh-cn/index.md
new file mode 100644
index 000000000..9bdb56572
--- /dev/null
+++ b/website/client/src/zh-cn/index.md
@@ -0,0 +1,191 @@
+---
+layout: home
+title: Repomix
+titleTemplate: 将代码库打包成AI友好的格式
+aside: false
+editLink: false
+
+features:
+ - icon: 🤖
+ title: AI 优化
+ details: 以 AI 易于理解和处理的方式格式化代码库。
+
+ - icon: ⚙️
+ title: Git 感知
+ details: 自动识别并尊重您的 .gitignore 文件。
+
+ - icon: 🛡️
+ title: 注重安全
+ details: 集成 Secretlint 进行强大的安全检查，检测并防止敏感信息的泄露。
+
+ - icon: 📊
+ title: 令牌计数
+ details: 提供每个文件和整个代码库的令牌计数，便于控制 LLM 上下文限制。
+
+---
+
+
+
+## 快速开始
+
+使用 Repomix 生成打包文件（`repomix-output.txt`）后，您可以将其发送给 AI 助手，并附上这样的提示：
+
+```
+此文件包含了仓库中所有文件的合并内容。
+我想重构代码，请先帮我审查一下。
+```
+
+AI 将分析您的整个代码库并提供全面的见解：
+
+
+
+在讨论具体修改时，AI 可以帮助生成代码。通过像 Claude 的 Artifacts 这样的功能，您甚至可以一次性接收多个相互依赖的文件：
+
+
+
+祝您编码愉快！🚀
+
+
+
+## 进阶使用指南
+
+对于需要更多控制的高级用户，Repomix 通过其 CLI 界面提供了广泛的自定义选项。
+
+### 快速上手
+
+您可以在项目目录中无需安装即可立即尝试 Repomix：
+
+```bash
+npx repomix
+```
+
+或者全局安装以便重复使用：
+
+```bash
+# 使用 npm 安装
+npm install -g repomix
+
+# 或使用 yarn 安装
+yarn global add repomix
+
+# 或使用 Homebrew 安装（macOS）
+brew install repomix
+
+# 然后在任意项目目录中运行
+repomix
+```
+
+就是这么简单！Repomix 将在您的当前目录中生成一个 `repomix-output.txt` 文件，其中包含了以 AI 友好格式整理的整个代码库。
+
+
+
+### 基本用法
+
+打包整个代码库：
+
+```bash
+repomix
+```
+
+打包特定目录：
+
+```bash
+repomix path/to/directory
+```
+
+使用 [glob 模式](https://github.com/mrmlnc/fast-glob?tab=readme-ov-file#pattern-syntax)打包特定文件：
+
+```bash
+repomix --include "src/**/*.ts,**/*.md"
+```
+
+排除特定文件：
+
+```bash
+repomix --ignore "**/*.log,tmp/"
+```
+
+处理远程仓库：
+```bash
+repomix --remote https://github.com/yamadashy/repomix
+
+# 也可以使用 GitHub 简写形式：
+repomix --remote yamadashy/repomix
+
+# 可以指定分支名称、标签或提交哈希：
+repomix --remote https://github.com/yamadashy/repomix --remote-branch main
+
+# 或使用特定的提交哈希：
+repomix --remote https://github.com/yamadashy/repomix --remote-branch 935b695
+```
+
+初始化配置文件（`repomix.config.json`）：
+
+```bash
+repomix --init
+```
+
+生成打包文件后，您可以将其用于 Claude、ChatGPT、Gemini 等生成式 AI 工具。
+
+#### Docker 使用方法
+
+您也可以使用 Docker 运行 Repomix 🐳
+如果您想在隔离环境中运行 Repomix 或更偏好使用容器，这是一个很好的选择。
+
+基本用法（当前目录）：
+
+```bash
+docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix
+```
+
+打包特定目录：
+```bash
+docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix path/to/directory
+```
+
+处理远程仓库并输出到 `output` 目录：
+
+```bash
+docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix --remote https://github.com/yamadashy/repomix
+```
+
+### 输出格式
+
+选择您偏好的输出格式：
+
+```bash
+# XML 格式（默认）
+repomix --style xml
+
+# Markdown 格式
+repomix --style markdown
+
+# 纯文本格式
+repomix --style plain
+```
+
+### 自定义设置
+
+创建 `repomix.config.json` 进行持久化设置：
+
+```json
+{
+ "output": {
+ "style": "markdown",
+ "filePath": "custom-output.md",
+ "removeComments": true,
+ "showLineNumbers": true,
+ "topFilesLength": 10
+ },
+ "ignore": {
+ "customPatterns": ["*.test.ts", "docs/**"]
+ }
+}
+```
+
+### 更多示例
+::: tip
+💡 查看我们的 [GitHub 仓库](https://github.com/yamadashy/repomix)获取完整文档和更多示例！
+:::
+
+
diff --git a/website/client/tsconfig.json b/website/client/tsconfig.json
index 581f49f63..fc72973a9 100644
--- a/website/client/tsconfig.json
+++ b/website/client/tsconfig.json
@@ -17,10 +17,5 @@
"types": ["vite/client", "vitepress/client"]
},
"include": [".vitepress/**/*.ts", ".vitepress/**/*.d.ts", ".vitepress/**/*.tsx", ".vitepress/**/*.vue"],
- "exclude": ["node_modules", "dist"],
- "references": [
- {
- "path": "./tsconfig.node.json"
- }
- ]
+ "exclude": ["node_modules", "dist"]
}
diff --git a/website/client/tsconfig.node.json b/website/client/tsconfig.node.json
index 6e3a2242f..42d7357e8 100644
--- a/website/client/tsconfig.node.json
+++ b/website/client/tsconfig.node.json
@@ -6,5 +6,5 @@
"moduleResolution": "bundler",
"allowSyntheticDefaultImports": true
},
- "include": [".vitepress/config.ts"]
+ "include": [".vitepress/config.ts", ".vitepress/config/**/*", ".vitepress/theme/**/*"]
}