說明文件

啟動精靈

啟動精靈會在您首次開啟應用程式時執行。它會引導您選擇使用模式、選擇是否啟用 AI 功能、設定加密與同步，並檢視您的後續步驟——讓應用程式調整為符合您實際的使用方式。

選擇您的模式

設定步驟

1. 選擇您的語言以及最符合您使用習慣的模式 — 個人管家、專業庫存或完整版。
2. 在AI 超能力畫面中,決定是否啟用影像辨識(拍張照片,AI 自動填入物品詳情)及銷售描述(AI 為市集撰寫吸睛的商品說明)。
3. 在個人化中調整外觀,在安全鎖定?中啟用端對端加密,並在您的資料居所中啟用多裝置同步。
4. 查看準備就緒!摘要 — 包含新增 AI API 金鑰、設定 Square 及啟用同步的快速連結 — 然後點選開始使用進入主畫面儀表板。

注意:若您選擇啟用加密,精靈將執行一段簡短的後續流程來建立加密密碼並儲存復原片語 — 請將復原片語妥善保存於安全處,因為這是您忘記密碼時找回資料的唯一方法。精靈中的所有選擇日後皆可在設定中修改。

首頁儀表板

首頁畫面是您的核心樞紐。它會顯示您所有的項目、簽入/簽出狀態,並透過底部標籤導覽快速存取每個主要功能。

底部標籤導覽

本應用程式使用底部標籤列在主要區段之間導覽:

項目管理

項目是 Where The Bleep 的核心。每個項目都可以有照片、描述、類別、中繼資料（序號、購入價格、估計價值、保險參考編號）以及位置指派。

建立項目

1. 點選首頁上的 + 收納新物品按鈕
2. 新增標題與描述—或點選 AI 相機按鈕拍照後讓 AI 自動生成
3. 從選擇器中選取類別
4. 透過瀏覽位置樹來指定位置
5. 可選擇性新增照片、序號、購買價格、估計價值和保險資訊
6. 如果您想追蹤數量,請開啟有庫存
7. 點選儲存

項目狀態

項目操作

位置

位置以階層方式組織。容器位置（房間、建築物、衣櫃）可以容納其他容器或目的地。目的地位置是項目實際儲存的地方 — 特定的層架、抽屜或盒子。

位置功能

• 麵包屑路徑— 例如「家 > 辦公室 > 書桌」
• 旭日圖— 整個位置樹的互動式視覺化
• QR 標籤— 為任何目的地位置產生兩種 Avery 範本格式的可自訂 QR 碼標籤
• 項目數量— 查看每個位置儲存的項目數量
• 列印為 PDF— 將 QR 碼標籤頁匯出為 PDF，可在標準標籤紙上列印
• 選擇性重新列印— 僅列印未列印的標籤、重新列印單一標籤，或一次列印所有標籤
• 搜尋— 全文與語音搜尋，可依名稱或內部儲存內容跳至任何位置

管理位置

QR Code 與標籤

每個目的地位置都可以擁有一個 QR Code 標籤，掃描後即可立即開啟該位置並辦理物品的入庫或出庫。標籤可完全自訂，並可列印為兩種 Avery 範本——Avery 5160（1 × 2-5/8 英吋）或較大的 2 × 4 英吋格式。標籤使用 belongings://loc/{uuid} URI 結構描述，因此任何支援深層連結的 QR 掃描器皆可開啟。

QR 標籤工作流程

1. 前往目的地位置
2. 點選 QR Code 圖示以產生標籤
3. 可單張列印標籤，或使用批次 PDF 匯出一次列印多張
4. 將標籤貼到實體位置上（架子、箱子、抽屜）
5. 若要將物品入庫，請使用 App 內建相機掃描 QR Code

QR 狀態追蹤

列印選項

• 標籤格式——可選擇 Avery 5160（1 × 2-5/8 英吋）或較大的 2 × 4 英吋範本，並支援垂直或水平版面
• 自訂標籤——可獨立調整位置名稱與 ID 代碼的尺寸滑桿，並可切換顯示或隱藏麵包屑路徑
• 頂部邊界偏移——微調列印起始位置，讓部分使用過的標籤紙能正確對齊
• 包含條碼編號——在每個 QR 下方列印原始 ID，以便在無法掃描時可手動輸入
• 僅待重印——批次列印時跳過已列印的標籤，避免浪費標籤紙
• 另存為 PDF——傳送至印表機前先在螢幕上預覽整張標籤紙

