docs: 统一时间戳/flash接口命名，规范配置字段命名，修正拼写

Author: Jiu-xiao

docs/basic_coding/core/core-def.md

@@ -40,7 +40,7 @@ sidebar_position: 1
 | `CHECK_ERR`  | -6   | 校验失败           |
 | `NOT_SUPPORT`| -7   | 功能不支持         |
 | `NOT_FOUND`  | -8   | 未找到对象         |
-| `NO_REPONSE` | -9   | 无响应             |
+| `NO_RESPONSE` | -9   | 无响应             |
 | `NO_MEM`     | -10  | 内存不足           |
 | `NO_BUFF`    | -11  | 缓冲区不足         |
 | `TIMEOUT`    | -12  | 操作超时           |

docs/basic_coding/core/core-time.md

@@ -6,28 +6,28 @@ sidebar_position: 7
 
 # 时间戳与时间差
 
-本模块定义了微秒级和毫秒级的时间戳类型 `TimestampUS` 和 `TimestampMS`，用于表示系统时钟时间，并可计算两个时间点之间的时间差。适用于定时器、延迟控制、性能分析等场景。
+本模块定义了微秒级和毫秒级的时间戳类型 `MicrosecondTimestamp` 和 `MillisecondTimestamp`，用于表示系统时钟时间，并可计算两个时间点之间的时间差。适用于定时器、延迟控制、性能分析等场景。
 
-## TimestampUS
+## MicrosecondTimestamp
 
 ```cpp
-class TimestampUS {
+class MicrosecondTimestamp {
  public:
-  TimestampUS();
-  TimestampUS(uint64_t microsecond);
+  MicrosecondTimestamp();
+  MicrosecondTimestamp(uint64_t microsecond);
   operator uint64_t() const;
-  TimeDiffUS operator-(const TimestampUS &old) const;
+  Duration operator-(const MicrosecondTimestamp &old) const;
 };
 ```
 
 表示微秒级时间戳，支持隐式转换为 `uint64_t`，可计算时间差。
 
-### TimeDiffUS
+### Duration
 
 ```cpp
-class TimeDiffUS {
+class Duration {
  public:
-  TimeDiffUS(uint64_t diff);
+  Duration(uint64_t diff);
   operator uint64_t() const;
   double ToSecond() const;
   float ToSecondf() const;
@@ -36,37 +36,37 @@ class TimeDiffUS {
 };
 ```
 
-表示两个 `TimestampUS` 之间的差值，单位为微秒。支持以秒/毫秒返回差值。
+表示两个 `MicrosecondTimestamp` 之间的差值，单位为微秒。支持以秒/毫秒返回差值。
 
-## TimestampMS
+## MillisecondTimestamp
 
 ```cpp
-class TimestampMS {
+class MillisecondTimestamp {
  public:
-  TimestampMS();
-  TimestampMS(uint32_t millisecond);
+  MillisecondTimestamp();
+  MillisecondTimestamp(uint32_t millisecond);
   operator uint32_t() const;
-  TimeDiffMS operator-(TimestampMS &old);
+  Duration operator-(MillisecondTimestamp &old);
 };
 ```
 
 表示毫秒级时间戳，支持隐式转换为 `uint32_t`，可计算时间差。
 
-### TimeDiffMS
+### Duration
 
 ```cpp
-class TimeDiffMS {
+class Duration {
  public:
-  TimeDiffMS(uint32_t diff);
+  Duration(uint32_t diff);
   operator uint32_t() const;
-  double ToSecond();
-  float ToSecondf();
+  double ToSecond() const;
+  float ToSecondf() const;
   uint64_t ToMicrosecond() const;
   uint32_t ToMillisecond() const;
 };
 ```
 
-表示两个 `TimestampMS` 之间的差值，单位为毫秒。支持以秒/微秒返回差值。
+表示两个 `MillisecondTimestamp` 之间的差值，单位为毫秒。支持以秒/微秒返回差值。
 
 ## 溢出处理
 

docs/basic_coding/driver/flash.md

@@ -21,9 +21,17 @@ public:
   // 写入数据到指定偏移地址
   virtual ErrorCode Write(size_t offset, ConstRawData data) = 0;
 
