local-coze 0.0.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. local_coze/__init__.py +110 -0
  2. local_coze/cli/__init__.py +3 -0
  3. local_coze/cli/chat.py +126 -0
  4. local_coze/cli/cli.py +34 -0
  5. local_coze/cli/constants.py +7 -0
  6. local_coze/cli/db.py +81 -0
  7. local_coze/cli/embedding.py +193 -0
  8. local_coze/cli/image.py +162 -0
  9. local_coze/cli/knowledge.py +195 -0
  10. local_coze/cli/search.py +198 -0
  11. local_coze/cli/utils.py +41 -0
  12. local_coze/cli/video.py +191 -0
  13. local_coze/cli/video_edit.py +888 -0
  14. local_coze/cli/voice.py +351 -0
  15. local_coze/core/__init__.py +25 -0
  16. local_coze/core/client.py +253 -0
  17. local_coze/core/config.py +58 -0
  18. local_coze/core/exceptions.py +67 -0
  19. local_coze/database/__init__.py +29 -0
  20. local_coze/database/client.py +170 -0
  21. local_coze/database/migration.py +342 -0
  22. local_coze/embedding/__init__.py +31 -0
  23. local_coze/embedding/client.py +350 -0
  24. local_coze/embedding/models.py +130 -0
  25. local_coze/image/__init__.py +19 -0
  26. local_coze/image/client.py +110 -0
  27. local_coze/image/models.py +163 -0
  28. local_coze/knowledge/__init__.py +19 -0
  29. local_coze/knowledge/client.py +148 -0
  30. local_coze/knowledge/models.py +45 -0
  31. local_coze/llm/__init__.py +25 -0
  32. local_coze/llm/client.py +317 -0
  33. local_coze/llm/models.py +48 -0
  34. local_coze/memory/__init__.py +14 -0
  35. local_coze/memory/client.py +176 -0
  36. local_coze/s3/__init__.py +12 -0
  37. local_coze/s3/client.py +580 -0
  38. local_coze/s3/models.py +18 -0
  39. local_coze/search/__init__.py +19 -0
  40. local_coze/search/client.py +183 -0
  41. local_coze/search/models.py +57 -0
  42. local_coze/video/__init__.py +17 -0
  43. local_coze/video/client.py +347 -0
  44. local_coze/video/models.py +39 -0
  45. local_coze/video_edit/__init__.py +23 -0
  46. local_coze/video_edit/examples.py +340 -0
  47. local_coze/video_edit/frame_extractor.py +176 -0
  48. local_coze/video_edit/models.py +362 -0
  49. local_coze/video_edit/video_edit.py +631 -0
  50. local_coze/voice/__init__.py +17 -0
  51. local_coze/voice/asr.py +82 -0
  52. local_coze/voice/models.py +86 -0
  53. local_coze/voice/tts.py +94 -0
  54. local_coze-0.0.1.dist-info/METADATA +636 -0
  55. local_coze-0.0.1.dist-info/RECORD +58 -0
  56. local_coze-0.0.1.dist-info/WHEEL +4 -0
  57. local_coze-0.0.1.dist-info/entry_points.txt +3 -0
  58. local_coze-0.0.1.dist-info/licenses/LICENSE +21 -0
@@ -0,0 +1,636 @@
1
+ Metadata-Version: 2.4
2
+ Name: local-coze
3
+ Version: 0.0.1
4
+ Summary: Local Coze SDK - 优雅的多功能 AI SDK,支持图片生成、视频生成、语音合成、语音识别、大语言模型、联网搜索和文本/多模态 Embedding。包含命令行工具 local-coze,支持 Context 上下文追踪
5
+ License: MIT
6
+ License-File: LICENSE
7
+ Keywords: coze,coze-coding,integration,ai,sdk,image-generation,video-generation,text-to-speech,speech-recognition,llm,search,embedding,vector-embedding,semantic-search,rag,doubao,seedream
8
+ Author: Coze Coding Integration Team
9
+ Author-email: support@coze.com
10
+ Maintainer: Coze Coding Integration Team
11
+ Maintainer-email: support@coze.com
12
+ Requires-Python: >=3.11
13
+ Classifier: Development Status :: 4 - Beta
14
+ Classifier: Intended Audience :: Developers
15
+ Classifier: License :: OSI Approved :: MIT License
16
+ Classifier: Operating System :: OS Independent
17
+ Classifier: Programming Language :: Python :: 3
18
+ Classifier: Programming Language :: Python :: 3.11
19
+ Classifier: Programming Language :: Python :: 3.12
20
+ Classifier: Programming Language :: Python :: 3.13
21
+ Classifier: Programming Language :: Python :: 3.14
22
+ Classifier: Topic :: Multimedia :: Graphics
23
+ Classifier: Topic :: Multimedia :: Sound/Audio
24
+ Classifier: Topic :: Multimedia :: Video
25
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
26
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
27
+ Requires-Dist: alembic (>=1.13.0)
28
+ Requires-Dist: boto3 (>=1.26.0)
29
+ Requires-Dist: click (>=8.0.0)
30
+ Requires-Dist: coze-coding-utils (>=0.1.0)
31
+ Requires-Dist: cozeloop (>=0.1.0)
32
+ Requires-Dist: langchain-core (>=0.1.0)
33
+ Requires-Dist: langchain-openai (>=0.1.0)
34
+ Requires-Dist: langgraph (>=0.2.0)
35
+ Requires-Dist: langgraph-checkpoint-postgres (>=3.0.0)
36
+ Requires-Dist: psycopg-pool (>=3.0.0)
37
+ Requires-Dist: psycopg[binary] (>=3.0.0)
38
+ Requires-Dist: pydantic (>=2.0.0)
39
+ Requires-Dist: requests (>=2.31.0)
40
+ Requires-Dist: rich (>=13.0.0)
41
+ Requires-Dist: sqlacodegen (>=3.0.0)
42
+ Requires-Dist: sqlalchemy (>=2.0.0)
43
+ Project-URL: Changelog, https://github.com/coze/local-coze/blob/main/CHANGELOG.md
44
+ Project-URL: Documentation, https://github.com/coze/local-coze#readme
45
+ Project-URL: Homepage, https://github.com/coze/local-coze
46
+ Project-URL: Issues, https://github.com/coze/local-coze/issues
47
+ Project-URL: Repository, https://github.com/coze/local-coze
48
+ Description-Content-Type: text/markdown
49
+
50
+ # Coze Coding Dev SDK
51
+
52
+ > 优雅、模块化的多功能 AI SDK,支持图片生成、视频生成、语音合成、语音识别、大语言模型和联网搜索。同时提供强大的命令行工具 `coze-coding-ai`。
53
+
54
+ [![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
55
+ [![PyPI](https://img.shields.io/pypi/v/coze-coding-dev-sdk.svg)](https://pypi.org/project/coze-coding-dev-sdk/)
56
+ [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
57
+ [![Downloads](https://img.shields.io/pypi/dm/coze-coding-dev-sdk.svg)](https://pypi.org/project/coze-coding-dev-sdk/)
58
+
59
+ ## ✨ 特性
60
+
61
+ - 🎨 **图片生成** - 基于豆包 SeeDream 模型的高质量图片生成 (2K/4K)
62
+ - 🎬 **视频生成** - 文本/图片生成视频,支持多种模型和配置
63
+ - 🤖 **大语言模型** - 支持流式对话、思考链、缓存机制
64
+ - 🔍 **联网搜索** - Web 搜索、AI 总结、图片搜索
65
+ - 🎙️ **语音合成 (TTS)** - 多音色、高质量的文本转语音
66
+ - 🎧 **语音识别 (ASR)** - 快速准确的语音转文字
67
+ - 🏗️ **模块化设计** - 清晰的模块划分,易于扩展
68
+ - 🔒 **类型安全** - 完整的类型提示
69
+ - 🔄 **自动重试** - 内置重试机制
70
+ - 📊 **可观测性** - 集成 cozeloop 监控
71
+ - 🛠️ **命令行工具** - 提供 `coze-coding-ai` CLI 工具,快速使用 AI 功能
72
+
73
+ ## 📦 安装
74
+
75
+ ### 仅安装 SDK
76
+
77
+ ```bash
78
+ pip install coze-coding-dev-sdk
79
+ ```
80
+
81
+ ### 安装 SDK + CLI 工具
82
+
83
+ ```bash
84
+ pip install coze-coding-dev-sdk[cli]
85
+ ```
86
+
87
+ ### 开发安装
88
+
89
+ ```bash
90
+ git clone https://github.com/coze/coze-coding-dev-sdk.git
91
+ cd coze-coding-dev-sdk/packages/python
92
+ pip install -e ".[dev]"
93
+ ```
94
+
95
+ ## 🚀 快速开始
96
+
97
+ ### 环境配置
98
+
99
+ #### 必需配置
100
+
101
+ ```bash
102
+ export COZE_WORKLOAD_IDENTITY_API_KEY="your_api_key"
103
+ export COZE_INTEGRATION_BASE_URL="https://api.coze.com"
104
+ export COZE_INTEGRATION_MODEL_BASE_URL="https://model.coze.com"
105
+ ```
106
+
107
+ #### 可选配置(Cozeloop 监控)
108
+
109
+ 如果需要使用扣子罗盘(Cozeloop)进行模型监控和可观测性追踪,需要额外配置:
110
+
111
+ ```bash
112
+ export COZELOOP_WORKSPACE_ID="your_workspace_id"
113
+ export COZELOOP_API_TOKEN="your_api_token"
114
+ ```
115
+
116
+ **获取 workspace_id 的方法:**
117
+
118
+ 1. 登录扣子罗盘平台
119
+ 2. 在项目设置或工作区设置中找到 `workspace_id`
120
+ 3. 复制该 ID 并设置到环境变量中
121
+
122
+ **注意:** 如果不配置 Cozeloop 相关环境变量,会看到警告信息,但不影响 SDK 的正常使用。
123
+
124
+ ### 图片生成
125
+
126
+ ```python
127
+ from coze_coding_dev_sdk import ImageGenerationClient, ImageConfig
128
+
129
+ client = ImageGenerationClient()
130
+
131
+ files, response = client.generate(
132
+ prompt="一只可爱的橘猫坐在窗台上",
133
+ config=ImageConfig(size="4K", watermark=False)
134
+ )
135
+
136
+ print(f"图片 URL: {response.image_urls}")
137
+ ```
138
+
139
+ ### 视频生成
140
+
141
+ ```python
142
+ from coze_coding_dev_sdk import VideoGenerationClient, VideoConfig
143
+
144
+ client = VideoGenerationClient()
145
+
146
+ task = client.text_to_video(
147
+ prompt="一只可爱的小猫在草地上玩耍",
148
+ config=VideoConfig(resolution="1080p", ratio="16:9", duration=5)
149
+ )
150
+
151
+ print(f"视频 URL: {task.video_url}")
152
+ ```
153
+
154
+ ### 大语言模型
155
+
156
+ ```python
157
+ from coze_coding_dev_sdk import LLMClient
158
+ from langchain_core.messages import HumanMessage
159
+
160
+ client = LLMClient()
161
+
162
+ messages = [HumanMessage(content="你好,介绍一下你自己")]
163
+
164
+ for chunk in client.stream(messages=messages):
165
+ if chunk.content:
166
+ print(chunk.content, end="", flush=True)
167
+ ```
168
+
169
+ ### 联网搜索
170
+
171
+ ```python
172
+ from coze_coding_dev_sdk import SearchClient
173
+
174
+ client = SearchClient()
175
+
176
+ results = client.web_search("Python 最新特性")
177
+ for item in results:
178
+ print(f"{item.title}: {item.url}")
179
+ ```
180
+
181
+ ### 语音合成 (TTS)
182
+
183
+ ```python
184
+ from coze_coding_dev_sdk import TTSClient
185
+
186
+ client = TTSClient()
187
+
188
+ audio_file, size = client.synthesize(
189
+ uid="user123",
190
+ text="你好,欢迎使用 Coze SDK!",
191
+ speaker="zh_female_xiaohe_uranus_bigtts"
192
+ )
193
+
194
+ print(f"音频文件: {audio_file.url}")
195
+ ```
196
+
197
+ ### 语音识别 (ASR)
198
+
199
+ ```python
200
+ from coze_coding_dev_sdk import ASRClient
201
+
202
+ client = ASRClient()
203
+
204
+ text, data = client.recognize(
205
+ uid="user123",
206
+ url="https://example.com/audio.mp3"
207
+ )
208
+
209
+ print(f"识别结果: {text}")
210
+ ```
211
+
212
+ ### 上下文追踪 (Context)
213
+
214
+ SDK 支持通过 Context 对象进行请求追踪和上下文管理。Context 会自动注入到 HTTP 请求头中,用于链路追踪、日志关联等场景。
215
+
216
+ ```python
217
+ from coze_coding_dev_sdk import ImageGenerationClient
218
+ from coze_coding_utils.runtime_ctx.context import Context
219
+
220
+ # 创建 Context 对象
221
+ ctx = Context(
222
+ request_id="req-123456",
223
+ trace_id="trace-789",
224
+ user_id="user-001"
225
+ )
226
+
227
+ # 在初始化 Client 时传入 ctx
228
+ client = ImageGenerationClient(ctx=ctx)
229
+
230
+ # 后续所有请求都会自动携带 Context 信息
231
+ response = client.generate(prompt="一只可爱的小猫")
232
+ ```
233
+
234
+ **支持 Context 的所有 Client:**
235
+
236
+ - `ImageGenerationClient` - 图片生成
237
+ - `VideoGenerationClient` - 视频生成
238
+ - `LLMClient` - 大语言模型
239
+ - `SearchClient` - 联网搜索
240
+ - `TTSClient` - 语音合成
241
+ - `ASRClient` - 语音识别
242
+
243
+ **注意事项:**
244
+
245
+ - Context 参数是可选的,不传入时不影响正常使用
246
+ - Context 只在 Client 初始化时传入,不需要在每个方法中传递
247
+ - Context 信息会通过 `default_headers()` 自动转换为 HTTP 请求头
248
+
249
+ ## 📁 项目结构
250
+
251
+ ```
252
+ coze-coding-dev-sdk/
253
+ ├── coze_coding_dev_sdk/ # SDK 主包
254
+ │ ├── core/ # 核心层(配置、异常、基础客户端)
255
+ │ ├── image/ # 图片生成模块
256
+ │ ├── video/ # 视频生成模块
257
+ │ ├── llm/ # 大语言模型模块
258
+ │ ├── search/ # 联网搜索模块
259
+ │ └── voice/ # 语音模块(TTS + ASR)
260
+ ├── examples/ # 使用示例
261
+ │ ├── image_examples/ # 图片生成示例
262
+ │ ├── video_examples/ # 视频生成示例
263
+ │ ├── llm_examples/ # LLM 示例
264
+ │ ├── search_examples/ # 搜索示例
265
+ │ └── voice_examples/ # 语音功能示例
266
+ ├── LICENSE # MIT 许可证
267
+ ├── CHANGELOG.md # 版本变更记录
268
+ └── README.md # 项目文档
269
+ ```
270
+
271
+ ## 🎯 核心模块
272
+
273
+ ### 1. 图片生成 (Image)
274
+
275
+ ```python
276
+ from coze_coding_dev_sdk import ImageGenerationClient, ImageConfig
277
+
278
+ client = ImageGenerationClient()
279
+
280
+ files, response = client.generate(
281
+ prompt="壮丽的雪山日出",
282
+ config=ImageConfig(size="4K", watermark=False)
283
+ )
284
+
285
+ results = await client.batch_generate([
286
+ {"prompt": "春天的樱花", "size": "2K"},
287
+ {"prompt": "夏日的海滩", "size": "4K"},
288
+ ])
289
+ ```
290
+
291
+ **功能特性:**
292
+
293
+ - 支持 2K/4K 或自定义尺寸
294
+ - 同步/异步双模式
295
+ - 批量并发生成
296
+ - 参考图片风格迁移
297
+ - 组图生成
298
+
299
+ ### 2. 视频生成 (Video)
300
+
301
+ ```python
302
+ from coze_coding_dev_sdk import VideoGenerationClient, VideoConfig
303
+
304
+ client = VideoGenerationClient()
305
+
306
+ task = client.image_to_video(
307
+ prompt="小猫从坐着到站起来",
308
+ first_frame_url="https://example.com/cat_sitting.jpg",
309
+ last_frame_url="https://example.com/cat_standing.jpg",
310
+ config=VideoConfig(resolution="1080p", duration=5)
311
+ )
312
+ ```
313
+
314
+ **功能特性:**
315
+
316
+ - 文本生成视频(text-to-video)
317
+ - 图片生成视频(image-to-video)
318
+ - 支持首帧、尾帧、参考图片
319
+ - 异步任务轮询
320
+ - 多种分辨率和比例
321
+
322
+ ### 3. 大语言模型 (LLM)
323
+
324
+ ```python
325
+ from coze_coding_dev_sdk import LLMClient
326
+
327
+ client = LLMClient()
328
+
329
+ response = client.chat(
330
+ messages=[{"role": "user", "content": "解释量子计算"}],
331
+ enable_thinking=True,
332
+ enable_cache=True
333
+ )
334
+
335
+ for chunk in client.chat_stream(messages=[...]):
336
+ print(chunk, end="")
337
+ ```
338
+
339
+ **功能特性:**
340
+
341
+ - 流式和非流式对话
342
+ - 思考链(thinking)
343
+ - 缓存机制
344
+ - 多模态支持
345
+ - 集成 LangChain
346
+
347
+ ### 4. 联网搜索 (Search)
348
+
349
+ ```python
350
+ from coze_coding_dev_sdk import SearchClient
351
+
352
+ client = SearchClient()
353
+
354
+ web_results = client.web_search("AI 最新进展")
355
+
356
+ summary, results = client.web_search_with_summary("量子计算原理")
357
+
358
+ images = client.image_search("可爱的猫咪")
359
+ ```
360
+
361
+ **功能特性:**
362
+
363
+ - Web 搜索
364
+ - Web 搜索 + AI 总结
365
+ - 图片搜索
366
+ - 结构化结果返回
367
+
368
+ ### 5. 语音合成 (TTS)
369
+
370
+ ```python
371
+ from coze_coding_dev_sdk import TTSClient, TTSConfig
372
+
373
+ client = TTSClient()
374
+
375
+ audio, size = client.synthesize(
376
+ uid="user123",
377
+ text="你好世界",
378
+ speaker="zh_female_xiaohe_uranus_bigtts",
379
+ audio_format="mp3",
380
+ speech_rate=0
381
+ )
382
+ ```
383
+
384
+ **功能特性:**
385
+
386
+ - 30+ 音色选择
387
+ - 支持 SSML 格式
388
+ - 可调节语速和音量
389
+ - 多种音频格式(MP3/PCM/OGG)
390
+ - 流式返回
391
+
392
+ ### 6. 语音识别 (ASR)
393
+
394
+ ```python
395
+ from coze_coding_dev_sdk import ASRClient
396
+
397
+ client = ASRClient()
398
+
399
+ text, data = client.recognize(
400
+ uid="user123",
401
+ url="https://example.com/audio.mp3"
402
+ )
403
+ ```
404
+
405
+ **功能特性:**
406
+
407
+ - 支持 URL 和 Base64 输入
408
+ - 多种音频格式
409
+ - 详细的时间戳信息
410
+ - 最长 2 小时音频
411
+
412
+ ## 🔧 高级配置
413
+
414
+ ### 统一配置
415
+
416
+ ```python
417
+ from coze_coding_dev_sdk import Config, ImageGenerationClient, TTSClient
418
+
419
+ config = Config(
420
+ api_key="your_api_key",
421
+ base_url="https://api.coze.com",
422
+ retry_times=5,
423
+ retry_delay=2.0,
424
+ timeout=120
425
+ )
426
+
427
+ image_client = ImageGenerationClient(config=config)
428
+ tts_client = TTSClient(config=config)
429
+ ```
430
+
431
+ ### 异常处理
432
+
433
+ ```python
434
+ from coze_coding_dev_sdk import (
435
+ CozeSDKError,
436
+ APIError,
437
+ NetworkError,
438
+ ValidationError,
439
+ ConfigurationError
440
+ )
441
+
442
+ try:
443
+ files, response = client.generate(prompt="测试")
444
+ except ValidationError as e:
445
+ print(f"参数错误: {e.field} = {e.value}")
446
+ except APIError as e:
447
+ print(f"API 错误: {e.message}, 状态码: {e.status_code}")
448
+ except NetworkError as e:
449
+ print(f"网络错误: {e}")
450
+ except ConfigurationError as e:
451
+ print(f"配置错误: {e.missing_key}")
452
+ ```
453
+
454
+ ## 💡 使用示例
455
+
456
+ 查看 `examples/` 目录获取更多示例:
457
+
458
+ - `examples/image_examples/` - 图片生成示例
459
+ - `examples/video_examples/` - 视频生成示例
460
+ - `examples/llm_examples/` - 大语言模型示例
461
+ - `examples/search_examples/` - 联网搜索示例
462
+ - `examples/voice_examples/` - 语音功能示例
463
+
464
+ 运行示例:
465
+
466
+ ```bash
467
+ python examples/image_examples/simple_example.py
468
+ python examples/video_examples/text_to_video.py
469
+ python examples/llm_examples/simple_chat.py
470
+ python examples/search_examples/web_search.py
471
+ python examples/voice_examples/tts_example.py
472
+ ```
473
+
474
+ ## 🛠️ 命令行工具 (CLI)
475
+
476
+ 安装 CLI 工具后,可以直接在命令行中使用 AI 功能:
477
+
478
+ ```bash
479
+ # 安装 CLI
480
+ pip install coze-coding-dev-sdk[cli]
481
+
482
+ # 查看帮助
483
+ coze-coding-ai --help
484
+ ```
485
+
486
+ ### 图片生成
487
+
488
+ **支持的图片尺寸:**
489
+
490
+ - `2K` (默认, ~2560x1440)
491
+ - `4K` (~3840x2160)
492
+ - 自定义: `WIDTHxHEIGHT` (宽度 2560-4096, 高度 1440-4096)
493
+
494
+ ```bash
495
+ # 文生图 (默认 2K)
496
+ coze-coding-ai image -p "A beautiful landscape" -o "./image.png"
497
+
498
+ # 4K 分辨率
499
+ coze-coding-ai image -p "Professional portrait" -o "./portrait.png" -s 4K
500
+
501
+ # 图生图
502
+ coze-coding-ai image \
503
+ -p "Transform into watercolor style" \
504
+ -i "https://example.com/photo.jpg" \
505
+ -o "./result.png"
506
+ ```
507
+
508
+ ### 视频生成
509
+
510
+ ```bash
511
+ # 文生视频
512
+ coze-coding-ai video -p "A cat playing with a ball" --poll
513
+
514
+ # 图生视频
515
+ coze-coding-ai video \
516
+ -i "https://example.com/image.png" \
517
+ -p "Make the scene come alive" \
518
+ --poll
519
+
520
+ # 查询任务状态
521
+ coze-coding-ai video-status <task-id>
522
+
523
+ # Mock 模式(测试运行,不消耗配额)
524
+ coze-coding-ai video -p "Test video" --mock --poll
525
+ coze-coding-ai video-status <task-id> --mock
526
+ ```
527
+
528
+ ### Chat 对话
529
+
530
+ ```bash
531
+ # 基础对话
532
+ coze-coding-ai chat -p "Hello, how are you?"
533
+
534
+ # 自定义系统提示词
535
+ coze-coding-ai chat \
536
+ -p "Review this code: function add(a,b) { return a+b; }" \
537
+ -s "You are an expert code reviewer" \
538
+ -o review.json
539
+
540
+ # 启用思考链 (Chain of Thought)
541
+ coze-coding-ai chat \
542
+ -p "Solve this math problem: If a train travels 120km in 2 hours, what's its speed?" \
543
+ -t \
544
+ -o solution.json
545
+
546
+ # 流式输出
547
+ coze-coding-ai chat \
548
+ -p "Write a short story about a robot" \
549
+ --stream
550
+ ```
551
+
552
+ ### 联网搜索
553
+
554
+ ```bash
555
+ # 网页搜索(默认)
556
+ coze-coding-ai search "AI 最新进展"
557
+
558
+ # 网页搜索 + 指定结果数量
559
+ coze-coding-ai search "Python 教程" --count 20
560
+
561
+ # 网页搜索 + AI 智能摘要
562
+ coze-coding-ai search "量子计算原理" --type web_summary
563
+
564
+ # 图片搜索
565
+ coze-coding-ai search "可爱的猫咪" --type image
566
+ coze-coding-ai search "可爱的猫咪" -t image -c 20
567
+
568
+ # 高级过滤 - 指定站点
569
+ coze-coding-ai search "Python 教程" --sites "python.org,github.com"
570
+
571
+ # 高级过滤 - 屏蔽站点
572
+ coze-coding-ai search "新闻" --block-hosts "example.com"
573
+
574
+ # 高级过滤 - 时间范围(1d=1天, 1w=1周, 1m=1月)
575
+ coze-coding-ai search "最新科技" --time-range "1d"
576
+
577
+ # 高级过滤 - 仅返回有正文的结果
578
+ coze-coding-ai search "技术文章" --need-content
579
+
580
+ # 保存结果到 JSON 文件
581
+ coze-coding-ai search "AI 研究" -o results.json
582
+
583
+ # 不同输出格式
584
+ coze-coding-ai search "Python" --format table # 表格格式(默认)
585
+ coze-coding-ai search "Python" --format simple # 简单文本格式
586
+ coze-coding-ai search "Python" --format json # JSON 格式
587
+ ```
588
+
589
+ **搜索类型说明:**
590
+
591
+ - `web` - 普通网页搜索(默认)
592
+ - `image` - 图片搜索
593
+ - `web_summary` - 网页搜索 + AI 智能摘要
594
+
595
+ **高级过滤选项:**
596
+
597
+ - `--count, -c` - 返回结果数量(默认 10)
598
+ - `--summary, -s` - 启用 AI 摘要(仅 web 类型)
599
+ - `--need-content` - 仅返回有正文的结果
600
+ - `--need-url` - 仅返回有原文链接的结果
601
+ - `--sites` - 指定搜索的站点范围(逗号分隔)
602
+ - `--block-hosts` - 屏蔽的站点(逗号分隔)
603
+ - `--time-range` - 发文时间范围(1d, 1w, 1m)
604
+ - `--output, -o` - 保存结果到 JSON 文件
605
+ - `--format, -f` - 输出格式(table, json, simple)
606
+
607
+ 更多 CLI 使用说明请查看 [CLI 文档](https://github.com/coze/coze-coding-dev-sdk/blob/main/packages/shell/README.md)
608
+
609
+ ## 📊 版本历史
610
+
611
+ 查看 [CHANGELOG.md](CHANGELOG.md) 了解详细的版本变更记录。
612
+
613
+ ## 🤝 贡献
614
+
615
+ 欢迎提交 Issue 和 Pull Request!
616
+
617
+ 查看 [CONTRIBUTING.md](CONTRIBUTING.md) 了解如何参与贡献。
618
+
619
+ ## 📄 许可证
620
+
621
+ 本项目采用 [MIT License](LICENSE) 开源协议。
622
+
623
+ ## 🙏 致谢
624
+
625
+ 基于 Coze AI Integrations 和豆包大模型构建。
626
+
627
+ ## 📞 联系方式
628
+
629
+ - 项目主页: https://github.com/coze/coze-sdk
630
+ - 问题反馈: https://github.com/coze/coze-sdk/issues
631
+ - 邮箱: support@coze.com
632
+
633
+ ## ⭐ Star History
634
+
635
+ 如果这个项目对你有帮助,请给我们一个 Star ⭐️
636
+
@@ -0,0 +1,58 @@
1
+ local_coze/__init__.py,sha256=OHRKPscxjSgythzmQpaXLcU5CaqSmCD9CeYt-IgQFgU,2399
2
+ local_coze/cli/__init__.py,sha256=mR6I-ofyv_QKCCsrc3Z4SeyF4pRAnFM4K3eV8KIRF98,100
3
+ local_coze/cli/chat.py,sha256=QLBauq4-p9OjDoa2BgkUuUcR2k25cwAxGd6Y_rNd9UQ,4180
4
+ local_coze/cli/cli.py,sha256=NUZSEjqU5_cEg7eaBOFsQvplft6NhDk0CVkCoa6yrmw,743
5
+ local_coze/cli/constants.py,sha256=VnVzOHbBZ44j86UCWvKAR0wrlCGqyuU2MjltZsLxCZw,119
6
+ local_coze/cli/db.py,sha256=ySLz5tj0G1XlZv0UJyCwQkpXkXywzoKl45a1fA7IJGI,2256
7
+ local_coze/cli/embedding.py,sha256=r3NLN6mBZOZUlZExj1NunhopdmMPouStGrvyokxOxeo,6263
8
+ local_coze/cli/image.py,sha256=8a4M2LcO9HSAjY--4ihpq764gGCoHjytuvVXilQ_Cck,5138
9
+ local_coze/cli/knowledge.py,sha256=WjmBYG81QYEkflZPekN5EQAB99W8Ykt_4uyrA4umOGs,5863
10
+ local_coze/cli/search.py,sha256=LKsplPMDQHILGUAr5wu2ARPVWYpQpu_FjjdFAVIAdf4,8130
11
+ local_coze/cli/utils.py,sha256=GkVHRrfVvMIfPQnQ9bngIZ3bgm6TwrdCr3CZ-5Enyv8,1116
12
+ local_coze/cli/video.py,sha256=kHIBNcdVdwnx5EPXAdkFfzJ0zXq4mqXUfBYfNVMVkv4,6695
13
+ local_coze/cli/video_edit.py,sha256=fJM4jvwIhWMekHxKHKXhEWjYzkHjalR3oeOULVn8lIM,31699
14
+ local_coze/cli/voice.py,sha256=ecz1YvXqsaP-Z4M-gjGR6Am-dF_M4BIgzc3qLOqTAqY,12111
15
+ local_coze/core/__init__.py,sha256=IEtDGYuzifulHEcx_McFJXulIcjNkQKEKLYfpAHoQPc,434
16
+ local_coze/core/client.py,sha256=TTF5ShvEMqTcwPe302ezwCA90uNnK3E0mxO5tfd9ZcY,8353
17
+ local_coze/core/config.py,sha256=DvI0Uq0XHEKDjY6PrbLEMcx7XLGFkmfiDBgQM2mdb2A,1922
18
+ local_coze/core/exceptions.py,sha256=R4l8famgq8OsdUd5Lp5Lxn9AGcLI8ArmYa43rrWB0Vk,1991
19
+ local_coze/database/__init__.py,sha256=KfL38xBh0eVNmir28g9j2iYZnCLX1VhGvz34zN8C8tQ,470
20
+ local_coze/database/client.py,sha256=D6adRymZTXDdPkJ1vp8TnjMgj9yCmlBreBmNUgVwEZ4,3915
21
+ local_coze/database/migration.py,sha256=BBog-rRX0RwKf0wl2r9VhsnSwq0_0343dvV6KZS7zqY,9892
22
+ local_coze/embedding/__init__.py,sha256=U_VMURrBZ4cS9y2JD13c7wwMgy67JqT5r5UIW3Hloiw,698
23
+ local_coze/embedding/client.py,sha256=RecyglpS1sdOIcY3IGQJcqSzD2REsh3QeJR8cBBoFvI,11181
24
+ local_coze/embedding/models.py,sha256=-eQLwQP4A8N_l0GE4a3hgcsKewAx8-JaLfPqSg5P7f0,5690
25
+ local_coze/image/__init__.py,sha256=gIrmP2AZcTGRl8Sn0ipix6vkeylPHrCQxdrV4B2xv5U,359
26
+ local_coze/image/client.py,sha256=wPBoRZb7VrBEe1LA2wmX0xXjw_tfYJG_vhUdzUOW71o,3988
27
+ local_coze/image/models.py,sha256=nGuZI3vdPWyo713XMfAwYHgzuCgmyjzz67rnD36noS0,5528
28
+ local_coze/knowledge/__init__.py,sha256=GtCmVKLsrLdMLiCBgjaHXdDkITIh0msd_Vx_DX032Y4,386
29
+ local_coze/knowledge/client.py,sha256=SdSST3Rx7IwKTHQMl9oTDBd1sZa4jm4jb_Gz3sszoUo,4811
30
+ local_coze/knowledge/models.py,sha256=BJsyP3z5sqLqBcHqfPyBJL-UjznEinOgr5Tiebc7egg,1826
31
+ local_coze/llm/__init__.py,sha256=07QVOn6_FbrRKizlGnNFUxhK5aezgn6qdtmppznFaRg,448
32
+ local_coze/llm/client.py,sha256=6EoUKnVBv6nIVEgd3AKLPC3m4cV1kV9PcZfqeJJmj-k,12100
33
+ local_coze/llm/models.py,sha256=ij4Uvr0AQ1GbbuHfI-uTxlus8d2QrcWE0cyXiJVEPAQ,1792
34
+ local_coze/memory/__init__.py,sha256=WdwARckCWRUPgIwp2FhsxnWVtdYcHcnjimcg0TEl4rg,181
35
+ local_coze/memory/client.py,sha256=OwbjZXEn0eqm9CpRE-Vdw7mMnf1Vsl_zV__gAtjs92U,5928
36
+ local_coze/s3/__init__.py,sha256=Rca0FvlulnQ5mmZc5o2-3rxyhZezzXL-CUrhpXtO4Ak,215
37
+ local_coze/s3/client.py,sha256=crlMVtKJ4dHE0pT6o9Q1A4YsJrRucvsHQb0RFFba7F0,21035
38
+ local_coze/s3/models.py,sha256=Ur4kxNXgzcX_9PteVM2ENHtdJd7bonbRvLOkCGYFebY,281
39
+ local_coze/search/__init__.py,sha256=N6Fwq-wHVE-S1oS-i6oUn36FGtPZmwYP9QTQSyytnFs,302
40
+ local_coze/search/client.py,sha256=LYfXHyjvkOYq1c2sgDYlfYLDUQdW511pbseYSZ4G81g,5756
41
+ local_coze/search/models.py,sha256=HYDhrTERN655F64Lt5_4xjDNt0wE6Y5GqJ36eySllug,2841
42
+ local_coze/video/__init__.py,sha256=Xcy44Pn3yjl3-N-RJeA2H1O1NKVnw8H024a7LeXs2HM,328
43
+ local_coze/video/client.py,sha256=j-P10dYWeyY0BZwbcsBkPF27DhtHKT1m2CMJgcNwrFc,13587
44
+ local_coze/video/models.py,sha256=-coe0mi4dCYgpkWR9UpwP9v8iKltJ830FHwKB7_Sock,1086
45
+ local_coze/video_edit/__init__.py,sha256=Y5CzLyWTukV5yv2muGuDnwpH_GTt_qrj0wY6dGr9BUQ,466
46
+ local_coze/video_edit/examples.py,sha256=5U05R9uCFn9Aq9dSDP-MV2CbqHZ4hwQJ7pXECj4zMCY,9236
47
+ local_coze/video_edit/frame_extractor.py,sha256=GT5_SLW_rDgpI_L9Zc6vHh2mqVm1VUr6G8DRctjKO4I,5348
48
+ local_coze/video_edit/models.py,sha256=1fol0qcztvtfeGx-n1scdkWQ271pYGwdrbyYvs5AXuI,15183
49
+ local_coze/video_edit/video_edit.py,sha256=lbzeNWNATJ22e6IQihiAnoYXI_2DIG96eLeU_Rrvp3A,21772
50
+ local_coze/voice/__init__.py,sha256=ecRvs8xtvYIc93Dcaqk9BCReUOOEt_HvhEMx_LcnagQ,262
51
+ local_coze/voice/asr.py,sha256=1qpz62SNR6xSFkfEn9_03WLZAm4BixzEHHfPIpAs9qc,2513
52
+ local_coze/voice/models.py,sha256=2jRh8enlupkyAHdfbRw0zdOPT3p0XD95OWSAg2_OysE,2787
53
+ local_coze/voice/tts.py,sha256=9GIzGXuESbG0VuhON0LJ1aoKniwW1zInrQkPuW_i2EU,3146
54
+ local_coze-0.0.1.dist-info/METADATA,sha256=cSsb5op0X3qsP-qLX9U8YqdcZeG_Us7oepQ3OujBbqI,17084
55
+ local_coze-0.0.1.dist-info/WHEEL,sha256=kJCRJT_g0adfAJzTx2GUMmS80rTJIVHRCfG0DQgLq3o,88
56
+ local_coze-0.0.1.dist-info/entry_points.txt,sha256=37kOTs7vjbu1CukoP1bEW71UwBBNOUI_CRQv6EqJaxs,54
57
+ local_coze-0.0.1.dist-info/licenses/LICENSE,sha256=RTlorGn8pATA9jBDus6j3KcNGKN0iVL0RYQw3NECCBo,1070
58
+ local_coze-0.0.1.dist-info/RECORD,,
@@ -0,0 +1,4 @@
1
+ Wheel-Version: 1.0
2
+ Generator: poetry-core 2.3.1
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
@@ -0,0 +1,3 @@
1
+ [console_scripts]
2
+ local-coze=local_coze.cli.cli:main
3
+