<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by frozenfung on Medium]]></title>
        <description><![CDATA[Stories by frozenfung on Medium]]></description>
        <link>https://medium.com/@frozenfung?source=rss-dc66ceb35b90------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*3ChJO8Luuq1GfxBk3loJpg.jpeg</url>
            <title>Stories by frozenfung on Medium</title>
            <link>https://medium.com/@frozenfung?source=rss-dc66ceb35b90------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Tue, 17 Nov 2026 04:34:51 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@frozenfung/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[2025 書單]]></title>
            <link>https://medium.com/@frozenfung/2025-%E6%9B%B8%E5%96%AE-f2267f030595?source=rss-dc66ceb35b90------2</link>
            <guid isPermaLink="false">https://medium.com/p/f2267f030595</guid>
            <dc:creator><![CDATA[frozenfung]]></dc:creator>
            <pubDate>Wed, 31 Dec 2025 01:14:21 GMT</pubDate>
            <atom:updated>2025-12-31T01:14:21.502Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*WLXuiaTWHV018wrU" /><figcaption>Photo by <a href="https://unsplash.com/@tomhermans?utm_source=medium&amp;utm_medium=referral">Tom Hermans</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><p>今年不論是工作還是生活都有很大的轉變，有機會再來更新彼此的近況。例行公事還是要做，2025 的書單分享給大家。</p><ul><li>失落在膚色底下的歷史</li><li>現代菲律賓的誕生：一片片拼圖組成的國家</li><li>中國文化的深層結構</li><li>深度關係：一切美好都是深度關係的產物</li><li>區判</li><li>沒有不好的你: 風行全球的內在家庭系統IFS, 徹底翻轉你我的生命</li><li>顯化效應</li><li>把你的時間買回來</li><li>真相製造: 從聖戰士媽媽、極權政府、網軍教練、境外勢力、打假部隊、內容農場主人到政府小編</li><li>階級與品味︰隱藏在文化審美與流行趨勢背後的地位渴望</li><li>僧人心態: 從道場到職場, 訓練你的心, 過著平靜而有目標的每一天</li><li>超單身社會</li><li>擁抱你的內在家庭：運用IFS，重新愛你的內在人格，療癒過去受的傷</li><li>佛畏系統</li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=f2267f030595" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[AI Evals 常見問答集]]></title>
            <link>https://medium.com/@frozenfung/ai-evals-%E5%B8%B8%E8%A6%8B%E5%95%8F%E7%AD%94%E9%9B%86-e1dfe00190e6?source=rss-dc66ceb35b90------2</link>
            <guid isPermaLink="false">https://medium.com/p/e1dfe00190e6</guid>
            <category><![CDATA[retrieval-augmented-gen]]></category>
            <dc:creator><![CDATA[frozenfung]]></dc:creator>
            <pubDate>Wed, 30 Jul 2025 07:51:30 GMT</pubDate>
            <atom:updated>2025-07-30T07:51:30.091Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*mCLlHEBn1i2palqj" /><figcaption>Photo by <a href="https://unsplash.com/@growtika?utm_source=medium&amp;utm_medium=referral">Growtika</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><blockquote>本篇為錄音檔逐字稿，連結如下<br>https://soundcloud.com/hamel-husain/llm-evals-faq</blockquote><p>歡迎收聽。今天我們將一起深入探討 AI 開發中的一個關鍵主題──評估（evals）──的常見問題解答。這份指南根據 Hamel Hussain 和 Shreya Shankar 撰寫的部落格文章《關於 AI 評估的常見問答》，整理了他們在教學過程中收到來自超過 700 位工程師與產品經理的最常見提問。這些是對大多數情況有效的犀利觀點，但並非放諸四海皆準的真理，請依實際判斷採用。</p><p>在開始之前，補充一點：如果你想更深入了解這個主題，這篇文章的作者也提供一門完整的 AI 評估課程，網址是 bit.ly/evals-AI。使用這個連結即可享有 35% 的折扣。再次提醒，是 bit.ly/evals-AI。</p><p>現在，我們開始吧。首先是「入門與基本概念」這一節。</p><p><strong>第一題：什麼是 LLM 評估？</strong><br>如果你完全是新手，我們這裡指的是「產品專屬的 LLM 評估」，而不是用來測試基礎模型的通用基準。LLM 評估是一種系統性測試與改進 AI 應用品質的過程，目的是針對特定產品與使用者進行優化。</p><p><strong>第二題：什麼是 trace？</strong><br>trace 指的是從一個初始使用者查詢到最終回應的完整紀錄。這包含你系統中所有元件的每一步操作、多輪對話、AI 回應、檢索的文件，以及所有中間工具的互動。值得注意的是，不同的可觀察性（observability）平台對 trace 和 span 的定義略有不同，這也常造成混淆。</p><p><strong>第三題：最小可行的評估設定是什麼？</strong><br>重點是先做錯誤分析，不要一開始就構建複雜的基礎設施。每次系統有重大變更時，花約 30 分鐘手動檢查 20 到 50 筆 LLM 輸出，並找一位真正理解使用者的領域專家來判斷品質，這位人物有時被稱為「仁慈獨裁者」。建議使用 Jupyter notebook 來檢查 trace 與資料分析，因為你可以寫任意程式碼、視覺化數據，並快速反覆測試，甚至能在 notebook 裡建立自己的標註介面。</p><p><strong>第四題：應該分配多少開發預算給評估？</strong><br>你應該將評估視為開發流程的一部分，而不是獨立預算項目，就像 debug 一樣是不可或缺的一環。很多錯誤透過簡單的檢查（例如正規表示式）就能捕捉，幾乎沒什麼成本。如果要建立複雜的「LLM 評審者」型評估器，則需要進行成本效益分析。根據我們的經驗，60% 到 80% 的開發時間會花在錯誤分析與評估上，絕大多數努力都是為了了解失敗原因，而不是構建自動化機制。</p><p>請小心不要過度追求高通過率的評估測試。如果你通過率 100%，那可能代表你根本沒挑戰你的系統。通過率 70% 反而可能代表這是一場更有意義、能壓力測試你的應用的評估。</p><p><strong>第五題：5 到 10 年後這些評估方法還有用嗎？</strong><br>答案是肯定的。即使未來模型接近完美，你仍然需要驗證它是否在幫助使用者解決正確的問題。系統性錯誤分析、針對特定領域的測試以及持續監測仍會是必要的。即便目前的 prompt engineering 技巧可能會過時，但了解系統錯誤模式的需求永遠存在。LLM 並不能讀心，研究顯示，人們需要實際觀察 LLM 的行為，才能明確釐清自己對它的需求。</p><h3>第二部分：錯誤分析與資料蒐集</h3><p><strong>第一題：為什麼錯誤分析在 LLM 評估中這麼重要？怎麼做？</strong><br>錯誤分析是評估中最重要的活動。它幫助你決定應該寫哪些評估，因為你能藉此辨認出應用與資料中獨特的錯誤類型。此過程包含四個主要步驟：</p><ol><li><strong>建立資料集</strong>：收集使用者互動的代表性 trace。如果還沒有資料，也可以用合成資料起步。</li><li><strong>開放編碼（open coding）</strong>：讓人工標註者（最好是仁慈獨裁者）檢視 trace，並寫下開放式備註，記錄他們發現的問題。這像是寫日記。建議初期先記下 trace 中看到的第一個錯誤，因為上游錯誤往往會引發一連串的下游錯誤。</li><li><strong>軸向編碼（axial coding）</strong>：將開放式備註歸類，建立錯誤分類法，最後統計各類錯誤的數量，也可以用 LLM 協助分組。</li><li><strong>反覆精煉</strong>：持續檢視更多 trace，直到達到「理論飽和」，也就是說新的 trace 不再出現新的錯誤模式。建議至少檢視 100 筆 trace。</li></ol><p>錯誤分析不可跳過，因為它能確保你開發的評估指標是基於實際問題，而非可能導致誤導的通用指標。</p><p><strong>第二題：除了使用者回饋之外，如何找出問題 trace？</strong><br>使用者回饋固然重要，但還有其他方法可輔助：</p><ol><li><strong>隨機抽樣</strong>：初期可用隨機抽樣，如果發現問題很少，再升級為壓力測試。</li><li><strong>用現有的評估工具進行初步篩選</strong>：先跑評估器，然後挑出有問題的 trace 進行人工分析。</li><li><strong>有效率的抽樣策略</strong>：包括異常值偵測、依據不同指標排序、分層抽樣等方式，以找出值得深入分析的 trace。</li></ol><p><strong>第三題：應該多久進行一次錯誤分析？</strong><br>每次系統有重大變更時都應該重新進行錯誤分析，例如新增功能、主要 prompt 更新、模型替換、修正重大 bug。實務上，建議每 2 到 4 週檢視 100 筆新的 trace。平常則可以每週檢視 10 到 20 筆，特別是那些異常的 trace，如對話特別長、多次重試的 session、被自動監測標記的 trace。</p><p><strong>第四題：如何產生高品質的合成資料？</strong><br>常見錯誤是直接請 LLM「幫我產生測試查詢」，這通常只會得到千篇一律的結果。較好的方式是使用「維度（dimensions）」的概念，也就是為查詢定義多種面向。</p><p>舉例來說：</p><ul><li>食譜 App 的維度可能包括：飲食限制、料理類型、查詢複雜度。</li><li>客服機器人的維度可能是：問題類型、客戶情緒、對話上下文。</li></ul><p>從這些維度出發，提出假設並產生具有代表性的測試資料。</p><p>了解你的系統可能失敗的方式後，請手動建立大約 20 組「元組」（tuple）。元組只是你從不同維度中選出的具體組合，例如「純素」、「義大利」、「多步驟」。完成這些手動元組後，可以用兩步驟的方式擴展資料集。第一步，請 LLM 產生更多這樣結構化的元組；第二步，分開使用另一個 prompt，讓 LLM 將每個元組轉換為自然語言查詢。這種分離方式可以避免語句重複。</p><p>產生完合成查詢後，將它們送入你的實際系統，以取得完整的 trace，再從中抽樣大約 100 筆來進行錯誤分析。</p><p>順帶一提，下一個相關問題是：有哪些情況下合成資料不可靠？答案是：絕對有。合成資料可能會誤導你，以下是幾種常見的失敗情境：</p><ul><li>當資料屬於複雜的專業領域內容，例如法律文件或醫療紀錄，LLM 往往無法捕捉其中的細微差異與關鍵邊界案例；</li><li>資源稀少的語言或方言，所生成的資料常常不切實際；</li><li>無法驗證資料真實性時，也就是無法確認合成資料是否真實可信，就必須使用真實資料；</li><li>在高風險領域（如醫療、法律），合成資料經常缺乏足夠的細緻度；</li><li>如果目標使用者族群在訓練資料中代表性不足，合成資料還可能強化原本已存在於 LLM 裡的偏見。</li></ul><p>接下來的問題是：當系統處理多樣化的使用者查詢時，應該如何設計評估策略？簡單回答是：只要做錯誤分析就夠了。你的評估策略應該根據實際觀察到的錯誤模式來設計，而不是根據想像中各種查詢類型所編排出的大型矩陣。你會發現，不同查詢類型常常共享相似的失敗模式，而這些才應該成為你的評估重點。</p><p>最後這一小節的問題是：如何有效率地從生產環境中抽樣 trace？隨機抽樣效率低，因為大部分 trace 可能都是成功的。這裡有幾種更有效的策略：</p><ul><li><strong>異常值偵測</strong>：依據回應長度或延遲時間等指標排序，檢查極端值；</li><li><strong>使用者回饋</strong>：優先檢查有負評或對應客服單的 trace；</li><li><strong>指標排序</strong>：即便是通用指標也可能揭示潛在問題；</li><li><strong>分層抽樣</strong>：依據使用者類型或功能區塊分群後再抽樣；</li><li><strong>embedding 分群</strong>：將查詢按語意相似度分群，進而找出並過度抽樣稀有類型的查詢。</li></ul><h3>第三部分：評估設計與方法論</h3><p><strong>第一題：為什麼推薦使用二元（通過/未通過）評估，而不是 1 到 5 的 Likert 等級？</strong><br>雖然工程師常認為 1–5 的評分可以提供更多資訊，但實際上這樣的複雜性往往弊大於利。二元評估會迫使你更清楚思考，並提高標註一致性。Likert 評分中，相鄰分數（例如 3 與 4）之間的差異極為主觀，且標註者傾向選中間值以避免下判斷。而二元選項會迫使人做出決定，也更快速，避免花時間爭論細微分數差異。</p><p>如果你想追蹤逐步改善，可以將一個大項拆成幾個二元檢查，例如，不是用 1–5 來評估事實正確性，而是檢查是否有提到特定事實的四到五項二元指標。</p><p><strong>第二題：應該使用「以評估為驅動的開發流程」（eval-driven development）嗎？</strong><br>通常不建議。這種方法是先撰寫評估器再實作功能，聽起來很有吸引力，但對 LLM 系統來說往往造成更多問題。傳統軟體的錯誤較可預測，而 LLM 可能出錯的面向幾乎無限，所以你無法預先想到所有會壞掉的地方。更好的做法是先進行錯誤分析，針對實際發現的錯誤撰寫評估器。</p><p>唯一的例外是對某些明確、嚴格的限制條件，例如「絕不能提到競爭對手」，此時可以提前撰寫評估器。</p><p><strong>第三題：是否需要為每個發現的錯誤模式都建一個自動化評估器？</strong><br>應該只針對你已經試著修復，但錯誤仍持續發生的情況建立自動化評估器。許多團隊會發現 LLM 沒有達到他們其實從未明確表達的偏好，例如回應應該簡短或遵守特定格式。你應該先修正這些 prompt 指令上的缺失，再考慮建立更複雜的評估工具。</p><p>同時，也應考慮不同評估器的成本層級。簡單的斷言或參考檢查便宜好維護，而「LLM 擔任裁判」的評估器成本高，需大量標註資料與持續維護，只應該針對你會重複調整的問題使用。</p><p><strong>第四題：是否應該使用現成的評估指標？</strong><br>答案是不應該。通用評估不但浪費時間，還可能讓你產生不實的信心。正如課程講師 Eleanor Berger 所說：「使用這些現成評估，你什麼都得不到，最好情況是浪費時間，最壞情況是產生錯誤的自信。」這些指標通常測量的是抽象概念，像是「有幫助」或「一致性」，不一定對你的應用有意義。</p><p>正確做法是進行錯誤分析、定義具體的二元錯誤模式，並基於這些問題設計客製化評估器。</p><p><strong>第五題：像 BERT score 或 Rouge 這類相似度指標在評估 LLM 輸出上有用嗎？</strong><br>對多數 AI 應用來說，這些通用相似度指標並不適合用來評估最終輸出。更好的方式是先做錯誤分析，找出特定於你應用的錯誤類型，再設計相對應的指標。</p><p>例如，對一個房地產助理來說，如果建議預約時間其實不可用，那就是嚴重錯誤，但相似度指標無法偵測到這點。不過這類指標在搜尋或推薦系統中仍有其價值，特別是用來優化或偵錯 RAG 系統中的檢索元件。</p><p><strong>第六題：是否可以使用同一個模型來執行主任務與評估任務？</strong><br>如果是讓 LLM 擔任裁判，使用相同模型通常沒問題，因為這是不同的任務，範疇也較小，通常只是簡單的二元分類。此時重點應該是讓裁判模型在驗證資料上達到高的 true positive 與 true negative，而不是避開同一系列的模型。</p><p>選擇裁判模型時，最好先用能力最強的模型，先確保與人類判斷高度一致，日後再考慮成本優化。品質標準的最終權威應該是一位專家。指定單一專家可以避免「廚師太多」造成的衝突與停滯。如果你在大型組織或跨多個領域工作，可能需要多位標註者，這時就要使用像是 Cohen’s kappa 這類一致性指標來衡量他們的一致性。不過，只要有可能，還是建議從一位「仁慈獨裁者」開始。</p><h3>第四部分：人工註釋和流程</h3><p><strong>第一題：產品經理與工程師應該共同參與錯誤分析嗎？要如何合作？</strong><br>答案是：絕對應該。一開始，他們應該共同建立共享的背景知識。工程師擅長發現技術問題，例如工具錯誤，而 PM 則能識別使用者需求未滿足的產品失誤。隨著時間推進，應該讓那位仁慈獨裁者、領域專家或深刻理解使用者需求的 PM 主導此流程。你應該授權他們評估實際成果，而不是僅僅檢查技術實作是否成功。舉例來說，問題應該是「預約有成功建立嗎？」而不是「工具呼叫成功了嗎？」最好的方式是提供客製化標註工具，讓這個人能夠同時看到商業結果與技術 trace。</p><p><strong>第二題：我應該把標註與註解工作外包嗎？</strong><br>外包錯誤分析通常是個大錯。評估的核心是培養產品直覺，而這只有透過系統性地分析自己系統的失敗才能建立。將標註外包，會打斷你觀察錯誤與理解如何改進產品之間的回饋循環。外部團隊缺乏內部專家的細膩判斷與默契知識。與其外包，不如專注於建立高效率的內部評估流程。任命你的仁慈獨裁者。為了應對工作量，你可以採用像「邊思考邊說」（Think Aloud）這樣的策略，請專家在檢閱 trace 時說出自己的想法。</p><p>當然也有一些例外，像是純機械性的任務（例如找出電話號碼）或不需產品脈絡的明確任務（如翻譯），這些可以外包。也可以聘請外部領域專家來擔任你內部的領域專家。</p><p><strong>第三題：有哪些評估工作可以用 LLM 自動化？<br></strong> 答案是：LLM 可以加速流程的一部分，但不能取代你在關鍵專業判斷上的角色。如果你讓 LLM 完全處理錯誤分析，可能會錯過重要的失敗案例。但 LLM 在特定階段作為輔助工具仍然很有價值。例如：</p><ul><li>幫助初步做軸向編碼，將錯誤筆記分類；</li><li>將標註對應到預定義的失敗模式；</li><li>發現常見問題後建議 prompt 改進；</li><li>協助分析標註資料以找出模式。</li></ul><p>但以下幾項千萬不能交給 LLM 處理：初始的開放式編碼（你必須自己讀 trace）、驗證錯誤分類法、建立 ground truth 標籤，以及深入的根因分析。</p><p><strong>第四題：我應該停止手寫 prompt 改用自動化工具嗎？</strong><br>建議：對於自動優化 prompt 的工具保持懷疑態度，特別是在開發早期階段。手寫 prompt 能逼你釐清假設並明確化需求。正如作家 Paul Graham 所說，「好的寫作就是好的思考。」如果太早把這件事交給工具，你可能永遠不會真正理解自己的需求。</p><p>因為自動 prompt 最佳化只是針對預設的評估指標做 hill climbing，它只能改善你已知的問題，無法發現新的失敗模式。研究也顯示，人在看到模型輸出後，對評估標準會發生「標準漂移」，這表示評估是一種人主導、反覆理解的過程，而不是可以交給優化器的靜態目標。</p><h3>第五部分：工具與基礎建設</h3><p><strong>第一題：我應該打造自訂標註工具，還是使用現成的？</strong><br>強烈建議打造自訂標註工具。這是對 AI 評估流程中最有影響力的投資。使用現代 AI 開發工具，通常幾個小時就能完成客製化介面。有自訂工具的團隊，迭代速度往往是其他團隊的 10 倍。</p><p>自訂工具之所以優秀，是因為它們可以在同一介面中整合來自多個系統的脈絡、以產品專屬方式呈現資料，並根據你的工作流程設計濾鏡與排序方式。</p><p><strong>第二題：</strong>好的自訂介面應該具備哪些條件？<br>答案是：好的介面應讓人工審查快速、清楚、令人有動力。以下幾點最關鍵：</p><ol><li><strong>智慧呈現 trace</strong>，不要用通用格式。例如評估產生的 email，就讓它看起來像 email。</li><li><strong>顯示進度與鍵盤操作支援</strong>：提供進度條與快捷鍵，幫助標註者進入專注狀態。</li><li><strong>透過分群、濾鏡、搜尋導覽 trace</strong>：協助觀察重複問題與驗證假設。</li><li><strong>優先標註問題 trace</strong>：自動將其他系統已標記的 trace 顯示出來，便於立即審查。</li></ol><p>原則上，介面應保持極簡。</p><p><strong>第三題：有哪些評估工具無法涵蓋的缺口需要我自己補足？</strong><br>大多數工具能處理基本需求，但以下四個面向你可能需要補強：</p><ol><li><strong>錯誤分析與模式發現</strong>：需要能自動聚類類似問題的工具；</li><li><strong>AI 輔助整個流程</strong>：希望 LLM 在各階段幫你分類、建議改進；</li><li><strong>自訂評估器</strong>：必須自己建立評估器來反映你產品真正關注的點；</li><li><strong>支援自訂標註 App 的 API</strong>：需要 observability 平台提供好用的 API 以匯出與寫回大量資料。</li></ol><p><strong>第四題：你最推薦的評估工具供應商是誰？</strong><br>這個領域目前競爭激烈，比較功能幾乎一週就過時。他們最常接觸的工具供應商包括 Langsmith、Arise 與 Braintrust。在協助客戶選擇供應商時，重點通常是誰能提供最好的支援，而不只是功能。人的互動與整體感覺（vibes）也很重要。總結來說，他們沒有最愛的供應商，通常會基於現成工具再打造自訂功能。他們建議你親自試用幾家供應商，找到最適合你的。</p><h3>第六部分：部署與實際運行</h3><p><strong>第一題：在 CI/CD 與生產監控中，評估的用途有何不同？</strong><br>最主要差異在於使用的資料。CICD 測試資料集規模小（約 100 筆），是有目的地設計出來的，涵蓋核心功能、回歸測試與已知邊界案例。由於執行頻繁，應該盡量使用低成本檢查方法，例如簡單斷言或可判定的檢查，而非昂貴的「LLM 作為裁判」評估器。</p><p>生產監控則是抽樣實際使用 trace，非同步執行評估器。這些資料通常沒有參考答案，因此更可能仰賴昂貴但不需參考資料的評估器（如 LLM 作為裁判）。這兩種系統是互補的：生產監控發現新失敗模式後，應將代表性案例加入 CI 測試資料集中。為了防止回歸錯誤（regression）</p><p><strong>第二題：Guardrails 和 Evaluators 有什麼不同？</strong><br>Guardrails 是直接存在於請求與回應路徑中的即時安全檢查，它們會在使用者看到輸出前驗證輸入或輸出。因此，它們必須快速且具決定性，通常是像正則表達式、關鍵字封鎖名單或結構驗證器這樣的簡單機制。它們針對的是明確且高影響力的錯誤，例如個資洩漏、髒話、或格式錯誤的 JSON。</p><p>相對地，Evaluators 通常在回應產生後才執行，用來衡量像事實正確性或完整性這類無法靠簡單規則判斷的品質。它們的評判結果會被送往儀表板與模型改進流程，但不會阻擋回應送達使用者。</p><p><strong>第三題：Evaluators 可以用來在生產環境中自動修正錯誤輸出嗎？</strong><br>答案是可以，但只有某些類型可以。這又回到 Evaluator 與 Guardrail 的區別。是否適合使用 Evaluator 當作 Guardrail 有兩個關鍵標準：</p><ol><li><strong>延遲與成本</strong>：該 Evaluator 是否足夠快且成本夠低，能夠在請求關鍵路徑中運行？</li><li><strong>錯誤率取捨</strong>：要如何平衡誤判（誤攔好輸出）與漏判（讓錯誤輸出通過）？</li></ol><p>大多數 Guardrails 的設計是極度快速且誤判率極低。因此，幾乎不可能在同步流程中使用慢速或非決定性的「LLM 作為裁判」的 Evaluator 當作 Guardrail。</p><p><strong>第四題：我應該花多少時間在模型選擇上？</strong><br>建議是許多開發者會過度專注於選模型當作改進系統的主要方法。你應該先從錯誤分析開始，了解失敗模式，再考慮是否需要換模型。正如作者 Hamel 所說：「不要一開始就把換模型當作改善系統的主要方向，除非有明確的證據顯示模型才是問題所在。」</p><h3>第七部分：特定領域應用</h3><p><strong>第一題：RAG 死了嗎？</strong><br>這個問題來自一篇爆紅文章，聲稱「檢索增強生成」（RAG）已死，讓很多開發者困惑。要了解這篇文章實際上是在反對「使用幼稚的向量資料庫檢索來驅動自主編碼代理」，而不是反對整個 RAG 概念。</p><p>RAG 的本質是：使用檢索來提供上下文，以改善模型輸出。這個核心原則依然重要。真正的問題不是「要不要使用檢索」，而是「如何有效檢索」。現代系統使用各種檢索策略，而「RAG」這個詞已變成缺乏共識的流行語。你的重點應該放在讓 LLM 得到它所需的上下文，並嘗試不同檢索方法找出最適合你的策略。</p><p><strong>第二題：應該如何評估 RAG 系統？</strong><br>RAG 系統有兩個主要組件，分別需要不同評估方式：<strong>檢索</strong>與<strong>生成</strong>。</p><ul><li>檢索：本質上是一個搜尋問題，應使用傳統的資訊檢索指標來評估，例如 Recall@k、Precision@k。</li><li>生成：評估 LLM 如何使用檢索到的上下文，應使用前述的錯誤分析方法：找出失敗模式、人工標註、建立並驗證「LLM 作為裁判」的 Evaluators。</li></ul><p>建立這些裁判模型時，一定要用人工標註資料來驗證，以確保這些指標真正反映你的品質標準。總結來說，先用 IR 指標除錯檢索，再用驗證過的評估器分析生成品質。</p><p><strong>第三題：如何選擇文件處理任務的 chunk 大小？</strong><br> 與 RAG 不同，文件處理假設模型會讀取每個 chunk。目標是將文本切分為模型能夠有效推理的單位。這取決於任務類型：</p><ul><li><strong>固定輸出任務</strong>（例如提取一個數字）：可以使用較大的 chunk。</li><li><strong>可擴展輸出任務</strong>（例如摘要）：建議使用較小的 chunk，以維持推理品質。</li></ul><p>chunk 大小會影響結果的原因是：越大的 chunk，模型的「認知負荷」越大，可能忽略中間細節；較小的 chunk 則能讓模型專注於特定區段。總之，chunk 大小是一個需要實驗調整的超參數。</p><p><strong>第四題：如何除錯多輪對話 trace？</strong><br>建議從簡單開始。先判斷整體對話是否達成使用者目標，用簡單的通過/失敗判定。再看完整 trace，找出最早出現的上游錯誤。</p><p>對於多代理流程，要為每個請求指定 session 或 trace ID，以重建整體路徑。當你發現錯誤時，嘗試用最簡單的測試重現。例如：如果 bot 在第四輪失敗，先試試單輪查詢是否也會失敗，這有助於快速定位問題。</p><p><strong>第五題：如何評估含有人力接手的 session？</strong><br>你必須在 trace 中完整記錄使用者歷程，包含人工接手的部分。trace 應持續記錄直到使用者需求實際被解決。記錄內容應包括：接手決策、原因、傳遞的上下文與最終解決結果。很多錯誤就發生在人與 AI 交接的邊界。錯誤分析時，應將這些交接點視為潛在的失敗模式，例如：這次交接有必要嗎？AI 是否提供了足夠的上下文？</p><p><strong>第六題：如何評估複雜的多步驟流程？</strong><br>首先，你需要記錄整個工作流程，從初始觸發直到最終業務結果，涵蓋所有 LLM 呼叫、工具使用、人為核准與資料庫寫入。你應使用：</p><ul><li><strong>結果指標</strong>：確認最終是否達成目標；</li><li><strong>過程指標</strong>：評估流程效率。</li></ul><p>除錯時，通常先處理流程上的失敗較容易。你也應根據流程階段分段進行錯誤分析，因為早期錯誤往往影響最大。最後，可以用「流程轉換錯誤矩陣」來分析流程最常失敗的環節。</p><p><strong>第七題：如何評估具有自主性的代理流程（agentic workflows）</strong><br>建議分兩階段評估：</p><p>第一階段：端對端任務成功率。將代理視為黑盒子，只問一件事：「是否達成使用者目標？」</p><p>第二階段：步驟級診斷。根據第一階段的錯誤分析，針對失敗率高的流程進行細部評分，例如：</p><ul><li>工具選得對嗎？</li><li>參數是否正確擷取？</li><li>是否妥善處理錯誤？</li></ul><p>此時「流程轉換錯誤矩陣」特別有用。你可以建立一個矩陣，列為上一次成功的狀態，欄為首次失敗的階段，這能將複雜流程轉化為可執行的洞察，幫助你釐清該將除錯重點放在哪一段。</p><p>最後提醒：如果你想精通這些概念，別忘了去看看完整的 AI Evals 課程。身為聽眾，你可在 bit.ly/evals-ai 享有 35% 折扣。再次提醒，是 bit.ly/evals-ai。</p><p>感謝你的收聽。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=e1dfe00190e6" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[優化 Retrieval-Augmented Generation（RAG）的全流程指南]]></title>
            <link>https://medium.com/@frozenfung/%E5%84%AA%E5%8C%96-retrieval-augmented-generation-rag-%E7%9A%84%E5%85%A8%E6%B5%81%E7%A8%8B%E6%8C%87%E5%8D%97-7afd79b34738?source=rss-dc66ceb35b90------2</link>
            <guid isPermaLink="false">https://medium.com/p/7afd79b34738</guid>
            <category><![CDATA[retrieval-augmented-gen]]></category>
            <dc:creator><![CDATA[frozenfung]]></dc:creator>
            <pubDate>Mon, 28 Jul 2025 06:29:51 GMT</pubDate>
            <atom:updated>2025-07-28T06:29:51.554Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*yzJrOgxOJy_ww3VPZQZprw.png" /></figure><blockquote>本篇為我的學習筆記，參考簡報 <a href="https://maven.com/p/35585d/rag-anti-patterns-in-the-wild-and-how-to-fix-them">RAG Anti-patterns in the Wild, and How to Fix Them</a>，部分內容由 ChatGPT 協助產生。</blockquote><p>Retrieval-Augmented Generation（RAG）是一種結合語言模型與外部知識檢索的技術，廣泛應用於問答系統、聊天機器人、企業知識庫等場景。然而，若想真正發揮 RAG 的潛力，僅僅依賴模型能力是不夠的，我們需要對整個流程進行精細優化。</p><p>本文將深入探討 RAG 系統中四個關鍵環節 — — 資料收集與整理（data collection &amp; curation）、索引與儲存（indexing &amp; storage）、重新排序（reranking）與生成階段（generation） — — 以及每個環節常見的錯誤與改進建議。</p><h3>資料收集與整理：打好地基</h3><p>RAG 的效能高度依賴底層資料的品質，資料收集與處理不當會造成整體效能下降。</p><h4>文件格式不一致</h4><ul><li><strong>問題</strong>：文件存在不同編碼與格式，導致解析困難。</li><li><strong>解法</strong>：導入格式驗證器與轉換器，統一資料格式。</li></ul><h4>壞段落污染語料</h4><ul><li><strong>問題</strong>：品質低落的片段會干擾模型學習。</li><li><strong>解法</strong>：以「人工檢查最短 5% 片段」策略排除異常。</li></ul><h4>切塊大小影響效果</h4><ul><li><strong>問題</strong>：過大或過小的 chunking 會導致語意不清或資訊遺失。</li><li><strong>解法</strong>：提供使用者可調整的 chunk size。</li></ul><h4>無關文檔混入</h4><ul><li><strong>問題</strong>：語料中若夾雜無關主題，檢索會變得模糊。</li><li><strong>解法</strong>：透過顧客訓練機制進行篩選。</li></ul><h4>資訊擷取錯誤</h4><ul><li><strong>問題</strong>：若抽取資訊錯誤，後續所有流程皆會受到影響。</li><li><strong>解法</strong>：結合多種 parser 做交叉驗證。</li></ul><h3>索引與儲存：建立可用的資料檢索基礎</h3><p>即使資料本身完整，如果索引策略不佳，也會導致檢索失敗。</p><h4>無檢索充分性可視性</h4><ul><li><strong>問題</strong>：無法得知檢索是否已涵蓋足夠資訊。</li><li><strong>解法</strong>：設計查詢覆蓋率評估機制。</li></ul><h4>輕率使用 embedding</h4><ul><li><strong>問題</strong>：粗糙或不精調的 embedding 會導致檢索結果偏離主題。</li><li><strong>解法</strong>：根據應用場景微調 embedding。</li></ul><h4>忽略索引陳舊問題</h4><ul><li><strong>問題</strong>：內容更新後未重新索引會造成知識延遲。</li><li><strong>解法</strong>：設計自動檢查索引更新的機制。</li></ul><h4>缺乏任務分解</h4><ul><li><strong>問題</strong>：一個大型任務若未拆解為子任務，容易出現檢索範圍過廣。</li><li><strong>解法</strong>：以任務導向方式設計 query schema。</li></ul><h4>接受模糊或偏題查詢</h4><ul><li><strong>問題</strong>：查詢模糊會降低召回率。</li><li><strong>解法</strong>：加入 query 正規化模組與使用者提示。</li></ul><h4>忽略 false negative 檢查</h4><ul><li><strong>問題</strong>：系統可能未檢出關鍵資訊而誤以為已完成。</li><li><strong>解法</strong>：納入 negative sampling 評估指標。</li></ul><h3>重新排序（Reranking）：高品質回應的關鍵</h3><p>Reranking 是將初步檢索結果進行重排序，提升上下文品質的重要步驟。</p><h4>不當增加複雜度</h4><ul><li><strong>問題</strong>：模型複雜化並未帶來效能提升。</li><li><strong>解法</strong>：以效益分析評估 reranker 增強模組的價值。</li></ul><h4>容許無關結果通過</h4><ul><li><strong>問題</strong>：降低整體回答品質。</li><li><strong>解法</strong>：結合語義相似度與上下文匹配分數。</li></ul><h4>boost 使用過度</h4><ul><li><strong>問題</strong>：過多強化某些關鍵詞，導致偏斜。</li><li><strong>解法</strong>：限制 boost 權重範圍並以 A/B 測試驗證。</li></ul><h3>生成階段：把好最後一關</h3><p>最後的語言生成若無防護措施，很容易讓錯誤資訊輸出。</p><h4>回答推理型問題能力差</h4><ul><li><strong>問題</strong>：簡單的檢索型 RAG 無法應對需要推理的任務。</li><li><strong>解法</strong>：引入 intermediate reasoning steps 模型（如 CoT）。</li></ul><h4>沒有設計防幻覺機制</h4><ul><li><strong>問題</strong>：模型產生不存在或錯誤資訊。</li><li><strong>解法</strong>：加入 output guardrails，如 reference span 高亮或 citation validation。</li></ul><h3>RAG 是全鏈條工程，不是單點最佳化</h3><p>要打造一個穩定且高效的 RAG 系統，不能只關注某一個環節，而要從資料準備、索引建構、排序策略到最終生成全流程精雕細琢。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=7afd79b34738" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[現代年輕人現況]]></title>
            <link>https://medium.com/@frozenfung/%E7%8F%BE%E4%BB%A3%E5%B9%B4%E8%BC%95%E4%BA%BA%E7%8F%BE%E6%B3%81-809125ac4c63?source=rss-dc66ceb35b90------2</link>
            <guid isPermaLink="false">https://medium.com/p/809125ac4c63</guid>
            <dc:creator><![CDATA[frozenfung]]></dc:creator>
            <pubDate>Mon, 05 May 2025 15:32:43 GMT</pubDate>
            <atom:updated>2025-05-05T15:35:08.138Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*s3c_glA3wAnBcOqe8Dg_QA.png" /><figcaption>driven by desire or fear?</figcaption></figure><p>內容為 B 站影片 &lt;抽象可以，但抽象不行&gt; 逐字稿</p><p><a href="https://www.bilibili.com/video/BV1p7VPzeECG/">https://www.bilibili.com/video/BV1p7VPzeECG/</a></p><p>大家好，我是老蔣，今天呢是五四，又到了一年一度的和大家嘮嘮嗑的環節。那剛才呢我其實看到了刷到了B站，今年的青年節影片，B站每年都會發一個嘛，今年的主題是這種，我總結啊，看完以後就是年輕人心中普遍性的，瀰漫性的這種焦慮，而且呢他提他提了一個很可怕的詞，叫做一種被消除的狀態。演化到極致之後就會被消除，這個影片也給了我不少啟發，因為我在年初的時候其實聊過一期 2024年中觀察，其中有一些東西和這個是穩合的，那個影片是從社會和群體的角度講了，我理解的年輕人的世代困境。</p><p>那麼今天呢我想換個視角，完全從個體的心理的角度來重新聊聊這個事，我一直覺得我們人呢有兩套內在的動力系統，一套是慾望或慾念，一套是恐懼，根據我這些年的觀察，其實對我們社會來說，大多數人其實是靠著恐懼在驅動，我們去生活和行動的，我們這輩子有太多值得害怕的事情對吧，怕讓老師這個父母失望，怕自己丟臉，怕工作背鍋，怕失業，怕自己孤獨終老，怕被人看不起，怕還不上房貸等等，具體的還有不具體的都有。這種怕呢，把自己醃入了味兒，它就成了一種模式，一種無形的讓人緊繃的這種精神壓力，在你耳邊一直去低語，連最後你都不知不知道自己在怕什麼。</p><p>但是你就是好像懼怕自己，周圍的環境和周圍的生活，你都說不上來了，那我呢對這事恐體會不是特別的深，因為我並不是一個焦慮型的性格。但是呢我有很強的拖延症，很多時候就是我並不知道我在拖些什麼，你說我寫東西常常喜歡拖延，但是我不喜歡寫東西，不喜歡表達嗎，不是我明明是非常喜歡表達，但是我怕自己寫不好，我怕自己寫不出來，所以呢我就拖著不住不做，拖著不做，這個不好的結果就永遠出不來對吧，永遠不會到來，這種對害怕的害怕形成了焦慮，而焦慮又會在無形中消耗我，把我掏空，讓我喪失行動力和自主性。這是有毒的，其實很多人也是一樣，我相信相當多的人都能有這種共鳴，就是當你處在這種焦慮性的困境中的時候，其實你並沒有做什麼事，但是你很累。很多人的生活都是這樣的，活在一種不著邊際的惶恐，還有擔憂之中，天天愁眉苦臉。</p><p>所以呢我一直會覺得另一種靠欲求去驅動，可能是更好的，嗯至少我在3、4年前我是這麼想的，那麼靠慾望驅動看起來是更健康的。你產生一種慾望去行動，然後呢你滿足這個慾望，再催生新的慾求，催生新的這個慾念，再去滿足它是一個正循環。這在大多數情況下是很好的，但是呢也不好說，比如說你看人民的名義裡面，第一集裡面那種貪官對吧，他桑木號也可以說是慾望驅動的人生，為什麼不算呢，他貪了那麼多錢。但是你說這種氾濫的不受管控的慾望，為他帶來了什麼呢，肯定不是好的東西，所以呢綜合起來，其實應該說慾望和恐懼都可以形成正向回饋，它都是我們的生物本能嘛。他都是我們的財富，一個是趨利，一個是避害，當他們很具體的時候，都沒有太大的問題。</p><p>但是當慾念和恐懼抽象化的時候，它就變成了問題，當我不是害怕寫作這件事兒，而是害怕寫作有可能失敗的這種抽象的預期，甚至害怕自己會害怕這件事的時候。一個是二階，害怕寫作，一個是三階害怕害怕寫作。那麼這個就是一種抽象的恐懼，同理抽象的慾念也不好，就像那種貪了幾個億的貪官啊，他貪到後面，你說錢對他來說意味著什麼呢，他本身是官員，他也花不出去。那麼這個就已經不是具體的慾望了，而是一種概念化的對於數字的飢渴。當一個人向他行賄的時候，你具體問啊，「你貪了這100萬，你要幹嘛？」「你要拿這個錢去做什麼？」他也不知道。這就變成了一種抽象的慣性，那麼不管是慾望還是恐懼驅動你的動機，你的動力系統一旦不不具體，你就容易被異化，你就變成了某種概念的奴隸對吧。你不是渴求金錢所能交換的物質，你不是想讓自己的生活變好，你是渴望金錢本身，那麼金錢就變成了主體，而你變成客體對了吧，或者你不是渴求親密關係，你不是渴求陪伴，你不是渴求你所愛的人的回應，你只是接受不了自己，沒有辦法結婚所暗示的失敗結果，那你就變成了婚姻的奴隸。</p><p>所以慾望和恐懼都不是問題，問題是要具體不要抽象，不要抽象化。但是不幸的是，中國青年自身的動機確實非常容易被抽象化，不得不承認這一點。首先是從小被極端幽寂的環境灌輸了，你必須贏，必須非常優秀的念頭。你很難接觸到具體的快樂，具體的愉悅。你的驅動力，從小就幾乎全部是外在的，被賦予的，被要求的。我在去年年終觀察裡也提過。就是很多人因為這種成長過程中的遭遇，變成空心人，我身邊就有現實中的朋友是這樣，我有個關係很好的，一直有聯繫的男大同學，從小到大都是學霸，畢業以後工作也挺好。但一直很不開心，他想換一個環境，然後呢，35歲又申請了荷蘭的學校出去留學。因為他的學習能力真的很強啊，他其實是個很厲害的人，所以他也順理成章的，真正非常順利的就到了荷蘭。那照理說夢想成真了，但是去年跟我打電話，他說自己有一門成績考到的學院，有史以來所有所有國家所有學生的第一名，整體所有所有績點也是排前幾。但是呢就算這樣，他也覺得自己依然不夠好，為什麼，因為他沒有每一門都考到第一，我覺得這非常荒謬。我就問他，我說你你自己覺得這事合理嗎，你自己不覺得荒謬嗎，他說他理性上也知道自己已經做的不錯了，但是理性沒有用，因為一直以來的慣性，他就是覺得自己不夠好。不管怎麼樣，只要有更好的可能性。他就覺得自己不夠好，他會覺得自己是差勁的，這是一種深入骨髓的思維慣性。我認識這樣的人並不少啊，我有時候覺得這些朋友可能也是幸運的，因為因為我從小到大確實是重點中學，他們可能我身邊的朋友運氣好，都是能力很強，確實也能拿到比較好，結果他們能經營的起來的這群人，所以對他們來說，是周期性的陷入自我否定和自我肯定。</p><p>這樣的循環，但是有些人面對這樣的PUA，有可能就是徹底的墮入黑暗，那麼抽象的恐懼。其中一部分和抽象的慾念其實是一體兩面的，就是我不知道自己想要什麼，那怎麼辦呢。我只能想要贏對吧，想要贏，於是我也就怕輸，我怕自己贏不了，不能成為大家值得肯定的人，於是我就一無是處了。所以這個時候，抽象的慾望和抽象的恐懼是一體的。另一部分呢是網路媒介帶來帶來的，抽象的恐懼，就是我們已經實實在在的資訊過載了，媒材渲染了，渲染了太多的訊息，他給了你好多好像太多的黑幕，太多的極端個例。年輕人如果沒有充分的接觸真實的社會，沒有相抗衡的這種資訊量和對社會的理解，那麼世界在他們眼中就是一個龐大的神祕的危險，重重的理解不了的黑暗莫測的世界。在這樣的一個是一個環境裡面，一個普通人從心理上像扁舟一葉，好像怎麼走都是死路，怎麼選選擇都是錯的，那我們就從動機的角度去看，新一代人的困境，就是像剛才說的這樣，慾念和恐懼都抽象化了。有句話我最近想的很多啊，這個應該是B站某個up主常說，於是他也成了一個比較比較比較大家常用的梗，叫一根筋變兩頭堵，上下不能左右為難。</p><p>那麼對於年輕人來說，我覺得一根筋變兩頭堵是挺實在的一個狀況。我們這一代，新的一代，他們生物本能的那種生存壓力幾乎是消失了，就你不管你覺得這個社會是好是壞，你覺得過的你過得是好是壞，但是你不得不承認，在這樣的社會裡，在我們中國，你想要真的餓死是不容易的對吧。那而那些高級的追求呢，你想要追尋到卻又不太容易，你又追求不到，這個是兩頭堵。然後呢再說成長環境，這種活人的愉悅感，這種鬆弛感被幽寄的教育，被從小的環境毀了。但是呢向上的階層躍升那種你能贏，你能比別人過得好的機會又在急劇的縮窄，這個勝率在變低，這個也是兩頭堵。還有從時代階段上來說，前代的那些PUA還沒消失對吧，那麼還依然有很多人告訴你要催婚，有很多人告訴你怎麼樣能做男人，怎麼樣能做一個女人啊，這種前代的東西還沒有消失，而現代生活的利多與多樣性又逐漸的萎縮。還有現代性的這種壓抑和空洞以及虛偽又席捲而來，我們又必須面對。而且它還是一種抽象的負面情緒，就是你甚至不知道該去怪誰，那麼這個也是兩頭堵，這是一種前代與現代的合圍。</p><p>去年的年終觀察，我也聊過類似的結構，但是我還可以再講，因為這是很核心的時代命題。這種精神上的結構，我認為會影響一代人的精氣神，這種兩頭堵帶來的是什麼呢，是一種惶惶不可，終日不知何處為家，自己又是誰，自己又在哪裡。自己又該往哪裡走的迷茫，它是一種又顛又喪，看起來顛。實際上喪的精氣神。我覺得當前世代上就是兩個世代或幾個世代之間，在輿論場上的衝突這麼大，這麼不能互相理解。其中很大的一個原因是，老一輩，確實理解不了這種又癲又喪的精神狀態，他理解不了這種年輕人心中的這種黑洞。這種空洞，還有附加的晃晃悠悠的，很難受的感覺，因為確實如果你不從年輕人的內心去理解，你不去真正的觀察和融入他們的生活的話。你完全站在外面來看，你當然會覺得這是無病呻吟對吧。因為物質條件的確更好了，受的教育也更好了，但是你們還唧唧歪歪事反而變得更多了。然後可能啊上一輩會覺得你問你到底咋了，你又不直說，又不跟他們好好說。但是他們不知道的是，正是因為說不出來才難受，那麼面對這樣的一種個體的困境。其實大家有不同的選擇，一部分人選擇躺啊，你不行動，行動就不會白費嘛對吧。不選擇就不會選錯嗎，你不能面對問題，問題就能暫時的被關在外面對吧，你很難說這是一種理性的行之有效的行為邏輯。但是他的確是符合人性，符合情緒模式的。</p><p>那麼還有一種選擇是什麼呢，是既然我拿不到一個我可以認可的價值，那我就把全部的價值都摧毀掉，我解構一切啊，我調侃一切，看透一切，嘲笑一切，我假裝這個世界上沒有自己在意、值得追尋的東西，也是一種選擇。那麼另一個選擇就更加的危險，就是我既然找不到價值，那我就用力量感去代償，填補這種價值缺失，填補這種價值價值空洞，找不到價值就去找力量。那什麼是最直接的力量呢，傷害他人就是最有效率的證明自己力量的方式，這就是我說過的，仇恨共同體的心理機制上的來源。而且我們回看歷史，也可以看到每一次的週期變動，當社會走到了形成價值空洞的那個時間點上，同一時間也會是大眾絕望地尋求力量力，力量感的那個時間點，所以我們可以看到現在輿論場上的許多現象，很多熱點你你說到根兒上，就是上面三種選擇的一種雜糅嘛。很多事情其實無關對錯，也無關事情本身他就是想圍獵遊戲，就大家把目光聚焦在，一些幾乎毫無公共性的議題上，用大多數人的正確啊去圍剿少數人。而且這少數人還不一定是錯誤，有可能只是他們不招人喜歡，或者他們恰好代表了映射了某種大家不讓大家不滿的事物。這裡我說的不是協和4+4啊，或是山西案這樣的熱點。這種事情是少有的，真正有一些公共價值的事件啊，其實有很多了，我說的是什麼呢，我說的是像何同學搭計程車是不是拒絕好評，房琪對葉童不敬，小明建模和老婆到底是怎麼過日子。這種破爛事兒，這種破事兒在類似的事情裡面，大家是靠著對他人，對這些目標的道德批判，靠羞辱他們的人格來進行名名為正義的傷害。然後再透過觀察到這樣傷害的產生，觀察到他們的恐懼或哀嚎，或是另一個陣營的人的哀嚎，來達到一種內心的高潮對吧。這種高潮在他們自己看來可能是懲惡揚善，但這其中又包含有多少，我看見我傷害，所以我存在，所以我有力量，這樣的非常好的正回饋呢，我認為是不少的。</p><p>上面你可以理解成是我對現象的解讀，或者一種歸因邏輯。我承認它也是一種批判，但是如果你剛好就是上面說的這種，用力量感去代償價值感的人。我該怎麼樣給你一個解法呢？給你一個解法不容易，因為避免動機抽象化的做法，似乎看起來很簡單吧，就一句話的事，就是讓你自己和你的生活變得具體，但具體不是一種態度，而是一種能力。你必須有能夠具體的東西才行，你得有那個實在的東西，你得足夠的敏感，你得見過真正好的事情，你得看見自己和別人。你才有可能變得具體，而且很重要的是，你得有足夠的心理空間，你得有是一種心理能量，你才能好好生活。你不能是一個被吃乾抹淨，被消耗乾淨。然後按B站今年五四影片說的，很恐怖的一個詞，就是被消除的人，這樣的話你是沒有辦法具體的。所以怎麼辦呢。我自己給的不一定對的解法，就是嘗試去做一個不精緻的利己主義者，或者我們說的直白一點，就是你別太無私了，你不要一個勁兒地去滿足別人的期待，你不要一個勁兒地去滿足社會的期待，滿足父母的期待，你別一個勁兒的去為了正義去譴責什麼東西啊，為了弱者去發聲，然後天天和一些你認為的，醜陋的社會現象去做鬥爭。</p><p>我覺得更該做的是，你在我覺得你陷入了這樣的情緒風暴，陷入了這樣的正義的風暴，這種戰鬥欲的時候，那你在刷B站，刷抖音，刷知乎的時候，你想一想，就是我在這個過程中到底獲得了什麼。你不要只關注社會的正能量，你專注於關注自己的正能量，我覺得我們在這樣的一個時代週期面前。應該更吝嗇的使用和消耗自己的情緒，你不要強行為了自己之外的人，為了對抗什麼所謂的惡勢力，去強忍那些讓你不開心的，讓你憤怒的，讓你感覺無奈，難受和迷茫的事情，而是遠離他們，遠離這些事。你想想自己到底需要什麼，怎麼能讓自己更愉悅、更放鬆。其實在這個層面上，無意義的娛樂，搞抽象發癲，無意義的消費都沒問題，只要他能補充你、滋養你，而不是消耗你就行。我覺得這其實也不真的那麼難判斷，就是你做完這些事，你是更累了，更空虛了、更失眠了、睡不著覺了、更麻木了。還是你能感覺到自己有些滿足，更有餘力了，你睡得更香了，你的思維更活躍了，而且你對自己和他人更敏銳了，我覺得我們其實是能夠感受到的，如果你真的想感受的話。</p><p>所以我的答案就是這個世界可能不太好，但是呢我們應該對自己好一點，你對自己好一點，你才能對這個社會好。你才能夠形成一種回饋，多保護自己，少管點有的沒的。因為人是非常非常有限的一個生物，我們的情緒，我們的注意力，我們的善意都是非常有限的，那麼要給自己的精神世界留下更多空間。你才能容納得下具體的他人，還有具體的世界，不然一切都是抽象的關切。不然呢你的動力系統就會變得抽象，然後你的關切也會變得抽象化。而通往地獄之路，正是由這樣的抽象化的善意來撲救的。我還比較喜歡這兩年被人常說的一句話，叫做尊重他人命運，放下助人情結。那麼在這個影片的最後，就祝福各位的青年能真正的看見具體的自己，好謝謝感謝大家，祝你們節日快樂。朋友們，我們相信100年前的苦難都沒有消除，中國青年，中國青年也絕對不會被焦慮消除。</p><p>內容為 B 站影片 &lt;抽象可以，但抽象不行&gt; 逐字稿</p><p><a href="https://www.bilibili.com/video/BV1p7VPzeECG/">https://www.bilibili.com/video/BV1p7VPzeECG/</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=809125ac4c63" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[玩德州撲克到底是不是在賭博？]]></title>
            <link>https://medium.com/@frozenfung/%E7%8E%A9%E5%BE%B7%E5%B7%9E%E6%92%B2%E5%85%8B%E5%88%B0%E5%BA%95%E6%98%AF%E4%B8%8D%E6%98%AF%E5%9C%A8%E8%B3%AD%E5%8D%9A-35ffcb9f5802?source=rss-dc66ceb35b90------2</link>
            <guid isPermaLink="false">https://medium.com/p/35ffcb9f5802</guid>
            <category><![CDATA[德州撲克]]></category>
            <category><![CDATA[poker]]></category>
            <dc:creator><![CDATA[frozenfung]]></dc:creator>
            <pubDate>Fri, 07 Mar 2025 02:24:55 GMT</pubDate>
            <atom:updated>2025-03-07T02:24:55.313Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*4maQ3qNhOYSDuIpi7SBKeQ.png" /></figure><p>最近看到越來越多人討論，我也來跟大家分享我的看法，共四個部分：</p><p>1️⃣ 德州撲克是什麼<br>2️⃣ 賭博是什麼 <br>3️⃣ 德州撲克算不算賭博 <br>4️⃣ 結論</p><p>1️⃣ 德州撲克是什麼？</p><p>首先我們要定義德州撲克，這篇討論的是無限注德州撲克（Texas hold’em），不是奧馬哈撲克，也不是短牌或是加勒比撲克等等其他多樣化的德州撲克類型。</p><p>2️⃣ 賭博是什麼？</p><p>這邊討論的是普世價值，而非因為國情不同而寬鬆不一的法律標準，一般大家都認可的賭博的定義是：「一種以金錢或財物為賭注，結果主要由運氣決定的行為。」</p><p>3️⃣ 德州撲克算不算賭博</p><p>定義完德州撲克跟賭博後，我們終於可以開始討論兩者之間的關係。有玩過德州撲克的人都知道，德州撲克最好玩的地方就是即便你拿最爛的牌 27o，面對最好的手牌 AA，你仍然有機率獲勝（12.2%）。也就是說除了少部份極端狀況外，不管勝率多低的牌都有機會贏下底池。也就是說你可能因為今天的好運拿 27o bad beat AA，這種狀況每天都在世界各地上演。不過我們也都知道，一個人的運氣不可能一直這麼好。當發生的次數夠多時，好運壞運最終會達到一個平衡，最終符合統計學的大數法則：「樣本數量越多，則其算術平均值就有越高的機率接近期望值」。說白話一點就是，拿 27o 跟 AA 跑馬一百萬次，27o 勝利的結果會非常接近 12 萬 2 千次（1, 000, 000 * 12.2%）。這說明了德州鋪克長期玩下來的結果跟運氣無關，金錢和財物的變化完全取決於勝率以及賠率的計算。</p><p>4️⃣ 結論</p><p>如果你只打過德州撲克三次，你可能是在賭博<br>如果你打德州撲克超過十萬手牌，且每手牌你都有認真計算勝率和賠率，你絕對是賭鬼</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=35ffcb9f5802" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[2024 書單]]></title>
            <link>https://medium.com/@frozenfung/2024-%E6%9B%B8%E5%96%AE-cece083f4b0e?source=rss-dc66ceb35b90------2</link>
            <guid isPermaLink="false">https://medium.com/p/cece083f4b0e</guid>
            <category><![CDATA[books]]></category>
            <dc:creator><![CDATA[frozenfung]]></dc:creator>
            <pubDate>Fri, 13 Dec 2024 06:08:11 GMT</pubDate>
            <atom:updated>2024-12-13T06:08:11.320Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*lO4PHLXRVd4PHCYM" /><figcaption>Photo by <a href="https://unsplash.com/@inakihxz?utm_source=medium&amp;utm_medium=referral">Iñaki del Olmo</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><p>去年信義誠品熄燈之後，今年轉往中山地下街找書看書，這跟以往在信義誠品找書的體驗很不一樣。信義誠品是百貨的規模，因此在不同類型的書櫃中移動的體驗可以是走馬看花，我也更容易被陳設的商品吸引。相對的在中山地下街，除了主要走道上的擺攤之外以及書店對面少數店家外，就只剩下行人，更接近沉浸式找書的體驗。</p><ul><li>僧侶與哲學家</li><li>通關升級！發想創意、構建關卡、設計控制、塑造角色的全方位遊戲設計指南</li><li>蒙格之道</li><li>別把你的錢留到死</li><li>呼吸為了療癒</li><li>窮查理的普通常識</li><li>雲端封建時代：串流平台與社群媒體背後的經濟學</li><li>最強時間營養學</li><li>娛樂至死: 追求表象、歡笑和激情的媒體時代</li><li>失控的焦慮世代</li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=cece083f4b0e" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[#7 不能說很像，只能說一模一樣的 iOS 原生時鐘 Tab 2 Alarms]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/7-%E4%B8%8D%E8%83%BD%E8%AA%AA%E5%BE%88%E5%83%8F-%E5%8F%AA%E8%83%BD%E8%AA%AA%E4%B8%80%E6%A8%A1%E4%B8%80%E6%A8%A3%E7%9A%84-ios-%E5%8E%9F%E7%94%9F%E6%99%82%E9%90%98-tab-2-alarms-db540836dab8?source=rss-dc66ceb35b90------2</link>
            <guid isPermaLink="false">https://medium.com/p/db540836dab8</guid>
            <category><![CDATA[ios]]></category>
            <dc:creator><![CDATA[frozenfung]]></dc:creator>
            <pubDate>Sat, 27 Jan 2024 08:26:49 GMT</pubDate>
            <atom:updated>2024-01-27T14:07:50.425Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*YhWZsqXIiJpwKksQ" /><figcaption>Photo by <a href="https://unsplash.com/@renelwackett?utm_source=medium&amp;utm_medium=referral">Renel Wackett</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><p>延續<a href="https://medium.com/p/c82fdfb82192">上一篇</a>，這篇主要紀錄實作 iOS 原生時鐘的第二個 Tab Alarm</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/295/1*oRLzl5rVbKrf1gNfub2Ojg.gif" /><figcaption>Tab 2 Alarms</figcaption></figure><h4>實作範圍</h4><p>第二個 Tab Alarms</p><h4>開發過程</h4><p>建立第一個 ViewController 並且設定主要的 TableView</p><pre>import UIKit<br><br>class AlarmTableViewController: UITableViewController {<br>    // 用來保存鬧鐘對象的數組<br>    var alarms: [Alarm] = [] {<br>        didSet {<br>            toggleNavBarEditButton() // 每當 alarms 數組改變時，更新導航欄的編輯按鈕<br>        }<br>    }<br>    <br>    // &quot;添加鬧鐘&quot; 按鈕的 outlet<br>    @IBOutlet weak var AddAlarmBut: UIBarButtonItem!<br>    <br>    // 用來保存所選鬧鐘的變量<br>    var selectedAlarm: Alarm?<br>    <br>    override func viewDidLoad() {<br>        super.viewDidLoad()<br>        <br>        // 設置導航欄<br>        navigationItem.leftBarButtonItem = editButtonItem<br>        tableView.backgroundColor = .black<br>        <br>        // 如果有已保存的鬧鐘，則加載它們<br>        if let savedAlarms = Alarm.loadAlarms() {<br>            alarms = savedAlarms<br>            tableView.reloadData()<br>        }<br>        <br>        // 開發用：選擇第一個鬧鐘並執行一個 segue<br>        // selectedAlarm = alarms[0]<br>        // performSegue(withIdentifier: &quot;updateAlarm&quot;, sender: AlarmTableViewCell.self)<br>    }<br>    <br>    // MARK: - 表格數據源<br>    <br>    // 用於處理返回到 AlarmTableView 的 unwind 操作<br>    @IBAction func unwindToAlarmTableView(_ unwindSegue: UIStoryboardSegue) {<br>        if let savedAlarms = Alarm.loadAlarms() {<br>            alarms = savedAlarms<br>        } else {<br>            alarms = []<br>        }<br>        <br>        tableView.reloadData()<br>    }<br>    <br>    // 用於提供分組標題的方法<br>    override func tableView(_ tableView: UITableView, titleForHeaderInSection section: Int) -&gt; String? {<br>        if section == 0 {<br>            return &quot;睡眠 | 醒來&quot;<br>        } else {<br>            return &quot;其他&quot;<br>        }<br>    }<br>    <br>    // 自定義分組標題的方法<br>    override func tableView(_ tableView: UITableView, willDisplayHeaderView view: UIView, forSection section: Int) {<br>        if let headerView = view as? UITableViewHeaderFooterView {<br>            headerView.textLabel?.textColor = .white<br>            headerView.textLabel?.font = .systemFont(ofSize: 16.0, weight: UIFont.Weight.bold)<br>            headerView.textLabel?.lineBreakMode = .byCharWrapping<br>        }<br>    }<br>    <br>    // 用於處理行刪除的方法<br>    override func tableView(_ tableView: UITableView, commit editingStyle: UITableViewCell.EditingStyle, forRowAt indexPath: IndexPath) {<br>        if editingStyle == .delete {<br>            // 從數據源中刪除鬧鐘<br>            Alarm.deleteAlarm(self.alarms[indexPath.row].id)<br>            self.alarms.remove(at: indexPath.row)<br>            if alarms.count == 0 {<br>                tableView.deleteSections(IndexSet(integer: indexPath.section), with: .fade)<br>            } else {<br>                tableView.deleteRows(at: [indexPath], with: .fade)<br>            }<br>        }<br>    }<br>    <br>    // 用於指定分組數量的方法<br>    override func numberOfSections(in tableView: UITableView) -&gt; Int {<br>        if alarms.count == 0 {<br>            return 1<br>        } else {<br>            return 2<br>        }<br>    }<br>    <br>    // 用於指定每個分組中行數量的方法<br>    override func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -&gt; Int {<br>        if section == 0 {<br>            return 1<br>        } else {<br>            return alarms.count<br>        }<br>    }<br>    <br>    // 用於指定分組標題高度的方法<br>    override func tableView(_ tableView: UITableView, heightForHeaderInSection section: Int) -&gt; CGFloat {<br>        return 35<br>    }<br>    <br>    // 用於指定行是否可編輯的方法<br>    override func tableView(_ tableView: UITableView, canEditRowAt indexPath: IndexPath) -&gt; Bool {<br>        if indexPath.section == 0 {<br>            return false<br>        } else {<br>            return true<br>        }<br>    }<br>    <br>    // 用於指定行高度的方法<br>    override func tableView(_ tableView: UITableView, heightForRowAt indexPath: IndexPath) -&gt; CGFloat {<br>        if indexPath.section == 0 {<br>            return 90<br>        } else {<br>            return 100<br>        }<br>    }<br>    <br>    // 用於配置單元格的方法<br>    override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -&gt; UITableViewCell {<br>        if indexPath.section == 0 {<br>            let cell = tableView.dequeueReusableCell(withIdentifier: &quot;HealthAlarmTableViewCell&quot;, for: indexPath)<br>            cell.backgroundColor = .black<br>            cell.selectionStyle = .none<br>            return cell<br>        } else {<br>            let cell = tableView.dequeueReusableCell(withIdentifier: &quot;AlarmTableViewCell&quot;, for: indexPath) as! AlarmTableViewCell<br>            cell.update(alarms[indexPath.row])<br>            cell.switcher.id = alarms[indexPath.row].id<br>            return cell<br>        }<br>    }<br>    <br>    // 用於處理行選擇的方法<br>    override func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {<br>        if indexPath.section == 0 {<br>            return<br>        }<br>        selectedAlarm = alarms[indexPath.row]<br>        performSegue(withIdentifier: &quot;updateAlarm&quot;, sender: AlarmTableViewCell.self)<br>    }<br><br>    // 用於準備進行 segue 的方法<br>    override func prepare(for segue: UIStoryboardSegue, sender: Any?) {<br>        if sender is UIBarButtonItem {<br>            return<br>        }<br>        <br>        if segue.identifier == &quot;updateAlarm&quot; {<br>            if let navVC = segue.destination as? UINavigationController,<br>               let destinationVC = navVC.viewControllers.first as? AddAlarmViewController {<br>                destinationVC.selectedAlarm = selectedAlarm<br>            }<br>        }<br>    }<br>    <br>    // 用於切換導航欄編輯按鈕的方法<br>    func toggleNavBarEditButton() {<br>        if alarms.count == 0 {<br>            navigationItem.leftBarButtonItem = nil<br>        } else {<br>            navigationItem.leftBarButtonItem = editButtonItem<br>        }<br>    }<br><br>    // 開關切換時的動作方法<br>    @IBAction func clickSwitcher(_ sender: AlarmSwitcher) {<br>        guard let id = sender.id else { return }<br>        let index = alarms.indexOfElement(with: id)<br>        let alarm = alarms[index]<br>        Alarm.updateAlarm(alarm.id, newAlarm: Alarm(<br>            meridium: alarm.meridium,<br>            time: alarm.time,<br>            toggle: sender.isOn == true ? Toggle.ON : Toggle.OFF,<br>            title: alarm.title,<br>            days: alarm.days,<br>            sound: alarm.sound<br>        ))<br>        <br>        if let savedAlarms = Alarm.loadAlarms() {<br>            alarms = savedAlarms<br>            tableView.reloadData()<br>        }<br>    }</pre><p>接著自定義 AlarmTableViewCell</p><pre>import UIKit<br><br>class AlarmSwitcher: UISwitch {<br>    var id: Alarm.ID?<br>}<br><br>class AlarmTableViewCell: UITableViewCell {<br>    @IBOutlet weak var alarmTitle: UILabel!<br>    @IBOutlet weak var switcher: AlarmSwitcher!<br>    @IBOutlet weak var time: UILabel!<br>    <br>    override func awakeFromNib() {<br>        super.awakeFromNib()<br>        // Initialization code<br>        self.backgroundColor = .black<br>        time.textColor = .lightGray<br>        self.selectionStyle = .none<br>    }<br><br>    override func setSelected(_ selected: Bool, animated: Bool) {<br>        super.setSelected(selected, animated: animated)<br><br>        // Configure the view for the selected state<br>    }<br><br>    func update(_ alarm: Alarm) {<br>        let str = alarm.time + alarm.meridium<br>        let myMutableString = NSMutableAttributedString(string: str, attributes: [NSAttributedString.Key.font :UIFont.systemFont(ofSize: 56, weight: UIFont.Weight.light)])<br>        if alarm.time.count &gt; 4 {<br>            myMutableString.addAttribute(NSAttributedString.Key.font, value: UIFont.systemFont(ofSize: 28, weight: UIFont.Weight.light), range: NSRange(location:5, length:2))<br>        } else {<br>            myMutableString.addAttribute(NSAttributedString.Key.font, value: UIFont.systemFont(ofSize: 28, weight: UIFont.Weight.light), range: NSRange(location:4, length:2))<br>        }<br>        time.attributedText = myMutableString<br>        alarmTitle.text = alarm.title<br>        if alarm.toggle == .ON {<br>            switcher.isOn = true<br>            time.textColor = .white<br>            alarmTitle.textColor = .white<br>        } else {<br>            switcher.isOn = false<br>            time.textColor = .lightGray<br>            alarmTitle.textColor = .lightGray<br>        }<br>    }<br>}</pre><p>新增 AddAlarmViewController 處理新增鬧鐘的邏輯</p><pre>import UIKit<br><br>// 枚舉表示鬧鐘時間的組成部分<br>enum AlarmComponent: Int {<br>    case hour = 0<br>    case minute = 1<br>    case meridium = 2<br>}<br><br>class AddAlarmViewController: UIViewController, UIPickerViewDelegate, UIPickerViewDataSource, UITableViewDelegate, UITableViewDataSource, UITextFieldDelegate, ChooseDayViewControllerDelegate, LabelCellDelegate, ChooseSoundViewControllerDelegate {<br><br>    var selectedAlarm: Alarm? // 用於保存所選擇的鬧鐘<br>    var checkedDays: [String] = [] // 用於保存選擇的重複日期<br>    var selectedSound: String = &quot;Departure&quot; // 用於保存所選擇的聲音<br>    var alarmTitle: String? // 用於保存鬧鐘的標題<br>    <br>    @IBOutlet weak var configTableView: UITableView! // 配置設置表視圖<br>    @IBOutlet weak var nav: UINavigationItem! // 導航項目<br>    @IBOutlet weak var timePicker: UIPickerView! // 時間選擇器<br>    <br>    override func viewDidLoad() {<br>        super.viewDidLoad()<br>        <br>        let appearance = UINavigationBarAppearance()<br>        appearance.titleTextAttributes = [.foregroundColor: UIColor.white]<br>        appearance.largeTitleTextAttributes = [.foregroundColor: UIColor.white]<br>        appearance.backgroundColor = .chooseCityBackground<br>        navigationItem.standardAppearance = appearance<br>        navigationItem.scrollEdgeAppearance = appearance<br>        configTableView.backgroundColor = .chooseCityBackground<br>        configTableView.isScrollEnabled = false<br>        <br>        // 如果有選中的鬧鐘，則將已選擇的重複日期、標題和聲音加載到界面上<br>        if let sa = selectedAlarm {<br>            checkedDays = sa.days<br>            alarmTitle = sa.title<br>            selectedSound = sa.sound<br>        }<br>    }<br>    <br>    override func viewDidAppear(_ animated: Bool) {<br>        let formatter = DateFormatter()<br>        formatter.timeZone = TimeZone(secondsFromGMT: 3600 * 8)<br>        formatter.dateFormat = &quot;h/mm/a&quot;<br>        <br>        let result = formatter.string(from: Date()).split(separator: &quot;/&quot;)<br>        // 如果有選中的鬧鐘，則將其時間設置到時間選擇器上<br>        if let sa = selectedAlarm {<br>            timePicker.selectRow(Int(sa.time.split(separator: &quot;:&quot;)[0])! - 1, inComponent: 0, animated: true)<br>            timePicker.selectRow(Int(sa.time.split(separator: &quot;:&quot;)[1])! - 1, inComponent: 1, animated: true)<br>            if (sa.meridium == &quot;AM&quot;) {<br>                timePicker.selectRow(0, inComponent: 2, animated: true)<br>            } else {<br>                timePicker.selectRow(1, inComponent: 2, animated: true)<br>            }<br>        } else {<br>            // 否則，將當前時間設置到時間選擇器上<br>            timePicker.selectRow(Int(result[0])! - 1, inComponent: 0, animated: true)<br>            timePicker.selectRow(Int(result[1])! - 1, inComponent: 1, animated: true)<br>            if (String(result[2]) == &quot;AM&quot;) {<br>                timePicker.selectRow(0, inComponent: 2, animated: true)<br>            } else {<br>                timePicker.selectRow(1, inComponent: 2, animated: true)<br>            }<br>        }<br>    }<br>    <br>    // UIPickerViewDelegate 和 UIPickerViewDataSource 方法<br>    <br>    // 返回時間選擇器中組的數量<br>    func numberOfComponents(in pickerView: UIPickerView) -&gt; Int {<br>        3<br>    }<br>    <br>    // 返回指定組的寬度<br>    func pickerView(_ pickerView: UIPickerView, widthForComponent component: Int) -&gt; CGFloat {<br>        switch component {<br>        case AlarmComponent.hour.rawValue:<br>            return 60<br>        case AlarmComponent.minute.rawValue:<br>            return 50<br>        case AlarmComponent.meridium.rawValue:<br>            return 70<br>        default:<br>            return 100<br>        }<br>    }<br>    <br>    // 返回時間選擇器中指定組和行的標題<br>    func pickerView(_ pickerView: UIPickerView, titleForRow row: Int, forComponent component: Int) -&gt; String? {<br>        switch component {<br>        case AlarmComponent.hour.rawValue:<br>            return String(row + 1)<br>        case AlarmComponent.minute.rawValue:<br>            if row &lt; 9 {<br>                return &quot;0\(String(row + 1))&quot;<br>            } else {<br>                return String(row + 1)<br>            }<br>        case AlarmComponent.meridium.rawValue:<br>            if row == 0 {<br>                return &quot;AM&quot;<br>            } else {<br>                return &quot;PM&quot;<br>            }<br>        default:<br>            return &quot;Error!&quot;<br>        }<br>    }<br>    <br>    // 返回時間選擇器中指定組的行數<br>    func pickerView(_ pickerView: UIPickerView, numberOfRowsInComponent component: Int) -&gt; Int {<br>        switch component {<br>        case AlarmComponent.hour.rawValue:<br>            return 12<br>        case AlarmComponent.minute.rawValue:<br>            return 59<br>        case AlarmComponent.meridium.rawValue:<br>            return 2<br>        default:<br>            return 0<br>        }<br>    }<br>    <br>    // UITableViewDelegate 和 UITableViewDataSource 方法<br>    <br>    // 返回表視圖中的分組數量<br>    func numberOfSections(in tableView: UITableView) -&gt; Int {<br>        if selectedAlarm != nil {<br>            return 2<br>        } else {<br>            return 1<br>        }<br>    }<br>    <br>    // 返回指定分組中的行數量<br>    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -&gt; Int {<br>        if section == 0 {<br>            return 4<br>        } else {<br>            return 1<br>        }<br>    }<br>    <br>    // 配置並返回表視圖中的單元格<br>    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -&gt; UITableViewCell {<br>        if indexPath.section == 0 {<br>            switch indexPath.row {<br>            case 0:<br>                let cell = tableView.dequeueReusableCell(withIdentifier: &quot;RepeatCell&quot;, for: indexPath) as! RepeatCell<br>                if checkedDays != [] {<br>                    if checkedDays.count == 1 {<br>                        cell.labelText.text = &quot;Every \(checkedDays[0])&quot;<br>                    } else if checkedDays.count &lt; 7  {<br>                        cell.labelText.text = checkedDays.map({$0.prefix(3)}).joined(separator:&quot;, &quot;)<br>                    } else {<br>                        cell.labelText.text = &quot;Every day&quot;<br>                    }<br>                }<br>                return cell<br>            case 1:<br>                let cell = tableView.dequeueReusableCell(withIdentifier: &quot;LabelCell&quot;, for: indexPath) as! LabelCell<br>                cell.delegate = self<br>                if let title = selectedAlarm?.title {<br>                    cell.alarmTitle.text = title<br>                }<br>                return cell<br>            case 2:<br>                let cell = tableView.dequeueReusableCell(withIdentifier: &quot;SoundCell&quot;, for: indexPath) as! SoundCell<br>                cell.labelText.text = selectedSound<br>                return cell<br>            default:<br>                return tableView.dequeueReusableCell(withIdentifier: &quot;SnoozeCell&quot;, for: indexPath)<br>            }<br>        } else {<br>            return tableView.dequeueReusableCell(withIdentifier: &quot;DeleteCell&quot;, for: indexPath)<br>        }<br>    }<br>    <br>    // 點擊表視圖中的行時執行的方法<br>    func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {<br>        if indexPath.section == 0 {<br>            switch indexPath.row {<br>            case 0:<br>                // 顯示選擇重複日期的視圖控制器<br>                guard let controller = storyboard?.instantiateViewController(withIdentifier: &quot;\(ChooseDayViewController.self)&quot;) as? ChooseDayViewController else { return }<br>                controller.title = &quot;Repeat&quot;<br>                controller.delegate = self<br>                controller.checkedDays = checkedDays<br>                self.view.endEditing(true)<br>                navigationController?.pushViewController(controller, animated: true)<br>            case 2:<br>                // 顯示選擇鬧鐘聲音的視圖控制器<br>                guard let controller = storyboard?.instantiateViewController(withIdentifier: &quot;\(ChooseSoundViewController.self)&quot;) as? ChooseSoundViewController else { return }<br>                controller.title = &quot;Sound&quot;<br>                controller.delegate = self<br>                controller.selectedSound = selectedSound<br>                self.view.endEditing(true)<br>                navigationController?.pushViewController(controller, animated: true)<br>            default:<br>                return<br>            }<br>        } else {<br>            // 刪除鬧鐘<br>            Alarm.deleteAlarm(selectedAlarm!.id)<br>            performSegue(withIdentifier: &quot;complishAddNewAlarm&quot;, sender: self)<br>        }<br>    }<br>    <br>    // 點擊保存按鈕時執行的方法<br>    @IBAction func clickSaveBut(_ sender: Any) {<br>        let hour = timePicker.selectedRow(inComponent: 0) + 1<br>        let minutes = timePicker.selectedRow(inComponent: 1) + 1<br>        var meridium: String<br>        let meridiumIndex = timePicker.selectedRow(inComponent: 2)<br>        <br>        var time: String<br>        if minutes &lt; 10 {<br>            time = &quot;\(hour):0\(minutes)&quot;<br>        } else {<br>            time = &quot;\(hour):\(minutes)&quot;<br>        }<br>        <br>        if meridiumIndex == 0 {<br>            meridium = &quot;AM&quot;<br>        } else {<br>            meridium = &quot;PM&quot;<br>        }<br>        <br>        // 更新或保存鬧鐘設置<br>        if let sa = selectedAlarm {<br>            Alarm.updateAlarm(sa.id, newAlarm: Alarm(<br>                meridium: meridium,<br>                time: time,<br>                toggle: Toggle.ON,<br>                title: alarmTitle ?? &quot;Alarm&quot;,<br>                days: checkedDays,<br>                sound: selectedSound<br>            ))<br>        } else {<br>            Alarm.saveAlarms(Alarm(<br>                meridium: meridium,<br>                time: time,<br>                toggle: Toggle.ON,<br>                title: alarmTitle ?? &quot;Alarm&quot;,<br>                days: checkedDays,<br>                sound: selectedSound<br>            ))<br>        }<br>        performSegue(withIdentifier: &quot;complishAddNewAlarm&quot;, sender: self)<br>    }<br>    <br>    // 更新鬧鐘標題<br>    func updateAlarmTitle(_ cell: LabelCell) {<br>        alarmTitle = cell.alarmTitle.text ?? &quot;Alarm&quot;<br>    }<br>    <br>    // 選擇日期視圖控制器完成後執行的方法<br>    func didFinishChooseDay(_ controller: ChooseDayViewController) {<br>        checkedDays = controller.checkedDays<br>        configTableView.reloadData()<br>    }<br>    <br>    // 選擇聲音視圖控制器完成後執行的方法<br>    func didFinishChooseSound(_ controller: ChooseSoundViewController) {<br>        selectedSound = controller.selectedSound ?? &quot;Departure&quot;<br>        configTableView.reloadData()<br>    }<br>    <br>    // 點擊取消按鈕時執行的方法<br>    @IBAction func clickCancelBut(_ sender: Any) {<br>        dismiss(animated: true)<br>    }<br>}</pre><p>建立 AlarmStruct 結構</p><pre>import Foundation<br>import UIKit<br><br>let Days: [String] = [&quot;Sunday&quot;, &quot;Monday&quot;, &quot;Tuesday&quot;, &quot;Wednesday&quot;, &quot;Thursday&quot;, &quot;Friday&quot;, &quot;Saturday&quot;]<br><br>struct Alarm: Codable, Identifiable {<br>    var id = UUID() // 鬧鐘的唯一識別符<br>    var meridium: String // AM 或 PM<br>    var time: String // 時間，以 12 小時制表示<br>    var toggle: Toggle // 鬧鐘的開關狀態<br>    var title: String? // 鬧鐘的標題<br>    var days: [String] // 重複的日期<br>    var sound: String // 鬧鐘響起時的聲音<br>    var notificationIdentifier: [String]? // 通知的識別符<br><br>    static let KEY = &quot;Alarms&quot; // 用於 UserDefaults 中存儲鬧鐘數據的鍵<br><br>    // 將鬧鐘保存到 UserDefaults 中<br>    static func saveAlarms(_ savedAlarm: Alarm) {<br>        var alarms = self.loadAlarms() ?? []<br>        var sa = savedAlarm<br>        if sa.toggle == .ON {<br>            sa.registerNotification()<br>        }<br>        alarms.append(sa)<br>        let encoder = JSONEncoder()<br>        guard let data = try? encoder.encode(alarms) else { return }<br>        UserDefaults.standard.set(data, forKey: Alarm.KEY)<br>    }<br><br>    // 從 UserDefaults 中加載鬧鐘數據<br>    static func loadAlarms() -&gt; [Alarm]? {<br>        guard let data = UserDefaults.standard.data(forKey: Alarm.KEY) else { return nil }<br>        let decoder = JSONDecoder()<br>        return try? decoder.decode([Alarm].self, from: data).sortByTime()<br>    }<br><br>    // 刪除指定識別符的鬧鐘<br>    static func deleteAlarm(_ alarmId: UUID) {<br>        var remainAlarms: [Alarm] = []<br>        remainAlarms = Alarm.loadAlarms()!<br>        remainAlarms = remainAlarms.filter { alarm in<br>            if alarm.id != alarmId {<br>                return true<br>            } else {<br>                alarm.unregisterNotification()<br>                return false<br>            }<br>        }<br>        UserDefaults.standard.removeObject(forKey: Alarm.KEY)<br>        remainAlarms.forEach { Alarm.saveAlarms($0) }<br>    }<br><br>    // 更新鬧鐘<br>    static func updateAlarm(_ alarmId: UUID, newAlarm: Alarm) {<br>        Alarm.deleteAlarm(alarmId)<br>        Alarm.saveAlarms(newAlarm)<br>    }<br>}<br><br>// 用於對 Alarm 數組進行排序的擴展方法<br>extension Array where Element == Alarm {<br>    func sortByTime() -&gt; [Alarm] {<br>        let arr = self<br>        return arr.sorted {<br>            var firstTime: Int<br>            var secondTime: Int<br><br>            if $0.meridium == &quot;PM&quot; {<br>                firstTime = Int($0.time.replacingOccurrences(of: &quot;:&quot;, with: &quot;&quot;))! + 1200<br>            } else {<br>                firstTime = Int($0.time.replacingOccurrences(of: &quot;:&quot;, with: &quot;&quot;))!<br>            }<br><br>            if $1.meridium == &quot;PM&quot; {<br>                secondTime = Int($1.time.replacingOccurrences(of: &quot;:&quot;, with: &quot;&quot;))! + 1200<br>            } else {<br>                secondTime = Int($1.time.replacingOccurrences(of: &quot;:&quot;, with: &quot;&quot;))!<br>            }<br><br>            return firstTime &lt; secondTime<br>        }<br>    }<br>}<br><br>// 表示鬧鐘開關狀態的枚舉類型<br>enum Toggle: Codable {<br>    case ON<br>    case OFF<br>}<br><br>// Date 的擴展方法，用於獲取日期對應的星期幾<br>extension Date {<br>    func dayNumberOfWeek() -&gt; Int? {<br>        return Calendar.current.dateComponents([.weekday], from: self).weekday<br>    }<br>}</pre><p>接下來我們透過 delegate 處理在 LabelCell 修改完鬧鐘名稱後傳送資料回 TableView 並且 reloadTable 的邏輯。設定鬧鐘名稱的 LabelCell，首先在 Cell 檔案裡宣告 Protocol</p><pre>protocol LabelCellDelegate {<br>    func updateAlarmTitle(_ cell: LabelCell)<br>}</pre><p>在 LabelCell裡面指定 delegate 變數</p><pre>class LabelCell: UITableViewCell, UITextFieldDelegate {<br>    var delegate: LabelCellDelegate?<br>}</pre><p>選擇在 textFieldDidChangeSelection 的時機執行 updateAlarmTitle</p><pre>func textFieldDidChangeSelection(_ textField: UITextField) {<br>    self.delegate?.updateAlarmTitle(self)<br>}</pre><p>到這裡 delegate 的前置作業完成。接下來我們回到 AddAlarmViewCell 指定自己為 LabelCell 的代理人執行 updateAlarmTitle</p><pre>class AddAlarmViewController: UIViewController, LabelCellDelegate {}</pre><p>第一步先宣告 AddAlarmViewController 遵循 LabelCellDelegate ，接著在 render cell 的時候宣告 delegate 對象為 AddAlarmViewController</p><pre>func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -&gt; UITableViewCell {<br>    ...<br>    let cell = tableView.dequeueReusableCell(withIdentifier: &quot;LabelCell&quot;, for: indexPath) as! LabelCell<br>    cell.delegate = self // 宣告 delegate 對象為 AddAlarmViewController<br>    if let title = selectedAlarm?.title {<br>        cell.alarmTitle.text = title<br>    }<br>    return cell<br>    ...<br>}</pre><p>覆寫 updateAlarmTitle</p><pre>class AddAlarmViewController: UIViewController, LabelCellDelegate {}    <br>    func updateAlarmTitle(_ cell: LabelCell) {<br>        alarmTitle = cell.alarmTitle.text ?? &quot;Alarm&quot;<br>    }<br>}</pre><p>這樣設定好之後，每當使用者更新鬧鐘名字時，也會同步更新 AddAlarmViewController 的 alarmTitle 屬性，選擇鈴聲也是同樣的做法。</p><p>接著我們實作設定鬧鐘時間到的時候的 Local Notification，首先在 AppDelegate 中的 application(_:didFinishLaunchingWithOptions) 設定在使用者第一次開啟 App 的時候跳出是否讓此 App 發送通知的允許</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ML_BtFOQKXAY0ybdHQJpig.png" /><figcaption>詢問使用者是否接受 App 發送通知</figcaption></figure><pre>class AppDelegate: UIResponder, UIApplicationDelegate, UNUserNotificationCenterDelegate {<br>    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -&gt;<br>      let center = UNUserNotificationCenter.current()<br>      center.delegate = self<br>      center.requestAuthorization(options: [.badge, .alert, .sound]) {(granted, error) in<br>          if (granted) {<br>              print(&quot;granted&quot;)<br>          } else {<br>              print(&quot;Do not disturb me.&quot;)<br>          }<br>      }<br>    }<br>}</pre><p>在 AlarmStruct 裡面定義註冊以及取消註冊 notification 的程式</p><pre>struct Alarm: Codable, Identifiable {<br>    ...<br>    // 註冊本地通知<br>    private mutating func registerNotification() {<br>        let content = UNMutableNotificationContent()<br>        content.title = &quot;Alarm Notification&quot;<br>        content.body = self.title ?? &quot;Alarm&quot;<br>        let sound = &quot;\(self.sound).caf&quot;<br>        content.sound = UNNotificationSound(named: UNNotificationSoundName.init(sound))<br>        content.interruptionLevel = .timeSensitive<br><br>        var weekdays: [Int] = []<br>        for day in days {<br>            if Days.contains(day) {<br>                weekdays.append(Days.firstIndex(of: day)!)<br>            }<br>        }<br><br>        if weekdays.count == 0 {<br>            var dateComponents = DateComponents()<br>            dateComponents.calendar = Calendar.current<br>            dateComponents.weekday = Date().dayNumberOfWeek()!<br>            if self.meridium == &quot;PM&quot; {<br>                dateComponents.hour = Int(self.time.split(separator: &quot;:&quot;).first!)! + 12<br>            } else {<br>                dateComponents.hour = Int(self.time.split(separator: &quot;:&quot;).first!)<br>            }<br>            dateComponents.minute = Int(self.time.split(separator: &quot;:&quot;).last!)<br><br>            let trigger = UNCalendarNotificationTrigger(<br>                dateMatching: dateComponents, repeats: false)<br><br>            let uuidString = UUID().uuidString<br>            let request = UNNotificationRequest(identifier: uuidString, content: content, trigger: trigger)<br><br>            UNUserNotificationCenter.current().add(request) { (error) in<br>                if error != nil {<br>                    // Handle any errors.<br>                }<br>            }<br><br>            self.notificationIdentifier = [uuidString]<br>        } else {<br>            self.notificationIdentifier = weekdays.map { weekday in<br>                var dateComponents = DateComponents()<br>                dateComponents.calendar = Calendar.current<br>                dateComponents.weekday = weekday + 1<br>                if self.meridium == &quot;PM&quot; {<br>                    dateComponents.hour = Int(self.time.split(separator: &quot;:&quot;).first!)! + 12<br>                } else {<br>                    dateComponents.hour = Int(self.time.split(separator: &quot;:&quot;).first!)<br>                }<br>                dateComponents.minute = Int(self.time.split(separator: &quot;:&quot;).last!)<br><br>                let trigger = UNCalendarNotificationTrigger(<br>                    dateMatching: dateComponents, repeats: true)<br><br>                let uuidString = UUID().uuidString<br>                let request = UNNotificationRequest(identifier: uuidString, content: content, trigger: trigger)<br><br>                UNUserNotificationCenter.current().add(request) { (error) in<br>                    if error != nil {<br>                        // Handle any errors.<br>                    }<br>                }<br><br>                return uuidString<br>            }<br>        }<br>    }<br><br>    // 取消本地通知<br>    private func unregisterNotification() {<br>        if let ni = self.notificationIdentifier {<br>            UNUserNotificationCenter.current().removePendingNotificationRequests(withIdentifiers: ni)<br>        }<br>    }<br>    ...<br>}</pre><p>以上是我開發 iOS 的一些心得，歡迎大家在下方留言跟我討論程式碼或是遊戲設計。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=db540836dab8" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/7-%E4%B8%8D%E8%83%BD%E8%AA%AA%E5%BE%88%E5%83%8F-%E5%8F%AA%E8%83%BD%E8%AA%AA%E4%B8%80%E6%A8%A1%E4%B8%80%E6%A8%A3%E7%9A%84-ios-%E5%8E%9F%E7%94%9F%E6%99%82%E9%90%98-tab-2-alarms-db540836dab8">#7 不能說很像，只能說一模一樣的 iOS 原生時鐘 Tab 2 Alarms</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[#6 不能說很像，只能說一模一樣的 iOS 原生時鐘 Tab 1 World Clock]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/6-%E4%B8%8D%E8%83%BD%E8%AA%AA%E5%BE%88%E5%83%8F-%E5%8F%AA%E8%83%BD%E8%AA%AA%E4%B8%80%E6%A8%A1%E4%B8%80%E6%A8%A3%E7%9A%84-ios-%E5%8E%9F%E7%94%9F%E6%99%82%E9%90%98-c82fdfb82192?source=rss-dc66ceb35b90------2</link>
            <guid isPermaLink="false">https://medium.com/p/c82fdfb82192</guid>
            <category><![CDATA[ios]]></category>
            <dc:creator><![CDATA[frozenfung]]></dc:creator>
            <pubDate>Thu, 11 Jan 2024 08:03:32 GMT</pubDate>
            <atom:updated>2024-01-27T08:25:58.285Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*UzkzjgzNzLV7pIyI" /><figcaption>Photo by <a href="https://unsplash.com/@moritz_photography?utm_source=medium&amp;utm_medium=referral">Moritz Kindler</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/369/1*yrmwy46PdBrlMN5mZbWrmw.jpeg" /><figcaption>iOS 的內建時鐘</figcaption></figure><p>時鐘對於大部分拿 iPhone 的人來說一點也不陌生，除了購買第一天就內建在手機裡面不用下載之外，鬧鐘功能對於廣大的上班族也是非常關鍵的功能。而對於練習 iOS 專案的我來說，我會選擇他主要的原因是因為這個 App 裡面有非常大量的 iOS 原生的元件以及功能，對於熟悉生態系非常有幫助。</p><h4>實作範圍</h4><p>第一個 Tab World Clock</p><h4>開發過程</h4><p>當初開始實作的時候打算用 ControllerView 包 TableView ，結果馬上就踩到雷，所以後來改成用 TableViewController 實作。先透過 storyboard 設定初始的 TabBarController 和 NavigationController ，確保能運作之後開始設計這個畫面的核心 CityNameClockCell 。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/682/1*yLaQx9fIqSfJquIJ1dGJsQ.png" /><figcaption>CityNameClockCell</figcaption></figure><p>開一個名為 CityNameClockCell 的檔案，並且在 storyboard 指定畫面上 cell 的 custom class 為 CityNameClockCell 。接著透過 storyboard 新增四個 label，並且與檔案建立 IBOutlet connection 方便後續程式呼叫。</p><pre>class CityTableViewCell: UITableViewCell {<br>    @IBOutlet weak var HRS: UILabel!<br>    @IBOutlet weak var PMAM: UILabel!<br>    @IBOutlet weak var cityName: UILabel!<br>    @IBOutlet weak var cityTime: UILabel!<br>}</pre><p>定義 Clock struct</p><pre>struct Clock: Codable {<br>    var city: String<br>    var time: String<br>}</pre><p>設定假的程式資料</p><pre>let cities = [<br>    Clock(city: &quot;Taipei&quot;, time: &quot;4:35&quot;),<br>    Clock(city: &quot;New York&quot;, time: &quot;6:35&quot;) <br>]</pre><p>接著在 WorldClockTableViewController裡面覆寫下面三個 function</p><pre>    override func numberOfSections(in tableView: UITableView) -&gt; Int {<br>        // #warning Incomplete implementation, return the number of sections<br>        1<br>    }<br><br>    override func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -&gt; Int {<br>        // #warning Incomplete implementation, return the number of rows<br>        cities.count<br>    }<br><br>    override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -&gt; UITableViewCell {<br>        let cell = tableView.dequeueReusableCell(withIdentifier: &quot;CityTableViewCell&quot;, for: indexPath) as! CityTableViewCell<br>        cell.update(with: Clock(city: cities[indexPath.row].city, time: cities[indexPath.row].time), isEditing: false)<br><br>        return cell<br>    }</pre><p>稍微調整 UI，現在能夠顯示假資料的世界時鐘頁面。接著我們來建立新增世界時鐘的頁面，先建立 ChooseCityViewController 檔案跟對應的 storyboard，選取城市的區塊也很適合透過 TableView 實作，因此我們在 ChooseCityViewController 裡面加入 TableView ，設定 delegate 以及 dataSource 。設定完成後定義對應的 tableView 函式回傳 numberOfRowSection 以及自定義的 cell 。</p><pre>class ChooseCityViewController: UIViewController, UITableViewDelegate, UITableViewDataSource {<br>    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -&gt; Int {<br>        filteredCities.count<br>    }<br>    <br>    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -&gt; UITableViewCell {<br>        let cell = tableView.dequeueReusableCell(withIdentifier: &quot;ChooseCityTableViewCell&quot;, for: indexPath)<br>        cell.backgroundColor = .chooseCityBackground<br>        cell.textLabel?.text = String(dataset[indexPath.row].split(separator: &quot;/&quot;).last!).replacingOccurrences(of: &quot;_&quot;, with: &quot; &quot;)<br>        cell.selectionStyle = .none<br>        cell.textLabel?.textColor = .white<br>        return cell<br>    }<br>}</pre><p>這個時候 tableView並沒有資料可以顯示，我們透過 TimeZone.knownTimeZoneIdentifiers 取得不同時區的代表城市作為資料來源。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*jPDVnvMHxgZAwXi0toiWiw.png" /><figcaption>TimeZone.knownTimeZoneIdentifiers 裡面的資料跟我自己手機的 Clock App 內的城市還是有些出入</figcaption></figure><p>實作上方的搜尋 bar 以及相關功能，這個做完之後 UI 就差不多完成，其他 UI 細節比較花時間，等到最後再來補強。</p><pre>let searchController = UISearchController()<br>searchController.searchResultsUpdater = self</pre><pre>extension ChooseCityViewController: UISearchResultsUpdating {<br>    func updateSearchResults(for searchController: UISearchController) {<br>        if let searchText = searchController.searchBar.text,<br>           searchText.isEmpty == false  {<br>            filteredCities = dataset.filter({ c in<br>                c.localizedStandardContains(searchText)<br>            })<br>        } else {<br>            filteredCities = dataset<br>        }<br>        cityTableView.reloadData()<br>    }<br>}</pre><p>接著我們要實作新增/刪除時鐘的功能。 資料儲存我這次選擇使用 iOS 內建的 UserDefault 當作暫存空間。回到 Clock struct ，在裡面定義 saveWorldClock loadWorldClocks 跟 removeWorldClocks 三個函示，分別對應到新增，讀取以及刪除三大功能</p><pre>struct Clock: Codable {<br>    var city: String<br>    var time: String<br>    <br>    static let KEY = &quot;worldClocks&quot;<br>    // 新增<br>    static func saveWorldClocks(savedClock: Clock) {<br>        var clocks = self.loadWorldClocks() ?? []<br>        var isClockExisted = false<br>        for clock in clocks {<br>            if savedClock.city == clock.city {<br>                isClockExisted = true<br>            }<br>        }<br>        <br>        if isClockExisted {<br>            return<br>        }<br>        <br>        clocks.append(savedClock)<br>        let encoder = JSONEncoder()<br>        guard let data = try? encoder.encode(clocks) else { return }<br>        UserDefaults.standard.set(data, forKey: Clock.KEY)<br>    }<br>    <br>    // 讀取<br>    static func loadWorldClocks() -&gt; [Clock]? {<br>        guard let data = UserDefaults.standard.data(forKey: Clock.KEY) else { return nil }<br>        print(&quot;loadWorldClocks&quot;)<br>        let decoder = JSONDecoder()<br>        return try? decoder.decode([Clock].self, from: data)<br>    }<br><br><br>    // 刪除  <br>    static func removeWorldClocks(removedClock: String) {<br>        var clocks:[Clock] = []<br>        clocks = Clock.loadWorldClocks()!<br>        print(&quot;clocks.count: \(clocks.count)&quot;)<br>        for (i, clock) in clocks.enumerated() {<br>            if removedClock == clock.city {<br>                clocks.remove(at: i)<br>            }<br>        }<br><br>        UserDefaults.standard.removeObject(forKey: Clock.KEY)<br>        <br>        for clock in clocks {<br>            print(&quot;remain: \(clock)&quot;)<br>            Clock.saveWorldClocks(savedClock: clock)<br>        }<br>    }<br>}</pre><p>定義完成之後， 回到 WorldClockTableView 把原本使用假資料的地方透過新的 API 替換掉</p><pre>/*<br>let cities = [<br>    Clock(city: &quot;Taipei&quot;, time: &quot;4:35&quot;),<br>    Clock(city: &quot;New York&quot;, time: &quot;6:35&quot;) <br>]<br>*/<br><br>// 透過 Clock struct API 讀取資料庫裡面的 World Clock 資料<br>if let worldClocks = Clock.loadWorldClocks() {<br>    cities = worldClocks<br>    tableView.reloadData()<br>}<br></pre><p>最後我們要設定當我們選擇城市後，透過 unwind 關閉 ChooseCityViewController 頁面並且回到 WorldClockViewController ，這邊需要特別注意的是，時鐘相關的資料我們已經透過 saveWorldClock 存進 UserDefault ，因次不需要傳資料回去原本的頁面，等回去 WorldClockViewController 再透過 loadWorldClock 讀取就好。</p><pre>class WorldClockTableViewController: UITableViewController {<br>    @IBAction func unwindToWorldClockTableView(_ unwindSegue: UIStoryboardSegue) {<br>        if let worldClocks = Clock.loadWorldClocks() {<br>            cities = worldClocks<br>            // 有新增一筆資料 reloadData 顯示新資料<br>            tableView.reloadData()<br>        }<br>    }<br>}</pre><p>最後是左上方的時鐘編輯功能，這部分我們直接透過 iOS 內建的功能實作，覆寫 setEditing ，這樣就大功告成了。</p><pre>  override func setEditing(_ editing: Bool, animated: Bool) {<br>      super.setEditing(editing, animated: animated)<br>      if let indexPaths = tableView.indexPathsForVisibleRows {<br>          for indexPath in indexPaths {<br>              let clock = cities[indexPath.row]<br>              if let cell = tableView.cellForRow(at: indexPath) as? CityTableViewCell {<br>                  cell.update(with: clock, isEditing: isEditing)<br>              }<br>          }<br>      }<br>  }</pre><p>最後的最後，補上沒有時鐘的時候 tableView 會顯示 No World Clocks 的做法。主要是透過 setNeedUpdateContentUnavailableConfigurationState() 以及 func updateContentUnavailableConfigurationState() 搭配來進行</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kUeCXCS_LHvjiE9bIUCJoA.png" /><figcaption>沒有時鐘時顯示 No World Clocks</figcaption></figure><pre>  override func updateContentUnavailableConfiguration(using state: UIContentUnavailableConfigurationState) {<br>      var config: UIContentUnavailableConfiguration?<br>      if cities.count == 0 {<br>        var empty = UIContentUnavailableConfiguration.empty()<br>        empty.background.backgroundColor = .black<br>        empty.text = &quot;No World Clocks&quot;<br>        empty.textProperties.color = .lightGray<br>        config = empty<br>      }<br>      contentUnavailableConfiguration = config<br>  }</pre><h4>實作畫面</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/295/1*zA1KEy7vJNWtx5pulk2Swg.gif" /><figcaption>最終成品</figcaption></figure><p>以上是我開發 iOS 的一些心得，歡迎大家在下方留言跟我討論程式碼或是遊戲設計。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=c82fdfb82192" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/6-%E4%B8%8D%E8%83%BD%E8%AA%AA%E5%BE%88%E5%83%8F-%E5%8F%AA%E8%83%BD%E8%AA%AA%E4%B8%80%E6%A8%A1%E4%B8%80%E6%A8%A3%E7%9A%84-ios-%E5%8E%9F%E7%94%9F%E6%99%82%E9%90%98-c82fdfb82192">#6 不能說很像，只能說一模一樣的 iOS 原生時鐘 Tab 1 World Clock</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[#5 甜甜圈消除遊戲 App 開發日誌]]></title>
            <link>https://medium.com/peter-pan-swift-ios-class/5-%E7%94%9C%E7%94%9C%E5%9C%88%E6%B6%88%E9%99%A4%E9%81%8A%E6%88%B2-app-%E9%96%8B%E7%99%BC%E6%97%A5%E8%AA%8C-a1b075c6c28b?source=rss-dc66ceb35b90------2</link>
            <guid isPermaLink="false">https://medium.com/p/a1b075c6c28b</guid>
            <category><![CDATA[ios]]></category>
            <category><![CDATA[game-development]]></category>
            <dc:creator><![CDATA[frozenfung]]></dc:creator>
            <pubDate>Tue, 26 Dec 2023 07:55:25 GMT</pubDate>
            <atom:updated>2023-12-26T10:29:42.387Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*XlhVLWNi_RsO7sdg" /><figcaption>Photo by <a href="https://unsplash.com/@fkaregan?utm_source=medium&amp;utm_medium=referral">Samuel Regan-Asante</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><p>延續<a href="https://medium.com/%E5%BD%BC%E5%BE%97%E6%BD%98%E7%9A%84-swift-ios-app-%E9%96%8B%E7%99%BC%E6%95%99%E5%AE%A4/4-%E7%94%9C%E7%94%9C%E5%9C%88%E6%B6%88%E9%99%A4%E9%81%8A%E6%88%B2-app-%E9%96%8B%E7%99%BC%E6%97%A5%E8%AA%8C-71ac7f0a6da4">上一篇</a>繼續開發新功能</p><h4>更新畫面</h4><figure><img alt="" src="https://cdn-images-1.medium.com/max/295/1*6FLnz3XNgrXmVOetVU5ZAA.gif" /></figure><h4>練習內容</h4><p>利用 Airtable 當作後端資料庫，開啟 Airtable API 功能，實作透過 iOS 介面<strong>讀取排行榜</strong>以及<strong>新增排行榜資料</strong>兩個功能</p><h4>開發過程</h4><p>先到 Airtable 後台開啟串接資料用的資料表，並設定好對應的欄位，以這個案例來看需要設定兩個欄位： name 用於記錄玩家名稱， matchCount 用於記錄甜甜圈配對次數。接著到 Airtable 後台取得 API Key，並且設定讀取以及寫入的權限。</p><p>取得 API Key 之後，首先我們要把排行榜的 data source 從原本自行建立的假資料轉換到 Airtable 上面的資料。在 LeaderBoardTableViewController 中定義 decode 的資料結構：</p><pre>struct LeaderBoardRecords:Decodable {<br>    let records:[Record]<br>    <br>    struct Record:Decodable {<br>        let id:String<br>        let createdTime:String<br>        let fields:Fields<br>    }<br><br>    struct Fields:Decodable {<br>        var name:String<br>        var matchCount:String<br>    }<br>}</pre><p>定義完成之後宣告 fetchLeaderBoardData</p><pre>        let url = URL(string: &quot;https://api.airtable.com/v0/APP_ID/Table%201&quot;)!<br>        var request = URLRequest(url: url)<br>        request.setValue(&quot;Bearer API_KEY&quot;, forHTTPHeaderField: &quot;Authorization&quot;)<br>        <br>        URLSession.shared.dataTask(with: request) { data, response, error in<br>            if let data {<br>                let decoder = JSONDecoder()<br>                do {<br>                    let lbs = try decoder.decode(LeaderBoardRecords.self, from: data)<br>                    for rec in lbs.records {<br>                        self.players.append(rec.fields)<br>                    }<br>                    self.players = self.players.sorted(by: { Int($0.matchCount)! &lt; Int($1.matchCount)! })<br>                    DispatchQueue.main.async {<br>                        self.tableView.reloadData()<br>                    }<br>                } catch {<br>                    print(error)<br>                }<br>            } else if let error {<br>                print(error)<br>            }<br>        }.resume()</pre><p>透過 URLSession.share 在背景執行，當我們從 Airtable API 取得最新的排行榜資訊後，需要特別注意的是記得透過 tableView.reloadData() 更新資料到畫面上，因為跟畫面有關，所以透過 DispatchQueue.main.async 確保更新資料的邏輯在 main thread 執行。</p><p>接著我希望在玩家登陸記錄的同時新增排行榜，因此我在 ShowGradeViewController 裡面定義了新增排行榜的函式</p><pre>    func uploadRank() {<br>        let url = URL(string: &quot;https://api.airtable.com/v0/APP_ID/Table%201&quot;)!<br>        var request = URLRequest(url: url)<br>        request.httpMethod = &quot;POST&quot;<br>        request.setValue(&quot;Bearer API_KEY&quot;, forHTTPHeaderField: &quot;Authorization&quot;)<br>        request.setValue(&quot;application/json&quot;, forHTTPHeaderField: &quot;Content-Type&quot;)<br>        let encoder = JSONEncoder()<br>        let httpBody = RankBody(records: [<br>            .init(fields: .init(<br>                name: inputName,<br>                matchCount: String(grade)<br>            ))<br>        ])<br>        request.httpBody = try? encoder.encode(httpBody)<br>        URLSession.shared.dataTask(with: request) { data, response, error in<br>            if let data,<br>               let content = String(data: data, encoding: .utf8) {<br>            }<br>        }.resume()<br>    }</pre><p>同時在檔案上方定義 RankBody 作為 httpBody 的資料格式參照</p><pre>struct RankBody:Encodable {<br>    let records: [Record]<br>    <br>    struct Record: Encodable {<br>        let fields: Fields<br>    }<br>    <br>    struct Fields: Encodable {<br>        let name:String<br>        let matchCount:String<br>    }<br>}</pre><p>最後在 UIAlertAction 中呼叫我們新定義的 uploadRank</p><pre>        let saveAction = UIAlertAction(title: &quot;Save&quot;, style: .default) { _ in<br>            // this code runs when the user hits the &quot;save&quot; button<br>            self.inputName = self.alertController.textFields![0].text!<br>            self.uploadRank() // upload to Airtable<br>            self.performSegue(withIdentifier: &quot;showLeaderBoard&quot;, sender: nil)<br>        }</pre><p>到 Airtable 後台也能看到新上傳的玩家紀錄</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/898/1*MEvcAp2Dj29FmbrGsr9yFw.png" /></figure><p>以上是我開發 iOS 的一些心得，歡迎大家在下方留言跟我討論程式碼或是遊戲設計。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=a1b075c6c28b" width="1" height="1" alt=""><hr><p><a href="https://medium.com/peter-pan-swift-ios-class/5-%E7%94%9C%E7%94%9C%E5%9C%88%E6%B6%88%E9%99%A4%E9%81%8A%E6%88%B2-app-%E9%96%8B%E7%99%BC%E6%97%A5%E8%AA%8C-a1b075c6c28b">#5 甜甜圈消除遊戲 App 開發日誌</a> was originally published in <a href="https://medium.com/peter-pan-swift-ios-class">彼得潘的 Swift iOS / Flutter App 開發教室</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[2023 書單]]></title>
            <link>https://medium.com/@frozenfung/2023-%E6%9B%B8%E5%96%AE-136c33fc3304?source=rss-dc66ceb35b90------2</link>
            <guid isPermaLink="false">https://medium.com/p/136c33fc3304</guid>
            <category><![CDATA[books]]></category>
            <dc:creator><![CDATA[frozenfung]]></dc:creator>
            <pubDate>Mon, 25 Dec 2023 05:23:15 GMT</pubDate>
            <atom:updated>2023-12-25T05:23:15.736Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*IxEp7-4yhmMtzWAb" /><figcaption>Photo by <a href="https://unsplash.com/@syinq?utm_source=medium&amp;utm_medium=referral">Susan Q Yin</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><p>又到了一年一度整理書單的點，相較於<a href="https://medium.com/@frozenfung/2022-%E6%9B%B8%E5%96%AE-eb546bfd1c4f">去年</a>，今年看得書少了許多，不過就一併把他們整理上來，信義誠品這兩天收了之後也該找下一個能夠試閱的地方。</p><ul><li>誰搬走了我的乳酪</li><li>大眾傳播與美利堅帝國</li><li>情感資本主義：從情感獨裁到情感救贖</li><li>萬曆十五年</li><li>規模與範圍</li><li>IKIGAI‧生之意義：每天早上醒來的理由，那些微不足道的事物，就是IKIGAI</li><li>多重伴侶下的安全感：依附關係、創傷理論，與知情同意的開放式關係</li><li>呼吸，為了療癒：全新的呼吸科學與醫學，透過清醒的呼吸，徹底轉化身心</li><li>當下的力量: 找回每時每刻的自己</li><li>P.E.T 父母效能訓練</li><li>空港粉碎</li><li>二十一世紀機器人新律: 如何打造有AI參與的理想社會?</li><li>用你的不平等優勢創業</li><li>7大市場力量：商業策略的基礎</li><li>創新的用途理論</li><li>底層邏輯2</li><li>呼吸革命</li><li>3.3 秒的呼吸奧秘</li><li>好策略壞策略</li><li>常勝者的策略</li><li>策略布局</li><li>百年企業策略轉折點</li><li>全球800CEO必備的應變智商</li><li>獲利世代</li><li>新企業參謀</li><li>多元獲利模式大全</li><li>解構顧客價值鏈</li><li>生態系競爭策略</li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=136c33fc3304" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>