思源笔记API创建文档后文档树定位问题解析

问题背景

在思源笔记v3.1.21版本更新中，对文档创建时的文档树默认行为进行了调整。这一变更影响了通过API创建文档时的预期行为，特别是使用/api/filetree/createDoc接口时，文档树不再自动定位到新创建的文档上。

技术细节分析

思源笔记提供了一个用于创建文档的API接口/api/filetree/createDoc。在v3.1.21版本之前，调用此接口创建新文档后，文档树会自动展开并定位到新创建的文档节点。这一行为对于插件开发者来说非常有用，因为它提供了即时的视觉反馈。

然而，在v3.1.21版本中，这一默认行为被修改了。现在调用该API创建文档后，文档树不会自动定位到新文档，这可能导致用户体验上的不一致，特别是对于那些依赖这一行为的插件功能。

解决方案

根据官方回复，可以通过在API调用时传入listDocTree: true参数来恢复原有的文档树定位行为。这一参数设计允许开发者根据实际需求选择是否需要在创建文档后更新文档树视图。

最佳实践建议

对于插件开发者，建议在调用创建文档API时：

1. 明确指定listDocTree参数，而不是依赖默认行为
2. 根据功能需求决定是否需要立即更新文档树视图
3. 在文档中注明API行为可能随版本变化，做好兼容性处理

总结

思源笔记的这一变更体现了API设计上的灵活性，通过参数化控制文档树行为，既保留了原有功能，又提供了更多选择。开发者应当关注这类API行为的变化，及时调整插件实现，确保用户体验的一致性。