Skip to content

feat(llms.txt): just like https://ant.design/llms.txt #7400

New issue
New issue
Closed
#7461
Closed
feat(llms.txt): just like https://ant.design/llms.txt#7400
#7461
Assignees
ArgoZhang
Labels
enhancementNew feature or request
Milestone
v10.1.0

Description

@ice6
ice6
opened on Dec 23, 2025

Is there an existing issue for this?

  • I have searched the existing issues

Is your feature request related to a problem? Please describe the problem.

check here(https://llmstxt.org/) and here(https://ant.design/docs/react/llms-cn)

it is very useful for code agents.

Describe the solution you'd like

No response

Additional context

No response

Activity

  1. ice6
    assigned
    ArgoZhang
    on Dec 23, 2025
  2. ice6
    added
    enhancementNew feature or request
    on Dec 23, 2025

  3. bb-auto commented on Dec 23, 2025

    @bb-auto
    bb-autoBot
    on Dec 23, 2025 – with bb-auto

    @ice6 Thank you for contacting us. We will give feedback later.

  4. bb-auto
    added this to the v10.1.0 milestone on Dec 23, 2025

  5. j4587698 commented on Dec 25, 2025

    @j4587698
    j4587698
    on Dec 25, 2025
    Collaborator

    由于目前blazor是通过ws进行真实渲染内容交互的，所以llms.txt应该毫无作用，它只能提供对应的url链接，但是大模型去读取url的时候只能读到基础内容，无法连接到ws，就没有办法真正的获取到文档正文。
    llms-full.txt倒是可以，但是目前由于所有的例子都是实际例子，不是人工维护的，所以目前也没有什么好办法来生成完整的llms-full.txt，这个需求比较难做。

  6. ice6 commented on Dec 25, 2025

    @ice6
    ice6
    on Dec 25, 2025
    ContributorAuthor

    @j4587698 确实，文档网站居然没考虑SEO，可以考虑用blazor ssr生成文档主体部分，或者llms-full.txt也行。有了这个 code agent 就不会胡乱生成标签和属性了，不然现在code agent生成的代码编译都过不了。

  7. ice6 commented on Dec 25, 2025

    @ice6
    ice6
    on Dec 25, 2025
    ContributorAuthor

    如果没有这个东西，目前只能用项目引用的方式，让code agent直接读取 bootstrap blazor 组件源码了。不过这也太hack了。 :)

  8. j4587698 commented on Dec 25, 2025

    @j4587698
    j4587698
    on Dec 25, 2025
    Collaborator

    blazor本身就没办法seo，内容都是后面自动加载的，所有的code都是从源码里自动读取出来的，如果在预处理里就加载这些源码，那么你有的等了啊

  9. ice6 commented on Dec 25, 2025

    @ice6
    ice6
    on Dec 25, 2025
    ContributorAuthor

    blazor本身就没办法seo，内容都是后面自动加载的，所有的code都是从源码里自动读取出来的，如果在预处理里就加载这些源码，那么你有的等了啊

    https://learn.microsoft.com/zh-cn/aspnet/core/blazor/components/class-libraries-and-static-server-side-rendering

    我做的项目都是blazor server + ssr 呀，怎么会不能SEO呢 :)

    文档网站可能需要从架构层面解决一下，找到方法应该也不是难事儿，体验会好很多。

  10. ice6 commented on Dec 25, 2025

    @ice6
    ice6
    on Dec 25, 2025
    ContributorAuthor

    我特地跑到 https://www.fluentui-blazor.net/ 去看了一下，他们的文档网站居然从ssr切到了wasm...

    但网站上还留着这句话：

    By default, components use Static Server-side rendering (SSR). 
