dsh-plugin-guide 0.3.35 → 0.3.36

package/references/official-docs/docs/persistence-changes/2026-10-13-user-rpc-principal.zh.md

@@ -0,0 +1,60 @@
+---
+description: "记录持久化类型更改及其兼容性确认。"
+kind: persistence-change
+---
+
+# 2026-10-13-user-rpc-principal
+
+[English](2026-10-13-user-rpc-principal.md) | 中文
+
+## 概述
+
+为 owner 以外的调用方提交的 prompt，在 user-rpc 消息来源上增加可选的 principal。
+
+## 目录
+
+- [声明](#declaration)
+- [兼容性](#compatibility)
+- [验证](#verification)
+- [开发备注](#dev-note)
+
+<a id="declaration"></a>
+## 声明
+
+```yaml persistence-change
+schemaVersion: 1
+id: 2026-10-13-user-rpc-principal
+baseline: false
+changes:
+  - root: "event:agent/inbox/spliced"
+    previous: "2026-10-05-working-directory-attribution"
+    after: "0755b7d1128319ba2e389619cbbf2c961ad648882b4e91da7f3e9582cc8a2034"
+    decision: same-version
+  - root: "event:developer/message"
+    previous: "2026-10-05-working-directory-attribution"
+    after: "97e0162f983c27456ec71269fb4976b1851588b8c1aeac5d071d43e11f95e03c"
+    decision: same-version
+  - root: "event:session/title-llm-request"
+    previous: "2026-10-07-title-reasoning-effort"
+    after: "79a4c87f8bfb4d6d05cd9952b99210d6a7db3b478c4a01d94b4c50602308c056"
+    decision: same-version
+  - root: "event:user/message"
+    previous: "2026-10-05-working-directory-attribution"
+    after: "2ae8594a998c9862a597129e782277bcc518266712a703b5c3161bdf552d13b8"
+    decision: same-version
+```
+
+<a id="compatibility"></a>
+## 兼容性
+
+owner 的 prompt 不写该字段，因此其来源与所有既有 Session 日志都不变；缺少 principal 即为 owner。早于该字段的读取方会忽略它，并因 kind 仍为 'user' 而把消息当作普通用户消息。当前读取方读取旧日志时找不到 principal，把每条消息都视为 owner 的消息。该字段不进入任何模型请求：provider 适配器只读取模型可见的消息内容。SESSION_FORMAT_VERSION 不变。
+
+<a id="verification"></a>
+## 验证
+
+pnpm exec vitest run packages/api/session-controller/tests/remote-access.host.spec.ts packages/subagent/subagent/tests/control.spec.ts packages/api/session-controller/tests/session-cold.host.spec.ts：非 owner 的 prompt 在 agent/inbox/spliced 中持久化 source.principal，owner 与既有时区来源保持逐字节不变；全部测试通过。
+
+<a id="dev-note"></a>
+## 开发备注
+
+无。

package/references/official-docs/docs/persistence-changes/historical-formats/README.i18n.yaml

@@ -15,8 +15,8 @@
   en: 14c57f30e676f6e3
   zh: b1a0ccf26fab3727
 /session-persistence-formats/format-references:
-  en: 553fd4963cf19abe
-  zh: 7ca3cd5d0a88d35a
+  en: 17ef09dfc5a89073
+  zh: 59b8d60acb66c2dc
 /session-persistence-formats/scope-and-evidence:
   en: b220062139ddac1e
   zh: 7c4c0efe05dafa9c

package/references/official-docs/docs/persistence-changes/historical-formats/README.md

@@ -32,7 +32,7 @@ The index is generated from validated snapshots and the current writer constant.
 | 1 | PR #3349 | [V1](v1.md) | [JSON](v1.schema.json) | 54 / 415 |
 | 2 | `dsh-v0.1.3-alpha.2` | [V2](v2.md) | [JSON](v2.schema.json) | 56 / 435 |
 | 3 | PR #4320 | [V3](v3.md) | [JSON](v3.schema.json) | 60 / 467 |
-| 4 | Current checkout | [Current catalog](../../persistence-catalog.md) | [JSON](../../persistence-schema.json) | 63 / 597 |
+| 4 | Current checkout | [Current catalog](../../persistence-catalog.md) | [JSON](../../persistence-schema.json) | 65 / 614 |
 
 <!-- persistence-format-index:end -->
 

package/references/official-docs/docs/persistence-changes/historical-formats/README.zh.md

@@ -32,7 +32,7 @@ description: "查找从 V0 到工作区写入器版本的每个 Session 格式
 | 1 | PR #3349 | [V1](v1.zh.md) | [JSON](v1.schema.json) | 54 / 415 |
 | 2 | `dsh-v0.1.3-alpha.2` | [V2](v2.zh.md) | [JSON](v2.schema.json) | 56 / 435 |
 | 3 | PR #4320 | [V3](v3.zh.md) | [JSON](v3.schema.json) | 60 / 467 |
-| 4 | 当前工作树 | [当前目录](../../persistence-catalog.zh.md) | [JSON](../../persistence-schema.json) | 63 / 597 |
+| 4 | 当前工作树 | [当前目录](../../persistence-catalog.zh.md) | [JSON](../../persistence-schema.json) | 65 / 614 |
 
 <!-- persistence-format-index:end -->