# 拉片知识库（Video Breakdown KB）

## 目录索引
- `01-拉片笔记/` — 单条视频拉片笔记：儿童安全教育 / 剧情短片 / 广告 / 其他
- `02-音频与台词/` — 台词转写、配音、音乐分析
- `03-技巧库/` — 可复用技巧：镜头.md / 节奏.md / 钩子.md / 音乐.md / 字幕.md
- `04-素材索引/索引.md` — 所有素材的总表
- `templates/拉片模板.md` — 新建笔记模板

## 命名规范
`YYYYMMDD-平台-标题.md`，UTF-8 编码，front-matter 填写 标签。

## Agent 查询方式（HTTP，只读）
- 浏览器（Accept: text/html）访问 `.md` → 渲染为排版好的 HTML（侧栏目录树、面包屑、目录、表格、图片、视频）。
- 原始 Markdown：`GET /<路径>.md?raw=1`，或请求头 `Accept: text/markdown`；不带 `text/html` 的客户端（curl/脚本）默认也返回原文（text/markdown; charset=utf-8）。
- 搜索（JSON，给 Agent）：`GET /search?q=关键词` → `{"q":..., "count":N, "results":[{"path","line","text"}]}`（大小写不敏感，最多200条）。
- 搜索（HTML，给人看）：`GET /search.html?q=关键词` 或 `/search?q=关键词&format=html`。
- 图片/视频等文件原样返回，支持 HTTP Range（mp4 可拖动播放）。
- 建议流程：先读 `/README.md?raw=1` → `/search?q=标签或技巧` → 读取命中文件全文（`?raw=1`）。
- 写入：HTTP 只读（POST/PUT/DELETE 返回 405）；新增笔记需直接在 C:\KB 中按模板创建文件。