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迁移”进行手动二次迁移。

关于猪齿鱼​

Choerodon 猪齿鱼是一个全场景效能平台，基于 Kubernetes 的容器编排和管理能力，整合 DevOps 工具链、微服务和移动应用框架，来帮助企业实现敏捷化的应用交付和自动化的运营管理的平台，同时提供 IoT、支付、数据、智能洞察、企业应用市场等业务组件，致力帮助企业聚焦于业务，加速数字化转型。

大家也可以通过以下社区途径了解猪齿鱼的最新动态、产品特性，以及参与社区贡献：

• 官网：http://choerodon.io
• 论坛：http://forum.choerodon.io
• Github：https://github.com/choerodon

知识管理是Choerodon猪齿鱼的一个重要功能，支持在线自定义文档编辑、成员协助共享等功能，帮助团队集中管理创意、需求和设计。本文将会和大家聊一聊知识管理对敏捷团队的重要性，介绍Choerodon选用XWiki作为开发基础的原因，以及开发团队如何设计Choerodon知识管理，最后会简单介绍一下Choerodon知识管理的一些主要功能和特色。

敏捷团队的知识管理

对于软件开发团队来说，每个成员都是知识工作者，知识工作者需要具备一个很重要的能力——知识管理能力。知识是软件行业的灵魂和生存之本，然而很多时候大家都忽略或轻视了团队知识管理的重要性，所以Choerodon希望能够为团队提供一个便捷高效的知识管理方式。

Choerodon猪齿鱼知识管理是为了解决敏捷团队在快速迭代的开发过程中可能忽视的知识沉淀、文档管理和团队协作等问题而诞生的。

印第安人在赶了3天路之后，会停下来小憩一天，因为他们要等待自己的灵魂跟上来。敏捷开发过程也是如此，在经历一个迭代或者冲刺之后，也需要做一些休整，那就是敏捷回顾。每次回顾时，团队成员需要归纳总结开发过程中积累下来的各种问题或经验，并将这些知识记录在可共享的wiki上，这样既便于团队成员互相学习，也利于以后需要时快速查阅。

为什么基于XWiki开发Choerodon知识管理

现在常见到的wiki有很多，开源免费的如 MediaWiki、DokuWiki，企业收费的如 Confluence等。在开发Choerodon猪齿鱼知识管理初期，团队希望能够选择一款既开源，又能针对Choerodon猪齿鱼平台的应用场景，做定制化的wiki系统。比如适应Choerodon的组织项目层级结构，以及与Choerodon猪齿鱼中的敏捷管理、测试管理等做更多的互动，让用户能够在使用平台时，快速准确地记录下自己的知识，让知识管理在应用交付和自动化运营过程中发挥更大的价值。在经过许久对比和甄选之后，团队选择了一个优秀、强大的开源wiki系统——XWiki。

XWiki是由一家法国的公司XWiki SAS于2004年开发出的一款wiki系统，并于2007年开源。至今已经10多年，这个社区仍然有众多活跃的贡献者和使用者,并且拥有大量的客户群体和产品案例。XWiki有健壮的编辑器、强大的编辑语法，能提供多种拓展特性来定制化wiki。除了XWiki官方提供的功能以外，还有超过100个社区参与者贡献的拓展项目，这些拓展都可以直接在XWiki系统的拓展市场上安装和管理。

XWiki、Confluence以及MediaWiki对比​

接下来通过XWiki与Confluence以及MediaWiki的对比，来谈谈Choerodon为什么选择XWik作为其知识管理的基础。

XWiki是一个开源的项目，使用了LGPL开源协议，使用者可自己搭建和拓展XWiki而不需要购买任何授权。它使用java语言开发，提供了众多面向企业的特性，并且拥有丰富的拓展库和宏，灵活性与拓展性很强。有许多如Amazon、AFP、EDF等大型的公司使用XWiki创建知识库或者协作工具，也有一些企业和组织使用XWiki搭建门户网站。

Confluence是一个团队协作软件，由澳大利亚的公司Atlassian开发和销售，它是一个面向业务的专业wiki，使用java开发，主要应用于企业环境。目前Confluence有许多大型客户案例，如Facebook、eBay、Adobe等，不过使用Confluence，需要向Atlassian公司购买授权。

