bitable-upload 1.3.0 → 1.3.2

package/README.md

@@ -1,107 +1,65 @@
-# 🚀 xiaxiamao-lark-bitable
-
-<p align="center">
-  <a href="https://github.com/xiaxiamao/xiaxiamao-lark-bitable/releases">
-    <img src="https://img.shields.io/github/v/release/xiaxiamao/xiaxiamao-lark-bitable" alt="Release">
-  </a>
-  <a href="https://www.npmjs.com/package/xiaxiamao-lark-bitable">
-    <img src="https://img.shields.io/npm/v/xiaxiamao-lark-bitable" alt="npm">
-  </a>
-  <a href="https://github.com/xiaxiamao/xiaxiamao-lark-bitable/blob/main/LICENSE">
-    <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License">
-  </a>
-</p>
-
-<p align="center">
-  <b>Xiaxiamao's Lark多维表格通用附件上传工具</b><br>
-  支持多种文件类型，自动化批量处理<br>
-  <a href="#安装">开始使用</a> • <a href="#功能特性">功能特性</a> • <a href="#使用方法">使用方法</a>
-</p>
+# 🚀 bitable-upload
+
+Node.js CLI tool for uploading attachments to Lark Bitable multidimensional tables
 
 ## 📦 **安装**
 
 ```bash
 # 全局安装（推荐）
-npm install -g xiaxiamao-lark-bitable
+npm install -g bitable-upload
 
 # 或作为项目依赖
-npm install xiaxiamao-lark-bitable --save
-```
-
-## 🔧 **配置**
-
-### 环境变量配置
-```bash
-# Lark应用凭证（必需）
-export LARK_APP_ID="cli_your_app_id"
-export LARK_APP_SECRET="your_app_secret"
-
-# 可选：设置默认参数
-export LARK_DEFAULT_APP_TOKEN="your_default_app_token"
-export LARK_DEFAULT_TABLE_ID="your_default_table_id"
+npm install bitable-upload --save
 ```
 
