郊狼体感剧情 NanamiKite/Coyote-x-dsh

郊狼xDSH（Coyote x DSH）

让每一段剧情都留下切身印象。

AI 接入的体感文字冒险 MCP 插件。
AI 主持场景包驱动的角色扮演剧情，用实时文字状态推进故事，并通过郊狼 Coyote V2/V3 外置反馈设备执行有界物理反馈增强沉浸感。

免责声明

重要：本项目仅供技术研究、软件开发与个人实验使用。

本插件会通过 BLE 控制兼容设备输出电脉冲。用户应充分了解所连接设备及其输出特性，并自行确认设备适用于当前使用场景。

本项目作者及贡献者不对因使用本插件、修改源码、连接第三方设备、设备故障、协议实现差异、配置错误、武装状态下的执行、异常断连或其他不可预见情况所造成的任何直接或间接损失、设备损坏、人身伤害或其他后果承担责任。

插件内置的强度、时长、波形及协议范围限制属于软件层面的安全措施，不构成对设备实际输出或使用安全性的保证。不同硬件、固件版本及设备状态可能导致实际行为与软件预期存在差异；不得仅依据本插件中的限制判断设备是否安全。

使用前请确认：设备处于可控状态；已阅读制造商安全说明；已正确配置本地规则上限；能随时运行 tentacle_stop 或 node bin/arm.js off 立即停止。

如出现异常输出、无法停止或任何不确定情况，应立即停止使用并断开设备。使用本项目即表示你理解并接受上述风险。

安装（即插即用）

dsh内插件选择github仓库安装或本地选择本地clone下来的仓库文件夹安装即可。

运行示例

安全配置不调小心被电飞（本人不耐电所以默认数值比较低（（（推荐：在 DSH Web 的插件管理器里直接调。 Web GUI → 插件管理器 → 本包（coyote-x-dsh）→ tentacle 行的配置按钮 → 六字段表单（强度、强度上限、单次时长、时长上限、冷却、通道）：

- 表单由本包的浏览器半侧渲染——它往插件管理器的 plugins.row.config 槽位注册 coyote-x-dsh#tentacle 这一行的配置页；
- 六个字段在插件 Config 中标注为 .volatile()：保存即完整 schema 校验（越界直接拒绝）、即持久化到 profile 的 cordis.patch.yml、即时生效——不重挂插件、不重启、不中断正在运行的有界反馈（当前计划按启动参数跑完即止，下一次执行用新值）；
- backend 不在表单内（换后端需要重建控制器），改它编辑 YAML 即可（loader 自动重挂，先归零）。

其余方式（等价，任选）：字段写在 cordis.patch.yml （包内，重启生效）或 profile 同 id 覆盖行（热重载）的 config: 里，由 src/plugin/index.mjs 导出的 Config schema 校验：越界值直接拒绝，不是静默钳制。

| 字段 | 默认 | 硬上限 | 含义 |
| backend | ble | ble / mock | 真机 BLE 或无硬件调试 |
| channel | A | A / B / AB | 输出通道 |
| intensity | 20 | 0–200 | 默认强度挡位（协议 S = 挡位 × 7） |
| maxIntensity | 40 | 200 | 强度天花板：招式计划只能被钳到更低 |
| durationMs | 1500 | 100–30000 | 默认单次时长 ms |
| maxDurationMs | 5000 | 30000 | 时长天花板 ms |
| cooldown | 10 | 0–3600 | 两次反馈之间的冷却秒数 |

即使有人改 YAML 抬参，下面两层仍然独立钳制：rules.planMove()（0–200 挡位、 ≤30000 ms、Z ≤15）与 CoyoteSafety（挡位 0–200、协议 S ≤2047、时长 ≤5000）。

安全模型（三层 + 门禁）

1. 本地武装（arm）门禁 —— 输出工具默认锁定。只有在设备所在电脑运行
node bin/arm.js on [--minutes N]（默认 30 分钟）后 AI 才能执行反馈；
node bin/arm.js off 立即撤销；到期自动失效。AI 无法自行武装。
2. 规则钳制 —— rules.planMove() 把招式计划钳制在本地强度/时长/通道上限内；场景包与 AI 都无法抬高上限。波形 Z 值自动 ≤15。
3. 设备层 Safety —— CoyoteSafety 独立钳制 App 挡位 0–200、协议 S ≤ 2047、协议值 = 挡位 × 7 的防御检查，即使绕过上层也无法越界。

另外：

- FeedbackRuntime 串行写入队列 + 取消纪元：tentacle_stop 之后在途写入全部失效；
- 截止时间先于第一个异步 BLE 调用设定，到时必归零；
- 每次执行有冷却（可配置）；
- tentacle_stop 永远可用：不需武装、不受冷却限制；
- 断开 / 插件卸载 / 退出时自动归零并断开连接（含热重载换实例）。

武装工作流

