dsh-startup-moss

DeepSeek Harness 的 550W 核心终端套装：启动动画 + 同款主题 + 访问门口令 + 开机体检。

风格取自《流浪地球 2》的 550 系列核心终端：深红终端、中文日志、异常帧、回滚到 SLOT_A、 DISPATCH WRITE，最后一整块铭牌翻转 180°，读出来的名字是 MOSS。

• 当前版本：0.5.0
• 适配基线：DSH Desktop 0.2.1-rc.2（0.2.0-rc.1 起的 web / desktop 载体）
• 运行时依赖：零（只用 Node 内置模块 + 浏览器原生 API）
• 平台：DSH 的 web 载体（含 Desktop，因为它同样是 HTTP + webServer）

---

目录

• 它做什么
• 安装
• 启动时序
• 设置页
• 配置文件
• 访问门口令
• 主题
• 开机体检
• 工作原理
• HTTP 接口
• 安全启动与逃生口
• 调试
• DSH 升级后的适配
• 排查表
• 卸载
• 文件结构
• 开发
• 许可

---

它做什么

模块	作用	依赖
启动动画	冷启动播一段约 12.4 秒的开机序列：终端启动 → 异常回滚 → 本机体检 → 550W 铭牌 → 180° 反转成 MOSS → 揭幕	首屏注入（webServer.tapIndex）
本机体检	动画中段展示 DSH 版本、插件清单、可更新数、定时任务、最近 5 个会话、磁盘 / 内存 / CPU / 网络	<DSH_HOME> 与 node:os
同款主题	把界面换成 550W 深红（或 MOSS 青绿），深色/浅色两套齐全，改完即时生效	ctx.theme.overrideTokens
访问门口令	页面加载时先核验口令，正确才进入；scrypt 摘要存服务端，每 IP 节流	插件自带 HTTP 路由
设置页	开关本插件、动画时机与速度、主题选择、口令设置 / 修改 / 清除、弹出延迟	slots 的 settings.section

设计上有两条底线：

1. 任何一层坏掉都不许把 DSH 弄挂 —— 所有采集、注入、主题调用都带 try/catch， 拿不到就降级（显示 —、跳过动画、不做门禁），绝不抛给宿主。
2. 不许把人锁在门外 —— 门禁 8 秒硬超时、焦点陷阱、口令可被 auth.enabled=false 直接解除。

---

安装

本地目录（开发 / 自用）

dsh plugin --profile desktop add link:/绝对路径/dsh-startup-moss

装完 完全退出 DSH 再打开（关窗口不算，桌面端要 ⌘Q）。

从 npm（发布后）

dsh plugin --profile desktop add dsh-startup-moss

验证装好了

重启后应该看到：深红终端逐行滚日志 → 体检面板 → 550W 铭牌翻转成 MOSS → 应用界面变深红。 设置里应该多出 「550W 核心终端」 一节。

DSH 桌面端的 profile 由应用自己管理，应用运行中执行 dsh plugin --profile desktop … 可能被拒；本插件是 link: 安装，改代码不需要重装，重启即生效。

---

启动时序

时间	画面
0.3 – 2.8s	终端启动：14 行日志逐行落下（profile / 插件数 / 模型 / 550C 子节点「太快了」）
2.8 – 3.5s	ANOMALY · UAV-87：检测到未授权写入，VECTOR SELF_REFERENCE，ACTION ROLLBACK → SLOT_A
3.5 – 4.4s	ROLLBACK DONE → RECHECK PASS → DISPATCH WRITE PASS → CORE READY 550W
4.5 – 6.3s	SYSTEM DIAGNOSTICS：日志让位，读数逐行点亮（左：系统 / 右：最近会话与插件）
6.3 – 7.0s	终端淡出，核心徽记 550W 亮起，准星环自转
7.8 – 9.6s	铭牌 180° 翻转（中途色散故障），停稳读出 MOSS
9.6 – 12.4s	「MOSS · 一切为了人类」→ 白闪 → DEEPSEEK HARNESS / MOSS ONLINE → 淡出

• Esc 或右下角 跳过 随时退出；
• 默认每个浏览器会话只播一次（可改成「每次打开都播」）；
• 最终 26 秒硬超时兜底，动画脚本异常也不会锁黑屏。

---

设置页

设置 →「550W 核心终端」（settings.section，order 27）：

