ディレクトリに戻る

dsh-cosplay

キュレーションリスト掲載メンテナンス: 活発

liceses/dsh-cosplay

DSH向けのロールプレイプラグインです。キャラクターカード、システムプロンプト注入、ユーザープロンプト書き換え、共有可能な単一ファイルカード、元UIを再現したタブと初回選択チップを提供します。

GitHub で見る
$ dsh plugin add dsh-cosplay

インストール方法

dsh には中央のインストールコマンドはありません。このプラグインのエントリ(README に記載)をプロファイルまたはパッチ設定に追加し、再起動します。

インストールの仕組み

7

スター

1

フォーク

TypeScript

言語

2026-10-02

作成日

2026-10-10

最終プッシュ

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.

DSH Plugin DSH version Platform

给 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 用户:desktop profile 由 Electron 独占管理,命令行会被拒绝, 请在设置 → 插件界面填仓库地址(或本地路径)。

没网时:node scripts/link-sdk.mjs 把 node_modules/@deepseek-ai/* 指向本机 SDK 镜像, npx tsc --noEmit 与 npm run build 照样能跑(只需要 typescript 与 tsdown 在本地)。

二、用:新建会话的第一屏就能选角

输入框左下角(+ / 权限 / 模式 那一排)有一个 🎭 无角色 胶囊 —— 点它弹出卡片列表,选一张,然后直接发第一句话。

输入框 chip:首轮选角 🎭 无角色 chip 的弹出面板 —— 列表右侧标出每张卡走「人设」还是「改写」链路。

第二轮开始顶部才会出现「对话 / 轨迹 / 角色」页签,那里是卡片管理面(网格 / 二级详情 / 编辑 / 立绘 / 导入导出)。

为什么入口在输入框而不是页签:DSH 的空白会话不渲染页签条 (dsh-client-ui-conversation:showTabs = !hideChrome && …,空白态 hideChrome = blank; 视图区在 blank 阶段直接 return null)。所以"打开角色页签再选角"对第一轮根本不成立 —— chip 就是为这件事存在的:它随会话视图挂载,在你敲字之前就把"本会话用哪张卡"写进宿主。

  1. 新建会话 → 点 chip → 选一张卡 → 发第一句话(实测首轮就带角色:回复以「喵~」结尾)

    首轮就带角色 第一轮就生效 —— chip 已显示「赛博猫娘」,回复以角色口吻作答。

  2. 正常说话:

    • 人设卡(如「赛博猫娘」):回复以角色口吻作答;
    • 改写卡(如「硬邦邦」):你发的「画一张秦始皇骑北极熊」在日志里就变成了那篇暴躁甲方 prompt;
  3. 想停:chip 里的「本会话停用」/详情页「本会话停用」/命令 /cosplay off(零 token);

  4. 想每个新会话都自动上角色:什么都不用配 —— 你上次选过的那张卡会被新会话自动继承 (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": "…" } }
}

导入规则(有测试盯着):

GitHub で README 全文を読む →

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。