@adlc/ticket-sync

中文文档
1.12.0发布于 2026/10/10MITES Module构建来源已验证近 30 天下载 8223

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

中文使用文档
文档目录5 节
  1. 图标
  2. 如何运作
  3. 打开瞄准镜
  4. 完整向导
  5. 许可证

@adlc/ ticket- sync

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

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 syncpull 接下来 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 关闭.

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 旗帜矩阵, 配置 参考文献,区块/侧车型,一能细节,铁道-信托-根基 互动,和活烟.

许可证

校对:Soup

版本与发布记录

@adlc/ticket-sync 共发布 15 个版本,首次发布于 2026/07/11;过去 12 个月发布了 15 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.12.0latest2026/10/1027 天前
1.11.12026/09/091 个月前
1.11.02026/08/252 个月前
1.10.02026/08/112 个月前
1.9.02026/08/092 个月前
1.8.02026/08/082 个月前

关于 @adlc/ticket-sync 的常见问题

@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 和提交记录判断。