@max-null/dsh-achievements 0.1.2 → 0.1.4

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/dist/engine.d.ts

@@ -21,12 +21,24 @@ 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;

package/dist/engine.js

@@ -138,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');
@@ -166,6 +168,25 @@ 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)
@@ -256,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();
         }
     }));
@@ -269,13 +297,13 @@ function agentKeyOf(exec) {
 /** HTTP 路由（/achievements/api，POST）——仿 dsh-memory 的 /memory/api 信任围栏。 */
 export function registerRoutes(ctx, engine) {
     const webServer = ctx.webServer;
-    const webRuntime = ctx.webRuntime;
+    const webStartup = ctx.webStartup;
     ctx.effect(() => webServer.register({
         kind: 'prefix',
         path: '/achievements/api',
         handler: async (req, res) => {
             const request = req;
-            if (!isTrusted(request, webRuntime.trustedHosts)) {
+            if (!isTrusted(request, webStartup.trustedHosts)) {
                 writeJson(res, 403, { ok: false, error: { code: 'forbidden', message: 'forbidden' } });
                 return;
             }

package/dist/index.js

@@ -1,15 +1,16 @@
 import { AchievementsEngine, attachListeners, registerRoutes, registerTool } from "./engine.js";
 export const name = '@max-null/dsh-achievements';
-export const inject = ['tools', 'webServer', 'webRuntime'];
+export const inject = ['tools', 'webServer', 'webStartup'];
 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();
-    }));
+    // 会话计数不再在此处订阅 `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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@max-null/dsh-achievements",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "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,7 +21,8 @@
     "dist",
     "client.js",
     "cordis.patch.yml",
-    "README.md"
+    "README.md",
+    "docs/shots"
   ],
   "dsh": {
     "bundle": {
@@ -43,21 +44,25 @@
   },
   "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",
     "tsx": "^4.0.0",
     "typescript": "^5.5.0",
     "vitest": "^2.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Max-Null/dsh-achievements.git"
   }
 }