Craft Agents 是什么？

想象你有一个超级助手——它不仅能回答问题，还能真正帮你做事：发邮件、查数据库、连接 Slack、运行代码。这就是 Craft Agents 做的事。它是由 craft.do 团队专门为"指挥 AI Agent 干活"而打造的 TypeScript 桌面应用。

Craft Agents 使用了 Anthropic 的 Claude Agent SDK，把复杂的"让 AI 自主行动"能力打包成了一个优美的桌面应用。

代码里的"主演"——核心类型

Craft Agents 的代码就像一部剧，有几个主角。理解它们，你就能告诉 AI "把这个逻辑放到 Session 里，不要放到 Workspace 里"——这正是指挥 AI 的关键。

代码翻译：Session 是如何定义的

下面是 Craft Agents 里 Session 的真实定义（来自 packages/core/src/types/session.ts）。左边是代码，右边是白话解释：

export interface Session {
  id: string;
  sdkSessionId?: string;
  workspaceId: string;
  name?: string;
  status?: SessionStatus;
  isFlagged?: boolean;
  isArchived?: boolean;
}
            

发一条消息，幕后发生了什么

你在 Craft Agents 里打了一段话按下发送——这个简单动作触发了一条完整的指令链。点击"下一条消息"，跟着数据走一遍：

检验一下你的理解

AI 为什么需要"工具"？

把 Claude 想象成一位知识渊博的顾问——但他被关在一个没有网络、没有电话的房间里。他知道该怎么查销售数据，但他进不了你的数据库。工具就是给他开的那扇门。

MCP——工具的"通用插口"

Craft Agents 支持 MCP（Model Context Protocol）。MCP 就像给 AI 工具定义了一种"通用 USB 接口"——任何工具只要实现这个接口，Claude 就能直接用它，不需要为每个工具单独写适配代码。

代码翻译：Session MCP Server 的工具注册

Craft Agents 内置了一个特殊的 MCP 服务——session-mcp-server，它让 Agent 能感知到自己所在的会话上下文。下面是它如何注册一个工具（来自 packages/session-mcp-server/src/index.ts）：

const server = new McpServer({
  name: "craft-session",
  version: "1.0.0"
});

server.registerTool(
  "get_session_info",
  { description: "Get current session metadata" },
  async () => ({ content: sessionData })
);
            

工具调用的完整数据流

当 Claude 决定调用一个工具，数据是这样在系统里流动的：

思考一下

技能包：给 Agent 的"操作手册"

想象你雇了一个新员工，第一天上班。你不会让他什么都靠猜——你会给他一本操作手册，写着"接到客户投诉时，先查订单状态，再用这个模板回复"。Craft Agents 的技能（Skills）就是这个操作手册。

代码翻译：MessagingGateway 如何路由指令

整个 Craft Agents 的核心是 MessagingGateway。它采用了一种叫 命令模式（Command Pattern） 的架构：

export class Router {
  private handlers = new Map<
    string,
    CommandHandler
  >();

  register(type: string, handler: CommandHandler) {
    this.handlers.set(type, handler);
  }

  async dispatch(cmd: Command) {
    const handler = this.handlers.get(cmd.type);
    return handler?.execute(cmd);
  }
}
            

自动化：让 Agent 在后台自主运行

Craft Agents 最强大的功能之一是自动化（Automations）——基于事件触发的 Agent 任务，不需要你手动开启。这就像给 Agent 设置了一套巡逻规则：

应用思考

两种运行模式

Craft Agents 有两种运行形态，适合不同场景。就像同一款软件，可以安装到个人电脑上用，也可以部署到公司服务器上让全团队访问：

项目结构地图

理解这个目录结构，你就能告诉 AI"去 packages/messaging-gateway 里修改路由逻辑"，而不是让它到处乱找：

代码翻译：Server 启动逻辑

下面是 Craft Agents 在 Server 模式下的启动流程（来自 packages/server-core/src/bootstrap/）：

export async function bootstrap(config: ServerConfig) {
  const gateway = await createGateway(config);
  const transport = new HttpTransport(gateway);
  await transport.listen(config.port);
  return { gateway, transport };
}
            

综合考验