@max-null/dsh-achievements 0.1.0

package/README.md

@@ -0,0 +1,28 @@
+# dsh-achievements 路 SSiD 全家桶成就插件
+
+[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSS）全局进度成就系统：监听 session / tool 事件，把工具调用、记忆/模板库工具、上下文审计、token 用量、GenUI 渲染等行为折成成就进度，解锁时 toast + 设置页「成就」面板（全景：含 GenUI 类别的融合视图）。
+
+## 特性
+
+- **18 个成就**、7 类别（启程 / 记忆 / 审计 / GenUI / 工具 / 行为 / 隐藏），稀有度覆盖 普通 → 传说；隐藏成就（如 夜猫子、自我指涉、亿万富翁）解锁前显示「？？」
+- **分层面板**：工具名、事件类型、token 计数、当天时刻等叶级标量——**绝不读取消息正文、文件内容或错误详情**
+- **GenUI 融合**：client 读取 genui 插件自身的计数存储（`dsh.genui.achievements`），上报合并——全景页与 genui 成就页数据同源、互不重复计数
+- **本地持久化**：`$DSH_HOME/achievements/state.json`，重启保留
+- **HTTP 通道**：`/achievements/api`（list / recent / clear / genui-merge），信任围栏同 dsh-memory 的 `/memory/api`
+- **模型工具**：`list_achievements`（只读进度查询）
+
+## 接入
+
+```bash
+dsh plugin add @max-null/dsh-achievements
+```
+
+设置页 → 「成就」；首次解锁 toast 在页面右下角弹出。
+
+## 配置
+
+无（零配置；`$DSH_HOME` 缺省 `~/.dsh`）。
+
+## 设计纪律
+
+成就的意义在「激励探索」而非「统计监控」：所有计数只保留推理所需的叶级标量；卸载/清空（`clear`）随时可重置；深度内容（正文/文件）不在任何成就的判定路径上。

package/client.js

@@ -0,0 +1,252 @@
+window.__ModuleLoader__.load({
+  id: "@max-null/dsh-achievements",
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client/index.tsx
+var index_exports = {};
+__export(index_exports, {
+  AchievementsView: () => AchievementsView,
+  apply: () => apply,
+  inject: () => inject,
+  mountToastLayer: () => mountToastLayer
+});
+module.exports = __toCommonJS(index_exports);
+var import_react = require("react");
+async function api(method, body) {
+  try {
+    const response = await fetch(`/achievements/api/${method}`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(body ?? {})
+    });
+    const payload = await response.json();
+    return payload.value ?? null;
+  } catch {
+    return null;
+  }
+}
+var STRINGS = {
+  zh: {
+    title: "\u6210\u5C31",
+    desc: "SSiD \u5168\u5BB6\u6876\u8FDB\u5EA6\uFF1A\u5DE5\u5177/\u8BB0\u5FC6/\u5BA1\u8BA1/GenUI \u4F7F\u7528\u6210\u5C31\uFF0C\u89E3\u9501\u53EF\u9886 toast\u3002",
+    refresh: "\u5237\u65B0",
+    locked: "\u672A\u89E3\u9501",
+    unlocked: "\u5DF2\u89E3\u9501"
+  },
+  en: {
+    title: "Achievements",
+    desc: "SSiD family progress: tool/memory/audit/GenUI usage trophies with unlock toasts.",
+    refresh: "Refresh",
+    locked: "Locked",
+    unlocked: "Unlocked"
+  }
+};
+var GENUI_LS_KEY = "dsh.genui.achievements";
+function readGenUI() {
+  try {
+    const raw = localStorage.getItem(GENUI_LS_KEY);
+    if (raw === null) return { unlockedCount: 0, fences: 0 };
+    const parsed = JSON.parse(raw);
+    return {
+      unlockedCount: Object.keys(parsed.unlocked ?? {}).length,
+      fences: parsed.state?.fences ?? 0
+    };
+  } catch {
+    return { unlockedCount: 0, fences: 0 };
+  }
+}
+function lang() {
+  return typeof document !== "undefined" && (document.documentElement.lang || "zh").toLowerCase().startsWith("zh") ? "zh" : "en";
+}
+function AchievementsView(_props) {
+  const [snapshot, setSnapshot] = (0, import_react.useState)(null);
+  const [category, setCategory] = (0, import_react.useState)("\u5168\u90E8");
+  const [note, setNote] = (0, import_react.useState)("");
+  const t = STRINGS[lang()];
+  const reload = (0, import_react.useCallback)(async () => {
+    const genui = readGenUI();
+    await api("genui-merge", genui);
+    const data = await api("list");
+    if (data !== null) setSnapshot(data);
+  }, []);
+  (0, import_react.useEffect)(() => {
+    void reload();
+    const timer = window.setInterval(() => void reload(), 15e3);
+    return () => window.clearInterval(timer);
+  }, []);
+  const categories = snapshot === null ? ["\u5168\u90E8"] : ["\u5168\u90E8", ...new Set(snapshot.achievements.map((a) => a.category))];
+  const items = snapshot?.achievements.filter((a) => category === "\u5168\u90E8" || a.category === category) ?? [];
+  return (0, import_react.createElement)(
+    "div",
+    { className: "ach", "data-dsh-achievements-view": "" },
+    (0, import_react.createElement)(
+      "div",
+      { className: "achHead" },
+      (0, import_react.createElement)("span", { className: "achTitle" }, t.title),
+      (0, import_react.createElement)("span", { className: "achMeta" }, snapshot !== null ? `${snapshot.unlocked} / ${snapshot.total}` : "\u2026"),
+      (0, import_react.createElement)("button", {
+        type: "button",
+        className: "achBtn",
+        onClick: () => {
+          void reload();
+          setNote("\u5DF2\u5237\u65B0");
+          window.setTimeout(() => setNote(""), 1500);
+        }
+      }, t.refresh)
+    ),
+    (0, import_react.createElement)("div", { className: "achDesc" }, t.desc),
+    (0, import_react.createElement)(
+      "div",
+      { className: "achCats" },
+      categories.map((c) => (0, import_react.createElement)("button", {
+        key: c,
+        type: "button",
+        className: `achCat${category === c ? " achCatOn" : ""}`,
+        onClick: () => setCategory(c)
+      }, c))
+    ),
+    (0, import_react.createElement)(
+      "div",
+      { className: "achList" },
+      items.map((a) => (0, import_react.createElement)(
+        "div",
+        { key: a.id, className: `achRow${a.locked ? "" : " achRowOn"}` },
+        (0, import_react.createElement)("span", { className: "achIcon", "aria-hidden": "" }, a.icon),
+        (0, import_react.createElement)(
+          "div",
+          { className: "achBody" },
+          (0, import_react.createElement)(
+            "div",
+            { className: "achName" },
+            a.name,
+            (0, import_react.createElement)(
+              "span",
+              { className: `achRarity achRarity-${a.rarity}` },
+              a.rarity === "legendary" ? "\u4F20\u8BF4" : a.rarity === "epic" ? "\u53F2\u8BD7" : a.rarity === "rare" ? "\u7A00\u6709" : "\u666E\u901A"
+            )
+          ),
+          (0, import_react.createElement)("div", { className: "achDesc2" }, a.desc),
+          (0, import_react.createElement)(
+            "div",
+            { className: "achProgRow" },
+            (0, import_react.createElement)(
+              "div",
+              { className: "achProg" },
+              (0, import_react.createElement)("div", {
+                className: "achProgFill",
+                style: { width: `${Math.min(100, Math.round(a.progress.current / a.progress.target * 100))}%` }
+              })
+            ),
+            (0, import_react.createElement)("span", { className: "achProgNum" }, `${a.progress.current} / ${a.progress.target}`)
+          )
+        ),
+        (0, import_react.createElement)("span", { className: `achState${a.locked ? "" : " achStateOn"}` }, a.locked ? t.locked : t.unlocked)
+      ))
+    ),
+    note !== "" ? (0, import_react.createElement)("div", { className: "achNote" }, note) : null
+  );
+}
+function mountToastLayer() {
+  if (typeof document === "undefined") return () => {
+  };
+  const host = document.createElement("div");
+  host.dataset.dshAchievementsToast = "1";
+  document.body.appendChild(host);
+  const render = () => {
+    void api("recent").then((data) => {
+      if (data === null || data.length === 0) return;
+      host.textContent = "";
+      for (const u of data) {
+        const row = document.createElement("div");
+        row.className = "at-row";
+        row.textContent = `\u{1F3C6} \u6210\u5C31\u89E3\u9501\uFF1A${u.name}`;
+        host.appendChild(row);
+      }
+      window.setTimeout(() => {
+        host.textContent = "";
+      }, 4200);
+    });
+  };
+  const first = window.setTimeout(render, 2500);
+  const interval = window.setInterval(render, 8e3);
+  return () => {
+    window.clearTimeout(first);
+    window.clearInterval(interval);
+    host.remove();
+  };
+}
+var inject = ["slots"];
+function apply(ctx) {
+  const disposers = [];
+  ctx.slots.inject("settings.section", () => ctx.slots.register({
+    name: "settings.section",
+    id: "ssid-achievements",
+    order: 90,
+    label: () => STRINGS[lang()].title
+  }, () => (0, import_react.createElement)(AchievementsView, { visible: true })));
+  disposers.push(mountToastLayer());
+  return () => {
+    for (const dispose of disposers) dispose();
+  };
+}
+if (typeof document !== "undefined" && document.querySelector("style[data-dsh-achievements-css]") === null) {
+  const tag = document.createElement("style");
+  tag.dataset.dshAchievementsCss = "1";
+  tag.textContent = CSS;
+  document.head.appendChild(tag);
+}
+var CSS = [
+  ".ach{display:flex;flex-direction:column;gap:10px;padding:4px 0}",
+  ".achHead{display:flex;align-items:center;gap:10px}",
+  ".achTitle{font-size:14px;font-weight:600;color:var(--dsw-alias-label-primary,inherit)}",
+  ".achMeta{font-size:13px;color:var(--dsw-alias-label-secondary,inherit)}",
+  ".achBtn{margin-left:auto;padding:4px 12px;border:1px solid var(--dsw-alias-border-l1,rgba(127,127,127,.4));border-radius:8px;background:transparent;color:var(--dsw-alias-label-primary,inherit);font-size:12px;cursor:pointer}",
+  ".achDesc{font-size:12px;line-height:1.5;color:var(--dsw-alias-label-tertiary,inherit)}",
+  ".achCats{display:flex;flex-wrap:wrap;gap:6px}",
+  ".achCat{padding:3px 10px;border:1px solid var(--dsw-alias-border-l1,rgba(127,127,127,.4));border-radius:999px;background:transparent;color:var(--dsw-alias-label-secondary,inherit);font-size:12px;cursor:pointer}",
+  ".achCatOn{border-color:var(--dsw-alias-state-business-primary,#4f8ef7);color:var(--dsw-alias-state-business-primary,#4f8ef7)}",
+  ".achList{display:flex;flex-direction:column;gap:8px;max-height:420px;overflow:auto}",
+  ".achRow{display:flex;align-items:center;gap:10px;padding:10px 12px;border:1px solid var(--dsw-alias-border-l1,rgba(127,127,127,.25));border-radius:12px}",
+  ".achRowOn{border-color:color-mix(in srgb,var(--dsw-alias-state-business-primary,#4f8ef7) 35%,transparent)}",
+  ".achIcon{font-size:20px;line-height:1}",
+  ".achBody{flex:1;min-width:0}",
+  ".achName{display:flex;align-items:center;gap:8px;font-size:13px;font-weight:600;color:var(--dsw-alias-label-primary,inherit)}",
+  ".achRarity{font-size:11px;padding:0 6px;border-radius:6px;background:color-mix(in srgb,var(--dsw-alias-state-business-primary,#4f8ef7) 14%,transparent);color:var(--dsw-alias-state-business-primary,#4f8ef7)}",
+  ".achRarity-rare{background:color-mix(in srgb,#f59e0b 14%,transparent);color:#f59e0b}",
+  ".achRarity-epic{background:color-mix(in srgb,#a78bfa 14%,transparent);color:#a78bfa}",
+  ".achRarity-legendary{background:color-mix(in srgb,#f43f5e 14%,transparent);color:#f43f5e}",
+  ".achDesc2{font-size:12px;line-height:1.5;color:var(--dsw-alias-label-secondary,inherit)}",
+  ".achProgRow{display:flex;align-items:center;gap:8px;margin-top:4px}",
+  ".achProg{flex:1;height:4px;border-radius:999px;background:var(--dsw-alias-border-l1,rgba(127,127,127,.3));overflow:hidden}",
+  ".achProgFill{height:100%;background:var(--dsw-alias-state-business-primary,#4f8ef7)}",
+  ".achProgNum{font-size:11px;color:var(--dsw-alias-label-tertiary,inherit)}",
+  ".achState{flex:none;font-size:11px;color:var(--dsw-alias-label-tertiary,inherit)}",
+  ".achStateOn{color:var(--dsw-alias-state-success-primary,#6ccb5f)}",
+  ".achNote{font-size:12px;color:var(--dsw-alias-state-success-primary,#6ccb5f)}",
+  ".at-row{position:fixed;right:16px;bottom:16px;z-index:9999;width:300px;padding:10px 12px;border:1px solid var(--dsw-alias-state-business-primary,#4f8ef7);border-radius:12px;background:var(--dsw-alias-bg-layer-2,rgba(0,0,0,.85));color:var(--dsw-alias-state-business-primary,#4f8ef7);font-size:13px;box-shadow:0 8px 24px rgba(0,0,0,.25)}"
+].join("");
+    return module.exports;
+  },
+});
+

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# dsh-achievements bundle patch: one insert over the profile root.
+# The engine observes session/tool events already provided by the host
+# (dsh-base); this adds only the achievements plugin.
+- insert:
+    - id: achievements
+      name: '@max-null/dsh-achievements'

