企业官网建设流程全解析

前阵子帮朋友在一台龙芯3A6000处理器的台式机上部署AI环境，把我折腾得不轻。先是在网上翻了两个小时教程，发现绝大多数都是针对x86_64或arm64写的，到了龙芯平台上总会在某个步骤卡住：要么依赖包装不上，要么干脆没有对应的二进制版本。后来我试了一圈“芯语CAP”这个面向龙芯平台的AI应用商店，一下子就走通了。所以今天这篇指南，就是把我从下载安装到实际跑起AI应用的全过程整理下来，给同样想在龙芯上玩AI的新手一个可以照着做的参考。我会尽量说清每一步为什么要这么做，以及哪些坑值得提前避开。

1. 为什么我会在一台龙芯机器上折腾“芯语CAP”这类AI应用商店

1.1 龙芯跑AI的尴尬：不是性能不够，是流程断了

龙芯处理器的算力其实没有想象中那么弱，特别是3A6000系列，单核性能已经可以跑很多日常应用了。可一旦涉及AI，你面对的问题就不是“CPU快不快”，而是“一个AI应用通常依赖一大堆底层库，比如BLAS、OpenMP、量化工具、推理运行时，这些库到底有没有对应的loongarch64版本”。很多主流AI工具默认只发布x86_64和arm64的安装包，放到龙芯平台上，要么用源码从头编译，要么就卡在某个依赖上。

“从源码编译”这句话听起来简单，实际会牵扯到Python版本、gcc版本、链接库路径、模型格式兼容等一系列问题。一个稍复杂一点的推理框架，编译依赖可能有三四十个，随便一个版本对不上就得重新来过。新手很容易在这里劝退。哪怕你咬牙编出来了，下一次框架升级又得重复一遍。这正是AI应用商店存在的意义：它把“应用、运行环境、依赖库、模型文件”打包成一个相对完整的分发体系，用户不需要知道底层每个库怎么编。

1.2 芯语CAP做了一件什么事

芯语CAP本质上是一个面向龙芯平台的应用商店，但它不是装普通Linux软件那种商店，而是专门解决“AI应用”这类特殊软件的分发问题。AI应用和普通软件最大的区别是：普通软件安装完就能跑，AI应用通常还额外需要一个模型文件，模型文件可能是几个GB甚至几十个GB，而且不同应用对运行时版本有严格要求。芯语CAP在后端把适配龙芯架构的运行时和常用模型打包成统一格式，你只需要在界面里点安装，剩下的模型下载、依赖校验、默认参数配置都由它代劳。

我第一次用的时候，有个很直观的感受：以前装一个聊天大模型，要自己处理的步骤至少包括准备Python环境、编译量化内核、下载模型、写启动脚本、调推理参数。在芯语CAP里，这些被压缩成了两步：选应用、点安装。页面会告诉你这个模型占多大空间、需要多少内存、推荐用什么线程数，而不是甩给你一堆技术名词。这种体验对普通用户来说确实友好很多。

1.3 谁适合看这篇指南

这篇指南的目标读者很明确：一是手头刚好有龙芯台式机、笔记本，想试试本地AI应用的人；二是对Linux有一定了解、但不想把时间浪费在源码编译上的效率党；三是单位或工作室里有一批龙芯设备，想批量部署AI工具而不是一台台手动调的运维朋友。如果你对命令行不熟也没关系，安装部分我会同时讲图形化和命令行两种方式，新手可以走图形化路线，有经验的可以命令行一把梭。

如果你还没搞清楚自己的设备是不是龙芯，下面第2节会先讲环境确认，建议花十分钟走一遍，后面能少踩很多坑。

2. 安装前的准备工作：先花十分钟确认你的环境

2.1 先确认架构和基本配置

我见过不少人在安装前没做环境检查，结果装完商店启动报错，还以为是安装包问题。其实只要提前确认好CPU架构、内存和系统类型，大部分问题都能预判。

