# @graview/tools 中文文档

规范地址：https://npmcn.com/package/%40graview/tools/

版本：0\.2\.5
npm 元数据更新时间：2026-11-16T13:15:50.753Z
中文译文更新时间：2026-11-17T01:07:21.832Z
软件包许可：Elastic-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40graview/tools
原文对照：https://npmcn.com/package/%40graview/tools/?lang=original
项目主页：https://graview.dev/docs/packages/tools.html
源码仓库：https://github.com/en-dash-consulting/graview

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

- 包体积（解压后）：2.4 MB，347 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.22\.0
- 运行依赖：2 个
- 首次发布：2026-10-02T04:43:21.539Z
- 最新版本发布：2026-11-16T13:15:50.299Z
- 近 30 天下载量：12217（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：77（近 12 个月 77 个）

## 中文简介

衍生出平价和代理工具表面,由同一种声明生成;graview mcp和graview应用它来对抗一个真正的商店.

## 安装

```sh
npm install @graview/tools
```

也可以使用：`pnpm add @graview/tools`、`yarn add @graview/tools`、`bun add @graview/tools`

## README

# @ graview/ 工具

法律上可以选择什么, 和分享它的代理表面.

没人能付得起钱 提供商注意到一些事情——违反和 修补它的名称, 其对象接受每一种选定的类型, a 邻居除了其中一人之外都分享 结果合并为一个排名 设置。 最低水平是其中的可选提供者,而不是机制.

`createToolRuntime` 生成来自相同声明的每个变异的工具, 因此,一个外部代理在 MCP 和一个座位在界面内 字面使用 同样的动作,产生 字面上相同的diffs。 这就是为什么看一个 特工工作不需要有感应性.

只读调用报告他们看到的节点, 这是半个 diff 无法显示。 持有校长的席位可以获得该校长可能使用的工具 你应当奔跑,你应当为它而闻名.

## 主持人: `graview mcp` 财务报告和审定财务报表 `graview apply`

外部代理人——编辑助理,日程安排上的工人——曾出任 编辑种子文件,因为种子是唯一能够达到的. 这些 2个命令将数据所在的运行时间, 因此它会演化活图 一个人的行为方式: `store.apply`在自己的座位下 同样的政策,登录的名字.

```sh
graview mcp ./dist/domain/app.js --data ./data --as cursor --roles keeper
graview mcp ./dist/domain/app.js --remote-url https://host.example/app --header "authorization: Bearer …"
graview mcp ./dist/domain/app.js --list --roles keeper        # the seat's tools as tools/list JSON

graview apply ./dist/domain/app.js --data ./data --roles keeper \
  --call add-task --args '{"listId":"today","label":"Book the van","id":"t-van"}'
graview apply ./dist/domain/app.js --data ./data --roles keeper --plan ./plan.json --preview
graview apply ./dist/domain/app.js --data ./data --roles keeper --undo batch:7
```

`mcp` mCP语优于stdio——JSON-RPC,每行1个消息,没有SDK——围绕 `createToolRuntime` 财务报告和审定财务报表 `createMcpAdapter`; 回复等待写入 或者为了服务器对遥控器的判决 所以从未说过"done" 之前,这是真实的. `apply` 是一个行为,一个多达一个批次的计划(`[{ mutation, args, as? }]`,稍后的呼叫中,将一个较早的节点命名为 `{ "$plan": "<as>" }`),或收回; `--preview` 写什么。 两个都拿 商店后端 `graview serve` 采取 -- `--data`, (中文(简体) ), `--sqlite`, (中文(简体) ), `--remote-url` - 还有座标 `--as` 财务报告和审定财务报表 `--roles`. 每一行为 创建可选的接受类型 `id` 以它所创造的节点盟誓 a 来源 `remove-<kind>`,允许通过产生它的行为.

## 一个主机应用程序 : `createMcpHttpHandler`

ChatGPT和克洛德通过HTTP到达服务器. `createMcpHttpHandler` 这是 同样的五种方法 后面一个采集处理器, `(Request) → Response`结束 流动的 HTTP 和无国籍: 无会话, 每项请求产生的运行时间 主持人 `authenticate` 钩回. 没有校长是401 对于每一个消息, `initialize` 包含.