package/dist/engine.d.ts

@@ -0,0 +1,48 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { type AchieveState } from './rules.ts';
+export interface EngineSnapshot {
+    state: AchieveState;
+    distinct: Record<string, number>;
+    unlocked: Record<string, number>;
+    recent: Array<{
+        id: string;
+        name: string;
+        rarity: string;
+        icon: string;
+    }>;
+}
+/** 引擎（带事件源的宿主注入）。 */
+export declare class AchievementsEngine {
+    private store;
+    private queue;
+    /** 回合中间状态（agent key → 工具计数）。 */
+    private turnTools;
+    get count(): AchieveState;
+    recordTool(name: string): void;
+    recordTurnStart(agentKey: string): void;
+    recordTurnTool(agentKey: string): void;
+    recordTurnEnd(agentKey: string): void;
+    recordSession(): void;
+    recordTurn(): void;
+    recordMidnight(): void;
+    recordTokens(amount: number): void;
+    /** GenUI 计数合并（client 写入；host 侧直接写计数键）。 */
+    mergeGenUI(unlockedCount: number, fences: number): void;
+    /** 检查解锁；返回新解锁（进队列 + 持久化；计数每次落盘）。 */
+    flush(): void;
+    snapshot(): EngineSnapshot;
+    drainRecent(): Array<{
+        id: string;
+        name: string;
+        rarity: string;
+        icon: string;
+    }>;
+    fullSnapshot(): Record<string, unknown>;
+    clear(): void;
+}
+/** 事件监听接线（0.1.1-rc.2 宿主事件面）。 */
+export declare function attachListeners(ctx: Context, engine: AchievementsEngine): void;
+/** HTTP 路由（/achievements/api，POST）——仿 dsh-memory 的 /memory/api 信任围栏。 */
+export declare function registerRoutes(ctx: Context, engine: AchievementsEngine): void;
+/** 工具：list_achievements（模型侧查询进度；只读）。 */
+export declare function registerTool(ctx: Context, engine: AchievementsEngine): void;

