@ dsh- 代理角色/ 状态

Firefox2100维护的DSH Agentic Lockersplay的持久性会话状态和内存服务.

大多数用户应安装 @dsh-agentic-roleplay/all。当另一个DSH插件需要角色扮演数据库,寄存器,召回引擎,或者没有完整的角色扮演界面的模型化记录工具时,单独安装此包.

一个DeepSeek Harness 插件, 保持角色扮演会话状态: 一个 SQLite 每个会话的数据库,通过存储器与犬科模型连接。 这个 没有管弦乐,也没有UI,所以可以自行安装以获得一个 角色扮演数据库和状态管理没有其他角色扮演捆绑. 其他插件通过 roleplayState 服务。 建模工具 包含并可通过其配置启用.

需要 DSH 0.2 和节点 22.19 或 后期( 它使用内置) node:sqlite) (中文(简体) ).

dsh plugin --profile <name> add @dsh-agentic-roleplay/state

使用另一个插件

import type {} from '@dsh-agentic-roleplay/state'            // types `ctx.roleplayState`
import type { Context } from '@deepseek-ai/cordis'

export const inject = ['roleplayState']

export function apply(ctx: Context) {
  // Creates sessions/<uuid>/session.sqlite and opens it.
  const session = ctx.roleplayState.createSession('/path/to/sessions', {
    name: 'First night',
    world: { id: 'blackwater-observatory', name: 'The Blackwater Observatory' },
  })

  session.transaction(() => {
    const mayor = session.characters.add({ name: 'Eleanor Graves', /* … */ control: 'agent' })
    session.characterStates.create(mayor.id, { publicState: '…', innerState: '…', activity: '…' })
    session.intents.add(mayor.id, { type: 'agenda', name: '…', /* … */ })
  })

  session.characters.findByName('the mayor')       // by name or alias, ignoring case
  session.characterStates.update(1, { activity: 'looking for the key' }, { expectedVersion: 3 })
}

该服务在您给出的会话文件夹下创建并打开会话, 每个会话共享一个连接, 当插件卸下时全部关闭 :

会话 ids 成为文件夹名称, 因此只接受一个 UUID v4 。 套装也 输出与平面函数相同的操作createSession, (中文(简体) ), openSession, (中文(简体) ), createSessionStore,.)用于不运行在DSH内部的代码,例如测试.

记录 API 和模型化工具

该套件拥有一个故事是如何被记住的,而不仅仅是它存储的地方:

• session.edit(edit) 改变故事的纪录(特征状态,事件与谁收录,信仰,线条) 一起或完全不收. 它先检查整个编辑然后扔出去 InvalidEditError 命名每个问题,所以一个模型的错误可以报告给它. parseRecordsEdit(json) 读取线条格式模型写入( snake case)和 recordsEditSchema({ characters, changes }) 是它的JSON schema,用于模型的结构输出或工具的参数.
• session.records(scope) 以同样的电线格式读取记录.
• session.recall({ characterId, situation, turn, policy }) 一个人物被提醒的是什么: 它所经历的事件和它相信的东西, 通过局势谁提到, 共享的言语和标签, 重要性和故事时间的调整 policy.flaky 年长和不重要的人被说成是淡出或模糊的,或者已经消失。 年龄已经过了故事时间 session.clock从不计数 一个不重要的事件有六层楼的半生 它计算它带回的记忆, 它使它持续的时间更长.
• session.recallStored(query, { queryVector? }) 将会话的搜索索引添加到提示中:通过文字来匹配情况,并与情况向量相匹配的文本,以含义来对应. session.searchEvents({ text, vector?, fromTurn, toTurn, minImportance, limit }) 找到同一两次搜查的经过 由对等等级合并.
• session.recallRanked(query, signal, { queryVector? }) 需要任何能提醒某样东西的功能: recall,在插件以 roleplayState.rankMemories(ranker) (嵌入模型,重排;见 docs/capabilities.md) (中文(简体) ). session.recallCandidates(query) 给出可以召回的, 与文本匹配的, 一个分级。 与 explain: true 在查询中每个被召回的东西 why:瞬间之提示(人名,言语相通,地地相通),每次搜索的得分,重要程度,是多久以前,所想的多少,以及排名的多少.
• session.knowledge 地点、物品和直接出口的封闭世界意识图(learn, (中文(简体) ), knows, (中文(简体) ), get, (中文(简体) ), list, (中文(简体) ), forget) (中文(简体) ). 方向关系是相应的字符对字符边缘. 认识只提供身份,不提供现状或下落. session.planKnownMove 计划只通过一个角色已知的地点和出口; planMove 仍然是权威的世界规划者.
• session.factions, (中文(简体) ), factionStates, (中文(简体) ), factionMemberships, (中文(简体) ), factionRelationships 财务报告和审定财务报表 factionIntents 将持久性组织与在场景中发挥作用的字符分开存储。 成员众多;涉及派别的关系是方向性的,是封闭世界认识边缘的两倍.
• roleplayState.bind(resolver) 告诉一个代理商在哪个角色扮演会话中工作的工具(运行代理商的插件提供它,同时播放转盘和内存政策).

