接手的第一件事:先讀
AGENTS.md(鐵則),再讀本節。 下面兩節是歷史,僅供追溯。
所有工作已收編進 master 並 push(本地與 origin 同步,且都只剩 master 一條 branch)。
版本 vc17 / 1.3.1。工作區乾淨。唯一在跑的事:Stan 要把 release AAB 上傳 Play Console。
tip sha 別寫死在文件裡(寫死了每 commit 一次就爛一次)。要現況跑
git log --oneline -1 master。
從 Codex 交出一堆未 commit 的改動開始,到 vc17 可送審為止:
- 收編 Codex 的 1957 行未 commit 改動(19 個檔全躺在工作區,沒有版本足跡)。
按相依層次切成 7 個 commit(
20febc3..9c10a30),每一個都 checkout 出來實際編譯 + 跑測試驗過。 不是按「8 個功能主題」切——那 8 個主題交錯在同一批函式裡,真要那樣切得憑空改寫 Codex 的程式碼、 生出 8 個從沒被測試過的中間狀態當還原點。那是偽造歷史。 - 修好「同一則訊息跳兩張卡」(
f4f2b46)。這是本次最實質的修復,詳見下方「關鍵決策」。 - 修根因:AGENTS.md 的版本規則(
e67273c)。 - 合併進 master + push,並校正
play-console-progress.md裡過期的 Impersonation blocker(ddb5c6c)。 - 產出 vc17 / 1.3.1 的 release AAB 與中英 release notes(都在 500 字元上限內,已用
wc -m實測)。
-
雙 callback 去重的指紋不准放
PendingIntent或MessagingStyle。 Codex 的 v1.3.0 宣稱修好了「跳兩則」,實機上一次都沒生效過。實機 logcat 逐欄位比對後找到兩個原因:contentIntent.hashCode()在 tagged 與 legacy mirror 兩邊必然不同(實測 250458503 vs 131309470, 而且是兩者唯一不同的欄位),卻被算進指紋 → 配對保證失敗。- legacy mirror 有時整個抽不到 MessagingStyle → 指紋退回 null → 連配對都不試。
修法是把指紋改由「兩邊必然相同」的結構性身分組成,並把組裝抽成純函式
NotificationClassifier.mirrorFingerprint(...)——參數列就是欄位白名單,型別層面傳不進 PendingIntent。 光寫註解擋不住下一個人再犯。想加欄位,先在實機證明它兩邊一致。 -
版號 bump 是收工義務,不是發版動作。 舊 AGENTS.md 把「別自己改 versionCode」和「別自己上傳 Play」寫成一句,agent 字面執行的結果是 「版號不能碰」,於是 Codex 交出 1957 行零版本足跡的改動,Stan 裝到手機上完全看不出裝了什麼。 規則已拆開重寫(
e67273c)。Stan 的硬性要求:他裝到手機時必須能在「關於」頁看到版號變了、 看到這次改了什麼。 -
Play Console 的狀態不准用讀 repo 的方式去猜。 我曾照
play-console-progress.md判定「icon 像 LINE = Impersonation blocker」,Stan 說那是錯的: 改名後重新送審已通過,icon 維持原樣沒問題。那份文件的紅燈是 2026-06-23 退件當下的推測, 被 Console 的實際裁決推翻了。 Console 只有 Stan 看得到。
- 能跑:
assembleDebug/assembleRelease/bundleRelease全綠。 - 測試 42 個全過(40 classifier + 2 ChatRoom)。跑
./gradlew.bat testDebugUnitTest --rerun。⚠️ 不加--rerun會回UP-TO-DATE跳過測試卻仍印BUILD SUCCESSFUL,那不是綠燈。 拿真數字讀app/build/test-results/testDebugUnitTest/*.xml的tests=/failures=。 - 實機驗證通過(Nothing A059P / Android 16 / LINE 26.10.1):一則訊息一張卡,群組也是。 手機上目前裝著 vc17 / 1.3.1。
- release 產物已備妥:
app/build/outputs/bundle/release/app-release.aab(7,112,501 bytes,SHA-2560a91222c75e10ab9…,jarsigner -verify通過,權限實測只有 2 個)。 - 線上隱私政策已部署且驗證:push master 後 GitHub Pages 自動更新,
curl線上頁與 repodocs/逐字一致。
-
🔴 Android 15+ 私密通知的遮蔽偵測,從來沒有真正執行過一次。 這是最重要的未結項。
isSystemRedactedNotification()有四個判斷條件,只有「系統字串比對」拿到實證 (實機查到Resources.getSystem()回傳的繁中字串與用戶截圖逐字相同,且該查詢會跟著系統語系走, 所以不需要為英文另外寫程式碼)。其餘三條(subText == null、title == LINE 的 app label、 app label 讀得到)零真實資料佐證。 Stan 的手機重現不出遮蔽通知(連刻意傳驗證碼格式也沒觸發系統的敏感內容分類器)。 唯一驗證路徑:等真的會遇到的用戶裝到 1.3.1 之後回報。⚠️ 別因為「程式碼看起來很完美、有單元測試、有詳細註解」就當它會動——Codex 的雙 callback 合併 就是這樣,實機上一次都沒命中。讀程式碼推不出行為。 -
⚠️ 如果有人回報「私密訊息現在完全看不到通知了」,那不是 bug,是設計。 遮蔽的訊息 Notify+ 會退場, 讓 LINE 自己的通知顯示(LINE 看得到完整內容)。FAQ 裡有寫(faq_q_sensitive_hidden)。 -
ℹ️ Play Console 的兩個 warning 不用修(已在 vc17 上重新驗證):
- native debug symbols:AAB 裡唯一的
.so是 androidx 帶進來的libandroidx.graphics.path.so,file顯示它 stripped——符號表根本不存在,抽不出東西。ndk { debugSymbolLevel = "FULL" }早就設了(app/build.gradle.kts:47),AAB 的BUNDLE-METADATA/裡依然一個 symbol 都沒有。 專案零自家原生程式碼,不可能在原生層當機。修不了也不需要修。 - 沒有 deobfuscation 檔:因為 R8 故意關著(鐵則 6)。沒混淆就沒對照表,這警告本來就會出現。
- native debug symbols:AAB 裡唯一的
- Stan:上傳 vc17 到 Play Console。
⚠️ 先確認 vc17 沒被 Console 佔用過(Release → App bundles 看歷史)。文件只確認 vc13、vc14 已燒掉, vc15、vc16 狀態不明。若 vc17 已被用掉,要 bump 到下一個可用號碼並重建 AAB(三件套一起改)。- AAB:
app/build/outputs/bundle/release/app-release.aab - Release notes(中英,已壓進 500 字元):
play-store-assets/store-listing.md
清掉殘留 branch✅ 已完成(2026-07-15,見下方「branch 清理」)。- 上線後盯遮蔽偵測的回報。 這是唯一能驗證它的路徑。
本地與 origin 現在都只剩 master。 原本殘留的 11 條全部刪除:7 條已併入 master(-d 乾淨刪),
4 條過期產物(feat/* ×3 落後 master 21 個 commit、preview/all-three-2026-07-02 是三條的重複預覽)
用 -D 強制刪。
刪除前已打 tag 釘住那 4 條的 commit,本地與 origin 都有,永遠救得回來:
archive/feat/notification-style-visual-guide → a480542
archive/feat/permission-guidance → 2c3c610
archive/feat/problem-reporting → 7c09702
archive/preview/all-three-2026-07-02 → 1f7d3a6
要復原任何一條:git checkout -b <名字> archive/<原分支名>
為什麼刪:
feat/*是rebased/*的過期前身,內容 100% 被 master 覆蓋,而且合下去會衝突 (feat/notification-style-visual-guide解錯衝突還會把 master 刻意移除的 HelpActivity 「通知風格說明」卡復活)。preview/與那三條 patch-id 重複。留著只會誤導下一個接手的人。
- 行為類改動你驗證不了,不准宣稱測過。
BUILD SUCCESSFUL只證明編得過。這個 repo 有兩次血淋淋的例子: (1)painterResource(R.mipmap.ic_launcher)編譯正常、一啟動就 crash; (2) Codex 的雙 callback 合併程式碼完美、測試齊全、實機一次都沒生效。 - 要看通知行為,用 logcat 不要用推論:
關鍵 log:
export ADB="C:/Users/stans/AppData/Local/Android/Sdk/platform-tools/adb.exe" export MSYS2_ARG_CONV_EXCL="*" # 不加這行,Git Bash 會把 /system/... 轉成 Windows 路徑 "$ADB" logcat -c "$ADB" logcat -v time LineNotify:V "*:S"
收到訊息(每則訊息應只出現一次)、對話串通知 count=(應只到 1)、合併 LINE conversation/legacy mirror callback(每則訊息應命中一次)、系統已遮蔽敏感通知(遮蔽偵測命中)。 install -r之後一定要重綁 listener,否則訊息不會跳:驗證有沒有綁上:COMP="com.stanslab.linenotify/com.stanslab.linenotify.service.LineNotificationListener" "$ADB" shell cmd notification disallow_listener "$COMP" "$ADB" shell cmd notification allow_listener "$COMP"
"$ADB" shell settings get secure enabled_notification_listeners | grep linenotify(cmd notification allowed_listeners不是有效指令,別用它判斷)- build 環境:Windows 路徑含空格,先
export JAVA_HOME="/c/Program Files/Android/Android Studio/jbr"。 - commit 一律用明確路徑(
git add <path>),禁git add -A:工作區有.claude/、tools/、build-install.bat、design/*.png等未追蹤雜物,會被掃進去。 - 設計決策仍然有效:導航 B 模型、主要按鈕鎖品牌綠
Green40 (#06C755)其餘跟系統動態取色、 元件命名照design/COMPONENTS.md。 - 回應一律繁體中文。
- 通知行為出問題 →
diagnosing-bugs(先建可重現的紅燈迴圈,別直接猜) - 動 Compose UI →
impeccable - 切 commit / 版號策略 →
agent-skills:git-workflow-and-versioning - 宣稱完成前 →
superpowers:verification-before-completion - 對外文字(商店文案、release notes)→
humanizer-zh-tw/humanizer
⚠️ 本節的成果已全部收編進 master(切成20febc3..9c10a30七個 commit)。 但本節宣稱「已修好」的雙 callback 合併,實機上從未生效過,已於 2026-07-15 重修(f4f2b46)。 本節的「沒有 bump、commit」是照當時 HANDOFF 的錯誤指令做的,不是 Codex 的錯。
- branch:
fix/notification-feedback-2026-07-14 - repo 版本維持
versionName 1.2.1 / versionCode 15;沒有 bump、commit、push、merge 或上傳 Play。 - 所有修改仍在 working tree,包含新測試目錄
app/src/test/java/com/stanslab/linenotify/model/。 - 使用者既有 untracked 檔完全保留:
.claude/、build-install.bat、design/.claude/、design/editor-advanced.png、design/editor-preview.png、design/text-editor.html、tools/。
- Android 私密通知占位字
- 精確辨識 Android framework 的「系統已隱藏含有私密資訊的通知內容」clone。
- 不建立假聊天室、不重發占位字、不取消 LINE 原通知;Notify+ 自己的通知改為 private visibility, public version 只顯示通用內容。
- FAQ 補 OPPO/realme 排查與隱私取捨。Android 在 listener callback 前移除的原文,App 無法還原。
- 聊天室完全靜音
- 新版關閉聊天室會清除 Notify+ 與可辨識的 LINE 原通知,包含
@all和直接標註本人。 - 舊
disabled_chats維持「不增強、保留 LINE 原通知」,避免升級後無預警漏訊息;使用者先開再關才遷移到fully_muted_chats_v2。 - 若 framework 已遮蔽聊天室名稱,或 OEM 在 listener 撤掉前先顯示,仍是平台限制;UI 已明確說明。
- 新版關閉聊天室會清除 Notify+ 與可辨識的 LINE 原通知,包含
- 社群分類
- production 統一走受測 classifier;
line.square.notification=true會 sticky 確認社群,不因下一則缺 extra 降回群組。 - 聊天室列可手動固定「好友/群組/社群」,並標示「手動」。
- production 統一走受測 classifier;
- 通知安全與穩定性
- 只處理 LINE
NewMessages,通話/付款/好友邀請等 fail-open 保留。 - 只有確認 Notify+ replacement 已 active 才取消原 LINE;active query 失敗一律保留原通知。
- Apple 模式每房 8、全域 24 個 child,以 transaction/rollback 方式提交 eviction;沒有安全 victim 時保留 LINE。
- 快速回覆只有 LINE PendingIntent 成功後才更新 UI;thread active query 失敗不清 buffer。
- 2026-07-14 實機抓到 LINE 26.10.1 對同一私訊於 24ms 內送出 tagged conversation + legacy 兩個 callback。 現在只合併 exact tagged-first 形狀、完整 MessagingStyle/interaction fingerprint、500ms 內且來源仍 active 的配對; 任一條件不符就保留兩則,優先避免漏訊息。對抗性 review 無 P1/P2 blocker。
- ChatRoom buffer 上限 25,移除手動 recycle,補 exact object identity/cap 測試。
- 只處理 LINE
- 隱私與文件
allowBackup=false;隱私政策與商店文案修正為實際資料生命週期。ROADMAP.md、README.md、AGENTS.md更新為 38 個測試;權限返回 bug 已在實機驗證完成。
lintDebug testDebugUnitTest assembleDebug assembleRelease bundleRelease --rerun-tasks:BUILD SUCCESSFUL。- JVM:38 passed / 0 failed / 0 errors / 0 skipped;lint:0 errors / 60 warnings。
- release APK:
7,595,943 bytes,SHA-25669500B611EE10AA3D4E6E361C6EF16096139B1EBA2046E1BB8B0B4A09C7D2D3E。 - release AAB:
7,113,665 bytes,SHA-2567769C4A073E111790E153BB44A977117C8767AA34899B3F0831F60A1E7C22CFE;jarsigner -verifyexit 0。 - APK manifest:minSdk 26 / targetSdk 35、
allowBackup=false、權限只有BIND_NOTIFICATION_LISTENER_SERVICE+POST_NOTIFICATIONS。 - APK:16K zipalign 驗證成功;v2 signature=true、1 signer。
- ADB:Nothing A059P、Android 16 / API 36、serial
001701527000969。- 最新 debug
install -r成功,listener 已恢復 enabled/bound。 - 關閉 listener → 首頁立即顯示「服務未啟用/需要授權」;恢復 →「服務運行中/正在接聽」。
- Help 敏感通知 FAQ、聊天室管理說明皆可見;Help/ChatManagement/About 連跑 2 輪,共 6/6 導覽成功。
- 本輪 logcat:0 fatal exception、0 app ANR、0 app process error;導覽後 PSS 約 100 MB。
- 最新 debug
- 最終 debug 安裝後尚未再收到一則真實 LINE 訊息,所以 strict mirror 合併只有純函式測試、對抗性 review,及 修正前抓到的真實雙 callback 結構;後續收到測試訊息時確認 log 有「合併 LINE conversation/legacy mirror callback」且只留一則。
- 沒有 OPPO Find X8 Ultra/realme GT8 Pro 實機;私密通知只能確認平台根因、fail-open 與 Nothing UI,仍需兩台回歸。
- 「只擋
@all、保留直接@我」刻意未用可見文字猜。需 Nothing/OPPO/realme 各抓兩種真實 extras 後再設獨立開關。 - 持久設定多數仍以顯示名稱為 key,同名聊天室可能碰撞;listener 很大、頭貼 PNG 仍在 callback 同步寫入,
thread 模式也缺全域 room budget。見
ROADMAP.md。 - LINE 沒提供 stable message ID,且 Android 沒有 query-and-cancel 原子 API;極端完全相同 payload 仍只能 fail-open。
- GitHub Pages 線上隱私政策尚未部署;不要把 repo 已更新誤寫成線上已更新。
- launcher/512 icon 仍像 LINE 綠+白氣泡,屬再次 Impersonation 退件風險。
- 4 張手機圖有舊品牌/舊功能/私密內容/debug 痕跡且 3 張比例不合;8 張 tablet 圖是假平板畫面;全部重做。
line-oa-cover.png仍是舊品牌;feature graphic 可保留,但換 icon 後需再確認整套一致。- 發版前先部署/複查 Pages、確認 vc15 是否已被 Console 使用,再由 Stan 決定版號三件套;目前產物只供驗證, 不是可直接上傳的 release。
給接手的 AI(Codex):先讀
AGENTS.md(鐵則,你會自動載入),再讀這一節。 本節取代 2026-06-07 那份的「下一步」,舊記錄保留在下方僅供追溯,它的待辦已經全部過期,別照著做。
把 3 條有價值的 rebased/* 分支整合起來,開一條 integration 分支 + PR 給 Stan。
專案目前殘留 9 條 branch(其中 8 條沒進 master,1 條已在 master 但沒清掉),懸在那裡沒人收。 它們是 2026-07-02 那一輪的產物,堆到現在造成 master 不是乾淨基準,任何新功能疊上去都會撞。 這件事阻塞其他所有工作,所以優先做它。
我(Claude)已經把 9 條全部驗過一遍,事實如下。這些是 git merge-tree / git cherry / patch-id
實測結果,不是推測,你可以直接採信,不必重查。(另有一隻獨立 verifier agent 重跑過一遍全部指令,
含「模擬依序合三條」的最終樹檢查:strings 零重複 key、無重複 import/函式宣告、R.string.* 全部解得到定義。)
| Branch | tip | 對 master | 處置 |
|---|---|---|---|
rebased/problem-reporting |
7e09c9f |
領先 2 / 落後 2,merge 乾淨 | ✅ 合(第 1 順位,最小 +58 行) |
rebased/permission-guidance |
169372e |
領先 2 / 落後 2,merge 乾淨 | ✅ 合(第 2 順位,MainActivity +140) |
rebased/notification-style-visual-guide |
9332a77 |
領先 2 / 落後 2,merge 乾淨 | ✅ 合(第 3 順位,含 223 行新檔) |
preview/all-three-2026-07-02 |
1f7d3a6 |
領先 4,merge 乾淨但內容與上面三條重複 | ❌ 別合,合完三條後刪 |
feat/problem-reporting |
7c09702 |
落後 21,merge 會衝突 | ❌ 刪 |
feat/permission-guidance |
2c3c610 |
落後 21,merge 會衝突 | ❌ 刪 |
feat/notification-style-visual-guide |
a480542 |
落後 21,merge 會衝突且是回歸 | ❌ 刪 |
fix/notification-behavior |
0d7a4d5 |
空殼,樹是 master 真子集 | ❌ 刪 |
test/unit-scaffolding-2026-07-02 |
6f72fb3 |
已在 master | ❌ 刪 |
三條 rebased/* 彼此兩兩不衝突(pairwise merge-tree 全 exit=0),所以依序合不會有二次衝突。
-
一律用
rebased/*,feat/*全部丟掉。feat/*是rebased/*的過期前身,分支點停在 2026-06-02,落後 master 21 個 commit。git merge-tree master feat/*三條全部 exit=1(衝突);rebased/*三條全部 exit=0(乾淨)。rebased/*就是把同樣的衝突解過一次的版本。 最毒的是feat/notification-style-visual-guide:它的HelpActivity.kt +2是插在NotificationStyleGuideCard()這個函式內部,而 master 的309cf52已經把整個函式連同呼叫處刪掉了。 合下去是 modify/delete 級的內容衝突(實測 exit=1);它不會自動把卡救回來,但你如果在解衝突時取了 它那邊,就會把 master 刻意移除的卡片復活,變成回歸。 別去解這個衝突,直接用rebased/版 (它完全沒碰 HelpActivity,已正確丟掉那 2 行)。 -
preview/all-three-2026-07-02不要合。 它不是 merge commit,是把三個 feature 線性堆疊的整合預覽(全單親、零分岔),內容就是那三條。 證據:其中兩顆 commit 與 rebased 版 patch-id 完全相同(42c2040≡169372e、5fa64db≡7e09c9f); 第三顆(1f7d3a6vs9332a77)patch-id 不同,但那只是因為它疊在前兩個 feature 之上、ROADMAP.md的 context 行已被打勾改過,--stat完全一樣、新檔 blob 也相同(NotificationStyleVisualGuide.kt兩邊都是502ab48)。實質內容重複。 合它 = 製造重複 commit。它的價值只在於「證明三條可以共存」,這點已經驗過了。 -
fix/notification-behavior是空殼,直接刪。 舊 HANDOFF 說它是 2026-06-07 的工作分支,那已經不成立:它後來被拿去掛別的東西,tip 現在是 2026-07-02 的一個 docs commit。git cherry -v master fix/notification-behavior回-(= master 已有等價 commit),patch-id1cfb999…與 master45e5e07完全相同,而且那是它唯一 領先 master 的 commit。它 6/07 的通知行為程式碼早就進 master 了。 反過來它比 master 少了 2 個檔案(NotificationClassifier.kt+NotificationClassifierTest.kt),build.gradle.kts也少了測試依賴。合它進 master 得不到任何東西。零價值。 -
你不能自己合進 master。 見下方「三、你的邊界」。
AGENTS.md 明令:禁止碰 master、別自己 merge、別 push master、別自己改 versionCode。
這跟「收編分支」看似矛盾,實際不矛盾。你的交付物是一條準備好的整合分支 + PR,不是一個被合掉的 master。
- ✅ 你做:開
integration/rebased-three-2026-07-14(從 master 切),把三條依序 merge 進去, 跑驗證,開 PR 給 Stan。 - ❌ 你不做:merge 進 master、push master、刪除任何 branch、bump versionCode、上傳 Play Console。 刪 branch 和合 master 是 Stan 的動作,你只在 PR 描述裡列出「建議刪除這 5 條」讓他執行。
- 發版三件套先不要碰。 三條分支沒有任何一條動過
app/build.gradle.kts(master 現在 vc15 / 1.2.1)。合併 feature 進 master 不等於發版,所以現在不需要 bump。 等 Stan 決定要出版本時,他自己補三件套(versionCode +1、versionName、AboutActivity changelog)。 你只要在 PR 裡提醒他「這批合完後若要發版,記得補三件套」。
- 能跑:
./gradlew.bat assembleDebug綠燈。 - 測試能跑而且會過:
./gradlew.bat testDebugUnitTest --rerun→ 19 passed / 0 failed (app/src/test/.../NotificationClassifierTest.kt)。⚠️ 不加--rerun的話 Gradle 會回UP-TO-DATE跳過測試、卻仍印BUILD SUCCESSFUL。那不代表測試跑過。 要拿真數字讀app/build/test-results/testDebugUnitTest/*.xml的tests=" " failures=" "。 - branch:
master,與origin/master同步(45e5e07)。 - 版本:versionCode 15 / versionName 1.2.1。尚未上架(vc12 因 Impersonation policy 退件,
已改名 Notify+ 待重交,見
play-store-assets/play-console-progress.md)。 - 權限:8 條 branch 沒有任何一條動過
AndroidManifest.xml,鐵則 2 沒被破壞。 (rebased/permission-guidance只加request_post_notifications這個字串和 runtime 請求 UI, POST_NOTIFICATIONS 權限本來就在。安全。) - i18n / 平板已完成:
values-en、values-sw600dp、values-sw720dp都在。 舊文件說「無 i18n」是錯的,我已經修掉AGENTS.md。
git status 目前有這些 untracked:
.claude/ build-install.bat design/.claude/ design/editor-advanced.png
design/editor-preview.png design/text-editor.html tools/
這些不屬於這次任務。commit 時一律 git add <明確路徑>,禁用 git add -A / git add .,
否則會把它們掃進 PR。
git checkout -b integration/rebased-three-2026-07-14 mastergit merge rebased/problem-reporting(7e09c9f,最小,先合方便 review)git merge rebased/permission-guidance(169372e)git merge rebased/notification-style-visual-guide(9332a77)- 三條的
ROADMAP.md各自打勾不同的 checkbox、strings.xml加的 key 完全不重名,git 會自動併。 - 三條都含同一個 docs commit
0d7a4d5,git 認得它與 master45e5e07是同一個 patch,會自動去重。
- 三條的
- 每合完一條就跑一次:
./gradlew.bat assembleDebug+./gradlew.bat testDebugUnitTest --rerun。 (不是最後才跑一次。中途壞掉要能指出是哪一條造成的。) git diff master...HEAD -- app/src/main/AndroidManifest.xml確認權限零變更(應為空輸出)。⚠️ 用三個點master...HEAD。two-dot 的git diff master..rebased/*會假性列出app/build.gradle.kts,那是因為 rebased 的基底ec66140少了 master 的6f72fb3(加測試依賴的 那顆),是 diff 方向造成的錯覺,不是分支真的動過它。別被騙去「修」一個不存在的問題。
- 開 PR 給 Stan,PR 描述要包含:
- 三條合了什麼、改了哪些檔
- build + test 的實際輸出(不是「應該會過」)
- 建議 Stan 刪除的 6 條廢 branch:
feat/notification-style-visual-guide、feat/permission-guidance、feat/problem-reporting、preview/all-three-2026-07-02、fix/notification-behavior、test/unit-scaffolding-2026-07-02(最後這條已在 master,純殘留)。建議刪前先打archive/*tag 保險。 - 實機驗證清單:三條都是 UI/行為改動,你驗不了(無手機),列出 Stan 該在實機上點哪些地方看哪些結果
- 提醒:若要發版,記得補三件套
- 行為類改動你驗證不了,不准宣稱測過。 這是
AGENTS.md的硬規定。BUILD SUCCESSFUL只證明編得過, 不證明通知行為正確。歷史教訓:painterResource(R.mipmap.ic_launcher)編譯完全正常,一啟動就 crash (adaptive icon 載不動)。 - build 環境:Windows 路徑含空格,直接跑
gradlew.bat會炸。先export JAVA_HOME="/c/Program Files/Android/Android Studio/jbr"。 - 實機 / adb / rebind listener 的雷點:見下方 2026-06-07 那節的第七項(
install -r後一定要 rebind notification listener,否則訊息不會跳)。那部分仍然有效。 - 設計決策仍然有效:導航 B 模型、混合配色(主要按鈕鎖品牌綠
Green40 #06C755,其餘跟系統動態取色)、 元件命名照design/COMPONENTS.md。詳見下方 2026-06-07 那節的第四項。 - Compose BOM 2024.12.01 / material3 1.3.1,用穩定 API。
- 回應一律繁體中文。
- 合併衝突真的發生 →
resolving-merge-conflicts - 收尾分支、決定 merge/PR/清理 →
superpowers:finishing-a-development-branch - 動 Compose UI →
impeccable(前端視覺主力) - 宣稱完成前 →
superpowers:verification-before-completion
⚠️ 本節的「六、還沒做」已全部過期(社群分類 bug 已於 commit09088de修掉; Figma / GIF 進度見ROADMAP.md)。第四項(設計決策)、第五項(設計參考檔)、第七項(build/adb 雷點) 仍然有效,其餘僅供追溯。
LINE Notify+:NotificationListenerService 攔截 LINE 通知,重組成「堆疊 / 對話串」通知,支援快速回覆、雙開區分、通話守門。Kotlin + Jetpack Compose + Material3。只用 2 個權限(BIND_NOTIFICATION_LISTENER_SERVICE + POST_NOTIFICATIONS),無網路。
- 能跑:debug build 正常,已裝在測試機(Nothing A059P,serial
001701527000969)。 - branch:
fix/notification-behavior,工作區有大量未 commit 變更(建議先 commit 一個乾淨基準再接手)。 - versionCode = 11(鐵則:不可重用;要上架再 bump)。
- 首頁:管理個別聊天室=外框按鈕;官方帳號+開啟權限=綠色主要按鈕;頂列加 logo + 標題;移除「已讀後清除」開關(改永遠開啟);「回覆後清除通知」改名+新文案。
- 進階功能(灰色摺疊):通知風格、回覆後清除 各加 ⓘ → 說明對話框(GIF 目前是 placeholder 文字)。
- 聊天室:移除刪除鍵;分類改 全部/好友/群組/社群(個人→好友);加 🔍 搜尋 + ⓘ 說明 popup(含「🔒 我們如何處理你的資料」隱私超連結)+ 長按多選(✕/已選N/全選/啟用/停用)。
- 教學與 FAQ:名稱統一;介紹改「LINE Notify+ 是什麼」(無破折號);移除「通知風格說明」卡;FAQ 改可展開,加 小米/OPPO/vivo/三星/華為 後台常駐教學。
- 關於:更新紀錄卡改白底(不再灰)。
- 通話守門:來電/通話中/未接 通知 直接放行不處理(不存清單、不堆疊、不取消)— 已實機驗證。
- 導航 = B 模型(乾淨首頁 + 推送子頁),不走底部 Tabs(功能量還不夠;等「許願池/訊息搜尋」變大再升級)。
- 配色 = 混合:主要按鈕/關鍵強調鎖品牌綠
Green40 (#06C755);其餘元素跟系統動態取色(Material You)。⚠️ 實機主色會依手機桌布變(這台是藍灰)—— 不是 bug。 - 元件命名:一律用
design/COMPONENTS.md的名稱(主要按鈕/外框按鈕/文字按鈕/圖示按鈕、開關/單選鈕/篩選標籤/下拉選單、狀態卡/白卡/灰卡、開關列/導航列/單選列/聊天室列…)。 - 刪除功能:已移除(用每列開關停用即可)。已讀後清除:固定永遠開啟(不給開關)。
COMPONENTS.md/COMPONENTS.html/components-visual.png— 元件目錄(含實機截圖 + 品牌綠對照)STRUCTURE-template.md(user 已填)/nav-diagram.png— 結構樹 + Mermaid 導航圖preview-b.html/preview-b.png— B 模型預覽real_home_v2.png/r2_advanced.png/r2_chat.png/r2_help.png/real_about_v2.png— 現況實機截圖(可當 Figma 起稿底圖)../play-store-assets/play-store-icon-512.png— App icon(Figma logo 用)
社群分類 bug→ 已修,commit09088de(改用line.square.notification旗標判社群)。- GIF 示範:進階 ⓘ 目前是 placeholder。用
adb screenrecord錄實機 → ffmpeg 轉 GIF → 放進對話框。(仍未做,見ROADMAP.md) - Figma 視覺定稿:user 會在 Figma 排版,排好匯出 PNG 給你照著實作。
- build(Windows 路徑含空格,直接跑
gradlew.bat會炸):set JAVA_HOME=C:\Program Files\Android\Android Studio\jbr然後java -cp gradle\wrapper\gradle-wrapper.jar org.gradle.wrapper.GradleWrapperMain assembleDebug - adb:
C:\Users\stans\AppData\Local\Android\Sdk\platform-tools\adb.exe,測試機001701527000969 - install -r 後一定要 rebind listener(否則訊息不會跳):
cmd notification disallow_listener <COMP>再allow_listener <COMP>COMP =com.stanslab.linenotify/com.stanslab.linenotify.service.LineNotificationListener - 行為類改動一定要實機驗證:只看
BUILD SUCCESSFUL會被騙 —— 這次就踩過painterResource(R.mipmap.ic_launcher)一啟動就 crash(adaptive icon 載不動)。
- 鐵則看
AGENTS.md:versionCode 不可重用、只准 2 權限、別加無障礙/網路、別碰 keystore、R8 關著、在 branch 上做。 - Compose BOM 2024.12.01 / material3 1.3.1:用穩定 API。
painterResource不能載 adaptive icon(<adaptive-icon>XML);要 VectorDrawable 或 PNG/JPG/WEBP。logo 已改用res/drawable-nodpi/app_logo.png。- 主要按鈕鎖綠:
import com.stanslab.linenotify.ui.theme.Green40,用ButtonDefaults.buttonColors(containerColor = Green40, contentColor = Color.White)。