dsh-vod-devkit
v0.5.26
Published
VOD user-voice collection tools for DeepSeek Harness (dsh). Thin shell over the VOD external HTTP API — mirrors vod-devkit (MCP) collect semantics.
Maintainers
Readme
dsh-vod-devkit
VOD 用户声音采集插件 —— DeepSeek Harness (dsh) 薄壳。
形态
- 纯采集:3 工具(
vod_submit_voices/vod_list_submitted/vod_devkit_info) - 插件=引擎客户端,只走 HTTPS(VOD external API),不 import 任何引擎模块
- 与 vod-devkit(MCP 形态,同仓
../vod_mcp)语义对齐:- voiceId = f(source, content, 调用级 nonce):同调用幂等、跨调用保声量
- 归因=运行期从用户原话解析(引擎产品名录别名,含中文/长别名),唯一命中才采信; 优先级:字面证据 > 记忆(30 分钟)> 配置 product 先验 > 未知(引擎 UNKNOWN 池)
- 多产品命中=歧义 → 不带 product 上送(宁可人工归因,不可错归;与 vod_mcp 同口径)
- 无 key/401 → POST /external/token 零字段匿名令牌 → 本地落盘 → 重试一次
- 本地账本 data/runtime.json(cap 200 环形,读改写只动目标键)
安装
npx --yes vod-devkit install --target dsh --profile <name> [--product <产品>] # 推荐(--product 可选先验;给了即硬校验)⚠️ 不要用
dsh plugin add dsh-vod-devkit裸装:只装插件本体不写配置—— apiBase/uiBase 缺失时工具半不可用、UI 提交会发往 dsh 同源(404 → 本地暂存 发不出去,嵌入方真机实锤)。裸装后补救:跑一次上面的 npx 命令即可(幂等)。 product 不再是必填:归因默认从用户原话解析,配置值只是无证据时的先验。
装后配置落在 profile 的 cordis.patch.yml(npx 包装命令自动写入):
- id: vod-devkit
config:
product: '' # 可选先验(无字面证据且无记忆时兜底);归因主路径=用户原话解析
# apiBase: https://vod-dev.topxtopx.com # 工具半(Node 服务端)用,缺省即此
# uiBase: https://vod-dev.topxtopx.com # 浏览器半(反馈按钮)直连用,缺省即此UI 半(反馈按钮)部署前提——二选一
- uiBase 直连(默认,本包形态):浏览器直接请求 uiBase 指向的引擎地址。
依赖:引擎侧 CORS 允许 dsh 页面源(本地 dsh 为
http://127.0.0.1:<port>)。 引擎 CORS 收敛(白名单制)落地时,白名单必须含 dsh 本地源,随其上线同步验证。 - 宿主代理(嵌入方自建,可选):由 dsh 部署侧把
/external/*反代到引擎, 此时 uiBase 可留空走同源。当前 dsh 不自带此代理,默认勿依赖。
配置(dsh 插件设置)
| 字段 | 默认 | 说明 | |---|---|---| | apiBase | https://vod-dev.topxtopx.com | VOD external API 基址(工具半/服务端用) | | uiBase | 同 apiBase | 浏览器半(反馈按钮)直连基址;同源代理形态可留空 | | apiKey | (空) | 缺省走零字段匿名令牌;灰度期可用运营签发 key | | product | (空) | 可选归因先验(如 codearts):仅在无字面证据且无记忆时生效;空=完全靠原话解析,歧义落 UNKNOWN | | confirmWrites | true | 写操作走 dsh 审批通道(tools/pre-execute → ask) | | timeoutSec | 30 | HTTP 超时 |
安全
- apiKey 标记
.role('secret'):不跨 wire 回传,展示一律 sha1[:8] 指纹 - 写操作默认弹确认;单批 ≤50;content ≤2000 逐条校验
