83 lines
2.5 KiB
Markdown
83 lines
2.5 KiB
Markdown
# 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 服务配置
|
||
|
||
已配置两个钉钉 MCP 服务，用于日程和通讯录操作：
|
||
|
||
### MCP1 - 钉钉MCP
|
||
- URL: `https://mcp-gw.dingtalk.com/server/6efc2da975c4393ba3ad307bad77180a09e28f0c660b247bf0b2258804dc034b?key=1ef173d18cfc53aec32435c06a06908b`
|
||
- **用途**：日程管理（创建/查询/修改/删除日程、会议室预约）
|
||
|
||
### MCP2 - 钉钉MCP2
|
||
- URL: `https://mcp-gw.dingtalk.com/server/d0050f4b18d11aa780d304f2707e7bbb24794237a4f0a41d0f1dfdb40bc8bd27?key=ec174881fd525c64726e41b22892a7cf`
|
||
- **用途**：备用/其他 MCP 工具
|
||
|
||
### ⚠️ 重要：日程和通讯录操作必须通过 MCP 服务
|
||
- **日程操作**（创建会议、查询日程等）→ 使用 MCP1 的 `create_calendar_event` 等接口
|
||
- **通讯录操作**（查询用户、部门等）→ 使用 MCP 服务
|