先看CPU架构：

uname -m

返回loongarch64说明当前就是龙芯平台，后面所有安装流程都可以正常走。如果返回的是x86_64或aarch64，那你用的可能不是原生龙芯系统，或者是模拟环境，性能损耗会很大，不建议在这种环境下跑AI。

接着看CPU型号和内存：

lscpu | grep -E "Model name|CPU\(s\)|Architecture" free -h

内存这块我建议至少8GB，最好16GB。8GB内存跑一个7B量化模型比较吃力，不是完全不能跑，但系统会很卡。16GB基本能流畅运行7B模型，也能勉强试一下14B，只限于“能跑”。

2.2 磁盘空间必须提前规划

应用商店本身安装包不大，通常几百MB，但AI模型是按GB算的。以目前主流的量化模型为例，7B参数模型4bit量化后大约4GB，14B大约8GB，文生图模型小一点但也有2到5GB，OCR类模型比较小，几百MB就够。所以我建议系统盘至少预留20GB给模型缓存，最好准备一个独立数据分区专门放模型。这样系统盘满了不会影响系统运行，模型重装时数据也不用动。

检查磁盘剩余空间用：

df -h / # 看根分区 df -h /data # 如果有独立数据分区，看它的情况

如果剩余空间不足20GB，可以先清理旧内核、旧日志、apt缓存：

sudo apt clean sudo journalctl --vacuum-time=3d sudo apt autoremove --purge

这几个命令清理出来的空间往往比你想象的多。尤其是journalctl，日志文件动不动就占好几个GB。

2.3 软件源和网络连通性检查

芯语CAP的安装和模型下载都需要联网。安装前可以简单测一下能不能正常访问软件源：

ping -c 3 cap-store.example.com

如果ping不通，先检查DNS和网关，再看是不是防火墙拦截。很多龙芯设备出厂系统会做一定程度的访问控制，需要你在系统设置里把对应域名的访问放开。这里不展开太多，只提醒一句：不要在离线环境下安装商店，因为商店首次启动就要拉取应用清单，没有网络会直接卡在初始化界面。

如果你所在的网络环境访问软件源很慢，可以试试把系统DNS改成公共DNS再重试，很多“拉取超时”其实是DNS解析引起的，不一定真的是网络不通。

2.4 更新系统与安装基础依赖

在安装芯语CAP之前，我建议先把系统更新一遍，避免因为底层库版本太旧导致兼容问题：

sudo apt update && sudo apt upgrade -y

更新完成后，安装几个通用依赖，后面解包和部署都会用到：

sudo apt install -y curl wget gnupg ca-certificates python3 python3-venv

python3-venv可能有些朋友觉得多余，但很多AI应用会在自己的目录里创建虚拟环境，避免和系统Python冲突，提前装好能省很多事情。

如果你执行apt时遇到“软件源索引更新失败”，多半是源列表里有无效条目。先跑一句sudo apt update看具体报错，哪条源报错就注释掉哪条，不用全删。这个排查思路比直接重装系统靠谱得多。

3. 安装芯语CAP的两种方式：图形安装包与命令行部署

3.1 方式A：图形安装包，适合新手

官方Releases页面会提供针对loongarch64的安装包，文件名类似xinyu-cap_1.2.1_loong64.deb。新手建议直接下载这个包，然后双击，桌面环境的软件中心会弹出一个安装界面，点“安装”等它跑完就行。

如果你更习惯用命令来装，下载后执行：

sudo dpkg -i xinyu-cap_1.2.1_loong64.deb

这里有个细节必须提醒：dpkg -i返回成功不代表依赖已经齐全。dpkg只把deb包解压并登记到系统里，不会自动去软件源拉依赖。如果安装过程中报“依赖关系不满足”，接着执行：

sudo apt -f install

这条命令会修复依赖关系，自动补齐缺失的包。我头几次装这类deb包时不理解为什么还要多跟一条命令，后来才明白这是dpkg和apt各司其职的典型例子。新手看到dpkg -i报错不要慌，先跑修复命令，绝大多数情况都能解决。

