知言自主部署指南 · 0.1.0

知言 · Dialogexa 自行部署试用指南

版本：0.1.0 测试版。编写日期：2026-10-01。此指南对应可下载的测试构建与源码，不将品牌页所描述的产品愿景当作本试用包已交付的能力。

这份测试版可以让你搭建自己的会话工作台，体验客户消息、需求表、人工回复、内部指导、单会话接管、草稿审核与知识条目审核。真实模型自动回复、自动翻译、文件解析、手机推送与 iOS 原生应用仍属于后续产品方向。

选择下载内容

下载	适合谁	内容
Linux ARM64 测试包	使用兼容 ARM64 Linux 的技术用户	服务端、.NET 运行时、SQLite 组件与编译后的网页
完整源码包	希望审阅、修改、重新构建的开发团队	独立 Microsoft Visual Studio 工程、Android Studio 工程、网页源码与 API 合同

服务端预编译包目前只提供 linux-arm64。已在 aarch64 HolmesBox 上运行并验证；其他 ARM64 Linux 发行版尚未逐一验证。Windows、Linux x64 和 macOS 需要使用源码自行构建，不能直接运行这份 ARM64 Linux 包。

自包含发布附带 .NET 运行时，但 Linux 所需的原生系统依赖仍须由你的系统提供。先检查系统与架构，再按微软对应发行版文档核对依赖；本指南不会假定所有 Linux 都有相同包名。

在自己的 Linux ARM64 机器上启动

以下命令由你在自己的测试机器上运行，不需要 GPU，也不涉及知言线上服务器。下载文件名如有版本后缀，以下载页实际文件名为准。

先确认架构：

uname -m

应为 aarch64。将下载的包置于当前目录，并与下载页提供的 SHA-256 清单核对：

sha256sum dialogexa-evaluation-linux-arm64.tar.gz
tar -tzf dialogexa-evaluation-linux-arm64.tar.gz

建立独立目录，将持久化资料与程序文件分开。不要把数据目录放在 wwwroot 中：

trial_root="$HOME/dialogexa-trial"
mkdir -p "$trial_root/app" "$trial_root/data"
chmod 700 "$trial_root/data"
tar -xzf dialogexa-evaluation-linux-arm64.tar.gz -C "$trial_root/app"
chmod 755 "$trial_root/app/Dialogexa.Api"
cd "$trial_root/app"
DX_DATA_DIR="$trial_root/data" ASPNETCORE_URLS=http://127.0.0.1:18760 ./Dialogexa.Api

保持该终端运行。另开终端检查：

curl --fail http://127.0.0.1:18760/api/health

应返回 JSON，其中 status 为 ok。realModelEnabled: false 和 pushEnabled: false 是本测试版的真实状态。

在运行机器自己的浏览器打开：

客户试用：http://127.0.0.1:18760/chat/index.html?platform=demo-shop
管理工作台：http://127.0.0.1:18760/admin/index.html

如果服务器没有桌面浏览器，可从你自己的电脑建立 SSH 端口转发，再打开上面的本机地址：

ssh -L 18760:127.0.0.1:18760 your-user@your-host

将示例中的账户和主机替换为自己的测试服务器信息。示例不会创建账户或配置 SSH；本地端口已被占用时选择另一个空闲本地端口，并在浏览器地址中使用该端口。

取得自己的管理员凭据

首次启动时，应用为你创建独立管理员凭据，位置为：

<你的数据目录>/.secrets/admin-token

在自己的受信任终端或私有文件查看器中查看此文件，将内容输入管理工作台的凭据框。不要放进分享链接、网页源码、截图或公开聊天。凭据只用于你自己的实例；下载包不包含知言线上管理员凭据，也不会替你取得公共演示站的管理权限。

工作台需要有效凭据才能加载。客户页面不需要管理员凭据；它会创建并保存独立的客户会话能力。要模拟两个客户，使用不同浏览器档案或隐私窗口。

完成一次真实试用

在客户页创建测试会话，发送一条合成需求并提交演示表单。
在自己的工作台输入自己的管理员凭据，打开对应会话。
保存内部指导，返回客户页确认内部内容没有出现。
直接发送人工回复，或填写客户语言草稿，审核后发送。
切换人工接管；核对旧草稿或旧版本不会越过服务端检查发送。
停止自己的测试进程并重新启动，确认消息与表单仍存在。

这是人工协作流程的真实试用。auto 是会话控制模式名称，不表示已经接通模型。演示资料仅用于测试，不代表真实业务报价或政策。

常驻运行与公网接入

上面的前台进程适合首次验证，关闭终端便会停止。常驻运行可由自己的管理员配置独立 systemd 服务，使用固定工作目录与 DX_DATA_DIR，并用非 root 账户运行。线上访问需要你自己的域名、HTTPS 接入、权限与备份安排；不要直接把 HTTP 测试端口暴露给公网。

自托管包不含知言线上 Tunnel 令牌或账户配置。公网域名接入与 systemd 安装是你的环境配置步骤，不是下载即完成的一键部署。知识和消息保存在你的 SQLite 数据目录；升级时先停止写入并做一致性备份，保留数据目录及原程序版本。

从源码构建

源码包中 VS/Dialogexa.sln 是 Microsoft Visual Studio 入口，AS/Dialogexa.Android 是独立 Android Studio 工程。API 合同位于 contracts/api-v1.md。先读相应 README，核对已安装的工具链与锁文件，再构建。

后端固定 .NET SDK 10.0.401（global.json）；前端锁定 React、TypeScript、Vite 与 pnpm，并提供锁文件。Android 的 Gradle Wrapper、AGP 与 SDK 要求见 Android README。源码分发包使用可移植的 Node 默认与相对缓存路径；仍需核对自己的 Node 与 Android SDK 设置。Android 源码默认只接入 HTTPS。

服务端可通过微软官方发布命令为自己的平台重新构建，例如 Linux x64：

dotnet publish VS/src/Dialogexa.Api/Dialogexa.Api.csproj -c Release -r linux-x64 --self-contained true -o output/linux-x64

再构建或使用源码包中附带的前端 dist，按如下对应关系复制到服务端发布目录：

VS/web/portal/*                    → 发布目录/wwwroot/
VS/web/Dialogexa.Admin/dist/*     → 发布目录/wwwroot/admin/
VS/web/Dialogexa.Widget/dist/*    → 发布目录/wwwroot/chat/

复制时保留 admin、chat 和其资源文件，不要用根首页目录替换整个 wwwroot。重新构建的新平台包必须在你的目标机器完成运行检查；ARM64 的既有验证不能自动算作 x64、Windows 或 macOS 验证。

一手资料

试用版已完成目标 ARM64 服务运行、公开接口及持久化检查。浏览器交互、其他用户机器、Android 实机和通知送达需分别验证；它们不由下载文件存在或接口返回 200 证明。