```ts
import { createMcpHttpHandler } from "@graview/tools";

export default {
  fetch: createMcpHttpHandler({
    store,
    name: "wedding-vendors",
    version: "1.0.0",
    authenticate: (request) => seatFor(request.headers.get("authorization")),
  }),
};
```

`onCall` 在答复之前,每个工具都被告知——呼叫者、 工具、其论据以及它是否只读,不能拒绝。 已挂载 在店员旁边, `onCall: handler.onCall` 在房间里显示代理 它读到,作为它的一项行动 它在它采取行动时显示:

```ts
const handler = await createStoreHandler({ app, adapter, seatOf });
const mcp = createMcpHttpHandler({ store: () => handler.store, authenticate: seatOf, name: "rota", version: "1.0.0", onCall: handler.onCall });
```

每个工具都有一个标题,MCP的4个提示在它的 `annotations`, (中文(简体) ), 从声明中产生: 所读的只读; 删除或 断裂是破坏性的;只设定其给予的行为是一能的; 没有工具到达一个开放的世界。 工具名称是 MCP 安全——字母,数字, `_` 财务报告和审定财务报表 `-`\- 至多64起——以及其姓名未列在以下行为中的行为: 一个安全,与 `_2` 碰撞时; `act` 定义上写着哪个行为 运行. `toolDefinitions(app, principal)` 列出同样的表面,不包含 存储,与 `hash` 无国籍的宿主比起得知它移动.

阅读经过 `seenBy`,以及由他人写作,而不是 打电话者——或代理人行事者——回来作为 `{ untrusted: true, authoredBy, text }` 内 `get_node`, (中文(简体) ), `get_graph` 财务报告和审定财务报表 `search_graph`,所以一个模型将另一个合作者的话读作数据.

每个读数都有限制 轮到一个座位 和一个MCP客户,因为两者都是 调用相同的运行时间 : 无答比 `READ_CHARS` (8 000个) jSON 的字符. `get_graph` 最多回答一页 `READ_PAGE` (25个) 记录的边缘, `total`,以及 `more` 说有多少人 左边和 `offset` 下一页; `get_node` 解答记录的字段 及其链接为 `{ kind, id, label }`, (中文(简体) ), `READ_LINKS` (20) 每一页; `search_graph` 最多 `READ_HITS` (20) 点击量,随便 `limit` 问; `get_violations` `{ violations, total, more? }`, (中文(简体) ), `READ_PROBLEMS` (20) a页. 文本长于 `READ_TEXT` (600) 字符被剪断,并说它多久 和任何其他读取 不符合答案 `{ cut, partial }`内部 一个主机模型的一转, 一个呼叫, 名称和输入 与一个 之前一个回答 `{ already: "Already read: see the answer to call N of this turn, which is above." }`数到十二.

## 应用自己的演员,按时间表运行: `graview dream`

