# dingtalk-agent

**Repository Path**: oky/dingtalk-agent

## Basic Information

- **Project Name**: dingtalk-agent
- **Description**: 钉钉个人助理
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-07
- **Last Updated**: 2026-02-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 钉钉个人智能助理（无服务器版）

> 基于 **阿里云函数计算（Function Compute）** + **通义千问（Qwen）** + **钉钉机器人**  
> ✅ 无需管理服务器｜✅ 月成本约 ¥3｜✅ 支持自然语言设置提醒｜✅ 未来可对接业务数据库

## 🌟 核心功能

- **智能问答**：调用 Qwen-Turbo 回答各类问题（如“如何写周报？”）
- **任务提醒**：理解自然语言，自动解析时间并确认（如“明天下午3点开会”）
- **安全私有**：所有交互仅在你的钉钉群内，数据不外泄
- **平滑扩展**：预留 PostgreSQL / SQL Server 接口，未来可查销售、用户、订单等业务数据

---

## 🚀 部署指南

### 1️⃣ 前置准备

- **阿里云账号**（已实名认证）
- **钉钉企业内部应用**（个人可免费创建）
- **本地开发环境**：
  - 安装 [Node.js](https://nodejs.org/)（LTS 版本）
  - 安装 Serverless Devs 工具：
    ```bash
    npm install -g @serverless-devs/s
    ```

### 2️⃣ 获取必要密钥

| 密钥 | 获取方式 |
|------|--------|
| **DashScope API Key** | 登录 [DashScope 控制台](https://dashscope.console.aliyun.com/apiKey) → 创建 API Key |
| **钉钉 AppSecret** | 登录 [钉钉开发者后台](https://open-dev.dingtalk.com/) → 创建「企业内部应用」→ 添加「机器人」→ 查看 **AppSecret** |

> 🔐 请妥善保管密钥，切勿泄露！

### 3️⃣ 配置本地项目

```bash
# 克隆本项目（或手动创建文件）
git clone https://gitee.com/你的用户名/dingtalk-agent.git
cd dingtalk-agent

# 复制环境变量模板
cp .env.example .env

# 编辑 .env，填入你的密钥（示例）：
# DASHSCOPE_API_KEY=sk-xxxxxxxxxxxxxxxx
# DINGTALK_APP_SECRET=your_dingtalk_secret_here
```

### 4️⃣ 一键部署到阿里云

```bash
s deploy
```

✅ 成功后你会看到类似输出：
```text
URL: https://xxxxx.cn-hangzhou.fc.aliyuncs.com/2023-09-01/proxy/dingtalk-agent-service/agent-handler/
```

### 5️⃣ 配置钉钉机器人回调

打开 钉钉开发者后台
进入你的「企业内部应用」→ 「机器人」
在 事件订阅 区域：
请求地址（URL）：粘贴上一步的 URL
加签密钥：填写 .env 中的 DINGTALK_APP_SECRET
点击「确认」保存
⚠️ 钉钉要求 URL 必须是 HTTPS —— 阿里云 API 网关已自动满足！


### 6️⃣ 测试你的助理

在钉钉群中添加该机器人，并发送：
提醒我每周一上午9点发周报
你将收到回复：
✅ 已设置提醒：
内容：提醒我每周一上午9点发周报
时间：待确认（当前版本暂不支持周期性，但会记录）
或问：
Qwen 和 GPT 有什么区别？
助理将调用 Qwen 给出专业回答。
🔒 安全与隐私
.env 文件已加入 .gitignore，不会被提交到 Gitee
所有通信走阿里云内网（FC → DashScope），安全高效
钉钉消息通过 HMAC-SHA256 签名验证，防止伪造请求


## 📝 未来计划

🔹 接入结构化存储（Table Store）
存储待办事项、用户偏好
实现“查看今日所有提醒”
🔹 对接业务数据库
PostgreSQL / SQL Server：取消 utils/db_client.py 中的注释即可
示例查询：“上个月华东区销售额是多少？”
🔹 定时任务（EventBridge）
每日 9:00 自动推送待办清单
每周一自动生成周报草稿


## 🛠️ 项目结构说明

```text
dingtalk-agent/
├── s.yaml              # Serverless Devs 部署配置
├── .env.example        # 环境变量模板（重命名为 .env 使用）
├── src/index.py        # 主逻辑入口（处理钉钉消息）
└── utils/
    ├── dingtalk.py     # 钉钉签名验证 & 消息发送
    ├── task_parser.py  # 自然语言时间解析（规则+关键词）
    └── db_client.py    # 数据库接口（含 PostgreSQL/SQL Server 示例）

```

## ❓ 常见问题
Q：能用个人微信吗？
A：不推荐。个人微信机器人有封号风险。企业微信或钉钉更稳定、合规。
Q：费用高吗？
A：日常使用基本在免费额度内，月成本通常 < ¥5。


## 📝 免责声明

- 本项目仅供学习和研究使用，请勿用于商业用途
- 本项目不包含任何个人隐私信息，仅用于展示技术实现
- 本项目不保证长期稳定运行，请自行备份和迁移数据


Made with ❤️ for your intelligent, serverless personal assistant.