Starfire 是基于上游 cinnyapp/cinny 深度整理和扩展的 Matrix 客户端，面向中文使用场景持续优化。项目同时支持 Web 端和 Tauri 桌面端，桌面端产品名为 Starfire。

当前版本：1.4.0

这个仓库不是简单的界面汉化，而是在保留 Cinny 轻量、现代、模块化结构的基础上，补充了更适合中文用户和二次开发的能力，包括消息收藏、房间/联系人分类、圣经工具、AI 配置、桌面端能力、外观自定义、设备管理增强以及多处聊天体验修复。

• 支持密码登录、Token 登录、SSO 登录、注册和重置密码。
• 支持房间、私聊、空间、探索页、收件箱等核心视图。
• 支持文本、图片、视频、音频、文件、贴纸等消息内容。
• 支持回复、转发、消息搜索、媒体预览、URL 预览和通知提醒。
• 支持设备验证、密钥备份/恢复、已验证设备状态展示。

相关入口：

• src/app/pages/auth
• src/app/pages/client
• src/app/features/room
• src/app/features/search
• src/app/features/message-search

• 欢迎页、设置页、资料页、弹窗和常用提示文案已做中文整理。
• 项目信息、作者联系、版本说明和桌面端品牌信息已按当前仓库定制。
• 复制、搜索、菜单、成员入口、未读状态等高频聊天交互针对中文用户习惯做了修复和优化。

相关入口：

• src/app/constants/branding.ts
• src/app/constants/projectInfo.ts
• src/app/features/settings
• src/app/pages/client/WelcomePage.tsx

仓库内包含独立的消息收藏能力，不只是前端展示，而是带有状态与管理逻辑的业务模块。

• 支持将消息加入收藏 / 取消收藏。
• 支持独立收藏页与侧边栏入口。
• 支持按内容类型分类浏览。
• 支持备注、搜索、筛选和批量管理。
• 支持从收藏结果回跳原消息。

相关入口：

• src/app/features/favorites
• src/app/pages/client/favorites
• src/app/pages/client/sidebar/FavoritesTab.tsx

房间导航和私聊导航支持更快地找到重要会话。

• 支持将房间或联系人加入 收藏 分类。
• 支持创建自定义分类，并把房间或联系人加入指定分类。
• 支持从房间/联系人更多菜单中加入收藏、移出收藏、加入分类或移出分类。
• 首页房间、私聊聊天、空间房间列表都会显示收藏和自定义分类入口。
• 分类状态按用户保存在本地，避免不同账号之间互相污染。

相关入口：

• src/app/state/roomNavCategories.ts
• src/app/features/room-nav/RoomNavCategorySections.tsx
• src/app/features/room-nav/RoomNavItem.tsx
• src/app/pages/client/home/Home.tsx
• src/app/pages/client/direct/Direct.tsx
• src/app/pages/client/space/Space.tsx

• 消息搜索输入后，重置按钮恢复正常显示。
• 房间成员按钮恢复可用入口，避免点击无反馈。
• 消息弹窗里的复制消息按钮增加图标，视觉更清晰。
• 文本消息恢复浏览器默认选择与 Ctrl+C 复制能力，不再强制只能通过菜单复制。
• 已经在聊天底部看到最新消息时，会补充触发已读判定，减少“明明看到最新消息却还显示未读”的情况。

相关入口：

• src/app/features/message-search
• src/app/features/room
• src/app/features/room/RoomTimeline.tsx
• src/app/components/message

圣经工具是当前仓库中识别度较高的扩展功能，可与聊天输入联动。

• 支持圣经书卷、章节、经文浏览。
• 支持关键字检索。
• 支持旧约 / 新约 / 当前书卷 / 自定义范围搜索。
• 支持多节经文选择、复制和插入输入框。
• 支持从侧边栏和消息输入区调起。
• 本地经文数据来自仓库内置的 Bible1.csv。

相关入口：

• src/app/features/bible
• src/app/pages/client/sidebar/BibleTab.tsx
• Bible1.csv

• 支持主题色、气泡颜色、透明度调节。
• 支持经典 / 玻璃磨砂两套界面风格。
• 支持聊天背景图选择、压缩处理与账号级同步。
• 支持通过 Matrix account data 同步外观配置到同账号其他端。

相关入口：

• src/app/features/settings/general/AppearanceCustomizer.tsx
• src/app/state/appearanceAccountData.ts
• src/app/pages/client/ClientNonUIFeatures.tsx

• 当前内置 provider 为 aihubmix。
• 支持配置 API Key、Base URL、Models API URL。
• 支持技能列表配置。
• 技能支持命令、模型、系统提示词、上下文开关和事件数量限制。
• 配置支持本地存储，并可同步到账号数据。

相关入口：

• src/app/state/ai.ts
• src/app/features/settings/ai

桌面端基于 Tauri 2 构建。

• 支持自动检查更新与安装更新。
• 支持打开外部链接到系统浏览器。
• 支持任务栏未读角标。
• 支持桌面媒体缓存与资源预热。
• 支持本地 PIN 锁屏与账号级安全策略。
• 支持桌面窗口配置、资源协议和本地缓存目录隔离。

相关入口：

• src-tauri/tauri.conf.json
• src-tauri/src/main.rs
• src/app/utils/desktop.ts
• src/app/utils/desktopUpdater.ts
• src/app/utils/pinLock.ts

• React 18
• TypeScript
• Vite
• React Router 6
• Matrix JS SDK
• Jotai
• TanStack React Query
• Folds UI
• vanilla-extract
• Tauri 2

• Node.js >= 16
• 推荐使用较新的 npm
• 桌面端构建需要 Tauri 2 对应的本地依赖环境

npm ci

npm start

npm run build

npm run typecheck
npm run lint

npm run tauri
npm run desktop:build
npm run desktop:build:nsis

• config.json：服务端、探索页等运行配置。
• build.config.ts：子目录部署或构建路径调整。
• src-tauri/tauri.conf.json：桌面端应用和打包配置。

项目支持标准静态前端部署，可结合以下文件使用：

• Dockerfile
• docker-nginx.conf
• netlify.toml
• contrib/nginx
• contrib/caddy

桌面端更新源当前指向：

• 发布源：https://github.com/iszkq/cinny
• 更新清单：latest.json

• 本地设置主要通过 localStorage / IndexedDB 保存。
• 部分配置会同步到 Matrix account data。
• 当前已包含外观设置和 AI 设置的账号级同步逻辑。
• 房间/联系人导航分类保存在当前用户本地存储中。
• 桌面端会维护本地媒体缓存、emoji 资源缓存和运行时缓存。

相关入口：

• src/app/state/settings.ts
• src/app/state/appearanceAccountData.ts
• src/app/state/ai.ts
• src/app/state/roomNavCategories.ts
• src/app/pages/client/ClientNonUIFeatures.tsx

本项目基于 Cinny 继续开发，遵循原项目 AGPL-3.0-only 许可证。当前仓库用于中文定制、私有部署、功能扩展和桌面端分发维护。