MyCoder

基于命令行的 AI 辅助编程系统。完整详情请访问 MyCoder.ai 官网 及 MyCoder.ai 官方文档。

特性

• 🤖 AI 驱动：利用 Anthropic 的 Claude、OpenAI 模型以及 Ollama 提供智能编程辅助
• 🛠️ 可扩展工具系统：模块化架构，支持多种类别的工具
• 🔄 并行执行：能够生成子代理（Sub-agents）以进行并发任务处理
• 📝 自我修改：具备修改代码的能力，其本身就是通过自我编写和测试构建的
• 🔍 智能日志：分层、颜色编码的日志系统，输出清晰直观
• 👤 人类友好：通过 README.md、项目文件和 Shell 命令自动构建上下文
• 🌐 GitHub 集成：支持 GitHub 模式，可将 Issues 和 PR 纳入工作流
• 📄 Model Context Protocol：支持 MCP 以访问外部上下文资源
• 🧠 消息压缩：针对长时间运行的代理，自动管理上下文窗口

欢迎加入 MyCoder.ai Discord 社区获取支持：https://discord.gg/5K6TYrHGHt

安装

npm install -g mycoder

关于 macOS 和 Linux 的详细安装说明（包括如何使用 NVM 设置 Node.js），请参阅我们的 入门指南。

使用方法

# 交互模式
mycoder -i

# 通过提示词（Prompt）运行
mycoder "Implement a React component that displays a list of items"

# 通过文件中的提示词运行
mycoder -f prompt.txt

# 在执行期间启用交互式更正（按下 Ctrl+M 发送更正信息）
mycoder --interactive "Implement a React component that displays a list of items"

# 禁用用户提示，实现全自动会话
mycoder --userPrompt false "Generate a basic Express.js server"

# 在自动化环境中禁用用户确认警告和版本升级检查
mycoder --upgradeCheck false "Generate a basic Express.js server"

配置

MyCoder 通过项目中的配置文件进行设置。MyCoder 支持多种配置文件位置和格式，类似于 ESLint 和其他现代 JavaScript 工具。

配置文件位置

MyCoder 将按以下优先顺序搜索配置文件：

1. 项目根目录下的 mycoder.config.js
2. 项目根目录下的 .mycoder.config.js
3. 项目根目录下的 .config/mycoder.js
4. 项目根目录下的 .mycoder.rc
5. 主目录下的 .mycoder.rc
6. package.json 中的 mycoder 字段
7. ~/.config/mycoder/config.js (XDG 标准用户配置)

支持多种文件扩展名：.js、.ts、.mjs、.cjs、.json、.jsonc、.json5、.yaml、.yml 和 .toml。

创建配置文件

在首选位置创建一个配置文件：

// mycoder.config.js
export default {
  // GitHub 集成
  githubMode: true,

  // 浏览器设置
  headless: true,
  userSession: false,

  // 系统浏览器检测设置
  browser: {
    // 是否使用系统浏览器或 Playwright 自带的浏览器
    useSystemBrowsers: true,

    // 首选浏览器类型 (chromium, firefox, webkit)
    preferredType: 'chromium',

    // 自定义浏览器可执行文件路径 (覆盖自动检测)
    // executablePath: null, // 例如: '/path/to/chrome'
  },

  // 模型设置
  provider: 'anthropic',
  model: 'claude-3-7-sonnet-20250219',
  maxTokens: 4096,
  temperature: 0.7,

  // 自定义设置
  // customPrompt 可以是字符串，也可以是包含多行的字符串数组
  customPrompt: '',
  // 多行自定义提示词示例:
  // customPrompt: [
  //   'Custom instruction line 1',
  //   'Custom instruction line 2',
  //   'Custom instruction line 3',
  // ],
  profile: false,

  // Base URL 配置 (针对需要它的提供商)
  baseUrl: 'http://localhost:11434', // Ollama 示例

  // MCP 配置
  mcp: {
    servers: [
      {
        name: 'example',
        url: 'https://mcp.example.com',
        auth: {
          type: 'bearer',
          token: 'your-token-here',
        },
      },
    ],
    defaultResources: ['example://docs/api'],
    defaultTools: ['example://tools/search'],
  },
};

CLI 参数将会覆盖配置文件中的设置。

交互式更正

MyCoder 支持在主代理运行过程中向其发送更正信息。当你发现代理偏离轨道或需要额外信息时，此功能非常有用。

操作步骤

1. 使用 --interactive 标志启动 MyCoder：

   mycoder --interactive "Implement a React component"
   

2. 当代理运行时，按下 Ctrl+M 进入更正模式

3. 输入你的更正信息或额外上下文

4. 按下 Enter 键将其发送给代理

代理将收到你的消息并将其整合到决策过程中，这与父代理向子代理发送消息的方式类似。