-  size_t min_erase_size_;   // 最小可擦除块大小（字节）
-  size_t min_write_size_;   // 最小可写入块大小（字节）
-  RawData flash_area_;      // 映射的闪存内存区域
+  // 读取指定偏移地址的数据
+  virtual ErrorCode Read(size_t offset, RawData data) = 0;
+
+  // 获取最小可擦除块大小
+  size_t MinEraseSize() const { return min_erase_size_; }
+
+  // 获取最小可写入块大小
+  size_t MinWriteSize() const { return min_write_size_; }
+
+  // 获取flash大小
+  size_t Size() const { return flash_area_.size_; }
 };
 ```
 

docs/code_gen/stm32/uart.md

@@ -64,13 +64,13 @@ terminal_source: usb
 
 # 终端相关配置（可选）
 Terminal:
-  READ_BUFF_SIZE: 32      # 终端读取缓冲区大小
-  MAX_LINE_SIZE: 32       # 每行最大字符数
-  MAX_ARG_NUMBER: 5       # 每行最大参数个数
-  MAX_HISTORY_NUMBER: 5   # 历史命令个数
-  RunAsThread: true       # 是否作为线程运行
-  ThreadStackDepth: 1024  # 线程栈深度（仅在线程下有效）
-  ThreadPriority: 3       # 线程优先级（仅在线程下有效）
+  read_buff_size: 32      # 终端读取缓冲区大小
+  max_line_size: 32       # 每行最大字符数
+  max_arg_number: 5       # 每行最大参数个数
+  max_history_number: 5   # 历史命令个数
+  run_as_thread: true       # 是否作为线程运行
+  thread_stack_depth: 1024  # 线程栈深度（仅在线程下有效）
+  thread_priority: 3       # 线程优先级（仅在线程下有效）
 
 # 硬件串口配置
 USART:

docs/code_gen/stm32/watchdog.md

@@ -42,14 +42,14 @@ iwdg1_thread.Create(reinterpret_cast<LibXR::Watchdog *>(&iwdg1), iwdg1.ThreadFun
 IWDG:
   iwdg1:
     timeout_ms: 1000   # 溢出超时时间（毫秒）
-    feed_ms: 250       # 喂狗周期（毫秒）
+    feed_interval_ms: 250       # 喂狗周期（毫秒）
 
 # Watchdog 相关全局配置
 Watchdog:
-  RunAsThread: true         # 是否作为线程运行（否则定时任务）
-  ThreadStackDepth: 1024    # 线程栈深度（仅在线程下有效）
-  ThreadPriority: 3         # 线程优先级（仅在线程下有效）
-  FeedInterval: 250         # 定时任务喂狗周期（毫秒，默认250）
+  run_as_thread: true         # 是否作为线程运行（否则定时任务）
+  feed_interval_ms: 1024    # 线程栈深度（仅在线程下有效）
+  thread_stack_depth: 3         # 线程优先级（仅在线程下有效）
+  thread_priority: 250         # 定时任务喂狗周期（毫秒，默认250）
 ```
 
 > * 若 `RunAsThread: true`，则每个启用的 IWDG 会自动生成线程，线程参数可全局配置。

i18n/en/docusaurus-plugin-content-docs/current/basic_coding/core/core-def.md

@@ -40,7 +40,7 @@ The `ErrorCode` enum defines a unified error code system used to represent vario
 | `CHECK_ERR`    | -6    | Validation failed        |
 | `NOT_SUPPORT`  | -7    | Feature not supported    |
 | `NOT_FOUND`    | -8    | Object not found         |
-| `NO_REPONSE`   | -9    | No response              |
+| `NO_RESPONSE`   | -9    | No response              |
 | `NO_MEM`       | -10   | Insufficient memory      |
 | `NO_BUFF`      | -11   | Insufficient buffer      |
 | `TIMEOUT`      | -12   | Operation timeout        |

i18n/en/docusaurus-plugin-content-docs/current/basic_coding/core/core-time.md

@@ -6,28 +6,28 @@ sidebar_position: 7
 
 # Timestamps and Time Differences
 
-This module defines microsecond- and millisecond-level timestamp types `TimestampUS` and `TimestampMS`, which represent system clock times and can be used to compute the time difference between two points. It is suitable for scenarios such as timers, delay control, and performance analysis.
+This module defines microsecond- and millisecond-level timestamp types `MicrosecondTimestamp` and `MillisecondTimestamp`, which represent system clock times and can be used to compute the time difference between two points. It is suitable for scenarios such as timers, delay control, and performance analysis.
 
-## TimestampUS
+## MicrosecondTimestamp
 
 ```cpp
-class TimestampUS {
+class MicrosecondTimestamp {
  public:
-  TimestampUS();
-  TimestampUS(uint64_t microsecond);
+  MicrosecondTimestamp();
+  MicrosecondTimestamp(uint64_t microsecond);
   operator uint64_t() const;
-  TimeDiffUS operator-(const TimestampUS &old) const;
+  Duration operator-(const MicrosecondTimestamp &old) const;
 };
 ```
 
 Represents a microsecond-level timestamp. Supports implicit conversion to `uint64_t` and can be used to compute time differences.
 
-### TimeDiffUS
+### Duration
 
 ```cpp
-class TimeDiffUS {
+class Duration {
  public:
-  TimeDiffUS(uint64_t diff);
+  Duration(uint64_t diff);
   operator uint64_t() const;
   double ToSecond() const;
   float ToSecondf() const;
@@ -36,37 +36,37 @@ class TimeDiffUS {
 };
 ```
 
-Represents the time difference between two `TimestampUS` instances, in microseconds. Supports conversion to seconds and milliseconds.
+Represents the time difference between two `MicrosecondTimestamp` instances, in microseconds. Supports conversion to seconds and milliseconds.
 
