Obsidian 内置 AI 功能

Obsidian 1.8+ 引入了官方内置 AI 功能，无需安装第三方插件或配置 API 即可使用智能写作辅助。

概述

什么是内置 AI？

内置 AI 是 Obsidian 官方提供的 AI 服务，直接集成在应用中，开箱即用：

特性	说明
智能补全	编辑时提供 AI 驱动的文本补全建议
文本变换	选中文本后进行润色、翻译、总结等操作
聊天助手	在侧边栏与 AI 对话，基于笔记内容回答问题
无需配置	不需要自行申请 API Key 或安装插件
官方支持	由 Obsidian 团队维护，保证兼容性和稳定性

内置 AI vs 第三方 AI 插件

特性	内置 AI	第三方插件
配置难度	零配置	需要申请 API Key
数据隐私	通过 Obsidian 服务器中转	取决于插件和 API
功能深度	基础到中级	可高度自定义
成本	按使用量付费	取决于 API 提供商
自定义程度	有限	高（Prompt、模型、参数）
离线使用	不支持	本地模型可支持

如何选择？

• 新手/轻度使用：内置 AI 开箱即用，适合快速上手
• 进阶/重度使用：第三方插件提供更多自定义选项，详见 AI 插件配置
• 隐私优先：完全本地化方案，详见 本地 AI 部署

启用内置 AI

步骤一：启用核心插件

1. 打开设置 → 核心插件
2. 找到「AI」并启用
3. 阅读并同意使用条款

步骤二：基本设置

在设置 → 核心插件 → AI 中配置：

设置项	说明	推荐值
启用智能补全	输入时自动触发补全	开启
补全触发延迟	输入后多久触发补全	500ms
默认操作语言	AI 响应的语言	跟随系统 / 中文
使用统计	匿名使用数据收集	按需

智能补全

基本用法

在编辑器中输入内容，AI 会根据上下文提供补全建议：

1. 自动触发：输入时自动检测补全时机
2. 手动触发：使用快捷键 Ctrl/Cmd + J 手动请求补全
3. 接受建议：按 Tab 接受补全内容
4. 拒绝建议：按 Esc 或继续输入忽略

补全场景

笔记开头

# 项目计划

AI 建议：
本项目旨在实现...

列表续写

## 待办事项

- [ ] 完成需求文档
- [ ] 

AI 建议：
- [ ] 设计系统架构
- [ ] 编写技术方案
- [ ] 评审并确定方案

代码注释

```python
def calculate_score(items):

AI 建议：
    """根据项目列表计算总分"""
    total = 0
    for item in items:
        total += item.score
    return total
```

补全技巧

• 提供上下文：在笔记开头写清楚主题，补全质量更高
• 使用标题结构：良好的标题层级帮助 AI 理解文档结构
• 渐进式写作：先写大纲，再逐节展开，AI 补全更准确
• 及时修正：如果补全方向不对，修改后重新触发

文本变换

使用方式

1. 选中要处理的文本
2. 右键 → AI 变换，或使用命令面板 Ctrl/Cmd + P → 搜索「AI」
3. 选择变换操作

内置变换操作

操作	说明	示例
润色	改善文本表达	口语 → 书面语
简化	精简冗余内容	长句 → 短句
扩写	扩展内容深度	提纲 → 段落
总结	提取核心要点	文章 → 摘要
翻译	翻译为指定语言	中文 → 英文
修正	修正语法和拼写	错句 → 正句
语气调整	调整表达风格	随意 → 正式
列表化	将段落转为列表	段落 → 要点

自定义变换

在设置中添加自定义变换 Prompt：

自定义变换:
  - 名称: "生成问答"
    Prompt: "将以下内容转换为问答格式，每个要点生成一个问答对"
  - 名称: "添加示例"
    Prompt: "为以下内容添加具体示例说明"
  - 名称: "对比分析"
    Prompt: "将以下内容与类似概念进行对比分析"

文本变换工作流

graph LR
    A[选中文本] --> B[选择变换操作]
    B --> C[AI 处理]
    C --> D[预览结果]
    D --> E{满意？}
    E -->|是| F[应用变换]
    E -->|否| G[调整或重试]
    G --> C

聊天助手

打开聊天面板

1. 点击右侧边栏的 AI 图标
2. 或使用命令面板 → 「AI: 打开聊天」
3. 或使用快捷键 Ctrl/Cmd + Shift + J

聊天功能

基本对话

直接在聊天框输入问题，AI 会根据对话上下文回答。

基于笔记回答

聊天助手可以引用当前库中的笔记内容：

