@blueking/bkui-knowledge 0.0.1-beta.1

package/knowledge/component-apis/tag.json

@@ -0,0 +1,89 @@
+{
+  "name": "bk-tag",
+  "description": "标签组件",
+  "version": "3.0",
+
+  "props": {
+    "theme": {
+      "type": "'success' | 'info' | 'warning' | 'danger'",
+      "default": "undefined",
+      "description": "主题色"
+    },
+    "type": {
+      "type": "'filled' | 'stroke'",
+      "default": "filled",
+      "description": "类型"
+    },
+    "closable": {
+      "type": "boolean",
+      "default": "false",
+      "description": "是否可关闭"
+    },
+    "checkable": {
+      "type": "boolean",
+      "default": "false",
+      "description": "是否可选中"
+    },
+    "checked": {
+      "type": "boolean",
+      "default": "false",
+      "description": "是否选中 (checkable 时使用)"
+    },
+    "radius": {
+      "type": "string",
+      "default": "2px",
+      "description": "圆角大小"
+    },
+    "size": {
+      "type": "'small' | 'large'",
+      "default": "undefined",
+      "description": "尺寸 (从源码)"
+    },
+    "stopPropagation": {
+      "type": "boolean",
+      "default": "true",
+      "description": "是否阻止事件冒泡 (从源码)"
+    }
+  },
+
+  "slots": {
+    "default": {
+      "description": "标签内容"
+    },
+    "icon": {
+      "description": "图标插槽"
+    }
+  },
+
+  "events": {
+    "close": {
+      "params": "(event: MouseEvent)",
+      "description": "关闭时触发"
+    },
+    "change": {
+      "params": "(checked: boolean)",
+      "description": "选中状态变化时触发"
+    }
+  },
+
+  "visualMapping": {
+    "description": "设计稿颜色到 theme 的映射",
+    "蓝色背景": "theme=\"info\"",
+    "绿色背景": "theme=\"success\"",
+    "橙色背景": "theme=\"warning\"",
+    "红色背景": "theme=\"danger\"",
+    "灰色边框": "type=\"stroke\"",
+    "默认灰色填充": "无 theme"
+  },
+
+  "tableUsage": {
+    "description": "在表格中使用标签的示例 (如：内置/自定义)",
+    "code": "<template #source=\"{ row }\">\n  <bk-tag :theme=\"row.source === 'builtin' ? 'info' : 'success'\">\n    {{ row.source === 'builtin' ? '内置' : '自定义' }}\n  </bk-tag>\n</template>",
+    "colorGuide": {
+      "内置/系统": "info (蓝色)",
+      "自定义/用户": "success (绿色)",
+      "警告/待处理": "warning (橙色)",
+      "错误/失败": "danger (红色)"
+    }
+  }
+}

package/knowledge/component-apis/time-picker.json

@@ -0,0 +1,63 @@
+{
+  "name": "bk-time-picker",
+  "description": "时间选择器组件",
+  "version": "3.0",
+
+  "props": {
+    "modelValue": {
+      "type": "string | Date | array",
+      "default": "undefined",
+      "description": "绑定值，支持 v-model"
+    },
+    "type": {
+      "type": "'time' | 'timerange'",
+      "default": "time",
+      "description": "选择器类型"
+    },
+    "format": {
+      "type": "string",
+      "default": "HH:mm:ss",
+      "description": "显示格式"
+    },
+    "placeholder": {
+      "type": "string",
+      "default": "请选择时间",
+      "description": "占位文本"
+    },
+    "disabled": {
+      "type": "boolean",
+      "default": "false",
+      "description": "是否禁用"
+    },
+    "readonly": {
+      "type": "boolean",
+      "default": "false",
+      "description": "是否只读"
+    },
+    "clearable": {
+      "type": "boolean",
+      "default": "true",
+      "description": "是否可清空"
+    },
+    "allowCrossDay": {
+      "type": "boolean",
+      "default": "false",
+      "description": "是否允许跨天 (timerange)"
+    }
+  },
+
+  "events": {
+    "update:modelValue": {
+      "params": "(value)",
+      "description": "值变化时触发"
+    },
+    "change": {
+      "params": "(value)",
+      "description": "值改变时触发"
+    },
+    "open-change": {
+      "params": "(isOpen: boolean)",
+      "description": "面板展开/收起时触发"
+    }
+  }
+}

package/knowledge/component-apis/timeline.json

