用途
obsidian-tc（全称 Obsidian Turbocharged）是一个受治理、面向智能体的 Model Context Protocol（MCP）服务器，用于访问 Obsidian 笔记库，面向人类用户和 AI 智能体。它不采用对多年笔记的原始文件系统访问，而是让每一次工具调用都经过同一条管道：认证、文件夹 ACL、只读终止开关、破坏性操作的人工确认（HITL）以及审计日志。
主要能力
- 工具面：提供跨 31 个领域的 163 个工具，默认全部可见，也可通过 opt-in 的 profile: "core" 使用更小的集合。通过 3 个元工具（find_capability、describe_capability、call_capability）加标准 search / fetch 对进行发现与调用。
- 受治理的工具：每个能力都是带声明访问作用域的受治理工具。读工具（read_note、search_vault、get_backlinks 等）不会修改笔记库；写工具覆盖整篇笔记与部分编辑（write_note、append_note、patch_note 支持标题与块锚定编辑、update_frontmatter、标签与链接维护）；删除与移动（delete_note、move_note）、批量操作（bulk_set_property）、执行（execute_command）和管理（add_vault、reload_vault）由独立的作用域类别控制。
- 融合检索：结合全文、向量与图检索。
- 记忆层：包含情节、衰减、遗忘，存放在笔记库内并受相同 ACL 约束。
- 多笔记库原生支持：支持多笔记库场景。
- 可插拔嵌入：语义搜索默认使用捆绑的离线嵌入器；npm/Docker 在发布前需要显式提供者。
- 接口模式：toolFacade.mode 可选 triad（默认）、domain 或 flat（另有已被取代的 auto），仅改变边界，不绕过任何门禁。
使用方式
- 60 秒快速开始：每个笔记工具和词法搜索可立即使用；语义搜索默认使用捆绑嵌入器。多笔记库、认证或 ACL 需使用配置文件。
- 安装：以 npm 包（provenance-signed）、Docker 镜像（GHCR）、.mcpb 捆绑包和独立二进制形式分发。
- Claude Code 插件：启动 npx -y obsidian-tc，启用时询问配置文件路径。
- Cursor / VS Code 手动配置：使用同一对象 {"command": "npx", "args": ["-y", "obsidian-tc"], "env": {"OBSIDIAN_TC_CONFIG": "/ABS/config.json"}}。
- VS Code Insiders：另有安装方式。
- Grok Build 和 Muse Code（1.4.0+）：读取同一市场。
- claude.ai 和 ChatGPT（远程 HTTP）：见 distribution 文档。
- TC Bridge 插件：可选的 Obsidian 配套插件，扩展 Local REST API，增加 Obsidian 专有功能端点（Templater、Dataview、Tasks、Excalidraw、Git、Remotely Save）。需先安装 Local REST API，复用其 bearer-token 认证，仅桌面端。所有文件系统级功能无需该插件即可工作。
适用场景
- 需要让 AI 智能体在受治理、可审计的前提下访问 Obsidian 笔记库。
- 需要多笔记库、认证、文件夹 ACL 等治理能力。
- 需要融合检索与笔记库内记忆层。
- 从其他 Obsidian MCP 服务器迁移（见 docs/CUTOVER.md）。
限制
- 项目自述为比多数方案更重的产品：若只需最小占用、只读访问或完全不用 MCP，单一可信人类操作单笔记库、只读包装器或 Obsidian URI/Local REST API 插件可能已足够。
- 零设置、仅源码检出场景受限：笔记库从磁盘读取；语义搜索默认使用捆绑离线嵌入器；npm/Docker 在发布前需要显式提供者。
- 零配置会放弃认证/ACL：obsidian-tc /path/to/vault 启动时认证关闭、无文件夹 ACL，仅因本地运行才可接受；治理是 opt-in。
- 采用 AGPL-3.0-only 的网络 copyleft 条款，非宽松许可；可能存在商业许可，需开讨论。
- 单维护者项目。
- 检索变更通过统计发布规则对照私有黄金集进行门控；README 上曾出现的头条数字已于 2026-08-07 因不可复现而撤回，详见 docs/EVALUATION.md。
- 与 Obsidian 及其制造商 Dynalist Inc. 无关联，未获其背书；"Obsidian" 是 Dynalist Inc. 商标，仅作指称性使用。
其他信息
- 版本：v1.33.1，已发布到 npm（provenance-signed 包），容器镜像在 GHCR。
- 文档站点：https://obsidian-tc.the40thieves.io
- 相关文档：docs/QUICKSTART.md、docs/WHY.md、SECURITY.md、docs/CUTOVER.md、docs/EVALUATION.md、ARCHITECTURE.md。
- 贡献遵循 DCO，见 CONTRIBUTING.md；行为准则与安全政策见相应文件。
