QDA 模式

QDA 模式將 Potato 變為定性資料分析（QDA）工作區。 設定 qda_mode.enabled: true，Potato 便會把動態碼本、原位編碼、分析備忘錄、案例與全文搜尋組合成一套統一的工作流，用於通讀和編碼整個語料庫。它是 NVivo、ATLAS.ti、MAXQDA 和 Dedoose 等工具的免費、開源、基於網頁的替代方案。

定性資料分析 是指為非結構化文本（訪談記錄、開放式問卷回答、田野筆記或文件）的段落賦予編碼，並將這些編碼構建為主題的實踐。QDA 模式是同時啟用 Potato 各項定性編碼功能的單一開關，其預設值針對一位分析者貫穿整個語料庫工作的場景進行了調優。

處於 QDA 模式的 Potato：一個以碼本為支撐的跨度方案，配有“查詢”搜尋面板以及“備忘錄”和“碼本”側邊欄

QDA 模式改變了什麼

啟用 qda_mode 假定的是單編碼者姿態（一位分析者處理整個語料庫，無需保護標註者間抽樣）。在此前提下，它將 Potato 的通用功能切換為其定性預設值：

每一項預設值都可被覆蓋。QDA 模式只改變起點。即使在 QDA 模式下，眾包後端也會強制將碼本鎖定為 fixed，因此付費標註者無法重塑共享碼本。

快速開始

annotation_task_name: My Qualitative Study
task_dir: .
output_annotation_dir: annotation_output/
data_files:
- data/interviews.json
item_properties:
  id_key: id
  text_key: text
 
qda_mode:
  enabled: true            # compose codebook + memos + cases + search
 
codebook_invivo_key: i     # mint a code from a text selection
 
cases:                     # group excerpts into units of analysis
  enabled: true
  key: participant_id
  attributes: [condition]
 
search:                    # let the coder jump to any matching excerpt
  enabled: true
  annotator_claim: true
 
annotation_schemes:
- annotation_type: span    # span + codebook = in-vivo coding
  name: codes
  description: Highlight a passage and apply (or mint, via `i`) a code
  codebook: true
  labels: [access barriers, cost concerns, provider trust]

cases、search 和備忘錄程式碼塊都是可選的，因為 QDA 模式已經開啟了案例和備忘錄。只有在需要調整預設值時才寫它們，例如選擇 cases.key 或啟用 annotator_claim。

從倉庫根目錄執行隨附的示例：

python potato/flask_server.py start examples/advanced/qda-mode-example/config.yaml -p 8000

各個組成部分

qda_mode.enabled 在單一儲存之上組合四種定性介面

• 動態碼本。 共享、可變的編碼集合。通過 codebook: true 讓某個方案加入；在 QDA 模式下，你可以在閱讀時擴充並重組碼本。
• 原位編碼。 在同時為 codebook: true 的 span 方案上，選中一段文字並按下原位鍵（codebook_invivo_key，預設 i），即可直接從所選文本鑄造一個編碼。編排器會顯示近似重複的編碼，讓你複用而非碎片化。
• 備忘錄。 附加到某個實例或某段具體文本選區的分析性筆記，可設為僅你可見或與團隊共享。
• 案例。 將摘錄歸組為分析單元（一位參與者、一份文件），並提取案例級屬性，如 condition，從而讓管理員編碼交叉表能夠將編碼與參與者層面的變數進行製表。
• 搜尋。 對語料庫進行 FTS5 全文搜尋。配合 annotator_claim: true，編碼者可將任意匹配項拉入自己的佇列。

組合器標記近似重複項，活的編碼本隨之收斂

配置

qda_mode:
  enabled: true
  memos:
    enabled: true                 # memo defaults under QDA Mode
    show_sidebar_by_default: true
  codebook:
    enabled: true
    mode: open                    # open | extensible | fixed

未知的 qda_mode.* 鍵會被保留而非拒絕，因此你可以為後續階段才落地的功能編寫向前相容的 YAML。

匯出你的編碼

兩個匯出器可將已編碼資料轉化為定性研究的交付成果：

• codebook —— 每個編碼一行，含其層級、描述、顏色與使用次數。
• quotation_report —— 每個已編碼跨度一行：引文、其字元偏移量、來源實例以及編碼者。新增 include_memos=true 可追加備忘錄行。

python -m potato.export config.yaml --format quotation_report \
  --option include_memos=true -o quotations.csv

從 Potato 2.9 起，編碼完成的項目還可以以 REFI-QDA .qdpx 格式送回 QDA 工具（NVivo、ATLAS.ti、MAXQDA、Quirkos 和 QDA Miner 都能讀寫這種交換格式），來自這些工具中任何一個的 .qdpx 也可以匯入：

potato import -i project.qdpx -o my-study
python -m potato.export -c my-study/config.yaml -f qdpx -o ./export/

編碼手冊會保留其層級結構，同時保留編碼記錄以及每條編碼由哪位分析者完成。ATLAS.ti 只支援一級子程式碼，所以如果編碼手冊層級更深，請在匯出時加上 --option flatten_subcodes=true。每個程式碼都會被重新掛到頂層，並重命名為 Parent > Child。參見匯入項目。

codebook、quotation_report 以及標註者間一致性功能（Cohen's 與 Fleiss' kappa）均在 2.5.0 定性編碼版本中釋出。版本歷史請參見 更新內容。

相關內容

• 標註者間一致性指南 —— 用 Cohen's 與 Fleiss' kappa 衡量編碼者信度
• 匯出格式 —— 完整的匯出器與列參考
• 單人模式 —— 單標註者、LLM 輔助的標註

有關實現細節，請參見 源文件。