my-assistant/TOOLS.md

TOOLS.md - Local Notes

Skills define how tools work. This file is for your specifics — the stuff that's unique to your setup.

What Goes Here

Things like:

• Camera names and locations
• SSH hosts and aliases
• Preferred voices for TTS
• Speaker/room names
• Device nicknames
• Anything environment-specific

Examples

### Cameras

- living-room → Main area, 180° wide angle
- front-door → Entrance, motion-triggered

### SSH

- home-server → 192.168.1.100, user: admin

### TTS

- Preferred voice: "Nova" (warm, slightly British)
- Default speaker: Kitchen HomePod

Why Separate?

Skills are shared. Your setup is yours. Keeping them apart means you can update skills without losing your notes, and share skills without leaking your infrastructure.

---

Add whatever helps you do your job. This is your cheat sheet.

钉钉应用配置（企业内部应用）

用于操作日历、查看日志、文档等企业钉钉功能。

AgentId: 4404185308
Client ID (AppKey): dingklemniq8uqk5qbgx
Client Secret (AppSecret): _8EHgyhvHRHRMx6fZbh9LNpQoxyYl3At0b-fXXlQiahwupbt9oY5P6Grj8IM9Dx8

钉钉 API 注意事项

⚠️ 时间参数单位：毫秒（ms）

钉钉绝大名接口的时间参数（如 start_time、end_time、created_at 等）都是毫秒，不是秒！

• ❌ 错误：1743206400（秒）
• ✅ 正确：1743206400000（毫秒）

⚠️ 字段命名：全小写 userid

很多接口参数名是 userid（全小写），不是 userId（驼峰）。具体以接口文档为准。

日志查询

参考文档：https://open.dingtalk.com/document/development/query-logs-sent-by-an-employee

详细调用方式见 skill：skills/dingtalk-log/SKILL.md

MCP 服务配置

已配置 3 个钉钉 MCP 服务：

钉钉文档

• URL: https://mcp-gw.dingtalk.com/server/fcf2405ec27cd4428220e0515ff8e04ee52ba7e11578aabbd1ef57651ad9c4d4?key=70fb66762bdf5b10a304a3d1a270aebb
• 用途：飞书云文档操作（创建/读取/写入/管理文档和表格）

钉钉MCP (MCP1)

• URL: https://mcp-gw.dingtalk.com/server/6efc2da975c4393ba3ad307bad77180a09e28f0c660b247bf0b2258804dc034b?key=1ef173d18cfc53aec32435c06a06908b
• 用途：日历/日程管理
• 主要工具：
  • create_calendar_event - 创建日程
  • list_calendar_events - 查询日程列表
  • get_calendar_detail - 获取日程详情
  • update_calendar_event - 修改日程
  • delete_calendar_event - 删除日程
  • add_calendar_participant - 添加参与人
  • query_busy_status - 查询用户闲忙状态
  • query_available_meeting_room - 查询空闲会议室

钉钉MCP2 (MCP2)

• URL: https://mcp-gw.dingtalk.com/server/d0050f4b18d11aa780d304f2707e7bbb24794237a4f0a41d0f1dfdb40bc8bd27?key=ec174881fd525c64726e41b22892a7cf
• 用途：通讯录/用户管理
• 主要工具：
  • get_user_info_by_user_ids - 批量获取用户详情
  • search_user_by_key_word - 搜索成员
  • search_user_by_mobile - 通过手机号获取成员
  • get_sub_depts_by_dept_id - 获取子部门
  • get_dept_members_by_deptId - 获取部门下所有成员
  • search_dept_by_keyword - 搜索部门
  • get_current_user_profile - 获取当前用户详情
  • search_contact_by_key_word - 搜索好友和同事

钉钉待办

• URL: https://mcp-gw.dingtalk.com/server/e594739312cbde234b7d9fcfbe0badd0e797d46dd401fa93e71b6338fd2d0aa6?key=7f8ad91c1f1b50cdd4b896a29803a64b
• 用途：待办事项管理
• 主要工具：
  • create_personal_todo - 创建个人待办
  • get_user_todos_in_current_org - 查询个人待办列表
  • query_todo_detail - 查询待办详情
  • update_todo_task - 修改待办任务
  • update_todo_done_status - 修改待办完成状态
  • delete_todo - 删除待办

⚠️ 钉钉功能与工具映射规则

钉钉功能	操作工具
钉钉文档	钉钉文档 MCP
钉钉日程	钉钉日程 MCP
钉钉待办	钉钉待办 MCP
钉钉通讯录	钉钉通讯录 MCP
其他钉钉操作	通过相应 skill 调用 API

腾讯企业邮箱配置

用于接收和读取企业邮件。

IMAP 服务器: imap.exmail.qq.com (SSL, 端口993)
SMTP 服务器: smtp.exmail.qq.com (SSL, 端口465)
邮箱账号: lgc@77ircloud.com
密码: bVPPcg6XgB7qRPw7

重要提醒人： fj@77ircloud.com 的邮件需要重点关注

⚠️ 邮件操作安全规则

只读不删！ 严禁执行任何删除邮件的操作，包括但不限于：

• 删除单封邮件
• 删除文件夹
• 标记删除
• 清空回收站

所有邮件操作仅限：阅读、搜索、导出。