MediaWiki是一款使用PHP开发的开源wiki软件，它最著名的案例就是维基百科，所以也是受众最大的wiki。MediaWiki支持多语言管理、各种扩展和媒体格式，还能够配置wiki外观。但是MediaWiki在权限管理，组织架构管理上并不适合Choerodon的解决方案，也不太适用企业的业务需求。

除了上面谈到的三款wiki软件之外，我们还对比了其他比较流行的wiki软件，综合考虑之后，最终选择了开源的、有强大的拓展特性以及适应企业多种业务场景的XWiki。

Choerodon猪齿鱼知识管理的设计

Choerodon猪齿鱼平台是基于spring cloud的微服务架构开发，而Choerodon知识管理选择以XWiki作为开发的基础，那么就需要做到统一的用户、权限以及组织架构。因此开发团队开发了微服务wiki-service，这个微服务主要用于监听Choerodon平台中其他服务的操作，比如IAM的创建组织、创建项目等，然后使用http请求的形式，让XWiki做对应的业务处理，比如创建对应的空间和页面。另外XWiki需要使用Choerodon猪齿鱼平台统一的登录和权限校验，所以Choerodon在XWiki中添加了OAuth登录认证。下图是Choerodon猪齿鱼知识管理设计示意图：

Choerodon猪齿鱼平台中有三层组织层次，即全局层、组织层和项目层。Choerodon 使用三层组织结构来管理用户、权限、项目、环境资源、菜单，以及其他系统资源和功能。其中全局层包含了系统的一些基本设置，例如组织管理、菜单管理、全局角色管理等；组织层管理用户、权限、项目、环境资源，以及其它系统资源和功能；项目层用来管理软件的开发，项目属于组织。Choerodon知识管理也是按照组织层和项目层，以及组织和项目下的空间来管理wiki的。为了保证XWiki与Choerodon平台有统一的组织和项目以及组织、项目对应的人员、权限等，需要将每个组织项目的创建、角色分配等都在XWiki中做对应的处理。下图是当IAM创建一个组织时，wiki-service为保证数据一致性做的处理：

Choerodon猪齿鱼知识管理功能介绍

Choerodon知识管理实现了一个强大的Wiki平台，允许用户根据自己的特定需求自定义Wiki，为企业、IT团队提供方便的项目协作平台和强大的项目内容管理平台，集中式管理产品相关内容，例如需求收集、架构设计、功能设计、开发规范、命名规范、会议记录、计划安排等。目前Choerodon知识管理除基础的空间页面创建、文档编辑、文档共享等，还开发了一些特色功能，如个人空间、组织项目文档权限控制、匿名分享、文档模板等。

基本概念简介​

• 空间

空间相当于一个分组，它是一类文档的集合，组织和项目下都可以创建空间。在空间下可以创建对应类型的文档树，实现各类文档的分别维护和管理。

• 页面

页面是Wiki中的基本内容单元，也就是使用者在空间下创建的文档。页面可以创建在空间下或者在其他页面之下，这样用户就可以随意地组织团队的文档结构。页面可以进行编辑、分享、评论、收藏等操作，还支持使用多语法编辑和多人协作编辑，另外每个页面都可以有版本控制。

个人空间​

Choerodon知识管理中除了组织项目下的共享空间之外，Choerodon还设计了一种特殊的空间——个人空间。这个空间为每个wiki用户提供了一个私人的编辑区域，用户可以在个人空间中随意编辑和记录文档，并且可以选择将一些文档发布到需要的公开区域，比如某个组织或者项目下。

空间、页面权限​

在Choerodon知识管理中，空间和页面采用相同的权限模型，以用户组的形式配置权限。对于组织和项目下的空间、以及空间下的页面，在不单独配置权限的情况下，默认是继承组织和项目的权限的，也就是只有组织或者项目成员才可以查看。

同时，用户可以针对某个页面或者空间，个性化配置权限，可以是对某个用户组开放，也可以对所有人或者匿名用户开放，权限包括视图查看、评论、编辑、修改脚本、删除和设置管理员。如下图的权限配置页面所示：

