Dingtalk-to-AI-Skill

通过钉钉群聊远程控制本地 AI CLI（OpenCode 或 Claude Code），在手机上随时随地与 AI 编码助手交互。

安装 Skill

方式一：Claude Code Plugin 安装（推荐）

/plugin marketplace add dreamor/dingtalk-to-ai-skill
/plugin install dingtalk-bridge

方式二：使用 npx skills 安装

cd /path/to/your/project
npx skills add dreamor/dingtalk-to-ai-skill

安装后可使用：

/dingtalk-bridge setup    # 交互式配置
/dingtalk-bridge start    # 启动桥接服务
/dingtalk-bridge stop     # 停止桥接服务
/dingtalk-bridge status   # 查看状态
/dingtalk-bridge logs [N] # 查看日志
/dingtalk-bridge doctor   # 诊断问题

手动安装

git clone https://github.com/dreamor/dingtalk-to-ai-skill.git ~/.claude/skills/dingtalk-bridge

功能特性

• 双 AI Provider：OpenCode CLI + Claude Code CLI
• 流式卡片：AI Card 打字机效果实时输出
• 多轮对话：自动管理会话上下文
• 项目记忆：跨会话保留关键信息
• 媒体处理：语音转文字、图片描述
• 多 Agent 路由：根据规则自动选择 Provider
• 生产级：消息去重、并发控制、自动重试、SQLite 持久化

系统架构

钉钉群聊 → Stream SDK → Gateway → 消息队列 → 路由 → AI CLI → 流式卡片 → 钉钉群聊
                              ↓              ↓
                        SQLite 持久化    项目记忆

项目结构

src/
├── dingtalk/          # 钉钉集成（Stream + AI Card 流式卡片）
├── gateway/           # HTTP 网关（健康检查、队列消费、重试）
├── opencode/          # OpenCode CLI 执行器
├── claude/            # Claude Code CLI 执行器（持久化会话）
├── agents/            # Agent 适配器注册中心
├── commands/          # 聊天命令（/help, /status, /model 等）
├── session-manager/   # 会话管理（TTL、历史）
├── message-queue/     # 消息队列（并发控制、流量限制）
├── router/            # 多 Agent 路由
├── scheduler/         # Cron 定时任务
├── memory/            # 项目记忆（自动摘要）
├── media/             # 媒体处理（语音、图片）
├── display/           # 显示过滤
├── storage/           # SQLite 持久化
├── health/            # 健康检查
├── logger/            # 结构化日志
└── utils/             # 工具函数

快速开始

git clone https://github.com/dreamor/dingtalk-to-ai-skill.git
cd dingtalk-to-ai-skill
npm install && npm run build
cp .env.example .env   # 编辑填入钉钉凭证

配置 .env：

DINGTALK_APP_KEY=your_app_key
DINGTALK_APP_SECRET=your_app_secret
AI_PROVIDER=opencode   # 或 claude

启动：

bash start.sh          # PM2 生产模式
# 或
npm run dev            # 开发调试

聊天命令

命令	说明
/help	显示所有可用命令
/status	显示系统状态
/model	查看/切换 AI 模型
/mode	查看/切换权限模式
/history [N]	显示最近 N 条对话
/stop	终止当前 AI 执行
/list	列出所有会话
/switch <id>	切换到指定会话
/queue	显示消息队列状态
/config	显示当前配置
/reset	重置当前会话
/remember <key> <value>	保存记忆（预留）

AI Provider 选择

Provider	适用场景	安装方式
opencode	日常聊天对话	npm install -g opencode
claude	项目开发任务	brew install anthropic/claude/claude

配置

完整配置说明见 .env.example，主要配置项：

变量	必填	默认值	说明
DINGTALK_APP_KEY	是	-	钉钉应用 AppKey
DINGTALK_APP_SECRET	是	-	钉钉应用 AppSecret
DINGTALK_ALLOW_FROM	否	*	允许的用户ID，逗号分隔
AI_PROVIDER	是	opencode	AI 提供者：opencode 或 claude
CLAUDE_PERMISSION_MODE	否	default	Claude 权限模式
SESSION_TTL	否	1800000	会话过期时间（ms）
SESSION_IDLE_RESET_MINS	否	30	空闲轮转阈值（分钟）
DISPLAY_MODE	否	compact	显示模式：full/compact/quiet
STREAMING_ENABLED	否	true	启用流式卡片输出
PERSISTENT_SESSION_ENABLED	否	true	启用持久化会话

API 接口

接口	方法	描述
/health	GET	健康检查
/api/status	GET	系统状态
/api/doctor	GET	诊断检查
/api/sessions	GET	会话统计
/api/queue	GET	队列状态
/api/test	POST	测试消息处理

开发

npm run build          # 编译 TypeScript
npm run dev            # 开发模式 (ts-node)
npm test               # 运行测试
npm run test:coverage  # 覆盖率报告
npm run lint:fix       # 代码检查并修复

License

MIT License - 查看 LICENSE 文件