让AI在你的Obsidian里直接跑终端命令：Agent Client for Obsidian的Terminal集成全解

让AI在你的Obsidian里直接跑终端命令Agent Client for Obsidian的Terminal集成全解【免费下载链接】obsidian-agent-clientBring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-agent-clientAgent Client for Obsidian简称 Agent Client是一款 Obsidian 社区插件它通过 Agent Client ProtocolACP把 Claude Code、Codex、Gemini CLI 等 AI 编码 Agent 直接带进你的笔记库。其中最实用的能力之一就是Terminal 集成AI 不只是嘴上说说而是真的在你系统里执行终端命令并把输出实时显示在聊天面板中。本文将带你快速上手并讲清楚它背后的安全机制。终端集成能做什么普通聊天机器人只能回答文字而接入 Agent Client 后AI Agent 可以️执行真实 Shell 命令git status、npm run build、脚本、数据处理命令一应俱全实时回传输出命令的 stdout / stderr 直接显示在聊天气泡里的终端块中✅显示退出码命令结束后展示 Exit Code成功绿色、失败红色一眼看出结果支持多 Agent 并行侧边栏、标签页、浮动窗口里同时跑多个 Agent各自独立执行命令最快上手3步让AI跑通第一条命令第 1 步安装插件进入 Obsidian 的Settings → Community Plugins → Browse搜索Agent Client点击 Install 并 Enable。第 2 步安装并认证一个 Agent插件本身不内置模型需要本机安装一个支持 ACP 的 Agent任选其一Agent说明Claude CodeAnthropic经 ACP 适配器接入CodexOpenAI经 ACP 适配器接入Gemini CLIGoogle加--experimental-acp启动OpenCode / Kiro / Hermes 等内置 ACP 支持各 Agent 的完整配置方法见官方文档docs/agent-setup/。第 3 步开始聊天点击左侧缎带上的机器人图标或命令面板搜索 Open chat view然后直接下达指令例如运行git log --oneline -5并用中文总结最近的 5 次提交Agent 会通过 ACP 的terminal/create请求创建一个终端进程执行命令后把输出贴回聊天。你全程在 Obsidian 内完成无需切换到系统终端。原理全解一条命令是如何执行的理解底层机制你才能放心使用。整个流程由四个模块协作完成1️⃣ ACP 协议层的终端请求插件实现了 ACP 协议中的全部 5 个终端方法见 docs/reference/acp-support.mdterminal/create— Agent 请求创建终端并执行命令terminal/output— 插件回传累积输出terminal/wait_for_exit— 等待进程结束terminal/kill/terminal/release— 终止与释放终端2️⃣ 进程管理器 TerminalManagerterminal-handler.ts 中的TerminalManager负责真正干活以子进程方式spawn命令src/acp/terminal-handler.ts捕获 stdout 和 stderr合并为统一输出流支持输出字节上限超长日志自动从头部截断防止内存膨胀每个终端拥有唯一 ID结束状态exitCode / signal会被记录3️⃣ 聊天中的实时渲染TerminalBlock.tsx 是聊天里的终端块组件。它以100ms 的间隔轮询终端输出src/ui/TerminalBlock.tsx因此即使是快速完成的命令也能立刻看到结果进程退出后停止轮询并显示带颜色的退出码。4️⃣ 权限守门人Agent 每次请求执行命令前插件都会弹出权限横幅由你决定是否放行——这是下一节的重点。权限与安全放心让AI执行命令插件的核心安全设计是**每一次动作都可见、可拒绝**️逐条审批每个终端命令都会触发权限提示你可以 Allow本次允许、Always Allow始终允许或 Reject拒绝️会话模式输入框工具栏可切换 Default、Accept Edits、Plan Mode只规划不执行、Dont Ask、Bypass Permissions 等模式适合不同信任场景密钥保护API Key 存储在 Obsidian 的 Keychain 中绝不以明文落盘️仅桌面端Terminal 集成依赖本地子进程仅支持桌面版 Obsidian⚠️ 请注意Agent 拥有与终端相同的完整系统权限Auto-allow permissions默认关闭会跳过所有提示请仅在充分理解风险后开启。Windows 用户必看WSL 模式Windows 下的推荐姿势是开启WSL ModeSettings → Agent Client → Windows Subsystem for Linux在 WSL 内安装 Node.js 和 Agent兼容性最好插件会自动通过WSLENV将环境变量转发进 WSLterminal-handler.ts非 WSL 模式下插件还会自动从注册表补全 PATH解决Electron 启动时 PATH 不全导致命令找不到的经典问题常见问题与排查方法参考docs/help/troubleshooting.md。进阶玩法给项目开一个专属聊天任意目录会话使用New chat in directory把聊天指向任意文件夹——代码项目、写作项目都行Agent 会自动读取该目录的上下文文件同时你仍可以用提及其库里的笔记笔记内嵌聊天用代码块在任意笔记中嵌入实时聊天加persist让对话重启后依然存活会话管理Session Manager 列出所有对话及实时状态包括等待权限一键跳转总结Agent Client 的 Terminal 集成让 Obsidian 从笔记工具升级为AI Agent 工作台AI 直接跑命令、实时回输出、权限全程可控。配合笔记引用、多 Agent 并行和会话管理你的知识库可以同时成为 AI 的手和脑。核心文件速查终端进程管理src/acp/terminal-handler.tsACP 协议处理src/acp/acp-handler.ts聊天终端块渲染src/ui/TerminalBlock.tsxACP 支持清单docs/reference/acp-support.md快速上手指南docs/getting-started/quick-start.md【免费下载链接】obsidian-agent-clientBring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-agent-client创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考