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 tokensassistant/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只提供插件管理页的标题与描述。
No comments yet. Be the first to write one.