dsh-rpg-workstation

把 DeepSeek Harness 变成一个 RPG 工作台：每次完成一个对话回合就获得经验值，升级、解锁成就、保持每日连击，右下角浮动的游戏面板实时展示你的“战绩”。

Game-ify your DeepSeek Harness usage — earn XP per completed conversation turn, level up, unlock achievements and keep daily streaks, with a floating RPG dashboard in the web UI.

截图：

---

环境要求

依赖	版本	说明
Node.js	≥ 18	构建与运行
pnpm	任意较新版本	仅 dsh plugin 命令需要（没有也能手动安装，见下文）
DeepSeek Harness	web profile	插件面向 dsh web 界面

---

安装

前置：先全局安装 dsh 命令行工具。没有它就没有 dsh plugin / dsh web 这些命令：

npm install -g @deepseek-ai/dsh

之后一条命令安装本插件：

dsh plugin --profile web add dsh-rpg-workstation

dsh plugin add 会自动把包加入 profile 层叠（包声明了 dsh.bundle.patch），无需手写补丁。

安装完成后重启 dsh web，界面右下角就会出现 RPG 面板。

卸载：

dsh plugin --profile web remove dsh-rpg-workstation

原理：dsh 的 profile 由一层层补丁拼装。cordis.patch.yml 里的 - insert: 是标准补丁写法，id 是该行的稳定句柄，name 是 loader 要解析的 npm 包名（必须先装进 profile 的 node_modules）。客户端 bundle 由 dsh 的 dsh.client 扫描自动打包，所以 lib/ 产物 + dsh 两个字段就够用了。

---

使用方法

面板挂在右下角（shell.overlay 插槽），一切都是自动的——聊着聊着就攒经验：

操作	效果
正常对话 / 让 AI 干活	每完成一个回合 +10 XP；回合内每调用一次工具额外 +2 XP（上限 +20）
点击面板头部	折叠 / 展开
按住头部拖动	把面板移到任意位置
点击成就圆点区	展开详情：本周柱状图、每日任务、统计、成就列表、存档导入/导出
升级瞬间	等级数字轻放大 + 「升级 Lv.N」浮出（里程碑等级 5/10/15 有专属彩蛋）
全成就解锁	称号变「圆满」+ 高亮彩蛋

---

功能一览

• 经验与等级 — 每回合 (10 + min(20, 工具数×2)) × 连击加乘；level = floor(sqrt(xp/100)) + 1
• 连击加乘 — 连击 3 / 7 / 30 天 → XP ×1.1 / ×1.25 / ×1.5
• 14 个成就 — 对话数、等级、工具调用、文件写入、连击、单日回合、深夜/清晨各成一档
• 每日任务 — 对话达人 / 工具狂人 / 保持连击，每完成一个 +20 XP，次日刷新
• 称号系统 — 新手 → 学徒 → 冒险者 → 勇者 → 大师 → 传说（全成就时「圆满」）
• 每周报告 — 最近 7 个自然日柱状图（以 XP 为高度）+ 周汇总
• 存档导出 / 导入 — 一键下载 rpg-data-YYYY-MM-DD.json，导入自动归一化（旧版/手改存档不留空洞）
• 持久化 — ~/.dsh/rpg-data.json（尊重 $DSH_HOME），原子写入 + 串行队列，崩溃不损坏
• 界面克制 — 宿主主题变量、无 emoji 噪音、prefers-reduced-motion 支持

---

架构

┌─ Host (Node.js) ────────────────────────────────────────────┐
│ apply(ctx)                                                  │
│  ├─ ctx.on('session/event')  → turn/end(completed)          │
│  │     → registerCompletedTurn()  (+XP, 连击, 成就, 任务)     │
│  │     → updateWeekHistory()     (按活跃日累计周历史)          │
│  │     → saveSoon()              (timer.debounce + ctx.effect)│
│  └─ webServer.register × 3                                   │
│       ├─ /rpg-workstation/state.json → computeSnapshot       │
│       ├─ /rpg-workstation/export     → 原始存档 JSON          │
│       └─ /rpg-workstation/import     → normalize + 落盘      │
└──────────────────────────┬──────────────────────────────────┘
                           │ 同源 fetch（纯 JSON）
┌─ Client (Browser) ───────▼──────────────────────────────────┐
│ apply(ctx)                                                  │
│  ├─ styles 注入 style.css（命名空间隔离）                      │
│  └─ slots.inject('shell.overlay')                            │
│        → <Dashboard/> 每 2s 轮询                              │
│             ├─ 等级/称号/经验条/连击/每日任务/周报/成就          │
│             └─ 升级轻提示 + 圆满彩蛋                           │
└─────────────────────────────────────────────────────────────┘

• Host 面（src/index.ts）负责后端：监听会话事件、算分、落盘、状态/导出/导入路由。
• Client 面（src/client/）负责界面：插槽注册、样式注入、轮询渲染。
• 两端类型（src/shared/types.ts）单一定义快照结构，改一处另一侧立刻类型报错，防止漂移。

---

玩法公式

项目	公式
每回合经验	(基础 +10 + 工具加成 min(20, 工具数 × 2)) × 连击加乘（turn/end 且 reason.kind === 'completed'）
连击加乘	连击 3 / 7 / 30 天 → ×1.1 / ×1.25 / ×1.5
等级	level = floor(sqrt(xp / 100)) + 1
升下一级阈值	level² × 100（xpAtLevel(level+1)）
当前级跨度	(2·level − 1) × 100（进度条分母）
连击	当天首次 → 1；连续每天 → +1；中断一天 → 归零
称号	1-2 新手 / 3-4 学徒 / 5-6 冒险者 / 7-9 勇者 / 10-14 大师 / 15+ 传说
行为统计	累计工具调用（tool/call）、文件写入（write/edit）、今日回合

---

License

MIT