# 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

```markdown
### 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.

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

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

```markdown
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 (MCP1)
- **通讯录/用户/部门** → 使用 钉钉MCP2 (MCP2)
- **待办操作** → 使用 钉钉待办
- **文档操作** → 使用 钉钉文档
