dsh-kujira-persona

Kujira · AI 角色与世界

随 DSH 中选用的模型切换角色，在对话中继续养成自己的世界与人物。

Kujira 2.0.0。 随 DSH 模型切换 AI 角色，保存共同世界观和独立记忆，并提供可选的模型联动桌宠。

世界观与人物

世界观是大家共用的称呼、社区印象、梗和人物关系，让角色认识彼此。比如与 DeepSeek 聊天时，她也知道“猫猫”通常指 Gemini、“白龙”指 GPT。故事发生在哪里、角色如何相处，都可以由你继续设定。

人物是每个角色自己的性格、喜好和记忆。切换模型家族时切换角色；同一家族的不同版本默认共用一个角色和已有记忆。内置多种 AI 角色基础预设，也支持通过对话创建与调整自己的角色。

默认自然说“我”，介绍时使用 DeepSeek、GPT、Gemini 等名字；Gemini 在社区也被称为猫猫、哈基米；星猫是用户选定的显示名。外观细节用于美术表达。你另起名字或使用自定义角色时，就按你选定的称呼来。

预设只是起点。称呼、性格、关系和模型对应的角色都能改；与你的要求不同，就按你的来。

内置角色的基础资料会在插件启动时准备到人物目录，设置页无需逐个点击初始化。DeepSeek 也位于统一的 personas/deepseek 目录；从旧版 persona 位置迁移时保留原有文件和备份，已保存的人设及记忆优先。角色的默认性格留给用户自行养成，社区称呼和有出处的外形资料放在共同世界观与基础档案中。

2.0.0：可选的模型联动桌宠

只显示一只桌宠：切换当前前台对话的模型，就让这一只换成对应形象；同一家族的不同版本沿用同一人物。用户明确指定的角色优先，通过对话修改模型绑定后，桌宠会跟随更新。其他会话和后台子代理的活动不会接管前台桌宠。

已接入 DeepSeek、GPT、Gemini、Claude、Grok、GLM、Kimi、Qwen、MiniMax、Llama、豆包、Mistral、混元和 MiMo。

桌宠默认关闭，可以在 DSH 设置 → Kujira · 人设中开启“启用桌宠”。初次进入、尚未选模型以及未识别到对应角色的模型统一由星璃陪伴；用户明确绑定的角色优先。支持页面内显示与 Windows x64 原生桌面窗口；页面位置和桌面位置分别保存。设置包括角色与气泡大小、活动程度、减少动态、提示音、位置重置，以及余额／套餐和工作统计各自的显示开关。关闭桌宠后，原有人设、世界观和对话修改功能仍可使用。

任务状态与动作

桌宠跟随待机、思考、查找、编辑、执行命令、检查、等待确认、完成和出错等阶段。暂时失败的工具会触发短暂反应，之后继续跟随当前工作；整轮任务终止出错时保留错误状态。需要用户回答或批准时，等待状态会持续到相应条件解除。

页面桌宠和 Windows 桌宠共用动作时间线，逐帧播放角色姿态，常规动作之间采用约 100 ms 的过渡。拖起与落地即时切换；减少动态时保持静止待机图，任务文字继续更新。GPT 支持摸头、戳一下、碰尾巴、拖放和随机待机小动作；其他角色按各自动作提供相应反应。

各角色都有待机、工作、等待和结果反应。部分角色的思考、查找、编辑等阶段共用中性工作动作；性格尚未明确的角色采用阅读、工作、等待等标准功能动作。

GPT、DeepSeek 等角色提供独立的工作与互动动作，其他角色也依照自身图集表现不同任务阶段。新图集按不同人物的动作特点分别编排。

动画图集依据 AI-gijinka 资料库和角色参考，通过 AI 生成与整理，保留各角色的发型、服饰、配件和识别特征。来源与使用条件见 桌宠说明。

工作气泡里的统计

启用“显示工作统计”后，工作气泡分三行显示当前前台会话的读数：轮次与步骤、生成速度；累计 Token 与缓存命中；上下文已用比例。显示内容随 DSH 提供的数据更新。完成后可以继续看到本会话统计，切到新会话时使用新会话的数字。