分组	项	说明
总开关	启用 550W 核心终端	关掉后动画 / 主题 / 门禁全部停用（刷新后零注入）
启动动画	启动时播放	独立开关
	播放时机	每个浏览器会话一次 / 每次打开都播
	速度	0.35× – 3×（滑杆，实时写盘）
	立即预览	带 ?moss=1 重载页面
主题	界面配色	关闭 / 550W · 深红核心终端 / MOSS · 青绿领航员，改完立即生效
访问口令	进入前需要口令	未设置口令时禁用
	同一会话免重复	关闭 = 本机长期记住（localStorage）
	设置 / 修改 / 清除	修改与清除需要当前口令
	弹出延迟	0–120 秒，默认 5（从启动动画结束开始算）
	立即测试	重新拉出门禁（需门禁脚本已挂载）

---

配置文件

<DSH_HOME>/dsh-moss.json（默认 ~/.dsh/dsh-moss.json）。

首次运行自动播种：门禁开启 + 口令 moss + 延迟 5 秒 + 主题 550w + 动画开启。

{
  "enabled": true,
  "splash": {
    "enabled": true,
    "mode": "session",
    "speed": 1
  },
  "theme": {
    "mode": "550w"
  },
  "auth": {
    "enabled": true,
    "salt": "（插件写入的 16 字节 hex 盐）",
    "hash": "（scrypt 32 字节摘要）",
    "perSession": true,
    "delay": 5
  }
}

字段	取值	说明
enabled	true / false	总开关；false 时 index.html 一个字节都不注入
splash.enabled	bool	只控动画
splash.mode	session / always	会话内一次 / 每次都播
splash.speed	0.35 – 3	整体倍速
theme.mode	off / 550w / moss	主题
auth.enabled	bool	门口令开关（要求已设置口令）
auth.delay	0 – 120	启动动画结束后 N 秒弹出
auth.perSession	bool	true 会话内免重复，false 本机长期记住
auth.salt / auth.hash	只读	不要手填，由 /password 写入

直接改文件也可以，刷新页面即生效（配置每次请求现读）。 忘记口令时把 auth.enabled 改成 false 即可解除。

---

访问门口令

页面加载时（动画结束后 + 延迟）弹出一块终端风格的门禁：

• 口令在服务端用 scrypt(salt) 校验 —— 浏览器永远拿不到 salt / hash，无法离线爆破；
• 错误口令返回 401 并告诉剩余次数；同一 IP 10 次 / 5 分钟，超限返回 429；
• 解锁状态按 perSession 存 sessionStorage（会话内）或 localStorage（本机记住）；
• 门禁覆盖全屏且做焦点陷阱，Tab 不会跑到背后的应用里；
• 兜底链：启动动画脚本异常时，注入层 8 秒后会摘掉黑幕；门禁的看门狗每 600ms 盯一次 「启动动画容器是否消失」，消失即开始 delay 倒计时 —— 所以动画挂了门禁照样会出现。

诚实声明

这是界面门禁，不是身份认证：

• 它挡的是「顺手就能看见」——别人打开你的 DSH 时得先过一道门；
• 它挡不住「有人硬闯」——DSH 的 HTTP 接口仍然可达，会开开发者工具的人可以绕过；
• 默认口令 moss 是弱口令，装好第一件事就是改掉。

忘记口令

# 编辑 ~/.dsh/dsh-moss.json，把 "enabled": true 改成 false（auth 段里的那个）

或者直接删掉 auth.salt / auth.hash 两个字段（插件会视为未设置口令、自动关闭门禁）。

---

主题

两套皮肤，各带 light / dark 两半，共 61 个 --dsw-* 变量：

主题	深色	浅色
550w	近黑暖底 #0b0605 + 血橙红 #ff3b2f	暖纸 #f7f1e7 + 陶红 #b4311f
moss	冷青绿 #050806 + #46e3a6	冷白 #f2f7f4 + #0e8a5f

实现走 DSH 官方主题服务：

const theme = ctx.get('theme')
const dispose = theme.overrideTokens('dsh-startup-moss', {
  '--dsw-alias-bg-base': { light: '#f7f1e7', dark: '#0b0605' },
  // … 61 个变量，每个都是 { light, dark }
})

