Cómo configurar Harper, un corrector gramatical offline sin fugas de datos
TuBrief 편집팀
2026년 7월 25일
0
Computing/Software원본 영상을 바탕으로 AI의 도움을 받아 작성했습니다. 원본 영상이 기준입니다.
커뮤니티의 다른 글
댓글 (0)
Log in to leave a comment
아직 작성된 글이 없습니다
원본 영상을 바탕으로 AI의 도움을 받아 작성했습니다. 원본 영상이 기준입니다.
Log in to leave a comment
아직 작성된 글이 없습니다
Si la política de seguridad interna de su empresa bloquea herramientas de IA externas como Grammarly, los desarrolladores se encuentran en una situación difícil. Dejar erratas en la documentación técnica o en los comentarios del código antes de desplegar reduce la confianza, pero revisar todo a ojo lleva demasiado tiempo.
Harper resuelve este problema de forma impecable. Al ser un motor de corrección gramatical offline desarrollado en Rust, bloquea por completo cualquier comunicación con servidores externos. A diferencia de LanguageTool, que funciona sobre Java y consume cientos de megabytes de memoria, el uso de memoria de Harper es de tan solo unos diez megabytes. Además, funciona con un tiempo de respuesta inferior a 10 ms, por lo que el editor nunca se ralentizará.
harper-ls realiza el análisis sintáctico dentro del terminal utilizando únicamente los recursos de la CPU local. Solo necesita instalar el binario con el gestor de paquetes adecuado para su sistema operativo y registrarlo como un LSP estándar en su editor.
Ejecute el comando en la terminal para instalar el binario.
brew install harpercargo install harper-ls --lockedscoop install harperEn Neovim, configure los tipos de archivo de destino y las reglas del linter con nvim-lspconfig.
`lua
local lspconfig = require('lspconfig')
lspconfig.harper_ls.setup({
filetypes = { 'markdown', 'gitcommit', 'rust', 'go', 'typescript', 'python' },
settings = {
["harper-ls"] = {
userDictPath = "~/config/harper/user_dict.txt",
workspaceDictPath = ".harper-dictionary.txt",
linters = {
SpellCheck = true,
SpelledNumbers = false,
AnA = true,
SentenceCapitalization = false,
UnclosedQuotes = true,
WrongApostrophe = false,
LongSentences = true,
RepeatedWords = true,
Spaces = true,
CorrectNumberSuffix = true
}
}
}
})
`
Al utilizar la API nativa de LSP en Neovim 0.11 o superior, configure vim.lsp.config['harper'] y llame a vim.lsp.enable('harper'). Para los usuarios de VS Code, basta con instalar la extensión elijah-potter.harper y definir la ruta "harper.path": "/usr/local/bin/harper-ls" en .vscode/settings.json.
Harper incluye un analizador AST Tree-sitter integrado, por lo que omite el código fuente real y analiza únicamente el texto en inglés dentro de los bloques de comentarios. Si desea excluir por completo los comentarios de una función específica del análisis, añada una directiva en línea.
`javascript
// harper:ignore
function processInternalSecurityToken() {
// spellcheck:ignore
// 내부 보안 토큰 로직
}
`
Si solo utiliza el diccionario de inglés básico, la herramienta marcará términos técnicos como gRPC, OAuth2 o Prometheus como errores. El uso de una estructura de diccionario jerárquica permite eliminar rápidamente el ruido de las advertencias.
Harper valida las palabras a través de 4 capas.
| Capa del diccionario | Ubicación de almacenamiento | Propósito |
|---|---|---|
| Static Dictionary | Integrado en el binario harper-ls |
Base de datos básica de palabras en inglés no modificable |
| User Dictionary | ~/.config/harper-ls/dictionary.txt |
Diccionario global para el entorno de desarrollo personal |
| Workspace Dictionary | Raíz del proyecto .harper-dictionary.txt |
Diccionario de términos exclusivo del proyecto (gestionado con Git) |
| File-Local Dictionary | Guardado en la ruta de datos del SO | Almacenamiento de identificadores exclusivos para un solo archivo |
.harper-dictionary.txt en el directorio raíz del proyecto.`text
Kubernetes
gRPC
OAuth2
OpenTelemetry
Prometheus
mTLS
Netty
Etcd
`
Ctrl + . en VS Code, o la combinación de teclas correspondiente a Code Action en Neovim) para añadir inmediatamente dicha palabra a .harper-dictionary.txt.Con solo subir este archivo al repositorio Git, todos los miembros del equipo compartirán la misma lista de palabras.
Desactive las reglas molestas al redactar comentarios.
SentenceCapitalization: Establézcalo en false para desactivar la regla que fuerza la mayúscula inicial en los comentarios.LongSentences: Establézcalo en false para desactivar las advertencias de oraciones largas, comunes en la documentación técnica.SpellCheck y UnclosedQuotes: Mantenga en true la verificación de errores ortográficos y de comillas sin cerrar.Los errores tipográficos que los desarrolladores pasan por alto en el editor deben bloquearse en la fase de PR. La integración de la herramienta de línea de comandos harper-cli en el flujo de trabajo permite filtrar automáticamente los errores gramaticales antes de fusionar en la rama principal.
Defina una tarea en el archivo .github/workflows/harper-lint.yml para inspeccionar únicamente los archivos Markdown modificados.
`yaml
name: Technical Documentation Linting
on:
pull_request:
paths:
- 'docs/'
- '.md'
jobs:
harper-grammar-check:
runs-on: ubuntu-latest
steps:
- name: Checkout Repository
uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Install Rust Toolchain
uses: dtolnay/rust-toolchain@stable
- name: Cache Harper CLI Binary
uses: actions/cache@v3
with:
path: ~/.cargo/bin/harper-cli
key: ${{ runner.os }}-harper-cli-${{ hashFiles('**/Cargo.lock') }}
- name: Install Harper CLI
run: |
if ! command -v harper-cli &> /dev/null; then
cargo install harper-cli --locked
fi
- name: Get Changed Markdown Files
id: changed-files
run: |
git fetch origin ${{ github.base_ref }}
FILES=$(git diff --name-only --diff-filter=AM origin/${{ github.base_ref }} HEAD | grep '\.md$' || true)
echo "files=$FILES" >> $GITHUB_OUTPUT
- name: Run Harper Lint Check
if: steps.changed-files.outputs.files != ''
run: |
ERRORS=0
for file in ${{ steps.changed-files.outputs.files }}; do
echo "Linting $file with Harper..."
harper-cli lint "$file" || ERRORS=$((ERRORS+1))
done
if [ $ERRORS -gt 0 ]; then
echo "Harper validation failed with $ERRORS error(s)."
exit 1
fi
`
Si incluye .harper-dictionary.txt ubicado en la raíz del proyecto en el commit, el ejecutor de CI también realizará la inspección basándose en la misma lista de palabras que el editor. Si utiliza un generador de sitios estáticos (SSG) como MkDocs o Docusaurus, es más seguro configurarlo para que ejecute el comando harper-cli lint docs/ justo antes de ejecutar el script de compilación.