前言¶

在 DeepSeek Harness（DSH）里做智能体或日常开发时，文档经常落在腾讯文档里。浏览器里要反复切 tab、在云盘里找目录，和 DSH 左侧的工作流是割裂的。社区插件 dsh-tencent-docs 把「最近打开」「云文档目录」和「按标题搜索」接到 DSH Web 左侧栏，数据走腾讯文档官方 MCP 接口，令牌只在本机保存一次。下面介绍它是什么、怎么装、怎么用，以及权限和已知限制。

这是什么¶

dsh-tencent-docs（GitHub：lxclinux/dsh-tencent-docs）是 DSH 的客户端插件：在左侧栏增加文档图标，点开后面板分三个标签，通过 Host 侧桥接访问 https://docs.qq.com/openapi/mcp。维护者为 liuxc（README 署名），许可证 MIT，当前资料中的版本为 v0.3.5。package.json 要求 Node >=20，DSH >=0.2.0-rc.2 等兼容版本。

它不替代腾讯文档网页编辑器，也不在内嵌 iframe 里预览文件（腾讯文档禁止第三方嵌入）；定位是在 DSH 里快速列出、搜索并新开标签打开你的云文档。

核心功能¶

面板三个标签，能力在 README 中有明确对应：

1. 最近 — 调用 manage.recent_online_file，每页 20 条，支持翻页；默认首页。
2. 云文档 — manage.folder_list 逐层下钻真实目录，带面包屑；manage.search_file 按标题搜索；点开文件在新标签打开。
3. 本机清单 — 用户自维护的链接列表，持久化到 ~/.dsh/tencent-docs/docs.json，换浏览器不丢。

Host 半还提供同源 HTTP 路由（供面板调用），例如最近文件、目录树、搜索、授权与本机清单读写；错误格式为 { ok: false, error, authRequired }，缺令牌返回 401。

安装与启用¶

在 desktop profile 下从插件名安装（资料原文命令，请勿自行改成 github:owner/repo 形式）：

dsh plugin --profile desktop add dsh-tencent-docs

若使用本地目录或 tarball，示例为：

dsh plugin --profile desktop add "C:\path\to\dsh-tencent-docs"
dsh plugin --profile desktop add "C:\path\to\dsh-tencent-docs-0.3.4.tgz"

装完后刷新 Web GUI，左侧栏会出现文档图标，位置在 dsh-context 与 dsh-purge 之间。

安装前建议自行查看仓库源码与 MIT 许可证；插件以当前 DSH 进程权限运行，沙箱扫描会体现网络、读写 ~/.dsh/tencent-docs/ 等能力（见下文「权限与数据」）。

授权（一次性令牌）¶

1. 点击侧栏图标，面板会提示需要访问令牌。
2. 打开 腾讯文档开放场景页，使用 QQ 或微信登录后复制访问令牌。
3. 在面板中粘贴并保存。令牌仅由 Host 半写入 %USERPROFILE%\.dsh\tencent-docs\auth.json（权限 0600），浏览器侧脚本无法读取；面板中「断开」会清除令牌。

典型用法¶

日常流程可以概括为：

1. 完成安装与授权后，打开 DSH Web，点左侧文档图标。
2. 在 最近 标签翻页查看近期在线文件，点条目在新标签打开。
3. 在 云文档 沿面包屑下钻文件夹，或用标题搜索定位文件后打开。
4. 在 本机清单 维护常用文档链接，数据落在本机 docs.json。

面板即主要交互入口。

权限与数据边界¶

沙箱静态扫描可见 fs-read / fs-write / network；无 shell、无 env、无读取其他 credentials。

适用场景与注意¶

适合：已在用 DSH desktop Web、文档集中在腾讯文档、希望在同一界面里列目录和搜索、能接受「打开即新标签」而非侧栏预览的开发者。

注意：

• 腾讯文档设置 frame-ancestors，面板内不做预览，文件一律新标签打开。
• MCP 工具名在运行时按正则解析（端点约 227 个工具），插件不硬编码工具名列表。
• manage.recent_online_file 的 count 上限为 20，更大值会被拒绝；Host 侧已做截断。
• 免费账号 MCP 调用额度为 2000 次/天（README 写明）。

DSH 生态理念是「一切皆插件」；SkillHub 目录页 是社区收录站点，与 DeepSeek / 幻方无官方从属关系，安装来源以你信任的 registry 或本地包为准。

结尾¶

dsh-tencent-docs 把腾讯文档的最近文件、目录下钻和标题搜索收进 DSH 左侧栏，授权与清单数据留在本机。若你需要在 Harness 里少切一次浏览器，可按上文命令安装并完成一次性令牌配置。

• 目录页：https://www.skillhub.cn/plugins/lxclinux/dsh-tencent-docs
• 仓库：https://github.com/lxclinux/dsh-tencent-docs