3.2 方式B：通过软件源安装，适合批量部署

如果手上有多台龙芯设备，一台台下载deb包太折腾，直接把芯语CAP的软件源加到系统里，之后所有设备的安装和升级统一走apt，管理会轻松很多。

添加软件源：

sudo sh -c 'echo "deb [arch=loong64] https://cap-store.example.com/loong64 stable main" > /etc/apt/sources.list.d/xinyu-cap.list'

导入GPG密钥：

curl -fsSL https://cap-store.example.com/key.asc | sudo gpg --dearmor -o /usr/share/keyrings/xinyu-cap-archive-keyring.gpg

更新软件源并安装：

sudo apt update sudo apt install xinyu-cap

这种方式最大的好处是以后升级不用再手动下包，sudo apt upgrade就能一并解决。不过在第一次添加源之前，记得确认你的发行版是否支持deb [arch=loong64]这种按架构限定源的写法，绝大多数基于apt的龙芯系统都支持。

3.3 安装完成后的启动与确认

安装完成后，先确认版本号是否正确：

xinyu-cap --version

如果命令提示找不到，不要急着重装，先看看/usr/bin或/usr/local/bin下有没有对应的可执行文件，因为不同发行版安装到不同目录的情况太常见了。

图形界面启动方式有两种：

xinyu-cap-store

或者在系统开始菜单里搜索“芯语CAP”。首次启动会进入初始化向导，别直接关掉，下一节我会详细讲每个选项怎么选。

4. 首次启动与基础配置：把商店调到“能用的状态”

4.1 初始化向导会问什么

首次启动时芯语CAP会弹出一个初始化向导，一般会问四个问题。第一个问题是“数据存储目录”，这个对应刚才说的模型缓存，我强烈建议选一个空间充足的分区，不要在默认的home目录里硬挤。第二个问题是“运行时检测方式”，一般选“自动探测”，让商店扫描系统里已有的AI运行时；如果你清楚自己需要哪个运行时，也可以选手动指定。第三个问题是“模型下载通道”，默认选主通道就行，备用通道通常在网络异常时才用。第四个问题是“是否开机自启”，个人建议关掉，因为AI应用不像浏览器，没必要开机就常驻。

这里的每个选择都会写入配置文件，后面想改随时可以改，不用怕选错。

4.2 配置文件中的核心参数

配置文件默认在~/.config/xinyu-cap/config.toml。如果你用了XDG_CONFIG_HOME环境变量，位置会跟着变。初次配置完，文件内容大概是这样的：

[store] data_dir = "/data/xinyu-cap" language = "zh-CN" [model] download_threads = 4 max_cache_size = 20 [device] type = "auto" max_threads = 4

几个字段说明一下：

• data_dir：模型和应用数据存放目录，尽量放独立分区。
• download_threads：模型下载线程数，4到8都行，宽带够大可以调高。
• max_cache_size：模型缓存上限（单位GB），防止多个模型把磁盘撑爆。
• device.type：设成auto会让商店自动适配CPU；如果你后续想外接其他加速设备，再改成对应名称。

有经验的用户可以直接改配置文件，新手建议先通过界面设置改，配置文件用来排查问题更合适。

4.3 绑定一个AI运行时

这一点是芯语CAP和普通软件商店最大的不同。商店里每个AI应用都依赖一个运行时，比如llama.cpp适配版、ONNX Runtime适配版等。首次启动后，你要先到“设置-运行时”里看一下，如果显示“未安装运行时”，点一下“安装推荐运行时”，等它下载完成。

为什么要单独做这一步？因为同一款模型可能兼容多种推理框架，商店如果把运行时和应用打包在一起，更新会非常频繁。让运行时作为独立组件先安装好，应用层只负责声明“我需要哪个运行时”，商店在安装应用时再匹配版本，这个解耦思路我认为是合理的。

