Xian-JL/dsh-Kinich-theme

面向 DeepSeek Harness Web / Desktop 的 基尼奇（Kinich）& 阿乔（Ajaw）交互主题插件。

• GitHub：https://github.com/Xian-JL/dsh-Kinich-theme
• 分发方式：npm（GitHub Release 安装包可作备用）
• 当前正式插件版本：2.0.2（npm latest）
• 目标运行环境：声明兼容范围内的 DSH Web，以及桌面端 0.2.0-rc.2

本项目是独立社区插件，与 DeepSeek、HoYoverse 无官方关联，也不代表其认可或背书。

自定义背景支持自动配色，并提供 0%–100% 的背景可见度滑条（默认 75%）；数值越高，界面表面越通透，背景图片越清晰。

v2.0.2 提供复杂动态壁纸、壁纸包制作/管理/导入导出，以及按 Profile 保存的“启用动态壁纸”开关。普通背景不叠加说明文字，六个设置分区和三种风格可直接访问，设置等弹窗保持不透明。四项壁纸参数默认均为 50；关闭动态壁纸保留素材、参数和采色，静态背景与已有动效不受影响。本机已核实的宿主仍为 0.2.0-rc.2，未确认稳定版 DSH 0.2.0。详见 规格 1.0.7 和 维护发布说明。

2.0.2 起，DSH 与 settings peer 声明统一为 >=0.2.0-rc.2 <0.3.0，与 Xiao 一致；旧 0.1.x 声明移除，本机 RC.2 仍兼容。

安装

桌面端需先打开一次以初始化 Profile，然后完全退出。使用该桌面端安装目录内自带的 DSH CLI：

dsh plugin --profile desktop add dsh-kinich-theme@latest

安装后重新启动桌面端。Web 版使用下方命令。

dsh plugin --profile web add dsh-kinich-theme@latest

随后启动：

dsh web

普通用户无需克隆仓库、登录 npm、运行构建或安装 esbuild；npm 包和 Release 安装包均包含预构建的 lib/index.js 与 lib/client.js。

备用的 GitHub Release 安装方式：

dsh plugin --profile web add https://github.com/Xian-JL/dsh-Kinich-theme/releases/latest/download/dsh-kinich-theme-latest.tgz

更新

dsh plugin --profile web remove dsh-kinich-theme
dsh plugin --profile web add dsh-kinich-theme@latest

卸载

dsh plugin --profile web remove dsh-kinich-theme

Astra 优化版主要功能

Jungle 现代界面

• 以 Jungle 为当前唯一设计目标；旧版 Phlogiston / Sunlit 配置仍可读取，但不再参与本轮视觉设计。
• 欢迎页采用左侧编辑式文案、右上菱形基尼奇立绘、下沉输入框和右下阿乔构图。
• 保留原神式暖金细线、纳塔几何纹样和克制的雨林光感。

视觉强度

视觉模式之外，可独立选择 Minimal / Balanced / Immersive 三档表现强度。

Ajaw Companion 2.0

• Idle / Hover / Reacting / Dragging 状态。
• 根据 DSH 会话运行与完成状态反馈。
• 支持拖拽、镜像、旋转、复位。
• 聚焦阿乔后可用方向键以 8 px 步长调整位置；Shift 加速，Home 复位位置。拖动时位置即时跟随指针。
• 点击显示当前 DeepSeek 官方 API 账户余额，60 秒自动刷新。
• CNY 余额低于 ¥10 时，阿乔只发生两项变化：整体变红、动画速度翻倍；点击、拖动、情绪和会话反馈全部照常工作。
• API Key 只在 Host 侧解析，不会发送到浏览器。

原生 DSH 集成

• Sidebar Kinich/Ajaw 品牌区域。
• 空白会话 Hero 品牌视觉。
• 原生 Settings 设置项。
• DSH Semantic Token 实时覆盖。
• 动态环境效果，并支持 prefers-reduced-motion。
• 保存、余额手动刷新和会话反馈均有明确状态文字；发送状态来自真实会话快照。

设置入口

2.0.3-rc.3（2026-10-23）增加明暗配色预览和文字／按钮对比度保护，完善焚曜风格的菜单与代码底色，并补强图片导入、余额反馈的异步退出处理。候选版使用 npm next，不覆盖 latest；详见 开发记录。

2.0.3-rc.2 新增 API 余额 → 启用官方余额监控，按 Profile 保存，默认开启以保留既有行为。关闭后隐藏余额、停止自动与手动查询，并取消低余额红温加速；阿乔点击、拖动、待机与会话反馈继续可用。候选版使用 npm next，不覆盖 latest。

进入 Settings → Kinich，可调整：

• Jungle（旧模式只保留配置兼容）
• Minimal / Balanced / Immersive
• 基尼奇角色层
• 阿乔伙伴
• 纳塔边角装饰与纹理
• 动态环境效果

兼容性

v1.8.1 支持声明范围内的 DSH 版本及桌面端 0.2.0-rc.2：

@deepseek-ai/dsh ^0.1.5-rc.1 || ^0.1.6-alpha.1 || ^0.1.7-rc.2 || ^0.2.0-rc.2
Node.js ^22.19.0 || >=24.0.0

0.1.6 兼容层已适配新版 promptError、openError、lastAgentError 会话错误字段，并按 DSH 主视图实际保留的会话隔离阿乔反馈；旧版 0.1.5 会话快照仍可正常使用。

在 DSH 0.1.7 中，基尼奇设置使用 Profile 内的实时 Config 与 configForms API；余额监测在 Host 侧读取当前 DeepSeek 官方 API Key 提供者的配置。旧版 DSH 继续使用原有设置接口。

DeepSeek Harness 仍处于快速迭代阶段。未来 DSH API 发生变化时，请使用明确声明兼容对应 DSH 版本的 Kinich Theme 版本。

开发

npm install
npm run verify

源码位于 src/，使用 esbuild 生成 lib/ 中的 Host / Client 预构建运行文件。 桌面端视觉与动效规则见 docs/DESIGN_AND_MOTION.md。

素材与署名

详见 THIRD_PARTY_ASSETS.md。MIT 许可仅覆盖本项目原创代码和文档；第三方角色、图片、商标及视觉素材仍受各自权利和条款约束。

License

原创插件代码及文档采用 MIT License，详见 LICENSE。