不再把開發用 template 塞進使用者資料夾;上游錯誤不再被退避訊息吞掉

## leo 三條裁決,逐條落實
① 「**別人的錯誤一律要顯示給用戶看,不然就會變成我的錯誤,導致客服**」
   → manifest entry 新增 `LastError`(存**原文**),退避訊息改成
     「上次失敗(第 N 次),58m 後重試|**原因:**<上游原文>」。
     成功後清空,不留舊錯誤嚇人。
     測試 `TestUpstreamErrorSurvivesBackoff` 從上游錯誤字串出發,
     驗它活到給使用者看的那句話;反向驗證拿掉即紅。

② 「**拿來開發一般人用不到的根本別安裝**」
   → daemon 不再代裝 system-dev template(`CLAUDE.md`/`scripts/`/`system-dev/`,37 檔)。
     兩層傷害:把人家資料夾弄亂 + 那些檔被當知識吃進去
     ⇒ 知識庫長出 `kb`/`t195-watch` 這種不是使用者內容的庫(leo 實撞)。
     `template-install` 子命令保留,開發者情境不受影響。

③ 「**它也不能只看隱藏檔內,因為 template 在我所有的 repo 裡不是隱藏的**」
   → 排除規則用**路徑身分**(`TemplateOwns()`,來源是內嵌 templatefs 的實際路徑
     + `system-dev/`・`scripts/` 目錄前綴),**不是**「有沒有以點開頭」。
     測試刻意把 template 檔放成**不隱藏**(就像 leo 的 repo),驗它仍被排除;反向驗證即紅。
     這些檔也不計進「有 N 個檔案沒有被整理」——那欄是給使用者看他自己的檔案的。

## 順帶修 leo 截圖上的重複
「有 2 個檔案沒有被整理」底下 `scripts/sdd-active-check.sh` 出現兩次
——多帳號時同一個資料夾被掃多輪、每輪都 append。已去重。

## 殘項(誠實)
App 端失敗卡還沒接上這條線 ⇒ **畫面尚未真的顯示原因**。未打包、未送達。
This commit is contained in:
2026-08-06 21:33:37 +08:00
parent 6e0b65a2bb
commit c7675a10a0
7 changed files with 217 additions and 26 deletions
+60
View File
@@ -0,0 +1,60 @@
package collector
import (
"os"
"path/filepath"
"testing"
)
// TestTemplateFilesAreNotKnowledge 釘住 leo 2026-08-06 的兩條裁決:
//
// ①「拿來開發一般人用不到的**根本別安裝**」
// ②「它也不能只看隱藏檔內,因為 **template 在我所有的 repo 裡不是隱藏的**」
//
// 事故:daemon 把 system-dev templateCLAUDE.mdscripts/system-dev/37 檔)
// 代裝進使用者的文件資料夾,然後又把它們當知識吃進去
// ⇒ 知識庫長出 `kb``t195-watch` 這種不是使用者內容的庫(leo 實撞)。
//
// 這支測試刻意把 template 檔**放成不隱藏**(就像 leo 的 repo),驗它仍被排除。
func TestTemplateFilesAreNotKnowledge(t *testing.T) {
root := t.TempDir()
write := func(rel, body string) {
p := filepath.Join(root, filepath.FromSlash(rel))
if err := os.MkdirAll(filepath.Dir(p), 0o755); err != nil {
t.Fatal(err)
}
if err := os.WriteFile(p, []byte(body), 0o644); err != nil {
t.Fatal(err)
}
}
// template 的東西(**沒有隱藏**
write("CLAUDE.md", "開發用設定")
write("scripts/sdd-active-check.sh", "#!/bin/sh")
write("system-dev/wiki/status.md", "開發用 wiki")
// 使用者真正的內容
write("我的筆記.md", "這是我要搜尋的東西")
m := &Manifest{Entries: map[string]*ManifestEntry{}}
res, err := Scan(root, m, ScanOptions{})
if err != nil {
t.Fatalf("掃描失敗:%v", err)
}
got := map[string]bool{}
for _, e := range res.Events {
got[e.Path] = true
}
if !got["我的筆記.md"] {
t.Error("使用者自己的檔案不見了——排除規則太寬")
}
for _, dev := range []string{"CLAUDE.md", "scripts/sdd-active-check.sh", "system-dev/wiki/status.md"} {
if got[dev] {
t.Errorf("%s 是 template 的開發用檔,不該被當成使用者知識", dev)
}
}
// 也不該計進「有 N 個檔案沒有被整理」——那欄是給使用者看他自己的檔案的
if res.SkippedOther > 0 {
t.Errorf("template 檔不該計進『沒被整理』(會佔用使用者的注意力),實得 %d:%v",
res.SkippedOther, res.SkippedOtherNames)
}
}