绑定操作本质上是把运行时路径写进配置文件。打开“运行时管理”，如果列表里出现一个或多个运行时，状态显示“可用”，说明绑定成功。有些用户会跳过这步直接装应用，结果应用一直启动失败，页面也不提示原因，其实原因就是运行时没绑定。

4.4 配置过程中容易踩的坑

先说最典型的一个：提示“数据目录不可写”。这通常是因为你选了一个需要root权限才能写入的目录，但商店进程是以普通用户身份运行的。解决办法很简单，把目录所有者改成当前用户：

sudo mkdir -p /data/xinyu-cap sudo chown -R $USER:$USER /data/xinyu-cap

第二个坑是“未找到可用运行时”。你以为装完了运行时，但商店没识别到。原因可能是运行时版本太新或太旧，不在商店的兼容列表里。解决方法是在运行时管理里点“重新扫描”，如果还不行，卸载运行时，重新用商店的“安装推荐运行时”装一遍，不要自己从其他渠道拉最新版。

第三个坑是修改配置文件后不生效。改完配置文件后需要完全退出商店进程再重新启动，不是刷新一下窗口就能读到的。使用命令行启动时，退出后用pgrep -f xinyu-cap确认没有残留进程再启动。

5. 安装并运行第一个AI应用：从“商店”到“模型加载”

5.1 在商店里怎么选应用

初始化配置完成后，进入应用页面，搜索“对话”或“chat”，会看到类似“本地大模型聊天助手”的条目。这里我要特别强调一下：应用卡片上一般会写两行小字，一行是“模型7B-4bit”，一行是“推荐内存16GB”，很多人不看这一行就直接点安装，结果后续翻车。

普通用户第一个应用我建议选7B规模的4bit量化模型，既能完成日常问答、文案润色、代码解释一类任务，内存压力又可控。别一上来就选14B或更大，等你熟悉整套流程之后，再根据自己的实际需求换大模型也不迟。

5.2 一键安装背后的流程

点“安装”后，商店会依次做这几件事：解析依赖、申请磁盘空间、检查运行时、拉取模型文件、生成启动配置。这个过程在界面上看起来就是一个进度条，但如果你好奇卡在哪一步，打开终端跑一下：

journalctl -u xinyu-cap-store -f

可以实时看日志。下载模型是耗时间最多的一步，商店有断点续传机制，中途网络断了不用怕，重新点安装会从断点继续传，不会从头开始。这点对国内网络环境特别重要，大模型动辄几个GB，刚开始那几天我至少断了三四次，最后都是接着下完的。

5.3 手动导入已有模型的场景

如果你手头已经有一个本地模型文件，比如以前在别的机器上下载好的GGUF格式文件，不需要非得通过商店重新下载。在商店的“模型管理”里选“本地导入”，配置好模型名称、上下文长度和量化格式，它会直接引用这个文件，不重复占用空间。

命令行方式也有对应操作：

xinyu-cap model import --path /path/to/model.gguf --name my-model --ctx 2048

这个功能对经常折腾模型的用户非常实用。我有一次网络特别差，商店下载速度只有几十KB，干脆跑到邻居家路由器把模型文件拷回来，用导入方式注册，几分钟搞定。

5.4 其他类型应用的安装差异

除对话聊天外，芯语CAP里常见应用还有OCR文字识别、语音转写、文生图等。它们的安装流程整体一样，差别主要在模型文件大小和推荐配置：

• OCR类：模型小，几百MB，内存需求低，4GB都能跑，适合老机器。
• 语音转写：模型中等，1到2GB，主要看录音质量和麦克风输入。
• 文生图：模型较大，依赖较高，CPU推理比较慢，但龙芯平台现在也能跑，只是需要耐心。

商店会针对不同应用预设运行参数，比如OCR应用默认把线程数设为CPU核心数的一半，避免占用太多系统资源。这个设计在Windows和macOS的应用商店里很难见到，属于AI应用商店该有的能力。

