Skip to content

chore: Update changelog and add TinyVue intelligent component access documentation #3498

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Jun 13, 2025

Conversation

zzcr
Copy link
Member

@zzcr zzcr commented Jun 12, 2025

chore: 更新changelog,并添加TinyVue智能化组件接入文档

PR

PR Checklist

Please check if your PR fulfills the following requirements:

  • The commit message follows our Commit Message Guidelines
  • Tests for the changes have been added (for bug fixes / features)
  • Docs have been added / updated (for bug fixes / features)

PR Type

What kind of change does this PR introduce?

  • Bugfix
  • Feature
  • Code style update (formatting, local variables)
  • Refactoring (no functional changes, no api changes)
  • Build related changes
  • CI related changes
  • Documentation content changes
  • Other... Please describe:

What is the current behavior?

Issue Number: N/A

What is the new behavior?

Does this PR introduce a breaking change?

  • Yes
  • No

Other information

Summary by CodeRabbit

  • New Features

    • Added a new "智能化" (Intelligent) menu item to the application menu.
    • Introduced comprehensive documentation (in both Chinese and English) for integrating AI-powered features, including AI conversation and voice interaction.
  • Documentation

    • Updated the changelog with new features, enhancements, and bug fixes for multiple components.
    • Added detailed integration guides for intelligent components, covering setup, configuration, and troubleshooting.

Copy link

coderabbitai bot commented Jun 12, 2025

Walkthrough

A new menu item for "智能化" (Intelligentization) has been added to the menu configuration. Two comprehensive documentation files—one in Chinese and one in English—have been introduced to guide users on integrating TinyVue's intelligent components. The changelog has been updated with a new entry detailing recent features, bug fixes, and contributor acknowledgments.

Changes

File(s) Change Summary
examples/sites/demos/pc/menus.js Added a new menu entry for "智能化"/"mcp" to the menu configuration array.
examples/sites/demos/pc/webdoc/changelog.md Added a new changelog entry for v3.24.0/v2.24.0 with feature and bug fix details, and a new contributor mention.
examples/sites/demos/pc/webdoc/mcp.md, examples/sites/demos/pc/webdoc/mcp-en.md Added new integration guide documentation for TinyVue intelligent components in both Chinese and English.

Poem

In the garden of menus, a new bud appears,
"智能化" whispers, the future draws near.
Guides in two tongues, for all to explore,
Changelog refreshed, with fixes galore.
🐇 Hopping ahead, with docs in our pack—
Intelligence blooms, there’s no turning back!


📜 Recent review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 6281c4f and d161f0e.

📒 Files selected for processing (1)
  • examples/sites/demos/pc/webdoc/mcp-en.md (1 hunks)
✅ Files skipped from review due to trivial changes (1)
  • examples/sites/demos/pc/webdoc/mcp-en.md

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Explain this complex logic.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai explain this code block.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and explain its main purpose.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@github-actions github-actions bot added the chore label Jun 12, 2025
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (7)
examples/sites/demos/pc/webdoc/mcp.md (5)

1-4: Add language switch link
Consider adding a link at the top to switch between Chinese and English versions (e.g., [English](./mcp-en.md)) for better navigation.


5-11: Specify installation versions
You might include version constraints (e.g., @opentiny/tiny-vue-mcp@^x.y.z) or mention --save/--save-dev flags for clarity.


27-54: NextClient proxy example is clear
The Vue SFC snippet correctly sets up useNextClient. Consider adding a brief note about the SSE proxy server requirements here if not covered elsewhere.


84-89: List formatting is fine
The 注意事项 list is concise. Optionally, unify punctuation (e.g., remove trailing periods).


90-102: FAQ section structured well
Nested lists are indented correctly. You may want to hyperlink common error codes or logs in a future iteration.

examples/sites/demos/pc/webdoc/mcp-en.md (1)

1-4: Add link to Chinese version
Include a link to the Chinese guide (e.g., [中文版](./mcp.md)) at the top of the document for bilingual navigation.

examples/sites/demos/pc/webdoc/changelog.md (1)

23-23: Consistent acronym casing
Change “mcp” to uppercase “MCP” for consistency with other entries:

