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

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

一、打开与首次准备
---------------------------------
· 当前发行包未使用商业代码签名，macOS 也未做 Apple 公证。首次打开请先阅读《!!首次打开必读.txt》，按系统提示主动确认来源；不要关闭系统安全功能，也不要执行移除 quarantine 的命令。
· Mac Apple Silicon：首次右键（触控板双指点按）「启动.command」→「打开」；若仍被拦，到「系统设置 → 隐私与安全性」选择「仍要打开」。以后可直接双击。
· Windows x64：完整解压后双击「启动.bat」；若 SmartScreen 提示，选择「更多信息 → 仍要运行」。如果 Windows 11 的 Smart App Control 直接阻止，当前未签名版无法运行；不要关闭系统安全功能，请联系购买渠道处理。
· 只支持通过对应平台的「启动.command」或「启动.bat」进入本机页面使用；包内 Python 文件是内部实现，不提供命令行或模块 API 支持。

首次打开需联网准备 Python 3.12.11、哈希锁定的依赖和固定版本 Chromium（约 3-6 分钟）。Windows 浏览器只从 Playwright 官方 CDN 下载，并在解压前后核对固定 SHA-256；安装包自带固定版本运行器，不会执行远程安装脚本。准备完成后会打开 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/

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

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

首次激活还会在授权服务创建不可变的最小确认记录，包括软件版本、激活请求 ID、条款标识/版本、摘要版本、四点摘要与三份完整说明的 SHA-256、确认方式/时间和设备标识的 SHA-256 摘要；该确认记录不包含原始授权码、原始设备标识、IP 地址、浏览器 User-Agent 或条款全文。

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