Skip to content

About

Codex skill for Tencent Docs MCP workflows

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

Tencent Docs Codex Skill

这是一个面向 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 重新被发现。

Token 配置

本 skill 依赖腾讯文档远程 MCP 服务:

  • tencent-docs: https://docs.qq.com/openapi/mcp
  • tencent-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 等许可证。

About

Codex skill for Tencent Docs MCP workflows

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages