DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

MrLukezy /

MrLukezy/dsh-codequest

Verified

CodeQuest for DeepSeek Harness: 把真实 Token 流量与会话内容变成成就游戏,带自建排行榜

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: master@894e49e3

CodeQuest for DSH

把 DeepSeek Harness 真实的 Token 流量 / 会话内容 / 工具调用 变成一款成就游戏,并可连接自建服务器参与排行榜。

📖 图文教程:guide.lukezystudio.cn/dsh-codequest —— 含成就墙、悬浮卡、数据页与排行榜的实拍截图。

灵感与成就文案来自 MrLukezy/ai-using-achievement(TokenMonitor · CodeQuest),本插件是为 DSH 重新实现的数据层与界面,不是原项目的移植。

安装

方式一:插件市场(推荐)

在 Harness 的「发现」页签里搜 CodeQuest 或 成就。市场索引地址:

https://raw.githubusercontent.com/MrLukezy/dsh-code-review/main/market/index.json

方式二:直接从 GitHub 装

plugin_manager { action: "install_bundle", target: "git+https://github.com/MrLukezy/dsh-codequest.git#v0.7.0" }

方式三:本地目录

git clone https://github.com/MrLukezy/dsh-codequest.git

然后把 target 指向仓库根目录的绝对路径。

装好后插件行 id 是 include:dsh-codequest;改完 Host 代码用 disable → enable 重载,改完 Client 代码刷新页面。排行榜是可选功能,不配置也能单机玩。

仓库结构

