ChatLark 0.1.1

ChatArch Feishu/Lark bot helpers extracted from ChatTool.

English | 简体中文

ChatLark

ChatArch 的 Feishu/Lark bot helper 包，承接从 ChatTool 拆出的轻量机器人、消息发送、事件服务和消息内容构造能力。更广泛的 Feishu/Lark OpenAPI 操作仍优先使用官方 lark-cli。

快速开始

pip install -e ".[dev]"
chatlark --help
chatlark --version
chatlark send --help
chatlark serve --help
python -m pytest -q
python -m build

CLI

chatlark info
chatlark send USER_ID "Hello"
chatlark send "Hello"                  # 使用 FEISHU_DEFAULT_RECEIVER_ID
chatlark send -t chat_id "Hello team" # 使用 FEISHU_DEFAULT_CHAT_ID
chatlark serve echo
chatlark serve webhook

模型调用相关命令暂不放入 ChatLark 的默认命令面；需要模型 backend 的 bot 编排会在后续单独设计，避免重新引入 ChatTool 或其他 LLM runtime 硬依赖。

Python API

from chatlark import LarkBot, ChatSession

bot = LarkBot()
session = ChatSession(system="你是助手")

@bot.on_message
def chat(ctx):
    ctx.reply(session.chat(ctx.sender_id, ctx.text))

bot.start()

配置

ChatLark 复用 ChatEnv 的 Feishu 配置字段：

• FEISHU_APP_ID
• FEISHU_APP_SECRET
• FEISHU_API_BASE
• FEISHU_DEFAULT_RECEIVER_ID
• FEISHU_DEFAULT_CHAT_ID

可通过环境变量直接提供，也可以通过 -e/--env 指定 ChatEnv Feishu profile 或 .env 文件。

边界

• ChatLark：bot helper、消息发送、事件服务、消息上下文、消息内容构造。
• lark-cli：广泛 Feishu/Lark OpenAPI 操作和用户授权流程。
• ChatTool：迁移完成后只应保留有意设计的兼容入口或依赖连接，不再重复持有 Lark business logic。

开发说明

扩展前先阅读 DEVELOP.md 和 AGENTS.md。发布走 PyPI Trusted Publisher/OIDC workflow，不使用本地 token 上传正式版本。