# @companion-ai/alpha-hub 中文文档

规范地址：https://npmcn.com/package/%40companion-ai/alpha-hub/

版本：0\.1\.7
npm 元数据更新时间：2026-10-12T18:24:48.886Z
中文译文更新时间：2026-11-10T13:18:34.751Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40companion-ai/alpha-hub
原文对照：https://npmcn.com/package/%40companion-ai/alpha-hub/?lang=original
项目主页：https://github.com/Companion-Inc/alpha-hub#readme
源码仓库：https://github.com/Companion-Inc/alpha-hub

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

- 包体积（解压后）：61 kB，23 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.22\.0
- 运行依赖：4 个
- 首次发布：2026-03-20T17:56:10.632Z
- 最新版本发布：2026-10-12T18:24:48.483Z
- 近 30 天下载量：8197（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 8 个）

## 中文简介

非官方的 alphaXiv 动力CLI 和研究代理的库

## 安装

```sh
npm install @companion-ai/alpha-hub
```

也可以使用：`pnpm add @companion-ai/alpha-hub`、`yarn add @companion-ai/alpha-hub`、`bun add @companion-ai/alpha-hub`

## README

# 阿尔法枢纽

非官方的αXiv动力CLI和用于研究代理的库.

## 安装

需要节点.js **22.220.0或较新的**。 。 。 .

```bash
npm install -g @companion-ai/alpha-hub
```

如果您安装了临时 `@advaitpaliwal/alpha-hub` 软件包,一次迁移 :

```bash
npm uninstall -g @advaitpaliwal/alpha-hub
npm install -g @companion-ai/alpha-hub
```

命令不变 `alpha` 财务报告和审定财务报表 `alpha-mcp`图书馆消费者应使用 `@companion-ai/alpha-hub` 依赖性和进口范围;出口路径,例如 `/lib` 财务报告和审定财务报表 `/lib/auth` 不变.

## 快速启动

```bash
alpha login
alpha status
alpha search "attention mechanism"
alpha get 1706.03762
alpha ask 1706.03762 "What datasets were used for evaluation?"
alpha code https://github.com/openai/gpt-2 /
```

`alpha login` 打开浏览器并等待重定向到 `http://127.0.0.1:9876/callback`。在远程服务器上,在SSH上,或在容器中,打开任何浏览器中打印的URL。 签名后,粘贴浏览器的地址结束于( W)`http://127.0.0.1:9876/callback?code=...`)进入候机楼.

## 软件包导出

此套件曝光 :

-   `alpha` 国 际
-   `alpha-mcp` CLI (sdio MCP 服务器)
-   图书馆助手 `@companion-ai/alpha-hub/lib` (单位:千美元)`searchPapers`, (中文(简体) ), `getPaper`, (中文(简体) ), `askPaper`,说明,认证),加 `/lib/auth`, (中文(简体) ), `/lib/alphaxiv`, (中文(简体) ), `/lib/papers`,以及 `/lib/annotations`

见 [仓库读取器](https://github.com/Companion-Inc/alpha-hub#library) 用于完整导出列表.

## 0.1.6 国家

-   `alpha login` 忽略一个召回或粘贴的 URL,其 OAuth 状态不是此登录的(它回答 400 并持续等待) 而不是中止 。 一个 `?error=` 与匹配状态仍然结束登录.
-   托肯刷新在一个过程中共享,因此并行请求不再进行刷新-托肯旋转. 刷新不再覆盖 `auth.json` 如果您在运行时登录出去,或者更新或登录了另一个进程.
-   一个已过期或被撤销的访问令牌不再会失败 AlphaXiv 的呼叫 。 以前,在登录大约一小时后,保持一个连接的长期运行进程失败 `Streamable HTTP error: Error POSTing to endpoint: {"error":{"message":"Invalid Authorization"}}`,该错误未确认为认证错误。 现在,任何接到这个错误的呼叫都会刷新一个符号(与并行的呼叫共享),重新连接和重复一次. 如果失败,它会报告 `alphaXiv session expired. Run \`alpha 登录后再次签名
-   `alpha status` 现在用 alphaXiv 检查登录(`oauth2/userinfo`如果拒绝,则尝试刷新一个符号。 它在未登录时退出 1, 当会话已过期, 或无法到达 alphaXiv 时退出 。 图书馆的 `isLoggedIn()` 仍然只检查存储的代币。 新的 `verifyLogin()` 内 `/lib/auth` 进行服务器检查.
-   `auth.json` 在解剖学上被替换 : 在它旁边写出一个新的只有所有者的文件,并在它上重新命名.

## 0.1.5 (中文(简体) )

-   `alpha login` 接受粘贴的重定向 URL 当浏览器无法到达本地调用时, 例如在无头服务器、 SSH 会话、 容器和 WSL 上。 OAuth 状态检查仍然有效 。 在Linux上,没有显示, `alpha login` 不再尝试打开浏览器。 在WSL上,它尝试 `wslview` 然后是Windows默认浏览器。 登入等待时间是5分钟.
-   `~/.ahub/auth.json` 仅限所有者权限.
-   `alpha get` 财务报告和审定财务报表 `alpha ask` 接受来自搜索结果的 AlphaXiv 托管纸质ID, 如 `2607.some-paper-title`。搜索结果给出这些文件 `arxivUrl: null`。 。 。 .
-   如果 alphaXiv 删除 `discover_papers` MCP工具,搜索回落到αXiv的REST搜索.
-   `alpha search --mode both` 财务报告和审定财务报表 `--mode all` 不再在打印结果后挂起,不再发送重复请求. 并行搜索的图书馆呼叫者现在也共享一个连接.

## 常见问题

### @companion-ai/alpha-hub 是什么？

非官方的 alphaXiv 动力CLI 和研究代理的库

### 如何安装 @companion-ai/alpha-hub？

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

### @companion-ai/alpha-hub 支持 TypeScript 吗？

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

### @companion-ai/alpha-hub 支持 ESM 还是 CommonJS？

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

### @companion-ai/alpha-hub 需要什么版本的 Node\.js？

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

### @companion-ai/alpha-hub 可以商用吗？

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

### @companion-ai/alpha-hub 的下载量有多少？

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

### @companion-ai/alpha-hub 还在维护吗？

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