edit | blame | history | raw

COMMANDS - 可复用命令索引

本文件只记录后续可能需要复用、且不应埋在长对话里的命令。具体上下文仍以同名会话记录为准。

TagLauncher quicksearchfilter 8.4.0 TestFlight 上传状态

来源：26.0830-Taglauncher.quicksearchfilter-TestFlight上传.md

搜索关键词：TESTFLIGHT_INTERNAL_READY_QSF、BETA_INTERNAL_TESTING、482c12a7-543d-4dab-afac-aa4e1b4bb6d0、20260828.2219、6777149496、Hainan Wanxing Technology Co., Ltd.

用途：找回 8.4.0 上传到 App Store Connect / TestFlight 后的 delivery id、Apple 处理状态和复核命令。

8.4.0 TestFlight 状态复核

cd /Users/ar/Projects/Taglauncher/03-O
xcrun altool --build-status --delivery-id 482c12a7-543d-4dab-afac-aa4e1b4bb6d0 -u shanghai3168@gmail.com -p @keychain:PrivateVoice_ASC_UPLOAD --provider-public-id 4f806387-adf4-498b-9abd-126b13c1c5b2 --output-format json

TagLauncher quicksearchfilter 8.4.0 App Store 上传包

来源：26.0828-Taglauncher.quicksearchfilter-8.4.0正式冻结.md

搜索关键词：ASC_UPLOAD_READY_QSF、8.4.0、20260828.2219、v8.4.0-build20260828.2219、CR3J54M8BQ、TagLauncher Mac App Store 20260707、productbuild、TagLauncher-8.4.0-build20260828.2219.pkg

用途：找回 quicksearchfilter 8.4.0 正式 App Store 上传包、公司证书签名、profile 一致性、远端 main/tag 和上传前复核命令。

8.4.0 App Store 上传包复核

cd /Users/ar/Projects/Taglauncher/03-O/K3.运营与发布资料/Release/AppStore-8.4.0-20260828.2219
shasum -a 256 -c SHA256SUMS.txt
pkgutil --check-signature Upload/TagLauncher-8.4.0-build20260828.2219.pkg
hdiutil verify Archive/TagLauncher-8.4.0-build20260828.2219.dmg

8.4.0 远端冻结复核

cd /Users/ar/Projects/Taglauncher/03-O
git ls-remote boborobots refs/heads/main refs/tags/v8.4.0-build20260828.2219 'refs/tags/v8.4.0-build20260828.2219^{}'

TagLauncher quicksearchfilter 8.4.0 本地安装包

来源：26.0828-Taglauncher.quicksearchfilter-8.4.0本地包.md

搜索关键词：LOCAL_TEST_READY_QSF、QSF-PKG-001、TagLauncher-8.4.0-build20260828.1732-localtest.dmg、c5bdc7f1eb3ff4287beeeebb17d4f02f376a8d38、76647a1133fbb96abdb8dd0531dc83819ac58815057071671204b746b781070f

用途：找回 quicksearchfilter 8.4.0 本地安装体验包的源码冻结、DMG 归档、SHA 和验证命令。

TagLauncher Quick Search 标签筛选 V1

来源：26.0828-Taglauncher.quicksearchfilter-开发实现.md

搜索关键词：QSF-DEV-001、DEV_READY_QSF、quick_search_tag_filter_qa.sh、QuickSearchTagFilterBar、selectedTagName、quickSearchSelectedTagName、Quick Search 标签筛选

用途：找回 Quick Search 标签筛选 V1 的实现入口、PMO 回报证据和开发自测命令。

Quick Search 标签筛选开发自测

cd /Users/ar/Projects/Taglauncher/03-O
bash C1.source/Scripts/quick_search_tag_filter_qa.sh
bash C1.source/Scripts/quick_search_launch_contract_qa.sh
bash C1.source/Scripts/windowserver_event_safety_qa.sh
bash C1.source/Scripts/quick_search_system_app_qa.sh
bash C1.source/Scripts/macos14_availability_typecheck_qa.sh
git diff --check -- C1.source/Apptag/QuickSearch.swift C1.source/Apptag/ContentView.swift C1.source/Apptag/Localization C1.source/Scripts/quick_search_tag_filter_qa.sh CODEGRAPH.md

TagLauncher AppGrid 备注气泡 placeholder 字色

来源：26.0822-Taglauncher.AppGrid备注气泡-placeholder字色.md

搜索关键词：AppBubbleNoteTextField、placeholderAttributedString、appNote.placeholder、NSColor.white.withAlphaComponent(0.48)、APP 用途备注

用途：找回备注气泡 placeholder 可读性优化、设计色值和对应 QA/typecheck 命令。

TagLauncher 8.3.6 TestFlight 90886 签名警告修复

来源：26.0707-Taglauncher.8.3.6发布-TestFlight签名警告修复.md

搜索关键词：90886、TestFlight warning、application identifier、com.apple.application-identifier、CR3J54M8BQ.com.taglauncher.app、TagLauncher-AppStore.entitlements、20260707.1526

用途：找回 Transporter 已交付但 TestFlight 不合格时的 signed entitlements / embedded provisioning profile 一致性检查、最终 20260707.1526 包路径和上传前门禁。

TagLauncher 8.3.6 ASC root-only 权限修复

来源：26.0707-Taglauncher.8.3.6发布-ASC权限修复.md

搜索关键词：root user、only readable by root、20260707.1506、pkg payload permission、Localization 700、macos14_build_metadata_qa.sh、v8.3.6-build20260707.1506

用途：找回 ASC 拒绝 root-only payload 权限后的定位、构建脚本修复和 expanded pkg 权限检查；该记录里的 20260707.1506 后续已被 20260707.1526 替代。

TagLauncher 8.3.6 ASC 上传包最终收口

来源：26.0707-Taglauncher.8.3.6发布-ASC包最终收口.md

搜索关键词：8.3.6、20260707.1242、ASC 上传包、CR3J54M8BQ、Hainan Wanxing、3rd Party Mac Developer Installer、embedded.provisionprofile、v8.3.6-build20260707.1242

用途：找回 8.3.6 第一次公司签名 ASC .pkg 生成流程、包内 app/profile 预检、SHA256 复核、远端 main/tag 复核命令；该记录里的 20260707.1242 后续已被 20260707.1526 替代。

TagLauncher 8.3.6 去外框与公司证书阻塞

来源：26.0707-Taglauncher.8.3.6发布-去外框与公司证书阻塞.md

搜索关键词：8.3.6、20260707.1242、settingsFixedProHeader、CR3J54M8BQ、Hainan Wanxing、3rd Party Mac Developer、Mac App Distribution、Mac Installer Distribution、p12、embedded.provisionprofile

用途：找回 8.3.6 设置页 Pro 固定行去外框、源码冻结、本地 QA DMG、公司证书 / profile 阻塞、.p12 备份步骤和恢复生成 ASC .pkg 的命令。

Taglauncher 本电脑初始化复核

来源：26.0705-Taglauncher.项目初始化-本电脑初始化.md

搜索关键词：Taglauncher 初始化、HIPO、boborobots、C1.source、upstream、push.default=upstream、release-gate-required、AppleDouble cleaned

用途：复核本电脑初始化、HIPO 状态、自建远端连接、当前分支 upstream、Git 噪声治理结果、8.3.5 release evidence errata 和发布前 gate 边界。完整命令见来源记录的“可复用命令 / Runbook”小节。

TagLauncher WindowServer 会诊

来源：2026-07-01-WindowServer会诊.md

搜索关键词：WindowServer、CursorUIViewService、20260701.2029、20260701.2234、Quick Search IME、markedText、mouseDown forwardMethod、tag_editor_mouse_event_qa、Usage Tips hitTest、TagNavigation nextEvent

用途：找回 2026-07-01 WindowServer / CursorUIViewService 卡顿会诊结论、Quick Search IME 风险、鼠标事件递归风险和静态 QA Runbook。完整命令见来源记录的“可复用命令 / Runbook”小节。

TagLauncher WindowServer 会诊风险复核

来源：26.0701-Taglauncher.WindowServer会诊-风险复核.md

搜索关键词：WindowServer、CursorUIViewService、Quick Search IME、hasMarkedText、markedText、addGlobalMonitorForEvents、TagNavigation nextEvent、tag_editor_mouse_event_qa、quick_search_launch_contract_qa

用途：找回 8.3.1 最新源码下 WindowServer 会诊风险复核结论、仍建议提前修复的 Quick Search / IME / TagNavigation 风险，以及静态 QA 命令。

TagLauncher WindowServer 四项修复 QA

来源：26.0701-Taglauncher.WindowServer会诊-四项修复.md

搜索关键词：windowserver_event_safety_qa.sh、Quick Search IME、hasMarkedText、composition、TagNavigation nextEvent、pressedMouseButtons、macos14_availability_typecheck_qa.sh

用途：找回 WindowServer / TextInput 四项风险修复后的完整 QA、typecheck 和 build Runbook。

WindowServer / TextInput 事件安全门禁

cd /Users/ar/Projects/Taglauncher/src
bash Scripts/windowserver_event_safety_qa.sh

Quick Search 启动合同

cd /Users/ar/Projects/Taglauncher/src
bash Scripts/quick_search_launch_contract_qa.sh
bash Scripts/quick_search_app_name_qa.sh
bash Scripts/quick_search_system_app_qa.sh

TagNavigation / 标签编辑事件回归

cd /Users/ar/Projects/Taglauncher/src
bash Scripts/tag_double_click_preferences_qa.sh
bash Scripts/tag_navigation_hover_scroll_qa.sh
bash Scripts/tag_editor_mouse_event_qa.sh

macOS 14 兼容与构建

cd /Users/ar/Projects/Taglauncher/src
bash Scripts/macos14_availability_typecheck_qa.sh
bash Scripts/macos14_build_metadata_qa.sh
bash build.sh

TagLauncher WindowServer 预防收窄 QA

来源：26.0702-Taglauncher.Coder3-WindowServer预防收窄.md

搜索关键词：usage_tips_qa.sh、app_note_bubble_input_qa.sh、WindowServer、App note bubble、NSTextField、hasMarkedText、NSEvent.mouseLocation、event.window === self.window

用途：找回 Usage Tips local monitor 只处理本窗口事件、App note 泡泡原生 NSTextField IME 防线，以及完整 QA / 构建命令。

WindowServer 预防收窄完整回归

cd /Users/ar/Projects/Taglauncher/src
bash Scripts/usage_tips_qa.sh
bash Scripts/app_note_bubble_input_qa.sh
bash Scripts/windowserver_event_safety_qa.sh
bash Scripts/tag_editor_mouse_event_qa.sh
bash Scripts/quick_search_launch_contract_qa.sh
bash Scripts/macos14_availability_typecheck_qa.sh
git diff --check
bash build.sh
bash Scripts/macos14_build_metadata_qa.sh

TagLauncher Raycast Extension 发布命令

来源：26.0702-Taglauncher.Coder3-Raycast扩展备忘.md

搜索关键词：Raycast Extension、Search TagLauncher、npm run build、npm run publish、raycast/extensions、Raycast Store、index.json

用途：未来开发 Raycast Extension 后，找回本地构建和提交 Raycast Store 审核的命令与前置条件。

Raycast Extension 构建与发布

npm run lint
npm run build
npm run publish

TagLauncher 本机 Pro 状态 QA 切换

来源：26.0701-Taglauncher.Coder3-Pro状态QA命令.md

搜索关键词：TAGLAUNCHER_QA_PRO_STATE、launchctl setenv、launchctl unsetenv、强制 Pro、强制免费、Pro QA 状态、本机购买测试

用途：找回本机 QA 时强制切换 TagLauncher 免费 / Pro 状态，以及清理 QA 覆盖恢复真实权益状态的 Runbook。完整命令见来源记录的“可复用命令 / Runbook”小节。

强制切到 Pro 状态

pkill -x TagLauncher || true
launchctl setenv TAGLAUNCHER_QA_PRO_STATE pro
open -n /Users/ar/Projects/Taglauncher/src/build/TagLauncher.app

强制切回免费状态

pkill -x TagLauncher || true
launchctl setenv TAGLAUNCHER_QA_PRO_STATE free
open -n /Users/ar/Projects/Taglauncher/src/build/TagLauncher.app

清理 QA 覆盖，恢复真实权益状态

pkill -x TagLauncher || true
launchctl unsetenv TAGLAUNCHER_QA_PRO_STATE
open -n /Users/ar/Projects/Taglauncher/src/build/TagLauncher.app

注意：unsetenv 不是强制免费，只是恢复真实权益判断；如果测试目标是免费态，用上面的 setenv TAGLAUNCHER_QA_PRO_STATE free。

TagLauncher 8.3.0 自定义容器额度

来源：26.0701-Taglauncher.Coder3-标签额度开发.md

搜索关键词：8.3.0、20260701.1530、freeCustomContainerLimit、customContainerQuota、pro_custom_container_quota_qa、TagLauncher-8.3.0-20260701.1530.dmg

用途：找回 8.3.0 自定义容器额度开发后的构建、DMG、QA 与校验 Runbook。完整命令见来源记录的“可复用命令 / Runbook”小节。

TagLauncher 8.3.5 标签排序释放

来源：26.0702-Taglauncher.Coder3-8.3.5排序释放.md

搜索关键词：8.3.5、20260702.1046、free tag order persistence、pro_custom_container_quota_qa、pro_custom_hotkeys_qa、TagLauncher-8.3.5-build20260702.1046.pkg、v8.3.5-build20260702.1046

用途：找回 8.3.5 释放免费用户标签列表排序持久化、自定义快捷键仍保持 Pro、QA、DMG、App Store .pkg 和冻结 tag 的 Runbook。完整命令见来源记录的“可复用命令 / Runbook”小节。

8.3.5 QA 回归

cd /Users/ar/Projects/Taglauncher/src
bash Scripts/pro_custom_container_quota_qa.sh
bash Scripts/pro_feature_gate_qa.sh
bash Scripts/pro_localization_qa.sh
bash Scripts/app_ordering_data_qa.sh
bash Scripts/pro_custom_hotkeys_qa.sh
bash Scripts/macos14_availability_typecheck_qa.sh
bash Scripts/pro_display_mode_preview_qa.sh
bash Scripts/theme_settings_qa.sh
APP_BUILD=20260702.1046 bash build.sh
bash Scripts/macos14_build_metadata_qa.sh build/TagLauncher.app
codesign --verify --deep --strict --verbose=2 build/TagLauncher.app

8.3.5 发布包预检

cd /Users/ar/Projects/Taglauncher/src
hdiutil verify Release/AppStore-8.3.5-20260702.1046/Archive/TagLauncher-8.3.5-build20260702.1046.dmg
pkgutil --check-signature Release/AppStore-8.3.5-20260702.1046/Upload/TagLauncher-8.3.5-build20260702.1046.pkg
pkgutil --expand-full Release/AppStore-8.3.5-20260702.1046/Upload/TagLauncher-8.3.5-build20260702.1046.pkg Release/AppStore-8.3.5-20260702.1046/Preflight/expanded
codesign --verify --deep --strict --verbose=2 Release/AppStore-8.3.5-20260702.1046/Preflight/expanded/com.taglauncher.app.pkg/Payload/TagLauncher.app
shasum -a 256 Release/AppStore-8.3.5-20260702.1046/Archive/TagLauncher-8.3.5-build20260702.1046.dmg Release/AppStore-8.3.5-20260702.1046/Upload/TagLauncher-8.3.5-build20260702.1046.pkg

TagLauncher 8.3.0 标签额度刷新 QA

来源：2026-07-01-标签额度刷新审查.md

搜索关键词：customContainerQuotaAccessory、customContainerQuotaStatus、onRefresh、TagEditorView、pro_custom_container_quota_qa、0/6、1/6、免费用户自定义标签额度

用途：找回免费用户维护标签后顶部额度文案实时刷新的静态 QA、typecheck 和构建验证命令。完整命令见来源记录的“可复用命令 / Runbook”小节。

TagLauncher 8.3.0 编辑标签崩溃与额度刷新最终 DMG

来源：26.0701-Taglauncher.发布修复-编辑标签崩溃和额度刷新.md

搜索关键词：TagLauncher.dmg、20260701.2234、tag_editor_mouse_event_qa.sh、pro_custom_container_quota_qa.sh、customContainerQuotaStatus、0/6、mouseDown(with: event)、TextFieldContainer、编辑标签卡死、额度实时刷新

用途：找回 8.3.0 编辑标签卡死修复、自定义容器额度实时刷新补修、最终本地验收 DMG、QA 和包验证 Runbook。完整命令见来源记录的“可复用命令 / Runbook”小节。

最终本地验收 DMG

/Users/ar/Projects/Taglauncher/src/build/TagLauncher.dmg

最终构建号与 SHA256

8.3.0 (20260701.2234)
a3f7f9d87ec74e5f424e00219d8876f113ee68b29dd147043ad640764d642fbf

TagLauncher 8.3.1 设置标题语言刷新 DMG

来源：26.0701-Taglauncher.Pro会员功能-设置标题刷新.md

搜索关键词：settings_language_title_qa.sh、refreshPreferencesWindowTitle、localizedPreferencesWindowTitle、appLanguageDidChange、menu.preferences、Параметры、8.3.1、20260701.2302、TagLauncher.dmg

用途：找回设置窗口标题栏语言刷新修复、8.3.1 本地验收 DMG、QA 和包验证 Runbook。完整命令见来源记录的“可复用命令 / Runbook”小节。

最终本地验收 DMG

/Users/ar/Projects/Taglauncher/src/build/TagLauncher.dmg

最终构建号与 SHA256

8.3.1 (20260701.2302)
195e5edb09e031333f74cadf22935f322c4016bd1d30073d664938296b3e62f7

TagLauncher Settings over AppGrid 双 ESC

来源：26.0701-Taglauncher.Coder3-设置ESC与语言居中.md

搜索关键词：settingsEscapeMonitor、languageContentWidth、key code 53、taglauncher://show、Settings over AppGrid、双 ESC、语言页居中

用途：找回语言页整体居中、Settings 覆盖 AppGrid 时第一次 ESC 关 Settings / 第二次 ESC 关 AppGrid 的构建、QA 与 GUI 验证 Runbook。完整命令见来源记录的“可复用命令 / Runbook”小节。

TagLauncher 8.3.0 本地验收 DMG

来源：26.0701-Taglauncher.Coder3-8.3.0验收DMG.md

搜索关键词：TagLauncher-8.3.0-build20260701.2029.dmg、hdiutil verify、make_dmg.sh、APP_BUILD、本地验收DMG、c1a2b0da8fd2c1ed7a00e792440085cfe2003830665db48bc2c4da77742b36bb

用途：找回 8.3.0 本地验收 DMG 的生成、重命名、SHA256 和挂载验证 Runbook。完整命令见来源记录的“可复用命令 / Runbook”小节。

TagLauncher 8.2.9 冻结与上架

来源：2026-06-30-代码冻结-01.md

上架包路径

/Users/ar/Projects/Taglauncher/src/Release/AppStore-8.2.9-20260630.1617/Upload/TagLauncher-8.2.9-build20260630.1617.pkg

回滚验证 DMG

/Users/ar/Projects/Taglauncher/src/Release/AppStore-8.2.9-20260630.1617/Archive/TagLauncher-8.2.9-build20260630.1617.dmg

重新构建与打 DMG

cd /Users/ar/Projects/Taglauncher/src
APP_BUILD=20260630.1617 bash build.sh
bash make_dmg.sh

推送冻结分支和 tag

cd /Users/ar/Projects/Taglauncher
git push origin codex/pro-custom-hotkeys-8.2.0
git push origin v8.2.9-build20260630.1617

回到冻结点检查

cd /Users/ar/Projects/Taglauncher
git switch --detach v8.2.9-build20260630.1617

GitHub Pages Hero 图片替换

来源：2026-06-30-网站Hero替换.md

脏工作区中单文件替换 Pages Hero

搜索关键词：hero-visual.jpg、GitHub Pages、main:/docs、Gemini_Generated_Image、443c1ce

用途：在主工作区已有大量未提交改动时，用临时 worktree 只替换并发布 main:/docs/assets/hero-visual.jpg。

完整命令见：2026-06-30-网站Hero替换.md 的“可复用命令 / Runbook”小节。

GitHub Pages App Memo 图片替换

来源：2026-06-30-app-memo替换.md

压缩并替换 app-memo.png

搜索关键词：app-memo.png、GitHub Pages、main:/docs、2.2.jpeg、3a48209

用途：在主工作区已有未提交改动时，用临时 worktree 把 /Users/ar/Downloads/2.2.jpeg 转为压缩 PNG，并发布为 main:/docs/assets/app-memo.png。

完整命令见：2026-06-30-app-memo替换.md 的“可复用命令 / Runbook”小节。

GitHub Pages 官网文案替换

来源：2026-06-30-官网文案替换.md

重新生成并验证官网文案

搜索关键词：官网文案、siteViewsLead、siteTagsVisualLine、siteTagsDragLine、一屏到底，一目了然

用途：在官网 worktree 中重新生成 GitHub Pages 静态页，并验证简体中文首页文案替换结果。

完整命令见：2026-06-30-官网文案替换.md 的“可复用命令 / Runbook”小节。

App Store 截图尺寸处理

来源：2026-06-30-截图尺寸处理.md

补白为 2560x1600 PNG

搜索关键词：App Store 截图尺寸、2560x1600、ImageChops、SCR-20260630-szrh-2

用途：把非 16:10 官网截图补白为苹果接受的 2560 × 1600 PNG，同时不缩放、不裁切原图。

完整命令见：2026-06-30-截图尺寸处理.md 的“可复用命令 / Runbook”小节。

Pro 自定义容器额度 QA

来源：2026-07-01-额度状态审查.md

复查容器额度静态门禁

搜索关键词：pro_custom_container_quota_qa.sh、customContainerQuotaAccessory、customContainerQuotaStatus、已使用 0 / 6

用途：复查 Pro 自定义容器额度门禁、文案和脚本 wiring。

完整命令见：2026-07-01-额度状态审查.md 的“可复用命令 / Runbook”小节。

TagLauncher 8.3.5 App Store 发布前价格复核

来源：26.0702-Taglauncher.Coder3-8.3.5上架配置.md

搜索关键词：App Store Connect、Taglauncher 8.3.5、20260702.1046、价格 下载、$0.00、175 个国家或地区、此版本新增内容、添加以供审核

用途：找回 8.3.5 提交审核前的 App Store Connect 价格页与版本页复核步骤，避免新版本仍按旧付费下载价格上架。

GitHub Pages App Store 下载链接

来源：2026-07-05-官网商店链接.md

搜索关键词：官网、App Store、apps.apple.com/cn/app/taglauncher/id6777149496、coming soon、website-copy-text、docs/index.html

用途：找回官网静态 HTML 增加 App Store 下载入口后的覆盖检查、旧“即将上架”文案检查和本地静态服务验证命令。

TagLauncher 自建远端 main 接入

来源：2026-07-05-自建远端接入.md

搜索关键词：selfhost、git.boborobots.com、tag-launcher.git、codex/pro-custom-hotkeys-8.2.0、github-pages-main-legacy、v8.3.5-build20260702.1046

用途：找回当前 App 最新代码接入自建 Git 服务器、推送 selfhost/main、本地分支改名为 main、推送当前 release tag 和后续验证命令。

TagLauncher AppGrid 备注气泡 placeholder 本地测试包

来源：26.0822-Taglauncher.AppGrid备注气泡-placeholder字色.md

搜索关键词：placeholderAttributedString、NSColor.white.withAlphaComponent(0.48)、8.3.7、20260822.2207、localtest.dmg

用途：找回 AppGrid 备注气泡 placeholder 字色优化后的本地 DMG 构建、验证、归档路径和 SHA256。

TagLauncher AppGrid 备注气泡 placeholder Owner 验收

来源：26.0828-Taglauncher.AppGrid备注气泡-placeholder验收.md

搜索关键词：8.3.7、20260822.2207、localtest.dmg、Owner 验收、效果 OK

用途：找回用户安装验证通过后的验收结论，以及本地体验 DMG 的校验和打开命令。

TagLauncher quicksearchfilter 返修代码审核

来源：26.0828-Taglauncher.quicksearchfilter-返修代码审核.md

搜索关键词：QSF-CR-002、CR_PASS_QSF_FIX、QuickSearchTagFilterClickTargetView、isReservedGroupName、Duplicate values for key、quick_search_tag_filter_qa.sh

用途：找回 quicksearchfilter 8.4.0 F1/F2 返修代码审核的复跑命令、终态结论和 QA 复测边界。