@@ -0,0 +1,42 @@
+{
+  "name": "bk-timeline",
+  "description": "时间轴组件",
+  "version": "3.0",
+
+  "props": {
+    "list": {
+      "type": "array",
+      "default": "[]",
+      "description": "时间轴数据"
+    },
+    "titleAble": {
+      "type": "boolean",
+      "default": "false",
+      "description": "标题是否可点击"
+    }
+  },
+
+  "listItemProps": {
+    "tag": "string | VNode - 时间标签",
+    "content": "string | VNode - 内容",
+    "type": "string - 类型 (primary, success, warning, danger)",
+    "size": "string - 尺寸",
+    "color": "string - 颜色 (blue, red, green, yellow, gray)",
+    "icon": "VNode | function - 自定义图标",
+    "filled": "boolean - 是否填充",
+    "border": "boolean - 是否显示边框"
+  },
+
+  "slots": {
+    "content": {
+      "description": "自定义内容，参数为 item"
+    }
+  },
+
+  "events": {
+    "select": {
+      "params": "(item)",
+      "description": "点击时间轴项时触发"
+    }
+  }
+}

package/knowledge/component-apis/transfer.json

@@ -0,0 +1,78 @@
+{
+  "name": "bk-transfer",
+  "description": "穿梭框组件",
+  "version": "3.0",
+
+  "props": {
+    "sourceList": {
+      "type": "array",
+      "default": "[]",
+      "description": "左侧源数据"
+    },
+    "targetList": {
+      "type": "array",
+      "default": "[]",
+      "description": "右侧目标数据，支持 v-model"
+    },
+    "displayKey": {
+      "type": "string",
+      "default": "name",
+      "description": "显示字段名"
+    },
+    "settingKey": {
+      "type": "string",
+      "default": "id",
+      "description": "唯一标识字段名"
+    },
+    "sortKey": {
+      "type": "string",
+      "default": "undefined",
+      "description": "排序字段名"
+    },
+    "title": {
+      "type": "array",
+      "default": "['左侧列表', '右侧列表']",
+      "description": "左右列表标题"
+    },
+    "emptyContent": {
+      "type": "array",
+      "default": "['无数据', '未选择']",
+      "description": "空状态文案"
+    },
+    "sortable": {
+      "type": "boolean",
+      "default": "false",
+      "description": "右侧是否可排序"
+    },
+    "searchable": {
+      "type": "boolean",
+      "default": "false",
+      "description": "是否可搜索"
+    },
+    "searchPlaceholder": {
+      "type": "string",
+      "default": "请输入关键字",
+      "description": "搜索框占位符"
+    }
+  },
+
+  "slots": {
+    "source-option": {
+      "description": "自定义左侧列表项"
+    },
+    "target-option": {
+      "description": "自定义右侧列表项"
+    }
+  },
+
+  "events": {
+    "update:targetList": {
+      "params": "(value: array)",
+      "description": "目标列表变化时触发"
+    },
+    "change": {
+      "params": "(sourceList, targetList, changedList)",
+      "description": "数据变化时触发"
+    }
+  }
+}

package/knowledge/component-apis/tree.json

@@ -0,0 +1,98 @@
+{
+  "name": "bk-tree",
+  "description": "树形组件",
+  "version": "3.0",
+
+  "props": {
+    "data": {
+      "type": "array",
+      "default": "[]",
+      "description": "树形数据"
+    },
+    "nodeKey": {
+      "type": "string",
+      "default": "id",
+      "description": "节点唯一标识的键名"
+    },
+    "showCheckbox": {
+      "type": "boolean",
+      "default": "false",
+      "description": "是否显示复选框"
+    },
+    "checkStrictly": {
+      "type": "boolean",
+      "default": "false",
+      "description": "父子节点是否不关联"
+    },
+    "defaultExpandedKeys": {
+      "type": "array",
+      "default": "[]",
+      "description": "默认展开的节点"
+    },
+    "defaultCheckedKeys": {
+      "type": "array",
+      "default": "[]",
+      "description": "默认选中的节点"
+    },
+    "expandOnClickNode": {
+      "type": "boolean",
+      "default": "true",
+      "description": "点击节点是否展开"
+    },
+    "checkOnClickNode": {
+      "type": "boolean",
+      "default": "false",
+      "description": "点击节点是否选中"
+    },
+    "draggable": {
+      "type": "boolean",
+      "default": "false",
+      "description": "是否可拖拽"
+    },
+    "filterMethod": {
+      "type": "function",
+      "default": "undefined",
+      "description": "过滤方法"
+    },
+    "async": {
+      "type": "object",
+      "default": "undefined",
+      "description": "异步加载配置"
+    },
+    "virtualRender": {
+      "type": "boolean",
+      "default": "false",
+      "description": "是否启用虚拟滚动"
+    }
+  },
+
+  "events": {
+    "node-click": {
+      "params": "(node, data)",
+      "description": "节点点击时触发"
+    },
+    "node-expand": {
+      "params": "(node, data)",
+      "description": "节点展开时触发"
+    },
+    "node-collapse": {
+      "params": "(node, data)",
+      "description": "节点收起时触发"
+    },
+    "check": {
+      "params": "(node, checked, data)",
+      "description": "节点选中时触发"
+    },
+    "check-change": {
+      "params": "(data, checked)",
+      "description": "选中状态变化时触发"
+    }
+  },
+
+  "methods": {
+    "filter": "(keyword) - 过滤节点",
+    "getCheckedKeys": "() - 获取选中的节点 key",
+    "setCheckedKeys": "(keys) - 设置选中的节点",
+    "expandNode": "(key) - 展开指定节点"
+  }
+}