dsh-codequest/            ← 插件包根目录(DSH 直接安装这一层)
├─ index.js               Host 半区:扫描会话、算成就、HTTP 路由、免密登录签名
├─ client.js              Client 半区:CodeQuest 页 + 浮层 HUD + 解锁提示
├─ scan.js / text.js      会话日志折叠与文本信号提取
├─ achievements.js        313 枚成就定义与等级曲线
├─ art.js                 成就 → 徽章图映射
├─ cloud.js               排行榜服务端客户端
├─ assets/icons/*.webp    84 张 chibi 徽章(192px)
├─ locale/                插件管理页的标题与描述
└─ server/                ← 排行榜服务端(Express + SQLite),可选
   ├─ server.mjs
   └─ package.json

它长什么样

在会话视图的标签栏里多出一个 CodeQuest 页,包含五个分区:

分区 内容
成就 313 枚成就,按 12 个分类分组展示(每组带 已解锁/总数 与积分进度条);支持搜索、按「接近达成 / 稀有度 / 最近解锁」排序、最近解锁时间线;点击卡片弹出详情(达成条件、当前值/目标值、百分比、还差多少、解锁时间)
剧情 28 段「模型的记忆」:按分类进度(50% / 100%)和总解锁数(1 / 30 / 90 / 200)解锁章节;未解锁的显示标题与还差多少,解锁后可读全文,正文里的 {tokens} 这类占位符会填成本机真实数字;新章节解锁会弹 toast
数据 6 张渐变 KPI 卡(累计 Token / 会话 / 工具 / 缓存命中 / 连续 / 轮次)、30 天流量面积图(峰值标注 + 日均)、24 小时时段条(高峰高亮)、情绪堆叠条 + 图例、工具 / 文件 / 命令三列带比例轨的排行榜、文本性格胶囊(按占比填充)、模型分布与概览
排行榜 11 个榜单可切换(成就 / 积分 / 等级 / Token / 会话 / 连续天数 / 活跃天数 / 工具调用 / 代码块 / 今日 Token / 赛季),前 50,带头像与自己那一行的高亮
账号 DeepSeek 账号一键登录、同步、退出、登录设备管理;服务器地址从不显示(默认连内置服务器,「服务器与密钥」里可改成自己的),邮箱密码作为备用入口

顶部是等级徽章、称号、积分与升级进度条。

会话页悬浮层

两个常驻组件注册在 shell.overlay(框架级浮层,点击穿透,只在自己绘制的区域接管指针):

  • 使用曲线 HUD(右下角):默认收成小胶囊(等级头像 + Lv.x + 今日 Token + 迷你折线),点它展开成完整卡片(近 14 天折线、解锁数、升级进度);点 − 收回。
  • 默认开启,重启后仍在:✕ 只关闭当前这一次视图(不写任何持久状态),刷新或重启 DSH 会自动回来。想彻底关掉用「数据 → 悬浮窗」里的三档开关(胶囊 / 展开 / 关闭),它存在 Host 的 state.json 里(prefs.hud),换浏览器、重装插件都跟着走。
  • 可拖动:按住胶囊或卡片标题栏即可拖到任意位置,位置记在 localStorage['dsh-codequest.hudpos'],双击标题栏或点「数据 → 复位位置」回到默认角落;窗口变小、记住的坐标跑到屏幕外时会自动回到默认角落,不会出现「窗口在但看不见」。
  • 实时:HUD 走单独的 /live 轻接口(221 字节 vs /state 的 95 KB),每 3 秒一次,Token 数变化时会在曲线上飘一个绿色 +1.2M。
  • 解锁提示:成就解锁时右下角弹出 toast(徽章 + 名称 + 积分),6 秒自动消失,点击可立即关闭;最多同时 4 条。
  • 首次加载会以当前解锁集合为基线,不会把历史成就一次性弹出来;之后新解锁的才提示。
  • 样式表在插件加载时注入 <head>(#dsh-codequest-style),因为浮层不在 Conversation 视图的 DOM 树里,视图内联的样式管不到它;模块重载时会替换旧样式表而不是沿用缓存。
  • 浮层整体 pointer-events:none,只有胶囊/卡片自身接管点击,不会挡住下面的界面。

解锁短片

成就卡右上角出现 NEW!,点它播放一段几秒的「解锁短片」——不是视频文件,是 canvas 粒子 + CSS 相位动画实时生成的。不压黑屏幕:身后只做一层 backdrop-filter 全屏模糊,粒子直接铺在当前界面上,名字与积分用一块浅色玻璃条托底:

  • 先藏后现:前两个相位(glow / burst)完全不显示徽章,粒子先散开、光晕先收拢;到 name 相位徽章才从模糊里放大成形,随后名称、积分、条件依次浮出。
  • 12 个分类 12 种粒子形态:代码与工具是代码雨、时间是星尘、文本性格是飘起来的字、职场是方块、翻车现场是向外炸开的短线……同一个粒子池换一支笔。
  • 4 档稀有度 4 档强度:common / rare / epic / legendary 分别 26 / 52 / 84 / 140 颗粒子,时长 3.6–5.6 秒。
  • 点空白关闭:点任意空白处或按 Esc 直接关闭(同时记已看);点徽章、文字或按钮不会误关。播完后出现「关闭」「看详情」,详情页底部有「重播解锁动画」。
  • 已看记忆:记录在 localStorage['dsh-codequest.film-seen'],看完立刻摘掉 NEW!;首次运行只保留最近 3 枚带 NEW,其余按已看处理,不会一屏全是新。
  • 尊重减少动态效果:系统开了 prefers-reduced-motion: reduce 时不生成粒子,只留文字与光晕。
  • 短片挂在成就页内部,shell.overlay 依旧只注册 HUD 与 toast,两者互不影响。

数据来源

全部来自 DSH 自己的会话日志(ctx.sessionQuery),不读任何第三方工具的数据,不上传会话正文:

  • assistant/message.data.usage → input / output / cacheRead / cacheWrite / reasoning / total tokens
  • assistant/message.data.message.source 与 request/header → 模型、供应商
  • tool/call、tool/result → 工具调用次数、工具种类、报错次数
  • user/message → 只有 data.source.kind === 'user' 才算真人输入;AGENTS.md、skill 目录、时间快照等注入内容全部排除
  • 真人 prompt 与 AI 回复的文本信号(见下节),只存计数不存正文
  • turn/start、step/start、事件 time → 轮次、步骤、时段、活跃天数、连续天数、单次峰值
  • assistant/message.data.turn + usage → 单轮 Token 峰值;user/message 的日期 → 单日 prompt 峰值
  • SessionHeader.cwd → 工作目录数量

文本信号

文本层(text.js)把每条 prompt 和每条 AI 回复压缩成布尔信号,state.json 里只有计数器:

来源 信号
你的 prompt 疑问 / 极短指令 / 长文需求 / 重试纠正 / 质疑 / 礼貌 / 表情 / 追问原理 / 暴躁 / emo / 咖啡 / 周末摸鱼 / 报错堆栈 / 贴代码 / 中英混用 / 夸奖 / 道歉
业务词 服务端 / git 分支 / 需求策划 / 美术 UI / 性能 / 发布 / Unity / 测试 / 重构
AI 回复 代码块语言分布、表格、列表、道歉、含糊措辞、TODO、emoji、超长回复
工具参数 触碰的文件扩展名(.cs/.js/.java/.py/.json/.md/.prefab…)、命令首词(git/node/python/ssh…)

拉丁关键词按词边界匹配(ui 不会命中 build),中文关键词用短语而非单字(滚 不会命中「滚动」)。

每个会话被折叠成一份紧凑摘要(不含完整正文),缓存在:

$DSH_HOME/storages/dsh-codequest/state.json

折叠口径变化时 scan.js 里的 FOLD_VERSION 需要 +1,旧缓存会被重建。

成就与等级

  • 313 枚成就,12 个分类,稀有度 common / rare / epic / legendary(59 / 111 / 96 / 35),分值 10 / 20 / 40 / 80。
  • 分类:Token 流量 26 · 交互 26 · 时间 22 · 文本性格 33 · 职场 26 · 代码与工具 35 · 精通 23 · 探索与收集 18 · 彩蛋 31 · 翻车现场 20 · 自我改造 28 · 社交与排行 13。
  • 阈值按本机真实数据标定:入门档是「再走几步就能拿到」,顶端档需要长期积累(例如 32B Token、2000 局会话、40 天连续活跃)。
  • 多数成就一开始不显示:稀有度高于 common 的目标默认处于「未揭晓」,成就墙上只留一枚 🔒 N 枚未揭晓 的占位卡,点一下可以临时揭晓全部(剧透开关,存在 localStorage)。
  • 揭晓规则:已解锁、进度 ≥ 60%、或 common 档(新手引导)才显示真实名字与条件;彩蛋类(daily_1b、max_session_200m、late_night_40m 等)无论如何都要等解锁后才露面。
  • 总数始终固定可见:每个分类标题的 已解锁/总数 和顶部进度条都按全量 313 计算,隐藏的成就一样计入总数与积分上限。
  • 等级公式:每级需要 150 + 2×(等级-1) 分,接近线性,所以等级大致等于完成度;全部 313 枚约 10k 分,最后一级「Token 之神」需要约 78% 的积分。
  • 判定是单调的:解锁时间一旦写入不会被撤销。

「自我改造」「社交与排行」这两类读的是 DSH 自身的使用痕迹(用了哪些工具)和云端状态(同步次数、历史最高名次、排行榜玩家数),不是会话正文。

新增成就只需在 achievements.js 的 ACHIEVEMENTS 里加一行:

a('my_achievement', '名字', '风味文案', '达成条件说明', '🎯', 'rare', 'code', 100, (m) => m.toolCalls),
// a(id, name, desc, cond, icon, rarity, category, target, metric, extra?)
// 分值按稀有度自动取 10/20/40/80,可用 extra.points 覆盖;extra.hidden 标记隐藏成就。

常用的 metric 简写已经备好:S('question') 文本信号、AI('apology') AI 回复信号、F('csharp') 代码块语言、X('cs') 文件扩展名、C('git') 命令行工具、T('edit', 'write') 工具调用合计、H(9) 某小时的消耗。

m 是 scan.js 的 aggregate() 输出(见该文件末尾返回对象),因此新成就通常不需要改采集层。

新成就还要在 art.js 里补一行 'my_achievement': '<徽章名>',否则卡片只会显示 emoji 兜底。批量加完成就后可以直接重跑 _cq/make-art-map2.mjs 重新分配。

剧情(模型的记忆)

成就解锁的不只是积分,还有一段可以读的文字。lore.js 里 28 段章节分两条轴解锁:

轴 条件
全局 累计解锁 1 / 30 / 90 / 200 枚
分类 该分类完成 50% / 100%

正文里可以写 {tokens} {sessions} {tools} {days} {perday} {today} {streak} {players} 这类占位符,客户端用本机真实数据填进去——同一章在不同人那里读到的是自己的数字。

未解锁的章节只下发标题,正文不下发(body: null),所以从 /state 里也读不到剧透。新章节解锁时右下角会弹一个 📖 toast,已读状态记在 localStorage 的 dsh-codequest.lore-seen。

加一章只要往 LORE 里 push 一条:

{ id: 'code_3', scope: 'code', at: 1, chapter: '代码与工具 · 三', title: '标题', body: '正文,可含 {tools}' }

scope: 'global' 的 at 是解锁总数,其余 at 是该分类的完成比例。

美术资源

徽章图集(部分)

等级头像:7 张 chibi 立绘,一一对应 titleFor() 的 7 个称号段位(新手观察员 → 见习生 → 熟练工 → 资深提示工程师 → AI 编排官 → 算力领主 → Token 之神),同一套金桂冠徽章框,随等级自动切换:

等级头像

  • 徽章来自 MrLukezy/ai-using-achievement 的 chibi 成就图(MIT),已裁掉透明边、居中方形化并缩到 192px WebP,共 84 张,合计约 1.5 MB。
  • 映射表在 art.js(313 条成就 → 84 张徽章,按 id 家族 + 分类就近分配,84 张全部用上);重复使用的徽章只出现在语义相近的成就上。
  • 文件放在 assets/icons/<name>.webp,由 Host 的 prefix 路由 GET /dsh-codequest/icon/<name>.webp 以 image/webp + immutable 缓存下发;只接受 [a-z0-9_]+\.webp,路径穿越直接 404。
  • 插件图标 icon.png 由 syn_ai_grandmaster 徽章 + 品牌渐变合成。
  • 卡片按稀有度着色:common 灰蓝、rare 蓝、epic 紫、legendary 琥珀;解锁态有描边与光晕,未解锁只降透明度并加 🔒,不再整卡去色。
  • 顶部头像按称号段位换图(7 段位 7 张),等级徽标叠在头像右下角;浮层 HUD 用同一张。
  • 等级头像由 HFSY 网关(gpt-image-2)生成,源图 1254px 透明 PNG,落盘时缩到 256px 并留 10% 透明边,单张约 25 KB。

云端排行榜

服务端在 server/,Express + better-sqlite3,单文件、无外部依赖服务。

开箱即连:插件内置项目自己的排行榜地址(https://www.lukezystudio.cn/codequest/api),装好、用 DeepSeek 账号登录就能上榜,不需要填任何地址。想换成自己的服务端,用「账号 → 服务器与密钥 → 改成我自己的服务器」,或设 DSH_CODEQUEST_CLOUD 环境变量,或 POST /dsh-codequest/config {"cloudBase":"…"}(传空字符串恢复默认)。界面里不显示当前地址。

免密登录要和服务端的 DSH_SHARED_SECRET 一致,密钥不在仓库里:拿到别人的机器上用,地址是通的,但免密登录会返回 bad_signature。这种情况用「账号 → 改用邮箱 + 密码」注册/登录即可(服务端 /auth/register、/auth/login)。

排行榜支持 11 个榜,界面上用 chip 切换:成就数、积分、等级、累计 Token、会话数、连续天数、活跃天数、工具调用、代码块、今日 Token、赛季成就。所有数值在服务端按字段取 MAX 合并,客户端重传一个更小的数不会把名次冲掉。

多端登录(同一账号多台机器)

同一个账号可以在任意多台机器上同时登录,每台机器一条独立 token:

行为 结果
在 B 机登录 不影响 A 机,A 机的 token 仍然有效
在 A 机退出 只删 A 机的 token,B 机继续在线
成就同步 按设备分行存储,用户的收藏 = 各设备并集;B 机成就少也不会删掉 A 机的记录
进度 / Token 按字段取 MAX 合并;同一天两台机器的 todayTokens 取较大值而不是相加
限流 按 token 计数,两台设备各有自己的每分钟额度
设备管理 「账号」页显示当前登录设备数,可一键「退出其它设备」(GET /auth/devices、POST /auth/devices/revoke-others)
token 过期 30 天;插件收到 401 会清掉本地 token 并回到未登录状态,提示重新登录

因为 DSH 的会话日志是本地的,两台机器的成就天然不同(B 机没跑过 A 机的项目),所以服务端把「同一 achievement_id 在不同设备上解锁」视为同一枚成就,按 COUNT(DISTINCT achievement_id) 计数。

自己部署

cd server
npm install
DSH_SHARED_SECRET="$(openssl rand -hex 24)" JWT_SECRET="$(openssl rand -hex 32)" \
  ADMIN_PASS="换成你的密码" PORT=3010 BASE_PATH=/codequest node server.mjs
环境变量 说明
PORT 监听端口,默认 3010
BASE_PATH 反向代理前缀,默认 /codequest;服务挂在 ${BASE_PATH}/api
JWT_SECRET 会话 token 的签名密钥,务必自己生成
ADMIN_USER / ADMIN_PASS /admin 后台账号,默认 admin / 占位密码,必须改
DSH_SHARED_SECRET 与插件共享的免密登录密钥;留空则关闭 /auth/dsh

然后把「账号 → 服务器与密钥 → 改成我自己的服务器」填成你的 ${BASE_PATH}/api,把同一个 DSH_SHARED_SECRET 填到「共享密钥」里;也可以直接 POST /dsh-codequest/config {"cloudBase":"…","sharedSecret":"…"}。

接口

插件默认用 DeepSeek 账号免密登录,邮箱密码只是备用入口:

接口 用途
POST /auth/dsh DeepSeek 账号免密登录:{accountKey, contact, name, avatarUrl, signature},首次自动建号,之后按 dsh_account_id 命中同一账号
POST /auth/register、POST /auth/login 邮箱密码注册 / 登录(备用)
POST /sync/achievements 上传解锁记录 {id, unlockedAt, deviceId};replace:true 只清理本设备的旧记录,不碰其它设备
POST /sync/season 建立/读取赛季起点
POST /sync/progress 上传 {totalTokens, totalSessions, sentiment, sources}(服务端按字段取 MAX)
GET /leaderboard?kind=<board>&limit=50 多榜排行:achievements / season / points / level / tokens / sessions / streak / days / tools / code / today
GET /auth/devices 当前账号登录着的设备列表(current 标记当前这台)
POST /auth/devices/revoke-others 退出除当前设备外的所有设备
POST /share 分享一枚成就:{achievement, art},返回 {id, url}
GET /share/:id 分享内容的 JSON
GET /s/:id 分享页(HTML,带 og: 预览标签)
GET /s/:id/art 分享页用的徽章图(存在库里,不依赖插件本机)

分享

成就详情弹窗底部有「分享这张卡片」:Host 把成就字段和徽章图(assets/icons/*.webp,约 20 KB)一起 POST 到 /share,服务端存进 SQLite 并返回一个短链,形如

https://www.lukezystudio.cn/codequest/s/4fdcbk7d

链接是公开的、不需要登录就能看,页面自带 og:title / og:description / og:image,贴到群里会有预览。未揭晓的成就不能分享(Host 直接拒绝,返回 still_secret),避免把隐藏成就的名字和条件泄露到公开链接里。

分享页用的图存在服务端数据库里,不依赖分享者的机器在线;站点地址由环境变量 PUBLIC_BASE 决定(默认 https://www.lukezystudio.cn)。

免密登录的身份来自 Host 的 ctx.deepseekAccount(getState() + getProfile()),取 profile.id 作为稳定账号键、profile.name 作为昵称、profile.avatarUrl 作为头像;contact 若是脱敏手机号则不会写成邮箱。Host 用共享密钥对 accountKey|contact 做 HMAC-SHA256,服务端用 crypto.timingSafeEqual 校验,因此伪造的身份会被拒绝(401 bad_signature)。

共享密钥不写死在仓库里:插件侧通过 state.json 的 cloud.sharedSecret(界面「账号 → 共享密钥」或 POST /dsh-codequest/config)设置,服务端侧用环境变量 DSH_SHARED_SECRET,两处一致即可。仓库里的默认值 change-me-codequest-shared-secret 只是占位符,正式部署必须换掉。

服务器地址存在 state.json 的 cloud.base,默认值是内置的项目服务器。界面里从不显示当前地址(「服务器与密钥」只给一个空白输入框,用来填你自己的),所以地址不会出现在任何页面、截图或录屏里。要改地址就编辑 state.json 或 POST /dsh-codequest/config {"cloudBase":"…"}。

Host 路由

同源 JSON 接口(同时注册 /dsh-codequest/* 与 /dsh/dsh-codequest/*,以适配根路径与 /dsh/ 前缀两种部署):

方法 路径 说明
GET /dsh-codequest/state 全量状态(统计 + 成就 + 进度 + 云端信息),超过 20s 未扫描会触发一次后台扫描
GET /dsh-codequest/live HUD 用的轻量快照(等级 / 积分 / 今日 Token / 连击),约 220 字节;折叠超过 6s 会在后台补一次增量扫描
GET /dsh-codequest/account 读取本机已登录的 DeepSeek 身份(供账号页展示)
POST /dsh-codequest/cloud/dsh-login 用 DeepSeek 身份免密登录排行榜
POST /dsh-codequest/refresh 触发扫描,{force:true} 强制重建全部折叠
POST /dsh-codequest/config 修改 {cloudBase, sharedSecret, hud};hud 取 pill / open / off
POST /dsh-codequest/cloud/login / register / logout 账号操作
POST /dsh-codequest/cloud/sync 推送成就与进度
GET /dsh-codequest/cloud/devices 当前账号的登录设备列表
POST /dsh-codequest/cloud/devices/revoke 退出其它设备
POST /dsh-codequest/cloud/leaderboard?kind=<board> 拉取指定榜单
POST /dsh-codequest/cloud/share 分享一枚成就 {achievementId},返回公开链接
GET /dsh-codequest/icon/<name>.webp 成就徽章静态图(prefix 路由,7 天 immutable 缓存)
GET /dsh-codequest/level/level_<n>.webp 等级段位头像(prefix 路由,同上缓存)

写操作校验 Origin 与 Host 同源;路由不参与 DSH 的登录网关,公网部署时请把 /dsh-codequest/ 一并放在网关之后。

测试

测试不依赖运行中的 Harness,直接跑:

# 采集 + 成就 + HTTP 路由全链路(读本机真实会话日志)
node test/host.test.mjs "$env:DSH_HOME\sessions"

# 折叠与聚合口径
node test/fold.test.mjs "$env:DSH_HOME\sessions"

# 浏览器半区:模块加载 + slot 注册(用桩 React)
node test/client.test.mjs

# 组件渲染:用真实 /state 数据跑分组与成就墙,崩溃即标签页白屏
node test/render.test.mjs

前两个需要本机存在 DSH 会话日志;后两个不需要,可单独跑。

已知限制

  • 首次扫描需要遍历全部历史会话(本机 109 个会话约 2–4 秒),之后只重扫活跃会话。
  • 情感与文本信号只看真人 prompt;注入上下文(AGENTS.md、skill 目录、时间快照)已排除,因此 promptChars 只统计你真正打的字。
  • 每类信号每个 prompt 只计一次,且只看会话前 12 条 prompt 的前 600 字符。
  • 「夜间」定义为 20:00 之后开始;「周末」类成就已移除(对工作日作息不可达成)。
  • 礼貌 / emoji / 咖啡这类信号取决于你的表达习惯,可能长期为 0——它们是彩蛋,不是必拿项。
  • 排行榜的「今日 Token」由客户端上报,服务端只做 MAX 合并,不能跨天归零(本地跨天后会自然降为当天值)。
  • 界面文字目前中/英双语硬编码在 client.js,locale/*.json 只提供插件管理页的标题与描述。
—/ 5

No ratings yet

Verified DSH bundle

Commit 894e49e3ca42

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout