novel-doomsday-resurgence/.novel-sync-temp/TOOLS.md
唐天洛 5dc8c00de0 feat(sync): 固化小说内容到Git仓库
📚 小说内容:
- 《末日重生-开局囤货十亿物资》33章
- 完整的状态文件、记忆索引、钩子系统

🛠️ 系统配置:
- 版本控制管理系统
- 自动化脚本系统
- 质量监控系统

🧠 固化记忆:
- 长期记忆文件
- 系统配置文档
- 恢复流程指南

💾 数据安全:
- 本地备份系统
- Git版本控制
- 远程同步机制

同步时间: 2026-03-30 16:25:35
系统状态: inkos正常运行中 (PID: 1433309)
创作进度: 第33章《油粮》创作中
2026-03-30 16:25:35 +08:00

94 lines
2.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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