# @adlc/ticket-sync 中文文档

规范地址：https://npmcn.com/package/%40adlc/ticket-sync/

版本：1\.12\.0
npm 元数据更新时间：2026-10-10T03:04:36.746Z
中文译文更新时间：2026-11-06T00:21:22.445Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40adlc/ticket-sync
原文对照：https://npmcn.com/package/%40adlc/ticket-sync/?lang=original
项目主页：https://github.com/voodootikigod/adlc/tree/main/packages/ticket-sync#readme
源码仓库：https://github.com/voodootikigod/adlc

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

- 包体积（解压后）：123 kB，26 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：2 个
- 首次发布：2026-07-10T23:29:06.121Z
- 最新版本发布：2026-10-10T03:04:36.365Z
- 近 30 天下载量：8223（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 15 个）

## 中文简介

ADLC门票与出道机双向同步(GitHub Issues First).

## 安装

```sh
npm install @adlc/ticket-sync
```

也可以使用：`pnpm add @adlc/ticket-sync`、`yarn add @adlc/ticket-sync`、`bun add @adlc/ticket-sync`

## README

# @adlc/ ticket- sync

由Canonical ADLC售票店与外道追踪器双向同步—— **GitHub 问题** 先说 将问题导入入票, 只为本地创建问题 将 ADLC 执行元数据写回发行机构 干线运行 默认; 所有 I/O 网络通过 `gh` CLI(英语:CLI).

```bash
npm i -g @adlc/ticket-sync
gh auth login                       # the provider shells out to gh
adlc-ticket-sync --help
```

## 图标

| 命令 | 它会做什么 |
| --- | --- |
| `adlc-ticket-sync pull` | 进口问题 − 活跃的售票店(3道调节;工会;因冲突未能关闭). |
| `adlc-ticket-sync push` | 写回门票:更新同步出问题+ **一能创建** 用于本地专用车票+只显示状态标签/评论. |
| `adlc-ticket-sync sync` | `pull` 接下来 `push` (非清洁拉出后再推出). |
| `adlc-ticket-sync doctor` | 只读,离线健康检查(配置 / 票 / schema 漂移 / sidecar / stale lock). |

默认干跑-通过 `--write` 申请. `--json` 在所有命令上显示. `--limit <n>` 上限 : `pull`编号 :`push`编号 :`sync` 从跟踪器中选择列表 (违约500). 达到上限的列名因可能被截断而被拒绝 而不是同步,所以提高它(或缩小) `select` 当它发生的时候. 与 `select.query` 设置, 列表通过 GitHub 的搜索 API, 它 返回时最多为 1000 个结果,因此拒绝将 1000 行切换为任意 `--limit`; 缩小查询范围. 退出代码 : `0` ok \\fn微软雅黑okay \\fn微软雅黑okay \\fn方正黑体简体\\fs18\\b1\\bord1\\shad1\\3ch2f2f2f}美国海军陆战队 `1` \* 运行中 `2` 关闭.

```bash
adlc-ticket-sync pull               # preview the import
adlc-ticket-sync pull --write       # apply it
adlc-ticket-sync push --write       # create/update issues + status
adlc-ticket-sync doctor             # check repo health, read-only
```

## 如何运作

-   **元数据** GitHub 问题 缺少生活在一个有栅栏的 JSON **块** 在问题机构, 介于 `<!-- adlc:begin … -->` 编号 : `<!-- adlc:end -->` 卫所. 围绕它 保留了逐字记录.
-   **同步簿记** (节点ids, 三向基散列, 创建键) 生活在一个 带子 **侧车** (单位:千美元)`.adlc/ticket-sync.state.json`)——所以例行同步从不 触起铁道信根. 其元数据可以重建,但作者可以持久地保留 并且闭口闭口 `pendingCreates` 恢复手柄.
-   **独立储存**: 已磨损 `.adlc/tickets/` 用于新重置的立体; 遗产 `.adlc/tickets.json` 继续通过移民桥梁开展工作.
-   **创建**: 稳定的 sentinel 密钥 + 预创建的收养扫描 + `pendingCreates` 崩溃恢复意味着重新运行永远不会重复一个问题。 把手 直到身份证重写和散列证据重新验证完成为止, 所以重新运行可以恢复一半。 在创建时, 重新分配了票号 `T<n>` → `gh:<owner>/<repo>#<n>` 带有全店边 重写.
-   **离线第一**: 所有逻辑都通过注入进行离线测试 `gh` 跑道; 一条 活边有选择入住的烟雾(`scripts/ticket-sync-smoke.mjs`) (中文(简体) ).

## 打开瞄准镜

`pull` 需求 `issues:read`· ; `push` 需求 `issues:write`更喜欢一个精致的PAT 大范围 `repo` 范围. `GH_HOST` 我为GitHub企业感到荣幸.

## 完整向导

见 **[文件/目录-同步md](https://npmcn.com/package/docs/ticket-sync.md)** 旗帜矩阵, 配置 参考文献,区块/侧车型,一能细节,铁道-信托-根基 互动,和活烟.

## 许可证

校对:Soup

## 常见问题

### @adlc/ticket-sync 是什么？

ADLC门票与出道机双向同步\(GitHub Issues First\)\.

### 如何安装 @adlc/ticket-sync？

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

### @adlc/ticket-sync 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/adlc\_\_ticket-sync 是否存在。

### @adlc/ticket-sync 支持 ESM 还是 CommonJS？

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

### @adlc/ticket-sync 需要什么版本的 Node\.js？

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

### @adlc/ticket-sync 可以商用吗？

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

### @adlc/ticket-sync 的下载量有多少？

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

### @adlc/ticket-sync 还在维护吗？

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