dsh-waifu-agents 0.2.4 → 0.3.0

package/README.md

@@ -2,449 +2,207 @@
 
 ![dsh-waifu-agents](icon.png)
 
-**Waifu Agents** 是一款面向 **DSH** 的「人设 + 多角色同场」插件：既能把 **Markdown 人设**注册成 Agent Preset、在会话中途 **动态切换** 单个角色，也能把**一组人设**放进同一场对话里同场开口（团队模式）。两种形态共用同一份人设文件：**单人**是一位角色回答你，**团队**是一组角色在同一个场景里互相接话——**都由同一个模型一次写完全场**，不是多个 Agent 分工协作（写得特别长时会自动续写，但那仍是同一场、同一个模型接着写，不是分工）。公共提示词、分组排序、搜索、隐藏、默认人设、面板内自升级一应俱全，让你灵活地定制和管理 AI 的角色、性格与回复风格。
+给 DSH 装上一批**用 Markdown 写的角色**：会话开到一半能换人，也能让一组角色在同一场对话里一起说话。
 
-## 它能做什么
+模式默认全局一种，单个会话可以另外单独设一种——所以在都要干活的环境里，你可以把某一场设成只陪聊。
 
-| 能力                     | 一句话                                                                                                  |
-| ------------------------ | ------------------------------------------------------------------------------------------------------- |
-| **轮次级换人**           | 会话开到一半，`/waifu-change 名字` 就**从下一轮**开始由她回答——不用新开会话，不用重启                   |
-| **两层人设，互不干扰**   | **会话级**：这一个会话用谁；**全局默认**：以后新建的会话用谁                                            |
-| **面板就是全部**         | 新建 / 编辑 / 改名 / 分组 / 排序 / 搜正文 / 批量隐藏 / 导入导出，一个标签页里做完                       |
-| **公共条款只写一次**     | 共用框架放进 `_common.md`，每篇只写她自己那段；改一次，所有人一起变                                     |
-| **顺序永远对**           | 自定义人设一定排在四个内置模式（standard / ptc / minimal / cordis）**下面**，团队预设再排在**所有人设**后面；各自内部顺序可拖拽 |
-| **面板内自升级**         | 面板里检查版本 → 确认 → **进度窗**告诉你 pnpm 在干什么 → 装完明确说「重启 DSH 生效」                    |
-| **改完当场生效**         | 换默认立刻反映到新任务页，连屏幕上那个还没开口的空会话也一起换                                          |
-| **多人同场（团队模式）** | `/waifu-team <队名>` 把这场会话交给一组人设，**一次生成、全员轮流开口**——她们接话、反驳、赞同，你就在场。**不接工具**；带**剧情记忆**——记得这个会话之前几轮聊了什么（默认开，可关，见第六节），定位是同场演出而非执行任务 |
-
-## 四条常用命令
-
-会话已经开着、想换人 / 换队的时候用：
-
-| 命令             | 作用                                                                                                                    |
-| ---------------- | ----------------------------------------------------------------------------------------------------------------------- |
-| `/waifu-change`  | **不带参数**：弹出选择器（可搜索、按分组、当前那位打勾）。**带名字**：`/waifu-change 大肥鱼` 直接切；名字可以只打前几个字，前提是对得上唯一一位 |
-| `/waifu-current` | 一句话告诉你这个会话现在是谁在回答                                                                                      |
-| `/waifu-reset`   | 清掉本会话的人设/团队覆盖，回到「换人/换队之前这场会话在跑的那支/那位」（不是最后切到的，也不一定是全局默认）；**团队会话用它退出当前队** |
-| `/waifu-team`    | **不带参数**：看当前是单人还是某队、列出可选队伍。**带队名**：`/waifu-team <队名>` 把这场会话交给那个队，全员同场开口   |
-
-> **「轮次级」是什么意思**：换人 / 换队**从下一轮开始生效**，你正在打的那一句不动，已经发出去的回答也不会重写。下一轮请求会带上新人设（或新队伍），并附一句运行时身份确认，让模型彻底放下上一位
-
-另有一个 `/persona <json>`：面板背后的内部接口（列目录、增删改、导入导出都走它），日常不用碰——面板上每个按钮最终都落到它上面，字段随版本在变，不要拿它写外部脚本。
-
-## 三分钟上手
-
-|     | 做什么                                                                                      |
-| --- | ------------------------------------------------------------------------------------------- |
-| 1   | **装并启用**：设置 → 插件 → 添加插件 → 输入 `dsh-waifu-agents` → 在卡片上点「**立即启用**」 |
-| 2   | **开聊**：开一个**新任务**，在还没发消息的那一屏点 preset 名字 → 选她                       |
-| 3   | **让她当新会话的默认**：打开插件面板，动她那一行右边的开关                                  |
+角色文件放在你自己电脑上，卸载插件也不会删。
 
 ## 目录
 
