💡 知识卡片
原始会话经 LLM 提炼后的结构化知识。比原始会话更好读、更好搜。
问答
dsh_watcher推送机制与接口
问题：需要理解 dsh_watcher 如何把 DSH 会话同步到 NAS，以及推送失败时如何定位。
方案：启动时先执行 push_existing：遍历 find_sessions(dsh_root) 找到每个 session 目录下的 session.v4.jsonl.zstd，读取字节后 POST 到 {nas_url}/sync/{employee}/{sid}，请求头带 Authorization: Bearer <token>、Content-Type: application/octet-stream，超时 60s；返回 200 记为成功并打印大小，非 200 打印状态码与前 200 字符响应，异常打印 error。之后用 watchdog Observer 递归监听 dsh_root 持续推送；--once 时推完即退出。
问答
DSH会话同步watcher无日志排查
问题：dsh_watcher 进程在运行，但 dsh_watcher.admin.out.log / .err.log 均为 0 字节，没有推送日志，怀疑进程未正常启动或未执行推送。
方案：1) 确认日志路径为 D:\nas-data\logs\dsh_watcher.<employee>.log（logger 名为 dsh_watcher:<employee>）；2) 检查启动参数：--employee、--nas-url、--token（或 .secrets.json 中的 sync_token，缺失会直接 sys.exit(1)）；3) 确认 --dsh-root 路径存在，否则只告警不推送；4) 用 --once 参数手动跑一次，观察 push_existing 是否输出“扫描现有会话”“pushed <sid>”“初始化推送完成”等日志，以区分是启动失败还是仅等待新事件。
问答
清理残留 dsh_watcher 进程与任务计划
问题：NAS 上存在多个残留的 dsh_watcher 进程和重复的 Windows 任务计划：alice 账号已不存在仍在监听，ehong001 的 watcher 指向 Tailscale 内网地址 100.121.80.122 但本机未装 Tailscale 导致推送失败。
方案：1) 杀掉所有 dsh_watcher 进程（按 PID 逐个 kill，如 9616、11292、3128）；2) 删除旧任务计划（schtasks 删除 NAS-DSH-Watcher-admin、NAS-DSH-Watcher-ehong001 等重复项）；3) 重新启动干净的 ehong001 watcher，--nas-url 指向 http://127.0.0.1:9000；4) 重新安装任务计划；5) 用 monitor.py 验证各服务 running/healthy 状态。
问答
同机测试 dsh_watcher 会重复归档
问题：在同一台 NAS 上为 ehong001 安装 dsh_watcher 做测试时，两个 watcher 读取相同的 DSH 会话文件，同一会话会被同时打上 alice 和 ehong001 标签，产生重复归档。
方案：本地仅用于验证链路可以接受重复；生产环境应让每个员工在自己的电脑上运行 dsh_watcher --employee <工号>，各自只归档本机会话，避免同一会话被多实例重复采集。