dsh-fish-soul-patches
Unofficial experience patches for dsh-fish-soul (MIT).
Not affiliated with or endorsed by the upstream author. Tested against dsh-fish-soul@0.18.2; anchors may break on newer versions.
What this is
A patch kit, not a fork and not a plugin. It applies a set of anchor-based patches to the installed
dsh-fish-soul package inside your DSH profile:
- Continuity prompt — finish unfinished thoughts in the same turn, ask a topic-related follow-up instead of ending the conversation.
- First-reply delay — a small 0.6–3 s human-like delay before the first bubble.
- No-reply follow-up chain — after a private chat reply, wait a random 3–9 min; then follow up or close. If the first follow-up was a follow-up (not a closing), roll 30 % after 4 min for a second one.
- Auto-continue — when a reply is a flat statement (no question, no explicit closing), optionally send one more topic-related line after 3–8 s; cancelled as soon as the user replies.
- Reasoning fallback — if the model puts the whole reply in reasoning and leaves the text empty, salvage the last “输出/答案/回复” segment.
- Closing-marker handling — strip and recognize
【收尾】and bracket variants so the marker never leaks to QQ. - QQ text rules — require the real outgoing text in the reply body, and “finish it this turn”.
- Proxy fake-IP allowance — allow
198.18.0.0/15(Clash fake-IP) insafeDownload, otherwise QQ images/CDN downloads are rejected as reserved addresses. - X topics — a small daily topic source: authoritative X accounts + authoritative news, filtered by age/domain/keywords and a monthly search budget. No X API, no X login; uses the plugin’s configured web search (Tavily/Bocha/host).
- Settings UI — “连续对话(补丁)” under Platform → QQ, and “X 话题(补丁)” under Model → Web
Search; plus
GET/POST /patchesandPOST /x-topics/run.
Requirements
- DSH Desktop with
dsh-fish-soul@0.18.2installed (the desktop profile is app-managed; install the plugin through the DSH plugin manager/market, notdsh plugin --profile desktop ...). - Node.js ≥ 22.5.
- Optional: a Tavily API key (free tier, no credit card) for the X topics feature; or Bocha / DSH host search.
Install
# 1) install dsh-fish-soul@0.18.2 in DSH (plugin manager / market)
# 2) clone or copy this repo anywhere
node ./patch-fish-soul.mjs
The script resolves the profile from DSH_PROFILE_DIR, or defaults to ~/.dsh/profiles/desktop.
Expected output: all [ok] or [done]. If you see [!!], upstream changed the anchor — do not
force it; open an issue with the output and your plugin version.
Then restart DSH and refresh the settings page (UI chunks are cached by the web client).
Re-running the script is safe (idempotent). Reinstalling/upgrading the plugin wipes the patched files, so run it again afterwards.
Configuration
Patches never overwrite your config. Merge the relevant sections from
fish-soul-patch/fish-soul-config.example.json into ~/.dsh/fish-soul-config.json, or edit them in the
settings UI.
followup — continuity
{
"enabled": true,
"minMinutes": 3,
"maxMinutes": 9,
"secondMinutes": 4,
"secondChance": 0.3,
"autoContinue": { "enabled": true, "chance": 0.45, "cooldownSeconds": 60, "minDelayMs": 3000, "maxDelayMs": 8000 }
}
xTopics — daily topics
{
"enabled": true,
"sources": ["x", "news"],
"runsPerDay": 3,
"newsPerRun": 2,
"xPerRun": 1,
"itemsPerDay": 5,
"maxAgeHours": 48,
"maxXAgeHours": 168,
"monthlySearchCap": 280,
"dailySearchCap": 10,
"slots": [12, 18, 21],
"activeHours": [8, 24],
"queries": [],
"xQueries": [],
"newsDomains": [],
"authorityOnly": true,
"excludeKeywords": [],
"share": false,
"sharePerDay": 1
}
Budget: default 3 runs × (2 news + 1 X) = 9 searches/day ≈ 270/month; monthly cap 280, daily cap 10. Tavily’s free tier is 1,000 credits/month, leaving ~70 % for ad-hoc chat searches.
Why X + news? Public search indexes contain X posts that are often days or months old; pure X
cannot reliably produce 3–5 fresh items per day. Set "sources": ["x"] if you only want X.
tools.web — web search
{ "enabled": true, "perDay": 20, "provider": "tavily", "apiKeys": { "tavily": "tvly-YOUR_KEY" } }
Tavily free tier: 1,000 credits/month, no credit card. Alternatives: bocha (domestic, Alipay),
host (DSH built-in), brave, searxng.
Settings UI
After restarting DSH:
- Platform → QQ → 连续对话(补丁): follow-up window, second follow-up, auto-continue.
- Model → Web Search → X 话题(补丁): sources, budget, limits, slots, custom queries, “跑一轮”.
Data and files
- Patch entry:
patch-fish-soul.mjs - Patch data:
fish-soul-patch/ - Manifest:
fish-soul-patch/manifest.json - Example config:
fish-soul-patch/fish-soul-config.example.json
New table in soul.db: x_topic. KV counters: xTopics.day / dayRuns / daySearches / month / monthSearches.
Updating the plugin
- Upgrade
dsh-fish-soulthrough DSH. - Run
node ./patch-fish-soul.mjs. - If everything is
[ok]/[done], restart DSH. - If an anchor is missing, check the upstream diff; update the data files in
fish-soul-patch/and the corresponding section inpatch-fish-soul.mjs.
Limitations & caveats
- Patches modify files inside
node_modules; a plugin update/reinstall removes them. Keep this repo. - X topics relies on third-party search indexes; freshness and coverage are limited. It does not call the X API and does not log in to X.
- Platform terms (QQ/SnowLuma, Bilibili, Douyin, X, Tavily, Bocha) are the user’s responsibility. Do not use this to spam, scrape at scale, or violate rate limits.
- No credentials, cookies, API keys, chat databases, or personal data are included in this repo.
Security
- Review the patch script before running it; it writes to
~/.dsh/profiles/desktop/node_modules/dsh-fish-soul/lib/. - Keep your real
fish-soul-config.json,soul.db,chat-archive.db, logs and API keys out of git (see.gitignore). - The example config contains a placeholder key only.
License & attribution
Contains code derived from or excerpted from
dsh-fish-soul (MIT, declared in its package.json;
no LICENSE file was present in the upstream repository at the time of writing). Original additions in
this repo are Copyright (c) 2026 the patch author.
“dsh-fish-soul” is used only to describe compatibility. All trademarks belong to their respective owners. This project is not an official part of dsh-fish-soul.
中文说明
这是 dsh-fish-soul(MIT)的非官方体验补丁包,不是插件本体,也不包含上游完整源码。测试版本 0.18.2,上游改结构后锚点可能失效。
安装:在 DSH 里装好 dsh-fish-soul@0.18.2,把本仓库放到任意目录,运行:
node ./patch-fish-soul.mjs
全部 [ok]/[done] 后重启 DSH,并刷新设置页。升级插件后需要重跑。设置页会多出「连续对话(补丁)」和「X 话题(补丁)」两个分组;参数也可直接改 ~/.dsh/fish-soul-config.json。
注意:补丁改的是 node_modules 里的文件,重装插件会被清掉;X 话题不调用 X API、不登录 X,走你已配好的联网搜索(Tavily 免费 1000 次/月,或博查/DSH 自带);不要把真实配置、数据库、日志、API key 提交到 git。
No comments yet. Be the first to write one.