使用「已列印」切換按鈕來重印個別標籤，無需再次批次列印全部標籤。

搜尋與語音

搜尋採用 SQLite FTS5 技術，可在物品名稱、描述和標籤中進行極速全文搜尋。麥克風使用裝置端語音轉文字，並可在應用程式的每個文字欄位中使用 — 不僅限於搜尋列。

搜尋功能

• 全文搜尋 — 在名稱、描述和標籤中尋找符合項目
• 前綴比對 — 開始輸入即可立即顯示結果
• 語音搜尋 — 輕觸麥克風圖示並說出您的查詢
• 依位置篩選 — 將結果縮小至特定房間或區域
• 依類別篩選 — 僅顯示特定類別中的物品
• 依狀態篩選 — 存放中、已借出、待售中等
• 每個欄位皆可語音輸入 — 麥克風適用於物品名稱與描述、上架備註、要價、簽入 / 簽出名稱，以及應用程式中任何其他文字輸入
• 在位置內搜尋 — 在位置樹狀結構上方使用語音或文字搜尋，依名稱跳至房間、抽屜或容器

人員與借出

管理可借用您物品的人員清單。每個人可以包含電話號碼、電子郵件、地址、關係(家人、同事等)和自由格式備註。應用程式提供兩個獨立的操作:<strong>取出</strong>會將物品從其位置移除,而<strong>借出</strong>則會將物品指派給特定人員,並可選擇性設定<strong>預期歸還日期</strong>。已取出和已借出的物品會顯示在主畫面儀表板上各自的標籤中,讓您隨時掌握所有物品的位置。

取出與外借工作流程

1. 在物品詳細資料畫面中，點選「取出」將物品自其位置移除，或點選「外借」將其指派給某人
2. 若選擇「外借」，請從聯絡人中選取一位對象，或新增一位
3. 物品狀態會變更為「已取出」或「已外借」，並顯示對方姓名
4. 如要歸還，請點選「歸還」—物品會回到「已收納」狀態

管理人員

事件歷史記錄

每次簽入、簽出和外借都會記錄時間戳記。可從項目的詳細資料畫面查看歷史記錄。

庫存追蹤

可選擇對任何項目啟用庫存計數——獨立於借出/歸還之外。追蹤消耗品、用品或任何您持有多個的物品數量。

運作方式

1. 建立或編輯項目時，開啟啟用庫存
2. 設定初始數量
3. 在項目詳細資料畫面，使用 + 和 - 按鈕調整數量
4. 點按數字本身可手動設定特定數量
5. 所有變更都會在庫存歷史記錄中附帶時間戳記

庫存報表

點按庫存切換按鈕旁的報表圖示即可產生 PDF 庫存報表。報表包含項目縮圖、目前數量以及完整的變更歷史表格。可透過系統分享面板儲存或分享 PDF。

條碼掃描

點選庫存標籤上的綠色 QR 圖示開啟庫存掃描 — 一個即時相機掃描器,具有兩個調整庫存的標籤:進貨用於入庫項目,手動用於設定確切數量。出庫庫存則透過 POS 中的銷售掃描處理,詳見 Square POS 章節。

庫存不足與缺貨

為任何已追蹤的項目設定補貨點。當現有數量達到或低於該點時，庫存分頁會顯示橘色的庫存不足標記；當數量歸零時則顯示紅色的缺貨標記。儀表板摘要圖塊和首頁警示卡片都會顯示這些數量，讓您不必特地尋找便能發現短缺，而庫存不足和缺貨篩選標籤可將清單縮小至受影響的項目。

盤點

從 ⋮ 選單開啟盤點，選擇目標位置，然後逐一巡檢該位置的所有追蹤項目，輸入您在貨架上看到的實際數量。畫面會在您輸入的數值旁顯示預期數量，並以綠色或紅色箭頭標示差異。儲存後，應用程式只會記錄已變動的項目，並可為每筆調整附上原因和備註。

CSV 匯入

從 ⋮ 選單選擇從 CSV 匯入並選擇含有兩欄的檔案 — barcode_or_name 和 quantity。長度為 8-14 位數的數值會被視為條碼;其他值則會與項目名稱進行模糊比對。第一列會自動偵測為標題列。匯入會記錄為 CSV 匯入調整,因此您可以追溯任何變更回到原始檔案。

