xiaowei-system/skills/software-development/obsidian-plugin/references/impl-notes.md

织忆 Obsidian 插件 — 实现参考

本文件记录 ~/projects/memoryweave/plugins/obsidian/ 的具体实现细节。

插件功能清单

子任务	文件	状态
E5.1.1 插件骨架	manifest.json, main.ts, styles.css	✅
E5.1.2 记忆侧边栏面板	src/MemoryView.ts	✅
E5.1.3 实体图谱视图（D3）	src/GraphView.ts	✅
E5.1.4 记忆搜索模态框	src/SearchModal.ts	✅
E5.1.5 实体详情视图	src/GraphView.ts（点击节点递归展开）	✅
E5.1.6 蒸馏状态面板	src/MemoryView.ts（顶部红色警告条，30s 轮询）	✅

API 端点使用

功能	端点	方法
统计	/api/v1/stats	GET
记忆列表	/api/v1/memories?namespace=&limit=&offset=	GET
语义搜索	/api/v1/search/recall	POST
图谱邻居	/api/v1/graph/navigate?entity=&depth=1	GET
图谱导出	/api/v1/graph/export?namespace=&limit=	GET
PageRank	/api/v1/graph/pagerank?limit=	GET
按实体查记忆	/api/v1/memories/by-entity/{entity}	GET
蒸馏状态	/api/v1/distill/status	GET
蒸馏配额	/api/v1/distill/quota	GET

构建与安装

# 构建
cd ~/projects/memoryweave/plugins/obsidian
npm install  # 只需运行一次
node esbuild.config.mjs

# 安装
make install-obsidian

# 或手动
mkdir -p ~/.obsidian/plugins/zhiyi-memory/
cp main.js manifest.json styles.css ~/.obsidian/plugins/zhiyi-memory/

图谱渲染关键代码

D3.js 从 CDN 动态加载，GraphView 使用 forceSimulation + forceLink + forceManyBody + forceCenter + forceCollide。节点颜色按 category 区分，中心节点（当前选中实体）红色高亮。点击节点递归调用 fetchNeighbors 加载下一层。

已解决的技术问题

1. npm 路径错误：~/.local/bin/npm → 实际路径 ~/.local/lib/npm/bin/npm-cli.js（修复方法见 openclaw skill）
2. TypeScript LSP 无 obsidian 类型：正常，Obsidian host 运行时提供，esbuild 不受影响
3. CORS 预检：Go 中间件处理 OPTIONS 请求，返回 204