AIBanlv Harness Companion

让 Harness 的工作进度，有个熟悉的身影。

给 DeepSeek Harness 的透明桌面伴侣：在你写代码、等任务时，用人物气泡、表情与互动陪你工作，也能随手查看 DeepSeek 余额。无需 AIBanlv 账号，不安装推理模型。

English · AI 安装提示词 · 开始试用 · 详细指南 · 常见问题 · 路线图 · 了解 AIBanlv

Windows x64 已验证 · 面向 Harness 0.2.1-rc.2 · 早期预览，当前从源码运行。尚未发布独立安装器或上架插件市场。与 DeepSeek 无官方隶属关系。

先看它能做什么

你正在做什么	伴侣会怎样陪你
Harness 正在思考、输出、完成或失败	跟随真实任务状态，用一句人物台词和表情提示
同时处理多个 Harness 会话	自动跟随最近启动的任务，或在控制中心固定一个会话
想知道等了多久、完成了几轮	查看当前任务耗时与本次完成／异常／取消统计，仅保留在内存
等待长任务，暂时切到其他窗口	人物常驻透明桌面，可置顶、隐藏、调整大小
想让伙伴有自己的性格	切换温柔、活泼、沉稳；支持昵称与公共 3D / 原创 SVG 形象
想轻松互动一下	全桌面视线与头部跟随，轻点、长按和连续抚摸反馈
切走窗口后想知道任务结果	可选完成／异常系统通知，无声音、无任务正文，点击返回伴侣
想让桌面多一点氛围	可选人物底部柔光粒子，支持公共 3D 和 SVG，隐藏时暂停
想知道 DeepSeek 还剩多少余额	可选 API / 账号钱包查询，三位小数、每分钟更新

AIBanlv 公共形象「婉儿」的实机截图；动图由思考、回复、完成三个状态截图组成。任务与余额为合成演示数据，不调用模型。素材来源见展示素材说明。

使用同款形象：点击齿轮 → 角色形象选择 → 加载 / 刷新公共 3D 形象 → 上官婉儿。首次需联网下载，资源说明见形象说明。

插件默认使用本地人物台词。可选沿用 Harness 当前模型生成一句人物总结，开启后每轮最多多一次模型请求，沿用宿主用量。没有系统语音播报，也不驱动说话嘴型。

快速试用

让 Harness 帮你安装

把这句话发给 Harness：

帮我安装 https://github.com/Zzzzhy1/aibanlv-harness-plugin 的插件。

供 AI 执行的具体步骤见安装指引。

手动试用

准备 Windows x64、Node.js 22.18+ 的 22 系列或 24 LTS、npm 10.9.2。从本仓库 Code → Download ZIP 下载并解压，在解压后的项目根目录打开 PowerShell：

npm ci --ignore-scripts
node node_modules/electron/install.js
npm run setup:desktop
npm run demo

demo 不需要 Harness、模型 Key 或 AIBanlv 账号，通过本机合成任务演示思考 → 回复 → 完成。首次安装仍需联网下载依赖与 Electron；退出演示可在伴侣菜单中退出，或在终端按 Ctrl+C。

接入你的 Harness

结束演示后，在项目根目录运行：

npm run start:desktop

已有 Harness 桌面版时，优先使用上面的 AI 安装方式，安装到当前 profile。 使用 CLI 试用时，另开一个能运行 dsh 和 pnpm 的终端，进入同一项目根目录：

$pluginPath = (Get-Location).Path
dsh plugin --profile web add $pluginPath
dsh --profile web

web 自带浏览器聊天界面。首次使用时，按 Harness 的流程配置自己的模型，再发起任务。 伴侣显示“已连接 Harness”后即可跟随任务。web 与桌面版的 desktop 是不同 profile。 任意新建的 companion-test 默认只有基础服务，不能直接作为聊天入口。

齿轮打开独立控制中心：选择形象、性格、安静模式或开启余额。demo 使用合成任务，不读取真实钱包；接入自己的 Harness 后，开启余额才查询真实数据。升级后重载宿主插件并重启伴侣。连接、卸载和排错详见完整指南与FAQ。

“状态与总结”可开启系统通知，“角色形象选择”可开启柔光粒子，两项默认关闭并记住选择。 “连接与状态”可选择跟随会话、查看计时和本次工作回顾；默认自动跟随最近启动的任务。 通知实际显示受 Windows 通知／勿扰设置影响；粒子在系统减少动态效果时静止显示。

控制中心预览（演示余额）

你的数据会去哪里

• 默认只转发状态，公开回复原文需要显式开启；内部推理与工具参数不会发送到桌面。
• 跟随、触控和基础表情在本机运行，不记录或上传鼠标轨迹。
• 余额查询默认关闭；Key 只由 Harness 宿主向固定 DeepSeek 官方接口鉴权，金额只在内存展示。
• 可选人物总结使用当前模型提供方；点击官网入口才打开浏览器，不发送任务或身份信息给 AIBanlv。

具体边界与本机文件位置见数据说明。

插件与 AIBanlv

这个插件专注于 Harness 工作陪伴，状态、表情、互动和余额可以独立使用，无需注册 AIBanlv。喜欢这种表现形式，想进一步了解实时语音、数字人定制等体验，可以前往 AIBanlv。具体能力及开放情况以官网为准。

想创建自己的数字人？下载 AIBanlv 手机 App，体验形象定制。形象页也提供这个入口；当前插件不提供本机形象包导入，也不承诺 App 定制形象自动同步到插件。

一起完善

如果它让你等任务时更轻松，欢迎点一个 Star，方便关注更新。遇到问题请带上复现步骤提交 Issue；也欢迎分享桌面搭配、人物台词或提交改进。

优先方向见路线图，开发方法见CONTRIBUTING，更新见CHANGELOG。开源代码和原创 SVG 使用 MIT；公共 3D、AIBanlv 动画素材与商标有独立权利边界，详见资源说明。