package/dist/engine.js

@@ -0,0 +1,344 @@
+/**
+ * engine.ts — 成就引擎：session/tool 事件监听 → 计数 → 解锁队列 →
+ * 持久化（`$DSH_HOME/achievements/state.json`）+ HTTP 路由 + 工具。
+ *
+ * 隐私纪律：只读叶级标量（工具名/成功标志/session 事件类型/token 数/
+ * 当天时刻），绝不读消息正文/文件内容/错误详情。
+ */
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { checkUnlocks, emptyState, snapshot } from "./rules.js";
+const STATE_SCHEMA_VERSION = 1;
+function stateDir() {
+    return join(process.env.DSH_HOME ?? join(homedir(), '.dsh'), 'achievements');
+}
+class StateStore {
+    counters = emptyState();
+    distinct = {};
+    unlocked = {};
+    file;
+    constructor() {
+        this.file = join(stateDir(), 'state.json');
+        this.load();
+    }
+    load() {
+        try {
+            const parsed = JSON.parse(readFileSync(this.file, 'utf8'));
+            const base = emptyState();
+            for (const [key, value] of Object.entries(parsed.counters ?? {})) {
+                if (typeof value === 'number')
+                    this.counters[key] = (this.counters[key] ?? 0) + value;
+                else
+                    this.counters[key] = base[key] ?? 0;
+            }
+            for (const [key, values] of Object.entries(parsed.distinct ?? {})) {
+                if (Array.isArray(values))
+                    this.distinct[key] = new Set(values.filter(v => typeof v === 'string'));
+            }
+            for (const [id, at] of Object.entries(parsed.unlocked ?? {})) {
+                if (typeof at === 'number')
+                    this.unlocked[id] = at;
+            }
+        }
+        catch {
+            this.counters = emptyState();
+        }
+    }
+    save() {
+        try {
+            mkdirSync(stateDir(), { recursive: true });
+            const data = {
+                schemaVersion: STATE_SCHEMA_VERSION,
+                counters: this.counters,
+                distinct: Object.fromEntries(Object.entries(this.distinct).map(([k, v]) => [k, [...v]])),
+                unlocked: this.unlocked,
+            };
+            writeFileSync(this.file, JSON.stringify(data, null, 2));
+        }
+        catch {
+            // 持久化失败不致命：本页会话内存状态继续工作。
+        }
+    }
+    /** 清零并立即落盘（clear 语义：不重读旧档）。 */
+    reset() {
+        this.counters = emptyState();
+        this.distinct = {};
+        this.unlocked = {};
+        this.save();
+    }
+    bump(key, by = 1) {
+        this.counters[key] = (this.counters[key] ?? 0) + by;
+    }
+    addDistinct(key, value) {
+        let set = this.distinct[key];
+        if (set === undefined) {
+            set = new Set();
+            this.distinct[key] = set;
+        }
+        if (!set.has(value)) {
+            set.add(value);
+            this.save();
+        }
+    }
+    get count() { return { ...this.counters }; }
+    get distinctCounts() {
+        const out = {};
+        for (const [key, set] of Object.entries(this.distinct))
+            out[key] = set.size;
+        return out;
+    }
+    get unlockMap() { return { ...this.unlocked }; }
+    setUnlocked(id, at) { this.unlocked[id] = at; }
+    totalDistinct(key) { return this.distinct[key]?.size ?? 0; }
+}
+/** family 指纹：记忆类工具（dsh-memory / prompt 模板库）。 */
+const MEMORY_TOOLS = new Set([
+    'memory_save', 'memory_list', 'memory_search', 'memory_confirm', 'memory_forget', 'memory_update',
+    'prompt_search', 'prompt_get', 'prompt_list', 'prompt_add',
+]);
+const CONFIRM_TOOLS = new Set(['memory_confirm']);
+const TEMPLATE_TOOLS = new Set(['prompt_search', 'prompt_get', 'prompt_list', 'prompt_add']);
+const AUDIT_TOOLS = new Set(['context_audit']);
+/** 引擎（带事件源的宿主注入）。 */
+export class AchievementsEngine {
+    store = new StateStore();
+    queue = [];
+    /** 回合中间状态（agent key → 工具计数）。 */
+    turnTools = new Map();
+    get count() { return this.store.count; }
+    recordTool(name) {
+        this.store.bump('tools');
+        this.store.addDistinct('toolsUsed', name);
+        if (MEMORY_TOOLS.has(name))
+            this.store.bump('memoryTools');
+        if (CONFIRM_TOOLS.has(name))
+            this.store.bump('memoryConfirmed');
+        if (TEMPLATE_TOOLS.has(name))
+            this.store.bump('templateTools');
+        if (AUDIT_TOOLS.has(name))
+            this.store.bump('audits');
+        if (name === 'list_achievements')
+            this.store.bump('selfQueries');
+    }
+    recordTurnStart(agentKey) {
+        this.turnTools.set(agentKey, 0);
+    }
+    recordTurnTool(agentKey) {
+        const current = (this.turnTools.get(agentKey) ?? 0) + 1;
+        this.turnTools.set(agentKey, current);
+        if (current >= 10)
+            this.store.bump('marathonTurns'); // 单回合 10 次工具（一次性语义靠解锁幂等）
+    }
+    recordTurnEnd(agentKey) {
+        this.turnTools.delete(agentKey);
+    }
+    recordSession() { this.store.bump('sessions'); }
+    recordTurn() { this.store.bump('turns'); }
+    recordMidnight() { this.store.bump('midnightTurns'); }
+    recordTokens(amount) { if (amount > 0)
+        this.store.bump('tokens', amount); }
+    /** GenUI 计数合并（client 写入；host 侧直接写计数键）。 */
+    mergeGenUI(unlockedCount, fences) {
+        this.store.bump('genuiUnlocked', Math.max(0, unlockedCount));
+        this.store.bump('genuiFences', Math.max(0, fences));
+    }
+    /** 检查解锁；返回新解锁（进队列 + 持久化；计数每次落盘）。 */
+    flush() {
+        const state = this.count;
+        const fresh = checkUnlocks(state, this.store.unlockMap);
+        for (const achievement of fresh) {
+            const at = Date.now();
+            this.store.setUnlocked(achievement.id, at);
+            this.queue.push({ id: achievement.id, name: achievement.name, rarity: achievement.rarity, icon: achievement.icon });
+        }
+        this.store.save();
+    }
+    snapshot() {
+        return {
+            state: this.count,
+            distinct: this.store.distinctCounts,
+            unlocked: this.store.unlockMap,
+            recent: [...this.queue].slice(-5),
+        };
+    }
+    drainRecent() {
+        const queue = this.queue;
+        this.queue = [];
+        return queue;
+    }
+    fullSnapshot() {
+        return {
+            ...snapshot(this.count, this.store.unlockMap),
+            recent: this.snapshot().recent,
+            distinct: this.store.distinctCounts,
+        };
+    }
+    clear() {
+        this.store.reset();
+        this.queue = [];
+    }
+}
+/** 事件监听接线（0.1.1-rc.2 宿主事件面）。 */
+export function attachListeners(ctx, engine) {
+    // tools/result：工具执行完成（冻结的最终结果）。
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    ctx.on('tools/result', ((exec, result) => {
+        const name = typeof exec?.name === 'string' ? exec.name : '';
+        if (name === '')
+            return;
+        engine.recordTool(name);
+        engine.recordTurnTool(agentKeyOf(exec));
+        if (result?.isError !== true) {
+            // 成功即可；失败也计入 tools（recordTool 已计）
+        }
+        engine.flush();
+    }));
+    // session/event：usage / header / user 消息 / 会话首事件（叶级标量）。
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    ctx.on('session/event', ((session, event) => {
+        if (event?.type === 'assistant/message') {
+            const usage = event.data?.usage;
+            if (usage !== undefined && typeof usage === 'object') {
+                let total = 0;
+                for (const key of ['inputTokens', 'outputTokens', 'cacheReadTokens', 'cacheWriteTokens', 'reasoningTokens']) {
+                    const value = usage[key];
+                    if (typeof value === 'number')
+                        total += value;
+                }
+                engine.recordTokens(total);
+                engine.flush();
+            }
+            return;
+        }
+        if (event?.type === 'user/message') {
+            const hour = new Date().getHours();
+            if (hour >= 0 && hour < 5)
+                engine.recordMidnight();
+            engine.flush();
+            return;
+        }
+        if (event?.type === 'session/start') {
+            engine.recordSession();
+            engine.recordTurn();
+            engine.flush();
+        }
+    }));
+}
+function agentKeyOf(exec) {
+    const id = exec?.agent?.id;
+    return typeof id === 'string' ? id : 'root';
+}
+/** HTTP 路由（/achievements/api，POST）——仿 dsh-memory 的 /memory/api 信任围栏。 */
+export function registerRoutes(ctx, engine) {
+    const webServer = ctx.webServer;
+    const webRuntime = ctx.webRuntime;
+    ctx.effect(() => webServer.register({
+        kind: 'prefix',
+        path: '/achievements/api',
+        handler: async (req, res) => {
+            const request = req;
+            if (!isTrusted(request, webRuntime.trustedHosts)) {
+                writeJson(res, 403, { ok: false, error: { code: 'forbidden', message: 'forbidden' } });
+                return;
+            }
+            if (request.method !== 'POST') {
+                writeJson(res, 405, { ok: false, error: { code: 'method-error', message: 'method not allowed' } });
+                return;
+            }
+            const pathname = new URL(request.url ?? '/', 'http://dsh.internal').pathname;
+            const method = pathname.startsWith('/achievements/api/') ? pathname.slice('/achievements/api/'.length) : undefined;
+            if (method === undefined || method.includes('/')) {
+                writeJson(res, 404, { ok: false, error: { code: 'not-found', message: 'unknown achievement API method' } });
+                return;
+            }
+            try {
+                switch (method) {
+                    case 'list':
+                        writeJson(res, 200, { ok: true, value: engine.fullSnapshot() });
+                        return;
+                    case 'recent':
+                        writeJson(res, 200, { ok: true, value: engine.drainRecent() });
+                        return;
+                    case 'clear':
+                        engine.clear();
+                        writeJson(res, 200, { ok: true, value: engine.fullSnapshot() });
+                        return;
+                    case 'genui-merge': {
+                        const body = (await readJsonBody(req));
+                        engine.mergeGenUI(typeof body.unlockedCount === 'number' ? body.unlockedCount : 0, typeof body.fences === 'number' ? body.fences : 0);
+                        engine.flush();
+                        writeJson(res, 200, { ok: true, value: engine.fullSnapshot() });
+                        return;
+                    }
+                    default:
+                        writeJson(res, 404, { ok: false, error: { code: 'not-found', message: `unknown method "${method}"` } });
+                }
+            }
+            catch (error) {
+                writeJson(res, 500, { ok: false, error: { code: 'internal', message: error instanceof Error ? error.message : String(error) } });
+            }
+        },
+    }), '@max-null/dsh-achievements: /achievements/api routes');
+}
+const MAX_BODY_BYTES = 1 << 20;
+async function readJsonBody(req) {
+    const chunks = [];
+    let total = 0;
+    for await (const chunk of req) {
+        const buffer = Buffer.from(chunk);
+        total += buffer.length;
+        if (total > MAX_BODY_BYTES)
+            throw new Error('request body too large');
+        chunks.push(buffer);
+    }
+    try {
+        return JSON.parse(Buffer.concat(chunks).toString('utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+/** 工具：list_achievements（模型侧查询进度；只读）。 */
+export function registerTool(ctx, engine) {
+    ctx.tools.register(defineTool({
+        name: 'list_achievements',
+        description: '查询 SSiD 成就系统状态：已解锁成就、总成就数、最近解锁与各项进度。只读，不影响会话。',
+        parameters: {},
+        output: {
+            schema: { type: 'json' },
+            render: (_args, value) => [{ type: 'text', text: JSON.stringify(value, null, 2) }],
+        },
+        execute: (_args) => Promise.resolve(engine.fullSnapshot()),
+    }));
+}
+/* ---- 路由辅助（与 dsh-memory routes.ts 同款） ---- */
+function writeJson(res, status, body) {
+    const r = res;
+    try {
+        r.writeHead(status, { 'content-type': 'application/json; charset=utf-8' });
+        r.end(JSON.stringify(body));
+    }
+    catch {
+        // 流已关闭/非法响应：忽略
+    }
+}
+/** loopback / trustedHosts 围栏（与 /memory/api 一致）。 */
+function isTrusted(request, trustedHosts) {
+    const host = request.headers['host'];
+    const hostValue = typeof host === 'string' ? host : '';
+    const authority = typeof request.headers[':authority'] === 'string' ? request.headers[':authority'] : hostValue;
+    if (authority !== '') {
+        try {
+            const u = new URL(`http://${authority}`);
+            if (u.hostname === 'localhost' || u.hostname === '[::1]' || /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(u.hostname))
+                return true;
+            if (trustedHosts.includes(u.hostname))
+                return true;
+        }
+        catch { /* fall through */ }
+        return false;
+    }
+    return trustedHosts.length > 0 ? trustedHosts.includes('*') : true;
+}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @max-null/dsh-achievements host half: the achievements engine for the SSiD
+ * family. Observes the session/tool event plane, folds leaf scalars into
+ * durable counters, unlocks trophies (toast queue + HTTP + tool view), and
+ * serves /achievements/api to the browser half. Privacy: counters only —
+ * tool names, event kinds, token counts; message/file/error content is never
+ * read. The GenUI category is merged by the client reading the genui
+ * plugin's own localStorage counters.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "@max-null/dsh-achievements";
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;
+export { AchievementsEngine } from './engine.ts';
+export { ACHIEVEMENTS, checkUnlocks, emptyState, snapshot, viewOf } from './rules.ts';
+export type { AchieveState, AchievementDef, Category, Rarity } from './rules.ts';

package/dist/index.js

@@ -0,0 +1,19 @@
+import { AchievementsEngine, attachListeners, registerRoutes, registerTool } from "./engine.js";
+export const name = '@max-null/dsh-achievements';
+export const inject = ['tools', 'webServer', 'webRuntime'];
+export function apply(ctx) {
+    const engine = new AchievementsEngine();
+    attachListeners(ctx, engine);
+    registerRoutes(ctx, engine);
+    registerTool(ctx, engine);
+    ctx.on('agent/session-start', (() => {
+        engine.recordSession();
+        engine.flush();
+    }));
+    ctx.on('agent/turn-stopping', (() => {
+        engine.recordTurn();
+        engine.flush();
+    }));
+}
+export { AchievementsEngine } from "./engine.js";
+export { ACHIEVEMENTS, checkUnlocks, emptyState, snapshot, viewOf } from "./rules.js";

package/dist/rules.d.ts

@@ -0,0 +1,55 @@
+/**
+ * rules.ts — SSiD 全家桶成就定义（纯数据/纯函数，零依赖可测）。
+ *
+ * 计数语义只含「工具名/事件类型/时间」级别的标量：工具调用名与成功与否、
+ * 会话/回合计数、usage token 数（叶级标量）、当天时刻。绝不读取消息正文、
+ * 文件内容或错误详情。GenUI 类别由 client 侧读取 genui 插件的计数
+ * localStorage 合并（见 client/index.tsx）。
+ */
+export type Category = '启程' | '记忆' | '审计' | 'GenUI' | '工具' | '行为' | '隐藏';
+export type Rarity = 'common' | 'rare' | 'epic' | 'legendary';
+export interface AchievementDef {
+    id: string;
+    name: string;
+    desc: string;
+    icon: string;
+    category: Category;
+    rarity: Rarity;
+    hidden?: boolean;
+    /** 阈值规则：计数器键 → 目标值。 */
+    threshold: {
+        counter: string;
+        target: number;
+    };
+}
+/** 计数键（leaf scalars only）。 */
+export declare const KEYS: {
+    readonly sessions: "sessions";
+    readonly turns: "turns";
+    readonly tools: "tools";
+    readonly toolsUsed: "toolsUsed";
+    readonly memoryTools: "memoryTools";
+    readonly memorySaved: "memorySaved";
+    readonly memoryConfirmed: "memoryConfirmed";
+    readonly templateTools: "templateTools";
+    readonly audits: "audits";
+    readonly genuiUnlocked: "genuiUnlocked";
+    readonly genuiFences: "genuiFences";
+    readonly marathonTurns: "marathonTurns";
+    readonly midnightTurns: "midnightTurns";
+    readonly selfQueries: "selfQueries";
+    readonly tokens: "tokens";
+};
+/** SSiD 全家桶成就表。 */
+export declare const ACHIEVEMENTS: readonly AchievementDef[];
+/** 成就状态数据（纯标量）。 */
+export interface AchieveState {
+    [index: string]: number;
+}
+export declare function emptyState(): AchieveState;
+/** 检查新解锁（不看 hidden——hidden 仅影响展示）。 */
+export declare function checkUnlocks(state: AchieveState, unlocked: Record<string, number>): AchievementDef[];
+/** 视图行（client 渲染用）。 */
+export declare function viewOf(achievement: AchievementDef, state: AchieveState, unlocked: Record<string, number>): Record<string, unknown>;
+/** 快照（HTTP / 工具共用）。 */
+export declare function snapshot(state: AchieveState, unlocked: Record<string, number>): Record<string, unknown>;

package/dist/rules.js

@@ -0,0 +1,89 @@
+/**
+ * rules.ts — SSiD 全家桶成就定义（纯数据/纯函数，零依赖可测）。
+ *
+ * 计数语义只含「工具名/事件类型/时间」级别的标量：工具调用名与成功与否、
+ * 会话/回合计数、usage token 数（叶级标量）、当天时刻。绝不读取消息正文、
+ * 文件内容或错误详情。GenUI 类别由 client 侧读取 genui 插件的计数
+ * localStorage 合并（见 client/index.tsx）。
+ */
+/** 计数键（leaf scalars only）。 */
+export const KEYS = {
+    sessions: 'sessions',
+    turns: 'turns',
+    tools: 'tools',
+    toolsUsed: 'toolsUsed',
+    memoryTools: 'memoryTools',
+    memorySaved: 'memorySaved',
+    memoryConfirmed: 'memoryConfirmed',
+    templateTools: 'templateTools',
+    audits: 'audits',
+    genuiUnlocked: 'genuiUnlocked',
+    genuiFences: 'genuiFences',
+    marathonTurns: 'marathonTurns',
+    midnightTurns: 'midnightTurns',
+    selfQueries: 'selfQueries',
+    tokens: 'tokens',
+};
+/** SSiD 全家桶成就表。 */
+export const ACHIEVEMENTS = [
+    // ── 启程 ──
+    { id: 'first-session', name: '启程', desc: '第一个会话开跑。', icon: '🚀', category: '启程', rarity: 'common', threshold: { counter: KEYS.sessions, target: 1 } },
+    { id: 'first-turn', name: '初试身手', desc: '完成第一轮对话。', icon: '👋', category: '启程', rarity: 'common', threshold: { counter: KEYS.turns, target: 1 } },
+    { id: 'first-tool', name: '工具初体验', desc: '第一次调用工具。', icon: '🛠️', category: '启程', rarity: 'common', threshold: { counter: KEYS.tools, target: 1 } },
+    // ── 记忆 ──
+    { id: 'memory-first-save', name: '落笔成忆', desc: '第一次使用记忆工具（memory_*）。', icon: '📝', category: '记忆', rarity: 'common', threshold: { counter: KEYS.memoryTools, target: 1 } },
+    { id: 'memory-10', name: '记忆织工', desc: '累计 10 次记忆工具调用。', icon: '🧵', category: '记忆', rarity: 'rare', threshold: { counter: KEYS.memoryTools, target: 10 } },
+    { id: 'memory-first-confirm', name: '审核人', desc: '第一次人工确认（memory_confirm）。', icon: '✅', category: '记忆', rarity: 'rare', threshold: { counter: KEYS.memoryConfirmed, target: 1 } },
+    { id: 'template-user', name: '模板常客', desc: '第一次使用模板库工具（prompt_*）。', icon: '🗂️', category: '记忆', rarity: 'rare', threshold: { counter: KEYS.templateTools, target: 1 } },
+    // ── 审计 ──
+    { id: 'audit-first', name: '上下文审计官', desc: '第一次跑 context_audit。', icon: '🔍', category: '审计', rarity: 'rare', threshold: { counter: KEYS.audits, target: 1 } },
+    { id: 'audit-10', name: '注审老手', desc: '累计 10 次上下文审计。', icon: '🕵️', category: '审计', rarity: 'epic', threshold: { counter: KEYS.audits, target: 10 } },
+    // ── GenUI（client 侧合并 genui 计数）──
+    { id: 'genui-first', name: '第一块面板', desc: 'GenUI 渲染了第一块界面。', icon: '🎨', category: 'GenUI', rarity: 'common', threshold: { counter: KEYS.genuiUnlocked, target: 1 } },
+    { id: 'genui-5', name: '界面收藏家', desc: 'GenUI 解锁 5 个成就。', icon: '🖼️', category: 'GenUI', rarity: 'rare', threshold: { counter: KEYS.genuiUnlocked, target: 5 } },
+    { id: 'genui-25', name: '界面编织者', desc: 'GenUI 渲染过 25 个界面。', icon: '🧶', category: 'GenUI', rarity: 'epic', threshold: { counter: KEYS.genuiFences, target: 25 } },
+    // ── 工具 ──
+    { id: 'tool-10', name: '工具新手', desc: '累计调用 10 次工具。', icon: '🔧', category: '工具', rarity: 'common', threshold: { counter: KEYS.tools, target: 10 } },
+    { id: 'tool-50', name: '工具达人', desc: '累计调用 50 次工具。', icon: '⚙️', category: '工具', rarity: 'rare', threshold: { counter: KEYS.tools, target: 50 } },
+    { id: 'five-tools', name: '多面手', desc: '使用过 5 种不同工具。', icon: '🧰', category: '工具', rarity: 'rare', threshold: { counter: KEYS.toolsUsed, target: 5 } },
+    // ── 行为 ──
+    { id: 'marathon', name: '马拉松', desc: '单回合内调用 10 次工具。', icon: '🏃', category: '行为', rarity: 'rare', hidden: true, threshold: { counter: KEYS.marathonTurns, target: 1 } },
+    { id: 'night-owl', name: '夜猫子', desc: '在凌晨 0-5 点发过消息。', icon: '🦉', category: '行为', rarity: 'rare', hidden: true, threshold: { counter: KEYS.midnightTurns, target: 1 } },
+    // ── 隐藏 ──
+    { id: 'self-ref', name: '自我指涉', desc: '用成就工具查询自己。', icon: '🪞', category: '隐藏', rarity: 'rare', hidden: true, threshold: { counter: KEYS.selfQueries, target: 1 } },
+    { id: 'billionaire', name: '亿万富翁', desc: '累计消耗一亿 token。', icon: '💰', category: '隐藏', rarity: 'legendary', hidden: true, threshold: { counter: KEYS.tokens, target: 100000000 } },
+];
+export function emptyState() {
+    const state = {};
+    for (const achievement of ACHIEVEMENTS)
+        state[achievement.threshold.counter] = 0;
+    return state;
+}
+/** 检查新解锁（不看 hidden——hidden 仅影响展示）。 */
+export function checkUnlocks(state, unlocked) {
+    return ACHIEVEMENTS.filter(achievement => unlocked[achievement.id] === undefined
+        && (state[achievement.threshold.counter] ?? 0) >= achievement.threshold.target);
+}
+/** 视图行（client 渲染用）。 */
+export function viewOf(achievement, state, unlocked) {
+    const current = Math.min(state[achievement.threshold.counter] ?? 0, achievement.threshold.target);
+    return {
+        id: achievement.id,
+        name: achievement.hidden && unlocked[achievement.id] === undefined ? '？？' : achievement.name,
+        desc: achievement.hidden && unlocked[achievement.id] === undefined ? '继续探索以揭示' : achievement.desc,
+        icon: achievement.icon,
+        category: achievement.category,
+        rarity: achievement.rarity,
+        hidden: achievement.hidden === true,
+        unlocked: unlocked[achievement.id] !== undefined,
+        progress: { current, target: achievement.threshold.target },
+    };
+}
+/** 快照（HTTP / 工具共用）。 */
+export function snapshot(state, unlocked) {
+    return {
+        total: ACHIEVEMENTS.length,
+        unlocked: Object.keys(unlocked).length,
+        achievements: ACHIEVEMENTS.map(achievement => viewOf(achievement, state, unlocked)),
+    };
+}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@max-null/dsh-achievements",
+  "version": "0.1.0",
+  "description": "SSiD family progress achievements — listens to session/tool events, folds activity into durable counters, unlocks trophies with toasts and an achievements page; the GenUI category merges the genui plugin's own counter data.",
+  "license": "MIT",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./client": "./client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "client.js",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-locale"
+      ],
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node build-client.mjs",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-session": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.1-rc.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/cordis-plugin-loader": "^1.0.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-session": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.1-rc.1",
+    "@types/node": "^26.2.0",
+    "esbuild": "^0.25.0",
+    "react": "^18.3.1",
+    "tsx": "^4.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.1.0"
+  }
+}