前言¶
DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。dsh-cubox 是一個針對 Cubox 的同步插件，它利用 DSH 的計劃任務和代理工具，將 Cubox 的收藏整理、AI 每日簡報生成以及 Markdown 導出流程自動化。
插件定位¶
該插件由 zhengjy01 維護，採用 MIT 許可證。它通過 DeepSeek Harness 的內置 API 擴展與 Cubox 交互，主要用於處理收藏數據的本地緩存、AI 摘要生成以及 flomo 筆記的同步。
安裝與啓用¶
通過命令行安裝該插件：
dsh plugin --profile web add github:zhengjy01/dsh-cubox
安裝完成後，重啓 dsh web 即可加載插件。
核心功能¶
- 計劃同步：插件維護一個本地緩存（
~/.dsh/dsh-cubox-cache.json），默認每 60 分鐘拉取一次最新收藏。設置中可配置間隔，設置爲 0 則禁用定時任務。 - AI 每日簡報：支持自定義提示模板（Prompt Template）。在配置 LLM Key 後，每次同步會根據
{collection}佔位符生成的列表生成簡報，並寫入 Obsidian 格式的 Markdown 文件（如今日收藏簡報-YYYY-MM-DD.md）。 - Markdown 導出：支持配置輸出目錄。可開啓
exportCards選項，導出包含 Frontmatter、標題、描述、鏈接及註釋的單卡 Markdown 文件；關閉則僅導出 AI 簡報。 - 卡片查詢：提供
cubox_cards工具，支持通過關鍵字、時間範圍、是否標註或星標等條件過濾收藏。 - flomo 註釋同步：支持將新增或變更的註釋（高亮與想法）推送到 flomo。插件維護本地去重賬本，避免重複推送。支持自定義標籤（Tag）和 ASCII
#轉換爲全角＃，並可將摘要分流推送到 flomo、本地 Markdown 或 Notion。
配置與使用¶
配置分爲兩步：獲取 Cubox API 鏈接，並在 DSH 中設置。
- 在 Cubox 設置中啓用「API Extension」，複製生成的唯一鏈接（例如
https://cubox.pro/c/api/save/abcd12345）。 - 在 DSH 的設置面板（Settings → Cubox）中粘貼該鏈接。也可以直接在對話中讓代理執行配置：
幫我配置 Cubox，API 鏈接是 https://cubox.pro/c/api/save/abcd12345
- （可選）設置本地導出目錄、LLM Key（默認兼容 OpenAI 格式，推薦 DeepSeek）及 AI 簡報模板。
常用工具¶
插件提供以下命令工具：
| 工具名 | 功能 |
|---|---|
cubox_status |
查看連接狀態及緩存狀態 |
cubox_config |
修改配置項（API 鏈接、同步間隔、導出目錄、LLM 設置等） |
cubox_sync |
手動觸發一次同步（默認同步最近 1 天） |
cubox_cards |
查詢收藏卡片，支持關鍵字過濾 |
cubox_flomo |
立即將新註釋推送到 flomo |
注意事項¶
- 權限與安全：Cubox 的讀取接口並非公開的 Open API，而是通過內部的
/c/api/cli/*端點。API 鏈接和 LLM Key 存儲在~/.dsh/dsh-cubox.文件中，文件權限爲 0600。泄露這些憑證可能導致數據泄露或 LLM 配額被濫用。 - 許可證：請在使用前檢查源碼與許可證（MIT）。
