docs(skill): 去除全部 localhost:3003 —— 一律使用公网地址 table.inkreach.cc
skill 面向公开分发,不应包含部署机内网地址。SKILL.md / cli-reference / rest-api / instance-access 共 10 处替换;rest-api 双源表与 ssh 隧道 兜底整段删除(前端 rewrite 已让域名全功能可用)。
This commit is contained in:
@@ -11,15 +11,8 @@ the CLI. For one-off table/automation operations, prefer the CLI.
|
||||
|
||||
## 1. Base URL & Authentication
|
||||
|
||||
Two origins — pick by where you run:
|
||||
|
||||
| Origin | API (`/api/*`) | Swagger (`/docs`, `/docs-json`) |
|
||||
|---|---|---|
|
||||
| Public domain, e.g. `https://table.inkreach.cc` | ✅ works (proxied to backend) | ✅ works (frontend rewrite, since 2026-09-23) |
|
||||
| Backend origin, e.g. `http://localhost:3003` (reference deployment) | ✅ | ✅ |
|
||||
|
||||
```bash
|
||||
BASE=https://table.inkreach.cc # or http://localhost:3003 on the backend host
|
||||
BASE=https://table.inkreach.cc
|
||||
TOKEN=teable_xxx_yyy # PAT; web UI Settings → Personal Access Tokens
|
||||
curl -s "$BASE/api/auth/user" -H "Authorization: Bearer $TOKEN" # verify → 200 + user JSON
|
||||
```
|
||||
@@ -99,7 +92,7 @@ MUST be the `search[]` tuple form, plain `search=` is ignored), `skip` / `take`
|
||||
## 3. Canonical Examples
|
||||
|
||||
```bash
|
||||
BASE=http://localhost:3003; AUTH="Authorization: Bearer $TOKEN"
|
||||
BASE=https://table.inkreach.cc; AUTH="Authorization: Bearer $TOKEN"
|
||||
|
||||
# create records (single + bulk). typecast: accepts strings for non-text
|
||||
# fields; fieldKeyType 'id' = keys are fld ids ('name' = field names)
|
||||
@@ -165,16 +158,10 @@ const res = await fetch(triggerInput._apiBaseUrl + "/api/table/tblB/record", {
|
||||
|
||||
The backend exposes **~362 paths**; this guide documents the
|
||||
agent-operational core (what the CLI wraps). The authoritative full spec is
|
||||
the live OpenAPI JSON — served on the backend origin, and on the public
|
||||
domain via the frontend rewrite (`/docs`, `/docs-json`; verified 2026-09-23):
|
||||
the live OpenAPI JSON at `$BASE/docs-json` (browsable UI: `$BASE/docs`):
|
||||
|
||||
```bash
|
||||
curl -s "$BASE/docs-json" | python3 -c "import json,sys; [print(m.upper(), p) for p,o in json.load(sys.stdin)['paths'].items() for m in o]"
|
||||
# browsable UI: $BASE/docs
|
||||
|
||||
# deployments WITHOUT that rewrite: docs-json only exists on the backend
|
||||
# origin — reach it via an ssh tunnel from other machines:
|
||||
ssh -L 3003:localhost:3003 <backend-host> # then use http://localhost:3003/docs-json
|
||||
```
|
||||
|
||||
### ⚠️ Swagger is a curated registry, NOT an auto-scan (audited 2026-09-23)
|
||||
@@ -219,7 +206,7 @@ automation webhook route), plugin UI endpoints (`/api/plugin/*` panels,
|
||||
chart, proxy), `/api/v2/integrity`, `/api/v1/ai-proxy`.
|
||||
|
||||
When you use one of these, verify the exact param shape before calling —
|
||||
from docs-json (backend origin / domain / ssh tunnel), or from the backend
|
||||
from docs-json, or from the backend
|
||||
source:
|
||||
`grep -rh "@Controller(\|@Get(\|@Post(\|@Patch(\|@Put(\|@Delete(" apps/nestjs-backend/src/features --include='*.controller.ts'`
|
||||
in the inkreach-teable app repo. Do not guess key names (the automation
|
||||
|
||||
Reference in New Issue
Block a user