@deepseek-ai/dsh-session-log-deepseek 0.2.1-alpha.1 → 0.2.1-alpha.3

package/README.i18n.yaml

@@ -18,8 +18,8 @@
   en: 1b899e63d8039643
   zh: d489461bbb618b5d
 /deepseek-ai-dsh-session-log-deepseek/request-field:
-  en: 197814e2c48d05b5
-  zh: f4616fb23a3c7a32
+  en: 65795dc44af4b15e
+  zh: 849c7d57f16f66af
 /deepseek-ai-dsh-session-log-deepseek/acceptance-and-retry:
   en: 3688592c474b3e95
   zh: 5e83afeb9aa9e9e3

package/README.md

@@ -39,7 +39,7 @@ The Web **Settings → General → Upload Session Log when using the official mo
 
 For a request carrying a live `sessionId`, the plugin folds the greatest accepted watermark for that exact Session format generation, snapshots `Session.events`, and sends the longest contiguous run after the watermark that fits `maxBytes`. A process-local fold scans each event once and consumes later appends incrementally; restart and HMR rebuild it from the durable log. The version-1 field contains `sessionFormatVersion`, a raw session header (`seedLength` is present only for a seeded Session), numeric `afterSeq` and `throughSeq`, and every complete canonical event translated to raw-number envelope fields. Forked sessions ignore inherited parent watermarks because both the recorded Session id and format generation must match the request source. Surface events require `surfaceOp`, with numeric `startSeq` and `endSeq` for replacements; only system, user, and tool events may carry `sourceEventSeqs`. Assistant provider metadata stays in the embedded stream, and log-only events carry neither metadata field.
 
-`maxBytes` bounds the complete serialized field in UTF-8 bytes, including the header and numeric envelope fields. A backlog above the limit drains across consecutive accepted requests, each continuing after the previous `throughSeq`. When the first pending event alone exceeds the limit, the request omits `dsh_session_log`, the plugin logs a warning, and the watermark stays before that event until `maxBytes` admits it. An event too large for the runtime to serialize at all is handled the same way, and no `maxBytes` value admits it.
+`maxBytes` bounds the complete serialized field in UTF-8 bytes, including the header and numeric envelope fields. A backlog above the limit drains across consecutive accepted requests, each continuing after the previous `throughSeq`. When the first pending event alone exceeds the limit, the request omits `dsh_session_log`, the plugin logs one warning per blocking event, and the watermark stays before that event until `maxBytes` admits it. An event too large for the runtime to serialize at all is handled the same way, and no `maxBytes` value admits it.
 
 <a id="acceptance-and-retry"></a>
 ## Acceptance and retry

package/README.zh.md

@@ -39,7 +39,7 @@ Web **设置 → 通用 → 在使用官方模型 API 时上传 Session Log**
 
 对于携带存活 `sessionId` 的请求，插件会折叠该确切会话格式代的最大已接受水位，对 `Session.events` 取快照，并发送水位之后能放进 `maxBytes` 的最长连续事件段。进程内 fold 会让每条事件只被扫描一次并增量消费后续追加；重启与 HMR（热模块替换）会从持久日志重建它。版本 1 字段包含 `sessionFormatVersion`、原始会话 header（仅 seeded Session 携带 `seedLength`）、数值型 `afterSeq` 与 `throughSeq`，以及每个已转换为原始数值 envelope 字段的完整规范事件。只有记录的会话 id 与格式代均匹配请求来源时水位才生效，因此 fork 会话会忽略从父会话继承的水位。表层事件必须携带 `surfaceOp`，替换范围使用数值型 `startSeq` 与 `endSeq`；仅 system、user 与 tool 事件可以携带 `sourceEventSeqs`。assistant 的提供方元数据保留在内嵌流中，只出现在日志中的事件不携带这两个元数据字段。
 
-`maxBytes` 按 UTF-8 字节限制完整的序列化字段，包括 header 与数值型 envelope 字段。超过上限的积压会分多次已接受的请求补传，每次都从上一次的 `throughSeq` 之后继续。第一条待发事件本身就超过上限时，请求会省略 `dsh_session_log`，插件记录一条告警，水位停在该事件之前，直到 `maxBytes` 能容纳它。运行时根本无法序列化的超大事件也按同样方式处理，且任何 `maxBytes` 都无法容纳它。
+`maxBytes` 按 UTF-8 字节限制完整的序列化字段，包括 header 与数值型 envelope 字段。超过上限的积压会分多次已接受的请求补传，每次都从上一次的 `throughSeq` 之后继续。第一条待发事件本身就超过上限时，请求会省略 `dsh_session_log`，插件对每个阻塞事件只记录一次告警，水位停在该事件之前，直到 `maxBytes` 能容纳它。运行时根本无法序列化的超大事件也按同样方式处理，且任何 `maxBytes` 都无法容纳它。
 
 <a id="acceptance-and-retry"></a>
 ## 接受与重试

