前言¶

在 DeepSeek Harness（DSH）里做智能体时，文档和表格往往还在腾讯文档里：改单元格、查最近文件、搜表名，如果只能自己拼 HTTP 或写脚本，和对话式 Harness 的用法是割裂的。腾讯文档开放平台提供了官方 MCP 端点（docs.qq.com），但要接到 DSH 上，还需要配置官方 @deepseek-ai/dsh-mcp-client、准备账号侧的 API 凭据（space_secret），并保证凭据只留在本机。

下面介绍社区维护的插件 dsh-tencent-docs-bridge（npm 包名 @hs666-ai/dsh-tencent-docs-bridge）：非官方桥接层，复用官方 mcp-client 连官方 MCP，插件侧负责「取票 + 配置注入」，仓库不内嵌任何凭据。

这是什么¶

一句话：让你在 DSH 里用自然语言驱动腾讯文档（例如「把这张表第 5 行改成 100 并标黄」），底层请求发往腾讯文档开放平台官方 MCP 端点 https://docs.qq.com/openapi/mcp。

插件目录页：skillhub.cn/plugins/hs666-ai/dsh-tencent-docs-bridge。源码与说明：GitHub - hs666-ai/dsh-tencent-docs-bridge。

核心功能¶

连接官方 MCP¶

启动后通过 ctx.loader.create 挂载官方 mcp-client，serverName=tencent-docs，传输方式为 streamable-http，请求头携带 Bearer space_secret。工具在 DSH 中以 mcp__tencent-docs__* 暴露，README 中举例包括：

• mcp__tencent-docs__get_sheet_info
• mcp__tencent-docs__set_cell_value
• mcp__tencent-docs__manage_search_file

维护者在 v0.2.1 实测中，probe 对官方端点返回 HTTP 200，工具数 226；并验证过 sheet.get_sheet_info、sheet.set_range_value 等调用，以及向在线表格写入后回读一致。

自足取票链路¶

插件不内置 token。取票优先级（见 lib/resolver.js）：环境变量 → 本地 vault → 可选本地网关 127.0.0.1:18761（兼容 /internal/tencent-docs/tokens）。

自带 CLI（bin/tdoc-auth.mjs，npm 下通过包名调用）支持：

• login：系统浏览器弹窗，微信/QQ 扫码，写入本地 vault
• inject：手动写入 32 位 hex（无弹窗或 CI）
• probe / status / clear：探测端点、查看 vault 摘要（无明文）、清空凭据

安全与合规设计¶

README 与 COMPLIANCE 强调：仓库与 cordis.patch.yml 零 token 明文；日志仅输出长度与前 4 位指纹；模型只见 MCP 工具结果。官方免费档频率限制（文档写明 2000 次/天）由官方执行，插件不绕过。安装前建议阅读仓库中的 DISCLAIMER.md 与 COMPLIANCE.md。

可选 Declarative 模式¶

若不想用运行时挂载，可在 profile 的 cordis.patch.yml 手写 @deepseek-ai/dsh-mcp-client 条目，token 仅走环境变量 TDOC_OAUTH_ACCESS_TOKEN，并以 --disable-runtime-mount 启动插件（或只保留手写条目）。示例见 GitHub README「Declarative 模式」一节。

安装与启用¶

前置条件¶

1. 已安装 DSH 环境，Node.js ≥ 22.6。
2. 具备腾讯文档账号（个人版，QQ/微信登录）。
3. 官方 mcp-client 已就位（通常随 profile 自带；缺失时可全局安装）：

npm i -g @deepseek-ai/dsh-mcp-client

安装插件¶

npm 安装（README 推荐，便于插件中心收录）：

dsh plugin --profile web add @hs666-ai/dsh-tencent-docs-bridge

或从 GitHub 安装：

dsh plugin --profile web add github:hs666-ai/dsh-tencent-docs-bridge

支持 web 等 profile；安装后需重启 dsh web 生效。

若面板出现 failed to import，README 说明 0.2.2 及更早 版本存在模块名与 npm scope 不一致问题，升级到 0.2.3+：

dsh plugin --profile <你的profile> add @hs666-ai/dsh-tencent-docs-bridge@latest

然后重启 dsh web 或桌面端。

准备凭据（第一步）¶

推荐：一条命令扫码写入 vault。

npx -y @hs666-ai/dsh-tencent-docs-bridge login
npx -y @hs666-ai/dsh-tencent-docs-bridge probe

全新环境请使用 npx -y @hs666-ai/dsh-tencent-docs-bridge …，不要单独使用 npx tdoc-auth …（npm 上无独立 tdoc-auth 包名）。轮换密钥可加 --refresh（旧密钥立即失效）。

手动注入：

npx -y @hs666-ai/dsh-tencent-docs-bridge inject --token <32位hex>

或环境变量：

export TDOC_OAUTH_ACCESS_TOKEN=<32位hex>

验证¶

重启 dsh web 后，对模型说一句「列出我最近的腾讯文档」，或调用上述 MCP 工具，确认插件已启用且无 import 报错。

典型用法¶

工作流可以概括为：安装插件 → 取票 → 重启 DSH → 在对话里描述文档操作。

1. 按上一节完成 login 或 inject，probe 返回成功即表示能连上官方端点。
2. 在 Harness 对话中描述表格或文档意图，由模型选择 mcp__tencent-docs__* 工具执行。
3. 需要断连或换机前，可执行：

npx -y @hs666-ai/dsh-tencent-docs-bridge clear

卸载插件并清空 vault 后，即不再向官方端点携带本地保存的 space_secret。

适用场景与注意¶

适合谁：已在用 DSH、文档资产在腾讯文档、希望用官方 MCP 能力而不是自写 OpenAPI 封装的开发者或团队。

运行权限：插件以当前 dsh 进程权限运行，凭据保存在本机 vault；安装前应自行审阅源码与 MIT 许可证，并理解非官方社区项目的免责范围。

频率与账号：调用发生在你的腾讯账号责任范围内；space_secret 等同于账号 API 凭据，勿分享、勿提交到仓库。

生态说明：DSH 采用「一切皆插件」的扩展方式；skillhub.cn 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本文介绍的插件同样为社区维护。

结尾¶

dsh-tencent-docs-bridge 把腾讯文档官方 MCP 端点接到 DSH：官方 mcp-client 负责协议与工具，插件负责本机取票与挂载，避免在仓库或配置里出现明文凭据。若你要在 Harness 里直接「对表格说人话」，可按 README 完成安装、取票与重启验证。

• 目录页：https://www.skillhub.cn/plugins/hs666-ai/dsh-tencent-docs-bridge
• GitHub：https://github.com/hs666-ai/dsh-tencent-docs-bridge