41 lines
1.7 KiB
Markdown
41 lines
1.7 KiB
Markdown
# inkreach-teable-cli
|
||
|
||
inkreach-teable 实例的运维 CLI（npm 包 `@inkreach/inkreach-teable`）与
|
||
**全部 Agent Skills 的唯一维护仓库**。
|
||
|
||
## Skills（本仓库 `skills/` 目录 = single source of truth）
|
||
|
||
| Skill | 用途 |
|
||
|---|---|
|
||
| `inkreach-teable` | 操作已部署实例：表格/字段/记录/视图/自动化日常运维、REST API 参考 |
|
||
| `inkreach-teable-plugin` | 开发动态 React 组件插件：IIFE bundle（webpack/vite 双模板）、多资产上传（chunk + sourcemap）、`teable-plugin dev` 热更新闭环、5 个挂载位（含整页 route） |
|
||
|
||
**维护规则**：所有 skill 只在本仓库修改；主仓库（inkreach-teable）不含任何
|
||
skill 源文件。改完后同步到安装位置（`~/.zcode/skills/` 为主，
|
||
`~/.agents/skills/` 为镜像）：
|
||
|
||
```bash
|
||
cp -r skills/<name>/SKILL.md skills/<name>/metadata.json skills/<name>/dynamic-plugins ~/.zcode/skills/<name>/
|
||
cp -r skills/<name>/ ~/.agents/skills/<name>/ # 按需镜像
|
||
```
|
||
|
||
## 安装（任意机器 / 任意会话的 Agent）
|
||
|
||
把下面这段引导词发给 Agent 即可完成安装并开始使用：
|
||
|
||
```text
|
||
请安装并用 inkreach-teable CLI 操作 inkreach-teable：
|
||
1. 安装 cli：
|
||
npm i -g @inkreach/inkreach-teable
|
||
2. 安装技能：
|
||
npx -y skills add https://gitea.inkreach.cc/inkreachhub/inkreach-teable-cli.git -g -y --copy
|
||
3. 鉴权（PAT 从 Web UI Settings → Personal Access Tokens 获取）：
|
||
inkreach-teable auth login --endpoint https://table.inkreach.cc --token <PAT> --base-id bseXXX
|
||
```
|
||
|
||
## 目录结构
|
||
|
||
- `skills/` — Agent Skills（本仓库的核心资产之一）
|
||
- `src/` — CLI 源码（commander 实现）
|
||
- `docs/cli-skill-design.md` — CLI + Skill 的设计文档
|