# @fungi\.computer/graft 中文文档

规范地址：https://npmcn.com/package/%40fungi.computer/graft/

版本：0\.2\.25
npm 元数据更新时间：2026-11-15T06:03:39.005Z
中文译文更新时间：2026-11-15T18:58:24.649Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：47.1 kB，14 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2026-10-17T00:54:52.761Z
- 最新版本发布：2026-11-15T06:03:38.647Z
- 近 30 天下载量：6581（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：35（近 12 个月 35 个）

## 中文简介

ACP v1 对授权的Shiitake会话的预测

## 安装

```sh
npm install @fungi.computer/graft
```

也可以使用：`pnpm add @fungi.computer/graft`、`yarn add @fungi.computer/graft`、`bun add @fungi.computer/graft`

## README

# 运算( R)`@fungi.computer/graft`(中文(简体) )

此套件通过稳定剂呈现授权的Shiitake会话 客户协议 (ACP) v1. 编辑器和主机集成使用它来创建,加载, 快速并观察会话,而东道主仍然负责 授权.

只要真菌在Zed 或者另一个ACP编辑? 运行 `fungi acp` 看到了吗 [在编辑器中使用真菌](https://docs.fungi.computer/guides/use-fungi-in-your-editor/)。 。 。 . (笑声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声).

## 安装或设置

```sh
npm install @fungi.computer/graft
```

严格的类型Script 消费者也安装 `@modelcontextprotocol/sdk@1.30.0`页:1 转录 Google GenAI 声明参考了这个可选对等点.

## 快开始

只要真菌在Zed 或者另一个ACP编辑? 运行 `fungi acp` 看到了吗 [在编辑器中使用真菌](https://docs.fungi.computer/guides/use-fungi-in-your-editor/)。 。 。 . (笑声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声).

这个自成一体的例子在不批准的情况下初始化了非加太连接 访问任何会话。 用主机替换拒绝目录 接受创建或加载请求前授权的会议目录.

```ts
import * as acp from "@agentclientprotocol/sdk";
import { createHttpStream } from "@agentclientprotocol/sdk/experimental/http-client";
import {
  agentAcpMethods,
  type AuthorizedShiitakeSessionDirectory,
} from "@fungi.computer/graft";
import { createShiitakeAcpServer } from "@fungi.computer/graft/server";

const directory: AuthorizedShiitakeSessionDirectory = {
  create() {
    return Promise.reject(new Error("Session access is not granted"));
  },
  load() {
    return Promise.reject(new Error("Session access is not granted"));
  },
};
const server = createShiitakeAcpServer(directory);
const stream = createHttpStream("https://agent.test/acp", {
  fetch: (input, init) => server.handleRequest(new Request(input, init)),
});
try {
  await acp
    .client({ name: "graft-example" })
    .connectWith(stream, async (ctx) => {
      const initialized = await ctx.request(agentAcpMethods.initialize, {
        protocolVersion: acp.PROTOCOL_VERSION,
      });
      console.log(initialized.protocolVersion);
    });
} finally {
  await stream.writable.close();
  await server.close();
}
```

抓取适配器调用服务器进行中; 它不提出网络请求和 不需要模型或证书。 装入的运行时间证明 [`test/stranger/runtime.mjs`](https://npmcn.com/package/%40fungi.computer/graft/test/stranger/runtime.mjs) 使用 节点. [`test/index.test.ts`](https://npmcn.com/package/%40fungi.computer/graft/test/index.test.ts) 额外证明会话 通过保持的非加太客户端创建、激励和清理.

## 核心概念

-   **该目录拥有访问权限.** 内容 `create` 财务报告和审定财务报表 `load` 方法返回 a 会话只有在主机授权后才具有约束力 。 它可以验证工作 目录,额外的目录,以及会话开幕前的MCP服务器.
-   **师取自会州.** 非加太适应器项目信息、工具 电话、进度、取消和终端结果。 它不拥有 记录或删除持久会话.
-   **非加太公司的连接拥有其租约.** 关闭会话或连接发布 其东道方提供的客户租赁和观察。 活动提示被取消 并允许在其会话中默认和解达5秒 关闭.
-   **服务器是一个适配器.** `createShiitakeAcpServer` 暴露同一个特工 通过维持的可流式HTTP运输;不提供 自行授权.

## API 参考

软件包导出 `createShiitakeAcpAgent`,授权和适配器 类型,以及 `agentAcpMethods` 从 [`src/index.ts`](https://npmcn.com/package/%40fungi.computer/graft/src/index.ts). HTTP 软件 服务器从 [`src/server.ts`](https://npmcn.com/package/%40fungi.computer/graft/src/server.ts)编辑 主机拥有的目录适配器在 [`src/session-directory.ts`](https://npmcn.com/package/%40fungi.computer/graft/src/session-directory.ts)生成 [API 参考](https://npmcn.com/package/%40fungi.computer/graft/docs/api/README.md) 列入柏油丸.

## 实例

-   [`test/index.test.ts`](https://npmcn.com/package/%40fungi.computer/graft/test/index.test.ts) 证明创建/ 装入/ 即时行为 , 通过维护的流媒体消息投影、取消和清理 ACP客户端.
-   私人本地 stdio 主机目前拒绝 ACP `additionalDirectories` 财务报告和审定财务报表 `mcpServers`;其他主机在其授权边界时可能支持它们 允许他们.

## 限制和错误

适配器支持文本和图像提示,嵌入文本或图像资源, 和文本或图像工具结果。 音频和其他二进制资源被拒绝. A 类 主机决定连接的目录、 MCP 服务器和会话 使用时。 非加太创建请求不能提供它们自己的稳定重试身份,所以 目录生成Shiitake的请求身份。 打电话者必须关闭非加太公司 连接,从而解除手表和授权租赁;关闭租赁 不删除会话.

## 贡献和许可证

运行 `pnpm --filter @fungi.computer/graft test` 《非加太国家议定书》 生命周期测试,以及 `pnpm --filter @fungi.computer/graft build` 汇编 软件包。 将装满的焦油丸当作陌生人安装:

```sh
pnpm install --frozen-lockfile
pnpm turbo:run run build --filter=@fungi.computer/graft
pnpm --filter @fungi.computer/graft run pack
pnpm --filter @fungi.computer/graft run stranger
```

陌生人的证明 包装的依赖关闭 并安装在新鲜的 用户已启用图书馆检查 。 软件包使用 MIT 许可证在 [`LICENSE`](https://npmcn.com/package/%40fungi.computer/graft/LICENSE)。 。 。 .

## 编辑能力

适配器使用ACP SDK 1.7并稳定协议v1. 初始化返回 支持协议版本,即使一个编辑器提供了另一个版本 编辑器决定它是否可以继续。 仅当 授权主机目录提供它。 本地列表保存了工程会话 .

主机可能提供终端登录方法. 只有编辑才登广告 支持终端认证; 编辑器在 a 中运行登录命令 单独的交互式进程。 主机目录不获取本地 证书.

文本资源及时保留其URI和内容。 资源链接 保留他们的名字和URI 供特工授权的工具解决 图像, 包括嵌入式图像资源,请输入Shiitake 的限速录入 并持续作为皮伊图像的内容。 历史通过ACP回放图像. 音频和 其他二进制资源返回 `invalid_params`它们不是被悄悄抛弃的.

参考议定书: [初始化](https://agentclientprotocol.com/protocol/v1/initialization) 财务报告和审定财务报表 [内容](https://agentclientprotocol.com/protocol/v1/content)。 。 。 .

## 常见问题

### @fungi\.computer/graft 是什么？

ACP v1 对授权的Shiitake会话的预测

### 如何安装 @fungi\.computer/graft？

在项目目录运行 npm install @fungi\.computer/graft，或使用 pnpm add / yarn add / bun add。

### @fungi\.computer/graft 支持 TypeScript 吗？

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

### @fungi\.computer/graft 支持 ESM 还是 CommonJS？

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

### @fungi\.computer/graft 可以商用吗？

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

### @fungi\.computer/graft 的下载量有多少？

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

### @fungi\.computer/graft 还在维护吗？

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