損壞與遺失追蹤

當盤點數量短缺時,以原因標記差異 — 損壞、計算錯誤、過時、變質、失竊或其他。原因會輸入 ⋮ 選單下的兩份報告:差異(每筆調整的原始清單)和損耗報告(依原因和日期範圍分組的總計),兩者皆可匯出為 PDF 用於保險或期末檢視。

庫存儀表板

庫存分頁是所有庫存相關事務的主要據點：包含追蹤項目、總單位數和庫存不足的摘要卡片；全部、庫存不足和缺貨的篩選標籤；全文及語音搜尋；浮動 QR 掃描按鈕；印表機快捷鍵；以及可開啟盤點、轉移、CSV 匯入和四種內建報表（庫存水平、異動、估值和損耗）的 ⋮ 選單。

Square POS

Where The Bleep 在銷售分頁中內建了銷售點 (POS) — 一個由條碼掃描器驅動的購物車,可交由 Square 處理刷卡付款。您也可以使用內建的找零計算來收取現金,或記錄透過其他管道支付的銷售。每個收銀工作階段開啟時都會顯示今日摘要(銷售、退貨、淨額)以及最近交易清單,您可以重新列印或退款。

付款方式

結帳工作流程

1. 在銷售分頁中，點選綠色的 QR 掃描按鈕以開啟 POS 掃描器
2. 掃描條碼（或從搜尋清單中選取）將商品加入購物車——數量預設為 1，可在加入購物車視窗中編輯
3. 在購物車工作表上點選付款以開啟結帳，您可在此選擇付款方式並確認總金額
4. 刷卡機與手動刷卡會交由 Square 處理；現金付款時，輸入收取金額後，App 會自動計算找零
5. 交易完成後，會顯示面向顧客的收據畫面——顧客可選擇輸入電子郵件，以便以其偏好的語言收到收據

離線 POS

當應用程式失去網路連線時,POS 仍可繼續處理非 Square 付款,並將需要與伺服器往返的任何操作排入佇列。

• 現金和外部付款可完全離線運作 — 無需網路連線
• POS 銷售產生的庫存調整會在本機記錄,並在您重新連線時立即同步到其他裝置
• 電子郵件收據會在本機排隊,並在網路恢復後自動寄送;面向客戶的感謝畫面仍會立即顯示

注意:讀卡機和手動刷卡付款在收費時需要有效的網路連線 — Square 必須授權該卡。如果結帳過程中網路中斷,請改用現金或外部付款,以其他方式收款,並記錄銷售以保持庫存和報告的準確性。

銷售人員與操作員

新增銷售人員（操作員），讓銷售點可由多人輪值，且每筆交易都會歸屬於實際結帳的人。操作員以姓名與選用的 PIN 登入、僅取得您授予的權限，您也可以隨時使用加密密碼切換回管理員身分。

新增銷售人員

1. 開啟設定 > 銷售 > 銷售人員，並點擊新增銷售人員（或銷售人員列表上的 + 按鈕）
2. 輸入名稱和選擇性的 6 位數 PIN 碼——若沒有 PIN 碼，該檔案為公開狀態，任何人都可以使用，這對單一可信地點而言可以接受，但對繁忙的賣場則不太理想
3. 切換您要授予的權限——庫存存取、報表存取，以及選擇性的設定到期日以限定存取時間
4. 可選擇性地指定預設銷售地點，讓操作員的 POS 銷售自動從正確的地點扣除庫存

權限級別

限時存取

在新增或編輯銷售人員時開啟設定到期日並選擇日期。在該日期之後，他們的權限將被自動撤銷，操作員登入畫面會顯示明確的到期訊息——適用於季節性員工、約聘人員，或任何您僅需授予臨時存取權的對象。

事件標記與稽核軌跡

每筆銷售、退貨、庫存調整與盤點都會標記執行該操作的操作員，包括以管理員身分登入時所結帳的交易。這些標記會顯示在交易清單、庫存事件歷史紀錄與匯出報表中——讓您隨時掌握誰在何時做了什麼。

注意：從操作員工作階段切換回管理員需要加密密碼（若未啟用加密則需裝置解鎖）。這可防止已登入的操作員變更設定、刪除其他操作員，或調閱他們不應檢視的現金抽屜報表。

銷售與市集上架

在 7 個支援的市集上架待售物品。AI 會根據您的物品資料產生上架詳情，應用程式還會產生 PDF 銷售簡介，供您張貼時參考。

支援的市集

刊登流程

1. 前往銷售分頁並點擊新增刊登
2. 從可搜尋的項目選擇器中挑選一個項目
3. 選擇一個市集平台
4. AI 自動填入刊登欄位：標題、價格、類別、狀況與描述
5. 每個市集平台都有自己的額外欄位（例如 eBay：品牌、UPC、運送方式；Poshmark：部門、尺寸）
6. 在檢視畫面上檢閱並編輯所有內容
7. 產生PDF 銷售單— 包含項目照片、所有刊登詳情，以及連結至市集建立刊登頁面的 QR 碼
8. 儲存至下載項目，或透過 AirDrop、電子郵件或訊息分享

銷售追蹤

物品依以下上架狀態流轉：待售中 → 已售出 – 未交付 → 已交付。銷售儀表板顯示有效上架（包括已售出未交付的物品）、完整的銷售紀錄，以及包含買家詳細資訊、定價、費用和淨收益的摘要統計。可為任何日期範圍產生 PDF 或 CSV 銷售報告。

銷售用 Square 整合

除了在銷售點接受面對面的卡片付款外，Square 連結還支援電子郵件收據——當連接了有效的 Square 電子郵件收據訂閱時，可以直接從銷售點的感謝畫面以買家偏好的語言發送面向客戶的收據。在設定 > 銷售 > Square 付款下授權 Square 一次，卡片付款和電子郵件收據即可共用同一連線。

收據

每筆 POS 銷售結束時，都會顯示面向顧客的感謝惠顧收據畫面，內含商品明細、總金額、付款方式以及（現金交易時的）找零金額。顧客可選擇輸入電子郵件，以其偏好的語言收到收據，您也可以從近期交易清單中重印或退款任何過往的銷售紀錄。

收據功能

• 多語言——收據會於銷售當下自動翻譯為顧客選擇的語言（支援 18 種語言）
• 兩種傳遞管道——買家可在您的裝置上閱讀面向顧客的畫面，亦可選擇將收據以電子郵件寄送至其信箱
• 隨需重印——近期交易中的每筆交易皆可開啟完整收據詳情頁面，可重新寄送、另存為 PDF 或退款
• 現金找零追蹤——現金交易的收據會記錄收取金額與找零金額，使稽核軌跡明確無虞

收據工作流程

1. 在 POS 中完成銷售 — 面向客戶的收據畫面會自動顯示總額和語言選擇器
2. 將裝置交給客戶；畫面使用較大的文字和語言選擇器，讓他們能舒適地閱讀並隨時切換語言
3. 如果客戶想要電子郵件副本，他們輸入電子郵件地址並輕觸傳送收據 — 電子郵件會以他們選擇的語言排隊發送
4. 輕觸完成返回 POS 掃描器，準備進行下一筆銷售

自訂收據

收據品牌資訊取自設定 > 銷售 > 商家資訊——您的商家名稱、地址、電話、電子郵件、稅籍編號與郵遞區號將顯示於頂部。請在設定 > 銷售 > 電子郵件選項中設定寄件者：可選擇內建的 Where The Bleep 郵件服務（需訂閱）或您自己的自訂 SMTP 伺服器，讓收據從您自己的網域寄出。

注意：電子郵件收據在發送時需要網際網路連線，但如果您處於離線狀態，它們會在本機排隊，並在網路恢復後立即發送。面向客戶的感謝畫面無論線上或離線都會立即顯示。

加密與安全性

Where The Bleep 採用零知識端對端加密。您的資料在裝置上加密後才會傳到雲端。我們無法讀取您的資料 — 只有您可以。

加密詳細資訊

金鑰階層

您的密碼透過 PBKDF2-HMAC-SHA256（60 萬次迭代）衍生出主金鑰（256 位元）。從主金鑰再衍生出三個子金鑰：

• DEK（資料加密金鑰）— 加密項目欄位、名稱與描述
• FEK（檔案加密金鑰）— 以 64 KB 區塊加密圖片與文件
• SIK（搜尋索引金鑰）— 為伺服器端查詢產生盲索引

解鎖選項

暴力破解防護

密碼嘗試失敗會觸發指數型退避鎖定機制：30 秒 → 5 分鐘 → 15 分鐘 → 1 小時。

