功能升级 | Choerodon猪齿鱼“新”知识管理介绍

Choerodon猪齿鱼知识管理是一种内容管理工具，具有创建、编辑、导航、链接、搜索等功能。它为企业、IT团队提供方便的项目协作平台和强大的项目内容管理平台，集中式管理产品相关内容等，例如需求收集、架构设计、功能设计、开发规范、命名规范、会议记录、计划安排等。

在0.17版本中，猪齿鱼上线了新的知识管理，作为项目团队内容管理功能，并在0.18做了升级和功能增强，而原有的承载知识管理功能的Wiki管理将在0.19版本正式下线。

那么，这个新的知识管理和之前的“知识管理（Wiki管理）”有何不同？

新老知识管理有何区别？

猪齿鱼早期的知识管理——“Wiki管理”是团队基于开源产品XWiki所开发。XWiki是一个由Java编写的基于LGPL协议发布的开源wiki和应用平台，基本涵盖了在知识、文档管理等方面所需的各种大小功能。但随着产品的不断演进，XWiki官方团队减少对产品的投入，大大降低了迭代以及运维的效率。

而0.18版本中使用的知识管理则由猪齿鱼团队自行开发，内置于猪齿鱼平台，不再需要跳转至Wiki空间，保留了文档编辑、分享、管理等基本功能，整体上更加轻量。

为什么要重新开发一个新的知识管理服务？

随着更多新用户的增加以及数据的不断积累，XWiki已经无法满足用户在体验和操作上的更高需求，根据社区成员和用户的反馈，猪齿鱼进行了商议和选型，经过1个迭代的周期推出了新的知识管理。

选择重新开发的原因有很多，主要有以下几点：

▍1. 功能开发成本高

Wiki管理自上线以来，一直在不断迭代优化，但猪齿鱼在实际开发过程中发现，针对wiki管理的功能优化，即使是一些普遍性需求，功能开发代价也常常加倍。

比如使用频率很高的分享功能，由于原XWiki中的分享功能在猪齿鱼平台中无法满足到用户的需求，猪齿鱼只能进行二次开发。在开发过程中，经常会因为一些诸如需要先读懂源代码逻辑等工作，让工作量超出预期，反而降低了团队的开发效率。

▍2. 升级引起重构

猪齿鱼引用XWiki(版本)实现了内容的管理，但同时，为了满足用户的需求，一般都会对其进行二次开发，在此情况下，如果猪齿鱼跟随官方对XWiki进行了升级，那就意味着二次开发代码的重构，升级的不确定性会带来很大的成本，因此弃用XWiki并开发新的知识管理很有必要。

▍3. 操作较为复杂，用户体验不佳

猪齿鱼是一个既追求产品功能又重视产品体验的平台。在前几个版本中，开发者更多地是在关注功能是否缺失，可随着产品功能的逐步完善，产品经理和设计师的关注度逐步向体验和操作转移。

根据产品团队的不完全统计，针对Wiki管理，社区论坛上关于操作的问题达到50%以上，性能问题达到了20%以上，比如：

1、Wiki服务与猪齿鱼平台用户同步的问题；
2、权限配置的问题；
3、左侧树形菜单结果加载过慢问题。

这一切本不该出现的问题，占到了总数的70%，此时，猪齿鱼团队更加确定Wiki必须重构。

猪齿鱼知识管理服务上线

从决定重构，选型，开发再到最后的上线，开发团队前后花了大概3周的时间，在0.17版本发布了一个可用的基础版。

新的知识管理是一个开发轻量级，操作简便的内容管理工具，具有最基本的创建、编辑、导航、链接、版本回滚、搜索等功能，组织层和项目层均有属于自己的知识管理服务。

一、操作和体验

▍1. 安装、升级更加快捷

无需引入第三方XWiki，可直接部署、升级猪齿鱼知识管理服务。

▍2. 操作简单，弱化了权限设置操作，突出团队共享

结构权限上与之前的Wik相比，没变的是同项目的成员可查看项目内创建的所有文档，不同的是组织层的文档，各个项目成员均能查看；

项目成员可对其他成员创建的文档进行编辑，但只能删除自己创建的文档。

▍3. 界面布局清晰，无需手册容易上手

二、功能

▍1. 文档的创建与编辑

• 创建文档即是创建内容也是创建页面；
• 编辑器支持基本的编辑需要；
• 支持实时保存，离开界面时，会进行确认提醒；
• 支持2种编辑模式：markdown/所见即所得。

▍2. 文档的查看

• 点击左侧树形菜单结构进行查看（无限层级）；
• 支持全局搜索查看；
• 可显示目录，通过目录跳转到目标位置进行查看；
• 可针对文档进行评论、附件上传；
• 面包屑导航显示文档的位置；
• 可通过分享链接的方式，分享自己创建的文档，非项目成员可通过分享的链接查看文档。

▍3. 其他操作

• 文档可在左侧树型菜单上自由移动，可移动单个文档或文档集；
• 支持Word格式文档的导入；
• 支持PDF的导出；
• 支持版本回滚以及历史版本对比（并显示新增和删除记录）；
• 所有操作日志的记录。

针对知识管理，猪齿鱼团队会逐步迭代，进行功能和操作体验的提升。希望重构后的知识管理可以更好地帮助到大家，也欢迎大家多多反馈，开发团队会积极回应大家的需求和意见。

插播通知

Choerodon猪齿鱼将于0.19版本正式取消Wiki管理功能，所有文档内容管理相关操作请大家在知识管理中进行。

Wiki管理和知识管理会在0.18版本中并行，方便用户进行数据迁移。Choerodon猪齿鱼系统已经将所有用户所属项目空间下的Wiki文档自动迁移至知识管理，如您在wiki空间中还有新的增改，可点击知识管理菜单栏上方“wiki迁移”进行手动二次迁移。