# @szhl/dsh-tencent-docs

**腾讯文档 / Tencent Docs** —— 一次授权，两件事：输入框里能**选文档并插进草稿**，模型能**真正读到那份文档**。

## 安装

```bash
dsh plugin --profile desktop add @szhl/dsh-tencent-docs
```

`--profile` 换成你自己的 profile 名（桌面版是 `desktop`）；`dsh plugin` 会把后面的参数转交给 profile 里的 pnpm。装完重启 DSH 生效。

## 一个包，两行配置

| 行 | 作用 |
| --- | --- |
| `tencent-docs-connector` | 面板、二维码授权、文档列表/搜索、`@` 提及源、登出；把授权令牌写入 `$DSH_HOME/tencent-docs-token` |
| `tencent-docs-mcp` | 挂载官方腾讯文档 MCP server（`https://docs.qq.com/openapi/mcp`），从同一个令牌文件读 `Authorization`，给模型 `mcp__tencent-docs__*` 工具 |

两行必须在一起才完整：connector 往草稿里放的是**文档标题**，模型靠 `mcp__tencent-docs__*` 的 `manage.search_file` 用标题反查出 file id，再去读内容。

## 用法

1. 输入框点「+」→「腾讯文档」→ 面板内用微信/QQ 扫码授权（也可以在面板里手动粘贴 token）。
2. 授权后搜索或从最近列表里选一个文档，它会以 `腾讯文档《标题》：` 的形式进入草稿；用 `@` 触发源则插入带文档名的引用胶囊，提交时序列化成 file id。
3. 面板头部的「已连接」胶囊可点：第一下上膛、第二下登出（rail 里也有同名按钮）。登出会删掉令牌与在途授权码。

## 备注

- 令牌文件位置与手工写入方式：
  `printf '%s' '<TOKEN>' > ~/.dsh/tencent-docs-token && chmod 600 ~/.dsh/tencent-docs-token`
  （也可在 https://docs.qq.com/open/auth/mcp.html 自助获取，免费额度 2000 次/天。）
- MCP 那行在**组合加载时**读取令牌，所以换账号/登出后需要重载 DSH 才会作用到模型侧工具。
- `failOnStartupError: false` 是有意的：令牌失效只该损失工具，不该拖垮整个启动（启动失败会走恢复路径，把**所有**第三方 bundle 一起禁掉）。
- 需要 `@deepseek-ai/dsh-client-ui-conversation`。

## 宿主路由

`GET /tencent-docs.state`、`POST /tencent-docs.auth`、`POST /tencent-docs.auth/poll`、`POST /tencent-docs.files`、`POST /tencent-docs.token`、`POST /tencent-docs.signout`、`POST /tencent-docs.diag`。全部经 `ctx.connection.requestRejection` 的信任围栏，只应答本机操作者自己的浏览器。

## 许可

MIT © 2026 suzhilin
