dsh-devin-cli

dsh-devin-cli

---

🌟 核心特性

• DSH 微前端原生体验：通过 DSH Client Slots 注入专属独立「Devin CLI」设置面板与状态徽标，完全解耦，绝不污染官方原生配置。
• 210+ 模型可视化全选与管理：自动探测本机 Devin CLI 关联账户下的海量可用模型，支持一键搜索过滤、批量激活，已激活模型直观置顶展示。
• 会话即选即用：在 DSH 会话输入框中键入 /model 或点击底部模型下拉选择器，无缝调用已激活的任意 Devin 模型。
• 极简纯粹的本地 stdio ACP：通过标准 Agent Client Protocol（JSON-RPC 2.0）直接与本地 devin acp 通信，无需额外外部代理。
• 全栈契约完备：显式实现 prepareCall(provider, model, signal)，完美兼容最新版 DSH (dsh-llm 0.1.2-rc.1+)。
• 多模态就绪：针对 swe-1-7 等模型精准声明 inputModalities: ['text', 'image']，支持视觉多模态能力。
• 原生独立工具调用卡片：将 Devin 底层工具调用（代码搜索、终端执行、文件读写等）原生映射并派发为 DSH 独立的 tool/call 与 tool/result 卡片消息体，工具执行细节清晰直观，思考流（Reasoning）保持纯净无杂质。
• 上下文工作区动态对齐：自动提取会话绑定的工作区目录（Session CWD），确保子进程环境精准对齐当前工程。
• 独立持久化保障：用户模型勾选状态安全保存在 ~/.dsh/devin-settings.json，插件更新升级不丢失配置。
• 自动化 Agent-Ready：内置 pnpm run mount / pnpm run unmount 脚本，便于 AI Agent（如 Claude Code、Cursor、Antigravity、Windsurf）0 门槛自动完成安装与挂载。

---

🤖 面向 AI Agent 的自动化安装指南 (Agent-Ready)

本节专为 AI Agent（以及希望快速部署的开发者）设计。Agent 可直接按顺序执行下列步骤与检查命令。

Step 0: 前置环境探测

请在执行安装前通过以下命令验证环境：

# Agent 一键环境自检
node -e "console.log('Node:', process.version)" && pnpm -v && devin --version

---

Step 1: 克隆与构建

# 1. 克隆代码仓库
git clone https://github.com/AtWhuhu/dsh-devin-cli.git
cd dsh-devin-cli

# 2. 安装依赖并构建产物 (包含 TypeScript 后端与 Client 微前端包装)
pnpm install
pnpm run check

构建成功后，lib/ 目录下将生成：

• lib/index.mjs (Cordis 后端插件入口)
• lib/client.js (微前端微模块容器，调用 window.__ModuleLoader__.load)

---

Step 2: 挂载插件到 DSH Profile

方式 A：全自动挂载（推荐 AI Agent 执行）

仓库内置了跨平台的自动挂载脚本，可自动定位 ~/.dsh/profiles/ 下的配置并以符号链接注入：

pnpm run mount

输出示例：

🔍 检测 DSH 环境目录: C:\Users\liuwan\.dsh
✅ [web] 成功挂载插件到: C:\Users\liuwan\.dsh\profiles\web\package.json
   └─ 链接路径: link:C:/Users/liuwan/dsh-devin-cli
🎉 挂载完成！共更新 1 个 DSH Profile。

提示：若需要从 DSH 中卸载此插件，只需执行 pnpm run unmount。

方式 B：手动挂载（配置对照）

如需手动配置，修改 ~/.dsh/profiles/web/package.json（或桌面版对应 profile）：

{
  "name": "dsh-profile-web",
  "dsh": {
    "profile": {
      "bundles": [
        // ... 原有 bundles
        "dsh-devin-cli" // 👈 1. 添加此项
      ]
    }
  },
  "dependencies": {
    // ... 原有 dependencies
    "dsh-devin-cli": "link:/绝对路径/dsh-devin-cli" // 👈 2. 添加 link 依赖 (Windows 使用正斜杠 /)
  }
}

---

Step 3: 启动并验证

启动 DSH Web 宿主：

dsh --profile web

管理通道说明（Agent 验证机制）

插件不再监听任何本地端口。设置面板的状态查询、模型探测与保存全部通过 DSH 原生 connection.rpc（共享 /api 通道）完成，自动复用宿主的浏览器认证与 Host/Origin 信任栅栏——只有已登录的 DSH Web 会话可以调用。

# Agent 验证方式：确认构建产物存在且插件成功挂载
pnpm run check
# 启动后观察 DSH 日志，预期输出:
# [dsh-devin-cli] Successfully registered Devin LLM adapter

---

💡 在 DSH 会话中使用 Devin 模型

在浏览器访问 DSH Web（通常为 http://localhost:3080）：

1. 配置与激活模型

1. 点击左下角的 「设置」 齿轮图标；
2. 在左侧面板中选择 「Devin CLI」 独立专区；
3. 可以看到上方有 【✨ 当前已选激活模型】 状态栏与徽章；
4. 在下方的模型清单中搜索并勾选需要使用的模型（如 glm-5-2, swe-1-7 等）；
5. 点击右上角的 「保存」 按钮，系统会持久化至 ~/.dsh/devin-settings.json 并动态注册到 DSH 模型注册表中。

