Xodera Plugins · Bubble Native
Xodera Documents AI Native
將收據或送貨照片轉換為草稿表單。讓 AI 建議日期、總額及其他要求欄位，然後由人工審核後再儲存。
Public beta guides · Haptics instructions are in its Bubble listing
Public beta offer: free Bubble install · 7-day card trial, then US$1.50/month per plugin/project.
文件審閱日期：2026年11月6日
實用範例
從收據照片預填費用草稿
重複輸入商家、日期和金額會減慢費用輸入；提取的欄位可作為可審核的草稿。
`fields_json = ["merchant","date","total","currency"]`；使用者捕獲收據影像並另行同意處理。測試時僅使用樣本收據。
計畫中：`analysis_requested` → Analyze Captured Document，使用受限的匯出位元組/MIME/欄位名稱/同意/請求 ID → 在可編輯的費用表單中顯示返回的欄位。
此動作返回 `status`、`operation_id`、`fields_json` 和 `review_required`。您的使用者在工作流程建立費用之前會校正/批准這些欄位。
在結果不確定時，使用相同 `operation_id` 的 Read Analysis；不要自動發起另一項分析。撤回同意會清除保留的捕獲/匯出；絕不在公共物件或日誌中持久保存原始 base64。
計畫中。必須在儲存前由人員審核每個建議值。
讀取送貨單參考供員工審核表單使用
倉庫使用者應能審核建議的參考/日期，而非從拍攝的紙條中手動輸入。
`fields_json = ["delivery_reference","supplier","delivery_date"]`；測試時捕獲樣本送貨單的相關面。
在單獨的捕獲/處理同意之後，Analyze Captured Document 提出所選欄位。將照片顯示於可編輯欄位旁，並請員工確認相符的送貨記錄。
保留返回的 `operation_id` 以再次檢查結果，並將 `fields_json` 作為提案。您的工作流程僅在員工審核後才執行實際的送貨查詢/更新。
缺失、模糊或不正確的欄位需要手動修正。供應商錯誤會使原始送貨保持不變；Read Analysis 檢查不確定操作的結果。
計畫中。必須在儲存前由人員審核每個建議值。
從標籤照片建議設備序號
當資產標籤難以輸入時，維護表單可提供可審核的型號/序號建議。
`fields_json = ["manufacturer","model","serial_number"]`；捕獲樣本設備標籤影像；在專案設定中選擇您的 AI 供應商。
計畫中的 Analyze Captured Document 動作返回建議字串。將它們顯示於照片旁；讓使用者在您的資產查詢或維護工作流程之前校正它們。
使用返回的 `fields_json`、`review_required` 和 `operation_id`。將識別碼視為文字，以便您的應用保留前導零。
如果影像無法辨識或模型提出錯誤字串，允許手動輸入。於不確定回應後再次讀取相同操作，而非額外收費進行推論。
計畫中。必須在儲存前由人員審核每個建議值。
目前可用功能
私人測試版。照片擷取已可供測試。從照片中擷取欄位仍在規劃中，尚未可於您的應用程式使用。
建立工作流程
計畫中
規劃中的工作流程。目前的測試版尚未提供。
這些範例使用如 Lesson、Message 和 Order 的應用程式記錄。請以您自己的資料類型和元素名稱取代它們。範例媒體位址必須替換為您自己的檔案。
規劃中：選擇表單所需的欄位，例如 fields_json=["title","date","total"]。啟用 enable_analysis_export 並將 analysis_context 設為選取的帳號或記錄。此分析設定在目前的擷取版本中不可用。
讓使用者拍攝照片並另行同意處理。在 analysis_requested 上，使用此元素的 analysis_image_base64、analysis_mime_type、analysis_fields_json 與 analysis_consent 執行 Analyze Captured Document。將 analysis_request_id 作為 idempotency_key 使用。
儲存返回的 operation_id、request_id 以及 status。若 status 為 processing，請使用 Read Analysis 搭配該 operation_id 以稍後取得結果。
在可編輯的審核表單中顯示返回的 fields_json。僅在使用者檢查並按下 Confirm後才儲存批准的值。保留原始記錄直至確認完成。
一次性設定
在 BestPlugins → Dashboard → Plugins 中建立或選取您的 Bubble 應用程式專案。選擇 Xodera Documents AI Native，複製其金鑰，然後開啟 Bubble → Plugins → Xodera Documents AI Native，將金鑰貼入 project_api_key。儲存一次；之後使用下方操作。每個專案中的每個外掛都有其專屬金鑰。
請求相機權限並說明為何需要照片。處理需另行取得使用者同意。於專案設定中選擇您的 AI 供應商；其使用費用由該供應商計費。
一次性設定
- 在 BestPlugins → Dashboard → Plugins 中建立或選取您的 Bubble 應用程式專案。
- 選取此外掛並複製其專案金鑰。
- 開啟 Bubble → Plugins → Xodera Documents AI Native；將金鑰貼入 project_api_key 並儲存。
- 加入元件，選取您的應用程式資料，並建立下方的工作流程。
- 目前僅限私人測試版存取。公開安裝與付費啟用尚未開放。
安裝與訂閱
For Audio Player, Video Player, Photo Editor, Audio Recorder, Files Kit and Haptics: free Bubble installation, a 7-day trial with a card, then US$1.50 per month per plugin and app project. Development and production are included, with no operation cap. File-size and feature limits still apply. Review billing and cancellation before confirming. Other plugins remain unavailable for purchase.
將結果儲存至您的應用程式
範例 ExpenseDraft：owner、operation_id、request_id、status 與 proposed_fields_json。審核後，儲存批准的日期、總額及其他欄位，外加 reviewed_by 與 reviewed_at。僅映射表單要求的欄位。請勿將完整影像內容寫入日誌或一般文字記錄。
失敗、取消與復原
若結果延遲，保留相同請求，並使用已知的 operation_id 呼叫 Read Analysis 查詢結果。不要自動拍攝新照片或建立新請求。若使用者撤回同意，請清除照片並停止提供結果；已傳送或儲存的副本無法撤回。
功能與限制
規劃中的影像輸入：PNG、JPEG 或 WebP，最高 5 MiB；請求 1–32 不同的欄位名稱。務必審核擷取的值。此功能不屬於身分驗證、文件真偽檢查或醫療決策工具。AI 供應商收費另計。
設定、操作與結果
在 Bubble 中使用這些名稱。計畫中的功能會另行標示。
可用的測試版設定
元素設定
document_side · textbutton_label · textconsent_text · textdisabled · yes/nofields_json · textprocessing_consent_text · textanalyze_button_label · textcheck_button_label · textlanguage · textui_text_json · text狀態
capture_status · textlocal_uri · textmime_type · textdocument_side · textimage_width · numberimage_height · numbererror_code · textis_capturing · yes/noanalysis_status · textanalysis_operation_id · textanalysis_fields_json · textanalysis_error_code · textreview_required · yes/nois_analyzing · yes/no事件
capture_startedcapture_succeededcapture_cancelledpermission_deniedcapture_erroranalysis_startedanalysis_readyanalysis_pendinganalysis_error操作及其輸入
元素設定 · 12
規劃中的工作流程。目前的測試版尚未提供。
document_sidetext · 預設: "front"- 範例值
front - 範例 Bubble 表達式
Capture Side Dropdown's value - 使用目前業務記錄的值；依以下限制進行驗證。
button_labeltext · 預設: ""- 範例值
"" - 範例 Bubble 表達式
App Texts' capture_label - 可見的應用文字；留空則使用內建的本地化文字（若支援）。請勿填入憑證。
consent_texttext · 預設: ""- 範例值
I agree to capture this non-sensitive receipt. - 範例 Bubble 表達式
App Texts' capture_consent - 說明特定的捕獲/處理目的與接收者。撤回同意會清除保留的位元組，但不會刪除應用程式先前產生的副本。
disabledyes/no · 預設: false- 範例值
no - 範例 Bubble 表達式
GuideHost's is_busy (your yes/no custom state) - 當您的應用忙碌或此操作不可用時，停用該元件。
processing_consent_texttext · 預設: ""- 範例值
I agree to send this image to the configured AI provider for draft fields. - 範例 Bubble 表達式
App Texts' processing_consent - 說明特定的捕獲/處理目的與接收者。撤回同意會清除保留的位元組，但不會刪除應用程式先前產生的副本。
analyze_button_labeltext · 預設: ""- 範例值
"" - 範例 Bubble 表達式
App Texts' analyze_label - 可見的應用文字；留空則使用內建的本地化文字（若支援）。請勿填入憑證。
languagetext · 預設: "auto"- 範例值
uk - 範例 Bubble 表達式
Current User's preferred_language - 設定 language=auto 以跟隨支援的裝置或瀏覽器語言。輸入支援的語言代碼以明確選擇。
ui_text_jsontext · 預設: ""- 範例值
{} - 範例 Bubble 表達式
App Settings' player_labels_json (supported keys only) - 可選的 JSON，包含支援的按鈕標籤。留空則使用內建文字。
enable_analysis_exportyes/no · 預設: false- 範例值
yes - 範例 Bubble 表達式
App Settings' enable_reviewed_extraction - 計畫中：允許分析動作在使用者分別同意拍攝與處理後使用照片。預設為關閉。
analysis_contexttext · 預設: ""- 範例值
<current-user-id> - 範例 Bubble 表達式
Current User's unique id - 此帳戶或記錄的穩定值。變更後會清除先前的照片。
is_activeyes/no · 預設: true- 範例值
yes - 範例 Bubble 表達式
GuideHost's view_is_active (your yes/no custom state) - 在此視圖開啟時設為是，離開時設為否，以便停止播放或當前工作。
fields_jsontext · 預設: "[\"title\",\"date\",\"total\"]"- 範例值
["title","date","total"] - 範例 Bubble 表達式
Expense Settings' extraction_fields_json - JSON 請求的提取欄位名稱陣列；輸出為供人工審核的建議資料。
操作及其輸入 · 2
規劃中的工作流程。目前的測試版尚未提供。
Analyze Captured Document
image_base64text · 預設: —- 範例值
<canonical bytes from consented export> - 範例 Bubble 表達式
Document Capture's analysis_image_base64 - 使用目前業務記錄的值；依以下限制進行驗證。
mime_typetext · 預設: —- 範例值
image/jpeg - 範例 Bubble 表達式
Document Capture's analysis_mime_type - 使用目前業務記錄的值；依以下限制進行驗證。
fields_jsontext · 預設: —- 範例值
["title","date","total"] - 範例 Bubble 表達式
Document Capture's analysis_fields_json - JSON 請求的提取欄位名稱陣列；輸出為供人工審核的建議資料。
consentyes/no · 預設: —- 範例值
yes — current processing consent - 範例 Bubble 表達式
Document Capture's analysis_consent - 使用目前業務記錄的值；依以下限制進行驗證。
idempotency_keytext · 預設: —- 範例值
<unchanged analysis_request_id> - 範例 Bubble 表達式
Document Capture's analysis_request_id - 使用目前業務記錄的值；依以下限制進行驗證。
environmenttext · 預設: —- 範例值
development - 範例 Bubble 表達式
App Settings' selected_environment - 使用目前業務記錄的值；依以下限制進行驗證。
回傳值
ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/noRead Analysis
operation_idtext · 預設: —- 範例值
<returned operation_id> - 範例 Bubble 表達式
Current ExpenseDraft's operation_id - 使用目前業務記錄的值；依以下限制進行驗證。
environmenttext · 預設: —- 範例值
development - 範例 Bubble 表達式
App Settings' selected_environment - 使用目前業務記錄的值；依以下限制進行驗證。
回傳值
ok · yes/nostatus · textoperation_id · textrequest_id · textfields_json · texterror_code · textreview_required · yes/no狀態與事件
規劃中的工作流程。目前的測試版尚未提供。
狀態
capture_status · text此操作的當前結果。於儲存成功前使用相符的完成事件。
local_uri · text此裝置上的檔案位置。若必須保留在線上，請另行保存或上傳檔案。
mime_type · text所選項目的當前值。於相關事件後讀取。
document_side · text所選項目的當前值。於相關事件後讀取。
image_width · number所選項目的當前值。於相關事件後讀取。
image_height · number所選項目的當前值。於相關事件後讀取。
error_code · text上一次操作的錯誤資訊。顯示有用的訊息並提供相關的重試。
is_capturing · yes/no所選項目的當前值。於相關事件後讀取。
analysis_image_base64 · text所選項目的當前值。於相關事件後讀取。
analysis_mime_type · text所選項目的當前值。於相關事件後讀取。
analysis_fields_json · text請求欄位的建議值。儲存前先顯示供審核。
analysis_request_id · text此項目或操作的識別碼。請將其與相應的應用記錄一起保存。重試不確定結果時，使用相同的請求識別碼。
analysis_consent · yes/no所選項目的當前值。於相關事件後讀取。
analysis_export_status · text此操作的當前結果。於儲存成功前使用相符的完成事件。
analysis_export_error · text上一次操作的錯誤資訊。顯示有用的訊息並提供相關的重試。
analysis_image_bytes · number所選項目的當前值。於相關事件後讀取。
事件
capture_started當此事件發生時，從同一元素讀取相關狀態。
capture_succeeded當此事件發生時，從同一元素讀取相關狀態。
capture_cancelled當此事件發生時，從同一元素讀取相關狀態。
permission_denied當此事件發生時，從同一元素讀取相關狀態。
capture_error當此事件發生時，從同一元素讀取相關狀態。
analysis_requested當此事件發生時，從同一元素讀取相關狀態。
analysis_export_error當此事件發生時，從同一元素讀取相關狀態。
analysis_cleared當此事件發生時，從同一元素讀取相關狀態。
開發者常問問題
它會驗證身分或文件嗎？
不會。它會提出文字欄位供審核。捕獲的文件影像並不構成身分、真偽或醫療/財務結論的依據。
訂閱如何運作？
計畫價格：在 Bubble 中安裝此插件為免費。BestPlugins 存取需為每個插件在每個 Bubble 應用專案中分別訂閱：7 天免費，之後每月 US$1.50。Development 與 Live 已包含。操作次數沒有固定上限；檔案大小與功能限制仍然適用。結帳尚未開放。啟用畫面將顯示首次計費日期與取消條款。
相關指南
Marketplace 發布待處理
論壇指南未發佈
如需協助，請告訴我們您使用的插件與裝置、嘗試的操作以及發生的情況。請使用不含個人資料的範例。切勿分享您的金鑰或私人檔案。