{"_id":"@buddhilive/dsh-deepseek-llm-api-extensions","name":"@buddhilive/dsh-deepseek-llm-api-extensions","dist-tags":{"alpha":"0.1.2-alpha.3","latest":"0.1.2-alpha.3"},"versions":{"0.1.2-alpha.3":{"name":"@buddhilive/dsh-deepseek-llm-api-extensions","description":"Additive request-field registry for the official DeepSeek LLM API adapter","version":"0.1.2-alpha.3","publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/Buddhilive/buddhi-ai-harness.git","directory":"packages/llm/deepseek-llm-api-extensions"},"type":"module","main":"lib/index.js","types":"lib/types/index.d.ts","exports":{".":{"types":"./lib/types/index.d.ts","default":"./lib/index.js"},"./invariant":{"types":"./lib/types/invariant.d.ts","default":"./lib/invariant.js"},"./types":{"types":"./lib/types/types.d.ts","default":"./lib/types/types.js"},"./src/*":"./src/*","./package.json":"./package.json"},"license":"MIT","peerDependencies":{"@buddhilive/dsh-invariants":"^0.1.2-alpha.3","@deepseek-ai/cordis":"^4.0.2"},"devDependencies":{"@buddhilive/dsh-invariants":"^0.1.2-alpha.3","@deepseek-ai/cordis":"^4.0.2"},"_id":"@buddhilive/dsh-deepseek-llm-api-extensions@0.1.2-alpha.3","bugs":{"url":"https://github.com/Buddhilive/buddhi-ai-harness/issues"},"homepage":"https://github.com/Buddhilive/buddhi-ai-harness#readme","_integrity":"sha512-pxgt3741F4qeQCDJzvp/E3r3pNQFGB7KMMH8UjmbkY9WeNWA3NbLUD095E9zI6wuF7lZWqE5fxdPAxh8aFMTUQ==","_resolved":"C:\\DevDojo\\Buddhi\\buddhi-ai-harness\\dist\\npm\\buddhilive-dsh-deepseek-llm-api-extensions-0.1.2-alpha.3.tgz","_from":"file:C:/DevDojo/Buddhi/buddhi-ai-harness/dist/npm/buddhilive-dsh-deepseek-llm-api-extensions-0.1.2-alpha.3.tgz","_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-pxgt3741F4qeQCDJzvp/E3r3pNQFGB7KMMH8UjmbkY9WeNWA3NbLUD095E9zI6wuF7lZWqE5fxdPAxh8aFMTUQ==","shasum":"2a8efcb0f3baff435711d69227cc35d463d14b0f","tarball":"https://registry.npmjs.org/@buddhilive/dsh-deepseek-llm-api-extensions/-/dsh-deepseek-llm-api-extensions-0.1.2-alpha.3.tgz","fileCount":13,"unpackedSize":24188,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDBD1dhr1R7Jm+FG8VVUlJASRBA3eJwr2VrCb5hyn/WYAIgSowbpAgehFOoe+eey4XulnV+9jvw9R1z3OgNzDBWyvs="}]},"_npmUser":{"name":"buddhilive","email":"visitbudkavin@gmail.com"},"directories":{},"maintainers":[{"name":"buddhilive","email":"visitbudkavin@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/dsh-deepseek-llm-api-extensions_0.1.2-alpha.3_1788165599615_0.7739217459539856"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-31T08:39:59.392Z","0.1.2-alpha.3":"2026-08-31T08:39:59.748Z","modified":"2026-08-31T08:40:00.091Z"},"maintainers":[{"name":"buddhilive","email":"visitbudkavin@gmail.com"}],"description":"Additive request-field registry for the official DeepSeek LLM API adapter","homepage":"https://github.com/Buddhilive/buddhi-ai-harness#readme","repository":{"type":"git","url":"git+https://github.com/Buddhilive/buddhi-ai-harness.git","directory":"packages/llm/deepseek-llm-api-extensions"},"bugs":{"url":"https://github.com/Buddhilive/buddhi-ai-harness/issues"},"license":"MIT","readme":"---\ndescription: \"面向提供方插件的官方 DeepSeek 请求扩展注册表，用于贡献具有生命周期归属的顶层 API 字段。\"\nkind: \"package-reference\"\n---\n\n# @buddhilive/dsh-deepseek-llm-api-extensions\n\n[English](README.md) | 中文\n\n## 概述\n\n用于向 DeepSeek 官方 LLM API 请求添加顶层字段的提供方特定注册表。`DeepSeekLlmApiExtensionRegistry` 注册 `ctx.deepseekLlmApiExtensions`；贡献插件分别认领一个经声明合并的字段，`dsh-llm-deepseek` 则在序列化基础请求后准备当前贡献。当插件必须添加经过验证的提供方特定字段且不能修改基础 adapter 时，请使用它。\n\n## 目录\n\n- [服务](#service)\n- [模型体验](#model-experience)\n- [已知限制与暂缓事项](#known-limitations-and-deferred-work)\n- [开发备注](#dev-note)\n\n-----\n\n<a id=\"service\"></a>\n## 服务\n\n- `register(field, provider)` 为调用 fiber 保留一个字段。重复或格式错误的名称会同步失败；dispose（资源释放）该注册后，后续提供方可以再次认领。\n- `prepare(request)` 对已注册提供方取快照，并发准备贡献，克隆并冻结返回的 JSON 值，然后返回 `{ fields, accept }`。准备失败会在 HTTP 分发前拒绝请求；请求取消后，即使某个提供方忽略信号，注册表也会停止等待。\n- `accept()` 对每个捕获的 2xx 后回调只运行一次。并发调用会等待同一次结算，所有回调都在报告失败前完成，多个失败会合并为一个 `AggregateError`。\n\n每个提供方都会看到确切的已序列化基础正文、请求 `AbortSignal`，以及可选的 `sessionId` 与辅助调用 `purpose`。提供方必须在取消后迅速停止自身工作；字段不适用于当前请求时返回 `undefined`。即使 HMR（热模块替换）在 HTTP 接受前移除了注册，已准备的操作仍会保留其捕获的提供方。\n\n注册表拥有字段添加与生命周期，不拥有字段语义。`@buddhilive/dsh-session-log-deepseek` 拥有 `dsh_session_log`；`@buddhilive/dsh-plugin-package-inventory-deepseek` 拥有 `dsh_plugin_packages`。提供方无关的 LLM seam 与 `llm-pi-ai` 都不消费该注册表。\n\n<a id=\"model-experience\"></a>\n## 模型体验\n\n通过 `@buddhilive/dsh-llm-deepseek` 间接生效；该包在模型的 `messages`、系统提示词与工具 schema 之外发送已注册字段。\n\n#### KV Cache 影响\n\n无；注册表字段是模型不可见的提供方元数据，不改变已序列化的模型输入前缀。\n\n## 已知限制与暂缓事项\n\n<a id=\"known-limitations-and-deferred-work\"></a>\n\n- **仅限 DeepSeek 官方请求**——该注册表刻意不提供提供方无关的路由，也不集成 pi-ai 适配器。\n- **不约定字段顺序**——JSON 对象成员顺序取决于注册准备顺序，但接收方按名称寻址字段。\n\n\n<a id=\"dev-note\"></a>\n### 开发备注\n\n<details>\n<summary>维护者工作上下文——点击展开</summary>\n\n无。\n\n</details>\n","readmeFilename":"README.zh.md","_rev":"1-3850277208405b4773246289b95aa54d"}