From 201f921dc498e98e39d015419f1c8b1c6d1d51d5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=8F=9C=E5=BE=97=E8=AE=A9=E4=BA=BA=E5=8F=91=E6=AF=9B?=
 <2328204591@qq.com>
Date: Tue, 16 Sep 2025 16:15:26 +0800
Subject: [PATCH 1/2] =?UTF-8?q?feat(doc):=20OInput=E7=BB=84=E4=BB=B6?=
 =?UTF-8?q?=E6=96=87=E6=A1=A3=E8=A1=A5=E5=85=85kind=E5=AD=97=E6=AE=B5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 packages/opendesign/src/input/__docs__/index.en-US.md | 1 +
 packages/opendesign/src/input/__docs__/index.zh-CN.md | 1 +
 2 files changed, 2 insertions(+)

diff --git a/packages/opendesign/src/input/__docs__/index.en-US.md b/packages/opendesign/src/input/__docs__/index.en-US.md
index 4b2b1f72..d8927b5c 100644
--- a/packages/opendesign/src/input/__docs__/index.en-US.md
+++ b/packages/opendesign/src/input/__docs__/index.en-US.md
@@ -1,5 +1,6 @@
 ---
 sidebar: OInput
+kind: input
 ---
 
 # Input box
diff --git a/packages/opendesign/src/input/__docs__/index.zh-CN.md b/packages/opendesign/src/input/__docs__/index.zh-CN.md
index f64d6045..c9ed0765 100644
--- a/packages/opendesign/src/input/__docs__/index.zh-CN.md
+++ b/packages/opendesign/src/input/__docs__/index.zh-CN.md
@@ -1,5 +1,6 @@
 ---
 sidebar: OInput 输入框
+kind: input
 ---
 
 # 输入框
-- 
Gitee


From fbe9fb78d7de02e6fe40d1f48ab446b2a5500e64 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=8F=9C=E5=BE=97=E8=AE=A9=E4=BA=BA=E5=8F=91=E6=AF=9B?=
 <2328204591@qq.com>
Date: Tue, 16 Sep 2025 16:22:12 +0800
Subject: [PATCH 2/2] =?UTF-8?q?feat(doc):=20=E6=96=B0=E5=A2=9EOProgress?=
 =?UTF-8?q?=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../__docs__/__case__/ProgressSize.vue        | 46 ++++++++++
 .../__docs__/__case__/ProgressUsage.vue       | 85 +++++++++++++++++++
 .../src/progress/__docs__/index.en-US.md      | 15 ++++
 .../src/progress/__docs__/index.zh-CN.md      | 15 ++++
 .../src/progress/style/theme-ascend.scss      |  6 ++
 .../src/progress/style/theme-kunpeng.scss     |  6 ++
 .../src/progress/style/theme-openeuler.scss   |  6 ++
 packages/opendesign/src/progress/types.ts     | 34 ++++++--
 8 files changed, 204 insertions(+), 9 deletions(-)
 create mode 100644 packages/opendesign/src/progress/__docs__/__case__/ProgressSize.vue
 create mode 100644 packages/opendesign/src/progress/__docs__/__case__/ProgressUsage.vue
 create mode 100644 packages/opendesign/src/progress/__docs__/index.en-US.md
 create mode 100644 packages/opendesign/src/progress/__docs__/index.zh-CN.md

