file-guide
Windows file organiser that uses Jev Choice and Noul to suggest which folder a new file belongs in and to drill down to find files.
Overview
File Guide is a Windows desktop app built with Electron, Vue 3 and TypeScript, documented in Chinese, that uses Jev for structured file-system judgments shown with probabilities and confidence. While browsing local directories, you can create or upload a file and ask for a filing suggestion: the current directory's subfolders become Choice candidates, and Jev returns the top five recommendations plus an uncertain row, batching automatically above 250 candidates.
A search feature decomposes global search into layer-by-layer drilling, following TypeSafe's hierarchical classification cookbook. Each layer makes one call with a Choice (which child is the target most likely in) and a Noul (is the target really at this level). An automatic mode keeps all branches above a 1% noise floor in a global priority queue and evaluates the top two each round, within a budget of 24 calls and six levels, ranking hits by in-layer probability with a depth-adjusted path factor. Folder candidates include sampled child names so the model can infer purpose, and prompts note names may be pinyin or English.
What the decision model decides
| Type | Question | Answers |
|---|---|---|
| Choice | Which subfolder should this new file go into? | — |
| Choice | Which child at this level most likely contains the target? | — |
| Yes / no | Is the target directly at this level? | yes · no |
How it works
- Browse local directories
- For filing, ask Jev which subfolder fits the new name
- For search, drill down level by level with Choice and Noul
- Show ranked results with probabilities and path scores
Strengths
- Hierarchical search over large trees within a call budget
- Uncertain option exposed to the user
- Handles pinyin and English naming
Caveats
- Windows only
- Chinese-first documentation
- Folder and file names sent to TypeSafe
Getting started
Clone the repo, install dependencies and run the Electron app per the README, then set your TypeSafe key.At a glance
- Type
- Project
- Status
- prototype
- Language
- TypeScript
- Runtime
- Electron desktop app (Windows)
- Has code
- yes
Use cases and integrations
How curated lists describe it
AI-assisted file organizer built on Electron + Vue 3 + TypeSafe (Jev) - AI 归档建议与逐层查找.
hellogumbo/awesome-jev
Frequently asked questions
What does Jev decide?
Which folder a new file belongs in, and which branch to drill into when searching.
How many API calls does a search use?
Up to 24 calls and six levels in automatic mode.
Which platform?
Windows desktop.
Related projects
Privacy-first personal knowledge management system, listed as integrating Jev for document classification and tag routing.
PluginproductionTypeScriptGo terminal app that files documents using five Jev questions: category, sensitivity, urgency, whether action is needed and action state.
ProjectbetaGonpm library that walks a taxonomy with one Jev Choice per level so you can select among thousands of leaves despite the 255-option cap.
ProjectbetaTypeScriptObsidian plugin that ranks existing vault folders and tags for the active note with Jev and only moves or tags after you confirm.
ProjectbetaTypeScriptLLM-maintained Markdown wiki where a System One classifier decides where documents and questions go, keeping it fast as it grows.
ServicebetaPythonWindows office workbench with search, OCR and batch renaming, where Jev optionally helps pick extracted contract fields.
ProjectbetaRust