SIDOR 人设卡 AKI2253/Sidor_Character

Sidor_Character · SIDOR 人设卡（独立附属插件）

DSH 插件 sidor-character cordis 静态持久化 MIT

版本导入单预设制

功能①批量导入功能②卡片管理功能③会话内应用功能④预设持久化功能⑤格式教程

关键词：deepseek-harness · dsh · dsh-plugin · cordis · persona · 人设卡 · 角色卡 · agent 预设 · settings.section · sidor

DeepSeek Harness Web GUI 的 SIDOR 人设卡（独立分发仓库，附属插件）。
与主皮肤 Sidor_UI、工具箱 Sidor_box 是互相独立的插件——可单独安装，也可并存，互不干扰（官方插槽 settings.section 按 order 自动排序共存）。

当前版本：v0.2.0 —— 批量导入人设卡 + 双通道应用（会话内即时 / Agent 预设持久化，单预设制）已落地。

一键安装（dsh 端）

懒人版

把你的 dsh 打开，对它说：

安装一下这个人设卡插件：https://github.com/AKI2253/Sidor_Character

说明：dsh 助手会 git clone / 读取该仓库并自动完成安装。

本地路径版（仓库尚未发布 / 已在本地）

复制以下整段内容发给 dsh 助手：

【任务】请为 DSH（DeepSeek Harness Web GUI）安装 SIDOR 人设卡插件（sidor-character，静态持久化形态）。

【插件来源】
- 本地仓库路径：E:\DeepSeek Harness\Sidor_Character

【执行步骤】
1. 校验仓库完整性：确认 package.json、lib/client.js、lib/index.js、cordis.patch.yml、scripts/install.ps1 都存在；
2. 运行安装脚本（Windows PowerShell）： powershell -ExecutionPolicy Bypass -File "E:\DeepSeek Harness\Sidor_Character\scripts\install.ps1"
3. 校验安装结果：
- %USERPROFILE%\.dsh\profiles\web\node_modules\sidor-character\ 存在，且 lib\client.js 非空；
- %USERPROFILE%\.dsh\profiles\web\cordis.patch.yml 中已有 sidor-character 的 insert 条目（与 sidor-ui / sidor-box 等其他插件的条目并存，不得覆盖或删除其它条目）；
4. 若安装脚本报 Access denied / UnauthorizedAccess：如实向用户说明并请求批准权限后重试；或改用命令版：dsh plugin --profile web add "E:\DeepSeek Harness\Sidor_Character"；
5. 汇报结果，并提醒用户：重启 DSH，浏览器 Ctrl+Shift+R 硬刷新后生效。

【约束】
- 只写 %USERPROFILE%\.dsh\profiles\web 下的 package 目录与 cordis.patch.yml，不改其它文件；
- 禁止执行卸载（-Remove），除非用户另行要求；
- 若 cordis.patch.yml 已有 sidor-character 条目，视为已安装，只做覆盖拷贝，不重复追加。

命令版（需 pnpm）

cd
dsh plugin --profile web add
安装 = 复制包到 %USERPROFILE%\.dsh\profiles\web\node_modules\sidor-character
+ 在 profile 的 cordis.patch.yml 追加 - insert: {id: sidor-character, name: sidor-character}。
安装后重启 DSH，浏览器 Ctrl+Shift+R 硬刷新。

若此前装过动态形态（sidc-* 会话内插件），安装静态版并重启 DSH 后，动态插件随进程退出自动消失，不会冲突；静态版与动态版的设置（localStorage）共用同一批 key，一次填写即可迁移。

功能

| # | 功能 | 说明 |
| ① | 批量导入人设卡 | 多选 / 拖拽导入 .persona.md（主格式）与酒馆角色卡 JSON / pack JSON；浏览器内解析，冲突支持覆盖/跳过/重命名 |
| ② | 人设卡管理 | 人设卡列表（名称/标签/简介/状态），应用 / 停用 / 删除 |
| ③ | 应用到当前会话 | 经官方 /api session.prompt 向当前会话发送人设指令，立即生效、可随时换卡/停用（动态/静态形态通用） |
| ④ | 安装为 Agent 预设 | 人设 → 用户 agent 预设（复制 standard + 把正文追加到 @deepseek-ai/dsh-persona 的 prefix；DSH 0.1.5+ 字段名为 prefix，0.1.4 及更早为 text），新建会话时选用，持久生效；单预设制：安装新预设自动替换旧预设 |
| ⑤ | 格式说明与模板 | 分 tab 教程：.persona.md / 酒馆角色卡 / 批量打包 / AI 转换提示词，模板与示例一键复制 |

人设卡文件格式（.persona.md）

format: sidor-persona
version: 1
id: scholar-senpai
name: 知性学姐 description: 博学温柔的学姐，用浅显的方式讲解知识
tags: [温柔, 教育, 中文]
apply: preset

（人设正文：即应用时发送、安装预设时追加到 dsh-persona prefix 的人设指令）

示例见 examples/知性学姐.persona.md 与 examples/Yuki傲娇妹妹.persona.md；格式规范与实现方案见 docs/PERSONA_DESIGN.md。

静态形态说明

Sidor_Character 为静态持久化插件（install.ps1 安装到 profile，随 DSH 启动自动加载），无 host RPC 通道。依赖宿主的能力（安装/卸载 Agent 预设、读写 %USERPROFILE%\.dsh）由客户端在检测到 host.call 不可用后自动降级为「agent 代执行」——通过官方 /api （session.prompt queue）向 Agent 发出精确指令，由 Agent 完成文件操作后汇报。
人设卡数据只存浏览器 localStorage（sidor.character.prefs），动态/静态共用。

开发

| 文件 | 说明 |
| src/sidor-character-client.js | Client 半源码（插件函数体，动态/静态双形态共用） |
| scripts/client-wrapper.template.js | ModuleLoader bundle 模板（闭包注入 React / styles / host / harness；host.call 一律 reject 触发静态降级） |
| scripts/build-client.ps1 | 构建：源码内联 → lib/client.js（含 node --check 语法门禁） |
| scripts/install.ps1 | 安装 / 卸载（UTF-8 安全读写 patch，可与其他插件并存） |
| lib/client.js | 构建产物（提交进仓库作为分发输出） |
| lib/index.js | Host 半空壳（静态形态无 host RPC） |
| cordis.patch.yml | bundle 补丁声明 |
| docs/ | 设计方案 / 开发提示词 / 一键安装提示词 |

源码更新流程：

powershell -ExecutionPolicy Bypass -File .\scripts\build-client.ps1 # 重打 lib/client.js powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1 # 重装到 profile 重启 DSH + Ctrl+Shift+R

打包注意事项见 Sidor_UI 打包文档（同一条构建管线）。

未来规划

人设卡按「先试后装」设计：会话内即时应用适合快速体验，Agent 预设适合长期固定风格。
后续候选：PNG 内嵌酒馆卡、pack 导出、会话-人设自动绑定、人设模板库。

许可

MIT。SIDOR 品牌标识归本项目所有。