{"_id":"@baiducloud/qianfan-deep-research","_rev":"18-ca8e98c87de8bfcea6731f9bc67d7cf7","name":"@baiducloud/qianfan-deep-research","dist-tags":{"latest":"0.0.7"},"versions":{"0.0.1":{"name":"@baiducloud/qianfan-deep-research","version":"0.0.1","keywords":["deep-research","sdk","umd","react"],"_id":"@baiducloud/qianfan-deep-research@0.0.1","maintainers":[{"name":"bce-cfc-dev","email":"bce-cfc-dev@baidu.com"},{"name":"xiaojiaolv","email":"dfsq757@sina.com"},{"name":"yangwei9012","email":"yangwei9012@163.com"},{"name":"qianchuan","email":"qianchuan.deng@gmail.com"},{"name":"lurunze","email":"lurunze@hotmail.com"},{"name":"leophen","email":"leophen@foxmail.com"},{"name":"willghy","email":"390816673@qq.com"},{"name":"tjdl102306","email":"tjdl102306@gmail.com"}],"dist":{"shasum":"cc17ec841ef55da99516425cf60e4d7d412e4fda","tarball":"https://registry.npmjs.org/@baiducloud/qianfan-deep-research/-/qianfan-deep-research-0.0.1.tgz","fileCount":177,"integrity":"sha512-PdKywNsS5XUqNe4S+PjxdWnuB8SarAnTOT4eJiZygKsaT6CdLfxwH44q4VtZFPmTPEdCwjUnyDCCofrBfnSBEA==","signatures":[{"sig":"MEQCIDhxLngFSdqmEqbwio9v5K5dL6LUsuOFbg6driHGtyVbAiBkKuLSaWxKqabNLlfp3aqEL6hJPZK+Au0K6Emu3GVfyQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46943560},"main":"./dist/index.js","types":"./dist/index.d.ts","gitHead":"d8c721e0cea8e029ebd28734b240bea949516c7c","scripts":{"dev":"rsbuild dev","build:umd":"rslib build && cp src/dist-index.d.ts dist/index.d.ts","dev:dist-test":"rsbuild dev --config rsbuild.dist-test.config.ts"},"_npmUser":{"name":"willghy","email":"390816673@qq.com"},"_npmVersion":"10.9.2","description":"Deep Research SDK - 深度研究SDK，提供UMD格式的第三方集成能力","directories":{},"_nodeVersion":"22.15.0","dependencies":{},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/qianfan-deep-research_0.0.1_1768466360616_0.6304237948267863","host":"s3://npm-registry-packages-npm-production"}},"0.0.2":{"name":"@baiducloud/qianfan-deep-research","version":"0.0.2","keywords":["deep-research","sdk","umd","react"],"_id":"@baiducloud/qianfan-deep-research@0.0.2","maintainers":[{"name":"bce-cfc-dev","email":"bce-cfc-dev@baidu.com"},{"name":"xiaojiaolv","email":"dfsq757@sina.com"},{"name":"yangwei9012","email":"yangwei9012@163.com"},{"name":"qianchuan","email":"qianchuan.deng@gmail.com"},{"name":"lurunze","email":"lurunze@hotmail.com"},{"name":"leophen","email":"leophen@foxmail.com"},{"name":"willghy","email":"390816673@qq.com"},{"name":"tjdl102306","email":"tjdl102306@gmail.com"}],"dist":{"shasum":"216c11c32a400702379c6bcce43e700cb2a882e7","tarball":"https://registry.npmjs.org/@baiducloud/qianfan-deep-research/-/qianfan-deep-research-0.0.2.tgz","fileCount":177,"integrity":"sha512-5mpkvfbLbsMi/8Tax7KEkrjilFE5VZT79v6rtiwNkHcHDR+pxnZ5B/JDe3Hnhcsn9/ra0GgUBaP94kDML+wKKw==","signatures":[{"sig":"MEUCIGEoSC6xkfVkqwpeJmyDGGri3t519Vp/s0iCvtV94HFdAiEAruby+33+ivIMzNMSV6kvymeZbCLkqlQx+hKiPkYSamM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46143286},"main":"./dist/index.js","types":"./dist/index.d.ts","gitHead":"d8c721e0cea8e029ebd28734b240bea949516c7c","scripts":{"dev":"rsbuild dev","build:umd":"rslib build && cp src/dist-index.d.ts dist/index.d.ts","dev:dist-test":"rsbuild dev --config rsbuild.dist-test.config.ts"},"_npmUser":{"name":"willghy","email":"390816673@qq.com"},"_npmVersion":"10.9.2","description":"Deep Research SDK - 深度研究SDK，提供UMD格式的第三方集成能力","directories":{},"_nodeVersion":"22.15.0","dependencies":{},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/qianfan-deep-research_0.0.2_1768467810065_0.7563274412363956","host":"s3://npm-registry-packages-npm-production"}},"0.0.3":{"name":"@baiducloud/qianfan-deep-research","version":"0.0.3","keywords":["deep-research","sdk","umd","react"],"_id":"@baiducloud/qianfan-deep-research@0.0.3","maintainers":[{"name":"bce-cfc-dev","email":"bce-cfc-dev@baidu.com"},{"name":"xiaojiaolv","email":"dfsq757@sina.com"},{"name":"yangwei9012","email":"yangwei9012@163.com"},{"name":"qianchuan","email":"qianchuan.deng@gmail.com"},{"name":"lurunze","email":"lurunze@hotmail.com"},{"name":"leophen","email":"leophen@foxmail.com"},{"name":"willghy","email":"390816673@qq.com"},{"name":"tjdl102306","email":"tjdl102306@gmail.com"}],"dist":{"shasum":"3c042933f5d401bcb4aeff3bb04a000fcaa2de1d","tarball":"https://registry.npmjs.org/@baiducloud/qianfan-deep-research/-/qianfan-deep-research-0.0.3.tgz","fileCount":177,"integrity":"sha512-k6uqV+KyzZIGdNKabPvF+KFTbwYPsGR6AL3ifSfbD1KXwOwywLWZd6FR4JTjKrseu9vJKT/bPR3rrOZIGechaw==","signatures":[{"sig":"MEUCIQDQ7luANbsb+Y/UU9Wh2Ob6iylC8G7QGQd79ZRVWdQPaQIgfUfIYt3hx/iIhJY2DwY+27Dn8qUoae7TPzoNZ5Q4v9k=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46943560},"main":"./dist/index.js","types":"./dist/index.d.ts","gitHead":"d8c721e0cea8e029ebd28734b240bea949516c7c","scripts":{"dev":"rsbuild dev","build:umd":"rslib build && cp src/dist-index.d.ts dist/index.d.ts","dev:dist-test":"rsbuild dev --config rsbuild.dist-test.config.ts"},"_npmUser":{"name":"willghy","email":"390816673@qq.com"},"_npmVersion":"10.9.2","description":"Deep Research SDK - 深度研究SDK，提供UMD格式的第三方集成能力","directories":{},"_nodeVersion":"22.15.0","dependencies":{},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/qianfan-deep-research_0.0.3_1768468465885_0.4938939365272783","host":"s3://npm-registry-packages-npm-production"}},"0.0.4":{"name":"@baiducloud/qianfan-deep-research","version":"0.0.4","keywords":["deep-research","sdk","umd","react"],"_id":"@baiducloud/qianfan-deep-research@0.0.4","maintainers":[{"name":"bce-cfc-dev","email":"bce-cfc-dev@baidu.com"},{"name":"xiaojiaolv","email":"dfsq757@sina.com"},{"name":"yangwei9012","email":"yangwei9012@163.com"},{"name":"qianchuan","email":"qianchuan.deng@gmail.com"},{"name":"lurunze","email":"lurunze@hotmail.com"},{"name":"leophen","email":"leophen@foxmail.com"},{"name":"willghy","email":"390816673@qq.com"},{"name":"tjdl102306","email":"tjdl102306@gmail.com"}],"dist":{"shasum":"8cc003d1848493bd304912a96168c56278975119","tarball":"https://registry.npmjs.org/@baiducloud/qianfan-deep-research/-/qianfan-deep-research-0.0.4.tgz","fileCount":177,"integrity":"sha512-3uSJdiyOCWzaDQSWw5ElKCPWbfwT5tXLE81hO4dhBX/8tXobLMpXlrFjDMIJrIj+9m56JxI0LOkIqqTHd0Hh5w==","signatures":[{"sig":"MEYCIQDZZSWZyHs/1BaL2sc/kkZJkbIGk4Pk31QIiunaE7tcKgIhAI1FxbAmu4bJRQ9W6tOYM/UzbdiiWm16qQ9qFjcFXrmq","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46943560},"main":"./dist/index.js","types":"./dist/index.d.ts","gitHead":"d8c721e0cea8e029ebd28734b240bea949516c7c","scripts":{"dev":"rsbuild dev","build:umd":"rslib build && cp src/dist-index.d.ts dist/index.d.ts","dev:dist-test":"rsbuild dev --config rsbuild.dist-test.config.ts"},"_npmUser":{"name":"willghy","email":"390816673@qq.com"},"_npmVersion":"10.9.2","description":"Deep Research SDK - 深度研究SDK，提供UMD格式的第三方集成能力","directories":{},"_nodeVersion":"22.15.0","dependencies":{},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/qianfan-deep-research_0.0.4_1768473011895_0.9324618035595333","host":"s3://npm-registry-packages-npm-production"}},"0.0.5-alpha.1":{"name":"@baiducloud/qianfan-deep-research","version":"0.0.5-alpha.1","keywords":["deep-research","sdk","umd","react"],"_id":"@baiducloud/qianfan-deep-research@0.0.5-alpha.1","maintainers":[{"name":"bce-cfc-dev","email":"bce-cfc-dev@baidu.com"},{"name":"xiaojiaolv","email":"dfsq757@sina.com"},{"name":"yangwei9012","email":"yangwei9012@163.com"},{"name":"qianchuan","email":"qianchuan.deng@gmail.com"},{"name":"lurunze","email":"lurunze@hotmail.com"},{"name":"leophen","email":"leophen@foxmail.com"},{"name":"willghy","email":"390816673@qq.com"},{"name":"tjdl102306","email":"tjdl102306@gmail.com"}],"dist":{"shasum":"a0d9ea577d646aa0ad3c0ec2ca69e37c174be594","tarball":"https://registry.npmjs.org/@baiducloud/qianfan-deep-research/-/qianfan-deep-research-0.0.5-alpha.1.tgz","fileCount":177,"integrity":"sha512-YU+5TKc+DMbrbSkZ0yoJV0LxQVm/PGTrppvIneQDmM3XCijQC0PtfbQpV26s4VE9uVWw/a51fv8VgZlIAfS+Sg==","signatures":[{"sig":"MEYCIQDmwrMwwsGoRjKOtWxUggzmtDohdG18oN5Ixods7bH4zgIhAMHOsEnRsMiUl9lzPHBr6uXR1JnwmkhYqK7W2Lm3VulH","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46945220},"main":"./dist/index.js","types":"./dist/index.d.ts","gitHead":"61caf256edfd7b72d657debdbe891a775a8fcd6c","scripts":{"dev":"rsbuild dev","build:umd":"rslib build && cp src/dist-index.d.ts dist/index.d.ts","dev:dist-test":"rsbuild dev --config rsbuild.dist-test.config.ts"},"_npmUser":{"name":"willghy","email":"390816673@qq.com"},"_npmVersion":"10.9.2","description":"Deep Research SDK - 深度研究SDK，提供UMD格式的第三方集成能力","directories":{},"_nodeVersion":"22.15.0","dependencies":{},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/qianfan-deep-research_0.0.5-alpha.1_1768473623123_0.10245406397251378","host":"s3://npm-registry-packages-npm-production"}},"0.0.5-alpha.2":{"name":"@baiducloud/qianfan-deep-research","version":"0.0.5-alpha.2","keywords":["deep-research","sdk","umd","react"],"_id":"@baiducloud/qianfan-deep-research@0.0.5-alpha.2","maintainers":[{"name":"bce-cfc-dev","email":"bce-cfc-dev@baidu.com"},{"name":"yangwei9012","email":"yangwei9012@163.com"},{"name":"lurunze","email":"lurunze@hotmail.com"},{"name":"leophen","email":"leophen@foxmail.com"},{"name":"willghy","email":"390816673@qq.com"},{"name":"howie126313","email":"howie126313@gmail.com"},{"name":"tjdl102306","email":"tjdl102306@gmail.com"}],"dist":{"shasum":"feb53f03eb452d0086d32a260bad10c66758f809","tarball":"https://registry.npmjs.org/@baiducloud/qianfan-deep-research/-/qianfan-deep-research-0.0.5-alpha.2.tgz","fileCount":177,"integrity":"sha512-SeBple5bWl9t+FzqvE/JUFyQXJlYtsSnznKpNPNkxeAzo8nEedpJEzFlFdayDT3+WrgvVWDGg9K2fbPHICTPtQ==","signatures":[{"sig":"MEQCIElx18bawOMLAU2O/lmAKS70WuhSapkr8wRfF2HcLUoNAiBMMMv31xQkEPYwRerieA7+oS2kmYMoyYcobbGlK215bg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46945104},"main":"./dist/index.js","types":"./dist/index.d.ts","gitHead":"0ad76fa2ec07e264a4f087251739d16892724a0e","scripts":{"dev":"rsbuild dev","build:umd":"rslib build && cp src/dist-index.d.ts dist/index.d.ts","dev:dist-test":"rsbuild dev --config rsbuild.dist-test.config.ts"},"_npmUser":{"name":"willghy","email":"390816673@qq.com"},"_npmVersion":"10.9.2","description":"Deep Research SDK - 深度研究SDK，提供UMD格式的第三方集成能力","directories":{},"_nodeVersion":"22.15.0","dependencies":{},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/qianfan-deep-research_0.0.5-alpha.2_1768555813088_0.47069069203640157","host":"s3://npm-registry-packages-npm-production"}},"0.0.6":{"name":"@baiducloud/qianfan-deep-research","version":"0.0.6","keywords":["deep-research","sdk","umd","react"],"_id":"@baiducloud/qianfan-deep-research@0.0.6","maintainers":[{"name":"bce-cfc-dev","email":"bce-cfc-dev@baidu.com"},{"name":"yangwei9012","email":"yangwei9012@163.com"},{"name":"lurunze","email":"lurunze@hotmail.com"},{"name":"leophen","email":"leophen@foxmail.com"},{"name":"willghy","email":"390816673@qq.com"},{"name":"howie126313","email":"howie126313@gmail.com"},{"name":"tjdl102306","email":"tjdl102306@gmail.com"}],"dist":{"shasum":"d0e4b12e795db9b01b1df6a12b25f0a0f7729df6","tarball":"https://registry.npmjs.org/@baiducloud/qianfan-deep-research/-/qianfan-deep-research-0.0.6.tgz","fileCount":177,"integrity":"sha512-xWndH6wZTuvoC3BZ4j2uA+4yv21qDCRL4xDuaUMtZUqEOwQSF4hXo8qOGNyGNoC12FE3zgEUpoznQkO63uWWrA==","signatures":[{"sig":"MEQCIChOBIvCQ9eYo49MviCRlzcSt0iJzz1GS4vcGwAICrtOAiAXXQc9IgEc/o/1J/GN+9FHmM10iXOJsDQn+Ax1SI/QnA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46945291},"main":"./dist/index.js","types":"./dist/index.d.ts","gitHead":"47ce8419aea62ae617dc87eb01d0c8d1d429d498","scripts":{"dev":"rsbuild dev","build:umd":"rslib build && cp src/dist-index.d.ts dist/index.d.ts","dev:dist-test":"rsbuild dev --config rsbuild.dist-test.config.ts"},"_npmUser":{"name":"willghy","email":"390816673@qq.com"},"_npmVersion":"10.9.2","description":"Deep Research SDK - 深度研究SDK，提供UMD格式的第三方集成能力","directories":{},"_nodeVersion":"22.15.0","dependencies":{},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/qianfan-deep-research_0.0.6_1768621031631_0.7119166611236949","host":"s3://npm-registry-packages-npm-production"}},"0.0.7":{"name":"@baiducloud/qianfan-deep-research","version":"0.0.7","keywords":["deep-research","sdk","umd","react"],"_id":"@baiducloud/qianfan-deep-research@0.0.7","maintainers":[{"name":"xinc123","email":"xinc12358@gmail.com"},{"name":"bce-cfc-dev","email":"bce-cfc-dev@baidu.com"},{"name":"yangwei9012","email":"yangwei9012@163.com"},{"name":"lurunze","email":"lurunze@hotmail.com"},{"name":"leophen","email":"leophen@foxmail.com"},{"name":"willghy","email":"390816673@qq.com"},{"name":"howie126313","email":"howie126313@gmail.com"},{"name":"chenxuejin","email":"chenxuejin512@gmail.com"},{"name":"tjdl102306","email":"tjdl102306@gmail.com"}],"dist":{"shasum":"93336121e75a59adb03eb4c1d8fe5ac33e74f909","tarball":"https://registry.npmjs.org/@baiducloud/qianfan-deep-research/-/qianfan-deep-research-0.0.7.tgz","fileCount":54,"integrity":"sha512-E30c65xlj/rT2f3r9iUOU7qojWSRZsyaW9CckGm4RvZTxXyBlaR56J937AVmE2smgeGzg3egZOrFSyclrMPmIg==","signatures":[{"sig":"MEYCIQCEV+UfceAqnjQ/a3hqGEb32r/CCCcknInHt/NSHBhtKgIhALTzeJo2LxarRNT5TxSdK9HXVDcN7HUXrpbWiokP9853","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":21446460},"main":"./dist/index.js","types":"./dist/index.d.ts","gitHead":"37edfc765533177c56afa0410c3d524c0260612b","scripts":{"dev":"rsbuild dev","build:umd":"rslib build && cp src/dist-index.d.ts dist/index.d.ts","dev:dist-test":"rsbuild dev --config rsbuild.dist-test.config.ts"},"_npmUser":{"name":"chenxuejin","email":"chenxuejin512@gmail.com"},"_npmVersion":"10.9.2","description":"Deep Research SDK - 深度研究SDK，提供UMD格式的第三方集成能力","directories":{},"_nodeVersion":"22.14.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/qianfan-deep-research_0.0.7_1780042460387_0.15978370729962665","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-01-15T08:39:20.467Z","modified":"2026-09-09T12:33:04.925Z","0.0.1":"2026-01-15T08:39:21.534Z","0.0.2":"2026-01-15T09:03:31.059Z","0.0.3":"2026-01-15T09:14:26.780Z","0.0.4":"2026-01-15T10:30:12.804Z","0.0.5-alpha.1":"2026-01-15T10:40:24.033Z","0.0.5-alpha.2":"2026-01-16T09:30:14.080Z","0.0.6":"2026-01-17T03:37:12.520Z","0.0.7":"2026-05-29T08:14:20.721Z"},"keywords":["deep-research","sdk","umd","react"],"description":"Deep Research SDK - 深度研究SDK，提供UMD格式的第三方集成能力","maintainers":[{"email":"siddenly@live.com","name":"siddenly"},{"email":"zxxself@126.com","name":"daxiongz"},{"email":"xinc12358@gmail.com","name":"xinc123"},{"email":"bce-cfc-dev@baidu.com","name":"bce-cfc-dev"},{"email":"yangwei9012@163.com","name":"yangwei9012"},{"email":"lurunze@hotmail.com","name":"lurunze"},{"email":"leophen@foxmail.com","name":"leophen"},{"email":"aaa919938949@gmail.com","name":"mingliuyiming"},{"email":"wangyuzhen01@baidu.com","name":"wangyuzhen01"},{"email":"390816673@qq.com","name":"willghy"},{"email":"howie126313@gmail.com","name":"howie126313"},{"email":"zhangchi951221@gmail.com","name":"sanderhoff"},{"email":"kaloklxc@gmail.com","name":"kaloklxc-pixel"},{"email":"chenxuejin512@gmail.com","name":"chenxuejin"},{"email":"tjdl102306@gmail.com","name":"tjdl102306"}],"readme":"# Deep Research SDK\n\n深度研究 SDK，提供 UMD 格式的第三方集成能力，支持通过 `<script>` 标签引入使用。\n\n## 安装\n\n### 通过 npm 安装\n\n```bash\nnpm install @baiducloud/qianfan-deep-research\n```\n\n**注意**：本包提供 UMD 格式的构建产物，仅支持通过 `<script>` 标签引入。\n\n## 使用方法\n\n### OpenAPI 文档\n\nSDK 需要配合 OpenAPI 自行实现接口调用。在实现 `IClientService` 接口时，请参考 [千帆 API 文档](https://cloud.baidu.com/doc/qianfan-api/s/vmizwyngh) 中的深度研究 Agent 相关接口规范。\n\n### UMD引入\n\n通过 `<script>` 标签引入，SDK 会自动挂载到 `window.DeepResearchAgent`。\n\n#### 引入方式\n\n**方式一：直接引用构建产物**\n\n如果已将 UMD 包复制到项目的静态资源目录，可以直接通过相对路径引用：\n\n```html\n<script src=\"/dist/index.js\"></script>\n```\n\n**方式二：通过构建配置引入**\n\n在构建配置中（如 Vite、Webpack、Rsbuild 等），可以通过 `publicDir` 配置将 UMD 包引入到项目中：\n\n```javascript\n// vite.config.js / webpack.config.js / rsbuild.config.ts 等\nimport path from 'path';\n\nexport default {\n    // ... 其他配置\n    publicDir: {\n        name: path.resolve(__dirname, 'node_modules/@baiducloud/qianfan-deep-research/dist')\n    }\n};\n```\n\n配置后，UMD 包会被复制到构建输出的静态资源目录，可以通过 `<script>` 标签引用：\n\n```html\n<script src=\"/index.js\"></script>\n```\n\n#### 使用示例\n\n**重要提示**：UMD 包必须在应用代码之后加载，因为 SDK 需要挂载 UI 到对应的 DOM 元素上。请确保：\n\n1. 先创建用于挂载 SDK UI 的 DOM 容器\n2. 然后加载 UMD 包脚本\n3. 最后在脚本中初始化 SDK\n\n```html\n<!DOCTYPE html>\n<html>\n    <head>\n        <meta charset=\"UTF-8\" />\n        <title>Deep Research SDK 示例</title>\n    </head>\n    <body>\n        <!-- 步骤1：创建容器（必须在脚本加载前存在） -->\n        <div id=\"deep-research-container\"></div>\n\n        <!-- 步骤2：加载 UMD 包（必须在应用代码之前加载） -->\n        <script src=\"/dist/index.js\"></script>\n        <!-- 或使用通过构建配置引入的路径 -->\n        <!-- <script src=\"/index.js\"></script> -->\n\n        <!-- 步骤3：初始化 SDK（必须在 UMD 包加载后执行） -->\n        <script>\n            // 实现 IClientService 接口（接口定义见下方）\n            const clientService = {\n                /** 对话接口 - SSE流式接口 */\n                deepResearchRun: (param, callbacks, options) => {\n                    // param: 请求参数对象\n                    // callbacks: {\n                    //     onMessage: (message: string) => void;  // 收到消息时调用\n                    //     onCompleted: () => void;               // 完成时调用\n                    //     onError: (error: Error) => void;        // 错误时调用\n                    // }\n                    // options?: {\n                    //     abortController?: AbortController;      // 用于取消请求\n                    //     headers?: HeadersInit;                  // 请求头\n                    // }\n\n                    // 实现 SSE 流式请求逻辑\n                    // 示例：通过 EventSource 或其他方式实现流式请求\n                    const eventSource = new EventSource('/api/stream', {\n                        headers: options?.headers\n                    });\n\n                    eventSource.onmessage = event => {\n                        callbacks.onMessage(event.data);\n                    };\n\n                    eventSource.onerror = error => {\n                        callbacks.onError(new Error('Stream error'));\n                        eventSource.close();\n                    };\n\n                    // 监听 abort 信号\n                    options?.abortController?.signal.addEventListener('abort', () => {\n                        eventSource.close();\n                        callbacks.onError(new Error('Request aborted'));\n                    });\n                },\n\n                /** 创建对话 */\n                async createConversation() {\n                    // 返回对话ID\n                    return 'conversation-id-123';\n                },\n\n                /** 文件上传 */\n                async uploadFile(files, conversationId) {\n                    // 实现文件上传逻辑，返回文件ID和对话ID\n                    return {\n                        file_id: 'file-id-123',\n                        conversation_id: conversationId\n                    };\n                },\n\n                /** 文件解析触发 */\n                async fileParseCommit(fileIds) {\n                    // 实现文件解析提交逻辑，返回任务ID数组\n                    return fileIds.map((fileId, index) => `task-id-${index}`);\n                },\n\n                /** 文件解析状态查询 */\n                async fileParseQuery(taskIds) {\n                    // 实现文件解析状态查询逻辑\n                    return taskIds.map((taskId, index) => ({\n                        file_id: `file-id-${index}`,\n                        parse_status: 'success' // 文件解析状态：init | running | success | failed\n                    }));\n                },\n\n                /** 应用基本信息查询 */\n                async getAppInfo() {\n                    return {\n                        name: '深度研究 Agent',\n                        prologue:\n                            '广泛深度迭代检索全网信息及上传文件，根据指定大纲生成深度研究报告，适用于金融研报、科研综述等场景',\n                        avatarUrl: 'https://deepresearch.baidu.com/logo.png'\n                    };\n                }\n            };\n\n            // 初始化 SDK\n            DeepResearchAgent.init(document.getElementById('deep-research-container'), clientService);\n        </script>\n    </body>\n</html>\n```\n\n## 类型声明文件\n\n构建后会生成 `dist/index.d.ts` 类型声明文件，可以通过以下方式使用类型：\n\n```typescript\n// 从类型声明文件导入类型\nimport type {\n    IClientService,\n    IFileUploadRes,\n    IFileParseRes,\n    IAppInfo\n} from '@baiducloud/qianfan-deep-research/dist/index.d.ts';\n```\n\n## IClientService 接口定义\n\n```typescript\n/** SDK模式下的客户端服务接口 */\ninterface IClientService {\n    /** 对话接口 - SSE流式接口 */\n    deepResearchRun: (\n        param: any,\n        callbacks: {\n            /** 接受到消息的回调 */\n            onMessage: (message: string) => void;\n            /** 任务执行完成的回调 */\n            onCompleted: () => void;\n            /** 任务执行错误的回调 */\n            onError: (error: Error) => void;\n        },\n        options?: {\n            abortController?: AbortController;\n            headers?: HeadersInit;\n        }\n    ) => void;\n\n    /** 创建对话 */\n    createConversation(): Promise<string>;\n\n    /** 文件上传 */\n    uploadFile(files: File, conversationId: string): Promise<IFileUploadRes>;\n\n    /** 文件解析触发 */\n    fileParseCommit(fileIds: string[]): Promise<string[]>;\n\n    /** 文件解析状态查询 */\n    fileParseQuery(taskIds: string[]): Promise<IFileParseRes[]>;\n\n    /** 应用基本信息查询 */\n    getAppInfo(): Promise<IAppInfo>;\n}\n\n/** 文件上传返回结构 */\ninterface IFileUploadRes {\n    /** 文件id */\n    file_id: string;\n    /** 对话id */\n    conversation_id: string;\n}\n\n/** 文件解析状态返回结构 */\ninterface IFileParseRes {\n    /** 文件id */\n    file_id: string;\n    /** 文件解析状态 init | running | success | failed */\n    parse_status: string;\n}\n\n/** 应用基本信息返回结构 */\ninterface IAppInfo {\n    /** 应用名称 */\n    name?: string;\n    /** 应用开场白 */\n    prologue?: string;\n    /** 应用头像 */\n    avatarUrl?: string;\n}\n```\n\n## 开发调试\n\n在使用 SDK 进行开发时，建议在浏览器开发者工具中查看控制台输出，以便排查问题和调试接口调用。\n\n## 依赖说明\n\nSDK 采用全量打包方式，所有依赖（包括 React、ReactDOM 等）都已打包在 UMD 文件中，用户无需额外引入任何依赖即可使用。\n\n## 注意事项\n\n1. **UMD 模式说明**：本包提供 UMD 格式的构建产物，仅支持通过 `<script>` 标签引入，SDK 会自动挂载到 `window.DeepResearchAgent` 全局对象。\n\n2. **加载顺序**：UMD 包必须在应用代码之后加载，因为 SDK 需要挂载 UI 到对应的 DOM 元素上。正确的顺序是：先创建 DOM 容器 → 加载 UMD 包脚本 → 初始化 SDK。\n\n3. **构建配置引入**：可以通过构建工具的 `publicDir` 配置将 `node_modules/@baiducloud/qianfan-deep-research/dist` 目录复制到静态资源目录，然后通过 `<script>` 标签引用。\n\n4. **文件上传**：`uploadFile` 方法需要同时传入 `files`（File 对象）和 `conversationId`，SDK 会在内部处理文件上传逻辑。\n\n5. **流式接口**：`deepResearchRun` 是一个函数属性，需要实现 SSE（Server-Sent Events）流式请求，并通过回调函数处理消息、完成和错误事件。\n\n6. **对话ID管理**：SDK 会在需要时调用 `createConversation` 创建新对话，也可以在上传文件时传入已有的 `conversationId`。\n\n7. **错误处理**：所有异步方法都应该正确处理错误情况，SDK 会在内部捕获并显示错误信息。\n\n8. **TypeScript 类型支持**：可以通过引用构建产物中的 `dist/index.d.ts` 文件来获得 TypeScript 类型支持。\n","readmeFilename":"README.md"}