{"_id":"@acring/feishu-bitable-cli","_rev":"5-0b13d7eb86972d29c956eb3c63fbfdb1","name":"@acring/feishu-bitable-cli","dist-tags":{"latest":"1.0.4"},"versions":{"1.0.0":{"name":"@acring/feishu-bitable-cli","version":"1.0.0","author":"","license":"ISC","_id":"@acring/feishu-bitable-cli@1.0.0","maintainers":[{"name":"acring","email":"392398434@qq.com"}],"bin":{"feishu-bitable":"dist/bin/cli.js"},"dist":{"shasum":"c7294eeec4f9e614c6beec719d96b553c15ff931","tarball":"https://registry.npmjs.org/@acring/feishu-bitable-cli/-/feishu-bitable-cli-1.0.0.tgz","fileCount":8,"integrity":"sha512-W2oFZ7lNTqM0une3+uBtbF72OEyT/tQ1Ymf/g9pAT9JleT7XeXq4j5Yv5o8wM/lG0FG/BFkIZh9yf2VWWAxLxg==","signatures":[{"sig":"MEQCIDgveH/8OZcAIRQwezN3xy1/H6v9po21irlxxUpc0ED7AiBHvkivJha3HOTfBDv18mz+IyxvTDqqMMvS6Xco7IBceA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":30165},"type":"commonjs","engines":{"node":">=20"},"gitHead":"f5c21a3a77c9a3bc7673476dad0d5fd40614244a","scripts":{"dev":"tsx bin/cli.ts","test":"npm run typecheck","build":"tsc","prepack":"npm run build","typecheck":"tsc --noEmit","pack:check":"npm run build && npm pack --dry-run"},"_npmUser":{"name":"acring","email":"392398434@qq.com"},"_npmVersion":"11.5.1","description":"飞书多维表格命令行工具，支持按 URL 查询记录与下载附件","directories":{},"_nodeVersion":"24.7.0","dependencies":{"dotenv":"^17.3.1","commander":"^14.0.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^6.0.2","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/feishu-bitable-cli_1.0.0_1774348088084_0.4907199348150386","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@acring/feishu-bitable-cli","version":"1.0.1","author":"","license":"ISC","_id":"@acring/feishu-bitable-cli@1.0.1","maintainers":[{"name":"acring","email":"392398434@qq.com"}],"bin":{"feishu-bitable":"dist/bin/cli.js"},"dist":{"shasum":"a36df01887993e9908b92203d9a6c0717cb56c07","tarball":"https://registry.npmjs.org/@acring/feishu-bitable-cli/-/feishu-bitable-cli-1.0.1.tgz","fileCount":8,"integrity":"sha512-bNYAEzIHpsilWNy1bM6fyyAZDXb6iuLZXnkCo0uxuN6CS408+zr9fsDsXbJBanridRSYPP6TmfrKgzbjWtk9EA==","signatures":[{"sig":"MEUCIQDm/jgy10rh+pA3XRpECKxQwLCnqvxM2BLLz9WwI+hSFwIgSJEHW+FPf9i4fsiDR3qu8v7gTxt/kUOsChtXgex0FcY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34597},"type":"commonjs","engines":{"node":">=20"},"gitHead":"ea1a8331bbb0cb771c79a869241cb31a40e90ff0","scripts":{"dev":"tsx bin/cli.ts","test":"npm run typecheck","build":"tsc","prepack":"npm run build","typecheck":"tsc --noEmit","pack:check":"npm run build && npm pack --dry-run"},"_npmUser":{"name":"acring","email":"392398434@qq.com"},"_npmVersion":"11.5.1","description":"飞书多维表格命令行工具，支持按 URL 查询记录与下载附件","directories":{},"_nodeVersion":"24.7.0","dependencies":{"dotenv":"^17.3.1","commander":"^14.0.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^6.0.2","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/feishu-bitable-cli_1.0.1_1774407273068_0.565183785874793","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@acring/feishu-bitable-cli","version":"1.0.2","author":"","license":"ISC","_id":"@acring/feishu-bitable-cli@1.0.2","maintainers":[{"name":"acring","email":"392398434@qq.com"}],"bin":{"feishu-bitable":"dist/bin/cli.js"},"dist":{"shasum":"d49a39ec3f7065577347d797725d99277975ed13","tarball":"https://registry.npmjs.org/@acring/feishu-bitable-cli/-/feishu-bitable-cli-1.0.2.tgz","fileCount":8,"integrity":"sha512-Olo7urawETlpArGTlGwssUXfH31uvEvQfUo3otMi3R3GKLrOvISjlxfwVc0sWD5Bc8qMI2+fOlnfDgceVKPqLQ==","signatures":[{"sig":"MEQCIH26B/WFomo/srNfPpYKM1jXRe4BhvGJsWw6P0VdWnHIAiAW6hSnKAoyg3Emv3WUZatvdlF2WXKgBy4lhz/64VXWAw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35527},"type":"commonjs","engines":{"node":">=20"},"gitHead":"fbe57f5e4b794eb4c03a043290e66173c2d2e954","scripts":{"dev":"tsx bin/cli.ts","test":"npm run typecheck","build":"tsc","prepack":"npm run build","typecheck":"tsc --noEmit","pack:check":"npm run build && npm pack --dry-run"},"_npmUser":{"name":"acring","email":"392398434@qq.com"},"_npmVersion":"11.5.1","description":"飞书多维表格命令行工具，支持按 URL 查询记录与下载附件","directories":{},"_nodeVersion":"24.7.0","dependencies":{"dotenv":"^17.3.1","commander":"^14.0.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^6.0.2","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/feishu-bitable-cli_1.0.2_1774409541771_0.7670031603648029","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@acring/feishu-bitable-cli","version":"1.0.3","author":"","license":"ISC","_id":"@acring/feishu-bitable-cli@1.0.3","maintainers":[{"name":"acring","email":"392398434@qq.com"}],"bin":{"feishu-bitable":"dist/bin/cli.js"},"dist":{"shasum":"e29b7db8c30273db714a51899a3d8ef19a3fdc8a","tarball":"https://registry.npmjs.org/@acring/feishu-bitable-cli/-/feishu-bitable-cli-1.0.3.tgz","fileCount":8,"integrity":"sha512-LRR8GGxWbC+yBmM7GkI3KE+mm3M+kTGUCRpC1eh9pzmsj3657dLipdZEjUJzAJzUavyBsyJv01wdyGLzUGoK1A==","signatures":[{"sig":"MEUCICgcvI6dt53rEDua+1pzkfj3M3orjsX1BFMX4NwZNUX/AiEAzniDAKkQvr2WIqzXzCjKq2FinpBIMInBHGEWdU2U/Ug=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":39165},"type":"commonjs","engines":{"node":">=20"},"gitHead":"987fc274b6f6227444db39f3667bff240bae072d","scripts":{"dev":"tsx bin/cli.ts","test":"npm run typecheck","build":"tsc","prepack":"npm run build","typecheck":"tsc --noEmit","pack:check":"npm run build && npm pack --dry-run"},"_npmUser":{"name":"acring","email":"392398434@qq.com"},"_npmVersion":"11.5.1","description":"飞书多维表格命令行工具，支持按 URL 查询记录与下载附件","directories":{},"_nodeVersion":"24.7.0","dependencies":{"dotenv":"^17.3.1","commander":"^14.0.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^6.0.2","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/feishu-bitable-cli_1.0.3_1774420438205_0.03168139309814344","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@acring/feishu-bitable-cli","version":"1.0.4","description":"飞书多维表格命令行工具，支持按 URL 查询记录与下载附件","license":"ISC","author":"","type":"commonjs","bin":{"feishu-bitable":"dist/bin/cli.js"},"scripts":{"dev":"tsx bin/cli.ts","build":"tsc","typecheck":"tsc --noEmit","prepack":"npm run build","pack:check":"npm run build && npm pack --dry-run","test":"npm run typecheck"},"engines":{"node":">=20"},"publishConfig":{"access":"public"},"dependencies":{"commander":"^14.0.3","dotenv":"^17.3.1"},"devDependencies":{"@types/node":"^25.5.0","tsx":"^4.21.0","typescript":"^6.0.2"},"_id":"@acring/feishu-bitable-cli@1.0.4","gitHead":"c240bb2d48f899adbd384c66edae7ac196ea9b3b","_nodeVersion":"24.7.0","_npmVersion":"11.5.1","dist":{"integrity":"sha512-13RJ0mEC2NLKfl8GDg0zwrqSXpgkIjplcQFFE0ACLw9O3wAEcYUlc6QpyGBVro4JU03CD9rwHwYaipPOEC3plg==","shasum":"e8136fde98346b7e8a6256e1652261b9b0453557","tarball":"https://registry.npmjs.org/@acring/feishu-bitable-cli/-/feishu-bitable-cli-1.0.4.tgz","fileCount":8,"unpackedSize":42266,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAf50D2KpuL0OlKykvM+PAVBgOh/jh0DfNuUobRpj5S8AiEA+wZIeAR/3F7ShDeuZZy6qR5fJDdFbZwKFuNKq0YLPu4="}]},"_npmUser":{"name":"acring","email":"392398434@qq.com"},"directories":{},"maintainers":[{"name":"acring","email":"392398434@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/feishu-bitable-cli_1.0.4_1774422841953_0.5276773333786746"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-24T10:28:07.957Z","modified":"2026-03-25T07:14:02.283Z","1.0.0":"2026-03-24T10:28:08.228Z","1.0.1":"2026-03-25T02:54:33.209Z","1.0.2":"2026-03-25T03:32:21.930Z","1.0.3":"2026-03-25T06:33:58.366Z","1.0.4":"2026-03-25T07:14:02.165Z"},"license":"ISC","description":"飞书多维表格命令行工具，支持按 URL 查询记录与下载附件","maintainers":[{"name":"acring","email":"392398434@qq.com"}],"readme":"# feishu-bitable-cli\n\n一个面向飞书多维表格的命令行工具，支持通过表格 URL 查询记录、通过记录分享 URL 拉取单条详情、更新记录，以及下载记录附件。\n\n## 安装\n\n```bash\nnpm install -g @acring/feishu-bitable-cli\n```\n\n安装后可执行命令：\n\n```bash\nfeishu-bitable --help\n```\n\n## 认证\n\n优先级如下：\n\n1. `--access-token`\n2. 当前 shell 已导出的环境变量\n3. 当前工作目录下按顺序加载的环境文件：`.env` -> `.env.local` -> `.env.<NODE_ENV>` -> `.env.<NODE_ENV>.local`\n4. `FEISHU_ACCESS_TOKEN`\n5. `LARK_ACCESS_TOKEN`\n6. `FEISHU_USER_ACCESS_TOKEN`\n7. `LARK_USER_ACCESS_TOKEN`\n8. `FEISHU_APP_ID` + `FEISHU_APP_SECRET`\n9. `LARK_APP_ID` + `LARK_APP_SECRET`\n\n可参考 `.env.example`。\n\n`table-url` 也支持通过环境变量提供，优先级如下：\n\n1. 命令行参数中的 `table-url`\n2. 当前 shell / `.env*` 中的 `FEISHU_BITABLE_TABLE_URL`\n3. `LARK_BITABLE_TABLE_URL`\n4. `FEISHU_TABLE_URL`\n5. `LARK_TABLE_URL`\n\n## 用法\n\n查询整张表的记录：\n\n```bash\nfeishu-bitable records \"https://xxx.feishu.cn/wiki/xxxx?table=tblxxxx&view=vewxxxx\"\n```\n\n查询整张表的字段：\n\n```bash\nfeishu-bitable fields \"https://xxx.feishu.cn/wiki/xxxx?table=tblxxxx&view=vewxxxx\"\n```\n\n如果已经在环境变量里配置了 `table-url`，可以直接省略：\n\n```bash\nexport FEISHU_BITABLE_TABLE_URL=\"https://xxx.feishu.cn/wiki/xxxx?table=tblxxxx&view=vewxxxx\"\nfeishu-bitable records\n```\n\n同样也可以直接查询字段：\n\n```bash\nfeishu-bitable fields\n```\n\n导出单条记录并下载附件：\n\n```bash\nfeishu-bitable record \\\n  \"https://xxx.feishu.cn/wiki/xxxx?table=tblxxxx\" \\\n  \"https://xxx.feishu.cn/record/recuXXXXXX\" \\\n  --output ./record-1\n```\n\n配置环境变量后，也可以只传 `record-url`：\n\n```bash\nfeishu-bitable record \\\n  \"https://xxx.feishu.cn/record/recuXXXXXX\" \\\n  --output ./record-1\n```\n\n更新单条记录：\n\n```bash\nfeishu-bitable update-record \\\n  \"https://xxx.feishu.cn/wiki/xxxx?table=tblxxxx\" \\\n  \"recxxxxxxxx\" \\\n  --fields '{\"文本\":\"新的内容\",\"数字\":100}'\n```\n\n配置环境变量后，也可以只传 `record-id`：\n\n```bash\nfeishu-bitable update-record \\\n  \"recxxxxxxxx\" \\\n  --fields '{\"文本\":\"新的内容\",\"数字\":100}'\n```\n\n如果字段 JSON 较复杂，也可以从文件读取。文件内容既可以是完整请求体中的 `fields` 对象，也可以是 `{ \"fields\": { ... } }`：\n\n```bash\nfeishu-bitable update-record \\\n  \"https://xxx.feishu.cn/wiki/xxxx?table=tblxxxx\" \\\n  \"recxxxxxxxx\" \\\n  --fields-file ./fields.json \\\n  --ignore-consistency-check\n```\n\n开发阶段直接运行 TypeScript 入口：\n\n```bash\nnpm run dev -- --help\n```\n\n## 发布到 npm\n\n发布前检查：\n\n```bash\nnpm install\nnpm run pack:check\n```\n\n首次发布 scoped 包建议确认 public access：\n\n```bash\nnpm login\nnpm publish\n```\n\n当前包已在 `package.json` 中设置 `\"publishConfig\": { \"access\": \"public\" }`。\n","readmeFilename":"README.md"}