Files

T

修雨 2c10be2a1a feat(schema): publish 210 built-in shortcuts (#802 )

Publishes all 210 public built-in shortcuts as reviewed Agent-visible
leaf tools across 16 product groups, with stable canonical identities,
executable +shortcut CLI paths, parameter and cross-parameter
constraints, selection guidance, interface metadata, and runtime-aligned
safety/confirmation semantics. Catalog grows from 603 to 813 tools.

2026-07-28 00:11:29 +08:00

8.6 KiB

Raw Permalink Blame History

5分钟搭好团队知识库：DWS 让 IT 服务台自己开口答疑，你值得拥有

💡 省流版摘要： 别再用鼠标一个个建文档了，真的没必要！本文带你用 DWS（钉钉命令行工具），5 分钟搭好一个团队知识库：建空间、搭目录、批量导入 FAQ、配权限，全程命令行一步到位。最后再花 30 秒把它挂到钉钉机器人上——同事在群里 @ 一下，知识库自己开口答疑。知识管理员从"搬运工"升级为"甩手掌柜"，就是这么简单。

（温馨提示：本文内容可以直接丢给智能体，让智能体一次性逐步安装和使用）

一、痛点吐槽：管知识库有多累？

身为企业 IT / 知识管理员，你肯定经历过这些"九九八十一难"……

点击马拉松：建空间点 5 下、建文件夹点 3 下、建一篇文档再点 4 下。一个季度下来，鼠标点击次数比写的字还多。
搬运工噩梦：几百篇历史 FAQ 散落在本地 Word / Markdown 里，要搬进钉钉知识库？复制粘贴到天荒地老，格式还经常翻车。
权限苦差：新同事入职要加权限、转岗要改角色、离职要移除。逐个空间点进去操作，漏一个就是安全隐患。
知识沉睡：库是建好了，可同事还是习惯私聊问你"VPN 又连不上了怎么办"。知识库躺着吃灰，你继续当人肉客服。😭

今天，DWS（DingTalk Workspace CLI）闪亮登场！🌟

你不需要写一行代码，只要在终端敲几行命令，知识库的"建、搬、管、用"全链路一次搞定。更香的是：搭好的知识库可以直接挂到钉钉机器人上，让知识自己开口答疑。

二、DWS 是个啥？知识库的"遥控指挥中心"

DWS 是钉钉能力的原子化封装，把复杂的 OpenAPI 打包成简单指令。管知识库这件事，主要靠它的"三驾马车"：

命令族	能干什么
🗂️ `dws wiki`	知识库空间、目录节点、成员权限的全生命周期管理
📄 `dws doc`	文档内容读写、本地文件批量导入、模板套用
📁 `dws drive`	钉盘文件上传下载、全局搜索、归档备份

你可以把它想象成知识库的"遥控指挥中心" 🎮——既能你手动按（终端敲命令，比点界面快 10 倍），也能让 AI 帮你按（Claude Code、Qoder 等智能体直接听懂并调用）。

适合谁用：

企业 IT / 知识管理员：批量建库、批量导入、批量管权限，脚本化解放双手
开发者 / AI 玩家：把知识库挂到机器人上，打造 24 小时答疑小能手
重度钉钉用户 / 效率党：一条命令搜全库，比在界面里翻目录快得多

三、搭好的知识库能帮你做什么？

场景	玩法
🛟 IT 服务台 FAQ 库	VPN、邮箱、打印机常见问题集中沉淀，机器人自动答疑
📜 制度流程库	报销、请假、采购制度批量导入，全文秒搜
🎓 新人上岗手册	按部门建目录，入职即授权限，自助通关
🤖 知识库 + 机器人	`--knowledge-source wiki:<spaceId>` 一挂，群里 @ 它就答

所想即所得，拒绝画饼，直接上菜！🍽️

四、5分钟倒计时，搭好你的团队知识库

以下命令全部经过真实环境跑通验证，放心照抄。

0. 安装并登录 DWS（约 1 分钟）

把以下指令复制给你的智能体（Claude Code、Qoder、Codex 等）执行，或手动在终端跑：

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install.sh | sh

Windows（PowerShell）：

irm https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install.ps1 | iex

dws auth login

【截图位：dws auth status 显示 token_valid: true】

1. 建一个知识库空间（10 秒）

dws wiki space create --name "IT服务台知识库" --desc "IT 常见问题与制度流程"

返回里的 workspaceId 就是空间的身份证号，后面每步都要用它。

【截图位：返回 workspaceId 与 spaceUrl】

2. 搭目录结构（20 秒）

知识库的结构 = 文件夹节点 + 文档节点。先建分类文件夹：

dws wiki node create --workspace <workspaceId> --name "常见问题FAQ" --type folder
dws wiki node create --workspace <workspaceId> --name "制度流程" --type folder

在文件夹下建一篇空文档（不加 --folder 就建在根目录）：

dws wiki node create --workspace <workspaceId> --name "VPN连接失败排查指南" --folder <文件夹nodeId>

3. 批量导入历史文档（1 分钟，重头戏！）

几百篇本地 FAQ 不用复制粘贴，doc import 直接整批灌进知识库，Word、Excel、Markdown、txt 通吃：

# 单篇导入到指定文件夹
dws doc import --file ./vpn-faq.md --workspace <workspaceId> --folder <文件夹nodeId> --name "VPN连接失败排查指南"

# 批量导入整个目录（bash 一把梭）
for f in ./faq/*.md; do
  dws doc import --file "$f" --workspace <workspaceId> --folder <文件夹nodeId>
done

已有在线文档想补内容？Markdown 直接写入：

dws doc update --node <文档nodeId> --content-file ./补充内容.md --mode append

【截图位：终端批量导入的滚动输出 + 知识库里齐刷刷的文档列表】

4. 配权限：把人拉进来（30 秒）

# 先用通讯录查到同事的 userId
dws contact user search --query "张三"

# 加为编辑者（--users 支持逗号分隔批量加）
dws wiki member add --workspace <workspaceId> --users <userId1>,<userId2> --role EDITOR

# 随时盘点成员
dws wiki member list --workspace <workspaceId>

5. 验收：搜一下，秒级命中（10 秒）

# 库内全文搜索
dws wiki node search --workspace <workspaceId> --query "VPN"

# 全局搜知识库空间
dws wiki space search --query "IT服务台"

【截图位：搜索结果命中文档标题】

6. 封神一步：挂到机器人上，知识自己开口答疑（30 秒）

如果你已经按《5分钟抱走你的嘴替机器人》建好了钉钉机器人，只需加一个参数：

dws dev connect --channel claudecode \
  --robot-client-id <你的机器人ID> --robot-client-secret <你的机器人密钥> \
  --knowledge-source wiki:<workspaceId>

机器人会自动从知识库拉取知识并缓存。同事在群里 @ 它问"VPN 连不上怎么办"，它直接引用你刚导入的排查指南回答——你，终于不用当复读机了。😎

五、进阶使用技巧

知识库管理速查表

操作	命令
列出我的个人空间	`dws wiki space list --type myWikiSpace`
列出组织知识库	`dws wiki space list --type orgWikiSpace`
浏览库内节点树	`dws wiki node list --workspace <ID> [--folder <nodeId>]`
移动 / 复制节点	`dws wiki node move` / `dws wiki node copy`
改成员角色	`dws wiki member update --users <UID> --role VIEWER`
移除成员	`dws wiki member remove --users <UID>`
删除整个空间	`dws wiki space delete --workspace <ID>`（进回收站，可恢复）

老手避坑指南 ⛳

建在线表格用 --type axls，asheet 服务端不支持，别踩坑。
member list 只返回姓名和角色、不返回 userId；要串联 update / remove，先用 dws contact user search --query "<姓名>" 反查。
搜索关键词的 flag 是 --query，--keyword 是遗留别名，新脚本请用 --query。
所有命令加 --format json，配合 --jq 过滤字段，写脚本时稳得一批。
破坏性操作（删空间、覆盖写文档）前加 --dry-run 先预览，确认无误再执行。

让机器人答得更好

开关	作用
`--knowledge-source wiki:<spaceId>`	从钉钉知识库拉知识作为答疑来源（本文主角）
`--knowledge-dir <目录>`	挂本地 .md/.txt 知识目录，可与上面并存
`--allowed-groups / --allowed-users`	白名单，只让指定群或人触发
`--daemon`	后台常驻，关掉终端也不断线

六、更多 DWS 官方信息

钉钉 CLI 官网：https://open.dingtalk.com/dingtalk-cli
开源仓库：https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli
上一篇姊妹篇：《5分钟抱走你的嘴替机器人：启动钉钉DWS，你值得拥有》

七、欢迎加入交流群

【截图位：DWS 交流群二维码】

8.6 KiB Raw Permalink Blame History Unescape Escape