Original em inglês: https://argusic.com/subject/kordoc
kordoc
Ferramenta de IA para documentos coreanos que lê, corrige e reescreve: converte HWP, HWPX, PDF, Office e scans (OCR) para Markdown, com comparação de versões, edição preservando formatação, criação de HWPX a partir de Markdown, conversão de HWP para HWPX, preenchimento de formulários e revisão de documentos oficiais. Disponível como biblioteca, CLI e servidor MCP.
Executafonte: GitHubpágina do projetoTypeScriptMITcommit dd4a08b77784
TypeScript, licença MIT. O projeto se descreve como: cli, document conversion, document parser, docx, hancom, hwp, hwp parser e hwpx.
kordoc executa. Em uma máquina limpa sem GPU, um agent da Argusic o instalou em 0,6 minutos e encontrou 1 erro, corrigindo-o sem ajuda, e a sessão inteira foi gravada.
kordoc 4.13.1 builds, all 1691 automated tests pass, the CLI parses HWPX and XLS files to Markdown correctly, and the library API returns structured parse results with fileType, markdown, blocks, and metadata.
O que o agent conseguiu em uma máquina limpa, nas palavras dele. Como isto é medido
Medido pela Argusic em uma máquina nova, todas as vezes. Cada número tem link para as suas evidências. Pontuação Argusic 100 de 100 (a média das pontuações das execuções deste projeto).
Visão geral
Dados do projeto de GitHub, com link no topo desta página, atualizado em . Dados de teste da Argusic (CC BY 4.0); cada número tem link para uma página de execução com o log completo, a gravação e os hashes sha256 deles.
O que foi medido
Da execução que decidiu este veredito. Cada linha é um valor registrado, não uma estimativa.
O que deu errado, nas palavras do agent
As palavras do próprio agent, das piores para as menores, nunca reescritas como conselho.
- sharp 0.35.x requires Node >=20.9.0 but container has Node 18.19.1 — 14 tests fail at load time10 minutos
- Tempo de instalação
- menos de um minuto
- Da máquina limpa até o fim
- 28 minutos
- Erros encontrados e corrigidos
- 1 encontrado, 1 corrigido sem ajuda humana
- Como o resultado foi comprovado
- npm test exited 0: 1691 passed, 0 failed, 7 skipped. node dist/cli.js tests/fixtures/dummy.hwpx printed correct markdown. node -e "require('./dist/index.cjs').parse('tests/fixtures/dummy.hwpx').then(r=>console.log(r.fileType,r.success))" returned hwpx true
- Tokens de modelo usados
- 189.213
- Commit exato testado
- dd4a08b77784
- Imagem do container
- sha256:cdd920bce783
O que não foi medido
A outra metade, para você ver exatamente até onde estas evidências vão. Uma lacuna é mostrada como lacuna e nunca é preenchida.
- Pico de memória da GPU
- esta execução foi em uma máquina com CPU, então não havia GPU para medir
- Comportamento em uma execução longa
- cada tentativa usa as menores configurações documentadas e um orçamento de tempo fixo, então isto mede se ele executa, não como ele se comporta sob carga
O fim da gravação
As últimas linhas da sessão de terminal que decidiu este veredito, exatamente como foram gravadas.
**Fix applied:** `sharp@^0.35.0` requires Node ≥20.9.0 — container has Node 18.19.1. Downgraded to …
**Tests:** 1691 passed, 0 failed, 7 skipped (benign — missing OCR models and optional large corpus …
**CLI verified:** `node dist/cli.js --version` → `4.13.1`; `node dist/cli.js tests/fixtures/dummy.h…
**API verified:** `parse('tests/fixtures/dummy.hwpx')` → `fileType: hwpx, success: true, pageCount:…
tokens used
189,213
All systems verified. Here's the final report:
**Install:** `npm install` and `npm run build` both succeed.
**Fix applied:** `sharp@^0.35.0` requires Node ≥20.9.0 — container has Node 18.19.1. Downgraded to …
**Tests:** 1691 passed, 0 failed, 7 skipped (benign — missing OCR models and optional large corpus …
**CLI verified:** `node dist/cli.js --version` → `4.13.1`; `node dist/cli.js tests/fixtures/dummy.h…
**API verified:** `parse('tests/fixtures/dummy.hwpx')` → `fileType: hwpx, success: true, pageCount:…Reproduzir a sessão inteira, cada comando desde a máquina limpa até este ponto.
Como foi testado
Um agent, um container, nenhuma ajuda humana. Ele instala o projeto do jeito que a própria documentação do projeto manda, executa o projeto e corrige o que quebra. Tudo abaixo é registrado como aconteceu: a sessão de terminal, o log e o commit exato. A metodologia completa.
Pontos fortes e limites
Fatos medidos, não opiniões. Como este conteúdo é escrito.
O que deu certo
- Chegou a um estado de execução em uma máquina limpa, com a sessão gravada.
- Instalado em 0,6 minutos, mais rápido que a mediana dos 121 projetos comparáveis que a Argusic mediu.
- Recuperou-se do único erro sem que uma pessoa interviesse, o que indica que as falhas estão documentadas o suficiente para serem resolvidas.
- Executou sem GPU, então não precisa de uma para iniciar.
- Licença MIT, segundo a plataforma onde o projeto está hospedado.
- Medido 2 vezes, então o resultado não é um caso isolado.
Dos 122 projetos de cli que a Argusic instalou e cronometrou, kordoc foi o 8º mais rápido a chegar a um estado de execução, e 109 de 122 chegaram a esse estado.
Para que é uma escolha razoável
- Testar em um laptop ou em um servidor pequeno: ele chegou a um estado de execução sem GPU.
- Uma avaliação rápida: ele estava executando 0,6 minutos depois do clone.
Também testados, na mesma área
Cada um destes foi instalado e executado pela Argusic em uma máquina limpa. Nada aparece aqui sem ter sido testado.
Histórico de execuções
Tópicos (de GitHub)
clidocument-conversiondocument-parserdocxhancomhwphwp-parserhwpxkoreanllmmarkdownmcpmcp-serverocrofficeparserpdfpdf-to-markdownragxlsx
Incorporar o selo
Markdown para o README do projeto. Ele tem link de volta para esta página; os termos estão na página de termos.
[](https://argusic.com/subject/kordoc)Perguntas
- kordoc executa?
- Sim. kordoc executa. A Argusic o instalou e iniciou em uma máquina limpa em 1 minutos, encontrando 1 erro no caminho, e gravou a sessão.
- Como a Argusic testou kordoc?
- Em uma máquina nova e descartável, com cada comando gravado e o repositório fixado no commit dd4a08b77784. Há 2 tentativas registradas, e a metodologia completa está na página da metodologia.
- Quanto custou testar kordoc?
- A execução que produziu este veredito custou US$ 0,15: custo real de computação e de modelo, não um preço de tabela por milhão de tokens. Esse valor está registrado na página da execução.
- Quanto tempo leva para instalar kordoc?
- 0,6 minutos na execução que decidiu este veredito, de uma máquina limpa até um estado de execução. É uma tentativa medida, não uma média.
- kordoc precisa de GPU?
- Não para iniciar. A Argusic chegou a um estado de execução em uma máquina sem GPU.
- O que dá errado ao instalar kordoc?
- 1 coisa quebrou na execução registrada, e 1 foi corrigida sem ajuda humana. Cada uma, com o tempo que custou, está listada nesta página.
- Como kordoc se compara às alternativas?
- Dos 122 projetos de cli que a Argusic instalou e cronometrou, kordoc foi o 8º mais rápido a chegar a um estado de execução, e 109 de 122 chegaram a esse estado.
- Onde estão as evidências de kordoc?
- Todas as 2 execuções registradas estão nesta página, cada uma com link para o seu log completo e a sua gravação do terminal, guardados com uma impressão digital sha256 para que não possam ser alterados discretamente.