前两天通过咱的 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 参数，在插入文档的时候可以同时写入属性。
Quicker 您的指尖工具箱！操作更少，收获更多！
AngularJS 诞生于 2009 年，由 Misko Hevery 等人创建，后为 Google 所收购。是一款优秀的前端 JS 框架，已经被用于 Google 的多款产品当中。AngularJS 有着诸多特性，最为核心的是：MVC、模块化、自动化双向数据绑定、语义化标签、依赖注入等。2.0 版本后已经改名为 Angular。
1999 年 2 月腾讯正式推出“腾讯 QQ”，在线用户由 1999 年的 2 人（马化腾和张志东）到现在已经发展到上亿用户了，在线人数超过一亿，是目前使用最广泛的聊天软件之一。
Pipe 是一款小而美的开源博客平台。Pipe 有着非常活跃的社区，可将文章作为帖子推送到社区，来自社区的回帖将作为博客评论进行联动（具体细节请浏览 B3log 构思 - 分布式社区网络）。
这是一种全新的网络社区体验，让热爱记录和分享的你不再感到孤单！
锤子科技（Smartisan）成立于 2012 年 5 月，是一家制造移动互联网终端设备的公司，公司的使命是用完美主义的工匠精神，打造用户体验一流的数码消费类产品（智能手机为主），改善人们的生活质量。
i18n（其来源是英文单词 internationalization 的首末字符 i 和 n，18 为中间的字符数）是“国际化”的简称。对程序来说，国际化是指在不修改代码的情况下，能根据不同语言及地区显示相应的界面。
Eclipse 是一个开放源代码的、基于 Java 的可扩展开发平台。就其本身而言，它只是一个框架和一组服务，用于通过插件组件构建开发环境。
Logseq 是一个隐私优先、开源的知识库工具。
Logseq is a joyful, open-source outliner that works on top of local plain-text Markdown and Org-mode files. Use it to write, organize and share your thoughts, keep your to-do list, and build your own digital garden.
OpenStack 是一个云操作系统，通过数据中心可控制大型的计算、存储、网络等资源池。所有的管理通过前端界面管理员就可以完成，同样也可以通过 Web 接口让最终用户部署资源。
大数据（big data）是指无法在一定时间范围内用常规软件工具进行捕捉、管理和处理的数据集合，是需要新处理模式才能具有更强的决策力、洞察发现力和流程优化能力的海量、高增长率和多样化的信息资产。
Chrome 又称 Google 浏览器，是一个由谷歌公司开发的网页浏览器。该浏览器是基于其他开源软件所编写，包括 WebKit，目标是提升稳定性、速度和安全性，并创造出简单且有效率的使用者界面。
星云链是一个开源公链，业内简单的将其称为区块链上的谷歌。其实它不仅仅是区块链搜索引擎，一个公链的所有功能，它基本都有，比如你可以用它来开发部署你的去中心化的 APP，你可以在上面编写智能合约，发送交易等等。3 分钟快速接入星云链 (NAS) 测试网
前端技术一般分为前端设计和前端开发，前端设计可以理解为网站的视觉设计，前端开发则是网站的前台代码实现，包括 HTML、CSS 以及 JavaScript 等。
小薇是一个用 Java 写的 QQ 聊天机器人 Web 服务，可以用于社群互动。
由于 Smart QQ 从 2019 年 1 月 1 日起停止服务，所以该项目也已经停止维护了！
发布对别人有帮助的原创内容是最好的 SEO 方式。
服务器，也称伺服器，是提供计算服务的设备。由于服务器需要响应服务请求，并进行处理，因此一般来说服务器应具备承担服务并且保障服务的能力。
有点意思就行了
VirtualBox 是一款开源虚拟机软件，最早由德国 Innotek 公司开发，由 Sun Microsystems 公司出品的软件，使用 Qt 编写，在 Sun 被 Oracle 收购后正式更名成 Oracle VM VirtualBox。
RabbitMQ 是一个开源的 AMQP 实现，服务器端用 Erlang 语言编写，支持多种语言客户端，如：Python、Ruby、.NET、Java、C、PHP、ActionScript 等。用于在分布式系统中存储转发消息，在易用性、扩展性、高可用性等方面表现不俗。
Cloud Foundry 是 VMware 推出的业界第一个开源 PaaS 云平台，它支持多种框架、语言、运行时环境、云平台及应用服务，使开发人员能够在几秒钟内进行应用程序的部署和扩展，无需担心任何基础架构的问题。
支付宝是全球领先的独立第三方支付平台，致力于为广大用户提供安全快速的电子支付/网上支付/安全支付/手机支付体验，及转账收款/水电煤缴费/信用卡还款/AA 收款等生活服务应用。
etcd 是一个分布式、高可用的 key-value 数据存储，专门用于在分布式系统中保存关键数据。
flomo 是新一代 「卡片笔记」 ，专注在碎片化时代，促进你的记录，帮你积累更多知识资产。
C 语言是一门通用计算机编程语言，应用广泛。C 语言的设计目标是提供一种能以简易的方式编译、处理低级存储器、产生少量的机器码以及不需要任何运行环境支持便能运行的编程语言。
Openfire 是开源的、基于可拓展通讯和表示协议 (XMPP)、采用 Java 编程语言开发的实时协作服务器。Openfire 的效率很高，单台服务器可支持上万并发用户。
欢迎来到这里！
我们正在构建一个小众社区，大家在这里相互信任，以平等 • 自由 • 奔放的价值观进行分享交流。最终，希望大家能够找到与自己志同道合的伙伴，共同成长。
注册 关于