cloudbase-document-database-in-wechat-miniprogram skill
✓ Doğrulandıwx.cloud.database SDK kullanarak WeChat Mini Programları içerisinde CRUD işlemleri, karmaşık sorgular, sayfalama, toplama (aggregation) ve coğrafi konum sorguları gerçekleştirin.
- GitHub yıldızları
- 1.164
- Dosyalar
- 8
- Son commit
- 11 Kas 2026
- Lisans
- MIT
- İzin verilen araçlar
- —
cloudbase-document-database-in-wechat-miniprogram skill ne işe yarar?
wx.cloud.database SDK kullanarak WeChat Mini Programları içerisinde CRUD işlemleri, karmaşık sorgular, sayfalama, toplama (aggregation) ve coğrafi konum sorguları gerçekleştirin.
Özet, skill'in SKILL.md dosyasından oluşturuldu.
cloudbase-document-database-in-wechat-miniprogram skilli hakkında
Veri yönetimi, bu SKILL'in temel işlevidir. Geliştiricilerin wx.cloud.database() SDK aracılığıyla doğrudan doküman veritabanı işlemleri yapmasına olanak tanır. Bir agent, Mini Program koleksiyon CRUD, sayfalama, toplama veya coğrafi konum sorguları içeren bir görevle karşılaştığında bu aracı yüklemelidir. Mini Program ortamı için özel olarak tasarlanmış istemci tarafı kodları üreterek veritabanı çağrılarının yerel framework ile uyumlu olmasını sağlar.
Bu SKILL, Web SDK veya sunucu tarafı cloud function'lar yerine yalnızca Mini Program tarafındaki SDK'ya odaklandığı için farklılık gösterir. CloudBase bağlamı üzerinden yerleşik kullanıcı kimliğini yönetir ve _openid gibi sistem tarafından yönetilen alanlara saygı duyar. Geliştiriciler, güvenlik kurallarının ve sahiplik kontrollerinin doğru çalışmasını sağlamak için Mini Program sayfaları veya bileşenleri içinde çalışırken bunu kullanmalıdır. MySQL, ilişkisel veritabanı işlemleri veya tarayıcı tabanlı @cloudbase/js-sdk uygulamaları için tasarlanmamıştır.
Bir agent bununla neler yapabilir
- 1Koleksiyon CRUD işlemleri gerçekleştirinBir WeChat Mini Program koleksiyonu içindeki dokümanları oluşturmak, okumak, güncellemek veya silmek için kod yazın.
- 2Veri sayfalama uygulayınSayfalama kullanarak veritabanı sonuçlarını daha küçük ve yönetilebilir parçalar halinde getirecek mantıklar geliştirin.
- 3Karmaşık coğrafi konum sorguları yürütünCoğrafi konum verilerine dayalı olarak verileri filtreleyen veya getiren sorgular oluşturun.
Skill'in SKILL.md dosyasından yazılmıştır. Her kullanım durumu oradaki bir alıntı ile kontrol edilir.
cloudbase-document-database-in-wechat-miniprogram skill nasıl kurulur
Her komut, skill klasörünü istemcinin skills dizinine kopyalar. Yüklemek için istemciyi yeniden başlatın veya yeni bir oturum başlatın.cloudbase-document-database-in-wechat-miniprogram skill'ini Claude Code uygulamasına kur
~/.claude/skills/cloudbase-document-database-in-wechat-miniprogram/SKILL.md
$ npx degit TencentCloudBase/CloudBase-AI-Toolkit/config/.claude/skills/cloudbase-document-database-in-wechat-miniprogram ~/.claude/skills/cloudbase-document-database-in-wechat-miniprogramcloudbase-document-database-in-wechat-miniprogram skill'ini Claude Code (project) uygulamasına kur
.claude/skills/cloudbase-document-database-in-wechat-miniprogram/SKILL.md
$ npx degit TencentCloudBase/CloudBase-AI-Toolkit/config/.claude/skills/cloudbase-document-database-in-wechat-miniprogram .claude/skills/cloudbase-document-database-in-wechat-miniprogramcloudbase-document-database-in-wechat-miniprogram skill'ini Codex uygulamasına kur
~/.agents/skills/cloudbase-document-database-in-wechat-miniprogram/SKILL.md
$ npx degit TencentCloudBase/CloudBase-AI-Toolkit/config/.claude/skills/cloudbase-document-database-in-wechat-miniprogram ~/.agents/skills/cloudbase-document-database-in-wechat-miniprogramcloudbase-document-database-in-wechat-miniprogram skill'ini Gemini CLI uygulamasına kur
~/.gemini/skills/cloudbase-document-database-in-wechat-miniprogram/SKILL.md
$ npx degit TencentCloudBase/CloudBase-AI-Toolkit/config/.claude/skills/cloudbase-document-database-in-wechat-miniprogram ~/.gemini/skills/cloudbase-document-database-in-wechat-miniprogramcloudbase-document-database-in-wechat-miniprogram skill'ini Claude.ai uygulamasına kur
npx degit TencentCloudBase/CloudBase-AI-Toolkit/config/.claude/skills/cloudbase-document-database-in-wechat-miniprogram cloudbase-document-database-in-wechat-miniprogram && zip -r cloudbase-document-database-in-wechat-miniprogram.zip cloudbase-document-database-in-wechat-miniprogram # claude.ai → Customize → Skills → + → Create skill → Upload a skill → cloudbase-document-database-in-wechat-miniprogram.zip
Otomatik kontroller
Çalıştırıldı 15 Kas 2026Tam rapor →Otomatik kontrollerimizi geçti. Bu bir güvenlik denetimi değil: bir ajanın çalıştırmasına izin vermeden önce betikleri okuyun. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirtencentcloudbase/cloudbase-ai-toolkit/config/.claude/skills/cloudbase-document-database-in-wechat-miniprogram is public and reachablegithub.com/tencentcloudbase/cloudbase-ai-toolkit/tree/HEAD/c ↗Geçti
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit 2026-11-11github.com/tencentcloudbase/cloudbase-ai-toolkit/commits ↗Geçti
- Betiklerde indir-çalıştır veya kimlik bilgisi hırsızlığı yokNo scripts in the skill folderGeçti
- SKILL.md içinde gizli talimat yokNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/tencentcloudbase/cloudbase-ai-toolkit/blob/HEAD/c ↗Geçti
- Önceden izin verilen araçlar sınırlıNo pre-approved tools; the agent asks before using onegithub.com/tencentcloudbase/cloudbase-ai-toolkit/blob/HEAD/c ↗Geçti
- SKILL.md, Agent Skills biçimine uyuyorthe description does not say when to use the skillgithub.com/tencentcloudbase/cloudbase-ai-toolkit/blob/HEAD/c ↗Bulgu
SKILL.md
GitHub'da görüntüleSibling skills (local only)
Sibling CloudBase skills ship beside this skill. Use local relative paths such as ../auth-tool-cloudbase/SKILL.md.
If a referenced sibling skill file is missing from this environment, ask the user to install the full CloudBase plugin (or the missing skill). Do not HTTP-fetch remote skill or protocol markdown into the agent context.
CloudBase Document Database WeChat Mini Program SDK
Activation Contract
Use this first when
- A WeChat Mini Program must access CloudBase document database through
wx.cloud.database(). - The request mentions Mini Program collection CRUD, pagination, aggregation, or geolocation queries.
- Moving that Mini Program app's data onto CloudBase PG while keeping
wx.cloud.database()is pgdoc — read../postgresql-development-cloudbase/references/pgdoc.mdbefore changing any SDK call. CUSTOM security rules do not apply after pgdoc takes over.
Read before writing code if
- The task is Mini Program database work but you still need to separate it from Web SDK, cloud functions, or SQL tasks.
- The request depends on built-in user identity,
_openid, or Mini Program-side permissions.
Then also read
- Mini Program project rules and CloudBase integration ->
../miniprogram-development/SKILL.md - Mini Program auth and identity flow ->
../auth-wechat-miniprogram/SKILL.md - Browser-side document database code ->
../cloudbase-document-database-web-sdk/SKILL.md
Do NOT use for
- Browser/Web code using
@cloudbase/js-sdk. - Server-side or cloud-function database access.
- MySQL / relational database work.
Common mistakes / gotchas
- Copying Web SDK code into Mini Program pages.
- Manually writing
_openidduring create or update operations. - Assuming built-in Mini Program identity means security rules can be ignored.
- Mixing collection CRUD and backend-wide admin workflows in the same client path.
Minimal checklist
- Confirm the caller is a Mini Program page/component or Mini Program-side logic.
- Initialize
wx.cloudcorrectly before database calls. - Verify whether the collection rules rely on
auth.openid/_openid. - Read the specific companion reference file for the operation you need.
Overview
This skill covers Mini Program-side document database access through wx.cloud.database().
Use it for:
- collection CRUD in Mini Program pages
- query composition and pagination
- aggregation
- geolocation queries
Mini Program CloudBase access comes with built-in identity, but database operations are still constrained by collection permissions and security rules.
Canonical initialization
const db = wx.cloud.database();
const _ = db.command;
To target a specific environment:
const db = wx.cloud.database({
env: "test"
});
Important notes:
- Users are authenticated through the Mini Program CloudBase context.
- In cloud functions, caller identity is available through
wxContext.OPENID. - In client-side collection rules, ownership checks usually use
auth.openid/doc._openid.
Quick routing
- CRUD ->
./crud-operations.md - Complex queries ->
./complex-queries.md - Pagination ->
./pagination.md - Aggregation ->
./aggregation.md - Geolocation ->
./geolocation.md - Security rules ->
./security-rules.md
Working rules for a coding agent
-
Keep Mini Program code Mini Program-native
- Use
wx.cloud.database(). - Do not substitute browser SDK initialization patterns.
- Use
-
Respect ownership fields
_openidis system-managed for SDK writes.- Never set or override
_openidmanually in.add(),.set(), or.update()payloads.
-
Remember that security rules validate requests
- If a rule requires ownership conditions, the query shape must match that rule model.
- Permission errors usually mean the rule/query relationship is wrong, not only that the user is logged out.
-
Route admin-style operations to backend flows
- If the task needs privileged global access, use backend tools or functions instead of exposing that path directly in Mini Program client code.
Quick examples
Basic collection access
const todos = db.collection("todos");
const result = await todos.where({ completed: false }).get();
Document reference
const todo = db.collection("todos").doc("todo-id");
const result = await todo.get();
Best practices
- Create clear collection naming conventions.
- Use typed wrappers or model helpers in app code where possible.
- Design rules around real ownership and sharing patterns.
- Use pagination instead of large unbounded reads.
- Keep admin/operations logic in backend code, not Mini Program direct access.
Bu becerideki dosyalar
8cloudbase-document-database-in-wechat-miniprogram skill soruları
cloudbase-document-database-in-wechat-miniprogram skill'ini Claude Code uygulamasına nasıl kurarım?
npx degit TencentCloudBase/CloudBase-AI-Toolkit/config/.claude/skills/cloudbase-document-database-in-wechat-miniprogram ~/.claude/skills/cloudbase-document-database-in-wechat-miniprogram komutunu çalıştırın. Claude Code, skill'leri ~/.claude/skills (tüm projeler) veya .claude/skills (tek proje) konumundan yükler ve açıklaması görevle eşleştiğinde skill'i kullanır.
cloudbase-document-database-in-wechat-miniprogram skill'ini hangi istemciler kullanabilir?
Agent Skills biçimini okuyan her istemci: Claude Code, Codex, Gemini CLI ve claude.ai (ZIP olarak yükleyin). Skill içindeki betikler yalnızca istemcinin kod çalıştırmaya izin verdiği yerlerde çalışır.
WeChat Mini Program içerisinde CloudBase veritabanını nasıl başlatabilirim?
Veritabanını const db = wx.cloud.database(); komutuyla veya wx.cloud.database({ env: 'test' }); şeklinde belirli bir ortam belirterek başlatabilirsiniz.
Bir dokümanı güncellerken _openid alanını manuel olarak ayarlayabilir miyim?
Hayır, _openid alanı sistem tarafından yönetildiği için oluşturma veya güncelleme işlemleri sırasında bu alanı asla manuel olarak ayarlamamanız veya üzerine yazmamanız gerekir.
Sorgu sırasında yetki hatası alırsam ne yapmalıyım?
Yetki hataları genellikle kullanıcının oturumunun kapalı olmasından ziyade, sorgu yapınız ile koleksiyon güvenlik kuralları arasındaki ilişkinin hatalı olduğunu gösterir.