dsh-clear-conversation
DeepSeek Harness 插件：按需清除对话上下文，让旧的对话轮次不再消耗令牌
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:William20100221/dsh-clear-conversation#064e98304cf97507b23833d2ecdc7fa3dcc47a19Clear Conversation 以 dsh-clear-conversation 发布，当前版本为 0.6.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Say "clear everything above" and DeepSeek Harness actually forgets it.
Long sessions get slow and expensive: every request resends the whole history, and old topics leak into new answers.
This DeepSeek Harness (dsh) plugin lets you drop that history in plain words, mid-conversation, without starting a new session.
What a session looks like (illustrative):
You: My favourite colour is green. Now help me name a cat.
dsh: How about "Basil"? It suits a green-loving owner.
You: Clear everything above, then tell me a joke.
dsh: [clear_conversation] Context cleared.
Why don't skeletons fight? They don't have the guts.
You: What's my favourite colour?
dsh: I don't know. You haven't told me in this conversation.
dsh plugin --profile web add github:William20100221/dsh-clear-conversation
dsh web
That's it: no build step and no configuration. Using the DeepSeek Harness desktop app? Open Plugins → Add plugin and enter github:William20100221/dsh-clear-conversation. New to dsh, or want to try it safely first? See TESTING.md.
/clear command. Clear everything yourself while the agent is idle (Web, Desktop and SDK)./clear shows a collapsible "Context cleared" card with the input tokens released, measured by dsh's own token meter. Open it to see which prompts were cleared.DSH_CLEAR_CONVERSATION_NO_UPDATE_CHECK=1 to switch the check off.dsh builds every request from the session's surface, an ordered list of messages. Its own /compact command replaces a run of old turns with an AI-written summary. This plugin uses the same mechanism, but writes one short note instead of a summary, so it costs nothing to run.
flowchart LR
A[System prompt] --> B[Old turns] --> C["Your message: clear, then X"] --> D[Reply]
B -. replaced by .-> N["Note: earlier conversation cleared"]
Does it delete my messages? No. The transcript and session log keep everything. Only the model's view changes.
Can I undo a clear? Not yet. The old turns stay readable, but cannot be put back into the model's context.
Can the cleared messages be folded away in the transcript? Not from a plugin today. dsh's Web UI gives plugins no way to hide messages it has already drawn, which is also why messages compacted by /compact stay visible. The "Context cleared" card shows where the clear happened instead.
Does it contact the internet? Once per start, to ask GitHub for the latest release number. Nothing about your sessions is sent. Set DSH_CLEAR_CONVERSATION_NO_UPDATE_CHECK=1 to switch it off.
Which dsh surfaces does it work in? The tool works everywhere the model runs. /clear appears where dsh shows commands: Web and SDK, not ACP or headless.
How do I remove it? dsh plugin --profile web remove dsh-clear-conversation, then restart dsh.
Status? Preview, for dsh 0.2.1-rc.5 and later 0.2.x releases. Clearing by request and /clear are confirmed in the desktop app; the /clear card and token count are new and covered by tests. Please open an issue if something breaks.
This repo also keeps the earlier Cherry Studio work. Each part works on its own.
mcp-server is a tiny tool you add in Cherry Studio's MCP settings. No fork needed, and it really saves tokens.
It works by writing the Ctrl+K divider into Cherry Studio's database, with a backup first. If a Cherry Studio update changes the database, it stops and asks you to update.
node server.mjs --check verifies your setup and tells you when a newer version exists.See the MCP server README for install steps.
skill/clear-conversation is an Agent Skill. It works in stock Cherry Studio agents, Claude Code, and other apps that load skills.
SKILL.md.See the skill README for install steps and phrases.
William20100221/cherry-studio, branch feature/clear-context-tool adds a built-in clear_conversation tool. With it, a clear is real: older messages stay on screen but are no longer sent to the model, which saves tokens.
| Chat topic | Agent session | |
|---|---|---|
| Needs the skill | No, the tool's description is enough | Yes, for the full rules |
| Where the divider goes | Directly above the message that asked | After the current turn |
| When the fresh start begins | The next turn | The next turn, once the session is idle |
| Undo | Click the divider, or the Undo toast | The Undo toast (10 s) |
| Ctrl+K / eraser | Divider now, or a queued clear while streaming | Same |
| Ctrl+L | Stops the reply, then divider or delete (setting), queue continues | Same |
| Delete mode | Always asks first, also when the model requests it | Same |
Settings → Context Management has two switches: the default clear action (divider or delete) and whether the assistant may clear at all.
In an Agent session, follow-ups already queued behind the clearing turn still run with the old context.
npm test
The tests exercise the clearing logic against a stand-in session; they do not start dsh.
MIT for this repo. The Cherry Studio fork stays under Cherry Studio's AGPL-3.0 license.