知识治理平台真正消耗运维精力的，往往不是“提交任务”这个动作，而是提交之后的一连串确认：抽取完成了吗、失败在哪里、原文件能否直接查看、首页提醒能不能按环境关闭。qKnow 专业版 v3.1.3 围绕这些高频环节进行优化，新增结构化与非结构化抽取任务消息提醒，引入 kkFileView 部署配置，并支持通过参数管理控制首页提醒的显示与隐藏。
抽取任务从被动查询变成状态通知
知识抽取通常是异步任务。文件规模较大、队列拥堵或模型处理耗时增加时，用户提交任务后无法立即拿到结果。过去如果只能反复刷新任务列表，平台会产生两类额外成本：用户需要持续关注页面，管理员也会收到大量“任务是否完成”的重复询问。
v3.1.3 为结构化与非结构化抽取任务新增消息提醒，关键价值不只是多了一条通知，而是让任务生命周期更容易被感知。实际使用时，建议重点确认以下状态是否能够清晰区分：
- 任务已提交：表示平台已接收请求，但尚未完成抽取。
- 任务执行成功：提醒用户可以进入结果检查或后续知识发布流程。
- 任务执行失败：除了失败状态，还应关注页面是否提供可定位问题的信息。
- 多任务并行：通知应包含任务名称、文件名或任务编号，避免用户无法判断是哪次操作完成。
消息提醒不能替代任务中心。提醒适合告诉用户“状态发生了变化”，任务中心则应保留完整记录，用于查看历史结果、失败原因和重试情况。两者结合，才能同时覆盖即时感知和事后审计。
kkFileView 补上文件核验环节
抽取结果是否可信，通常需要和原始文件对照。新增 kkFileView 部署配置后，平台管理员可以为文件预览能力准备独立服务，使用户在知识治理过程中减少下载文件、寻找本地软件再打开的往返操作。
下面是一种可以改造的 Docker Compose 部署方式。该示例使用 kkFileView 的公开容器镜像，镜像版本、数据目录和网络策略需要按实际生产环境调整；qKnow 中对应的参数名称及填写位置应以当前版本的管理界面和部署文档为准。
services:
kkfileview:
image: keking/kkfileview:4.4.0
container_name: kkfileview
restart: unless-stopped
ports:
- "8012:8012"
environment:
TZ: Asia/Shanghai
volumes:
- kkfileview-data:/opt/kkFileView-4.4.0/file
volumes:
kkfileview-data:
将内容保存为 compose.yaml 后，可以这样启动并检查服务：
docker compose up -d
docker compose ps
curl -I http://127.0.0.1:8012/
如果 qKnow 和 kkFileView 都运行在容器中，不要直接把 127.0.0.1:8012 当作容器间访问地址。应将两个服务接入同一个 Docker 网络，并使用服务名访问，例如 http://kkfileview:8012。如果浏览器需要直接访问预览服务，还要配置反向代理、TLS 和用户可达的外部域名。
上线文件预览前，应额外检查四个边界：
- 预览服务是否只能获取被授权的文件，避免通过可猜测 URL 越权读取文档。
- 临时文件是否设置清理周期，防止磁盘持续增长。
- 大文件、复杂 Office 文档和特殊字体是否能够正常转换。
- 预览失败时是否允许回退到下载，并记录可供排查的日志。
首页提醒进入参数化管理
首页提醒并不适合在所有环境中永久显示。测试环境可能需要长期展示操作提示，生产环境则可能希望在用户熟悉流程后关闭提醒。v3.1.3 支持通过参数管理控制首页提醒显示或隐藏，使管理员不必为了调整一个界面提示反复修改前端代码或重新构建镜像。
参数化配置的重点是明确作用范围：它是全局设置、租户级设置，还是用户偏好；修改后是否立即生效；关闭提醒后，用户还能否从帮助入口重新找到相关内容。对于多环境部署，还应把关键参数纳入发布检查，避免测试环境和生产环境的显示策略互相覆盖。
下面的 YAML 仅用于说明如何管理环境差异，并不代表 qKnow 的真实参数键名。接入时应把示例键替换为产品参数管理页面提供的实际配置项：
# values-production.yaml（示意配置）
qknow:
parameters:
homeReminderVisible: false
integrations:
kkFileViewBaseUrl: "https://preview.example.com"
这类配置最好由部署系统维护，并在变更记录中写明操作者、修改时间和变更原因。这样即使提醒被误关，也能快速追溯，而不是依赖口头确认。
升级时不要只验证“功能出现了”
此次升级聚焦细节，但涉及异步任务、外部预览服务和运行时参数，仍值得安排一轮端到端验收：
- 分别提交结构化和非结构化抽取任务，确认成功与失败场景下的提醒内容。
- 同一用户连续提交多个任务，检查消息是否能准确关联到对应任务。
- 用 PDF、Word、Excel 和较大文件验证预览效果、加载时间与失败回退。
- 切换首页提醒参数，确认生效范围、缓存行为及权限控制符合预期。
- 检查 kkFileView 的网络暴露、鉴权边界、临时文件清理和日志留存。
v3.1.3 的改进集中在知识治理链路中最容易产生重复操作的位置：等待任务、核验文件和调整提示。升级收益能否真正落地，取决于团队是否同时补齐通知规则、预览服务安全和参数变更治理，而不只是完成版本替换。