这是一个面向 Codex 的腾讯文档在线文档 skill,用于通过腾讯文档 MCP 读取、创建、编辑和管理 docs.qq.com 上的在线文档与在线表格。
- 读取腾讯在线文档、在线表格、智能文档、智能表格中的内容。
- 根据标题、文件夹、空间节点、近期创建结果等信息定位腾讯文档文件。
- 创建在线文档、在线表格、智能表格、收集表、幻灯片、思维导图、流程图、白板等腾讯文档资源。
- 编辑已有智能文档、Word/docengine 文档、在线表格和智能表格。
- 支持在线表格的结构化读取、分块读取、样式调整、边框处理、冻结行列、导入导出等工作流。
- 支持将本地
.xlsx作为模板导入腾讯文档,适合创建格式稳定的在线表格。 - 支持导出在线文档到本地文件,再用本地工具核验公式、保护、批注、列宽、冻结、样式等结构。
- 对身份证号、手机号、学号、邮箱、地址等敏感字段默认采用统计、校验、脱敏摘要或问题定位,不主动完整回显敏感值。
- 对只读任务默认走只读路径,避免在读取、总结、核对时误改内容、样式、权限或文件位置。
- 针对 Windows PowerShell / Codex 终端中文乱码问题,内置 UTF-8 维护规则。
.
├── README.md
└── tencent-docs/
├── SKILL.md
├── agents/
├── doc/
├── references/
├── sheet/
└── setup.sh
其中 tencent-docs/ 是可安装的 skill 目录。
将仓库中的 tencent-docs 文件夹复制到 Codex 的 skills 目录:
git clone https://github.com/dangerous090566/tencent-docs-codex-skill.git
Copy-Item -Recurse -Force .\tencent-docs "$env:USERPROFILE\.codex\skills\tencent-docs"在 macOS / Linux 中可复制到:
~/.codex/skills/tencent-docs安装后重启 Codex,使 skill 重新被发现。
本 skill 依赖腾讯文档远程 MCP 服务:
tencent-docs:https://docs.qq.com/openapi/mcptencent-docengine:https://docs.qq.com/api/v6/doc/mcp
使用前需要获取腾讯文档 MCP Token,并设置环境变量 TENCENT_DOCS_TOKEN。
Windows PowerShell 示例:
[Environment]::SetEnvironmentVariable("TENCENT_DOCS_TOKEN", "你的腾讯文档Token", "User")设置后重启 Codex。请不要把真实 Token 提交到 GitHub。
适合在以下请求中使用:
- “帮我读取这个腾讯文档”
- “总结这个 docs.qq.com 表格”
- “把这个名单做成腾讯在线表格”
- “创建一个可填写的在线统计表”
- “检查这个在线表格有没有公式、保护或隐藏结构”
- “把这个 Word/智能文档内容追加一段”
- “把这个本地 Excel 模板导入腾讯文档”
如果只是处理本地 .xlsx / .csv 文件,且不需要上传到腾讯文档,通常应优先使用本地表格处理能力,而不是本 skill。
- 默认读取任务不得修改文档内容、格式、权限、保护状态或文件位置。
- 删除、移动、权限修改、保护状态修改属于高风险操作,执行前应由用户明确提出并确认。
manage.set_privilege只表示整份文件的分享权限,不等同于收集表的“填写内容隐藏/仅填写者与创建者可见”等隐私设置。- 如果 MCP 当前工具不能设置收集表隐私项,不应创建可收集真实敏感信息的入口,应提示用户在腾讯文档 UI 中手动配置。
- 对敏感数据默认做脱敏处理,除非用户明确要求且目的合理。
- 公开仓库不包含任何个人 Token、凭据或本地账号配置。
在 Windows PowerShell 或 Codex 终端中查看中文内容时,如果出现乱码,优先判断为终端编码或显示问题,不要直接认定源文件已经损坏。
维护本 skill、生成临时脚本、读写包含中文的 Markdown、JSON、CSV、LaTeX、.mjs 或 .py 文件时,建议统一使用 UTF-8。PowerShell 5.1 中向外部进程管道传递中文前,应设置 UTF-8 相关编码和环境变量。
本仓库当前未声明开源许可证。公开仓库表示代码和说明可被访问,但不自动授予再分发或商用许可;如需正式开源,可后续补充 MIT、Apache-2.0 等许可证。