AIDM 开发者文档

⚡快速开始

AIDM 是一款强大的 VS Code 插件，为你提供 AI 驱动的代码补全、代码生成和代码解释功能。只需几分钟即可完成安装并开始使用。

安装步骤

1. 打开 VS Code，点击左侧活动栏中的 扩展 图标（或按 Ctrl+Shift+X / Cmd+Shift+X）
2. 在搜索框中输入 AIDM，找到由 AIDM 官方发布的插件
3. 点击 "安装" 按钮，等待安装完成
4. 安装完成后，VS Code 右下角会显示 AIDM 状态栏图标，点击图标进行 登录
5. 登录成功后，即可开始使用 AIDM 的全部功能

命令行安装

如果你更喜欢使用命令行，可以通过以下命令快速安装：

code --install-extension aidm.aidm

⚙配置指南

AIDM 支持多种配置选项，让你可以根据自己的需求定制 AI 助手的行为。

配置 API Key

AIDM 使用 NewAPI 作为后端服务。你需要配置 API Key 才能使用 AI 功能：

1. 登录 AIDM 官网，注册并登录账号
2. 进入 "个人中心" → "API Keys" 页面
3. 点击 "创建新密钥"，为密钥设置名称（如 "VS Code"）
4. 复制生成的 API Key
5. 在 VS Code 中打开 AIDM 设置（Ctrl+Shift+P → "AIDM: 设置"），粘贴 API Key

选择 AI 模型

AIDM 支持多种主流 AI 模型，你可以根据使用场景选择最合适的模型：

VS Code 设置项

在 VS Code 的 settings.json 中，你可以配置以下 AIDM 相关选项：

{
  // AIDM 配置
  "aidm.model": "gpt-4o-mini",          // 默认 AI 模型
  "aidm.autoComplete": true,             // 启用自动代码补全
  "aidm.inlineSuggestions": true,         // 启用行内建议
  "aidm.maxTokens": 2048,                 // 单次生成最大 Token 数
  "aidm.theme": "dark",                   // 主题（dark / light）
  "aidm.language": "zh-CN"                // 界面语言
}

✍代码补全

AIDM 的智能代码补全功能可以实时分析你的代码上下文，提供精准的补全建议。

自动补全

安装并登录后，AIDM 会自动监听你的输入。当你编写代码时，AIDM 会在光标处显示灰色的补全建议：

// 输入以下内容，AIDM 会自动建议补全
function formatDate(date) {
  const year = date.getFullYear();
  const month = String(date.getMonth() + 1).padStart(2, '0');
  const day = String(date.getDate()).padStart(2, '0');
  // AIDM 建议: return `${year}-${month}-${day}`;
}

接受补全

• 按 Tab 键接受完整的补全建议
• 按 Ctrl+→（Mac: Cmd+→）逐词接受
• 按 Esc 忽略建议

✨代码生成

通过自然语言描述你的需求，AIDM 可以快速生成完整的代码片段。

使用方式

1. 在编辑器中按 Ctrl+Shift+P（Mac: Cmd+Shift+P）打开命令面板
2. 输入 "AIDM: 生成代码" 并回车
3. 在弹出的输入框中用自然语言描述你需要的代码
4. AIDM 会在当前光标位置插入生成的代码

示例

你可以用自然语言描述各种需求，例如：

// 示例提示词：
"创建一个防抖函数，延迟 300ms，支持取消功能"
"写一个 React Hook，用于管理表单状态和验证"
"生成一个快速排序算法的 TypeScript 实现"
"创建一个 Express 中间件，用于 JWT 鉴权"

// AIDM 生成的防抖函数示例
function debounce<T extends (...args: any[]) => any>(
  fn: T,
  delay: number = 300
): { run: T; cancel: () => void } {
  let timer: ReturnType<typeof setTimeout> | null = null;

  const run = (...args: Parameters<T>) => {
    if (timer) clearTimeout(timer);
    timer = setTimeout(() => fn(...args), delay);
  };

  const cancel = () => {
    if (timer) {
      clearTimeout(timer);
      timer = null;
    }
  };

  return { run: run as T, cancel };
}

📚代码解释

遇到不理解的代码？AIDM 可以帮你逐行分析代码逻辑，用清晰的语言解释代码的功能。

使用方式

1. 选中你想要理解的代码片段
2. 右键点击，选择 "AIDM: 解释代码"（或使用快捷键 Ctrl+K / Cmd+K）
3. AIDM 会在侧边面板中显示详细的代码解释

解释面板功能

• 逐行解释：每一行代码的功能说明
• 整体概述：代码片段的整体功能和目的
• 关键概念：涉及的设计模式、算法或 API
• 改进建议：可选的优化方向和最佳实践

❓常见问题