bitable-upload 1.3.0 → 1.3.1

package/README.md

@@ -1,250 +1,19 @@
-# 🚀 xiaxiamao-lark-bitable
+# 🚀 bitable-upload
 
 <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 href="https://github.com/xiaxiamao2026/xiaxiamao-lark-bitable/releases">
+    <img src="https://img.shields.io/github/v/release/xiaxiamao2026/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 href="https://www.npmjs.com/package/bitable-upload">
+    <img src="https://img.shields.io/npm/v/bitable-upload" alt="npm">
   </a>
-  <a href="https://github.com/xiaxiamao/xiaxiamao-lark-bitable/blob/main/LICENSE">
+  <a href="https://github.com/xiaxiamao2026/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>
+  <b>Node.js CLI工具 - 上传附件到Lark多维表格</b><br>
+  支持图片和PDF文件，命令行调用<br>
   <a href="#安装">开始使用</a> • <a href="#功能特性">功能特性</a> • <a href="#使用方法">使用方法</a>
 </p>
-
-## 📦 **安装**
-
-```bash
-# 全局安装（推荐）
-npm install -g xiaxiamao-lark-bitable
-
-# 或作为项目依赖
-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"
-```
-
-### 获取应用凭证
-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
-```
-
-### 2. 快速上传模式
-```bash
-xb-upload <appToken> <tableId> <recordId> <fieldName> <filePath>
-```
-
-### 3. 查看帮助
-```bash
-xb-upload --help
-```
-
-### 4. 获取版本信息
-```bash
-xb-upload --version
-```
-
-## ✨ **功能特性**
-
-### 🔍 **智能发现**
-- **自动发现** - 列出所有多维表格应用
-- **字段识别** - 智能识别附件字段（支持多附件字段）
-- **记录定位** - 准确找到目标记录（支持记录ID和序号）
-
-### 📤 **通用上传**
-- **多文件类型** - 支持图片、PDF、文档等任意文件
-- **自动类型检测** - 根据文件扩展名自动选择上传类型
-- **大文件支持** - 支持分片上传（大文件自动处理）
-
-### 🔄 **批量处理**
-- **批量上传** - 支持多文件批量上传
-- **记录批量更新** - 支持多记录同时更新
-- **进度显示** - 实时显示上传进度
-
-### 🛡️ **企业级特性**
-- **错误重试** - 自动重试失败的任务
-- **Token管理** - 自动处理Token过期和刷新
-- **权限验证** - 完整的权限检查和错误提示
-- **日志记录** - 详细的操作日志和错误追踪
-
-## 🎯 **使用示例**
-
-### 交互式上传流程
-```
-$ xb-upload
-
-🚀 开始多维表格附件上传流程
-
-📋 正在获取多维表格列表...
-📋 可用的多维表格:
-1. 项目管理表 (app_a1b2c3d4e5f6g7h8)
-2. 资产登记表 (app_i9j0k1l2m3n4o5p6)
-3. 产品资料库 (app_q7r8s9t0u1v2w3x4)
-
-请选择表格编号 (1-3): 1
-✅ 已选择表格: 项目管理表
-
-🗂️  正在获取数据表列表...
-🗂️  数据表列表:
-1. 项目附件 (table_1a2b3c4d5e6f7g8h)
-2. 团队资料 (table_9i0j1k2l3m4n5o6p)
-
-请选择数据表编号 (1-2): 1
-✅ 已选择数据表: 项目附件
-
-🔍 正在获取字段列表...
-📎 附件字段列表:
-1. 设计稿 (field_design)
-2. 需求文档 (field_requirements)
-
-请选择附件字段编号 (1-2): 1
-✅ 已选择附件字段: 设计稿
-
-📝 正在获取记录列表...
-📝 记录列表 (前20条):
-1. 移动端UI设计 (rec_1a2b3c4d5e)
-2. 后台管理系统 (rec_6f7g8h9i0j)
-3. 数据可视化大屏 (rec_k1l2m3n4o5)
-
-请选择记录编号 (1-20) 或输入记录ID: 1
-✅ 已选择记录: rec_1a2b3c4d5e
-
-📁 请输入要上传的图片文件路径: /tmp/design_mockup.png
-📤 正在上传图片: /tmp/design_mockup.png...
-✅ 文件上传成功: file_x1y2z3a4b5c6d7e8f9
-
-🔄 正在更新记录附件字段...
-🎉 附件上传完成！
-📎 记录ID: rec_1a2b3c4d5e
-📄 字段: 设计稿
-🖼️  附件: file_x1y2z3a4b5c6d7e8f9
-```
-
-### 快速上传
-```bash
-xb-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 uploader = new FeishuBitableAttachmentUploader(
-  'your_app_id',
-  'your_app_secret'
-);
-
-// 快速上传
-await uploader.quickUpload({
-  appToken: 'your_app_token',
-  tableId: 'your_table_id',
-  recordId: 'your_record_id',
-  fieldName: '附件字段名',
-  filePath: '/path/to/image.png',
-  customName: 'custom_name.png' // 可选
-});
-
-// 交互式上传
-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

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.1",
   "description": "Node.js CLI tool for uploading attachments to Lark Bitable multidimensional tables",
   "main": "index.js",
   "bin": {