繁界 AngleNaris/fanframe

繁界 · FanFrame

繁界，意思是「繁星的域界」。这个插件对 DSH 桌面版的 UI 界面做轻度打磨，带来更舒适的日常交互体验。我为 DSH 带来了统一侧边栏，用来放置图标，给对话列表留出充足空间，同时避免插件随意摆放自己的图标造成混乱。此外，给对话正文增加了染色处理，让文字阅读更轻松愉快。最后，用冷峻的无圆角风格和大量细微的交互动画，增加一点小小的精致感。

界面预览

繁界使用截图（用户提供）

繁界宣传图（品牌视觉，非界面截图）

主要功能

- 直角外观。 统一界面的直角风格，调整侧栏会话标题的明暗层次。保留原生按钮和已有操作入口。
- 聊天阅读配色。 整理 Markdown 标题、强调文字、行内代码、引用与表格的配色。相关文字颜色跟随宿主的浅色或深色主题调整。
- 悬停与聚焦反馈。 为设置导航、输入框等控件补充状态反馈，保留设置项的当前选中态。沿用现有描边，不额外添加焦点外框。
- 短时动效。 为部分控件、浮层和折叠区域补充过渡，让新出现的任务列表、目标栏与本地发送回显淡入。保留宿主已有动效，历史消息不补播，新增动效尊重「减少动态效果」设置。
- 侧栏与插件列表。 整理窄图标栏布局，保留必要的滚动空间。插件列表支持搜索、恢复默认顺序，以及按名称升序或降序排列。
- 子智能体目录。 用鼠标打开目录时默认定位到末尾，开始手动浏览后不持续吸底，已有键盘焦点保持可见。可查询到模型信息时，用服务商与模型名替换对应目录项的摘要；无法查询时保留原生摘要。

版本与安装

当前测试版本为 1.10.0-beta.16，npm 包名为 fanframe。中文显示名为「繁界」，英文显示名为「FanFrame」。

在 DSH 插件管理器中添加 fanframe@1.10.0-beta.16，安装后启用插件。也可以使用 fanframe@beta 获取测试渠道版本。latest 标签独立维护，不代表稳定版。

兼容范围

- 安装兼容声明： DSH Desktop 0.2.1-rc.1 至 0.2.1-rc.6，包含两端，对应 >=0.2.1-rc.1 <=0.2.1-rc.6。
- 实际验证基线： 0.2.1-rc.3。其他版本尚未逐一实测，不能把声明范围理解为完整的逐版验证结果。
- 宿主依赖： 部分样式与目录功能依赖 DSH 的界面结构和兼容接口。宿主升级后可能需要适配，不保证各版本呈现完全一致。

Desktop 0.2.1-rc.3 更新提示： 宿主可能缓存旧的客户端注入版本。更新插件后先确认新版本是否生效；确需完整重载时，保存当前工作后正常退出并重新启动 Desktop，避免直接硬刷新页面。

从旧包迁移

fanframe 不是旧 fan-de-hai 的 npm 原位升级。已使用旧包时，请按以下顺序迁移：

1. 记录旧包版本，并保留回滚副本。
2. 禁用旧 fan-de-hai 插件或 bundle。
3. 安装并启用 fanframe，检查显示名称、图标和常用操作。
4. 确认正常后，再决定是否移除旧包。

不要同时启用两个包，也不要通过重命名安装目录来迁移。需要回滚时，先禁用 fanframe，再启用旧包。

使用边界

繁界调整的是已有界面的呈现和局部列表操作，不是模型接入、附件管理或图片查看器插件。它不替换原生图片查看器，也不宣称修复图片上传或存储问题。

同时使用其他修改全局主题、侧栏或浮层的插件时，样式可能互相覆盖。禁用或卸载繁界时，会清理插件自身添加的样式、监听、计时器和临时绘制层。

工程测试用于检查动效、清理与原生行为保留等实现约束，不能代替安装后的实际使用检查，也不是性能基准。分发包只包含运行文件、元数据、图标和必要文档，不包含工程夹具或本机审计资料。

FanFrame (繁界) means “Fanxing’s realm.” This plugin lightly polishes the DSH Desktop UI to make everyday interactions more comfortable. I have added a unified sidebar for icons, giving the conversation list plenty of room while avoiding the clutter caused by plugins placing their icons wherever they like. I have also added color styling to conversation text to make reading easier and more enjoyable. Finally, an austere, square-cornered style and numerous subtle interaction animations add a small touch of refinement.

Features

- Sharp corners: Apply a consistent angular appearance and adjust sidebar session-title contrast while retaining native controls.
- Chat styling: Refine Markdown headings, emphasis, inline code, quotations and tables, with text colors that follow the host's light or dark theme.
- Interaction feedback: Add hover or focus feedback to controls such as Settings navigation and the composer, using existing strokes without adding focus rings.
- 细微动效： 给部分控件、弹窗和展开区加上短过渡，新任务列表、目标栏和本地提交回显淡入。保留原生动效，跳过历史消息，新增效果遵循「减少动态效果」偏好。
- 侧边栏与插件工具： 打磨窄图标栏，新增插件搜索、默认排序，以及按名称升序或降序排序。
- 子代理目录： 指针打开的目录从底部开始，不持续覆盖导航，也不隐藏键盘焦点。宿主能提供时显示服务商/模型标签；否则保留原生摘要。

安装与兼容性

通过 DSH Plugin Manager 安装 fanframe@1.10.0-beta.16，或用 fanframe@beta 走 beta 通道。npm 包名是 fanframe，中文显示名为繁界。latest 标签独立维护，不代表稳定版。

声明的 DSH Desktop 引擎范围是 >=0.2.1-rc.1 <=0.2.1-rc.6，含两端。实际验证基线仍是 0.2.1-rc.3；该范围内其他版本未逐一测试。部分功能依赖宿主 UI 结构和兼容接口，因此不同 DSH 版本上行为可能有差异。

启用 FanFrame 前先停用旧版 fan-de-hai 包，并保留一份回滚副本，直到迁移验证完成。切勿同时启用两个包。在 Desktop 0.2.1-rc.3 上，确认更新后的客户端已加载；若需完整重载，先保存工作，再正常重启 Desktop，不要硬刷新页面。

FanFrame 不新增模型服务，不改消息内容和发送逻辑，不改附件存储，也不替换原生图片查看器。其他 UI 插件可能与其样式冲突。工程测试不构成完整的设备兼容矩阵，也不构成性能保证。

许可证

MIT。四点星与放射线图标随包分发。