-- [一、安装与启用](#一安装与启用)
-- [二、人设从哪来：目录、文件与公共骨架](#二人设从哪来目录文件与公共骨架)
-- [三、面板：人设、团队与设置](#三面板人设团队与设置)
-- [四、日常操作](#四日常操作)
-- [五、换人与换队](#五换人与换队)
-- [六、多人同场：团队会话（Team Mode）](#六多人同场团队会话team-mode)
-- [七、什么时候生效](#七什么时候生效)
-- [八、更新插件](#八更新插件)
-- [九、常见问题](#九常见问题)
+- [三十秒上手](#三十秒上手)
+- [五条命令](#五条命令)
+- [人设文件](#人设文件)
+- [面板](#面板)
+- [聊天模式与工作模式](#聊天模式与工作模式)
+- [团队会话](#团队会话)
+- [记忆](#记忆)
+- [省不省 token](#省不省-token)
+- [什么时候生效](#什么时候生效)
+- [常见问题](#常见问题)
+- [更新插件](#更新插件)
 
----
+## 三十秒上手
 
-## 一、安装与启用
+|   | 做什么                                                            |
+| - | -------------------------------------------------------------- |
+| 1 | 设置 → 插件 → 添加插件，输入 `dsh-waifu-agents`，装完在卡片上点「**启用**」（装和启用是两件事） |
+| 2 | 开一个**新任务**，在还没发消息的那一屏点预设名 → 选她；聊到一半想换人，发 `/waifu-change 名字`    |
+| 3 | 想让她成为**以后新会话**的默认：打开插件面板，打开她那一行右边的开关                           |
 
-设置 → 插件 → **添加插件**，输入包名：
+新任务页找不到预设选择器：设置 → 通用 → 打开「显示代码工作视图」。
 
-```
-dsh-waifu-agents
-```
-
-想锁定版本就写精确版本号（升级时**必须**这么写，见第八节）：
+## 五条命令
 
-```
-dsh-waifu-agents@0.2.4
-```
+| 命令 / 用法                 | 作用                                                                                |
+| ----------------------- | --------------------------------------------------------------------------------- |
+| `/waifu-change 名字`      | 直接换成她；不打名字就弹选择器（名字打前几个字、能唯一对上就行）                                                  |
+| `/waifu-current`        | 这一场现在谁在回答、是什么模式                                                                   |
+| `/waifu-reset`          | 撤销这一场的换人 / 换队，回到**这个会话开始时选的那位**；团队会话用它退队。`/waifu-reset global` 搬去全局默认             |
+| `/waifu-team 队名`        | 把这一场交给那个队；不打队名则看当前是单人还是某队                                                         |
+| `/waifu-mode here chat` | 不带参数看模式；`chat` / `work` 改全局；`here chat` / `here work` 只改这一场；`here inherit` 改回跟随全局 |
 
-装完**要在卡片上点「启用」**，否则一个人设都不会出现——**安装和启用是两件事**。
+换人、换队**从下一轮开始**，你正在打的这句不受影响；换模式当场生效。
 
-## 二、人设从哪来：目录、文件与公共骨架
+## 人设文件
 
-### 人设文件
+放在人设目录（默认 `~/.dsh/personas`）里的一个 `.md`：
 
 ```markdown
 ---
 name: 显示名
-order: 20
 description: 一句话简介
 group: 组名
-template: _common.md
 ---
 
-正文：这个人**独有**的那部分。
+正文：这个人独有的那部分。
 ```
 
-- 开头这几行**都可以省**；第一个 `---` 之后的一切都是正文。
-- **保留名**：`README.md`、`_template.json`、`_common.md`——扫描时跳过，也占不到这些 id。
-- **`template: _common.md`**：正文插进骨架里 `[[body]]` 的位置，骨架里的 `[[name]]` 换成显示名。**不写这行就整篇注入**（老文件原样可用）。
-- `group:` 只影响面板视图，不影响注册。`order` 决定顺序。
-- **`order` 是插件内部的局部序号，注册时会整体加上 10000**：平台把四个内置模式（standard 1 / ptc 2 / minimal 3 / cordis 4）和人设放在**同一个**排序键上，直接把你写的 1、2、3 交出去就会和内置互相穿插。加偏移之后，无论你写多小，自定义人设一定排在内置四个**下面**。文件里存的一直是你自己那个号，拖拽排序也只改这一行。
-- 通过面板保存 / 导入会**规范化文件**：只保留 `name`、`order`、`description`、`group`、`template` 五行（空的不写），正文去掉首尾空白，换行统一 LF。想留别的东西请放进正文。
-
-### 公共骨架（`_common.md`）
-
-放在同一个人设目录里：
+开头那几行都可以省。**多个角色共用的规则写进 `_common.md`**，正文位置用 `[[body]]`，改一次所有人一起变——在开头加一行 `template: _common.md` 就会套上骨架：
 
 ```markdown
 现在起，你是「[[name]]」。
 
 [[body]]
-
-【硬性边界】
-
-- 表演层可以自由发挥；代码、路径、行号、命令参数必须一字不差。
 ```
 
-- 必须**恰好一个** `[[body]]`；没有或有两个，保存都会被拒。
-- `[[name]]` 可以出现任意次。
-- 骨架里同样不许出现非法的 `{{…}}`。
-- **改骨架会连已经开着的人设会话一起变**（下一轮生效，见第七节）。
-
-### 人设放在哪
-
-- **自动挑选**，顺序是：面板里指定的目录 → `<DSH 主目录>/personas` → 插件自带的出厂目录。中间这个主目录由 `DSH_PROFILE_DIR` 推出（取上两级），否则用 `DSH_HOME`，都没有就是 `C:\Users\你\.dsh`；这个 `personas` 不存在时，插件会**用出厂人设把它建出来**，实在建不出来（比如只读）才退回包内那份。
-- 看当前用的是哪个：设置里的「**目录来源**」那一行。
-- 换地方：路径填进「人设目录」→ 保存，插件会自己重启一次。
-- **目录在插件包内时是只读的**：插件升级会整包替换它，写进去的人设会跟着没。看到这个提示就把目录换到包外。
-- 目录在**你自己的用户目录**里，所以卸载插件**不会删掉任何人设**；重装后原样回来。
-- **插件写在磁盘上的东西都在这个目录里**：你的 `.md`、一份 `overrides.json`（会话覆盖：哪个会话指定了谁、换人前是谁）、一份 `teams.json`（团队定义）、一份 `runs.jsonl`（团队运行账本，一行一次运行），以及一个 `team-memory/` 子目录（团队剧情记忆，按会话一份文件，超过 7 天没续上的自动清掉）。唯一的例外是目录只读时——`overrides.json` 会退到 `<DSH 主目录>/dsh-waifu-agents.overrides.json`。
-
-## 三、面板：人设、团队与设置
-
-面板 = 设置 → tab **waifu-agents**，里面分**三个分段**：
-
-- **人设**：名册（新建 / 编辑 / 隐藏 / 排序 / 搜索……）
-- **团队**：建队与编辑，以及「**让这支队成为新会话的默认**」（见第六节）
-- **设置**：运维（目录、默认、清理、版本）
-
-> 顺序是人设 · 团队 · 设置——团队和名册紧挨着，因为一支队伍本来就是从名册里挑人组成的。
-
-**工具条**
-
-| 按钮         | 作用                                                                                                                |
-| ------------ | ------------------------------------------------------------------------------------------------------------------- |
-| 搜索框       | 按名字 / 简述 / 分组 / id 筛选；打 **2 个字以上**还会搜正文，命中单列在「正文命中」里，标明来自**骨架**还是**正文** |
-| 新增         | 在列表最上面开一张空卡片                                                                                            |
-| 导入 md      | 选一个 `.md` 存进目录（同名会报错，不覆盖）                                                                         |
-| 导出全部     | **只问一次、只存一处**：所有可见人设打进一个 `waifu-personas-YYYYMMDD.zip`（一次保存对话框，选一个文件夹），解压就是一堆 `.md` |
-| 下载出厂人设 | 下载包内那份出厂人设，照着改，再用「导入 md」导回来                                                                 |
-| 批量         | 勾选模式：全选 / 隐藏选中 / 导出选中 / 取消选择。「隐藏选中」也走**确认窗**，勾选后才执行                            |
-| 拖拽排序     | **每次打开面板都是关的**——这个开关**不记忆**（以前存在浏览器本地，开过一次就永远开着，看起来像默认开启）。打开后整行都能拖，行内的展开、开关、导出、隐藏会锁住防误触 |
-| 刷新         | 重扫并重新注册。手动放进目录的新文件、在面板外改过的名字 / 简介 / 分组 / 顺序，都要按一次（正文和骨架不用，见第七节）   |
-
-**每一行**
-
-| 控件     | 作用                                                                                 |
-| -------- | ------------------------------------------------------------------------------------ |
-| ↕        | 拖拽手柄。在工具条打开「**拖拽排序**」后出现；**整行都能拖**，拖到另一行上即保存顺序 |
-| ▸ / ▾    | 展开 / 收起她的编辑器。**只有这个按钮会展开**，点名字不会——免得误触                  |
-| 开关     | 她是不是**新会话的默认**。和 设置 → Agent Presets、**团队页那排开关**是**同一个值**：打开一个，其余全部自动取消（平台只有一格） |
-| 下载图标 | 导出这一条 `.md`                                                                     |
-| 隐藏图标 | 点一下**弹确认窗**，勾选后才能确认：文件归档成 `<id>.md.off`，**正文不删**           |
-| 勾选框   | 只在「批量」模式下出现                                                               |
-
-**设置页**（左边描述、右边操作）
-
-| 行             | 作用                                                                                                                               |
-| -------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
-| 人设目录       | 填路径 → 保存：插件会重启一次并重扫。灰着 = 路径没改                                                                               |
-| 目录来源       | 目录是从哪挑出来的                                                                                                                 |
-| 公共骨架       | 有没有骨架、文件在哪；按钮**就地展开编辑器**                                                                                       |
-| 已隐藏         | 展开后逐条「取消隐藏」（**单个也会先弹确认窗**）；「全部取消隐藏」同样先弹确认窗                              |
-| 新会话默认用谁 | 当前默认是谁 + 「关掉（谁都不指定）」；**也可能是一支队**，那时这一行显示「团队：名字」（团队页的开关写的是同一格）；默认指不到人时在这一行下面直接报错 |
-| 分页           | 每页 N 条，默认关闭、打开时默认 **10**。**同一个分组不会被拆到两页**；**打开分页会直接落到默认人设所在的那一页**（不是第 1 页）；关掉再打开会记住你上次填的数。存在浏览器本地 |
-| 彻底清理       | 清掉会话覆盖记录和全局默认指向；打开右边「连人设目录一起删」，才会动目录里的东西（`.md`、`teams.json`、`runs.jsonl`、`team-memory/` 一起没）。弹窗勾选后才执行 |
-| 插件版本       | 当前版本 + 更新按钮。确认后原地换成**进度窗**，装完要你自己点「关闭」（见第八节）                                                  |
-
-## 四、日常操作
-
-- **新建**：点「新增」→ 填「名字」和正文（简述、分组可留空）→ **离开输入框自动保存**。什么都没填就点到别处，空卡片会被丢掉。目录里有骨架时，新建会**自动套上**它。
-- **编辑**：点任意一行展开 → 改完**离开输入框自动保存**（切到别的行、离开标签页，最后一次改动都不会丢）。编辑框只有一种状态——就是编辑。
-- **预览**：行尾的**眼睛图标**（和导出、隐藏并排）→ 弹窗里看她**组装之后的成品**：骨架 + 正文，也就是模型真正收到的那份。它读磁盘，而点它会先触发那次自动保存并等它写完——刚敲的字一定在里面。
-- **改名**：直接改「名字」，**文件名自动跟着变**（转小写、空格标点折成 `-`，中文原样保留；撞名加 `-2`）。
-- **导出**：单条用行尾的**下载图标**（一个 `.md`，一次保存）。**批量**（工具条的「导出全部」、批量模式的「导出选中」）走**一个压缩包**：只弹一次保存框、选一个位置，打开就是 `阿库娅.md`、`惠惠.md`……；不会像以前那样弹 N 次、还可能散到 N 个文件夹里。
-- **隐藏 / 取消隐藏（不是删除）**：隐藏图标 → 弹窗确认 → 文件变成 `<id>.md.off`，提示是**「已隐藏 名字」**（不会把 `名字.md.off` 这种文件名甩给你）；批量隐藏提示是「已批量隐藏 甲，乙」。**取消隐藏**在「设置 → 已隐藏」里点一下（单个也先弹确认窗，确认后提示「已恢复 名字」；「全部取消隐藏」提示「已恢复 3/3」）；重复隐藏产生的 `.md.off.2`、`.3` 也在那儿。
-- **会改数据的事都先问一句**：单条隐藏、批量隐藏、单条取消隐藏、全部取消隐藏、删除团队、彻底清理、安装新版本，一律是**同一个确认窗**（说清后果 + 一个勾选框，勾上才能点确认）。以前批量隐藏、取消隐藏和删除团队是点一下就执行，一次误点能把整批人设归档。
-- **提示都是 DSH 自己的 toast**：保存成功、保存被拒、导入失败、团队校验没过——一律走平台顶部那条一次性提示（成功是打勾、失败是警告图标），**不会在列表里插一行绿字**。绿字有两个毛病：它跟着列表滚走，而且它只画在「人设」那一页里——在团队编辑器里存失败时它根本没地方显示，看起来就像按钮坏了。
-- **调整顺序**：在「**人设**」工具条点「**拖拽排序**」（默认关着，防误操作）→ 整行可拖，拖到另一行上即保存——写进文件的 `order:`，重启后还在。开着的时候行内的按钮和展开会锁住，关掉立刻恢复。批量模式下始终不能拖。
-- **分组**：在编辑器里填「分组」，名册就按组折叠。
-- **搜索**：名字 / 简述 / 分组 / id 是本地筛选；正文搜索走 Host，只回片段。
-- **正文里不要写 `{{…}}`**：平台的提示词渲染**只认 `{{provider}}`、`{{model}}`、`{{cwd}}`**，写别的会让整份系统提示词渲染失败、**会话直接起不来**。面板保存前会拦，Host 还会再拦一次。要写占位符请用 `[[name]]` / `[[body]]`。
-
-## 五、换人与换队
-
-- **从下一轮开始**，当前这句不动。
-- 换人时，插件会在人设**前后各加一行**提示——开头「人设已切换」（点名作废之前的身份）、结尾「本轮身份 · 最后确认」——帮模型彻底放下上一位。
-- 除此之外，换过人之后你每次提问后面还会多出一句「本轮身份 · 运行时确认」——插件替模型再确认一次「现在是谁」，只在身份真的变了的时候出现。看到它不用处理。
-
-几个细节：
-
-- **切回已经在用的那位，不会假装切换**：如果你 `/waifu-change` 到的正好是当前这位，它会回「本来就是 X · 没有改动」，而不是报「已切换」——因为人设内容没变，硬说切换是骗你的。
-- **只列能用的人设**：你选中的那篇如果组装不出来，**不会替换**，这一轮仍然用原来那位。
-- **`/waifu-reset` 也算换人**：回落之后这一轮照样会收到「人设已切换」和那句运行时身份确认，所以模型不会继续用刚被 reset 掉的那位说话。
-- **`/waifu-reset` 回的是「这场会话换人/换队之前在跑的那支/那位」**（换人前的身份记在 `overrides.json` 的 `resting` 里），不是你最后切到的，也不一定是全局默认。它同时把 `/waifu-team` 的团队绑定一起清掉——团队绑定也算一层覆盖。如果这场会话从没换过，reset 会说「本来就没有覆盖，什么都没改」。
-- **会话顶上那个标签会跟着变**：插件用平台自己的那条通道把标签挪过去，只动标签、不动正在跑的插件树——所以标签说的和模型听到的终于一致了。
-- **一个副作用要知道**：标签也是**会话恢复时**用来决定挂载谁的。换过人之后，下次打开 DSH 恢复这个会话，它会真的按新人设装配（工具集也跟着换）——这正是「这个会话就是她」该有的样子，别惊讶。
-- **顺序和分组**：名册按每篇文件的 `order:` 排，组内也是。填了「分组」就按组折叠显示；没填的归到「未分组」。**默认人设所在的那一组会自动展开并滚到她**。组名**只在组头上出现一次**，行里不再重复一个分组小标签——同一行上下各写一遍，看起来像两个互不相干的属性。
-
-## 六、多人同场：团队会话（Team Mode）
-
-> 单人模式是一个「人设」回答你。**团队模式**是**一组人设**在同一场对话里轮流开口：她们接话、反驳、赞同、吐槽，你就在她们中间。整场讨论由**一次**模型调用生成，再按角色逐段流式呈现——所以你看到的是她们一段一段地聊，而不是等半天再一次性甩出来。
-
-### 它和普通换人有什么不同
-
-|          | 单人换人（`/waifu-change`）                 | 团队会话（`/waifu-team`）                            |
-| -------- | ------------------------------------------- | ---------------------------------------------------- |
-| 谁在回答 | 一位人设                                    | 一组人设**同场**                                     |
-| 一次生成 | 一段回答                                    | 全场多段对话                                         |
-| 你看到的 | 她一个人说                                  | 她们接龙式地聊，你在场                               |
-| 退出方式 | `/waifu-change` 再切一位，或 `/waifu-reset` 回到换人之前 | `/waifu-change` 切回单人，或 `/waifu-reset` 回到换队之前 |
-
-### 它不做什么、又记得什么（先看这条，能省一次失望）
-
-团队模式是**剧场**，不是**工位**。「不接工具」是硬边界，不是暂时没做；「记忆」则相反——它是有的，而且默认开着：
-
-| 不做什么         | 为什么                                                                                                                       | 你该怎么做                                     |
-| ---------------- | ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
-| **不调用任何工具** | 团队请求是「队伍背景 + 成员人设 + 剧情记忆 + 这一句」，**不带工具清单**（`tools` 和 `toolHistory` 都没有）。她们读不到你的文件、跑不了命令、搜不了网页 | 要动手就切回单人：`/waifu-change 名字`         |
-
-这条为什么硬：**整场讨论由一次模型调用生成**，输出必须是 `〔名字〕台词` 这样的分段文本。工具调用返回的是结构化的调用请求、不是文本，而且一次调用只能返回一组、没法归给某一个角色——硬塞进来会把分段协议打散。所以不是「忘了接」，是接了就不能这样演。
-
-### 剧情记忆（这一轮记得之前几轮）
-
-每一轮结束后，插件会把这一场的剧情存进一份按会话隔离的记忆文件；下一轮请求把它拼在最前面带给模型。所以**连续聊的剧情是接得上的**——第二幕的她们记得第一幕发生了什么。
-
-| 项       | 说明                                                                                                                         |
-| -------- | ---------------------------------------------------------------------------------------------------------------------------- |
-| 记忆归属 | 按「**会话 × 队伍**」存：这一场同这支队越聊越记得；新会话从零开始，不共享。**中途换队不串剧情**——B 队看不到 A 队的场次；给某支队伍**改名**会从新记忆开始，旧文件按保留期自然过期 |
-| 装多少   | 最近的场次**逐字带**（约 4,800 字符封顶），更早的压成一段**梗概**（≤800 字符）——不会无限膨胀                                   |
-| 保留期   | 超过这么多天没续上的记忆，下次读到时自动清掉、当新会话处理。天数在团队编辑器里**自己填**（像分页的数字框），默认 **7**；填 **0 = 永久保留**，一直留到手动清空为止 |
-| 开关     | 团队编辑器里「**剧情记忆**」开关，**默认开**；关掉这一支队就回到每轮无记忆的旧形态                                                               |
-| 全清     | 团队编辑器里「**强制清空记忆**」：不分保留期、立刻删掉**所有**会话的记忆文件（全量清除、删了找不回来；人设、团队配置、账本不受影响）                |
-
-代价与好处一起说清：正因为不吃那套工具清单（在单人模式里它占首轮输入的 **82%**），团队依然是三种形态里最便宜的。开记忆后每轮输入不再严格恒定——记忆块有上限（约 3,900 token 封顶），且旧场次转写是稳定前缀、会被供应商的前缀缓存接住，账单上表现为「**准恒定**」：比直线略涨、涨到封顶就走平，绝不会像单人那样按轮次平方增长。
-
-一句话：**想让她们聊，用团队；想让 AI 干活，用单人。**
-
-### 怎么定义一支队伍（在面板里做）
-
-打开 设置 → waifu-agents → **团队** 分段，点「**新建团队**」，填这几项：
-
-| 项           | 说明                                                                                              |
-| ------------ | ------------------------------------------------------------------------------------------------- |
-| **名字**     | **必填**。队伍名，也是 `/waifu-team <这个名字>` 要打的字。没填就点保存，会直接在名字框下面标红提示，不会存 |
-| **背景**     | **可选**，一句话设定（她们彼此的关系、已知的事）。每次讨论都带着；成员看不到主对话，只信这一栏   |
-| **成员**     | **必填**。用「**加人设**」挑单个角色，或用「**加组**」把某个分组里所有人一次拉进来；人设和组可混用 |
-
-点「**保存**」即生效。两项必填任意一项没填，都不会写文件，也不会关掉编辑器——提示就在那一条旁边，不在屏幕顶上飘一下就走。
-
-> **改名是改名**：点既有队伍的「**编辑**」，把名字改掉再保存，改的是**这一支队**（成员、背景都留着），不会多出一支同名的队。已经绑在这支队上的会话会跟着新名字走，不用重新 `/waifu-team`。
-
-> **人数上限**有两层，小的说了算：**全局**在「团队」分段底部的两行——**人数上限**（留空 = 不设限，设了必须是不小于 2 的整数）和**超限怎么办**（「超出就不跑」= 这一轮整队不跑；「超出取前几个」= 只留名单里靠前的几个，其余跳过并点名）——对所有队伍生效；**每一支队伍**还可以在自己的编辑器里填「**本队人数上限**」压过全局（留空 = 跟随全局）。比如日常闲聊队填 2、剧情队填 5，超限时走的都是全局那套「超限怎么办」。
-
-> 队伍数据背后存成 `teams.json`（和人设目录里的 `overrides.json` 同目录）、所有会话共用；但你日常只跟面板打交道，**不用手改 JSON**。每个团队同时也是一个预设，会出现在新建会话时的模式列表里，排在**所有人设后面**——选了它，这个会话一出生就在团队模式。
-
-> **让一支队成为新会话的默认**：团队列表里每行右边有一个开关，和她那一行上的是**同一个开关**——平台的 `selectedDefault` 只有一格，所以**打开团队的默认，人设那边就自动取消选中**，反过来也一样。打开之后，新建的会话一出生就在这支队的团队模式里。团队还没注册成预设（刚建好、同步还没跑完）时开关是灰的，旁边会写原因；改名或删掉这支已设默认的队，那个指向会跟着改名走 / 被清掉，不会留下一个指不到任何东西的默认（那会让**每个新会话都开不起来**）。
-
-- 成员引用的人设**必须还在名册里、能正常解析**；失效的成员在编辑器里标「**已失效**」并仍占名额，需要去掉或改回目录里有的名字。
-- 一支队**至少解析出 2 名成员**才会以多人模式开口；凑不够就按单人模式跑——面板里标「只解析到一个人，按单人模式跑」，命令会直接说清是哪支队、只剩几名成员。
-- 面板只负责**建队**；把某支队**绑定到当前会话**（上线）要用 `/waifu-team <队名>`。
-- 删队（列表里那一行）会先弹**确认窗**：删掉的是 `teams.json` 里的这条定义，成员人设文件原封不动；已经绑在这支队上的会话退回单人模式。
-
-### 怎么进场
-
-| 方式 | 怎么做                                                            |
-| ---- | ----------------------------------------------------------------- |
-| 命令 | `/waifu-team <队名>` 直接选队；不带参数先看当前是谁、有哪些队可选 |
-| 面板 | 只负责**建队 / 改名 / 删队**，**不能**把队伍绑到某个会话——上线、下线都是会话级操作，用 `/waifu-team` |
-
-选完**从下一轮开始**生效——你正在打这句不动，下一句起她们就同场了。会话顶上那个标签（chip）也会跟着换成这支队伍；`/waifu-reset` 会把它换回这场会话原本的那支/那位。
-
-> 标签也是**重启后还认不认这支队**的依据：插件把绑定挪到标签上，下次打开 DSH 恢复这个会话，它还是这支队伍。
-
-### 怎么退出团队
-
-用这两条之一：
-
-- `/waifu-change 大肥鱼` —— 切到某一位人设；
-- `/waifu-reset` —— 回到这场会话原本的那支/那位（不是当前绑定的这支，见下方常见问题）。
-
-### 卡顿、超时与「被截断」（团队模式的可靠性）
-
-团队模式一次生成的提示很长、分段多，最怕上游网络慢或中途断流。这部分做了几件事，你体感上应该能注意到：
-
-- **单次请求有约 2 分钟墙钟上限**：某一次模型调用如果卡住不动，插件不会无限等——到时自动中断，然后退避重试（最多重试 2 次，也就是同一轮最多 3 次尝试）。
-- **黑屏卡死会自动重试**：一个字都没吐出来就超时，会干净地重试，通常不耽误你什么。
-- **流了一半卡死，先补完再保留**：如果断在半句（断点落在没闭合的引号/括号里），插件会按「没写完」自动续写（带上已说内容，最多续 2 次），能补完就补完、末尾正常收口；只有续写次数用完还断着，才**保留**已说部分并提示「这一轮因为连接卡住被截断了，已保留说出的部分」——而不是把整段对话一起扔掉。
-- **上游主动报超时 / 断连也重试**：`TIMEOUT` / `TRANSPORT` 这类错误在「没产出内容」时同样会退避重试。
-- **长度不再事先定死**：一次请求最多写约 4,000 token，但这是技术兜底，不是「这一轮只能这么长」。写到头还没说完，会自动接着要下一段（最多续 2 次），并把已经说过的内容一并带上，让她们从下一位接着讲——所以长讨论不会被掐断，短寒暄也照旧很快收住（什么时候停由内容决定，不由预算决定）。
-- **写到很长会自己收口**：快到上限时，最后一位接话的人负责把结论、还没谈拢的分歧、下一步说清，然后结束——不再开新话题。所以长讨论的结尾是「收住了」，不是「断了」。寒暄这种一层就问完的不会硬加总结。
-- **有人没开口会补一次**：如果一轮正常结束了、但还有成员一句话没说，会再请求一次，只请这几位开口。**这一步排在收口前面**——不会为了让最后一个人总结就把没说过话的人跳过。补了一次仍不说，才在末尾点名告诉你「某某没开口」。
-
-> 如果你发现某场对话**整段消失**，或者**连着好几分钟一个字都没有**，多半是上游当时真不稳（一次尝试最长约 2 分钟，3 次都空手才会放弃）；重试仍失败会在末尾明确告知原因，而不是假装成功。
-
-## 七、什么时候生效
-
-**下一轮生效，已经发出去的那句不生效。**
-
-- **改正文**：已经开着的会话**下一轮**就用新的——提示词每轮都按磁盘上那份文件现拼（面板保存会清掉缓存，外部编辑器改的按修改时间也认得出来）。不用新开会话，也不用重启。
-- **改骨架**：所有套用它的人设会话，下一轮一起变（每轮都按当前骨架重新组装），不只是新会话。骨架编辑器里也写着这句。
-- **命令**（`/waifu-change` 等）**从下一轮开始生效**。
-- **名字 / 简介 / 分组 / 顺序 / 新增的文件**：这几项在**注册**时定下来。面板里改完保存会立刻重新注册；**手动放进目录**的、或者你在面板外改的，要按一次「刷新」。
-- **升级插件**要重启 DSH；**换目录**会让插件自己重启一次。
+正文里**不要写 `{{…}}`**——平台只认 `{{provider}}`、`{{model}}`、`{{cwd}}`，写别的会话直接起不来。
 
-**所以要按「刷新」的是这几件事**：手动放进目录的新 `.md`、以及在面板外改过的名字 / 简介 / 分组 / 顺序。面板里保存的不算——它当场就重新注册了；正文和骨架也不算——它们每轮现拼。
+插件所有东西都在这一个目录：你的 `.md`、`overrides.json`、`teams.json`、`team-memory/`、`persona-memory/`。放在自己的用户目录里，升级、卸载都不动它。
 
-**用外部编辑器改过同一个文件？** 面板保存时会带上「我读到的那一版」的指纹；对不上就**拒绝写入**，而不是覆盖对方。重开这一行载入最新内容再合并。写入走「临时文件 + rename」，不会有半截文件——所以不会留下 `.bak` 之类的中间副本。
+## 面板
 
-## 八、更新插件
+设置 → tab **waifu-agents**，分四页：
 
-- 面板**顶部**有新版时会多一条「有新版本 X（当前 Y）」+「查看」；
-- 「**设置**」里的**版本行**也有一个按钮。
+| 分段     | 干什么                                              |
+| ------ | ------------------------------------------------ |
+| **人设** | 新增 / 编辑 / 改名 / 分组 / 排序 / 搜正文 / 批量隐藏 / 导入导出，都在这一页 |
+| **团队** | 建队、设默认、剧情记忆设置                                    |
+| **记忆** | 每个角色记得什么、开关、保存上限                                 |
+| **设置** | 人设目录、公共骨架、分页、彻底清理、版本                             |
 
-两条都打开**同一个确认窗**：
+几条习惯：
 
-1. 窗里写着当前版本、要装到哪个版本、这次会做什么；
-2. **勾选**「我知道这会安装新版本，并且需要重启 DSH」才能按确认——确认键在勾选前是灰的；
-3. 确认后**窗口不会关**，原地换成**进度窗**（见下）；
-4. 装完**必须重启 DSH**。
+- 编辑是**离开输入框自动保存**，没有保存按钮。
+- 只有行首的 **▸** 会展开编辑器，点名字不会。
+- 行尾的**眼睛**看组装后的成品（模型真正收到的那份）。
+- 改名字时**文件名自动跟着变**；改名不会丢正文。
+- 隐藏是改名成 `.md.off`，正文还在，随时取消隐藏。
+- 会动数据的事都会先弹一次确认。
 
-没有新版时，那个按钮是「**已是最新版本**」——它是状态，点一下等于重新检查。
+## 聊天模式与工作模式
 
-### 进度窗
+模式决定这一场手里有没有工具，和人设、团队互不影响。
 
-点确认之后那个窗**一直开着**，直到你自己点「关闭」。它显示：
+|      | 聊天模式                  | 工作模式        |
+| ---- | --------------------- | ----------- |
+| 能做什么 | 只说话，不碰文件、不跑命令         | 全套工具        |
+| 每轮开销 | 3–4 千 token（工具清单不进请求） | 高得多，干多少活算多少 |
 
-- **进度条**：跟着平台报的阶段走（准备 → 从源安装 → 应用配置）。阶段之间的百分比是**估算**的：平台报的是阶段，不是字节数，没有真值可显示。条子只在**真的装完**那一刻才满。
-- **一行状态**：此刻在做什么。
-- **下载源计数**：这个 profile 配了多个源时，会写明「第 1/2 个源」——换源重试表现为条子**前进**，而不是倒退。
-- **已用时间**：秒数一直走，所以你分得清「慢」和「卡死」。万一平台的进度回报迟迟不来，这里也会直说，而不是假装一切正常（安装本身仍在进行）。
-- **pnpm 输出**：可展开，就是 pnpm 自己打的那几行。
-- **结果**：成功会说「已装到磁盘，重启 DSH 后生效」；失败会把原因和 pnpm 的原话摆出来，并给一个「**重试**」。
+- `/waifu-mode chat`、`/waifu-mode work`：改全局，**当场生效**。
+- `/waifu-mode here chat`、`here work`：**只改这一场**，别的会话不变；`here inherit` 把这一场改回跟随全局。
+- 面板「设置 → 模式」里那两个 tab 就是全局开关。
+- **想这一场只陪聊、别的照常干活**：全局保持「工作」，在这一场发 `here chat`。别用全局的 `/waifu-mode chat`——那是把默认换掉，没单独设过的会话会一起变成聊天。
+- **团队永远不拿工具**，跟这一项无关。
 
-**把进度窗关早了也不要紧**：面板顶部会留一条状态（正在更新 / 已更新到 vX / 上次更新失败），点「查看」就能把它叫回来。
+反过来（全局聊天 + `here work`）只能拿回一部分工具，命令会当场说明，不会假装成功。所以混用只有一种做法：**全局工作，个别场次 `here chat`**。
 
-> 为什么要写**精确版本号**：刚发布的版本用裸包名可能被 pnpm 的「新版本冷静期」挡住（`ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION`），精确版本号会被自动放行。面板里这个更新按钮走的就是精确版本号。
+## 团队会话
 
-## 九、常见问题
+单人是一位角色回答你；团队是一组人设在同一场里接着聊，你就在她们中间。整场由**一次**生成完成。
 
-**新任务页上找不到 preset 选择器。**
-设置 → 通用 → 打开「**显示代码工作视图**」。
+|       | 单人                    | 团队                    |
+| ----- | --------------------- | --------------------- |
+| 谁在回答  | 一位                    | 一组，接话 / 反驳 / 附和       |
+| 能不能干活 | 能（工作模式下）              | **不能**，每一轮都没有工具       |
+| 怎么退出  | 再切一位，或 `/waifu-reset` | 切回一位，或 `/waifu-reset` |
 
-**面板里一个人设都没有。**
-先按「刷新」；再确认文件确实在「设置 → 目录来源」显示的那个目录里、后缀是 `.md`、结尾不是 `.off`。
+用之前：
 
-**某一行带「未注册」或「激活失败」。**
-三种提示三种含义：
+1. 面板 → **团队** → 新建团队：名字（必填）、背景（可选）、成员（**至少两个人**）。
+2. `/waifu-team 队名` 把这一场交给它；下次想直接用它开场，就在新任务页选它（团队也占一个预设位）。
+3. 之后如果成员的人设被删掉、隐藏或改名，解析出来不足两位，这一轮才按单人跑——面板和回复里都会点名少了谁。
 
-- 「未注册 · 没注册上，点刷新重试」——注册这一步没落地（改了正文、刚保存完都在这一档），按一次「刷新」就会重新注册；
-- 「未注册 · **本插件旧实例的残留注册**」——插件文件在运行中被替换（热重载）后，旧实例的注册还占着 id；平台的注册表没有删除接口，刷新清不掉，**重启 DSH 即清除**；
-- 「未注册 · 这个 id 被别的所有者占用了」——真的有别的插件注册了同名 id（很少见），改个名字再刷新。
+聊天时的两件事要知道：
 
-「激活失败：…」冒号后面就是原因。
+- 只聊剧情，写代码、跑命令请切回单人。
+- 台词里若出现 `〔某个角色名〕` 会被当成新的一段——贴代码前把那对方括号去掉。
 
-**保存被拒，提示「磁盘上变过」。**
-文件在你打开这一行之后被别的程序改过。重开这一行载入最新内容，合并后再保存（被拒时什么都不会写进磁盘，原文件原封不动）。
+## 记忆
 
-**正文里写 `{{char}}` 为什么不让保存？**
-平台的提示词渲染只认 `provider`、`model`、`cwd`，写别的会让整份系统提示词渲染失败——**会话根本起不来**那个级别。面板会拦，Host 还会再拦一次。占位符请用 `[[name]]` / `[[body]]`。
+两套记忆，分开存、分开管：
 
-**什么是「公共骨架」？**
-一份 `_common.md`，装所有人设共用的条款。写了 `template: _common.md` 的人设只写自己那段，注册时自动拼起来——改一次公共条款，所有人一起变。
+|      | 剧情记忆     | 长期记忆              |
+| ---- | -------- | ----------------- |
+| 记什么  | 上下文都聊了什么 | 她经历过什么            |
+| 跟着谁  | 会话（× 队伍） | 角色                |
+| 换会话后 | 从零开始     | **还在**（换项目、重开都还在） |
 
-**拖不动行，或者一拖就点到按钮了。**
-「拖拽排序」**每次打开面板都是关的**（防误操作，而且这个开关不记忆），在「**人设**」工具条打开。开着的时候整行可拖，行内的展开 / 开关 / 导出 / 隐藏会一起锁住——就是为了不让拖动半路变成误点。关掉立刻恢复；重开面板也会回到关闭。
+- **剧情记忆**：团队每轮自动存，默认保留 7 天，可在团队编辑器里改；「强制清空记忆」立刻删光，慎点。
+- **长期记忆**：单人回合正常结束后记一条，**不额外调用模型**。
+- 每人默认存 **20 条**（可改 1–200），超了淘汰最旧的；每轮**最多注入 3 条**，只注入与这句话相关的，不相关就一条都不给。
+- 新记的都是「情节」，只在那支队里可用；想让别的会话也为她用上，在面板上标「**稳定**」。
+- **工作模式的回合默认不记**（干活时最长的那句往往是代码）；想记就在「记忆 → 工作模式也记」打开。
+- 清空 ≠ 关闭 ≠ 停用：关闭是不读不写、内容留着；清空是删内容、开关不动。
 
-**装新版本装不上、或装完还是旧版本。**
-用**精确版本号**装（如 `dsh-waifu-agents@0.2.4`）。装到磁盘 ≠ 正在运行，重启 DSH 才会换。
+## 省不省 token
 
-**卸载插件会删掉我的人设吗？**
-不会。人设是普通文件，在「设置 → 目录来源」显示的目录里。
+同一场对话，给不给工具差三个数量级：
 
-**卸载之后，这个插件还会留下什么？**
-插件自己的东西只有**人设目录**一个：你的 `.md`、`overrides.json`（会话覆盖）、`teams.json`（团队定义）、`runs.jsonl`（团队运行账本）、`team-memory/`（团队剧情记忆，超过 7 天没续上的本来就会自动清掉）。卸载前到「设置」点「**彻底清理**」，会清掉覆盖记录和全局默认指向；想连目录里的东西一起清，还要打开右边的「**连人设目录一起删**」。
-另外几样是**平台的**，清完会列给你（第一项「彻底清理」会顺手处理，剩下三项插件碰不到）：
+| 形态                |   一轮输入 |    50 轮累计 |
+| ----------------- | -----: | --------: |
+| 聊天模式 · 团队 2 人     |  2,484 |   124,200 |
+| 聊天模式 · 团队 3 人     |  3,094 |   216,400 |
+| 聊天模式 · 单人         |  3,736 | ≈ 400,000 |
+| 没开聊天模式 · 单人（装了插件） | 10,157 | 1,869,100 |
+| 没开聊天模式 · 单人（不装插件） |  6,361 | 1,771,150 |
 
-- `selectedDefault`——安装/改默认时写进 profile 的一行，指向本插件的人设（「彻底清理」会顺手清掉它，所以它不算残留）；
-- `.plugin-manager/logs/operation-*`——平台的安装日志，每次装/卸都攒一个；
-- pnpm 的内容库索引（`%LOCALAPPDATA%\pnpm`），要自己跑一次 `pnpm store prune`；
-- `pnpm-workspace.yaml` 里的 `minimumReleaseAgeExclude` 条目——pnpm 安装时自己写的放行记录，删掉可能让版本被冷静期挡回去，留着更安全。
+![一轮输入 token 的量级](docs/token-cost-ladder.svg)
 
-**我改了名字，文件不见了？**
-没丢，文件名跟着名字走了（这就是设计）。
+![累计输入 token 的名义值与缓存折算](docs/token-cache-lines.svg)
 
-**`/waifu-team` 选了队，但她们不开口 / 只有一个人说话？**
-先看这支队伍能不能凑够两个人：团队编辑器里，失效成员会标「**已失效**」并仍然占着名额——把它们去掉，或者改回目录里还在的名字。凑不到 2 名有效成员就会按单人模式跑：面板标「只解析到一个人，按单人模式跑」，命令那边会直接说是哪支队、只剩几名成员。
-凑够两个人也可能有人不说话：规则要求每个人至少用自己的人设语气表个态（不是套「我同意某某」的模板）。某一轮某位确实没接上，是这次生成没做满轮次，不是成员掉了。
+聊天模式的请求里真的没有工具清单，一轮全在 3 千出头。不装插件是 6,361——其中 5 千多是宿主自带的 25–28 个工具，一句闲聊也照付；装了插件却没切聊天模式是 10,157，多出来的还是那张清单。累计形状也不同：单人和裸平台每轮重发全部历史，越聊越陡（二次增长）；团队每轮只发「队伍背景 + 成员人设 + 这一句」，是一条直线，开记忆后先缓涨、封顶走平。而工具清单带过一次就进缓存，之后按 1/10 计价——开了聊天模式后 7 轮里 90.4% 是缓存读，名义 2.4 万折算下来 4,535；不开则 7 轮有 6 轮没命中，名义 5.5 万、折算 5.1 万，几乎没打折。真开工（工作模式调工具）整场 188 万起，裸平台约 680 万。
 
-**怎么退出团队？**
-用 `/waifu-change 名字` 切到某一位人设，或 `/waifu-reset` 回到这场会话原本的那支/那位。
+**所以：省 token 靠「这一轮要不要工具」，不靠删人设、也不靠剪骨架。**（名义＝`inputTokens + cacheReadTokens`，折算再加缓存读 × 0.1；只算输入，看量级不是报价。）
 
-**`/waifu-reset` 回的是默认人设，还是这场会话最早的那位？**
-都不是，也不是「最后一个」。它回的是**这场会话第一次换人/换队之前在跑的那支/那位**（人设记在 `overrides.json` 的 `resting`）——可能是默认人设，也可能不是（比如你用 `/waifu-change` 开这个会话，resting 就是那一位；用 `/waifu-team` 换过队，则回到绑队之前的那支）。它同时会清掉团队绑定。如果这场会话从没换过，reset 直接说「本来就没有覆盖，什么都没改」。
+## 什么时候生效
 
-**执行 `/waifu-change` 这类命令会消耗 token 吗？**
-不会。这些命令只是改会话的人设指向和会话标签，是本地状态操作，**不调用模型**。只有下一句正常的对话才会带新人设——而那句本来就要消耗 token。
+| 改了什么           | 什么时候管用                    |
+| -------------- | ------------------------- |
+| 切换人设 / 团队 / 模式 | 下一轮（模式是当场）                |
+| 人设正文、公共骨架      | 已经开着的会话下一轮就用新的            |
+| 名字、简介、分组、顺序    | 面板里保存立刻生效；面板外改的，点一次「刷新」   |
+| 升级插件           | 以面板那句话为准：可能当场生效，可能要重启 DSH |
 
-**三种模式到底谁更省 token？**
-短答：**第一轮团队最省；聊得越久，单人越贵。团队开记忆后会缓涨，但涨到封顶就走平。**
+## 常见问题
 
-![三种模式的累计输入 token 随轮次增长](docs/token-usage.svg)
+**面板里一个人设都没有？** 先点「刷新」；再确认文件在「设置 → 目录来源」那个目录、后缀是 `.md`、不是 `.off`。
 
-| 轮数 | 单人       | 裸平台     | 团队 3 人 | 团队 2 人 |
-| ---: | ---------: | ---------: | --------: | --------: |
-|    1 |     10,040 |      8,081 |     4,328 |     2,484 |
-|   10 |    150,620 |    131,030 |     43,280 |    24,840 |
-|   50 |  1,869,100 |  1,771,150 |    216,400 |   124,200 |
+**某一行提示「激活失败」「ID 占用冲突」？** 多半是热重载时新旧实例并存，**完全退出 DSH 再启动**，提示消失就没事。
 
-差别不在斜率，在**形状**：
+**保存被拒，说「磁盘上变过」？** 这行在别处被改过了，重新打开载入最新内容再改一次（被拒时磁盘上什么都没写）。
 
-- **单人 / 裸平台**：每轮把全部历史重发一遍，累计是**二次增长**。第 50 轮时单人 187 万。
-- **团队（无记忆）**：每轮只发「队伍背景 + 成员人设 + 这一句」，累计是**一条直线**。第 50 轮 21.6 万（3 人）／12.4 万（2 人）。
-- **团队（开记忆，默认）**：每轮多带一块记忆——最近场次逐字 + 更早的梗概，**封顶约 3,900 token**。累计线先缓涨、到封顶后走平，**绝不是单人的平方曲线**。上表两组团队数字是记忆功能加入前的实测，现在应视为**下限**：之后每轮最多再加约 3,900 token（实际远小于此——旧场次转写是稳定前缀，供应商的前缀缓存会接住大半）。
-- 所以 50 轮时单人仍约为团队 3 人的 **8 倍以上**；轮次越多，倍数越大。
+**拖不动行？** 「拖拽排序」每次打开面板都是关的，在工具条里打开；开着时行内按钮会一起锁住。
 
-口径说明：只统计**输入**（`inputTokens + cacheReadTokens`），不含回答；单人只有第 1 轮是实测，第 2 轮起按每轮 +1,116 外推（图上用虚线）；缓存命中会压低**账单**，但不改变 token 量，也不改变三条线的形状。另外，一轮若写到技术上限被自动续写，续写请求会把已说内容一起带上，那一轮的输入会高于上表——表里按**单次请求**计。团队两组数字是加入「收束规则」之前实测的，那条规则让系统提示长了约 90 字符（约 +57 token），量级和结论都不变；记忆块的实际占用写在团队运行账本每行的 `memChars` 里，可以自己对着账。
+**只有一个人说话，是不是坏了？** 不是。谁接谁由内容决定，不必人人开口。真会退回单人的只有一种情况：队伍里的人设被删掉、被隐藏之后，解析出来剩不到两位（建队时至少要两位，所以这只会发生在建好之后）。
 
-反过来记住一句：**想省 token，最大的杠杆是「这一轮要不要工具」，不是删人设、也不是剪骨架**——单人首轮 82% 花在工具清单上。
+**`/waifu-reset` 回的是全局默认吗？** 不是，是这个会话开始时选的那位。想搬去当前全局默认就写 `/waifu-reset global`。
 
-**`teams.json` 写在哪？**
-和人设目录里的 `overrides.json` 同一个目录（见第二节「人设放在哪」）。文件开头那两项全局设置，就是面板「团队」分段底部那两行——**人数上限**和**超限怎么办**，对所有队伍生效；每支队伍自己的 `maxMembers`（编辑器里那行「本队人数上限」）填了就压过全局。
+**这些命令花 token 吗？** 不花。它们只改本地状态，不调用模型。
 
-**团队能帮我写代码 / 改文件吗？**
-分两半：**写代码文字可以，动你的仓库不行。**
+**卸载会删人设吗？** 不会。卸载前到「设置」点「彻底清理」，会清掉覆盖和默认指向；勾上「连人设目录一起删」才会动你的文件。
 
-- **不行**：团队请求不带工具，她们读不到你的仓库、不能写文件、不能跑测试、不能查网页。要真正落地执行，切回单人（`/waifu-change 名字`）——单人模式才有工具。
-- **可以**：让她们在对话里贴代码片段、讨论方案、互相挑错是可行的。分段协议能承载代码块（多角色各贴一段也能正常切段）。
-- **一个已知限制**：代码里如果出现 `〔某个角色名〕` 这样的字样（日志格式、模板字符串、测试数据里很常见），会被误认成新的一段、从中间切开。要贴这种代码，先把那段改成不带方括号的写法。
+## 更新插件
 
-**团队为什么不是「多个 Agent 各管一摊」？**
-这是设计时明确排除的一条路，主要卡在成本和连贯上：
+面板顶部或「设置 → 版本行」出现新版本时点它：确认窗里勾一下，它自己下载安装，装完告诉你「已经生效」还是「要重启 DSH」。
 
-|            | 真·多 Agent（每个角色一个）                        | 现在的团队模式                                |
-| ---------- | -------------------------------------------------- | --------------------------------------------- |
-| 请求次数   | 每人一次，还得再多一次调度汇总——2 个人一轮至少 3 次 | **通常 1 次**；写长了自动续写，一轮最多 3 次 |
-| 每次带什么 | 每个角色各自的系统提示 + 工具清单 + 全部历史        | 队伍背景 + 成员人设 + 剧情记忆（封顶约 3,900 token）+ 这一句 |
-| 每轮输入   | 人数 × 轮次，越聊越贵                              | 约 2,484（2 人）／4,328（3 人）起，记忆块封顶后走平，不按轮次平方增长 |
-| 场景连贯   | 靠角色互相转述，第三个人开口时已经转了两手          | 同一次生成，谁接谁是一次安排的                |
+升级会换掉**插件自己带的东西**：
 
-真正拉开差距的是输入量：单人模式首轮 10,040 token 里，**82% 是工具清单**。真多 agent 版本等于每个成员各背一份工具清单、各背一份历史，再为「谁在调度」多付一次——而她们说的还是同一场闲聊。
+- 代码（整包替换）
+- 人设目录里的骨架 `_common.md` 和说明 `README.md`——这两个是插件资产，跟着版本走。包里的话术改进了，你这里会同步换掉；换之前那份存成 `_common.md.bak-<时间戳>` 留在旁边，想找回随时能找。
 
-另外两件不是钱的事：**连贯**靠一次生成最省事（同一个模型在同一口气里安排谁反驳谁）；**工具调用的归属**在多人同场里说不清——一次调用只返回一组结果，没法判定是澪查的还是纱月查的。硬接进来就得再设计一套「谁在动手」的协议，那是另一个产品了。
+升级**不碰**你的数据：人设 `*.md`（包括你自己的和大肥鱼）、`persona-memory/`、`teams.json`、`overrides.json`、`mode.json`。
 
-所以不是做不到，是这个定位下不划算：**要同场演出，一次生成最便宜也最连贯；要真干活，切回单人。**
+只有插件自己建出来的那个目录（默认 `~/.dsh/personas`）会这样更新。你手动指到别处的目录（比如桌面上放角色的那个文件夹）插件一个字节都不往里写。
 
-**团队对话好慢 / 中途断了怎么办？**
-团队模式一次要把整场对话写完，输出 token 比单人一句多得多，所以慢是正常的——不是卡住。分三种情况：一轮写到了技术上限还没说完，会自动续写（最多两次），那确实更慢，但东西是完整的；上游卡顿有约 2 分钟上限，会自动重试；流到一半断在半句（引号/括号没闭合）会按「没写完」自动续写补完，**续写次数用完仍断着才**保留已说出的部分并提示被截断，不会整段消失。
+从命令行装的时候**写精确版本号**（`dsh-waifu-agents@版本号`，用 npm 页面上最新那个）。刚发布的版本用裸包名可能被 pnpm 的新版本冷静期挡住。