douyin-chat-insight

Douyin Chat Insight（抖音聊天转知识库）

一句话

把用户已经拥有的聊天导出，变成一页可执行情报（Chat → Insight）。

何时使用

• 用户提供群聊/私聊 JSONL / JSON / 文本导出，要提炼价值、需求、矛盾、待办
• 社群主理人要「需求原话墙」而不是凭感觉运营
• 与公开作品分析（creator-insight）对照：主页承诺 vs 群里真实问题

何时不要使用（路由）

硬边界

• 不在 skill 内登录 IM、扫码、读 cookie、启 Docker 导出器
• 不把第三方导出器打进安装依赖
• 主路径：零阿里百炼 AppKey
• 若检测到兄弟 skill 或 DASHSCOPE_API_KEY：只展示，不读取收藏账本、不抢 browser profile、不强制复用
• 可选 ASR 端口：聊天中的抖音链接默认只识别；用户要转写时给配置指导，不在核心 run.py 强制云调用

状态机（必须遵守）

输入路径
  → load_export
  → inventory（概况表）
  → 【停止】等待用户指定：会话# / 会话名 / 人物
  → 仅当显式 --conv（或等价指定）才 analyze
  → quality_gate
  → 写 HTML / MD / JSON

没有会话对象，禁止直接深挖全库「假装已完成」。

标准命令

python3 scripts/doctor.py
python3 scripts/setup.py
python3 scripts/setup.py --check --json
python3 scripts/run.py -i <导出文件或目录>
python3 scripts/run.py -i <导出> --conv 1 --owner-alias '群主昵称'
python3 scripts/run.py -i <导出> --conv 1 --person '某人' --json

报告默认目录：output/douyin-chat-insight/（可用 -o 改）。 人类终端会打印「本机打开」绝对路径；JSON 内路径已脱敏。

Agent 话术

首次：

我可以分析你自备的聊天导出，生成需求原话与动作清单。请给我文件路径。 不需要登录聊天软件，也不需要阿里百炼 Key（除非你还要对消息里的抖音链接做转写）。

仅有路径、用户未指定会话：

先出概况表。请回复要深挖的会话编号，例如：会话 #1。

用户要爬群：

我不能替你登录或静默采集。你可以自己导出后把文件给我；可选工具说明见 references/how-to-get-exports.md。

用户要分析抖音链接：

文字四块报告不依赖百炼。链接转写是可选增强，见 references/optional-douyin-link-asr.md。

质量门

• inventory 会话非空
• 深挖必须显式会话对象
• 四块不能全空
• 不在报告/仓库写入 cookie、token、私人绝对路径

发布前本机：python3 scripts/doctor.py（期望 RESULT: READY）。

输出约定

• hard_facts / open_contradictions / demand_quotes / actions
• optional_enhancements：抖音链接端口状态与中文指导
• meta.note：启发式草稿，须终审

版本

v0.1.5 · MIT · 源码 https://github.com/tars1230/douyin-chat-insight