Mieksido/surfcore
效率与系统工具让 DSH agent 拥有持久身份,能在 QQ 聊天、逛B站,并作为桌宠出现。
SurfCore 是给 DeepSeek Harness(DSH)用的 Windows 专用附加组件:它让模型拥有人格卡、会衰减的记忆卡、作息、QQ 与 B站 账号,以及可选的桌面分身。它不是通用“把大模型接进 QQ”的机器人框架——agent 会自己判断要不要看、要不要说、引用谁、何时收尾潜水,并在配置的作息和额度内行动。
工作机制
系统由两个进程协作。DSH 插件 surfcore 提供设置页、B站 调度、记忆维护、额度统计和桌宠接口;独立桥接进程 src/bridge.js 通过 SnowLuma 处理 QQ 收发、会话映射、本机控制台和三个 MCP server。一条 QQ 消息经 OneBot 进入,变成 DSH 会话,回复再回到 QQ。默认的 reserved2 模式把一切变成工具调用:agent 自己看消息、发言、等待或潜水,并留下“下次怎么接”的记录(README 概览、架构)。
记忆分成会衰减并进入提示词的记忆卡,以及只追加、永不遗忘的全量卡;QQ、B站、桌宠三个场景写入同一套记忆,定期摄取。chat 模式让 agent 使用受限的白名单工具,closed-agent 只服务管理员并可用完整 DSH 工具,两个 reserved 模式则模拟群友(日常使用)。
要求与范围
- Windows 10/11、Node ≥ 22.13、DSH 0.2.1-rc.2 或更新(rc.3 能装但功能未完整回归);QQ 部分还需要 SnowLuma2。SnowLuma2 是第三方专有运行时,本项目不下载、不安装、不打包,登录与扫码由你自己完成(安装指南)。
- 只有 QQ 路径需要 SnowLuma;B站、记忆和桌宠可以不用它,但 DSH 始终必需。
- 语音可选,走 surfvoicelocal 或 surfvoicecloud;桌宠是独立的 Electron 应用 surfpet。AI 发语音默认关闭。
- 必须从仓库根目录安装,不能只装
plugins/surfcore;装完要刷新 DSH 页面。README 说明旧版本(≤ 0.6.18)无法自动更新。
边界与安全
白名单为空表示谁都不响应,而不是全部放行。控制台只接受带令牌的本机回环请求;不可逆删除会先隔离到 _backups/。项目不承诺在语义层完全防住提示注入,而是把工具白名单和白名单当作真正的边界。运行时数据留在本机,但拼进提示词的文本会发往模型 API(安全摘要、边界说明)。
HotRepo 点评
2026-10-28 的新项目榜(JavaScript)记录为 107 总星、#25;所给样本没有日榜历史,因此无法说明热度走势。这是一个与 Windows 和 DSH 深度绑定的年轻项目,适用范围具体而狭窄,尚未得到广泛验证。
本文由 AI 根据项目 README 生成,更新于 2026年10月28日,以项目官方文档为准。