@max-null/dsh-achievements 0.1.1 → 0.1.3

package/README.md

@@ -1,18 +1,28 @@
 # dsh-achievements 路 SSiD 全家桶成就插件
 
-[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSS）全局进度成就系统：监听 session / tool 事件，把工具调用、记忆/模板库工具、上下文审计、token 用量、GenUI 渲染等行为折成成就进度，解锁时 toast + 设置页「成就」面板（全景：含 GenUI 类别的融合视图）。
+[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）全局进度成就系统：监听 session / tool 事件，把工具调用、记忆/模板库工具、上下文审计、token 用量、GenUI 渲染、消息收藏等行为折成成就进度，解锁时 toast + 设置页「成就」面板（全景：含 GenUI 类别的融合视图）。
 
 ## 特性
 
-- **18 个成就**、7 类别（启程 / 记忆 / 审计 / GenUI / 工具 / 行为 / 隐藏），稀有度覆盖 普通 → 传说；隐藏成就（如 夜猫子、自我指涉、亿万富翁）解锁前显示「？？」
+- **23 个成就**、8 类别（启程 / 记忆 / 审计 / GenUI / 收藏 / 工具 / 行为 / 隐藏），稀有度覆盖 普通 → 传说；隐藏成就（如 夜猫子、自我指涉、亿万富翁）解锁前显示「？？」
 - **分层面板**：工具名、事件类型、token 计数、当天时刻等叶级标量——**绝不读取消息正文、文件内容或错误详情**
 - **GenUI 融合**：client 读取 genui 插件自身的计数存储（`dsh.genui.achievements`），上报合并——全景页与 genui 成就页数据同源、互不重复计数
+- **收藏融合**：client 读 dsh-chat-rail 的 `/chat-rail/api/favorites`（只读计数）上报合并——host 侧 `setMax` 取绝对值，重复上报不虚增
 - **本地持久化**：`$DSH_HOME/achievements/state.json`，重启保留
-- **HTTP 通道**：`/achievements/api`（list / recent / clear / genui-merge），信任围栏同 dsh-memory 的 `/memory/api`
+- **HTTP 通道**：`/achievements/api`（list / recent / clear / genui-merge / chat-rail-merge），信任围栏同 dsh-memory 的 `/memory/api`
 - **模型工具**：`list_achievements`（只读进度查询）
 
-## 接入
+## 截图
+
+装完后在设置里多出「成就」一项，展示 SSiD 全家桶使用进度：
+
+**入口：** 设置 → 成就
 
+| 设置入口与面板 |
+|---|
+| ![设置 → 成就](docs/shots/achievements-1.png) |
+
+## 接入
 ```bash
 dsh plugin add @max-null/dsh-achievements
 ```

package/client.js

@@ -71,12 +71,29 @@ var STRINGS = {
 var PLUGIN_SHORT = {
   "@max-null/dsh-memory": "\u8BB0\u5FC6",
   "dsh-context-doctor": "\u5BA1\u8BA1",
-  "@changfenhuang/dsh-genui": "GenUI"
+  "@changfenhuang/dsh-genui": "GenUI",
+  "@max-null/dsh-chat-rail": "\u6536\u85CF"
 };
 function pluginLabel(plugin) {
   if (plugin === null) return null;
   return PLUGIN_SHORT[plugin] ?? plugin.split("/").pop() ?? plugin;
 }
+async function readChatRail() {
+  try {
+    const res = await fetch("/chat-rail/api/favorites", { headers: { Accept: "application/json" } });
+    if (!res.ok) return 0;
+    const data = await res.json();
+    const map = data.value;
+    if (map === null || typeof map !== "object" || Array.isArray(map)) return 0;
+    let total = 0;
+    for (const value of Object.values(map)) {
+      if (Array.isArray(value)) total += value.filter((id) => typeof id === "string" && id !== "").length;
+    }
+    return total;
+  } catch {
+    return 0;
+  }
+}
 var TROPHY_PATHS = [
   "M6 9H4.5a2.5 2.5 0 0 1 0-5H6",
   "M18 9h1.5a2.5 2.5 0 0 0 0-5H18",
@@ -155,6 +172,7 @@ function AchievementsView(_props) {
   const reload = (0, import_react.useCallback)(async () => {
     const genui = readGenUI();
     await api("genui-merge", genui);
+    await api("chat-rail-merge", { total: await readChatRail() });
     const data = await api("list");
     if (data !== null) setSnapshot(data);
   }, []);

package/dist/engine.d.ts

@@ -21,17 +21,31 @@ export declare class AchievementsEngine {
     private queue;
     /** 回合中间状态（agent key → 工具计数）。 */
     private turnTools;
+    /** 已计入 `sessions` 的会话 id，保证一个会话只记一次。 */
+    private countedSessions;
     get count(): AchieveState;
     recordTool(name: string): void;
     recordTurnStart(agentKey: string): void;
     recordTurnTool(agentKey: string): void;
     recordTurnEnd(agentKey: string): void;
     recordSession(): void;
+    /**
+     * 按会话 id 计一次会话。
+     *
+     * 为什么不用 `agent/session-start`：该事件在 DSH 0.1.7 已不存在（0.1.5 在
+     * `core/agent/src/runtime-types.ts`），cordis 对未知事件名静默——监听它不会报错，
+     * 只是永不触发，于是 `sessions` 恒为 0，`first-session` 永久不解锁。现在改由
+     * 会话的首个 `turn/start` 记账（见 `attachListeners` 的 `session/event` 分支）。
+     * @param sessionId - 会话 id；缺id 时不做去重，直接记一次。
+     */
+    recordSessionOnce(sessionId: string): void;
     recordTurn(): void;
     recordMidnight(): void;
     recordTokens(amount: number): void;
     /** GenUI 计数合并（client 写入；host 侧直接写计数键）。 */
     mergeGenUI(unlockedCount: number, fences: number): void;
+    /** chat-rail 收藏绝对值（localStorage 上报；setMax 防重复虚增）。 */
+    mergeChatRail(total: number): void;
     /** 检查解锁；返回新解锁（进队列 + 持久化；计数每次落盘）。 */
     flush(): void;
     snapshot(): EngineSnapshot;

package/dist/engine.js

@@ -71,6 +71,14 @@ class StateStore {
     bump(key, by = 1) {
         this.counters[key] = (this.counters[key] ?? 0) + by;
     }
+    /** merge 上报语义：取 max（外部系统计数为绝对值，重复上报不虚增）。 */
+    setMax(key, value) {
+        if (value <= 0)
+            return;
+        if ((this.counters[key] ?? 0) >= value)
+            return;
+        this.counters[key] = value;
+    }
     addDistinct(key, value) {
         let set = this.distinct[key];
         if (set === undefined) {
@@ -106,6 +114,7 @@ export const ASSOCIATED_PLUGINS = [
     '@max-null/dsh-memory',
     'dsh-context-doctor',
     '@changfenhuang/dsh-genui',
+    '@max-null/dsh-chat-rail',
 ];
 /** 探测已安装的关联插件：SSID_PROFILE_DIR（壳注入）与常见 profile 目录。 */
 export function installedPlugins() {
@@ -129,6 +138,8 @@ export class AchievementsEngine {
     queue = [];
     /** 回合中间状态（agent key → 工具计数）。 */
     turnTools = new Map();
+    /** 已计入 `sessions` 的会话 id，保证一个会话只记一次。 */
+    countedSessions = new Set();
     get count() { return this.store.count; }
     recordTool(name) {
         this.store.bump('tools');
@@ -157,14 +168,37 @@ export class AchievementsEngine {
         this.turnTools.delete(agentKey);
     }
     recordSession() { this.store.bump('sessions'); }
+    /**
+     * 按会话 id 计一次会话。
+     *
+     * 为什么不用 `agent/session-start`：该事件在 DSH 0.1.7 已不存在（0.1.5 在
+     * `core/agent/src/runtime-types.ts`），cordis 对未知事件名静默——监听它不会报错，
+     * 只是永不触发，于是 `sessions` 恒为 0，`first-session` 永久不解锁。现在改由
+     * 会话的首个 `turn/start` 记账（见 `attachListeners` 的 `session/event` 分支）。
+     * @param sessionId - 会话 id；缺id 时不做去重，直接记一次。
+     */
+    recordSessionOnce(sessionId) {
+        if (sessionId === '') {
+            this.recordSession();
+            return;
+        }
+        if (this.countedSessions.has(sessionId))
+            return;
+        this.countedSessions.add(sessionId);
+        this.recordSession();
+    }
     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));
+        this.store.setMax('genuiUnlocked', Math.max(0, unlockedCount));
+        this.store.setMax('genuiFences', Math.max(0, fences));
+    }
+    /** chat-rail 收藏绝对值（localStorage 上报；setMax 防重复虚增）。 */
+    mergeChatRail(total) {
+        this.store.setMax('chatRailFavorites', Math.max(0, total));
     }
     /** 检查解锁；返回新解锁（进队列 + 持久化；计数每次落盘）。 */
     flush() {
@@ -243,8 +277,15 @@ export function attachListeners(ctx, engine) {
             return;
         }
         if (event?.type === 'session/start') {
-            engine.recordSession();
-            engine.recordTurn();
+            // 该事件类型在 0.1.5 / 0.1.7 都不存在（Session 公共面没有它），此分支
+            // 从来没有触发过。保留会让人误以为会话计数有两条路径，删掉。
+            return;
+        }
+        if (event?.type === 'turn/start') {
+            // 会话记账落在首个 turn/start：这是 0.1.7 上确定到达的会话级信号，
+            // 且不像 `agent/created` 那样是可否决的 serial 监听（抛错会挡住 agent 创建）。
+            const id = typeof session?.id === 'string' ? session.id : '';
+            engine.recordSessionOnce(id);
             engine.flush();
         }
     }));
@@ -295,6 +336,13 @@ export function registerRoutes(ctx, engine) {
                         writeJson(res, 200, { ok: true, value: engine.fullSnapshot() });
                         return;
                     }
+                    case 'chat-rail-merge': {
+                        const body = (await readJsonBody(req));
+                        engine.mergeChatRail(typeof body.total === 'number' ? body.total : 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}"` } });
                 }

package/dist/index.js

@@ -6,10 +6,11 @@ export function apply(ctx) {
     attachListeners(ctx, engine);
     registerRoutes(ctx, engine);
     registerTool(ctx, engine);
-    ctx.on('agent/session-start', (() => {
-        engine.recordSession();
-        engine.flush();
-    }));
+    // 会话计数不再在此处订阅 `agent/session-start`：该事件在 DSH 0.1.7 已不存在
+    // （0.1.5 在 `core/agent/src/runtime-types.ts`），而 cordis 对未知事件名静默，
+    // 监听它不会报错、只是永不触发——`sessions` 因此恒为 0、`first-session` 永久
+    // 不解锁。现改由 `attachListeners` 里的 `session/event` 按每会话首个 `turn/start`
+    // 记账（不选 `agent/created`：那是可否决的 serial 监听，抛错会挡住 agent 创建）。
     ctx.on('agent/turn-stopping', (() => {
         engine.recordTurn();
         engine.flush();

package/dist/rules.d.ts

@@ -6,7 +6,7 @@
  * 文件内容或错误详情。GenUI 类别由 client 侧读取 genui 插件的计数
  * localStorage 合并（见 client/index.tsx）。
  */
-export type Category = '启程' | '记忆' | '审计' | 'GenUI' | '工具' | '行为' | '隐藏';
+export type Category = '启程' | '记忆' | '审计' | 'GenUI' | '收藏' | '工具' | '行为' | '隐藏';
 export type Rarity = 'common' | 'rare' | 'epic' | 'legendary';
 export interface AchievementDef {
     id: string;
@@ -37,6 +37,7 @@ export declare const KEYS: {
     readonly audits: "audits";
     readonly genuiUnlocked: "genuiUnlocked";
     readonly genuiFences: "genuiFences";
+    readonly chatRailFavorites: "chatRailFavorites";
     readonly marathonTurns: "marathonTurns";
     readonly midnightTurns: "midnightTurns";
     readonly selfQueries: "selfQueries";

package/dist/rules.js

@@ -19,6 +19,7 @@ export const KEYS = {
     audits: 'audits',
     genuiUnlocked: 'genuiUnlocked',
     genuiFences: 'genuiFences',
+    chatRailFavorites: 'chatRailFavorites',
     marathonTurns: 'marathonTurns',
     midnightTurns: 'midnightTurns',
     selfQueries: 'selfQueries',
@@ -54,6 +55,15 @@ export const ACHIEVEMENTS = [
         plugin: '@changfenhuang/dsh-genui' },
     { id: 'genui-25', name: '界面编织者', desc: 'GenUI 渲染过 25 个界面。', icon: '🧶', category: 'GenUI', rarity: 'epic', threshold: { counter: KEYS.genuiFences, target: 25 },
         plugin: '@changfenhuang/dsh-genui' },
+    // ── 收藏（dsh-chat-rail 消息收藏；client 侧合并 localStorage 计数）──
+    { id: 'fav-first', name: '初见倾心', desc: '收藏第一条消息。', icon: '⭐', category: '收藏', rarity: 'common', threshold: { counter: KEYS.chatRailFavorites, target: 1 },
+        plugin: '@max-null/dsh-chat-rail' },
+    { id: 'fav-10', name: '收藏发烧友', desc: '累计收藏 10 条消息。', icon: '📚', category: '收藏', rarity: 'rare', threshold: { counter: KEYS.chatRailFavorites, target: 10 },
+        plugin: '@max-null/dsh-chat-rail' },
+    { id: 'fav-30', name: '收藏大师', desc: '累计收藏 30 条消息。', icon: '👑', category: '收藏', rarity: 'epic', threshold: { counter: KEYS.chatRailFavorites, target: 30 },
+        plugin: '@max-null/dsh-chat-rail' },
+    { id: 'fav-100', name: '千禧藏家', desc: '累计收藏 100 条消息。', icon: '💎', category: '收藏', rarity: 'legendary', threshold: { counter: KEYS.chatRailFavorites, target: 100 },
+        plugin: '@max-null/dsh-chat-rail' },
     // ── 工具 ──
     { id: 'tool-10', name: '工具新手', desc: '累计调用 10 次工具。', icon: '🔧', category: '工具', rarity: 'common', threshold: { counter: KEYS.tools, target: 10 },
         plugin: null },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@max-null/dsh-achievements",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "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",
@@ -21,8 +21,7 @@
     "dist",
     "client.js",
     "cordis.patch.yml",
-    "README.md"
-  ],
+    "README.md", "docs/shots"],
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
@@ -43,16 +42,16 @@
   },
   "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"
+    "@deepseek-ai/dsh-session": ">=0.1.1-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-tools": ">=0.1.1-rc.1 <0.3.0"
   },
   "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",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.1-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-client-runtime": ">=0.1.1-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-session": ">=0.1.1-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-tools": ">=0.1.1-rc.1 <0.3.0",
     "@types/node": "^26.2.0",
     "esbuild": "^0.25.0",
     "react": "^18.3.1",