- - feat(grid): optimize mcp configuration usage and sample code by @zzcr ...
+ - feat(grid): optimize MCP configuration usage and sample code by @zzcr ...
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between fa86275 and e5e0d76.

📒 Files selected for processing (4)
  • examples/sites/demos/pc/menus.js (1 hunks)
  • examples/sites/demos/pc/webdoc/changelog.md (1 hunks)
  • examples/sites/demos/pc/webdoc/mcp-en.md (1 hunks)
  • examples/sites/demos/pc/webdoc/mcp.md (1 hunks)
🧰 Additional context used
🪛 LanguageTool
examples/sites/demos/pc/webdoc/changelog.md

[style] ~30-~30: Unless you want to emphasize “not”, use “cannot” which is more common.
Context: .../tiny-vue/pull/3445> - fix(select): fix can not set grid rowId in select by @gimmyhehe ...

(CAN_NOT_PREMIUM)

🔇 Additional comments (4)
examples/sites/demos/pc/menus.js (1)

45-49: Verify MCP menu entry configuration
The new “智能化”/“mcp” item is correctly inserted between theme-dark and formValid. Ensure that corresponding docs files (mcp.md and mcp-en.md) exist at examples/sites/demos/pc/webdoc/ and that your routing logic handles the key: 'mcp'.

examples/sites/demos/pc/webdoc/mcp.md (2)

13-25: Initialization snippet looks correct
The JS code block properly demonstrates registerMcpConfig. Confirm that this matches the actual path of your entry file (main.js/main.ts).


56-82: MCP component configuration is accurate
The tiny-grid example and useNextServer call align with the integration guide. No issues found.

examples/sites/demos/pc/webdoc/changelog.md (1)

7-24: Changelog entry for v3.24.0/v2.24.0 looks good
Version header, date, and feature list align with existing format. The new features (including MCP support) are properly documented.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between fa86275 and 6281c4f.

📒 Files selected for processing (4)
  • examples/sites/demos/pc/menus.js (1 hunks)
  • examples/sites/demos/pc/webdoc/changelog.md (1 hunks)
  • examples/sites/demos/pc/webdoc/mcp-en.md (1 hunks)
  • examples/sites/demos/pc/webdoc/mcp.md (1 hunks)
🧰 Additional context used
🪛 LanguageTool
examples/sites/demos/pc/webdoc/changelog.md

[style] ~30-~30: Unless you want to emphasize “not”, use “cannot” which is more common.
Context: .../tiny-vue/pull/3445> - fix(select): fix can not set grid rowId in select by @gimmyhehe ...

(CAN_NOT_PREMIUM)

🔇 Additional comments (3)
examples/sites/demos/pc/menus.js (1)

45-49: New MCP menu item integration is correct.

The insertion of the "智能化" / "mcp" entry aligns with the new documentation and follows the existing menu structure without disrupting order or filtering logic.

examples/sites/demos/pc/webdoc/mcp.md (1)

1-102: Chinese MCP integration guide documentation looks comprehensive.

The Markdown layout, localized headings, and code examples are clear and correctly formatted. No issues detected.

examples/sites/demos/pc/webdoc/changelog.md (1)

7-54: Changelog entry for v3.24.0/v2.24.0 is accurate and well-structured.

The new version header, feature list, bug fixes, and contributor acknowledgments are clearly documented and formatted.

🧰 Tools
🪛 LanguageTool

[style] ~30-~30: Unless you want to emphasize “not”, use “cannot” which is more common.
Context: .../tiny-vue/pull/3445> - fix(select): fix can not set grid rowId in select by @gimmyhehe ...

(CAN_NOT_PREMIUM)

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (3)
examples/sites/demos/pc/webdoc/mcp-en.md (2)

1-3: Refine the document title for clarity.

Consider changing to "TinyVue Intelligent Components Integration Guide" to more precisely reflect the integration focus.


56-58: Complete the introductory sentence under MCP Component Configuration.

The fragment "When using" is incomplete. For example:
"When using MCP-enabled components such as tiny-grid, configure them as follows:"

