Skip to content

docs: mark plugin system as beta #1558

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.

Sign up for GitHub

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
tempurai merged 1 commit into from
Mar 24, 2026
Merged

docs: mark plugin system as beta #1558

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/.vitepress/config.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ export default withMermaid(defineConfig({
text: '定制化',
items: [
{ text: 'Model Context Protocol', link: '/zh/customization/mcp' },
{ text: '插件', link: '/zh/customization/plugins' },
{ text: '插件 (Beta)', link: '/zh/customization/plugins' },
Copy link
Copy Markdown
Contributor

@devin-ai-integration devin-ai-integration bot Mar 24, 2026

Choose a reason for hiding this comment

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

🔴 Chinese sidebar label changed, violating docs/AGENTS.md rule

The rule at docs/AGENTS.md:38 states: "Do not change H1 titles or nav/sidebar labels." This PR changes the Chinese sidebar label from '插件' to '插件 (Beta)'. Sidebar labels should remain stable; the Beta status is already communicated by the warning callout on the page itself.

Suggested change
{ text: '插件 (Beta)', link: '/zh/customization/plugins' },
{ text: '插件', link: '/zh/customization/plugins' },
Open in Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

{ text: 'Agent Skills', link: '/zh/customization/skills' },
{ text: 'Agent 与子 Agent', link: '/zh/customization/agents' },
{ text: 'Print 模式', link: '/zh/customization/print-mode' },
Expand Down Expand Up @@ -131,7 +131,7 @@ export default withMermaid(defineConfig({
text: 'Customization',
items: [
{ text: 'Model Context Protocol', link: '/en/customization/mcp' },
{ text: 'Plugins', link: '/en/customization/plugins' },
{ text: 'Plugins (Beta)', link: '/en/customization/plugins' },
Copy link
Copy Markdown
Contributor

@devin-ai-integration devin-ai-integration bot Mar 24, 2026

Choose a reason for hiding this comment

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

🔴 English sidebar label changed, violating docs/AGENTS.md rule

The rule at docs/AGENTS.md:38 states: "Do not change H1 titles or nav/sidebar labels." This PR changes the English sidebar label from 'Plugins' to 'Plugins (Beta)'. Sidebar labels should remain stable; the Beta status is already communicated by the warning callout on the page itself.

Suggested change
{ text: 'Plugins (Beta)', link: '/en/customization/plugins' },
{ text: 'Plugins', link: '/en/customization/plugins' },
Open in Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector bot Mar 24, 2026

Choose a reason for hiding this comment

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

P1 Badge Revert sidebar labels to the canonical wording

docs/AGENTS.md states "Do not change H1 titles or nav/sidebar labels," but this change renames the customization sidebar entry to Plugins (Beta) (and similarly in Chinese). That breaks the documented docs convention for stable navigation labels and can cause maintenance drift across mirrored locales; beta status should be conveyed in page content instead of the sidebar label.

Useful? React with 👍 / 👎.

{ text: 'Agent Skills', link: '/en/customization/skills' },
{ text: 'Agents and Subagents', link: '/en/customization/agents' },
{ text: 'Print Mode', link: '/en/customization/print-mode' },
Expand Down
6 changes: 5 additions & 1 deletion docs/en/customization/plugins.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,8 @@
# Plugins
# Plugins (Beta)
Copy link
Copy Markdown
Contributor

@devin-ai-integration devin-ai-integration bot Mar 24, 2026

Choose a reason for hiding this comment

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

🔴 H1 title changed in English plugins page, violating docs/AGENTS.md rule

The rule at docs/AGENTS.md:38 states: "Do not change H1 titles or nav/sidebar labels." This PR changes the H1 from # Plugins to # Plugins (Beta). The "(Beta)" status information should be conveyed via the warning callout block (which is already added) rather than by modifying the H1 title.

Suggested change
# Plugins (Beta)
# Plugins
Open in Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector bot Mar 24, 2026

Choose a reason for hiding this comment

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

P1 Badge Keep the plugin page H1 title unchanged

docs/AGENTS.md explicitly requires that H1 titles are not changed, but this commit rewrites the page heading from # Plugins to # Plugins (Beta). This violates the repository’s documentation contract and should be reverted, with beta messaging kept in a callout/body section instead.

Useful? React with 👍 / 👎.


::: warning Beta Feature
Copy link

Copilot AI Mar 24, 2026

Choose a reason for hiding this comment

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

The ::: warning callout title should follow the docs style guide: English warnings typically use no title or a short generic title like Note (see docs/AGENTS.md). Consider changing the title from “Beta Feature” and keep the beta messaging in the block content.

Suggested change
::: warning Beta Feature
::: warning

Copilot uses AI. Check for mistakes.
Copy link
Copy Markdown
Contributor

@devin-ai-integration devin-ai-integration bot Mar 24, 2026

Choose a reason for hiding this comment

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

🔴 English warning callout uses descriptive title "Beta Feature" instead of short category word

The rule at docs/AGENTS.md:103-105 specifies: "Use short category titles for callout blocks... English: use no title or short words like Note for warning." The callout ::: warning Beta Feature should use ::: warning (no title) or ::: warning Note, with "Beta Feature" as part of the block content instead.

Suggested change
::: warning Beta Feature
::: warning Note
Open in Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

The plugin system is currently in Beta. The implementation details and configuration definitions may change in future releases. Please use with caution in production environments and stay tuned for updates.
:::

The plugin system allows you to add custom tools to Kimi Code CLI, extending the AI's capabilities. Unlike MCP servers, plugins are lightweight local toolkits ideal for packaging project-specific scripts and utilities.

Expand Down
6 changes: 5 additions & 1 deletion docs/zh/customization/plugins.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,8 @@
# 插件
# 插件 (Beta)
Copy link
Copy Markdown
Contributor

@devin-ai-integration devin-ai-integration bot Mar 24, 2026

Choose a reason for hiding this comment

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

🔴 H1 title changed in Chinese plugins page, violating docs/AGENTS.md rule

The rule at docs/AGENTS.md:38 states: "Do not change H1 titles or nav/sidebar labels." This PR changes the H1 from # 插件 to # 插件 (Beta). The "(Beta)" status information should be conveyed via the warning callout block (which is already added) rather than by modifying the H1 title.

Suggested change
# 插件 (Beta)
# 插件
Open in Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.


::: warning Beta 功能
Copy link

Copilot AI Mar 24, 2026

Choose a reason for hiding this comment

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

The warning callout title doesn’t follow the docs style guide. For Chinese ::: warning blocks, the title should be 注意 (and put “Beta” wording in the content) per docs/AGENTS.md typography guidelines.

Suggested change
::: warning Beta 功能
::: warning 注意

Copilot uses AI. Check for mistakes.
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector bot Mar 24, 2026

Choose a reason for hiding this comment

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

P1 Badge Use the standard warning callout title in zh docs

The Chinese docs style guide in docs/AGENTS.md requires warning callouts to use the category title 注意, with details moved into the body. Using ::: warning Beta 功能 breaks that documented convention and makes warning blocks inconsistent with the rest of the site.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Contributor

@devin-ai-integration devin-ai-integration bot Mar 24, 2026

Choose a reason for hiding this comment

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

🔴 Chinese warning callout uses wrong title "Beta 功能" instead of "注意"

The rule at docs/AGENTS.md:103-104 specifies: "Chinese: use 提示 for tip, 注意 for warning, 说明 for info, 警告 for danger." The callout ::: warning Beta 功能 should use ::: warning 注意 with "Beta 功能" content moved into the block body.

Suggested change
::: warning Beta 功能
::: warning 注意
Open in Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

插件系统目前处于 Beta 阶段，具体的实现细节和配置定义可能会在未来版本中调整。请谨慎在生产环境中使用，并关注后续更新。
:::

插件系统让你可以为 Kimi Code CLI 添加自定义工具，扩展 AI 的能力。与 MCP 服务器不同，插件是轻量级的本地工具包，适合封装项目特定的脚本和实用程序。

Expand Down
Loading