@kongxiangyiren/dhs-theme-plugin

DSH 主题管理插件（静态版）：在 设置 → 主题 提供主题大分类，内置两套主题， 支持上传自定义 JS 主题并一键切换，数据持久化在磁盘上（换浏览器不丢）。

功能

• 设置 → 主题 大分类（与"通用"平级）
• 内置主题：森林绿 / 海洋蓝（13 个 alias token 覆盖 + 质感特效 CSS：辉光、网格/波纹、暗角、霓虹光带）
• 上传自定义 JS 主题：__ModuleLoader__.load 格式单文件，支持 overrideTokens 改色、注入 CSS、slots 注册 UI 组件、require("react")
• 点击切换：上传主题出现在主列表，点一下即应用；切换内置主题自动停用上传主题；同一时刻只有一个生效
• 磁盘持久化：Host 半部注册 webServer 路由 GET/POST /api/theme-plugin，数据存放在 DSH home（~/.dsh/dhs-theme-plugin.json），浏览器无关

安装

包已装入：

~/.dsh/profiles/node_modules/@kongxiangyiren/dhs-theme-plugin/

启用补丁（~/.dsh/profiles/web/cordis.patch.yml）：

- insert:
    - id: "@kongxiangyiren/dhs-theme-plugin"
      name: "@kongxiangyiren/dhs-theme-plugin"

修改后需重启 web 应用让 loader 重新组合。

使用

1. 打开 设置 → 主题
2. 点击列表项切换：跟随系统 / 浅色 / 深色 / 森林绿 / 海洋蓝 / 已上传主题
3. 上传主题：点 选择 JS 文件，选一个主题脚本（见 examples/）
4. "已上传主题"区可查看状态（应用中/未应用）并删除

主题文件格式

上传文件必须是浏览器 bundle 格式（与 dsh.client 包相同）：

window.__ModuleLoader__.load({
  id: "my-theme",
  factory: (require) => {
    var module = { exports: {} };
    var exports = module.exports;
    function apply(ctx) {
      ctx.effect(() => ctx.theme.overrideTokens("my-theme", {
        "--dsw-alias-bg-base": { light: "#ffffff", dark: "#0f1115" },
        "--dsw-alias-brand-primary": { light: "#7c3aed", dark: "#a78bfa" }
      }), "my-theme tokens");
    }
    exports.apply = apply;
    return module.exports;
  },
});

apply 收到的迷你 ctx 提供：theme / slots / effect / on / once / timeout / interval / get / console； factory 内支持 require("react")。注意：上传的 JS 会在页面中直接执行，只使用可信文件。

示例

• examples/cyberpunk-theme.js — 黑底荧光绿终端风：网格、扫描线、霓虹光带、glitch
• examples/nekogirl-theme.js — 粉色猫娘风：粉色调、猫耳、樱花花瓣、喵酱按钮、输入框猫猫（演示 require("react") + UI）