雙重驗證

將驗證器應用程式與您的帳戶配對，在密碼之上增加一層保護。請至設定 > 安全性 > 雙重驗證進行設定——任何相容於 TOTP 的應用程式皆可使用（Google Authenticator、Authy、1Password、Microsoft Authenticator）。配對後，於新裝置登入時將同時需要您的密碼和應用程式產生的最新 6 位數驗證碼。

網路安全

• 憑證透明度監控 — 為每個 API 端點追蹤 TOFU TLS 憑證
• 憑證變更偵測 — 當憑證指紋意外變更時發出警示
• Android 上封鎖明文流量 — 沒有未加密的 HTTP 連線
• 憑證監控畫面 — 檢視每個端點的憑證簽發者、到期時間、指紋和變更記錄(設定 > 安全性 > 憑證監控)

雲端同步

Where The Bleep 採離線優先設計—無需網路即可完整使用。雲端同步為選用功能，僅限 Pro 訂閱者使用。

同步運作方式

• 所有資料皆儲存在本機的 SQLite 中——應用程式絕不需要網際網路
• webDocsSyncFeature2
• 資料在離開您的裝置之前即已加密——伺服器只看得到加密過的欄位
• 衝突偵測——資料列層級的「最後寫入優先」原則，並將衝突記錄至事件稽核軌跡
• 刪除傳播——在裝置 A 上刪除會同步移除裝置 B 上的項目
• 使用者隔離——資料列層級安全機制確保您只看得到自己的資料
• 市集刊登與銷售已納入同步範圍，並對買家個人資訊進行加密

備份與還原

將您的整個資料庫和圖片匯出為加密的備份封存檔。匯出時設定備份密碼，並可用該密碼於任何裝置上還原。

備份內容

• 完整的 SQLite 資料庫
• 所有物品圖片
• 採用使用者設定的備份密碼進行 AES-256-GCM 加密（PBKDF2 衍生金鑰）
• 用於封存完整性驗證的 JSON 清單檔

還原工作流程

1. 前往設定 > 備份與還原
2. 輕觸匯入備份
3. 使用檔案選擇器選取備份檔案
4. 輸入您建立備份時設定的備份密碼
5. 您的資料和圖片已還原

資料匯出與報告

以多種格式匯出您的庫存資料,用於保險理賠、個人記錄或資料可攜性。

匯出格式

AI 智慧描述

拍張照片，讓 AI 為您的物品生成標題、描述和標籤。同樣的 AI 功能也支援跳蚤市場刊登內容生成。您可使用所支援的 8 家供應商之一的自有 API 金鑰。

支援的 AI 供應商

設定

1. 前往「設定」>「AI 供應商」
2. 選擇您偏好的供應商
3. 輸入您的 API 金鑰
4. 可自行更改預設模型（選用）
5. 新增或編輯物品時，點選 AI 相機按鈕即可使用

注意：您的 API 金鑰僅儲存於裝置本機，絕不會傳送至我們的伺服器。AI 請求會直接從您的裝置發送至供應商。

設定

「設定」畫面是您管理加密、同步、AI 設定、資料匯出與帳戶管理的控制中心。

設定區段

訂閱

Where The Bleep 提供慷慨的免費方案，內含所有核心功能。Pro 方案解鎖雲端同步、自動備份與優先支援。

方案

訂閱透過 App Store（iOS）或 Google Play（Android）管理。您可以隨時從裝置的訂閱設定中取消。

What's Included with Pro

• 經營真正的商家 — 支援讀卡機和手動刷卡付款的 Square POS、具備 PIN 碼和個別操作員權限的銷售人員、18 種語言的電子郵件收據、eBay 刊登,以及四個內建的庫存報告(庫存量、移動、估值、損耗)
• 帶上您的團隊 — 選擇 5、10 或 20 部裝置方案,讓您的銷售人員、廚房員工或共同所有人都能從各自的裝置以各自的登入帳號工作
• 無需 Wi-Fi 也能運作 — 網路中斷時每個畫面仍可使用,包括現金銷售、庫存調整和盤點;所有操作會排隊,並在重新連線時立即同步
• 加密雲端同步與自動備份 — 您的資料在裝置上採端對端加密,在數秒內複製到每個配對裝置,並持續備份到雲端,即使所有裝置遺失也能還原