Latitude LLM项目中的Prompt共享功能设计与实现

在Latitude LLM项目中，团队设计并实现了一套类似Notion的Prompt共享系统，允许用户通过表单提交请求并获取LLM生成的响应。该系统不仅支持Prompt的发布、分享和复用，还提供了丰富的交互功能，如参数化配置、对话跟踪和分支创建等。以下将详细解析该功能的技术实现与设计思路。

核心功能模块

1. Prompt的发布与共享

用户可以将编写好的Prompt发布为公开文档，其他用户通过唯一URL访问。系统通过publishedDocumentUuid生成固定路径（如/share/d/:publishedDocumentUuid），并确保仅已发布的文档可被访问（草稿状态返回404）。发布状态通过开关按钮控制，支持实时切换。

2. 参数化与动态URL

Prompt支持参数化输入，用户提交的参数会动态更新URL，便于直接分享特定配置。例如，表单中的输入字段会映射为URL查询参数，实现“一次配置，直接复用”的效果。

3. 分支（Fork）机制

用户可对共享Prompt创建分支，系统会完整复制原Prompt及其嵌套的所有关联Prompt（深度克隆）。分支流程与登录/注册流程无缝集成，新用户注册后自动完成Prompt的克隆操作。

4. 交互与事件追踪

• 运行记录：每次执行Prompt会触发运行事件，记录调用详情。
• 访问统计：独立记录文档访问次数，帮助作者分析使用情况。
• 分支事件：跟踪Prompt被分支的次数，反映其复用价值。

5. 用户界面优化

• 模态框设计：分享功能通过多标签页模态框实现，包含URL预览、权限设置等选项。
• 侧边栏参数：运行时可折叠的侧边栏集中展示参数配置，提升表单填写效率。
• 响应展示：默认折叠Prompt历史消息，仅显示AI助手的最终响应，简化界面复杂度。

技术实现细节

状态管理与安全控制

• 发布校验：后端严格校验文档状态，未发布的请求返回定制化404页面，提示用户联系作者。
• 权限分离：编辑权限与查看权限解耦，确保分享链接仅允许查看或运行，避免未授权修改。

数据持久化与克隆逻辑

分支操作涉及深层数据复制，需递归处理Prompt内部的嵌套引用（如子Prompt），确保克隆后的功能完整性。实现时采用UUID重映射技术，避免数据冲突。

前端交互优化

• 工具提示：禁用分享按钮时显示原因提示（如“请先发布文档”）。
• URL同步：使用前端路由库（如React Router）监听参数变化，实时更新URL而不触发页面刷新。

总结

Latitude LLM的Prompt共享系统通过模块化设计平衡了灵活性与易用性，其核心在于参数化、事件追踪和分支机制的结合。这种设计不仅适用于LLM应用场景，也可为其他需要协作编辑和复用的工具提供参考。未来可进一步扩展权限粒度或集成版本控制，以支持更复杂的团队协作需求。