6. 龙芯平台上的实测记录：闪退、卡顿与性能调优

6.1 内存不足导致应用闪退

我在16GB内存的龙芯3A6000机器上试过安装一个14B对话模型，安装本身很顺利，但启动应用后十几秒就被系统杀掉了。用dmesg | tail一看，典型的Out of Memory。原因很简单：14B模型即便量化后也有8GB左右，加载时还要额外占用上下文内存和运行时开销，16GB机器同时开着商店、浏览器、桌面环境，内存自然不够。

解决办法不是换机器，而是调整应用的启动参数。在应用设置里把线程数从默认值往下调，比如设成4，同时开启“内存映射”选项，让模型按需从磁盘读取，而不是一次性全部载入内存。这样能降低峰值内存占用，虽然推理速度会慢一点，但至少能跑起来。

6.2 磁盘空间“看起来够，实际不够”的坑

前面建议预留20GB空间，但我实测发现只预留20GB还是有点悬。原因是模型下载时采用分块写入，下载结束后临时文件和最终模型文件会有一段时间同时存在于磁盘上，瞬时占用可能是最终模型大小的1.5倍。如果磁盘只剩20GB，下载一个14GB的模型，中途可能失败。

我踩过的坑就是没看缓存目录，导致模型下载到90%失败，重新下载还要再费一遍流量。排查时可以看：

du -sh ~/.cache/xinyu-cap

如果里面有一个很大的临时文件，确认任务已失败后可以删掉。更好的办法是把模型目录单独放一个分区，并且把配置里的max_cache_size调到一个合理值，比如20GB，避免商店无限缓存多个版本的模型文件。

6.3 商店升级后运行时异常

有一次我把芯语CAP从1.1升级到1.2，结果之前能正常跑的对话应用全部启动失败。打开“运行时管理”，发现运行时后面多了一个黄色叹号，提示“版本不兼容”。原因是商店升级后对运行时版本做了更严格的校验，旧版本运行时的哈希值不在新版的信任列表里。

处理方法很直接：在运行时管理里点击“重新校准”，商店会重新检查现有运行时的版本信息，然后更新信任记录。如果“重新校准”没用，就把运行时卸载，再用商店的“安装推荐运行时”重装。这里有一点要特别提醒：不要自己从模型社区下载最新的上游运行时来替换，因为商店扫描到未知版本时会自动禁用，反而更麻烦。

6.4 让大模型在龙芯上跑得更快的几个调整

龙芯平台目前多数设备没有独立GPU，CPU推理主要看内存带宽和核心利用率。我测试下来，下面几个调整组合最有效：

线程数这块特别容易踩坑。很多人以为线程数设成越多越快，结果设成满核心后整个桌面鼠标都不动了。物理核心数减2是个经验值，既能让模型跑得尽量快，又不至于让系统失去响应。文生图类应用同理，线程数过高不会明显变快，反而可能触发系统限流。

另外，如果你经常只跑同一个模型，可以让它在应用列表里保持“常驻”，避免每次重新加载模型。加载模型是最耗时的一步，常驻模式能让第二次对话的响应速度提升非常明显。

最后再说一点个人体会。折腾龙芯上的AI应用，最考验人的其实不是技术难度，而是心态：网上大量资料都按x86的思维惯性写，直接照搬必踩坑。芯语CAP这类AI应用商店把依赖处理、模型下载、运行时管理打包成了标准化流程，我实际用下来最明显的感受是：从打开安装到跑起第一个聊天应用，比当年编译源码的方式节省了大半天时间。建议新手刚上手不要贪多，先装一个7B对话模型，完整跑通一次“安装-配置-对话”链路，再慢慢试OCR、语音、文生图这些工具。等你对整个流程有了手感，再回头看那些手动编译方案，会发现商店其实帮你处理了最繁琐的一层，剩下的应用选择权还是在你自己手里。