package/lib/index.js

@@ -19,6 +19,8 @@ const Config = z.object({
 	maxBytes: z.number().step(1).min(1).default(8 * 1024 * 1024)
 });
 const acceptanceFolds = /* @__PURE__ */ new WeakMap();
+/** Event each Session's upload was last reported blocked at; a block is logged once. */
+const blockedWarnings = /* @__PURE__ */ new WeakMap();
 /** Translate logical Session metadata to raw external request fields. */
 function wireHeader(session) {
 	const header = session.header;
@@ -165,7 +167,8 @@ function apply(ctx, config) {
 		const last = events.length === 0 ? void 0 : pending[events.length - 1];
 		if (last === void 0) {
 			const first = pending[0];
-			if (first !== void 0) {
+			if (first !== void 0 && blockedWarnings.get(session) !== first.seq) {
+				blockedWarnings.set(session, first.seq);
 				const seq = String(first.seq);
 				ctx.logger.warn(Number.isFinite(candidateBytes) ? `session-log-deepseek: event ${seq} of session "${session.id}" needs a ${String(candidateBytes)}-byte dsh_session_log field, above maxBytes ${String(maxBytes)}; this session's upload stays at event ${seq} until maxBytes admits it` : `session-log-deepseek: event ${seq} of session "${session.id}" is too large to serialize into a dsh_session_log field; this session's upload stays at event ${seq}`);
 			}

package/lib/types/index.js

@@ -18,6 +18,8 @@ export const Config = z.object({
     maxBytes: z.number().step(1).min(1).default(8 * 1024 * 1024),
 });
 const acceptanceFolds = new WeakMap();
+/** Event each Session's upload was last reported blocked at; a block is logged once. */
+const blockedWarnings = new WeakMap();
 /** Translate logical Session metadata to raw external request fields. */
 function wireHeader(session) {
     const header = session.header;
@@ -177,7 +179,8 @@ export function apply(ctx, config) {
             const last = events.length === 0 ? undefined : pending[events.length - 1];
             if (last === undefined) {
                 const first = pending[0];
-                if (first !== undefined) {
+                if (first !== undefined && blockedWarnings.get(session) !== first.seq) {
+                    blockedWarnings.set(session, first.seq);
                     const seq = String(first.seq);
                     ctx.logger.warn(Number.isFinite(candidateBytes)
                         ? `session-log-deepseek: event ${seq} of session "${session.id}" needs a ${String(candidateBytes)}-byte`

package/locale/en.json

@@ -0,0 +1,5 @@
+{
+  "meta": {
+    "title": "session-log-deepseek"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "DeepSeek 会话日志上传",
+    "description": "启用后，随官方模型 API 请求向 DeepSeek 上传会话日志。"
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-session-log-deepseek",
   "description": "Incremental lossless session-log request extension for the official DeepSeek LLM API",
-  "version": "0.2.1-alpha.1",
+  "version": "0.2.1-alpha.3",
   "publishConfig": {
     "access": "public"
   },
@@ -23,36 +23,38 @@
       "default": "./lib/types/types.js"
     },
     "./src/*": "./src/*",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
   },
   "files": [
+    "locale/*.json",
     "lib/index.js",
     "lib/types/**/*.js",
     "lib/types/**/*.d.ts"
   ],
   "license": "MIT",
   "dependencies": {
-    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-brand": "0.2.1-alpha.1",
-    "@deepseek-ai/schemastery": "~3.18.5-alpha.1"
+    "@deepseek-ai/dsh-brand": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.3",
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.2"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "0.2.1-alpha.1",
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
-    "@deepseek-ai/dsh-session": "0.2.1-alpha.1"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2",
+    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.3"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
-    "@deepseek-ai/cordis-plugin-include": "~1.0.10-alpha.1",
-    "@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.1",
-    "@deepseek-ai/dsh-command-feedback": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-llm": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-llm-deepseek": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-llm-deepseek-api-key": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-llm-mock-server": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-message-feedback": "0.2.1-alpha.1"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2",
+    "@deepseek-ai/cordis-plugin-include": "~1.0.10-alpha.2",
+    "@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.2",
+    "@deepseek-ai/dsh-command-feedback": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-llm-deepseek": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-llm-deepseek-api-key": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-llm-mock-server": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-message-feedback": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.1-alpha.3"
   }
 }