Repository navigation
從 0.4.1 升級(0.4.2-rc1 是演練發版流程的預發佈,程式與 0.4.1 相同):docker compose pull && docker compose up -d
就好;docker-compose.yml 與 .env 沒有變。image 是 ghcr.io/1morr/berth:0.5.0,同時是 :0.5 與 :latest——固定在
:0.4 的不會自動升到這一版,要把 berth 的 image 改成 :0.5。下面改到的 API 只有 Berth 自己的畫面在用,升級之後
重新整理一次頁面即可。這一版有兩個資料庫 migration(Berth 啟動時自動依序套用一次,各自寫在下面那一條;都只加
可以留空的欄位,舊資料不改);升級前備份一次 ${CONFIG_ROOT}/berth。
升級後第一次啟動要知道的:
- 審核佇列會自動重算一次:停在審核、由舊版本規則算出的計劃(例如被「早於播出日」擋下的地上波先行集數),啟動後在
背景照新規則重算,放行的自己入庫;你逐列改過的與撤銷回來的不動。之後同一版重啟不再重算。 - 第一次每日巡檢(05:00)可能開出「遲到」:訂閱的作品最後入庫的一集之後,有集播出過了門檻(預設 2 天,從播出日
隔天起算)還沒入庫時,待處理會多一件;最後一集缺集播出滿 60 天的不提醒,收在追更頁的「斷更很久」。門檻在訂閱頁改。 - 推理程度預設「中」:設定 → AI 沒動過的,升級後讀回來是「中」。Anthropic 接口上的 DeepSeek 與支援推理程度的
Claude 會照它送(DeepSeek 的「中」等於「高」),之前什麼都不送;要省 token 或你的服務不收這個參數,到設定 → AI
改成「低」或「關」。OpenAI 相容接口上 Berth 認不得的模型照舊不送。
這一版是 M5.5「新番與導覽」:頁首收成五項,多了新番時間表與追更頁,訂閱的作品晚了會開 Issue;審核佇列裡被誤擋的地上波
先行集數與累計編號的第一批不再等人,這些都不需要 AI;助理面板修了模型清單、搜尋結果、推理與對話清單。
Added
- 訂閱的作品遲到提醒:每天 05:00 的巡檢看訂閱的作品(綁好的 RSS Series,或從作品頁預先綁定、一集都還沒收到的
Feed),最後入庫的一集之後播出滿門檻還沒入庫的集,開一件「遲到」到待處理,一部作品一件,列出晚的集與卡在哪
(字幕組沒發、送單失敗、下載停滯、入庫失敗),連到作品頁與卡住的下載;下載還在跑、等審核或已經有 Issue 管著的
不開,都入庫之後自己收掉。門檻預設 2 天,在訂閱頁改(新的
GET/PUT /api/rss/overdue,只有管理員)。上一集與這一集隔了三週以上時說「可能是下一輪」(多半是 Mikan 上另一個
番組,要另外訂);最後一集缺集播出滿 60 天就不再提醒;刪掉訂閱之後不再提醒。每個字幕組可以在訂閱頁的「進階」各設門檻
(新的PUT /api/rss/series/{id}/overdue,只有管理員;migratione5a2c8f4b931在rss_series加可留空的
overdue_days,留空用全域),一部作品訂了幾組時取最大的。巡檢前先向 TMDB 更新訂閱作品的
集數表,剛播出的那一集看得到;更新失敗的那部作品那一天不開也不收。Discord 的「有 N 件等你處理」與「等了 N 天」
遇到遲到時,內文一部一行寫出作品名與晚的集(例如「葬送的芙莉蓮 S02E05–E06」),可能是下一輪的照實說,最多列五部、
其餘寫「等 N 部」;英文的私訊用英文片名。 - 新番時間表(
/schedule):這一週 TMDB 上播的日本與中國動畫,週一到週日分欄、今天標出,手機上一次看一天;每張卡寫
第幾集與狀態(已訂閱、已入庫),點進作品頁就能訂閱,可切「只看已訂閱」。頁首的「新番」改成每個人都有、連到這裡;
「訂閱」分頁仍只有管理員。第一次打開要向 TMDB 讀這一週每一部作品,約十幾秒,之後六小時內是即時的。新的
GET /api/schedule(登入就能讀)。原文名在 AniList 對得上的卡片另寫放送時刻(只有還沒播的),在 Bangumi 對得上的
另寫評分;對不上或這兩個來源連不上時只少這兩格(GET /api/schedule的卡片多airs_at與score)。 - 追更頁(
/schedule/tracking,只有管理員):新番底下多一個「追更」分頁,訂閱的作品一部一列,寫字幕組、已播到、
已入庫到與狀態(下載停滯會說出來),晚了的寫「晚 N 天」(從播出日算)並連到卡住的下載;分「要你動手」「準時」
「斷更很久」三段,斷更很久預設收起。沒接 Discord 收不到遲到通知時,頁首說一句並連到通知設定。時間表上晚了的那一集
也寫「晚 N 天」。新的GET /api/schedule/tracking(只有管理員);GET /api/schedule的卡片多late狀態與
late_days。 - 設定 → AI 的模型清單:模型欄的建議照表單上的 Base URL 換成那一家的模型(例如填了 DeepSeek 的網址就是 DeepSeek
的模型),只查 Berth 內建的價目表、不帶 key、不連外。模型欄旁多一顆「取得模型」,按了才向填的端點問它有哪些模型;
端點不提供清單(例如 DeepSeek 的 Anthropic 接口)或問不到時退回內建的清單並說明原因,模型名仍可照打。改了 Base URL
或 key 之後,取得的清單收掉。新的GET/POST /api/settings/ai/models(只有管理員)。 - 查得到助理當時有哪些搜尋工具:側面板的
/status多一列「網路搜尋」,由 Berth 照設定直接說下一則訊息搜得到什麼
(伺服器端web_search、Tavily),不問模型;每一輪的步驟頁在每次模型呼叫下列出送出的工具,之前的呼叫寫「未記錄」
(migrationb8d4f2a6c193在ai_calls加可留空的tools_json)。
助理也被告知工具可能在兩則訊息之間變動,只看當下的清單。 - 推理程度:設定 → AI 的模型欄下面多一格「推理程度」(關、低、中、高,沒設過是中),兩種接口各記各的。DeepSeek
只分低與高,中等於高;在 Anthropic 接口上關掉就真的不推理。OpenAI 相容接口上 Berth 認不得會推理的模型(包括
DeepSeek),以及 Claude Sonnet 4.5、Haiku 4.5 這類不支援的 Claude,不送這個設定,設定頁會說沒有效果。
服務不接受這個程度時,助理停下的說明下面連到設定頁那一格(一般使用者
看到請管理員改)。/api/settings/ai每種接口多reasoning,新的GET /api/settings/ai/reasoning(只有管理員)。
Anthropic 接口上 Berth 認不得的相容閘道(DeepSeek 官方端點以外),選「關」就什麼推理參數都不送,設定頁與停下的
說明都會這樣說;低、中、高照送。GET /api/settings/ai/reasoning多收base_url、多回off_sends_nothing。 - 側面板畫出助理的推理:模型回推理文字時(例如 DeepSeek),回答上方多一格「推理」,預設收起、串流中也不展開,
展開看得到全文;重新載入之後還在。 - 助理的對話清單:側面板頁首多一顆「對話」,列出你最近 50 段對話(第一句話當標題、多久前、還在回答的標出來),
點一段切回去;輸入欄打/history是同一份清單。換一個瀏覽器或裝置打開面板時,自動接上你最近的一段對話,不再是空白;
按「新對話」之後重新整理仍是新的那一段。新的GET /api/agent/conversations(登入就能讀,只列自己的)。
Changed
- 頁首收斂成五項:探索、新番、媒體庫、下載、待處理(待處理只有管理員;新番與待處理帶件數,只有管理員看得到);
設定、健康、週報、語言與登出收進右上角的帳號選單。待處理裡審核與 Issue 是兩個分頁,原本的 RSS 頁改叫「訂閱」、
放在新番底下。所有網址不變,Discord 週報的連結照樣打得開。新的GET /api/waiting(只有管理員)回三份清單各等著幾件。 - M5.5 的介面收尾:桌面上開著側面板時,時間表改成一次一天、頁首不再折成三列;時間表選的那一天與「只看已訂閱」
記在網址,點進作品頁再回來還在。待處理的「遲到」收著就寫出哪一集、晚幾天、卡在哪,下一步照卡在哪說。設定 → AI
按「取得模型」後把端點列的模型畫成一排鍵、按一下就填進去;改了 Base URL 時 key 欄當場說存著的 key 用不上。側面板的
對話清單打開時焦點落在目前這段;英文的面板抬頭改成 Chats / New chat。沒有 TMDB 憑證時,一般使用者只被請去找管理員,
怎麼申請只對管理員說,服務的原文收進「技術細節」。 - 地上波先行的集數不再被擋在審核:字幕組從 ABEMA 這類平台先拿到片,發佈比 TMDB 的電視台播出日早幾天。季集照字面
對上的發佈,早 9 天以內照常入庫(早超過 2 天的記一條「比播出日早」的理由);早 10–14 天的停在審核、說平台先行的
核准就好,更早的叫人先查作品與 TMDB 的日期。這樣先行的字幕組,訂閱的第一批也由系統確認。季號或集號經過換算的發佈
仍只容忍 2 天,理由改叫人查季號、offset 或絕對編號。 - 寫明季號的累計編號,第一批由系統確認:例如「夜櫻家 S2 - 40」對到第二季第 13 集,前面各季集數加起來剛好對得上、
那一集剛播、下一集還沒播時,訂閱的第一批不再等人按確認。只寫集號的絕對編號與重數推測仍要人確認。 - 升級後自動重算審核佇列:啟動時,停在審核、由舊版本規則算出的計劃會在背景照新規則重算;人改過的計劃與撤銷回來的
不動,同版本重啟不重算。 - 助理的網路搜尋結果:側面板把
web_search的結果畫成標題、網址與日期的清單;每筆只給服務端用的encrypted_content
不再送到瀏覽器(串流與重新載入都是),助理下一輪的歷史照舊。
Fixed
- 改了 AI 的 Base URL 後,存著的 key 會被送到新網址:key 欄空著時,Berth 只在 Base URL 與存著的相同時才用存著的
那把(留空與填官方網址算相同)。網址改了、key 欄空著時,「取得模型」「測試連線」與儲存都會說要重填 key,什麼都不送、
不存。