# @atrib/summarize 中文文档

规范地址：https://npmcn.com/package/%40atrib/summarize/

版本：0\.6\.1
npm 元数据更新时间：2026-10-23T18:21:03.156Z
中文译文更新时间：2026-11-07T03:56:51.578Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40atrib/summarize
原文对照：https://npmcn.com/package/%40atrib/summarize/?lang=original
项目主页：https://atrib.dev/
源码仓库：https://github.com/creatornader/atrib

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

- 包体积（解压后）：48.6 kB，13 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：3 个
- 首次发布：2026-05-06T01:57:57.556Z
- 最新版本发布：2026-10-23T18:21:02.774Z
- 近 30 天下载量：2902（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：45（近 12 个月 45 个）

## 中文简介

遗留summarization MCP服务器在D164别名窗口中保留. 汇总签名的记录,使代理读取上下文,而不是原始字节.

## 安装

```sh
npm install @atrib/summarize
```

也可以使用：`pnpm add @atrib/summarize`、`yarn add @atrib/summarize`、`bun add @atrib/summarize`

## README

# @atrib/摘要

MCP 服务器显示 `summarize` 用于 Atrib 可核查的动作层的工具。 它使用一个OpenAI相容的LLM来合成一个跨越N记录的叙述.

**在npm上贬值.** `summarize` 没有后续形状 `recall` 动词 ([D164电话](https://github.com/creatornader/atrib/blob/main/DECISIONS.md#d164-attestrecall-verb-rename-and-primitive-surface-collapse):读取的表面返回已核实的材料而调用者合成. 工具通过别名窗口挂起 .

关闭消费方的认知空间 原始伴侣 `atrib-trace`: track 返回所声明的关联路径; 总结返回所选记录上被合成的含义. 两者都读取同一个本地镜像,包括可选的 `_local` 侧车.

## 安装

```bash
pnpm add @atrib/summarize
```

验证本地建筑 `pnpm --filter @atrib/summarize test`。 。 。 .

## 工具

```
mcp__atrib-summarize__summarize({
  context_id?: string,        // 32-hex trace; summarize all records in it
  record_hashes?: string[],   // explicit list; unioned with context_id
  focus?: string,             // optional steering for the synthesis
  max_records?: number,       // cap on records fed to LLM (default 50, max 200)
  model?: string              // override model from env
})
→ {
  narrative: string | null,
  cited_record_hashes: string[],
  records_summarized: number,
  records_skipped: number,           // beyond max_records
  records_with_sidecar: number,      // had semantic content
  records_without_sidecar: number,   // legacy bare records, impoverished input
  model_used: string | null,
  warnings: string[]
}
```

## LLM 提供者

OpenAI-相容的HTTP. NVIDIA NIM 默认为 `qwen/qwen3.5-397b-a17b`。通过掩体或每个呼叫覆盖 `model` 输入 :

| 新闻 var | 默认 |
| --- | --- |
| `ATRIB_SUMMARIZE_API_KEY` | 返回到提供者内/缓存 |
| `ATRIB_SUMMARIZE_BASE_URL` | `https://integrate.api.nvidia.com/v1` |
| `ATRIB_SUMMARIZE_MODEL` | `qwen/qwen3.5-397b-a17b` |
| `ATRIB_SUMMARIZE_MAX_TOKENS` | `4000` |
| `ATRIB_SUMMARIZE_TEMPERATURE` | `0.3` |
| `ATRIB_SUMMARIZE_TIMEOUT_MS` | `120000` |

提供者掩体/缓存回落 :

| 提供方 URL 包含 | 新闻 var | 快取文件 |
| --- | --- | --- |
| `integrate.api.nvidia.com` | `NVIDIA_API_KEY` | `~/.atrib/secrets/nvidia-api-key` |
| `api.cerebras.ai` | `CEREBRAS_API_KEY` | `~/.atrib/secrets/cerebras-api-key` |
| `cloudflare.com` | `CLOUDFLARE_API_KEY` | `~/.atrib/secrets/cloudflare-api-key` |

没有 API 密钥, 工具将返回每个 [第5.8节](https://github.com/creatornader/atrib/blob/main/atrib-spec.md#58-degradation-contract) 优雅的降级合同.

## 读取

与 `@atrib/trace`: 每一个 `*.jsonl` 镜像下方 `~/.atrib/records/` (通过 `ATRIB_RECORDS_DIR`) (中文(简体) ). 容忍留下的光记录和当前信封形状.

总结为: `_local.content` 首先,在需要时,从遗留的包装或OpenInference侧车场获得相同的内容形状。 OpenInform 内容可以将跨类型/名称,工具/代理/模型,即时标识符和模板,输入/输出,使用,成本,分数,元数据,以及专题等添加到合成快取. 这些田地保持本地侧车载荷/ [D108级](https://npmcn.com/package/DECISIONS.md#d108-observability-span-trees-are-intake-local-sidecars-are-cognitive-payload);它们不被提升到已签名的协议字段.

当一个记录缺少可用的本地内容(legacy accord)时,提示包括一个标记告诉LLM输入贫穷,只有事件 类型+密码元数据可用,因此合成可以诚实地说明漏洞. 产出报告 `records_with_sidecar` 财务报告和审定财务报表 `records_without_sidecar` 算来算来算来算来算来算来算去的.

## 行为

-   **选择**数字 : `record_hashes` 记录 - 匹配 -`context_id`,被贬损.
-   **绑架**:按时间顺序递升排序,然后取 `max_records`。浮出水面了.
-   **真实输入标记**: 即时标记记录中的每行记录缺少语义内容;系统即时指示LLM不要发明语义.
-   **仅在 LLM 呼叫时访问网络**: 存储已读是本地的, 但所选的记录内容会被发送到所配置的 LLM 端点(默认情况下是 NVIDIA NIM) 来生成叙述. 这个读取原始的 发送镜像内容的机器。 点 `ATRIB_SUMMARIZE_BASE_URL` 在自动托管或本地模式中保存记录内容。 测试使用与其余工作空间相同的FORBIDDEN HOSTS后卫来防止固定泄漏.
-   **没有重试 LLM 失败**: 显示错误 `warnings` 并返回无效的叙述。 呼叫者决定是否用较小的重试 `max_records` 或不同的型号.
-   **仪器 [D084级](https://github.com/creatornader/atrib/blob/main/DECISIONS.md#d084-read-primitive-instrumentation-for-empirical-loop-closure-measurement) 水面6级**:每通电话都会写一个每通电话jsonl条目 `~/.atrib/state/read-primitives/calls.jsonl` 用于统一环闭分析器. 包括 `elapsed_ms` 覆盖全部 LLM 往返加码 `errored: true` lLM 失败路径。 静默失败者 [第5.8节](https://github.com/creatornader/atrib/blob/main/atrib-spec.md#58-degradation-contract); 仪器从不阻断摘要响应. `ATRIB_READ_PRIMITIVES_LOG` 覆盖测试的默认路径.

## 接线

添加到您的 MCP 主机配置 :

```json
{
  "atrib-summarize": {
    "command": "npx",
    "args": ["-y", "@atrib/summarize"],
    "env": {
      "ATRIB_SUMMARIZE_MODEL": "qwen/qwen3.5-397b-a17b"
    }
  }
}
```

从单列波检出, 使用 `"command": "node"` 与 `"args": ["/path/to/atrib-summarize/dist/main.js"]` 换句话说 API 密钥可以 生活在主机内或上面的缓存文件中。 不写入秘密值 输入共享的 MCP 配置 .

## 与证明/召回名称的关系[D164电话](https://npmcn.com/package/DECISIONS.md#d164-attestrecall-verb-rename-and-primitive-surface-collapse)(中文(简体) )

`summarize` 没有后续形状 `recall` 动词. `recall` 返回时 经核实的材料; 调用器合成. npm 软件包不设条件 替换指针; 工具通过别名窗口挂起.

## 状态

出版并维护. 单位测试涵盖记录选择(通过散列,按上下文,结合,缺失-skip)和退化路径(没有输入,没有API密钥). 对真实的LLM进行集成测试的门是后面的 `ATRIB_SUMMARIZE_API_KEY` 而不是在CI运行.

伴侣 `atrib-trace` 是结构原始的;它们共同关闭了认知循环的消费方.

## 部分笔记

atrib是可核查剂动作的开放式协议. 每个动作都变成一个签名的连锁记录,任何人都可以对照一个公开的默克勒日志进行验证,没有操作员可以信任. 这个包是一个切入点。 见 [全包家族](https://github.com/creatornader/atrib#packages) 编辑 [协议光谱](https://github.com/creatornader/atrib/blob/main/atrib-spec.md)。 。 。 .

## 常见问题

### @atrib/summarize 是什么？

遗留summarization MCP服务器在D164别名窗口中保留\. 汇总签名的记录,使代理读取上下文,而不是原始字节\.

### 如何安装 @atrib/summarize？

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

### @atrib/summarize 支持 TypeScript 吗？

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

### @atrib/summarize 支持 ESM 还是 CommonJS？

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

### @atrib/summarize 需要什么版本的 Node\.js？

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

### @atrib/summarize 可以商用吗？

@atrib/summarize 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @atrib/summarize 的下载量有多少？

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

### @atrib/summarize 还在维护吗？

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