dsh-title-curator
Stable, human-recognisable session titles for DeepSeek Harness.
Every session ends up as category emoji + object｜goal, for example 🧩 邮箱注册｜验证码过期修复. The naming policy is ported from oil-codex-title; the scheduling, state machine and host integration are written against DSH's official session-title API.
中文说明
Sidebar after the plugin
Real sidebar capture (default width; the host truncates long titles).
Why
A sidebar full of "回应中文问候"、"继续修改" is useless once several projects run in parallel. This plugin keeps the title on the main line of work instead of the last sentence: the object stays stable, the goal updates only when the work actually changes, and anything you renamed yourself is never touched again.
What it does
| |
|---|
| Trigger | user/message (debounced), turn/end, session/created (opening an old conversation), first request/header |
| Model | the session's own route via ctx.llm.stream, cheapest supported reasoning effort |
| Write | ctx.sessionTitle.rename(), metadata only — no message is added, nothing enters model context |
| Failures | silent: the current title stays, the reason goes to audit.jsonl |
Behaviour worth knowing:
- Idempotent — a content fingerprint (policy version + cwd + title + recent message hashes) skips unchanged opportunities without a model call.
- Manual rename wins forever — the plugin records the title event seq it wrote; any change afterwards locks the session permanently.
- No duplicate titles — a candidate equal to another live session's title is retried once with the conflict list, then dropped rather than decorated with a fake suffix.
- Keep-only-when-compliant — a
keep answer against a title that does not match emoji + object｜goal is rejected and retried with explicit feedback.
- Cheap — pure acknowledgements ("ok", "thanks", "继续") skip the model, and a session is evaluated at most once every 90 seconds.
Install
From GitHub:
dsh plugin --profile desktop add github:chancecc99-gif/dsh-title-curator
From a local checkout:
dsh plugin --profile desktop add /absolute/path/to/dsh-title-curator
Restart the host afterwards (a new package needs a fresh module generation). Uninstall:
dsh plugin --profile desktop remove dsh-title-curator
Titles already written are ordinary session/title events and survive uninstall.
Configuration
Override the row in the profile's cordis.patch.yml:
- id: title-curator
config:
enabled: true
debounceMs: 6000
minIntervalMs: 90000
maxTokens: 700
sweepDelayMs: 4000
See README.zh.md for the full table.
Privacy
Only the last 5 human messages (600 chars each), the current title, the last cwd segment and up to 16 titles of other live sessions are sent to the model. Assistant answers, tool output, file paths and attachments are never included.
State lives in $DSH_HOME/plugin-data/dsh-title-curator/ (state.json, audit.jsonl). Deleting it degrades safely to "never touch a user-sourced title".
Limits
- Only live sessions can be renamed: DSH exposes no public write path for a session that is not mounted. Opening a conversation triggers a pass; an untouched, never-opened session keeps its old title.
- Titles are metadata, not folders — the emoji is a visual group, not a category tree.
- A session with thousands of events costs one log scan per evaluation.
Development
npm test # 24 tests: validators, parser, assembler, fingerprint, decision table, end-to-end host fake
Licence
MIT. Naming rules and the original Codex implementation: oil-oil/oil-codex-title (MIT).
