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:
yeuimu
2026-09-23 05:54:15 +00:00
parent 65437e59d4
commit d81d14bd52
4 changed files with 10 additions and 23 deletions
@@ -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