多引擎智能体 hanhtang711-netizen/claudian-dsh

Claudian

本仓库是 YishenTu/claudian 的 fork（base: v2.1.3 e707f1c），新增 DeepSeek Harness（DSH） 作为第五个聊天引擎（claude/codex/grok/opencode/pi → +dsh），并修复了两个通用的 ACP 集成缺口。全部改动说明与安装步骤见 docs/DSH_INTEGRATION.md。

This fork adds DeepSeek Harness as a new ACP chat provider, plus two generic ACP integration fixes. See docs/DSH_INTEGRATION.md. Everything below is the upstream README.

Preview

Obsidian 插件，把 AI 编程智能体（Claude Code、Codex、Grok、Opencode、Pi，后续还会支持更多）嵌进你的 vault。vault 就是智能体的工作目录——读写文件、搜索、bash、多步工作流，开箱即用。

功能与用法

从侧边栏图标或命令面板打开聊天侧栏。选中文本，按快捷键即可行内编辑。用法和你熟悉的编程智能体一样，Claude Code、Codex、Grok、Opencode、Pi——跟智能体说话，它就会在你的 vault 里读、写、改、搜文件。

行内编辑 — 选中文本，或把光标停在目标位置 + 快捷键，直接在笔记里编辑，带词级 diff 预览。

斜杠命令与技能 — 输入 / 或 $，调用可复用的提示词模板或技能，来源可以是用户级，也可以是 vault 级。

@mention — 输入 @ 提及任何你想让智能体处理的东西，包括 vault 文件、子代理、外部目录里的文件。

计划模式 — 用 Shift+Tab 切换。智能体先探索、先设计，再动手实现，然后给出计划等你批准。

指令模式（#） — 从聊天输入框添加润色过的自定义指令。

MCP 服务器 — 通过各编程智能体原生的 CLI 托管 MCP 配置，接入外部工具。

标签页与会话管理 — 单面板模式下可用多个标签页；双面板模式下，聊天旁边有常驻的会话管理器。

环境要求

- 至少装一个下面这些 harness：
- Claude Code CLI
- Codex CLI
- Grok Build
- OpenCode
- Pi
- 兼容的订阅或 API 服务商，例如 OpenRouter、Kimi、GLM 或 DeepSeek。
- Obsidian v1.7.2+
- 仅支持桌面端（macOS、Linux、Windows）

安装

从 Obsidian 社区插件安装（推荐）

1. 打开 Obsidian → Settings → Community plugins → Browse
2. 搜索 "Claudian"，点击 Install
3. 启用插件

也可以直接从社区插件页面安装。

从源码安装（开发）

1. 把仓库克隆到 vault 的 plugins 目录：
cd /path/to/vault/.obsidian/plugins
git clone https://github.com/YishenTu/claudian.git
cd claudian

2. 安装依赖并构建：
npm install
npm run build

3. 在 Obsidian 中启用插件：
- Settings → Community plugins → Enable "Claudian"

开发

Watch mode
npm run dev

Production build
npm run build

隐私与数据使用

- 发送到 API 的内容：你的输入、附件、图片，以及工具调用输出。具体发往哪里取决于你选的服务商：Anthropic（Claude）、OpenAI（Codex）、xAI（Grok），或者你在 OpenCode、Pi 里配置的服务商。目标地址可以在服务商设置和环境变量里配置。
- 没有遥测，也不会偷偷跑后台任务：Claudian 不会发送遥测信标。UI 里的轮询定时器只读取本地 Obsidian／编辑器的选区状态。网络活动仅限于服务商运行时的必要工作、你配置的 MCP 端点，以及为回答你的请求而调用的服务商 SDK／CLI。

故障排查

下面几节以 Claude Code 为例。

找不到服务商 CLI