2. 在对话中调用

1. 点击新建会话或进入已有会话；
2. 方式一：在聊天输入框内输入 /model，在弹出的模型列表中选中你的 Devin 模型；
3. 方式二：直接点击输入框底部的当前模型名称下拉框，从列表中切换至已激活的模型；
4. 输入你的 Prompt，即可体验原生打字机般的 Stdio ACP 极速流式输出！

---

🏗️ 架构与设计规范

┌────────────────────────────────────────────────────────────┐
│                    DSH Web 前端 (浏览器)                   │
│   ┌──────────────────────────┐  ┌───────────────────────┐  │
│   │ Devin CLI Settings Slot  │  │   /model 切换模型     │  │
│   └────────────┬─────────────┘  └───────────┬───────────┘  │
└────────────────┼────────────────────────────┼──────────────┘
                 │ DSH 原生 /api RPC（浏览器认证）│ DSH RPC
┌────────────────▼────────────────────────────▼──────────────┐
│                    DSH 插件后端 (Cordis)                   │
│   ┌──────────────────────────┐  ┌───────────────────────┐  │
│   │   DevinRpc (connection)  │  │     DevinAdapter      │  │
│   │  (原生 RPC 状态/配置)    │  │ (LlmAdapter 实现)     │  │
│   └────────────┬─────────────┘  └───────────┬───────────┘  │
└────────────────┼────────────────────────────┼──────────────┘
                 │ 独立持久化                  │ Stdio (JSON-RPC)
┌────────────────▼─────────────┐  ┌───────────▼──────────────┐
│ ~/.dsh/devin-settings.json   │  │ 本地 devin acp 进程      │
└──────────────────────────────┘  └──────────────────────────┘

1. 零污染隔离：
   • 不修改 DSH 官方源码或官方模型枚举；
   • 微前端前端资源通过 lib/client.js 与 window.__ModuleLoader__.load 契约挂载；
   • 依赖注入由 Cordis 的 inject = ['llm'] 精准管理。
2. ACP 交互闭环 (Agent Client Protocol)：
   • 启动参数：devin acp --model <model>；
   • 协议流程：initialize → authenticate → session/new → session/prompt；
   • 支持 session/update 实时转为 DSH 的 StreamChunk；
   • 支持多模态输入（文本 + 图片）与请求取消 (signal.abort)。

---

📂 代码目录

dsh-devin-cli/
├── src/
│   ├── index.ts              # Cordis 插件入口，注册 DevinAdapter 与原生 RPC 端点
│   ├── DevinAdapter.ts       # LlmAdapter 标准实现 (prepareCall, stream, listModels)
│   ├── rpc.ts                # DSH 原生 connection.rpc 管理端点（/api 通道）
│   ├── storage.ts            # 用户设置独立持久化 (~/.dsh/devin-settings.json)
│   ├── credentials.ts        # 本地 ~/.devin/credentials.toml 凭据解析
│   ├── client/
│   │   └── index.ts          # 浏览器端 Slot 注入（Devin CLI 专属设置面板）
│   └── acp/
│       ├── protocol.ts       # ACP 协议定义 (JSON-RPC 2.0)
│       └── AcpStdioClient.ts # Stdio 进程通信与流解析器
├── scripts/
│   ├── build-client.js       # 微前端打包器（将 CJS 产物打包进 ModuleLoader）
│   ├── mount.mjs             # 自动化挂载脚本 (Agent-Ready)
│   └── unmount.mjs           # 自动化卸载脚本
├── cordis.patch.yml          # DSH Profile 补丁配置文件
├── package.json              # 插件元信息与依赖声明
└── tsconfig.json             # TypeScript 编译配置

---

⚙️ 核心配置参数

在 cordis.patch.yml 或 DSH 配置中支持以下可选属性：

---

🛠️ 常见问题排查 (Troubleshooting)

Q1: 设置面板提示「无法连接 Devin CLI 服务」？

解答：管理通道走 DSH 原生 /api RPC 并复用浏览器登录态。请确认浏览器已正常登录 DSH Web（若 Cookie 过期请重新打开带令牌的入口 URL），并确认插件已随 DSH 启动（日志中出现 Successfully registered Devin LLM adapter）。

Q2: 提示 registration.adapter.prepareCall is not a function？

解答：最新版 dsh-llm 要求必须显式实现 prepareCall 方法。本项目在 DevinAdapter 中已完备实现，若依然出现此提示，请运行 pnpm run check 重新打包。

Q3: 为什么在设置页面选了模型，在会话中没有刷新？

解答：在「Devin CLI」设置面板中勾选完模型后，请务必点击右上角的 「保存」 按钮。保存后后端会立即重新加载可用模型列表。如果聊天页面下拉菜单未即时变更，按 F5 刷新浏览器页面即可。

Q4: 如何在多机器或容器环境跨平台部署？

解答：pnpm run mount 脚本自动将 Windows 反斜杠 \ 转换为正斜杠 /，保证在 Windows、macOS 和 Linux 上均可安全运行 link: 路径。

---

📄 开源许可证

本项目基于 MIT License 开源。