前两天通过咱的 api 写插件，碰到个问题，这里记录一下，希望 D 大看看如何优化一下。
场景：
我通过/api/filetree/createDocWithMd 接口写入文档，同时需要找到文档内容 blocks 的 ids，保存至 doc 的自定义属性中，以此让两者产生关联。
问题：
通过 api 写入文档后，仅返回了 doc_id，并没有返回任何内容相关的信息，我需要单独通过 sql 接口查，但是呢，可能是因为文档数据和 db 数据同步需要一定时间，马上去查 blocks 就会查不到任何数据，等会再查就没问题。
所以，我的解决方案是延时的循环查询，直到查到数据或超出最大循环次数。
不知道是否有更优的解决方案，或者该 api 接口能否在文档数据和 db 数据全部处理完毕后再返回结果？
可参考相关方法的 143、187 行。
我要做的是： 基于 markdown 创建 A 文档，然后把子块的 ids 写入 A 到的 attrs 里。
我目前的解决方案不是非常好，也仅仅是根据目前 api 和我的能力，想到的一种方案。
实际场景：
把浏览器的一个书签以 doc 的方式插入到 siyuan。这是最根本的需求。
由于 doc 内无法直观的看到 attrs，所以在创建 doc 的时候，把链接地址写入到了文档中，生成了 block。方便浏览文档的时候一键打开网站。
然后，为了修改浏览器书签的时候，能同时能更新到此 block，我用到的笨办法就是把 blockId 写入到 doc 的 attrs 里。
这是我目前的实现方式。从头到尾只有一个 doc 和它的一个子 block。
当然，也还有其它的解决方案，希望 D 大择优考虑。
方案 1：页面能直观展示 attrs。
（这样就避免在正文中插入 block 了）
方案 2：doc 的 title 有 url 属性，就好像有 icon 属性一样，直接在 title 上加超链接。
（同样不需要在正文插入 block；而且还自带超链接）
方案 3：能直接为 doc 插入新 block。插入 block 时，可同时写 docId 至 block 的 attrs，从而达到二者关联。
（另外，希望 1.6.0 的 api/block/insertBlock，不仅可以靠 previousID，也可以靠 docID 作为参数）
以上是大概的场景，希望对 api 设计有帮助。
能有 prependBlock 和 appendBlock 是最好了
那我就等 api 放出了。
另外，希望 insertBlock prependBlock appendBlock 增加 attrs 参数，在插入文档的时候可以同时写入属性。
发布对别人有帮助的原创内容是最好的 SEO 方式。
PWA（Progressive Web App）是 Google 在 2015 年提出、2016 年 6 月开始推广的项目。它结合了一系列现代 Web 技术，在网页应用中实现和原生应用相近的用户体验。
各种网址链接、内容导航。
Redis 是一个开源的使用 ANSI C 语言编写、支持网络、可基于内存亦可持久化的日志型、Key-Value 数据库，并提供多种语言的 API。从 2010 年 3 月 15 日起，Redis 的开发工作由 VMware 主持。从 2013 年 5 月开始，Redis 的开发由 Pivotal 赞助。
让我们欢迎这对新人。哦，不好意思说错了，让我们欢迎这位新人！
新手上路，请谨慎驾驶！
GitBook 使您的团队可以轻松编写和维护高质量的文档。 分享知识，提高团队的工作效率，让用户满意。
上帝为你关上了一扇门，然后就去睡觉了....努力不一定能成功，但不努力一定很轻松 (° ー °〃)
资讯是用户因为及时地获得它并利用它而能够在相对短的时间内给自己带来价值的信息，资讯有时效性和地域性。
JRebel 是一款 Java 虚拟机插件，它使得 Java 程序员能在不进行重部署的情况下，即时看到代码的改变对一个应用程序带来的影响。
Lute 是一款结构化的 Markdown 引擎，支持 Go 和 JavaScript。
jQuery 是一套跨浏览器的 JavaScript 库，强化 HTML 与 JavaScript 之间的操作。由 John Resig 在 2006 年 1 月的 BarCamp NYC 上释出第一个版本。全球约有 28% 的网站使用 jQuery，是非常受欢迎的 JavaScript 库。
gzip （GNU zip）是 GNU 自由软件的文件压缩程序。我们在 Linux 中经常会用到后缀为 .gz 的文件，它们就是 Gzip 格式的。现今已经成为互联网上使用非常普遍的一种数据压缩格式，或者说一种文件格式。
Vue.js（读音 /vju ː/，类似于 view）是一个构建数据驱动的 Web 界面库。Vue.js 的目标是通过尽可能简单的 API 实现响应的数据绑定和组合的视图组件。
Mobi.css is a lightweight, flexible CSS framework that focus on mobile.
WordPress 是一个使用 PHP 语言开发的博客平台，用户可以在支持 PHP 和 MySQL 数据库的服务器上架设自己的博客。也可以把 WordPress 当作一个内容管理系统（CMS）来使用。WordPress 是一个免费的开源项目，在 GNU 通用公共许可证（GPLv2）下授权发布。
我来 wolai：不仅仅是未来的云端笔记！
黑曜石是一款强大的知识库工具，支持本地 Markdown 文件编辑，支持双向链接和关系图。
A second brain, for you, forever.
OkHttp 是一款 HTTP & HTTP/2 客户端库，专为 Android 和 Java 应用打造。
网络爬虫（Spider、Crawler），是一种按照一定的规则，自动地抓取万维网信息的程序。
微软是一家美国跨国科技公司，也是世界 PC 软件开发的先导，由比尔·盖茨与保罗·艾伦创办于 1975 年，公司总部设立在华盛顿州的雷德蒙德（Redmond，邻近西雅图）。以研发、制造、授权和提供广泛的电脑软件服务业务为主。
SpaceVim 是一个社区驱动的模块化 vim/neovim 配置集合，以模块的方式组织管理插件以
及相关配置，为不同的语言开发量身定制了相关的开发模块，该模块提供代码自动补全，
语法检查、格式化、调试、REPL 等特性。用户仅需载入相关语言的模块即可得到一个开箱
即用的 Vim-IDE。
正则表达式（Regular Expression）使用单个字符串来描述、匹配一系列遵循某个句法规则的字符串。
用爱发电 (Programming With Love) 是一个以开源精神为核心的民间开源爱好者技术组织，“用爱发电”象征开源与贡献精神，加入组织，代表你将遵守组织的“个人开源爱好者”的各项条款。申请加入：用爱发电组织邀请帖。
用爱发电组织官网：https://programmingwithlove.stackoverflow.wiki/
NetBeans 是一个始于 1997 年的 Xelfi 计划，本身是捷克布拉格查理大学的数学及物理学院的学生计划。此计划延伸而成立了一家公司进而发展这个商用版本的 NetBeans IDE，直到 1999 年 Sun 买下此公司。Sun 于次年（2000 年）六月将 NetBeans IDE 开源，直到现在 NetBeans 的社群依然持续增长。
iOS 是由苹果公司开发的移动操作系统，最早于 2007 年 1 月 9 日的 Macworld 大会上公布这个系统，最初是设计给 iPhone 使用的，后来陆续套用到 iPod touch、iPad 以及 Apple TV 等产品上。iOS 与苹果的 Mac OS X 操作系统一样，属于类 Unix 的商业操作系统。
webpack 是一个用于前端开发的模块加载器和打包工具，它能把各种资源，例如 JS、CSS（less/sass）、图片等都作为模块来使用和处理。
深度学习（Deep Learning）是机器学习的分支，是一种试图使用包含复杂结构或由多重非线性变换构成的多个处理层对数据进行高层抽象的算法。
欢迎来到这里！
我们正在构建一个小众社区，大家在这里相互信任，以平等 • 自由 • 奔放的价值观进行分享交流。最终，希望大家能够找到与自己志同道合的伙伴，共同成长。
注册 关于