dsh-trpg
DeepSeek Harness 客户端插件：AI 跑团（TRPG）主持人 —— 剧本自适应、GM 吐槽、真随机骰子与检定、贿赂透露情报。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:liuleo2538548-hash/dsh-trpg#d39c8995e100e98ab436f711e4c735f7aec34105
Trpg 以 dsh-trpg 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
⚠️ 使用时请小心。 非官方第三方插件，与 DeepSeek 官方无关。装上它会接管你的会话视图、调用你的模型账号、并在工作区之外写文件，卸载也不会自动清理它写下的存档。装之前请务必读完 ⚠️ 副作用与意外产物 这一节。
给 DSH（DeepSeek Harness）客户端加一个说人话的 GM：能读你的剧本、会吐槽、替你掷骰子、还能被玩家拿好处套出情报。
侧栏出现 🎲 AI 跑团，点开就是完整跑团面板。
真实运行截图（不是效果图）：战役「雨夜疑云」、属性条、进度钟、骰子 chip、GM 气泡与场外音、贿赂面板。
| 功能 | 说明 |
|---|---|
| 适应剧本 | 粘贴任意长度的剧本原文（Markdown 标题 / 第一章 / 【场景】 都认）。GM 只拿到一份摘要，不会照着剧本念，玩家走到哪它讲到哪；确认要找线索时会要求过检定。 |
| GM 吐槽 | 自带 60+ 条中文单行吐槽库，按心情（8 种）与情境分类。GM 每回合开头给个情绪，吐槽会避开最近说过的，不会复读。强度 0~5 可调。 |
| 骰子 | 1d100、2d6+1、4d6kh3 这类公式都能掷；带 COC 风格的检定（常规 / 困难 / 极难，奖励骰与惩罚骰），大成功与大失败有专门判定。 |
| 贿赂与情报 | 每个 NPC 可以有一件秘密。玩家给的东西够不够分量，由规则算分：金额与具体性加分，NPC 对你的态度加分，怀疑度与反复磨嘴皮子扣分。成交才会松口。 |
| 拟人 | GM 有自己的口吻与立场，会阴阳玩家、会不耐烦、会在大失败时嘲笑；但每句吐槽都必须把剧情往前推。 |
模型永远拿不到随机数。 骰点只能在服务端由 lib/dice.js 掷。模型想掷骰只能写 <<roll 1d100 dc=55>> 这样的指令，宿主解析后自己掷，再把结果写回叙述里。这样模型无法伪造成败，也骗不了玩家。
请当成第三方代码跑在你的用户权限下来对待。以下是实际会发生的，不是理论风险：
| 副作用 | 细节 | 怎么收拾 |
|---|---|---|
| 改你的 profile 清单 | scripts/install.mjs 会文本级改写 ~/.dsh/profiles/desktop/package.json：加一条 link: 依赖 + 一个 dsh.profile.bundles 条目。不做 JSON 重排版，但你的注释/顺序会被动。 | 它写前备份成 package.json.pre-dsh-trpg.bak（已存在则不覆盖）；或 node scripts/install.mjs --uninstall |
| 在工作区外写文件 | 运行期在 ~/.dsh/dsh-trpg/ 写 state.json（全部战役、线报、账本）与 scenarios/<campaignId>.json（你导入的剧本原文）。这些不在你的仓库里，卸载插件也不会删。 | 面板里「导出 JSON」；或手动删目录 |
| 建 junction | 在 ~/.dsh/profiles/desktop/node_modules/dsh-trpg 建指向本仓库的 junction。仓库一旦被移动/删除，DSH 启动时这条 bundle 就加载失败。 | --uninstall 会摘掉它 |
| 残留坏档 | state.json 读坏时不会崩，而是改名留证成 state.json.corrupt-<时间戳> 再开空档。长期反复出问题会攒下一堆 .corrupt-*。 | 手动删 |
| 会话视图被接管 | 面板注册在 main slot（replaceRisk: "shadows-shipped-ui"），打开时会替换掉整个会话视图。 | 面板左上角「← 返回会话」，或换侧栏项 |
llm.stream，用的是你在 DSH 里配的 provider 与 key。费用按你的账号结算。cordis.patch.yml 变化会触发重组）。你在源码里的修改不会即时生效。第N章、【场景】。格式奇怪的长文可能只切出一节。切得不好就先手动加标题。lib/view.js。snark 与吐槽库是中文的：换语言得自己写库（lib/gm.js）。~/.dsh/dsh-trpg/。# 装进 desktop profile（会加一条 link: 依赖 + 一个 bundle 条目，并备份原清单）
node scripts/install.mjs
# 只看看会改什么，不落盘
node scripts/install.mjs --dry-run
# 卸载
node scripts/install.mjs --uninstall
装好后刷新 DSH 的 Web 界面，侧栏会多一个 🎲 AI 跑团。
档放在 ~/.dsh/dsh-trpg/（state.json 与 scenarios/）；DSH_HOME 可覆盖。
本插件零第三方依赖，不需要
pnpm install。装法只有上面这一种 —— 它是本地link:安装，不走 npm registry。
【情报】 的形式进线报并落进账本。返回会话：面板左上角的 ← 按钮，或按侧栏图标切换。
GM 在回复里可以用这两行方括号指令，宿主会解析并执行，界面上不会显示它们：
<<mood ominous>> 心情：决定 GM 的说话口吻与表情
<<roll 1d100 dc=55 reason=撬锁>> 请求掷骰；dc 给了就判达成
<<bribe granted price=一瓶酒>> 贿赂判定（另见 /bribe 流程）
没闭合的 << 会被忽略（模型话说一半很正常），非法公式只报一条错误，不会毁掉整个回合。
dsh-trpg/
├─ package.json # 零依赖；main/exports/dsh 三个块
├─ cordis.patch.yml # bundle patch：一行 insert
├─ CONTRACT.md # 冻结契约（当初派活用的规格书）
├─ docs/screenshot.png # 真实运行截图
├─ lib/
│ ├─ index.js # 宿主半：七条路由 + SSE
│ ├─ schema.js # 存档唯一权威 + 全部上限与钳制
│ ├─ commands.js # 唯一写入权威：~30 条命令
│ ├─ store.js # 落盘（原子写 + 坏档隔离）
│ ├─ dice.js # 骰子与检定
│ ├─ scenario.js # 剧本解析 / 摘要 / 检索
│ ├─ gm.js # GM 人格：吐槽库 + 指令解析
│ ├─ bribe.js # 贿赂判定策略
│ ├─ prompt.js # 提示词装配
│ └─ view.js # 派生视图（界面不重算）
├─ client/client.js # 浏览器半：plain IIFE，React.createElement
├─ scripts/
│ ├─ check.mjs # 静态契约检查
│ ├─ build.mjs # 无打包器"构建"：语法校验 + 拷进 dist/
│ ├─ verify.mjs # 五步验收，全过打印 all steps passed
│ └─ install.mjs # 装进 profile / 卸载
└─ test/ # 9 个测试文件，230 条用例
node scripts/verify.mjs # 五步验收（静态检查 → 构建 → 测试 → 产物 → 干跑安装）
node scripts/check.mjs # 只跑静态契约检查
node --test --experimental-test-isolation=none test/*.test.js
verify 的五步：静态契约 → 逐文件语法检查 + 拷出 dist/ → 单元测试 → 校验 dist/ 产物 → 安装干跑。全过打印 all steps passed。当前 230 / 230 通过。
必须带
--experimental-test-isolation=none：本机沙箱里 Node 的测试运行器默认会给每个文件 spawn 子进程，直接spawn EPERM。不带这个旗标时测试根本没被加载，看起来像"全绿"其实是空跑。
这些都是踩过的坑，改代码前先看一眼：
require 一个参数，host.call 这类私有 JSON RPC 只对动态定义的包开放。所以浏览器半一律走自己的 HTTP 路由 + 普通 fetch。requestBody: "buffered"。漏写时共享 Fetch 层会把请求当 streaming，无 body 的 GET 会被构造成带 body 的 Request 并抛错 —— handler 根本不跑，浏览器收到空响应。check.mjs 会对每条路由校验这一点。source: { kind:"model", provider, model }，否则 dsh-llm 派发时读 message.source.replayState 会抛错。applyCommand(state, command, ctx)。--dsw-alias-button-primary-fill + 文字 --dsw-alias-label-primary-foreground。绝不要把 --dsw-alias-brand-primary 当背景 —— 它是 ink token（浅色近黑、深色近白），配白字在深色主题下对比度 1.05:1，完全看不见。MIT。见 LICENSE。
第三方插件，非 DeepSeek 官方作品，不含任何担保。装上它意味着你接受上面「副作用与意外产物」里写的全部行为。