# V5项目交付资料指导手册2026
2026年8月
北京致远互联软件股份有限公司
# 前言
本手册旨在提炼项目交付过程中常见的问题通过什么通路解决，适用于项目经理、开发、运维、实施体系，建议收藏并定期复习，以提升个人综合实力、以及项目交付效率！
详细视频教程参见《运维体系化在线视频教程 (opens new window)》
# 万能方法论
| 工作方法 |
|---|
| 1、实践求真：多摸产品、多做实践、多扩展学习知识面、多总结改进 |
| 2、活用工具：各类知识库、DeepSeek/智慧泉随时开着、公司CoMi一搜、智能客服随时用着 |
| 3、终生学习：一有时间就多看看 开放平台 (opens new window)、致远学院(协同云-赋能中心进入) (opens new window) |
| 4、持续总结：养成记笔记总结的习惯，记录一份专属自己的笔记 |
| 5、学会拒绝：产品不是万能的，用户需求也不是什么都能免费响应的，开放平台-技术运维- [V5项目交付常见额外投入列表 (opens new window)] 有常见不支持和额外投入参考 |
| 6、AI提效：不仅会用工具，还要学会产出工具，将共性问题提炼成AI工具、skill加速个人和团队处理效率 |
# 什么问题走什么流程？
| 维度 | 通路 |
|---|---|
| 产品如何使用 | cloud.seeyon.com赋能中心-协同云AI-AI客服助手 公司协同BUG上报单查询相似问题 操作手册、各版本发版文档-新特性手册 ~ |
| 生产系统：产品功能BUG、数科/文档通问题、报错、故障、宕机 | AI客服助手 → AI交付助手 → 客户BUG流程 |
| 直销-产品二次开发问题，代码如何实现、代码问题排查 | 客开自助解决无果 → 开发作业单（无论是找研发还是找谁处理都是这个单子） |
| 分销-产品二次开发问题，代码如何实现、代码问题排查 | 客开自助解决无果 → 技术运维支持申请单（分类选 需求评估或开发），涉及结算成本 |
| 安装部署配置问题、升级升迁问题或护航、压测问题、M3未加固包、BI实施问题 | 技术自助解决无果 → 技术运维支持申请单 |
| 非正式用户，售前阶段产品、开发、部署问题 | 技术自助解决无果 → 售前支持申请单 |
# 系统环境类问题处理规则
| 问题分类 | 流程规则 |
|---|---|
| 生产系统无法启动/宕机/卡慢问题 | 保持原模式：项目组（结合AI知识库/工具/环境群内交流）先排查问题，处理不了上报400 |
| 非工作时间项目升级升迁护航 | 重要变化：部分项目由顾问升级易出问题，故直分销项目护航需要区域安排高级技术护航做基础环境问题指导处理，疑难问题总部研发处理（不再指导如备份/恢复/Linux命令/中间件配置等简单问题）。 |
| 所有环境产品部署/升级等问题（OA、全文检索、CoMi等） | 重要变化：客户上报给400的此类问题统一转区域运维负责处理跟进。 标准流程：项目组（结合AI知识库/工具/环境群内交流）先排查处理，疑难上报技术服务支持单。 |
| 所有环境薪事力环境部署/维护/升级/备份恢复/服务器维护等 | 重要变化：业务受理流程保持不变，问题处理模式优化调整。环境问题统一由项目组运维承接，疑难问题按流程流转至总部后，总部将协同项目组运维联合处置问题，总部不再直接对接客户做环境维护。 |
| 所有环境服务器运维（数据库、中间件、证书更换、网络排查、巡检等） | 重要变化：客户上报给400的此类问题统一转区域运维负责处理跟进。 标准流程：项目组（结合AI知识库/工具/环境群内交流）先排查处理，疑难上报技术服务支持单。 |
| 数据库SQL编写/数据修复 | 重要变化：客户上报给400的此类问题统一转区域运维/客开负责处理跟进。 标准流程：项目组（结合AI知识库/工具/环境群内交流）先排查处理，疑难上报技术服务支持单（最终数据库环境问题处理依然由项目组完成）。 |
| 产品安全问题 | 重要变化：客户上报给400的此类问题统一转区域运维负责处理跟进。 标准流程：项目组（结合安全培训视频/AI知识库/工具/安全群内交流）先排查处理，疑难上报安全问题上报单。 |
| 金山weboffice中台问题 | 产品BUG：上报BUG流程； 部署问题：项目组（结合AI知识库/工具/环境群内交流）先排查处理，疑难上报技术服务支持单； 安全问题：上报安全问题上报单 |
| 数科、文档通部署/安全/产品问题 | 项目组（结合AI知识库/工具/环境群内交流）先排查处理，处理不了上报BUG |
| 致信融云部署迁移配置问题 | 项目组（结合AI知识库/工具/环境群内交流）先排查处理，疑难上报技术服务支持单 |
| 转库/转版/合版/分版问题 | 项目组（结合AI知识库/工具/环境群内交流）先排查处理，疑难上报技术服务支持单 |
# 有效沟通-发起人要对问题门清
| 无效问题 | 有效沟通 |
|---|---|
| 客户有问题需要研发跟客户沟通 | 什么问题？具体问题清单？ |
| 客户要正式升级，申请研发护航 | 什么时间？什么版本？谁升级？是否测试升级？有哪些主要模块？ |
| 测试升级报错，需要支持（没有日志、没有现象截图） | 升级日志、启动日志、现象截图？升级日志智能体的分析结果？ |
| 部署报错，研发说发支持单 | 具体报什么错？项目上的排查过程截图？ |
| xx领导说系统慢 | xx领导说系统慢，我实际操作了下发现是打开xx页面慢，需要20秒，其余页面正常 |
| 客户宕机了，研发赶紧支持下 | 客户宕机了，我通过宕机问题分析教程发现系统监控里面堆内存99%了，需要一起分析下 |
# 产品基础专项
| 维度 | 教程 | 工具 |
|---|---|---|
| V5产品架构知识 | 视频教程+PPT (opens new window) | CoMi一搜 |
| V5信创体系知识 | 视频教程+PPT (opens new window) | CoMi一搜 |
| CoMi体系知识 | 视频教程-大模型基础 (opens new window) 视频教程-CoMi基础 (opens new window) | 算力推荐和测算手册 (opens new window) 本地模型练手 (opens new window) |
| 服务器资源评估 | 视频教程 (opens new window) | CoMi一搜-服务器资源生成智能体 (opens new window) |
| 产品功能变化清单 | 文档中心-营销中心-营销体系-销售管理知识库-产品下载地址Excel-对应版本云盘-文档-功能清单-版本变化清单Excel | 公司协同“2025年直销客户低版本升级升迁专项行动通知”附言-专项文档.zip有一份整理到V9.0的变化总表 |
| Linux基础 | 视频教程 (opens new window) | 系统镜像： 龙蜥 (opens new window) 欧拉 (opens new window) 本地虚拟化：VMware (opens new window) SSH：WindTerm (opens new window) MobaXterm (opens new window) |
| Java基础（非开发） | 视频教程 (opens new window) | 毕昇JDK (opens new window) 龙芯JDK (opens new window) |
| 网络基础 | 视频教程 (opens new window) | 拓扑图工具：Processon (opens new window) V5拓扑图：模板下载地址 (opens new window) |
| 数据库基础 | 视频教程 (opens new window) 互联网自学 | 【Navicat Premium Lite】 (opens new window) 【DBeaver】 (opens new window) 【DBX】 (opens new window) AI |
# 部署升级迁移专项
| 维度 | 教程 | 工具 |
|---|---|---|
| V5部署升级迁移入门到精通 | 视频教程 (opens new window) 手册文档 (opens new window) | 协同云-赋能中心-实施交付中心-揭榜挂帅-张传金 |
| V5非信创环境部署 | 视频教程 (opens new window) 手册文档 (opens new window) | |
| V5信创环境各种中间件部署 | 视频教程 (opens new window) 手册文档 (opens new window) | CoMi一搜→信创日志分析智能体 (opens new window) |
| V5非标信创组件部署 | 手册文档 (opens new window) | |
| V5集群环境部署 | 视频教程 (opens new window) 手册文档 (opens new window) | |
| CoMi部署 | 视频教程 (opens new window) 手册文档 (opens new window) | 临时免费模型：agnes-2.5-flash (opens new window) 硅基流动BAAI/bge-m3 (opens new window) |
| V5扩展服务部署 | 手册文档 (opens new window) | |
| MySQL/NG/Redis部署 | 手册文档 (opens new window) | 自动部署脚本-AI生成 (opens new window) |
| V5产品迁移升级 | 升级指导手册 (opens new window) 迁移手册 (opens new window) | CoMi一搜→V5升级日志分析智能体 (opens new window) |
| V5安装包统一下载地址 | 公司系统-文档中心-营销中心-营销体系-销售管理知识库-产品下载地址Excel | |
| 友商数据迁移 | 泛微/蓝凌/通达数据迁移到致远V5产品线，具体实施动作和咨询走开发作业单流程 | |
| V5数据迁移V8 | V5产品线数据迁移到云原生新一代V8产品线，具体实施动作和咨询走开发作业单流程 |
支持单上报规范：
- 信创部署启动问题：先用信创日志分析智能体分析原因 → （分析无果提供分析结果）上报支持单
- 测试升级问题分析：先用V5升级日志分析智能体分析原因 →（分析无果提供分析结果）上报支持单
# 产品交付文档资料
项目交付、验收过程高频的文档，都汇总在这里：
| 维度 | 通路 |
|---|---|
| 产品架构 | 1、产品架构赋能视频和PPT (opens new window) 2、开放平台-FAQ [V5协同OA产品架构 (opens new window)] 3、公司系统-文档中心-营销中心-营销体系-销售管理知识库-产品下载地址Excel-客户对应版本云盘-文档-白皮书 |
| 产品使用的第三方组件版权信息，产品引用开源组件清单及版本号 | 公司系统-文档中心-营销中心-营销体系-销售管理知识库-产品下载地址Excel-客户对应版本云盘-文档-版本工程及三方组件说明-自取 |
| 产品各版本功能变化清单，从Vxx到Vxx有哪些变化 | 公司协同“2025年直销客户低版本升级升迁专项行动通知”附言-专项文档.zip有一份整理到V9.0的变化总表； 公司系统-文档中心-营销中心-营销体系-销售管理知识库-产品下载地址Excel-对应版本云盘-文档-功能清单-版本变化清单Excel有该版本新的变化清单 |
| 产品商务插件和报价 | 公司协同-公告-Vxx上市通知 附件 |
| 各版本新特性发布文档 | 公司系统-文档中心-营销中心-营销体系-销售管理知识库-产品下载地址Excel-对应版本云盘-文档-发布文档 文件夹下PPT 注：自V9.0开始，操作手册文件夹下新增一份《新特性手册》，详细介绍该版本新增的所有新特性及操作 |
| 技术、安全白皮书 | 公司系统-文档中心-营销中心-营销体系-销售管理知识库-产品下载地址Excel-对应版本云盘-文档-白皮书文件夹下 |
| 用户操作手册 | 公司系统-文档中心-营销中心-营销体系-销售管理知识库-产品下载地址Excel-对应版本云盘-文档-操作手册 注：自V8.1SP2开始，产品新增一份《新特性手册》，详细介绍该版本新增的所有新特性及操作 协同OA系统-我的工具-系统帮助有在线的操作手册（客户系统也有） |
| 安装维护手册（离线版） | 公司系统-文档中心-营销中心-营销体系-销售管理知识库-产品下载地址Excel-对应版本云盘-文档-安装手册文件夹下自取 注：离线版无法实时更新，建议部署人员全部使用开放平台在线文档 |
| 产品系统测试报告 | 公司系统-文档中心-营销中心-营销体系-销售管理知识库-产品下载地址Excel-对应版本云盘-文档-测试报告 |
| 产品性能压测报告 | 公司系统-文档中心-营销中心-营销体系-销售管理知识库-产品下载地址Excel-对应版本云盘-文档-测试报告 |
| 产品安全测试报告 | 公司系统-文档中心-营销中心-营销体系-销售管理知识库-产品下载地址Excel-对应版本云盘-文档-安全文件夹下自取公司安全团队的测试报告 安全团队的安全评估报告包含了：代码审计、渗透测试等多方安全检查结果 |
| 公司安全资质、第三方代码审计报告、第三方安全评估报告、公司安全策略文件 | 公司协同-文档中心-他人共享的-郑敏 公司协同-文档中心-营销中心直接搜索（如'等保三级'） |
| 产品测试用例、测试方案、测试过程报告 | 1、公司产品对外只提供系统测试报告，获取地址在上面 2、产研过程中的详细测试用例、测试方案属于公司核心资产，无法对外分享 3、研发可提供主要模块的冒烟测试用例，通过技术支持单流程-类型选择文档资料获取 |
| 数据字典、数据结构 | 请客户经理联系公司商务申请数据字典（可能需要签订保密协议） |
| 开发文档、客开文档、接口文档 | 开放平台-技术文档、SeeyonAPI等自取 |
# 安全问题专项
安全问题需要项目组自检、自查、内部消化，不同漏洞有对应的处理方法论：
2025年V5产品安全培训视频（方法论未过期） 协同云平台 (opens new window)- 赋能中心 - 致远学院 - 搜索 2025年V5产品安全培训：讲透了漏扫工具如何使用 2026年HW行动教程视频：致远学院搜索“2026年护网行动专项会议视频”，培训课件已上传至知识中心-客户成功部-老客户运维工具-安全工具-安全培训。
| 维度 | 通路 |
|---|---|
| 安全应急响应公示平台、安全服务网站地址 | 公司级安全服务平台迁移至Support [参考地址 (opens new window)] 安全服务平台内容涵盖：安全应急响应机制、安全公告、补丁通知（补丁列表）等 在线网站未提供补丁下载：可以通过自己电脑用安全补丁工具可以下载每个版本的补丁 |
| 漏扫工具地址、使用方法、打补丁不生效问题处理方法 | 1、漏扫工具 [下载地址 (opens new window)] ，一定要不定期下载最新的工具，最新的补丁才最全 2、漏扫工具详细使用教程：协同云平台 (opens new window)- 赋能中心 - 致远学院 - 搜索2025年V5产品安全培训 |
| 产品相关安全问题通用处理方法 | 1、下载最新的漏洞扫描工具进行扫描并打上所有安全相关的补丁 2、公司协同-CoMi图标-安全智能客服录入问题搜索答案 3、CoMi一搜智能搜索，用自然语言的形式一个一个叙述问题寻找解决方案（开放平台记录了大量常见安全问题处理方法，弱口令、明文传输、版本号泄漏等等问题都有说明） 4、开放平台-安全问题专题 (opens new window)-列出了主要场景的排查方案 |
| 开源jar包组件版本漏洞（组件漏洞） | 主机扫描CVE组件版本漏洞 (opens new window) |
| Tomcat漏洞 | Tomcat是开源中间件，会定期更新发布修复CVE披露的漏洞，个别用户会要求Tomcat定期更新： 1、先从 [Support安全服务平台 (opens new window)] - 第三方安全补丁 - 标准产品Tomcat中间件版本更新补丁检查是否有修复补丁包自助处理 2、如果用户要求的Tomcat版本非常新，需要发技术支持单，选系统环境问题，研发来评估提供 |
| 特殊安全问题：源码静态扫描 | 这里特指产品源码的扫描，源码默认不公开给用户，公开给用户的是安装程序和运行程序： 1、严禁取标准产品源代码扫描，源代码扫描只能取客开改动的源码进行扫描，并且由客开根据客户要求做修正。 2、源代码扫描属于静态代码扫描范畴，此类扫描往往是代码合规性问题，并不代表构成安全风险。鉴于修改代价极高，不可复用，研发不提供源码扫描问题的修复。 3、如有刚性需求，需要约定范围并签订额外工作量合同，由项目组投入成本修正。 |
| 特殊安全问题：数科、文档通安全问题流程 | 数科、文档通安全问题上报客户BUG流程处理，并且数科一个BUG、文档通一个BUG分开报 |
| 特殊安全问题：等保、分保合规性问题 | 等保、分保是一种安全合规规范 / 配置标准，不能当作安全问题处置，应该属于一种特殊项目类型，这种客户过审需求通常是项目组跟客户签订专项合同做处理： 1、产品提供了分保插件，实现了基础的等保分保合规功能（具体可见V8.1SP1和SP2的发版PPT） 2、产品无法保证100%过审，不同行业不同专家针对等保、分保评审规则不同，基本都需要投入额外成本改造，跟客户做好沟通：按照问题功能点投入客开修改 3、如果需要安全团队支持，需要给客户做报价，然后走安全问题支持单，安全团队计费支持 4、不是所有问题都要付费：如果确实是真实渗透测试问题，有真实的payload报告，安全团队会承接 |
| 26年度安全培训视频 | 协同云平台 (opens new window)- 赋能中心 - 致远学院 - 搜索 2026年护网行动专项会议视频 |
| 24年度安全培训视频（方法论未过期） | 协同云平台 (opens new window)- 赋能中心 - 致远学院 - 搜索 24年度安全培训（护网行动准备+安全工具版本更新）： 3-1）如何做全面的护网安全加固？弱口令？木马查杀推荐？杀软推荐？（从播放时长22:00开始） 3-2）漏扫工具那么多功能如何使用？请参考第1条 - 24年度安全培训（从播放时长50:00开始） 3-3）主动防御工具能解决什么问题？请参考第1条 - 24年度安全培训（从播放时长1:31:00开始） |
| 2025年V5产品安全培训视频（方法论未过期） | 协同云平台 (opens new window)- 赋能中心 - 致远学院 - 搜索 2025年V5产品安全培训：讲透了漏扫工具如何使用 |
| 产品加解密相关算法接口资料 | 开放平台 - [加密解密 (opens new window)] |
# CoMi AI专项
| 维度 | 通路 |
|---|---|
| ★CoMi AI Agent体系化入门课程 | 协同云-赋能中心-致远学院- [CoMi2.0 交付课程体系 (opens new window)] 涵盖：大模型基础、模型算力测算、AI Agent基础、CoMi环境和部署、CoMi实施技能视频 |
| CoMi所需资源、依赖什么模型 | 开放平台-系统运维-AI应用手册- [环境准备指导手册 (opens new window)] ，手册中还有在线视频链接，看不懂就看视频解读 涵盖：服务器资源要求、部署架构图、大模型推荐、商务插件准备、支持的环境 等内容 |
| CoMi部署手册 | 开放平台-系统运维-AI应用手册- [CoMi部署手册 (opens new window)] CoMi版本迭代很快，一定要先看环境准备指导手册，明确用哪个版本再去看对应部署手册 部署方案可能有多种，根据自身特点选型，协同云-赋能中心-致远学院-知识库-实施交付（AI）下有部署视频 新人先看部署视频，了解一个大概再动手 |
| CoMi常见问题 | 开放平台-系统运维-AI应用手册-CiMi部署手册 - [CoMi部署配置常见异常解决方案 (opens new window)] 开放平台-智能搜索直接输入错误关键字搜答案 |
| CoMi各种案例手册版本资料 | 飞书知识库 - [CoMi产品库 (opens new window)] 飞书知识库涵盖了（部署除外）CoMi研发所有发版资料 |
# 数据库常见问题处理方案专项
| 维度 | 通路 |
|---|---|
| 表单数据清理、指定数据清理、公文正文附件替换、人员恢复 | S1工具具备这些恢复、修复的功能，使用S1完成 S1有的功能，不提供SQL修复方法 |
| 数据库由我们维护吗？ | 不是。产品报价中没有数据库的报价，数据库安装部署维护是客户负责，项目上可根据团队自身能力做对应运维报价。 也可以咨询总部，提供第三方数据库维护厂商（对公）付费支持。 |
| 我们产品对数据库有哪些核心要求？ | 1、标准支持的数据库有限：看部署手册最前面有数据库型号的支持范围 2、产品对数据库配置有要求：看部署手册/环境准备手册，对数据库配置有要求 3、对数据库的备份要求：一定要自动备份库、自动异地机器备份 |
| 数据库转库有工具吗？谁来做？ | 1、如果是MySQL转SQLServer、Oracle，我们产品有工具：购买转库工具做实施，研发支持兜底 2、如果是转信创数据库（达梦、金仓、高斯等）：我们产品没有工具，需要使用信创数据库的转库工具，由信创数据库厂商兜底 |
| 客户数据库很大，怎么优化？ | 1、量化“大”的概念，具体是什么大？多大？ 2、先请客户检查是否是数据库碎片、日志过多导致，先清理、收缩这些东西 3、再请客户查询一下大表TOP20，项目组根据表名搜索FAQ看表是否可以清理 |
| 客户数据库很大，整理出了TOP大表信息，想问哪些表数据可以删除 | 开放平台-FAQ直接输输入大表表名，可以知道当前表是否可以删除 如果搜索不到，则说明表很重要，无法删除 |
| 我们产品使用的数据库每天增加20G怎么解决？ | 1、需要客户检查具体是什么在增长，给出具体的增量的信息 2、通常可能是数据库开了binlog等导致的非产品相关的业务数据增长，这块客户评估处理即可 3、如果明确出是产品某个表每天有大量数据产生（如每天10万条数据），则给出表找研发排查 |
| 数据库操作原则 | 1、先测试验证，再正式执行 2、数据增删改前，必须养成备份的习惯，避免误操作 3、有工具、接口能完成的数据操作必须用工具、接口 4、只有没有工具接口的情况，才能去用SQL，数据无价，谨慎再谨慎 |
| 表单误删除，数据恢复方法 | 数据被删除后恢复的条件都是需要有非常新的备份数据： [数据操作：恢复被删除的流程表单数据 (opens new window)] [数据操作：恢复被删除的表单配置 (opens new window)] [数据操作：CAP4应用包误删除后恢复 (opens new window)] |
| 流程撤销后，期望恢复撤销的流程 | [【工作流】数据操作：恢复撤销流程 (opens new window)] |
# 环境问题工具专项
| 维度 | 通路 |
|---|---|
| 压测工具和脚本 | 1、产品发版提供了研发标准的压测报告，如项目上没有压测合同，可以免费自取产品压测报告交付 2、如有压测合同要求，产品提供了各版本标准压测工具、脚本、教程，项目组可以独立完成 [压测工具下载地址 (opens new window)] [压测视频教程 (opens new window)] 2、如有自定义压力测试场景，需要投入额外工作量，必须签订合同，按开发工作量成本投入 3、如还有长时间稳定性测试、高可用性测试等特殊测试场景，同样需签订合同，按开发工作量成本投入 4、如客户聘请第三方做压测，务必将我们的压测脚本提供给三方参考，避免三方不理解我们的业务逻辑，编写脚本错漏 5、压测报错之后，提取错误关键字，去开放平台 《压力测试工具和常见问题 (opens new window)》 能解决很多问题 |
| 启动不了/启动卡住 | 1、启动不了（启动一会儿就退出）：需要掌握日志分析技能，积累经验，可以参考FAQ 《协同OA启动不了，问题原因合集 (opens new window)》 2、启动卡住（没退出但也一直没成功）：卡住需要分析运行进程，可以参考FAQ 《启动过程中卡在某个位置很久 (opens new window)》 扩展：信创问题分析智能体 AI交付助手 - 信创日志分析 |
| 单点功能报错 | 通常按以下顺序执行：浏览器F12控制台和请求 → OA日志，不同问题调试方法见 《问题调试分析方法 (opens new window)》 |
| 单个功能缓慢 | 1、通常按以下顺序执行：浏览器F12网络 → 后台ThreadDump → Nginx日志 2、自己无法处理的问题，发生问题时用V5浏览器采集工具采集数据再上报问题 [视频教程 (opens new window)] [工具下载（需VPN） (opens new window)] |
| 系统性能宕机问题 | 1、技术人员提前学习 性能宕机体系化课程 (opens new window) ，里面有标准方法论，提前采集数据 2、容易出性能问题的环境提前部署Seeyondump工具，定时抓取服务运行状态，方便做性能问题排查 [下载地址 (opens new window)] 3、自己无法处理的问题，上报BUG时提供Seeyondump供研发分析 4、如没有部署Seeyondump，可以使用 [V5环境检查工具envchecktool (opens new window)] 里面也会抓一部分系统实时运行情况供研发参考 扩展：大量性能宕机问题案例合集 《大量性能宕机问题案例合集 (opens new window)》 |
| 服务器巡检 | 1、浏览器前端巡检 [V5浏览器巡检工具 (opens new window)] 2、服务器巡检 [V5环境检查工具envchecktool (opens new window)] |
| BUG上报提效 | 1、提供日志、版本信息、故障时间、故障截图 2、26年10月研发即将发布”日志打包“工具 |
编撰人：het、admin
快速跳转
