Harzva/dsh-obsidian

README 摘要

dsh-obsidian 把本机项目接入 Obsidian：扫描项目 → 生成 wiki 链接笔记 → Obsidian 图谱视图自动呈现知识图谱。 Bridge local projects into Obsidian and let its graph view render the knowledge graph. [!IMPORTANT] Independent, unofficial DSH integration. Works fully offline: the Obsidian app does not need to be running while notes are generated, and no data ever leaves your machine. Obsidian 如何"识别"本机项目并建立知识图谱 Obsidian 的图谱视图不扫描代码仓库，它只索引 vault 里的 .md 文件 + [[wiki 链接]] 。 所以关键不是"让 Obsidian 去扫描项目"，而是 把项目转译成 Obsidian 能理解的结构 ，三步完成： 1. 发现 ：按 package.json / Cargo.toml / go.mod / pyproject.toml / .git 识别项目； 提取 npm name、依赖、描述、技术栈、git remote。 2. 建边 ：依赖（npm name、 workspace: 、 file: 引用）、技术栈、根目录区域、关键词主题 —— 全部确定性，无虚构关联。 3. 落盘 ：每个项目一张笔记， graph/tech/ 、 graph/areas/ 、 graph/topics/ 是 hub 笔记。 Obsidian 打开 vault 即自动索引，图谱视图里 hub 成为簇中心、依赖成为连线。 在 DSH 里只需两步：设置页 扫描项目 → 生成知识图谱 。 What works - Native DSH tab at Settings → Plugins → Obsidian . - Bounded local project scanner with manifest detection and tech-stack extraction. - Deterministic knowledge graph: dependency / tech / area / topic edges. - Dual transport: Obsidian Local REST API (Bearer, loopback) with filesystem fallback — no REST plugin needed. - Incremental writes via graph/.dsh-obsidian-s…

分类