前言¶
DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。在实际使用中，当需要管理多套角色设定、风格化 Agent 预设，或频繁切换人设时，依赖会话内的动态插件或手动维护配置文件往往效率较低。
Sidor_Character 是一个独立附属插件，它为 DSH Web GUI 提供了 SIDOR 人设卡管理能力。该插件支持批量导入、管理及即时应用到当前会话，或将其安装为 Agent 预设以实现持久化风格控制。它与主皮肤 Sidor_UI、工具箱 Sidor_box 互相独立，通过官方插槽接入，可共存。
核心功能¶
该插件提供以下功能：
- 批量导入人设卡：支持多选或拖拽导入
.persona.md主格式，以及酒馆角色卡 JSON / pack JSON。 - 人设卡管理：提供列表视图，支持查看名称、标签、简介及状态，支持应用、停用和删除操作。
- 应用到当前会话：通过官方
/api session.prompt接口向当前会话发送人设指令，即时生效，支持随时更换。 - 安装为 Agent 预设：将人设转化为用户 Agent 预设。安装新预设时会自动替换旧预设（单预设制）。
- 格式说明与模板：提供
.persona.md、酒馆卡、批量打包及 AI 转换提示词的教程与模板。
安装与启用¶
Sidor_Character 是一个静态持久化插件，安装到 profile 后会随 DSH 启动自动加载。
安装命令：
dsh plugin --profile web add <Sidor_Character 仓库路径>
安装完成后，需要重启 DSH 并在浏览器执行硬刷新（Ctrl + Shift + R）才能生效。
使用方式¶
批量导入与格式¶
插件支持导入 .persona.md 文件，该文件格式包含 YAML Frontmatter 和正文。正文部分即为人设指令，应用时发送，安装为预设时追加到 @deepseek-ai/dsh-persona 的 prefix 字段。
应用到当前会话¶
通过官方 /api session.prompt 接口向当前会话发送人设指令。这种方式适合快速测试不同人设，可随时启用或停用。
安装为 Agent 预设¶
将人设转化为 Agent 预设以持久化风格。系统会复制 standard 预设，并将人设正文追加到 prefix 字段（DSH 0.1.5+ 版本）或 text 字段（0.1.4 及更早版本）。由于采用单预设制，安装新预设会自动替换旧预设。
格式说明¶
插件内置格式说明与模板，用户可以直接参考或一键复制。
技术细节与限制¶
- 形态：静态持久化插件，安装到 profile 目录，随 DSH 启动自动加载。
- 数据存储：人设卡数据仅存储在浏览器
localStorage中。 - RPC 通道：插件无 host RPC 通道。当检测到
host.call不可用时，会自动降级为 Agent 代执行，通过官方/api发送指令由 Agent 完成文件操作。 - 共存性：与 Sidor_UI、Sidor_box 互相独立，官方插槽按
order排序共存。 - 单预设制：Agent 预设采用单预设制，安装新预设会覆盖旧预设。
- 重启要求：安装后必须重启 DSH 并硬刷新浏览器才能完全加载。
参考资料¶
- 仓库地址：https://github.com/AKI2253/Sidor_Character
- 插件目录：https://www.skillhub.cn/plugins/AKI2253/Sidor_Character
