企业官网建设流程全解析

obsidian-local-gpt（Local GPT）是 Obsidian 里主打「隐私 + 离线」的 AI 助手插件，可对接 Ollama 或 OpenAI 类接口。它的核心交互入口就是Action Palette（动作面板）——一个内嵌在笔记编辑区里的智能输入框。本文带你用/指令快速切换模型与参数、用@文件 chips 一键注入上下文，再用「替换选区」把 AI 答案直接写回你选中的文字，一次彻底搞懂这套高效工作流。

什么是 Action Palette？先认识这个输入框

Action Palette 不是普通弹窗，而是直接“贴”在你笔记光标位置的一个可编辑输入区。它把三件事整合进同一个框里：

面板底部常驻一行提示：“使用/输入命令，@引用文件”，并显示当前提供商 · 模型 · 创造力徽章。它的占位文案与提示定义见 actionPaletteController.ts，本地化文案见 zh.json。

💡 快捷键：Enter发送、Shift+Enter换行、Esc关闭菜单或面板、Ctrl/Cmd+A全选输入内容、Alt+R（macOS 为⌥+R）切换替换选区。

/指令：像终端一样切换模型与参数

在面板里输入/，会弹出指令菜单。内置指令由 actionPaletteOptions.ts 定义，包含：

• /provider—— 切换 AI 提供商（如 Ollama、OpenAI）
• /model—— 切换该提供商下的具体模型
• /creativity—— 调整“创造力”（即 temperature）：默认 / 无 / 低 / 中 / 高
• /system—— 切换系统提示词，也可「清除系统提示」
• /reasoning—— 为本次请求选择推理模式（需 AI Providers 支持）

指令匹配规则：/必须是行首或前面是空白字符，否则不触发。这一判断在 actionPaletteTriggers.ts 中实现。

小技巧：选完一项后，指令会从输入框里“摘掉”，转成底部的彩色徽章。点击徽章可随时重新打开对应菜单——例如点击 🧠 推理徽章、创造力徽章即可再次修改，无需重新输入/。徽章渲染逻辑见 ActionPalette.svelte。

⚡ 输入/或@菜单无匹配结果时按Enter，会直接把你输入的内容当作提示词发送；有结果时Enter/Tab用于选中当前高亮项。

@文件 chips：把笔记与 PDF 变成上下文

输入@会弹出文件菜单，可搜索并引用你笔记库里的.md与.pdf文件。选中后它会变成一颗「文件 chip」，作为 RAG 上下文随提示词一起发送。

• 支持的文件来源：所有 Markdown 文件 + 所有 PDF 文件，见 actionPaletteFiles.ts
• 引用写法必须带扩展名，如@会议记录.md、@Spec.pdf；识别正则见 actionPaletteTypes.ts
• 同一菜单最多显示 15 条结果（MAX_DROPDOWN_RESULTS）
• 移除 chip：直接点击那颗 chip 即可删除引用，实现于 actionPaletteController.ts

多个 chip 可叠加，方便一次性把多篇笔记 + 一份 PDF 一起喂给模型。

替换选区：把答案“写回”你选中的文字

这是最实用的能力。当你先选中一段文字、再打开 Action Palette 时，面板右下角会出现一个替换切换图标。

• 开启后：AI 答案会替换你选中的那段文字
• 关闭时：答案默认插入在选区下方
• 切换方式：点击图标，或按Alt+R/⌥+R
• 你的选择会被记住（直到 Obsidian 重启）

底层开关逻辑在 actionPaletteController.ts，UI 上的替换按钮与状态见 ActionPalette.svelte。

典型场景：选中一段英文 → 打开面板 → 输入“翻译成中文” → 开启替换 → 发送，原文直接被翻译结果覆盖。

历史与效率：上下键翻出你敲过的提示

面板还内置提示词历史：当光标在第一行时按↑、在最后一行时按↓，可在你之前发送过的提示之间来回切换，避免重复打字。相关实现见 actionPaletteNavigation.ts。

常见问题速查（FAQ）

• 为什么/或@不弹菜单？前面必须紧跟空白（或处于行首），且要带扩展名 / 指令名；触发判断见 actionPaletteTriggers.ts。
• /reasoning没有显示？需要把 AI Providers 插件更新到支持推理模式的版本，面板会自动隐藏不支持的指令。
• 替换选区图标不见了？只有在“选中文字后再打开面板”时才会出现，纯光标定位（未选中文本）时不显示。
• 创造力设了却没生效？面板里的“API 默认”会针对本次请求覆盖全局设置，见 README.md。

相关源码与配置路径

• 面板 UI 主体：ActionPalette.svelte
• 核心控制器（输入、提交、替换切换）：actionPaletteController.ts
• /与@触发逻辑：actionPaletteTriggers.ts
• 指令 / 文件 / 模型等选项与过滤：actionPaletteOptions.ts
• 键盘导航与快捷键：actionPaletteNavigation.ts
• 常量与正则（前缀、上限）：actionPaletteTypes.ts
• 中文文案：zh.json

掌握/指令、@文件 chips 和「替换选区」这三件套，你就能把 Local GPT 变成一个真正离线、私密的“智能笔记副驾驶”。