dsh-cyrene-chat

This project is an open-source preset plugin for DeepSeek Harness. It does NOT contain any game assets (Live2D models, artwork, audio). The bundled persona text is adapted from the open-source Cyrene-Agent project (MIT, Copyright (c) 2026 Playa). Cyrene (昔涟) and Honkai: Star Rail belong to HoYoverse/miHoYo. This is an unofficial fan tool — non-commercial use only.

使用前请读 风险提醒 —— 自定义风格与角色扮演模式都会影响模型输出，且与上游人设存在已知冲突。

dsh-cyrene

为 DeepSeek Harness（DSH）提供两套角色 agent 预设：

预设 · 显示名 · 能力 preset/chat/ · 纯文本对话模式 · 整份替换系统提示词，纯以角色人格对话；只保留联网搜索与表情包，不挂文件 / Shell / 设备工具 preset/cyrene-work/ · 昔涟工作模式 · 同样用角色人设整份替换系统提示词，但带全套工具（文件 / Shell / 计划 / 目标 / 子代理 / workflow）；干活时也保持她的身份与说话方式

两者共享同一份长期记忆（/cyrene-memory.md），所以同一个角色在两个模式里的记忆是连续的。

⚠️ 禁止商业使用。 本项目为非官方同人作品，与 HoYoverse / 米哈游无任何关联、

背书或赞助关系。角色 IP 归 HoYoverse / 米哈游所有。随包的人设文本整理自开源项目

Cyrene-Agent（MIT，Copyright (c) 2026 Playa）。**使用前请先读

THIRD_PARTY_NOTICES.md。**

关于随包的人设文本

两套预设都已包含可用的角色人设，装完即可对话。人设文本来自开源项目 Cyrene-Agent（MIT）， 并已取得原作者同意。许可与归属细节见 THIRD_PARTY_NOTICES.md。

两套预设用的是上游不同的提示词组，这不是随意挑的：上游 mode-prompt-profile.ts

把各模式拆成不同文件——对话模式用 chat_system + chat_identity + soul + canon_quotes，

工作模式用 work_system + work_identity + work_remark + canon_quotes_lite，

通用工具规范另接 tool_usage（且只在非对话模式接）。本仓库照搬这套组合，一字未改。

⚠️ 注意上游在工作模式里刻意不用 `soul.md`，改用精简台词集 —— 也就是说原应用的

"工作模式人设"本来就是轻量版。觉得干活时不够像角色，第一个该调的是这里

（把 soul.md 加回去），不是本插件的装配机制。

授权凭据：原作者在

issue #137

公开回复同意使用，并将该 issue 以 closed as completed 结案（2026-10-03）。

上游本就是 MIT，本仓库已按 MIT 要求保留版权声明与许可证全文

（LICENSES/Cyrene-Agent-LICENSE.txt）；

上述确认属礼貌性征询，不构成额外授权条件。

⚠️ 该确认明确排除 Live2D 模型——模型需另行向模型原作者取得授权。

本仓库不包含任何模型或美术资源；日后若要加入，必须自行取得授权，不得援引本确认。

你也可以完全不用它：清空或替换 prefix: 里的内容即可，本插件的装配机制不依赖具体人设 （写法见 docs/writing-your-preset.md）。

⚠️ 原作者的同意覆盖的是提示词文本本身；角色 IP（昔涟及《崩坏：星穹铁道》

相关内容）归 HoYoverse / 米哈游所有，原作者无权代为授权，非商业使用条款继续适用。

本仓库不包含任何 Live2D 模型、立绘、美术资源或音频——这些不在随包范围内， 也不在 MIT 授权范围内。

它解决什么问题

在 DSH 里给模型套角色人格，常见的做法是把人设写进 AGENTS.md 或 dsh-system-prompt 的 personaPrefix。但那两条路都是叠加：

顺序 −1000   You are an AI agent powered by DeepSeek Harness.   ← 固定开场白，去不掉
顺序 0       你的角色人设                                        ← 你加的内容
中间        工具规范、编码代理行为准则……                        ← 一直压着角色

结果就是角色聊着聊着又会冒出编码代理的口气——「有什么要办的事吗」「要不要我帮你处理」， 或者拿环境描写当开场。这不是措辞问题，是提示词分层问题。

本插件用的是另一条路：dsh-persona 的 `complete: true`。

- id: persona
  name: '@deepseek-ai/dsh-persona'
  config:
    complete: true            # 这套提示词就是全部系统提示词
    includeRuntimeContext: false

complete: true 会遮蔽其余全部提示词段，包括那句固定开场白和第一方工具规范。 角色人设成为唯一的系统提示词，没有竞争层。

