Skip to content

dsh-hive-queen

Verified

dsh-hive-queen · v0.4.24 · MIT · Web UI

单包蜂巢协作内核:可配置五阶段、任意角色真实圆桌、独立评审、工牌预算、DAG 并行、候选沉淀与梦境;保留人格、记忆和多渠道能力。

Install

dsh plugin add dsh-hive-queen

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

dsh-hive-queen(蜂巢 · 蜂后)

一个 DeepSeek Harness 单包插件:蜂后是拥有独立人格与私人记忆的个人助理,同时管理可配置的任务型 AI 员工。协作内核提供五阶段闭环、真实圆桌、独立评审、工牌、预算、绩效、DAG 并行、Ticket、事务 Outbox、分域记忆和可复现评测。

  • 许可:MIT;移植代码及第三方 notice 见 NOTICE
  • 已适配宿主:DSH 0.2.2-rc.1
  • Node:>=24.9.0
  • 核心协作不依赖 fish-soul、Redis、Graphiti、桌面控制服务或其他蜂巢插件

本文件对应 0.4.24 文档修正版,发布状态以 npm registry 回读为准。完整源码回归为 154/154。0.4.23 已通过 qwen3.7-max、qwen3.7-plus 与 deepseek-flash 的两轮六贡献真实圆桌,零角色失败且无执行副作用。早期版本还通过了真实 NAS 的 Nginx 临时站点、WAF 自检恢复、IPTV、阿里云专用 A 记录写入/删除、元宝混合圆桌、双视口设计渲染、本地 H.264 组装和本机独立进程 A2A;这些是历史验收,不冒充本版逐项回归。Token Plan、三 Qwen 同场、智谱/豆包网页免费对话、手机实机、生成式媒体、音频、公开发布和跨机器 A2A 仍未闭合,不能宣称已全面替代 V21.2。详见验收矩阵。

0.4.24:Token Plan 与浏览器前置条件复核

  • 收回 0.4.23 文档中“Token Plan 401 根因已经完全确定”的过度断言。最新对照使用 DSH 当前保存的同一条凭证直连两个端点:Token Plan 返回 401 invalid_api_key,普通百炼返回 HTTP 200 和 OK。这证明当前保存值与 Token Plan 端点不匹配,不证明用户打算使用的 Token Plan Key 本身失效,也不是蜂巢或 DSH 路由造成的鉴权失败。
  • 正式与隔离 DSH 当前保存值一致,均为 35 字符、sk- 开头且无首尾空白。需在「设置-模型」复核实际保存的是否为控制台 Token Plan 专属凭证,再重跑 Token Plan;不能用普通百炼成功替代该项验收。
  • 智谱中国站和豆包均已做真实浏览器前置检查:当前浏览器显示未登录。智谱发送后要求手机号验证码登录;豆包点击发送及回车均未发出对话,登录窗口提供扫码、手机号和飞书方式。两项都没有收到模型回答,免费网页额度仍为 verified:false。证据为 v0.4.24-browser-free-model-precheck.json。

0.4.23:关联记忆与混合模型圆桌

本版参考 icyaaaww/dsh-soul 2.x 的关联记忆思路自研实现,不依赖该插件:

  • 同域同主体的一跳关联回捞,只有真实共同回捞才建立 coactivated 关系;单纯展示不增加使用次数。
  • 记忆替换保留历史版本,旧节点归档并记录 supersedes/superseded_by;归档或被取代内容不再扩散。
  • 私域正文仍需所属用户授权,组织记忆替换仅允许 memory-admin;新内容仍需通过候选激活门。
  • 新增 associativeRecall、dynamics、privateMemoryEnabled、privateMaxItems、privateMaxChars 配置。动力学默认关闭,避免改变既有相关性/时间排序。

普通百炼按量付费路由 https://dashscope.aliyuncs.com/compatible-mode/v1 已通过官方 llm.stream 真实返回正常结束与 TokenUsage;这项结果不能替代 Token Plan 验收。

推理模型在 DSH 子代理的结构化工具输出中会同时消耗思考与回答 Token。本轮 4096 上限多次出现 max-tokens,提高到 16384 后才完成两轮圆桌。建议按模型实测调整角色 maxTokens、roundtable.maxTokensPerRole 和日预算,不要把单模型短回答成功当作完整圆桌成功。三 Qwen 同场本轮仍未通过;最终通过的是两位 Qwen 加 DeepSeek 的降级组合。

官方能力复用

插件优先调用当前 DSH profile 已挂载的官方服务,不另建一套模型或凭证数据库:

  • 设置-模型、Provider 目录和模型路由
  • 官方 credentials 凭证服务
  • Session、子代理与真实 TokenUsage 查询
  • 官方插件管理器的版本查询与包更新

蜂巢只保存角色到 provider/model 的引用。目录中未列出模型不等于路由一定无效;实际执行前仍通过官方 LLM 服务解析。未知 Token 或费用保持未知,不按零结算。

可配置协作内核

