【2026 最新】Hob 新手教學：本機 AI 怎麼整理 CSV、讀 PDF、輸出圖表？（五步練習）

你有一份銷售 CSV、一頁計算規則 PDF，想請 AI 整理成圖，卻不想先研究模型部署。這篇 Hob 新手教學會帶你用小份假資料，把「讀檔、計算、交件」拆成看得懂的五步練習。

專為沒有技術背景的讀者寫：你只需要會存文字檔、列印成 PDF、打開資料夾。本文是依官方文件與公開程式碼設計的練習指南，操作說明以 Apple silicon Mac 介面為主，並拆開其他平台的 PDF 讀取路徑。文中的合計是範例資料的標準答案；產品圖片採官方示範，兩者分開看。

先說結論：本機助手＝本機模型＋檔案工具＋你的驗收

Hob 可以先想成「坐在你電腦裡、帶著工具箱的助理」。模型負責理解需求，工具負責開檔與計算，你負責判斷交回來的檔案是否符合要求。能聊天只是第一關，能把四筆有效交易算成 270，才是這次要完成的事。

截至 2026 年 10 月 27 日，官方倉庫提供 Mac、Windows、Linux 下載，首頁列出至少 8 GB 記憶體；Mac 指 Apple silicon。這是入門條件，不能據此推定某台電腦能快速完成文件工作。官方以 llama.cpp 在本機執行模型，並自動依硬體選模。

先記住一條學習順序：先做對一個小任務，再增加文件量。想補足「模型怎麼變成能做事的助手」這個觀念，可先讀 Agent Harness 白話解釋；這篇直接從操作與交件開始。

Hob 新手教學第一步：從官方下載，記下這台電腦的條件

怕一開始就選錯模型？先交給程式選。從 官方 Releases 下載頁取得適合作業系統的安裝檔。查核當下的 latest 指向 v0.2.1；本文也交叉閱讀當天 main 分支的文件與程式碼，不把開發分支畫面當成每個安裝版都相同。

Mac 可從  → 關於這台 Mac記下晶片與記憶體。打開 Hob 後，記錄啟動畫面選到的模型、顯示的下載大小，再按 Download and start。先讓必要資產下載完成，才進行離線練習。軟體的開源授權與模型的授權分開管理；模型檔也會占用你的磁碟空間。

在 Settings → Model 可查看模型；目前主分支的按鈕包括 Use model、Download & use。新手先保留自選模型，記錄開始時間、出現第一段回答的時間與最後完成時間。下載花多久，和模型做一份報表花多久，是兩個時鐘。先問一句「請用繁體中文打招呼」，確認基本對話，再碰檔案。

PDF 要分清讀取路徑：原生 PDF helper檢查 macOS，使用 Apple PDFKit／Vision；但 一般 read_file 工具在原生讀取失敗時，另有 Python 預覽備援，使用 pypdf 讀取文字。原生工具限 Mac，不等於整個產品的文字 PDF 讀取都限 Mac。Windows、Linux 讀者也可用這份一頁文件嘗試，先核對能否抽出原句；若改成把規則文字貼進對話，只計為規則運用練習，不計為 PDF 讀取過關。

第二步：準備三份小檔案，把答案留在工作區外

不知道該給 AI 什麼資料？先造一個你自己能算完的例子。在文件資料夾建立 hob-practice，只放兩份輸入：sales.csv 與 rules.pdf。第三份 answer.txt 放在旁邊，不要把它所在的上層資料夾授權給 Hob。答案留在自己手上，才能檢查它是否真的從資料算出結果。

用純文字編輯器建立 sales.csv，以 UTF-8 儲存下列內容。Mac「文字編輯」可先選 格式 → 製作純文字；存檔後確認名稱沒有多出 .txt。CSV 就是「每行一筆、用逗號隔開欄位」的小表格。這裡的金額都用同一個虛構單位。

order_id,region,amount,status
101,North,120,paid
102,South,80,paid
103,North,30,refunded
104,South,50,paid
105,North,20,paid

接著用一般文件編輯器打一頁規則，透過 列印 → 儲存為 PDF 存成 rules.pdf。內容只放以下三句：

