仓库智能体工作台guyuefangyuanl/Deeperian

Deeperian

一个将 DeepSeek Harness（DSH）智能体嵌入你的仓库的 Obsidian 插件。你的仓库成为该智能体的工作目录——文件读写、搜索、bash 以及多步骤工作流都能就地运行。

⚠️ 开发进行中——尚不可安装

Deeperian 是 Qoderian 的一个分支，目前正处于替换其智能体后端的过程中。DSH 运行时尚未编写完成。 代码树中仍包含 Qoderian 面向 Qoder 的适配层，位于 src/qoder/ 下，并且仍将 @qoder-ai/qoder-agent-sdk 声明为依赖项。

目前没有发布版本，并且在替换完成之前也不会有——Qoder Agent SDK 并非 MIT 许可，不得在构建中重新分发。参见 NOTICE。

此仓库公开是为了让工作和其归属从一开始就可见，而不是因为它已可供使用。

为什么选择分支而不是全新插件

Obsidian 社区目录中已经存在两个 DSH 插件，二者都是从零编写的。Qoderian 带来了约 23,000 行成熟的聊天 UI，而这两者都不具备：多个对话标签页、内联渲染的子智能体运行、带差异预览的内联编辑、MCP 服务器管理、五种权限模式，以及恢复 / 分叉 / 回退。重写这些需要数月的工作。而替换其底层的智能体后端则不需要。

移植的当前状态

Qoderian 中的供应商耦合异常干净，这正是其可行的原因。在导入的代码树上测得：

| 层 | 大小 | 计划 |
| --- | --- | --- |
| src/app core shared i18n | 约 6,300 行 | 保持原样——与宿主无关 |
| src/features（聊天、设置、内联编辑） | 23,241 行 | 保留——26 个文件需要重新指向导入/类型 |
| src/qoder/ | 92 个文件，12,843 行 | 替换为 src/deepseek/ |

所有 20 个导入 @qoder-ai/qoder-agent-sdk 的文件都位于 src/qoder/ 内。UI 层中没有任何内容直接接触该 SDK。

src/qoder/runtime/（4,634 行）和 src/qoder/stream/（980 行）承载着 SDK 耦合，并且从不被 src/qoder/ 之外的代码导入——它们仅通过 qoder-services.ts 门面（141 行）访问。保持该门面的形态，整个聊天 UI 就能原样运行。

UI 实际导入的 18 个模块是可移植的那些——工具名称映射、工具结果渲染、配置路径、MCP 管理、模型列表、斜杠命令。

路线图

完整映射——架构决策、逐服务表格、会话事件词汇表以及已知缺口——见 docs/PORT-CONTRACT.md。

- [x] 针对 qoder-services.ts 定义 DSH 侧的服务契约
- [~] 探索：启动 Cordis + dsh-base 并到达 ctx.agents——已在 Node 中验证，Electron 部分仍未测试
- [ ] 实现 src/deepseek/ 服务和 src/deepseek/stream/
- [ ] 重新指向 26 个 UI 文件，移除 src/qoder/
- [ ] 从 dependencies 中移除 @qoder-ai/qoder-agent-sdk
- [ ] 替换继承的测试套件的 SDK mock
- [ ] 首次发布构建 + Obsidian 社区目录提交

DSH 没有可嵌入的 agent SDK，所以这不是一次 import 替换：Deeperian
在进程内组合 DSH bundles 并直接驱动 ctx.agents，遵循
@deepseek-ai/dsh-headless 所确立的模式。参见契约的 §1。

归属与许可

Deeperian 是 Qoderian 的 fork，后者是 Qoder 开发的 MIT 许可的 Obsidian 插件。Qoderian 又衍生自 Claudian，同样是 MIT 许可。所有三个上游版权声明均逐字保留在 LICENSE 中，衍生链记录在 NOTICE 中。

Deeperian 是一个独立的社区项目。它不隶属于 Qoder 或 DeepSeek，也未获得其背书或赞助。“DeepSeek”、“DeepSeek Harness”、“Qoder”和“Qoderian”仅出于兼容性和归属目的而被引用。

依据 MIT License 授权。