# @falkenslab/agent-kit 中文文档

规范地址：https://npmcn.com/package/%40falkenslab/agent-kit/

版本：0\.35\.0
npm 元数据更新时间：2026-11-12T07:08:02.039Z
中文译文更新时间：2026-11-14T09:33:56.549Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40falkenslab/agent-kit
原文对照：https://npmcn.com/package/%40falkenslab/agent-kit/?lang=original
项目主页：https://github.com/falkenslab/agent-kit#readme
源码仓库：https://github.com/falkenslab/agent-kit

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.1 MB，232 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：14 个
- peer 依赖：fflate \>=0\.8\.0，mammoth \>=1\.6\.0，linkedom \>=0\.16\.0，turndown \>=7\.0\.0，@mozilla/readability \>=0\.5\.0
- 首次发布：2026-09-28T12:32:08.121Z
- 最新版本发布：2026-11-12T07:08:01.829Z
- 近 30 天下载量：2626（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：30（近 12 个月 30 个）

## 中文简介

在克洛德特工SDK上方建一个代理的图书馆

## 安装

```sh
npm install @falkenslab/agent-kit
```

也可以使用：`pnpm add @falkenslab/agent-kit`、`yarn add @falkenslab/agent-kit`、`bun add @falkenslab/agent-kit`

## README

