DSH Plugins Marketplace

DSH Plugins

Plugins

/

character-archives

W

character-archives

Discovered★ 4

DSH Tavern Plugin "Character Archive": Let NPCs Remember What They Know

Machine translated

人物档案馆 · character-archives

简体中文 | English

Package plugin Release

给 DSH Tavern 的第三方插件。让 NPC 记得住自己知道什么,并在写正文时把这些记忆按需递给模型。


这是什么

玩长线角色扮演时,模型有个天然缺陷:它只看得到最近一段对话。

于是会出现这些情况——

  • 三章前那个掌柜明明亲眼见过你杀人,这章却像不认识你
  • 你在另一个城市跟人说起某位旧识,模型完全接不上
  • 同一个角色,昨天还是"冷面杀手",今天就变得和蔼可亲,因为它忘了自己是谁

把所有档案全塞进上下文是另一个极端:撑爆字数,而且分不清"谁真的知道"和"谁只是听说"。

这个插件做的是中间那条路:给每个人物记一本小册子,只在需要时抽出相关的那几页。

而且它承认一件现实——同一件事,A 信、B 不信、C 只是听说,这不是矛盾,是常态。 所以档案能同时保存"同一件事的多个版本",各人的认知互不干扰。


它做什么

能力说明
自动建档值得记住的角色自动入册,不用你手动添加
每轮自动整理正文写完后,后台读一遍正文,判断谁出场了、谁知道了什么
写前提醒下次生成正文前,把相关人物的记忆按字数预算递过去
可查可改侧栏面板里能翻每个人的档案,改名字、改内容、改关系
换一套栏目默认 8 个栏目,可以改名、改提示词,也可以整套换掉
改提示词三段跟模型说话的模板都能自己改,也能一键恢复默认
导出备份整本人物册能导出成文件,也能导回来

怎么装

你需要先有

  • 已装好 DSH Tavern
  • 会压缩 / 解压 zip

方式一:上传 ZIP(推荐)

第 1 步:拿到插件包(二选一)

  • 最省事:从 Releases 下载现成的 character-archives.zip(由 CI 自动打好,直接可用)
  • 自己打:下载本仓库 → 解压 → 只把 plugin/ 这一个文件夹压缩成 zip

第 2 步:酒馆里打开 设置 → 酒馆插件 → 上传 ZIP,选中那个 zip。

第 3 步:宿主侧几秒内加载,刷新浏览器就能在侧栏看到。

⚠️ 别把整个仓库打包 安装器按「最浅的那个 package.json」认定插件根。仓库根有一份开发用的 package.json(跑测试、装插件用的脚本),如果整包上传,它会抢在 plugin/package.json 前面被选中,然后报错: package.json 没有写宿主入口(exports "." 或 main),不是 Tavern 插件

所以只压 plugin/ 这一层——压出来的 zip 里应该是 plugin/package.json(或直接就是 package.json),而不是仓库根的 package.json。

方式二:手动复制文件夹

DSH Tavern 的插件就是一个文件夹——不需要编译、不需要装依赖、不用改酒馆源码。

把 plugin/ 整个复制到酒馆数据目录下的 plugins/ 里,并改名成 character-archives:

<酒馆数据目录>/plugins/
└─ character-archives/
   ├─ package.json
   ├─ index.mjs      宿主侧(改它要重启)
   ├─ client.js      浏览器侧(自动热更)
   ├─ assets/        提示词默认版 + 分词词表
   └─ lib/           纯逻辑模块

Windows 上酒馆数据目录一般在:

C:\Users\<你的用户名>\.dsh\profile-data\tavern\data\plugins\

文件夹名必须是 character-archives——插件靠这个名字认出自己是被酒馆装的,进而把数据存到 <酒馆数据目录>/plugin-data/character-archives/。名字不对会退化成"数据存在插件目录里",更新时容易丢。

如果你在本仓库里开发

npm run install:dev

这条命令把 plugin/ 复制到上面那个目录。

⚠️ 两个必须知道的点

  1. 改 index.mjs(宿主侧)之后要重启 DSH,否则不生效;改 client.js 会自动热更。
  2. install:dev 只复制、不删除——plugin/ 里删掉的文件不会从安装目录消失,需要自己清理。

装完检查

打开任意一局游戏 → 侧栏「+」→ 插件 → 人物档案馆。能看到面板就是装好了。

💡 更新已有插件要重启:全新安装宿主会自己加载,但覆盖升级后旧模块还在内存里,必须重启 DSH 才会换成新代码。


怎么用

面板有四个标签页

标签页干什么
档案看在场/离场/冷档的人物,搜索,查某人"知道什么"
设置召回预算、认知口径、存储保留等
提示词改三段跟模型说话的模板,或恢复默认
预设改栏目名字与抓取提示词,另存为全局默认或按卡覆盖

档案页能做什么

  • 点人物名展开,看他的栏目内容(他是什么样)和认知(他知道什么、信不信、听谁说的)
  • 改名字(旧名自动进别名)、改状态(在场/离场)、打 ★ 标记
  • 锁住某人(模型不能改)、对模型隐藏(不递给他)
  • 拖动标题行换分组(在场/离场/冷档)
  • 每条命题后面能看到程序自动分出来的词,帮你理解"为什么这次召回了这个人"

不用管的事

  • 谁该建档、谁该离场、谁知道了什么——插件自己判,你只在觉得不对时手动改
  • 人物册跟着这一局走,剧情回退它会跟着回退

它怎么工作

三段话讲完,细节在 设计文档。

一、记忆分两层。 一层是「命题」——有人提过、有人信过的一句话,不保证为真;另一层是「指针」——每个人各持一份,记录"他信不信、从谁那儿听来的"。同一件事可以有多个版本,因为认知本来就分人。

二、只在需要时递过去。 每轮生成正文前,插件挑出在场人物的相关记忆,按 3000 字预算塞进提示词。挑谁、挑哪几条,靠固定规则打分:关于在场他人、关于当前地点、词语在正文里命中。离场的人不递——正文刚写过他,用不着再念一遍。

三、每轮写完后整理。 正文写完,后台把正文读一遍,判断谁出场了、谁知道了什么,更新到人物册。这一步用独立模型调用,不占你正文的上下文。


目录结构

