ShowMeBug 核心技术内幕

ShowMeBug 是一款远程面试工具，双方可通过在线面试板进行实时沟通技术。所以关键技术要点在于 “实时同步”。关于实时同步，ShowMeBug 采用了以下技术。

OT 转换算法

本质上，ShowMeBug 核心就是多人同时在线实时编辑，难点即在这里。因为网络原因，操作可能是异步到达，丢失，与他人操作冲突。想想这就是个复杂的问题。

经过研究，最好用户体验的方式是 OT 转换算法。此算法由 1989 年 C. Ellis 和 S. Gibbs 首次提出，目前像 quip，google docs 均用的此法。

OT 算法允许用户自由编辑任意行，包括冲突的操作也可以很好支持，不用锁定。它的核心算法如下：

文档的操作统一为以下三种类型的操作（ Operation ）：

1. retain(n): 保持 n 个字符
2. insert(s): 插入字符串 s
3. delete(s): 删除字符串 s

然后客户端与服务端各记录历史版本，每次操作都经过一定的转换后，推送给另一端。

转换的核心是

S(o_1, o_2) = S(o_2, o_1)

换言之，把正在并发的操作进行转换合并，形成新的操作，然后应用在历史版本上，就可以实现无锁化同步编辑。

下图演示了对应的操作转换过程。

这个算法的难点在于分布式的实现。客户端服务端均需要记录历史，并且保持一定的序列。还要进行转换算法处理。

OT Rails 侧的处理

本质上，这是一个基于 websocket 的算法应用。所以我们没有怀疑就选用 ActionCable 作为它的基础。想着应该可以为我们节省大量的时间。实际上，我们错了。

ActionCable 实际上与 NodeJS 版本的 socket.io 一样，不具备任何可靠性的保障，做一些玩意性的聊天工具还可以，或者做消息通知允许丢失甚至重复推送的弱场景是可以的。但像 OT 算法这种强要求的就不可行了。

因为网络传输的不可靠性，我们必须按次序处理每一个操作。所以首先，我们实现了一个互斥锁，也就是针对某一个面试板，准备一个锁，同时只有一个操作可以进行操作。锁采用了 Redis 锁。实现如下：

 def unlock_pad_history(lock_key) logger.debug "[padable] unlock( lock_key: #{lock_key} )..." old_lock_key = REDIS.get(_pad_lock_history_key) if old_lock_key == lock_key REDIS.del(_pad_lock_history_key) else log = "[FIXME] unlock_pad_history expired: lock_key=#{lock_key}, old_lock_key=#{old_lock_key}" logger.error(log) e = RuntimeError.new(log) ExceptionNotifier.notify_exception(e, lock_key: lock_key, old_lock_key: old_lock_key) end end # 为防止死锁，锁的时间为 5 分钟，超时自动解锁，但在 unlock 时会发出异常 def lock_pad_history(lock_key) return REDIS.set(_pad_lock_history_key, lock_key, nx: true, ex: 5*60) end def wait_and_lock_pad_history(lock_key, retry_times = 200) total_retry_times = retry_times while !lock_pad_history(lock_key) sleep(0.05) logger.debug '[padable] locked, waiting 50ms...' retry_times-=1 raise "wait_and_lock_pad_history(in #{total_retry_times*0.1}s) #{lock_key} failed" if retry_times == 0 end logger.debug "[padable] locking it(lock_key: #{lock_key})..." end 

服务端的并发控制完毕后，客户端通过 “状态队列” 技术一个个排队发布操作记录，核心如下：

class PadChannelSynchronized { sendHistory(channel, history){ channel._sendHistory(history) return new PadChannelAwaitingConfirm(history) } } class PadChannelAwaitingConfirm { constructor(outstanding_history) { this.outstanding_history = outstanding_history } sendHistory(channel, history){ return new PadChannelAwaitingWithHistory(this.outstanding_history, history) } receiveHistory(channel, history){ return new PadChannelAwaitingConfirm(pair_history[0]) } confirmHistory(channel, history) { if(this.outstanding_history.client_id !== history.client_id){ throw new Error('confirmHistory error: client_id not equal') } return padChannelSynchronized } } class PadChannelAwaitingWithHistory { sendHistory(channel, history){ let newHistory = composeHistory(this.buffer_history, history) return new PadChannelAwaitingWithHistory(this.outstanding_history, newHistory) } } let padChannelSynchrOnized= new PadChannelSynchronized() export default padChannelSynchronized 

以上，便实现了一个排队发送的场景。

除此之外，我们设计了一个 PadChannel 用来专门管理与服务器通信的事件，维护历史的状态，处理断线重传，操作转换与校验。

定义自己的历史（ history) 协议

解决了编辑器协同的问题，才是真正的问题的开始。每次的 ”代码运行”，“编辑”，“清空终端”，“首次同步” 都是需要记录的历史操作。于是，ShowMeBug 定义了以下协议：

 # 包含以下: edit( 更新编辑器内容 ), run( 执行命令 ), clear( 清空终端 ), sync( 同步数据 ) # select( 光标 ), locate( 定位 ) # history 格式如下: # # { # op: 'run' | 'edit' | 'select' | 'locate' | 'clear' # id: id // 全局唯一操作自增 id, 首次前端传入时为 null, 服务端进行填充, 如果返回时为空, 则说明此 history 被拒绝写入 # version: 'v1' // 数据格式版本 # prev_id: prev_id // JS 端生成 history 时上一次收到服务端的 id, 用于识别操作序列 # client_id: client_id // 客户端生成的 history 的唯一标识 # creator_id: creator_id // 操作人的用户 id, 为了安全首次前端传入时为 null，由中台填充 # event: { // op 为 edit 时, 记录编辑器 OT 转化后的数据, see here: https://github.com/Aaaaash/blog/issues/10 # [length, "string", length] # // op 为 select 时, 记录编辑器选择区域(包括光标) # } # snapshot: { # editor_text: '' // 记录当前编辑器内容快照, 此快照由服务端填充 # language_type: '' // 记录当前编辑器的语言种类 # terminal_text: '' // 记录当前终端快照 # } # } # created_at: created_at // 生成时间 

值得说明的是，client_id 是客户端生成的一个 8 位随机码，用于去重和与客户端进行 ACK 确认。

id 是由服务端 Redis 生成的自增 id，客户端会根据这个判断历史是否是新的。prev_id 用来操作转换时记录所需要进行转换操作的历史队列。

event 是最重要的操作记录，我们用 OT 的转换数据进行存储，如: [length, "string", length]

通过上述的设计，我们将面试板的所有操作细节涵盖了，从而实现多人面试实时同步，面试题和面试语言自动同步，操作回放等核心功能。

总结

篇幅限制，这里只讲到 ShowMeBug 的核心技术，更多的细节我们以后继续分享。

ShowMeBug 目前承载了 3000 场面试记录，成功支撑大量的实际面试官的面试，可靠性已得到进一步保障。这里面有两种重要编程范式值得考虑：

1. 如何在不可信链路上设计一种有序可靠的交付协议，定义清晰的协议数据和处理好异步事件是关键。
2. 如何平衡研发效率与稳定性之间的关系，比如实现的忙等锁，允许一定原因的失败，但处理好用户的提示与重试。既高效完成了功能，又不影响到用户体验。

ShowMeBug( https://www.showmebug.com ) 让你的技术面试更高效，助你找到你想要的候选人。