@scemoon/cdh 1.0.9 → 1.0.10-beta.1

package/ai-dlc-skill/providers/tcb/SKILL.md

@@ -1,208 +0,0 @@
----
-name: tcb
-description: |
-  Tencent CloudBase (TCB) knowledge base for AI Agents.
-  Covers: CloudBase Functions (FaaS), CloudBase Run (CaaS), DocDB, COS Storage,
-  Static Hosting, Environment Management, CLI, REST API, SDK, MCP integration.
-  Supports decision-making for architecture selection, deployment, troubleshooting.
-triggers:
-  - tcb
-  - cloudbase
-  - 腾讯云
-  - cloudbase functions
-  - serverless
-  - faas
-  - caas
-services:
-  - cloudbase-functions
-  - cloudbase-run
-  - cloudbase-database
-  - cloudbase-storage
-  - cloudbase-hosting
-compute_modes:
-  - cloudbase-functions  # FaaS
-  - cloudbase-run        # CaaS
-credentials:
-  - TENCENTCLOUD_SECRETID
-  - TENCENTCLOUD_SECRETKEY
-  - TCB_SECRET_ID
-  - TCB_SECRET_KEY
-  - TCB_ENV_ID
-compatibility:
-  cdh: ">=1.4"
-  opencode: ">=1.15"
----
-
-# Tencent CloudBase (TCB) Knowledge Base
-
-## What is TCB
-
-Tencent CloudBase (TCB) is a serverless cloud development platform providing:
-
-| Service | Type | Use Case |
-|---------|------|----------|
-| CloudBase Functions | FaaS | Event-driven serverless functions |
-| CloudBase Run | CaaS | Long-running container workloads |
-| CloudBase Database (DocDB) | NoSQL | Document storage, JSON-like queries |
-| MySQL | RDBMS | Relational data, SQL queries |
-| COS | Object Storage | Files, images, static assets |
-| CloudBase Hosting | Static Hosting | SPA, static sites, mini-program backends |
-
-## Agent Decision Tree
-
-When agent needs to interact with TCB, follow this decision tree:
-
-```
-1. What is the goal?
-   ├── Deploy/manage cloud functions → services/cloud-functions.md
-   ├── Deploy/manage containers → services/cloud-run.md
-   ├── Query/modify data → services/cloud-database.md
-   ├── Upload/download files → services/cloud-storage.md
-   ├── Deploy static website → services/cloud-hosting.md
-   ├── Manage environments → cli/env.md
-   └── Debug/deploy → best-practices/troubleshooting.md
-```
-
-## How to Interact
-
-### MCP Server (Preferred for structured operations)
-
-When `@cloudbase/cloudbase-mcp` is connected, use `MCPTool`:
-
-```
-MCPTool(server="cloudbase", tool="deploy_function", arguments={...})
-MCPTool(server="cloudbase", tool="invoke_function", arguments={...})
-MCPTool(server="cloudbase", tool="query_database", arguments={...})
-```
-
-See `integration/mcp-server.md` for complete tool reference.
-
-### CLI (Preferred for scripts and CI/CD)
-
-```
-exec_shell("tcb fn deploy --name hello --dir ./functions")
-exec_shell("tcb db query \"SELECT * FROM users\"")
-```
-
-See `cli/` directory for complete command reference.
-
-### REST API (For programmatic access)
-
-```
-POST https://tcb-api.cloud.tencent.com/mcp/v1/<endpoint>
-Headers: X-TencentCloud-SecretId, X-TencentCloud-SecretKey
-```
-
-See `api/rest-api.md` for endpoint reference.
-
-## Architecture Overview
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                        TCB Platform                         │
-├─────────────┬─────────────┬─────────────┬──────────────────┤
-│   Functions │  Cloud Run  │   Database  │     Storage      │
-│    (SCF)    │  (CaaS)     │   (DocDB)   │      (COS)       │
-├─────────────┴─────────────┴─────────────┴──────────────────┤
-│                      CloudBase Hosting                       │
-│                   (Static Site + SSR)                       │
-└─────────────────────────────────────────────────────────────┘
-                              │
-                    ┌─────────┴─────────┐
-              Environment ID (env-xxxxx)
-                    │
-     ┌──────────────┼──────────────┐
-     │              │              │
-   Backend       Web App      Mobile App
-  (Functions)   (Hosting)     (via API)
-```
-
-## Environment Model
-
-TCB uses **environment** as the fundamental deployment unit. Each environment has:
-
-- Unique `envId` (e.g., `env-8a9b6c5d`)
-- Isolated database instance
-- Isolated storage bucket
-- Isolated function namespace
-- Shared CDN/preview domain: `https://{envId}.tcb-preview.com`
-
-| Environment | Purpose | Access |
-|-------------|---------|--------|
-| `dev-{user}` | Personal dev sandbox | Per-component deploy allowed |
-| `preview` | Integration testing | Stack deploy only |
-| `staging` | Pre-production | Stack deploy only |
-| `production` | Live traffic | Stack deploy + human approval |
-
-## Credential Management
-
-See `security/authentication.md` for complete guide.
-
-| Variable | Description |
-|----------|-------------|
-| `TENCENTCLOUD_SECRETID` | Tencent Cloud root credential |
-| `TENCENTCLOUD_SECRETKEY` | Tencent Cloud root credential |
-| `TCB_SECRET_ID` | TCB-specific credential (recommended) |
-| `TCB_SECRET_KEY` | TCB-specific credential (recommended) |
-| `TCB_ENV_ID` | Target environment ID |
-
-## Quick Reference
-
-### Deploy a Cloud Function
-
-```bash
-# 1. Create function directory with cloudbaserc.json
-# 2. Deploy
-tcb fn deploy --name hello --dir ./functions --env $TCB_ENV_ID
-
-# Or use MCP
-MCPTool(server="cloudbase", tool="deploy_function", args={name: "hello", dir: "./functions"})
-```
-
-### Query Database
-
-```bash
-tcb db query "SELECT * FROM users WHERE status = 'active'" --env $TCB_ENV_ID
-```
-
-### Deploy Static Site
-
-```bash
-tcb hosting deploy --env $TCB_ENV_ID --dir ./dist
-```
-
-## File Structure
-
-```
-tcb/
-├── SKILL.md                    # This file
-├── provider.yaml               # AI-DLC provider config
-├── preview.yaml                # Preview deployment flow
-├── deployment.yaml             # Production deployment pipeline
-├── services/
-│   ├── overview.md             # Platform overview
-│   ├── cloud-functions.md      # CloudBase Functions (FaaS)
-│   ├── cloud-database.md       # DocDB + MySQL
-│   ├── cloud-storage.md        # COS object storage
-│   ├── cloud-hosting.md        # Static hosting
-│   └── cloud-run.md            # CloudBase Run (CaaS)
-├── cli/
-│   ├── setup.md                # Installation & login
-│   ├── env.md                  # Environment management
-│   ├── functions.md            # Function management (fn)
-│   ├── database.md             # Database management (db)
-│   ├── storage.md              # Storage management (storage)
-│   └── hosting.md              # Hosting management (hosting)
-├── api/
-│   ├── rest-api.md             # REST API reference
-│   └── sdk.md                  # Node.js SDK
-├── integration/
-│   ├── mcp-server.md           # MCP server integration
-│   └── ci-cd.md                # CI/CD integration
-├── security/
-│   └── authentication.md       # Auth & credentials
-└── best-practices/
-    ├── function-design.md      # Function design patterns
-    ├── database-design.md      # Database schema design
-    └── troubleshooting.md      # Common issues & solutions
-```

