1. 项目概述一个为知识管理注入AI能力的Obsidian插件如果你和我一样是个重度Obsidian用户每天在笔记的海洋里构建自己的第二大脑那你一定体会过那种“想法很多但下笔难”的瞬间。我们搭建了复杂的双链网络积累了海量的笔记碎片但如何让这些静态的笔记“活”起来产生新的连接和洞见一直是个挑战。直到我遇到了nhaouari/obsidian-textgenerator-plugin这个项目它像是一把钥匙为我打开了在个人知识库PKM中集成人工智能辅助创作的大门。简单来说Text Generator (TextGen) 插件是一个为Obsidian笔记软件设计的强大工具。它的核心功能是让你能够直接在Obsidian编辑器内调用诸如OpenAI的GPT系列、Anthropic的Claude等大型语言模型LLM对你的笔记内容进行各种智能操作。无论是基于现有笔记生成新的内容大纲、总结冗长的会议记录、润色一段生硬的文字还是将零散的想法扩展成一篇结构完整的文章它都能胜任。这个项目在GitHub上由开发者nhaouari维护已经成为了Obsidian社区中最受欢迎和功能最全面的AI插件之一。它解决的正是知识工作者从“收集”到“创造”的关键一跃。我们不再仅仅是信息的囤积者而是可以利用AI作为思考的协作者激发灵感提升写作和知识整合的效率。无论你是学生、研究者、写作者还是任何需要处理大量文本信息的人只要你在使用Obsidian这个插件都值得你深入探索。接下来我将结合自己数月的深度使用经验为你彻底拆解这个插件的设计思路、核心玩法、实战配置以及那些官方文档里不会写的“坑”与技巧。2. 插件核心设计思路与生态位解析2.1 为什么是Obsidian插件与笔记软件的共生关系要理解TextGen插件的价值首先要理解Obsidian的独特之处。Obsidian的核心是本地优先和双向链接。所有笔记都以纯文本Markdown格式存储在本地这赋予了用户完全的数据控制权和隐私安全感。同时通过[[ ]]语法建立的双向链接网络使得知识不再是孤岛而是形成了有机的图谱。TextGen插件的设计哲学完美契合了这一点。它没有尝试做一个独立的AI写作工具而是选择深度嵌入到Obsidian的工作流中。它的所有操作都围绕“当前笔记”、“当前选区”、“链接的笔记”这些上下文展开。这意味着AI的“思考”素材直接来源于你精心构建的知识图谱生成的成果也直接沉淀回你的知识库成为图谱的新节点。这种设计避免了数据在多个应用间搬运的割裂感实现了“思考-记录-增强-再思考”的闭环。2.2 核心功能矩阵不止于“生成文本”很多人初看插件名“Text Generator”会以为它只是个简单的文本补全工具。实际上它的功能矩阵相当丰富可以概括为以下几个核心维度内容生成与扩展这是基础功能。你可以选中一段文字或基于全文让AI对其进行续写、扩写、重写或翻译。例如将几个要点扩展成段落或将一段口语化记录改写成正式报告。摘要与提炼快速总结长篇内容。对于一篇冗长的访谈记录或研究论文可以一键生成核心要点摘要极大提升信息消化速度。结构化与重组将无序的头脑风暴或会议记录按照指定的格式如SWOT分析、Pros and Cons列表、会议纪要模板进行重组赋予杂乱信息以结构。对话与问答在笔记中与AI进行多轮对话。你可以就笔记中的某个概念进行深入提问AI会基于笔记上下文和你提供的知识进行回答相当于一个驻留在你笔记里的专家。模板化批量处理这是它的高阶能力。通过创建自定义“模板”你可以将一系列复杂的提示词Prompt和操作固化下来用于批量处理笔记。比如为所有“读书笔记”类型的文件自动生成一个“核心观点与批判性思考”的章节。2.3 技术架构浅析连接Obsidian与AI服务的桥梁从技术实现上看TextGen插件扮演了一个智能网关的角色。其架构可以简单理解为[Obsidian笔记内容] - [TextGen插件] - [封装为API请求] - [外部AI服务提供商(OpenAI, Anthropic等)] - [返回AI生成结果] - [插件解析并插入笔记]插件的核心工作包括上下文管理智能地获取并组合当前编辑器中的选中文本、当前笔记全文、甚至通过链接关联的其他笔记内容作为提供给AI的“上下文”。提示词工程集成提供了强大的模板系统允许用户使用{{ }}语法嵌入变量如{{title}},{{content}},{{selection}}动态构建高质量的提示词。多模型适配通过统一的接口支持配置不同供应商的API只需更换API密钥和端点地址即可在GPT-4、Claude、Ollama本地模型等模型间切换。结果处理提供多种结果插入方式替换选区、在光标处插入、追加到文末等并可以设置自动添加引用或分隔线保持笔记的整洁和可追溯性。这种设计使得插件本身轻量而强大将复杂的AI交互简化为Obsidian用户熟悉的按钮和命令技术复杂性被很好地隐藏在了背后。3. 从零开始完整配置与核心操作指南3.1 环境准备与插件安装首先你需要在电脑上安装并运行Obsidian。确保你使用的是较新的版本以获得最好的兼容性。安装TextGen插件有两种推荐方式社区插件市场安装最简单打开Obsidian进入“设置” - “社区插件”。点击“浏览”在搜索框中输入“Text Generator”。找到插件后点击“安装”安装完成后记得点击“启用”。手动安装适用于尝鲜测试版或特定版本访问项目的GitHub发布页面https://github.com/nhaouari/obsidian-textgenerator-plugin/releases下载最新的main.js、manifest.json等文件。在你的Obsidian仓库的.obsidian/plugins/目录下新建一个名为obsidian-textgenerator-plugin的文件夹。将下载的文件解压后放入该文件夹。重启Obsidian在“社区插件”列表中启用它。注意安装后插件默认是未配置状态无法直接使用。最关键的一步是配置AI模型的API。3.2 核心配置详解连接你的AI大脑点击插件图标或进入设置页面的“Text Generator”选项你会看到配置面板。核心配置集中在“设置”选项卡选择AI引擎OpenAI最常用的选择。你需要一个OpenAI API密钥。在https://platform.openai.com/api-keys创建。OpenAI (Custom URL)如果你使用第三方代理服务需自行确保合规性可以在此处填写自定义的API端点。Anthropic使用Claude模型。需要Anthropic的API密钥。Ollama本地部署大模型的绝佳选择。如果你在本地电脑上运行了Ollama服务例如运行了ollama run llama3可以选择此项。API端点通常是http://localhost:11434。这完全在本地运行无需网络隐私性最强但需要一定的硬件资源推荐16GB以上内存。其他插件还支持Azure OpenAI、Hugging Face等提供了极高的灵活性。API密钥与基础参数API Key将你在对应平台申请的密钥粘贴在此处。请务必妥善保管不要泄露。模型选择根据你选择的引擎下拉菜单中会出现对应的模型列表。例如OpenAI下可选gpt-3.5-turbo,gpt-4等。对于日常笔记处理gpt-3.5-turbo性价比很高对于需要深度推理和复杂创作gpt-4效果更佳。最大生成长度限制单次生成的最大token数。一般设置1024或2048即可避免生成长篇大论消耗过多额度。温度控制生成文本的随机性。值越高接近1.0结果越创造性、不可预测值越低接近0结果越确定、保守。对于总结、提炼等任务建议0.1-0.3对于头脑风暴、创意写作可以调到0.7-0.9。高级设置上下文策略决定插件将哪些内容发送给AI。有“仅选中文本”、“当前活动文件”、“活动文件前后文件”等选项。这是保证生成结果相关性的关键。通常对于针对某段内容的操作选“仅选中文本”对于需要结合整篇文章背景的问答选“当前活动文件”。系统提示词你可以在这里设置一个全局的“角色指令”例如“你是一个严谨的学术助手擅长总结和提炼观点”。这个指令会包含在每一次请求中有助于稳定AI的行为风格。实操心得初次使用建议从OpenAI的gpt-3.5-turbo开始它的响应速度快成本极低适合熟悉插件各项功能。强烈建议尝试本地部署的Ollama。虽然初始设置稍有门槛但一旦成功你将获得一个完全免费、隐私无忧、随时可用的AI助手。Llama 3、Mistral等开源模型的能力已经足够应对大部分笔记辅助任务。温度参数不要一成不变。根据任务类型动态调整这个参数是提升生成质量的小窍门。3.3 基础操作命令面板与右键菜单配置完成后你就可以开始使用了。主要有两种交互方式命令面板按下CtrlPWindows/Linux或CmdPMac输入“Text Generator”即可看到所有相关命令如“生成文本”、“总结”、“重写”、“扩写”等。选中命令根据提示操作即可。右键菜单在编辑器中选择一段文本右键单击在上下文菜单中会出现“Text Generator”子菜单里面包含了常用的操作非常便捷。一个典型的工作流你写了一篇读书笔记但感觉观点比较零散。你选中所有笔记内容。右键 - Text Generator - “Summarize”总结。几秒后一段凝练的摘要就插入到了你的笔记底部。4. 进阶利器模板功能与自定义提示词工程如果说基础功能是开箱即用那么模板功能才是TextGen插件真正发挥威力的地方。它允许你将复杂的、重复性的AI交互流程固化下来一键执行。4.1 模板是什么模板是一个后缀名为.tg的文本文件里面包含了提示词你精心设计的、用于指导AI完成特定任务的指令。变量使用{{ }}包裹的动态占位符插件会在执行时用实际内容替换它们。配置可以指定该模板使用的模型、温度等参数覆盖全局设置。4.2 创建你的第一个模板假设我们想创建一个“将会议记录转化为待办事项”的模板。打开模板管理器在TextGen插件设置中找到“模板”选项卡点击“打开模板管理器”。创建新模板点击“创建新模板”命名为MeetingToActionPlan.tg。编辑模板内容%* // 这是一个Nunjucks模板可以在其中使用JavaScript逻辑 // 下面定义了一个“system”提示词用于设定AI角色 -% {{system}}你是一个高效的项目经理助理擅长从杂乱的对话中识别出行动项、负责人和截止日期。 {{user}}请仔细阅读以下会议记录提取出所有明确或隐含的**行动项**并以Markdown表格的形式输出。表格应包含“行动项描述”、“负责人”如未明确则写“待定”、“截止日期”如未明确则写“待定”三列。 会议记录 {{content}}保存并使用保存模板。以后在任何会议记录笔记中只需打开命令面板运行“Text Generator: Generate text with template”然后选择你创建的MeetingToActionPlan.tg插件就会自动将当前笔记的全部内容{{content}}填入提示词发送给AI并返回一个格式清晰的待办事项表格。4.3 核心变量与实用模板示例插件提供了丰富的内置变量让模板极其灵活{{title}}当前笔记的标题。{{content}}当前笔记的全文内容。{{selection}}当前选中的文本。{{frontmatter}}当前笔记的YAML Frontmatter元数据。{{tags}}当前笔记的标签。{{date}},{{time}}当前日期和时间。更多实用模板思路文献笔记提炼器{{system}}你是一位专业的学科研究员。 {{user}}请对以下学术文本进行提炼 1. 用一句话概括核心论点。 2. 列出三个最重要的支撑论据或发现。 3. 指出其研究方法或结论的一个潜在局限性。 文本 {{content}}周报自动生成器结合Obsidian的Dataview插件先查询出过去一周创建的或修改过的“工作日志”笔记然后将这些笔记的内容作为{{content}}输入给一个周报总结模板。创意写作提示扩展当你只有一个模糊的想法时。{{system}}你是一个创意写作教练。 {{user}}我有一个关于“{{selection}}”的故事创意。请为我生成 - 3个可能的故事开头 - 2个潜在的情节转折点 - 1个故事主题的深化建议注意事项模板中的提示词质量直接决定输出质量。尽量清晰、具体、分步骤地提出要求。可以在模板开头使用%* ... -%来写JavaScript逻辑实现更复杂的变量处理例如条件判断、循环等但这需要一定的编程基础。为不同的任务创建不同的模板文件夹便于管理。5. 深度集成将AI能力编织进你的工作流TextGen插件的强大之处在于它能与Obsidian的其他插件和核心功能无缝结合创造出自动化的工作流。5.1 与“核心插件”和“Dataview”联动每日笔记你可以在每日笔记的模板中加入一个固定的章节比如“## 今日灵感”。然后设置一个TextGen模板命令每天打开日记时自动让AI基于前几天的日记内容生成几个今日可探索的想法或问题。Dataview查询Dataview能让你用查询语句从笔记库中提取数据。你可以先使用Dataview查询出所有“状态为待复习”的闪卡笔记然后将查询结果列表作为{{content}}输入给一个“生成复习提纲”的TextGen模板。5.2 与“Templater”插件的高级自动化Templater插件允许你执行更复杂的脚本。你可以编写一个Templater模板在创建新笔记时自动触发根据笔记标题和标签调用TextGen生成一个初步的大纲。将大纲插入笔记的特定位置。甚至可以根据大纲再调用TextGen为每个章节生成一些提示性问题。这种级别的自动化能将内容创作的启动成本降到最低。5.3 自定义快捷键与快速触发对于最常用的几个操作如“总结选中内容”、“润色文字”你可以在Obsidian的快捷键设置中为它们分配专属快捷键。例如我将CtrlAltS绑定为“总结选中文本”这样在任何编辑场景下我都可以在选中文字后瞬间获得摘要流畅度堪比思维的自然延伸。6. 避坑指南与性能优化实战在实际使用中我踩过不少坑也总结出一些优化体验的技巧。6.1 常见问题与解决方案问题现象可能原因解决方案插件无响应或提示“Failed to fetch”1. API密钥错误或失效。2. 网络连接问题特别是使用自定义URL或本地Ollama时。3. API额度已用尽。1. 检查密钥是否正确是否有空格。去对应平台确认密钥状态。2. 检查网络尝试ping通API端点。对于Ollama确认服务是否运行ollama serve。3. 检查OpenAI等平台的用量和余额。生成的内容完全无关或质量低下1. 上下文内容过多或过少导致AI误解。2. 温度参数设置过高过于随机。3. 提示词不够清晰。1. 调整“上下文策略”尝试“仅选中文本”或确保当前文件内容与任务强相关。2. 降低温度值如设为0.2。3. 优化提示词使用更具体、分步骤的指令。在系统提示词中明确AI角色。使用模板时变量未被替换模板语法错误或变量名拼写错误。检查模板文件确保变量被正确的{{ }}包围且变量名是插件支持的内置变量或你正确定义的变量。生成速度非常慢1. 使用了响应慢的模型如某些大型本地模型。2. 上下文文本过长。3. 网络延迟高。1. 对于即时辅助换用更轻量的模型如gpt-3.5-turbovsgpt-4。2. 在设置中限制“最大上下文长度”。3. 考虑使用本地模型Ollama消除网络延迟。6.2 成本控制与隐私策略使用OpenAI API时刻关注你的用量https://platform.openai.com/usage。为不同任务选择不同模型日常问答、总结用gpt-3.5-turbo复杂分析、创意写作再用gpt-4。在插件设置中设定“最大生成长度”避免意外生成超长文本。拥抱本地模型这是平衡成本、隐私和响应速度的最佳长期方案。Ollama使得在个人电脑上运行70亿参数7B的模型变得非常简单。虽然生成质量可能略低于顶尖商用模型但对于笔记总结、思路扩展、文本润色等任务完全足够且零成本、零延迟、数据完全不出本地。敏感信息处理即使使用API也应避免向AI发送高度敏感的个人信息如密码、身份证号、详细财务数据。对于包含此类信息的笔记在使用插件前可先进行手动脱敏处理。6.3 我的高效使用心法明确人机分工AI是强大的协作者但不是主角。我的原则是事实、观点、核心逻辑由我主导表达优化、结构梳理、灵感激发交给AI。永远要对AI生成的内容进行批判性审阅和修改。迭代式交互不要指望一次生成就得到完美结果。采用“生成-评估-修改提示-再生成”的迭代方式。例如先让AI生成大纲你觉得第二部分不够好就单独选中第二部分让AI基于原有内容进行重写或扩写。建立个人模板库将你验证过有效的提示词保存为模板。随着模板库的丰富你会发现自己处理各类文本的效率呈指数级提升。我按照“写作”、“学习”、“工作”、“创意”分门别类管理模板。结合双链思考在让AI处理一篇笔记前先通过Obsidian的图谱功能或反向链接面板快速浏览一下与这篇笔记相关联的其他想法。有时人工建立的连接能为AI提供更丰富的思考背景甚至你可以将几个关联笔记的内容一起选中让AI进行综合分析与生成。这个插件彻底改变了我与我的知识库互动的方式。它不再是一个被动的存储仓库而是一个能随时与我对话、激发我思考的伙伴。从最初的简单文本补全到如今通过一套自定义模板库几乎自动化地处理日常写作、学习复盘和工作规划Text Generator插件已经成为了我Obsidian环境中不可或缺的“核心插件”。它所带来的不仅仅是效率的提升更是一种思维模式的拓展——当你知道有一个强大的工具可以随时帮你厘清思路、拓展边界时你记录和构建知识的勇气与野心也会随之增长。
Obsidian Text Generator插件：用AI激活你的个人知识库
1. 项目概述一个为知识管理注入AI能力的Obsidian插件如果你和我一样是个重度Obsidian用户每天在笔记的海洋里构建自己的第二大脑那你一定体会过那种“想法很多但下笔难”的瞬间。我们搭建了复杂的双链网络积累了海量的笔记碎片但如何让这些静态的笔记“活”起来产生新的连接和洞见一直是个挑战。直到我遇到了nhaouari/obsidian-textgenerator-plugin这个项目它像是一把钥匙为我打开了在个人知识库PKM中集成人工智能辅助创作的大门。简单来说Text Generator (TextGen) 插件是一个为Obsidian笔记软件设计的强大工具。它的核心功能是让你能够直接在Obsidian编辑器内调用诸如OpenAI的GPT系列、Anthropic的Claude等大型语言模型LLM对你的笔记内容进行各种智能操作。无论是基于现有笔记生成新的内容大纲、总结冗长的会议记录、润色一段生硬的文字还是将零散的想法扩展成一篇结构完整的文章它都能胜任。这个项目在GitHub上由开发者nhaouari维护已经成为了Obsidian社区中最受欢迎和功能最全面的AI插件之一。它解决的正是知识工作者从“收集”到“创造”的关键一跃。我们不再仅仅是信息的囤积者而是可以利用AI作为思考的协作者激发灵感提升写作和知识整合的效率。无论你是学生、研究者、写作者还是任何需要处理大量文本信息的人只要你在使用Obsidian这个插件都值得你深入探索。接下来我将结合自己数月的深度使用经验为你彻底拆解这个插件的设计思路、核心玩法、实战配置以及那些官方文档里不会写的“坑”与技巧。2. 插件核心设计思路与生态位解析2.1 为什么是Obsidian插件与笔记软件的共生关系要理解TextGen插件的价值首先要理解Obsidian的独特之处。Obsidian的核心是本地优先和双向链接。所有笔记都以纯文本Markdown格式存储在本地这赋予了用户完全的数据控制权和隐私安全感。同时通过[[ ]]语法建立的双向链接网络使得知识不再是孤岛而是形成了有机的图谱。TextGen插件的设计哲学完美契合了这一点。它没有尝试做一个独立的AI写作工具而是选择深度嵌入到Obsidian的工作流中。它的所有操作都围绕“当前笔记”、“当前选区”、“链接的笔记”这些上下文展开。这意味着AI的“思考”素材直接来源于你精心构建的知识图谱生成的成果也直接沉淀回你的知识库成为图谱的新节点。这种设计避免了数据在多个应用间搬运的割裂感实现了“思考-记录-增强-再思考”的闭环。2.2 核心功能矩阵不止于“生成文本”很多人初看插件名“Text Generator”会以为它只是个简单的文本补全工具。实际上它的功能矩阵相当丰富可以概括为以下几个核心维度内容生成与扩展这是基础功能。你可以选中一段文字或基于全文让AI对其进行续写、扩写、重写或翻译。例如将几个要点扩展成段落或将一段口语化记录改写成正式报告。摘要与提炼快速总结长篇内容。对于一篇冗长的访谈记录或研究论文可以一键生成核心要点摘要极大提升信息消化速度。结构化与重组将无序的头脑风暴或会议记录按照指定的格式如SWOT分析、Pros and Cons列表、会议纪要模板进行重组赋予杂乱信息以结构。对话与问答在笔记中与AI进行多轮对话。你可以就笔记中的某个概念进行深入提问AI会基于笔记上下文和你提供的知识进行回答相当于一个驻留在你笔记里的专家。模板化批量处理这是它的高阶能力。通过创建自定义“模板”你可以将一系列复杂的提示词Prompt和操作固化下来用于批量处理笔记。比如为所有“读书笔记”类型的文件自动生成一个“核心观点与批判性思考”的章节。2.3 技术架构浅析连接Obsidian与AI服务的桥梁从技术实现上看TextGen插件扮演了一个智能网关的角色。其架构可以简单理解为[Obsidian笔记内容] - [TextGen插件] - [封装为API请求] - [外部AI服务提供商(OpenAI, Anthropic等)] - [返回AI生成结果] - [插件解析并插入笔记]插件的核心工作包括上下文管理智能地获取并组合当前编辑器中的选中文本、当前笔记全文、甚至通过链接关联的其他笔记内容作为提供给AI的“上下文”。提示词工程集成提供了强大的模板系统允许用户使用{{ }}语法嵌入变量如{{title}},{{content}},{{selection}}动态构建高质量的提示词。多模型适配通过统一的接口支持配置不同供应商的API只需更换API密钥和端点地址即可在GPT-4、Claude、Ollama本地模型等模型间切换。结果处理提供多种结果插入方式替换选区、在光标处插入、追加到文末等并可以设置自动添加引用或分隔线保持笔记的整洁和可追溯性。这种设计使得插件本身轻量而强大将复杂的AI交互简化为Obsidian用户熟悉的按钮和命令技术复杂性被很好地隐藏在了背后。3. 从零开始完整配置与核心操作指南3.1 环境准备与插件安装首先你需要在电脑上安装并运行Obsidian。确保你使用的是较新的版本以获得最好的兼容性。安装TextGen插件有两种推荐方式社区插件市场安装最简单打开Obsidian进入“设置” - “社区插件”。点击“浏览”在搜索框中输入“Text Generator”。找到插件后点击“安装”安装完成后记得点击“启用”。手动安装适用于尝鲜测试版或特定版本访问项目的GitHub发布页面https://github.com/nhaouari/obsidian-textgenerator-plugin/releases下载最新的main.js、manifest.json等文件。在你的Obsidian仓库的.obsidian/plugins/目录下新建一个名为obsidian-textgenerator-plugin的文件夹。将下载的文件解压后放入该文件夹。重启Obsidian在“社区插件”列表中启用它。注意安装后插件默认是未配置状态无法直接使用。最关键的一步是配置AI模型的API。3.2 核心配置详解连接你的AI大脑点击插件图标或进入设置页面的“Text Generator”选项你会看到配置面板。核心配置集中在“设置”选项卡选择AI引擎OpenAI最常用的选择。你需要一个OpenAI API密钥。在https://platform.openai.com/api-keys创建。OpenAI (Custom URL)如果你使用第三方代理服务需自行确保合规性可以在此处填写自定义的API端点。Anthropic使用Claude模型。需要Anthropic的API密钥。Ollama本地部署大模型的绝佳选择。如果你在本地电脑上运行了Ollama服务例如运行了ollama run llama3可以选择此项。API端点通常是http://localhost:11434。这完全在本地运行无需网络隐私性最强但需要一定的硬件资源推荐16GB以上内存。其他插件还支持Azure OpenAI、Hugging Face等提供了极高的灵活性。API密钥与基础参数API Key将你在对应平台申请的密钥粘贴在此处。请务必妥善保管不要泄露。模型选择根据你选择的引擎下拉菜单中会出现对应的模型列表。例如OpenAI下可选gpt-3.5-turbo,gpt-4等。对于日常笔记处理gpt-3.5-turbo性价比很高对于需要深度推理和复杂创作gpt-4效果更佳。最大生成长度限制单次生成的最大token数。一般设置1024或2048即可避免生成长篇大论消耗过多额度。温度控制生成文本的随机性。值越高接近1.0结果越创造性、不可预测值越低接近0结果越确定、保守。对于总结、提炼等任务建议0.1-0.3对于头脑风暴、创意写作可以调到0.7-0.9。高级设置上下文策略决定插件将哪些内容发送给AI。有“仅选中文本”、“当前活动文件”、“活动文件前后文件”等选项。这是保证生成结果相关性的关键。通常对于针对某段内容的操作选“仅选中文本”对于需要结合整篇文章背景的问答选“当前活动文件”。系统提示词你可以在这里设置一个全局的“角色指令”例如“你是一个严谨的学术助手擅长总结和提炼观点”。这个指令会包含在每一次请求中有助于稳定AI的行为风格。实操心得初次使用建议从OpenAI的gpt-3.5-turbo开始它的响应速度快成本极低适合熟悉插件各项功能。强烈建议尝试本地部署的Ollama。虽然初始设置稍有门槛但一旦成功你将获得一个完全免费、隐私无忧、随时可用的AI助手。Llama 3、Mistral等开源模型的能力已经足够应对大部分笔记辅助任务。温度参数不要一成不变。根据任务类型动态调整这个参数是提升生成质量的小窍门。3.3 基础操作命令面板与右键菜单配置完成后你就可以开始使用了。主要有两种交互方式命令面板按下CtrlPWindows/Linux或CmdPMac输入“Text Generator”即可看到所有相关命令如“生成文本”、“总结”、“重写”、“扩写”等。选中命令根据提示操作即可。右键菜单在编辑器中选择一段文本右键单击在上下文菜单中会出现“Text Generator”子菜单里面包含了常用的操作非常便捷。一个典型的工作流你写了一篇读书笔记但感觉观点比较零散。你选中所有笔记内容。右键 - Text Generator - “Summarize”总结。几秒后一段凝练的摘要就插入到了你的笔记底部。4. 进阶利器模板功能与自定义提示词工程如果说基础功能是开箱即用那么模板功能才是TextGen插件真正发挥威力的地方。它允许你将复杂的、重复性的AI交互流程固化下来一键执行。4.1 模板是什么模板是一个后缀名为.tg的文本文件里面包含了提示词你精心设计的、用于指导AI完成特定任务的指令。变量使用{{ }}包裹的动态占位符插件会在执行时用实际内容替换它们。配置可以指定该模板使用的模型、温度等参数覆盖全局设置。4.2 创建你的第一个模板假设我们想创建一个“将会议记录转化为待办事项”的模板。打开模板管理器在TextGen插件设置中找到“模板”选项卡点击“打开模板管理器”。创建新模板点击“创建新模板”命名为MeetingToActionPlan.tg。编辑模板内容%* // 这是一个Nunjucks模板可以在其中使用JavaScript逻辑 // 下面定义了一个“system”提示词用于设定AI角色 -% {{system}}你是一个高效的项目经理助理擅长从杂乱的对话中识别出行动项、负责人和截止日期。 {{user}}请仔细阅读以下会议记录提取出所有明确或隐含的**行动项**并以Markdown表格的形式输出。表格应包含“行动项描述”、“负责人”如未明确则写“待定”、“截止日期”如未明确则写“待定”三列。 会议记录 {{content}}保存并使用保存模板。以后在任何会议记录笔记中只需打开命令面板运行“Text Generator: Generate text with template”然后选择你创建的MeetingToActionPlan.tg插件就会自动将当前笔记的全部内容{{content}}填入提示词发送给AI并返回一个格式清晰的待办事项表格。4.3 核心变量与实用模板示例插件提供了丰富的内置变量让模板极其灵活{{title}}当前笔记的标题。{{content}}当前笔记的全文内容。{{selection}}当前选中的文本。{{frontmatter}}当前笔记的YAML Frontmatter元数据。{{tags}}当前笔记的标签。{{date}},{{time}}当前日期和时间。更多实用模板思路文献笔记提炼器{{system}}你是一位专业的学科研究员。 {{user}}请对以下学术文本进行提炼 1. 用一句话概括核心论点。 2. 列出三个最重要的支撑论据或发现。 3. 指出其研究方法或结论的一个潜在局限性。 文本 {{content}}周报自动生成器结合Obsidian的Dataview插件先查询出过去一周创建的或修改过的“工作日志”笔记然后将这些笔记的内容作为{{content}}输入给一个周报总结模板。创意写作提示扩展当你只有一个模糊的想法时。{{system}}你是一个创意写作教练。 {{user}}我有一个关于“{{selection}}”的故事创意。请为我生成 - 3个可能的故事开头 - 2个潜在的情节转折点 - 1个故事主题的深化建议注意事项模板中的提示词质量直接决定输出质量。尽量清晰、具体、分步骤地提出要求。可以在模板开头使用%* ... -%来写JavaScript逻辑实现更复杂的变量处理例如条件判断、循环等但这需要一定的编程基础。为不同的任务创建不同的模板文件夹便于管理。5. 深度集成将AI能力编织进你的工作流TextGen插件的强大之处在于它能与Obsidian的其他插件和核心功能无缝结合创造出自动化的工作流。5.1 与“核心插件”和“Dataview”联动每日笔记你可以在每日笔记的模板中加入一个固定的章节比如“## 今日灵感”。然后设置一个TextGen模板命令每天打开日记时自动让AI基于前几天的日记内容生成几个今日可探索的想法或问题。Dataview查询Dataview能让你用查询语句从笔记库中提取数据。你可以先使用Dataview查询出所有“状态为待复习”的闪卡笔记然后将查询结果列表作为{{content}}输入给一个“生成复习提纲”的TextGen模板。5.2 与“Templater”插件的高级自动化Templater插件允许你执行更复杂的脚本。你可以编写一个Templater模板在创建新笔记时自动触发根据笔记标题和标签调用TextGen生成一个初步的大纲。将大纲插入笔记的特定位置。甚至可以根据大纲再调用TextGen为每个章节生成一些提示性问题。这种级别的自动化能将内容创作的启动成本降到最低。5.3 自定义快捷键与快速触发对于最常用的几个操作如“总结选中内容”、“润色文字”你可以在Obsidian的快捷键设置中为它们分配专属快捷键。例如我将CtrlAltS绑定为“总结选中文本”这样在任何编辑场景下我都可以在选中文字后瞬间获得摘要流畅度堪比思维的自然延伸。6. 避坑指南与性能优化实战在实际使用中我踩过不少坑也总结出一些优化体验的技巧。6.1 常见问题与解决方案问题现象可能原因解决方案插件无响应或提示“Failed to fetch”1. API密钥错误或失效。2. 网络连接问题特别是使用自定义URL或本地Ollama时。3. API额度已用尽。1. 检查密钥是否正确是否有空格。去对应平台确认密钥状态。2. 检查网络尝试ping通API端点。对于Ollama确认服务是否运行ollama serve。3. 检查OpenAI等平台的用量和余额。生成的内容完全无关或质量低下1. 上下文内容过多或过少导致AI误解。2. 温度参数设置过高过于随机。3. 提示词不够清晰。1. 调整“上下文策略”尝试“仅选中文本”或确保当前文件内容与任务强相关。2. 降低温度值如设为0.2。3. 优化提示词使用更具体、分步骤的指令。在系统提示词中明确AI角色。使用模板时变量未被替换模板语法错误或变量名拼写错误。检查模板文件确保变量被正确的{{ }}包围且变量名是插件支持的内置变量或你正确定义的变量。生成速度非常慢1. 使用了响应慢的模型如某些大型本地模型。2. 上下文文本过长。3. 网络延迟高。1. 对于即时辅助换用更轻量的模型如gpt-3.5-turbovsgpt-4。2. 在设置中限制“最大上下文长度”。3. 考虑使用本地模型Ollama消除网络延迟。6.2 成本控制与隐私策略使用OpenAI API时刻关注你的用量https://platform.openai.com/usage。为不同任务选择不同模型日常问答、总结用gpt-3.5-turbo复杂分析、创意写作再用gpt-4。在插件设置中设定“最大生成长度”避免意外生成超长文本。拥抱本地模型这是平衡成本、隐私和响应速度的最佳长期方案。Ollama使得在个人电脑上运行70亿参数7B的模型变得非常简单。虽然生成质量可能略低于顶尖商用模型但对于笔记总结、思路扩展、文本润色等任务完全足够且零成本、零延迟、数据完全不出本地。敏感信息处理即使使用API也应避免向AI发送高度敏感的个人信息如密码、身份证号、详细财务数据。对于包含此类信息的笔记在使用插件前可先进行手动脱敏处理。6.3 我的高效使用心法明确人机分工AI是强大的协作者但不是主角。我的原则是事实、观点、核心逻辑由我主导表达优化、结构梳理、灵感激发交给AI。永远要对AI生成的内容进行批判性审阅和修改。迭代式交互不要指望一次生成就得到完美结果。采用“生成-评估-修改提示-再生成”的迭代方式。例如先让AI生成大纲你觉得第二部分不够好就单独选中第二部分让AI基于原有内容进行重写或扩写。建立个人模板库将你验证过有效的提示词保存为模板。随着模板库的丰富你会发现自己处理各类文本的效率呈指数级提升。我按照“写作”、“学习”、“工作”、“创意”分门别类管理模板。结合双链思考在让AI处理一篇笔记前先通过Obsidian的图谱功能或反向链接面板快速浏览一下与这篇笔记相关联的其他想法。有时人工建立的连接能为AI提供更丰富的思考背景甚至你可以将几个关联笔记的内容一起选中让AI进行综合分析与生成。这个插件彻底改变了我与我的知识库互动的方式。它不再是一个被动的存储仓库而是一个能随时与我对话、激发我思考的伙伴。从最初的简单文本补全到如今通过一套自定义模板库几乎自动化地处理日常写作、学习复盘和工作规划Text Generator插件已经成为了我Obsidian环境中不可或缺的“核心插件”。它所带来的不仅仅是效率的提升更是一种思维模式的拓展——当你知道有一个强大的工具可以随时帮你厘清思路、拓展边界时你记录和构建知识的勇气与野心也会随之增长。
