dsh-plugin-guide 0.3.27 → 0.3.30

package/references/official-docs/docs/persistence-changes/2026-10-05-working-directory-attribution.zh.md

@@ -0,0 +1,60 @@
+---
+description: "记录持久化类型更改及其兼容性确认。"
+kind: persistence-change
+---
+
+# 2026-10-05-working-directory-attribution
+
+[English](2026-10-05-working-directory-attribution.md) | 中文
+
+## 概述
+
+新增由工作目录组件拥有的通知来源标记。
+
+## 目录
+
+- [声明](#declaration)
+- [兼容性](#compatibility)
+- [验证](#verification)
+- [开发备注](#dev-note)
+
+<a id="declaration"></a>
+## 声明
+
+```yaml persistence-change
+schemaVersion: 1
+id: 2026-10-05-working-directory-attribution
+baseline: false
+changes:
+  - root: "event:agent/inbox/spliced"
+    previous: "2026-09-21-user-question-reply"
+    after: "9a36727716d0e73f681f3b725e7f28f89417c68174c8af0ff2b1ef52b08326a0"
+    decision: same-version
+  - root: "event:developer/message"
+    previous: "2026-09-21-user-question-reply"
+    after: "ba5b10ea77d68f4a29439a9bd2a14f6a560acf55731749d57237757cc72fbc06"
+    decision: same-version
+  - root: "event:session/title-llm-request"
+    previous: "2026-09-21-user-question-reply"
+    after: "19fab83e64cf84ee8a6caf62c592e85c9b195bfd19e84a2667c6693a395681fd"
+    decision: same-version
+  - root: "event:user/message"
+    previous: "2026-09-21-user-question-reply"
+    after: "2ace3b8059b82b6d9837fed518ca97a99eb37c4482df7aad0e71c85489428ade"
+    decision: same-version
+```
+
+<a id="compatibility"></a>
+## 兼容性
+
+已有记录仍然有效。新增的 working-directory 来源种类只提供来源标记；已声明的来源策略保留未知标记而不解释其含义。Session 格式保持不变。
+
+<a id="verification"></a>
+## 验证
+
+pnpm exec vitest run packages/session/working-directory/tests packages/shell/tool-bash/tests/tools.spec.ts packages/shell/tool-pwsh/tests/tools.spec.ts packages/subagent/subagent/tests/schedule-tools.spec.ts：5 个文件、207 个测试通过。
+
+<a id="dev-note"></a>
+## 开发备注
+
+无。

package/references/official-docs/docs/persistence-changes/2026-10-07-title-reasoning-effort.i18n.yaml

@@ -0,0 +1,28 @@
+# Bilingual-pair consistency record for 2026-10-07-title-reasoning-effort.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write docs/persistence-changes/2026-10-07-title-reasoning-effort.md
+/:
+  en: 3d5a424ae7d7e46b
+  zh: c22a8e4a62d8cc1a
+/2026-10-07-title-reasoning-effort:
+  en: 62238f237d762372
+  zh: 67c868935122faba
+/2026-10-07-title-reasoning-effort/summary:
+  en: a23a870e04888548
+  zh: a794ea9022adf492
+/2026-10-07-title-reasoning-effort/table-of-contents:
+  en: 6cf314a069ceb451
+  zh: 9adff678e9ecab3b
+/2026-10-07-title-reasoning-effort/declaration:
+  en: 6907136f28e48c90
+  zh: 02f8298485f3d8e7
+/2026-10-07-title-reasoning-effort/compatibility:
+  en: 2aef689aa3af8d1c
+  zh: dc468f9d2c98d70c
+/2026-10-07-title-reasoning-effort/verification:
+  en: 48ef9b977eaf074b
+  zh: b1183bda3a6a38be
+/2026-10-07-title-reasoning-effort/dev-note:
+  en: b75c8458928b72b9
+  zh: 003ba4e17b4b5269

package/references/official-docs/docs/persistence-changes/2026-10-07-title-reasoning-effort.md

@@ -0,0 +1,48 @@
+---
+description: "Records a persistence type transition and its compatibility acknowledgement."
+kind: persistence-change
+---
+
+# 2026-10-07-title-reasoning-effort
+
+English | [中文](2026-10-07-title-reasoning-effort.zh.md)
+
+## Summary
+
+Records the concrete reasoning effort selected for auxiliary session-title requests.
+
+## Table of Contents
+
+- [Declaration](#declaration)
+- [Compatibility](#compatibility)
+- [Verification](#verification)
+- [Dev Note](#dev-note)
+
+<a id="declaration"></a>
+## Declaration
+
+```yaml persistence-change
+schemaVersion: 1
+id: 2026-10-07-title-reasoning-effort
+baseline: false
+changes:
+  - root: "event:session/title-llm-request"
+    previous: "2026-10-05-working-directory-attribution"
+    after: "b33545b3244861bcbf73b407d24b53402710f5acacab7ae939537e5504a68dc6"
+    decision: same-version
+```
+
+<a id="compatibility"></a>
+## Compatibility
+
+The new reasoningEffort field is optional. Existing V4 records remain valid and retain their original absence of a recorded effort. Prepared title requests write the resolved effort when the route exposes selectable reasoning; no Session format bump is required.
+
+<a id="verification"></a>
+## Verification
+
+Focused LLM, adapter, title-provider, and replay tests passed: 50 files and 1960 tests. The session-title-after-turn SDK snapshot passed with a recorded low effort selected from a route whose default is high.
+
+<a id="dev-note"></a>
+## Dev Note
+
+None.