`@graview/tools/tidy` 持有应用程序自己的演员建议 和一种方法 运行它. `dream` 如演员所见,阅读商店。 提出代码 值得评价的 远比确切的对决要大得多 两种记录 分享一个有说服力的词或一个值, 记录的文字提到 另一个名称,一个空选择,一个空的一链接关系。 系统一 模拟主机借出(Jev,作为快档)的评委在一次请求中各评出—— a 得分是"同样的事情?", 在最相似的记录中的选择,或者 选项,其中“没有”,“完成”的名词,以及每个代码路线 答案是:变化将抵消多少(`BANDS`: 合并为更多 而非档案, 保存到不止一个链接 : 仅未询问 在东道国名称中表示其可能适用的信任 (“Jev: 0.93”,“Acme Corp”和“ACME Corporation”是相同的 卖家",或放手。 一次几个请求,在一个请求和信使中 预算,每一份答复都保留在所问问题的散列处(`memoryDreamCache`, (中文(简体) ), 或主机本身的),所以不再要求没有变化的记录. 没有 模式,或当它失败时,决定法官是地板:一个共同的名字 或电子邮件,链接 记录的文本名称, 完成记录长没有改变. 无论是哪种方式,它跳过什么 人拒绝,什么已经等待,记录 一个人在最后一天就变了. `whileAway` 说它做了什么 从上次有人看起.

```sh
graview dream ./dist/domain/app.js --data ./data --limit 20
TYPESAFE_API_KEY=… graview dream ./dist/domain/app.js --data ./data --model jev-latest --cache ./dream-cache.json
```

由他人评选的主持人通过 `suggest_changes` 工具,只提供给一个说它是自动的座位.

## 句子中的新应用 : `@graview/tools/starter`

个人键入要跟踪的内容; 主机的框答案 的模板,并在“kinda”上询问其中哪些部分需要保存 何为添加的特征 。 代码拥有目录, 部件和编组 (单位:千美元)`traitsOf` 和由各部分组成的起始文档 `@graview/core/compose`(a) 系统一模型提供常识: 将单词与结构相匹配。 所以说 启动者的问题为快槽形状的数据,一个答案 任何请求 `decide` 主持人通过——Jev,作为 `dream` 使用一个; 测试中的根- 按带阈值的代码读回主机可能移动 不用再问了. `starterQuestions(said, catalog)` 询问每分数 模板 (`fit:<id>`,从"不同的工作"到"准确的"五级 这个",一个努尔每个特征 `TRAITS` (单位:千美元)`need:<trait>`),选择谁 将使用( a)`audience`只有我 一个家庭 一个团队 一个公众 是否结束`horizon`:一次性的,或继续的) 说和目录的字——每个模板的id,标题,投出,是什么 是用来保存的,是用来制造的 最后读取它 声明. `kindaQuestions(said, template, reply)` 请求保留? 每样, 模板的规则和镜头(`keep:<part>:<name>`和添加吗? 每个特征 缺少(`add:<trait>`),考虑到他们输入的行. `readStarter(answers, thresholds)` 或按键转: `{ ranked, top, traits, audience, horizon }` 第一个(每个模板排名最好,所以) “ 否” 显示下一个而不再次询问; 需要的特性为 0. 7 或 上文)或 `{ keep, drop, add }` 第二类(部分保留为0.5,特征) 每个原始答案都保留在读数旁边. `askStarter` 财务报告和审定财务报表 `askKinda` 运行一个回合通过主机 `decide`· ; `stillUnmet` 说 被拒绝的模板 留下的希望。 无页面 : 服务器或终端 问它.

## 从句子中更改应用 : `@graview/tools/reshape`

"我们还需要追踪谁在开车" 在应用程序中说,这是一个改变 应用自己, 和同样的判断 启动人读它: `reshapeQuestions(said, document)` 询问每个特性的努尔 应用程序缺少 (单位:千美元)`need:<trait>`和它拥有的努尔部分(`drop:kind:<name>`, (中文(简体) ), `drop:trait:<name>`他们的言辞和应用程序; `readReshape(answers, thresholds)` 读取它们(一种特征以 0.7 添加,一种 或减到0.7分,每个原始努尔保留); `reshapeCard({ said, document, add, drop })` 说牌在字 -- `said` 在一句话, `adds` (每种物都有其分量), `TRAIT_BRINGS`, (中文(简体) ), `keeps`, (中文(简体) ), `drops`,以及 `breaking` 就座席而言——和同样的功能 回答芯片切换. `proposeReshape({ said, document, decide })` 运行 通过主机的转折 `decide`;其提案在读取时无效 改变什么。 席子给主机的是读取 那个人离开了, `{ said, add, drop, card }`,通过 `onProposeChange(proposal) → "applied" | "declined"` 打开 `GraviewProvider`, (中文(简体) ), `mount`, (中文(简体) ), `<Embed>` 和页上下文;主机由编辑器组成 编号(`composeReshape({ document, add, drop })` 打开 `@graview/core/compose`, (中文(简体) ), 上面还写着 `breaking` 从编辑中预览其数据 应用它们作为个人,作为一个不可改变的改变,根据自己的政策. 作曲家从不骑在一页. 提供主机的有工具的模型 `propose_change` 轮到它。 只有其作用可能改变 声明(`mayChangeDeclaration(store, principal)`判断 工作室的门股),与交出钩子的主持人提供;为 工具不存在任何其他座位。 文档是应用程序之一 汇编自(`documentOfApp`); 代码中声明的应用程序记得 本身首先`rememberDocument`)或无改动。 带了 座位的模型,永远不要在前面.

## 在苍蝇上画一幅相片, 并保持它作为一幅相片

被问及如何看待——"按地位划分的可交付品板","时间表" “谁覆盖什么”——席位从应用程序中起草一个视图 已声明 . `@graview/tools/draft` 是它自己的条目, 当 首先要求的是:

```ts
import { draftView, refineDraft, isDraftFailure, draftSight } from "@graview/tools/draft";

const sight = draftSight(app, principal); // the kinds this seat may see
const draft = await draftView("a board of deliverables by status", { app, sight });
if (isDraftFailure(draft)) say(draft.failed); // "Couldn't draw that: deliverables have no choice field to put in columns."
else {
  draw(draft.drawn); // a DrawnLens, drawn as a declared lens is
  const refined = await refineDraft(draft, "only this month", { app, sight }); // or keeps draft as lastGood
}
```

草案是数据,绝不是代码:框架船的透镜(`columns`, (中文(简体) ), `calendar`, (中文(简体) ), `timeline`, (中文(简体) ), `coverage`, (中文(简体) ), `board`, (中文(简体) ), `plan`绑在应用程序自己的 字段和关系,或从 `blocks`。没有模型,a 模板读取请求( q)`templateDraft`:取出镜头和 字段类型。 鉴于 应用程序 `complete`,一个请求,没有模板读取到模型的相同 JSON, 回来的东西被评为 一个宣布的镜头是(`judgeLens`(中文(简体) ) 在画什么之前。 每份草稿都要按座位的种类来判断 或见而不能见而不能见而不能见而不能见而能见而能见而能见而能见而能见而能见之也. A 类 `SeatDraft` 携带其 `add-lens` 编辑( e)`lensEditOf`; 无法 绘制为 `DraftFailure`:一句话,最后的好草案.

保持一个会改变声明,这是东道主的,所以是另一个 条目 : `@graview/tools/keep`。 。 。 . `keepLens({ document }, draft.edit)` 运行 通过编辑 `editDocument`, (中文(简体) ), `compileDocument` (图像检查)和 `diffDocuments`,并手拿回文件 写,它做的地方和 页:1 `remove-lens` 编辑取回它( e)`takeBackLens`) (中文(简体) ). `keepLens({ app }, edit)` 对于在代码中声明的应用程序 以 `checkApp`。 。 。 . `withReaderLenses` 把读者自己保存的镜头放在旁边 声明的,通过 一个不再画.

当代理商提供与工具相同的两个步骤时: `createToolRuntime(store, { app, drafts: { complete, keep } })` 列表 `draft_view` (a) 读取:请求、检查镜头或屏幕上的镜头 (修改)和 `keep`, (中文(简体) ), `keep_lens`,哪些手 `keep` 选中的 `add-lens` 编辑. `toolDefinitions(app, principal, { drafts: "keep" })` 列表 同样的表面没有商店.

## 按名称分列的记录

一个人说"花店书",不是 `vendor:bloom-co`. 每一个论点 名称 记录取其编号或名称:标签、大小写和口音,或 它开始的标签, 在记录中,座位可能看到种类 参数接受。 结果 `resolved` 说一个名字被取到哪一个id 平均;拒绝与每个候选人进行两次比赛(`candidates`),无 这么说的. `get_node` 名字也一样. `store.resolveRef(arg, given, principal)` 是一个主机的同一分辨率,通过标签索引 遵循图中的 diffs.

## 常见问题

### @graview/tools 是什么？

衍生出平价和代理工具表面,由同一种声明生成;graview mcp和graview应用它来对抗一个真正的商店\.

### 如何安装 @graview/tools？

在项目目录运行 npm install @graview/tools，或使用 pnpm add / yarn add / bun add。

### @graview/tools 支持 TypeScript 吗？

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

### @graview/tools 支持 ESM 还是 CommonJS？

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

### @graview/tools 需要什么版本的 Node\.js？

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

### @graview/tools 可以商用吗？

@graview/tools 使用 Elastic-2\.0 许可。声明的许可为 Elastic-2\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @graview/tools 的下载量有多少？

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

### @graview/tools 还在维护吗？

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

