cb9b16e5a8
包含： - 核心配置文件（AGENTS.md, SOUL.md, USER.md等） - 记忆系统（memory/文件夹） - 技能库（skills/文件夹） - 小说内容（novel/文件夹） - .gitignore配置
94 lines
2.7 KiB
Markdown
94 lines
2.7 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.
|
||
|
||
---
|
||
|
||
## Feishu Tools Gotchas
|
||
|
||
### 📄 飞书文档更新限制
|
||
|
||
**单次更新长度限制**：约 1.5 万字
|
||
|
||
使用 `feishu_update_doc` 的 `overwrite` 模式时，如果文档超过约 1.5 万字，内容会被截断。
|
||
|
||
**长文档更新策略**：
|
||
1. **避免** `overwrite` 模式更新超长文档
|
||
2. **使用** `replace_range` 模式分章节更新（通过 `selection_by_title` 或 `selection_with_ellipsis` 定位）
|
||
3. **或采用** 删除后重新创建策略（先删除云文档，再用 `feishu_create_doc` 创建完整版本）
|
||
|
||
**最佳工作流**：
|
||
- 在本地完成所有修改（本地文件编辑更可靠）
|
||
- 使用章节定位方式分段更新到飞书
|
||
- 或者本地生成完整版本后一次性创建新文档
|
||
|
||
---
|
||
|
||
### 📝 飞书文档更新注意事项
|
||
|
||
**更新前必做检查**：
|
||
1. 先用 `feishu_fetch_doc` 读取完整文档，确认要更新的内容
|
||
2. 回顾前文，确保不会重复已知信息（视角一致性）
|
||
3. 确认内容格式正确（段落分隔、对话格式）
|
||
|
||
**避免重复已知信息**：
|
||
- 角色A已经经历过的事件，不需要角色B再告诉A
|
||
- 只传递接收者不知道的新信息
|
||
- 例如：第2章主角和所长一起查看了现场，第3章所长就不需要再说"我们去了你家，客厅很正常"
|
||
|
||
**内容格式规范**：
|
||
- 章节标题后必须空一行
|
||
- 每个对话必须单独成段：
|
||
```markdown
|
||
"对话内容，"他说。
|
||
```
|
||
- 段落之间必须空一行
|
||
- 每章末尾添加 `---` 分隔线
|
||
|
||
**精确定位更新**：
|
||
- 优先使用 `selection_with_ellipsis` 精确定位要替换的内容
|
||
- `selection_by_title` 可能定位到错误位置（导致内容重复）
|
||
- 复杂更新分步骤进行：先 `delete_range`，再 `insert_before`/`insert_after`
|
||
|
||
**更新后验证**：
|
||
- 再次用 `feishu_fetch_doc` 读取文档
|
||
- 确认内容正确，没有重复
|
||
- 确认格式规范（段落分隔、对话格式）
|
||
|
||
---
|
||
|
||
Add whatever helps you do your job. This is your cheat sheet.
|