跟进提及同事

解决本地跟进记录中的协作者指派痛点

在客户拜访或项目跟进的日常开发中，我们经常需要在内嵌的备注文本框里点名相关的同事（例如 @张三）来提醒协同。然而，原生的 input 或 textarea 并不具备自动补全和提及功能。直接引入重型的聊天组件不仅体积庞大，还会带来不必要的状态管理负担。本技能旨在用轻量级的方式，为现有的跟进备注框赋予本地同事名单的 @ 提及能力。

核心实现与关键步骤

该技能基于 tributejs 构建，核心思路是将本地同事名册作为 values 传入并挂载到目标文本框上。

• 数据准备：维护一份本地同事列表，确保每个候选项至少包含 key 和 value 字段。
• 组件挂载：在跟进备注框初始化时调用 attach 方法，传入同事列表。当用户输入触发符（默认为 @）时，会自动唤出下拉菜单。
• 标记写入：选中目标后，文本框内会插入可读的标记（如 @姓名），同时业务层可以额外存储对应的 userId 以便后端处理。
• 生命周期管理：在组件卸载（如 onBeforeUnmount）时，必须调用 destroy（或 detach）方法。

适用边界与避坑指南

本技能专注于本地提及与 UI 交互，不包含也不应扩展至全站消息中心、消息推送或已读回执等重型业务逻辑。

• 防泄漏与内存清理：切勿在组件销毁时忘记调用 detach，否则会导致重复菜单和潜在的内存泄漏。
• 职责分离：不要将企业微信或整站聊天系统的推送逻辑塞进本 Skill，保持其轻量、纯粹的输入增强属性。