# V5项目交付资料指导手册2026
2026年8月
北京致远互联软件股份有限公司
# 前言
本手册旨在提炼项目交付过程中常见的问题通过什么通路解决，适用于项目经理、开发、运维、实施体系，建议收藏并定期复习，以提升个人综合实力、以及项目交付效率！
# 万能方法论
| 工作方法 |
|---|
| 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上报单查询相似问题 客服400在线或人工 |
| 产品功能问题、数科/文档通问题、报错、故障、宕机 | 公司协同BUG上报单查询相似问题 客户BUG流程 |
| 直销-产品二次开发问题，代码如何实现、代码问题排查 | 开发作业单（无论是找研发还是找谁处理都是这个单子） |
| 分销-产品二次开发问题，代码如何实现、代码问题排查 | 技术运维支持申请单（分类选 需求评估或开发），涉及结算成本 |
| 安装部署配置问题、升级升迁问题或护航、压测问题、M3未加固包、BI实施问题 | 技术运维支持申请单 |
| 非正式用户，售前阶段产品、开发、部署问题 | 售前支持申请单 |
# 有效沟通-发起人要对问题门清
| 无效问题 | 有效沟通 |
|---|---|
| 客户有问题需要研发跟客户沟通 | 什么问题？具体问题清单？ |
| 客户要正式升级，申请研发护航 | 什么时间？什么版本？谁升级？是否测试升级？有哪些主要模块？ |
| 测试升级报错，需要支持（没有日志、没有现象截图） | 升级日志、启动日志、现象截图 |
| 部署报错，研发说发支持单 | 具体报什么错？项目上的排查过程截图？ |
# 产品基础专项
| 维度 | 教程 | 工具 |
|---|---|---|
| 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) 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等自取 |
# 安全问题专项
安全问题需要项目组自检、自查、内部消化，不同漏洞有对应的处理方法论：
| 维度 | 通路 |
|---|---|
| 安全应急响应公示平台、安全服务网站地址 | 公司级安全服务平台迁移至Support [参考地址 (opens new window)] 安全服务平台内容涵盖：安全应急响应机制、安全公告、补丁通知（补丁列表）等 交付所有人需要知道这个网站，需要了解里面的内容 |
| 漏扫工具地址、使用方法、打补丁不生效问题处理方法 | 1、漏扫工具 [下载地址 (opens new window)] ，一定要不定期下载最新的工具，最新的补丁才最全 2、漏扫工具详细使用教程：协同云平台 (opens new window)- 赋能中心 - 致远学院 - 搜索2025年V5产品安全培训 |
| 产品相关安全问题通用处理方法（第一步必做事项） | 通用处理方法：必须下载最新的漏洞扫描工具进行扫描并打上所有安全相关的补丁 确定漏扫工具漏洞全部处置完成，还有问题的话，再做后续的自查、自检和问题上报 |
| 产品相关安全问题通用处理方法（第二步必做事项） | 1、公司协同-CoMi图标-安全智能客服录入问题搜索答案 2、开放平台-FAQ搜索安全问题，有各种安全问题处理方法 3、同样可以开放平台-CoMi一搜智能搜索，用自然语言的形式一个一个叙述问题寻找解决方案（开放平台记录了大量常见安全问题处理方法，弱口令、明文传输、版本号泄漏等等问题都有说明） |
| 特殊安全问题：开源jar包组件版本漏洞 | 1、此类问题上报安全问题流程，经过安全老师评估是否支持 2、不是所有问题都能修复，比如一个2022年发版的版本，现在要把jar包升级到2026年几乎不可能（有些jar存在依赖，看似升级一个jar实际是升级关联的10个jar） 3、无法升级的jar，一般是做“漏洞无法利用”的说明，如果漏洞会被利用，安全团队一定会处理 4、此类开源jar版本扫描宜早不宜晚，尽量使用OA最新版本，每个新版本都会规划将jar升级到稳定版 |
| 特殊安全问题：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、如果需要安全团队支持，需要给客户做报价，然后走安全问题支持单，安全团队计费支持 |
| 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研发所有发版资料 |
# 环境问题专项
| 维度 | 通路 |
|---|---|
| 压测工具和脚本 | 1、产品发版提供了研发标准的压测报告，如项目上没有压测合同，可以免费自取产品压测报告交付 [参考地址 (opens new window)] 2、如有自定义压力测试场景，需要投入额外工作量，必须签订合同，按开发工作量成本投入 3、如还有长时间稳定性测试、高可用性测试等特殊测试场景，同样需签订合同，按开发工作量成本投入 4、如客户聘请第三方做压测，建议将我们的压测脚本提供给三方参考，避免三方不理解我们的业务逻辑，编写脚本错漏 5、压测报错之后，提取错误关键字，去开放平台-FAQ搜索或智能搜索 能解决很多问题 |
| SeeyonDump工具 | V5性能监控dump工具-SeeyonDumpTools可用于打到OA中，定时抓取服务运行状态，方便做性能问题排查 [参考地址 (opens new window)] |
| 数据库索引检查工具 | 如果涉及数据库转库、数据库迁移场景，都需要事后进行数据库索引检查 [参考地址 (opens new window)] ， 数据库索引是提升性能非常重要的指标，缺失关键索引会引发系统缓慢、卡顿。 |
| OA宕机问题排查方法 | 1、研发于2025年开展了“系统宕机性能问题初步排查方法”人人过关培训，系统性讲解了自助排查方法 2、项目组成员需要组织提前自学掌握，遇到问题时及时抓取信息上报BUG，没有预排查信息研发不会受理问题：协同云-赋能中心-致远学院-搜索“系统宕机性能问题初步排查方法” 3、为什么没有预排查信息，研发不会受理问题：性能宕机问题讲求实时性，一定要在出问题的时候及时提取到相关的信息，等事后重启OA了，再分析毫无意义，问题过程的关键信息都没了，没人能分析。注意这里的过程信息不是logs下的日志，那个是业务日志，对排查性能问题无意义。 |
| 系统环境检查 | 1、如果可以用环境检查工具则用环境检查工具：https://support.seeyon.com/cbo_cptjxx.html?id=1554733797281370113 2、如果不能用，就用S1，最新的S1里面内嵌了环境检查 3、人工巡检 - [系统环境巡检清单模板 (opens new window)] |
| 单个功能、性能问题排查思路 | 开放平台-技术文档- [问题调试分析方法 (opens new window)] |
| 大量性能宕机问题案例合集 | [性能宕机问题案例 (opens new window)]，有时间学习一下，能收获很多 |
# 数据库常见问题处理方案专项
| 维度 | 通路 |
|---|---|
| 数据库由我们维护吗？ | 不是。产品报价中没有数据库的报价，数据库安装部署维护是客户负责，项目上可根据团队自身能力做对应运维报价。 |
| 我们产品对数据库有哪些核心要求？ | 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)] |
| 表单数据清理、指定数据清理、公文正文附件替换、人员恢复 | S1工具具备这些恢复、修复的功能，使用S1完成 S1有的功能，不提供SQL修复方法 |
编撰人：het、admin
快速跳转