package/ai-dlc-skill/providers/tcb/api/rest-api.md

@@ -1,338 +0,0 @@
-# TCB REST API Reference
-
-## When to Use REST API vs CLI vs SDK
-
-**Use REST API when:**
-- Need programmatic access from external systems
-- CLI/SDK doesn't support specific operation
-- Building custom integrations
-- Debugging and testing
-
-**Use SDK when:**
-- Building applications (preferred over raw API)
-- Need type-safe access
-
-**Use CLI when:**
-- One-off operations
-- CI/CD pipelines
-- Local development
-
-## API Base URL
-
-```
-https://tcb-api.cloud.tencent.com/mcp/v1
-```
-
-Or use HTTP transport:
-```
-https://tcb-api.cloud.tencent.com/mcp/v1?env_id=<envId>
-```
-
-## Authentication
-
-### Headers
-
-```
-X-TencentCloud-SecretId: <your-secret-id>
-X-TencentCloud-SecretKey: <your-secret-key>
-```
-
-### Environment Parameter
-
-Pass `env_id` in query string or request body.
-
-## Common Endpoints
-
-### Environment
-
-#### Get Environment Info
-
-```
-GET /environments/{envId}
-```
-
-Response:
-```json
-{
-  "EnvId": "env-xxxxx",
-  "Region": "ap-shanghai",
-  "Status": "running",
-  "CreatedTime": "2024-01-01T00:00:00Z"
-}
-```
-
-#### List Environments
-
-```
-GET /environments
-```
-
-### Functions
-
-#### List Functions
-
-```
-GET /functions?envId=<envId>
-```
-
-Response:
-```json
-{
-  "Functions": [
-    {
-      "FunctionId": "cloudbaser-xxxxx",
-      "FunctionName": "hello",
-      "Runtime": "Nodejs16.13",
-      "Status": "active",
-      "ModifiedTime": "2024-01-15T10:00:00Z"
-    }
-  ],
-  "Total": 1
-}
-```
-
-#### Deploy Function
-
-```
-POST /functions/{functionName}/deploy?envId=<envId>
-```
-
-Request:
-```json
-{
-  "CodeUri": "./functions/hello",
-  "Handler": "index.main",
-  "Runtime": "Nodejs16.13",
-  "Timeout": 60,
-  "MemorySize": 256,
-  "HttpHttpTrigger": {
-    "Enable": true,
-    "Path": "/hello"
-  }
-}
-```
-
-#### Invoke Function
-
-```
-POST /functions/{functionName}/invoke?envId=<envId>
-```
-
-Request:
-```json
-{
-  "params": {}
-}
-```
-
-Response:
-```json
-{
-  "Result": {
-    "message": "Hello World"
-  },
-  "Duration": 15,
-  "MemUsage": 65536
-}
-```
-
-#### Get Function Logs
-
-```
-GET /functions/{functionName}/logs?envId=<envId>&limit=50
-```
-
-### Database
-
-#### List Collections
-
-```
-GET /databases/{envId}/collections
-```
-
-#### Query Documents
-
-```
-POST /databases/{envId}/collections/{collection}/query
-```
-
-Request:
-```json
-{
-  "query": { "status": "active" },
-  "limit": 20,
-  "offset": 0
-}
-```
-
-Response:
-```json
-{
-  "data": [
-    { "_id": "xxx", "name": "Alice", "status": "active" }
-  ],
-  "total": 100
-}
-```
-
-#### Insert Document
-
-```
-POST /databases/{envId}/collections/{collection}/insert
-```
-
-Request:
-```json
-{
-  "data": { "name": "Bob", "email": "bob@example.com" }
-}
-```
-
-#### Update Document
-
-```
-POST /databases/{envId}/collections/{collection}/update
-```
-
-Request:
-```json
-{
-  "query": { "_id": "document-id" },
-  "update": { "$set": { "status": "inactive" } }
-}
-```
-
-#### Delete Document
-
-```
-POST /databases/{envId}/collections/{collection}/delete
-```
-
-Request:
-```json
-{
-  "query": { "_id": "document-id" }
-}
-```
-
-### Storage
-
-#### Get Upload File URL
-
-```
-POST /storage/{envId}/upload
-```
-
-Request:
-```json
-{
-  "cloudPath": "/uploads/avatar.jpg",
-  "contentType": "image/jpeg"
-}
-```
-
-Response:
-```json
-{
-  "url": "https://cos.ap-shanghai.myqcloud.com/...",
-  "token": "xxx"
-}
-```
-
-#### Get Download File URL
-
-```
-POST /storage/{envId}/download
-```
-
-Request:
-```json
-{
-  "cloudPath": "/uploads/avatar.jpg"
-}
-```
-
-Response:
-```json
-{
-  "url": "https://cos.ap-shanghai.myqcloud.com/...?sign=xxx",
-  "expires": 3600
-}
-```
-
-#### Delete File
-
-```
-POST /storage/{envId}/delete
-```
-
-Request:
-```json
-{
-  "cloudPath": "/uploads/avatar.jpg"
-}
-```
-
-### Hosting
-
-#### Deploy Hosting
-
-```
-POST /hosting/{envId}/deploy
-```
-
-Request (multipart):
-```
-files: [binary content]
-path: /
-```
-
-Response:
-```json
-{
-  "files": ["index.html", "app.js"],
-  "urls": ["https://env-xxxxx.tcb-preview.com/"]
-}
-```
-
-## Error Responses
-
-All API errors follow this format:
-
-```json
-{
-  "ErrorCode": "INVALID_PARAMETER",
-  "ErrorMessage": "Function name is required",
-  "RequestId": "req-xxxxx"
-}
-```
-
-### Common Error Codes
-
-| Code | Meaning |
-|------|---------|
-| `INVALID_PARAMETER` | Missing or invalid parameter |
-| `AUTH_FAILURE` | Authentication failed |
-| `RESOURCE_NOT_FOUND` | Resource doesn't exist |
-| `RESOURCE_EXIST` | Resource already exists |
-| `LIMIT_EXCEEDED` | Quota exceeded |
-| `INTERNAL_ERROR` | Server error |
-
-## Rate Limits
-
-| API | Limit |
-|-----|-------|
-| Function invoke | 1000/min |
-| Database query | 500/min |
-| Storage operations | 200/min |
-| Other APIs | 100/min |
-
-## Best Practices
-
-1. **Use SDK when possible** - Easier than raw API
-2. **Implement retry logic** - Handle transient errors
-3. **Use pagination** - Don't fetch all data at once
-4. **Cache responses** - When data doesn't change frequently
-5. **Use appropriate timeout** - Some operations take longer
-
-For SDK reference → `sdk.md`