在DSH工具登记册上注册的工具(defineTool,键入输出,遵守调用 signal),通过约束解决: list_characters, (中文(简体) ), get_character, (中文(简体) ), search_events, (中文(简体) ), recall_memories, (中文(简体) ), list_threads,并仅在插件配置时 writeTools: true, (中文(简体) ), update_character_state, (中文(简体) ), record_event, (中文(简体) ), remember, (中文(简体) ), open_thread, (中文(简体) ), resolve_thread。对于一个在没有角色扮演会话中工作的代理商,它们以一个简单的信息失败。 字符和其他一发子剂没有看到它们(它们开始时没有工具).

配置

层

一切都是同步的,就像嵌入的 SQLite 库一样.

这是一个独立的社区项目,不是官方的DSH软件包. 文档 • 妇女 来源 • 妇女 问题 * 仅限GPL-3.0

会议

一个会话是文件夹 sessions/<uuid>/ 及其数据库 session.sqlite。 。 。 . 数据库是状态需要的唯一文件; 默认日记模式 保留一个可以复制或存档的文件.

世界本身没有储存. metadata 保持一个 世界参考页:1 世界稳定编号 id 联合国 world.json名称, 并选择一个版本,会话内容的指纹开始 来源和自由形式 extra 字段。 它保存为一个文档,所以 原产地可以在不改变计划的情况下增长.

元数据还包含会议列表显示的内容: name (创作时的选择),其创作时间,最后一出戏的时间 (不在场,直到一个转弯已经播放)和转弯次数. 随便啦 播放旋转调用 metadata.recordTurn(),它计算它和设定时间.

字符有会话本地整数 ID. source_id 保持编号 性格在世界上,所以一个会话可以追溯到它的世界; 播放时创建的字符没有.

Schema(第1版)

事件是地面真相; 感知(这些感知仍然可以重现: updatePerception, (中文(简体) ), addPerception),回忆和摘要都来源于它们,可以重建. 仓库是 events, (中文(简体) ), memories, (中文(简体) ), threads, (中文(简体) ), summaries 财务报告和审定财务报表 pendingCommits 在字符旁边.

删除字符可以删除属于它的一切. 这些表格是: STRICT,计数和范围为 CHECK 限制, 和外国键是 已执行。 文件记录了它的图案版本在 user_version 并携带一个 应用程序 id, 因此一个不是会话数据库的文件被拒绝 .

改变计划

当一个会话打开且从未编辑时,按顺序进行迁移 一旦发布: 更改是新条目 src/sqlite/schema.ts测试 标定每次释放的迁移。 拒绝更新版本的数据库 而不是损坏.

在更新最新计划后的文件之前,它必须通过 SQLite 的文件 快速完整性检查( 拒绝使用损坏的文件) CorruptDataError,未触及) 以及写给 migration-backups/schema-<version>.sqlite 在数据库旁边,每旧版本一次. migrationBackupPath(location, version) 说在哪里.

错误