README
dsh-cosplay · 让模型进入角色
English: A DeepSeek Harness plugin that puts the model in character — either by injecting a persona card into the system prompt, or by rewriting your message before the model ever sees it.
English: A DeepSeek Harness plugin that puts the model in character — either by injecting a persona card into the system prompt, or by rewriting your message before the model ever sees it.
给 DSH 里的模型一张角色卡,让它以指定的身份、语气与提示词风格作答。卡是你自己写的,插件负责把它送到模型眼前。
两种卡,解决两件不同的事:
| 你想干的事 | 用哪种卡 | 你看到的效果 |
|---|---|---|
| 让模型以某个身份说话(猫娘 / 温柔学姐 / 中二法师) | 人设卡 | 你正常说话,回复带上角色口吻 |
| 让模型收到另一种写法的需求(暴躁甲方 / 需求翻译机) | 改写卡 | 你发一句话,模型收到的是按你的规则重写后的 prompt |
聊天区顶部的「角色」页签 —— 卡片网格,点一张进二级详情,在本会话使用。
快速开始
一、装
前提:装完要重挂插件(宿主半边);只改浏览器半边时刷新页面即可。
# 方式一:本地链接(开发用)
npm install && npm run build
dsh plugin --profile web add "link:D:\developing\DSH-plugin\dsh-cosplay"
# 方式二:GitHub(lib/ 已入库,免编译)
dsh plugin --profile web add github:<you>/dsh-cosplay
DSH Desktop 用户:
desktopprofile 由 Electron 独占管理,命令行会被拒绝, 请在设置 → 插件界面填仓库地址(或本地路径)。
没网时:node scripts/link-sdk.mjs 把 node_modules/@deepseek-ai/* 指向本机 SDK 镜像,
npx tsc --noEmit 与 npm run build 照样能跑(只需要 typescript 与 tsdown 在本地)。
二、用:新建会话的第一屏就能选角
输入框左下角(+ / 权限 / 模式 那一排)有一个 🎭 无角色 胶囊 —— 点它弹出卡片列表,选一张,然后直接发第一句话。
🎭 无角色 chip 的弹出面板 —— 列表右侧标出每张卡走「人设」还是「改写」链路。
第二轮开始顶部才会出现「对话 / 轨迹 / 角色」页签,那里是卡片管理面(网格 / 二级详情 / 编辑 / 立绘 / 导入导出)。
为什么入口在输入框而不是页签:DSH 的空白会话不渲染页签条 (
dsh-client-ui-conversation:showTabs = !hideChrome && …,空白态hideChrome = blank; 视图区在 blank 阶段直接return null)。所以"打开角色页签再选角"对第一轮根本不成立 —— chip 就是为这件事存在的:它随会话视图挂载,在你敲字之前就把"本会话用哪张卡"写进宿主。
-
新建会话 → 点 chip → 选一张卡 → 发第一句话(实测首轮就带角色:回复以「喵~」结尾)
第一轮就生效 —— chip 已显示「赛博猫娘」,回复以角色口吻作答。 -
正常说话:
- 人设卡(如「赛博猫娘」):回复以角色口吻作答;
- 改写卡(如「硬邦邦」):你发的「画一张秦始皇骑北极熊」在日志里就变成了那篇暴躁甲方 prompt;
-
想停:chip 里的「本会话停用」/详情页「本会话停用」/命令
/cosplay off(零 token); -
想每个新会话都自动上角色:什么都不用配 —— 你上次选过的那张卡会被新会话自动继承 (
lastCardId);想固定成另一张就配 设置 → 角色扮演 → 默认角色。 换卡时会提示"会话里换过卡、旧口吻还在历史里",想从干净上下文开始角色就开个新会话。
命令是界面出问题时的逃生阀:
| 命令 | 作用 |
|---|---|
/cosplay |
状态(总开关 / 策略 / 本会话角色 / 库统计 / 最近改写) |
/cosplay list [关键词] |
卡片清单 |
/cosplay on | off |
本会话开 / 关 |
/cosplay none |
本会话取消角色 |
/cosplay <id | 名字> |
本会话换上这张卡 |
目录
| 想了解 | 看这里 |
|---|---|
| 它到底怎么实现的 | 两条链路的机制 |
| 一张卡有哪些字段 | 角色卡的数据结构 |
| 卡片存在磁盘哪 | 卡片库在哪 |
| 有哪些可配的开关 | 配置 |
| 出问题了怎么看 | 诊断 |
| 凭什么说"实测有效" | 人设 × 上下文 · 验证记录 |
| 怎么核对模型真收到的字 | 核对工具 |
| 有什么坑 | 已知限制与代价 |
| 想改代码 | 开发 · 文件地图 · 座位表 |
两条链路的机制(都已实测,不是设计稿)
人设注入:ctx.systemPrompt.section({ name, order: 部署人设+1, interpolate: false, text })。
实测证据(真实运行环境):host:prompt-section section=dsh-cosplay:persona order=1 agentId=session-… typeof=string
—— 装配上下文里拿得到会话 id,所以"每个会话各自一张卡"成立。
interpolate: false 是必须的:卡片正文是你写的,出现 {{…}} 时默认的严格插值会抛错并让整次装配失败。
提示词改写:agent/pre-step 是官方唯一能在模型看到之前替换用户消息的通道,而替换后的消息会被
dsh-agent-loop 真实地 durable 写成 user/message(lib/index.js:1061)。实测证据:
host:pre-step-plan 按「硬邦邦」改写:原文 10 字(mode=rewrite strategy=card)
host:rewrite-ok 8327ms · deepseek-official/deepseek-flash · 10 字 → 571 字
host:durable-user-message seq=10 正文=571字 预览:老哥们,我时间金钱不多了,agent team 这次算了…
也就是说:「对话」里那条用户消息本身就是改写后的 prompt,模型收到的与日志逐字一致 —— 不需要另做一层"实际发送了什么"的黑箱展示。
改写调用必须带上下文(否则会把任务主体换掉)
改写调用是无状态的:它只拿到"这一轮原文"和"卡片规则"。于是(真实事故,
session-cf7b1365,2026-10-02 02:35):
用户原话(agent/inbox/spliced) |
兄弟 太夯了 ,看的我硬邦邦!!! 想让更多人硬邦邦,把这个提交到我的仓库吧!!直接新创一个! |
上一轮真实交付物(assistant/message) |
搞完了。## 东西在哪 - 页面本体:miku/index.html |
| 当时的改写结果 | 任务:把我这套硬邦邦的肌肉集团提示词转换器直接新创一个 GitHub 仓库… |
"这个"没有指代对象 —— 而改写调用上下文里唯一存在的名词就是卡片规则本身("硬邦邦提示词转换专家"), 模型于是合理地把它填了进去,主模型随后真的去建了一个错的仓库。
修法(src/context.ts):改写时从官方 surface(agent.session.surface.nodes → session.eventAt,
与 dsh-compaction-basic 取摘要输入的同一组 API)取最近 ≤6 条 / ≤2400 字的"人话 + 助手话"
(排除 skills / runtime-context / tool-jobs / agent-message 等框架注入与子代理播报),
组装成一条分区明确的 user 消息:【最近对话(只读)】… 【本轮要改写的原始需求(只改这一段)】原文。
另外加一条指代守卫:原文含"这个 / 它 / 上一轮"这类指代、又拿不到上下文时跳过改写、原样放行 ——
无法解析指代时改写必然瞎猜主体,保留原文至少不会把任务改错。
轨迹里会留下 host:rewrite-context 带上下文 N 条 / M 字(原文 … 字,组装后 … 字),
没有上下文而跳过时留 host:rewrite-skip-unresolved(真实数值见下节「验证记录」)。
角色卡的数据结构
一张卡(CosplayCard)的字段与上限:
| 字段 | 说明 |
|---|---|
id |
[a-z0-9][a-z0-9-]{0,39},进 URL(天然防路径穿越) |
name / title / description |
显示名(≤24 字)/ 称号(≤40)/ 一句话简介(≤120) |
tags |
≤8 个,每个 ≤12 字 |
mode |
system(人设注入)/ rewrite(改写输入)/ both |
persona |
注入系统提示的正文(≤20000 字,实际注入受 personaMaxChars 约束) |
tailLine |
可选:尾部回声(≤200 字,用人设第一人称写)。它会出现在系统提示词最末尾(order=10201,在所有官方段之后),用来在近因位置重申角色的声音;没写就自动逐字取 persona 的第一句(跳过 #/【 标题行),都没有就不加。默认不启用(见 personaEcho 配置) |
rewrite.rules |
改写调用的 system prompt 主体(≤20000 字) |
rewrite.examples[] |
few-shot 示例 ≤4 组(强烈建议写,硬邦邦的效果主要靠它锚定) |
art |
立绘引用 { artId, mime, bytes, sha256, width?, height? },可选 |
cover |
无立绘时的占位 { emoji, hue } |
单文件多卡:dsh-cosplay-pack
导出/导入/预设共用同一个格式,所以"别人发来的包"和"插件自带的预设"是同一种东西:
{
"format": "dsh-cosplay-pack",
"version": 1,
"exportedAt": 1759320000000,
"cards": [ { "id": "hardcore", "name": "硬邦邦", "mode": "rewrite", "rewrite": { "rules": "…", "examples": [ … ] } } ],
"art": { "a-0123456789abcdef": { "mime": "image/png", "base64": "iVBORw0…", "sha256": "…" } }
}
导入规则(有测试盯着):
更多「纯属好玩」插件
dsh-pet
作者 pc2005-cloud
DSH 桌面宠物:一行命令装好即用的透明动画小桌宠,支持多开、大小位置随心配置;还内置 DIY 素材链,能用 AI 视频自造专属宠物
dsh-tavern
作者 flizzywine
基于DSH的Agent酒馆。类酒馆文字游戏Agent。兼容SillyTavern生态,人物卡直接导入就能玩。更快、更稳、更鲜活。所有模型都能用。手机也能玩。
dsh-dafeiyu
作者 qcytsn
DeepSeek Harness 的桌面原生大飞鱼陪伴插件,实时展示智能体状态,Windows 上置顶显示。
dsh-meme
作者 yyh-001
DeepSeek Harness 表情包插件:输入框一键发图、文字 token 斗图、情绪主动发图、AI 自动学图,图库市场一键安装。 · Meme/sticker plugin for DeepSeek Harness: one-click picker in the composer, text-token memes, mood-driven sending, AI learns your images, marketplace packs.
