by matteo
Classifica a nota com o Jev (TypeSafe): grava genero e categoria (taxonomia em PT-BR) e gera tags de pasta e de assunto no frontmatter.
Jev Classificador
Obsidian plugin. A button at the top right of the note (and the "Classify field and subfield" command) sends 1 request to Jev (TypeSafe System One), which picks a categoria (field, 13 options) and a genero (subfield, 89 options), in English or Brazilian Portuguese, and writes them to the frontmatter.
Install
- Obsidian → Settings → Community plugins → Browse → "Jev Classificador" → Install → Enable.
- In the window that opens, create a key at https://console.typesafe.ai/keys and paste it into the secret. Done.
Hotkeys: none by default. Set them in Settings → Hotkeys (search for "Jev"). Suggestion: Alt+C, Alt+T, Alt+A.
Privacy
- When classifying (or generating topic tags), the plugin sends to the TypeSafe API (
api.typesafe.ai): the note title, its tags and up to N characters of the body (default 12000). The folder path is never sent. Nothing is sent unless you run the command. - The key is kept in Obsidian's SecretStorage (it does not go into
data.json). - Excluded folders (settings): notes in them are never read or sent.
How it works
- Taxonomy: custom, with descriptions (
desc, sent to Jev as criteria), bundled insrc/taxonomia.en.json(English) andsrc/taxonomia.json(Portuguese). Each field has ageneralsubfield. - Confidence below the threshold (default 0.6): a modal with the top 3.
- Frontmatter:
categoria,generoandtagsare kept together, in that order. The property names stay the same in both languages. - "Generate tags" command, no API: a
<root folder without number, singular>/<subfield or field>tag in kebab-case without accents (e.g.1-concepts/x→concept/infrastructure). Only tags with the same prefix are replaced. Checkboxai-generated: true→ alsoai-generated. Singular exceptions in the settings (defaultlugares=lugar). - "Generate topic tags" command (API): 1–3 flat tags from a closed wordlist (
src/taxonomia-tags.en.jsonorsrc/taxonomia-tags.json).
Language
The Taxonomy language setting (Português/English) picks the taxonomy, the topic-tag wordlist, the instructions sent to Jev and the UI language. Default: English. Command names are always in English; command ids (classificar, gerar-tags, gerar-tags-assunto) never change, so your hotkeys keep working.
Switching language does not translate notes already classified:
categoria/generostay in the language they were written in (e.g.tecnologiain one note,technologyin another). Re-classify (Alt+C) if you want everything in one language.- Folder/subfield tags (Alt+T) follow the frontmatter value; since Alt+T replaces everything with the same prefix, running it again after re-classifying removes the old tag.
- Topic tags (Alt+A): the plugin recognizes the wordlists of both languages, so running Alt+A in the new language replaces the old tags (e.g.
#ia→#ai) without touching the others.
Dev
npm install
npm test # vitest (pure logic in src/core)
npm run build # builds main.js
Manual install: copy main.js, manifest.json and styles.css to <vault>/.obsidian/plugins/jev-classificador/.
For plugin developers
Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.