前言¶
DeepSeek Harness（DSH）让开发者通过对话编排工具与工作流，但 App Store Connect 的操作往往散落在 CLI 参数、JSON 载体和半文档化的状态里。Docker、Kubernetes 的经验已经证明，将系统级操作抽象为任务（jobs）和计划（plan），并强制审批，比在 shell 中直接调用命令更可控。本插件把这套思路引入 iOS 发布流程：它把 App Store Connect 的能力封装成五个任务状 jobs，提供 read/plan/apply 的工具面，内置六个技能让智能体知道如何使用，并管理 asc CLI 引擎的版本、认证与诊断。
是什么¶
- 名称：
sleep9ull/dsh-asc-cli（ASC for DeepSeek Harness） - 维护者：sleep9ull
- 定位：DeepSeek Harness 插件，将 App Store Connect 操作嵌入对话，用自然语言完成发布就绪检查、TestFlight 上传、反馈归档与合规扫描。
- 依赖：DeepSeek Harness >=0.2.1-rc.2，Node >=22.19.0，peerDependencies 包括 @deepseek-ai/cordis、@deepseek-ai/dsh-llm、@deepseek-ai/dsh-subprocess、@deepseek-ai/dsh-tools、@deepseek-ai/dsh-util-values、@deepseek-ai/schemastery。
- 引擎：基于 MIT 许可的 asc CLI（Go），插件为其提供产品层与编排层。
核心功能¶
五个任务状 jobs¶
| Job | 风险 | 职责 |
|---|---|---|
release-check |
read-only | 运行 asc validate，返回阻塞项与修复顺序 |
ship-testflight |
write | 上传 .ipa/.pkg，等待处理，提取 build ID 并加入 TestFlight 组，可选 beta review |
stage-release |
write | 验证、挂载构建、应用元数据，停止在提交前 |
triage-feedback |
read-only | 聚合 TestFlight 反馈、崩溃与评论 |
compliance-sweep |
read-only | 对年龄分级、加密声明、无障碍、当前定价做四项只读探测 |
写操作需要 mode: write、confirm: true 以及宿主审批。
工具面¶
asc_job：任务入口，返回计划状结果与分步摘要，支持 dry-run。asc：读取 apps、builds、TestFlight、评论、离线元数据校验，以及discover与run用于长尾命令。asc_plan：计划工具，执行validate、status、metadata-plan，不修改 App Store Connect。asc_apply：写工具，执行upload、groups、metadata-init、metadata-apply、stage、publish。asc_setup：环境工具，管理版本、认证状态、诊断、系统状态、提供与安装技能。
两个宿主命令¶
/asc：能力卡片，显示引擎状态、认证、默认 app、五个 jobs 与下一步。/asc-doctor：完整诊断：二进制与源码、版本与测试范围、认证、默认 app、供应、上游更新建议。
六个内置技能¶
安装后无需 git 或全局目录即可使用：
dsh-asc-quickstart：首次运行指引dsh-asc-auth：认证与 CI 场景dsh-asc-release-readiness：发布就绪检查dsh-asc-testflight-ship：TestFlight 上传dsh-asc-feedback-triage：反馈归档dsh-asc-compliance-sweep：合规扫描
引擎管理¶
- 定位顺序：
ascPath→ASC_CLI_PATH→ 插件缓存 →PATH。 - 诊断：版本、测试范围、认证、默认 app、供应状态，给出下一步。
- 提供：可选下载固定版本 asc 5.16.0，校验 SHA-256，按平台缓存到
$DSH_HOME/cache/asc-cli/。 - 更新：
/asc-doctor与最新 GitHub Release 比较（24 小时缓存），建议brew upgrade asc，不升级自身。
安装与启用¶
安装插件：
dsh plugin --profile desktop add @sleep9ull/dsh-asc-cli
重启或重新加载 profile 后，插件会在 profile 的 cordis.patch.yml 中插入一行 mode: read-only。
启用后运行：
/asc
或让智能体执行 asc_setup 动作 diagnose。如果尚未就绪，报告会给出唯一的下一步。不要在对话中粘贴私钥，认证保持在终端中。
若希望插件管理引擎，可在配置中启用 allowProvision，然后运行 asc_setup 动作 provision。
典型用法¶
列出并设置默认 app¶
List my apps and pick com.example.focus. Set it as the default app.
检查版本就绪性¶
Is 1.2.3 ready to submit? Show the blockers in priority order.
上传构建到 TestFlight¶
Upload ./build/Focus.ipa as 1.2.3 build 42 to the Internal Testers group.
预演不提交¶
Prepare 1.2.3 with this metadata, but don't submit.
Dry-run 示例：
Upload ./build/Focus.ipa as 1.2.3 build 42 to the Internal Testers group. dryRun: true
检查合规性¶
Are we compliant? Age rating, encryption, accessibility, pricing.
适用场景与注意¶
- 适合需要将 App Store Connect 操作统一到对话流中的 iOS 团队，特别是希望用计划与审批替代直接命令调用的场景。
- 插件以当前 DSH 进程权限运行，使用前应检查源码与许可证（MIT）。
- 安全模型默认只读，写操作需
confirm: true与宿主审批，审计日志可选 JSONL 格式。 - 注意
asc引擎版本与测试范围的一致性；/asc-doctor可帮助诊断版本与供应状态。
小结¶
通过把 App Store Connect 的操作抽象为五个 jobs、一套 read/plan/apply 工具和六个内置技能，本插件让开发者能在对话中完成从就绪检查、TestFlight 上传到反馈归档与合规扫描的全流程，同时保持审批与审计能力。安装一次后，即可通过自然语言与 agent 协作，而非在 shell 中拼凑命令。
