docs(sdk): clarify unknown user time zone

This commit is contained in:
fz committed 2026-10-19 20:40:09 +08:00
1 parent 3c45123daa
commit ba4395d046
3 files changed
+4 -2

No files matched your search

+2 -2
View File
@@ -33,8 +33,8 @@
en: 0503df0971e5f8d7
zh: 18cae8c6e25cda04
/deepseek-ai-dsh-sdk-app/known-limitations-and-deferred-work:
en: e72eec2652f06741
zh: 520fe70fffeaabe8
en: 451497677de7e6b9
zh: dcfdc671c38d54d4
/deepseek-ai-dsh-sdk-app/known-limitations-and-deferred-work/dev-note:
en: e67f633dc6fe7773
zh: e88aeb617ffb74ea
+1
View File
@@ -61,6 +61,7 @@ The static prefix is stable for a fixed profile, provider, model, and tool roste
<a id="known-limitations-and-deferred-work"></a>
- **No graphical client** — file cards, native file opening, and browser state require an embedding client; the SDK starts no Web server.
- **User time zone is unknown** — the SDK protocol does not carry a user time zone, so time context reports `Browser time zone for this request: unavailable.` The process or container time zone may differ from the user's. The `time-context.timeZone` setting only controls fallback timestamp formatting; it does not establish the user's time zone. Automatic detection and SDK time-zone input are deferred.
- **Questions require an answerer** — configure `onUserQuestion` in TypeScript or `on_user_question` in Python, or supply a native `user-questions/request` handler; otherwise `ask_user_question` returns `NO_PROVIDER`.
- **Schedules share the runtime lifetime** — delivery needs a running process and its persistent Session storage.
- **A profile can omit the SDK server** — a custom profile selected by the TypeScript client must retain this bundle or another `dsh-sdk-jsonrpc-server` row; client initialization fails when no peer answers.
+1
View File
@@ -61,6 +61,7 @@ profile 继承 base 系统提示词,包括 `You are an AI agent powered by Dee
<a id="known-limitations-and-deferred-work"></a>
- **没有图形客户端**:文件卡片、本地文件打开和浏览器状态需要嵌入客户端;SDK 不启动 Web server。
- **用户时区未知**:SDK 协议不携带用户时区,因此时间上下文显示 `Browser time zone for this request: unavailable.`。进程或容器的时区可能与用户时区不同。`time-context.timeZone` 配置只控制回退时间戳的显示格式,不能据此确定用户时区。自动检测和 SDK 时区传参暂缓支持。
- **提问需要回答方**:在 TypeScript 中配置 `onUserQuestion`、在 Python 中配置 `on_user_question`,或提供原生 `user-questions/request` handler;否则 `ask_user_question` 返回 `NO_PROVIDER`。
- **定时任务依赖运行时生命周期**:投递需要运行中的进程及其持久化 Session 存储。
- **profile 可能省略 SDK server**:TypeScript client 选择的自定义 profile 必须保留本组合包或另一个 `dsh-sdk-jsonrpc-server` 配置项;没有 peer 响应时,client 初始化会失败。