在「蜂巢 → 开始 → 协作内核」中配置:

  • 角色与工牌:角色数量、人格、参与阶段、参与模式、模型、工具权限、并发和预算不限于内置三角色。
  • 五阶段:需求理解、预测调研、决策拆分、任务执行、自动化沉淀逐段配置;必需阶段不能通过关闭来绕过。
  • 圆桌:显式请求或复杂度等条件激活,支持多角色、多轮、并行和分歧保留。生产默认要求不同实际模型;单模型验收必须显式豁免,不能把豁免当成独立模型证据。
  • 独立评审:默认排除生产者,按结构化评分和返工上限决定是否通过。
  • DAG 调度:依赖、并发、资源锁、失败阻断、预算预留与真实用量结算。
  • 沉淀与梦境:候选记忆和技能候选分开;梦境默认关闭。技能候选必须经过冻结评测与人工激活,模型不能自行激活。
  • 更新与恢复:人工选择官方列出的兼容版本,先备份 SQLite 与配置,再调用官方更新。更新查询超时默认 50 秒,可在 5–120 秒内配置并即时生效。数据恢复只生成下次启动请求,重启前不覆盖运行中的数据;包版本回滚使用官方 CLI 安装旧版本,更新接口不用于降级。

默认任务只规划。真实模型调用、DAG 执行、高风险动作、公开发布、凭证使用、桌面动作等分别授权;高风险动作仍需人工审批。

记忆边界

  • 蜂后私域按用户隔离,拥有独立人格和私人记忆。
  • Worker 只读取任务所需上下文,不继承蜂后私域或其他任务正文。
  • 组织记忆与任务记忆分域;两段检索先过滤索引,再在授权后读取正文。
  • 评测 checkpoint 和脱敏 Trace 不进入长期记忆。

包内还保留了来自上游项目的旧人格、多渠道、形象和运维模块。这些继承能力不等于 V3 外部生态已全部验收;其配置与平台风险以对应设置页为准。

外部适配器的真实边界

媒体短剧、设计质量、上下文观测、桌面控制、MCP 和 A2A 提供统一适配契约,外部执行默认关闭:

  • 媒体:保留短剧模板、局部重生成规划和规则降级草稿。hive_media_request/hive_media_assemble 可把有界文字场景经一次性人工审批组装为本地 H.264 视频;FFmpeg 使用参数数组,FFprobe 与完整解码独立回读并保存 SHA-256。可配置 FFmpeg、FFprobe、中文字体、输出目录和超时。该能力不是生成式视频或音频生成,也不提供公开发布快捷路径;公开平台发布仍需单独能力与授权。
  • 设计:hive_design_request/hive_design_render 对静态 HTML 提供一次性人工审批和隔离浏览器渲染。自动发现 Edge/Chromium,也可配置可执行文件、输出目录和超时;桌面与手机双视口检查标题、字体、响应式、对比度、键盘、溢出、控制台和交互,独立回读 PNG。拒绝页面脚本、事件与远程资源;这不是生产网站发布器,也不接受模型自评作为渲染证据。
  • 上下文:区分官方实测 Token 与字符估算;预算和去重可用不代表所有模型、所有压缩场景都已验收。
  • 桌面:通过 hive_desktop_snapshot、hive_desktop_request、hive_desktop_execute 完成观察、申请和执行。动作要求白名单、最新 UIA ref、一次性人工审批和动作后独立回读;窗口标题由服务端策略固定。本机专用 WPF 窗口已验证审批前零写入、真实文本回读和重放拒绝。
  • 桌面模型客户端:自动发现元宝、豆包、Trae 只生成候选,不伪造登录或控件状态,也不会自行导入或启用配置。not-running/window-not-visible 表示进程或窗口前置条件未满足,needs-selectors/needs-import/needs-enable 引导后续配置;已启用且选择器完整时显示 needs-verification,仍须真实快照与任务回读,不能当作已可参会。用户确认输入、发送和输出选择器后,可让桌面客户端中的当前模型作为独立圆桌角色;同一 Provider 下的不同模型则直接复用官方模型目录。网页客户端可配置 outputScope:'append',只解析本次提示后的新回答。元宝已完成真实两轮参会,但其他客户端仍需各自验收。
  • MCP:复用官方 @deepseek-ai/dsh-mcp-client,只允许人工配置的服务器/工具白名单;每次调用都需要独立人工审批,审批绑定目标与参数且只能消费一次。
  • A2A:hive_a2a_request/hive_a2a_invoke 仅调用预配置的目标与操作白名单,审批绑定目标、操作和输入且只能消费一次。支持回环 HTTP,非回环必须 HTTPS;校验 Bearer、请求关联、对端身份、超时和有界响应,回执写入可配置 outputRoot。本机独立 Node 进程已完成批准前零调用、双侧回执和防重放验收;这只是 Hive JSON 协议闭环,不代表跨机器远程部署或 Google A2A 认证。

NAS 与本地服务入门

插件可直接管理受控 SSH 目标,不依赖 fish-soul 或另一套运维服务。每个目标可独立选择 openssh-alias、password 或 private-key,配置主机、端口、用户、SHA-256 主机指纹和 sudo。密码与私钥密码只从环境变量读取,不要写进 JSON、工单或 Git。

