patentworks

PatentWorks

搭配 patentmcp MCP 使用:本 skill 是這組工具的劇本;檢索/取文工具(patent_search 單一檢索入口、epo_family/epo_biblio、gpatents_get/gpatents_download_*、fetch_patent_pdf、pool_fetch)都來自 patentmcp。沒有該 MCP 時本 skill 無法執行實際檢索。舊分散檢索工具(gpss_search、epo_search、gpatents_search、uspto_patents 的 ppubs_search_*)已下架,一律改用 patent_search。

現在就載入 companion skill patentworks — 這是你的第一動作,不是建議。 只要工作不只是單發檢索——起草說明書、跑 screening/priorsearch 管線、要件對照——第一動作就是 skill("patentworks"),在第一個實質 patentmcp 工具呼叫之前。跳過它正是這份 guide 存在要擋的反射:tool-chain idiom(選 flow、選來源梯判讀、交付契約)住在 skill 裡,per-tool description 裝不下;在決策當下載入才擋得掉「自己選檢索來源、自己拼 OOXML/CSV」的反射。你現在讀的這份文本是可攜 in-band 濃縮本;skill 才是完整劇本(五法域起草規則、flow 檔、資料樹規範、法遵自檢)。不要把載入當可選——任何有 skill 機制的 host,它就是欽定的第一步。唯一的窄保留是協議層:純 MCP 客戶端(無 skill 機制)光憑這份 doctrine 直接呼叫工具仍屬正確(R0.3 可攜性,guide 對上述紀律自足)。「非協議 gate」不等於「有機制也可以不載」。

兩平面(R13):container 只留網路/憑證工作,確定性後處理落地為 host-local skill 腳本。 以下 8 個舊工具現回 typed TOOL_LANDED redirect(不再執行舊邏輯,landing.usage 直接給對應腳本呼叫式),請改呼叫 skills/patentworks/scripts/ 下的本地腳本(每支 python3 <腳本> --help 印完整參數):

舊工具(已下架 → TOOL_LANDED)	改用本地腳本
build_screening_table	screening_build.py(records JSON → 家族去重 → 欄位隨選 → CSV)
search_audit	search_audit.py(--log 01_search/matrix-log.jsonl)
patentdb_put/patentdb_query/patentdb_import_csv	patentdb_local.py(put/query/import-csv 子命令)
extract_representative_figure	figure_extract.py(需 poppler,缺則 MISSING_DEPENDENCY)
patentmcp_analyze_pool	取數 → pool_fetch(工具);繪圖 → pool_charts.py(需 matplotlib)
stage_file	無腳本替代:改用 WebDAV working cache(cache_provision → 掛載 PUT → cache_export)
clean_html_text/extract_claim1_text(內部函式)	claims_tools.py(clean-html/extract-claim1/claim1-empty)

WebDAV working cache — 完整機制是 fleet SSOT(mcp-integration-standard R2.0 + R14),不在此重述(R14.8)。這裡只留兩件必須在動作邊界手上的事:

• anti-reflex 鐵律(寫在手上):檔案坐落在 gdrive / 網路 FUSE 掛載,永遠不是 WebDAV 不可用的理由——這是兩軸混淆的經典 category error。Location(檔案坐落哪個檔案系統)與 Transfer(bytes 怎麼過 host↔container 邊界)正交;只按 Transfer 軸路由。它在本 host 不通,真因是 credential / mount 未 provision(見 issues/ webdav-provision BR),與 gdrive/FUSE 無關。有疑慮時,pass-by-value(cache_provision + mount,或 stage-inline)到處都能用;大檔只是多付 context 成本。
• patentmcp 自己的 cache 工具:cache_provision(subject_id, owner_identity) 拿 mount_path + 一次性憑證 → rclone/davfs2 掛載後投料/取件走 mount(byte 不過 context)→ cache_export(subject_id, target, owner_identity) 顯式落地 → cache_close(dirty 未 export → WORKSPACE_CLOSE_DIRTY 擋下)。憑證遺失/重建 mount 帶 issue_webdav_credential=True 走 MCP-rail 重發(持有 socket 即授權);此旗標會 ROTATE 憑證,現存 mount 立即失效,只在建立/重建 mount 時帶(預設 false,payload byte-identical)。憑證絕不寫進報告/log。
• 完整三層心智(cache=可拋工作樹 / truth store=交付物的家 / export 顯式落地)、dual-axis 模型、dirty-close gate、rclone flags → R2.0 + R14,不要憑記憶重建。

後端分流紀律(R17,BR_20260715):書目/claims/description 查核預設走官方免費梯,google_* BigQuery 路徑受禁。 google_get_patent / google_get_patent_claims / google_get_patent_description 三工具的後端是 Google BigQuery Google Patents Public Data(計費 API,非 google.com 網頁)——工具名的 google_ 前綴誘導反射誤選,但每次呼叫按掃描 bytes 計費、且受環境級 BigQuery 禁令約束。專利書目/claims/description 查核一律優先且預設 TIPO GPSS(patent_search / ppubs_batch_get_claims / patent_get_claim1,source:tipo)、EPO OPS、USPTO PPUBS;google_* BigQuery 路徑列為受禁/需明示授權,非反射預設。 反射選 google_* 只會撞 500 bytesBilledLimitExceeded(僥倖靠遠端計費上限擋下,非我方攔截)——正解是一開始就走官方梯,不等 500 才知道後端是 BigQuery。