Skip to content

feat: 公开词级转写 CLI 命令与 JSON 输出 - #29

Merged
0xFANGO merged 3 commits into
mainfrom
ralph/listenhub-cli--815
Sep 17, 2026
Merged

0xFANGO merged 3 commits into
mainfrom
ralph/listenhub-cli--815

Conversation

@0xFANGO

@0xFANGO 0xFANGO commented Sep 17, 2026 •

Copy link
Copy Markdown
Contributor

变更摘要

新增 listenhub openapi transcription 的估价、上传、创建、查询、等待与词级 transcript JSON 命令,使 hypit Provider 和使用 API key 的用户能复用 ListenHub 转写。创建要求稳定幂等键,返回预留与实扣积分;超时提示恢复等待同一任务。中英文 README 给出实际 JSON 结构。

补充修复本次 #815 真机生成发现的上传 URL 回归:本地文件上传成功后,CLI 原样使用 OpenAPI 返回的 fileUrl,不再把私有资产域名错误改写为 storage.googleapis.com。回归测试以不同域名约束该行为。

实现期假设

  • SDK 0.0.22 尚无公开转写方法,局部 adapter 复用既有 transport,保持 SDK 的鉴权、域选择、响应解包与错误处理;实际 SDK HTTP fixture 约束兼容性,缺少 transport 时明确失败,后续公开 SDK 方法可替换 adapter。
  • 上传与创建分开;调用方显式提供幂等键,避免一次命令重跑被误认为新任务。
  • 上传接口返回的 fileUrl 是下游可消费的权威地址;CLI 只负责 PUT 到 presignedUrl,不推断或重写资产域名。

风险判定

快车道。脚本参考 risk=high(auth、money),nonDowngradable=false。覆盖理由:这些信号来自 issue 的跨仓转写/计费背景;本次增量只删除 URL 域名改写并增加回归 fixture,不修改鉴权、账务、凭证或服务端协议。

Staging:白名单第 3 条,CLI 无 staging 分支映射。

验证

  • lint / typecheck:pnpm ready PASS,90 文件格式正确,80 文件无 lint/type errors。
  • test:pnpm ready PASS,13 文件、127 用例;新增/调整的本地上传回归测试先复现错误域名,再随修复转绿。
  • build:pnpm build PASS,生成 dist/cli.mjs。
  • CI:PASS,精确 head 9500236e98ba440ac756deabf495e72bf2b7243d,CI run。
  • release prep:package version 已提升至 0.0.22。
  • 场景 QA:SKIPPED(repo-not-runtime-qa,CLI 属 other)。
  • 真机证据:#815 猫咪双模型测试在改写路径上失败;改用 API 原始 fileUrl 后四个任务全部成功。该轮生产生成报价/实扣均为 416 积分,失败任务余额前后不变。
  • 协议合规:未复制 hypit 源码、未改 hypit 署名;随 skill 分发的 Provider 免费开源,本 PR 不分发 hypit。

Part of marswaveai/listenhub-ralph#815

@0xFANGO
0xFANGO merged commit b5e7d7a into main Sep 17, 2026
1 check passed
@0xFANGO
0xFANGO deleted the ralph/listenhub-cli--815 branch September 17, 2026 10:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant