fix(helper): localise TCC prompts via lproj/InfoPlist.strings (#43)

User report: the two macOS TCC permission popups looked
inconsistent on a zh-locale machine — the Location prompt showed
"谛听 · 天耳" (Chinese) while the Bluetooth prompt showed
"diting-tianer.app" (English-looking bundle filename), and both
prompt bodies were always English even for zh users.

Root cause: the bundle had `CFBundleDisplayName = "谛听 · 天耳"`
set at the top level of Info.plist but no localised
InfoPlist.strings overrides. macOS picks the TCC prompt's
header from different fields per category (Location reads
CFBundleDisplayName, Bluetooth falls back to the bundle's URL
filename), and both prompt bodies come straight from the
NSLocationUsageDescription / NSBluetoothAlwaysUsageDescription
plist keys — which were English-only.

Fix: proper locale-aware InfoPlist.strings.

- New helper/Resources/en.lproj/InfoPlist.strings with English
  overrides for CFBundleDisplayName / CFBundleName /
  NSLocation* / NSBluetoothAlwaysUsageDescription
- New helper/Resources/zh-Hans.lproj/InfoPlist.strings with the
  Chinese equivalents (display name "谛听 · 天耳", prompt bodies
  translated)
- Info.plist top-level CFBundleName / CFBundleDisplayName unified
  to "diting · tianer" (English fallback for non-lproj-aware
  locales); the previous split between CFBundleName=diting-tianer
  and CFBundleDisplayName=谛听 was what created the prompt
  inconsistency in the first place
- Info.plist declares CFBundleLocalizations [en, zh-Hans] for
  older macOS releases that don't auto-discover lproj dirs
- helper/build.sh copies the Resources/*.lproj tree into the
  assembled bundle

Both .strings files pass `plutil -lint`; the bundle rebuilds
cleanly with no errors. zh-locale TCC prompts on v1.0.4 should
now show consistent Chinese display name + Chinese body in both
the Location and Bluetooth dialogs.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: chenchaoyi

CHANGELOG.md

@@ -9,6 +9,37 @@ the project follows [Semantic Versioning](https://semver.org/) where
 practical. The leading `v0.x` line is allowed to break minor
 behaviours between releases.
 
+## [1.0.4] — 2026-05-13
+
+User reported macOS's TCC permission prompts were inconsistent:
+the Location prompt showed "谛听 · 天耳" (Chinese display name)
+while the Bluetooth prompt showed "diting-tianer.app" (raw bundle
+filename) — and both prompt bodies were always English even for
+zh users. macOS picks the TCC prompt's header name from different
+fields per category (`CFBundleDisplayName` for Location, the
+bundle's URL filename for Bluetooth), and the prompt body comes
+straight from the usage-description plist keys.
+
+### Fixed
+- **TCC prompts now localise consistently.** Helper bundle ships
+  `Resources/en.lproj/InfoPlist.strings` and `Resources/zh-Hans.lproj/
+  InfoPlist.strings` with locale-specific `CFBundleDisplayName`,
+  `CFBundleName`, and all three usage-description keys
+  (`NSLocationUsageDescription`,
+  `NSLocationWhenInUseUsageDescription`,
+  `NSBluetoothAlwaysUsageDescription`). macOS now picks Chinese
+  strings for zh users in both the Location and Bluetooth prompt
+  headers AND bodies. `CFBundleLocalizations` lists both
+  locales so older macOS releases that don't autodiscover lproj
+  dirs still pick the right one. `helper/build.sh` copies the
+  `Resources/*.lproj` tree into the assembled `.app`.
+- **Top-level `Info.plist` `CFBundleName` / `CFBundleDisplayName`
+  unified.** Both keys now default to `diting · tianer` (English
+  fallback) instead of the previous split where `CFBundleName` was
+  `diting-tianer` and `CFBundleDisplayName` was `谛听 · 天耳` —
+  the split was what produced the language-inconsistent prompts
+  in the first place.
+
 ## [1.0.3] — 2026-05-13
 
 First end-user-installed release surfaced a long-latent CoreWLAN

docs/zh/CHANGELOG.md

@@ -8,6 +8,33 @@
 [Semantic Versioning](https://semver.org/)。`v0.x` 阶段允许破坏性的次要
 行为变更。
 
+## [1.0.4] — 2026-05-13
+
+用户反馈 macOS TCC 权限弹窗不一致：定位权限弹窗显示「谛听 · 天耳」
+（中文显示名），蓝牙权限弹窗显示「diting-tianer.app」（裸 bundle
+文件名）；而且两个弹窗的正文都永远是英文，中文用户看不到中文描
+述。本质上 macOS 给不同类别的 TCC 弹窗取标题字段的来源不一样
+（定位用 `CFBundleDisplayName`，蓝牙用 bundle URL filename），
+弹窗正文则直接来自 usage description 字段。
+
+### 修复
+- **TCC 弹窗在各语言下保持一致**。Helper bundle 新增
+  `Resources/en.lproj/InfoPlist.strings` 与
+  `Resources/zh-Hans.lproj/InfoPlist.strings`，按当前 locale 提供
+  `CFBundleDisplayName` / `CFBundleName` 以及三个 usage description
+  字段（`NSLocationUsageDescription`、
+  `NSLocationWhenInUseUsageDescription`、
+  `NSBluetoothAlwaysUsageDescription`）。zh 用户现在在「定位」和
+  「蓝牙」两个弹窗里都看到中文标题和中文正文。Info.plist 新增
+  `CFBundleLocalizations` 列出两种语言，老版本 macOS 不自动扫
+  lproj 目录也能找到对应翻译。`helper/build.sh` 已经把
+  `Resources/*.lproj` 整棵树拷进打包好的 .app。
+- **`Info.plist` 顶层 `CFBundleName` / `CFBundleDisplayName` 统一**。
+  两个 key 现在都默认是 `diting · tianer`（英文兜底）；先前
+  `CFBundleName` 是 `diting-tianer`，`CFBundleDisplayName` 是
+  `谛听 · 天耳` —— 正是这种分裂导致了上面那种语言不一致的 TCC
+  弹窗组合。
+
 ## [1.0.3] — 2026-05-13
 
 第一个真正可被最终用户装出来的 release。装出来之后 `diting` 一直卡

helper/Info.plist

@@ -11,11 +11,26 @@
     <key>CFBundleIdentifier</key>
     <string>com.chenchaoyi.diting.tianer</string>
 
+    <!-- CFBundleName / CFBundleDisplayName here are the English
+         defaults (fallback for any locale not in our lproj list).
+         The real per-locale display strings live in
+         Resources/{en,zh-Hans}.lproj/InfoPlist.strings so macOS
+         picks the user's preferred language for both the TCC prompt
+         header AND the prompt body
+         (NSLocationUsageDescription / NSBluetoothAlwaysUsageDescription).
+         Older macOS that doesn't honour CFBundleLocalizations still
+         falls back to these top-level values. -->
     <key>CFBundleName</key>
-    <string>diting-tianer</string>
+    <string>diting · tianer</string>
 
     <key>CFBundleDisplayName</key>
-    <string>谛听 · 天耳</string>
+    <string>diting · tianer</string>
+
+    <key>CFBundleLocalizations</key>
+    <array>
+        <string>en</string>
+        <string>zh-Hans</string>
+    </array>
 
     <key>CFBundlePackageType</key>
     <string>APPL</string>

helper/Resources/en.lproj/InfoPlist.strings

@@ -0,0 +1,19 @@
+/* English (default) localisation for the helper bundle's Info.plist.
+ *
+ * macOS's TCC prompts and the Finder display name read both
+ * CFBundleDisplayName and the usage descriptions through the
+ * active locale's lproj. Without this file, English users would
+ * see the global CFBundleDisplayName ("谛听 · 天耳") even though
+ * their locale is English — and the prompt bodies are English
+ * literals living in Info.plist directly.
+ *
+ * Keys must match exactly; macOS does NOT fall back to Info.plist
+ * if a key is missing here.
+ */
+
+"CFBundleDisplayName" = "diting · tianer";
+"CFBundleName" = "diting · tianer";
+
+"NSLocationUsageDescription" = "diting reads nearby Wi-Fi network names and BSSIDs to label access points and detect roaming. Location data never leaves your machine.";
+"NSLocationWhenInUseUsageDescription" = "diting reads nearby Wi-Fi network names and BSSIDs to label access points and detect roaming. Location data never leaves your machine.";
+"NSBluetoothAlwaysUsageDescription" = "diting scans nearby BLE advertisements so the TUI can show you what devices are around.";

helper/Resources/zh-Hans.lproj/InfoPlist.strings

@@ -0,0 +1,18 @@
+/* Simplified Chinese localisation for the helper bundle's Info.plist.
+ *
+ * Applies when the user's macOS preferred language starts with `zh`
+ * (zh-Hans, zh-CN, zh-HK with Simplified fallback). macOS shows
+ * these strings in the TCC prompts (CWNetwork / CBCentralManager
+ * permission dialogs) and in the Finder / Force Quit dialog.
+ *
+ * Keep parity with the EN strings — same fields, equivalent
+ * meaning. The brand name 谛听 · 天耳 follows the project memory:
+ * 谛听 (diting) is the family name, 天耳 (tianer) is the helper.
+ */
+
+"CFBundleDisplayName" = "谛听 · 天耳";
+"CFBundleName" = "谛听 · 天耳";
+
+"NSLocationUsageDescription" = "diting 读取附近 Wi-Fi 网络的 SSID 和 BSSID，用于识别 AP 与漫游事件。位置数据不会离开你的电脑。";
+"NSLocationWhenInUseUsageDescription" = "diting 读取附近 Wi-Fi 网络的 SSID 和 BSSID，用于识别 AP 与漫游事件。位置数据不会离开你的电脑。";
+"NSBluetoothAlwaysUsageDescription" = "diting 扫描附近 BLE 广播，TUI 才能显示周围的设备。";

helper/build.sh

@@ -31,6 +31,19 @@ cp Info.plist "$BUNDLE/Contents/Info.plist"
 cp "$BIN_PATH" "$BUNDLE/Contents/MacOS/$BIN_NAME"
 chmod +x "$BUNDLE/Contents/MacOS/$BIN_NAME"
 
+# Ship per-locale InfoPlist.strings overrides so macOS's TCC
+# prompts (Location / Bluetooth) AND the Finder display name pick
+# up Chinese strings for zh users instead of the English defaults
+# baked into Info.plist. Without these, the user sees one prompt
+# with "谛听 · 天耳" (CFBundleDisplayName) and another with
+# "diting-tianer.app" (the bundle filename), since macOS uses
+# different name sources across TCC prompt categories.
+for lproj in Resources/*.lproj; do
+    if [ -d "$lproj" ]; then
+        cp -R "$lproj" "$BUNDLE/Contents/Resources/"
+    fi
+done
+
 echo "==> ad-hoc code signing"
 # Ad-hoc signature is enough for local use; macOS still recognises the
 # bundle as a distinct TCC subject. For distribution, replace `-` with

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "diting"
-version = "1.0.3"
+version = "1.0.4"
 description = "macOS terminal listening post for Wi-Fi, BLE, link health, and the RF environment — your Mac hears more than it tells you"
 readme = "README.md"
 license = "MIT"