From 87099dcf55e52b9aff6722aa52a594bae91e0fd8 Mon Sep 17 00:00:00 2001
From: chakcy <947105045@qq.com>
Date: Wed, 5 Aug 2026 18:19:57 +0800
Subject: [PATCH] =?UTF-8?q?modify:=20=E8=AF=B4=E6=98=8E=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 62 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 62 insertions(+)

diff --git a/README.md b/README.md
index e69de29..ad1b993 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,62 @@
+# bytedance
+
+字节跳动安全通信 SDK，为豆包等字节系 API 提供加密通信通道。以 namespace package 组织，包含多个子模块。
+
+---
+
+## 安装
+
+```
+uv pip install -e utils/bytedance
+```
+
+---
+
+## 子模块
+
+| 模块 | 说明 |
+| --- | --- |
+| bytedance.volcengine_aicc_sdk | 火山引擎 AICC 安全通信 SDK（SecureHttpClient, AICCConfig） |
+| bytedance.tks | TKS 安全通信组件 |
+| bytedance.jeddak_secure_channel | Jeddak 安全通道 |
+
+---
+
+## 使用示例
+
+```
+from bytedance.volcengine_aicc_sdk.secure_http_client import (
+    AICCConfig,
+    AsyncSecureHttpClient,
+)
+
+config = AICCConfig(
+    access_key="your-access-key",
+    secret_key="your-secret-key",
+)
+client = AsyncSecureHttpClient(config)
+```
+
+---
+
+## 在豆包插件中的应用
+
+src/plugins/doubao/__init__.py 根据配置决定是否启用 AICC 安全通道：
+
+```
+if is_aicc:
+    from bytedance.volcengine_aicc_sdk.secure_http_client import (
+        AICCConfig, AsyncSecureHttpClient,
+    )
+```
+
+---
+
+## 依赖
+
+- requests — HTTP 客户端
+- pyjwt — JWT 处理
+- pymerkle — Merkle 树验证
+- jwcrypto — JWE/JWS 加密
+- loguru — 日志
+- wget — 文件下载