@reglow/review-mcp 0.1.2 → 0.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -37,7 +37,7 @@ Skills 的核心价值：
|
|
|
37
37
|
| 项目内安装包 | 当前工作目录含 `uni_modules/reglow-review`（自动识别） | 组件源码（无 `docs/` 与演示页，文档回退官网） |
|
|
38
38
|
| 官方文档站点（兜底） | 本地缺文档 / 未找到本地来源时 | 抓取 <https://reglow.huoli.tech/components-library/review> 并转 Markdown |
|
|
39
39
|
|
|
40
|
-
- 版本号从 `CHANGELOG.md` 顶部解析（当前 `1.
|
|
40
|
+
- 版本号从 `CHANGELOG.md` 顶部解析（当前 `1.3.0（2026-10-28）`），每次响应都会标注「知识源 + 组件库版本」。
|
|
41
41
|
- `version` 参数与 `--version` 保留（与 reui-mcp 的签名一致），但传值只会得到「未发布到 npm，请用 `--root`」的提示。
|
|
42
42
|
|
|
43
43
|
## 快速开始
|
|
@@ -141,7 +141,7 @@ npx -y -p @reglow/review-mcp review-skills --list # 查看可用
|
|
|
141
141
|
|
|
142
142
|
- 组件名用 kebab-case 且**不带** `re-` 前缀（`button`、`search-history`），也接受 easycom 标签写法（`re-button`）。
|
|
143
143
|
- `version` 参数保留以对齐 reui-mcp，但本库未发布 npm，传值只会得到提示。
|
|
144
|
-
- 所有返回都以「知识源 + 组件库版本 + 版本来源」开头（如 `知识源：本地 ReView 仓库｜组件库版本：1.
|
|
144
|
+
- 所有返回都以「知识源 + 组件库版本 + 版本来源」开头（如 `知识源：本地 ReView 仓库｜组件库版本：1.3.0（2026-10-28）`），
|
|
145
145
|
当内容来自官方文档站点兜底时会额外标注 ⚠️，避免 AI 误判文档版本。
|
|
146
146
|
|
|
147
147
|
## 知识来源
|
package/package.json
CHANGED
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
| 基础模块分工 | `re-common` 类型与工具（`type.uts`、`re-common.uvue`）；`re-theme` 注入 `--re-*` 令牌（支持暗色/局部覆盖）；`re-config-provider` 在 `re-theme` 之上统一语言包、`zIndex` 基线与作用域 | `docs/guide/introduction.md` |
|
|
14
14
|
| 语言包位置 | `uni_modules/reglow-review/utssdk/re-config-provider/locale/{zh-CN,zh-TW,en-US}.uts` | 实测 + `docs/guide/locale.md` |
|
|
15
15
|
| 升级 | 用插件市场更新或**整体替换** `uni_modules/reglow-review/`，不要只替换单个 `re-xxx` 目录：组件内部通过相对路径引用 `utssdk`（如 `re-infinite-loading.uvue` 里 `import { translate } from '../../utssdk/re-config-provider/locale.uts'`），版本混用会出现新旧不匹配 | `re-infinite-loading.uvue`、`re-address.uvue` |
|
|
16
|
-
| 版本 | 当前 **1.
|
|
16
|
+
| 版本 | 当前 **1.3.0（2026-10-28）**；插件 `package.json` 的 `version` 同为 1.3.0 | `CHANGELOG.md`、`uni_modules/reglow-review/package.json` |
|
|
17
17
|
|
|
18
18
|
> 口径校正：`README.md` 的「项目结构」注释里写了 `uni_modules/` 下还有 `re-common/`、`re-theme/`、`re-config-provider/`、`re-button/` 等「历史拆分目录」，但**当前工作区的 `uni_modules/` 下只有 `reglow-review/`**（外加一个 `uni_modules/README.md`，实测）；`uni_modules/reglow-review/package.json` 的 `uni_modules.dependencies` 也已是空数组。因此组件维护只看 `uni_modules/reglow-review/components/`。
|
|
19
19
|
|
|
@@ -93,7 +93,7 @@ const customLocale = {
|
|
|
93
93
|
|
|
94
94
|
3. **`uni.scss` 只用于业务页面自己的 SCSS 变量**：`review/uni.scss` 定义的是 `$uni-color-primary` / `$uni-spacing-*` / `$uni-border-radius-*` 等 DCloud 通用变量，**不是**组件主题令牌。
|
|
95
95
|
|
|
96
|
-
**陷阱**：不是所有组件都读 `--re
|
|
96
|
+
**陷阱**：不是所有组件都读 `--re-*`。仍有 6 个组件沿用 TDesign 的 `--td-*` 变量名（`re-form`、`re-form-item`、`re-input`、`re-radio`、`re-switch`、`re-avatar`）。1.3.0 起 `darkTheme` 已内置这些 `--td-*` 的暗色值，`theme="dark"` 可直接生效；但做品牌色定制时需同时覆盖 `--re-*` 与对应 `--td-*`，或改用组件文档给出的 `customStyle` / 颜色类 prop。
|
|
97
97
|
|
|
98
98
|
## 7. 性能
|
|
99
99
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> 分类与顺序取自 `review/docs/.vitepress/sidebar.ts`（组件分类的权威来源），组件条目与 `review/docs/components/*.md` **一一对应，共 121 个文档页**。
|
|
4
4
|
> 用途列优先引用该组件文档首段（`docs/components/<name>.md` 第 3 行）；文档首段为空时退化为 `review/README.md`「组件清单」中的说明（表中标注「README」）。
|
|
5
|
-
> 版本基线：`reglow-review` **1.
|
|
5
|
+
> 版本基线：`reglow-review` **1.3.0（2026-10-28）**（`CHANGELOG.md`）。
|
|
6
6
|
|
|
7
7
|
## 口径说明
|
|
8
8
|
|
|
@@ -76,37 +76,37 @@
|
|
|
76
76
|
|
|
77
77
|
## 数据展示 Data Display（29）
|
|
78
78
|
|
|
79
|
-
| 组件 | 中文名 | 用途
|
|
80
|
-
| --------------------------------------- | ---------- |
|
|
81
|
-
| `<re-avatar>` + `<re-avatar-group>` | 头像 | 参考 TDesign Avatar 的图片、图标、文字、角标和头像组能力，适配 uni-app x 组件写法
|
|
82
|
-
| `<re-badge>` | 徽章 | 参考 TDesign badge 的样式与形状能力，支持数字、文字、红点、角标展示
|
|
83
|
-
| `<re-cell>` + `<re-cell-group>` | 单元格 | 单元格组件，用于列表项展示，支持标题、描述、图标、箭头、链接跳转等
|
|
84
|
-
| `<re-collapse>` + `<re-collapse-panel>` | 折叠面板 | 折叠面板组件，可展开/收起内容区域
|
|
85
|
-
| `<re-count-down>` | 倒计时 | 倒计时组件，支持自定义格式化
|
|
86
|
-
| `<re-empty>` | 空状态 | 空状态组件，用于展示无数据时的占位，支持空数据、错误、网络异常等场景
|
|
87
|
-
| `<re-footer>` | 页脚 | 页脚组件，用于页面底部展示版权信息、链接等
|
|
88
|
-
| `<re-grid>` + `<re-grid-item>` | 宫格 | 宫格组件，用于展示多个等宽的宫格内容
|
|
89
|
-
| `<re-image>` | 图片 | 图片组件，支持懒加载、自定义形状、加载状态等
|
|
90
|
-
| `<re-image-viewer>` | 图片预览 | 图片预览组件，支持全屏查看、滑动切换、删除等
|
|
91
|
-
| `<re-progress>` | 进度条 | 进度条组件，用于展示任务进度
|
|
92
|
-
| `<re-qrcode>` | 二维码 | 二维码生成组件，支持自定义颜色、尺寸、中心图标
|
|
93
|
-
| `<re-result>` | 结果 | 结果（README：re-result 结果）
|
|
94
|
-
| `<re-segmented>` | 分段控制器 | 分段控制器（README：re-segmented 分段控制器）
|
|
95
|
-
| `<re-skeleton>` | 骨架屏 | 骨架屏（README：re-skeleton 骨架屏）
|
|
96
|
-
| `<re-sticky>` | 吸顶 | 吸顶（README：re-sticky 吸顶）
|
|
97
|
-
| `<re-swiper>` | 轮播 | 轮播（README：re-swiper 轮播）
|
|
98
|
-
| `<re-table>` | 表格 | 表格（README：re-table 表格）
|
|
99
|
-
| `<re-tag>` + `<re-check-tag>` | 标签 | 标签（README：re-tag 标签（含 re-check-tag））
|
|
100
|
-
| `<re-watermark>` | 水印 | 水印（README：re-watermark 水印）
|
|
101
|
-
| `<re-card>` |
|
|
102
|
-
| `<re-circle-progress>` | 环形进度条 | 以圆环形式展示进度，支持自定义颜色、大小、方向
|
|
103
|
-
| `<re-comment>` | 商品评论 | 展示评论信息，支持评论详情、图片/视频、追评与操作栏
|
|
104
|
-
| `<re-count-up>` | 数字滚动 | 数字从起始值滚动到目标值的动画效果，支持缓动
|
|
105
|
-
| `<re-price>` | 价格展示 | 商品价格格式化展示，支持货币符号、小数位、千分位、删除线
|
|
106
|
-
| `<re-trend-arrow>` | 趋势箭头 | 展示涨/跌趋势箭头及百分比，支持自定义颜色和文案
|
|
107
|
-
| `<re-barrage>` | 弹幕 | 弹幕（README：re-barrage 弹幕）
|
|
108
|
-
| `<re-video>` | 视频播放器 | 视频播放器（README：re-video 视频播放器）
|
|
109
|
-
| `<re-avatar-cropper>` | 头像裁剪 | 图片裁剪交互，用于头像裁剪，支持旋转、缩放
|
|
79
|
+
| 组件 | 中文名 | 用途 | 文档路径 |
|
|
80
|
+
| --------------------------------------- | ---------- | -------------------------------------------------------------------------------------- | ------------------------------------ |
|
|
81
|
+
| `<re-avatar>` + `<re-avatar-group>` | 头像 | 参考 TDesign Avatar 的图片、图标、文字、角标和头像组能力，适配 uni-app x 组件写法 | `docs/components/avatar.md` |
|
|
82
|
+
| `<re-badge>` | 徽章 | 参考 TDesign badge 的样式与形状能力，支持数字、文字、红点、角标展示 | `docs/components/badge.md` |
|
|
83
|
+
| `<re-cell>` + `<re-cell-group>` | 单元格 | 单元格组件，用于列表项展示，支持标题、描述、图标、箭头、链接跳转等 | `docs/components/cell.md` |
|
|
84
|
+
| `<re-collapse>` + `<re-collapse-panel>` | 折叠面板 | 折叠面板组件，可展开/收起内容区域 | `docs/components/collapse.md` |
|
|
85
|
+
| `<re-count-down>` | 倒计时 | 倒计时组件，支持自定义格式化 | `docs/components/count-down.md` |
|
|
86
|
+
| `<re-empty>` | 空状态 | 空状态组件，用于展示无数据时的占位，支持空数据、错误、网络异常等场景 | `docs/components/empty.md` |
|
|
87
|
+
| `<re-footer>` | 页脚 | 页脚组件，用于页面底部展示版权信息、链接等 | `docs/components/footer.md` |
|
|
88
|
+
| `<re-grid>` + `<re-grid-item>` | 宫格 | 宫格组件，用于展示多个等宽的宫格内容 | `docs/components/grid.md` |
|
|
89
|
+
| `<re-image>` | 图片 | 图片组件，支持懒加载、自定义形状、加载状态等 | `docs/components/image.md` |
|
|
90
|
+
| `<re-image-viewer>` | 图片预览 | 图片预览组件，支持全屏查看、滑动切换、删除等 | `docs/components/image-viewer.md` |
|
|
91
|
+
| `<re-progress>` | 进度条 | 进度条组件，用于展示任务进度 | `docs/components/progress.md` |
|
|
92
|
+
| `<re-qrcode>` | 二维码 | 二维码生成组件，支持自定义颜色、尺寸、中心图标 | `docs/components/qrcode.md` |
|
|
93
|
+
| `<re-result>` | 结果 | 结果（README：re-result 结果） | `docs/components/result.md` |
|
|
94
|
+
| `<re-segmented>` | 分段控制器 | 分段控制器（README：re-segmented 分段控制器） | `docs/components/segmented.md` |
|
|
95
|
+
| `<re-skeleton>` | 骨架屏 | 骨架屏（README：re-skeleton 骨架屏） | `docs/components/skeleton.md` |
|
|
96
|
+
| `<re-sticky>` | 吸顶 | 吸顶（README：re-sticky 吸顶） | `docs/components/sticky.md` |
|
|
97
|
+
| `<re-swiper>` | 轮播 | 轮播（README：re-swiper 轮播） | `docs/components/swiper.md` |
|
|
98
|
+
| `<re-table>` | 表格 | 表格（README：re-table 表格） | `docs/components/table.md` |
|
|
99
|
+
| `<re-tag>` + `<re-check-tag>` | 标签 | 标签（README：re-tag 标签（含 re-check-tag）） | `docs/components/tag.md` |
|
|
100
|
+
| `<re-watermark>` | 水印 | 水印（README：re-watermark 水印） | `docs/components/watermark.md` |
|
|
101
|
+
| `<re-card>` | 卡片 | 卡片组件，支持封面图、标题/副标题、左侧图标/图片、右侧额外文字、更多图标与底部操作按钮 | `docs/components/card.md` |
|
|
102
|
+
| `<re-circle-progress>` | 环形进度条 | 以圆环形式展示进度，支持自定义颜色、大小、方向 | `docs/components/circle-progress.md` |
|
|
103
|
+
| `<re-comment>` | 商品评论 | 展示评论信息，支持评论详情、图片/视频、追评与操作栏 | `docs/components/comment.md` |
|
|
104
|
+
| `<re-count-up>` | 数字滚动 | 数字从起始值滚动到目标值的动画效果，支持缓动 | `docs/components/count-up.md` |
|
|
105
|
+
| `<re-price>` | 价格展示 | 商品价格格式化展示，支持货币符号、小数位、千分位、删除线 | `docs/components/price.md` |
|
|
106
|
+
| `<re-trend-arrow>` | 趋势箭头 | 展示涨/跌趋势箭头及百分比，支持自定义颜色和文案 | `docs/components/trend-arrow.md` |
|
|
107
|
+
| `<re-barrage>` | 弹幕 | 弹幕（README：re-barrage 弹幕） | `docs/components/barrage.md` |
|
|
108
|
+
| `<re-video>` | 视频播放器 | 视频播放器（README：re-video 视频播放器） | `docs/components/video.md` |
|
|
109
|
+
| `<re-avatar-cropper>` | 头像裁剪 | 图片裁剪交互，用于头像裁剪，支持旋转、缩放 | `docs/components/avatar-cropper.md` |
|
|
110
110
|
|
|
111
111
|
## 反馈 Feedback（15）
|
|
112
112
|
|
|
@@ -61,13 +61,14 @@ description: ReView（reglow-review）uni-app x 移动端组件库的检索、
|
|
|
61
61
|
### 3.4 主题与国际化
|
|
62
62
|
|
|
63
63
|
- **主题**：基于 CSS 变量的主题系统，令牌前缀为 `--re-*`（`docs/guide/theme.md` 列出 `--re-color-primary`、`--re-text-color-primary`、`--re-radius-*` 等）；通过 `re-config-provider` 的 `theme="dark"` 切暗色、`themeVars` 覆盖变量；只想作用于局部时用 `re-theme`（`theme` + `themeVars`）。
|
|
64
|
-
-
|
|
64
|
+
- **深色模式（1.3.0）**：147 个组件已完成深色扫描，89 个组件颜色变量化（使用主题变量的组件 107 个），`theme="dark"` 后常规组件自动变暗；8 个语义色组件（toast / fab / overlay / swiper / image-viewer / scratch-card / turntable / watermark）有意保持固定配色。适配清单见 `docs/guide/dark-mode-audit.md`。
|
|
65
|
+
- **注意**：仍有 6 个组件沿用 TDesign 的 `--td-*` 变量名（`re-form`、`re-form-item`、`re-input`、`re-radio`、`re-switch`、`re-avatar`）。`darkTheme` 已内置对应暗色 `--td-*` 值，切 `theme="dark"` 可正常变暗；但业务自定义品牌色时仍需同时覆盖 `--re-*` 与该组件的 `--td-*`，或用组件文档给出的 `customStyle` / 颜色类 prop。
|
|
65
66
|
- **国际化**：内置 `zh-CN` / `zh-TW` / `en-US`，语言包为 **uts 文件**：`uni_modules/reglow-review/utssdk/re-config-provider/locale/{zh-CN,zh-TW,en-US}.uts`；通过 `re-config-provider` 的 `locale` 切换、`localeConfig` 覆盖文案（`docs/guide/locale.md`）。**组件源码中未使用 `vue-i18n`**（实测 `uni_modules` 下无 `vue-i18n` 引用），故不要把 `vue-i18n` 的 `useI18n()` 写法套到 ReView 上。
|
|
66
67
|
|
|
67
68
|
### 3.5 版本
|
|
68
69
|
|
|
69
|
-
- 当前版本 **1.
|
|
70
|
-
- 最近三版的关键行为变化（排障必读）：1.2.0 全面重构 `re-login`（5 套预设模板 + `pageMode
|
|
70
|
+
- 当前版本 **1.3.0（2026-10-28）**（`CHANGELOG.md`、`docs/guide/changelog.md`、`uni_modules/reglow-review/package.json` 的 `version`）。
|
|
71
|
+
- 最近三版的关键行为变化（排障必读）：1.3.0 完成全量组件深色主题适配（`theme="dark"` 自动变暗）、`re-card` 由商品卡片重构为通用卡片（旧商品字段/插槽已移除）、`re-tabs` 重写可滚动测量与定位、`re-cart-bar` 修复非吸底安全区白边与胶囊按钮高度、国际化支持响应式 `locale`、`re-login` 语言包与协议交互完善；1.2.0 全面重构 `re-login`（5 套预设模板 + `pageMode`）、增强 `re-tab-bar`/`re-navbar`、`re-drag` 支持 H5 鼠标拖拽。
|
|
71
72
|
|
|
72
73
|
## 4. 核心工作流（配合 review-mcp）
|
|
73
74
|
|
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
| `search_review_docs` | 跨文档与源码关键词检索 | 关键词（可多个）、`category`、`limit`、`version` | `组件/文件:行号` + 上下文片段 |
|
|
16
16
|
| `get_review_guide` | 库级指南 | `topic`：安装 / easycom / 主题 / i18n / 平台 / 约定 等 | 库级说明 |
|
|
17
17
|
|
|
18
|
-
**共同参数 `version`**：不传 = 项目本地已安装版本（当前基线 **1.
|
|
18
|
+
**共同参数 `version`**：不传 = 项目本地已安装版本（当前基线 **1.3.0**，见 `CHANGELOG.md`）。
|
|
19
19
|
|
|
20
20
|
## 2. 基础查询流程（四步走）
|
|
21
21
|
|
|
@@ -408,7 +408,7 @@ const cardStyle = styles({
|
|
|
408
408
|
|
|
409
409
|
| 步骤 | 调用 | 参数 | 判断 |
|
|
410
410
|
| ---- | ---------------------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ------------------------------- | --------------------------------------------- |
|
|
411
|
-
| 1 | `get_review_guide` | `{ topic: "changelog" }` 或直接读 `CHANGELOG.md` | 先确认当前版本 1.
|
|
411
|
+
| 1 | `get_review_guide` | `{ topic: "changelog" }` 或直接读 `CHANGELOG.md` | 先确认当前版本 1.3.0，再看最近三版是否已修过同类问题 |
|
|
412
412
|
| 2 | `search_review_docs` | `{ keywords: ["number | string | symbol", "v-for"], limit: 20 }` | 定位「模板 v-for 索引类型」告警的历史修复范围 |
|
|
413
413
|
| 3 | `get_file_code` | `{ component: "cascader", file: "re-cascader.uvue", startLine: 27, endLine: 80 }` | 确认列渲染是模板内直接 `v-for`（1.0.5 重构点），不再是内部 `re-cascader-item` |
|
|
414
414
|
| 4 | `list_component_files` | `{ component: "indexes" }` | 看到 `page-scroll.uts` + `re-indexes.uvue`，对应 1.0.4 的吸顶重构 |
|