Files
memoryweave/plugins/obsidian/README.md
T
xiaowei 2a350cf781 fix(distill): max_tokens 800→1200 — Agnes推理token预算不足
Agnes 2.0-flash是推理模型,推理token占大量预算。
800仍不够→JSON截断(parse error: unexpected end of JSON input)。
1200确保推理+正文都够用。
2026-08-20 01:13:06 +08:00

96 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 织忆 Obsidian 插件
> 给织忆记忆系统提供 Obsidian 内置可视化界面。
## 功能
- **🧠 记忆面板**:侧边栏展示记忆列表,分页浏览,支持蒸馏队列提醒
- **📐 图谱视图**:D3.js force-directed graph,输入实体探索 ego-network,节点可拖拽
- **🔍 搜索模态框**:`Ctrl+P` / 命令面板调起,实时语义搜索(debounce 300ms)
## 安装
### 方式一:本地开发安装
1. **构建插件**
```bash
cd plugins/obsidian
npm install
node esbuild.config.mjs
```
2. **Obsidian 开启第三方插件**
- 设置 → 社区插件 → 开启「第三方插件」
- 安全模式会阻止社区插件,按提示关闭
3. **复制到插件目录**
```bash
cp -r plugins/obsidian ~/.obsidian/plugins/zhiyi-memory/
```
4. **重载 Obsidian**
- 命令面板(`Ctrl+P`)输入 `Reload`
- 或重启 Obsidian
5. **启用插件**
- 设置 → 社区插件 → 找到「织忆」→ 启用
### 方式二:开发者热重载
```bash
# 进入插件目录,watch 模式
node esbuild.config.mjs --watch
# 修改后自动重新构建,Obsidian 中按 Ctrl+P → Reload vault
```
## 使用
### 命令面板(`Ctrl+P`)
- `织忆:打开织忆记忆面板` — 右侧边栏记忆列表
- `织忆:打开织忆图谱面板` — 图谱探索视图
- `织忆:搜索织忆记忆` — 语义搜索弹窗
### 图谱操作
- **输入实体名** → 回车 → 加载该实体的 ego-network(中心节点 + 一跳邻居)
- **点击节点** → 展开邻居(递归探索)
- **滚轮缩放** / **拖拽平移** / **节点拖动重排**
- **点击「Top 节点」** → 自动加载 PageRank 最高的实体
### 蒸馏状态
- 记忆面板顶部蒸馏队列 > 0 时自动出现红色警告条
## API 依赖
插件调用 `http://localhost:7821` 的织忆 Go API,确保服务运行:
```bash
systemctl --user start zhiyid
```
## 文件结构
```
plugins/obsidian/
├── manifest.json # Obsidian 插件清单
├── styles.css # 全局样式
├── main.ts # 插件入口(源)
├── main.js # esbuild 构建产物(Obsidian 加载这个)
├── src/
│ ├── api.ts # Go API 客户端
│ ├── MemoryView.ts # 记忆侧边栏面板
│ ├── GraphView.ts # D3 图谱渲染
│ └── SearchModal.ts # 搜索弹窗
├── esbuild.config.mjs # 构建配置
└── README.md
```
## 技术细节
- D3.js v7 从 CDN(`cdn.jsdelivr.net/npm/d3@7`)动态加载,不打包
- Obsidian 插件 API 类型由 Obsidian host 在运行时提供
- CORS 由 Go API 中间件处理(`Access-Control-Allow-Origin: app://obsidian.md`)
- 构建产物 `main.js` 约 200KB(minified,gzip 后更小)