# @extension\.dev/urls 中文文档

规范地址：https://npmcn.com/package/%40extension.dev/urls/

版本：0\.8\.4
npm 元数据更新时间：2026-11-05T02:04:57.602Z
中文译文更新时间：2026-11-14T06:19:55.879Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：94 kB，27 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.18
- 运行依赖：0 个
- 首次发布：2026-07-24T18:43:03.484Z
- 最新版本发布：2026-11-05T02:04:57.214Z
- 近 30 天下载量：2339（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

跨应用源和跨扩展路由的真相来源. dev车队(www,controup,docs,模板,主题,代码,检查,预览,用户地)和公众MCP. 纯路径构建器加带有本地- dev der 的 env 驱动源解析器

## 安装

```sh
npm install @extension.dev/urls
```

也可以使用：`pnpm add @extension.dev/urls`、`yarn add @extension.dev/urls`、`bun add @extension.dev/urls`

## README

# @ extension.dev/urls [![Version](https://img.shields.io/npm/v/%40extension.dev%2Furls.svg?color=26FFB8)](https://www.npmjs.com/package/@extension.dev/urls) [![Downloads](https://img.shields.io/npm/dm/%40extension.dev%2Furls.svg?color=26FFB8)](https://www.npmjs.com/package/@extension.dev/urls) [![CI](https://github.com/extensiondev/urls/actions/workflows/ci.yml/badge.svg?branch=main&color=26FFB8)](https://github.com/extensiondev/urls/actions) [![Discord](https://img.shields.io/discord/1253608412890271755?label=Discord&logo=discord&style=flat&color=26FFB8)](https://discord.gg/v9h2RgeTSN)

> 连接扩展的起源和路径的真相来源。 德夫舰队一起.