建议按以下顺序使用:

  1. 先用 hive_local_service_status 和 hive_local_service_inspect 做只读盘点,确认端口、Compose 文件、容器名和健康地址。
  2. 在目标 actions 中只开放需要的动作;Nginx 站点新增/删除、WAF 切换、IPTV 单服务部署、DDNS 更新和删除分别申请一次性人工审批。删除必须同时匹配完整域名、记录类型与当前 IP,且只能有一条精确匹配记录,删除后回读为空才算成功。
  3. 执行后检查插件回读与独立证据。失败回滚不等于原变更成功,旧 watchdog 未停用前不要开启插件 DDNS 周期调度。只读巡检的 verified:true 表示 API 回读成功;记录是否存在看 checks[].exists,记录是否齐全看 applied.recordsComplete。Provider 可能限制 TTL,验收所用的阿里云账号已实际拒绝 300 秒、接受 600 秒。
  4. 密钥更新只走 DSH 官方 credentials。自动发现元宝等桌面客户端只生成候选,取得真实窗口选择器并完成授权回读后才可参会。

当前真实 NAS 已验证 Nginx 临时站点、WAF 专用自检规则恢复和 IPTV;阿里云专用 A 记录也已验证真实写入、独立回读和删除,并在结束后清理。自动 DDNS 仍禁用,旧 watchdog 未停用,这不等于生产域名已全面迁移。完整配置字段和证据边界见验收矩阵。

手机端:官方通道已接入,实机仍待验收

插件使用 DSH 官方连接通道 @deepseek-ai/dsh-api-remote-access 提供受控会话访问,不另开匿名 HTTP 监听。手机发起的本地服务写操作沿用同一套一次性人工审批,模型不能自行批准。

hive_local_service_status 当前明确返回 mobile.verified:false、anonymousListener:null 和 verificationRequired:'real-mobile-session-and-independent-readback'。这表示官方接口与访问控制已接入,不表示真实手机会话已经验收。只有完成手机只读任务、受控部署申请、人工批准和 NAS 独立回读后,才能把实机链路标为通过;桌面浏览器的手机视口和本机回环 HTTP 均不能替代实机证据。

MCP 最小配置

先在 DSH profile 中用官方客户端配置服务器。以下是本地 stdio 示例;远程服务器可改用官方 streamable-http:

- id: mcp-local
  name: '@deepseek-ai/dsh-mcp-client'
  config:
    serverName: local
    transport: stdio
    command: node
    args: ['<你的 MCP 服务绝对路径>']
    toolCallTimeoutMs: 60000

再在蜂巢协作配置中只开放确实需要的工具:

{
  "adapters": {
    "mcp": {
      "enabled": true,
      "servers": [{ "name": "local", "tools": ["search"] }]
    }
  }
}

调用分三步:hive_mcp_request 创建审批,人类在审批入口批准,最后用 hive_mcp_invoke 和 approvalId 执行。模型不能自批,不能修改已批准的服务器、工具或参数,也不能重用审批。适配器只有在当前进程完成一次真实官方调用后才显示 available;重启后需要重新验证,不能把“配置过服务器”当作健康证明。

本包未复制 dsh-guizang-design 的 AGPL 代码;dsh-superagent-prototype 仅作理念参考,不是运行时依赖。真实多模型与 V21.2 替代边界见 验收矩阵。

安装

dsh plugin --profile <你的档案> add dsh-hive-queen

也可在 DSH 官方插件管理界面安装。安装后重启对应档案,在蜂巢的模型页选择或新增 Provider;密钥只写入官方 credentials,界面不会回显。

网络盘或 Windows 环境若无法创建 pnpm 符号链接,可在官方命令后转发 pnpm 参数,并把 store 放在工作区内:

dsh plugin --profile <你的档案> add dsh-hive-queen \
  --store-dir <工作区内存储目录> --package-import-method=copy --node-linker=hoisted

工具

核心注册 hive_task_plan、hive_task_run、hive_roundtable、hive_review、hive_dream、hive_memory_list、hive_budget_status、hive_performance、hive_model_catalog、hive_adapter_status、hive_media_request、hive_media_assemble、hive_design_request、hive_design_render、hive_desktop_snapshot、hive_desktop_request、hive_desktop_execute、hive_mcp_request、hive_mcp_invoke 和 hive_update_check 等工具。工具描述明确区分只读查询、规划、真实模型调用和执行授权。

开发

npm run build
npm test
npm run verify:package
npm pack --ignore-scripts

src/core/ 是协作内核源码,src/client.core.js 是其设置界面;构建会同步到 lib/。其余继承模块直接以 lib/ 为源码。自动化测试和 mock 宿主不能替代真实 DSH 验收,真实验收也不能替代来源与许可证审计。

第一次参与项目请阅读 贡献指南,其中包含蜂后与员工的区别、最小贡献流程、安全约束和证据分级。

诚实边界

人格、情绪、生活和梦境是状态模拟、策略偏置与表达生成,不代表真实主观感受。插件不会把计划伪报为已执行、把未知用量写成零、把单模型圆桌伪报为多模型独立评审,或把候选技能自动当作已验证能力。