From 3a467704d6ddfad805d03906bff9accf1a9c894e Mon Sep 17 00:00:00 2001
From: oliver <zhoutianjun127@126.com>
Date: Sun, 17 May 2026 12:16:46 +0800
Subject: [PATCH] chore(cursor): add Trilium MCP template and ignore local
 secrets

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 .cursor/mcp.json.example        | 14 ++++++++++++++
 .cursor/rules/trilium-notes.mdc | 12 ++++++++++++
 .gitignore                      |  8 ++++++++
 3 files changed, 34 insertions(+)
 create mode 100644 .cursor/mcp.json.example
 create mode 100644 .cursor/rules/trilium-notes.mdc

diff --git a/.cursor/mcp.json.example b/.cursor/mcp.json.example
new file mode 100644
index 00000000..d3ed33b7
--- /dev/null
+++ b/.cursor/mcp.json.example
@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "triliumnext-mcp": {
+      "command": "npx",
+      "args": ["-y", "triliumnext-mcp"],
+      "env": {
+        "TRILIUM_API_URL": "http://127.0.0.1:37840/etapi",
+        "TRILIUM_API_TOKEN": "<paste-from-trilium-settings>",
+        "PERMISSIONS": "READ;WRITE",
+        "VERBOSE": "false"
+      }
+    }
+  }
+}
diff --git a/.cursor/rules/trilium-notes.mdc b/.cursor/rules/trilium-notes.mdc
new file mode 100644
index 00000000..10eec064
--- /dev/null
+++ b/.cursor/rules/trilium-notes.mdc
@@ -0,0 +1,12 @@
+---
+description: >-
+  Trilium 笔记维护。结构：收集箱/工作（Oclaw·NETX 各挂技术文档，NAS 项目）/生活/资料/归档。禁止改动 Demo、Default、Journal、博客。
+alwaysApply: false
+---
+
+# Trilium 笔记维护
+
+- MCP：`triliumnext-mcp`（`.cursor/mcp.json`）
+- 规范：`skills/_workspace/generalist/knowledge-base-manager/SKILL.md`
+- **禁止改动**：Trilium Demo、Default、Journal、博客（`#kb/immutable`）
+- 仓库文档同步：`.\scripts\import_oclaw_netx_docs_to_trilium.ps1`（`-Update`）
diff --git a/.gitignore b/.gitignore
index 47dbbc77..fae64064 100644
--- a/.gitignore
+++ b/.gitignore
@@ -46,6 +46,9 @@ runtime/operations/scripts/.run/
 desktop/node_modules/
 desktop/dist/
 desktop/runtime-data/
+# Cursor MCP（含 Trilium token，复制 mcp.json.example 后本地填写）
+.cursor/mcp.json
+
 # _local/ 下其余文件均忽略（密钥、mcp_local.env 等）
 platform/data/*.sqlite
 platform/data/*.sqlite-journal
@@ -73,3 +76,8 @@ vendor/oclaw/
 
 # 仅本机使用的私有 skill（勿提交）
 skills/_workspace/generalist/knowledge-base-manager/
+
+# 本机 Trilium 文档导入（依赖个人 TRILIUM_API_*，勿提交；入口在仓库根 scripts/）
+scripts/import_oclaw_netx_docs_to_trilium.py
+scripts/import_oclaw_netx_docs_to_trilium.ps1
+scripts/import_oclaw_netx_docs_to_trilium.sh