dsh-plugin-guide 0.3.21 → 0.3.23

package/references/official-docs/docs/subsystems/product-telemetry.zh.md

@@ -0,0 +1,79 @@
+# 产品埋点
+
+[English](product-telemetry.md) | 中文
+
+[产品埋点插件](../../packages/host/product-telemetry-otel/README.zh.md) 通过 OTLP/HTTP 发送明确选定的分析事件。`productTelemetry` 服务仅负责提交；产品消费方决定事件发生时机与获准采集的字段。导出器不自动采集 Session 数据或标识。[桌面埋点消费方](../../packages/client/product-analytics/README.zh.md)选择交互与实时压缩事件，补充可用的登录身份，并遵守桌面启动时的采集开关。普通 Web 客户端不采集产品事件。
+
+`ProductTelemetryRecord` 要求事件名称、字符串 body 和 Unix 毫秒时间戳。属性接受字符串、数字、布尔标量，以及这些值组成的单层对象（`ProductTelemetryScalar`）。可选的严重程度使用 OTel 严重程度数字，默认为 INFO。记录入队时填写观测时间。
+
+入队同步完成，不代表送达确认。SDK 负责批量发送与重试；发送失败会产生本地诊断。配置、退出和丢失限制见包 README。
+
+## 记录类型
+
+```ts type-equiv
+/** Scalar values accepted in product attributes. */
+type ProductTelemetryScalar = OTelEventScalar
+```
+
+```ts type-equiv
+/** Caller-selected ordinary analytics record. */
+type ProductTelemetryRecord = OTelEventRecord
+```
+
+Source: [`packages/host/product-telemetry-otel/src/index.ts`](../../packages/host/product-telemetry-otel/src/index.ts)
+
+<!-- BEGIN GENERATED cordis-surface (gen-cordis-catalog.ts) — do not edit between markers -->
+
+<a id="cordis-surface"></a>
+
+## Cordis API
+
+Generated from source by `scripts/gen-cordis-catalog.ts` (verified fresh by `pnpm run verify-cordis-catalog` in doc-sync; regenerate with `pnpm run gen-cordis-catalog`) — the language sides differ only in locale-specific paired document paths. Signature blocks use a `ts cordis-catalog` fence and keep the original source JSDoc; dispatch modes are defined in the [primer](../cordis-primer.zh.md#dispatch-modes), and the framework-inherited `ctx` API lives in [cordis-api/inherited.md](../cordis-api/inherited.md).
+
+<a id="ctxproductanalytics--productanalytics"></a>
+
+### `ctx.productAnalytics` — `ProductAnalytics`
+
+Authenticated event intake; disabled instances do not inspect identity or accept new events.
+
+```ts cordis-catalog
+/**
+ * Read the collection policy.
+ * @returns whether this Host currently accepts Desktop analytics.
+ */
+@Remote enabled(): boolean
+
+/**
+ * Stream the effective policy initially and after live configuration edits.
+ * @param signal - subscriber lifetime.
+ * @returns current policy values until cancellation or service disposal.
+ */
+@Remote({ mode: 'stream' }) async *watchPolicy(signal: AbortSignal): AsyncIterable<boolean>
+
+/**
+ * Submit selected Desktop fields; missing identity is omitted and never generated.
+ * @param event - typed product event without message contents or credentials.
+ * @returns after local submission; no delivery or warehouse acknowledgement.
+ */
+@Remote async report(event: ProductEvent): Promise<void>
+```
+
+Source: [`packages/client/product-analytics/src/index.ts`](../../packages/client/product-analytics/src/index.ts)
+
+<a id="ctxproducttelemetry--producttelemetry"></a>
+
+### `ctx.productTelemetry` — `ProductTelemetry`
+
+Host analytics sender. Mounting alone sends nothing; the owning fiber drains it on unload.
+
+```ts cordis-catalog
+/**
+ * Enqueue one selected product event without waiting for network delivery.
+ * Queue admission and shutdown completion are not collector or warehouse acknowledgements.
+ * @param record - caller-owned event containing only approved analytics fields.
+ */
+emit(record: ProductTelemetryRecord): void
+```
+
+Source: [`packages/host/product-telemetry-otel/src/index.ts`](../../packages/host/product-telemetry-otel/src/index.ts)
+<!-- END GENERATED cordis-surface -->

package/references/official-docs/docs/subsystems/ptc-runtime.i18n.yaml

@@ -1,6 +1,19 @@
-# 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:
+# Bilingual-pair consistency record for ptc-runtime.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/subsystems/ptc-runtime.md
-ptc-runtime.md: efab5bcefa0aaec50c29c73f981f6a6b717cd087
-ptc-runtime.zh.md: f35c5bd84d79ddaccc40653707d792f5672e73d9
+/ptc-runtime:
+  en: 337a6580d7571274
+  zh: f4ae98899120d122
+/ptc-runtime/the-run-request-in-result-out:
+  en: b11e176bee0ca6bd
+  zh: 843d5d70c58dec42
+/ptc-runtime/bindings-host-functions-as-program-globals:
+  en: 182147ddf388c600
+  zh: c0a7d77602c78bcd
+/ptc-runtime/captured-output-and-the-failure-taxonomy:
+  en: e5431173436c00c2
+  zh: 4ba58e259bbadbc8
+/ptc-runtime/the-service:
+  en: a82f828fa006c7e9
+  zh: 2279d36867335b57

package/references/official-docs/docs/subsystems/sandbox.i18n.yaml

@@ -1,6 +1,19 @@
-# 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:
+# Bilingual-pair consistency record for sandbox.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/subsystems/sandbox.md
-sandbox.md: c29450d83c54d48a69f74f0b2fa38fe7c4f35ef2
-sandbox.zh.md: 71b55fcb8d46144e45daef717999d8905a78eec4
+/process-sandbox:
+  en: e0d4876306b192c3
+  zh: 63baaa0c79e87deb
+/process-sandbox/modes-and-enforcement:
+  en: 11f91b55cc317334
+  zh: 296678c4675864c1
+/process-sandbox/per-call-policy:
+  en: 7661eb4559bbc395
+  zh: 0dceeb0bba367862
+/process-sandbox/wrapped-argv-and-classification-dialects:
+  en: 2ba8930762e92e40
+  zh: 220f64da1a9e5d57
+/process-sandbox/provider-and-fail-closed-errors:
+  en: a90a38fe4b11737c
+  zh: 2397768e48712617

package/references/official-docs/docs/subsystems/sandbox.md

@@ -27,7 +27,7 @@ Only the first two modes can be sent to a provider. A `danger-full-access` consu
 type ConfinedSandboxMode = Exclude<SandboxMode, 'danger-full-access'>
 ```
 
-Enforcement is a reported fact. `full` means the backend governs every file effect promised by the mode; `partial` means an active backend or older kernel ABI governs only a subset, so consumers that require the absolute promise must reject or surface that distinction. Older Landlock ABIs and the Windows ACL runner's Everyone/hard-link boundaries are current partial cases.
+Enforcement is a reported fact. `full` means the backend governs every file effect promised by the mode; `partial` means an active backend or older kernel ABI governs only a subset, so consumers that require the absolute promise must reject or surface that distinction. Older Landlock ABIs and the Windows ACL runner's hard-link, unconfined-read, and AppContainer-ACL boundaries are current partial cases.
 
 ```ts type-equiv
 /**

package/references/official-docs/docs/subsystems/sandbox.zh.md

@@ -27,7 +27,7 @@ type SandboxMode = 'read-only' | 'workspace-write' | 'danger-full-access'
 type ConfinedSandboxMode = Exclude<SandboxMode, 'danger-full-access'>
 ```
 
-强制执行完整性是后端报告的事实。`full` 表示后端管控了该模式承诺的所有文件效果；`partial` 表示活跃后端或较旧的内核 ABI 仅管控其中一个子集，因此要求绝对保证的消费方必须拒绝或向上暴露这一区别。当前的部分强制执行情形包括较旧的 Landlock ABI，以及 Windows ACL runner 的 Everyone 与硬链接边界。
+强制执行完整性是后端报告的事实。`full` 表示后端管控了该模式承诺的所有文件效果；`partial` 表示活跃后端或较旧的内核 ABI 仅管控其中一个子集，因此要求绝对保证的消费方必须拒绝或向上暴露这一区别。当前的部分强制执行情形包括较旧的 Landlock ABI，以及 Windows ACL runner 的硬链接、读取不受限与 AppContainer ACL 边界。
 
 ```ts type-equiv
 /**

package/references/official-docs/docs/subsystems/schedule.i18n.yaml

@@ -1,6 +1,40 @@
-# 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:
+# Bilingual-pair consistency record for schedule.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/subsystems/schedule.md
-schedule.md: b92b81c6f24773b8cbafea5fccd7ac16df07ccd3
-schedule.zh.md: a3e6a4e5f82223526f0ec84e60e5c752e6f65f9a
+/host-wide-schedule:
+  en: 71c4686e65a7c7f9
+  zh: dfba124c28db2f63
+/host-wide-schedule/durable-records:
+  en: 41cd197b5c74bfa3
+  zh: 18ed11259036d726
+/host-wide-schedule/absolute-time-input:
+  en: a07f1a7153b0074f
+  zh: f3c584db1073e49d
+/host-wide-schedule/daily-wall-clock-input:
+  en: 2d249edc3dfccb8a
+  zh: 33fecda132b03b84
+/host-wide-schedule/fixed-rate-input-and-catch-up:
+  en: d2b5997cce3806dc
+  zh: 2483ba9e38ad3cf3
+/host-wide-schedule/cron-wall-clock-input:
+  en: 1ba9ae84f05d8919
+  zh: 5b4abfdcddbbcae0
+/host-wide-schedule/historical-session-changes:
+  en: d3bdcf22dd771a7d
+  zh: 11af3e617a7ef3fd
+/host-wide-schedule/active-views-and-management:
+  en: 93798ad69f74ddd5
+  zh: 634126ad8accc356
+/host-wide-schedule/web-catalog:
+  en: b5e5ac8125e65f33
+  zh: 9ee064d833a4f838
+/host-wide-schedule/timing-edits:
+  en: ce5d2095a3ad2e82
+  zh: 167b3715f8eaffc1
+/host-wide-schedule/saved-delivery-records:
+  en: 077aa6573d9ede1a
+  zh: 0acea592a6e3630a
+/host-wide-schedule/host-delivery:
+  en: b6d522d24b9b97ba
+  zh: 84df8ea09bedf51c