![agent-kit logo: three blue building blocks and a coral one being set in place](https://raw.githubusercontent.com/falkenslab/agent-kit/main/docs/static/img/logo.svg)

# 代理设备

**在克劳德身上建立一个AI代理,在它行动之前询问,记忆,和聊天像克劳德代码.**  
你写你的经纪人知道和做的; 工具包带来监督,安全,内存和接口.

[![npm](https://img.shields.io/npm/v/@falkenslab/agent-kit?color=cb3837&logo=npm)](https://www.npmjs.com/package/@falkenslab/agent-kit) ![Node.js 20+](https://img.shields.io/badge/node-20%2B-339933?logo=node.js&logoColor=white) ![Claude Agent SDK](https://img.shields.io/badge/Claude-Agent%20SDK-d97757?logo=anthropic&logoColor=white) ![TypeScript](https://img.shields.io/badge/types-included-3178c6?logo=typescript&logoColor=white) [![License: MIT](https://img.shields.io/badge/license-MIT-16a34a)](https://npmcn.com/package/%40falkenslab/agent-kit/LICENSE)

**[页:1](https://falkenslab.github.io/agent-kit/)** • 妇女 [埃斯帕尼奥尔文件](https://falkenslab.github.io/agent-kit/es/)

特工基特是建造AI特工的基础 在顶端 [克劳德探员SDK](https://www.npmjs.com/package/@anthropic-ai/claude-agent-sdk)。它不是一个代理本身:它一旦解决了每一个代理需要的东西(监督级别,批准,安全限制,跨会话的内存,扩展,以及像克洛德代码那样的终端聊天),所以每个代理只写属于它自己的域:它知道怎么做,用什么工具,如何说话. 老师的"Moodle"助理和"说笑话"的"海盗"猫"都是同样建造的.

## 为什么是特工

-   🎚️ **你选择它独自行动的程度.** 自动的,引导的(它问在别人看到或无法解除之前),一步步的,或者计划模式,它只读和计划;在同一对话中切换它们.
-   ✋ **它问一个人, 和工具包确定.** 批准,选择,一个文件,一个手签;一个已经安装的扩展名的工具,可以改变事物,等待任何模型决定的肯定,答案可以持续到会话或好.
-   🧠 **它记得.** 一种知识基础,随着每次会话的不断增长,它从未触及的原始文献中学习的原始文献,对人的记忆,以及每一次与人对话的回放 `--continue` 或者说 `/resume`。 。 。 .
-   🛡️ **它保持在极限.** 只有它自己的文件夹,从不保护文件,不能滑过主代理极限的子代理,隐藏在日志中的秘密,远程服务器允许,询问或拒绝.
-   🧩 **它随着扩展而增长.** Claude代码插件,带有MCP服务器,技能和命令,从市场或文件夹中安装,在聊天中有自己的选项,签名和目录;不需要Git.
-   🌐 **它会说出你的语言.** 它的界面是英语,西班牙语,法语或德语,它用该语言回答,除非你用另一种语言写.
-   🖥️ **像克洛德代码那样的终极聊天, 或者根本没有.** 全屏幕,活的标记下,折叠的工具呼叫,面板,历史,主题;或者桌面应用程序或网页内有自有界面的同一种代理.

## 快速启动

惠璶 [节点.js](https://nodejs.org/) 20岁或20岁以后 还有克劳德的账户 在与 `"type": "module"` 联合国 `package.json`数字 :

```bash
npm install @falkenslab/agent-kit tsx
```

另存为 `agent.ts`:唯一属于你经纪人的部分是顶部的谱.

```ts
import path from "node:path";
import { buildSessionOptions, ensureClaudeAuth, runChatInk, type AgentSpec, type BaseSessionConfig } from "@falkenslab/agent-kit";

const spec: AgentSpec<BaseSessionConfig> = {
  buildSystemPrompt: () => "You are a pirate cat who tells jokes. Always answer in character.",
  buildMcpServers: () => ({}), // its own MCP servers, if any
  pluginRoots: () => [], // folders with skills and commands
  buildSubagents: () => undefined, // subagents, if it delegates to any
};

await ensureClaudeAuth(); // offers to sign in with your Claude account, on Anthropic's page, if it isn't
const config: BaseSessionConfig = { mode: "guided", projectDir: process.cwd() };

// Each run gets a folder under .run/ (keep it out of git): its log, transcript and conversation.
await runChatInk((run) => buildSessionOptions(config, run.dir, spec, { run }), {
  runsDir: path.resolve(".run"),
  header: { title: "My agent" },
  mode: config.mode, // Shift+Tab cycles through guided, step by step and plan
  fullscreen: true,
});
```

运行它 `npx tsx agent.ts`:一个全屏聊天打开,用你系统的语言,代理在任何不该单独做的事情之前询问. 这个 [教程](https://falkenslab.github.io/agent-kit/docs/getting-started/first-agent) 从那里拿走.

## \- 密码的味道

给它一个内存和一个源的文件夹, 与工具包自己的扩展:

```ts
import { knowledge, memory, sources } from "@falkenslab/agent-kit";

const spec: AgentSpec<BaseSessionConfig> = {
  // …
  extensions: [sources({ dir: "sources" }), knowledge({ dir: "knowledge" }), memory({ dir: "memory" })],
};
```

让它从您的市场安装扩展, 并保持它的数据离开计算机而不询问:

```ts
const config: BaseSessionConfig = {
  mode: "guided",
  projectDir: process.cwd(),
  extensionDirs: { agent: path.join(os.homedir(), ".my-agent", "extensions") },
  officialMarketplace: "falkenslab/agent-extensions",
  remoteServers: "ask",
};
```

做一个工具总是等待 一个人是,在每一个呼叫:

```ts
const spec: AgentSpec<BaseSessionConfig> = {
  // …
  extensionGate: { confirmTools: { canva: ["create-design", "publish-design"] } },
};
```

## 工作上见

[威斯克队长](https://npmcn.com/package/%40falkenslab/agent-kit/examples/captain-whiskers),工具箱的楷模代理:一个退休的海盗猫用你的语言讲笑话,有一群子代理(一个在网络上寻找新笑话,一个评分,一个告诉时间),一个日志和自己的扩展. 他在终端,浏览器和Windows应用程序中运行.

![Captain Whiskers in Windows Terminal: his logo with the mode and the agent-kit version at the top, his crew at work in the middle, a task list under the spinner, and the framed prompt and status bar at the bottom](https://raw.githubusercontent.com/falkenslab/agent-kit/main/docs/assets/captain-whiskers.png)

见 [尽他所能](https://falkenslab.github.io/agent-kit/docs/examples/captain-whiskers#what-he-can-do)有截图 对于一个真正的, [宫城](https://github.com/falkenslab/miyagi) 是Moodle教师的助手:它分数、回答论坛、构建内容、总结课程, 监督、记忆、安全和聊天都来自工具箱;Miyagi带来了它所知道的关于Moodle的东西.

## 里面有什么东西

| 区域 | 举个例子 |
| --- | --- |
| \* 模式和大门 | 自主地,有指导地,分步骤地,有计划地;有指导地,有指导地,有指导地,有指导地,有指导地,有指导地,有指导地,有指导地,有指导地,有指导地,有计划地,有指导地,有指导地,有指导地,有指导地 |
| 环中人 | 批准、选择、自由文本、文件、手动步骤、MCP引出表单、没有键盘的主机响应文件 |
| QQ 记忆 | 一个知识库(一个LLM wiki), 源保持获得, 人物记忆, 运行恢复与 `--continue` 财务报告和审定财务报表 `/resume` |
| ++ 扩展 | 使用 MCP 服务器( 本地、 npm 、 远程 OAuth) 的 Claude 代码插件、 技能、 命令和子代理; 范围、 锁定、 工作空间信任、 选项、 市场和目录 |
| • 警卫 | 一个文件瞄准门, 拒绝路径, 子代理门, 一个远程服务器门, 与跑者自己的 Claude 代码隔离 |
| 副代理人 | 仅宣布类型,在前景中,没有主要代理的 Bash |
| ++ 接口 | 一个全屏墨水聊天,一个平版读行聊天,一个进度视图,一个向导,一个主题;一个桌面应用程序和网页的聊天控制器;一个MCP服务器,所以其他代理可以询问它的东西 |
| 语文 | 界面、答复和扩展服务器的英文、西班牙文、法文和德文 |

每一个出口,用它需要的和它给予的,都是在 [API 参考](https://falkenslab.github.io/agent-kit/docs/api)。 。 。 .

## 页:1

-   **[开始](https://falkenslab.github.io/agent-kit/docs/getting-started/installation)**:安装和第一代理,分步进行.
-   **[模式](https://falkenslab.github.io/agent-kit/docs/core-concepts/modes)** 财务报告和审定财务报表 **[循环中的人类](https://falkenslab.github.io/agent-kit/docs/human-in-the-loop/overview)**:代理人独活多活,又如何问.
-   **[扩展](https://falkenslab.github.io/agent-kit/docs/extensions/overview)**:安装,撰写并出版.
-   **[警卫](https://falkenslab.github.io/agent-kit/docs/security/overview)**每一个护栏, 和装备不能保护的东西.
-   **[终端聊天](https://falkenslab.github.io/agent-kit/docs/terminal-ui/ink-chat)**:它的键,面板,选项和主题.
-   **[威斯克队长](https://falkenslab.github.io/agent-kit/docs/examples/captain-whiskers)**:示例代理,逐个分出.

## 发展中

设计决定 和SDK行为 通过人工检查 背后的几个保障 [`.minispec/`](https://npmcn.com/package/%40falkenslab/agent-kit/.minispec/README.md)。 。 。 .

| 命令 | 它会做什么 |
| --- | --- |
| `npm run build` | 将工具包构建为 `dist/` |
| `npm run typecheck` | 检查类型而不构建 |
| `npm run lint` | 检查代码样式 |
| `npm test` | 运行所有测试( 一个文件 : `npx tsx --test test/tui/promptErrors.test.ts`(中文(简体) ) |
| `npm run docs:install` | 安装文档站点的依赖性( 一次) |
| `npm run docs:start` | 在本地服务文档站点, 重新加载更改 |
| `npm run docs:build` | 构建文档站点( 断开链接失败) |

在代理机中尝试修改套件而不发布,请指其 `package.json` 切换为本地克隆`"file:../agent-kit"`运行 `npm run build` 每次改变之后.

与克洛德密码合作的工具包通过Falken实验室的自身技能(承诺、核实、更新文件、发布、同步问题,以及READMEs、网站和Markdown的家用风格),来自 [falkenslab/falkenslab-插件](https://github.com/falkenslab/falkenslab-plugins) 市场。 安装一次,所有法尔肯实验室的仓库:

```bash
claude plugin marketplace add falkenslab/falkenslab-plugins
claude plugin install falkenslab-dev@falkenslab-plugins
claude plugin install falkenslab-style@falkenslab-plugins
```

每个插件带来什么, 以及留在这个寄存器

-   🔧 **falkenslab- dev 数据**数字 : `commit`, (中文(简体) ), `verify`, (中文(简体) ), `update-docs`, (中文(简体) ), `release`, (中文(简体) ), `sync-issues`, (中文(简体) ), `upgrade-deps` 财务报告和审定财务报表 `add-tool`。 。 。 .
-   🎨 **falkenslab 样式**数字 : `falkenslab-docs`, (中文(简体) ), `falkenslab-site-style`, (中文(简体) ), `falkenslab-terminal-screenshots` 财务报告和审定财务报表 `markdown-writing`。 。 。 .

在克洛德代码内,同样与 `/plugin marketplace add falkenslab/falkenslab-plugins` 财务报告和审定财务报表 `/plugin install falkenslab-dev@falkenslab-plugins`· ; `/plugin marketplace update falkenslab-plugins` 带来他们的最新版本。 这个寄存器只保存作为代理 Kit 自己的技能, in `.claude/skills/` (单位:千美元)`add-export`、迷你电视剧和 `upgrade-sdk`),而其释放对一般的附加内容是: [`CLAUDE.md`](https://npmcn.com/package/%40falkenslab/agent-kit/CLAUDE.md#releasing)。 。 。 .

由法尔肯实验室团队制作

## 常见问题

### @falkenslab/agent-kit 是什么？

在克洛德特工SDK上方建一个代理的图书馆

### 如何安装 @falkenslab/agent-kit？

在项目目录运行 npm install @falkenslab/agent-kit，或使用 pnpm add / yarn add / bun add。

### @falkenslab/agent-kit 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @falkenslab/agent-kit 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @falkenslab/agent-kit 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @falkenslab/agent-kit 可以商用吗？

@falkenslab/agent-kit 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @falkenslab/agent-kit 的下载量有多少？

根据 npm 官方下载统计，@falkenslab/agent-kit 在 2026/10/14 – 2026/11/12 这 30 天内被下载 2,626 次，日均约 88 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @falkenslab/agent-kit 还在维护吗？

最新版本 0\.35\.0 发布于 2026/11/12（2 天前）；至今共发布 30 个版本，其中过去 12 个月发布了 30 个；首次发布于 2026/09/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。