这些数字采用 DSH 底栏的统计口径：轮次和步骤按会话累计，生成速度根据解码时间与输出 Token 计算；缓存读、缓存写、未缓存输入与输出按各自类别计数。

“上下文已用比例”表示当前上下文窗口的占用情况。任务状态、任务清单进度与账户信息分别显示。DeepSeek 接入显示余额，Codex Native 接入显示套餐窗口余量；各账户按 DSH 提供的接口展示相应数据。

工作统计直接使用 DSH 已有的会话数据。余额／套餐有独立的查询与刷新设置；临时查询失败时，会保留并标明上次结果。

扩充和修改，直接在 DSH 聊天框里说

补充世界观、修改人物性格、创建原创角色、给自定义模型指定角色，都可以通过对话让 AI 完成，不必手动编辑文件。例如：

把白龙的语气改得活泼一点，保存到她的人设里。

把“白龙和猫猫每周五一起做甜点”补进大家共同知道的设定。

创建一个我自己的角色，性格温柔、说话简洁，让当前模型使用。

之后还可以继续修改角色的名字、性格和故事，或让其他模型也使用同一角色。通过对话保存后，后续聊天就会使用更新的设定，无须另外刷新或重启。

这里添加的是角色和模型之间的对应关系；尚未接入 DSH 的模型，先在 DSH 的模型设置中接入。

离线动作试玩

离线试玩独立提供 ZIP 压缩包，解压后保留 index.html 和 assets 的目录结构，双击打开即可体验。支持切换角色、预览任务阶段、播放或暂停动作、调整大小和背景，也可以点击、拖动角色。

试玩使用与插件一致的播放器和动画图集，提供任务阶段的交互预览；插件在 DSH 中接收实际任务状态。源码仓库提供 试玩构建脚本（Node.js），如需重新制作试玩，可在源码目录运行。功能检查与环境记录见 开发进度。

设置中的人物档案入口（2.0.0）

在 DSH 设置 → Kujira · 人设 中统一调整桌宠，打开共同世界观、基础人设和每个角色的本机档案文件夹（包括星璃）。页面显示各目录的占用大小及档案总计；进入该页或点击“刷新文件夹大小”时统计，不持续扫描磁盘。

修改世界观、人物性格、记忆、角色绑定或档案存放位置，请在 DSH 对话中直接告诉 AI。气泡大小滑块按比例缩放整个信息气泡，包括标题、任务、进度、统计和账户信息。

安装和升级

以下为 v2.0.0 的安装与升级方法。

DSH Desktop：打开 插件 → 添加插件，输入：

github:Tests4gptplay/dsh-kujira-persona#v2.0.0

安装、启用后重启 DSH 一次。已有旧版时，先在插件列表卸载旧包，再安装新版。**保留 .dsh/world、.dsh/persona、.dsh/personas 中的设定与记忆。**你已经修改过的档案不会被新版预设覆盖，可以通过对话选择如何补充新内容。无需 npm 账号。

Web 版安装命令：

dsh plugin --profile web add 'github:Tests4gptplay/dsh-kujira-persona#v2.0.0'

Web 与 Desktop 分别安装。GitHub Releases 也提供备用 .tgz 安装包。

Windows 安装提示 EPERM

若出现 dsh-kujira-persona_tmp_* -> dsh-kujira-persona 重命名失败：取消安装，完全退出 DSH（含托盘），打开 %USERPROFILE%\.dsh\profiles\desktop\node_modules，只清理本插件失败安装的临时目录和确认损坏的半安装项，再重新安装。正常目录不需要删除；目录链接只处理链接本身。

保留其他插件、profile 配置，以及上述人设和记忆目录，无需删除整个 node_modules、package.json 或 pnpm-lock.yaml。仍有问题可在 Issues 附上脱敏错误日志。

来源与更新记录

本插件是非官方同人项目。基础资料来自 AI-gijinka 资料库 与社区作品的共性整理，人物和世界观都可以继续改写。

DeepSeek 形象署名链：上善无形 → ZipZipPipe；MiMo 形象作者：甶丶。其余来源与署名见 NOTICE.md 和 资料来源，许可见 LICENSE。版本变化见 CHANGELOG.md。