-### 获取应用凭证
-1. 访问 [Lark开放平台](https://open.larksuite.com/)
-2. 创建或选择应用
-3. 在"凭证与基础信息"中获取App ID和App Secret
-4. 确保开启以下权限：
-   - `bitable:app` - 多维表格访问
-   - `docs:document.media:upload` - 素材上传
-   - `drive:drive` - 文件管理
-
 ## 🎯 **使用方法**
 
 ### 1. 交互式模式（推荐）
 ```bash
-xb-upload
-# 或
-xiaxiamao-bitable-upload
+bitable-upload
 ```
 
 ### 2. 快速上传模式
 ```bash
-xb-upload <appToken> <tableId> <recordId> <fieldName> <filePath>
+bitable-upload <appToken> <tableId> <recordId> <fieldName> <filePath>
 ```
 
 ### 3. 查看帮助
 ```bash
-xb-upload --help
+bitable-upload --help
 ```
 
 ### 4. 获取版本信息
 ```bash
-xb-upload --version
+bitable-upload --version
 ```
 
 ## ✨ **功能特性**
 
-### 🔍 **智能发现**
-- **自动发现** - 列出所有多维表格应用
-- **字段识别** - 智能识别附件字段（支持多附件字段）
-- **记录定位** - 准确找到目标记录（支持记录ID和序号）
+- **智能发现** - 自动列出多维表格、数据表和附件字段
+- **通用上传** - 支持图片、PDF等任意文件类型
+- **批量处理** - 支持多文件批量上传
+- **错误重试** - 自动重试失败的任务
+- **Token管理** - 自动处理Token过期和刷新
 
-### 📤 **通用上传**
-- **多文件类型** - 支持图片、PDF、文档等任意文件
-- **自动类型检测** - 根据文件扩展名自动选择上传类型
-- **大文件支持** - 支持分片上传（大文件自动处理）
+## 🔧 **配置**
 
-### 🔄 **批量处理**
-- **批量上传** - 支持多文件批量上传
-- **记录批量更新** - 支持多记录同时更新
-- **进度显示** - 实时显示上传进度
+### 环境变量配置
+```bash
+# Lark应用凭证（必需）
+export LARK_APP_ID="cli_your_app_id"
+export LARK_APP_SECRET="your_app_secret"
 
-### 🛡️ **企业级特性**
-- **错误重试** - 自动重试失败的任务
-- **Token管理** - 自动处理Token过期和刷新
-- **权限验证** - 完整的权限检查和错误提示
-- **日志记录** - 详细的操作日志和错误追踪
+# 可选：设置默认参数
+export LARK_DEFAULT_APP_TOKEN="your_default_app_token"
+export LARK_DEFAULT_TABLE_ID="your_default_table_id"
+```
 
 ## 🎯 **使用示例**
 
 ### 交互式上传流程
 ```
-$ xb-upload
+$ bitable-upload
 
 🚀 开始多维表格附件上传流程
 
@@ -152,39 +110,13 @@ $ xb-upload
 
 ### 快速上传
 ```bash
-xb-upload app_a1b2c3d4e5f6g7h8 table_1a2b3c4d5e6f7g8h rec_1a2b3c4d5e "设计稿" /tmp/design.png
+bitable-upload app_a1b2c3d4e5f6g7h8 table_1a2b3c4d5e6f7g8h rec_1a2b3c4d5e "设计稿" /tmp/design.png
 ```
 
-## 🔑 **获取Token的方法**
-
-### 1. 获取App ID和App Secret
-- 进入飞书开放平台
-- 创建或选择应用
-- 在"凭证与基础信息"中查看
-
-### 2. 获取多维表格Token
-- 打开多维表格
-- 从URL中获取: `https://my.feishu.cn/base/{app_token}`
-- 或使用API列出所有表格
-
-### 3. 获取数据表ID
-- 在表格内点击"分享" → "复制链接"
-- 或从URL中获取: `.../base/{app_token}?table={table_id}`
-
-### 4. 获取记录ID
-- 在表格中右键点击记录
-- 选择"复制记录ID"
-- 或从API获取记录列表
-
-### 5. 获取字段名称
-- 查看表格字段设置
-- 或使用API获取字段列表
-- 附件字段类型为17
-
 ## 📋 **API使用**
 
 ```javascript
-const FeishuBitableAttachmentUploader = require('feishu-bitable-attachment-upload');
+const FeishuBitableAttachmentUploader = require('bitable-upload');
 
 // 创建上传器
 const uploader = new FeishuBitableAttachmentUploader(
@@ -206,45 +138,8 @@ await uploader.quickUpload({
 await uploader.interactiveUpload();
 ```
 
-## 🛡️ **权限要求**
-
-在飞书应用中需要开启以下权限:
-- `bitable:app` - 多维表格访问
-- `docs:document.media:upload` - 素材上传
-- `drive:drive` - 文件管理
-
-## 💡 **最佳实践**
-
-1. **先测试权限**: 确保应用有足够权限
-2. **小文件测试**: 先用小文件测试上传流程
-3. **备份数据**: 上传前备份重要数据
-4. **字段命名**: 使用清晰的字段名称
-5. **记录管理**: 定期清理不需要的附件
-
-## 🔧 **调试技巧**
-
-```bash
-# 调试模式查看所有表格
-feishu-bitable-upload --debug
-
-# 查看详细错误信息
-DEBUG=* feishu-bitable-upload
-
-# 测试特定表格
-feishu-bitable-upload app_token table_id record_id field_name /path/to/test.png
-```
-
-## 📞 **故障排除**
-
-| 错误 | 原因 | 解决方案 |
-|------|------|----------|
-| 403 | 权限不足 | 检查应用权限 |
-| 404 | 资源不存在 | 检查Token和ID |
-| 1062009 | 文件大小不匹配 | 检查文件大小参数 |
-| TextFieldConvFail | 字段类型不匹配 | 确认是附件字段 |
-
 ## 📄 **许可证**
 MIT License
 
 ## 🤝 **贡献**
-欢迎提交Issue和Pull Request
+欢迎提交Issue和Pull Request

package/SKILL.md

@@ -1,7 +1,7 @@
-# 🚀 xiaxiamao-lark-bitable Skill
+# 🚀 bitable-upload Skill
 
 ## 🎯 **技能概述**
-xiaxiamao-lark-bitable 是Xiaxiamao开发的Lark多维表格通用附件上传工具，支持任意多维表格的附件字段上传操作。
+bitable-upload 是Node.js CLI工具，用于上传附件到Lark多维表格，支持任意多维表格的附件字段上传操作。
 
 ## 📋 **功能特性**
 
@@ -30,7 +30,7 @@ xiaxiamao-lark-bitable 是Xiaxiamao开发的Lark多维表格通用附件上传
 
 ### 📦 **安装**
 ```bash
-npm install -g xiaxiamao-lark-bitable
+npm install -g bitable-upload
 ```
 
 ### 🔧 **配置环境变量**
@@ -47,20 +47,13 @@ export LARK_DEFAULT_TABLE_ID="your_default_table_id"
 ### 🎯 **使用方式**
 ```bash
 # 交互式模式
-xb-upload
+bitable-upload
 
 # 快速上传模式
-xb-upload <appToken> <tableId> <recordId> <fieldName> <filePath>
+bitable-upload <appToken> <tableId> <recordId> <fieldName> <filePath>
 ```
 
-## 🚀 **快速开始**
-
-### 📝 **安装使用**
-```bash
-# 技能已集成到系统中，直接使用相关命令即可
-```
-
-### 🎯 **基本使用流程**
+## 🎯 **基本使用流程**
 1. 获取多维表格列表
 2. 选择目标表格和记录
 3. 识别附件字段
@@ -268,5 +261,5 @@ console.log("✅ 附件上传成功！");
 
 ---
 
-**技能版本**: v1.0.0  
-**最后更新**: 2026年3月17日
+**技能版本**: v1.3.0  
+**最后更新**: 2026年3月17日

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bitable-upload",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Node.js CLI tool for uploading attachments to Lark Bitable multidimensional tables",
   "main": "index.js",
   "bin": {