docs: translate remaining READMEs

2026-07-26 05:03:53 +08:00
parent 37bfac749b
commit 226dc7a249
559 changed files with 11227 additions and 1 deletions
@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# side as of the last confirmed-consistent state. Both languages carry equal authority;
+# after editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write
+README.md: 25ec92432b5c2d18624f2f4d851552ee2b3bf5d0
+README.zh.md: 685046a2a4d0859e6eca86cfba67690b8271afaf
@@ -1,5 +1,7 @@
 # @deepseek-ai/dsh-session-title-all-messages-llm

+English | [中文](README.zh.md)
+
 Optional `ctx.sessionTitle` provider that summarizes every eligible human message through `ctx.llm`. It registers the `all-user-messages` cadence and starts a new revision after each new human prompt, using seeded history as well as child-session prompts. A newer revision aborts and supersedes older work; even a provider that ignores cancellation cannot commit stale output.

 The plugin uses the complete required [shared LLM configuration](../session-title-llm/README.md#configuration). Omit both `provider` and `model` to inherit the exact route from each current logged main request, or set both to route title generation independently. If the final framed aggregate prompt exceeds `maxInputBytes`, the request fails instead of truncating history; automatic use warns and keeps the prior title.
@@ -0,0 +1,28 @@
+# @deepseek-ai/dsh-session-title-all-messages-llm
+
+[English](README.md) | 中文
+
+可选的 `ctx.sessionTitle` 提供方，通过 `ctx.llm` 总结所有符合条件的用户消息。它注册 `all-user-messages` 节奏，并在每条新用户提示词后启动新 revision，同时使用 seed 历史与子会话提示词。较新的 revision 会中止并取代旧工作；即使提供方忽略取消，也无法提交陈旧输出。
+
+该插件使用完整且必填的[共享 LLM 配置](../session-title-llm/README.md#configuration)。同时省略 `provider` 与 `model` 时，会继承每个当前已记录主请求的确切路由；也可以同时设置二者，使标题生成使用独立路由。如果最终封装的聚合提示词超过 `maxInputBytes`，请求会失败而不是截断历史；自动使用时会发出警告并保留先前标题。
+
+## 模型体验
+
+### 全消息标题请求
+
+#### 模型看到的内容
+
+标题模型会收到共享标题指令，以及一个 JSON 数组，其中按日志顺序包含截至当前 revision 的所有符合条件用户消息和确切 seq。Seed 历史也包含在内。
+
+#### Token 影响
+
+每条符合条件的新提示词之后都可能发送一项辅助请求，每次请求受 `maxInputBytes` 和 `maxOutputTokens` 约束；显式刷新可能增加调用。主 agent 请求不会增加 token。
+
+#### KV Cache 影响
+
+不会使主请求失效。每条提示词后，辅助输入都会增长或变化，因此提供方专用缓存复用会在第一个变化的 JSON token 处结束。
+
+## 已知限制与暂缓工作
+
+- 输入溢出时保留先前标题；对于很长的会话，此提供方没有摘要再摘要机制或保留策略。
+- 它平等对待所有符合条件的用户消息，不提供权重、过滤或手动标题优先级。