package/knowledge/component-apis/upload.json

@@ -0,0 +1,103 @@
+{
+  "name": "bk-upload",
+  "description": "文件上传组件",
+  "version": "3.0",
+
+  "props": {
+    "files": {
+      "type": "array",
+      "default": "[]",
+      "description": "已上传的文件列表，支持 v-model:files"
+    },
+    "url": {
+      "type": "string",
+      "default": "''",
+      "description": "上传地址"
+    },
+    "accept": {
+      "type": "string",
+      "default": "''",
+      "description": "接受的文件类型"
+    },
+    "multiple": {
+      "type": "boolean",
+      "default": "true",
+      "description": "是否支持多选"
+    },
+    "disabled": {
+      "type": "boolean",
+      "default": "false",
+      "description": "是否禁用"
+    },
+    "autoUpload": {
+      "type": "boolean",
+      "default": "true",
+      "description": "是否自动上传"
+    },
+    "limit": {
+      "type": "number",
+      "default": "undefined",
+      "description": "最大上传数量"
+    },
+    "size": {
+      "type": "number",
+      "default": "undefined",
+      "description": "单个文件最大大小 (MB)"
+    },
+    "withCredentials": {
+      "type": "boolean",
+      "default": "false",
+      "description": "是否携带 cookie"
+    },
+    "header": {
+      "type": "object",
+      "default": "{}",
+      "description": "请求头"
+    },
+    "customRequest": {
+      "type": "function",
+      "default": "undefined",
+      "description": "自定义上传方法"
+    },
+    "theme": {
+      "type": "'draggable' | 'button' | 'picture'",
+      "default": "draggable",
+      "description": "上传区域样式"
+    }
+  },
+
+  "slots": {
+    "default": {
+      "description": "自定义上传区域内容"
+    },
+    "tip": {
+      "description": "提示信息"
+    },
+    "file": {
+      "description": "自定义文件列表项"
+    }
+  },
+
+  "events": {
+    "success": {
+      "params": "(file, fileList)",
+      "description": "上传成功时触发"
+    },
+    "error": {
+      "params": "(file, fileList)",
+      "description": "上传失败时触发"
+    },
+    "progress": {
+      "params": "(event, file, fileList)",
+      "description": "上传进度变化时触发"
+    },
+    "exceed": {
+      "params": "(file, fileList)",
+      "description": "超出限制时触发"
+    },
+    "delete": {
+      "params": "(file, fileList)",
+      "description": "删除文件时触发"
+    }
+  }
+}

package/knowledge/component-apis/virtual-render.json

