1. 龙芯装 AI 应用的老问题为什么需要芯语 CAP 这个商店先说一个我自己的经历。去年帮朋友折腾一台龙芯 3A6000 的迷你主机系统是统信 UOS 龙芯版装完系统后第一件事想装个 AI 对话工具给家里老人玩。结果打开软件商店搜AI出来的都是些网页版快捷方式真正能本地跑的、基于大模型的应用一个都没有。想去网上找 Linux 版的 AI 工具下载页一看到 x86_64 的包就傻眼龙芯的 LoongArch 架构根本装不了。最后折腾了一晚上装了个 Python 环境对着 GitHub 上的开源项目编译了半天依赖冲突解决到凌晨才算跑起来一个命令行版的模型。这段经历其实暴露了龙芯用户现在最头疼的问题硬件性能已经够用了但能用的 AI 软件生态实在太少。普通用户不可能人人都会编译源码、手动配依赖、改环境变量。大家要的很简单就是打开商店、点安装、直接能用。芯语 CAP 这个 AI 应用商店瞄准的正是这个缺口。它的定位是面向龙芯平台的一站式 AI 应用分发入口把对话助手、AI 绘画、文档处理、本地知识库这类常用 AI 工具做成经过适配的安装包让龙芯电脑的用户像在手机应用商店里装 App 一样装 AI 软件。这篇文章就是写给第一次接触龙芯、又想用上 AI 应用的新手。我会按照自己实际摸索的顺序把从系统检查、安装商店、首次配置到日常使用、问题排查的完整过程写清楚包括那些官方文档里不太会提的坑。如果你手里正好有一台龙芯电脑或者正准备入手这篇文章可以直接当操作手册来用。2. 安装前的系统体检确认架构、系统版本与硬件底线别急着下载安装包。我在踩过几次坑之后养成了一个习惯先在终端里跑几条命令确认机器的底子到没到要求。这一步花不了五分钟但能挡住后面百分之八十的莫名其妙的问题。2.1 先确认是不是 LoongArch 架构芯语 CAP 的安装包是专门为龙芯平台编译的最核心的区别就在 CPU 指令集上。龙芯现在主流的 3A5000、3A6000 处理器用的是 LoongArch 架构这个架构和常见的 x86 不一样和 ARM 也不一样。你可以理解成三种不同国家的插座标准插头长得不一样硬插是插不进去的。打开终端执行下面这行命令uname -m如果输出是loongarch64那就没问题说明系统是 64 位的 LoongArch 架构。如果看到的是x86_64或者aarch64那要停下来想想是不是装了个模拟器或者跨界版本的系统。少数龙芯机器可以运行 x86 翻译层但在翻译层上跑大型 AI 应用性能损失很大而且依赖库容易出乱子不建议在这上面装 AI 商店。2.2 系统版本和桌面环境的要求芯语 CAP 在龙芯的几个主流系统上都做了适配包括 Loongnix 24龙芯官方系统、统信 UOS 龙芯版、银河麒麟龙芯版。理论上这三类系统的用户都能直接装但我建议优先选择 Loongnix 24 或统信 UOS 的最新版本因为这两者对新硬件的驱动支持更及时桌面环境也更新。查看系统版本可以用cat /etc/os-release另外要注意桌面环境。芯语 CAP 的图形界面是基于 Qt 开发的Gnome 和 KDE 桌面都没问题但如果是那种极度精简的服务器版系统没有装桌面环境那商店本身可以运行但商店里的 AI 应用可能需要图形界面才能操作建议还是用带桌面的系统版本。2.3 内存、磁盘和算力的底线这一点必须说实话。AI 应用商店本身是个很小的程序几百 MB 的安装包但里面装的 AI 应用是重量级选手。大语言模型类的应用模型文件动辄几个 GB 到十几个 GB加载到内存里运行时建议至少 16GB 内存32GB 会更从容。如果你的龙芯机器只有 8GB 内存也不是完全不能用但跑大模型的时候会很吃力输出一个字一个字往外蹦体验不太好。这种情况下可以优先选商店里标注轻量版或小模型的 AI 应用。磁盘空间也是容易被忽略的点。装商店本身只需要几个 GB 的空间但后续模型下载、缓存、日志都会占地方。我给的建议是根目录或 home 分区至少预留 50GB 空闲空间。检查磁盘空间用df -h如果有 NVIDIA 显卡或者国产的加速卡之前装过对应驱动那在商店里会看到有GPU 加速标识的应用这些应用在推理速度上会比纯 CPU 快不少。如果没有独立显卡也没关系芯语 CAP 里的轻度应用在龙芯 3A6000 上用纯 CPU 也能跑就是响应慢一些作为尝鲜完全够用。2.4 网络和软件源检查安装过程中需要从服务器下载应用包和模型文件网络通不通很关键。在终端跑ping -c 4 store.loongnix.cn如果延迟正常、没有丢包说明网络通畅。如果你用的内网环境需要代理配置注意在系统设置里把代理地址填好否则下载到一半会卡住。另外提醒一件事芯语 CAP 的下载源在国内不太存在海外线路绕路的问题只要宽带正常下载速度一般都能跑满。3. 安装全流程获取安装包、执行安装与验证做完体检就可以正式安装芯语 CAP 了。整个过程我分成三步拿安装包、执行安装、验证结果。每步我都会写清楚命令和判断标准。3.1 从哪里拿安装包才靠谱新手容易犯的错就是去搜索引擎乱找下载链接结果下到一个来路不明的包。装软件这件事来源比版本新旧更重要。芯语 CAP 的官方安装包目前主要通过两个渠道分发龙芯官方软件仓库在 Loongnix 和统信 UOS 的默认软件源里搜索xinyu或cap通常能找到。芯语官网的下载专区提供对应系统的.deb包适用于 debian 系、统信 UOS和.rpm包适用于银河麒麟、其他 rpm 系。我一般优先用软件仓库装因为仓库里的包会跟着系统源自动更新。如果仓库里暂时没有再官网手动下载。下载页上会区分LoongArch64和别的架构的包看清楚再点。有少数情况下载下来的是个.tar.gz压缩包那属于便携版解压后直接运行二进制文件就行不需要安装但我们不建议新手优先用这种形式因为它不写环境变量、不创建桌面快捷方式后续管理麻烦。3.2 deb 和 rpm 包的区别与安装命令龙芯平台上系统分两派统信 UOS 和 Debian 系用 deb 包银河麒麟和 Fedora 系用 rpm 包。你在终端里拿到安装包后用对应的命令安装如果是 deb 包sudo apt install ./xinyu-cap_*.deb注意前面加./否则 apt 会以为你要从软件源里找同名包。我见过不少人卡在这一步提示找不到软件包就是因为忘了写路径。如果是 rpm 包sudo dnf install ./xinyu-cap_*.rpmdnf 会自动解析依赖并安装。安装过程可能会提示需要额外依赖比如libqt5-*、pyqt5之类的图形库直接选择继续即可。系统如果没有配置好软件源可能出现有未满足的依赖关系的错误。这时候不要再硬装先检查源的配置。一个快速解决办法是安装gdebi对 deb 系系统来自动拉取依赖sudo apt install gdebi sudo gdebi xinyu-cap_*.debgdebi 会尝试从已配置的源里补全所有依赖处理体验上比 dpkg 裸装顺滑很多。3.3 安装包是否适合你的具体系统版本同一个 LoongArch 架构下不同的 glibc 版本也可能导致软件装上了却打不开。如果你的系统比较老比如三年前的 Loongnix 20芯语 CAP 新版本要求的 glibc 版本高于系统自带的那你需要先升级系统组件或者下载一个兼容老系统的旧版本安装包。判断 glibc 版本ldd --version正常来说系统会在安装时自动帮你检查依赖。如果报错信息里有GLIBC_2.34 not found这种字样就说明系统底座太旧建议先跑一遍系统更新sudo apt update sudo apt upgrade3.4 安装成功与否的三步验证法装完不是看到安装成功四个字就完事了。我习惯按三步验证确保商店真的能跑起来。第一步确认命令能调用which xinyu-cap能看到路径说明二进制安装到位了。第二步启动图形界面xinyu-cap 观察窗口是否弹出如果没弹去终端看报错信息。第三步检查日志目录。芯语 CAP 的日志一般放在~/.config/xinyu-cap/logs/或~/.cache/xinyu-cap/下打开看一眼有没有ERROR级别的记录。没有报错安装这关就算过了。4. 首次使用配置账号登录、模型路径与算力适配商店装好了接下来要做的是打开后的首次配置。这一步很多人会忽略直接进去就搜应用、点安装结果模型下载了一大半跑起来又报错。核心问题是没搞清商店引导页让填的每一栏是什么。4.1 引导页做了哪些事首次启动芯语 CAP会先进入一个设置引导界面。这里不是让你填各种隐私协议然后直接进主页而是让选择 AI 运行环境。具体来说有几项模型下载目录默认是~/AI/Models建议直接放在磁盘空间最大的分区最好不是系统盘。原因是大模型文件动辄几个 GB如果系统盘分区不够大很容易写满导致应用崩溃。数据缓存目录默认在~/.cache/xinyu-cap这个可以不改。运行模式通常有CPU 模式和GPU 模式选项后面会细说。这一页填完商店会根据你选的目录自动创建文件夹、配置环境变量并把结果写入~/.config/xinyu-cap/config.json。配置文件之后可以再改但提前一次填写对头能省掉后面很多搬移文件的时间。4.2 模型路径为什么要单独讲模型路径是新手最容易踩坑的地方。商店里的 AI 应用本身不大真正占空间的是应用下载到本地的大模型文件。龙芯平台的软件生态还在建设期很多应用允许你自己指定模型来源而不是商店把模型完全托管在服务器上让你直接下载。举个例子商店里有个聊天助手应用你点安装后可能只装了 200MB 的程序然后应用打开时会提示请指定模型文件路径。如果你之前刚好在网上下载过某个开源模型的 GGUF 文件路径填对就能直接用。如果没有商店也提供模型下载入口但这要求你在引导页预留的磁盘空间足够大。配置模型路径时要注意写绝对路径不要写~/这种相对符号。有些应用对路径解析不完善遇到波浪号会把模型文件放在一个奇怪的地方找也找不到。正确写法类似/media/data/Models/chat_model.gguf另外如果你把模型放在移动硬盘或 U 盘上而应用是在商店里直接启动的可能会因为系统环境的权限规则访问不到移动设备。这种情况下建议把模型复制到本机磁盘的目录里别偷懒用外接存储。倒不是技术上不支持而是权限和挂载时机会带来一些莫名其妙的麻烦。4.3 纯 CPU 跑还是挂加速卡怎么选龙芯平台上的 AI 推理主要分三种情况纯 CPU 运行龙芯 3A6000 的算力应付小模型比如 1B-3B 参数的量化模型还行。8GB 内存也能跑但加载模型花的时间长一些对话响应偏慢。适合体验环境。显卡加速如果你的机器装了 NVIDIA 显卡驱动商店在启动检测到显卡时会自动启用 GPU 模式。按龙芯机器的定位这类配置比较少见但确实有玩家这么折腾过。国产加速卡部分整机厂商会搭配国产 AI 加速卡如寒武纪、登临等。商店对这些加速卡的适配还在推进中如果检测到可用算力设备会在设置页显示出来。我自己的建议是刚开始用不要纠结用 CPU 还是 GPU。先把 CPU 模式跑通一个应用确认整个链路没问题再考虑加速方案。加速配置会引入驱动、兼容性、显存等多个变量一来就上 GPU 模式出问题时会很难判断是应用的问题还是驱动的问题。4.4 账号登录和数据安全第一次使用商店里的部分功能比如云端模型同步、付费应用购买可能需要手机号或邮箱注册登录一个芯语账号。注册流程很常规填手机号收验证码就行。但我建议一个原则不需要账号就能用的功能尽量先用免费的本地应用。原因不只是省钱主要是本地应用的数据完全存在你自己电脑上对话记录、绘画素材都不会上传到云端隐私方面更稳妥。商店设置里通常有数据存储位置和日志上报两个选项。第一次配置时可以把日志上报关了日志等级调成错误既不影响排障也减少无谓的磁盘写入。5. 从商店装应用的实战经验与高频操作配置完成进入商店主页这里才是真正的重头戏。我按自己的使用习惯从搜索、安装、更新、卸载几个维度说说实际操作中要注意的事情。5.1 搜索和筛选别急着看热门推荐商店首页会有推荐位和热门排行但我建议新手先别急着点。真正效率高的方式是用搜索框直接搜你要的工具类型比如对话、绘画、翻译、知识库。我试过替代国外收费工具这类需求实际在商店里搜文档处理比搜办公出来的结果更精准因为后者会混入大量系统工具。搜索结果里每个应用会有几个标签CPU/GPU、模型大小、下载量、维护状态。注意看维护状态这一项。我见过有人装了个下载量很大的老应用结果打开后界面风格还是多年前的部分模型接口已经失效。优先选那些最近三个月内更新过的应用哪怕下载量小一点至少维护者还在跟进适配。5.2 一键安装背后的依赖处理机制在芯语 CAP 里点安装它做的事情其实比普通软件包管理器多一步它会检查应用需要的 Python 版本、模型框架、推理库等依赖如果系统缺失会一并拉取安装。这里有个经验安装过程中终端或商店界面会显示正在解析依赖、正在下载依赖包、正在安装模型文件三个阶段。依赖阶段卡住不动的情况偶尔发生多半是网络问题或源暂时不可用。这时候不要频繁点重试等一两分钟刷新再试更不要中途把商店关掉否则依赖装了一半应用处于半残状态后续想装别的应用也可能受影响。如果你平时用命令行比较熟练可以在商店安装完成后手动跑一遍这个应用的启动命令比如chat-assistant如果直接在终端里能起来说明依赖全齐了。如果提示缺什么模块用 pip 补齐对应依赖即可。商店帮你装了基础环境但这种临时补充依赖的行为在实际使用中是允许的。5.3 应用更新到底该不该跟着升商店有自动更新开关默认开着。我对自动更新的态度是可以开着但要分情况。小版本更新直接跟着走修复 bug、提升稳定性几乎无风险。但如果是大版本更新尤其是模型框架从旧版本迁到新版本可能会导致模型文件格式不兼容之前下载的模型要重新下。更新前可以看一眼更新日志以及应用详情页的兼容模型列表是否发生变化。我自己遇到过的情况是某绘画应用从 1.x 升到 2.x 后界面华丽了不少但旧模型的加载方式变了我原来调好的几个参数全部失效不得不重新配置一遍。所以对重度使用的工具我一般先把自动更新关了等看几天反馈再手动升。5.4 数据管理缓存和模型占空间的清理方式用了一个月之后我注意到磁盘空间涨得很快查了才发现是商店里的应用缓存占了大量空间。AI 应用会在运行过程中缓存推理中间产物比如对话历史、预处理后的图像数据、模型加载时的临时文件这些都在缓存目录里堆着。清理方式很简单商店设置里有缓存清理按钮或者手动删除~/.cache/xinyu-cap下的子目录。注意不要顺手把~/.config/xinyu-cap里的东西删了那里存的是配置信息删了之后你所有的登录状态、模型路径设置都没了。我吃过这个亏清理磁盘时误删了配置目录结果所有应用恢复成初始状态重新配置花了大半天。6. 新手排障清单常见报错与对应的处理思路最后一章我说几个新手最常见的报错场景。这些坑我都踩过或者说过别人踩过列出来给大家当参考。6.1 商店打不开图形库缺失或依赖残留症状是双击图标没反应或者在终端输入xinyu-cap提示scene之类的崩溃信息。最常见原因是安装过程中的某个依赖没装上尤其是 Qt 图形库。排查顺序如下xinyu-cap --version如果能输出版本号但图形界面起不来优先怀疑显卡驱动或显示服务器协议的问题。龙芯机器的显卡驱动有时会和 Qt 渲染有冲突解决办法是强制使用软件渲染QT_QUICK_BACKENDsoftware xinyu-cap这个命令能跑通的话就在系统的环境变量文件里加一行export QT_QUICK_BACKENDsoftware以后每次启动都不用再手动指定。6.2 下载模型到一半就失败模型文件体积大下载中断的原因可能是磁盘写满、网络波动、服务器连接超时。先看磁盘df -h确认空间足够后在商店设置里找到断点续传选项。如果你的版本没有这个功能建议在下载模型前先手动腾出比模型文件大 2 倍的空间因为你至少需要一份完整的缓存文件和一份加载用的模型副本。6.3 应用提示找不到模型文件这个问题几乎都是路径写错。打开应用详情页找到模型配置入口确认你填的路径指向的是实际存在的文件。可以先在终端验证ls -l /your/path/model.gguf如果你填的是~开头的路径有些应用不识别改成/home/yourname/...绝对路径基本就解决了。另外如果模型文件名里带了中文建议重命名成纯英文个别应用的加载代码对非 ASCII 字符处理不友好。6.4 用日志定位问题的标准流程最后说一个通用方法任何解决不了的问题先看日志。芯语 CAP 的日志目录一般是~/.cache/xinyu-cap/logs/里面按日期分文件。排查时直接看当天的日志tail -100 ~/.cache/xinyu-cap/logs/$(date %F).log日志里看到Traceback就往下翻找到最后几行一般就是真正的原因。如果是缺某个 Python 模块比如No module named PIL直接用系统的包管理器或 pip 装上sudo apt install python3-pil如果你自己搞不定去龙芯或芯语的社区论坛发帖把你的系统版本、CPU 型号、日志最后二十行贴上去这样别人才能快速帮你定位。发帖时不要只写不行打不开信息越完整越容易得到有效的回答。我自己走下来的整体感受是芯语 CAP 的价值不是让龙芯用户变成 AI 专家而是把那些只有在 x86 生态里才能顺畅运行的 AI 应用通过适配和封装带到了龙芯平台上。安装和使用过程中确实会遇到一些坑但大部分是生态早期的成长烦恼随着版本迭代体验只会越来越好。如果你是第一次在龙芯上玩 AI别贪多先装一两个轻量应用跑通流程再逐步尝试更大模型这个过程本身也是熟悉龙芯系统的好机会。