匿名访问​

Choerodon知识管理的内容使用空间和页面的形式组织，并且受到组织项目权限的管控，当用户想将文档分享给未注册用户时，可以将一些需要公开的文档设置成可匿名访问，既不影响其他页面的权限，也保证了文档的安全。在权限设置中选择未注册用户勾选相应权限即可。

文档模板​

Choerodon知识管理预置了产品需求和敏捷回顾会议记录等文档的模板，可以直接进行编辑，简化了用户编辑排版操作。平台管理员也可以自定义创建团队常用文档模板、修改页面布局界面。

其他功能概述​

除了上面提到的几个特色以外，Choerodon知识管理还提供了比如：

• 所有更新、热门：用户可以查看最近wiki中发生的文档创建、编辑、评论等操作，以及一些浏览量较高的文档，能够了解到一些新的文档动态，及时的学习和共享。

• 最近工作、最近访问：用户可以在wiki中查看到自己最近编辑以及查看的文章，方便用户查看自己的历史操作记录。

• 通知：页面的操作可以通过站内信或者邮件的形式通知到关注者，帮助用户及时跟进文档的状态。

• 搜索：wiki系统提供了强大的文章搜索引擎，可以搜索到文章中的关键字，提高搜索精度。

• 导入、导出：页面还可以进行批量的导入导出，可以导入office文档，wiki会自动解析文档内容，并添加到页面中。

了解更多功能，请查看Choerodon知识管理用户手册。

总结

Choerodon Agent 自发布以来，经历了一系列优化与改进，不管是易用性还是稳定性都在不断提升，例如应用Chart模板中的资源对象将不用再预先插入平台所需要的标签，每个环境一个Agent客户端改成了一个集群一个客户端。增加了定期同步各资源状态的逻辑，有效地消除了平台中与集群的K8S资源状态的不一致，GitOps流程也越来越稳定。同时也感谢社区的朋友们反馈的一些Bug和建议，一起为产品完善而努力。

关于猪齿鱼​

Choerodon 猪齿鱼是一个全场景效能平台，基于 Kubernetes 的容器编排和管理能力，整合 DevOps 工具链、微服务和移动应用框架，来帮助企业实现敏捷化的应用交付和自动化的运营管理的平台，同时提供 IoT、支付、数据、智能洞察、企业应用市场等业务组件，致力帮助企业聚焦于业务，加速数字化转型。

大家也可以通过以下社区途径了解猪齿鱼的最新动态、产品特性，以及参与社区贡献：

• 官网：http://choerodon.io
• 论坛：http://forum.choerodon.io
• Github：https://github.com/choerodon

Choerodon猪齿鱼社区的架构师分别介绍了Choerodon猪齿鱼最新版本的各项核心功能，以及后续功能开发计划。比如在DevOps方面，会在已有部署、开发、构建相关的可视化图表基础上，增加新的报表，帮助用户直观了解开发情况。同时会增强分支管理与敏捷管理的任务可追溯性，更好地将开发过程融入项目管理。

双方在交流中，主要探讨了Choerodon使用过程中遇到的一些问题以及开发技巧。票易通团队从不同的角度提出了一些改进意见和需求，Choerodon猪齿鱼将从中汲取这些反馈，归纳出一些可以增加的功能和优化方向。

比如在部署实施方面，将权限进一步细化到单个应用、单个环境级别，使项目下的每个环境和应用可以单独授权给不同的成员；微服务方面，增加工具来进行K8S容器的监控和管理；基础组件应用方面，优化基础组件调度问题等。

本次两个团队的技术交流是Choerodon猪齿鱼社区首个团队面对面交流活动，Choerodon猪齿鱼社区致力于促进Choerodon猪齿鱼平台的创新与应用，提供分享与交流的平台，来帮助开发人员更好地了解和应用Choerodon猪齿鱼，使企业能够更快地构建出色的产品，最终实现敏捷化的应用交付和自动化的运营管理。

关于信息

欢迎通过我们的GitHub和猪齿鱼社区进行反馈与贡献，帮助Choerodon猪齿鱼不断成长，我们将持续迭代优化，敬请期待。