dsh-ai-ball

如果你在跑 DeepSeek Harness 或其它能接工具的 Agent，却希望用户能看见它在「说话」、有表情、还能在悬浮球里打字回传，单靠终端日志往往太冷。ai-ball 是一颗 Windows 上的悬浮球，通过读写在固定路径上的几个文件来呈现独白、心情和输入；dsh-ai-ball 则是 Harness 侧极薄的一层桥接：不操控窗口、不替你拉起 Python，只把球已经在盯着的 monologue.log、status.json、input.log 写好，让任意进程都能当球的「大脑」。

插件提供说话、改心情、开关独白面板、增量读取输入、查看接线状态以及按配置启动球等能力。设计上刻意只认文件：ball_status 反映的是磁盘上的状态而非窗口是否在跑，ball_say 也不会自动弹出面板——要让人看见，需要先显式打开面板。ball_mood 在写入心情的同时会持续刷新心跳，避免球把过期心跳当成「大脑已死」而整颗变灰盖住表情；若你还跑着自带的 brain.py，需要在 brain 配置里保留 mood 字段，避免和插件抢写 status.json。

适合已经或打算单独部署 ai-ball 本体、想把悬浮球接到 Harness Agent 上的 Windows 用户：本地助手、演示、陪跑式交互，或任何希望 Agent 有「一张嘴」、而不是只在聊天框里刷字的场景。插件不包含球本身，也不会猜测你把球解压到哪——ballDir 必须配置清楚，写错目录就是写错文件，这是有意为之的安全边界。