菜单
钉钉知识库搜索与读取。用于在钉钉沉淀知识里快速查资料、理解项目背景、梳理团队/部门信息、回答制度问题、整理新人入门材料、读取文档正文、导出 Markdown、下载文件，并可带图片和 diagram。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/breath57/dingtalk-skills --skill dingtalk-knowledge-search命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
钉钉消息发送。当用户提到"钉钉消息"、"发消息"、"发通知"、"群通知"、"群消息"、"Webhook"、"机器人消息"、"机器人发消息"、"工作通知"、"单聊消息"、"群聊消息"、"撤回消息"、"消息已读"、"发送Markdown"、"发卡片消息"、"ActionCard"、"@某人"、"@员工"、"at某人"、"提醒某人"、"dingtalk message"、"send message"、"robot message"、"work notification"时使用此技能。支持：群自定义 Webhook 机器人（文本/Markdown/ActionCard/Link/FeedCard + 加签 + @某人）、企业内部应用机器人单聊和群聊发送、消息撤回、已读查询、工作通知等全部消息类操作。
钉钉日程与日历。当用户提到"钉钉日程"、"日历"、"创建日程"、"新建会议"、"视频会议"、"钉钉会议"、"会议室"、"约会议室"、"会议室忙闲"、"空闲会议室"、"签到"、"签退"、"签到链接"、"签退链接"、"循环日程"、"重复日程"、"recurrence"、"查日程"、"日程列表"、"修改日程"、"删除日程"、"闲忙"、"忙闲"、"querySchedule"、"calendar"、"dingtalk schedule"、"日程提醒"时使用此技能。支持：主日历下日程 CRUD、用户闲忙、视频会议、会议室忙闲与绑定日程、签到/签退与链接、循环规则（recurrence）；订阅公共日历等需 Calendar.Calendar.Write 的能力见 api.md。
网页搜索与实时信息检索。需要查找最新资讯、实时数据、技术文档、热点事件，或用户说"搜一下"、"帮我查"、"查资料"、"web search"等时使用。基于小宿AI智能搜索，支持关键词搜索、时间范围过滤（一天/一周/一月/一年）、自定义结果数量、JSON 输出。
基于 SOC 职业分类
正在显示 SKILL.md
| name | dingtalk-knowledge-search |
| description | 钉钉知识库搜索与读取。用于在钉钉沉淀知识里快速查资料、理解项目背景、梳理团队/部门信息、回答制度问题、整理新人入门材料、读取文档正文、导出 Markdown、下载文件，并可带图片和 diagram。 |
cd <the_skill_dir_path>/scripts
python3 cli.py config check
python3 cli.py search "关键词1 关键词2 关键词3"
python3 cli.py read "https://alidocs.dingtalk.com/i/nodes/<node_id>"
python3 cli.py read <node_id>
先运行配置校验：
python3 cli.py config check
需要这些配置：
| 配置 | 用途 | 获取方式 |
|---|---|---|
DINGTALK_APP_KEY | 调用钉钉开放平台 API | 钉钉开放平台 -> 应用管理 -> 企业内部应用 -> 凭证与基础信息 |
DINGTALK_APP_SECRET | 获取 API token | 同上，应用凭证信息中查看 |
DINGTALK_MY_USER_ID | 当前操作者身份 | 管理后台 -> 通讯录 -> 成员管理 -> 点击成员查看 userId |
DINGTALK_MY_OPERATOR_ID | 文档 API 的 operatorId/unionId | 有 DINGTALK_MY_USER_ID 后可自动转换 |
缺少 DINGTALK_MY_OPERATOR_ID 时执行：
python3 cli.py config to-unionid
search：返回匹配文档列表；可用 --limit <n> 控制数量read：返回 Markdown；长内容会写到文件并返回路径；非 ALIDOC 文件会下载原文件read <pdf_node_or_url> --mode pdf2text 会先下载 PDF，再用系统 pdftotext -layout 输出 .txt；如果系统没有 pdftotext，会提示安装 poppler-utils，并退回返回 PDF 路径.skills-workspace/dingtalk-knowledge-search/outputs/--output-dir "$PWD/dingtalk-docs" --output-path 把结果写到当前项目modifiedTime 未变化时复用；默认用硬链接写入 --output-dir，用 --output-strategy copy 可复制隔离--with img-local，图片会下载到 Markdown 同目录 .assets/<文档名>/--with img，节约本地空间，但依赖代理服务和原链接有效期--with diagram 一起导出python3 cli.py search "项目背景 年假 晋升" --limit 10
python3 cli.py read "https://alidocs.dingtalk.com/i/nodes/<node_id>" --output-dir "$PWD/dingtalk-docs" --output-path
python3 cli.py read "https://alidocs.dingtalk.com/i/nodes/<node_id>" --with img-local --with diagram --output-dir "$PWD/dingtalk-docs" --output-path
python3 cli.py read "https://alidocs.dingtalk.com/i/nodes/<file_node_id>" --output-dir "$PWD/dingtalk-docs"
python3 cli.py read "https://alidocs.dingtalk.com/i/nodes/<pdf_node_id>" --mode pdf2text --output-dir "$PWD/dingtalk-docs"
python3 cli.py read "https://alidocs.dingtalk.com/i/nodes/<pdf_node_id>" --mode pdf2text --output-dir "$PWD/dingtalk-docs" --output-strategy copy
search 不缓存，每次直接查远端node、resolve-url、blocks 仍使用 SQLite API 缓存，受 --cache-ttl 影响modifiedTime 判断是否复用~/.dingtalk-skills/dingtalk-knowledge-search/output-cache/--output-strategy link：把全局缓存硬链接到当前 --output-dir，节省空间；编辑任一硬链接文件会影响同一份内容--output-strategy copy：复制到当前 --output-dir，和全局缓存隔离python3 cli.py cache clear --namespace output --yes 会删除输出缓存记录和关联本地文件loginRequired: true 和 screenshotPath