From edc63aec71d521e001c68e1b17f29cf038d58b11 Mon Sep 17 00:00:00 2001
From: byte-n <dancingbytes@qq.com>
Date: Thu, 7 May 2026 18:54:16 +0800
Subject: [PATCH 1/2] =?UTF-8?q?fix(client):=20=E5=8C=BA=E5=88=86=E5=9B=BE?=
 =?UTF-8?q?=E7=89=87=E4=B8=8B=E8=BD=BD=20401/403=20=E9=94=99=E8=AF=AF?=
 =?UTF-8?q?=E6=8F=90=E7=A4=BA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/client.ts | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/src/client.ts b/src/client.ts
index d460dfa..4c05563 100644
--- a/src/client.ts
+++ b/src/client.ts
@@ -112,8 +112,11 @@ export function createClient (appId: string, appSecret: string, loggerLevel: Log
       await resp.writeFile(filename);
       return filename;
     } catch (error: any) {
-      if ([400, 401, 403].includes(error.status)) {
-        throw new Error(`下载图片[${imgToken}]异常, 检查是否有接口 https://open.feishu.cn/document/server-docs/docs/drive-v1/media/download 的权限。`);
+      if (error.status === 401) {
+        throw new Error(`下载图片[${imgToken}]异常, 检查是否有接口 https://open.feishu.cn/document/server-docs/docs/drive-v1/media/download 的权限`);
+      }
+      if (error.status === 403) {
+        throw new Error(`下载图片[${imgToken}]异常, 应用的文档权限大于等于文档本身“谁可以创建副本、打印和下载”的权限`);
       }
       throw error;
     }

From ad25ce43b4a23b0aedf05edd53cd7d5c5f9314d8 Mon Sep 17 00:00:00 2001
From: byte-n <dancingbytes@qq.com>
Date: Thu, 7 May 2026 18:55:03 +0800
Subject: [PATCH 2/2] release: 0.5.2

---
 CHANGELOG.md | 6 ++++++
 package.json | 2 +-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1fd11f5..abd414d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.5.2
+
+### Fixed
+
+- **图片下载错误提示细化**：`createClient` 下载图片失败时，401 与 403 分别给出不同提示——401 指向接口权限问题，403 指向文档“谁可以创建副本、打印和下载”的权限配置，便于快速定位排错
+
 ## 0.5.1
 
 ### Changed
diff --git a/package.json b/package.json
index 198f8a0..af0e4db 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "lark-docx2md",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Convert Lark/Feishu documents to Markdown",
   "type": "module",
   "main": "./dist/converter.js",