Include only rows where status is paid.
Sum amount by region.
Mark a region ready when its total is at least 135; otherwise mark it hold.

儲存後用 PDF 閱讀器打開，確認文字可選取。這次先練文字型 PDF：把規則讀清楚，再學掃描件的文字辨識。最後把下面答案存到工作區外的 answer.txt：

有效交易：4 筆
North：120 + 20 = 140，ready
South：80 + 50 = 130，hold
有效金額總計：270
排除：order_id 103，refunded，amount 30

這個例子刻意放一筆退款。若把全部列直接相加會得到 300，正好能抓出「圖畫得漂亮，篩選規則卻沒套用」的錯誤。門檻也放在兩區合計之間：North 過關、South 未過關，才看得出 PDF 規則是否被正確使用。

第三步：建立 Project，先讓 CSV 交回可核對的合計

不想讓助手翻遍整部電腦？從側欄 Projects 的新增入口建立專案，按 Add folder 只加入 hob-practice。命名為「Hob 三檔練習」，在 Instructions (optional) 寫「用繁體中文回答；原始輸入保留；結果另存新檔」，再按 Create project。

專案指示像交班紙條；Hob 內建檔案操作則依資料夾授權判定路徑。這不代表每種工具都有相同隔離。Windows Python 執行器的程式註解明列：低完整性程序限制寫入，讀取與網路仍開放。練習工作區只放假資料，離線驗收要實際切斷網路。進入專案對話後，先送一個只做 CSV 的小任務：

請只讀取 sales.csv，先列出欄位名稱及總列數。只納入 status 等於 paid 的資料，依 region 加總 amount，列出有效筆數、各區合計與總計。請用計算工具處理，另存新檔 totals.csv，保留 sales.csv。這一步先不讀 PDF，也不要搜尋網路。

拿到回答後，打開 totals.csv，對照工作區外的答案：四筆有效交易、North 140、South 130、合計 270。聊天裡寫出檔名，和你真的能在資料夾裡打開檔案，是不同的完成條件。若它回 300，先追問排除了哪一列，再要求重算，先別進入畫圖。

用固定欄名、單一幣別和一個篩選規則，是為了讓你知道哪一步出錯。等小例子穩定，再加入空值、重複訂單或不同日期格式；一次只增加一種變化，才分得出是資料問題還是指令問題。

Hob 新手教學第四步：讀 PDF 規則，再輸出圖表

合計對了之後，才讓第二份輸入加入工作：

請讀取 rules.pdf，先引用與篩選及 ready 門檻有關的原句，說明它們的意思，再依 sales.csv 計算。請另存 region_review.csv，欄位為 region、total、decision，並畫一張各區有效金額長條圖。圖上保留 North、South 與金額，圖名不要宣稱全部訂單收入。原始 CSV、PDF 都保留。

你要驗收兩層：PDF 抽出的句子與原文件一致；套規則後的結果是 North＝140／ready、South＝130／hold。「at least 135」代表包含 135，不是嚴格大於。這一步是在教助手按文件辦事，並讓每個判斷有可回查的根據。

Hob 的 圖表工具可在對話中繪圖；圖表卡片提供 Download PNG。下載後用圖片檢視器打開，核對兩根長條的數字、區域名稱與標題。需要把 PNG 放回練習資料夾時，在下載儲存視窗自行選取該資料夾。

若畫面只顯示文字，先要求「請實際建立圖表卡片」，再確認是否能下載。若下載了卻讀不清標籤，就簡化圖名、使用 North／South 等現成欄值。你的目標是一張能交給別人核對的圖，而不是讓對話看起來完成了。

第五步：把修改批准、Undo 與離線分開驗收

想知道它改檔前會怎麼問？先把原始 sales.csv 手動備份到工作區外，另開一次任務，要求：「只把 order_id 101 的 amount 從 120 改成 121，其餘不動。」維持預設批准方式，查看批准卡的路徑與動作，只選單次 Allow，先不要選 Always in this folder。

這裡要修正一個常見想像。依目前 檔案權限判定，一般專案資料夾內的讀取與新建檔案可自動執行；修改既有檔案通常會詢問，持續允許等設定會改變行為。因此，剛才新增 totals.csv 沒跳卡片，和修改原始 sales.csv 的批准，是兩種情況。

修改後自己打開 CSV，確認 120 變成 121，再按該次任務的 Undo；再次開檔，檢查是否回到 120。官方 專案測試也包含新增檔案後以 Undo 移除的情境，但測試使用替身模型，不能拿來當模型理解需求或所有還原情境都成功的證明。若眼前結果不符預期，先保留備份與紀錄，停止拿原始文件練習。

接下來測離線。先完成模型與必要工具下載，在 Settings → Privacy → Web access 關閉網頁存取；到 Settings → Connectors 停用自己加過的連接器，這次不新增外掛。官方 Connector 文件明確指出 MCP server 不在 Hob 的沙箱內；外接工具的權限與本機 Python 工具要分開判讀。

先恢復原始輸入，再關閉 Wi-Fi 並拔除其他網路連線；開一個新的專案對話，以相同提示重做兩份輸入。核對合計 270、判定及匯出的 PNG，並記錄失敗停在哪一步。斷網重跑成功，只證明這個配置能離線完成這個任務。它不等於你已檢查所有背景通訊或完成安全稽核；模型下載、更新檢查和新套件安裝也應與日常已備妥的工作分開。

三個常見坑：跑得動、做得對、離得開網路，各自看證據

• 卡在下載：先查看下載狀態、剩餘磁碟空間與網路；還沒備妥的資產，不拿來評斷離線任務速度。
• 算對卻沒有交件：逐一開啟 CSV 和 PNG；圖表數據要能與彙總檔對上，PDF 的規則句子要能在原文找到。
• 為了修一個錯誤一路加工具：先縮短問題、保留兩個輸入。官方 Python 工具說明把網路權限、套件與沙箱分開列出；先知道缺的是哪一層，再決定是否增加工具。

Hob 適合先拿來練單一資料夾裡、答案可核對的小工作。若你的主要問題是自行部署模型、控制 GPU 或串接自製系統，學習路徑會更接近 本機模型部署教學。這次先把現成產品操作熟，再決定要不要往底層走。

常見問題：八個新手先講答案

1. Hob 是什麼？

是能使用檔案工具的本機 AI 桌面助手。把理解需求的模型與開檔、執行程式、畫圖等能力接在一起；本篇用交件驗收來學它。

2. 8 GB 記憶體就一定順嗎？

不一定。這是倉庫列出的入門門檻。能用哪個模型、每一步等多久，要依你選到的模型、電腦與實際任務記錄。

3. 需要先懂 Python 嗎？

這份練習不用。你負責提供清楚欄位與規則，請 Hob 使用計算工具；若它交不出檔案，就把任務縮回讀欄位與加總。

4. Windows、Linux 可以跟做嗎？

可從同一份假資料開始驗收。文字 PDF 可由一般讀檔工具走 Python 預覽備援；目前程式只預覽前五頁、每頁最多 1,500 字元，所以先用本文的一頁規則。PDF 原句要實際讀出，不能拿貼入文字冒充讀檔成功。

5. 關閉 Web access 就涵蓋 Connector 嗎？

要另外檢查 Connector。官方把自加連接器另列為連線來源；第一次離線練習先停用它們，並實際切斷電腦網路。

6. 新增 CSV 沒問我，代表批准壞了嗎？

不一定。專案內新建檔案與修改既有檔案有不同判定；用備份過的小檔案驗收修改動作，並檢查持續允許設定。

7. 官方截圖能證明繁中資料算得準嗎？

不能據此判定。截圖展示介面與功能位置，本文列出的標準答案才是你這次練習要逐項核對的目標。

8. 一次通過後可以換真實文件嗎？

先增加一點難度。加入一筆空值或不同日期格式，確認自己看得出錯誤再換資料；帳號密碼、私人身分資料先留在練習工作區外。

給新手的三個重點

• 先備妥：記下版本、硬體、模型與下載需求。
• 先算對：四筆有效交易合計 270，North 140、South 130，PDF 判定一區 ready、一區 hold。
• 再擴大：修改批准、Undo、斷網重跑各自留下結果，再增加資料量。