DimCode

简体中文

English

简体中文

English

Appearance

DimCode在终端里 Plan · Agent

多模型代码智能体，内置会话、安全审批与 ACP 编辑器集成。

快速开始
CLI 参考
SDK 与插件

漂亮的 TUI

用 Vue 打造的现代终端界面。

多会话工作区

每个项目保留多条线程，会话按 cwd 分组，Ctrl+P 一键切换。

工具审批

细粒度控制工具执行，默认安全。

多模型提供方

内置多家提供方，也支持本地提供方（Ollama / LM Studio）与自定义端点。

ACP 兼容

运行 ACP 模式对接编辑器（如 Zed）。

SDK 与插件

使用 @archships/dim-agent-sdk 与官方插件包构建嵌入式 agent。

DimCode 覆盖多模型 CLI、TypeScript SDK、ACP 编辑器集成与插件化 coding agent 工作流。

快速开始 ​

桌面 App ​

DimCode Desktop 0.2.4 提供 macOS 与 Windows 下载：

安装 ​

bash
npm install -g dimcode@latest
# pnpm add -g dimcode
# yarn global add dimcode
# bun add -g dimcode

运行 ​

bash
dim
# or: npx dimcode

配置凭据 ​

  • 按 Ctrl+P → Connect Provider（或输入 /connect），添加需要 API key 的提供方（OpenAI / OpenRouter 等）。

TUI 的第 1 分钟 ​

  • Ctrl+P：命令面板（会话、连接、模型、审批、MCP、插件）。
  • /connect：连接提供方（也可添加自定义 / 本地提供方）。
  • /models：选择模型。
  • /approvals：设置工具审批（auto、normal 或 strict）。
  • Shift+Enter：换行；Enter：发送；Ctrl+O：展开/折叠工具调用与思考。

数据存储位置 ​

默认存放在 ~/.dimcode/：

  • 配置：~/.dimcode/config.json
  • MCP servers：~/.dimcode/mcp.json
  • 工具设置：~/.dimcode/tools.json
  • 会话/缓存：~/.dimcode/dimcode/cache.json
  • 状态存储：~/.dimcode/dimcode/state/

完整说明见：/zh/config。

可通过以下变量调整位置：

  • DIMCODE_HOME（基础目录）
  • DIMCODE_STATE_DIR（状态目录）

可选集成 ​

网页搜索（Serper） ​

WebSearch 需要 Serper API Key。可在 Plugins（Ctrl+P → Plugins 或 /plugins）中配置。

MCP 服务器 ​

在 MCP（Ctrl+P → MCP 或 /mcp）中配置。

常见用法 ​

bash
# One-shot prompt (tools auto-approved)
dim "Review this repo and propose a refactor plan"

# One-shot prompt without interactive fallback
dim --no-interaction "Review this repo and propose a refactor plan"

# 从 stdin 执行 one-shot
echo "Review this code" | dim

# Next API OAuth 登录
dim auth next-api-oauth

# Editor integration (ACP)
dim acp

ACP 说明见：/zh/acp。

嵌入式 agent runtime 见 SDK 说明：/zh/sdk。

需要帮助？ ​

  • dim --help 查看命令与参数。
  • dim --debug 启用诊断，默认写入 ./dimcode-debug.log。