前言¶
在 DeepSeek Harness(DSH)Web 端做日常对话或智能体开发时,常见需求是让助手每轮回复的开场、收尾保持一致——要么在系统提示里反复写规则,要么每次手动粘贴同一句;字号、颜色、动效等视觉统一更难靠提示词实现。DSH 生态按「一切皆插件」扩展能力;社区目录 SkillHub 上的 dsh-greet-signoff(维护者 weifa860504-droid)面向 Web 端,把开场/收尾文案与样式做成可配置项,并附带本机会话花费台账与换会话时的交接摘要落盘。自 1.23.0 起,插件不再在输入框上方自绘上下文占用卡——占用率请用 DSH 官方输入框内的上下文圆环;本插件聚焦开场收尾、台账与 HANDOFF。
这是什么¶
dsh-greet-signoff 是 DSH 的 Web 插件(npm 包 / GitHub 仓库分发,许可证 MIT,当前 package 版本 1.24.0,声明兼容 DSH 0.1.5-rc.1)。它在每轮助手回复的正文首行、末行按配置渲染开场语与收尾语,规则写入系统提示段,浏览器端按文本匹配贴样式;另可读本机 usage 文件做花费台账,并把模型输出的交接块写入工作区 HANDOFF.md。配置默认在插件目录 config/greet-signoff.json,也可通过环境变量 DSH_GREET_SIGNOFF_HOME 指定位置;改完保存后下一轮回复即生效(组合层安装变更除外,见下文)。
核心功能¶
固定开场语与收尾语¶
- 每次回复正文第一行为开场语、最后一行为收尾语;中间正文不受影响。一条回复被工具调用拆成多个块时,两行仍按文案身份分配样式。
- 设置页左侧菜单「开场收尾」:开场/结束语段控、自动保存(约 1.2 秒)与「保存」按钮;v1.24.0 起左栏常驻预览,点哪一行编辑哪一行,右栏为参数表与搜索。
- 两个独立总开关(iOS 式滑动开关):关掉「开场语」或「收尾语」后,对应规则不再写入提示段,下一次回复生效;文案与样式配置仍保留。配置里仅
false表示关。
行级样式与文案能力¶
开场、结束语各有一套共 19 项可配字段(如 text、fontSize、color / colorDark、animation、shape、fill、borderWidth、shadow 等,非法值会回落默认)。默认开场文案示例为 👋 你好,我是 DeepSeek Harness 助手。,收尾为 ✅ 以上,随时叫我。。
- 一键外观:16 套预设(财神金、极简灰、霓虹赛博等),只改外观不动文案与图片。
- 动效:30 种整体动效 + 4 种逐字动效;设置页可切换「常用 / 全部」列表。
- 文案池(
pool):每轮从池中随机或按顺序选句;场景(scenes)存整份设置快照;bindings 可按工作区目录前缀覆盖文案/样式。 - 动态变量:固定行可用
{date}{weekday}{daypart}{time}{model}{count}{elapsed}{lastelapsed}{tokens}{lasttokens}等,服务端每轮填入真实值。 - 匹配模式(
matchMode):exact/ 默认loose/fuzzy,用于浏览器半给对应行贴样式类;可选onlyAssistant: true只贴助手消息。 - 深浅色:综合页面主题与底色亮度,写入
<html data-gs-dark>,深色档颜色可单独配置。
花费台账¶
设置页展示本条会话、今天、近 7 天、最贵几条会话等账;计价口径在全局 pricing(默认未命中输入 / 缓存命中输入 / 输出,元每百万 token 可配)。数据只读本机 dsh-usage/usage-ledger.json 与 session_projcache,不联网、不外发、不建库。接口:GET /api/greet-signoff/cost?sessionId=<id>&days=7。
交接摘要¶
模型在正文里用 <<<HANDOFF>>>…<<<END>>> 包裹的摘要,可通过 POST /api/greet-signoff/handoff 落盘到工作区根目录 HANDOFF.md(已存在会先备份 .bak);新会话时宿主侧提示会提醒先读该文件,便于换会话延续上下文。
诊断、连接自愈与导出¶
- 设置页「诊断 → 跑一遍自检」:配置、文案、贴样式、连接自愈、两侧版本等一次检查;
GET /api/greet-signoff/rule-text可查看当前写入模型的规则文本。 - 连接自愈:
dsh web重启换令牌导致页面「自动重连中」时,连续 30 秒异常且根路径仍 200、输入框无草稿则自动重载一次;服务不可用不动作,单标签页每小时最多 3 次、间隔 ≥60 秒。 - 底部支持导出/导入 JSON 配置、「撤销上次保存」。
与官方上下文环、其它插件¶
DSH Web 自带上下文占用圆环(输入框内、发送按钮左侧),与本插件曾用的 contextPressure 投影一致。自 1.23.0 起插件移除输入框上方自绘上下文卡及相关 API(GET /api/greet-signoff/session、GET /api/greet-signoff/context),看占用率请用官方圆环。
- 与
dsh-context:本插件不采集、不落库、不开 context 面板,可共存。 - 与
dsh-gold-capsule:互斥——后者用!important渲染标题内行内代码,会压掉本插件固定行样式;固定行请保持纯文本一行,二选一。
安装与启用¶
插件以 npm 包或 git 仓库为单元安装;装完必须重启 dsh web(组合层变更不会热加载)。Node 引擎要求 >=22.19.0(见 package.json)。
# 从 GitHub 安装(仓库名固定为 dsh-greet-signoff,用户名换成你自己的)
dsh plugin --profile web add github:weifa860504-droid/dsh-greet-signoff
# 或从本地目录安装(开发调试用)
dsh plugin --profile web add <本地包目录的绝对路径>
重启后打开任意会话:回复首尾两行应出现默认样式;设置 → 开场收尾 应出现配置页。
典型用法¶
- 改文案与样式:打开设置 → 开场收尾,编辑开场/结束语
text或点一键外观;左栏预览确认,等待自动保存或点「保存」。下一轮助手回复即带新首尾行。 - 按场景切换:在参数表配置「场景」快照(工作/生活等),或配置
bindings按工作区目录前缀自动换文案。 - 文案池:启用
pool,设置mode为sequence或random,维护greeting/signOff数组,每轮自动换句。 - 查花费:在设置页「成本」相关参数查看;需本机已有 DSH usage 台账文件。
- 交接:让模型在回复中输出
<<<HANDOFF>>>…<<<END>>>,由插件接口落盘HANDOFF.md,新会话先读该文件再继续。 - 手改配置(可选):直接编辑
config/greet-signoff.json或通过GET/POST /api/greet-signoff读写整份配置;手改时总开关仅认布尔false为关。
适用场景与注意¶
适合:希望在 DSH Web 对话里统一助手首尾话术与视觉、需要本机只读花费汇总、或依赖 HANDOFF.md 做会话切换的开发者与个人用户。
注意:
- 插件在当前 DSH 进程权限下运行,会读写在插件目录(及可选
DSH_GREET_SIGNOFF_HOME)的配置,并读 usage 文件、写工作区HANDOFF.md;安装前请查看 GitHub 源码 与 MIT 许可证,自行评估信任边界。 - SkillHub 目录页 为社区站点,与 DeepSeek / 幻方无官方从属关系。
- 目录简介若仍描述「输入框上方六格预算导航」,与仓库 README 1.23.0 变更不符;以仓库文档为准:上下文展示已交给 DSH 官方圆环。
结尾¶
dsh-greet-signoff 把「每轮固定开场/收尾 + 可配样式」从提示词草稿里抽成设置页与 Prompt 段联动,并补上本机花费台账与 HANDOFF.md 交接,改配置下一轮即生效。进一步了解与安装: