dolphindb 2.0.901 → 2.0.902

package/index.js

@@ -6,6 +6,7 @@ import ipaddrjs from 'ipaddr.js';
 const { fromByteArray: buf2ipaddr } = ipaddrjs;
 import { concat, assert, inspect, typed_array_to_buffer } from 'xshell/utils.js';
 import { connect_websocket } from 'xshell/net.js';
+import { t } from './i18n/index.js';
 export var DdbForm;
 (function (DdbForm) {
     DdbForm[DdbForm["scalar"] = 0] = "scalar";
@@ -16,7 +17,8 @@ export var DdbForm;
     DdbForm[DdbForm["dict"] = 5] = "dict";
     DdbForm[DdbForm["table"] = 6] = "table";
     DdbForm[DdbForm["chart"] = 7] = "chart";
-    /** Node internal communication may be used, calling function execution script generally does not return this type */
+    /** 结点内部通信可能会使用，调用函数执行脚本一般不会返回这种类型
+        Node internal communication may be used, calling function execution script generally does not return this type */
     DdbForm[DdbForm["chunk"] = 8] = "chunk";
     /** sysobj */
     DdbForm[DdbForm["object"] = 9] = "object";
@@ -117,7 +119,7 @@ export const nulls = {
     double: -Number.MAX_VALUE,
     bytes16: Uint8Array.from(new Array(16).fill(0))
 };
-/** Can represent data types in all DolphinDB databases */
+/** 可以表示所有 DolphinDB 数据库中的数据类型  Can represent data types in all DolphinDB databases */
 export class DdbObj {
     static dec = new TextDecoder('utf-8');
     static enc = new TextEncoder();
@@ -149,7 +151,7 @@ export class DdbObj {
     rows;
     /** 第 2 维 */
     cols;
-    /** The actual data. Different DdbForm, DdbType use different types in DdbValue to represent actual data */
+    /** 实际数据。不同的 DdbForm, DdbType 使用 DdbValue 中不同的类型来表示实际数据  The actual data. Different DdbForm, DdbType use different types in DdbValue to represent actual data */
     value;
     /** 原始二进制数据，仅在 parse_object 为 false 时通过 parse_message 生成的顶层对象有这个属性 */
     buffer;
@@ -471,7 +473,7 @@ export class DdbObj {
                 return [12, { scale: dv.getInt32(0, le), data: data === nulls.int64 ? null : data }];
             }
             default:
-                throw new Error(`${DdbType[type] || type} 暂时不支持解析`);
+                throw new Error(String(DdbType[type] || type) + t(' 暂时不支持解析'));
         }
     }
     /** parse: rows, cols, items
@@ -566,7 +568,7 @@ export class DdbObj {
                     lengths = new Uint32Array(lengths_buf.buffer);
                     break;
                 default:
-                    throw new Error(`array vector 存在非法 unit = ${unit}`);
+                    throw new Error(t('array vector 存在非法 unit: {{unit}}', { unit }));
             }
             let total_length = 0;
             for (const x of lengths)
@@ -891,7 +893,7 @@ export class DdbObj {
                             return [Int32Array.of(scale), BigInt64Array.of(data === null ? nulls.int64 : data)];
                         }
                         default:
-                            throw new Error(`${DdbType[type] || type} serialization is not currently supported`);
+                            throw new Error(String(DdbType[type] || type) + t(' 暂时不支持序列化'));
                     }
                 case DdbForm.vector:
                 case DdbForm.pair:
@@ -956,7 +958,7 @@ export class DdbObj {
                     ];
                 }
                 default:
-                    throw new Error(`${DdbForm[form]} serialization is not currently supported`);
+                    throw new Error(`${DdbForm[form] || form} ${t('暂时不支持序列化')}`);
             }
         })();
         if (!body)
@@ -1048,7 +1050,7 @@ export class DdbObj {
                 return [Int32Array.of(scale), data];
             }
             default:
-                throw new Error(`vector ${DdbType[type]} 暂不支持序列化`);
+                throw new Error(t('vector {{type}} 暂不支持序列化', { type: DdbType[type] || type }));
         }
     }
     [inspect.custom](depth, _options, _inspect) {
@@ -1201,7 +1203,7 @@ export class DdbObj {
             case 'boolean':
                 return new DdbBool(value);
             default:
-                throw new Error(`Cannot automatically convert ${type} to DdbObj`);
+                throw new Error(t('不能自动转换 {{type}} 至 DdbObj', { type }));
         }
     }
     /** 转换 js 数组为 DdbObj[] */
@@ -1209,7 +1211,7 @@ export class DdbObj {
         return values.map(value => this.to_ddbobj(value));
     }
     to_rows() {
-        assert(this.form === DdbForm.table, 'form must be DdbForm.table, otherwise it cannot to_rows');
+        assert(this.form === DdbForm.table, t('form 必须是 DdbForm.table, 否则不能 to_rows'));
         let rows = new Array(this.rows);
         for (let i = 0; i < this.rows; i++) {
             let row = {};
@@ -1241,10 +1243,10 @@ export class DdbObj {
         return rows;
     }
     to_dict({ strip, deep, } = {}) {
-        assert(this.form === DdbForm.dict, 'this.form must be DdbForm.dict, otherwise to_dict cannot be called to convert to js object');
+        assert(this.form === DdbForm.dict, t('this.form 必须是 DdbForm.dict, 否则不能调用 to_dict 转换为 js object'));
         const [{ value: keys, type: key_type }, { value: values, type: value_type }] = this.value;
-        assert(key_type === DdbType.string && value_type === DdbType.any, 'Currently only supports automatic conversion of dict<string, any> to js object');
-        assert(!(deep && !strip), 'strip = true must be set when deep = true');
+        assert(key_type === DdbType.string && value_type === DdbType.any, t('当前只支持自动转换 dict<string, any> 为 js object'));
+        assert(!(deep && !strip), t('deep = true 时必须设置 strip = true'));
         let obj = {};
         for (let i = 0; i < this.rows; i++) {
             let value = values[i];
@@ -1261,7 +1263,7 @@ let default_formatter = Intl.NumberFormat('en-US', { maximumFractionDigits: 20 }
 let _decimals = 20;
 /** 缓存，为了优化性能，通常 options.decimals 都是不变的 */
 let _formatter = Intl.NumberFormat('en-US', { maximumFractionDigits: 20 });
-/** Formats a single element (value) as a string according to DdbType, null returns a 'null' string */
+/** 根据 DdbType 格式化单个元素 (value) 为字符串，空值返回 'null' 字符串  Formats a single element (value) as a string according to DdbType, null returns a 'null' string */
 export function format(type, value, le, options = {}) {
     const { decimals } = options;
     const formatter = (() => {
@@ -1466,7 +1468,7 @@ export function format(type, value, le, options = {}) {
             return inspect(value, options);
     }
 }
-/** formatted vector, the index-th item in the collection is a string, a null value returns a 'null' string */
+/** 格式化向量、集合中的第 index 项为字符串，空值返回 'null' 字符串  formatted vector, the index-th item in the collection is a string, a null value returns a 'null' string */
 export function formati(obj, index, options = {}) {
     assert(index < obj.rows, 'index < obj.rows');
     if (64 <= obj.type && obj.type < 128) { // array vector
@@ -1801,10 +1803,9 @@ export class DdbSetString extends DdbObj {
         });
     }
 }
-/** Constructs a DdbDict object, which supports two usages:
-     - The incoming type is the keys of DdbObj<DdbVectorValue>, and the two parameters of values directly form the DdbDict of dict<keys.type, values.type>
-     - Pass in js object (type is Record<string, boolean | string | DdbObj>), automatically converted to DdbDict of dict<string, any>
-*/
+/** 构造 DdbDict 对象，支持两种用法:  Constructs a DdbDict object, which supports two usages:
+     - 传入类型是 DdbVectorObj 的 keys, values 两个参数直接组成 dict<keys.type, values.type> 的 DdbDict  The incoming type is the keys of DdbObj<DdbVectorValue>, and the two parameters of values directly form the DdbDict of dict<keys.type, values.type>
+     - 传入 js object (类型是 Record<string, boolean | string | DdbObj>), 自动转换为 dict<string, any> 的 DdbDict  Pass in js object (type is Record<string, boolean | string | DdbObj>), automatically converted to DdbDict of dict<string, any> */
 export class DdbDict extends DdbObj {
     constructor(arg0, arg1) {
         if (arg1)
@@ -1934,7 +1935,7 @@ export function timestamp2ms(timestamp) {
 /** format timestamp (bigint) to string
     - timestamp: bigint value
     - format?:
-        format string, default to `YYYY.MM.DD HH:mm:ss.SSS`
+        格式串，默认是 `YYYY.MM.DD HH:mm:ss.SSS`  format string, default to `YYYY.MM.DD HH:mm:ss.SSS`
         https://day.js.org/docs/en/parse/string-format#list-of-all-available-parsing-tokens
 */
 export function timestamp2str(timestamp, format = 'YYYY.MM.DD HH:mm:ss.SSS') {
@@ -1958,15 +1959,17 @@ export function datehour2str(datehour, format = 'YYYY.MM.DDTHH') {
             dayjs(1000 * 60 * new Date(ms).getTimezoneOffset() + ms).format(format);
 }
 /** parse timestamp string to bigint value
-    - str: timestamp string, If it is an empty string or 'null', it will return the corresponding empty value (nulls.int64)
+    - str: str: timestamp string, 如果为空字符串或 'null' 会返回对应的空值 (nulls.int64)
+        timestamp string, If it is an empty string or 'null', it will return the corresponding empty value (nulls.int64)
     - format?:
+        对应传入字符串的格式串，默认是 `YYYY.MM.DD HH:mm:ss.SSS`
         The format string corresponding to the incoming string, the default is `YYYY.MM.DD HH:mm:ss.SSS`
         https://day.js.org/docs/en/parse/string-format#list-of-all-available-parsing-tokens
 */
 export function str2timestamp(str, format = 'YYYY.MM.DD HH:mm:ss.SSS') {
     if (!str || str === 'null')
         return nulls.int64;
-    assert(str.length === format.length, 'The length of the timestamp string must be equal to the length of the format string');
+    assert(str.length === format.length, t('timestamp 字符串长度必须等于格式串长度'));
     const ms = dayjs(str, format).valueOf();
     return BigInt(-(1000 * 60 * new Date(ms).getTimezoneOffset()) +
         ms);
@@ -1980,10 +1983,10 @@ export function nanotime2str(nanotime, format = 'HH:mm:ss.SSSSSSSSS') {
     if (nanotime < 0n)
         return String(nanotime);
     const i_second_start = format.indexOf('ss');
-    assert(i_second_start !== -1, 'The format string must contain the format for seconds (ss)');
+    assert(i_second_start !== -1, t('格式串必须包含秒的格式 (ss)'));
     const i_second_end = i_second_start + 2;
     const i_nanosecond_start = format.indexOf('SSSSSSSSS', i_second_end);
-    assert(i_nanosecond_start !== -1, 'Format string must contain nanosecond format (SSSSSSSSS)');
+    assert(i_nanosecond_start !== -1, t('格式串必须包含纳秒的格式 (SSSSSSSSS)'));
     const ms = Number(nanotime) / 1000000;
     return (dayjs(1000 * 60 * new Date(ms).getTimezoneOffset() + ms).format(format.slice(0, i_second_end)) +
         format.slice(i_second_end, i_nanosecond_start) +
@@ -1999,8 +2002,8 @@ export function nanotimestamp2ns(nanotimestamp) {
 /** format nanotimestamp value (bigint) to string
     - nanotimestamp: bigint value
     - format?:
-        format string, default is `YYYY.MM.DD HH:mm:ss.SSSSSSSSS`
-        Seconds are in the format ss (must be included); nanoseconds are in the format SSSSSSSSS (must be included)
+        格式串，默认是 `YYYY.MM.DD HH:mm:ss.SSSSSSSSS`  format string, default is `YYYY.MM.DD HH:mm:ss.SSSSSSSSS`
+        秒的格式为 ss (必须包含); 纳秒的格式为 SSSSSSSSS (必须包含)  Seconds are in the format ss (must be included); nanoseconds are in the format SSSSSSSSS (must be included)
         https://day.js.org/docs/en/parse/string-format#list-of-all-available-parsing-tokens
 */
 export function nanotimestamp2str(nanotimestamp, format = 'YYYY.MM.DD HH:mm:ss.SSSSSSSSS') {
@@ -2013,10 +2016,10 @@ export function nanotimestamp2str(nanotimestamp, format = 'YYYY.MM.DD HH:mm:ss.S
     if (nanotimestamp === null || nanotimestamp === nulls.int64)
         return 'null';
     const i_second_start = format.indexOf('ss');
-    assert(i_second_start !== -1, 'The format string must contain the format for seconds (ss)');
+    assert(i_second_start !== -1, t('格式串必须包含秒的格式 (ss)'));
     const i_second_end = i_second_start + 2;
     const i_nanosecond_start = format.indexOf('SSSSSSSSS', i_second_end);
-    assert(i_nanosecond_start !== -1, 'Format string must contain nanosecond format (SSSSSSSSS)');
+    assert(i_nanosecond_start !== -1, t('格式串必须包含纳秒的格式 (SSSSSSSSS)'));
     const remainder = nanotimestamp % 1000000000n;
     const borrow = remainder < 0n;
     const ms = Number(nanotimestamp / 1000000n);
@@ -2030,21 +2033,22 @@ export function nanotimestamp2str(nanotimestamp, format = 'YYYY.MM.DD HH:mm:ss.S
                 remainder).padStart(9, '0'));
 }
 /** parse nano timestamp string to bigint value
-    - str: nano timestamp string, If it is an empty string or 'null', it will return the corresponding empty value (nulls.int64)
+    - str: nano timestamp string, 如果为空字符串或 'null' 会返回对应的空值 (nulls.int64)
+        nano timestamp string, If it is an empty string or 'null', it will return the corresponding empty value (nulls.int64)
     - format?:
-        The format string corresponding to the incoming string, the default is `YYYY.MM.DD HH:mm:ss.SSSSSSSSS`
-        Seconds are in the format ss (must be included); nanoseconds are in the format SSSSSSSSS (must be included)
+        对应传入字符串的格式串，默认是 `YYYY.MM.DD HH:mm:ss.SSSSSSSSS`  The format string corresponding to the incoming string, the default is `YYYY.MM.DD HH:mm:ss.SSSSSSSSS`
+        秒的格式为 ss (必须包含); 纳秒的格式为 SSSSSSSSS (必须包含)  Seconds are in the format ss (must be included); nanoseconds are in the format SSSSSSSSS (must be included)
         https://day.js.org/docs/en/parse/string-format#list-of-all-available-parsing-tokens
 */
 export function str2nanotimestamp(str, format = 'YYYY.MM.DD HH:mm:ss.SSSSSSSSS') {
     if (!str || str === 'null')
         return nulls.int64;
-    assert(str.length === format.length, 'nanotimestamp string length must be equal to format string length');
+    assert(str.length === format.length, t('nanotimestamp 字符串长度必须等于格式串长度'));
     const i_second_start = format.indexOf('ss');
-    assert(i_second_start !== -1, 'The format string must contain the format for seconds (ss)');
+    assert(i_second_start !== -1, t('格式串必须包含秒的格式 (ss)'));
     const i_second_end = i_second_start + 2;
     const i_nanosecond_start = format.indexOf('SSSSSSSSS', i_second_end);
-    assert(i_nanosecond_start !== -1, 'Format string must contain nanosecond format (SSSSSSSSS)');
+    assert(i_nanosecond_start !== -1, t('格式串必须包含纳秒的格式 (SSSSSSSSS)'));
     const ms = dayjs(str.slice(0, i_second_end), format.slice(0, i_second_end)).valueOf();
     return (BigInt(-(1000 * 60 * new Date(ms).getTimezoneOffset()) +
         ms) * 1000000n
@@ -2077,7 +2081,7 @@ export const winsize = 10_0000;
 export class ConnectionError extends Error {
     ddb;
     constructor(ddb) {
-        super(`websocket is disconnected: ${ddb.url}`);
+        super(`${t('websocket 连接已断开')}: ${ddb.url}`);
         this.ddb = ddb;
     }
 }
@@ -2104,7 +2108,7 @@ export class DDB {
     password = '123456';
     /** python session flag (2048) */
     python = false;
-    /** Whether it is a streaming data connection, this field is always null for non-streaming data */
+    /** 是否为流数据连接，非流数据这个字段恒为 null  Whether it is a streaming data connection, this field is always null for non-streaming data */
     streaming = null;
     // --- 内部选项, 状态
     print_message_buffer = false;
@@ -2121,20 +2125,20 @@ export class DDB {
         return this.websocket?.readyState === WebSocket.OPEN;
     }
     /**
-        Initialize an instance of DolphinDB Client using the WebSocket URL
-        (without establishing an actual network connection)
+        使用 WebSocket URL 初始化连接到 DolphinDB 的实例（不建立实际的网络连接）
+        Initialize an instance of DolphinDB Client using the WebSocket URL (without establishing an actual network connection)
         - url: DolphinDB WebSocket URL. e.g.：`ws://127.0.0.1:8848`
         - options?:
-            - autologin?: Whether to log in automatically after establishing a connection, default `true`
-            - username?: DolphinDB username, default `'admin'`
-            - password?: DolphinDB password, default `'123456'`
-            - python?: set python session flag, default `false`
-            - streaming?: When this option is set, the WebSocket connection is only used for streaming data
+            - autologin?: 是否在建立连接后自动登录，默认 `true`  Whether to log in automatically after establishing a connection, default `true`
+            - username?: DolphinDB 登录用户名，默认 `'admin'`  DolphinDB username, default `'admin'`
+            - password?: DolphinDB 登录密码，默认 `'123456'`  DolphinDB password, default `'123456'`
+            - python?: 设置 python session flag，默认 `false`  set python session flag, default `false`
+            - streaming?: 设置该选项后，该 WebSocket 连接只用于流数据  When this option is set, the WebSocket connection is only used for streaming data
         
         @example
         let ddb = new DDB('ws://127.0.0.1:8848')
         
-        // Encrypt with HTTPS
+        // 使用 HTTPS 加密  Encrypt with HTTPS
         let ddbsecure = new DDB('wss://dolphindb.com', {
             autologin: true,
             username: 'admin',
@@ -2158,9 +2162,9 @@ export class DDB {
     on_message(event) {
         // 这里的实现一定会被 connect 中的实现覆盖
     }
-    /** Establish a actual websocket connection to the DolphindB corresponding to the URL
-        It is a power, and after calling, it will ensure that it has been connected to the database (ensure that websocket.ReadyState is open), otherwise an error will be reported
-        this.autologin automatically log in when it is true */
+    /** 建立实际的 WebSocket 连接到 URL 对应的 DolphinDB  Establish a actual websocket connection to the DolphindB corresponding to the URL
+        是幂等的，调用后会确保已连接到数据库 (确保 websocket.readyState 为 open)，否则报错  It is a power, and after calling, it will ensure that it has been connected to the database (ensure that websocket.ReadyState is open), otherwise an error will be reported
+        this.autologin 为 true 时自动登录  this.autologin automatically log in when it is true */
     async connect() {
         if (this.connected)
             return;
@@ -2173,7 +2177,7 @@ export class DDB {
         try {
             if (!this.connected) {
                 this.on_message = (event) => {
-                    assert(false, '这是在调用 this.rpc 之前默认的 on_message, 不应该被调用到，除非建立连接后 server 先推送了 message');
+                    assert(false, t('这是在调用 this.rpc 之前默认的 on_message, 不应该被调用到，除非建立连接后 server 先推送了 message'));
                 };
                 this.presult = Promise.resolve(null);
                 this.pnode_run_defined = false;
@@ -2237,7 +2241,7 @@ export class DDB {
             this.websocket.close(1000);
     }
     /** rpc through websocket (function/script/variable command)
-        When the DDB is not connected, the call will be automatically connected. When the connection is disconnected, the call will throw the Connectionerror
+        未连接到 DDB 时调用会自动连接，连接断开时调用会抛出 ConnectionError  When the DDB is not connected, the call will be automatically connected. When the connection is disconnected, the call will throw the Connectionerror
         - type: API 类型: 'script' | 'function' | 'variable'
         - options:
             - urgent?: 决定 `行为标识` 那一行字符串的取值（只适用于 script 和 function）
@@ -2375,11 +2379,15 @@ export class DDB {
         return presult;
     }
     /** eval script through websocket (script command)
-        - script?: Script to execute
-        - options?: execution options
-            - urgent?: Urgent flag to ensure that submitted scripts are processed by urgent workers to prevent being blocked by other jobs
-            - listener?: Process messages during this rpc (DdbMessage)
-            - parse_object?: Set parse_object during this rpc, and restore the original after the end.
+        - script?: 执行的脚本  Script to execute
+        - options?: 执行选项  execution options
+            - urgent?: 紧急 flag，确保提交的脚本使用 urgent worker 处理，防止被其它作业阻塞
+                Urgent flag to ensure that submitted scripts are processed by urgent workers to prevent being blocked by other jobs
+            - listener?: 处理本次 rpc 期间的消息 (DdbMessage)
+                Process messages during this rpc (DdbMessage)
+            - parse_object?: 在该次 rpc 期间设置 parse_object, 结束后恢复原有，为 false 时返回的 DdbObj 仅含有 buffer 和 le，
+                不做解析，以便后续转发、序列化
+                Set parse_object during this rpc, and restore the original after the end.
                 When it is false, the returned DdbObj only contains buffer and le without parsing,
                 so as to facilitate subsequent forwarding and serialization
     */
@@ -2387,22 +2395,30 @@ export class DDB {
         return this.rpc('script', { script, urgent, listener, parse_object });
     }
     /** call function through websocket (function command)
-        - func: function name
-        - args?: `[ ]` Call parameters (the incoming native string and boolean will be automatically converted to DdbObj<string> and DdbObj<boolean>)
-        - options?: call options
-            - urgent?: Emergency flag. Use urgent worker execution to prevent being blocked by other jobs
-            - node?: When the node alias is set, it is sent to the corresponding node in the cluster for execution (using the rpc method in DolphinDB)
-            - nodes?: When setting multiple node aliases, send them to the corresponding multiple nodes in the cluster for execution (using the pnodeRun method in DolphinDB)
-            - func_type?: It must be passed when setting the node parameter, the function type needs to be specified, and it is not passed in other cases
-            - add_node_alias?: Select to pass when setting the nodes parameter, otherwise not pass
-            - listener?: Process messages during this rpc (DdbMessage)
-            - parse_object?: Set parse_object during this rpc, and restore the original after the end.
+        - func: 函数名  function name
+        - args?: `[ ]` 调用参数 (传入的原生 string 和 boolean 会被自动转换为 DdbObj<string> 和 DdbObj<boolean>)  Call parameters (the incoming native string and boolean will be automatically converted to DdbObj<string> and DdbObj<boolean>)
+        - options?: 调用选项  call options
+            - urgent?: 紧急 flag。使用 urgent worker 执行，防止被其它作业阻塞
+                Emergency flag. Use urgent worker execution to prevent being blocked by other jobs
+            - node?: 设置结点 alias 时发送到集群中对应的结点执行 (使用 DolphinDB 中的 rpc 方法)
+                When the node alias is set, it is sent to the corresponding node in the cluster for execution (using the rpc method in DolphinDB)
+            - nodes?: 设置多个结点 alias 时发送到集群中对应的多个结点执行 (使用 DolphinDB 中的 pnodeRun 方法)
+                When setting multiple node aliases, send them to the corresponding multiple nodes in the cluster for execution (using the pnodeRun method in DolphinDB)
+            - func_type?: 设置 node 参数时必传，需指定函数类型，其它情况下不传
+                It must be passed when setting the node parameter, the function type needs to be specified, and it is not passed in other cases
+            - add_node_alias?: 设置 nodes 参数时选传，其它情况不传
+                Select to pass when setting the nodes parameter, otherwise not pass
+            - listener?: 处理本次 rpc 期间的消息 (DdbMessage)
+                Process messages during this rpc (DdbMessage)
+            - parse_object?: 在该次 rpc 期间设置 parse_object, 结束后恢复原有，为 false 时返回的 DdbObj 仅含有 buffer 和 le，
+                不做解析，以便后续转发、序列化
+                Set parse_object during this rpc, and restore the original after the end.
                 When it is false, the returned DdbObj only contains buffer and le without parsing,
                 so as to facilitate subsequent forwarding and serialization
     */
     async call(func, args = [], { urgent, node, nodes, func_type, add_node_alias, listener, parse_object, } = {}) {
         if (node) {
-            assert(func_type in DdbFunctionType, 'func_type must be set when specifying node');
+            assert(func_type in DdbFunctionType, t('指定 node 时必须设置 func_type'));
             args = [
                 node,
                 new DdbFunction(func, func_type),
@@ -2435,14 +2451,14 @@ export class DDB {
     }
     /** upload variable through websocket (variable command) */
     async upload(
-    /** Uploaded variables' name */
+    /** 上传的变量名  Uploaded variables' name */
     vars, 
-    /** Uploaded variables' value */
+    /** 上传的变量值  Uploaded variables' value */
     args, { listener, parse_object, } = {}) {
-        assert(args.length && args.length === vars.length, 'variable command parameter cannot be empty and parameter name cannot be empty, and the number should match');
+        assert(args.length && args.length === vars.length, t('variable 指令参数不能为空且参数名不能为空，且数量应该匹配'));
         return this.rpc('variable', { vars, args, listener, parse_object });
     }
-    /** Cancel all console jobs corresponding to the current session id */
+    /** 取消当前 session id 对应的所有 console jobs  Cancel all console jobs corresponding to the current session id */
     async cancel() {
         let ddb = new DDB(this.url, this);
         try {
@@ -2474,7 +2490,7 @@ export class DDB {
         /** session id */
         const sid = parts[0];
         if (sid !== this.sid) {
-            console.log(`session.id: ${this.sid} -> ${sid}`);
+            console.log(t('session id 从 {{sid}} 变为 {{sid_}}', { sid: this.sid, sid_: sid }));
             this.sid = sid;
         }
         /** 返回对象的数量 */
@@ -2507,12 +2523,12 @@ export class DDB {
                     })
         };
     }
-    /** Internal stream subscription method */
+    /** 内部的流订阅方法  Internal stream subscription method */
     async subscribe() {
         await this.rpc('connect', {});
         if (this.autologin)
             await this.call('login', [this.username, this.password]);
-        console.log('Subscribed to streaming table, colnames:', 
+        console.log(t('订阅流表成功') + ', colnames:', 
         // string[3](['time', 'stock', 'price'])
         this.streaming.colnames = (await this.call('publishTable', [
             'localhost',