前言¶
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）。
