KitchenSink4Word
Tudo, inclusive a pia da cozinha, para o Microsoft Word: 170 ferramentas, incluindo edição ao vivo de documentos abertos, tabelas com reconhecimento de mesclagem, citações, notas de rodapé, sumário, escrita com controle de alterações, mala direta, redação e conversão de estilo de publicação.
Documentação
🚰 KitchenSink4Word Community Edition
Página inicial · llms.txt (manifesto de capacidades legível por máquina para agentes e rastreadores de LLM)
Edite documentos do Word com seu assistente de IA: alterações controladas, citações, modelos e edições ao vivo no Word.
Edite documentos reais do Word a partir do Claude Code, Codex CLI, Copilot CLI ou qualquer outro cliente MCP que execute ferramentas locais. O KitchenSink4Word conecta seu assistente a arquivos .docx no Windows e pode editar um documento enquanto ele está aberto no Microsoft Word, para que você veja as alterações chegarem. Os arquivos são processados no seu computador; a única coisa que sai dele é o que seu aplicativo de IA envia ao próprio provedor. A edição Community é gratuita sob a AGPL. A edição Business adiciona um instalador para Windows, um canal de atualização assinado, uma licença que sua empresa pode aprovar e suporte.
Funciona em: Windows. A edição de arquivos funciona sem o Microsoft Word; a edição ao vivo e os recursos baseados no Word precisam do Word instalado.
Instalação
Escolha o caminho para seu aplicativo de IA. Os comandos vão no PowerShell no Windows ou em um terminal no macOS e Linux, não em um chat de IA. Os caminhos de pacote precisam de Python 3.12 ou mais recente.
Claude Desktop
Instale o uv, depois saia e reabra o Claude Desktop. Baixe o arquivo .mcpb de KitchenSink4Word releases. No Claude Desktop, abra Configurações, depois Extensões, depois Configurações avançadas, depois Instalar extensão e escolha o arquivo. O pacote busca o pacote Python na primeira inicialização, então o primeiro lançamento precisa de conexão com a rede. Reinicie sua sessão e verifique se as ferramentas aparecem como conectadas.
Claude Code ou Codex CLI
Instale o uv e execute a linha para seu aplicativo e reinicie a sessão:
claude mcp add word -s user -- uvx kitchensink4word
codex mcp add word -- uvx kitchensink4word
Qualquer outro cliente MCP local
Use uvx como comando e kitchensink4word como argumento, ou instale o pacote e use kitchensink4word como comando do servidor:
pip install kitchensink4word
Depois siga o guia do seu cliente para adicionar um servidor MCP local. Instalar o pacote por conta própria não o conecta a um aplicativo de IA.
Edição Business
Compare as edições na página de preços. Já comprou? Seu instalador para Windows e link de download estão no seu portal de licenças.
O que ele pode fazer
110 ferramentas de documento, além dos controles de ativar/desativar pacotes.
- Revisar um relatório enquanto ele permanece aberto no Word, com edições que você pode acompanhar.
- Ler, aceitar e rejeitar alterações controladas e trabalhar nos comentários dos revisores.
- Preencher um modelo ou montar capítulos em um único manuscrito.
- Construir e formatar tabelas, listas, cabeçalhos e layouts de página.
- Inserir citações, bibliografias, notas de rodapé e referências cruzadas.
- Encontrar problemas de formatação, acessibilidade e estrutura antes da entrega.
- Comparar documentos, preparar mala direta e redigir texto selecionado.
- Importar ou exportar PDF pelo Word quando ele estiver instalado.
O que está disponível depende dos pacotes que você ativa e dos aplicativos instalados. A referência completa das ferramentas está abaixo.
Edição Business
Precisa de uma licença que sua empresa possa aprovar e uma configuração que alguém suporte? A edição Business combina essas ferramentas com um instalador para Windows, um canal de atualização assinado e suporte sob os termos Business. As verificações de atualização informam quando uma versão coberta está disponível; nada é instalado por conta própria. Compare as opções na página de preços. A edição Community permanece gratuita sob a AGPL, incluindo uso comercial que atenda aos seus termos.
Política de Privacidade
As ferramentas rodam no seu computador, e o KitchenSink4AI não recebe documentos nem dados de uso delas. Seu aplicativo de IA pode enviar prompts, conteúdos de arquivos e resultados de ferramentas ao próprio provedor sob as configurações e termos desse aplicativo. A instalação baixa pacotes, e a verificação de versão da Community entra em contato com o PyPI, a menos que você a desative; essas solicitações carregam detalhes de conexão, como seu endereço de rede, e nunca seus documentos. Pastas em nuvem e backups seguem suas próprias configurações. A Política de Privacidade cobre o produto, compras e registros de suporte.
Não afiliado, endossado ou patrocinado pela Microsoft Corporation. Microsoft e Word são marcas registradas do grupo de empresas Microsoft.
O que as 222 operações cobrem
O núcleo do dia a dia cobre texto e formatação, tabelas (incluindo inserção/exclusão de colunas ciente de mesclagem e edições em massa de células em uma única chamada), notas de rodapé e notas de fim (ciclo de vida completo, além de conversão entre notas de rodapé e notas de fim), sumário e listas de legendas, cabeçalhos, rodapés e seções, imagens, listas com marcadores e numeradas, controles de conteúdo e campos, comentários em thread e alterações controladas (ler, aceitar e rejeitar por autor, e escrever edições como alterações controladas). Além disso, a superfície abrange equações (LaTeX para matemática do Word), gráficos nativos, montagem de documentos (arquivos de capítulo em um único manuscrito), citações da biblioteca Zotero, conversão de estilo de publicação (8 estilos, beta), análises de ciclo de revisão, suítes de fluxo de trabalho (mala direta, operações em lote, redação, auditorias e correções de conformidade e acessibilidade, preparação de submissão, matéria de abertura, diagnósticos) e comparação de documentos com suporte do Word-COM, atualização de campos, exportação e importação de PDF e validação de abertura limpa no Windows.
O que o torna diferente
- Operações de coluna em tabelas cientes de mesclagem.
modify_table_structureinsere e exclui colunas corretamente através de células mescladas horizontal e verticalmente (gridSpan encolhe, cadeias vMerge re-enraízam). No momento em que este texto foi escrito, nenhum outro MCP público de Word tem isso. - API em massa primeiro. Editar 20 células é UMA chamada
set_cellscom um payload, não 20 idas e voltas. - Escrita de alterações controladas.
track=True, author="Jane"nas ferramentas de edição produz revisões reais do Word que o destinatário pode aceitar ou rejeitar, comprovadas em ida e volta contra o próprio mecanismo de revisão do servidor. - Comparação de documentos.
com_multi_document(action="compare")produz uma marcação de revisão nativa do Word entre duas versões de um documento. - Nunca corrompe. Salvamentos atômicos (arquivo temporário, validação estrutural, substituição), backups automáticos de slot antes de cada mutação, passagem byte a byte idêntica de qualquer coisa que não esteja sendo editada (equações, caixas de texto, controles de conteúdo sobrevivem intactos) e erros tipados limpos: um arquivo aberto no Word é recusado com uma mensagem, não um travamento.
- Seguro para execuções fragmentadas. Localizar e substituir funciona através das execuções arbitrariamente divididas do Word, preservando a formatação por caractere, com um guarda de timeout ReDoS em regex do usuário e um limite opcional de raio de explosão.
Por que este (a comparação de capacidades)
Todos os servidores MCP públicos de Word foram pesquisados antes de construir este. A comparação honesta é sobre o que cada um pode fazer, não quantos nomes tem:
| Capacidade | KitchenSink4Word | GongRzhe Office-Word (2.1k★, arquivado) | word-mcp-live (195★) | SecurityRonin docx-mcp (43★) |
|---|---|---|---|---|
| Carregamento de contexto em camadas (núcleo leve, pacotes sob demanda) | ✅ de ~10,2k tokens | ❌ | ❌ | ❌ |
| Edição ao vivo enquanto o documento está aberto no Word | ✅ seguro para cursor, um Ctrl+Z por chamada | ❌ | ✅ | ❌ |
| Inserção/exclusão de colunas em tabelas | ✅ ciente de mesclagem | ❌ | ❌ | ❌ |
| Edições em massa de células (uma chamada) | ✅ | ❌ | ❌ | ❌ |
| Mesclar/desmesclar células | ✅ | apenas mesclar | ❌ | ❌ |
| CRUD de notas de rodapé E notas de fim | ✅ + conversão | apenas adicionar | ❌ | ✅ |
| Inserir + atualizar sumário | ✅ | ❌ | ❌ | ❌ |
| Citações/bibliografia nativas | ✅ 12 estilos | ❌ | ❌ | ❌ |
| Geração de índice | ✅ | ❌ | ❌ | ❌ |
| ESCRITA de alterações controladas | ✅ | ❌ | ✅ | ✅ |
| Aceitar/rejeitar por autor | ✅ | ❌ | parcial | ✅ |
| Comparar + combinar documentos | ✅ nativo do Word | ❌ | ❌ | com bugs |
| Marcas d'água / proteção / números de linha | ✅ | apenas proteção | ❌ | ❌ |
| Mover seções / transferir modelos | ✅ | ❌ | ❌ | ❌ |
| Salvamentos atômicos + backup automático | ✅ | ❌ | ❌ | ❌ |
Pesquisa de capacidades compilada de repositórios públicos, documentação e rastreadores de problemas. Correções são bem-vindas: abra um problema.
Os pacotes
Os números abaixo vêm direto de scripts/measure_surface.py, nunca
contados à mão, e cada um conta a entrada inteira de tools/list que um cliente
recebe, em vez de apenas a descrição e o esquema. O núcleo leve carrega na
inicialização; os sete pacotes carregam sob demanda.
| Pacote | Ferramentas | Aprox. tokens | O que carrega |
|---|---|---|---|
| lite (inicialização) | 29 | ~10,2k | Leitura e edição do dia a dia: texto, parágrafos, tabelas, células, listas, localizar e substituir, estrutura de tópicos, visualização de documento, backups, guia de fluxo de trabalho, informações do servidor, alternâncias de pacotes |
| references | 8 | ~2,9k | Citações e bibliografia nativas do Word, pesquisa e citação no Zotero, verificações de paridade, conversão e detecção de estilo |
| review | 9 | ~2,4k | Alterações controladas (ler, aceitar/rejeitar, relatórios), comentários em thread, diff estruturado, anonimizar e desanonimizar |
| academic | 24 | ~7,6k | Notas de rodapé e notas de fim, sumário, índice, legendas, referências cruzadas, matéria de abertura, cabeçalhos de capítulo, seções, estilos, numeração de listas, contagens de palavras, baterias de validação, preparação de submissão, acessibilidade |
| assembly | 7 | ~2,1k | Inserir e dividir documentos, mover seções, copiar tabelas entre arquivos, aplicar e preencher modelos, mala direta |
| media-forms | 16 | ~5,6k | Imagens, gráficos, equações, caixas de texto, hiperlinks, estrutura e estilo de tabelas, campos de formulário, controles de conteúdo, códigos de campo |
| com-live | 13 | ~3,1k | Controla um Microsoft Word local: importação/exportação de PDF, comparar e combinar, revisão, legibilidade, atualização de campos, edição ao vivo de documentos abertos |
| protection-io | 6 | ~1,6k | Proteção de documentos, marcas d'água, redação com verificação, importação e exportação de dados de tabelas |
| Superfície completa | 112 | ~35,5k | Tudo (110 ferramentas de documento mais enable_tools / disable_tools) |
Início rápido: comece com lite, ative o que precisar
Uma sessão começa com o núcleo lite. Quando uma tarefa precisar de mais, o agente ativa o pacote pelo nome:
enable_tools(["references"]) # citations, bibliography, Zotero
enable_tools(["academic", "review"]) # notes, TOC, tracked changes, comments
Recusas de ferramentas lite nomeiam o pacote e a chamada exata de enable_tools a executar, e
as receitas de get_workflows nomeiam os pacotes que cada fluxo de trabalho precisa, então a descoberta é
integrada. Para pular a hierarquia completamente, inicie o servidor com KS4W_MODE=full e
todas as ferramentas estarão presentes desde a primeira chamada.
Instalado a partir do pacote .mcpb, as mesmas duas escolhas são caixas de seleção nas
configurações do Claude Desktop do servidor: "Carregar todas as ferramentas na inicialização" e "Bloquear o
conjunto de ferramentas na inicialização" (que fixa a superfície para que enable_tools recuse).
Elas escrevem KS4W_ALL_TOOLS e KS4W_LOCK_TOOLS. Ambas aceitam true ou
false, tratam vazio como desligado e recusam iniciar em qualquer outra coisa em vez de
adivinhar. KS4W_MODE supera a primeira e KS4W_PACK_POLICY supera a segunda
sempre que definidas, então uma lista de pacotes fixada sobrevive a uma instalação, e o
servidor escreve uma linha no stderr na inicialização nomeando o que decidiu a superfície.
Uma dica que remove a maioria dos pop-ups de permissão: Nas permissões de ferramentas do Claude Desktop para este servidor, defina o grupo de ferramentas somente leitura como Sempre permitir. Essas ferramentas não podem mudar nada, então aprová-las uma vez é seguro, e o Claude para de perguntar sobre cada leitura. Deixe as ferramentas de ação em Perguntar, para que qualquer coisa que mude coisas ainda verifique com você primeiro.
Uma ressalva do lado do cliente: alguns clientes MCP descartam o esquema de uma ferramenta quando um pacote é
desativado e não o recuperam ao reativar, mesmo que o servidor envie
tools/list_changed nos dois sentidos (observado no Claude Code, 2026-09). Se uma
ferramenta reativada voltar como "ferramenta inexistente", atualize a lista de ferramentas no
lado do cliente (no Claude Code, uma chamada de ToolSearch para a ferramenta recarrega seu
esquema).
Dois números que importam
- 222 operações de documentos, 110 ferramentas. A contagem de operações aumentou e a
contagem de ferramentas diminuiu de propósito. O v1 espalhava tarefas semelhantes por muitos
nomes concorrentes; o v2 dá a cada conceito exatamente um nome construído a partir de uma pequena
tabela de verbos (
insert_,set_,manage_,list_elements,validate,delete_element), para que um agente escolha a ferramenta certa na primeira vez e carregue menos esquema para fazer isso. Menos ferramentas, mais alcance. Medido com uma régua em ambas as árvores, o v1.6 executou 200 operações em suas 189 ferramentas e o v2.0 executa 222 em 110: toda capacidade do v1.6 sobreviveu à consolidação (o mapa de migração cobre todas as 189, protegido por testes) e o v2 adiciona o editor de lote ancorado, a visualização de documento ancorada, paridade de exclusão e despacho mais amplo nos multiplexadores. Ambos os números vêm descripts/count_operations.py; a execução do v1.6 éscripts/count_operations_v16.py, que mede um checkout do v1.6 com a mesma definição. - Carregamento em camadas: começa com cerca de 10,2 mil tokens, escala para tudo. Uma
sessão nova carrega o núcleo leve de 29 ferramentas (cerca de 10.200 tokens) e ativa
pacotes de capacidade somente quando uma tarefa precisa deles, com uma chamada de
enable_tools. Carregue todos os pacotes e a superfície completa mede cerca de 35.500 tokens, então uma sessão que nunca sai do modo leve carrega aproximadamente um quarto de todo o sink. (Todos os números são medidos por script e contam o que o cliente realmente recebe; veja Custo de contexto abaixo.)
Custo de contexto (medido)
Quase nenhum servidor MCP informa quanto custa para carregar. Aqui está a conta, de
scripts/measure_surface.py:
- Início leve: 29 ferramentas, cerca de 10.200 tokens, carregadas quando a sessão abre.
- Superfície completa: 112 ferramentas (110 ferramentas de documento mais os dois alternadores de pacote), cerca de 35.500 tokens com todos os pacotes habilitados.
- Clientes que adiam esquemas de ferramentas até o primeiro uso (por exemplo, Claude Code) pagam quase zero até que uma ferramenta seja realmente chamada.
Ambos os números contam a entrada inteira de tools/list que o cliente recebe: nome,
título, descrição, esquemas de entrada e saída, anotações e metadados. O
estimador usado para somar apenas descrição e esquema de entrada, o que publicava um
número cerca de um quarto abaixo do que atravessa o fio, e um servidor cuja proposta
é informar o que custa não pode publicar o subconjunto lisonjeiro.
A comparação com o v1.6 que esta seção costumava carregar foi feita com essa
régua mais antiga, então ela foi removida em vez de reformulada: nenhuma medição do v1.6
existe nesta régua.
Modelo de segurança
- Toda ferramenta de mutação recebe
file_pathe gira o conteúdo atual para slots de backup estáveis antes da alteração (backup=Falsepara pular a rotação; a validação atômica de salvamento sempre se aplica). Os backups ficam em uma pasta oculta.ks4w-backups/ao lado do documento, uma subpasta por documento, com exatamente dois slots:prev.docx(estado antes da mutação mais recente) eanchor.docx(início da sessão, girando após 60+ minutos de inatividade). O armazenamento permanece limitado a aproximadamente duas cópias por documento, não importa quantas edições uma sessão faça.manage_backupslista, restaura (de forma desfazível: o estado pré-restauração gira paraprevprimeiro) e remove-os, incluindo arquivos*.bak-*restantes de esquemas anteriores. - Exclua
.ks4w-backups/das ferramentas de sincronização em nuvem (OneDrive, Dropbox, Google Drive): os slots mudam a cada edição e os clientes de sincronização podem manter bloqueios que retardam os salvamentos. - Mutações do mesmo arquivo são serializadas (no processo e entre processos de servidor via um arquivo de bloqueio consultivo), então chamadas paralelas não podem se sobrescrever e os metadados de resposta refletem o estado estabelecido do documento.
- Mutações COM/ao vivo (documentos abertos no Word) permanecem fora deste sistema de backup; a Recuperação Automática do próprio Word cobre o documento aberto.
- Salvamentos são atômicos e validados; uma operação falha deixa o original byte-idêntico.
- Excluir conteúdo que carrega referências de nota de rodapé remove automaticamente as
definições agora órfãs;
validaterelata integridade em ambas as direções. - A exclusão de parágrafos recusa intervalos que cortariam um campo (TOC, PAGEREF) ao meio ou engoliriam silenciosamente uma quebra de seção.
Verificação de atualização (opt-out)
| Variável | Efeito |
|---|---|
KS4W_UPDATE_CHECK | off desativa completamente a verificação de atualização: sem chamada de rede, sem arquivo de cache (o KS4W_NO_UPDATE_CHECK=1 mais antigo ainda funciona) |
Verificação de atualização. O servidor procura uma versão mais recente no PyPI somente quando você
chama get_server_info, nunca na inicialização e nunca em um temporizador, no máximo uma
solicitação a cada sete dias, limitada a dois segundos. A verificação é um único GET HTTPS simples
para pypi.org que envia nada além da própria solicitação. Uma verificação falha é
relatada com seu motivo em vez de oculta. Defina KS4W_UPDATE_CHECK=off para desativá-la
completamente (o KS4W_NO_UPDATE_CHECK=1 mais antigo ainda funciona). O servidor nunca
baixa ou instala nada.
Sandboxing (opt-in)
Desativado por padrão: com nada configurado, o servidor se comporta exatamente como
sempre. Defina a variável de ambiente KS4W_ALLOWED_ROOTS para uma lista de
diretórios separados pelo separador de caminho do SO (; no Windows, :
em outros lugares), por exemplo %USERPROFILE%\Documents;D:\Work, e todo caminho que o
servidor toca deve resolver dentro de um desses diretórios. Leituras são controladas
tanto quanto escritas, já que uma leitura fora do sandbox exfiltra conteúdo tão
certamente quanto uma escrita o planta. A verificação de contenção é executada em caminhos
canonicalizados, então travessia ..\, escapes de symlink e junction, nomes curtos 8.3,
prefixos de comprimento estendido, truques de maiúsculas/minúsculas e diretórios irmãos semelhantes
(Documents2 contra um Documents permitido) são todos capturados, e caminhos de rede UNC
são recusados a menos que uma raiz permitida seja ela própria um caminho UNC que os contenha.
Uma chamada bloqueada recusa com um erro tipado nomeando o caminho ofensor e
as raízes permitidas antes que qualquer arquivo seja aberto. Recomendado sempre que o servidor
opera contra tráfego de agente não confiável ou semiconfiável.
Testes
2.189 testes (2.094 executados em todos os lugares; 95 testes marcados como ao vivo dirigem uma instância real do Word
no Windows): a suíte foi desenvolvida contra um corpus privado de
documentos do mundo real (capítulos do tamanho de livros, um documento com 171 notas de rodapé, um
manuscrito com 126 alterações rastreadas e comentários de revisores), e o CI
gera automaticamente substitutos sintéticos estruturalmente equivalentes
(tests/make_corpus.py) para que a suíte completa seja executada em qualquer máquina, incluindo
a sua e cada pull request. Documentos reais locais, quando presentes, têm
precedência. tests/word_validator.py abre saídas no Word invisível e
falha em qualquer prompt de reparo, a verificação definitiva de corrupção.
Histórico de desenvolvimento: prototipado com Claude Code em um dia (2026-08-27), depois
endurecido ao longo de ciclos de lançamento por meio de rodadas adversariais dedicadas (tortura de
escala, topologias de merge patológicas, fuzzing de Unicode e esquema, ReDoS,
ciclo de vida de bloqueio do Word, caças de interação de edição ao vivo, verificações de vazamento COM) mais
portões de unidade por fase. Cada descoberta corrigida com um teste de regressão, na mesma sessão
em que foi encontrada. research/ documenta os algoritmos e armadilhas OOXML em que a
implementação é construída, com atribuição às implementações de referência licenciadas sob MIT
estudadas.
Maturidade: o que o número da versão afirma e não afirma
Este projeto se move rápido e é honesto sobre o que o sustenta. O que o registro de
testes cobre: cada lançamento passa na suíte completa mais rodadas adversariais dedicadas
através do transporte MCP bruto, contra um corpus de documentos longos e fortemente
formatados do mundo real com zero corrupção em tudo isso. O que ele ainda não
cobre: outras máquinas, builds do Word mais antigas que o Microsoft 365 atual,
instalações do Word não-inglês (algumas ferramentas referenciam estilos por nome de exibição
localizado), scripts RTL e a diversidade de documentos que apenas usuários reais
trazem. A rede de segurança enquanto a ferramenta ganha essa quilometragem é estrutural:
backups automáticos de slot antes de cada mutação e salvamentos atômicos validados, então um
resultado ruim é uma restauração, não uma perda. Se algo se comportar mal em seus
documentos, um problema
com o sintoma (nunca o documento em si, a menos que não contenha nada
privado) é a coisa mais valiosa que você pode enviar. Antes de registrar: peça ao seu IA
para executar get_server_info e cole a saída aqui; ela é projetada para ser segura
de compartilhar.
Ferramentas rotuladas como Beta, heurísticas por natureza: revise sua lista de itens sinalizados
em vez de confiar silenciosamente: convert_citation_style,
anonymize_for_review, validate(checks=["defined_terms"]) e a
varredura de referência de texto dentro de validate(checks=["cross_references"]). Cada uma
retorna uma lista explícita do que não conseguiu lidar com confiança.
Matriz de capacidade do modo ao vivo
Quais ferramentas funcionam em um documento que está ABERTO no Word. Ferramentas de modo duplo roteiam automaticamente (live='auto'); todo o resto recusa com DOCUMENT_LOCKED até que o arquivo seja fechado. Chamadas COM do Word dentro de um processo de servidor são serializadas. Chamadas ao vivo e salvamento sem senha ou fechamento também usam um bloqueio entre processos local à máquina; um chamador concorrente recebe APP_BUSY antes de tocar no Word e nada é enfileirado. Edições ao vivo permanecem não salvas até com_save_document (o modelo Opção C: veja get_workflows(task='live-editing')).
| Ferramenta de modo duplo (arquivo + ao vivo) | Notas do modo ao vivo |
|---|---|
apply_edits | um grupo de desfazer COM; listas markdown/tabelas de pipe em operações de inserção recusam antecipadamente com uma dica de fechar o arquivo; substituir verifica o texto correspondido no intervalo ao vivo; todas as outras operações endereçadas por índice executam a guarda de obsolescência de snapshot contra o último estado salvo |
delete_paragraphs | intervalos que cruzam quebras de seção/campos recusam; endpoints de localização range={} executam a guarda de obsolescência de snapshot |
find_text | consultas simples, limite de 500 correspondências; modo de formatação e include_textboxes somente no modo arquivo |
format_text | modo de formatação roteia ao vivo; modo de caso somente no modo arquivo (ao vivo='force' recusa); localizações range={} executam a guarda de obsolescência de snapshot |
get_comments | mesma forma |
get_document_info | mesmos nomes de chave; adiciona words/track_revisions, omite lista de partes |
get_outline | mesma forma de lista plana |
get_text | forma do corpo idêntica; include_textboxes/modos de caixa de texto somente no modo arquivo |
insert_paragraphs | heading_level mapeia para estilos de Título integrados por constante numérica (documentos baseados em contorno obtêm níveis de contorno diretos); inherit_format/copy_format_from somente no modo arquivo; localizações de seletor de texto executam a guarda de obsolescência de snapshot |
search_and_replace | itens simples roteiam ao vivo (localizações de 255 caracteres tratadas); modos de visualização e find_formatting somente no modo arquivo (find_formatting com ao vivo='force' recusa) |
set_cells | células de texto simples; mesclagens verticais recusam ao vivo |
set_paragraph_format | chaves shading/borders/tab_stops recusam ao vivo (nível XML); índices brutos mantêm o contrato de confiança de índice do v1 |
set_paragraph_text | guarda de expectativa honrada; parágrafos com revisão rastreada recusam; localizações de seletor de texto executam a guarda de obsolescência de snapshot |
word_count | mecanismo de estatísticas do próprio Word; modo de exclusões somente no modo arquivo |
Ferramentas somente ao vivo (precisam do documento aberto): live_insert_at_cursor, live_repair, live_scroll_to, live_set_track_changes.
Camada COM (dirigem o aplicativo Word, aberto ou fechado): com_export_pdf, com_import_pdf, com_multi_document, com_proofing_errors, com_readability_statistics, com_refresh_fields, com_save_document, com_validate_opens_clean, com_word_status.
Leitor de documento aberto: get_document_view (lê o último estado SALVO e diz isso).
Os 63 escritores e 14 leitores restantes são somente arquivo: eles recusam enquanto o documento está aberto (feche-o, ou com_save_document com close=true). A tabela completa por ferramenta vive em docs/internal/live_parity_v2.md.
Limites conhecidos
- Substituições de regex ao vivo ignoram correspondências posicionadas após campos complexos em uma
história (os offsets de caracteres COM divergem lá); a contagem de ignorados é relatada e uma
busca literal ainda funciona. O
set_cellsao vivo recusa tabelas mescladas verticalmente (a ferramenta baseada em arquivo é ciente de mesclagem; feche o documento para essas). - A atribuição de alterações rastreadas ao vivo é de melhor esforço: o Word conectado a uma conta do Office atribui revisões a essa conta; os resultados relatam o autor efetivo honestamente.
- Os números de página do sumário e da lista de legendas exigem uma atualização de campo: automática
na próxima abertura do Word, ou imediata via
com_refresh_fields.
Atualizando da v1.x
Todos os nomes de ferramentas da v1.x mudaram. A superfície de 189 ferramentas da v1.6 foi reconstruída como um
conjunto consolidado de 110 ferramentas que cobrem toda capacidade anterior sob uma única
gramática. Se você está atualizando da v1.x, leia o
guia de migração primeiro: ele mapeia cada nome de ferramenta antigo
para seu destino na v2, e get_workflows("migrate-from-v1") retorna o
mesmo mapa na sessão. Novas instalações não precisam de nada extra.
Licença
KitchenSink4Word é licenciado duplamente:
AGPL-3.0 (código aberto). Gratuito para qualquer pessoa (indivíduos, acadêmicos e empresas) para qualquer uso que esteja em conformidade com os termos da AGPL. Esses termos incluem compartilhar o código-fonte, incluindo suas modificações, quando você distribui o software ou o disponibiliza por uma rede.
Licença comercial. Para organizações que desejam incorporar KitchenSink4Word em seus próprios produtos ou serviços sem as obrigações de compartilhamento de código-fonte da AGPL. Contate licensing@kitchensink4.ai.
Copyright (c) 2026 Alvut Consulting, LLC. KitchenSink4AI é uma linha de produtos da Alvut Consulting, LLC.
Não afiliado, endossado ou patrocinado pela Microsoft Corporation. Microsoft e Word são marcas registradas do grupo de empresas Microsoft.
Não afiliado ou endossado pela Microsoft Corporation. Microsoft e Word são marcas registradas da Microsoft Corporation. "Para Microsoft Word" descreve compatibilidade de formato de arquivo apenas.