examples/sites/demos/pc/webdoc/changelog.md (1)

29-30: Use "cannot" instead of "can not" for consistency.

Change:

- fix(select): fix can not set grid rowId in select by @gimmyhehe
+ fix(select): fix cannot set grid rowId in select by @gimmyhehe
🧰 Tools
🪛 LanguageTool

[style] ~30-~30: Unless you want to emphasize “not”, use “cannot” which is more common.
Context: .../tiny-vue/pull/3445> - fix(select): fix can not set grid rowId in select by @gimmyhehe ...

(CAN_NOT_PREMIUM)

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between fa86275 and 6281c4f.

📒 Files selected for processing (4)
  • examples/sites/demos/pc/menus.js (1 hunks)
  • examples/sites/demos/pc/webdoc/changelog.md (1 hunks)
  • examples/sites/demos/pc/webdoc/mcp-en.md (1 hunks)
  • examples/sites/demos/pc/webdoc/mcp.md (1 hunks)
🧰 Additional context used
🪛 LanguageTool
examples/sites/demos/pc/webdoc/changelog.md

[style] ~30-~30: Unless you want to emphasize “not”, use “cannot” which is more common.
Context: .../tiny-vue/pull/3445> - fix(select): fix can not set grid rowId in select by @gimmyhehe ...

(CAN_NOT_PREMIUM)

🔇 Additional comments (3)
examples/sites/demos/pc/menus.js (1)

45-49: Add new '智能化' ('mcp') menu item for documentation navigation.

Placement and keys align with the new MCP integration guides and match the filenames (mcp.md/mcp-en.md).

examples/sites/demos/pc/webdoc/mcp-en.md (1)

9-11: Verify code examples for accuracy.

All installation and setup snippets appear correct and self-contained.

Also applies to: 19-25, 32-46, 61-82

examples/sites/demos/pc/webdoc/mcp.md (1)

1-102: Chinese MCP integration guide is well-structured.

The documentation is clear, with accurate code examples and appropriate sectioning.


TinyVue's intelligent components provide a complete intelligent solution, allowing your application to have AI conversation, voice interaction, and other capabilities. This guide will walk you through how to integrate TinyVue's intelligent components into your project.

## 安装依赖
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🛠️ Refactor suggestion

Translate Chinese headings to English.

The English version mixes Chinese section titles ("安装依赖", "接入步骤", "常见问题"). Please update to "## Install Dependencies", "## Integration Steps", and "## Frequently Asked Questions".

Also applies to: 13-13, 90-90

🤖 Prompt for AI Agents
In examples/sites/demos/pc/webdoc/mcp-en.md at lines 5, 13, and 90, the section
headings are still in Chinese ("安装依赖", "接入步骤", "常见问题"). Replace these Chinese
headings with their English equivalents: "## Install Dependencies" at line 5,
"## Integration Steps" at line 13, and "## Frequently Asked Questions" at line
90 to maintain consistency in the English document.

@kagol kagol merged commit 299734c into release-3.24.0 Jun 13, 2025
5 checks passed
@kagol kagol deleted the zzc/update-3.24.0-changelog branch June 13, 2025 01:28
zzcr added a commit that referenced this pull request Jun 14, 2025
* feat: New MCP comprehensive example added to the official website (#3497)

* feat: 官网新增mcp综合示例

* fix: 修复 tiny-robot-chat 组件中的提示项和建议项的传递逻辑,优化 Demo 组件的 QR 码展示样式

* fix: 修复引入路径问题

* chore: Update changelog and add TinyVue intelligent component access documentation (#3498)

* chore: 更新changelog,并添加TinyVue智能化组件接入文档

* chore: 添加菜单优化文档

* chore: 更新mcp.md文档中的sessionId说明,简化调试提示

* chore: 更新mcp-en.md文档中的标题和内容,统一语言为英文

* feat: add remote control page, update next dependency (#3501)

* feat: 添加遥控器页面,更新next依赖

* chore: 修改代理为https url

* feat: 更新会话ID的处理逻辑

* fix: 更新依赖版本约束以支持更高版本

* fix: 更新版本号至3.24.4
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants