Skip to content

About

Local-first desktop knowledge graph for manually linking Markdown notes to papers, PDFs, books, and files. Built with PySide6 and SQLite.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

AllConnect

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.

Tests Python Qt License

AllConnect 是一个本地运行的桌面来源连接器:可以自由建立“硕士论文研究 → Koopman → 基础理论”这样的多层栏目,把 Markdown 笔记归入栏目,再把笔记与论文/PDF/书籍文件连成可展开、可收起的关系图。所有栏目和连接都由你亲自确认,数据保存在本机 SQLite 中,不上传笔记内容。

Why AllConnect?

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

Quick start

Windows

  1. Clone or download this repository.
  2. Double-click 安装依赖.bat once.
  3. Double-click 启动 AllConnect.vbs.
  4. Open 目录设置 and choose the folders that contain your Markdown notes.
  5. Click 新建栏目, create the hierarchy you need, then select a collection and click 编辑栏目笔记; expand the local folder tree and check the Markdown files you want.
  6. 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_note
  • F:\my_workspace\精读论文\notes

The app never scans or imports the temporary workspace F:\codex_workspace\try_sth\notes.

From a terminal

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\python.exe allconnect.py

Data and privacy

  • 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.

Design principles

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.

Development

.\.venv\Scripts\python.exe -X utf8 -m unittest -v

The 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.

Roadmap

  • 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.

About

Local-first desktop knowledge graph for manually linking Markdown notes to papers, PDFs, books, and files. Built with PySide6 and SQLite.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages