A local-first desktop knowledge graph for organizing Markdown notes into editable hierarchies and connecting them to papers, books, PDFs, and files — manually, accurately, and without uploading your knowledge base.
AllConnect 是一个本地运行的桌面来源连接器:可以自由建立“硕士论文研究 → Koopman → 基础理论”这样的多层栏目,把 Markdown 笔记归入栏目,再把笔记与论文/PDF/书籍文件连成可展开、可收起的关系图。所有栏目和连接都由你亲自确认,数据保存在本机 SQLite 中,不上传笔记内容。
Research notes often outlive the browser tab where they started. AllConnect keeps the trail visible:
- Manual by design — no filename matching, no “smart” guesses, no accidental links.
- Editable hierarchies — create, rename, move, and delete nested collections independently of physical folders.
- Expandable graph — click collection and note nodes to reveal or hide the next relationship level.
- Note-level and folder-level links — connect one note, or connect an entire subject folder such as “Linear Algebra” to one textbook.
- Local-first — Markdown stays where it is; PDFs and files open with the operating system’s default application.
- Focused graph — the canvas shows only objects that already have a relationship, so large note collections stay readable.
- Lightweight — Python, PySide6, and SQLite; no server, account, cloud database, or web app.
适合用 Markdown 做学习笔记、论文阅读记录、课程整理和研究资料管理的人。尤其适合这种关系:
硕士论文研究
├─ Koopman ──> Koopman算子.md ──> Koopman论文.pdf
├─ ESO ──> 扰动观测器.md
└─ LQR ──> LQR推导.md
线性代数(10 篇笔记) ──整体来源──> 线性代数教材.pdf
特征值与特征向量.md ──第 42 页──> 线性代数教材.pdf
- Clone or download this repository.
- Double-click
安装依赖.batonce. - Double-click
启动 AllConnect.vbs. - Open
目录设置and choose the folders that contain your Markdown notes. - Click
新建栏目, create the hierarchy you need, then select a collection and click编辑栏目笔记; expand the local folder tree and check the Markdown files you want. - Select a note, click
手动连接, choose a local file, and save the relationship.
- “栏目”是独立于磁盘文件夹的逻辑分类;刷新文件索引不会创建、移动或删除栏目。
- 顶层栏目默认收起。点击左侧箭头,或点击中间画布上带
▶/▼的栏目节点,可以展开或收起下一层。 - 展开栏目后显示它的直接子栏目和直接归属笔记;继续点击笔记节点才会显示该笔记的来源。
- 笔记默认以 Markdown 文件名(不含
.md)作为标题;可在右侧编辑 AllConnect 显示标题,留空即可恢复文件名,实际文件不会被重命名或改写。 - 一篇笔记可以同时属于多个栏目。
编辑栏目笔记按“笔记根目录 → 本地子文件夹 → Markdown 文件”展示,不再把所有笔记铺成一张长列表;右侧同时显示笔记标题或文件夹内笔记数。- 可以按文件夹名、文件名、笔记标题或完整路径搜索;匹配结果会自动展开,
展开已选可直接定位已勾选笔记。 - 选择栏目后,右侧可以新建子栏目、编辑名称/备注/父栏目、编辑栏目笔记或删除栏目。
- 选择笔记后可以编辑标题或调整所属栏目;取消栏目勾选只解除归属。展开笔记并选择来源节点后,可以编辑或解除那一条具体连接。
- 删除栏目只解除栏目关系;子栏目会提升到上一级,Markdown、来源、连接和实际文件不会被删除。
- 工具栏的
收起栏目可以一键回到只显示顶层栏目的状态。 - 画布使用固定可读的最小缩放比例;层级较长时通过拖动画布或滚轮浏览,不会再为了塞入窗口而把文字缩成不可读的小点。
The first launch suggests:
F:\my_workspace\study_noteF:\my_workspace\精读论文\notes
The app never scans or imports the temporary workspace F:\codex_workspace\try_sth\notes.
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\python.exe allconnect.py- Notes and source files are never moved, edited, or deleted by AllConnect.
- Relationships are stored locally in
data\allconnect.sqlite3. - Editable collections and note memberships are stored in the same local database.
data/and.venv/are intentionally ignored by Git, so personal paths and runtime files do not enter commits.- Deleting a relationship removes only the database relationship, not the actual file.
AllConnect deliberately avoids automatic linking and automatic classification. A relationship is useful only when it is trustworthy. The app therefore keeps the workflow short: create a collection, choose its notes, select a note, choose a local source file, add an optional page/section and note, save.
.\.venv\Scripts\python.exe -X utf8 -m unittest -vThe test suite uses isolated temporary databases and covers manual-only linking, editable collection hierarchies, cycle prevention, multi-collection note membership, the local-folder note picker, expandable/collapsible graph state, folder-level relationships, database migration, Chinese paths, missing files, graph bounds, and the Qt window smoke test.
- Manual note-to-source relationships
- Folder-level relationships
- Local SQLite persistence
- Focused relationship graph
- Editable hierarchical collections
- Expandable collection → note → source graph
- Optional export/import for backup and migration
Contributions and small UX improvements are welcome. See LICENSE.