> ## Documentation Index
> Fetch the complete documentation index at: https://extension.js.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Extension.js 命令指南

> Extension.js 全部 CLI 命令的参考，包括 dev、build、start、preview、create、install 与 uninstall，附用法示例。

根据当前扩展开发所处的阶段——从初次脚手架到生产验证——选择合适的命令。

## 命令选择器

| 目标               | 命令             | 示例                                                                 |
| ---------------- | -------------- | ------------------------------------------------------------------ |
| 搭建一个新项目          | `create`       | `npx extension@latest create my-extension --template=newtab-react` |
| 进入 watch 模式开发    | `dev`          | `extension dev --browser=firefox`                                  |
| 构建生产产物           | `build`        | `extension build --browser=chrome,firefox --zip`                   |
| 构建并启动生产输出        | `start`        | `extension start --browser=edge`                                   |
| 只启动已有的构建输出       | `preview`      | `extension preview --browser=chrome`                               |
| 为项目获取一个可分享的 URL  | `publish`      | `extension publish --ttl=4`                                        |
| 安装一个受管理的浏览器运行时   | `install`      | `extension install chrome`                                         |
| 移除一个受管理的浏览器运行时   | `uninstall`    | `extension uninstall chrome`                                       |
| 诊断一个运行中的 dev 会话  | `doctor`       | `extension doctor --browser=chromium`                              |
| 读取或流式查看会话日志      | `logs`         | `extension logs --follow --context background,content`             |
| 列出标签页或检查 DOM     | `inspect`      | `extension inspect --tab 412 --with-console`                       |
| 在活动上下文中执行代码      | `eval`         | `extension eval "location.href" --context page`                    |
| 读写扩展 storage     | `storage`      | `extension storage get --key settings`                             |
| 按需重载某个上下文        | `reload`       | `extension reload --context background`                            |
| 打开某个界面或回放一个动作    | `open`         | `extension open popup`                                             |
| 供脚本与 agent 使用的握手 | `capabilities` | `extension capabilities`                                           |

直接运行不带命令的 `extension` 会打印完整帮助并以退出码 `0` 结束。

## 典型的开发流程

1. `create` 搭建骨架。
2. `dev` 迭代编码与重载循环。
3. `build` 产出生产产物。
4. `preview` 或 `start` 做类生产验证。
5. 需要显式管理 Extension.js 浏览器运行时时，用 `install` 或 `uninstall`。
6. `logs`、`inspect`、`eval`、`storage`、`reload` 和 `open` 用于观察和驱动运行中的会话。
7. dev 会话或与之通信的自动化 verb 不再响应时，用 `doctor`。
8. 当由脚本或 agent（而不是人）驱动 CLI 时，先用 `capabilities`。

## 命令参考

* [create](/zh-Hans/docs/commands/create)
* [dev](/zh-Hans/docs/commands/dev)
* [build](/zh-Hans/docs/commands/build)
* [start](/zh-Hans/docs/commands/start)
* [preview](/zh-Hans/docs/commands/preview)
* [publish](/zh-Hans/docs/commands/publish)
* [install](/zh-Hans/docs/commands/install)
* [uninstall](/zh-Hans/docs/commands/uninstall)
* [doctor](/zh-Hans/docs/commands/doctor)
* [logs](/zh-Hans/docs/commands/logs)
* [inspect](/zh-Hans/docs/commands/inspect)
* [eval](/zh-Hans/docs/commands/eval)
* [storage](/zh-Hans/docs/commands/storage)
* [reload](/zh-Hans/docs/commands/reload)
* [open](/zh-Hans/docs/debugging/trigger-actions-and-commands)
* [capabilities](/zh-Hans/docs/commands/capabilities)

`telemetry` 命令（`enable` / `disable` / `status`）用于管理匿名遥测的授权——参见 [遥测与隐私](/zh-Hans/docs/features/telemetry-and-privacy)。

## 下一步

* 在 [全局 flag](/zh-Hans/docs/workflows/global-flags) 中应用跨命令的控制。
* 在 [扩展配置](/zh-Hans/docs/features/extension-configuration) 中集中默认值。