• 引用当前笔记：聊天时会参考当前打开的笔记
• 引用选中内容：选中文本后打开聊天，自动将其作为上下文
• 引用链接笔记：提及 [[笔记名]] 时，AI 会参考该笔记内容

对话操作

操作	快捷键	说明
发送消息	Enter	发送当前输入
换行	Shift + Enter	在输入框中换行
重新生成	—	对上一条回复重新生成
复制回复	—	复制 AI 回复到剪贴板
插入到笔记	—	将回复插入当前光标位置

聊天使用场景

知识问答

用户：解释一下双链笔记和传统文件夹组织的区别
AI：双链笔记和传统文件夹组织的核心区别在于关联方式...

用户：在我的笔记库中有哪些相关的实践？
AI：根据你的笔记，我看到以下相关内容：
- [[MOC 笔记法]] 中提到了索引页的用法
- [[渐进式笔记法]] 中讨论了链接的演进

写作辅助

用户：帮我扩展这个段落：${选中的文本}
AI：[基于选中内容进行扩展]

用户：用更正式的语气重写
AI：[以正式风格重写内容]

内容分析

用户：总结这篇笔记的核心观点
AI：这篇笔记的核心观点包括：...

用户：有哪些潜在的逻辑问题？
AI：从逻辑角度审视，以下几点值得注意：...

隐私与安全

数据处理方式

内置 AI 的数据处理流程：

graph LR
    A[你的输入] --> B[Obsidian 服务器]
    B --> C[AI 服务提供商]
    C --> D[生成回复]
    D --> B
    B --> A

隐私承诺

• Obsidian 不会存储你的笔记内容
• 请求仅用于生成回复，处理后即删除
• 不使用你的数据训练 AI 模型
• 通信全程加密

隐私设置

设置	说明	推荐
发送前确认	每次发送前弹出确认	敏感内容开启
排除文件夹	指定文件夹内容不发送	开启，排除敏感文件夹
使用统计	匿名使用数据收集	按需

保护隐私的最佳实践

1. 不要发送敏感信息：密码、密钥、个人身份信息等
2. 使用排除文件夹：将敏感笔记放入排除文件夹
3. 启用发送确认：避免意外发送内容
4. 考虑本地部署：如需完全隐私，使用 本地 AI 方案

费用说明

计费方式

内置 AI 采用按使用量计费：

项目	说明
计费单位	Token 数（约 1 个中文字 ≈ 2 Token）
免费额度	新用户赠送一定额度
查看用量	设置 → AI → 用量统计
充值方式	Obsidian 账户余额

节省费用的技巧

1. 精确的 Prompt：明确指令减少来回对话
2. 选中文本变换：比全笔记分析更省 Token
3. 合理使用补全：不需要时关闭自动补全
4. 批量处理：一次处理多段内容比多次单段更高效

与其他 AI 方案集成

内置 AI + 第三方插件

内置 AI 和第三方 AI 插件可以共存：

场景	推荐方案
日常写作辅助	内置 AI
复杂模板生成	Templater + Text Generator
知识库问答	Smart Connections
完全本地化	Ollama + Text Generator
高度自定义 Prompt	Text Generator

从内置 AI 迁移到第三方

如果内置 AI 无法满足需求，可以平滑迁移：

1. 保留内置 AI 用于日常简单任务
2. 安装 Text Generator 用于复杂场景
3. 配置 本地 AI 用于隐私敏感内容
4. 逐步建立个人 Prompt 库

常见问题

内置 AI 支持哪些语言？

内置 AI 支持中文、英文等主流语言。在设置中可以指定默认响应语言。

内置 AI 可以离线使用吗？

不可以。内置 AI 需要网络连接，请求通过 Obsidian 服务器处理。如需离线使用，请考虑 本地 AI 部署。

补全建议不准确怎么办？

1. 在笔记开头提供更多上下文
2. 使用标题和列表组织内容结构
3. 手动触发补全（Ctrl/Cmd + J）而非自动触发
4. 调整补全触发延迟

内置 AI 和 Copilot 插件有什么区别？

特性	内置 AI	Copilot 插件
来源	Obsidian 官方	社区插件
配置	零配置	需要 API Key
深度集成	原生体验	插件界面
自定义	有限	更多选项

如何完全禁用内置 AI？

在设置 → 核心插件中关闭「AI」即可。

下一步

• AI 插件配置 — 第三方 AI 插件的详细配置
• 本地 AI 部署 — 完全本地化的 AI 方案
• AI 最佳实践 — Prompt 优化和使用技巧
• AI 隐私与安全 — 深入了解数据安全