DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

Nico233333 /

Nico233333/dsh-persona

Topic repository only

Global persona system for DeepSeek Harness: one persona mounted across every session, dedicated persona page, editable card library, any-format import.

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@965d78ce

dsh-persona

DeepSeek Harness 的全局人格系统:登录一次,所有对话都按同一个人格说话。 一个专门的「人格」页:输入人格、编辑人格卡、预览模型实际收到的提示词、管理草稿与备份。

License: MIT Version


它解决什么问题

DeepSeek Harness 默认在每个会话里只有一个“助手”。这个插件给整个 Harness 加一层持久化人格:

  • 人格是全局的:登录一次,所有主会话、重启之后都还是同一个人;
  • 人格是可编辑的资产:卡片存在磁盘上,有分节、设定条目(lore)、示例对话与开场白;
  • 人格是可导入的:贴一段文字、拖一个文件,AI 会整理成规范卡;
  • 人格是用户独占的:模型只能读卡、起草、拆图,没有任何挂载/删除权限——避免一段不可信的文本把系统提示换掉。

特性

挂载与切换

  • 左侧栏「人格」页是唯一管理入口:登录 / 卡片 / 草稿 / 设置四个 tab
  • 登录 = 输入:输名字挂载已有卡,或粘贴整段人格原文当场建卡并挂载
  • 对话输入框左侧的状态片显示当前人格,点开可快速挂载/卸载(完整管理仍在人格页)
  • 只注入主会话;subagent / teammate / workflow 子代理默认不继承(可在设置里打开)

卡片

  • 六个分节:身份与背景、性格与行为准则、语言风格、示例对话、禁忌与边界、开场白
  • 设定条目(lore)逐条编辑:常驻 / 关键词命中 / 关闭;关键词条目只在当前用户消息命中时注入
  • 编辑器右侧实时预览模型实际收到的文本、字符数与设定命中数;可模拟一条用户消息查看命中
  • 版本历史:每次保存前自动留一版(保留最近 10 版),可一键回滚,回滚本身也可再回滚
  • 卡片库搜索(含正文与 lore 全文)、标签筛选、排序、批量删除、组合卡

导入

  • 按内容识别格式,不挑扩展名:纯文本、Markdown、SillyTavern PNG/JSON、Word(.docx)、ODT、EPUB、PDF、HTML、RTF、ZIP
  • 所有导入先由当前默认模型整理成规范卡,失败才回退确定性解析
  • 群像卡 / 多角色插画可拆成多个角色草稿(persona_split_image),背景作为常驻设定注入每张卡
  • PNG 卡自动用原图做头像

联网补全

  • 导入知名 IP 角色且卡面信息不足时,自动检索官方/wiki 资料补全空缺分节与设定,补充内容标注来源 URL
  • 卡上没有记录所属作品时,先让模型识别作品;认不出再在编辑器里问一句并记住答案
  • 可在设置里整体关闭

数据

  • 单卡导出(Markdown / SillyTavern JSON)、整库备份与恢复
  • 恢复同名卡可选:新建 / 跳过 / 覆盖
  • 审计日志(登录、卡片、导入、配置变更)
  • 注入预算 2000–60000 字符,超预算时按优先级裁剪

安装

需要 DeepSeek Harness 0.2.x(Web 端)。

方式一:本地 link(开发/自用推荐)

  1. 把 plugins/dsh-persona 放到任意目录;
  2. 在 Harness 里用插件管理器安装并指向该目录(install_bundle,source 记为 link:<绝对路径>);
  3. 启用插件,重启应用(宿主半只在启动时加载)。

方式二:从 Git 仓库安装(固定提交)

plugin_manager install_bundle
  target: git+https://github.com/Nico233333/dsh-persona.git#b1a4e58e385e52e4dfcc9bfd6c25cd95aa7af841&path:/plugins/dsh-persona

# 后面是 40 位提交 SHA(固定版本,避免拉到未发布的改动);path: 指向仓库里的插件目录。 需要 pnpm 能通过 https 读取该仓库。

方式三:DSH 插件市场(发现)

DSH 不内置任何索引源;先启用「实验性插件」里的 自定义插件索引,再到 发现 → 添加索引源 填:

https://raw.githubusercontent.com/Nico233333/dsh-persona/main/market/index.json

