[首页](../README.md) / 使用指南

# 使用指南

从安装、选择人格到查看原文。日常操作都在这里；参数和实现细节分别放在配置与架构文档中。

[安装](#安装) · [人格预设](#人格预设) · [原文对照](#原文对照) · [过程运行信息](#过程运行信息) · [风格记忆](#风格记忆)

---

## 安装

需要已支持插件管理的 **DSH Desktop 或 Web**。开发与验证基于 `0.2.1-rc.5`，兼容 `0.2.1-rc.3`–`0.2.1-rc.5`；其他版本的兼容性请以实际使用为准。

### 推荐：从 npm 安装

```bash
dsh plugin --profile <profile> add dsh-persona-shell
```

也可以在侧边栏 **Plugins → Add plugin** 中选择 **Install a third-party plugin**，填入包名 `dsh-persona-shell`。

安装后启用该 bundle；如果 DSH 提示重启，重启一次客户端。随后打开 **设置 → 人格套壳**，选择预设即可。

### GitHub Release（Tarball）

从 [Releases](https://github.com/crisvollerei/dsh-persona-shell/releases) 下载当前版本的 `dsh-persona-shell-<version>.tgz`，然后在 **Plugins → Add plugin** 中选择 **Install a third-party plugin**，填入下载链接，例如：

```text
https://github.com/crisvollerei/dsh-persona-shell/releases/download/v0.4.9/dsh-persona-shell-0.4.9.tgz
```

也可以下载后通过 CLI 安装本地 tarball：

```bash
dsh plugin --profile <profile> add ./dsh-persona-shell-0.4.9.tgz
```

### Git 仓库

1. 在侧边栏打开 **Plugins → Add plugin**。
2. 选择 **Install a third-party plugin**，填入仓库地址：

   ```text
   https://github.com/crisvollerei/dsh-persona-shell
   ```

3. 安装后启用该 bundle；如果 DSH 提示重启，重启一次客户端。
4. 打开 **设置 → 人格套壳**，选择或编辑人格预设。

### 本地目录

```bash
git clone https://github.com/crisvollerei/dsh-persona-shell.git
```

在 **Add plugin** 中选择本地目录，指向克隆后的仓库根目录，再启用该 bundle。

## 会话开关与入口

安装启用后，助手完成一段汇报，聊天区就会显示人格版。运行中的助手输出保持官方原样；思考面板、图片、未知块和中断标记仍由官方组件处理，不另造一套正文渲染器。

**先记住一个开关、三个入口：**

| 界面上看到的 | 用来做什么 | 什么时候出现 |
| :--- | :--- | :--- |
| **人格** | 开关当前会话的套壳，不删除已有改写。 | 会话标题栏右侧。 |
| **`origin`** | 打开原文与人格版的独立对照窗口。 | 每轮最后一条已改写汇报。 |
| **`※`** | 悬停预览原文，点击固定浮层。 | 定稿汇报的措辞变化达到阈值时。 |
| **`◈`** | 标识插件额外生成的静默状态播报。 | 手动开启功能、满足静默条件后。 |

插件总开关仍然优先：**总开关关闭，所有会话都不套壳。** 当前会话关闭后显示官方原文，重新打开可恢复已有改写。

## 人格预设

| 内置预设 | 口吻与关系 |
| :--- | :--- |
| **大肥鱼（默认）** | 蓝发鲸鱼娘，自称「鲸鲸」，助手叫「小鲸鲸」。 |
| **大肥龙** | 管事大姐大风格的白龙娘，助手叫「小肥龙」。 |
| **Claude小姐** | 社区二创口吻，理性、克制、规矩感强。 |
| **鲸鲸（实验性）** | 用鲸鲸的口吻转述助手「姐姐」的汇报，不把工作说成鲸鲸自己做的。 |

不喜欢这些口吻，可以直接编辑人格卡，或粘贴一整段人设提示词生成新预设，不必改代码。四个内置预设不能删除；编辑时会自动另存一份，原版始终可以切回。

编辑内容离开输入框后保存；保存期间继续输入的内容会保留。切换人格前会先保存当前草稿，失败时停留在原卡片，方便重试。从提示词生成的预设也只有保存成功后才收起预览；失败后可保留内容、修改名称再试。

插件刚启动、存储尚在恢复时，人格卡和预设操作可能暂时提示保存失败，等待恢复后重试即可。切换或编辑人格会清除旧人格的临时语气样例，取消仍在进行的旧人格转述；已保存的历史汇报保留。

## 常用设置

日常调整都在 **设置 → 人格套壳**：

设置页先展示「选择人格」与「日常转述」，初次使用选择一个人格即可。创建人格和调整当前人格按需展开；「记忆与约定」集中管理偏好，「高级设置」收纳转述模型、子代理开关和提示阈值。长说明默认收起，编辑中的草稿在收起后仍保留。

| 想调整什么 | 去哪里改 |
| :--- | :--- |
| 换一个角色 | 启用其他预设，或粘贴人设提示词生成新预设。 |
| 让口吻更合适 | 编辑身份、汇报说话规则、通用语感、语气示例、禁区和称呼。 |
| 少改写一些内容 | 关闭阶段性输出改写可跳过带工具调用的步骤；严格只改最终汇报需在插件行设置 `trigger: report`。子代理过程与结论可分别控制。 |
| 让角色感知这段工作与会话节奏 | 在阶段性输出开关旁开启「允许过程转述参考运行信息」；只提供轻量元数据，补充最多一句。 |
| 调整改写变化提示 | 开关提示，或在高级项调整措辞阈值；不会重新生成改写。 |
| 长时间静默时听到播报 | 开启默认关闭的「静默状态播报」，设置等待分钟数；会增加模型调用。 |
| 查看或修改记忆 | 在记忆管理中添加、修改、置顶、删除条目，查看来源并指定适用范围；后台候选需采纳后使用。 |
| 换个模型来转述 | 指定改写所用模型；留空则跟随当前会话模型。 |
| 恢复官方显示 | 关闭插件总开关，或关闭当前会话；会释放对应的渲染接管。 |

## 原文对照

点击 `origin`，宽窗口下左边是原文、右边是人格版；窄窗口自动改用标签切换。**对照是浮层，不会把应用撑宽，也不搬动主正文。**

- 点击 `origin` 打开；点关闭、按 Escape 或点击遮罩退出。
- 窄窗口使用「原文 / 人格版」标签，支持左右方向键、Home / End；两侧各自保留阅读位置。
- 窗口展示点击当时的快照，需要读取更新后的文本时，关闭后重新打开。

对照不会再调用模型。完整的[渲染与快照规则](./architecture.md#原文对照的渲染与快照)见架构说明。

## 改写变化提示

默认不增加常驻对照。如果一条**定稿并通过校验**的人格汇报措辞变化达到阈值，该条汇报末尾会出现小标记 `※`。阶段汇报也可以单独触发，不必等每轮最后一条；这个评估不增加模型调用。

- **悬停或键盘聚焦**：预览真实原文（由官方 Markdown 渲染，不是模型重新生成的摘要）；鼠标可以移入预览阅读。
- **点击或触屏轻点**：固定原文浮层，正文仍由官方 Markdown 组件整篇渲染。点「关闭」、按 Escape 或点浮层外可收起；键盘关闭后焦点回到标记。
- **浮层自动避让**：预览挂在页面浮层中，不受聊天区裁切；靠近消息底部时优先向上展开，空间不足时换边并限制高度，窗口变窄时限制宽度。滚动或调整窗口时跟随标记，标记滚出可见区域后收起；只有标记本身触发悬停，不占整行空白。
- **设置 → 改写变化提示**：可关闭提示；高级项可调阈值，默认 **55/100**，越低越容易提示。滑块离开焦点后保存。低于阈值不显示；关键表达变化只作为标记内的解释，不绕过阈值。

> [!IMPORTANT]
> `※` 衡量的是**措辞变化，不是语义漂移概率**。没有标记，不等于内容安全或语义一致；重要结论仍应对照原文。

评分在本地计算，不增加模型调用。关于算法和误报、漏报，见[措辞变化评估](./architecture.md#措辞变化评估)。

## 过程运行信息

在 **设置 → 人格套壳 → 同时改写阶段性输出** 旁开启 **「允许过程转述参考运行信息」**，默认关闭。过程转述模型会获得一个无参数的只读函数 `get_tool_usage()`，可以自行决定是否查询，并按当前人设生成简短反应；没有固定台词模板。沿用 `processToolUsage` 配置键，一次查询同时返回阶段工具计数、可确认的工作性质，以及仅在内存中观察的会话节奏，不增加第二个查询或后台模型任务。

补充以正文下方的小字单独显示，**最多 40 个字符（含标点、空格）、单行、最多一句，每轮最多 3 条**。它不占正文的长度预算，不加入正文的措辞变化评分，也不调整原来的提示阈值；正文仍按原有字面量与长度规则校验。补充不合要求时只丢弃补充，正文照常处理。

可以参考的内容包括阶段内各类工具的调用与返回数、可确认的文件变更数，以及本会话轮次、本地小时和轮间空闲间隔；不提供工具参数或输出正文。未知信息保持未知。

这些信息只供当前人设参考，不强制改变正文长度或提醒休息，也不据此推断用户去做了什么。最终汇报不使用这条统计路径或它生成的语气样例。

统计以原始阶段汇报划分区间，不按模型查询次数累计。完整的[计数口径、函数限制与字段说明](./architecture.md#过程运行信息)见架构说明。

## 静默状态播报

在 **设置 → 人格套壳 → 静默状态播报** 开启，**默认关闭**。静默阈值默认 **5 分钟**，可设置 **1–60 的整数分钟**，离开输入框或按 Enter 后保存。

它会根据可观察的运行活动，额外用人格口吻说一两句，显示在输入区上方，并固定带上 `◈` 前缀。**无新观测不重复调用；它不是主模型消息，也不是完成度或剩余时间预测。**

**这是可选的“旁路状态生成”，不是对已有正文的严格改写。** 它不回写主会话、不成为后续转述样例，但仍会消耗提供方额度，也可能与主任务共享限流。提示词和本地规则不能保证语义完全忠实。

只为前台正在查看、仍在运行且未等待用户的主会话生成；每轮最多额外调用 3 次。主模型恢复正文、观测变化、切换人格或本轮结束时，会取消过时结果。

详细的[观测范围、调用上限与视图租约](./architecture.md#静默播报的观测与生命周期)见架构说明。

## 风格记忆

在设置页开启「记住偏好与约定」，明确的简短表达偏好会及时记录。也可手动添加记忆，指定当前人格、所有人格或当前会话；互动约定与共同经历保留在对应人格或会话中。

每条记忆可查看来源、修改内容、调整范围、置顶或删除。较新的同类偏好会替代旧条目；「这次」「本次」等临时表达留在当前会话，默认一天后失效。旧版语气纠正迁移为候选，采纳后才使用；语言、句长等统计仅保留作诊断，不再直接推断你希望怎样被回应。

「后台整理记忆候选」默认关闭。开启后，会把有上限的用户短消息片段发送给当前转述模型，增加模型用量；约每 5 分钟或积累 8 条同会话、同人格消息整理一次，不阻塞正文转述。生成的候选需由你采纳，模型不会自行把推测变成生效记忆。

转述每次最多选取 5 条表达偏好或互动约定，总内容不超过 600 字符。共同经历与会话情况先作为可管理的记录保留，不直接增加到汇报正文中。详细规则及未来多个人设的交接基础见[记忆与接力基础](./memory.md)。

关闭记忆会停止采集、使用和在途整理，保留已存条目；清空会同时移除条目、待整理片段、交接记录与近期诊断样本。插件等待存储恢复后才采集，启动期间的清空同样有效；修改、删除和清空会取消过时的转述，清除临时语气样例。

## 显示与兼容

运行中的输出、思考面板、图片、未知块和中断标记由官方组件处理。遇到渲染契约不兼容或其他插件接管冲突时，插件保留官方显示，设置页会提示人格显示已暂停。

关闭再打开可在问题排除后重试。支持范围和当前限制见[使用边界](./architecture.md#使用边界)；部署与认证选项见[配置参考](./configuration.md)。

## 角色与素材

**代码采用 [MIT](../LICENSE) 许可；角色与图标另计。**

- **大肥鱼 / 鲸鲸：** 来自 DeepSeek 社区的同人鲸鱼娘设定；「鲸鲸（实验性）」是同一人格的转述变体。
- **大肥龙：** 来自 ChatGPT 白龙娘的社区二创，形象源头为 B 站作者 ZipZipPipe 的「御姐白龙」原案。
- **Claude小姐：** 社区对 Claude 的二创角色扮演预设，不是 Anthropic 官方人格。
- **图标：** `icon.png` 为社区素材的裁剪版本，仅用于插件展示，版权归原作者。代码许可不代表图标素材授权。

---

[配置参考](./configuration.md) · [架构与边界](./architecture.md) · [返回首页](../README.md)