前言¶
在 DeepSeek Harness（DSH）里开多个会话时，常见做法是换 Agent preset，或在系统提示里堆人设说明。Preset 绑定的是整套智能体（工具、插件、组合方式），会话创建后一般不能中途换；改系统提示又容易和已有上下文纠缠。若你只想让「这一通对话像耐心老师、下一通像直白的 Code Reviewer」，需要一层轻量、可随时切换的身份与风格配置。dsh-facet-cards 把这类需求做成「人设卡（Facet cards）」：小 JSON 描述是谁、怎么说话、怎么写代码，与任意 preset 叠加，并在 composer 旁用 dock 即时切换。
这是什么¶
dsh-facet-cards 是 DSH 插件，维护者为 GitHub 用户 13052293681-blip，在社区目录中归类为「趣味换装」。插件简介为：Facet cards (persona cards) for DSH sessions。它在不改动宿主系统提示词的前提下，为每个会话携带独立身份；在 Settings 里编辑卡片，在输入框旁的 dock 里切换，对话中途更换也不会清空上下文。项目 MIT 许可，当前 package 版本为 1.1.0，系 sildo466/dsh-character-cards（v0.1.0）的独立延续与重构。
与 Agent preset 的差别¶
README 用表格概括了范围：preset 管整只智能体，人设卡只管人格与风格；preset 在创建会话时选定且会话中通常不能换，人设卡随时可换；preset 用 YAML/文件编写，人设卡提供可视化编辑器；分享 preset 需安装包，分享人设卡只需一个 .dshcd 文件。
核心功能¶
以下能力均来自项目 README 与 package 描述，安装后可在 Settings -> 人设卡 与 composer 旁 dock 中使用。
- 按会话绑定人设：身份、语气、编码习惯、工作流与底线（Guardrails）分组编辑，保存后写入磁盘。
- Dock 式选择器：composer 旁紧凑 dock，可 pinned 某张卡、跟随全局默认，或选择「无卡」回到宿主默认人格。
- 分类与用量统计：卡片可分组、筛选；带使用计数并可排序，便于看出哪些 facet 真正在被用。
- 每张卡本地头像：列表与 dock 中可显示 per-card 本地图片。
- 导入 / 导出：单卡为
.dshcd；导出全部 生成facet-cards-backup-*.json合集，导入按钮同时支持单文件与该备份；冲突时 incoming 卡以新 id 导入而不覆盖。原 character-cards 插件导出的卡可原样导入；未知字段会保留。备份中的图片路径为本地引用，换机器需自行拷贝图片文件。 - 重新应用：保存不会静默改写已在跑的会话；使用中的卡会显示占用会话数，按 重新应用 将磁盘上的新版本推入这些 live session。
安装与启用¶
环境要求：DeepSeek Harness >= 0.2.0-rc.2，Node >= 22。
从 GitHub 安装（命令来自 README，<profile> 替换为你的 profile 名）：
dsh plugin --profile <profile> add github:13052293681-blip/dsh-facet-cards
桌面客户端：打开 Settings -> Plugins，从 GitHub 安装 dsh-facet-cards，然后重启应用。README 说明仅安装步骤需要重启；创建、编辑、切换卡片即时生效。
插件在 DSH 进程权限下运行；安装前建议自行查看 仓库源码 与 MIT 许可证。社区目录站点为独立生态入口，与 DeepSeek / 幻方无官方从属关系。
典型用法¶
- 打开 Settings -> 人设卡。
- 点击 新建卡片。
- 填写 facet：是谁、如何表达、如何工作（Identity、Voice、Code、Workflow、Guardrails）。
- 在当前会话从 composer 旁 dock 选中该卡，或设为新建会话的默认卡。
切换时对话上下文保留，仅身份层变化；可任意频率切换。若 preset 本身已是完整角色扮演人设，README 建议 preset 与人设卡二选一，叠加可能出现两套身份竞争。
适用场景与注意¶
适合需要在同一 DSH 环境里快速切换「教学 / 审代码 / 角色对话」等轻量人格，又不想为每种语气单独建 preset 或改系统提示的开发者。已知限制（README）：已在跑的会话保持启动时绑定的卡版本，直到 重新应用；界面目前为中文，卡片内容可用任意语言；桌面 profile 由客户端管理，安装与更新应在桌面客户端内完成而非 CLI。