powershell里执行：
cd "$env:USERPROFILE\.dsh\profiles\web"
.\node_modules\.bin\tentacle-arm.CMD on --minutes 30
或对话中让AI引导你在本机终端执行：

找不到路径时怎么自己定位 profile 名不一定是 web，换成你自己的那个就行；实在不确定就搜一下：

Get-ChildItem "$env:USERPROFILE\.dsh\profiles" -Directory | Select-Object Name
Get-ChildItem "$env:USERPROFILE\.dsh" -Recurse -Filter arm.js -ErrorAction SilentlyContinue | Select-Object FullName

指令示例：
node bin/arm.js on --minutes 30 # 设备电脑上武装（AI 无法代替）
node bin/arm.js status # 查看剩余时间
node bin/arm.js off # 立即撤销
profile 安装后也可在 profile 目录用：npx tentacle-arm on

武装文件默认在用户主目录 ~/.tentacle-arm.json：本机任意安装副本（git clone、profile 内的包、node_modules）读写的都是同一文件，「A 处武装、B 处加载」不会错位。可用 TENTACLE_ARM_FILE 显式改路径。
AI 请求执行反馈时若返回「未武装」，请自行运行上命令后再让它继续。

非 DSH 宿主：stdio MCP 回退

其他 MCP 客户端（Codex / Claude Code 等）可直接用 stdio 入口： yaml 客户端的 MCP 配置 mcpServers: tentacle: command: node
args: ['/path/to/Coyote-x-dsh/src/mcp/server.js']
env:
TENTACLE_BACKEND: ble # 无硬件调试时改为 mock 可选规则覆盖（stdio 模式专用，语义同上表）： TENTACLE_MAX_INTENSITY: '40' TENTACLE_MAX_DURATION_MS: '5000' TENTACLE_COOLDOWN_S: '10' TENTACLE_CHANNEL: 'A' # A / B / AB TENTACLE_RULES_JSON: '{"intensity":20,"maxIntensity":40}'

加载后模型会看到 mcp__tentacle__tentacle_status 等工具（该前缀由 mcp-client 生成；进程内 bundle 模式无此前缀）。

工具

| 工具 | 行为 |
| tentacle_status | 读取连接、武装、冷却、运行中反馈、当前阶段与最近事件。只读 |
| tentacle_scenario_list | 列出全部场景包（内置 + 自定义）。只读 |
| tentacle_scenario_start | 载入场景包、重置账本、开始新局 |
| tentacle_state_read | 读取完整状态：阶段/字段/时间线/招式/人设。只读 |
| tentacle_state_update | 按 schema 更新字段（int 钳制，enum/bool 拒绝非法值）。不触发硬件 |
| tentacle_state_advance | 沿阶段图推进（防跨图乱跳）。不触发硬件 |
| tentacle_feedback_list | 招式列表 + 钳制后的实际输出计划。只读 |
| tentacle_feedback_start | 执行有界招式（需武装 + 已连接 + 冷却结束；须给剧情理由） |
| tentacle_stop | 立即停止并归零。永远可用 |
| tentacle_connect / tentacle_disconnect | 连接 / 断开设备（连接后先归零） |

内置场景包（原创）

| id | 标题 | 风格 | 一句话设定 |
| spore-greenhouse | 孢子温室 | 俏皮诡异 | 夜班温室里，共生藤蔓「珞珈」把你当成新宿主，好奇地试探。 |
| abyss-dive | 深渊潜航 | 幽闭悬疑 | 7000 米海沟，水母群「灯缕」把你的隔离服当成新的光缆。 |
| clockwork-chase | 发条城追缉 | 蒸汽朋克 | 偷走「秒针之心」后，你在三分钟内躲避全城发条执法者的追缉。 |
| sympathetic-chain | 共感之链 | 情感叙事 | 与封印魔女瑟琳结下共感契约，她的伤沿银链传到你身上。 |

每个场景包包含：世界观前言、NPC 人设口吻（narrator）、阶段图（stages）、状态字段 schema（state.fields）、招式表（moves，各招绑定有界波形计划）、开场白与主持约定。

共创场景

在对话里和 AI 一起设计场景（世界观、NPC 口吻、阶段图、字段、招式），把结果保存为 src/game/scenarios/custom/.json（格式见 custom/_template.json）， MCP 重新连接（stdio）或插件重载（进程内）即加载。_ 开头的文件不会被加载；同 id 时自定义包覆盖内置包。

字段类型：int（带 min/max，写入自动钳制）、bool、enum（values 白名单）、text（≤300 字）。
招式 kind：sustain 持续 / burst 短促 / wave 疏密随机（可配 intensityRange）； stageGate 可限制招式只在指定阶段可用。波形名从 src/coyote/waveforms.js 波形库选取。

场景包无法突破安全上限：所有招式计划仍经过 planMove 与 CoyoteSafety 双层钳制。

许可证

MIT