diff --git a/cloud_latest.go b/cloud_latest.go new file mode 100644 index 0000000..5f72e84 --- /dev/null +++ b/cloud_latest.go @@ -0,0 +1,105 @@ +// cloud_latest.go — t215（2026-08-08）「每個知識庫要不要更新」的全域比較基準。 +// +// leo 原話：「在每個知識庫上顯示是否要更新，如果要，加開啓 install 頁的連結」。 +// 一個使用者可能連著不只一個雲端知識庫（帳號），每個帳號各自的雲端版本可能不同步—— +// 之前只有 t150 那套「小幫手自己」的更新提示，雲端側完全沒有對應的畫面。 +// +// 🔴 判準**必須跟 portal 設定頁那張版本卡一致**（不能自己另立一套，見驗收要求）： +// `console-ui/public/portal/index.html` 的 `loadVersion()` 拿自己的 `bundle_version` +// （cypher `/health`）比對 `install.arcrun.dev/api/latest` 的 `release` 欄位， +// 用逐段整數比較（不是字串比較），非 semver 格式一律視為落後。 +// 這裡原樣照抄同一個比法與同一個資料源，**不是**沿用 cloud_version.go 的 +// `cloudVersionStale`——那支比的是 `minCloudRelease`（協定相容底線，「太舊會壞掉」）， +// 跟這裡要回答的「有沒有更新版可以裝」是兩個不同的問題，兩把尺不能混用， +// 否則同一個知識庫會在小幫手與 portal 兩處得到相反答案。 +package collector + +import ( + "encoding/json" + "io" + "net/http" + "strings" + "sync" + "time" +) + +const installLatestURL = "https://install.arcrun.dev/api/latest" + +// latestCacheTTL：install.arcrun.dev 自己在 CF edge 快取 5 分鐘（landing/worker.js +// 同一顆端點的既有用法），daemon 端沒必要比它更頻繁去打；同步輪詢間隔常常只有十幾秒， +// 若不節流，每個帳號每輪都會外打一次全域端點＝不必要的高頻請求。30 分鐘一輪已經足夠 +// 讓使用者在「新版剛發佈」後半小時內看到提示。 +const latestCacheTTL = 30 * time.Minute + +var ( + latestMu sync.Mutex + latestCached string + latestCachedOK bool + latestFetched time.Time +) + +// fetchLatestCloudReleaseRaw 可在測試中替換為 stub（同 fetchCloudVersion 慣例）。 +var fetchLatestCloudReleaseRaw = func() (string, bool) { + client := &http.Client{Timeout: 5 * time.Second} + resp, err := client.Get(installLatestURL) + if err != nil { + return "", false + } + defer resp.Body.Close() + var payload struct { + Release string `json:"release"` + } + if err := json.NewDecoder(io.LimitReader(resp.Body, 4096)).Decode(&payload); err != nil { + return "", false + } + if strings.TrimSpace(payload.Release) == "" { + return "", false + } + return payload.Release, true +} + +// FetchLatestCloudRelease 回傳目前已知的「雲端最新版」，內建節流（見 latestCacheTTL）。 +// 節流窗內回快取值（含失敗快取＝ok=false）；窗口過了才真的重打一次。 +// 這是**全域單一值**（不分帳號）——所有知識庫比的是同一個「目前最新版是什麼」。 +func FetchLatestCloudRelease() (release string, ok bool) { + latestMu.Lock() + if time.Since(latestFetched) < latestCacheTTL { + release, ok = latestCached, latestCachedOK + latestMu.Unlock() + return + } + latestMu.Unlock() + + release, ok = fetchLatestCloudReleaseRaw() + + latestMu.Lock() + latestCached, latestCachedOK, latestFetched = release, ok, time.Now() + latestMu.Unlock() + return +} + +// CloudUpdateStatus 是「這個知識庫要不要更新」的判定結果。 +// Known=false 時前端要照實講「查不到」，不能當成「已是最新」—— +// 靜默把「不知道」呈現成「一切正常」正是 cloud_version.go 開頭記過的那個坑。 +type CloudUpdateStatus struct { + Known bool // 兩邊版本都拿得到才能下判斷 + NeedsUpdate bool // Known 且落後 + Mine string // 這個帳號目前的 bundle_version（可能是空字串或舊格式） + Latest string // 已知的最新版（可能是空字串＝暫時查不到） +} + +// EvalCloudUpdate 比較單一帳號的 bundle_version 與全域最新版。 +// 與 portal 版本卡 loadVersion() 的 cmpSemver 同一套邏輯： +// - mine 拿不到、或 latest 拿不到 → Known=false（誠實說「查不到」） +// - mine 不是 semver 格式（老實例的 YYYY-MM-DD+sha）→ 一律當落後 +// （新版才會寫 semver 進來，portal 端註解原話同此） +// - 兩邊都是 semver → 逐段整數比較，mine < latest 才算落後 +func EvalCloudUpdate(mine string, mineOK bool, latest string, latestOK bool) CloudUpdateStatus { + mine = strings.TrimSpace(mine) + latest = strings.TrimSpace(latest) + if !mineOK || mine == "" || !latestOK || latest == "" { + return CloudUpdateStatus{Known: false, Mine: mine, Latest: latest} + } + behind := !isSemverLike(mine) || compareSemver(mine, latest) < 0 + return CloudUpdateStatus{Known: true, NeedsUpdate: behind, Mine: mine, Latest: latest} +} diff --git a/cloud_latest_test.go b/cloud_latest_test.go new file mode 100644 index 0000000..4a9160d --- /dev/null +++ b/cloud_latest_test.go @@ -0,0 +1,84 @@ +// cloud_latest_test.go — t215 單元測試：EvalCloudUpdate 的判準要跟 portal 版本卡一致。 +package collector + +import "testing" + +func TestEvalCloudUpdate(t *testing.T) { + cases := []struct { + name string + mine string + mineOK bool + latest string + latestOK bool + wantKnown bool + wantUpdate bool + }{ + { + name: "兩邊都拿得到、mine 落後", mine: "1.4.1", mineOK: true, latest: "1.4.2", latestOK: true, + wantKnown: true, wantUpdate: true, + }, + { + name: "兩邊都拿得到、已是最新", mine: "1.4.2", mineOK: true, latest: "1.4.2", latestOK: true, + wantKnown: true, wantUpdate: false, + }, + { + // 字串比較會誤判 "1.10.0" < "1.9.0"；逐段整數比較才對（同 t103 迴歸守衛）。 + name: "1.10.0 比 1.9.0 新，不該判落後", mine: "1.10.0", mineOK: true, latest: "1.9.0", latestOK: true, + wantKnown: true, wantUpdate: false, + }, + { + // 老格式（YYYY-MM-DD+sha）——portal 版本卡註解原話：「這種情況一律當成落後」。 + name: "老格式版本一律當落後", mine: "2026-07-31+8e83589", mineOK: true, latest: "1.4.2", latestOK: true, + wantKnown: true, wantUpdate: true, + }, + { + name: "連不上這個知識庫（mineOK=false）→ 查不到，不能裝沒事", mine: "", mineOK: false, latest: "1.4.2", latestOK: true, + wantKnown: false, wantUpdate: false, + }, + { + name: "查得到 mine 但暫時查不到最新版 → 查不到，不是已最新", mine: "1.4.2", mineOK: true, latest: "", latestOK: false, + wantKnown: false, wantUpdate: false, + }, + { + name: "/health 可達但 bundle_version 空字串（老實例）→ 查不到", mine: "", mineOK: true, latest: "1.4.2", latestOK: true, + wantKnown: false, wantUpdate: false, + }, + } + for _, tc := range cases { + t.Run(tc.name, func(t *testing.T) { + got := EvalCloudUpdate(tc.mine, tc.mineOK, tc.latest, tc.latestOK) + if got.Known != tc.wantKnown { + t.Errorf("Known = %v，want %v", got.Known, tc.wantKnown) + } + if got.NeedsUpdate != tc.wantUpdate { + t.Errorf("NeedsUpdate = %v，want %v", got.NeedsUpdate, tc.wantUpdate) + } + }) + } +} + +// TestFetchLatestCloudReleaseThrottle 驗證節流：窗口內第二次呼叫不重打 fetchLatestCloudReleaseRaw。 +func TestFetchLatestCloudReleaseThrottle(t *testing.T) { + calls := 0 + orig := fetchLatestCloudReleaseRaw + defer func() { + fetchLatestCloudReleaseRaw = orig + latestMu.Lock() + latestCached, latestCachedOK, latestFetched = "", false, latestFetched.Add(-2*latestCacheTTL) + latestMu.Unlock() + }() + fetchLatestCloudReleaseRaw = func() (string, bool) { calls++; return "1.4.2", true } + // 強制第一次一定重打（避開其他測試留下的快取）。 + latestMu.Lock() + latestFetched = latestFetched.Add(-2 * latestCacheTTL) + latestMu.Unlock() + + r1, ok1 := FetchLatestCloudRelease() + r2, ok2 := FetchLatestCloudRelease() + if calls != 1 { + t.Errorf("節流窗口內第二次呼叫不該重打，calls = %d", calls) + } + if r1 != "1.4.2" || !ok1 || r2 != "1.4.2" || !ok2 { + t.Errorf("兩次結果應相同，got (%q,%v) (%q,%v)", r1, ok1, r2, ok2) + } +} diff --git a/cloud_version_test.go b/cloud_version_test.go index 6d30922..e19ac67 100644 --- a/cloud_version_test.go +++ b/cloud_version_test.go @@ -11,6 +11,9 @@ import ( // TestCloudVersionStale 直接測 cloudVersionStale 邏輯，不受此 stub 影響。 func TestMain(m *testing.M) { fetchCloudVersion = func(string) (string, bool) { return "", false } + // t215：同一個理由——避免 EvalCloudUpdate 相關測試因為真的打了 + // install.arcrun.dev 而變成看網路臉色的測試。 + fetchLatestCloudReleaseRaw = func() (string, bool) { return "", false } os.Exit(m.Run()) } diff --git a/cmd/arcrun-app/app.go b/cmd/arcrun-app/app.go index d452e43..3612711 100644 --- a/cmd/arcrun-app/app.go +++ b/cmd/arcrun-app/app.go @@ -96,6 +96,11 @@ type syncStatus struct { // 不重新定義結構，避免兩邊的欄位定義漂移。 Progress collector.SyncProgress `json:"progress"` FailureBreakdown collector.FailureBreakdown `json:"failure_breakdown"` + // t215（2026-08-08）：per-account 雲端版本狀態——collector.AccountSyncStatus 已經是 + // GetState 要的形狀（含 t215 新欄位 CloudUpdateKnown/CloudUpdateStale/CloudLatest）， + // 直接原樣接住，不重新定義一份會漂移的結構。key = instanceHostOf(cypher_url) + // （與 UIAccount.Host 同一套算法，見 shortHost）。 + AccountDetails map[string]collector.AccountSyncStatus `json:"account_details,omitempty"` } type skippedDoc struct { @@ -219,6 +224,15 @@ type UIAccount struct { Name string `json:"name"` Host string `json:"host"` Folders []UIFolder `json:"folders"` + // t215（2026-08-08，leo：「在每個知識庫上顯示是否要更新，如果要，加開啓 install 頁的 + // 連結」）——一個使用者可能連著不只一個知識庫，之前只有小幫手自己的版本會提示更新， + // 每個知識庫各自的雲端版本完全沒有畫面。判準與 portal 版本卡同一套 + // （collector.EvalCloudUpdate，不是 t103 的相容底線），這裡只翻成人話，不重新判斷。 + CloudVerKnown bool `json:"cloudVerKnown"` // false＝查不到（連不上／還沒查過），前端要老實說「查不到」 + CloudVerStale bool `json:"cloudVerStale"` // true＝有新版可更新 + CloudVerMine string `json:"cloudVerMine,omitempty"` // 這個知識庫目前的版本（可能連 Known=false 時也有值） + CloudVerLatest string `json:"cloudVerLatest,omitempty"` // 已知的最新版 + Email string `json:"email,omitempty"` // 供「前往安裝頁更新」預填帳號（同 portal 版本卡的做法） } type UIState struct { Version string `json:"version"` @@ -415,11 +429,20 @@ func (a *App) GetState() UIState { } } + sync := loadSyncStatus() for i, acc := range cfg.Accounts { - ui := UIAccount{Name: accountName(acc), Host: shortHost(acc.CypherURL)} + ui := UIAccount{Name: accountName(acc), Host: shortHost(acc.CypherURL), Email: acc.Email} for _, f := range acc.WatchFolders { ui.Folders = append(ui.Folders, UIFolder{Path: f, AccIdx: i}) } + // t215：per-account 雲端版本狀態——key 與 Host 同一套算法（shortHost）， + // 對應 collector 寫入 status.json 時用的 instanceHostOf（兩者對一般 https URL 同值）。 + if accSt, ok := sync.AccountDetails[ui.Host]; ok { + ui.CloudVerKnown = accSt.CloudUpdateKnown + ui.CloudVerStale = accSt.CloudUpdateStale + ui.CloudVerMine = accSt.CloudVersion + ui.CloudVerLatest = accSt.CloudLatest + } st.Accounts = append(st.Accounts, ui) } @@ -431,7 +454,6 @@ func (a *App) GetState() UIState { st.GeminiKey = "••••••••" } - sync := loadSyncStatus() st.Syncing, st.StatusBig, st.StatusSub = describeStatus(sync) st.Steps = buildSteps(sync, st.Syncing) st.Skipped = buildSkipped(sync) diff --git a/cmd/arcrun-app/frontend/src/main.js b/cmd/arcrun-app/frontend/src/main.js index b8a9a8c..8f83e31 100644 --- a/cmd/arcrun-app/frontend/src/main.js +++ b/cmd/arcrun-app/frontend/src/main.js @@ -37,6 +37,16 @@ $('overlay').addEventListener('click', (e) => { if (e.target.id === 'overlay') c document.addEventListener('keydown', (e) => { if (e.key === 'Escape') closeSheet(); }); // ── 側邊欄：每個知識庫一項（leo：「每個帳號有獨立的一個頁面」）── +// +// t215（2026-08-08，leo：「在每個知識庫上顯示是否要更新」）：落後的庫名旁加一顆 +// 警示點，逛清單時不用點進每個庫就能一眼看出哪個落後（完整說明＋更新按鈕在 +// 首頁 cardKbVersions 與各庫頁 kbVersionLine）。 +// +// 🔴 頂層 status.md 08-08 深夜記過一個**待 leo confirm、尚未定案**的提案： +// 「單一更新入口（版本白癡化）」——把小幫手自我更新與雲端知識庫更新合併成一顆按鈕。 +// 那個提案沒有否定「每庫獨立列出落後狀態」這件事本身（它本來就要「點進去才看細節」）， +// 只是問「總覽要不要合併」。這裡先實作 leo 這次明確要的「每庫看得到＋連得到」， +// 之後若那個提案 confirm，是在這層之上疊總覽 pill，不是重做這裡。 function renderNav() { const accs = (state && state.accounts) || []; $('nav').innerHTML = ` @@ -45,6 +55,7 @@ function renderNav() { ${accs.map((a, i) => `
▤${esc(a.name)} + ${a.cloudVerStale ? `` : ''} ${(a.folders || []).length}
`).join('')}
設定
@@ -75,6 +86,7 @@ function pageHome(s) { ${cardTrouble(s)} ${cardProgress(s.progress)} ${cardSkipped(s.skipped)} + ${cardKbVersions(s)}

總計

@@ -84,6 +96,60 @@ function pageHome(s) {
`; } +// t215（2026-08-08，leo：「在每個知識庫上顯示是否要更新，如果要，加開啓 install 頁的 +// 連結」）——一個使用者可能連著不只一個知識庫（leo 自己就是），各自雲端版本不同步時， +// 以前完全看不出「哪一個」落後、也沒有地方按。這張卡讓使用者不必逐個庫點進去， +// 首頁一眼看完全部知識庫的版本狀態。 +// +// 判準**不在這裡重新發明**：後端 collector.EvalCloudUpdate 與 portal 設定頁那張版本卡 +// （console-ui/public/portal/index.html 的 loadVersion()）同一套比法——自己的 +// bundle_version 比 install.arcrun.dev/api/latest 的 release，兩邊都是 semver 才逐段 +// 整數比較，非 semver（老格式）一律視為落後。前端只負責把後端已經算好的 +// cloudVerKnown/cloudVerStale 翻成人話，不做任何版本比較。 +function cardKbVersions(s) { + const accs = s.accounts || []; + if (!accs.length) return ''; + return ` +
+

