xiao-ui-theme-ts

魈主题（Xiao UI theme）—— 一套给 DeepSeek Harness Web 界面用的主题插件： 青玉/翠青配色 + 吉祥物徽章 + 魈式语气 + 磨砂背景 + 设置页。

这是什么

把 DeepSeek Harness 的 Web 界面换上一套「魈」主题视觉，并在会话里可选地注入「魈式语气」， 让界面与助手口吻都带上魈的味道（仅语气风格，不改变回答内容）。

示例

功能

• 青玉配色：浅色 / 深色两套青玉色板，设置页可一键关闭。
• 吉祥物徽章：可拖动、可收起的小徽章（底部右侧）。
• 魈式语气：向系统提示注入一段魈式语气说明（可开关），语言可选中文 / 英文模板，也可填自定义提示词。
• 磨砂背景：可配置背景图（支持相对插件目录或本地绝对路径，也可直接上传），并调节模糊强度与浅/深色遮罩。
• 设置页：总开关、注入语气、模板语言、自定义提示词、头像路径、背景开关/路径/上传、模糊与遮罩滑块。

环境要求

• DeepSeek Harness（dsh 可用）
• Node.js（建议 ≥ 18）
• pnpm

在线安装（在线快速安装）：

1. 确保安装dsh命令
2. 执行以下

dsh plugin --profile web add https://github.com/jinxlux/xiao-theme-dsh-ui-plugin/releases/download/dsh-ui-plugin-xiao-0.5/xiao-ui-theme-ts-0.5.0.tgz

克隆源代码后安装（从 git clone 开始）

git clone <copied-repo-url>
cd xiao-ui-theme-ts

pnpm install       # 安装构建所需依赖
pnpm run build     # 生成 lib/（ESM Host + ModuleLoader Client + 声明文件）
pnpm run check     # 可选：校验产物是否符合 DSH 插件契约

然后把它作为 bundle 挂到 DSH profile：

# 相对路径（在仓库同级目录执行）
dsh plugin --profile web add "./xiao-ui-theme-ts"
# 或绝对路径
dsh plugin --profile web add "D:/.../xiao-ui-theme-ts"

dsh plugin add 会把包装进 profile，并因其 dsh.bundle 声明自动接入 bundle 层栈，无需手动改配置。 刷新 / 重启 DSH Web 后主题生效。

使用与配置

• 打开 DSH Web → 设置 → 魈主题 页：总开关、注入语气、模板语言、自定义提示词、头像路径、 磨砂背景开关/路径/上传、模糊与遮罩滑块。
• 改动即时生效，无需重启 DSH。
• 设置保存在 ~/.dsh/xiao-theme.json；上传的背景图保存在 ~/.dsh/xiao-theme-uploads/（用户级，不随仓库走）。

注意事项

• 先构建再挂载：lib/ 是构建产物、不入库。clone 后务必先执行 pnpm install && pnpm run build， 再 dsh plugin add；直接 add 未构建的目录会因缺少 lib/ 而加载失败。
• 默认头像 / 背景使用包内相对路径（resource/avatar.png、resource/bg.svg），跨机器可读； 构建后请保持 resource/ 与 lib/ 同层（当前结构成立）。
• 魈式语气提示词依赖 DSH 的 systemPrompt 组装。若所用 agent 预设会把提示过滤成只剩 persona， 或使用了 complete persona，该语气在对应会话可能不出现（这是预设行为，不是插件故障）。
• 本插件不读取环境变量做配置；设置只来自 ~/.dsh/xiao-theme.json 与编译期默认值。

版权与免责声明

• 代码：本仓库源码以 MIT 许可证开源（见 LICENSE），可依法学习、修改与分发。
• 图片：resource/（bg.svg、avatar.png，及用户上传的背景图）来自网络公开来源，仅作本主题的 演示 / 自定义用途。
• 人物形象 / 设定：魈（Xiao）、《原神》（Genshin Impact）的角色形象、名称、相关设定与美术素材的 版权归米哈游（miHoYo）所有。MIT 许可证仅覆盖本仓库代码，不涉及米哈游拥有的角色形象 / 设定 / 原创美术；含关联素材（resource/ 及主题展示）禁止私自商用或挪作他用。如需商用或再分发，请先取得 米哈游授权许可；移除或替换 resource/ 中的相关素材即可避开该版权约束。详见 LICENSE 中的 “Character Image & Setting Intellectual Property Notice”。