飞度密集架

飞度密集架产品线指带屏幕的智能密集架，用于沉淀屏幕端、固定列 / 移动列、更新服务、镜像、设备联动和智档宝集成相关资料。

图例

移动列屏幕与平台交互

多列屏幕端

屏幕端细节

产品线结构

当前定位

方向	说明
屏幕端主程序	固定列大屏、移动列小屏、Electron / Web 前端、设备状态展示和本地交互
更新与分发	固定列主程序更新服务、更新中心、安装镜像和交付脚本
平台交互	智档宝向屏幕端下发开架、取档、盘点等任务，移动列屏幕端回传状态、执行结果和异常信息
业务集成	智档宝前后端中的飞度密集架库区、架体、开架、状态回传和任务联动
设备控制	TCP Client、USB Serial、HTTP / WS 等协议接入与现场联调

核心仓库

仓库	作用	结构观察
fit-archive/fdmjj/fit-denserack	固定列主程序	electron、src、resources、docs、public，偏终端应用
fit-archive/fdmjj/fit-denserack-updater	固定列更新服务	main.go、system、dist，偏本地更新进程
fit-archive/fdmjj/fit-denserack-update-center	更新中心	用于固定列程序版本管理和更新发布
fit-archive/fdmjj/fit-mjj-iso	固定列镜像	airootfs、packages.x86_64、profiledef.sh，偏系统镜像构建
fit-archive/fdmjj/smart-doc-vault	智档宝密集架后端集成	mjj、mjjs、iot、iot_plugin、wsocket、service
fit-archive/fdmjj/fit-archive-ng	智档宝密集架前端 / 桌面侧	src、src-tauri、electron、docs

建议目录

飞度密集架
├─ 0-总览
├─ 1-产品视图
├─ 2-终端主程序
├─ 3-设备协议
├─ 4-更新与镜像
├─ 5-智档宝集成
├─ 6-现场部署
└─ 7-调试排障

先补哪些

优先级	文档	内容
P0	设备协议	FD-01、FD-06、TCP Client、USB Serial、HTTP / WS 的统一口径
P0	终端主程序	固定列程序启动、配置、更新、日志和常见问题
P1	更新与镜像	ISO 构建、更新服务、版本发布流程
P1	智档宝集成	库区、架体、开架、任务、状态回传的边界

图形化概念

XORG （X11，X Server） -> Wayland

• 客户端 - 服务端（渲染） 分离 -> 基于SSH协议的 X11 转发
• XWayalnd -> 性能开销 历史bug 驱动问题 xorg config
• https://wiki.archlinuxcn.org/wiki/Xorg
• https://wiki.archlinuxcn.org/wiki/Wayland
• DISPLAY=:0 / WAYLNAD_DISPLAY=wayland-1

为什么不用XORG ？ -> 显卡驱动兼容 老机器...屏幕撕裂（intel -> xrog-intel / mesa）

DISPLAY ENV/ DISPLAY Manager / Window Manager / Compoister

• https://wiki.archlinux.org/title/Desktop_environment
• https://wiki.archlinux.org/title/Display_manager
• https://wiki.archlinux.org/title/Greetd
• OpenBOX/i3/XFCE/KDE/KYLINDE/GNOME/META/SWAY/
• SDDM/GDM/LigthDM.... greet
• box,KWM, KWIN Mutter，i3

客户端

• Electron Wayland

输入法

• 多文 商业 https://www.dwinput.com/
• 麒麟 FCITX5 https://gitee.com/openkylin/kylin-virtual-keyboard
• https://gitlab.singzer.cn/fit-archive/fdmjj/dwime-wayland-bridge

虚拟显示屏/显示屏配置/显卡...

网络设置

nm-connection-editor

触摸

• sway -> 屏幕旋转后触摸没旋转 -> 改配置ok 但是容易失效 -> 改sway 源码.. -> 上游修复了
• 网络设置工具 -> gtk 写的， 触摸不友好 -> 修改了 Ipv4代理配置的方法 （下拉框改列表）

PulseAudio -> Pipewire (声音)

• https://wiki.archlinuxcn.org/zh-mo/PulseAudio
• https://wiki.archlinuxcn.org/wiki/PipeWire

pavucontrol

与固定列主板通讯

• 账号系统
• 架体信息
• WOL 网络唤醒

与平台通讯 （选配）

见智档宝-档案管理-库区章节

TTS / ASR

TTS 合成

• MPV -> 播放服务
• https://github.com/xeden3/MSSpeechServer / https://gitlab.singzer.cn/fit-archive/fdmjj/msspeechserver - 弃用 - wine/docker -> msiEXE ... -> HTTP-SERVER -> 性能差 开销大 不稳定 日志文件大
• https://github.com/huakunyang/SummerTTS -> http://172.16.146.138:8080/
• 其他语言 预合成 HK -> 讯飞的...

ASR 识别

• https://github.com/huakunyang/SummerASR - WAV一段一段 无法流式
• https://gitlab.singzer.cn/fit-archive/fdmjj/asr-service / https://gitlab.singzer.cn/fit-archive/fdmjj/asr-onnx-service -> ws ... http://172.16.146.138:8777/
• 文本判断 （研究nlp 语义分析 https://gitlab.singzer.cn/fit-archive/fdmjj/nlu-service）
• 硬件方案 -> 交互

网页远程 （8520）

• swayvnc （wayland） -> vnc协议 -> novnc -> web

?

• reframe （kms） -> vnc协议 -> novnc -> web (gpu)

sudo systemctl enable --now reframe-server@example.service reframe@example.socket

人脸识别

• https://github.com/icepie/FaceSimilarityService.git - 5000 端口

镜像打包

基于 archiso 工具打包

• https://gitlab.singzer.cn/fit-archive/fdmjj/fit-mjj-iso

https://wiki.archlinuxcn.org/wiki/Archiso -> https://github.com/gsanhueza/ArchISOMaker -> https://gitlab.singzer.cn/fit-archive/fdmjj/fit-mjj-iso

• 滚动： 注意上游的变化 - 考虑版本兼容
• 固定： https://archive.archlinux.org/repos/ archiso 固定 - 国内镜像源丢
• 自建源（运维）

镜像安装

• install.sh (.bashrc 默认检测到 tty1)
• install.log (报错)
• 安装过程 右边显示日志 -> tmux

架构

• ArchLinux Base
• 两个网口
  • 局域网
  • 板子通讯 - 172.16.10.10/24(固定列) - 172.16.10.11/24（板子）
• 默认账号密码
  • gg / 10010
  • root / 10086