The component renders to the response stream and there is no interactivity.

    ......对fluentui-blazor无语了，之前这个站点还是干净的ssr。

    这个库的文档倒是code agent友好：

    https://antblazor.com/zh-CN/components/overview

  11. j4587698 commented on Dec 25, 2025

    @j4587698
    j4587698
    on Dec 25, 2025
    Collaborator

    ssr你seo个啥？没意义啊，seo也就是看到loading，有啥意义呢

  12. ice6 commented on Dec 25, 2025

    @ice6
    ice6
    on Dec 25, 2025
    ContributorAuthor

    @j4587698 看下文档很难么，不懂去看看文档再说话呗 :)

    https://learn.microsoft.com/zh-cn/aspnet/core/blazor/components/class-libraries-and-static-server-side-rendering

  13. j4587698 commented on Dec 25, 2025

    @j4587698
    j4587698
    on Dec 25, 2025
    Collaborator

    你开了预渲染然后把你的数据加载都放在init里？然后还要加载两遍？让用户陪着你看白屏吗？

  14. ice6 commented on Dec 25, 2025

    @ice6
    ice6
    on Dec 25, 2025
    ContributorAuthor

    @j4587698 我们现在讨论的是怎么给code agent看到内容。你要讨论用户体验的话，你再去补补知识行不？

  15. ice6
    closed this as completedon Dec 25, 2025

  16. 5 remaining items

  17. ice6 commented on Dec 25, 2025

    @ice6
    ice6
    on Dec 25, 2025
    ContributorAuthor

    你这方面知识确实少呀。

    我问你ssr是不是可以把部分代码输出到html source中去。

    你考虑了性能问题，那就加载一部分进去是不是就可以了，剩下的需要交互的部分用blazor server或者wasm或js增强交互是否可行？先静态的这部分是不是可以给code agent看了，剩下需要互动的部分用blazor的机制完成就行了。

    其次这个问题fluent-ui的维护者给了更好的方案，见这里：
    microsoft/fluentui-blazor#4427

    他提出了用MCP Server解决我提出的问题，那是正确的回应方式。而你直接说ssr不行，不是你知识有限而是啥？因为ssr确实可以提供给code agent够用的养料。

    blazor本身就没办法seo，内容都是后面自动加载的，这可能是.net 8之前的事情，作者的库都支持到.net 10了。

  18. ice6 commented on Dec 25, 2025

    @ice6
    ice6
    on Dec 25, 2025
    ContributorAuthor

    SSR解决白屏的原理是不预渲染，或者预渲染是Loading，哪怕微软，它的例子也是if (xx == null){loading...}else {真正的组件}。到底是谁知识太有限？ 从你给一个静态渲染的url我就知道，要不然你根本就没用过静态渲染，要不然你就根本没用过组件库。静态组件不支持js，不支持afterrender，不支持交互，所以这玩意我们组件库至少有一半以上的组件是不能正常用的。 你从开始就自己觉得如何，总以为别人比你知识少，你考虑过没有别人已经知道这些问题呢？

    我们组件库，你是BootstrapBlazor的维护者之一么？是的话，我向你们表达一下感谢，不是的话就把话说清楚一些。

  19. j4587698 commented on Dec 25, 2025

    @j4587698
    j4587698
    on Dec 25, 2025
    Collaborator

    部分代码输出的不是html吗？html你给code agent有什么用？code agent要看的是html吗？他要看的不是razor吗？不是编译前的东西吗？这部分跟你编译后的html有什么关系？
    MCP Server跟你说的llms.txt有什么关系呢？开始我们说的不是llms.txt做不到吗？你扯到MCP Server上去干啥？MCP Server又跟SSR有什么关系？

  20. j4587698 commented on Dec 25, 2025

    @j4587698
    j4587698
    on Dec 25, 2025
    Collaborator

    SSR解决白屏的原理是不预渲染，或者预渲染是Loading，哪怕微软，它的例子也是if (xx == null){loading...}else {真正的组件}。到底是谁知识太有限？ 从你给一个静态渲染的url我就知道，要不然你根本就没用过静态渲染，要不然你就根本没用过组件库。静态组件不支持js，不支持afterrender，不支持交互，所以这玩意我们组件库至少有一半以上的组件是不能正常用的。 你从开始就自己觉得如何，总以为别人比你知识少，你考虑过没有别人已经知道这些问题呢？

    我们组件库，你是BootstrapBlazor的维护者之一么？是的话，我向你们表达一下感谢，不是的话就把话说清楚一些。

    你难道看不到我右上角的Member吗？最起码证明我是库的成员之一吧？这玩意还用问吗？

  21. ice6 commented on Dec 25, 2025

    @ice6
    ice6
    on Dec 25, 2025
    ContributorAuthor

    code agent要看的是html吗?

    当然是拉，llms.txt不就是让code agent到对的位置自己去看文档的么？弱一点儿的llm工作起来像爬虫，需要获得html。强一点儿的自己渲染完整页面后直接dom里取数据，一般的code agent都是前者。

  22. j4587698 commented on Dec 25, 2025

    @j4587698
    j4587698
    on Dec 25, 2025
    Collaborator

    code agent要看的是html吗?

    当然是拉，llms.txt不就是让code agent到对的位置自己去看文档的么？弱一点儿的llm工作起来像爬虫，需要获得html。强一点儿的自己渲染完整页面后直接dom里取数据，一般的code agent都是前者。

    他看html干啥？他要知道怎么写<Table TItem="Entity">这个组件，不是需要看到这个Table最后渲染成<table><tr><td>你给他看<table><tr><td>没有任何用处

  23. ice6 commented on Dec 25, 2025

    @ice6
    ice6
    on Dec 25, 2025
    ContributorAuthor

    code agent看html，跟人看组件的说明文档是一个道理呀，它看code sample当然帮助更大，所以我本地直接用项目引用的方式，更利落。

  24. ice6 commented on Dec 25, 2025

    @ice6
    ice6
    on Dec 25, 2025
    ContributorAuthor

    SSR解决白屏的原理是不预渲染，或者预渲染是Loading，哪怕微软，它的例子也是if (xx == null){loading...}else {真正的组件}。到底是谁知识太有限？ 从你给一个静态渲染的url我就知道，要不然你根本就没用过静态渲染，要不然你就根本没用过组件库。静态组件不支持js，不支持afterrender，不支持交互，所以这玩意我们组件库至少有一半以上的组件是不能正常用的。 你从开始就自己觉得如何，总以为别人比你知识少，你考虑过没有别人已经知道这些问题呢？

    我们组件库，你是BootstrapBlazor的维护者之一么？是的话，我向你们表达一下感谢，不是的话就把话说清楚一些。

    你难道看不到我右上角的Member吗？最起码证明我是库的成员之一吧？这玩意还用问吗？

    Image

    还真看不到，圣诞快乐，:)

  25. j4587698 commented on Dec 25, 2025

    @j4587698
    j4587698
    on Dec 25, 2025
    Collaborator

    https://github.com/BootstrapBlazor/BootstrapBlazor.MCPServer 哪怕MCP Server的方式，我们也尝试过，但是现在拿不到合适的代码，需要去分那一块是哪一块。我们试过的方法比你想象的多太多了。就是那个搜索，那都是老张花了5万找人做的，专门花钱买了个爬虫来处理。
    BB的东西比你想象中多太多了，要做出一个合适的东西来要难得多。

  26. j4587698 commented on Dec 25, 2025

    @j4587698
    j4587698
    on Dec 25, 2025
    Collaborator

    我们随时欢迎PR，任何PR都会认真对待

  27. ice6 commented on Dec 25, 2025

    @ice6
    ice6
    on Dec 25, 2025
    ContributorAuthor

    @j4587698 谢谢 https://github.com/BootstrapBlazor/BootstrapBlazor.MCPServer 我回头看看，谢谢耐心回复。:)

  28. ice6 commented on Dec 25, 2025

    @ice6
    ice6
    on Dec 25, 2025
    ContributorAuthor

    https://github.com/BootstrapBlazor/BootstrapBlazor.MCPServer 哪怕MCP Server的方式，我们也尝试过，但是现在拿不到合适的代码，需要去分那一块是哪一块。我们试过的方法比你想象的多太多了。就是那个搜索，那都是老张花了5万找人做的，专门花钱买了个爬虫来处理。 BB的东西比你想象中多太多了，要做出一个合适的东西来要难得多。

    对你们有了更多的了解，非常感谢你们的贡献和付出！BIG THANKS to @ArgoZhang ! Merry Christmas.

  29. ArgoZhang commented on Dec 26, 2025

    @ArgoZhang
    ArgoZhang
    on Dec 26, 2025
    Member

    @ice6 @j4587698 看到二位激烈的讨论有些感触，鞠佬是组件库项目组老成员了，提供了很多扩展组件，还是微软最有价值专家（MVP），对 Blazor 有很深的功底的，但是文字表达很容易造成说者说的是茶杯的事，听着想到的是茶壶，所以各持己见，但是这也不是坏事，有讨论才有进步嘛。

    @ice6 我们为了迎合 AI 确实做了一些尝试，显然目前做的不够，但是真的希望有更好的解决方案，哪怕是思路也可以提供一下，我们可以去尝试一下下。

    微软每次更新大版本我们都会尝试一次把官网更改成 Auto 或者 wasm 模式，整体评估下来又都回退到 ssr 模式了，NET10 已经我们还没有精力把网站更改成 auto 或者 wasm 进行测试，这个工作量非常大，目前官网实例都是真的例子、能交互的例子，这个官网文档改版过两次，每次都是 6 个月之久（当时都还不到 100 个组件），太耗时了

    @ice6 非常感谢对组件库提出过非常非常多的建议以及 bug 报告，代表开发团队对你表示衷心的感谢

  30. dotnetcore
    locked and limited conversation to collaborators on Dec 26, 2025
  31. ArgoZhang
    converted this issue into a discussion #7420 on Dec 26, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request

Type

No type

Projects

No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions