前言¶
DeepSeek Harness (DSH) 的插件生态允许通过模块化扩展核心能力。dsh-cc-studio 是一个专注于角色卡 (CC) 开发的工具，旨在解决“只有点子，世界观薄弱”的问题。它将输入框上方的胶囊转换为全屏融合工坊，通过预设让 LLM 通过 14 个 Tool 进行交互，实现“先问再填”的共创流程。
功能概览¶
该插件提供以下核心能力：
* 胶囊融合工坊：将输入框胶囊转换为全屏工坊，提供更广阔的编辑空间。
* CC 模式预设：配合预设，让 LLM 通过 14 个 Tool 先提问再填入信息，辅助共创角色卡。
* 多格式导出：支持一键导出 JSON、PNG 或 CHARX 格式。
安装与启用¶
使用官方安装命令：
dsh plugin --profile web add @xia-sc/dsh-cc-studio
安装完成后，必须重启 dsh web 使其生效。
关于包名变更
包名由 @dsh-plugins/dsh-cc-studio 更改为 @xia-sc/dsh-cc-studio。如果之前安装过旧包名，请先卸载再安装新包名，否则无法正常加载。
配置与数据¶
插件的数据目录默认位于 <DSH_HOME>/cc-library/（角色卡）和 <DSH_HOME>/cc-drafts/（会话草稿）。DSH_HOME 默认为 ~/.dsh。从 0.3.6 版本起，插件开始识别 DSH_HOME 环境变量，但旧的 ~/.dsh 位置在 0.3.6 之前仍然可读。
CC 模式预设机制
插件随包提供了 CC 预设，无需手动拷贝文件。预设的加载方式取决于宿主 DSH 的版本：
* DSH >= 0.1.7-alpha.1：插件通过 presets/cc.patch.yml 的组合声明行注册预设，直接在会话模式中选择。
* DSH <= 0.1.6-alpha.2：插件启动时将 presets/cc 装载到 <DSH_HOME>/.agent-presets/cc 目录。
使用流程¶
- 在会话输入框上方找到胶囊图标，点击进入全屏融合工坊。
- 选择
CC 模式预设。 - LLM 会通过 14 个 Tool 进行提问，你需根据提示完善角色设定。
- 完成共创后，点击导出按钮，选择 JSON / PNG / CHARX 格式保存。
注意事项¶
- 权限：插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
- 会话保护：RPC 接口与资源地址受会话 cookie 保护。
- 资源鉴权：资源地址本身不走鉴权（如
/plugins/??@xia-sc/dsh-cc-studio/...），但访问 RPC 需要有效 cookie。 - 版本兼容：若使用旧版 DSH，需确保符合 <= 0.1.6-alpha.2 的目录安装要求。
