dsh-cubox

dsh-cubox

English | 中文

Cubox sync for DeepSeek Harness: scheduled sync of your Cubox collection, with an AI daily brief generated from your own prompt template and written straight into Obsidian — via the same /c/api/cli endpoints the official cubox-cli uses. Agent tools plus a web settings panel.

Features

• Scheduled sync — a timer pulls your latest bookmarks into a local cache (~/.dsh/dsh-cubox-cache.json) every N minutes (default 60, configurable; 0 disables the timer). Manual sync anytime with cubox_sync.
• AI daily brief — write your own prompt template (e.g. "今日收藏简报", {collection} is replaced with the formatted collection for the sync window: title / source / summary / annotations). When an LLM key is configured, every sync generates a brief into the output dir — 今日收藏简报-YYYY-MM-DD.md for a 1-day sync, 最近N日收藏简报-YYYY-MM-DD.md for wider windows (each window gets its own file).
• Markdown export — set outputDir and optionally keep one markdown file per card (frontmatter + title + description + Cubox/original links + annotations, same layout as the official Cubox Obsidian plugin). Toggle exportCards off to write only the AI brief.
• Query — cubox_cards filters by keyword, time window, annotated/starred/read status.
• flomo annotation sync — after each sync, newly created / changed annotations (highlights + thoughts) are pushed to flomo as a daily digest (card title + link + annotations). It reuses the ~/.dsh/dsh-flomo.json credentials (no new secret), keeps a local dedup ledger (~/.dsh/.cubox-flomo-annotations-sent) so nothing is pushed twice, only pushes annotations older than N minutes (default 60) to avoid half-typed notes, replaces every ASCII # in the body with the full-width ＃ (#123 still reads as ＃123; flomo only turns an ASCII #word into a tag) and appends only the configured tag, auto-splits long digests across memos, and can target flomo / local markdown / Notion with an optional LLM rewrite ({digest} prompt).
• Config & status — cubox_config / cubox_status / cubox_flomo; credentials persist to ~/.dsh/dsh-cubox.json (mode 0600), secrets never echoed.
• Settings panel — Settings → Cubox: paste the API-extension link, set the sync interval, pick the local export folder (OS folder chooser), toggle per-card export, edit the AI brief prompt and LLM settings (OpenAI-compatible, defaults to DeepSeek), and configure / manually push the flomo annotation digest.

Install

# after publishing to GitHub (repo tagged with the `dsh-plugin` topic)
dsh plugin --profile web add github:zhengjy01/dsh-cubox

# local development
dsh plugin --profile web add link:/path/to/dsh-cubox

Restart dsh web. The plugin ships pre-built — lib/index.js is plain ESM.

Current release: v0.2.0 (Releases · npm).

Configure

• Open Cubox preferences → Extensions & Automation → API Extension → enable it and copy your unique link (e.g. https://cubox.pro/c/api/save/abcd12345).

• Give the link to the plugin — either in the settings panel (Settings → Cubox), or just ask the agent:

  帮我配置 Cubox，API 链接是 https://cubox.pro/c/api/save/abcd12345
  

  The agent calls cubox_config to persist it. cubox.pro is the default server; cubox.cc is the international instance (auto-detected from the link).

• (Optional) Set the export dir + AI brief: choose the local folder, paste an OpenAI-compatible API key (DeepSeek by default), and edit the prompt template. {collection} is replaced with today's collection list.

Then:

同步一下今天的收藏                → cubox_sync (days=1)
查一下收藏里关于 LLM 的文章       → cubox_cards (keyword="LLM")

The API link and the LLM key are credentials — anyone holding them can read (and modify) your Cubox data or spend your LLM quota. They are stored in ~/.dsh/dsh-cubox.json (mode 0600). To rotate, refresh in the Cubox API-extension page, then re-configure.

Tools

Tool	Purpose
cubox_status	Connection & cache status
cubox_config	Set / clear apiLink, server, token, syncMinutes, outputDir, exportCards, llm*, plus the digest options flomoEnabled / exportDest / flomoTag / flomoMinAgeMinutes / usePrompt / exportPrompt / notion*
cubox_sync	Pull the last N days (default today) into the local cache + export markdown + AI brief + digest push
cubox_cards	Query the collection (keyword / days / annotated / starred / read)
cubox_flomo	Push new / changed annotations to flomo now (days window / force bypass min age / tag override)

Notes

• The public Cubox "open API" only accepts saves; reads go through the internal /c/api/cli/* family (same endpoints as the official cubox-cli).
• The sync cache is a plain JSON snapshot (cards + today's annotations, deduped by id, newest first) — agents can answer "what did I save" without extra round trips.
• License: MIT