diff --git a/packages/opendesign/src/input/__docs__/__case__/InputBasic.vue b/packages/opendesign/src/input/__docs__/__case__/InputBasic.vue
index 6d44ee410182177f9a821bafe2a7a55af66ab2a9..79659aab681730a77b5041958ad98f9b6c517067 100644
--- a/packages/opendesign/src/input/__docs__/__case__/InputBasic.vue
+++ b/packages/opendesign/src/input/__docs__/__case__/InputBasic.vue
@@ -17,7 +17,7 @@ const hasTextInputVal = ref('Hint');
 <template>
   <div class="demo-input-basic-wrap">
     <div class="no-text">
-      <h2 class="size-label no-text-label">无文本</h2>
+      <div class="size-label no-text-label">无文本</div>
       <div class="input-wrap">
         <span class="status-label"> Enabled </span>
         <OInput v-model="noTextInputVal" class="input-medium" size="large" round="pill" placeholder="Hint" />
@@ -35,7 +35,7 @@ const hasTextInputVal = ref('Hint');
       </div>
     </div>
     <div class="has-text">
-      <h2 class="size-label">有文本</h2>
+      <div class="size-label">有文本</div>
       <div class="input-wrap"><OInput v-model="hasTextInputVal" class="input-medium" size="large" round="pill" :clearable="true" /></div>
       <div class="input-wrap"><OInput v-model="hasTextInputVal" class="input-medium" size="large" round="pill" :clearable="true" disabled /></div>
       <div class="input-wrap">
diff --git a/packages/opendesign/src/input/__docs__/__case__/InputSize.vue b/packages/opendesign/src/input/__docs__/__case__/InputSize.vue
index 3e2092165d4a7bde2af4bedbdc9362750283bbf3..a0edc6db691248b506a5b2d6c3f7bd1ce34fe405 100644
--- a/packages/opendesign/src/input/__docs__/__case__/InputSize.vue
+++ b/packages/opendesign/src/input/__docs__/__case__/InputSize.vue
@@ -18,11 +18,11 @@ const mediumInputVal = ref('');
 <template>
   <div class="demo-input-size-wrap">
     <div class="demo-input-size">
-      <h2 class="size-label">L</h2>
+      <div class="size-label">L</div>
       <OInput v-model="largeInputVal" class="input-large" size="large" round="pill" :placeholder="placeholder" />
     </div>
     <div class="demo-input-size">
-      <h2 class="size-label">M</h2>
+      <div class="size-label">M</div>
       <OInput v-model="mediumInputVal" class="input-medium" size="medium" round="pill" :placeholder="placeholder" />
     </div>
   </div>