-## TimestampMS
+## MillisecondTimestamp
 
 ```cpp
-class TimestampMS {
+class MillisecondTimestamp {
  public:
-  TimestampMS();
-  TimestampMS(uint32_t millisecond);
+  MillisecondTimestamp();
+  MillisecondTimestamp(uint32_t millisecond);
   operator uint32_t() const;
-  TimeDiffMS operator-(TimestampMS &old);
+  Duration operator-(MillisecondTimestamp &old);
 };
 ```
 
 Represents a millisecond-level timestamp. Supports implicit conversion to `uint32_t` and can be used to compute time differences.
 
-### TimeDiffMS
+### Duration
 
 ```cpp
-class TimeDiffMS {
+class Duration {
  public:
-  TimeDiffMS(uint32_t diff);
+  Duration(uint32_t diff);
   operator uint32_t() const;
-  double ToSecond();
-  float ToSecondf();
+  double ToSecond() const;
+  float ToSecondf() const;
   uint64_t ToMicrosecond() const;
   uint32_t ToMillisecond() const;
 };
 ```
 
-Represents the time difference between two `TimestampMS` instances, in milliseconds. Supports conversion to seconds and microseconds.
+Represents the time difference between two `MillisecondTimestamp` instances, in milliseconds. Supports conversion to seconds and microseconds.
 
 ## Overflow Handling
 

i18n/en/docusaurus-plugin-content-docs/current/basic_coding/driver/flash.md

@@ -15,16 +15,25 @@ class Flash {
 public:
   Flash(size_t min_erase_size, size_t min_write_size, RawData flash_area);
 
-  // Erase a specified region (starting offset and size)
+  // Erase the specified region (starting offset and length)
   virtual ErrorCode Erase(size_t offset, size_t size) = 0;
 
-  // Write data to a specified offset address
+  // Write data to the specified offset
   virtual ErrorCode Write(size_t offset, ConstRawData data) = 0;
 
-  size_t min_erase_size_;   // Minimum erasable block size (in bytes)
-  size_t min_write_size_;   // Minimum writable block size (in bytes)
-  RawData flash_area_;      // Mapped flash memory region
+  // Read data from the specified offset
+  virtual ErrorCode Read(size_t offset, RawData data) = 0;
+
+  // Get the minimum erasable block size
+  size_t MinEraseSize() const { return min_erase_size_; }
+
+  // Get the minimum writable block size
+  size_t MinWriteSize() const { return min_write_size_; }
+
+  // Get the size of the flash
+  size_t Size() const { return flash_area_.size_; }
 };
+
 ```
 
 ## Usage Notes

i18n/en/docusaurus-plugin-content-docs/current/code_gen/stm32/uart.md

@@ -65,13 +65,13 @@ terminal_source: usb
 
 # Terminal-related settings (optional)
 Terminal:
-  READ_BUFF_SIZE: 32      # Terminal read buffer size
-  MAX_LINE_SIZE: 32       # Maximum line size
-  MAX_ARG_NUMBER: 5       # Maximum argument number
-  MAX_HISTORY_NUMBER: 5   # Maximum history number
-  RunAsThread: true       # Run as a thread
-  ThreadStackDepth: 1024  # Thread stack depth (only effective under thread mode)
-  ThreadPriority: 3       # Thread priority (only effective under thread mode)
+  read_buff_size: 32      # Terminal read buffer size
+  max_line_size: 32       # Maximum line size
+  max_arg_number: 5       # Maximum argument number
+  max_history_number: 5   # Maximum history number
+  run_as_thread: true       # Run as a thread
+  thread_stack_depth: 1024  # Thread stack depth (only effective under thread mode)
+  thread_priority: 3       # Thread priority (only effective under thread mode)
 
 # Hardware UART configuration
 USART:

i18n/en/docusaurus-plugin-content-docs/current/code_gen/stm32/watchdog.md

@@ -40,14 +40,14 @@ Configure watchdog behavior via `.config.yaml`:
 IWDG:
   iwdg1:
     timeout_ms: 1000   # Timeout in milliseconds
-    feed_ms: 250       # Feed interval in milliseconds
+    feed_interval_ms: 250       # Feed interval in milliseconds
 
 # Global watchdog options
 Watchdog:
-  RunAsThread: true         # Whether to run as thread (otherwise uses timer)
-  ThreadStackDepth: 1024    # Stack size for thread (only effective if thread enabled)
-  ThreadPriority: 3         # Thread priority (only effective if thread enabled)
-  FeedInterval: 250         # Feed interval in ms for timer mode (default 250)
+  run_as_thread: true         # Whether to run as thread (otherwise uses timer)
+  feed_interval_ms: 1024    # Stack size for thread (only effective if thread enabled)
+  thread_stack_depth: 3         # Thread priority (only effective if thread enabled)
+  thread_priority: 250         # Feed interval in ms for timer mode (default 250)
 ```
 
 > * If `RunAsThread: true`, each enabled IWDG generates a thread; thread parameters are global.