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