docs: sync llms.txt with CloudNS and automate doc changes detection (#666)

* Initial plan

* docs(agents): update AGENTS.md with CloudNS files and version

Co-authored-by: NewFuture <6290356+NewFuture@users.noreply.github.com>

* docs(agents): remove unnecessary emphasis on test_provider_cloudns.py

Co-authored-by: NewFuture <6290356+NewFuture@users.noreply.github.com>

* docs: update llms.txt with CloudNS and enhance update-agents workflow

Co-authored-by: NewFuture <6290356+NewFuture@users.noreply.github.com>

* Update .github/scripts/update_agents_structure.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* fix: remove trailing whitespace in update_agents_structure.py

Co-authored-by: NewFuture <6290356+NewFuture@users.noreply.github.com>

* fix: update script to use 'docs/' instead of 'doc/' directory

Co-authored-by: NewFuture <6290356+NewFuture@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: NewFuture <6290356+NewFuture@users.noreply.github.com>
Co-authored-by: New Future <NewFuture@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: 3 people

.github/scripts/update_agents_structure.py

@@ -55,20 +55,23 @@ def parse_agents_md():
             stack.append(name.rstrip("/"))
         else:
             path = "/".join(stack + [name])
-            if path.startswith(("ddns/", "doc/", "schema/")) and not path.endswith((".png", ".svg", ".jpg", ".gif", ".ico")):
+            if path.startswith(("ddns/", "docs/", "schema/")) and not path.endswith((".png", ".svg", ".jpg", ".gif", ".ico")):
                 files.add(path)
     return files
 
 
 def main():
     # type: () -> None
     actual = (
-        scan_files("ddns", (".py")) | scan_files("doc", (".md",)) | scan_files("schema", (".json",))
+        scan_files("ddns", (".py")) | scan_files("docs", (".md",)) | scan_files("schema", (".json",))
     )
     documented = parse_agents_md()
 
     added, deleted = sorted(actual - documented), sorted(documented - actual)
 
+    # Check if any changes are in docs/ directory
+    docs_changes = any(f.startswith("docs/") for f in added + deleted)
+
     # Remove old issue body file if exists
     if os.path.exists(ISSUE_BODY_FILE):
         os.remove(ISSUE_BODY_FILE)
@@ -88,6 +91,8 @@ def main():
         lines.extend("- `%s`" % f for f in deleted)
         lines.append("")
     lines.append("## Required Updates\n1. Update directory structure\n2. Update version/date")
+    if docs_changes:
+        lines.append("3. Update docs/llms.txt")
     lines.append("\n---\n*Auto-generated by update-agents workflow.*")
 
     with open(ISSUE_BODY_FILE, "w", encoding="utf-8") as f:

AGENTS.md

@@ -79,6 +79,7 @@ ddns/:	Main application code
 		aliesa.py:	Alibaba Cloud ESA
 		callback.py:	Custom webhook callbacks
 		cloudflare.py:	Cloudflare DNS
+		cloudns.py:	ClouDNS
 		debug.py:	Debug provider
 		dnscom.py:	DNS.COM
 		dnspod.py:	DNSPod (China)
@@ -138,6 +139,7 @@ docs/:	Documentation (VitePress-based)
 		aliesa.md:	Alibaba Cloud ESA guide
 		callback.md:	Custom webhook callbacks guide
 		cloudflare.md:	Cloudflare DNS guide
+		cloudns.md:	ClouDNS guide
 		debug.md:	Debug provider guide
 		dnscom.md:	DNS.COM provider guide
 		dnspod.md:	DNSPod (China) guide
@@ -165,6 +167,7 @@ docs/:	Documentation (VitePress-based)
 			aliesa.md:	Alibaba Cloud ESA guide
 			callback.md:	Custom webhook callbacks guide
 			cloudflare.md:	Cloudflare DNS guide
+			cloudns.md:	ClouDNS guide
 			debug.md:	Debug provider guide
 			dnscom.md:	DNS.COM provider guide
 			dnspod.md:	DNSPod (China) guide
@@ -580,6 +583,6 @@ For detailed information on specific topics, refer to:
 
 ---
 
-**Version**: 1.0.3  
-**Last Updated**: 2026-01-13  
+**Version**: 1.0.4  
+**Last Updated**: 2026-01-28  
 **Maintained by**: DDNS Project Contributors

docs/llms.txt

@@ -39,6 +39,7 @@ DDNS is a Python-based dynamic DNS client that automatically updates DNS records
 - Provider Overview: https://ddns.newfuture.cc/providers/
 - DNSPod: https://ddns.newfuture.cc/providers/dnspod
 - Cloudflare: https://ddns.newfuture.cc/providers/cloudflare
+- ClouDNS: https://ddns.newfuture.cc/providers/cloudns
 - AliDNS (Alibaba): https://ddns.newfuture.cc/providers/alidns
 - Tencent Cloud: https://ddns.newfuture.cc/providers/tecentcloud
 - Huawei Cloud: https://ddns.newfuture.cc/providers/huaweicloud
@@ -70,7 +71,7 @@ ddns --dns dnspod --id your_id --token your_token
 
 ## Supported DNS Providers
 
-DNSPod, Cloudflare, AliDNS (Alibaba Cloud), Tencent Cloud, Huawei Cloud, GoDaddy, Namecheap, CloudXNS, HE.net, DynDNS, NoIP, 51Dns, Aliesa, Callback, and more.
+DNSPod, Cloudflare, ClouDNS, AliDNS (Alibaba Cloud), Tencent Cloud, Huawei Cloud, GoDaddy, Namecheap, CloudXNS, HE.net, DynDNS, NoIP, 51Dns, Aliesa, Callback, and more.
 
 ## Technical Details