知客 v2.1.0 · 使用说明
=================================

知客在你自己的电脑上读取抖音作品评论，并只从你填写的业务问答或固定规则中匹配回复。
未明确命中时默认跳过；它不会调用外部大模型临时猜答案。

一、打开与首次准备
---------------------------------
· Mac Apple Silicon：双击「启动.command」。
· Windows x64（Windows 10 及以上）：双击「启动.bat」。若系统提示「Windows 已保护你的电脑」，点「更多信息 → 仍要运行」。
· 只支持通过启动脚本进入本机页面使用；包内 Python 文件是内部实现，不提供命令行或模块 API 支持。

首次打开需联网下载 Python 3.12、哈希锁定的依赖和 Chromium（约 3-6 分钟）。安装包自带固定版本运行器，不会执行远程安装脚本。准备完成后会打开 http://127.0.0.1:8300 。启动窗口关闭后，知客也会停止。

二、正确使用顺序
---------------------------------
1) 激活授权：粘贴授权码。授权会在激活、每次启动及运行中定期联网复核；运行中最长约有 1 小时的吊销状态刷新窗口。
2) 扫码登录：使用手机抖音 App 登录自己的账号；登录态只保存在本机。
3) 填业务问答：配置联系话术、作品问答和通用 FAQ。价格问题只有明确命中知识时才会回复。
4) 点「预览这轮」：检查作品、用户、原评论、拟回复和命中规则。
5) 确认无误后点「确认发送以上回复」。系统只会发送这批已审核内容；预览 15 分钟过期且只能用一次。

「每小时自动巡查」只会在活跃时段生成待审核预览，不会替你直接发送。活跃时段按北京时间（UTC+8）解释，适用于中国用户。

三、结果与防重
---------------------------------
· 已确认：平台页面出现成功提示、精确回复回显或回复数增加，才计为发送成功。
· 状态未知：计入当日安全上限，并阻止自动重试。请先到抖音评论区人工核对，再在发送账本中明确处理。
· 失败：不会冒充成功；重新预览后再决定是否发送。

默认额外护栏：每条随机间隔 6-15 秒、每天最多 50 条、北京时间 9:00-22:00。任何自动化都可能触发平台风控，护栏只能降低风险，不能保证账号安全。

四、本机数据、备份与清除
---------------------------------
在「业务问答 → 防封设置 → 本机数据」可查看数据位置、下载备份、恢复备份或清除本机数据。

· 业务数据：~/.douyin-profiles/
· 平台 Cookie：~/.douyin-cookies/
· 浏览器登录运行目录：~/.douyin-browser-profiles/
· 截图证据：~/.douyin-artifacts/
· Windows 上，以上 ~ 指你的用户文件夹（C:\Users\<用户名>\）。

备份包含业务知识、设置、配额、调度状态与发送账本；不包含抖音登录态、授权文件、浏览器运行目录、临时评论计划、一次性审核批次或可重建索引。临时评论计划 30 天后删除；已结束/过期审核批次 30 天后脱敏原文、90 天后删除。恢复后需重启知客。清除前应先下载备份；清除会同时移除业务数据、登录态和本机授权。

五、隐私边界
---------------------------------
业务问答、评论处理和发送账本默认留在本机，不上传给知客授权服务器，也不发送给外部大模型。授权服务会接收授权码、产品标识和本机设备标识，用于激活、设备绑定、到期/吊销判断及定期复核。软件会直接访问抖音创作者平台和首次安装所需的依赖/浏览器下载源。

六、常见问题
---------------------------------
· 页面打不开：确认启动窗口仍在运行，并检查 8300 端口是否被其他程序占用。
· 登录过期：重新扫码；不要复制 cookie 文件到其他电脑。
· 预览过期/已使用：重新预览，不能复用旧批次。
· 状态未知：先人工回读平台，禁止直接重试。
· 升级：先下载业务数据备份；覆盖程序文件不会覆盖 ~/.douyin-profiles/knowledge/ 下的用户知识。
· 卸载：先在界面清除本机数据，再删除知客程序文件夹。
