Merge branch 'master' of gitcode.net:dcloud/unidocs-zh into master

docs/tutorial/build/publish-mp-weixin-cli.md

@@ -2,7 +2,7 @@
 
 > HBuilderX 3.3.7+, uni-app 发行到微信小程序，支持自动上传代码到微信平台，无需再打开微信开发者工具上传发行
 
-![](https://hx.dcloud.net.cn/static/snapshots/cli/wechat-upload.png)
+<img src="https://f184e7c3-1912-41b2-b81f-435d1b37c7b4.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/f6a5835a-1fcc-4241-a995-11f50240ece8.jpg" style="zoom: 50%;" />
 
 通过微信小程序CI，使用上传密钥上传代码，无需打开微信开发者工具，一键完成微信小程序代码的上传、预览等操作。
 
@@ -11,3 +11,4 @@
 - 自动上传到微信平台，依赖CI插件，如弹窗提示要求安装CI插件，请点击确认安装；
 - 自动上传到微信平台，需要配置`上传密钥`，并正确填写`微信小程序appid`和`privatekey`；
 - 自动上传到微信平台，如果开启了`IP白名单`，请确保微信平台已正确配置 `IP白名单`。
+- 关于微信ci机器人编号，仅支持HBuilderX 3.6.16+
\ No newline at end of file

docs/uniCloud/aliyun-migrate-business.md

@@ -156,3 +156,44 @@ url化访问时不管是默认域名还是自定义域名均和上述转发逻
 ![](https://f184e7c3-1912-41b2-b81f-435d1b37c7b4.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/5fa6249a-2900-40aa-b4b8-16f37d2307a1.png)
 
 需要开发者在[uniCloud控制台](https://unicloud.dcloud.net.cn)将自定义域名删除后重新绑定，通过该操作获取到新的CNAME后，将域名解析更换到新的CNAME以完成域名迁移。 这个期间前端网页托管自定义域名访问会中断，建议在访问量较低的时候处理。
+
+
+## 迁移后uniCloud相关业务消耗资源费用变更情况
+
+### 短信及一键登录资源消耗评估@sms-unilogin-fee
+
+`短信`和`一键登录`业务涉及费用的部分主要是云函数/云对象的使用量、调用次数、和出网流量(如：使用`uni-id-co`或自定义的云函数/云对象来发送短信)。
+接下来，我们对不同资源，分别进行费用评估。
+
+我们按照[uniCloud官网](https://uniapp.dcloud.net.cn/uniCloud/price.html#aliyun-postpay)列出的按量计费规则，计算一下云函数的资源消耗。
+
+![](https://mp-8ca8132b-2139-4831-aff2-582d4c8385da.cdn.bspapp.com/cloudstorage/8492ba8e-f4c6-45de-abf2-f9d6825ceefb.png)
+
+我们可以简单得出如下公式：
+
+`云函数/云对象费用 = 资源使用量 * 0.000110592  + 调用次数 * 0.0133 / 10000 + 出网流量 * 0.8`
+
+其中：
+- 资源使用量 = 云函数内存（单位为G） * 云函数平均单次执行时长（单位为秒） * 调用次数
+- 调用次数 = 发送短信条数（一般情况下发送条数 = 调用次数，特殊情况除外）+ 一键登录调用次数（如果只使用其中某一项业务，则可设另一项业务调用次数为0）
+
+
+我们假设如下数据模型：
+
+- 云函数内存：512M，即0.5G （云函数内存默认为512M，用户可以自定义设置，最低可设置为128M）
+- 云函数平均单次执行时长：200毫秒，即0.2秒
+- 短信和一键登录业务平均每日调用次数：10000次
+- 出网流量：单次请求 2 KB
+
+按照如上公式，其`短信`业务云函数每天的费用为：
+
+```
+云函数费用（天） = 资源使用量 * 0.000110592  + 调用次数 * 0.0133 / 10000 + 出网流量 * 0.8
+			  = 云函数内存（单位为G） * 云函数平均单次执行时长（单位为秒） * 调用次数 + 调用次数 * 0.0133 / 10000 + 出网流量 * 0.8
+			  = 0.5G * 0.2S * 10000 * 0.000110592 + 10000 * 0.0133/10000 + 10000 * 2 * 0.8 / 1024 * 1024 
+			  = 0.110592 + 0.0133 + 0.0152587890625
+			  = 0.1391507890625（元）
+			  ≈ 0.139（元）
+```
+
+即：如果你的`短信`和`一键登录`业务平均每天发送条数为10000条，使用阿里云正式版云服务空间后，对应云函数每天大概消耗0.139元，对比之前的短信和一键登录费用，平均每次调用多花0.0000139元，几乎可忽略不计。
\ No newline at end of file

docs/uniCloud/cf-database-aggregate-operator.md

@@ -315,32 +315,41 @@ let res = await db.collection('sales').aggregate()
 
       
 ####  API 说明
- 语法如下：  
 
+语法如下：  
 
 ```js
 db.command.aggregate.ln(<number>)
 ```
 `<number>` 可以是任意解析为非负数字的表达式。  
 
- `ln` 等价于 `log([<number>, Math.E])`，其中 `Math.E` 是 `JavaScript` 获取 `e` 的值的方法。  
+`ln` 等价于 `log([<number>, Math.E])`，其中 `Math.E` 是 `JavaScript` 获取 `e` 的值的方法。  
 
  
 ####  示例代码
 
-####  db.command.aggregate.ln
- 
-计算给定数字在自然对数值。  
-
-语法如下：  
-
- 
+假设集合 curve 有如下记录：
 ```js
-db.command.aggregate.ln(<number>)
+{ _id: 1, x: 1 }
+{ _id: 2, x: 2 }
+{ _id: 3, x: 3 }
+```
+计算 ln(x) 的值：
+```js
+const $ = db.command.aggregate
+let res = await db.collection('curve').aggregate()
+  .project({
+    log: $.ln('$x')
+  })
+  .end()
+```
+返回结果如下：
+```js
+{ _id: 1, ln: 0 }
+{ _id: 2, ln: 0.6931471805599453 }
+{ _id: 3, ln: 1.0986122886681098 }
 ```
-`<number>` 可以是任意解析为非负数字的表达式。  
 
- `ln` 等价于 `log([<number>, Math.E])`，其中 `Math.E` 是 `JavaScript` 获取 `e` 的值的方法。
 
 ### log
 

docs/uniCloud/cf-database-dbcmd.md

@@ -98,8 +98,8 @@ function and(...expressions: Expression[]): Command
 
  
 ```js
-let res = await const dbCmd = db.command
-db.collection('todo').where({
+const dbCmd = db.command
+let res = await db.collection('todo').where({
   progress: dbCmd.gt(80).or(dbCmd.lt(20))
 }).get()
 ```

docs/uniCloud/price.md

@@ -40,7 +40,7 @@ uniCloud提供包月、按量计费两种计费方式，具体说明如下：
 
 **免费额度注意事项：**
 - 单个账号只能创建一个阿里云免费服务空间
-- 阿里云免费服务空间有效期默认一个月，到期时需主动续费（续费时依旧免费），否则将会被停服释放
+- 阿里云免费服务空间有效期默认一个月，到期时需主动续费（到期前15天可续费，续费时依旧免费），否则将会被停服释放
 - 免费版如需升配，只能针对剩余有效期进行操作，无法自定义升配时间
 - 免费版可以转换为按量计费
 - 免费版升配或转为按量计费后，免费额度会释放，此时仍可再创建一个免费版

docs/uniCloud/redis.md

@@ -2166,7 +2166,7 @@ member 移除成功返回 1，member 不是 source 集合成员，并且没有
 **示例**
 
 ```js
-await redis.sadd('key', 'a', 'b', 'c')
+await redis.sadd('source', 'a', 'b', 'c')
 await redis.smove('source', 'destination', 'a') // 返回 1
 ```
 

docs/uniCloud/send-sms.md

@@ -190,6 +190,7 @@ exports.main = async (event, context) => {
 【uniID】“DCloud”验证码：123456，3分钟内有效，请勿泄露并尽快验证。
 ```
 
+
 ### 发送失败注意@fail
 
 - data内如果有`测试`、`test`等字样，系统可能会被判定为测试用途，不会真正把短信下发到对应手机（此行为由运营商控制，可能真实发送，也可能不发送） 
@@ -210,6 +211,16 @@ exports.main = async (event, context) => {
 更多问题：欢迎加入<a class="join-group-chat" target="_blank" href="https://f184e7c3-1912-41b2-b81f-435d1b37c7b4.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/69a69072-8874-4ec1-bc0f-6f820f3919ee.png">DCloud短信技术交流群	<img src="https://f184e7c3-1912-41b2-b81f-435d1b37c7b4.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/69a69072-8874-4ec1-bc0f-6f820f3919ee.png">
 </a>咨询
 
+
+### 短信费用说明@sms-fee
+
+- 短信费用为：0.036元/条，但在实际使用中需要依赖`uniCloud`云服务，在使用阿里云正式版后，每条大约需要多花0.0000139元，几乎可以忽略不计，费用计算详见[短信及一键登录资源消耗评估](uniCloud/aliyun-migrate-business.md#sms-unilogin-fee)。
+- 计费条数计算方法：短信内容少于70个字符（每个汉字、标点、空格、字母均算一个字符）算作1条短信，短信内容多于70个字符时，每67个字符算作一条短信，并向上取整（不足67个字符的部分也算做1条）。 例： 短信内容有 100个字符时计费短信条数应为 100 / 67 ≈ 1.49 向上取整后算作2条。
+- 最终按照成功回执状态为"成功"的短信条数计费，成功回执状态可在"发送记录"页面查看。
+
+特别注意：短信成功回执最长延迟为72小时。
+
+
 <style>
 	.join-group-chat{
 		position: relative;

docs/uniCloud/univerify.md

@@ -235,3 +235,8 @@ exports.main = async function (event){
   return res
 }
 ```
+
+
+### 一键登录费用说明@unilogin-fee
+
+- 0.02元/次，失败不计费，但在实际使用中需要依赖`uniCloud`云服务，在使用阿里云正式版后，每条大约需要多花0.0000139元，几乎可以忽略不计，费用计算详见[短信及一键登录资源消耗评估](uniCloud/aliyun-migrate-business.md#sms-unilogin-fee)。