Skip to main content
W

dsh-deferred-ask

wangyz911/dsh-deferred-ask

Queues questions written in the composer and sends them only while DeepSeek bills at off-peak rates. Delivery is driven by a 30-second clock check rather than a pre-scheduled trigger, so a question missed while the app was closed is not released into the peak window. Up to 50 queued items, localStorage persistence, retry with exponential backoff, and a send-now button that pays the peak price.

Install

dsh plugin --profile web add github:wangyz911/dsh-deferred-ask

README

A queued question waiting under the composer, with the off-peak moon

Deferred ask

English | 中文

Queue a question from the composer and let DSH send it only while DeepSeek bills at off-peak rates — half the peak price.

Write the question you would otherwise ask now, press Ctrl+Enter, and it waits. When the off-peak window opens, the question is delivered on its own, so nothing is left to remember at 22:00.

Why it waits instead of scheduling ahead

DSH replays a scheduled task's missed occurrence on the next launch, and only the latest one. If the trigger were pinned at enqueue time (timing: {kind: 'at'}), that catch-up delivery could easily land inside a peak window and bill at full price.

So this plugin inverts the order: every 30 seconds it checks the clock, and only once the clock really is off-peak does it create a one-shot schedule that fires five seconds later. A question queued at noon on Tuesday is therefore delivered at 12:00:05, and one queued at 17:59 at 18:00:05.

Pricing window

Asia/Shanghai (UTC+8, no daylight saving):

WindowBilling
Mon-Fri 09:00–12:00 and 14:00–18:00peak (full price)
every other hour, including weekendsoff-peak (peak × 0.5)
Chinese public holidays, all dayoff-peak — but see the limit below

No holiday calendar is bundled, so a public holiday is treated as an ordinary weekday: the question goes out after 18:00 rather than immediately, which is later than the cheapest moment but never more expensive.

Usage

  • Queue: Ctrl+Enter, or click Defer to off-peak. The queue lives in localStorage (dsh.deferredAsk.queue.v1) and survives reloads.
  • Delivery: within 30 seconds of the window opening. The default target is a new session: the folder is resolved from the current session's workspace, then from cwd on the Host's session summaries, and finally from the folder pinned in the panel, which always wins.
  • Follow-up in place: choose Continue in this session in the panel (stored as "path": "") to force delivery into the current session; choose Automatic to release the pin.
  • Retry: a failed delivery keeps the item and retries with exponential backoff (from 5 minutes up to 1 hour), showing the error text on the item. An item is never delivered twice concurrently.
  • Send now: delivers immediately at peak price, useful for testing or for changing your mind.
  • Limit: 50 queued items.

Limits

  • The discount applies to per-token billing only; a flat subscription sees no change.
  • DSH must be running when the window opens. A closed app delivers on the next tick after it starts.
  • A queued question is billed for its own tokens: moving it to off-peak halves the unit price, not the token count. Because it usually starts a fresh session, write it as a self-contained question rather than "continuing from that bug".
  • The 30-second ticker only runs while DSH is open; nothing is scheduled into the OS.

Install

dsh plugin --profile <profile> add dsh-deferred-ask

For a local checkout, add it as a link instead:

dsh plugin --profile <profile> add link:C:/path/to/dsh-deferred-ask

The bundle then appears in Plugins as Deferred ask; the bar shows up under the composer of a conversation.

Implementation notes

For DSH plugin authors, the parts that are easy to get wrong:

  • inject must list nested services in full — ['slots', 'locale', 'remote', 'remote.schedule', 'remote.session']. Writing only remote fails later with without inject when remote.schedule is read.
  • The working folder has three sources: the workspaces snapshot (items[].sessionIds plus WorkspaceView.path), ctx.remote.session.list()'s SessionSummary.cwd, and the pinned folder in localStorage (dsh.deferredAsk.target.v1). Either of the first two can be empty for some sessions, so the third exists.
  • The picker has three states: no key means automatic, {"path": ""} means follow the current session (overriding automatic resolution), and {"path": "D:\\..."} pins a folder. An early version read the empty string as "no pin" and kept opening new sessions.
  • The selector hooks offered for that slot (useWorkspaces, useSession) are typed <S>(selector, equals?) => S; calling them without a selector throws, which is why the folder is not read through them.
  • The panel mounts at conversation.composer.dock, with a floating fallback at shell.overlay for when the dock is unavailable. shell.overlay runs in root scope with no sessionId in its props, so Continue in this session is refused there with a message rather than silently opening a new session.

License

Not yet chosen. Add a LICENSE file (MIT is the usual default for DSH plugins) before publishing the package.

Related plugins