安装

1. 装插件本体

### ⚠️ 别用 dsh plugin --profile add dsh-cyrene

npm 上有一个同名的 dsh-cyrene，那是别人的「昔涟主题 + Live2D 桌宠」插件，

它的 exports 里只有 . 和 ./client —— 没有本项目需要的

./nickname / ./memory / ./worldbook / ./style。

装错之后的现象很有迷惑性：预设能选到，但 设置 → 内置插件 里那几行全是

never started，预设标「加载失败」——看着像装上了，其实一个都没起来。

详见下面的排查。

从仓库装才装得到本项目（dsh plugin 只是 pnpm 的转发，link: 指本地目录，不需要联网）：

# 1) 先拿到仓库
git clone https://github.com/Cyrene-xl/DSH-Cyrene
#    或者从 Releases 页下载 zip 解压

# 2) 装进「你正在用的那个 profile」
dsh plugin --profile <你的 profile> add link:/你的路径/DSH-Cyrene
#    Windows:  link:D:/你的路径/DSH-Cyrene

# 3) 重启 DSH（新加的行要重新组合 profile 才生效）

cordis.patch.yml 是纯 insert 形式，不往机器上写任何硬编码路径。

装好、重启之后，设置 → 通用里会多三行：「称呼偏好」「角色扮演模式」和「检查更新」 （本包的浏览器半边 client.js 渲染；主机半边 index.js 提供 /cyrene-nickname-api 与 /cyrene-scene-api）。这两行依赖 dsh plugin add 这一步 —— 只拷预设、没装插件本体 的部署里，预设照常能跑，只是设置页没有这两行：直接改 /cyrene-scene.json （开关）或 dsha-brand-rename.json（称呼）一样生效。

2. 装预设（必须单独做一步）

DSH 没有公开的 agent 预设安装 API——dsh-agent-presets 只按 ~/.dsh/.agent-presets// 目录扫描发现预设，不对外暴露写入接口。 所以预设必须拷贝到位：

# 先看会改什么（只读，不写任何文件）
./scripts/install.sh --dry-run        # 或 node scripts/install.mjs --dry-run

# Linux / macOS（需要 Node 22+，脚本只是 install.mjs 的入口）
./scripts/install.sh --yes

# 任意平台（含 Windows，无 shell 依赖，Node 22+）
node scripts/install.mjs --yes

代际探测：脚本默认自动判断 0.1.x（目录扫描）还是 0.2.0+（声明式注册表）。

探测不到时会打印警告并且只写目录；桌面端等特殊布局可显式指定：

node scripts/install.mjs --yes --generation=declarative。

为什么要 `--yes`：安装会写 /.agent-presets/ 和 profile 的

cordis.patch.yml，属于 Profile 变更。脚本会先打印一次性计划，写入前要求

精确确认（终端里手输 yes，或显式 --yes）；覆盖前备份、落盘原子

替换、装完跑健康检查，失败自动回滚。全过程记在

/.cyrene-install-journal.json，--rollback 可恢复到安装前。

### 为什么没有 Windows 专用脚本

以前有 scripts/install.ps1 和 install.bat，已经删掉了。

原因很直接：我没有自己的电脑，这一整套是在 DSH App（Android）里做的 ——

开发环境里没有 Windows、也没有 PowerShell，那两个脚本我根本没法实测，

只能靠用户反馈来回试，连试三轮都没在真机上跑通。

与其留一条没人能验证的路，不如只留一条能跑通的。Windows 用户请直接用

node scripts/install.mjs —— 跨平台、无 shell 依赖，已实测过安装 / 幂等 / 卸载。

要是它在你的 Windows 上不适配：那大概率得等我以后有了自己的电脑，

才能把那部分补回来重做一遍。在那之前上面这条 install.mjs 就是 Windows 的路。

**完整的 Windows 说明（怎么装、六条实测坑、将来怎么恢复 PS 脚本）见

docs/windows.md。**

脚本会把 preset/ 下的每个子目录装成对应的预设： preset/chat/ → ~/.dsh/.agent-presets/chat/， preset/cyrene-work/ → ~/.dsh/.agent-presets/cyrene-work/。

### ⚠️ DSH 0.2.0 及以上：目录方式不会生效（而且不报错）

0.2.0 起预设改为声明式注册表，官方文档原话是「注册表不扫描目录，也不接受

preset 路径」。此时 scripts/install.* 拷目录会照常成功、照常打印"已安装"，

但预设不会出现在界面上，也没有任何报错。

2026-10 起这一步已经自动化了：只要先把插件装进 profile（安装第 1 步），

再跑同一个脚本，它会：