前言¶
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
