[ISSUE #14848] Add download Prompt version as Markdown feature

[grllll]

What is the purpose of the change

Fix #14848

Currently the Nacos console only supports viewing the content of a Prompt version inline, but there is no way for users to export or persist a Prompt version locally. This PR adds a feature that allows users to download any version of a Prompt as a Markdown file from the console, and tracks the download counts of each prompt / prompt version so that users can observe the popularity of prompts. The implementation is fully aligned with the existing Skill download feature for consistency.

Brief changelog

Backend

• Add PromptMarkdownBuilder utility to render a PromptVersionInfo (including metadata, variables, template, and examples) into a well-formatted Markdown document.
• Add a new Console API GET /v3/console/ai/prompt/version/markdown in ConsolePromptController, returning the markdown content with Content-Disposition: attachment so that browsers trigger a file download.
• Add the full handler chain for the new API: PromptHandler / PromptInnerHandler / PromptRemoteHandler / PromptNoopHandler / PromptProxy.
• Add downloadPromptVersion in PromptOperationService / PromptOperationServiceImpl, which fetches the version detail and publishes a PromptDownloadEvent.
• Add PromptDownloadEvent (new event) and PromptDownloadCountManager (new SmartSubscriber) to accumulate download counts in memory and flush them to DB every 10 seconds using atomic SQL (download_count = download_count + N), keeping the counting logic isolated from the existing SkillDownloadCountManager.
• Add downloadCount field to PromptMetaSummary and PromptVersionSummary, and populate it in listPrompts / listPromptVersions / getPromptDetail.

Frontend (console-ui-next)

• Add downloadPromptVersionMarkdown API call in src/api/prompt.ts.
• In the Prompt detail page, add a download button using the existing CliCommandCard component on the right sidebar (aligned with Skill detail page).
• Display the total download count and per-version download count as InfoCell entries inside the Basic Info card.
• Update TypeScript types in types/prompt.ts (downloadCount: number | null).
• Add i18n keys prompt.downloadCount, prompt.downloads, prompt.versionDownloads in both en-US.json and zh-CN.json.

Verifying this change

Unit tests

• Add PromptMarkdownBuilderTest covering header/metadata rendering, variables section, template section, examples section, and null/empty edge cases.

Manual tests (with MySQL datasource, standalone mode)

1. Open the Nacos console and enter the Prompt detail page.
2. Click the download icon inside the CLI Command card on the right sidebar — a .md file named {promptKey}-{version}.md is downloaded.
3. Open the downloaded file and verify the Markdown content contains the prompt metadata, variables, template, and examples.
4. Refresh the page (wait > 10s to let the counter flush to DB). Verify that the Downloads and Version Downloads values in the Basic Info card increase correctly.
5. Download different versions of the same prompt, and confirm that only the corresponding version's counter increments while the total count increments as expected.

Checks

• mvn -B clean package apache-rat:check spotbugs:check -DskipTests — passed
• mvn clean install -DskipITs — passed

[CLAassistant]

All committers have signed the CLA.

[github-actions]

⚠️ Commit Author Verification Failed

The following commits have author emails not linked to any GitHub account.
This will prevent CLA signing and block your PR from being merged.

Commit	Author	Email
541f7e8	Linyu	gengruilin.grl@alibaba-inc.com

How to fix:

1. Add your commit email to your GitHub account: https://github.com/settings/emails
2. Or update your local git config to use an email already linked to GitHub:

   git config user.name "Your GitHub Username"
   git config user.email "your-github-email@example.com"
   

3. Amend your commits and force-push:

   git rebase -i HEAD~1 # mark commits as "edit" and amend author
   git push --force-with-lease
   

This check will re-run automatically after you push.

[github-actions]

Thanks for your this PR. 🙏
Please check again for your PR changes whether contains any usage/api/configuration change such as Add new API , Add new configuration, Change default value of configuration.
If so, please add or update documents(markdown type) in docs/next/ for repository nacos-group/nacos-group.github.io

---

感谢您提交的PR。 🙏
请再次查看您的PR内容，确认是否包含任何使用方式/API/配置参数的变更，如：新增API、新增配置参数、修改默认配置等操作。
如果是，请确保在提交之前，在仓库nacos-group/nacos-group.github.io中的docs/next/目录下添加或更新文档（markdown格式）。

[KomachiSion]

@Sunrisea Please help to review

[Sunrisea]

LGTM

[codecov-commenter]

Codecov Report

❌ Patch coverage is 82.38994% with 28 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
.../ai/service/prompt/PromptDownloadCountManager.java	85.18%	4 Missing and 4 partials ⚠️
.../alibaba/nacos/ai/utils/PromptMarkdownBuilder.java	88.88%	0 Missing and 8 partials ⚠️
...aba/nacos/ai/controller/PromptAdminController.java	0.00%	4 Missing ⚠️
...a/nacos/api/ai/model/prompt/PromptMetaSummary.java	33.33%	2 Missing ⚠️
...acos/api/ai/model/prompt/PromptVersionSummary.java	33.33%	2 Missing ⚠️
...sole/handler/impl/inner/ai/PromptInnerHandler.java	0.00%	1 Missing ⚠️
...onsole/handler/impl/noop/ai/PromptNoopHandler.java	0.00%	1 Missing ⚠️
...le/handler/impl/remote/ai/PromptRemoteHandler.java	0.00%	1 Missing ⚠️
...om/alibaba/nacos/console/proxy/ai/PromptProxy.java	0.00%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!

[shiyiyue1102]

Thanks for the contribution. The main feature direction looks aligned with #14848, and the Markdown builder already has focused unit coverage.

Before moving this forward, could you add coverage for the new download-count path as well? In particular, PromptDownloadCountManager is the core state-changing part of this PR, but the current patch coverage shows it is not covered. It would be helpful to lock down event accumulation and the DB increment/flush behavior.

One more thing to confirm: PromptRemoteHandler.downloadPromptVersion() currently delegates to getVersionDetail(), while the download event is published by PromptOperationServiceImpl.downloadPromptVersion(). Please confirm whether download counts are expected to increase in remote console mode, or add/update the implementation and tests if needed.

Also, the linked issue discussion mentioned promptKey_version.md, while this PR currently uses promptKey-version.md. Please confirm the intended filename format.

---

感谢贡献。这个功能方向和 #14848 是对齐的，Markdown builder 也已经有比较聚焦的单测覆盖。

继续推进前，建议再补一下新增下载量统计链路的测试。尤其是 PromptDownloadCountManager 是这个 PR 里真正会改变状态的核心逻辑，但当前 patch coverage 显示这部分还没有覆盖。建议把事件累计、DB 增量 flush 行为锁定下来。

另外有一点需要确认：PromptRemoteHandler.downloadPromptVersion() 当前只是委托到 getVersionDetail()，而下载事件是在 PromptOperationServiceImpl.downloadPromptVersion() 中发布的。请确认 remote console 模式下下载量是否预期会增长；如果需要增长，请补充对应实现和测试。

还有一个小点：关联 issue 里讨论的文件名是 promptKey_version.md，当前 PR 使用的是 promptKey-version.md。请确认最终希望采用哪种文件名格式。

[KomachiSion]

Thanks for the contribution. The main feature direction looks aligned with #14848, and the Markdown builder already has focused unit coverage.

Before moving this forward, could you add coverage for the new download-count path as well? In particular, PromptDownloadCountManager is the core state-changing part of this PR, but the current patch coverage shows it is not covered. It would be helpful to lock down event accumulation and the DB increment/flush behavior.

One more thing to confirm: PromptRemoteHandler.downloadPromptVersion() currently delegates to getVersionDetail(), while the download event is published by PromptOperationServiceImpl.downloadPromptVersion(). Please confirm whether download counts are expected to increase in remote console mode, or add/update the implementation and tests if needed.

Also, the linked issue discussion mentioned promptKey_version.md, while this PR currently uses promptKey-version.md. Please confirm the intended filename format.

感谢贡献。这个功能方向和 #14848 是对齐的，Markdown builder 也已经有比较聚焦的单测覆盖。

继续推进前，建议再补一下新增下载量统计链路的测试。尤其是 PromptDownloadCountManager 是这个 PR 里真正会改变状态的核心逻辑，但当前 patch coverage 显示这部分还没有覆盖。建议把事件累计、DB 增量 flush 行为锁定下来。

另外有一点需要确认：PromptRemoteHandler.downloadPromptVersion() 当前只是委托到 getVersionDetail()，而下载事件是在 PromptOperationServiceImpl.downloadPromptVersion() 中发布的。请确认 remote console 模式下下载量是否预期会增长；如果需要增长，请补充对应实现和测试。

还有一个小点：关联 issue 里讨论的文件名是 promptKey_version.md，当前 PR 使用的是 promptKey-version.md。请确认最终希望采用哪种文件名格式。

@grllll 请帮忙确认一下上述review的问题。

[grllll]

Thanks for the contribution. The main feature direction looks aligned with #14848, and the Markdown builder already has focused unit coverage.
Before moving this forward, could you add coverage for the new download-count path as well? In particular, PromptDownloadCountManager is the core state-changing part of this PR, but the current patch coverage shows it is not covered. It would be helpful to lock down event accumulation and the DB increment/flush behavior.
One more thing to confirm: PromptRemoteHandler.downloadPromptVersion() currently delegates to getVersionDetail(), while the download event is published by PromptOperationServiceImpl.downloadPromptVersion(). Please confirm whether download counts are expected to increase in remote console mode, or add/update the implementation and tests if needed.
Also, the linked issue discussion mentioned promptKey_version.md, while this PR currently uses promptKey-version.md. Please confirm the intended filename format.
感谢贡献。这个功能方向和 #14848 是对齐的，Markdown builder 也已经有比较聚焦的单测覆盖。
继续推进前，建议再补一下新增下载量统计链路的测试。尤其是 PromptDownloadCountManager 是这个 PR 里真正会改变状态的核心逻辑，但当前 patch coverage 显示这部分还没有覆盖。建议把事件累计、DB 增量 flush 行为锁定下来。
另外有一点需要确认：PromptRemoteHandler.downloadPromptVersion() 当前只是委托到 getVersionDetail()，而下载事件是在 PromptOperationServiceImpl.downloadPromptVersion() 中发布的。请确认 remote console 模式下下载量是否预期会增长；如果需要增长，请补充对应实现和测试。
还有一个小点：关联 issue 里讨论的文件名是 promptKey_version.md，当前 PR 使用的是 promptKey-version.md。请确认最终希望采用哪种文件名格式。

@grllll 请帮忙确认一下上述review的问题。

Thanks @shiyiyue1102 @KomachiSion! Updated accordingly:

1. Filename: switched the separator from - to _ as suggested in the issue
   (promptKey_version.md).

2. Download-count coverage: extended the unit tests to lock down event accumulation,
   scheduled flush, zero-count cleanup, and put-back retry on DB failure.

3. PromptRemoteHandler delegating to getVersionDetail: intentional, aligned with the
   existing SkillRemoteHandler behavior — maintainer-client doesn't expose a dedicated
   download method yet.