chore: update project configuration and documentation

- Add 'dist/' to .gitignore to exclude build artifacts.
- Rename entry point from 'feishu-agent' to 'lark-agent' in pyproject.toml.
- Introduce a new installation guide document for the Lark Agent, detailing packaging and installation methods.

Author: liangyz

.gitignore

@@ -5,4 +5,5 @@ __pycache__/
 .pytest_cache/
 .env
 .vscode/
-.serena/
+.serena/
+dist/

doc/打包编译指南.md

@@ -0,0 +1,210 @@
+# Lark Agent 打包编译指南
+
+## 📦 打包方式
+
+### 方式一：构建 Wheel 包（推荐）
+
+使用 `uv` 构建分发包：
+
+```bash
+# 构建 wheel 包
+uv build
+
+# 构建结果会在 dist/ 目录下
+# 例如: dist/lark_agent-0.1.0-py3-none-any.whl
+```
+
+### 方式二：构建源码分发包
+
+```bash
+# 构建源码分发包（sdist）
+uv build --sdist
+
+# 构建结果会在 dist/ 目录下
+# 例如: dist/lark-agent-0.1.0.tar.gz
+```
+
+### 方式三：同时构建 wheel 和 sdist
+
+```bash
+# 构建所有格式的分发包
+uv build
+
+# 这会同时生成 wheel 和 sdist
+```
+
+---
+
+## 🚀 安装方式
+
+### 从本地构建的包安装
+
+```bash
+# 安装本地构建的 wheel 包
+uv tool install dist/lark_agent-0.1.0-py3-none-any.whl
+
+# 或从源码安装
+uv tool install dist/lark-agent-0.1.0.tar.gz
+```
+
+### 从 Git 仓库安装（发布后）
+
+```bash
+# 从 GitHub 安装
+uv tool install --from git+https://github.com/Wulnut/feishu_agent lark-agent
+
+# 安装特定版本/tag
+uv tool install --from git+https://github.com/Wulnut/feishu_agent@v0.1.0 lark-agent
+```
+
+---
+
+## 🔧 开发模式安装
+
+### 可编辑安装（开发时使用）
+
+```bash
+# 在当前环境中以可编辑模式安装
+uv pip install -e .
+
+# 这样修改代码后无需重新安装即可生效
+```
+
+---
+
+## 📋 构建前检查清单
+
+1. ✅ **版本号**: 确认 `pyproject.toml` 中的版本号正确
+2. ✅ **依赖**: 确认所有依赖都已正确声明
+3. ✅ **入口点**: 确认 `[project.scripts]` 配置正确
+4. ✅ **测试**: 运行测试确保代码正常
+   ```bash
+   uv run pytest
+   ```
+5. ✅ **代码质量**: 运行 lint 检查
+   ```bash
+   uv run ruff check .
+   ```
+
+---
+
+## 🎯 完整发布流程
+
+### 1. 更新版本号
+
+编辑 `pyproject.toml`:
+```toml
+[project]
+version = "0.1.0"  # 更新为新版本
+```
+
+### 2. 提交更改
+
+```bash
+git add .
+git commit -m "chore: bump version to 0.1.0"
+```
+
+### 3. 创建 Git Tag
+
+```bash
+git tag -a v0.1.0 -m "Release v0.1.0"
+```
+
+### 4. 构建分发包
+
+```bash
+# 清理旧的构建文件
+rm -rf dist/ build/ *.egg-info
+
+# 构建新包
+uv build
+```
+
+### 5. 验证构建结果
+
+```bash
+# 查看构建的文件
+ls -lh dist/
+
+# 应该看到类似：
+# lark_agent-0.1.0-py3-none-any.whl
+# lark-agent-0.1.0.tar.gz
+```
+
+### 6. 测试安装
+
+```bash
+# 在临时环境中测试安装
+uv tool install dist/lark_agent-0.1.0-py3-none-any.whl
+
+# 测试命令是否可用
+lark-agent --version  # 如果支持的话
+```
+
+### 7. 推送到远程仓库
+
+```bash
+# 推送代码和 tag
+git push origin main
+git push origin v0.1.0
+```
+
+---
+
+## 📦 发布到 PyPI（可选）
+
+如果需要发布到 PyPI：
+
+```bash
+# 安装构建工具
+uv pip install build twine
+
+# 构建包
+uv build
+
+# 上传到 PyPI（需要先配置 credentials）
+twine upload dist/*
+```
+
+---
+
+## 🔍 验证安装
+
+安装后验证：
+
+```bash
+# 检查命令是否可用
+which lark-agent
+
+# 检查 Python 模块是否可导入
+python -c "from src.mcp_server import main; print('✓ OK')"
+```
+
+---
+
+## ⚠️ 注意事项
+
+1. **构建系统**: 确保 `hatchling` 已正确配置在 `[build-system]` 中
+2. **包结构**: 确保 `[tool.hatch.build.targets.wheel]` 中指定的包路径正确
+3. **依赖锁定**: 如果使用 `uv.lock`，确保锁定文件是最新的
+4. **版本号**: 遵循语义化版本规范（Semantic Versioning）
+
+---
+
+## 🐛 常见问题
+
+### 问题：构建失败，提示找不到包
+
+**解决方案**: 检查 `[tool.hatch.build.targets.wheel]` 配置，确保 `packages = ["src"]` 正确
+
+### 问题：安装后命令不可用
+
+**解决方案**:
+- 检查 `[project.scripts]` 配置
+- 确保 `~/.local/bin` 在 PATH 中（Linux/macOS）
+- 确保 `%USERPROFILE%\.local\bin` 在 PATH 中（Windows）
+
+### 问题：导入模块失败
+
+**解决方案**: 检查 `src/` 目录结构，确保所有 `__init__.py` 文件存在

pyproject.toml

@@ -17,7 +17,7 @@ dependencies = [
 ]
 
 [project.scripts]
-feishu-agent = "src.mcp_server:main"
+lark-agent = "src.mcp_server:main"
 
 [dependency-groups]
 dev = [