如果 Claudian 无法自动检测到服务商 CLI，先确认 CLI 已安装，并且 GUI 应用能通过 PATH 找到它。常见报错有 spawn claude ENOENT 和 Claude CLI not found。用 Node 版本管理器（nvm、fnm、volta）时经常遇到这个问题。

先把 CLI 路径设置留空，让 Claudian 自动检测。如果自动检测失败，找到可执行文件路径，填到 Settings → Advanced → Claude CLI path。

| 平台 | 命令 | 路径示例 |
| macOS/Linux | which claude | /Users/you/.volta/bin/claude |
| Windows（原生） | where.exe claude | C:\Users\you\AppData\Local\Claude\claude.exe |
| Windows（npm） | npm root -g | {root}\@anthropic-ai\claude-code\cli-wrapper.cjs |
注意：在 Windows 上，别用 .cmd 和 .ps1 包装脚本。原生安装用 claude.exe，包管理器安装用 cli-wrapper.cjs。cli.js 只是旧版 Claude Code npm 包的兼容回退。

备选方案：在 Settings → Environment → Custom variables 里，把 Node.js 的 bin 目录加进 PATH。

npm 命令行与 Node.js 不在同一目录

用 npm 安装的服务商命令行时，要确保它的可执行文件和 Node.js 在同一个环境里都能找到。检查它们的路径：

dirname $(which claude)
dirname $(which node)

如果路径不一样，Obsidian 这类 GUI 应用可能找不到 Node.js。

两种做法：

1. 安装原生二进制文件（推荐）。
2. 在 Settings → Environment 里加上 Node.js 路径：PATH=/path/to/node/bin。

更多帮助

服务商各自的安装与配置指引，请看 Requirements 一节里链接的服务商文档。想提功能需求，或者遇到了 bug，请提交 GitHub issue。

架构

src/
├── main.ts # Plugin entry point
├── app/ # Shared defaults and plugin-level storage
├── core/ # Provider-neutral runtime, registry, and type contracts
│ ├── runtime/ # ChatRuntime interface and approval types
│ ├── providers/ # Provider registry and workspace services
│ ├── auxiliary/ # Shared provider auxiliary services
│ ├── bootstrap/ # Plugin bootstrap wiring
│ ├── security/ # Approval utilities
│ └── ... # commands, mcp, prompt, storage, tools, types
├── providers/
│ ├── claude/ # Claude SDK adaptor, prompt encoding, storage, MCP, plugins
│ ├── codex/ # Codex app-server adaptor, JSON-RPC transport, JSONL history
│ ├── grok/ # Grok Build ACP adaptor, native history, models, and tools
│ ├── opencode/ # Opencode adaptor
│ ├── pi/ # Pi RPC adaptor, model discovery, JSONL history
│ └── acp/ # Agent Client Protocol shared transport
├── features/
│ ├── chat/ # Sidebar chat: tabs, controllers, renderers
│ ├── inline-edit/ # Inline edit modal and provider-backed edit services
│ └── settings/ # Settings shell with provider tabs
├── shared/ # Reusable UI components and modals
├── i18n/ # Internationalization (10 locales)
├── types/ # Shared ambient types
├── utils/ # Cross-cutting utilities
└── style/ # Modular CSS

Star 历史

赞助

贝壳控股有限公司（BEIKE）

Claudian 由贝壳控股有限公司（BEIKE）与 MOMA 团队赞助。他们的支持让 Claudian 得以持续开发与维护，不断改进。

想赞助 Claudian，或想出现在这里？联系我：tysk01213@gmail.com。

贡献

欢迎提交 issue 和聚焦的 pull request。建议先从 issue 开始：把问题、复现步骤和环境描述清楚，方便排查。

提交 pull request 之前，请先阅读贡献指南。pull request 必须说明问题是什么、方案是什么、为什么这个方案合适，以及改动如何验证。不接受新增服务商的 pull request；指南里详细解释了这条维护与产品质量的边界。

许可证

基于 MIT License 授权。