plugin/            插件本体(复制进 plugins/ 即可运行)
├─ index.mjs       宿主侧入口:apply(ctx),注册所有 handle
├─ client.js       浏览器侧:侧栏面板
├─ prompt.js       三段提示词的兜底副本(由 assets/*.txt 生成,别手改)
├─ assets/         三段提示词的默认版 + jieba 分词词表
└─ lib/            纯逻辑模块(不碰酒馆接口,可本地单测)
docs/              设计文档、ADR(决策记录)、ROADMAP(路线)
tests/             单元测试
scripts/           开发脚本(装到酒馆、同步提示词副本)

数据存在哪

人物册不放在酒馆的对话数据里,而是放在插件自己的目录:

<酒馆数据目录>/plugin-data/character-archives/

这样做的好处是不受插件更新影响;代价是重装插件(清目录)会丢数据。

💡 建议:玩到一半想换机器或重装前,先在面板里导出一份。


常见问题

Q:改了代码没生效? 改 index.mjs 要重启 DSH;改 client.js 会自动热更。改了提示词则要检查是不是只改了一处——提示词在四个地方各存一份(详见设计文档)。

Q:某人被记了不该记的东西? 面板里直接删掉那条命题。也可以在「提示词」页调「记录门槛」相关段落,让模型少记。

Q:模型把鸡毛蒜皮都记下来了? 这是设计上花了很多力气的地方。系统提示词里有「四条硬规矩」,其中两条专门管这个:他做的事本身不记、这个身份本来就会的不记。如果还是太啰嗦,可以在「提示词」页把这两条写得更严格。

Q:在酒馆里粘 GitHub 地址装不上,报「没有写宿主入口」? 这是本仓库的结构决定的,不是你的操作问题。安装器按「最浅的 package.json」认插件根,而本仓库根目录有一份开发用的 package.json,会抢在 plugin/package.json 前面被选中。请改用「上传 ZIP」,并且只压 plugin/ 那一层(详见怎么装)。

Q:能同时装两个不同的人物档案馆吗? 不能。插件按名字识别,同名只能有一个。

Q:跨插件调用(别的插件读这里的档案)? 还没做。


相关文档

想知道什么看哪
当前设计是什么样的docs/DESIGN.md(唯一规格真源,由 AI 维护)
为什么这么定docs/adr/(104 条决策记录,索引)
以后要做什么docs/ROADMAP.md
这一版改了什么CHANGELOG.md(对外)/docs/CHANGELOG.md(内部时间线)
怎么参与开发CONTRIBUTING.md
项目约定与 AI 硬性要求AGENTS.md

状态

版本 0.1.3,已发布,安装包见 Releases。

  • 能跑:建档、自动结算、召回注入、面板增删改查、栏目预设、三段提示词编辑、导出导入、设置页、手动补写(自动写入没写进去时,点一下把最新一轮再写一次)、批量删命题/认知(多选 + 全选 + Shift 连选)
  • 测试:867 个用例全过(npm test),CI 在 Linux 上同样跑一遍
  • 零运行时依赖:plugin/ 里没有 dependencies
  • 还没做:跨插件接口、同名不同人、栏目预设单独导入导出、非 MVU 卡的游戏内时间

各版本的验收标准与待办见 docs/ROADMAP.md。



许可证

代码与文档分别授权:

范围许可证你要做的事
代码(plugin/、scripts/、tests/)GPL-3.0-or-later保留版权声明;修改后分发必须以 GPL 开源你的修改;标注你改了什么
文档(docs/、README、CONTRIBUTING、AGENTS)CC BY 4.0署名 WhichWitchWin、附许可证链接、注明有没有改动

完整说明与具体署名写法见 NOTICE。

⚠️ 一句话提醒:版权保护的是「文字怎么写」,不保护「想法」。 别人读你的设计、理解思路后自己重写一份实现,法律上不构成侵权——任何许可证都管不到。 CC BY 4.0 能强制的是:抄写或改编这些文字时必须署名。

第三方资源:plugin/assets/dict/ 下的分词词典来自 jieba(MIT),不适用上述双许可,见同目录 LICENSE-jieba.txt。

Comments

Loading…

Similar plugins

dsh-plugin-tavern

by Star-Guest

酒馆(SillyTavern 精简版)DSH 插件:角色卡解析管理员 card-analyst + 角色扮演讲述者 roleplay

Manifest valid

★ 4

JavaScript

Aug 22, 2026

dsh plugin --profile web add dsh-plugin-tavern

by 3121455692atou-sudo

DSH 酒馆模式:角色卡、预设、独立角色记忆与共享头像

Terminal & ClientsManifest valid

★ 0

JavaScript

Sep 12, 2026

dsh plugin --profile web add dsh-tavern-mode

by hu568

DSH 插件:角色设定与长期记忆(角色库 persona.yml/SOUL.md/USER.md + FACT.md/MEMORY.md + JOURNAL.jsonl),注册在宿主组合层,对所有 agent 预设生效,附右侧栏管理面板。MIT。

Manifest valid

★ 1

MIT

JavaScript

Oct 21, 2026

dsh plugin --profile web add @dsh-external/dsh-persona-memory

by XGUIMAX

DSH Tavern 错题库:按人物卡分类记下调试中踩过的坑,先查本卡、再跨卡。 / Per-card defect ledger for DSH Tavern.

Terminal & ClientsManifest valid

★ 4

MIT

JavaScript

Nov 4, 2026

dsh plugin --profile web add dsh-wrongbook

by RiemannRe3

DeepSeek Harness 的 Tavern 角色卡兼容与原生 Agent RolePlay 插件。

Just for FunManifest valid

★ 9

↓ 42/wk

MIT

TypeScript

Aug 30, 2026

dsh plugin --profile web add @riemannre3/dsh-roleplay

Persona mode with character cards, long-term memory that fades and can be reviewed, diaries, a reference library, and stickers.

Tools & CapabilitiesManifest valid

★ 0

dsh plugin --profile web add @local/dsh-persona-memory