diff --git a/packages/opendesign/src/progress/__docs__/__case__/ProgressSize.vue b/packages/opendesign/src/progress/__docs__/__case__/ProgressSize.vue
new file mode 100644
index 00000000..1d7ef7d2
--- /dev/null
+++ b/packages/opendesign/src/progress/__docs__/__case__/ProgressSize.vue
@@ -0,0 +1,46 @@
+<docs lang="md">
+<!-- zh-CN -->
+
+#### 尺寸
+
+<!-- en-US -->
+
+#### Size
+</docs>
+<script setup lang="ts">
+import { OProgress } from '@opensig/opendesign';
+
+const trackWidth = 300;
+const percentage = 30;
+</script>
+<template>
+  <div class="demo-progress-size-wrap">
+    <div class="demo-progress-size">
+      <div class="size-label">M</div>
+      <OProgress size="medium" :track-width="trackWidth" />
+      <OProgress size="medium" :track-width="trackWidth" :percentage="percentage" />
+    </div>
+    <div class="demo-progress-size">
+      <div class="size-label">S</div>
+      <OProgress size="small" :track-width="trackWidth" />
+      <OProgress size="small" :track-width="trackWidth" :percentage="percentage" />
+    </div>
+  </div>
+</template>
+<style lang="scss">
+@use '../../../_styles/mixin.scss';
+.demo-progress-size-wrap {
+  .demo-progress-size {
+    display: flex;
+    flex-direction: column;
+    align-items: start;
+    &:first-child {
+      margin-bottom: 16px;
+    }
+  }
+  .size-label {
+    width: 80px;
+    margin-right: 24px;
+  }
+}
+</style>
diff --git a/packages/opendesign/src/progress/__docs__/__case__/ProgressUsage.vue b/packages/opendesign/src/progress/__docs__/__case__/ProgressUsage.vue
new file mode 100644
index 00000000..0117737e
--- /dev/null
+++ b/packages/opendesign/src/progress/__docs__/__case__/ProgressUsage.vue
@@ -0,0 +1,85 @@
+<docs lang="md">
+<!-- zh-CN -->
+
+### 使用
+
+两种类型：`line`、`circle`；
+
+两种尺寸：`medium`、`small` ；
+
+四种颜色：`primary`、`success`、`warning`、`danger`；
+
+进度条百分比通过 `percentage` 属性控制；
+
+进度条线宽通过 `strokeWidth` 属性控制；
+
+进度条轨道宽度通过 `trackWidth` 属性控制；
+
+<!-- en-US -->
+
+### Usage
+
+Two types: `line`、`circle`;
+
+Two sizes: `medium`、`small`;
+
+Four colors: `primary`、`success`、`warning`、`danger`;
+
+The percentage of the progress bar is controlled by the `percentage` attribute;
+
+The width of the progress bar is controlled by the `strokeWidth` attribute;
+
+The width of the progress bar track is controlled by the `trackWidth` attribute;
+</docs>
+<script setup lang="ts">
+import { reactive } from 'vue';
+import { propsToAttrStr } from '../../../_demo/utils';
+import { DocDemoSchema, DocDemoTemplate } from '../../../_demo/types';
+
+const _schema = {
+  variant: {
+    type: 'list',
+    list: ['line', 'circle'],
+  },
+  size: {
+    type: 'list',
+    list: ['medium', 'small'],
+  },
+  color: {
+    type: 'list',
+    list: ['primary', 'success', 'warning', 'danger'],
+  },
+  percentage: {
+    type: 'number',
+    default: 30,
+  },
+  strokeWidth: {
+    type: 'number',
+    default: 8,
+  },
+  trackWidth: {
+    type: 'number',
+    default: 300,
+  },
+  'icon(slot)': {
+    type: 'boolean',
+  },
+} satisfies Record<string, DocDemoSchema>;
+
+const _template: DocDemoTemplate<typeof _schema> = (props) => {
+  const { 'icon(slot)': iconSlot, color } = props;
+  let innerHTML = '';
+  if (iconSlot && color === 'warning') {
+    innerHTML += '\n<template #icon><OIconWarning /></template>';
+  }
+  if (iconSlot && color === 'danger') {
+    innerHTML += '\n<template #icon><OIconDanger /></template>';
+  }
+  return `<OProgress  ${propsToAttrStr(props)} >${innerHTML}</OProgress>`;
+};
+
+const _ctx = reactive({
+  inputVal: '',
+});
+</script>
+<style lang="scss"></style>
diff --git a/packages/opendesign/src/progress/__docs__/index.en-US.md b/packages/opendesign/src/progress/__docs__/index.en-US.md
new file mode 100644
index 00000000..e6fb1ed3
--- /dev/null
+++ b/packages/opendesign/src/progress/__docs__/index.en-US.md
@@ -0,0 +1,15 @@
+---
+sidebar: OProgress
+kind: feedback
+---
+
+# progress
+
+## 示例
+
+<!-- @usage ProgressUsage -->
+<!-- @case:a|k|e ProgressSize -->
+
+## Api
+
+<!-- @api OProgress -->
diff --git a/packages/opendesign/src/progress/__docs__/index.zh-CN.md b/packages/opendesign/src/progress/__docs__/index.zh-CN.md
new file mode 100644
index 00000000..210a4abe
--- /dev/null
+++ b/packages/opendesign/src/progress/__docs__/index.zh-CN.md
@@ -0,0 +1,15 @@
+---
+sidebar: OProgress 进度条
+kind: feedback
+---
+
+# 进度条
+
+## 示例
+
+<!-- @usage ProgressUsage -->
+<!-- @case:a|k|e ProgressSize -->
+
+## Api
+
+<!-- @api OProgress -->
diff --git a/packages/opendesign/src/progress/style/theme-ascend.scss b/packages/opendesign/src/progress/style/theme-ascend.scss
index e69de29b..f246d63a 100644
--- a/packages/opendesign/src/progress/style/theme-ascend.scss
+++ b/packages/opendesign/src/progress/style/theme-ascend.scss
@@ -0,0 +1,6 @@
+.o-progress-primary,
+.o-progress-success {
+  .o-progress-line-bar {
+    background-image: linear-gradient(90deg, rgb(var(--o-deepblue-6)) 0%, rgb(var(--o-purple-6)) 100%);
+  }
+}
\ No newline at end of file
diff --git a/packages/opendesign/src/progress/style/theme-kunpeng.scss b/packages/opendesign/src/progress/style/theme-kunpeng.scss
index e69de29b..4ffd42aa 100644
--- a/packages/opendesign/src/progress/style/theme-kunpeng.scss
+++ b/packages/opendesign/src/progress/style/theme-kunpeng.scss
@@ -0,0 +1,6 @@
+.o-progress-primary,
+.o-progress-success {
+  .o-progress-line-bar {
+    background-image: linear-gradient(90deg, rgb(var(--ak-color-band-start)) 0%, rgb(var(--ak-color-band-end)) 100%);
+  }
+}
\ No newline at end of file
diff --git a/packages/opendesign/src/progress/style/theme-openeuler.scss b/packages/opendesign/src/progress/style/theme-openeuler.scss
index e69de29b..f656c4b3 100644
--- a/packages/opendesign/src/progress/style/theme-openeuler.scss
+++ b/packages/opendesign/src/progress/style/theme-openeuler.scss
@@ -0,0 +1,6 @@
+.o-progress-primary,
+.o-progress-success {
+  .o-progress-line-bar {
+    background-image: linear-gradient(90deg, rgb(var(--o-kleinblue-6)) 0%, #21A9FC 100%);
+  }
+}
\ No newline at end of file
diff --git a/packages/opendesign/src/progress/types.ts b/packages/opendesign/src/progress/types.ts
index d449b3a3..6df1da8b 100644
--- a/packages/opendesign/src/progress/types.ts
+++ b/packages/opendesign/src/progress/types.ts
@@ -11,14 +11,18 @@ export type ProgressColorT = (typeof ProgressColorTypes)[number];
 
 export const progressProps = {
   /**
-   * 进度条类型 ProgressVariantT
+   * @zh-CN 进度条类型
+   * @en-US Progress bar type.
+   * @default 'line'
    */
   variant: {
     type: String as PropType<ProgressVariantT>,
     default: 'line',
   },
   /**
-   * 进度条百分比
+   * @zh-CN 进度条百分比
+   * @en-US Progress bar percentage.
+   * @default 0
    */
   percentage: {
     type: Number,
@@ -26,47 +30,59 @@ export const progressProps = {
     validator: (val: number): boolean => val >= 0 && val <= 100,
   },
   /**
-   * 进度条线宽
+   * @zh-CN 进度条线宽
+   * @en-US Width of the progress bar.
    */
   strokeWidth: {
     type: Number,
   },
   /**
-   * 进度条尺寸类型 ProgressSizeT
+   * @zh-CN 进度条尺寸
+   * @en-US Progress bar size.
+   * @default 'medium'
    */
   size: {
     type: String as PropType<ProgressSizeT>,
     default: 'medium',
   },
   /**
-   * 进度条颜色类型 ProgressColorT
+   * @zh-CN 进度条颜色
+   * @en-US Progress bar color.
+   * @default 'primary'
    */
   color: {
     type: String as PropType<ProgressColorT>,
     default: 'primary',
   },
   /**
-   * 进度条轨道宽度，当为环形进度条时，仅支持Number
+   * @zh-CN 进度条轨道宽度，当为环形进度条时，仅支持Number
+   * @en-US The width of the progress bar track, when it is a circular progress bar, only supports Number.
    */
   trackWidth: {
     type: [Number, String],
   },
   /**
-   * 格式化文字
+   * @zh-CN 格式化文字
+   * @en-US Formatted text.
+   * @default (percentage: number) => `${percentage}%`
    */
   format: {
     type: Function as PropType<(percentage: number) => string>,
     default: (percentage: number) => `${percentage}%`,
   },
   /**
-   * 是否展示文字
+   * @zh-CN 是否展示文字
+   * @en-US Whether to display text.
+   * @default true
    */
   showLabel: {
     type: Boolean,
     default: true,
   },
   /**
-   * 线形进度条，文字是否在进度条内部
+   * @zh-CN 线形进度条，文字是否在进度条内部
+   * @en-US Linear progress bar. Is the text inside the progress bar.
+   * @default false
    */
   labelInside: {
     type: Boolean,
-- 
Gitee