@@ -0,0 +1,71 @@
+{
+  "name": "bk-virtual-render",
+  "description": "虚拟滚动组件",
+  "version": "3.0",
+
+  "props": {
+    "list": {
+      "type": "array",
+      "default": "[]",
+      "description": "数据列表"
+    },
+    "height": {
+      "type": "number | string",
+      "default": "100%",
+      "description": "容器高度"
+    },
+    "lineHeight": {
+      "type": "number",
+      "default": "30",
+      "description": "每行高度"
+    },
+    "minHeight": {
+      "type": "number",
+      "default": "30",
+      "description": "最小行高"
+    },
+    "groupItemCount": {
+      "type": "number",
+      "default": "undefined",
+      "description": "每组渲染数量"
+    },
+    "preloadItemCount": {
+      "type": "number",
+      "default": "undefined",
+      "description": "预加载数量"
+    },
+    "enabled": {
+      "type": "boolean",
+      "default": "true",
+      "description": "是否启用虚拟滚动"
+    },
+    "scrollEvent": {
+      "type": "boolean",
+      "default": "false",
+      "description": "是否触发滚动事件"
+    },
+    "throttleDelay": {
+      "type": "number",
+      "default": "60",
+      "description": "滚动节流延迟"
+    },
+    "rowKey": {
+      "type": "string",
+      "default": "undefined",
+      "description": "行唯一标识字段"
+    }
+  },
+
+  "slots": {
+    "default": {
+      "description": "列表项内容，作用域插槽参数: { data, index }"
+    }
+  },
+
+  "events": {
+    "content-scroll": {
+      "params": "(event, position)",
+      "description": "滚动时触发"
+    }
+  }
+}

package/knowledge/examples/404.tsx

@@ -0,0 +1,33 @@
+/*
+ * Tencent is pleased to support the open source community by making
+ * 蓝鲸智云PaaS平台社区版 (BlueKing PaaS Community Edition) available.
+ *
+ * Copyright (C) 2025 Tencent.  All rights reserved.
+ *
+ * 蓝鲸智云PaaS平台社区版 (BlueKing PaaS Community Edition) is licensed under the MIT License.
+ *
+ * License for 蓝鲸智云PaaS平台社区版 (BlueKing PaaS Community Edition):
+ *
+ * ---------------------------------------------------
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
+ * documentation files (the "Software"), to deal in the Software without restriction, including without limitation
+ * the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and
+ * to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of
+ * the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
+ * THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
+ * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+ * IN THE SOFTWARE.
+ */
+import { defineComponent } from 'vue';
+
+export default defineComponent({
+  name: '404',
+  setup() {
+    return () => <div>404</div>;
+  },
+});

package/knowledge/examples/affix/demo/affix-bottom.vue

@@ -0,0 +1,6 @@
+<template>
+  <bk-affix :offset-bottom="100">
+    <bk-button theme="primary"> 固定在底部100px </bk-button>
+  </bk-affix>
+</template>
+<script setup></script>

package/knowledge/examples/affix/demo/affix-callback.vue

@@ -0,0 +1,17 @@
+<template>
+  <bk-affix
+    :offset-top="300"
+    @change="change"
+  >
+    <bk-button theme="primary"> 固定在顶部300px，固定状态改变时的回调 </bk-button>
+  </bk-affix>
+</template>
+<script setup>
+  import BkMessage from '@bkui-vue/message';
+  const change = status => {
+    BkMessage({
+      message: `当前状态${status}`,
+      offsetY: 80,
+    });
+  };
+</script>

package/knowledge/examples/affix/demo/affix-container.vue

@@ -0,0 +1,26 @@
+<template>
+  <div
+    id="affix-demo"
+    class="scrollable-container"
+  >
+    <div class="background">
+      <bk-affix :target="'#affix-demo'">
+        <bk-button theme="primary"> 固定在target容器顶部位置 </bk-button>
+      </bk-affix>
+    </div>
+  </div>
+</template>
+<script setup></script>
+<style>
+  #affix-demo.scrollable-container {
+    height: 100px;
+    overflow-y: scroll;
+  }
+
+  #affix-demo .background {
+    height: 300px;
+    padding-top: 60px;
+    overflow: auto;
+    background-color: #8f8f89;
+  }
+</style>

package/knowledge/examples/affix/demo/affix-top.vue

@@ -0,0 +1,6 @@
+<template>
+  <bk-affix :offset-top="100">
+    <bk-button theme="primary"> 固定在顶部100px </bk-button>
+  </bk-affix>
+</template>
+<script setup></script>

package/knowledge/examples/affix/demo/affix-z-index.vue

@@ -0,0 +1,9 @@
+<template>
+  <bk-affix
+    :offset-top="200"
+    :z-index="10"
+  >
+    <bk-button theme="primary"> 固定在顶部200px，层级为10 </bk-button>
+  </bk-affix>
+</template>
+<script setup></script>

package/knowledge/examples/affix/demo/affix.vue

@@ -0,0 +1,6 @@
+<template>
+  <bk-affix>
+    <bk-button theme="primary"> 固定在顶部 </bk-button>
+  </bk-affix>
+</template>
+<script setup></script>