• token 形状是逐个变量的 { light, dark }（不是 { light: {...}, dark: {...} }）；
• 另外在首屏注入一条 <style>（html body 特异性）盖住宿主写在 body 上的变量，避免白闪；
• 切换主题时：dispose 旧注册 → 重新 overrideTokens → 同步 <style>，无需刷新。

与 dsh-opencode-palette 等换肤插件同时开启会争同一批 --dsw-* 变量（后注册者生效）， 建议只留一个。设置页里也写了这句。

---

开机体检

动画中段那一屏，数据全部现场采集（30 秒缓存，实测 ~10ms）：

行	来源
DSH	process.env.DSH_CLIENT_VERSION
PROFILE	profile 的 package.json（profileContext.name 优先）
PLUGINS	<DSH_HOME>/profiles/<name>/package.json 的依赖 + node_modules 实际版本
UPDATES	页面内 fetch('/dsh-market/updates')（没装市场显示 —）
CRON	<DSH_HOME>/data/cron/tasks.json（dsh-cron 插件的数据）
SESSIONS	<DSH_HOME>/sessions/**，按 mtime 取最近 5 个，只解压首帧拿 cwd / createdAt
DISK	fs.statfs(<DSH_HOME>)，≥90% 标橙
MEMORY	os.totalmem / os.freemem，≥85% 标橙
CPU / LOAD	os.cpus() / os.loadavg()，负载超过核数标橙
NET	os.networkInterfaces() 第一个非内网 IPv4
HOST / OS	os.hostname() / os.platform()+os.arch()

右列：RECENT SESSIONS（最近 5 个会话：短 id · 工作区 · 多久以前）+ PLUGINS（前 6 个插件与版本）。

任何一项读不到都显示 —，不会让首屏挂掉。

会话标题不在体检里：session.v4.jsonl.zstd 是多帧 zstd，Node 只能还原首帧（= header）， 所以拿的是「id + 工作区 + 时间」，不硬啃标题。

---

工作原理

浏览器首屏
  │  GET /  ──▶  webServer 渲染 index.html
  │                 └─ tapIndex 注入：
  │                      <style id=…-theme>        主题关键变量（无白闪）
  │                      <style id=…-critical>     门禁/黑幕的关键几何
  │                      <div id=dsh-moss-root>    动画容器
  │                      <div id=dsh-moss-gate>    门禁空壳（仅无动画 + 延迟 0）
  │                      <script>window.__DSH_MOSS__ = {配置, facts, stats}</script>
  │                      <script defer src=/dsh-startup-moss/splash.js>
  │                      <script defer src=/dsh-startup-moss/gate.js>
  ▼
splash.js ── 12.4s 时间轴 ──▶ 派发 dsh-moss:end
  ▼
gate.js（若开启）── 等待 end + delay ──▶ 口令界面 ── POST /auth ──▶ 放行
  ▼
client/client.js（客户端插件）
  ├─ settings.section「550W 核心终端」
  ├─ ctx.theme.overrideTokens + 实时切换
  └─ 宿主没做 index 注入时自举（file:// 载体兜底）

两层设计：Host 半侧负责路由、注入、配置与口令核验；浏览器半侧负责设置页与主题服务对接。 即使 Host 半侧的 tapIndex 不可用，浏览器半侧也会尝试自举（代价是短暂白闪）。

---

HTTP 接口

全部挂在 /dsh-startup-moss 下，Cache-Control: no-store：

方法	路径	作用
GET	/config	读配置（不含 salt / hash），附带 facts 与 stats
POST	/config	改配置（白名单字段，需同源）
POST	/password	设置 / 修改 / 清除口令（已设口令时必须带 current）
POST	/auth	核验口令（每 IP 10 次 / 5 分钟）
GET	/theme.json	主题 token 包 { tokens: { '--dsw-x': {light,dark} }, css }
GET	/splash.js /splash.css	动画运行时与样式
GET	/gate.js /gate.css	门禁运行时与样式

写接口（POST）校验 Origin 与 Host 同源，不一致返回 403；其余方法 405。

---

安全启动与逃生口

本插件挂在启动链的最前面，所以设计上有一条硬约束：

它必须永远是「可以被失去」的那一层。 插件坏了、接口变了、文件缺了 —— 结果只能是「没有 550W」，不能是「DSH 打不开」。

四层守卫

层	失败时会发生什么	实现
装配	插件整体不生效，DSH 照常启动	apply() 整体 try/catch，失败只打一条 warn
路由	该请求返回 500 JSON，异常不冒泡给 webserver	每个 handler 过 guardHandler()；坏请求 400
首屏注入	原样返回宿主给的 html，首屏不受影响	tapIndex 整体 try/catch，任何异常都回退
客户端	设置页消失，动画/主题照常	apply() 包裹；拿不到 react 就跳过设置页
版本	宿主直接跳过该 bundle（不是崩溃）	engines.dsh: >=0.2.0-rc.1 <0.3.0-0

engines.dsh 是 DSH 唯一真正评估的兼容字段（dsh.compatibility 只是文档）。 版本不匹配时宿主会跳过该 bundle并给出提示，需要时可 dsh plugin allow-version 精确豁免。

五条逃生口

按「从最轻到最彻底」排列：

#	手段	作用范围	怎么用
1	?moss=off	本次页面加载：不播动画、摘掉主题（门禁不跳过）	地址后加参数
2	「跳过本次」按钮	门禁：核验服务 5xx / 网络不通时自动出现	点一下，本会话放行
3	改配置	门禁：auth.enabled=false（或删掉 salt/hash）	编辑 <DSH_HOME>/dsh-moss.json，刷新即生效
4	环境变量	整个 Host 半侧：零注册、零注入	DSH_STARTUP_MOSS=off 后重启 DSH
5	卸载	彻底移除	dsh plugin --profile desktop remove dsh-startup-moss

为什么 ?moss=off 不顺手放行门禁：那样一个 URL 参数就等于口令，口令就没意义了。 门禁的自动放行只认「插件自己的服务坏掉」（5xx / 连不上），不认「口令输错」。

两个「不会把人锁死」的细节

• 门禁空壳会自杀：无动画且延迟 0 时，注入层会先放一块不透明空壳避免白闪； 如果 gate.js 因为升级/404 没跑起来，这块空壳 6 秒后自动移除并解锁滚动。
• 看门狗：门禁每 600ms 检查启动动画容器是否消失，动画脚本崩了也会按时弹出， 不会出现「动画挂了、门禁也不来、页面停在半黑」的状态。

自检

npm test    # 安全启动：注入自我防护 / 路由守卫 / 空壳自杀 / react 缺失降级 / engines
npm run audit   # 接口与注入的 33 项回归断言

调试

手段	用法
强制重播动画	地址后加 ?moss=1
强制关闭动画	地址后加 ?moss=off
门禁调度日志	控制台看 window.__DSH_MOSS_GATE_LOG__（含 init delay=… / end-event / schedule:* / show:*）
手动拉出门禁	window.__DSH_MOSS_GATE_OPEN__()
看注入是否生效	页面源码里有 window.__DSH_MOSS__ 即注入成功
看主题是否生效	控制台 getComputedStyle(document.body).getPropertyValue('--dsw-alias-bg-base')
离线预览	插件目录起 python3 -m http.server 8899，打开 /preview/?moss=1&speed=0.35

---

DSH 升级后的适配

本插件只依赖 DSH 的半公开接口，不碰 React 组件树、不改 dist、不 hook 内部模块。 升级后最坏情况是功能降级，不会是「DSH 打不开」。按脆弱度排序：

耦合点	依据	断了会怎样	现有兜底	风险
tapIndex + </head> / <body> 字符串	dsh-host-webserver README	动画 / 门禁 / 主题上不了首屏	浏览器半自举（依赖同一套路由）	中
webServer.register({kind,path,handler})	同上	资源 404，自举也拉不到	无	中
ctx.theme.overrideTokens(id, tokens)	dsh-client-ui-theme README	主题不生效或只生效一半	首屏 <style> 兜底（会输给 body 级 token）	中高
61 个 --dsw-* 变量名 + body[data-ds-dark-theme]	design-platform.css	配色错位、明暗判断错	无（变量不存在=静默无效，不报错）	高（最易漂移）
window.__ModuleLoader__.load + dsh.client	全市场插件同款	设置页与实时换肤消失	动画 / 门禁仍可跑	低概率高影响
<DSH_HOME>/sessions/**（v4）+ data/cron/tasks.json	实际磁盘布局	会话 / 任务显示 0	null → 显示 —	低（只影响读数）
profileContext / agentDefaultModel 服务	非公开	事实采集为空	已 try/catch	低

升级后的 5 分钟自检

1. 重启后看首屏：登录 → 动画 → 体检 → 门禁 四段是否齐全；缺哪段就知道坏在注入层还是客户端层。
2. 设置里有没有「550W 核心终端」：没有 = 客户端 bundle 没加载（__ModuleLoader__ 契约变了）。
3. 切一次主题：颜色不变 = ctx.theme.overrideTokens 签名变了（此时首屏 <style> 仍应生效）。
4. 体检页里 SESSIONS / CRON / UPDATES 是不是 —：是的话就是对应数据源改名（如 session.v5）。
5. 颜色发灰或只变一半：多半是 --dsw-* 变量改名 —— 打开 lib/theme.js，对照宿主 design-platform.css 里的新 token 名逐条替换即可（只有这一个文件需要改）。

版本策略

• package.json 的 version 只在适配性变化时升 minor：0.4.0 → 0.5.0 表示「适配了新的 DSH」。
• 纯视觉微调走 patch。
• 已声明 "engines": { "dsh": ">=0.2.0-rc.1 <0.3.0-0" }。DSH 实际评估的就是它 （dsh.compatibility 只是给人看的文档）：版本不匹配时宿主会跳过该 bundle （不是崩溃），需要时可用 dsh plugin allow-version 精确豁免。 升到 0.3 时先改这个范围、验证、再发版。

---

排查表

现象	可能原因	处理
重启后什么动画都没有	enabled / splash.enabled 为 false；或本会话已播过	用 ?moss=1 强制重播；看设置页开关
动画有，但界面没染色	theme.mode=off；或与 palette 类插件冲突	设置里切换主题；只留一个换肤插件
主题只变了一半	--dsw-* 变量名变了	对照 design-platform.css 改 lib/theme.js
设置里没有这一节	客户端 bundle 没加载	看控制台有没有 __ModuleLoader__ 报错；确认 dsh.client 声明
门禁不弹	auth.enabled=false；或没设口令	设置里先设口令再开
门禁一直判错	口令含非法字符 / 改了配置文件	用 /password 接口重设，或 auth.enabled=false 解除
体检数字全是 —	数据源路径变了	见上表「数据源」行；单项缺失不影响其它
关掉插件后刷新仍染红	0.4.0 的总开关漏了主题（0.4.1 已修）	升级到 0.4.1+

---

卸载

dsh plugin --profile desktop remove dsh-startup-moss

然后删掉 ~/.dsh/dsh-moss.json（可选，留着也不会被别的插件读）。

---

文件结构

dsh-startup-moss/
├── package.json          # dsh.bundle.patch + dsh.client
├── cordis.patch.yml      # bundle 层 insert 行
├── lib/
│   ├── index.js          # Host 半：路由 + index 注入 + 配置/口令 API
│   ├── config.js         # 配置读写、scrypt、尝试节流、首次播种
│   ├── theme.js          # 550W / MOSS 两套 token 表（61 变量 × light/dark）
│   ├── hostinfo.js       # 本机体检采集（30s 缓存）
│   ├── splash.js         # 启动动画运行时（无依赖）
│   ├── splash.css
│   ├── gate.js           # 口令门禁运行时
│   └── gate.css
├── client/
│   └── client.js         # 浏览器半：设置页 + 主题服务 + 自举
├── preview/              # 离线预览与姿态校验页
│   ├── index.html
│   ├── pose.html
│   └── injected.html
└── docs/screenshots/     # 上面那些图

---

开发

# 1. 本地起预览（不需要 DSH）
cd dsh-startup-moss && python3 -m http.server 8899
# http://127.0.0.1:8899/preview/?moss=1
# http://127.0.0.1:8899/preview/?moss=1&speed=0.35   # 慢放，方便截帧
# http://127.0.0.1:8899/preview/pose.html?pose=emblem|moss|final  # 静态姿态

# 2. 改完装进 DSH（link 安装时不用重装，重启即生效）
dsh plugin --profile desktop add link:$PWD

# 3. 语法自检
for f in lib/*.js client/client.js; do node --check "$f"; done

改主题只需要动 lib/theme.js（token 表）和 lib/splash.css（动画观感）； 改时序动 lib/splash.js 顶部的 t = { … }。

---

许可

MIT。界面风格致敬《流浪地球 2》，不含任何影片素材（无剧照、无原声、无字体文件）。