知識庫版本

+
+ ${accs.map((a) => ` +
+ ${esc(a.name)} + ${kbVersionLine(a)} +
`).join('')} +
+
`; +} + +// kbVersionLine：單一知識庫的版本判定文案，首頁卡與各庫頁共用同一份翻譯， +// 不讓兩處各寫各的文字（那樣才真的會出現「兩處講不同的話」）。 +// +// 三種情況都要照實講（cloud_version.go 記過的坑：把「查不到」呈現成「一切正常」）： +// ① Known 且落後 → 紅字＋按鈕，按下去帶 email 開 install 頁（同 portal 版本卡的預填做法） +// ② Known 且已最新 → 淡字「已是最新版」 +// ③ 不 Known → 照原因分兩句：連不上這個知識庫／查得到目前版本但暫時查不到最新版 +function kbVersionLine(a) { + if (!a.cloudVerKnown) { + const detail = a.cloudVerMine + ? `已知版本 ${esc(a.cloudVerMine)}，暫時查不到最新版本（稍後會自動再查）` + : '目前連不上這個知識庫，查不到版本'; + return `${detail}`; + } + if (a.cloudVerStale) { + return `有新版可更新（目前 ${esc(a.cloudVerMine)} → 最新 ${esc(a.cloudVerLatest)}） + `; + } + return `已是最新版（${esc(a.cloudVerMine)}）`; +} + +// installURLFor：與 portal 版本卡同一個做法——落後才需要按，按下去帶 email 讓安裝頁 +// 預填，既有實例更新免辨識碼（安裝器 t154），不必讓使用者自己去 install.arcrun.dev 找。 +function installURLFor(email) { + const base = 'https://install.arcrun.dev/'; + return email ? base + '?email=' + encodeURIComponent(email) : base; +} + // 🔴 G-6.2「不准安靜地略過」（2026-08-06）——J-1/S6 考題的後半句： // 「Then 我一樣找得到——**或當場被告知這種檔案還不支援**」 // 以前 .doc／.pages 這類檔在 collector 掃描時就被丟掉，畫面上一個字都沒有， @@ -172,6 +238,7 @@ function pageLib(s, idx) {
+
${kbVersionLine(a)}
${(a.folders || []).map((f) => `
${esc(f.path)} @@ -291,6 +358,9 @@ function wire() { on('uDiag', exportDiagnostics); document.querySelectorAll('[data-portal]').forEach((b) => { b.onclick = () => go.OpenURL(b.dataset.portal); }); document.querySelectorAll('[data-openurl]').forEach((b) => { b.onclick = () => go.OpenURL(b.dataset.openurl); }); + document.querySelectorAll('[data-updatekb]').forEach((b) => { + b.onclick = () => go.OpenURL(installURLFor(b.dataset.updatekb)); + }); document.querySelectorAll('[data-addto]').forEach((b) => { b.onclick = () => addFolder(Number(b.dataset.addto)); }); document.querySelectorAll('[data-rm]').forEach((b) => { b.onclick = () => confirmRemove(Number(b.dataset.acc), b.dataset.rm); diff --git a/cmd/arcrun-app/frontend/src/style.css b/cmd/arcrun-app/frontend/src/style.css index 7425792..1c0dcbb 100644 --- a/cmd/arcrun-app/frontend/src/style.css +++ b/cmd/arcrun-app/frontend/src/style.css @@ -247,3 +247,21 @@ input[type=text], input[type=password] { } .breaklist li:first-child { border-top: 0; } .breaklist li span:last-child { color: rgba(var(--ink-rgb), .55); white-space: nowrap; } + +/* t215（2026-08-08，leo：「在每個知識庫上顯示是否要更新」）——首頁「知識庫版本」卡、 + 各庫頁版本列、側邊欄警示點，三處共用同一組顏色：落後＝--err（同 .err 那個紅）， + 不是額外發明一個「警告色」。 */ +.kblist { display: flex; flex-direction: column; gap: 2px; margin-top: 10px; } +.kbrow { + display: flex; align-items: center; justify-content: space-between; gap: 12px; + padding: 9px 0; border-top: 1px solid rgba(var(--ink-rgb), .08); +} +.kbrow:first-child { border-top: 0; } +.kbrow .nm { font-size: 14px; font-weight: 600; flex: none; } +.kbrow .right { display: flex; align-items: center; gap: 10px; font-size: 13px; } +.kbver { margin-bottom: 14px; font-size: 13.5px; display: flex; align-items: center; gap: 10px; } +.warn { color: var(--err); font-size: 13px; } +#side .nav .dot.warn { + width: 7px; height: 7px; border-radius: 50%; flex: none; + background: var(--err); margin-left: 4px; +} diff --git a/direct.go b/direct.go index 1ffd891..2354300 100644 --- a/direct.go +++ b/direct.go @@ -582,6 +582,10 @@ func RunDirectOnce(cfg *DirectConfig, dryRun bool) ([]DirectResult, int, *Trigge var totalProgress SyncProgress var stuckReasons []string + // t215：全域「雲端最新版」只抓一次（自帶節流，見 cloud_latest.go）—— + // 這是所有帳號共用的同一把尺，不是逐帳號各打一次。 + latestRelease, latestOK := FetchLatestCloudRelease() + accountDetails := map[string]AccountSyncStatus{} for _, acc := range accounts { if acc.CypherURL == "" || acc.Namespace == "" { @@ -592,10 +596,15 @@ func RunDirectOnce(cfg *DirectConfig, dryRun bool) ([]DirectResult, int, *Trigge // t103：per-account 雲端版本偵測 cloudVer, cloudOK := fetchCloudVersion(accCfg.CypherURL) + // t215：這個帳號要不要更新——與 portal 版本卡同一套判準（見檔頭）。 + cloudUpd := EvalCloudUpdate(cloudVer, cloudOK, latestRelease, latestOK) accSt := AccountSyncStatus{ - LastSync: time.Now().Format(time.RFC3339), - CloudVersion: cloudVer, - CloudCheckOK: cloudOK, + LastSync: time.Now().Format(time.RFC3339), + CloudVersion: cloudVer, + CloudCheckOK: cloudOK, + CloudUpdateKnown: cloudUpd.Known, + CloudUpdateStale: cloudUpd.NeedsUpdate, + CloudLatest: cloudUpd.Latest, } // 🔴 t182（leo 08-04）：「會去**掃一次**看雲端是否裝好，**沒裝好就顯示 workers AI diff --git a/sync_status.go b/sync_status.go index dde29f0..22b92ff 100644 --- a/sync_status.go +++ b/sync_status.go @@ -11,11 +11,18 @@ import ( // AccountSyncStatus 彙總單一帳號的每輪同步結果（t104 多帳號看守）。 // key in SyncStatus.AccountDetails = instanceHostOf(cypher_url)。 type AccountSyncStatus struct { - LastSync string `json:"last_sync,omitempty"` - CloudVersion string `json:"cloud_version,omitempty"` // t103 per-account - CloudCheckOK bool `json:"cloud_check_ok"` - ExtractedOK int `json:"extracted_ok"` - ExtractFailed int `json:"extract_failed"` + LastSync string `json:"last_sync,omitempty"` + CloudVersion string `json:"cloud_version,omitempty"` // t103 per-account + CloudCheckOK bool `json:"cloud_check_ok"` + // t215（2026-08-08，leo：「在每個知識庫上顯示是否要更新」）：這個帳號的雲端知識庫 + // 有沒有新版可以裝——與 portal 版本卡同一套判準（EvalCloudUpdate，cloud_latest.go）， + // **不是**上面 CloudVersion/CloudCheckOK 搭配 t103 cloudVersionStale 那把尺 + // （那把量的是「太舊會不相容」的協定底線，這裡量的是「有沒有更新版可以裝」）。 + CloudUpdateKnown bool `json:"cloud_update_known"` + CloudUpdateStale bool `json:"cloud_update_stale"` + CloudLatest string `json:"cloud_latest,omitempty"` // 已知的最新版（供畫面顯示「最新版 x.y.z」） + ExtractedOK int `json:"extracted_ok"` + ExtractFailed int `json:"extract_failed"` // t182（leo 08-04：「沒裝好就顯示 workers AI 還沒通，一旦通了就顯示可用」）： // 這個帳號的雲端實例有沒有 /portal/daemon/extract。**逐帳號**各自記—— // 用戶可能有多個實例、更新進度不同步。只在走 workers-ai 這條路時探測。