diff --git a/packages/opendesign/src/progress/types.ts b/packages/opendesign/src/progress/types.ts
index 6df1da8b044e04f71880942ddd26b8474fe24617..26221585f71706b9be3c50b3062e8db2ed21aad7 100644
--- a/packages/opendesign/src/progress/types.ts
+++ b/packages/opendesign/src/progress/types.ts
@@ -23,6 +23,7 @@ export const progressProps = {
    * @zh-CN 进度条百分比
    * @en-US Progress bar percentage.
    * @default 0
+   * @validator (val: number): boolean => val >= 0 && val <= 100
    */
   percentage: {
     type: Number,
diff --git a/packages/opendesign/src/radio-group/types.ts b/packages/opendesign/src/radio-group/types.ts
index b4b5de24a53d77b86179ca5b064b1a9d72a92a2d..26fbd0008a321261cfe6591f897ccc6c3b0f99ed 100644
--- a/packages/opendesign/src/radio-group/types.ts
+++ b/packages/opendesign/src/radio-group/types.ts
@@ -3,27 +3,34 @@ import { DirectionT } from '../_utils/types';
 
 export const radioGroupProps = {
   /**
-   * 单选框组双向绑定值
+   * @zh-CN 单选框组双向绑定值
+   * @en-US Two-way binding values for radio box groups.
    */
   modelValue: {
     type: [String, Number, Boolean],
   },
   /**
-   * 非受控状态时，单选框组默认值
+   * @zh-CN 非受控状态时，单选框组默认值
+   * @en-US The default value of the radio box group in an uncontrolled state.
+   * @default ''
    */
   defaultValue: {
     type: [String, Number, Boolean],
     default: '',
   },
   /**
-   * 单选框组是否禁用
+   * @zh-CN 单选框组是否禁用
+   * @en-US Whether the radio box group is disabled.
+   * @default false
    */
   disabled: {
     type: Boolean,
     default: false,
   },
   /**
-   * 单选框组方向 DirectionT
+   * @zh-CN 单选框组方向
+   * @en-US Direction of the radio box group.
+   * @default 'h'
    */
   direction: {
     type: String as PropType<DirectionT>,
diff --git a/packages/opendesign/src/radio/__docs__/__case__/RadioGroup.vue b/packages/opendesign/src/radio/__docs__/__case__/RadioGroup.vue
new file mode 100644
index 0000000000000000000000000000000000000000..92710ee24206de1b7ed33db5058b648c5203bdf7
--- /dev/null
+++ b/packages/opendesign/src/radio/__docs__/__case__/RadioGroup.vue
@@ -0,0 +1,69 @@
+<docs lang="md">
+<!-- zh-CN -->
+
+#### 单选框组
+
+在 `ORadio` 数量较多的情况下，可以通过 `ORadioGroup` 统一管理单选框的状态，比如：
+
+1. 将所有 `ORadio` 的双向绑定委托给 `ORadioGroup`
+2. `disabled` 属性控制所有的单选框是否禁用
+3. `direction` 属性控制多选框组内多选框的排列方向
+
+<!-- en-US -->
+
+#### Radio Group
+
+When there are a large number of `ORdio`, the status of the radio boxes can be uniformly managed through `ORadioGroup`, for example:
+
+1. Delegate all the two-way bindings of `ORadio` to `ORadioGroup`.
+2. The `disabled` attribute controls whether all radio boxes are disabled.
+3. The `direction` attribute controls the arrangement direction of the multiple-choice boxes within a multiple-choice box group.
+</docs>
+<script setup lang="ts">
+import { ref, computed } from 'vue';
+import { ORadio, ORadioGroup, OSwitch, type DirectionT } from '@opensig/opendesign';
+
+const radioVal = ref('');
+const switchVal1 = ref(false);
+const switchVal2 = ref(false);
+
+const direction = computed<DirectionT>(() => {
+  if (switchVal1.value) {
+    return 'v';
+  }
+  return 'h';
+});
+</script>
+<template>
+  <div class="demo-radio-group-wrap">
+    <div class="switch-operation">
+      <span class="operation-des">切换排布方向</span>
+      <OSwitch v-model="switchVal1" />
+    </div>
+    <div class="switch-operation">
+      <span class="operation-des">切换禁用状态</span>
+      <OSwitch v-model="switchVal2" />
+    </div>
+    <ORadioGroup v-model="radioVal" :disabled="switchVal2" :direction="direction">
+      <ORadio value="peach">选项1</ORadio>
+      <ORadio value="watermelon">选项2</ORadio>
+      <ORadio value="pear">选项3</ORadio>
+    </ORadioGroup>
+    <div class="radio-val">Selected：{{ radioVal }}</div>
+  </div>
+</template>
+<style lang="scss">
+.demo-radio-group-wrap {
+  .switch-operation {
+    display: flex;
+    align-items: center;
+    margin-bottom: 12px;
+  }
+  .operation-des {
+    margin-right: 12px;
+  }
+  .radio-val {
+    margin-top: 12px;
+  }
+}
+</style>
diff --git a/packages/opendesign/src/radio/__docs__/__case__/RadioUsage.vue b/packages/opendesign/src/radio/__docs__/__case__/RadioUsage.vue
new file mode 100644
index 0000000000000000000000000000000000000000..7416a25fcfee6f6984fa81071e7f69d66bcdf415
--- /dev/null
+++ b/packages/opendesign/src/radio/__docs__/__case__/RadioUsage.vue
@@ -0,0 +1,65 @@
+<docs lang="md">
+<!-- zh-CN -->
+
+### 使用
+
+单选框传值：
+
+1. `value` 用于设置选中后 `modelValue` 的值
+2. `modelValue` 的类型是 `string | number | boolean`，当选中后 `modelValue` 的值为 `value` 值
+
+单选框组：当单选框的数量较多时，单选框组可以用来简化 `v-model` 的书写，此时将 `v-model` 写在单选框组上即可
+
+<!-- en-US -->
+
+### Usage
+
+Oradio Value Binding:
+
+1. The `value` is used to set the value of the `modelValue` after selection.
+2. The type of `modelValue` is `string | number | boolean`. If selected, the value of `modelValue` will be the value of `Value`.
+
+ORadio Groups: When there are a large number of radio choice boxes, radio choice box groups can be used to simplify the writing of `v-model`. At this time, just write `v-model` on the radio choice box group.
+</docs>
+<script setup lang="ts">
+import { reactive } from 'vue';
+import { propsToAttrStr } from '../../../_demo/utils';
+import { DocDemoSchema, DocDemoTemplate } from '../../../_demo/types';
+
+const _schema = {
+  value: {
+    type: 'string',
+    default: 'radio',
+  },
+  disabled: {
+    type: 'boolean',
+  },
+} satisfies Record<string, DocDemoSchema>;
+
+const _template: DocDemoTemplate<typeof _schema> = (props) => {
+  return `  <div class="demo-radio-usage-wrap">
+  <ORadio class="demo-radio-usage" v-model="ctx.radioVal" ${propsToAttrStr(props)} >Apple</ORadio>
+    <div class="demo-radio-val">
+    Selected：{{ ctx.radioVal }}
+  </div></div>
+  `;
+};
+
+const _ctx = reactive({
+  radioVal: '',
+});
+</script>
+<style lang="scss">
+.demo-radio-usage-wrap {
+  .demo-radio-usage {
+    display: block;
+    width: fit-content;
+    .o-radio-wrap {
+      width: fit-content;
+    }
+  }
+  .demo-radio-val {
+    margin-top: 16px;
+  }
+}
+</style>
diff --git a/packages/opendesign/src/radio/__docs__/index.en-US.md b/packages/opendesign/src/radio/__docs__/index.en-US.md
new file mode 100644
index 0000000000000000000000000000000000000000..5803505f3897d4e2b50fc66e85b0887f51c526ee
--- /dev/null
+++ b/packages/opendesign/src/radio/__docs__/index.en-US.md
@@ -0,0 +1,16 @@
+---
+sidebar: ORadio
+kind: operator
+---
+
+# ORadio
+
+## 示例
+
+<!-- @usage RadioUsage -->
+<!-- @case:a|k|e RadioGroup -->
+
+## Api
+
+<!-- @api ORadio -->
+<!-- @api ../../radio-group/__docs__/ORadioGroup -->
diff --git a/packages/opendesign/src/radio/__docs__/index.zh-CN.md b/packages/opendesign/src/radio/__docs__/index.zh-CN.md
new file mode 100644
index 0000000000000000000000000000000000000000..b392174335ec46dccc6114a437b8905a395955d8
--- /dev/null
+++ b/packages/opendesign/src/radio/__docs__/index.zh-CN.md
@@ -0,0 +1,16 @@
+---
+sidebar: ORadio 单选框
+kind: operator
+---
+
+# 单选框
+
+## 示例
+
+<!-- @usage RadioUsage -->
+<!-- @case:a|k|e RadioGroup -->
+
+## Api
+
+<!-- @api ORadio -->
+<!-- @api ../../radio-group/__docs__/ORadioGroup -->
diff --git a/packages/opendesign/src/radio/types.ts b/packages/opendesign/src/radio/types.ts
index ecf8fa63b9201e49177a60059b4e629bc7617a13..1827f28af0bebc65454c066dbebb3058aef3ae52 100644
--- a/packages/opendesign/src/radio/types.ts
+++ b/packages/opendesign/src/radio/types.ts
@@ -2,34 +2,41 @@ import { ExtractPropTypes } from 'vue';
 
 export const radioProps = {
   /**
-   * 单选框value
+   * @zh-CN 单选框value
+   * @en-US Radio box value.
    */
   value: {
     type: [String, Number, Boolean],
-    required: true,
+    required: true as const,
   },
   /**
-   * 单选框双向绑定值
+   * @zh-CN 单选框双向绑定值
+   * @en-US Two-way binding values for single-choice boxes.
    */
   modelValue: {
     type: [String, Number, Boolean],
   },
   /**
-   * 非受控状态时，默认是否选中
+   * @zh-CN 非受控状态时，默认是否选中
+   * @en-US Whether it is selected by default when in an uncontrolled state.
+   * @default false
    */
   defaultChecked: {
     type: Boolean,
     default: false,
   },
   /**
-   * 是否禁用
+   * @zh-CN 是否禁用
+   * @en-US Whether to disable.
+   * @default false
    */
   disabled: {
     type: Boolean,
     default: false,
   },
   /**
-   * input id
+   * @zh-CN 用于关联label元素与input元素
+   * @en-US Used to associate the label element with the input element.
    */
   inputId: {
     type: String,
diff --git a/packages/opendesign/src/result/__docs__/__case__/ResultAbnormal.vue b/packages/opendesign/src/result/__docs__/__case__/ResultAbnormal.vue
new file mode 100644
index 0000000000000000000000000000000000000000..9824fbc8d60e5031a8953948adb948df77f85681
--- /dev/null
+++ b/packages/opendesign/src/result/__docs__/__case__/ResultAbnormal.vue
@@ -0,0 +1,28 @@
+<docs lang="md">
+<!-- zh-CN -->
+
+#### 异常态
+
+<!-- en-US -->
+
+#### Abnormal state
+</docs>
+<script setup lang="ts">
+import { OResult, OButton } from '@opensig/opendesign';
+import imgSrc from '../../../../icons/svgs/fill/image-error.svg';
+
+const title = '暂无工单';
+const description = '内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容';
+</script>
+<template>
+  <div class="demo-result-wrap">
+    <OResult :title="title" :description="description">
+      <template #image>
+        <img :src="imgSrc" alt="" />
+      </template>
+      <template #extra>
+        <OButton size="large" color="primary" variant="solid" round="pill">在线提单</OButton>
+      </template>
+    </OResult>
+  </div>
+</template>
diff --git a/packages/opendesign/src/result/__docs__/__case__/ResultNormal.vue b/packages/opendesign/src/result/__docs__/__case__/ResultNormal.vue
new file mode 100644
index 0000000000000000000000000000000000000000..7230543f90430729212ca94a47a094b17b2658d3
--- /dev/null
+++ b/packages/opendesign/src/result/__docs__/__case__/ResultNormal.vue
@@ -0,0 +1,37 @@
+<docs lang="md">
+<!-- zh-CN -->
+
+#### 结果态
+
+<!-- en-US -->
+
+#### Result state
+</docs>
+<script setup lang="ts">
+import { OResult, OButton } from '@opensig/opendesign';
+
+const title = '提交成功';
+const description = '内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容内容';
+const status = 'success';
+</script>
+<template>
+  <div class="demo-result-wrap">
+    <OResult :title="title" :description="description" :status="status">
+      <template #extra>
+        <OButton class="extra-btn" size="large" variant="outline" color="primary" round="pill">返回首页</OButton>
+        <OButton class="extra-btn" size="large" variant="outline" color="primary" round="pill">我的计划</OButton>
+      </template>
+    </OResult>
+  </div>
+</template>
+<style lang="scss">
+@use '../../../_styles/mixin.scss';
+.demo-result-wrap {
+  .extra-btn {
+    margin: 0 8px;
+    @include respond-to('<=pad') {
+      margin: 0 6px;
+    }
+  }
+}
+</style>
diff --git a/packages/opendesign/src/result/__docs__/__case__/ResultUsage.vue b/packages/opendesign/src/result/__docs__/__case__/ResultUsage.vue
new file mode 100644
index 0000000000000000000000000000000000000000..d9083f27bb14242d2db617de5fa7798b9726ae9a
--- /dev/null
+++ b/packages/opendesign/src/result/__docs__/__case__/ResultUsage.vue
@@ -0,0 +1,45 @@
+<docs lang="md">
+<!-- zh-CN -->
+
+### 使用
+
+1. `status` 控制展示结果的状态，有四种状态：`info`, `success`, `warning`, `danger`；
+2. `title` 属性用于自定义结果展示的标题；
+3. `description` 属性用于自定义对结果的补充描述；
+
+<!-- en-US -->
+
+1. `status` controls the status of the display result. There are four types of status: `info`, `success`, `warning`, and `danger`.
+2. The `title` attribute is used to customize the title of the result display.
+3. The `description` attribute is used to customize the supplementary description of the result.
+
+### Usage
+</docs>
+<script setup lang="ts">
+import { propsToAttrStr } from '../../../_demo/utils';
+import { DocDemoSchema, DocDemoTemplate } from '../../../_demo/types';
+
+const _schema = {
+  title: {
+    type: 'string',
+    default: '提交成功',
+  },
+  description: {
+    type: 'string',
+    default: '您的申请正在审核中，请您耐心等待。',
+  },
+  status: {
+    type: 'list',
+    list: ['success', 'info', 'warning', 'danger'],
+  },
+} satisfies Record<string, DocDemoSchema>;
+
+const _template: DocDemoTemplate<typeof _schema> = (props) => {
+  return `  <div class="demo-result-usage-wrap">
+  <OResult class="demo-result-usage" ${propsToAttrStr(props)} />
+   </div>
+  `;
+};
+
+const _ctx = {};
+</script>
diff --git a/packages/opendesign/src/result/__docs__/index.en-US.md b/packages/opendesign/src/result/__docs__/index.en-US.md
new file mode 100644
index 0000000000000000000000000000000000000000..479f41d50a08cc9a5ffe30c1bb379596f6e59826
--- /dev/null
+++ b/packages/opendesign/src/result/__docs__/index.en-US.md
@@ -0,0 +1,16 @@
+---
+sidebar: OResult
+kind: feedback
+---
+
+# Result display
+
+## 示例
+
+<!-- @usage ResultUsage -->
+<!-- @case:a|k|e ResultNormal -->
+<!-- @case:a|k|e ResultAbnormal -->
+
+## Api
+
+<!-- @api OResult -->
diff --git a/packages/opendesign/src/result/__docs__/index.zh-CN.md b/packages/opendesign/src/result/__docs__/index.zh-CN.md
new file mode 100644
index 0000000000000000000000000000000000000000..4dc9da067a1169e961e647253f117e951062d6fa
--- /dev/null
+++ b/packages/opendesign/src/result/__docs__/index.zh-CN.md
@@ -0,0 +1,16 @@
+---
+sidebar: OResult 结果
+kind: feedback
+---
+
+# 结果展示
+
+## 示例
+
+<!-- @usage ResultUsage -->
+<!-- @case:a|k|e ResultNormal -->
+<!-- @case:a|k|e ResultAbnormal -->
+
+## Api
+
+<!-- @api OResult -->
diff --git a/packages/opendesign/src/result/types.ts b/packages/opendesign/src/result/types.ts
index d54df0435638a9b13a532959c778c39fbd4036c7..98a876993aefcd209d29ee5d65237aabeb2524b9 100644
--- a/packages/opendesign/src/result/types.ts
+++ b/packages/opendesign/src/result/types.ts
@@ -5,20 +5,23 @@ export type ResultStatusT = (typeof ResultStatusTypes)[number];
 
 export const resultProps = {
   /**
-   * 状态
+   * @zh-CN 状态
+   * @en-US Status.
    */
   status: {
     type: String as PropType<ResultStatusT>,
   },
   /**
-   * 标题
+   * @zh-CN 标题
+   * @en-US Title.
    */
   title: {
     type: String,
   },
   /**
-   * 描述
-   **/
+   * @zh-CN 描述
+   * @en-US Description.
+   */
   description: {
     type: String,
   },