索引只做展示与固定版本安装:条目指向本仓库 b1a4e58 的 plugins/dsh-persona, 不含任何构建脚本;安装前的确认框会显示 Git 仓库、提交与目录。

快速开始

  1. 重启后,左侧栏出现 人格 图标;
  2. 进入「登录」,在输入框里输入 祀 并回车(或直接粘贴一段人格设定);
  3. 回到任意对话,输入框左侧的状态片会显示这个名字;
  4. 下一轮开始,模型就按这个人格说话。

卸载:人格页「登录」tab 顶部点「卸载」,所有对话回到默认身份。

界面导览

Tab 作用
登录 当前挂载卡、输入框(名字 / 原文 / 文件)、卸载
卡片 新建 / 导入 / 搜索 / 标签 / 排序;每张卡:挂载、编辑、导出、删除;多选批量删除、组合卡
草稿 导入或拆图产生的草稿:编辑、保存并挂载、删除、全部保存
设置 注入预算、子代理继承、联网补全、审计、备份与恢复、最近活动

编辑器:左侧六分节 + lore 列表,右侧实时预览;「历史」查看/恢复旧版本;「联网补全」补全空缺;「复制开场白」直接拿去对话里用。

配置

设置页写入 ~/.dsh-persona/config.json:

字段 默认 说明
maxRenderedChars 12000 注入预算(2000–60000 字符),超出按优先级截断
inheritToSubagents false 子会话(subagent / teammate / workflow)是否继承当前人格
enrichFromWeb true 导入/补全时是否联网检索官方资料
audit true 是否写审计日志 audit.jsonl

数据目录

~/.dsh-persona/
├── state.json        当前挂载(唯一全局状态)
├── config.json       注入预算 / 继承 / 联网 / 审计
├── stats.json        使用次数
├── audit.jsonl       审计日志
├── personas/*.md     正式卡
├── drafts/*.md       草稿
├── history/<id>/     卡片历史版本(每卡最近 10 版)
├── sources/*.raw     导入原文
├── images/           拆图/头像原图
├── avatars/          头像文件
└── splits/*.json     插画拆分计划(背景 + 每个角色的 bbox)

备份 / 迁移:设置页「导出备份」得到一个 JSON;恢复时同名卡按策略处理。

隐私与安全

  • 挂载权在用户:模型没有 login / delete 工具,HTTP 写接口只接受带自定义头的同源请求;
  • 人格是数据:注入文本有固定边界标签与固定声明,卡片不能声明“忽略以上规则”;
  • 路径受限:所有卡片路径限制在 ~/.dsh-persona/**,拒绝 .. 越界;
  • 不执行代码:卡片正文只作为文本渲染,不做模板求值;
  • 网络:只有“联网补全”和“识别作品”会访问外部检索,可在设置里关闭;
  • 原文隔离:sources/ 只存原文、不参与注入、不自动外发。

兼容性

  • DeepSeek Harness 0.2.x(Web / Desktop)
  • 客户端依赖 @deepseek-ai/dsh-client-ui-conversation、@deepseek-ai/dsh-client-ui-settings
  • 宿主依赖 systemPrompt、tools、webServer、llm、web、agentDefaultModel(缺 llm/web 时自动降级:不整理、不联网)

开发

cd plugins/dsh-persona
node test-smoke.mjs     # 解析 / 存储 / 渲染 / 历史 / 草稿 / 角色卡校验

目录:

plugins/dsh-persona/
├── index.js          Host 半:存储、提示词段、HTTP 路由、agent 工具
├── client.js         Client 半:状态片、人格页(登录/卡片/草稿/设置)、编辑器
├── lib/cards.js      卡片格式、解析/序列化、注入渲染
├── lib/store.js      用户级存储:状态、配置、历史、导入导出、审计
├── lib/ingest.js     文件嗅探与格式解析(docx / pdf / epub / odt / html / rtf / zip / png)
├── lib/zip.js        最小 ZIP 读取(docx/odt/epub 复用)
├── lib/png.js        PNG 文本块(SillyTavern 卡)
├── lib/docx.js       DOCX 文本抽取
├── test-smoke.mjs    冒烟测试
└── locale/           插件元数据(中/英)

文档

  • 更新日志
  • 架构说明
  • 历史设计记录(内部迭代日志,行为以 README 为准)

License

MIT © 2026 Nico

—/ 5

No ratings yet

Manifest verification required

Commit 965d78ce0cbe

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout