[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-81539":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":13,"subscribersCount":13,"size":13,"stars1d":14,"stars7d":14,"stars30d":15,"stars90d":13,"forks30d":13,"starsTrendScore":16,"compositeScore":17,"rankGlobal":8,"rankLanguage":8,"license":8,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":20,"hasPages":20,"topics":21,"createdAt":8,"pushedAt":8,"updatedAt":22,"readmeContent":23,"aiSummary":24,"trendingCount":13,"starSnapshotCount":13,"syncStatus":14,"lastSyncTime":25,"discoverSource":26},81539,"Folium","XC-Xinze\u002FFolium","XC-Xinze",null,"TypeScript",28,4,26,0,2,3,6,41.4,false,"main",true,[],"2026-06-12 04:01:34","\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fassets\u002Ffolium-logo.png\" alt=\"Folium logo\" width=\"128\" height=\"128\" \u002F>\n\u003C\u002Fp>\n\n\u003Ch1 align=\"center\">Folium\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  A local-first card workspace for thinking through links, boxes, and temporary canvases.\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fxc-xinze.github.io\u002FFolium\u002F\">Website\u003C\u002Fa>\n  ·\n  \u003Ca href=\"https:\u002F\u002Fxc-xinze.github.io\u002FFolium\u002Fdocumentation.html\">Documentation\u003C\u002Fa>\n  ·\n  \u003Ca href=\"docs\u002Fplugin-sdk-v0.md\">Plugin SDK\u003C\u002Fa>\n  ·\n  \u003Ca href=\"docs\u002Felectron.md\">Desktop Notes\u003C\u002Fa>\n\u003C\u002Fp>\n\n---\n\nFolium is a desktop-first Markdown knowledge workspace inspired by the useful parts of Obsidian, Logseq, and Luhmann-style card indexes, but built around a different premise:\n\n> Links should carry a chain of thought, not just decorate isolated notes.\n\nYour notes stay as plain Markdown files in a local vault. Folium builds a local SQLite index over those files, then gives you card boxes, real double-links, potential links, graph exploration, tag views, temporary workspaces, attachment handling, and a trusted local plugin surface.\n\n## 1.5 Release\n\nFolium 1.5 is the first version that feels like the intended product rather than a pile of useful experiments.\n\n- **Simpler card canvas**: the main box view now focuses on box structure, real links, and optional potential links.\n- **Correct link expansion**: cards in the current box can pull in directly linked external cards, but imported external cards do not recursively pull a second ring.\n- **Potential as helper layer**: potential links combine unlinked references with high-confidence similarity signals while filtering attachment noise, date fragments, and generic daily-note terms.\n- **Workspace cleanup**: temp cards, real cards, labels, notes, apply\u002Funapply behavior, and deletion fallbacks now follow a clearer model.\n- **Graph view cleanup**: graph filters are now `Box`, `Link`, and `Tag`; the old hierarchy filter was removed because it was not a user-facing business concept.\n- **Visual redesign**: paper-like surfaces, calmer typography, dark mode fixes, focus styling, better card creation panels, and a more coherent GraphView.\n- **Layout preservation**: user-placed card positions are saved per box\u002Fworkspace, with reset layout available when needed.\n- **Image export**: box canvases and workspaces can export the current visible canvas as a PNG with clean solid links.\n- **Plugin path**: the early trusted-local plugin SDK is documented for future import\u002Fexport and workflow extensions.\n\n## 1.0 vs 1.5\n\nFolium 1.0 was the first public baseline: local vaults, Electron packaging, card canvases, workspaces, graph view, attachments, backups, and plugin groundwork were already present.\n\nFolium 1.5 is a product-shaping release. The biggest change is not one feature; it is the removal of confusing behavior. The main canvas no longer tries to be every view at once. Workspaces are clearly provisional. GraphView is for global structure. Potential links are suggestions, not structure. This makes 1.5 a better default for real use, while 1.0 remains useful as a reference point for anyone who wants to study or fork the earlier, heavier interaction model.\n\n## Core Ideas\n\n- **Box**: a top-level numbered card such as `1`, `2`, or `3` acts as an index box. Its Folgezettel descendants belong to that box.\n- **Card**: a Markdown note with a stable `luhmannId`.\n- **Real link**: a deliberate `[[link]]` stored in the vault.\n- **Potential link**: an unconfirmed suggestion from naked text references or high-confidence local similarity.\n- **Workspace**: a temporary canvas for arranging cards, notes, and temp cards before committing relationships back to the vault.\n- **Graph**: a global map of Box, Link, and Tag relations.\n\n## Highlights\n\n- **Local-first Markdown**: ordinary `.md` files remain the source of truth.\n- **SQLite index**: the database is an index, not a proprietary storage format.\n- **Persistent layouts**: card positions survive reloads per box and per workspace.\n- **Real and provisional links**: distinguish durable vault links from workspace-only reasoning.\n- **Temp cards**: sketch ideas in a workspace, then promote them into the vault when they are ready.\n- **Tag views**: collect tag-related cards and create real links from that context.\n- **Graph focus mode**: hover or select a node to emphasize first-degree relations.\n- **Canvas PNG export**: export a box or workspace as an image for sharing or documentation.\n- **Trusted local plugins**: plugin APIs are intentionally local and trusted, similar in spirit to Obsidian community plugins.\n\n## Install\n\nFolium 1.5 currently targets macOS Apple Silicon for local packaged builds.\n\n```bash\nnpm install\nnpm run pack:desktop\nopen release\u002Fmac-arm64\u002FFolium.app\n```\n\nThe app is not code-signed yet. On macOS, first launch may require right-click -> Open or approval in System Settings.\n\nYou can also run the web frontend and backend during development:\n\n```bash\nnpm install\n\n# Terminal 1\nnpm run dev:backend\n\n# Terminal 2\nnpm run dev:frontend\n```\n\nOpen:\n\n```text\nhttp:\u002F\u002F127.0.0.1:5173\n```\n\nDesktop development:\n\n```bash\nnpm run dev:backend\nnpm run dev:frontend\nnpm run dev:desktop\n```\n\n## Project Structure\n\n```text\nFolium\u002F\n├── packages\u002F\n│   ├── backend\u002F      Fastify API, SQLite index, vault scanner, watcher\n│   ├── frontend\u002F     React, Vite, Tailwind, card\u002Fworkspace\u002Fgraph UI\n│   └── desktop\u002F      Electron shell and preload bridge\n├── docs\u002F             GitHub Pages, method docs, plugin notes\n└── example-vault\u002F    Development sample vault\n```\n\n## Card Format\n\n```markdown\n---\nluhmannId: 1a\ntitle: Feature Selection and Dimensionality\ntags: [ML, Research]\ncrossLinks: [1a1, 3b]\n---\n\nBody text can include [[1a1]] or [[Card Title]] links.\n```\n\n`status` is derived by the app. Top-level numbered cards and cards with Folgezettel children are treated as index cards.\n\n## Security Model\n\nFolium is designed as a local desktop app.\n\n- The packaged backend binds to `127.0.0.1`.\n- Packaged API requests require an Electron-provided per-run token.\n- Vault file routes and backup restore paths are guarded against traversal and zip-slip.\n- Attachments live inside the selected vault root.\n- Plugins use a **trusted local plugin** model. They are not a hard sandbox.\n\n## Documentation\n\n- [Using Folium and Luhmann-style cards](https:\u002F\u002Fxc-xinze.github.io\u002FFolium\u002Fdocumentation.html)\n- [Plugin SDK v0](docs\u002Fplugin-sdk-v0.md)\n- [Workspace link model](docs\u002Fworkspace-link-model.md)\n- [Workspace JSON schema](docs\u002Fworkspace-json-schema.md)\n- [Electron packaging notes](docs\u002Felectron.md)\n\n## Roadmap\n\n- Signed and notarized macOS builds.\n- Release artifacts through GitHub Releases.\n- Plugin SDK stabilization.\n- Obsidian export plugin as the first official plugin example.\n- Windows\u002FLinux packaging.\n- Mobile-friendly architecture after the desktop workflow settles.\n\n## License\n\nNo license has been selected yet. Treat the repository as source-available until a license is added.\n","Folium是一个以桌面为主的Markdown知识工作空间，旨在通过链接、盒子和临时画布来组织思考。它允许用户将笔记保存为本地的Markdown文件，并构建了一个基于SQLite的本地索引，提供卡片盒子、双向链接、潜在链接、图谱探索、标签视图、临时工作区、附件处理以及一个可靠的本地插件界面等核心功能。特别适合需要深度思考、研究和写作的个人或团队使用，帮助用户在保持笔记结构清晰的同时，通过直观的链接和图谱方式增强信息之间的关联性。","2026-06-11 04:05:26","CREATED_QUERY"]