Name: dsh-autotitle
Author: echouniverse

インストール

dsh plugin --profile web add github:echouniverse/dsh-autotitle

README

@hanxu131/dsh-autotitle

给 DeepSeek Harness（DSH）加一条斜杠命令 /title：根据当前对话生成会话标题，长对话会智能删减后再调用模型。

English · npm · GitHub · 插件开发文档

这是什么？

一句话：用 /title 给当前会话起一个清楚的名字。

命令	做什么
`/title`	读对话 →（太长就删减）→ 用当前模型生成标题 → Web 上可确认 → 写入会话标题
`/title 我的标题`	不调模型，直接把会话标题设成你写的名字

适用场景：

DSH Web UI（dsh web）
ACP / DSHACP（Zed 等客户端）
其他挂了 commands 注册表的 DSH profile

开始之前

已安装 Node.js（建议 ^22.19 或 >=24）
能跑通 DSH，例如：

dsh --version
# 或
npx -p @deepseek-ai/dsh dsh --version

想清楚你平时用哪个 profile（常见：web、acp）。插件要装进你实际启动的那个 profile，不会全局共享。

安装（推荐）

把下面的 web 换成你的 profile 名（例如 acp）：

dsh plugin --profile web add @hanxu131/dsh-autotitle

没有全局安装 dsh 时：

npx -p @deepseek-ai/dsh dsh plugin --profile web add @hanxu131/dsh-autotitle

装完必须重启

你用的前端	重启什么
Web UI	停掉再开 `dsh web`
DSHACP / Zed	重启 ACP / `dsh --profile acp` 进程

然后在对话里输入 /title 试一下。

升级

dsh plugin --profile web update @hanxu131/dsh-autotitle

卸载

dsh plugin --profile web remove @hanxu131/dsh-autotitle

使用说明

Web UI 确认框

默认 confirm: true 时，Web 会弹出确认：

接受此标题 — 采用生成结果
重新生成 — 再调一次模型
取消 — 不改原标题

也可以在下方「输入你的答案」里写自定义标题再提交。

选项旁边的数字 1 / 2 / 3 只是展示，不能当快捷键（这是 DSH Web UI 的限制）。请用鼠标点选。

ACP / headless

没有确认 UI 时，生成后会直接设为会话标题。

配置（可选）

默认配置在本包的 cordis.patch.yml。要改参数，可在对应 profile 的用户补丁里覆盖同名行，例如 ~/.dsh/profiles/web/cordis.patch.yml：

- insert:
    - id: autotitle
      name: '@hanxu131/dsh-autotitle'
      config:
        confirm: true
        maxLength: 60
        language: follow
        prefix:
          enabled: true
          types: [Bug, Feature, Question, Refactor, Docs]
        trim:
          threshold: 15000
          window: 8000
          anchorChars: 500
        maxOutputTokens: 64
        timeoutMs: 30000

配置项	默认	含义
`maxLength`	`60`	提示模型「标题最多约这么长」
`prefix.enabled`	`true`	允许 `[Bug]` 这类前缀
`prefix.types`	见上	可选前缀列表
`language`	`follow`	`follow` / `zh` / `en`
`trim.threshold`	`15000`	估算 token 超过此值才删减
`trim.window`	`8000`	删减后保留最近约多少 token
`trim.anchorChars`	`500`	第一条用户消息锚定截断长度
`confirm`	`true`	有确认 UI 时是否询问
`maxOutputTokens`	`64`	生成标题的最大输出 token
`timeoutMs`	`30000`	生成超时（毫秒）

长对话删减策略：保留第一条用户消息（主题锚）+ 最近窗口，中间用 [... N messages omitted ...] 省略。

和内置自动标题的关系

DSH 自带的 first-prompt 自动标题（dsh-session-title-first-prompt-llm）会在首条消息后自动命名。本插件是手动 /title，看整段（可删减）对话，两者互补，不必关掉内置功能。

本地开发

git clone https://github.com/ECHOUniverse/dsh-autotitle.git
cd dsh-autotitle
pnpm install   # 或 npm install
pnpm build
dsh plugin --profile web add link:"$(pwd)"

改完代码后重新 pnpm build，并重启对应 DSH 进程。

链接

资源	地址
npm	https://www.npmjs.com/package/@hanxu131/dsh-autotitle
GitHub	https://github.com/ECHOUniverse/dsh-autotitle
DeepSeek Harness	https://deepseek.com/harness/zh/
第一个插件教程	https://deepseek-harness.github.io/deepseek-harness/develop/basic/
姊妹项目（Pi）	https://www.npmjs.com/package/@hanxu131/pi-autotitle
DSHACP（Zed）	https://github.com/ECHOUniverse/dshacp

License

MIT

dsh-autotitle