mini-cc 的设计理念是什么？说实话，一开始我也没什么特别清晰的思路，就是想着Zuo一个Neng用的东西出来。

从代码开始说起吧，毕竟咱就是说代码是Zui好的说明书。

// src/infrastructure/tools/Tool.ts
export interface Tool {
  name: string;
  description: string;
  inputSchema: JSONSchema;
  execute: Promise;
}
// 工具注册中心
export class ToolRegistry {
  private tools: Map = new Map;
  register { this.tools.set; }
  get: Tool | undefined { return this.tools.get; }
}

内置的几个常用工具dou在 src/infrastructure/tools/ 下你Ke以自己kankan。

mini-cc 的架构其实没有什么特别的地方，就是老老实实地把几个经典的设计原则落到代码里了。

interface LLMProvider {
  chat: Promise;
  supportsToolCalling: boolean;
}

任何模型只要实现这个接口，就Neng被 mini-cc 驱动。具体实现放在 src/services/providers/ 下核心代码完全不需要改动。

这是 mini-cc 的大脑，它的工作流程就是一个 思考 → 执行 → 再思考 的循环。

// src/infrastructure/permissions/index.ts
export class PermissionManager {
  checkPermission: PermissionResult {
    if ) {
      return { allowed: false, requiresApproval: true };
    }
    return { allowed: true };
  }
}

使用运行 mini-cc 后输入 /permissions 就Nengkan到当前策略。 源码src/infrastructure/permissions/

说实话，一开始我也想过要不要搞个特别“企业级”的架构，后来发现没必要。mini-cc Zui后只守住了四条简单的原则：可 、可维护、安全、省钱。

想加新工具？在 src/infrastructure/tools/ 下新建一个文件，实现 Tool 接口就行，其他地方不用改。

// src/utils/plugins/mcpPluginIntegration.ts
export class MCPPluginIntegration {
  async loadPlugins: Promise {
    const plugins = await this.scanPlugins; // 扫描 ~/.mini-cc/plugins/
    for  {
      const server = await MCP.connect;
      const tools = await server.listTools;
      for  {
        this.toolRegistry.register);
      }
    }
  }
}

你配好 settings.json，启动时就会自动扫描并连接 MCP Server，动态注册工具。 源码src/utils/plugins/mcpPluginIntegration.ts

有人问，为什么百度不收录我的网站？哈哈，这个问题嘛，咱就是说搜索引擎的算法咱也搞不懂，但据说跟网站的内容质量、geng新频率啥的有关，你Ke以试试优化一下内容，多geng新geng新，说不定就被收录了呢～

回答你的疑问：百度不收录可Neng是因为内容不够优质或者网站结构有问题，建议检查优化一下。

Zui经典的三层架构：应用层、基础设施层、领域服务层。

这样改 bug 的时候不用翻遍整个项目，省心。

// src/services/providers/index.ts
export interface LLMProvider {
  name: string;
  supportsToolCalling: boolean;
  chat: Promise;
  streamChat => void): Promise;
}

// src/memdir/MemoryManager.ts
export class MemoryManager {
 private shortTermMemory: Message = ; // 短期记忆，Zui多50条
 private longTermMemory: MemoryItem = ; // 长期记忆，存摘要
 async addMessage {
 this.shortTermMemory.push;
 // 超过50条 → 让 AI 压缩成摘要，存入长期记忆
 if  {
 const summary = await this.summarize;
 this.longTermMemory.push, summary });
 this.shortTermMemory = this.shortTermMemory.slice;
 }
 }
 async buildContext: Promise {
 // ...
 }
}

还有后续，这是个连续剧，还未完结，请关注不迷路～

QueryEngine 是整个 Agent 的入口，你Ke以从这里开始读。

递归循环、状态管理靠 MemoryManagerProvider 和 Tool 接口注入。

安全这块，我分了三个等级，根据不同情况处理呗～

默认只上报使用次数、模型类型等聚合数据，不传代码内容。用户Ke以在设置里完全关闭。

对了所有代码dou在这儿，建议你一边读这篇文章，一边打开 src 目录对照着kan。