[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-RAIT-09--obsidian-agent-client":3,"tool-RAIT-09--obsidian-agent-client":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",157379,2,"2026-04-15T23:32:42",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":72,"owner_avatar_url":73,"owner_bio":74,"owner_company":75,"owner_location":76,"owner_email":75,"owner_twitter":77,"owner_website":75,"owner_url":78,"languages":79,"stars":96,"forks":97,"last_commit_at":98,"license":99,"difficulty_score":100,"env_os":101,"env_gpu":102,"env_ram":102,"env_deps":103,"category_tags":109,"github_topics":110,"view_count":32,"oss_zip_url":75,"oss_zip_packed_at":75,"status":17,"created_at":117,"updated_at":118,"faqs":119,"releases":148},7971,"RAIT-09\u002Fobsidian-agent-client","obsidian-agent-client","Bring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.","obsidian-agent-client 是一款专为 Obsidian 打造的插件，它通过代理客户端协议（ACP），让你能直接在笔记库中调用 Claude Code、Codex、Gemini CLI 等主流 AI 智能体。这款工具解决了传统 AI 交互与本地知识库割裂的痛点，用户无需切换窗口，即可在熟悉的写作环境中与 AI 对话、引用特定笔记（@语法）、粘贴图片甚至让 AI 执行终端命令。\n\n它特别适合依赖 Obsidian 进行知识管理的开发者、研究人员及重度笔记用户。对于需要结合代码编写、文献整理或复杂任务规划的人群，它能将 AI 的计算能力无缝融入工作流。其技术亮点在于基于 Zed 团队开发的 ACP 标准，实现了多智能体并行会话、浮动聊天窗口以及原生支持 MCP（模型上下文协议）服务器，这意味着用户可以灵活切换不同 AI 模型，且无需在插件内重复配置后端服务。无论是想快速记录灵感，还是进行深度的代码辅助开发，obsidian-agent-client 都能让你的 Obsidian  vault 进化为真正的智能工作台。","\u003Ch1 align=\"center\">Agent Client Plugin for Obsidian\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdownloads\u002FRAIT-09\u002Fobsidian-agent-client\u002Ftotal\" alt=\"GitHub Downloads\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002FRAIT-09\u002Fobsidian-agent-client\" alt=\"License\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002FRAIT-09\u002Fobsidian-agent-client\" alt=\"GitHub release\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002FRAIT-09\u002Fobsidian-agent-client\" alt=\"GitHub last commit\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FRAIT-09\u002Fobsidian-agent-client\u002Fdiscussions\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdiscussions\u002FRAIT-09\u002Fobsidian-agent-client\" alt=\"GitHub Discussions\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"README.ja.md\">日本語はこちら\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.buymeacoffee.com\u002Frait09\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fcdn.buymeacoffee.com\u002Fbuttons\u002Fv2\u002Fdefault-yellow.png\" alt=\"Buy Me A Coffee\" width=\"180\" height=\"50\" >\u003C\u002Fa>\n\u003C\u002Fp>\n\nBring AI agents (Claude Code, Codex, Gemini CLI) directly into Obsidian. Chat with your AI assistant right from your vault.\n\nBuilt on [Agent Client Protocol (ACP)](https:\u002F\u002Fgithub.com\u002Fagentclientprotocol\u002Fagent-client-protocol) by Zed.\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F1c538349-b3fb-44dd-a163-7331cbca7824\n\n## Features\n\n- **Note Mentions**: Reference your notes with `@notename` syntax\n- **Image Attachments**: Paste or drag-and-drop images into the chat\n- **Slash Commands**: Use `\u002F` commands provided by your agent\n- **Multi-Agent Support**: Switch between Claude Code, Codex, Gemini CLI, and custom agents\n- **Multi-Session**: Run multiple agents simultaneously in separate views\n- **Floating Chat**: A persistent, collapsible chat window for quick access\n- **Mode & Model Switching**: Change AI models and agent modes from the chat\n- **Session History**: Resume or fork previous conversations\n- **Chat Export**: Save conversations as Markdown notes\n- **Terminal Integration**: Let agents execute commands and return results\n- **MCP Support**: Agents use their configured MCP servers — no extra setup needed in the plugin\n\n## Installation\n\n### Via BRAT (Recommended)\n\n1. Install the [BRAT](https:\u002F\u002Fgithub.com\u002FTfTHacker\u002Fobsidian42-brat) plugin\n2. Go to **Settings → BRAT → Add Beta Plugin**\n3. Paste: `https:\u002F\u002Fgithub.com\u002FRAIT-09\u002Fobsidian-agent-client`\n4. Enable **Agent Client** from the plugin list\n\n### Manual Installation\n\n1. Download `main.js`, `manifest.json`, `styles.css` from [Releases](https:\u002F\u002Fgithub.com\u002FRAIT-09\u002Fobsidian-agent-client\u002Freleases)\n2. Place them in `VaultFolder\u002F.obsidian\u002Fplugins\u002Fagent-client\u002F`\n3. Enable the plugin in **Settings → Community Plugins**\n\n## Quick Start\n\nOpen a terminal (Terminal on macOS\u002FLinux, PowerShell on Windows) and run the following commands.\n\n1. **Install an agent and its ACP adapter** (e.g., Claude Code):\n   ```bash\n   curl -fsSL https:\u002F\u002Fclaude.ai\u002Finstall.sh | bash   # Install Claude Code\n   npm install -g @agentclientprotocol\u002Fclaude-agent-acp   # Install ACP adapter\n   ```\n\n2. **Login** (skip if using API key):\n   ```bash\n   claude\n   ```\n   Follow the prompts to authenticate with your Anthropic account.\n\n3. **Find the paths**:\n   ```bash\n   which node   # macOS\u002FLinux\n   which claude-agent-acp\n\n   where.exe node   # Windows\n   where.exe claude-agent-acp\n   ```\n\n4. **Configure** in **Settings → Agent Client**:\n   - **Node.js path**: e.g., `\u002Fusr\u002Flocal\u002Fbin\u002Fnode`\n   - **Built-in agents → Claude Code → Path**: e.g., `\u002Fusr\u002Flocal\u002Fbin\u002Fclaude-agent-acp` (not `claude`)\n   - **API key**: Add your key, or leave empty if logged in via CLI\n\n5. **Start chatting**: Click the robot icon in the ribbon\n\n### Setup Guides\n\n- [Claude Code](https:\u002F\u002Frait-09.github.io\u002Fobsidian-agent-client\u002Fagent-setup\u002Fclaude-code.html)\n- [Codex](https:\u002F\u002Frait-09.github.io\u002Fobsidian-agent-client\u002Fagent-setup\u002Fcodex.html)\n- [Gemini CLI](https:\u002F\u002Frait-09.github.io\u002Fobsidian-agent-client\u002Fagent-setup\u002Fgemini-cli.html)\n- [Custom Agents](https:\u002F\u002Frait-09.github.io\u002Fobsidian-agent-client\u002Fagent-setup\u002Fcustom-agents.html) (OpenCode, Qwen Code, Kiro, Mistral Vibe, etc.)\n\n**[Full Documentation](https:\u002F\u002Frait-09.github.io\u002Fobsidian-agent-client\u002F)**\n\n## Development\n\n```bash\nnpm install\nnpm run dev\n```\n\nFor production builds:\n```bash\nnpm run build\n```\n\n## License\n\nApache License 2.0 - see [LICENSE](LICENSE) for details.\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRAIT-09_obsidian-agent-client_readme_c613c27ff58b.png)](https:\u002F\u002Fwww.star-history.com\u002F#RAIT-09\u002Fobsidian-agent-client&Date)\n","\u003Ch1 align=\"center\">Obsidian 的代理客户端插件\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdownloads\u002FRAIT-09\u002Fobsidian-agent-client\u002Ftotal\" alt=\"GitHub 下载量\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002FRAIT-09\u002Fobsidian-agent-client\" alt=\"许可证\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002FRAIT-09\u002Fobsidian-agent-client\" alt=\"GitHub 发布版本\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002FRAIT-09\u002Fobsidian-agent-client\" alt=\"GitHub 最新提交\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FRAIT-09\u002Fobsidian-agent-client\u002Fdiscussions\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdiscussions\u002FRAIT-09\u002Fobsidian-agent-client\" alt=\"GitHub 讨论\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"README.ja.md\">日本語はこちら\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.buymeacoffee.com\u002Frait09\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fcdn.buymeacoffee.com\u002Fbuttons\u002Fv2\u002Fdefault-yellow.png\" alt=\"请我喝杯咖啡\" width=\"180\" height=\"50\" >\u003C\u002Fa>\n\u003C\u002Fp>\n\n将 AI 代理（Claude Code、Codex、Gemini CLI）直接引入 Obsidian。您可以在自己的笔记库中直接与 AI 助手聊天。\n\n基于 Zed 开发的 [Agent Client Protocol (ACP)](https:\u002F\u002Fgithub.com\u002Fagentclientprotocol\u002Fagent-client-protocol) 构建。\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F1c538349-b3fb-44dd-a163-7331cbca7824\n\n## 特性\n\n- **笔记引用**：使用 `@notename` 语法引用您的笔记\n- **图片附件**：可将图片粘贴或拖放到聊天窗口中\n- **斜杠命令**：使用代理提供的 `\u002F` 命令\n- **多代理支持**：可在 Claude Code、Codex、Gemini CLI 和自定义代理之间切换\n- **多会话**：可在不同视图中同时运行多个代理\n- **悬浮聊天**：一个持久且可折叠的聊天窗口，方便快速访问\n- **模式与模型切换**：从聊天界面更改 AI 模型和代理模式\n- **会话历史**：恢复或分支之前的对话\n- **聊天导出**：将对话保存为 Markdown 笔记\n- **终端集成**：允许代理执行命令并返回结果\n- **MCP 支持**：代理使用其配置的 MCP 服务器——无需在插件中进行额外设置\n\n## 安装\n\n### 通过 BRAT（推荐）\n\n1. 安装 [BRAT](https:\u002F\u002Fgithub.com\u002FTfTHacker\u002Fobsidian42-brat) 插件\n2. 进入 **设置 → BRAT → 添加测试版插件**\n3. 粘贴：`https:\u002F\u002Fgithub.com\u002FRAIT-09\u002Fobsidian-agent-client`\n4. 在插件列表中启用 **Agent Client**\n\n### 手动安装\n\n1. 从 [发布页面](https:\u002F\u002Fgithub.com\u002FRAIT-09\u002Fobsidian-agent-client\u002Freleases) 下载 `main.js`、`manifest.json`、`styles.css`\n2. 将它们放置在 `VaultFolder\u002F.obsidian\u002Fplugins\u002Fagent-client\u002F`\n3. 在 **设置 → 社区插件** 中启用该插件\n\n## 快速入门\n\n打开终端（macOS\u002FLinux 上的 Terminal，Windows 上的 PowerShell），并运行以下命令。\n\n1. **安装代理及其 ACP 适配器**（例如 Claude Code）：\n   ```bash\n   curl -fsSL https:\u002F\u002Fclaude.ai\u002Finstall.sh | bash   # 安装 Claude Code\n   npm install -g @agentclientprotocol\u002Fclaude-agent-acp   # 安装 ACP 适配器\n   ```\n\n2. **登录**（如果使用 API 密钥则跳过）：\n   ```bash\n   claude\n   ```\n   按照提示使用您的 Anthropic 账户进行身份验证。\n\n3. **查找路径**：\n   ```bash\n   which node   # macOS\u002FLinux\n   which claude-agent-acp\n\n   where.exe node   # Windows\n   where.exe claude-agent-acp\n   ```\n\n4. **在设置中配置**：\n   - **Node.js 路径**：例如 `\u002Fusr\u002Flocal\u002Fbin\u002Fnode`\n   - **内置代理 → Claude Code → 路径**：例如 `\u002Fusr\u002Flocal\u002Fbin\u002Fclaude-agent-acp`（不是 `claude`）\n   - **API 密钥**：添加您的密钥，或者如果您已通过 CLI 登录，则留空\n\n5. **开始聊天**：点击功能区中的机器人图标\n\n### 设置指南\n\n- [Claude Code](https:\u002F\u002Frait-09.github.io\u002Fobsidian-agent-client\u002Fagent-setup\u002Fclaude-code.html)\n- [Codex](https:\u002F\u002Frait-09.github.io\u002Fobsidian-agent-client\u002Fagent-setup\u002Fcodex.html)\n- [Gemini CLI](https:\u002F\u002Frait-09.github.io\u002Fobsidian-agent-client\u002Fagent-setup\u002Fgemini-cli.html)\n- [自定义代理](https:\u002F\u002Frait-09.github.io\u002Fobsidian-agent-client\u002Fagent-setup\u002Fcustom-agents.html)（OpenCode、Qwen Code、Kiro、Mistral Vibe 等）\n\n**[完整文档](https:\u002F\u002Frait-09.github.io\u002Fobsidian-agent-client\u002F)**\n\n## 开发\n\n```bash\nnpm install\nnpm run dev\n```\n\n用于生产构建：\n```bash\nnpm run build\n```\n\n## 许可证\n\nApache License 2.0 — 详情请参阅 [LICENSE](LICENSE)。\n\n## 星标历史\n\n[![星标历史图表](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRAIT-09_obsidian-agent-client_readme_c613c27ff58b.png)](https:\u002F\u002Fwww.star-history.com\u002F#RAIT-09\u002Fobsidian-agent-client&Date)","# Obsidian Agent Client 快速上手指南\n\n将 Claude Code、Codex、Gemini CLI 等 AI 智能体直接集成到 Obsidian 中，在笔记库内即可与 AI 助手对话。本插件基于 Zed 的 **Agent Client Protocol (ACP)** 构建。\n\n## 环境准备\n\n在开始之前，请确保您的系统满足以下要求：\n\n*   **操作系统**：Windows, macOS, 或 Linux\n*   **核心依赖**：\n    *   **Node.js**：必须安装（用于运行 ACP 适配器）。\n    *   **Obsidian**：最新版本。\n    *   **AI 智能体 CLI**：至少安装一种支持的智能体（如 Claude Code, Codex, Gemini CLI 等）。\n*   **网络环境**：由于涉及 npm 包下载和 AI 服务连接，建议配置合适的网络环境或使用国内镜像源加速 npm 安装。\n\n## 安装步骤\n\n### 1. 安装 Obsidian 插件\n\n推荐使用 **BRAT** 插件安装（便于更新），也可手动安装。\n\n#### 方式一：通过 BRAT 安装（推荐）\n1.  在 Obsidian 中搜索并安装社区插件 **BRAT**。\n2.  进入 `设置` -> `BRAT` -> `Add Beta Plugin`。\n3.  粘贴仓库地址：`https:\u002F\u002Fgithub.com\u002FRAIT-09\u002Fobsidian-agent-client`\n4.  点击添加，然后在社区插件列表中启用 **Agent Client**。\n\n#### 方式二：手动安装\n1.  从 [Releases 页面](https:\u002F\u002Fgithub.com\u002FRAIT-09\u002Fobsidian-agent-client\u002Freleases) 下载 `main.js`, `manifest.json`, `styles.css`。\n2.  将文件放入笔记库目录：`VaultFolder\u002F.obsidian\u002Fplugins\u002Fagent-client\u002F`（若文件夹不存在请新建）。\n3.  在 Obsidian `设置` -> `社区插件` 中启用 **Agent Client**。\n\n### 2. 安装并配置 AI 智能体 (以 Claude Code 为例)\n\n打开终端（macOS\u002FLinux 使用 Terminal，Windows 使用 PowerShell），执行以下步骤：\n\n**步骤 A：安装智能体及 ACP 适配器**\n```bash\n# 安装 Claude Code\ncurl -fsSL https:\u002F\u002Fclaude.ai\u002Finstall.sh | bash\n\n# 安装 ACP 适配器 (建议使用国内镜像源加速，如未配置全局镜像可添加 --registry 参数)\nnpm install -g @agentclientprotocol\u002Fclaude-agent-acp\n```\n\n**步骤 B：登录认证**\n```bash\nclaude\n```\n按提示完成 Anthropic 账号认证（若使用 API Key 可跳过此步，后续在插件设置中填写）。\n\n**步骤 C：获取执行路径**\n我们需要找到 `node` 和适配器可执行文件的路径。\n\n*macOS \u002F Linux:*\n```bash\nwhich node\nwhich claude-agent-acp\n```\n\n*Windows:*\n```bash\nwhere.exe node\nwhere.exe claude-agent-acp\n```\n*请记录上述命令输出的完整路径。*\n\n### 3. 插件配置\n\n1.  进入 Obsidian `设置` -> `Agent Client`。\n2.  **Node.js path**：填入上一步获取的 node 路径（例如：`\u002Fusr\u002Flocal\u002Fbin\u002Fnode` 或 `C:\\Program Files\\nodejs\\node.exe`）。\n3.  **Built-in agents** -> **Claude Code** -> **Path**：填入适配器路径（注意：是 `claude-agent-acp` 的路径，**不是** `claude` 的路径）。\n4.  **API key**：如果之前未通过 CLI 登录，在此处填入您的 API Key；若已登录可留空。\n\n## 基本使用\n\n配置完成后，即可开始在 Obsidian 中使用 AI 智能体。\n\n1.  **启动聊天**：点击 Obsidian 左侧侧边栏的 **机器人图标**。\n2.  **引用笔记**：在输入框中输入 `@` 加上笔记名称（例如 `@ProjectPlan`），即可将当前笔记内容作为上下文发送给 AI。\n3.  **发送消息**：输入自然语言指令，例如“总结这篇笔记的核心观点”或“根据笔记内容生成一个待办列表”。\n4.  **高级功能**：\n    *   **图片交互**：直接拖拽图片到聊天窗口进行分析。\n    *   **斜杠命令**：输入 `\u002F` 查看并使用智能体提供的特定命令。\n    *   **多会话**：可开启多个独立的聊天视图，同时运行不同的任务。\n    *   **导出对话**：聊天结束后，可将对话记录保存为 Markdown 笔记。\n\n> **提示**：更多智能体（如 Codex, Gemini CLI）的配置方法请参考插件设置中的对应选项或官方文档。","一位技术作家正在 Obsidian 中撰写复杂的系统架构文档，需要频繁调用本地代码库并参考已有的笔记内容。\n\n### 没有 obsidian-agent-client 时\n- **上下文割裂严重**：必须不断在终端运行 Claude Code\u002FCodex 和 Obsidian 窗口间切换，手动复制粘贴代码片段或笔记内容，打断心流。\n- **引用笔记繁琐**：想让 AI 参考某篇旧笔记时，需先找到文件路径，复制全文再贴给终端里的 AI，操作冗长且易出错。\n- **结果整合困难**：AI 生成的代码解释或架构建议停留在终端黑框中，需人工整理格式后再次写入笔记，效率低下。\n- **多任务并行受限**：无法同时让一个 AI 检查代码错误，另一个 AI 润色文档，只能串行等待任务完成。\n\n### 使用 obsidian-agent-client 后\n- **工作流无缝融合**：直接在 Obsidian 侧边栏唤起浮动聊天窗，通过 `@notename` 语法一键引用任意笔记作为上下文，无需离开当前编辑界面。\n- **智能交互升级**：支持拖拽截图分析架构图，或使用 `\u002F` 命令直接让 Agent 执行终端指令（如运行测试脚本），结果自动返回聊天区。\n- **产出即时沉淀**：对话内容可一键导出为 Markdown 笔记，或将 AI 生成的代码块直接插入当前文档，实现“问即所得”。\n- **多代理协同作业**：开启多个会话视图，左侧让 Claude Code 重构代码，右侧让 Gemini CLI 同步撰写接口文档，并行推进任务。\n\nobsidian-agent-client 通过将强大的命令行 AI 代理原生嵌入笔记环境，彻底消除了工具间的壁垒，让知识管理与智能编码在同一空间内高效共振。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRAIT-09_obsidian-agent-client_e92167b3.png","RAIT-09","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FRAIT-09_74ed30f7.jpg","Graduate student at Ritsumeikan",null,"Osaka, Japan","rainbow_0219","https:\u002F\u002Fgithub.com\u002FRAIT-09",[80,84,88,92],{"name":81,"color":82,"percentage":83},"TypeScript","#3178c6",91.4,{"name":85,"color":86,"percentage":87},"CSS","#663399",8,{"name":89,"color":90,"percentage":91},"JavaScript","#f1e05a",0.4,{"name":93,"color":94,"percentage":95},"Shell","#89e051",0.2,1650,145,"2026-04-15T19:09:43","Apache-2.0",4,"Linux, macOS, Windows","未说明",{"notes":104,"python":102,"dependencies":105},"该工具是 Obsidian 插件，核心依赖是 Node.js 运行环境以及对应 AI 代理（如 Claude Code, Codex, Gemini CLI）的命令行工具和 ACP 适配器。用户需在终端手动安装这些外部代理及其适配器，并在插件设置中配置 Node.js 和代理执行文件的路径。无需本地 GPU 或特定 Python 环境，计算任务由调用的外部代理处理。",[106,107,108],"Node.js","@agentclientprotocol\u002Fclaude-agent-acp (或其他代理的 ACP 适配器)","BRAT (可选，用于安装插件)",[52,13],[111,112,113,114,46,115,116],"obsidian-md","obsidian-plugin","claude-code","codex","agent-client-protocol","opencode","2026-03-27T02:49:30.150509","2026-04-16T08:12:32.867619",[120,125,130,135,140,144],{"id":121,"question_zh":122,"answer_zh":123,"source_url":124},35687,"在 Linux 上使用 Flatpak 版 Obsidian 时提示找不到 gemini-cli 或其他代理命令怎么办？","这是因为 Flatpak 沙盒限制了访问主机文件系统。解决方法是运行以下命令授予只读访问权限：\nsudo flatpak override --filesystem=host-os:ro md.obsidian.Obsidian\n然后在插件配置中，将代理路径修改为映射后的路径，例如：\u002Fvar\u002Frun\u002Fhost\u002Fusr\u002Flocal\u002Fbin\u002Fgemini（根据实际安装路径调整）。如果问题依旧，也可以尝试使用 AppImage 版本代替 Flatpak 版本。","https:\u002F\u002Fgithub.com\u002FRAIT-09\u002Fobsidian-agent-client\u002Fissues\u002F11",{"id":126,"question_zh":127,"answer_zh":128,"source_url":129},35688,"Gemini CLI 连接时卡在 \"Connecting to Gemini CLI\" 且无法建立连接，如何解决？","首先请更新插件至 v0.7.1 或更高版本，旧版本错误地设置了 GOOGLE_API_KEY 环境变量，现已修正为 GEMINI_API_KEY。\n如果更新后仍报错 \"You have exhausted your daily quota on this model\"（即使未超出配额），这是 Gemini CLI 上游的已知问题。解决方法是避免使用 API Key 认证，改为使用 Google 登录方式：在终端运行 gemini auth login 进行认证。","https:\u002F\u002Fgithub.com\u002FRAIT-09\u002Fobsidian-agent-client\u002Fissues\u002F76",{"id":131,"question_zh":132,"answer_zh":133,"source_url":134},35689,"更新 Codex CLI 后，插件界面中“绕过权限”（bypass permissions）按钮消失了怎么办？","这通常是因为 Codex CLI 更新后需要重新信任当前目录。请打开终端进入你的 Obsidian 仓库（vault）目录，运行 Codex CLI 并手动信任该目录即可恢复。另外，如果使用的是 0.10.0 版本的 Codex CLI 出现此问题，可以尝试降级到 0.9.5 版本作为临时解决方案。","https:\u002F\u002Fgithub.com\u002FRAIT-09\u002Fobsidian-agent-client\u002Fissues\u002F168",{"id":136,"question_zh":137,"answer_zh":138,"source_url":139},35690,"Kiro CLI 是否支持作为内置代理直接使用？如何处理其特有的通知？","目前 Kiro CLI 可以通过自定义代理模式使用（命令：kiro-cli acp），但尚未作为像 Claude 或 Gemini 那样的“内置”选项直接集成，因为部分 Kiro 特有的通知格式（如 _kiro.dev\u002Fmcp\u002Fserver_init_failure）尚未标准化。\n维护者计划在未来实现一个通用的 extNotification() 处理器来记录这些未知通知，而不是直接报错。建议关注上游 Kiro 项目动态，若其采用标准 ACP 协议，后续将无需特殊配置即可完美支持。","https:\u002F\u002Fgithub.com\u002FRAIT-09\u002Fobsidian-agent-client\u002Fissues\u002F126",{"id":141,"question_zh":142,"answer_zh":143,"source_url":124},35691,"遇到代理进程启动失败或 EPIPE 错误时，应该如何排查？","请检查调试日志中的 stderr 输出。常见的错误如 \"\u002Fbin\u002Fbash: line 1: \u002Fusr\u002Flocal\u002Fbin\u002Fgemini: No such file or directory\" 表明配置的路径不正确或环境变量未生效。\n排查步骤：\n1. 确认配置的绝对路径在系统终端中可以直接运行。\n2. 检查是否使用了正确的登录 Shell（如 \u002Fbin\u002Fbash）。\n3. 如果是 Flatpak 用户，请参考文件系统权限问题。\n4. 确保已正确安装对应的 CLI 工具（如 gemini-cli, codex 等）并全局可用。",{"id":145,"question_zh":146,"answer_zh":147,"source_url":134},35692,"插件更新后某些功能异常，如何确认是否是版本兼容性问题？","如果在更新特定代理（如 Codex CLI）或插件本身后立即出现问题，可以尝试回退版本验证。例如有用户反馈 Codex CLI 从 0.9.5 升级到 0.10.0 后导致权限按钮消失，降级即可解决。对于插件本身的问题，建议查看 GitHub Issues 中是否有类似报告，或通过 BRAT 插件安装特定历史版本进行测试。",[149,154,159,164,169,174,179,184,189,194,199,204,209,214,219,224,229,234,239,244],{"id":150,"version":151,"summary_zh":152,"released_at":153},280903,"0.10.1","🔧 **改进与错误修复版本（v0.10.1）**\n\n### 🔧 改进：\n\n- **📦 安装提示**：代理路径设置现在会显示一个可复制的 `npm install -g ...@latest` 命令，帮助首次使用的用户安装缺失的代理 CLI。(#214)\n\n### 🐛 修复：\n\n- **📄 自动导出打开笔记**：修复了在新建聊天或关闭聊天时自动导出笔记时，“导出后打开笔记”设置不生效的问题。启用该设置后，导出的笔记现在能够正确打开。\n\n### 🚀 升级：\n\n只需从 v0.10.0 版本升级即可，无需进行任何配置。\n\n--------\n\n### 👋 新贡献者\n\n- @jarvisluk 在 #214 中完成了他们的首次贡献\n\n--------\n\n**感谢您一直以来的支持！您的反馈有助于让这款插件对所有人来说更加完善。** 🙏","2026-04-15T12:51:55",{"id":155,"version":156,"summary_zh":157,"released_at":158},280904,"0.10.0","✨ **功能发布 (v0.10.0)**\n\n本次发布带来了显著的性能提升、全新功能以及焕然一新的 UI——这一切都建立在一次重大的内部架构重构之上。\n\n### ⚡ 性能：\n\n- **🚀 更快的长对话体验**：大幅提升了包含大量消息、工具调用和流式输出的长时间会话的响应速度。滚动更加流畅，流式交互也更为顺滑。\n\n### 🌟 新增：\n\n- **📂 在目录中新建聊天**：通过“更多”菜单 → “在目录中新建聊天…”选项，可在 vault 外的任意目录中启动代理会话。新增原生文件夹选择器和工作目录横幅。（#78）\n- **📝 编辑会话标题**：直接从会话历史模态窗口中重命名会话。（#147）\n- **🔔 系统通知**：当代理完成响应或在 Obsidian 失焦时请求权限时，可接收操作系统通知。可在设置 → 通知中进行配置。（#181）\n- **⌨️ 新的聊天命令**：通过命令面板或快捷键，在上次活跃视图中启动新聊天。\n- **⬇️ 发送时平滑滚动**：在向上滚动状态下发送消息时，现在会平滑地滚动至底部。\n\n### 🔧 改进：\n\n- **🎨 原生 Obsidian 风格 UI**：重新设计了聊天头部、图标及整体样式，使其与 Obsidian 的原生外观保持一致。全局将表情符号图标替换为 Lucide 矢量图标。（#159）\n- **🔍 简化命令名称**：代理命令现可仅使用命令名称进行配置（如 `claude-agent-acp`），以实现跨平台 vault 同步。内置代理默认使用简化的命令名称。（#177）\n- **🍔 浮动头部改版**：将浮动聊天头部整合为 `[代理下拉菜单] [更多 ⋮] [最小化] [关闭]`。新建聊天、历史记录、导出、重启以及打开新窗口等功能现已移至“更多”菜单中。\n- **🔄 命令 ID 清理** ⚠️ **破坏性变更**：为保持一致性，对命令 ID 进行了重命名（如 `open-floating-chat` → `open-floating-chat-view`, `open-chat-with-{id}` → `switch-agent-to-{id}` 等）。**快捷键绑定需重新配置。**\n\n### 🐛 修复：\n\n- **🔗 WSL 路径链接**：修复了在 WSL 模式下，点击代理回复中的文件链接无法打开笔记的问题。（#208）\n- **🔗 vault 链接点击修复**：修复了点击代理回复中的绝对路径链接时，会创建文件夹树而非打开笔记的问题。（#201）\n- **🔧 会话模式\u002F模型恢复**：修复了加载或恢复会话时，模式和模型未能正确恢复的问题。（#197）\n- **🧹 进程树清理**：修复了关闭 Obsidian 或切换会话后，代理子进程（如 MCP 服务器）仍残留的问题。（#205）\n- **📋 斜杠命令下拉菜单**：修复了在筛选具有重复名称的命令时，建议下拉菜单显示过时条目的问题。（#163）\n\n### 🚀 升级说明：\n\n请从 v0.9.4 版本升级。**⚠️ 如果您已将快捷键绑定到浮动聊天或代理切换命令，则必须因命令 ID 变更而重新绑定。** 无需数据迁移。\n\n--------\n\n### 👋 新贡献者\n\n- @ultratykis 在 #177 中完成了首次贡献\n- @ayrtmn 在 #159 中完成了首次贡献\n\n--------\n\n**感谢您一如既往的支持！**","2026-04-08T14:23:35",{"id":160,"version":161,"summary_zh":162,"released_at":163},280905,"0.10.0-preview.5","🔬 **预览版（v0.10.0-preview.5）**\n\n### 🐛 修复：\n\n- **🔗 WSL 路径链接**：修复了在使用 WSL 模式时，点击代理响应中的文件链接无法打开笔记的问题。现在，代理生成的 WSL 路径（`\u002Fmnt\u002Fc\u002F...`）会被转换为 Windows 路径，以确保与 vault 的正确匹配。此外，还通过规范化斜杠方向提升了路径比较的鲁棒性。（#208）\n\n### 🚀 升级：\n\n请从 v0.10.0-preview.4 更新至此版本。无需更改任何配置。\n\n--------\n\n**感谢您一直以来的支持！您的反馈有助于让这款插件对每个人来说都更加出色。** 🙏","2026-04-07T14:14:20",{"id":165,"version":166,"summary_zh":167,"released_at":168},280906,"0.10.0-preview.4","🔬 **预览版（v0.10.0-preview.4）**\n\n### 🐛 修复：\n\n- **📋 斜杠命令下拉菜单显示问题**：修复了在筛选具有重复名称的命令时，建议下拉菜单显示过时条目的问题。\n\n### 🎨 样式：\n\n- **✨ Lucide 小箭头图标**：将文本形式的箭头字符（▶▼▲）替换为 Lucide 小箭头图标，用于可折叠便笺以及差异对比的收起\u002F展开切换按钮。\n\n### 🚀 升级：\n\n请从 v0.10.0-preview.3 版本升级。无需进行任何配置更改。\n\n--------\n\n**感谢您一如既往的支持！您的反馈有助于让这款插件对所有人来说更加出色。** 🙏","2026-04-05T14:31:37",{"id":170,"version":171,"summary_zh":172,"released_at":173},280907,"0.10.0-preview.3","🔬 **预览版（v0.10.0-preview.3）**\n\n### 🐛 修复：\n\n- **🧹 退出时进程清理**：修复了关闭 Obsidian、重启 Agent 或切换会话后，Agent 子进程（例如 MCP 服务器节点）仍会残留的问题。插件现在会使用各平台特有的策略，在断开连接时杀死整个进程树。同时，还增加了在插件禁用时的清理操作。（#205）\n\n### 🚀 升级说明：\n\n请从 v0.10.0-preview.2 更新至此版本。无需更改任何配置。\n\n--------\n\n**感谢您一直以来的支持！您的反馈有助于让这款插件对所有人来说都更加完善。** 🙏","2026-04-05T08:22:15",{"id":175,"version":176,"summary_zh":177,"released_at":178},280908,"0.10.0-preview.2","🔬 **预览版（v0.10.0-preview.2）**\n\n⚠️ **这是一个预览版本** — 本版本包含新功能、问题修复，以及自 preview.1 以来持续进行的内部重构。如果您发现任何问题，请立即通过 GitHub Issues 报告！\n\n### 🌟 新增：\n\n- **📝 编辑会话标题**：通过新的铅笔图标，可直接从会话历史模态窗口重命名会话。（#147）\n- **🔔 系统通知**：当代理完成响应或请求权限时，您将收到操作系统通知——即使在使用其他应用时也不会错过任何更新。可在设置 → 通知中进行配置。（#181）\n- **📂 在目录中新建聊天**：通过“更多”菜单 → “在目录中新建聊天…”选项，可在您的 vault 外的任意目录中启动代理会话。新增原生文件夹选择器，并显示当前工作目录的横幅。（#78）\n- **⬇️ 发送时平滑滚动**：发送消息后，会自动平滑滚动至底部。\n- **⌨️ 新的聊天命令**：新增 `new-chat` 命令，可通过命令面板或快捷键在上次活动视图中启动新聊天。\n\n### 🔧 改进：\n\n- **🍔 浮动头部重新设计**：浮动聊天头部整合为 `[代理下拉菜单] [更多 ⋮] [最小化] [关闭]`。新建聊天、历史记录、导出、重启以及打开新窗口等功能现位于“更多”菜单中。\n- **🔄 命令 ID 清理** ⚠️ **破坏性更改**：为保持一致性，对浮动聊天的命令 ID 进行了重命名（如 `open-floating-chat` → `open-floating-chat-view` 等）。同时，`open-chat-with-{id}` 被重命名为 `switch-agent-to-{id}` — 现在该命令适用于上次活动的视图（侧边栏或浮动窗口），而不再强制切换到侧边栏。**请务必重新配置快捷键绑定。**\n\n### 🐛 修复：\n\n- **🔗 修复 vault 链接点击问题**：修复了点击代理响应中的绝对路径链接时，会在 vault 根目录下创建文件夹结构而非打开对应笔记的问题。（#201）\n- **🔧 修复会话模式与模型恢复问题**：解决了加载或恢复会话时模式和模型无法正确恢复的问题。（#197）\n- **📝 自定义代理路径说明**：澄清了仅使用命令名称（如 `opencode`）即可支持调用代理的功能。（#199）\n\n### 🚀 升级：\n\n请从 v0.10.0-preview.1 更新至此版本。**⚠️ 如果您已将快捷键绑定至浮动聊天或代理切换相关命令，则必须重新绑定**，因为命令 ID 已发生变更。无需数据迁移。\n\n--------\n\n**⚠️ 注意**：本版本继续推进自 preview.1 开始的内部架构重构，包括性能优化和新增功能。如果您发现任何回归问题，请及时报告。\n\n**感谢您一如既往的支持！您的反馈有助于让这款插件变得更好，惠及每一位用户。** 🙏","2026-04-04T10:07:08",{"id":180,"version":181,"summary_zh":182,"released_at":183},280909,"0.9.4","🔧 **改进与错误修复版本（v0.9.4）**\n\n本次发布新增了消息的复制按钮，修复了 Markdown 内容溢出的问题，并优化了浮窗聊天的行为。\n\n### 🌟 新功能：\n\n- **📋 复制消息按钮**：将鼠标悬停在任意消息上，即可显示一个复制到剪贴板的按钮。用户消息和助手消息均支持此功能。（#189）\n\n### 🔧 改进：\n\n- **🪟 更智能的浮窗聊天命令**：浮窗聊天的相关命令（打开、最小化、关闭）现在仅在启用该功能时才会出现在命令面板中。此外，最小化和关闭操作还需确保浮窗处于焦点状态。（#188）\n\n### 🐛 修复：\n\n- **📜 宽内容的水平滚动**：修复了 Mermaid 流程图、表格和 SVG 图片被裁剪而非水平滚动的问题。（#190）\n- **🪟 浮窗聊天开关**：修复了在设置中关闭浮窗聊天功能后，浮窗按钮仍未隐藏的问题。（#187）\n\n### 🚀 升级说明：\n\n直接从 v0.9.3 版本升级即可，无需任何配置更改。\n\n--------\n\n### 👋 新贡献者\n\n- @aviatesk 在 #187 中完成了首次贡献\n\n--------\n\n**感谢您一直以来的支持！您的反馈有助于让这款插件对每个人来说都更加出色。** 🙏","2026-03-27T16:39:54",{"id":185,"version":186,"summary_zh":187,"released_at":188},280910,"0.9.3","⚡ **性能修复（v0.9.3）**\n\n本次发布优化了长时间会话中的聊天性能。\n\n### ⚡ 性能：\n\n- **🚀 更快的长对话**：提升了包含大量消息、工具调用和智能体思考的长时间会话的响应速度。(#180)\n\n### 🚀 升级：\n\n只需从 v0.9.2 版本升级即可，无需任何配置。\n\n--------\n\n### 👋 新贡献者\n\n- @bluzername 在 #185 中完成了他们的首次贡献\n\n--------\n\n**感谢您一如既往的支持！您的反馈有助于让这款插件对所有人来说更加出色。** 🙏","2026-03-26T14:11:52",{"id":190,"version":191,"summary_zh":192,"released_at":193},280911,"0.9.2","🔧 **维护版本（v0.9.2）**\n\n此版本支持上游 Claude Agent ACP 适配器的重命名。\n\n### 🔧 改进：\n\n- **📦 Claude Agent ACP 包重命名**：上游适配器已由 `@zed-industries\u002Fclaude-agent-acp` 重命名为 `@agentclientprotocol\u002Fclaude-agent-acp`。仍使用旧包的用户将收到迁移提示。\n\n### 🚀 升级：\n\n只需从 v0.9.1 更新即可，无需额外配置。\n\n--------\n\n**感谢您一直以来的支持！您的反馈有助于让这款插件对所有人更加完善。** 🙏","2026-03-26T11:59:31",{"id":195,"version":196,"summary_zh":197,"released_at":198},280912,"0.10.0-preview.1","🔬 **预览版（v0.10.0-preview.1）**\n\n⚠️ **这是一个预览版本** — 本次发布包含大规模的内部重构。尽管所有功能都经过了测试，但仍存在比平时更高的 bug 风险。如果您发现任何问题，请立即通过 GitHub Issues 报告！\n\n### ⚡ 性能：\n\n- **🚀 更快的长对话体验**：显著提升了在包含大量消息、工具调用和流式输出的长时间会话中的响应速度。滚动更加流畅，流式输出也更为顺滑。(#180)\n\n### 🔧 改进：\n\n- **🎨 Obsidian 原生头部**：聊天头部现在采用 Obsidian 的原生 `nav-header` 样式，以实现更好的视觉整合。(#159)\n- **✨ Lucide 图标**：在工具调用、思考、计划和终端区块中，将表情符号图标替换为 Lucide 矢量图标。\n- **🔧 工具调用状态图标**：工具调用的状态现在以内联图标的形式显示，而非文本标签。\n- **📊 更简洁的差异视图**：移除了差异显示中的行号和标记，使界面更宽广、更整洁。\n- **🖥️ 更简单的终端输出**：终端区块的显示方式已简化为直接文本输出。\n- **🔐 简化的权限 UI**：移除了权限请求中的后续选择界面。\n- **📐 响应式输入工具栏**：使用情况指示器以及模式\u002F模型下拉菜单现在能够在较窄的宽度下正常缩小。\n- **🔍 简化命令名称**：代理命令现在可以仅配置命令名称（例如 `claude-agent-acp` 而非 `\u002Fopt\u002Fhomebrew\u002Fbin\u002Fclaude-agent-acp`），以便于跨平台 vault 同步。内置代理支持自动检测。(#177)\n\n### 🚀 升级：\n\n从 v0.9.1 版本升级即可，无需额外配置。如果您之前已使用绝对路径配置代理命令，则这些命令仍可继续正常使用。\n\n--------\n\n### 👋 新贡献者\n\n- @ultratykis 在 #177 中完成了首次贡献\n- @ayrtmn 在 #159 中完成了首次贡献\n\n--------\n\n**⚠️ 注意**：本次发布包含了重大的内部架构重构。所有现有功能均得以保留，但由于改动范围较大，请您在发现任何回归问题时及时报告。\n\n**感谢您一直以来的支持！您的反馈有助于让这款插件对所有人来说更加完善。** 🙏","2026-03-24T15:32:00",{"id":200,"version":201,"summary_zh":202,"released_at":203},280913,"0.9.1","🔧 **Improvement Release (v0.9.1)**\r\n\r\nThis release improves floating chat window management and session history.\r\n\r\n### 🔧 Improvements:\r\n\r\n- **⏩ Permission Status on Loading Indicator**: Shows \"Waiting for permission...\" next to the loading dots when a permission request is pending. (#154)\r\n- **🪟 Floating Chat Minimize & Close**: Separate minimize (preserve session) and close (end session) buttons in the floating chat header. (#156)\r\n- **🪟 Minimize Floating Chat Command**: New command to hide the floating window while preserving the session.\r\n- **📂 Session History CWD Display**: Sessions from different working directories now show their path in the history list.\r\n- **🔄 Agent History Replay Fallback**: Sessions without local message data can now be restored using the agent's history replay.\r\n- **⚙️ Renamed \"Show floating button\" → \"Enable floating chat\"**: Better reflects that it controls the entire feature. Existing settings are automatically migrated.\r\n- **🔔 Floating Chat Disabled Notice**: Floating chat commands now show a notice when the feature is disabled.\r\n- **📋 Session Filter Default**: \"Hide sessions without local data\" is now off by default.\r\n\r\n### ⚠️ Breaking Changes:\r\n\r\n- **\"Close floating chat window\" now terminates the session** instead of just hiding the window. Use the new \"Minimize floating chat window\" command for the old behavior.\r\n\r\n### 🚀 Upgrade:\r\n\r\nUpdate from v0.9.0 — Settings are automatically migrated. Review the breaking change above if you use floating chat hotkeys.\r\n\r\n--------\r\n\r\n**Thank you for your continued support! Your feedback helps make this plugin better for everyone.** 🙏\r\n","2026-03-15T08:40:23",{"id":205,"version":206,"summary_zh":207,"released_at":208},280914,"0.9.0","✨ **Feature Release (v0.9.0)**\r\n\r\nThis release adds context usage tracking, file attachment support, agent update notifications, dynamic session configuration, and a chat export command.\r\n\r\n### 🌟 New:\r\n\r\n- **📊 Context Usage Indicator**: See how much of the agent's context window you've used, displayed next to the send button. Color changes at 70%\u002F80%\u002F90% thresholds to warn you before hitting limits. (#113)\r\n- **📎 File Attachments**: Attach non-image files (text, code, PDFs, etc.) to your messages via paste or drag-and-drop. Files are sent as `resource_link` content and rendered in chat messages. (#77)\r\n- **🔔 Agent Update Notifications**: The plugin now checks if your ACP adapter (claude-agent-acp, codex-acp) has a newer version available on npm, and shows a dismissible notification with the update command. Also detects deprecated packages (e.g., `claude-code-acp`) and prompts migration.\r\n- **🎛️ Dynamic Session Config**: Agents can now provide configuration options (mode, model, etc.) via the ACP `configOptions` API. Dropdowns appear automatically in the chat input when available.\r\n- **💾 Remember Last Used Mode**: The last used mode is now saved per agent and automatically restored on the next session. (#136)\r\n- **📤 Export Chat Command**: Export the current chat to a markdown note via the command palette or keyboard shortcut. Works with both sidebar and floating chat windows. (#135)\r\n\r\n### 🔧 Improvements:\r\n\r\n- **📦 ACP SDK Update**: Updated @agentclientprotocol\u002Fsdk to v0.14.1.\r\n\r\n### 🐛 Fixes:\r\n\r\n- **📜 Auto-Scroll Threshold**: Increased threshold from 20px to 35px for more reliable scroll tracking.\r\n- **⬇️ Scroll-to-Bottom Button on New Chat**: Fixed the scroll-to-bottom button incorrectly appearing on the 2nd+ new chat sessions even when messages fit on screen.\r\n- **🔗 Settings Documentation Link**: Fixed clicking the documentation link in settings causing Obsidian popout windows to close due to missing `target=\"_blank\"`. (#152)\r\n- **📋 Suggestion Dropdown Listener Leak**: Fixed click-outside listeners accumulating on the suggestion dropdown, preventing potential performance degradation.\r\n\r\n### 🚀 Upgrade:\r\n\r\nUpdate from v0.8.3 — no extra configuration required. New features activate automatically when supported by your agent.\r\n\r\n--------\r\n\r\n**Thank you for your continued support! Your feedback helps make this plugin better for everyone.** 🙏\r\n","2026-03-08T14:17:56",{"id":210,"version":211,"summary_zh":212,"released_at":213},280915,"0.9.0-preview.2","🔬 **Preview Release (v0.9.0-preview.2)**\r\n\r\n⚠️ **This is a preview release** — Features are experimental and may change. Please report any issues!\r\n\r\nThis preview adds an export chat command and fixes UI bugs.\r\n\r\n### 🌟 New:\r\n\r\n- **📤 Export Chat Command**: Export the current chat to a markdown note via the command palette or keyboard shortcut. Works with both sidebar and floating chat windows. (#135)\r\n\r\n### 🐛 Fixes:\r\n\r\n- **⬇️ Scroll-to-Bottom Button on New Chat**: Fixed the scroll-to-bottom button incorrectly appearing on the 2nd+ new chat sessions even when messages fit on screen.\r\n- **🔗 Settings Documentation Link**: Fixed clicking the documentation link in settings causing Obsidian popout windows to close due to missing `target=\"_blank\"`. (#152)\r\n\r\n### 🚀 Upgrade:\r\n\r\nUpdate from v0.9.0-preview.1 — no extra configuration required.\r\n\r\n--------\r\n\r\n**Thank you for your continued support! Your feedback helps make this plugin better for everyone.** 🙏","2026-03-06T06:01:17",{"id":215,"version":216,"summary_zh":217,"released_at":218},280916,"0.9.0-preview.1","🔬 **Preview Release (v0.9.0-preview.1)**\r\n\r\n⚠️ **This is a preview release** — Features are experimental and may change. Please report any issues!\r\n\r\nThis preview adds context usage tracking, file attachment support, agent update notifications, and dynamic session configuration.\r\n\r\n### 🌟 New:\r\n\r\n- **📊 Context Usage Indicator**: See how much of the agent's context window you've used, displayed next to the send button. Color changes at 70%\u002F80%\u002F90% thresholds to warn you before hitting limits. (#113)\r\n- **📎 File Attachments**: Attach non-image files (text, code, PDFs, etc.) to your messages via paste or drag-and-drop. Files are sent as `resource_link` content and rendered in chat messages. (#77)\r\n- **🔔 Agent Update Notifications**: The plugin now checks if your ACP adapter (claude-agent-acp, codex-acp) has a newer version available on npm, and shows a dismissible notification with the update command. Also detects deprecated packages (e.g., `claude-code-acp`) and prompts migration.\r\n- **🎛️ Dynamic Session Config**: Agents can now provide configuration options (mode, model, etc.) via the ACP `configOptions` API. Dropdowns appear automatically in the chat input when available.\r\n- **💾 Remember Last Used Mode**: The last used mode is now saved per agent and automatically restored on the next session. (#136)\r\n\r\n### 🔧 Improvements:\r\n\r\n- **📦 ACP SDK Update**: Updated @agentclientprotocol\u002Fsdk to v0.14.1.\r\n\r\n### 🐛 Fixes:\r\n\r\n- **📜 Auto-Scroll Threshold**: Increased threshold from 20px to 35px for more reliable scroll tracking.\r\n\r\n### 🚀 Upgrade:\r\n\r\nUpdate from v0.8.3 — no extra configuration required. New features activate automatically when supported by your agent.\r\n\r\n--------\r\n\r\n**Thank you for your continued support! Your feedback helps make this plugin better for everyone.** 🙏","2026-03-01T10:03:32",{"id":220,"version":221,"summary_zh":222,"released_at":223},280917,"0.8.3","🐛 **Bug Fix Release (v0.8.3)**\r\n\r\n### 🐛 Fixes:\r\n\r\n- **🐧 NixOS \u002F Non-Standard Shell Paths**: Fixed agents failing to start on systems where `\u002Fbin\u002Fbash` or `\u002Fbin\u002Fzsh` doesn't exist (e.g., NixOS). The plugin now uses the `$SHELL` environment variable to detect the user's shell, with fallback to `\u002Fbin\u002Fzsh` (macOS) or `\u002Fbin\u002Fsh` (Linux). (#131)\r\n\r\n### 🚀 Upgrade:\r\n\r\nSimply update from v0.8.2 — no configuration needed.\r\n\r\n--------\r\n\r\n**Thank you for your continued support! Your feedback helps make this plugin better for everyone.** 🙏","2026-02-25T02:56:26",{"id":225,"version":226,"summary_zh":227,"released_at":228},280918,"0.8.2","🔧 **Improvement & Bug Fix Release (v0.8.2)**\r\n\r\n### 🌟 New:\r\n\r\n- **⬇️ Scroll to Bottom Button**: A floating button now appears when you scroll up in a conversation, allowing you to quickly jump back to the latest messages with smooth scrolling. Works in both sidebar and floating chat windows. (#122)\r\n\r\n### 🐛 Fixes:\r\n\r\n- **📜 Loading Spinner Layout Shift**: Fixed layout shifting when the loading spinner appears\u002Fdisappears during message streaming. (#123)\r\n- **📏 Auto-Scroll Threshold**: Reduced the auto-scroll detection threshold from 50px to 20px for more precise scroll control.\r\n\r\n### 🚀 Upgrade:\r\n\r\nSimply update from v0.8.1 — no configuration needed.\r\n\r\n--------\r\n\r\n**Thank you for your continued support! Your feedback helps make this plugin better for everyone.** 🙏","2026-02-24T15:00:12",{"id":230,"version":231,"summary_zh":232,"released_at":233},280919,"0.8.1","🐛 **Bug Fix Release (v0.8.1)**\r\n\r\n### 🐛 Fixes:\r\n\r\n- **🪟 Floating Window Viewport Clamp**: Fixed floating chat window and button appearing off-screen when the window size is smaller than when the position was saved. Positions are now clamped to viewport bounds on startup. (#127)\r\n\r\n### 🚀 Upgrade:\r\n\r\nSimply update from v0.8.0 — no configuration needed.\r\n\r\n--------\r\n\r\n### 👋 Contributors\r\n\r\n- @steve-chen made their first contribution in #127\r\n\r\n--------\r\n\r\n**Thank you for your continued support! Your feedback helps make this plugin better for everyone.** 🙏","2026-02-23T15:11:23",{"id":235,"version":236,"summary_zh":237,"released_at":238},280920,"0.8.0","✨ **Feature Release (v0.8.0)**\r\n\r\nThis release introduces the Floating Chat window, input history navigation, configurable chat font size, and many quality-of-life improvements.\r\n\r\n### 🌟 New:\r\n\r\n- **🪟 Floating Chat**: A draggable, resizable chat window that floats over your workspace. Access quickly via the floating button or command palette. The floating button itself is also draggable — position it anywhere you like. (#91, #102, #111)\r\n- **⬆️ Input History Navigation**: Navigate through your previous messages using arrow keys in the input field, similar to CLI behavior. Press ArrowUp when the input is empty to recall previous messages, and ArrowDown to return. (#100)\r\n- **💾 Remember Last Used Model**: The plugin now remembers the last model you selected for each agent and automatically restores it on the next session. (#103)\r\n- **🔤 Configurable Chat Font Size**: Customize the chat font size independently from Obsidian's editor font size. Configure in Settings → Display. (#115)\r\n- **📍 Right Pane (Split) Option**: Added a new \"Right pane (split)\" option for chat view location, and fixed \"Right pane (tabs)\" to correctly create tabs instead of splits.\r\n\r\n### 🔧 Improvements:\r\n\r\n- **🚨 Agent Error Detection**: The plugin now parses agent stderr for known error patterns (missing API keys, authentication failures) and surfaces actionable error messages instead of failing silently. (#97)\r\n- **🍔 Native Header Menu**: Replaced the custom header menu with Obsidian's native Menu API, fixing rendering issues in popout windows and reducing code complexity. (#117)\r\n- **📝 Kiro Agent Example**: Added Kiro to the custom agents documentation. (#106)\r\n- **🔄 Renamed claude-code-acp → claude-agent-acp**: Updated all references to the renamed agent adapter.\r\n\r\n### 🐛 Fixes:\r\n\r\n- **⌨️ IME Composition**: Fixed Cmd\u002FCtrl+Enter not sending messages during IME composition (e.g., Japanese, Chinese, Korean input).\r\n- **🔍 Chat View Focus**: Fixed chat view not receiving focus when it was an inactive tab in a pane with multiple tabs.\r\n\r\n### 🚀 Upgrade:\r\n\r\nUpdate from v0.7.5 — no extra configuration required.\r\nFloating Chat can be enabled in Settings → Floating chat.\r\nIf you previously installed `@zed-industries\u002Fclaude-code-acp`, please update to `@zed-industries\u002Fclaude-agent-acp`.\r\n\r\n--------\r\n\r\n### 👋 Contributors\r\n\r\n- @Maws7140 made their first contribution in #102\r\n- @jdmonaco made their first contribution in #97\r\n- @Gnonymous made their first contribution in #115\r\n- @rewse made their first contribution in #106\r\n\r\n--------\r\n\r\n**Thank you for your continued support! Your feedback helps make this plugin better for everyone.** 🙏","2026-02-20T10:22:29",{"id":240,"version":241,"summary_zh":242,"released_at":243},280921,"0.8.0-preview.1","🔬 **Preview Release (v0.8.0-preview.1)**\r\n\r\n⚠️ **This is a preview release** — Features are experimental and may change. Please report any issues!\r\n\r\nThis preview introduces the Floating Chat window, input history navigation, and quality-of-life improvements.\r\n\r\n### 🌟 New:\r\n\r\n- **🪟 Floating Chat**: A draggable, resizable chat window that floats over your workspace. Access quickly via the floating button or command palette. (#91, #102)\r\n- **⬆️ Input History Navigation**: Navigate through your previous messages using arrow keys in the input field, similar to CLI behavior. Press ArrowUp when the input is empty to recall previous messages, and ArrowDown to return. (#100)\r\n- **💾 Remember Last Used Model**: The plugin now remembers the last model you selected for each agent and automatically restores it on the next session. (#103)\r\n\r\n### 🔧 Improvements:\r\n\r\n- **🚨 Agent Error Detection**: The plugin now parses agent stderr for known error patterns (missing API keys, authentication failures) and surfaces actionable error messages instead of failing silently. (#97)\r\n\r\n### 🚀 Upgrade:\r\n\r\nUpdate from v0.7.5 — no extra configuration required. Floating Chat can be enabled in Settings → Floating chat.\r\n\r\n--------\r\n\r\n### 👋 New Contributors\r\n\r\n- @Maws7140 made their first contribution in #102\r\n- @jdmonaco made their first contribution in #97\r\n\r\n--------\r\n\r\n**Thank you for your continued support! Your feedback helps make this plugin better for everyone.** 🙏","2026-02-07T15:42:15",{"id":245,"version":246,"summary_zh":247,"released_at":248},280922,"0.7.5","🔧 **Improvement Release (v0.7.5)**\r\n\r\n### 🔧 Improvements:\r\n\r\n- **🖥️ Command Preview in Permission Requests**: Terminal tool calls now display the command and arguments before approval, making it easier to review what will be executed.\r\n- **⬆️ SDK Update**: Updated @agentclientprotocol\u002Fsdk to v0.13.1.\r\n\r\n### 🚀 Upgrade:\r\n\r\nSimply update from v0.7.4 — no configuration needed.\r\n\r\n--------\r\n\r\n**Thank you for your continued support! Your feedback helps make this plugin better for everyone.** 🙏","2026-01-31T04:43:47"]