Regalo para desarrolladores

Skill de Obsidian para Desarrolladores

Patrones, gotchas y reglas acumuladas en 5 plugins con +95 pts en el Bot Store. Todo lo que necesitás saber para pasar la revisión de la comunidad.

Descargar skill completo (.md) Obsidian Community Store

Reglas críticas

Estas son las reglas que NUNCA debés violar. El bot de revisión las detecta automáticamente.

Nunca uses innerHTML. Usá createEl(), createDiv(), createSpan().

Nunca uses fetch() directo. Usá requestUrl() de la API de Obsidian. Retorna { status, json, text } — son propiedades, no métodos.

Nunca uses elementos de heading. Usá new Setting(containerEl).setName("Título").setHeading().

Nunca uses confirm() ni window.confirm(). Usá un Modal personalizado de Obsidian.

Nunca uses window.prompt(). Usá un Modal personalizado.

Siempre envolvé operaciones de vault en try-caché. Las race conditions con el índice asíncrono causan fallos silenciosos.

Usá window.setTimeout() en vez de setTimeout() bare. Para compatibilidad con popout windows.

Los handlers async en onClick deben retornar void. Wrappeá con void (async () => { ... })().

Verificá el @since de cada API contra minAppVersion en manifest.json antes de escribir código.

Workflow — 3 pasos

Paso 1: Cargar la referencia

Leé references/obsidian.md — gotchas acumulados, compatibilidad de API, reglas del bot de revisión, patrones, y flujo de releases.

Paso 2: Verificar cada llamada a la API

Para cada método de la API de Obsidian que uses, verificá la anotación @since en node_modules/obsidian/obsidian.d.ts y compará con minAppVersion.

API	@since	Alternativa compatible
`fileManager.trashFile()`	1.6.6	`vault.trash(file, true)` (0.9.7)
`workspace.revealLeaf()`	1.7.2	`setActiveLeaf(leaf, { focus: true })` (0.16.3)
`PluginSettingTab.display()`	deprecated 1.13.0	Extraer método `render()`, delegar desde `display()`

Paso 3: Aplicar reglas de revisión

Sin innerHTML → métodos de creación DOM
Sin fetch() → requestUrl() con { url, method?, headers?, body? }
requestUrl() retorna { status, json, text } — son propiedades, no métodos
res.status >= 200 && res.status < 300 en vez de res.ok
Sin confirm() / window.confirm() → Modal personalizado
Headings usan setHeading(), no createEl("h2")
setTimeout() usa prefijo window.
JSON.parse() resultados tipados explícitamente (no any)
Tags de release sin prefijo v; versions.json actualizado
Assets de release: solo main.js, manifest.json, styles.css
Release creado por CI workflow, no manualmente

Pitfalls — 9 gotchas que te van a morder

Las reglas del bot contradicen entre rondas. no-unsupported-api rechaza APIs nuevas; no-deprecated-api exige las mismas. Fix: subir minAppVersion.
El parser YAML custom corrompe con caracteres especiales. Siempre escapá \n, \r, \\, \".
Array.sort() muta in-place. Usá [...arr].sort() o arr.toSorted() en views.
data.json del plugin no se sincroniza. Implementá auto-descubrimiento de books desde el filesystem del vault.
El índice del vault en mobile puede estar vacío durante onload(). Fallback a adapter.list() / adapter.exists().
DEFAULT_SETTINGS solo aplica a instalaciones nuevas. Los usuarios existentes necesitan lógica de migración.
El release manual crea race condition con CI. Si hacés gh release create manualmente y el CI también lo hace, falla. Solo subí el tag — CI maneja el release.
requestUrl no soporta signal/AbortController. No podés pasar AbortSignal.timeout(). Eliminá la lógica de timeout o wrappeá con Promise.race.
Los callbacks de setTimeout que retornan non-void activan warnings. Usá block body: setTimeout(() => { expression; }).

Checklist de verificación

references/obsidian.md revisado para gotchas relevantes
Todas las llamadas a la API verificadas contra minAppVersion vía @since
Sin innerHTML, fetch() raw, confirm(), ni window.prompt()
Headings usan setHeading(), no createEl("h2"/"h3")
setTimeout() usa prefijo window.; handlers async wrappeados con void
JSON.parse() y requestUrl().json resultados tipados explícitamente
Tags de release sin prefijo v; versions.json actualizado en main
Assets de release: solo main.js, manifest.json, styles.css
Release creado por CI workflow, no manualmente
manifest.json minAppVersion ≥ @since más alto entre APIs usadas

Descargar skill completo (.md)