mcpField
G
glmv-doc-based-writing

glmv-doc-based-writing

github.com/zai-org文档处理47540 次安装28 周前更新
代码仓库

关于 glmv-doc-based-writing

glmv-doc-based-writing 是一项基于给定文档撰写文本内容的技能，适用于文章、报告、评论、提案等写作任务。它使用 ZhiPu GLM-V 多模态模型处理文档，并可将完整结果保存为 Markdown 或 JSON。

主要功能

  1. 01依据一个或多个文档写作
  2. 02撰写文章、报告、评论或提案
  3. 03支持 PDF、DOCX 和 TXT 文档 URL
  4. 04设置写作要求与自定义系统提示词
  5. 05将结果保存为 Markdown 或 JSON

适用场景

  1. 01根据论文撰写文章或简报
  2. 02总结文档并提炼核心观点
  3. 03基于书籍或电影材料撰写评论

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/zai-org/glm-skills --skill glmv-doc-based-writing

安装后在 Claude Code 中输入/glmv-doc-based-writing确认已加载。

附带文件.DS_Storescripts/doc_based_writing.py

详细介绍

GLM-V 基于文档的写作技能

理解给定文档，并使用智谱 GLM-V 多模态模型，根据你的要求撰写文本内容（论文／文章／随笔／报告／评论／帖子／简报／提案／计划）。

适用场景

  • 阅读所提供的文档后，根据指定要求撰写文本内容
  • 用户提及“基于文档的写作”“文章撰写”“文档解读”“新闻稿撰写”“简报撰写”“影评／书评撰写”“内容总结”“内容创作”“评论写作”“文档续写”“文档翻译”“方案策划”“发言稿撰写”“document-based writing”“article writing”“document reading”“press release writing”“brief writing”“film/book review writing”“content summarization”“content creation”“commentary writing”“document continuation”“document translation”“proposal planning ”“speech writing”

支持的输入类型

类型格式最大数量来源
文档（URL）pdf、docx50URL
文档（本地）仅 pdf总页数 ≤ 50本地路径

本地 PDF / 本地 PDF： 本地 PDF 文件会逐页转换为图像（base64），再发送给模型。需要安装 PyMuPDF（pip install PyMuPDF）。URL 文件支持 pdf/docx/txt 等完整格式。 本地 PDF 会自动逐页转为图片（base64）传给模型，需要安装 PyMuPDF（pip install PyMuPDF）。URL 文件支持 pdf/docx/txt 等全格式。

📋 输出显示规则（强制）

运行脚本后，必须按原样显示完整内容（Markdown 格式）。不得总结、截断、翻译、评论，也不得只回复“Writing Completed!”。

资源链接

资源链接
获取 API 密钥https://bigmodel.cn/usercenter/proj-mgmt/apikeys
API 文档对话补全

先决条件

API 密钥配置 / API Key 配置（必需 / 必需）

此脚本从 ZHIPU_API_KEY 环境变量读取密钥，并与其他智谱技能共用该密钥。 脚本通过 ZHIPU_API_KEY 环境变量获取密钥，与其他智谱技能共用同一个 key。

获取密钥 / 获取 Key： 访问 智谱开放平台 API 密钥 / 智谱开放平台 API Keys 创建或复制密钥。

配置方式 / 配置方式（任选一种）：

  1. OpenClaw 配置（推荐）/ OpenClaw 配置（推荐）： 在 openclaw.json 的 skills.entries.glmv-doc-based-writing.env 下设置：

    "glmv-doc-based-writing": { "enabled": true, "env": { "ZHIPU_API_KEY": "你的密钥" } }

  2. Shell 环境变量 / Shell 环境变量： 添加到 ~/.zshrc：

    export ZHIPU_API_KEY="你的密钥"

💡 如果你已为其他智谱技能（例如 zhipu-tools 或 glmv-caption）配置过密钥，它们共用同一个 ZHIPU_API_KEY，因此无需额外配置。 💡 如果你已为其他智谱 skill（如 zhipu-tools、glmv-caption）配置过 key，它们共享同一个 ZHIPU_API_KEY，无需重复配置。

使用方法

基本筛选
python scripts/doc_based_writing.py \
  --files "https://example.com/doucment1.pdf" "https://example.com/doucment2.docx" \
  --requirements "基于这篇论文撰写公众号文章，要求偏技术风格"
保存为 Markdown
python scripts/doc_based_writing.py \
  --files "https://example.com/doucment1.pdf" "https://example.com/doucment2.docx" \
  --requirements "总结文档主要内容和核心观点" \
  --output result.md
保存为 JSON
python scripts/doc_based_writing.py \
  --files "https://example.com/doucment1.pdf" "https://example.com/doucment2.docx" \
  --criteria "撰写新闻稿" \
  --output result.json --pretty
自定义系统提示词
python scripts/doc_based_writing.py \
  --files "https://example.com/doucment1.pdf" \
  --criteria "为这本书撰写书评" \
  --system-prompt "你是一位拥有20年跨领域写作经验的资深写作专家，擅长撰写书评"

输出示例

模型会输出如下 Markdown 内容：

XXX

CLI 参考

python scripts/doc_based_writing.py --files FILE [FILE...] --requirements REQUIREMENTS [OPTIONS]
参数必填描述
--files, -f✅文档文件 URL（pdf/docx，仅限 URL，最多 50 个）
--requirements, -c✅写作要求文本
--model, -m否模型名称（默认：glm-4.6v）
--system-prompt, -s否自定义系统提示词（默认：专业 HR 助手）
--temperature, -t否采样温度 0-1（默认：0.6）
--max-tokens否最大输出 token 数（默认：10000）
--output, -o否将结果保存到文件（Markdown 使用 .md，JSON 使用 .json）
--pretty否美化 JSON 输出

错误处理

未配置 API 密钥： → 引导用户配置 ZHIPU_API_KEY

身份验证失败（401/403）： → API 密钥无效或已过期 → 重新配置

速率限制（429）： → 配额已用尽 → 等待后重试

提供了本地路径： → 错误：仅支持 URL

内容被过滤： → 存在 warning 字段 → 内容被安全审查拦截

超时： → 文档过大或数量过多 → 减少文件数量

评论

支持 Markdown