diff --git a/docs/.cdn.cache.json b/docs/.cdn.cache.json
index 5975903d54..a11b25cc53 100644
--- a/docs/.cdn.cache.json
+++ b/docs/.cdn.cache.json
@@ -237,6 +237,7 @@
"https://github.com/user-attachments/assets/09c994cf-78f8-46ea-9fef-a06022c0f6d7": "/blog/assets6b6c251a2d4a77784c08fb07fc51abf9.webp",
"https://github.com/user-attachments/assets/0af85438-ac99-4c95-b888-a17e88ede043": "/blog/assetsf1e1ca1adaac36881ec6c3b2ce1a099e.webp",
"https://github.com/user-attachments/assets/0c73c453-6ee3-4f90-bc5d-119c52c38fef": "/blog/assets2a74d926ae05faf2ee9f8da858bec3f6.webp",
+ "https://github.com/user-attachments/assets/0d5fb9e3-f9f0-4f35-a2b8-abd000ab600f": "/blog/assets313dfd5108d6fade542c846a87e2aa5a.webp",
"https://github.com/user-attachments/assets/0e2fdc5d-9623-4a74-a7f6-dcb802d52297": "/blog/assets61324ea13398c8920f798b97ac19d58f.webp",
"https://github.com/user-attachments/assets/0e3a7174-6b66-4432-a319-dff60b033c24": "/blog/assets/39d7890f8cbe21e77db8d3c94f7f22e4.webp",
"https://github.com/user-attachments/assets/0f79c266-cce5-4936-aabd-4c8f19196d91": "/blog/assets6b67dabe7b9226cdff1bace5a3b8ab18.webp",
@@ -251,9 +252,11 @@
"https://github.com/user-attachments/assets/162bc64e-0d34-4a4e-815a-028247b73143": "/blog/assets308f9fd45d0e8a140c1c18e6c92a1a57.webp",
"https://github.com/user-attachments/assets/16cd9aef-c87b-48a4-95c0-b666082e7515": "/blog/assets0ceb7e446f9a850df283093563ba7803.webp",
"https://github.com/user-attachments/assets/199b862a-5de4-4a54-83b2-f4dbf69be902": "/blog/assetsb9d1f02ab6c26f8a2c7873a949b4dd3c.webp",
+ "https://github.com/user-attachments/assets/19f34b62-fb65-4a5d-9ca5-2ace06fb778b": "/blog/assets5dd8b54083201bff2494404b66e37df0.webp",
"https://github.com/user-attachments/assets/1a7e9600-cd0f-4c82-9d32-4e61bbb351cc": "/blog/assets5997a6461e20103f5bc9d6b78b872833.webp",
"https://github.com/user-attachments/assets/1bf1a5f0-32ad-418c-a8d1-6c54740f50b9": "/blog/assets4d0d191b487c114abf084eb7f2dc381c.webp",
"https://github.com/user-attachments/assets/1c6a3e42-8e24-4148-b2c3-0bfe60a8cf77": "/blog/assets8096422e62e10dcd58efe75c616f9e88.webp",
+ "https://github.com/user-attachments/assets/1ce3a977-05d8-4120-9260-34323c147087": "/blog/assetsa95ea7fad4727559d3f8d84a96947d5e.webp",
"https://github.com/user-attachments/assets/1d77cca4-7363-4a46-9ad5-10604e111d7c": "/blog/assets1049abec5850cebf8ce12cd50199b9c5.webp",
"https://github.com/user-attachments/assets/1e33aff2-6186-4e1f-80a8-4a2c855d8cc1": "/blog/assets6f2a84bee4245ca507e98e96247d5c5e.webp",
"https://github.com/user-attachments/assets/1fb5df18-5261-483e-a445-96f52f80dd20": "/blog/assets69146738e31a47ac6425070208ebd906.webp",
@@ -261,20 +264,27 @@
"https://github.com/user-attachments/assets/21c52e2a-b2f8-4de8-a5d4-cf3444608db7": "/blog/assets50607dece1bbffe80fdcbe76324ff9b6.webp",
"https://github.com/user-attachments/assets/22e1a039-5e6e-4c40-8266-19821677618a": "/blog/assets89b45345c84f8b7c3bf4d554169689ac.webp",
"https://github.com/user-attachments/assets/237864d6-cc5d-4fe4-8a2b-c278016855c5": "/blog/assetsf3e7c2e961d1d2886fe231a4ac59e2f1.webp",
+ "https://github.com/user-attachments/assets/23e57d4f-9449-48a0-b263-f6a869c023b3": "/blog/assets1aaca5d65761b58564e3f196a91cde3e.webp",
"https://github.com/user-attachments/assets/2787824c-a13c-466c-ba6f-820bddfe099f": "/blog/assets/8d6c17a6ea5e784edf4449fb18ca3f76.webp",
"https://github.com/user-attachments/assets/27c37617-a813-4de5-b0bf-c7167999c856": "/blog/assetsc958eae64465451c4374cdee8f6fd596.webp",
"https://github.com/user-attachments/assets/28590f7f-bfee-4215-b50b-8feddbf72366": "/blog/assets89a8dadc85902334ce8d2d5b78abf709.webp",
"https://github.com/user-attachments/assets/29508dda-2382-430f-bc81-fb23f02149f8": "/blog/assets/29b13dc042e3b839ad8865354afe2fac.webp",
+ "https://github.com/user-attachments/assets/2a0a21f6-4dc8-4160-a683-8629af1f6336": "/blog/assetsbd0ac93d1d3bba86d5da86b9569a6fb1.webp",
"https://github.com/user-attachments/assets/2a4116a7-15ad-43e5-b801-cc62d8da2012": "/blog/assets/37d85fdfccff9ed56e9c6827faee01c7.webp",
+ "https://github.com/user-attachments/assets/2b9d5184-5884-4dab-9eaa-c3097b19c499": "/blog/assets8a08815733e06500b6552019d6dfbe7b.webp",
"https://github.com/user-attachments/assets/2bb4c09d-75bb-4c46-bb2f-faf538308305": "/blog/assetsf0ebf396dbe9559eb3478f48f648a6e2.webp",
"https://github.com/user-attachments/assets/2dd3cde5-fa0d-4f52-b82b-28d9e89379a0": "/blog/assets66b0dfa56c1f5b3063b5ba740dd3ef8d.webp",
"https://github.com/user-attachments/assets/2f7c5c45-ec6a-4393-8fa9-19a4c5f52f7a": "/blog/assets89168f61edcb2ee92d2ad7064da218b2.webp",
+ "https://github.com/user-attachments/assets/301ff923-7702-46c7-b1f8-b2c43bd699aa": "/blog/assetscb1c097430e064f8f99de85e5f078784.webp",
"https://github.com/user-attachments/assets/3050839a-cb16-485d-8bae-1bc2f9ade632": "/blog/assetsf117203c39294f45930785d85773c83e.webp",
"https://github.com/user-attachments/assets/30c33426-412d-4dec-b096-317fe5880e79": "/blog/assets66829206b15b6c36fa3344835659c041.webp",
+ "https://github.com/user-attachments/assets/31a0b226-523d-4540-a98a-290b6853a3db": "/blog/assets0a25d3ffb02d35f6f28cdfa9da2dccd8.webp",
"https://github.com/user-attachments/assets/328e9755-8da9-4849-8569-e099924822fe": "/blog/assetsf78c85b0a0183a3ae3f2e916d59c0a67.webp",
"https://github.com/user-attachments/assets/35164b25-c964-42ce-9cb0-32f6ebe1d07c": "/blog/assetsb6af626eeb0e1e638d80dc9ff7a6eba9.webp",
"https://github.com/user-attachments/assets/37251adf-949b-4aec-bc49-bf4647e119da": "/blog/assetscd53b161a6d02424d03f8c5dcadc3dd5.webp",
"https://github.com/user-attachments/assets/378df8df-8ec4-436e-8451-fbc52705faee": "/blog/assetsba0243e75b0421b6dd7dadad02e4b0d6.webp",
+ "https://github.com/user-attachments/assets/37bd35c6-c6e1-4c33-aeb6-c4b0cb1e25ff": "/blog/assets3fcf2ee44ffb6be5c3148667f0c1696e.webp",
+ "https://github.com/user-attachments/assets/3849afb3-ea46-4d30-bc81-a7cb88cf451f": "/blog/assetsb6f4b163825de58e2b6fe4dba8ef1b26.webp",
"https://github.com/user-attachments/assets/385eaca6-daea-484a-9bea-ba7270b4753d": "/blog/assets/d6129350de510a62fe87b2d2f0fb9477.webp",
"https://github.com/user-attachments/assets/3ad2655e-dd20-4534-bf6d-080b3677df86": "/blog/assets48b5c19e20fb870c7bdd34bd3aefbb21.webp",
"https://github.com/user-attachments/assets/3c1a492d-a3d4-4570-9e74-785c2942ca41": "/blog/assets9880145be3e52b8f9dcd8343cd34a6ca.webp",
@@ -284,6 +294,7 @@
"https://github.com/user-attachments/assets/411e2002-61f0-4010-9841-18e88ca895ec": "/blog/assets7c3eab218c0823fa353b1cd23afe21c3.webp",
"https://github.com/user-attachments/assets/420379cd-d8a4-4ab3-9a46-75dcc3d56920": "/blog/assets0ca3e3989fb3884658765ee0ef2587a0.webp",
"https://github.com/user-attachments/assets/4257e123-9018-4562-ac66-0f39278906f5": "/blog/assetsadbc0db573a0f581b22c30ecf243f721.webp",
+ "https://github.com/user-attachments/assets/432d22e3-8d73-4376-b4cf-a7dcacae4444": "/blog/assets862c2fcdfd3a9e51c44c721c47e1ff5a.webp",
"https://github.com/user-attachments/assets/433fdce4-0af5-417f-b80d-163c2d4f02f6": "/blog/assets4aaf8d5d092608b649230e0e6fc92df6.webp",
"https://github.com/user-attachments/assets/452d0b48-5ff7-4f42-a46e-68a62b87632b": "/blog/assets78232916d13ddc942ab3d0b62b639509.webp",
"https://github.com/user-attachments/assets/467bb431-ca0d-4bb4-ac17-e5e2b764a770": "/blog/assetsff480f9009cf873852a43c252ac36828.webp",
@@ -312,8 +323,10 @@
"https://github.com/user-attachments/assets/638dcd7c-2bff-4adb-bade-da2aaef872bf": "/blog/assets95e6fe7c19ebfb9ead1c5a267aaf2a4e.webp",
"https://github.com/user-attachments/assets/639ed70b-abc5-476f-9eb0-10c739e5a115": "/blog/assets/b2845057b23bccfec3bfea90e43ac381.webp",
"https://github.com/user-attachments/assets/63e5ced7-1d23-44e1-b933-cc3b5df47eab": "/blog/assets5f1a6cb003752055b9ed131c1715154c.webp",
+ "https://github.com/user-attachments/assets/64f6a8cb-a693-4764-99f3-8e3621629db3": "/blog/assetsb74a9fc9aecbaa74529cf0fb0da37bca.webp",
"https://github.com/user-attachments/assets/659b5ac1-82f1-43bd-9d4b-a98491e05794": "/blog/assets856bd407c8a1510f616a4bdb1e02a883.webp",
"https://github.com/user-attachments/assets/669c68bf-3f85-4a6f-bb08-d0d7fb7f7417": "/blog/assets02dce7325584974cdba327fe2f996b9e.webp",
+ "https://github.com/user-attachments/assets/689c613b-776c-471f-b25c-167cce4033b0": "/blog/assets39788a720a65b89f84b2d0d844c4791d.webp",
"https://github.com/user-attachments/assets/692e7c67-f173-45da-86ef-5c69e17988e4": "/blog/assets6b01801b405c366fa4ebe683a77f289d.webp",
"https://github.com/user-attachments/assets/6935e155-4a1d-4ab7-a61a-2b813d65bb7b": "/blog/assets/6ee2609d79281b6b915e317461013f31.webp",
"https://github.com/user-attachments/assets/6d068fe0-8100-4b43-b0c3-7934f54e688f": "/blog/assets87c281587b15f05b6b4e1afcd5bb47e8.webp",
@@ -328,6 +341,7 @@
"https://github.com/user-attachments/assets/72f02ce5-9991-425b-9864-9113ee1ed6bf": "/blog/assetsfa2c650be15522ac2fd71a3e434a1b2e.webp",
"https://github.com/user-attachments/assets/7350f211-61ce-488e-b0e2-f0fcac25caeb": "/blog/assetsf9ed064fe764cbeff2f46910e7099a91.webp",
"https://github.com/user-attachments/assets/76ad163e-ee19-4f95-a712-85bea764d3ec": "/blog/assets5205b6dd0f80b8ba02c297fcdfc1aecb.webp",
+ "https://github.com/user-attachments/assets/78c408b0-8432-4938-bdff-c9a291b6c5be": "/blog/assetsf9317924035e48fcb1d1ae586568ea5f.webp",
"https://github.com/user-attachments/assets/796c94af-9bad-4e3c-b1c7-dbb17c215c56": "/blog/assetsbd8c97ef67055e3ff93c56e46c33fa8d.webp",
"https://github.com/user-attachments/assets/798ddb18-50c7-462a-a083-0c6841351d26": "/blog/assets11a8089b511aaa61e8982dea0a3665c5.webp",
"https://github.com/user-attachments/assets/7cb3019b-78c1-48e0-a64c-a6a4836affd9": "/blog/assets3ca963d92475f34b0789cfa50071bc52.webp",
@@ -346,6 +360,7 @@
"https://github.com/user-attachments/assets/8910186f-4609-4798-a588-2780dcf8db60": "/blog/assets4175fc55c2093d635f15a3287e89e977.webp",
"https://github.com/user-attachments/assets/899a4393-db41-45a6-97ec-9813e1f9879d": "/blog/assets88248c034ef28ca9b909219d2e7ef32a.webp",
"https://github.com/user-attachments/assets/8a0225e0-16ed-40ce-9cd5-553dda561679": "/blog/assets74fbd94a0dc865d2178954662dc964ae.webp",
+ "https://github.com/user-attachments/assets/8b52d907-4359-405c-95f6-eb61c36be0bc": "/blog/assetsc3042da681a9df811e70473636a8f461.webp",
"https://github.com/user-attachments/assets/8ce79bd6-f1a3-48bb-b3d0-5271c84801c2": "/blog/assets5f8cc99da9c3c1eaca284411833c99e3.webp",
"https://github.com/user-attachments/assets/8d90ae64-cf8e-4d90-8a31-c18ab484740b": "/blog/assets04ab03ac7920031925f7ee27846b3f7d.webp",
"https://github.com/user-attachments/assets/8ec7656e-1e3d-41e0-95a0-f6883135c2fc": "/blog/assets71b5cfd165bc907f437bf807048a3e67.webp",
@@ -361,7 +376,12 @@
"https://github.com/user-attachments/assets/a1af5778-f47a-4fdc-baf5-ca2a1e66f48e": "/blog/assets97ac48dab1a35e45e034fefe0a1a1006.webp",
"https://github.com/user-attachments/assets/a1ba8ec0-e259-4da4-8980-0cf82ca5f52b": "/blog/assetsbd69842ebb37848ecd50c242aad835b0.webp",
"https://github.com/user-attachments/assets/a42ba52b-491e-4993-8e2f-217aa1776e0f": "/blog/assets0f847842a5dedf7bef1f534278aec584.webp",
+ "https://github.com/user-attachments/assets/a4350cec-20ad-4abe-a135-de54d0790623": "/blog/assets95dc1ff1901807b3f860b70294667682.webp",
+ "https://github.com/user-attachments/assets/a43dd863-fd97-41ab-bcc0-0cf5fb1a859d": "/blog/assets05b5684db0f7035e8f0609f6b1b8d85c.webp",
+ "https://github.com/user-attachments/assets/a49860c9-11a9-4916-ae61-042e24b1e2f1": "/blog/assetsa8003533498461272ea15a19407db9f4.webp",
"https://github.com/user-attachments/assets/a53deb11-2c14-441a-8a5c-a0f3a74e2a63": "/blog/assets65c86d6e63ddd5dd9896a6a67c054c0d.webp",
+ "https://github.com/user-attachments/assets/a850b19f-c45a-4aa9-a583-4a453e421fc1": "/blog/assetsf811b07c10e4a887248fc3f53d085241.webp",
+ "https://github.com/user-attachments/assets/a92c8ad1-4243-4eaa-affa-8650fe0a6c63": "/blog/assets03aba6c4b7a39ed9b1be75ecd8f335dc.webp",
"https://github.com/user-attachments/assets/a9de7780-d0cb-47d5-ad9c-fcbbec14b940": "/blog/assets79e8fff075490d2a4535590a02333316.webp",
"https://github.com/user-attachments/assets/aa91ca54-65fc-4e33-8c76-999f0a5d2bee": "/blog/assetsf625540e8340bafe69ccbb89ad75707a.webp",
"https://github.com/user-attachments/assets/aaa3e2c5-7f16-4cfb-86b6-2814a1aafe3a": "/blog/assets93da89c4892a80e2e5a6caa49d80af5f.webp",
@@ -369,7 +389,9 @@
"https://github.com/user-attachments/assets/ae03eab5-a319-4d2a-a5f6-1683ab7739ee": "/blog/assetsa25c48c9faa225bf6f72658e5bd58d64.webp",
"https://github.com/user-attachments/assets/aea782b1-27bd-4d9c-b521-c172c2095fe6": "/blog/assets52c8de6425a785409464561c09f8c98d.webp",
"https://github.com/user-attachments/assets/aead3c6c-891e-47c3-9f34-bdc33875e0c2": "/blog/assetsb6959f725c38f86053e4b07c9188d825.webp",
+ "https://github.com/user-attachments/assets/aeb73c3e-4f04-4bec-820f-264792f8d0dc": "/blog/assets737e194726e134bc205a37d74eaee98e.webp",
"https://github.com/user-attachments/assets/aee846d5-b5ee-46cb-9dd0-d952ea708b67": "/blog/assets/8a8d361b4c0cce6da350cc0de65c0ad6.webp",
+ "https://github.com/user-attachments/assets/b022fb0b-9773-4bf1-adf2-c602d16467ae": "/blog/assetscfcdfc63bc4f8defc06accef81339a5b.webp",
"https://github.com/user-attachments/assets/b2b36128-6a43-4a1f-9c08-99fe73fb565f": "/blog/assets85af5a2a51b851fe125055d374cc8263.webp",
"https://github.com/user-attachments/assets/b3ab6e35-4fbc-468d-af10-e3e0c687350f": "/blog/assets4cd6d49afb0ab1354156961d396195a1.webp",
"https://github.com/user-attachments/assets/b49ed0c1-d6bf-4f46-b9df-5f7c730afaa3": "/blog/assets74000cc1bc59ee4a15e8f0304afbf866.webp",
@@ -388,6 +410,8 @@
"https://github.com/user-attachments/assets/c68e88e4-cf2e-4122-82bc-89ba193b1eb4": "/blog/assets/1f6c4f1c5e6211735ca4924c7807aca1.webp",
"https://github.com/user-attachments/assets/c75eb19e-e0f5-4135-91e4-55be8be8a996": "/blog/assets0f97d1dfccd5ba07172aff71ff9acd7b.webp",
"https://github.com/user-attachments/assets/c77fcf70-9039-49ff-86e4-f8eaa267bbf6": "/blog/assets5a2f360c19fcf9a037b2d1609479b713.webp",
+ "https://github.com/user-attachments/assets/ca1ef965-c7b6-401a-826c-bb9f1ac14769": "/blog/assets086849ced67ad95fc3f0d1f509add1bf.webp",
+ "https://github.com/user-attachments/assets/cb301317-8ac0-4962-8957-060c52c2010b": "/blog/assets8f3657f3785fc04c42b0f53c17daa72e.webp",
"https://github.com/user-attachments/assets/cb4ba5fe-c223-4b9f-a662-de93e4a536d1": "/blog/assets45d90e73abffd7ae7d85808f81827bb9.webp",
"https://github.com/user-attachments/assets/cc1f6146-8063-4a4d-947a-7fd6b9133c0c": "/blog/assets28749075f0c4d62c1642694a4ed9ec08.webp",
"https://github.com/user-attachments/assets/cf3bfd44-9c13-4026-95cd-67f54f40ce6c": "/blog/assetsc557d9ee77afeb958d198abf5ca79761.webp",
@@ -401,12 +425,14 @@
"https://github.com/user-attachments/assets/d7d65e32-679d-4e50-a933-28cf5dde1330": "/blog/assetsc51018f1581b769727ad1bb3bb641567.webp",
"https://github.com/user-attachments/assets/d902b5df-edb1-48d6-b659-daf948a97aed": "/blog/assets1e640c898e897bfb4ce4b66d5377010b.webp",
"https://github.com/user-attachments/assets/d961f2af-47b0-4806-8288-b1e8f7ee8a47": "/blog/assets9c1839eb146b89e9e2d262ca95d24323.webp",
+ "https://github.com/user-attachments/assets/d9daa8c9-957d-476e-83b1-4bbb351df555": "/blog/assets3865756ef6158a855aee64dd01bd3d6b.webp",
"https://github.com/user-attachments/assets/db59a5e7-32ed-49d7-a791-8f8ee6618c01": "/blog/assetsf601ee6fa15bed25e17d6b6879691f0f.webp",
"https://github.com/user-attachments/assets/dba58ea6-7df8-4971-b6d4-b24d5f486ba7": "/blog/assetsbbe90aa719d182d3d2f327e4182732c5.webp",
"https://github.com/user-attachments/assets/dd6bc4a4-3c20-4162-87fd-5cac57e5d7e7": "/blog/assetseebf66254337ce88357629c34e78c08d.webp",
"https://github.com/user-attachments/assets/dde2c9c5-cdda-4a65-8f32-b6f4da907df2": "/blog/assets/d47654360d626f80144cdedb979a3526.webp",
"https://github.com/user-attachments/assets/dec6665a-b3ec-4c50-a57f-7c7eb3160e7b": "/blog/assets8d4fbb776e2209a1ec58c6b3516351a1.webp",
"https://github.com/user-attachments/assets/dfc45807-2ed6-43eb-af4c-47df66dfff7d": "/blog/assetscad58c557fda04b9379000cbbaa4c493.webp",
+ "https://github.com/user-attachments/assets/e063e4e6-3d5c-47e4-84a2-c7f904a92a81": "/blog/assetsbc6a72dc53430bbbbeafcc7d921396f4.webp",
"https://github.com/user-attachments/assets/e269bd27-d323-43ba-811b-c0f5e4137903": "/blog/assetse12925fba0dda232168e695e6a5e4384.webp",
"https://github.com/user-attachments/assets/e3f44bc8-2fa5-441d-8934-943481472450": "/blog/assets3c54d6f2d55fae843fbbfdc0bd7ffec7.webp",
"https://github.com/user-attachments/assets/e43dacf6-313e-499c-8888-f1065c53e424": "/blog/assets89b0698da3476c6df24ba1f0a07e438e.webp",
@@ -414,6 +440,7 @@
"https://github.com/user-attachments/assets/e70c2db6-05c9-43ea-b111-6f6f99e0ae88": "/blog/assets/944c671604833cd2457445b211ebba33.webp",
"https://github.com/user-attachments/assets/e887fa04-c553-45f1-917f-5c123ac9c68b": "/blog/assets73ba166f1e6d54e8c860b91f61c23355.webp",
"https://github.com/user-attachments/assets/e89d2a56-4bf0-4bff-ac39-0d44789fa858": "/blog/assets9f6d4113be26efbcab41d83ed39dcb14.webp",
+ "https://github.com/user-attachments/assets/e8cb84eb-6eaf-4c72-8693-d28744965c22": "/blog/assetsfa30300bd730d56097bfbce49c5f3d06.webp",
"https://github.com/user-attachments/assets/eaa2a1fb-41ad-473d-ac10-a39c05886425": "/blog/assetsf5a62c963127764ebdf1cd226fac3dac.webp",
"https://github.com/user-attachments/assets/eaed3762-136f-4297-b161-ca92a27c4982": "/blog/assets/50b38eac1769ae6f13aef72f3d725eec.webp",
"https://github.com/user-attachments/assets/eb027093-5ceb-4a9d-8850-b791fbf69a71": "/blog/assetsd0c4369f894abb5ad6e514059b8f378e.webp",
@@ -422,15 +449,19 @@
"https://github.com/user-attachments/assets/ebdbc01a-a6b5-4bbc-b7ff-240d6015fbfc": "/blog/assets13656829368732a95940edeff9ddfca6.webp",
"https://github.com/user-attachments/assets/ed6965c8-6884-4adf-a457-573a96755f55": "/blog/assets2f83a9f03f13e73b7393641078627cf1.webp",
"https://github.com/user-attachments/assets/f0b2e72d-9eee-46a8-b094-4834b78764df": "/blog/assets8d6bb40d21d74cfa0312bdec347a11d0.webp",
+ "https://github.com/user-attachments/assets/f0e0a473-d6bf-4358-b9f1-cc6bfb4d74c4": "/blog/assetsfd4606a4b5d801a8764bf333cde77d57.webp",
+ "https://github.com/user-attachments/assets/f1f5c321-0285-46b7-9777-4a6bfa24029e": "/blog/assets939b659e955daf90e2e9e7caba8aa9bd.webp",
"https://github.com/user-attachments/assets/f3068287-8ade-4eca-9841-ea67d8ff1226": "/blog/assetsa343af49a2d7da73a3fa51f2086afdd4.webp",
"https://github.com/user-attachments/assets/f3177ce2-281c-4ed4-a061-239547b466c6": "/blog/assets86924c724c66931cf61417dbdcc04ee8.webp",
"https://github.com/user-attachments/assets/f4dbbadb-7461-4370-a836-09c487fdd206": "/blog/assets94397c91265c37b9f313dc439b90125f.webp",
"https://github.com/user-attachments/assets/f54c912d-3ee9-4f85-b8bf-619790e51b49": "/blog/assets620c308554394e72034d27ea743f8bff.webp",
"https://github.com/user-attachments/assets/f67180c2-47ba-4b04-9f12-d274c7821085": "/blog/assetscbda3a61a2d158eeb6046e1d1bf9972f.webp",
+ "https://github.com/user-attachments/assets/f6b19eab-42e5-4293-980a-b13fe409045f": "/blog/assets1be39423d2bca3a6ee3f247e02a638be.webp",
"https://github.com/user-attachments/assets/f878355f-710b-452e-8606-0c75c47f29d2": "/blog/assets3e2af0090f02059c687b6add6b73a90b.webp",
"https://github.com/user-attachments/assets/f9ccce84-4fd4-48ca-9450-40660112d0d7": "/blog/assetsd94f3e0cf32639bea46dbf92e0862f89.webp",
"https://github.com/user-attachments/assets/f9f7ed26-e506-4c52-a118-e0bb5e0918db": "/blog/assetse5dff9a2e16a134d85e891e4eb98fe55.webp",
"https://github.com/user-attachments/assets/fa8fab19-ace2-4f85-8428-a3a0e28845bb": "/blog/assets/2d678631c55369ba7d753c3ffcb73782.webp",
"https://github.com/user-attachments/assets/facdc83c-e789-4649-8060-7f7a10a1b1dd": "/blog/assets05b20e40c03ced0ec8707fed2e8e0f25.webp",
- "https://github.com/user-attachments/assets/fcdfb9c5-819a-488f-b28d-0857fe861219": "/blog/assets8477415ecec1f37e38ab38ff1217d0a7.webp"
+ "https://github.com/user-attachments/assets/fcdfb9c5-819a-488f-b28d-0857fe861219": "/blog/assets8477415ecec1f37e38ab38ff1217d0a7.webp",
+ "https://github.com/user-attachments/assets/fd60ab55-ead2-4930-ad00-fdf77662f5a0": "/blog/assets276a4e8748e9bd300b30dcd9d0e24980.webp"
}
diff --git a/docs/development/basic/contributing-guidelines.zh-CN.mdx b/docs/development/basic/contributing-guidelines.zh-CN.mdx
index 40240cf31c..9ae620ee66 100644
--- a/docs/development/basic/contributing-guidelines.zh-CN.mdx
+++ b/docs/development/basic/contributing-guidelines.zh-CN.mdx
@@ -91,17 +91,17 @@ bunx vitest run --silent='passed-only' '[file-path]'
提交信息请使用以下 emoji 作为前缀:
-| Emoji | 代码 | 类型 | 说明 | 触发发布? |
-| ----- | ------------------------ | -------- | ------------- | ---------- |
-| ✨ | `:sparkles:` | feat | 新功能 | 是 |
-| 🐛 | `:bug:` | fix | Bug 修复 | 是 |
-| 📝 | `:memo:` | docs | 文档更新 | 否 |
-| 💄 | `:lipstick:` | style | UI / 样式更改 | 否 |
-| ♻️ | `:recycle:` | refactor | 代码重构 | 否 |
-| ✅ | `:white_check_mark:` | test | 测试相关 | 否 |
-| 🔨 | `:hammer:` | chore | 维护任务 | 否 |
-| 🚀 | `:rocket:` | perf | 性能优化 | 否 |
-| 🌐 | `:globe_with_meridians:` | i18n | 国际化 | 否 |
+| Emoji | 代码 | 类型 | 说明 | 触发发布? |
+| ----- | ------------------------ | -------- | --------- | ----- |
+| ✨ | `:sparkles:` | feat | 新功能 | 是 |
+| 🐛 | `:bug:` | fix | Bug 修复 | 是 |
+| 📝 | `:memo:` | docs | 文档更新 | 否 |
+| 💄 | `:lipstick:` | style | UI / 样式更改 | 否 |
+| ♻️ | `:recycle:` | refactor | 代码重构 | 否 |
+| ✅ | `:white_check_mark:` | test | 测试相关 | 否 |
+| 🔨 | `:hammer:` | chore | 维护任务 | 否 |
+| 🚀 | `:rocket:` | perf | 性能优化 | 否 |
+| 🌐 | `:globe_with_meridians:` | i18n | 国际化 | 否 |
### 如何贡献
diff --git a/docs/usage/channels/discord.mdx b/docs/usage/channels/discord.mdx
index ca8c6292fd..bdd7bfc299 100644
--- a/docs/usage/channels/discord.mdx
+++ b/docs/usage/channels/discord.mdx
@@ -13,11 +13,6 @@ tags:
# Connect LobeHub to Discord
-
- This feature is currently in development and may not be fully stable. You can enable it by turning
- on **Developer Mode** in **Settings** → **Advanced Settings** → **Developer Mode**.
-
-
By connecting a Discord channel to your LobeHub agent, users can interact with the AI assistant directly through Discord server channels and direct messages.
## Prerequisites
diff --git a/docs/usage/channels/discord.zh-CN.mdx b/docs/usage/channels/discord.zh-CN.mdx
index 9a103ef525..75033fddd1 100644
--- a/docs/usage/channels/discord.zh-CN.mdx
+++ b/docs/usage/channels/discord.zh-CN.mdx
@@ -12,10 +12,6 @@ tags:
# 将 LobeHub 连接到 Discord
-
- 此功能目前正在开发中,可能尚未完全稳定。您可以通过在 **设置** → **高级设置** → **开发者模式** 中启用 **开发者模式** 来使用此功能。
-
-
通过将 Discord 渠道连接到您的 LobeHub 代理,用户可以直接通过 Discord 服务器频道和私信与 AI 助手互动。
## 前置条件
diff --git a/docs/usage/channels/feishu.mdx b/docs/usage/channels/feishu.mdx
index d3e4f4f495..1b22c24793 100644
--- a/docs/usage/channels/feishu.mdx
+++ b/docs/usage/channels/feishu.mdx
@@ -14,10 +14,6 @@ tags:
# Connect LobeHub to Feishu (飞书)
-
- This feature is currently in development and may not be fully stable. You can enable it by turning on **Developer Mode** in **Settings** → **Advanced Settings** → **Developer Mode**.
-
-
By connecting a Feishu channel to your LobeHub agent, team members can interact with the AI assistant directly in Feishu private chats and group conversations.
> If you are using the international version (Lark), please refer to the [Lark setup guide](/docs/usage/channels/lark).
@@ -38,6 +34,8 @@ By connecting a Feishu channel to your LobeHub agent, team members can interact
Click **Create Enterprise App**. Fill in the app name (e.g., "LobeHub 助手"), description, and icon, then submit the form.
+ 
+
### Copy App Credentials
Go to **Credentials & Basic Info** and copy:
@@ -46,6 +44,8 @@ By connecting a Feishu channel to your LobeHub agent, team members can interact
- **App Secret**
> **Important:** Keep your App Secret confidential. Never share it publicly.
+
+ 
## Step 2: Configure App Permissions and Bot
@@ -87,9 +87,13 @@ By connecting a Feishu channel to your LobeHub agent, team members can interact
}
```
+ 
+
### Enable Bot Capability
Go to **App Capability** → **Bot**. Toggle the bot capability on and set your preferred bot name.
+
+ 
## Step 3: Configure Feishu in LobeHub
@@ -111,6 +115,8 @@ By connecting a Feishu channel to your LobeHub agent, team members can interact
### Save and Copy the Webhook URL
Click **Save Configuration**. After saving, an **Event Subscription URL** will be displayed. Copy this URL — you will need it in the next step.
+
+ 
## Step 4: Set Up Event Subscription in Feishu
@@ -132,16 +138,22 @@ By connecting a Feishu channel to your LobeHub agent, team members can interact
This allows your app to receive messages and forward them to LobeHub.
+ 
+
### (Recommended) Fill in Verification Token and Encrypt Key
After configuring Event Subscription, you can find the **Verification Token** and **Encrypt Key** at the top of the Event Subscription page under **Encryption Strategy**.
+ 
+
Go back to LobeHub's channel settings and fill in:
- **Verification Token** — Used to verify that webhook events originate from Feishu
- **Encrypt Key** (optional) — Used to decrypt encrypted event payloads
Click **Save Configuration** again to apply.
+
+ 
## Step 5: Publish the App
@@ -151,6 +163,8 @@ By connecting a Feishu channel to your LobeHub agent, team members can interact
In your app settings, go to **Version Management & Release**. Create a new version with release notes.
+ 
+
### Submit for Review
Submit the version for review and publish. For enterprise self-managed apps, approval is typically automatic.
diff --git a/docs/usage/channels/feishu.zh-CN.mdx b/docs/usage/channels/feishu.zh-CN.mdx
index 85682d8a15..314ad08dd0 100644
--- a/docs/usage/channels/feishu.zh-CN.mdx
+++ b/docs/usage/channels/feishu.zh-CN.mdx
@@ -10,11 +10,6 @@ tags:
# 将 LobeHub 连接到飞书
-
- 此功能目前正在开发中,可能尚未完全稳定。您可以通过在 **设置** → **高级设置** → **开发者模式**
- 中启用 **开发者模式** 来使用此功能。
-
-
通过将飞书渠道连接到您的 LobeHub 代理,团队成员可以直接在飞书的私聊和群组对话中与 AI 助手互动。
> 如果您使用的是国际版(Lark),请参阅 [Lark 设置指南](/docs/usage/channels/lark)。
@@ -35,6 +30,8 @@ tags:
点击 **创建企业应用**。填写应用名称(例如 "LobeHub 助手")、描述和图标,然后提交表单。
+ 
+
### 复制应用凭证
进入 **凭证与基本信息**,复制以下内容:
@@ -43,6 +40,8 @@ tags:
- **应用密钥**
> **重要提示:** 请妥善保管您的应用密钥。切勿公开分享。
+
+ 
## 第二步:配置应用权限和机器人功能
@@ -84,9 +83,13 @@ tags:
}
```
+ 
+
### 启用机器人功能
进入 **应用能力** → **机器人**。开启机器人功能并设置您喜欢的机器人名称。
+
+ 
## 第三步:在 LobeHub 中配置飞书
@@ -108,6 +111,8 @@ tags:
### 保存并复制 Webhook URL
点击 **保存配置**。保存后,将显示一个 **事件订阅 URL**。复制此 URL—— 您将在下一步中需要它。
+
+ 
## 第四步:在飞书中设置事件订阅
@@ -129,16 +134,22 @@ tags:
这将使您的应用能够接收消息并将其转发到 LobeHub。
+ 
+
### (推荐)填写 Verification Token 和 Encrypt Key
配置事件订阅后,您可以在事件订阅页面顶部的 **加密策略** 中找到 **Verification Token** 和 **Encrypt Key**。
+ 
+
返回 LobeHub 的渠道设置,填写:
- **Verification Token** — 用于验证 webhook 事件是否来自飞书
- **Encrypt Key**(可选)— 用于解密加密事件负载
再次点击 **保存配置** 以应用。
+
+ 
## 第五步:发布应用
@@ -148,6 +159,8 @@ tags:
在您的应用设置中,进入 **版本管理与发布**。创建一个新版本并填写发布说明。
+ 
+
### 提交审核
提交版本进行审核并发布。对于企业自管理应用,通常会自动批准。
diff --git a/docs/usage/channels/lark.mdx b/docs/usage/channels/lark.mdx
index 922008f226..f1867ceadc 100644
--- a/docs/usage/channels/lark.mdx
+++ b/docs/usage/channels/lark.mdx
@@ -13,10 +13,6 @@ tags:
# Connect LobeHub to Lark
-
- This feature is currently in development and may not be fully stable. You can enable it by turning on **Developer Mode** in **Settings** → **Advanced Settings** → **Developer Mode**.
-
-
By connecting a Lark channel to your LobeHub agent, team members can interact with the AI assistant directly in Lark private chats and group conversations.
> If you are using the Chinese version (飞书), please refer to the [Feishu setup guide](/docs/usage/channels/feishu).
@@ -37,6 +33,8 @@ By connecting a Lark channel to your LobeHub agent, team members can interact wi
Click **Create Enterprise App**. Fill in the app name (e.g., "LobeHub Assistant"), description, and icon, then submit the form.
+ 
+
### Copy App Credentials
Go to **Credentials & Basic Info** and copy:
@@ -45,6 +43,8 @@ By connecting a Lark channel to your LobeHub agent, team members can interact wi
- **App Secret**
> **Important:** Keep your App Secret confidential. Never share it publicly.
+
+ 
## Step 2: Configure App Permissions and Bot
@@ -82,6 +82,8 @@ By connecting a Lark channel to your LobeHub agent, team members can interact wi
The scopes above are tailored for Lark (international). Some Feishu-specific scopes (e.g. `aily:*`, `corehr:*`, `im:chat.access_event.bot_p2p_chat:read`) are not available on Lark and have been excluded.
+ 
+
### Enable Bot Capability
Go to **App Capability** → **Bot**. Toggle the bot capability on and set your preferred bot name.
@@ -106,6 +108,8 @@ By connecting a Lark channel to your LobeHub agent, team members can interact wi
### Save and Copy the Webhook URL
Click **Save Configuration**. After saving, an **Event Subscription URL** will be displayed. Copy this URL — you will need it in the next step.
+
+ 
## Step 4: Set Up Event Subscription in Lark
@@ -127,6 +131,8 @@ By connecting a Lark channel to your LobeHub agent, team members can interact wi
This allows your app to receive messages and forward them to LobeHub.
+ 
+
### (Recommended) Fill in Verification Token and Encrypt Key
After configuring Event Subscription, you can find the **Verification Token** and **Encrypt Key** at the top of the Event Subscription page under **Encryption Strategy**.
@@ -137,6 +143,8 @@ By connecting a Lark channel to your LobeHub agent, team members can interact wi
- **Encrypt Key** (optional) — Used to decrypt encrypted event payloads
Click **Save Configuration** again to apply.
+
+ 
## Step 5: Publish the App
@@ -149,6 +157,8 @@ By connecting a Lark channel to your LobeHub agent, team members can interact wi
### Submit for Review
Submit the version for review and publish. For enterprise self-managed apps, approval is typically automatic.
+
+ 
## Step 6: Test the Connection
diff --git a/docs/usage/channels/lark.zh-CN.mdx b/docs/usage/channels/lark.zh-CN.mdx
index 48653f376f..5b89411b63 100644
--- a/docs/usage/channels/lark.zh-CN.mdx
+++ b/docs/usage/channels/lark.zh-CN.mdx
@@ -10,11 +10,6 @@ tags:
# 将 LobeHub 连接到 Lark
-
- 此功能目前正在开发中,可能尚未完全稳定。您可以通过在 **设置** → **高级设置** → **开发者模式**
- 中启用 **开发者模式** 来使用此功能。
-
-
通过将 Lark 渠道连接到您的 LobeHub 代理,团队成员可以直接在 Lark 的私聊和群组对话中与 AI 助手互动。
> 如果您使用的是中国版(飞书),请参阅[飞书设置指南](/docs/usage/channels/feishu)。
@@ -35,6 +30,8 @@ tags:
点击 **Create Enterprise App**。填写应用名称(例如 "LobeHub Assistant")、描述和图标,然后提交表单。
+ 
+
### 复制应用凭证
进入 **Credentials & Basic Info**,复制以下内容:
@@ -43,6 +40,8 @@ tags:
- **App Secret**
> **重要提示:** 请妥善保管您的 App Secret。切勿公开分享。
+
+ 
## 第二步:配置应用权限和机器人功能
@@ -80,6 +79,8 @@ tags:
以上权限码已针对 Lark(国际版)进行调整。部分飞书特有的权限码(如 `aily:*`、`corehr:*`、`im:chat.access_event.bot_p2p_chat:read`)在 Lark 上不可用,已被排除。
+ 
+
### 启用机器人功能
进入 **App Capability** → **Bot**。开启机器人功能并设置您喜欢的机器人名称。
@@ -104,6 +105,8 @@ tags:
### 保存并复制 Webhook URL
点击 **Save Configuration**。保存后,将显示一个 **Event Subscription URL**。复制此 URL —— 您将在下一步中需要它。
+
+ 
## 第四步:在 Lark 中设置事件订阅
@@ -125,6 +128,8 @@ tags:
这将使您的应用能够接收消息并将其转发到 LobeHub。
+ 
+
### (推荐)填写 Verification Token 和 Encrypt Key
配置事件订阅后,您可以在事件订阅页面顶部的 **Encryption Strategy** 中找到 **Verification Token** 和 **Encrypt Key**。
@@ -135,6 +140,8 @@ tags:
- **Encrypt Key**(可选)— 用于解密加密事件负载
再次点击 **Save Configuration** 以应用。
+
+ 
## 第五步:发布应用
@@ -147,6 +154,8 @@ tags:
### 提交审核
提交版本进行审核并发布。对于企业自管理应用,通常会自动批准。
+
+ 
## 第六步:测试连接
diff --git a/docs/usage/channels/overview.mdx b/docs/usage/channels/overview.mdx
index 635dbe666f..2c38d4ec59 100644
--- a/docs/usage/channels/overview.mdx
+++ b/docs/usage/channels/overview.mdx
@@ -19,10 +19,6 @@ tags:
# Channels
-
- This feature is currently in development and may not be fully stable. You can enable it by turning on **Developer Mode** in **Settings** → **Advanced Settings** → **Developer Mode**.
-
-
Channels allow you to connect your LobeHub agents to external messaging platforms. Once connected, users can interact with your AI assistant directly in the chat apps they already use — no need to visit LobeHub.
## Supported Platforms
@@ -47,9 +43,8 @@ Each channel integration works by linking a bot account on the target platform t
## Getting Started
-1. Enable **Developer Mode** in LobeHub: **Settings** → **Advanced Settings** → **Developer Mode**
-2. Navigate to your agent's settings and select the **Channels** tab
-3. Choose a platform and follow the setup guide:
+1. Navigate to your agent's settings and select the **Channels** tab
+2. Choose a platform and follow the setup guide:
- [Discord](/docs/usage/channels/discord)
- [Slack](/docs/usage/channels/slack)
- [Telegram](/docs/usage/channels/telegram)
diff --git a/docs/usage/channels/overview.zh-CN.mdx b/docs/usage/channels/overview.zh-CN.mdx
index d3061ae829..dc0843a653 100644
--- a/docs/usage/channels/overview.zh-CN.mdx
+++ b/docs/usage/channels/overview.zh-CN.mdx
@@ -18,10 +18,6 @@ tags:
# 渠道
-
- 此功能目前正在开发中,可能尚未完全稳定。您可以通过在 **设置** → **高级设置** → **开发者模式** 中启用 **开发者模式** 来开启此功能。
-
-
渠道功能允许您将 LobeHub 代理连接到外部消息平台。一旦连接,用户可以直接在他们已经使用的聊天应用中与您的 AI 助手互动,无需访问 LobeHub。
## 支持的平台
@@ -46,9 +42,8 @@ tags:
## 快速开始
-1. 在 LobeHub 中启用 **开发者模式**:**设置** → **高级设置** → **开发者模式**
-2. 前往您的代理设置页面,选择 **渠道** 标签
-3. 选择一个平台并按照设置指南操作:
+1. 前往您的代理设置页面,选择 **渠道** 标签
+2. 选择一个平台并按照设置指南操作:
- [Discord](/docs/usage/channels/discord)
- [Slack](/docs/usage/channels/slack)
- [Telegram](/docs/usage/channels/telegram)
diff --git a/docs/usage/channels/qq.mdx b/docs/usage/channels/qq.mdx
index b50b78f654..fe6765122c 100644
--- a/docs/usage/channels/qq.mdx
+++ b/docs/usage/channels/qq.mdx
@@ -13,11 +13,6 @@ tags:
# Connect LobeHub to QQ
-
- This feature is currently in development and may not be fully stable. You can enable it by turning
- on **Developer Mode** in **Settings** → **Advanced Settings** → **Developer Mode**.
-
-
By connecting a QQ channel to your LobeHub agent, users can interact with the AI assistant through QQ group chats, guild channels, and direct messages.
## Prerequisites
@@ -45,6 +40,8 @@ By connecting a QQ channel to your LobeHub agent, users can interact with the AI
> **Important:** Keep your App Secret confidential. Never share it publicly.
+ 
+
### Configure Webhook URL
In the QQ Open Platform, navigate to **Development Settings** → **Callback Configuration**. You will need to paste the LobeHub Callback URL here after completing Step 2.
@@ -69,6 +66,8 @@ By connecting a QQ channel to your LobeHub agent, users can interact with the AI
Click **Save Configuration**. After saving, a **Callback URL** will be displayed. Copy this URL.
Your credentials will be encrypted and stored securely.
+
+ 
## Step 3: Configure Callback in QQ Open Platform
@@ -87,6 +86,8 @@ By connecting a QQ channel to your LobeHub agent, users can interact with the AI
- `AT_MESSAGE_CREATE` — Triggered when the bot is @mentioned in a guild channel
- `DIRECT_MESSAGE_CREATE` — Triggered for direct messages in a guild
+ 
+
### Verify the Callback
The QQ Open Platform will send a verification request to your Callback URL. LobeHub handles this automatically using Ed25519 signature verification.
@@ -102,6 +103,8 @@ By connecting a QQ channel to your LobeHub agent, users can interact with the AI
### Wait for Approval
QQ will review your bot. Once approved, the bot will be published and ready to use. For sandbox testing, you can add test users directly without publishing.
+
+ 
## Step 5: Test the Connection
diff --git a/docs/usage/channels/qq.zh-CN.mdx b/docs/usage/channels/qq.zh-CN.mdx
index 5393b44f36..67bc472511 100644
--- a/docs/usage/channels/qq.zh-CN.mdx
+++ b/docs/usage/channels/qq.zh-CN.mdx
@@ -10,11 +10,6 @@ tags:
# 将 LobeHub 连接到 QQ
-
- 此功能目前正在开发中,可能尚未完全稳定。您可以通过在 **设置** → **高级设置** → **开发者模式**
- 中启用 **开发者模式** 来使用此功能。
-
-
通过将 QQ 渠道连接到您的 LobeHub 代理,用户可以通过 QQ 群聊、频道和私聊与 AI 助手互动。
## 前置条件
@@ -42,6 +37,8 @@ tags:
> **重要提示:** 请妥善保管您的 App Secret,切勿公开分享。
+ 
+
### 配置回调地址
在 QQ 开放平台中,导航到 **开发设置** → **回调配置**。您需要在完成第二步后将 LobeHub 的回调地址粘贴到此处。
@@ -66,6 +63,8 @@ tags:
点击 **保存配置**。保存后,将显示一个 **回调地址(Callback URL)**。复制此地址。
您的凭证将被加密并安全存储。
+
+ 
## 第三步:在 QQ 开放平台配置回调
@@ -84,6 +83,8 @@ tags:
- `AT_MESSAGE_CREATE` — 在频道中被 @提及时触发
- `DIRECT_MESSAGE_CREATE` — 频道私信时触发
+ 
+
### 验证回调
QQ 开放平台将向您的回调地址发送验证请求。LobeHub 会通过 Ed25519 签名验证自动处理此请求。
@@ -99,6 +100,8 @@ tags:
### 等待审核通过
QQ 会对您的机器人进行审核。审核通过后,机器人将发布并可投入使用。在沙盒测试阶段,您可以直接添加测试用户而无需发布。
+
+ 
## 第五步:测试连接
diff --git a/docs/usage/channels/slack.mdx b/docs/usage/channels/slack.mdx
index 6ae70b8c75..927810bcd6 100644
--- a/docs/usage/channels/slack.mdx
+++ b/docs/usage/channels/slack.mdx
@@ -13,11 +13,6 @@ tags:
# Connect LobeHub to Slack
-
- This feature is currently in development and may not be fully stable. You can enable it by turning
- on **Developer Mode** in **Settings** → **Advanced Settings** → **Developer Mode**.
-
-
By connecting a Slack channel to your LobeHub agent, users can interact with the AI assistant directly through Slack channels and direct messages.
## Prerequisites
@@ -39,6 +34,8 @@ By connecting a Slack channel to your LobeHub agent, users can interact with the
- **App ID** — displayed at the top of the page
- **Signing Secret** — under the **App Credentials** section
+ 
+
### Add Bot Token Scopes
In the left sidebar, go to **OAuth & Permissions**. Scroll down to **Scopes** → **Bot Token Scopes** and add the following:
@@ -66,6 +63,8 @@ By connecting a Slack channel to your LobeHub agent, users can interact with the
Still on the **OAuth & Permissions** page, click **Install to Workspace** and authorize the app. After installation, copy the **Bot User OAuth Token** (starts with `xoxb-`).
> **Important:** Treat your bot token like a password. Never share it publicly or commit it to version control.
+
+ 
## Step 2: Configure Slack in LobeHub
@@ -92,6 +91,8 @@ By connecting a Slack channel to your LobeHub agent, users can interact with the
### Copy the Webhook URL
Copy the displayed Webhook URL — you will need it in the next step to configure Slack's Event Subscriptions.
+
+ 
## Step 3: Configure Event Subscriptions
@@ -124,6 +125,8 @@ By connecting a Slack channel to your LobeHub agent, users can interact with the
### Save Changes
Click **Save Changes** at the bottom of the page.
+
+ 
## Step 4: Test the Connection
diff --git a/docs/usage/channels/slack.zh-CN.mdx b/docs/usage/channels/slack.zh-CN.mdx
index 7a82be258d..7042ef1ff7 100644
--- a/docs/usage/channels/slack.zh-CN.mdx
+++ b/docs/usage/channels/slack.zh-CN.mdx
@@ -10,10 +10,6 @@ tags:
# 将 LobeHub 连接到 Slack
-
- 此功能目前正在开发中,可能尚未完全稳定。您可以通过在 **设置** → **高级设置** → **开发者模式** 中启用 **开发者模式** 来使用此功能。
-
-
通过将 Slack 渠道连接到您的 LobeHub 代理,用户可以直接通过 Slack 频道和私信与 AI 助手互动。
## 前置条件
@@ -35,6 +31,8 @@ tags:
- **App ID** — 显示在页面顶部
- **Signing Secret** — 在 **App Credentials** 部分下
+ 
+
### 添加 Bot Token 权限范围
在左侧菜单中,进入 **OAuth & Permissions**。向下滚动到 **Scopes** → **Bot Token Scopes**,添加以下权限:
@@ -62,6 +60,8 @@ tags:
仍然在 **OAuth & Permissions** 页面,点击 **Install to Workspace** 并授权应用。安装完成后,复制 **Bot User OAuth Token**(以 `xoxb-` 开头)。
> **重要提示:** 请将您的 Bot Token 视为密码。切勿公开分享或提交到版本控制系统。
+
+ 
## 第二步:在 LobeHub 中配置 Slack
@@ -88,6 +88,8 @@ tags:
### 复制 Webhook URL
复制显示的 Webhook URL —— 您将在下一步中使用它来配置 Slack 的事件订阅。
+
+ 
## 第三步:配置事件订阅
@@ -120,6 +122,8 @@ tags:
### 保存更改
点击页面底部的 **Save Changes**。
+
+ 
## 第四步:测试连接
diff --git a/docs/usage/channels/telegram.mdx b/docs/usage/channels/telegram.mdx
index bf8ba622a6..ea3f59c1de 100644
--- a/docs/usage/channels/telegram.mdx
+++ b/docs/usage/channels/telegram.mdx
@@ -13,11 +13,6 @@ tags:
# Connect LobeHub to Telegram
-
- This feature is currently in development and may not be fully stable. You can enable it by turning
- on **Developer Mode** in **Settings** → **Advanced Settings** → **Developer Mode**.
-
-
By connecting a Telegram channel to your LobeHub agent, users can interact with the AI assistant through Telegram private chats and group conversations.
## Prerequisites
@@ -32,6 +27,8 @@ By connecting a Telegram channel to your LobeHub agent, users can interact with
Open Telegram and search for **@BotFather** — the official Telegram bot for managing bots. Start a conversation and send the `/newbot` command.
+ 
+
### Set Bot Name and Username
BotFather will ask you to:
@@ -39,10 +36,14 @@ By connecting a Telegram channel to your LobeHub agent, users can interact with
1. Choose a **display name** for your bot (e.g., "LobeHub Assistant")
2. Choose a **username** — it must end with `bot` (e.g., `lobehub_assistant_bot`)
+ 
+
### Copy the Bot Token
After creating the bot, BotFather will send you an **API token** (format: `123456789:ABCdefGhIjKlmNoPQRsTuVwXyZ`). Copy and save this token.
+ 
+
> **Important:** Your bot token is a secret credential. Never share it publicly.
@@ -59,6 +60,8 @@ By connecting a Telegram channel to your LobeHub agent, users can interact with
The **Bot User ID** will be automatically derived from your token — no need to enter it manually.
+ 
+
### Optional: Set a Webhook Secret
You can optionally enter a **Webhook Secret Token** for additional security. This is used to verify that incoming webhook requests originate from Telegram.
@@ -74,6 +77,8 @@ By connecting a Telegram channel to your LobeHub agent, users can interact with
Click **Test Connection** in LobeHub's channel settings to verify the integration. Then open Telegram, find your bot by searching its username, and send a message. The bot should respond through your LobeHub agent.
+
+
## Adding the Bot to Group Chats
To use the bot in Telegram groups:
@@ -82,6 +87,8 @@ To use the bot in Telegram groups:
2. By default, the bot responds when mentioned with `@your_bot_username`
3. Send a message mentioning the bot to start interacting
+
+
**About Group Privacy Mode:** Telegram bots have privacy mode enabled by default, which means they only receive messages that @mention the bot, reply to the bot, or contain /commands. If you change the privacy mode setting after creating the bot, you **must remove and re-add the bot to the group** for the new setting to take effect in that group.
diff --git a/docs/usage/channels/telegram.zh-CN.mdx b/docs/usage/channels/telegram.zh-CN.mdx
index 2eb6dfef72..4dab159adc 100644
--- a/docs/usage/channels/telegram.zh-CN.mdx
+++ b/docs/usage/channels/telegram.zh-CN.mdx
@@ -12,10 +12,6 @@ tags:
# 将 LobeHub 连接到 Telegram
-
- 此功能目前正在开发中,可能尚未完全稳定。您可以通过在 **设置** → **高级设置** → **开发者模式** 中启用 **开发者模式** 来使用此功能。
-
-
通过将 Telegram 渠道连接到您的 LobeHub 代理,用户可以通过 Telegram 私聊和群组对话与 AI 助手互动。
## 前置条件
@@ -30,6 +26,8 @@ tags:
打开 Telegram 并搜索 **@BotFather** —— 这是用于管理机器人的官方 Telegram 机器人。开始对话并发送 `/newbot` 命令。
+ 
+
### 设置机器人名称和用户名
BotFather 会要求您:
@@ -37,10 +35,14 @@ tags:
1. 为您的机器人选择一个 **显示名称**(例如,“LobeHub 助手”)
2. 选择一个 **用户名** —— 必须以 `bot` 结尾(例如,`lobehub_assistant_bot`)
+ 
+
### 复制机器人令牌
创建机器人后,BotFather 会发送给您一个 **API 令牌**(格式:`123456789:ABCdefGhIjKlmNoPQRsTuVwXyZ`)。复制并保存此令牌。
+ 
+
> **重要提示:** 您的机器人令牌是一个机密凭证,请勿公开分享。
@@ -57,6 +59,8 @@ tags:
**机器人用户 ID** 将根据您的令牌自动生成,无需手动输入。
+ 
+
### 可选:设置 Webhook 密钥
您可以选择输入一个 **Webhook 密钥令牌** 以增加安全性。此密钥用于验证来自 Telegram 的入站 Webhook 请求。
@@ -72,6 +76,8 @@ tags:
在 LobeHub 的渠道设置中点击 **测试连接** 以验证集成。然后打开 Telegram,搜索您的机器人用户名并发送消息。机器人应通过您的 LobeHub 代理进行响应。
+
+
## 将机器人添加到群组聊天
要在 Telegram 群组中使用机器人:
@@ -80,6 +86,8 @@ tags:
2. 默认情况下,机器人在被 `@your_bot_username` 提及时会响应
3. 发送一条提及机器人的消息以开始互动
+
+
**关于隐私模式(Group Privacy):** Telegram 机器人默认启用隐私模式,仅接收群组中 @提及、回复机器人的消息以及 / 命令。如果您在创建机器人后更改了隐私模式设置,**必须将机器人从群组中移除后重新加入**,新的设置才会对该群组生效。
diff --git a/docs/usage/channels/wechat.mdx b/docs/usage/channels/wechat.mdx
index ecc700400d..01c95bc7cd 100644
--- a/docs/usage/channels/wechat.mdx
+++ b/docs/usage/channels/wechat.mdx
@@ -13,11 +13,6 @@ tags:
# Connect LobeHub to WeChat
-
- This feature is currently in development and may not be fully stable. You can enable it by turning
- on **Developer Mode** in **Settings** → **Advanced Settings** → **Developer Mode**.
-
-
By connecting a WeChat channel to your LobeHub agent, users can interact with the AI assistant through WeChat private chats and group conversations.
## Prerequisites
@@ -44,6 +39,8 @@ In LobeHub, navigate to your agent's settings, then select the **Channels** tab.
After scanning, a confirmation prompt will appear in WeChat. Tap **Confirm** to authorize the connection.
+ 
+
### Connection Complete
Once confirmed, LobeHub will automatically save your credentials and connect the bot. You should see a success message in the channel settings.
diff --git a/docs/usage/channels/wechat.zh-CN.mdx b/docs/usage/channels/wechat.zh-CN.mdx
index a385012727..1a0345ebe4 100644
--- a/docs/usage/channels/wechat.zh-CN.mdx
+++ b/docs/usage/channels/wechat.zh-CN.mdx
@@ -10,11 +10,6 @@ tags:
# 将 LobeHub 连接到微信
-
- 此功能目前正在开发中,可能尚未完全稳定。您可以通过在 **设置** → **高级设置** → **开发者模式**
- 中启用 **开发者模式** 来使用此功能。
-
-
通过将微信渠道连接到您的 LobeHub 代理,用户可以通过微信私聊和群聊与 AI 助手互动。
## 前置条件
@@ -41,6 +36,8 @@ tags:
扫码后,微信中会出现确认提示。点击 **确认** 授权连接。
+ 
+
### 连接完成
确认后,LobeHub 将自动保存凭证并连接机器人。您应该会在渠道设置中看到成功消息。