dsh-genspark
A plugin that brings Genspark's AI capabilities into DeepSeek Harness (DSH).
Search, research, image/video/audio generation, media analysis, and social network search
(X / Instagram / Reddit) can all be called from the composer with /genspark-* commands.
Japanese: README_ja.md
Getting started
1. Install the CLI and log in
npm install -g @genspark/cli
gsk login # opens the browser → approve with your Genspark account
gsk me # success if your email, plan, and remaining credits are shown
-
Credentials are stored in ~/.genspark-tool-cli/config.json. This plugin never holds secrets
(it only uses what the CLI has saved).
-
On machines without a browser (CI, servers), you can authenticate with an API key instead.
$env:GSK_API_KEY = "gsk_..." # your Genspark API key
-
To switch accounts, run gsk logout → gsk login.
-
You can check the login state at any time with /genspark (or gsk me).
2. Install the plugin into a profile
powershell -ExecutionPolicy Bypass -File .\install-to-profile.ps1 -Profile "$env:USERPROFILE\.dsh\profiles\web" -Sync
To install it into the desktop app as well, run the same command against ...\.dsh\profiles\desktop.
3. Restart DSH
Reloading the page is not enough (the plugin is loaded only once, when the server starts).
After restarting, run /genspark; if your account and remaining credits appear, you are ready to go.
Commands
Available from the composer's + menu, or by typing / at the start of a line.
(When opening the menu with +, leave the input field empty — commands that take arguments
only appear as suggestions when it is empty.)
Search and research
| Command | What it does | Example |
|---|
/genspark | Connection status, account, remaining credits | /genspark |
/genspark-search | Web search | /genspark-search DeepSeek V4 reviews |
/genspark-image-search | Image search | /genspark-image-search cherry blossoms in full bloom |
/genspark-crawl | Read the body of a page | /genspark-crawl https://example.com/article |
/genspark-scholar | Find academic papers | /genspark-scholar diffusion model speech |
/genspark-maps | Look up maps and places | /genspark-maps cafes near Tokyo Station |
/genspark-summarize | Summarize a long document (PDF supported) | /genspark-summarize <URL> What are the key points? |
Create
| Command | What it does | Example |
|---|
/genspark-image | Generate an image | /genspark-image Mount Fuji at sunset |
/genspark-video | Generate a video | /genspark-video cherry petals falling, 5 seconds |
/genspark-audio | Generate speech or music | /genspark-audio Good morning |
Artifacts are saved to <working directory>/genspark-out/, and the save path and size are displayed.
Typical wait times (measured): images 15–40 s / audio 30–60 s / video 1–2 min (about 50 s for a
5-second 720p clip; longer videos take longer). Generation and analysis commands reply with
"Sending to Genspark…" immediately after input, and the result arrives in the chat afterwards.
Understand
| Command | What it does | Example |
|---|
/genspark-analyze-media | Describe what is in an image, video, or audio file (audio is transcribed) | /genspark-analyze-media genspark-out/test_cat.jpg What is it doing? |
Social search
/genspark-social lets the AI decide which service to search and runs the appropriate
search on X / Instagram / Reddit (the command itself calls no API, so credits are spent only on
the searches that are actually performed).
| Command | What it does | Example |
|---|
/genspark-social | The AI picks and searches X, Instagram, and Reddit | /genspark-social DeepSeek Harness reviews |
/genspark-x | Search X (Twitter) only (posts, users, profiles) | /genspark-x recent posts from @elonmusk |
/genspark-instagram | Search Instagram only (posts, users) | /genspark-instagram @natgeo |
/genspark-reddit | Search Reddit only (posts, comments, subreddits) | /genspark-reddit local llm reviews |
- You can get the same results by asking the AI (e.g. "check what people say about Genspark on X"
→
genspark_x_search).
- By default, results show up to 25 items with author, date, reaction counts, and post URL
(newest first).
- About 1.6 credits per call (measured). Instagram searches take 10–15 seconds, and Reddit's
"post with comments" and "subreddit posts" can take around 40 seconds.
- On X, passing "@username" returns that user's posts, while passing a "topic" runs a post
search. Instagram works the same way. Reddit accepts
sort (top / new, etc.) and a time range.
- Search tips (measured): keep queries to 1–2 words / for Japanese topics use
language="ja"
(the AI adds it when you ask for results "in Japanese") / "#hashtags" do not narrow anything /
on Reddit, naming a subreddit such as "in r/LocalLLaMA" tends to work better.
- If you see "failed to execute", it does not necessarily mean the feature is unsupported
(transient failures do happen). The plugin retries automatically once. If it still fails,
wait a while or change the wording.
- Comment fetching is often empty in practice (that is not a failure). Reddit search results do
not include score (vote count), so results are ordered by date instead.
Advanced
| Command | What it does | Example |
|---|
/genspark-models | List the generation models you can choose from | /genspark-models video |
/genspark-tools | Search across all 327 tools | /genspark-tools slack |
/genspark-run | Run any tool once | /genspark-run me |
Using attachments
The following 5 commands accept images, video, audio, and documents attached directly.
When you attach something, the text in the input field is treated as the instruction or question.
| Command | How the attachment is used |
|---|
/genspark-analyze-media | The target to analyze (image, video, audio) |
/genspark-summarize | The document to summarize |
/genspark-crawl | The page file to read |
/genspark-image | A reference image (editing, style transfer) |
/genspark-video | The first frame (create a video from an image) |
Example: attach a photo of a cat and run /genspark-analyze-media What is it doing?
Choosing a generation model
Each command runs with a default model, but Genspark offers many models and you can switch
between them.
| Kind | Default | Available |
|---|
| Image generation | nano-banana-2-flash-lite | 15 models |
| Video generation | kling/v3 | 21 models |
| Audio / music generation | Genspark's own default | 25 models |
| Transcription | whisper-1 | 3 models |
How to use them:
- See the list —
/genspark-models (filter by video, image, audio, transcribe, or part
of an id)
- Ask the AI — "Which video models are available?" "List the audio models"
→ the AI returns the list via
genspark_models
- Generate with a specific model — "Create a sunset video with gemini/veo3.1"
→ the AI runs it with the
model argument set
- Model details — "Tell me the specs of kling/v3"
→ the AI reports supported aspect ratios, durations, and whether audio is available via
get_model_info
Model names are not pinned in the plugin. The list is read from Genspark's catalog every time,
so models that are added or retired are picked up automatically.
If you type "model list" or "usage" into a generation command (/genspark-image,
/genspark-video, /genspark-audio), it returns the list or the usage without generating
anything (no credits are spent). When you want to generate, just describe what you want.
Settings
You normally do not need to change anything. Only when necessary, add these to the plugin
settings of your profile.
| Key | Default | Description |
|---|
enabled | true | Set to false to unregister all tools |
cliEntry | "" | Absolute path to the CLI entry (auto-detected when empty) |
nodePath | "" | node.exe for child processes (auto-detected when empty) |
writeMode | approve | approve (reject unapproved writes) / deny / allow |
timeoutMs | 600000 | Timeout per gsk invocation |
promotedCategories | ["search","media","social"] | Categories registered as typed tools |
commands | true | Register the composer commands |
commandFollowup | true | Hand command results to the AI for interpretation |
commandInlineWaitMs | 2500 | Upper bound for holding the input field (milliseconds) |
debug | false | Send the CLI's stderr to the log |
Troubleshooting
| Symptom | What to do |
|---|
| "API key is required" appears | Run gsk login (or set GSK_API_KEY) |
| A "CLI not found" message appears | Run npm install -g @genspark/cli. If it still fails, set cliEntry |
| Commands do not show up in the list | Check that DSH was restarted (setting commands: true) |
| Attaching a file says it is not accepted | Only the 5 commands listed above support attachments |
| The input field freezes for a few seconds while sending | By design (it clears after 2.5 s by default, and the AI reports the result in the chat) |
| Generation fails | Check your remaining credits with gsk me |
| A model list appears instead of a generation | By design (the request was detected as a "model list" request, and no credits were spent) |
/genspark shows nothing in a new conversation | Right after "New session", session creation (the screen transition) may not have finished. Wait until the display settles before running it, or send a short message first. If it still shows nothing, note the time and let us know (this is host behaviour and cannot be controlled from the plugin) |
/genspark-video stays unresponsive for a while in a new conversation | Generation commands raise a short turn as soon as they accept the input, which dismisses the hero screen (0.1.10+). If it is still unresponsive, the session transition may not have finished |
| Videos and images are not saved / generation ends immediately | The result includes status, failure_reason, and task_id (0.1.11+). If it is FAILED, the prompt may have been rejected by the sensitive-content filter (try different wording). Re-running the same command starts a new generation, so credits are spent |
/genspark-social only replies that the AI will choose and search | By design. The AI then calls the actual search tools and explains the results in the chat |
| A social search says "failed to execute" | This can be a transient upstream failure (one automatic retry has already been made). Wait a little and change the wording, or change the action. Some actions, such as count_posts and Reddit comment search, are not supported upstream |
Learn more
- Tools (the functions the model calls), arguments, implementation notes, and verification steps → SKILL.md
- Design history and measurement records →
../docs/
- Changelog → end of SKILL.md
