前两天通过咱的 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 参数，在插入文档的时候可以同时写入属性。
知乎是网络问答社区，连接各行各业的用户。用户分享着彼此的知识、经验和见解，为中文互联网源源不断地提供多种多样的信息。
JavaScript 一种动态类型、弱类型、基于原型的直译式脚本语言，内置支持类型。它的解释器被称为 JavaScript 引擎，为浏览器的一部分，广泛用于客户端的脚本语言，最早是在 HTML 网页上使用，用来给 HTML 网页增加动态功能。
有空闲时间是接外包好呢还是学习好呢？
Bootstrap 是 Twitter 推出的一个用于前端开发的开源工具包。它由 Twitter 的设计师 Mark Otto 和 Jacob Thornton 合作开发，是一个 CSS / HTML 框架。
IBM（国际商业机器公司）或万国商业机器公司，简称 IBM（International Business Machines Corporation），总公司在纽约州阿蒙克市。1911 年托马斯·沃森创立于美国，是全球最大的信息技术和业务解决方案公司，拥有全球雇员 30 多万人，业务遍及 160 多个国家和地区。
智能合约（Smart contract）是一种旨在以信息化方式传播、验证或执行合同的计算机协议。智能合约允许在没有第三方的情况下进行可信交易，这些交易可追踪且不可逆转。智能合约概念于 1994 年由 Nick Szabo 首次提出。
Electron 基于 Chromium 和 Node.js，让你可以使用 HTML、CSS 和 JavaScript 构建应用。它是一个由 GitHub 及众多贡献者组成的活跃社区共同维护的开源项目，兼容 Mac、Windows 和 Linux，它构建的应用可在这三个操作系统上面运行。
Git 是 Linux Torvalds 为了帮助管理 Linux 内核开发而开发的一个开放源码的版本控制软件。
我们平时所说的“架构”主要是指软件架构，这是有关软件整体结构与组件的抽象描述，用于指导软件系统各个方面的设计。另外还有“业务架构”、“网络架构”、“硬件架构”等细分领域。
子曰：“工欲善其事，必先利其器。”
深圳市大疆创新科技有限公司(DJI-Innovations，简称 DJI)，成立于 2006 年，是全球领先的无人飞行器控制系统及无人机解决方案的研发和生产商，客户遍布全球 100 多个国家。通过持续的创新，大疆致力于为无人机工业、行业用户以及专业航拍应用提供性能最强、体验最佳的革命性智能飞控产品和解决方案。
HTML5 是 HTML 下一个的主要修订版本，现在仍处于发展阶段。广义论及 HTML5 时，实际指的是包括 HTML、CSS 和 JavaScript 在内的一套技术组合。
各种网址链接、内容导航。
TensorFlow 是一个采用数据流图（data flow graphs），用于数值计算的开源软件库。节点（Nodes）在图中表示数学操作，图中的线（edges）则表示在节点间相互联系的多维数据数组，即张量（tensor）。
阿里云是阿里巴巴集团旗下公司，是全球领先的云计算及人工智能科技公司。提供云服务器、云数据库、云安全等云计算服务，以及大数据、人工智能服务、精准定制基于场景的行业解决方案。
GitHub 于 2008 年上线，目前，除了 Git 代码仓库托管及基本的 Web 管理界面以外，还提供了订阅、讨论组、文本渲染、在线文件编辑器、协作图谱（报表）、代码片段分享（Gist）等功能。正因为这些功能所提供的便利，又经过长期的积累，GitHub 的用户活跃度很高，在开源世界里享有深远的声望，并形成了社交化编程文化（Social Coding）。
钉钉，专为中国企业打造的免费沟通协同多端平台， 阿里巴巴出品。
Jenkins 是一套开源的持续集成工具。它提供了非常丰富的插件，让构建、部署、自动化集成项目变得简单易用。
Gitea 是一个开源社区驱动的轻量级代码托管解决方案，后端采用 Go 编写，采用 MIT 许可证。
Spark 是 UC Berkeley AMP lab 所开源的类 Hadoop MapReduce 的通用并行框架。Spark 拥有 Hadoop MapReduce 所具有的优点；但不同于 MapReduce 的是 Job 中间输出结果可以保存在内存中，从而不再需要读写 HDFS，因此 Spark 能更好地适用于数据挖掘与机器学习等需要迭代的 MapReduce 的算法。
Wide 是一款基于 Web 的 Go 语言 IDE。通过浏览器就可以进行 Go 开发，并有代码自动完成、查看表达式、编译反馈、Lint、实时结果输出等功能。
欢迎访问我们运维的实例： https://wide.b3log.org
Cloud Foundry 是 VMware 推出的业界第一个开源 PaaS 云平台，它支持多种框架、语言、运行时环境、云平台及应用服务，使开发人员能够在几秒钟内进行应用程序的部署和扩展，无需担心任何基础架构的问题。
Markdown 是一种轻量级标记语言，用户可使用纯文本编辑器来排版文档，最终通过 Markdown 引擎将文档转换为所需格式（比如 HTML、PDF 等）。
欢迎来到这里！
我们正在构建一个小众社区，大家在这里相互信任，以平等 • 自由 • 奔放的价值观进行分享交流。最终，希望大家能够找到与自己志同道合的伙伴，共同成长。
注册 关于