![Logo](https://media.extension.land/brand/extension-dev/logo-dock.png)

```bash
npm install @extension.dev/urls
```

权力交叉应用链接,用于www,Controup,docs,模板,主题,代码,检查,预览,用户地,以及公共MCP.

[扩展名.dev](https://extension.dev/) • 妇女 [电话分机.js](https://extension.js.org/) • 妇女 [解析器](https://discord.gg/v9h2RgeTSN)

## 链接为什么是一个软件包

交叉应用链接有两个半: **东道主** (哪个应用)和 **路径** (哪个) 里面的路线。 硬码或某应用程序移动或路由更名的那一天, 每个呼叫者都会漂流 这个软件包将两半都放在一个地方 所以链接 a 工具手回不能指向应用程序路由器不再服务的路由.

-   **`@extension.dev/urls/paths`** ——纯净无环境线路建设者. 保险 从任何运行时间(Next.js、Vite SPAs、Node、捆绑的MCP)调用,因为 他们不读环境,只读编码路径形状.
-   **`@extension.dev/urls/origins`** - 主持人 每个运行时间名称 env vars不同,所以这个模块从不读取环境本身: 呼叫者通过任何它拥有的 并返回一个完整的源集, 环境时由 Caddy 代理地图生成本地端主机 看起来像本地的, 生产主.
-   **`@extension.dev/urls/userland`** - 公共建筑的全URL建造者 查看器. userland是制作主机为每个工作空间的应用程序 (单位:千美元)`<workspace>.extension.dev`),因此无法选择其两半 它拥有自己的模块而不是一个 `paths` 输入.
-   **`@extension.dev/urls/reserved-slugs`** - 工作空间或项目的名称 鼻涕虫可能永远不会服用: `isReservedWorkspaceSlug`, (中文(简体) ), `isReservedProjectSlug` 财务报告和审定财务报表 后面的镜头。 名单住在这里,因为这是唯一的包裹 拒绝名称的 www 服务器和灰化它的主控台格式 已经靠你了,所以他们永远不能分开了.

## 使用量

```ts
import { resolveOrigins } from "@extension.dev/urls/origins";
import { consoleProjectPath, ConsoleProjectPage } from "@extension.dev/urls/paths";

const origins = resolveOrigins({
  // Pass only the vars this runtime actually has; the rest derive.
  www: process.env.EXTENSION_DEV_API_URL,
});

// A full link is `origins.<app> + <pathBuilder>(...)`.
const buildsUrl =
  origins.console +
  consoleProjectPath({ workspace: "acme", project: "toolbar" }, ConsoleProjectPage.builds);
```

存储提交材料位于控制台项目的一个根下。 年长者 `stores` 键作为别名保留并返回相同的路径 :

```ts
const ref = { workspace: "acme", project: "toolbar" };

consoleProjectPath(ref, ConsoleProjectPage.submissions);
// -> "/acme/toolbar/submissions"

consoleProjectPath(ref, ConsoleProjectPage.submissionNew("chrome"));
// -> "/acme/toolbar/submissions/chrome/new"

consoleProjectPath(ref, ConsoleProjectPage.submission("chrome", "sub_1"));
// -> "/acme/toolbar/submissions/chrome/sub_1"
```

设定一个本地覆盖, 每个未设置的源头都会跟着它到 dev 代理 :

```ts
resolveOrigins({ www: "http://localhost:3100" }).console;
// -> "http://console.extension.localhost"
```

公共建筑浏览器使用整个 URL,因为工作空间生活在 本地生产和路径中的主机 :

```ts
import { userlandBuildUrl } from "@extension.dev/urls/userland";

userlandBuildUrl({ workspace: "acme", project: "toolbar" }, "abc1234");
// -> "https://acme.extension.dev/toolbar/builds/abc1234"

userlandBuildUrl({ workspace: "acme", project: "toolbar" }, "abc1234", {
  base: resolveOrigins({ www: "http://localhost:3100" }).userland,
});
// -> "http://userland.extension.localhost/acme/toolbar/builds/abc1234"
```

## 扩展名.dev 堆栈

| 软件包 | 用它来 |
| --- | --- |
| [`@extension.dev/mcp`](https://www.npmjs.com/package/@extension.dev/mcp) | 给一个人工智能代理手:脚手架、运行、检查和发布扩展 |
| [`@extension.dev/skill`](https://www.npmjs.com/package/@extension.dev/skill) | 教特工们判断 一半: 交叉浏览器规则 游戏本 |
| [`@extension.dev/artifact-integrity`](https://www.npmjs.com/package/@extension.dev/artifact-integrity) | 在SHA-256和CI门上检查文物 |

所有东西都搭上 [电话分机.js](https://github.com/extension-js/extension.js),开源交叉浏览器扩展框架.

## 社区

-   加入扩展名.dev [解析器](https://discord.gg/v9h2RgeTSN) 帮助和反馈
-   浏览生产准备模板 [模板.扩展.dev](https://templates.extension.dev/)
-   遵循平台的公开软件包 [GitHub 图像](https://github.com/extensiondev)
-   扩展报告.js [GitHub 图像](https://github.com/extension-js/extension.js/issues)

## 许可证

Apache-2.0(c) 2026 Cezar Augusto and the extension.dev合作者. 见 [自由主义](https://npmcn.com/package/%40extension.dev/urls/LICENSE)。 。 。 .

## 常见问题

### @extension\.dev/urls 是什么？

跨应用源和跨扩展路由的真相来源\. dev车队\(www,controup,docs,模板,主题,代码,检查,预览,用户地\)和公众MCP\. 纯路径构建器加带有本地- dev der 的 env 驱动源解析器

### 如何安装 @extension\.dev/urls？

在项目目录运行 npm install @extension\.dev/urls，或使用 pnpm add / yarn add / bun add。

### @extension\.dev/urls 支持 TypeScript 吗？

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

### @extension\.dev/urls 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @extension\.dev/urls 需要什么版本的 Node\.js？

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

### @extension\.dev/urls 可以商用吗？

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

### @extension\.dev/urls 的下载量有多少？

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

### @extension\.dev/urls 还在维护吗？

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