autorag-doctor
Diagnose and repair a broken or half-working AutoRAG install so every configured source is both indexed and searchable. Checks AutoRAG, MinSync, Jikji, the embedding gateway, and every CLI-backed datasource (lazykatok, discrawl, slacrawl, wacrawl, telecrawl, notcrawl, qmd, mailcrawl, rclone, Spotlight), then fixes orphan locks, orphan processes, embedding dimension or identity mismatches, stale indexes, and missing setup. Use when search returns nothing or too little, refresh hangs or fails, a d
Оригинален текст · няма потвърден превод на българскиПърво прочетете инструкцията.
Файлът се зарежда от посочения източник само по ваше действие. Можете да го прочетете тук, да го копирате или да го запазите като .md.
GitHub хранилище- Звезди на репото
- 5092
- Лиценз
- NOASSERTION
- Последна проверка на записа
- 21.09.2026 г.
Добавете в своя инструмент.
Командата отваря избора на skills от репозитория. Прочетете файла и условията на автора преди изпълнение.
npx skills add Marker-Inc-Korea/AutoRAGСтраницата копира текст. Не инсталира и не изпълнява нищо на устройството ви.
Откъс от SKILL.md
Началото на файла на автора, без превод.
AutoRAG doctor
Goal: every configured datasource is indexed and actually returns
hits. A green status is not enough — the run is done only when a real query
returns a real hit per datasource, or the datasource is reported as genuinely
empty or not configured.
Always finish with the status table in Report.
Safety
- Never delete, move, or edit source documents.
- Never delete a datasource's native store (
~/Library/Application Support/katok,~/.discrawl,~/.mailcrawl,.qmd, Telegram/WhatsApp/Notion archives). AutoRAG only reads them; rebuilding them is the owning CLI's job. - Only AutoRAG-owned state under
AUTORAG_HOMEand the workspace.autoragdirectory may be reset. - Never print token or password values. Report credential names only.
- Kill a process only after confirming it is an AutoRAG-owned orphan.
1. Triage the core
autorag status --json
autorag health --json
autorag gateway status --format json
statusreportsstate,stale,diagnostics, and per-component state forminsync,jikji, anddatasources.stale: trueor anystale-indexdiagnostic means the corpus changed since the last successful refresh.healthresolves the single search model and does one live completion probe.--skip-probesonly proves config shape, never live access; do not claim a healthy model from it.- The gateway is on-demand:
stoppedis normal when nothing is embedding.unavailablewhile a refresh is running is a real failure.
Config lives at --config, AUTORAG_CONFIG, $AUTORAG_HOME/config.json, or
~/.autorag/config.json. Read searchPaths, workspacePath, minSync,
jikji, and datasources before changing anything.
If the CLI itself is missing or the config does not exist, stop and run the
autorag-setup skill first — doctor repairs an existing install, it does not
create one.
2. Probe every datasource natively
Each CLI owns its archive, so ask the CLI, not AutoRAG. A datasource is only
active when its binary exists, its store is present, and its own check passes.