@adobe/helix-onedrive-cli

中文文档
1.11.443发布于 2026/10/27Apache-2.0ES Module构建来源已验证近 30 天下载 2777

螺旋一驱 CLI

中文使用文档
文档目录10 节
  1. 状态
  2. 安装
  3. 使用量
  4. 设置
  5. 登录设备令牌
  6. 登录用户名/ 密码
  7. 发展
  8. 构建
  9. 测试
  10. 林特

螺旋一驱 CLI

Helix 单驱动命令行接口工具

状态

codecov CircleCI GitHub license GitHub issues LGTM Code Quality Grade: JavaScript semantic-release

安装

$ npm install @adobe/helix-onedrive-cli

使用量

Usage: 1d <command>

Commands:
  1d me                   Show information about the logged in user.
  1d login                Start the login interactive flow or ROPC flow with username / password.
  1d logout               Logout be removing the authorization file.
  1d resolve <link>       Resolves a share link to the respective drive item.
  1d ls [path]            Lists the contents of the [path]
  1d get <path> [local]   downloads the file at path
  1d put <local> [path]]  upload the local file.

Options:
  --version      Show version number
  --verbose, -v  Run with verbose logging
  --help         Show help

设置

1d 客户端使用默认客户端ID运行,该客户端支持交互登录. 走开 1d login,复制在浏览器中粘贴授权代码并唱入微软.

如果您想要以不同的参数运行客户端, 您可以提供 (单位:千美元) .env 包含您的应用程序的 azure 客户端身份和客户端机密的文件 .

# azure app oauth secrets
AZURE_APP_CLIENT_ID="11111111-1111-1111-1111-11111111111"
AZURE_APP_CLIENT_SECRET="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

之后 .env 设置,启动 dev 服务器 改为:

$ npm start

并打开浏览器 http://localhost:4502/.

点击链接登录。 在成功登录到微软后, 服务器会写一个 .auth.json 在磁盘上. 之后可以停止服务器,并使用 cli, 如:

$ 1d me
Logged in as: John Doe ([email protected])

要重设认证,只需删除 .auth.json 文件,并以私人模式打开浏览器.

登录设备令牌

要登录设备符号, 请运行 :

$ 1d login
To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code HNGP5CAF8 to authenticate.
updated .auth.json file.
$ 1d me
Logged in as: John Doe ([email protected])

登录用户名/ 密码

一些账户和app允许登录用户名和密码(ROPC流量). 通常联邦账户需要外交部, 禁止使用ROPC.

$ 1d login [email protected]
password: ****
updated .auth.json file.
Logged in as: John Doe ([email protected])

发展

构建

$ npm install

测试

$ npm test

林特

$ npm run lint

版本与发布记录

@adobe/helix-onedrive-cli 共发布 557 个版本,首次发布于 2020/02/05;过去 12 个月发布了 72 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.11.443latest2026/10/2711 天前
1.11.4422026/10/2514 天前
1.11.4412026/10/2216 天前
1.11.4402026/10/2117 天前
1.11.4392026/10/1325 天前
1.11.4382026/10/1325 天前

关于 @adobe/helix-onedrive-cli 的常见问题

@adobe/helix-onedrive-cli 是什么?

螺旋一驱 CLI

如何安装 @adobe/helix-onedrive-cli?

在项目目录运行 npm install @adobe/helix-onedrive-cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 1d,可以用 npx 1d 直接运行。

@adobe/helix-onedrive-cli 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/adobe__helix-onedrive-cli 是否存在。

@adobe/helix-onedrive-cli 支持 ESM 还是 CommonJS?

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

@adobe/helix-onedrive-cli 可以商用吗?

@adobe/helix-onedrive-cli 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@adobe/helix-onedrive-cli 的下载量有多少?

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

@adobe/helix-onedrive-cli 还在维护吗?

最新版本 1.11.443 发布于 2026/10/27(11 天前);至今共发布 557 个版本,其中过去 12 个月发布了 72 个;首次发布于 2020/02/05。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。