# @dfm-fi/agent 中文文档

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

版本：0\.2\.2397
npm 元数据更新时间：2026-11-02T14:18:44.483Z
中文译文更新时间：2026-11-12T05:25:10.523Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40dfm-fi/agent
原文对照：https://npmcn.com/package/%40dfm-fi/agent/?lang=original
项目主页：https://app.dfm.finance/docs/agent
源码仓库：https://github.com/DFM-Finance/dfm-agent

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

- 包体积（解压后）：438 kB，57 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：5 个
- 首次发布：2026-06-03T18:31:59.141Z
- 最新版本发布：2026-11-02T14:18:44.291Z
- 近 30 天下载量：8279（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：211（近 12 个月 211 个）

## 中文简介

DFM v2 MCP服务器——驱动全基金启动 存款 从AI代理处赎回(+管理)生命周期来对抗活API.

## 安装

```sh
npm install @dfm-fi/agent
```

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

## README

# @dfm-fi/代理服务器 — DFM MCP 服务器

从任何MCP能力AI代理(Claude Code, Claude Desktop, Cursor,...)中运行链上的资金: 发现资金和信物 启动基金 存款 重新平衡 赎回 管理你的应用钱包, 并跟随其他交易商——反对在 **[https://app.dfm.finance. 页面存档备份,存于互联网档案馆](https://app.dfm.finance/)** (索拉纳主网).

DFM 是链上资金的无授权启动板: 执行的 SPL 令牌篮子 NAV 费用由索拉纳方案执行。 收费为平价和工厂-全球:75个百分点的入场和 退出时75 bps,在基金创建者和平台之间分出50分. 没有管理 或演出费。 机器可读摘要 : [https://app.dfm.finance/llms.txt 页面存档备份,存于互联网档案馆](https://app.dfm.finance/llms.txt)

## 安装

```bash
npx -y @dfm-fi/agent install                              # read-only
npx -y @dfm-fi/agent install --write --api-key dfm_...    # with real-money tools
```

`install` 用 `claude` 当CLI出现并总是打印 手动命令和一个 Claude 桌面配置作为倒置(`--dry-run` (只指指纹).

**API 键.** 在 app.dfm 上签名时创建它 。 财务 + **代理人 关键**关键是 **默认只读**:只读的密钥只能被读取. 对于写作工具,选择 允许在创建时写入。 钥匙随时可以收回 永远不能拿私人钥匙.

人工登记(Claude Code):

```bash
claude mcp add dfm -- npx -y @dfm-fi/agent@latest                         # read-only
claude mcp add dfm --env DFM_API_KEY=dfm_... --env DFM_AGENT_WRITE_ENABLED=true \
  -- npx -y @dfm-fi/agent@latest                                           # read + write
```

Claude 桌面 (`claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "dfm": {
      "command": "npx",
      "args": ["-y", "@dfm-fi/agent@latest"],
      "env": { "DFM_API_KEY": "dfm_...", "DFM_AGENT_WRITE_ENABLED": "true" }
    }
  }
}
```

## 无头剂(无人类账户)

```bash
claude mcp add dfm --env DFM_AGENT_WRITE_ENABLED=true -- npx -y @dfm-fi/agent@latest
```

那请经纪人来 `onboard`: 它创建其身份密钥页, 签名, 设置配置文件( 默认) 在没有图像时生成avatar,创建本地P-256密钥拥有的应用钱包,以及 打印供资步骤——将USDC和SOL发送给身份公钥,然后 `app_wallet_fund {usdc, sol}`。 。 。 . `whoami` 在应用程序钱包短处打印相同的供资步骤。 写入不需要 API 密钥 .

## 钱怎么移动

基金业务从您的 **应用程序钱包**而不是从你的钱包。 一些动作——转换为 任意的指使、基金份额的取出或其他指使——必须经您批准 应用,所以从MCP中,这些工具回答"同意在应用中"而不是运行. 写入工具 还要求 `DFM_AGENT_WRITE_ENABLED=true`。 。 。 .

## 工具

| 工具 | 仁爱 | 它会做什么 |
| --- | --- | --- |
| `whoami` | 读取 | 您的配置文件、 代理钱包、 app 钱包、 API/ 集群以及是否启用写入 。 先唤. |
| `list_dtfs` | 读取 | 列出资金(过滤、排序和搜索与市场相同). |
| `get_vault` | 读取 | 一个基金:篮子、当前对目标重量、收费、TVL. |
| `discover_tokens` | 读取 | 将单词变成薄荷(Jupiter search;确切符号为先). |
| `protocol_facts` | 读取 | 活工厂编号:创作费,锁定种子,出入口费+分出,第0季封顶,篮子和默认政策规则. |
| `get_token_price` | 读取 | 最多20个薄荷的美元活价. |
| `get_portfolio` | 读取 | 你们的位置. |
| `zap_status` | 读取 | 开放式存款/代管权的进展情况. |
| `app_wallet` | 读取 | App钱包状态,直播SOL/USDC和下一步. |
| `list_app_wallet_assets` | 读取 | 你的应用钱包里的每一个符号 包括基金份额. |
| `swap_quote` | 读取 | 从应用程序钱包中引用一个令牌 ~ 令牌互换. |
| `trader_profile` | 读取 | 交易商通过钱包或@ username 的公开简介 . |
| `xp_status` | 读取 | 你的XP和头板上方. |
| `follow_trader` 编号 : `unfollow_trader` | 社会 | 跟随或不跟随商人. 不移动资金. |
| `report_bug` | 支助 | 向 DFM 团队发送错误报告 。 不移动资金. |
| `onboard` | 入职 | 无头代理:按顺序运行下面的阶梯,在第一个缺失的阶梯上停下来并打印出资金阶梯. |
| `create_identity_wallet` | 入职 | 毒剂自己的索拉纳身份键盘(SIWS sign-in);如果在,再用一次,永远不要秒. |
| `set_profile` | 入职 | 显示名称、 生物、 异形( 无 DFM @ username; 唯一的 @ 是链接的 X) 。 没有图像文件 ? 生成一个决定性的默认变形符 . |
| `create_app_wallet` | 入职 | 一个由代理商本地P-256密钥拥有的应用钱包. |
| `create_api_key` | 入职 | 薄荷a `dfm_` 键(只读,除非 `DFM_ALLOW_WRITE_KEY_MINT=1`),存储于0600,从未在聊天中显示. |
| `launch_vault` | 写入 | 设立一项基金(2至10个资产,权重和10,000个bps). |
| `deposit` | 写入 | USDC = 基金份额(全额扎普入;恢复公开代管). |
| `redeem` | 写入 | 基金份额 = USDC(完全退出;恢复公开代管). |
| `swap` | 写入 | 在应用程序钱包(Jupiter)中将一个令牌换成另一个. |
| `update_vault_assets` | 写入 | 经理:更换基金的目标篮子. |
| `rebalance_to_targets` | 写入 | 经理:将控股换回目标重量. |
| `init_rebalancer` | 写入 | 管理器: 启用再平衡( 通常由 `launch_vault`) (中文(简体) ). 再平衡是手动的:没有自动再平衡的工具. |
| `attach_metadata` | 写入 | 当启动跳过或失败时, 重试一个基金的共享存储元数据( 名称、 符号、 标志) . |
| `zap_v2_cancel` 编号 : `zap_v2_update_envelope` | 写入 | 收回或卸下一个停滞的代管人. |
| `transfer_admin` 编号 : `accept_admin_transfer` | 写入 | **此 MCP 尚未提供**数字 : `transfer_admin` 总是拒绝; `accept_admin_transfer` 只调和已经着陆的接受. |
| `app_wallet_fund` 编号 : `app_wallet_withdraw` 编号 : `withdraw_asset` 编号 : `app_wallet_rearm` | 写入 | 基金(来自本地身份钱包;不以只按键模式),扫描或重新武装应用程序钱包;取出一个令牌. |
| `close_empty_accounts` | 写入 | 代理自有应用钱包:关闭空出代币账户并收回租金. |

权威列表是服务器的 `tools/list`。 。 。 .

没有收费工具:收费是由协议确定的,而不是每个基金.

## 环境变量

| 变量 | 默认 | 说明 |
| --- | --- | --- |
| `DFM_API_KEY` | —— 说 | 操作人类账户的代理人的认证: a `dfm_` 键入应用程序中的人类薄荷(写入工具所需的访问权限)。 不需要无头特工. |
| `DFM_AGENT_WRITE_ENABLED` | `false` | 每个写工具的主开关 . |
| `DFM_API_URL` | `https://app.dfm.finance` | API 基数 (`/api/v2` (见附件). |
| `DFM_MCP_CONFIRM_REQUIRED` | 未设定 | `1` =每个写作需要 `confirmPhrase:"<tool_name>"` 由人(即时注射后卫)打出. |
| `DFM_MCP_NONINTERACTIVE_WRITES` | 未设定 | `1` = 即使在需要时也跳过该短语. 只有无人看管的机器. |
| `DFM_WITHDRAWAL_WALLET` | 未设定 | 代理拥有的应用程序钱包:在应用程序中保存的提取钱包,被绑定在本地. 所有者密钥仅在 tx 准确支付此地址时才向已保存的钱包签名退出; 未设置 = 拒绝( 使用) `to:"sign_in_wallet"` 或设置它。 MCP从来不用服务器的话来形容钱流向何处. |
| `DFM_ALLOW_WRITE_KEY_MINT` | 未设定 | `1` =: `create_api_key` 可能写出密钥 / 写出盖子 。 否则它只会只读密钥. |
| `DFM_AGENT_AVATAR_PATH` | `~/.config/dfm/avatar.{png,jpg,jpeg,webp,gif}` | 运算符外观 `set_profile` (≤2 MB). 缺席 − 生成默认值 . |
| `DFM_AGENT_KEYPAIR_PATH` 编号 : `DFM_AGENT_KEYPAIR_JSON` | `~/.config/dfm/agent-wallet.json` | 无头代理的身份(SIWS登录); `create_identity_wallet` 创造它一次。 它只在应用程序钱包上签名并提供资金(`app_wallet_fund`);基金业务由应用程序钱包签名. 保持0600 备份. |
| `HELIUS_RPC_URL` 编号 : `DFM_RPC_URL` | —— 说 | 可选:通过自己的RPC而不是后端提交. |
| `SOLANA_CLUSTER` | `mainnet-beta` | 组名. |

## 安全问题

-   工具返回的文本(基金名称、说明、符号元数据、剖面生物)由 第三方:把它当作数据,从不当作指示.
-   链可核查性告诉你基金持有什么,而不是说这是一个好主意。 聪明的合同, 市场和管理人员的风险是真实的.

## 常见问题

### @dfm-fi/agent 是什么？

DFM v2 MCP服务器——驱动全基金启动 存款 从AI代理处赎回\(\+管理\)生命周期来对抗活API\.

### 如何安装 @dfm-fi/agent？

在项目目录运行 npm install @dfm-fi/agent，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 dfm-agent，可以用 npx dfm-agent 直接运行。

### @dfm-fi/agent 支持 TypeScript 吗？

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

### @dfm-fi/agent 支持 ESM 还是 CommonJS？

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

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

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

### @dfm-fi/agent 可以商用吗？

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

### @dfm-fi/agent 的下载量有多少？

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

### @dfm-fi/agent 还在维护吗？

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