修雨
2c10be2a1a
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.
204 lines
8.6 KiB
Markdown
204 lines
8.6 KiB
Markdown
# 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：
|
||
|
||
```bash
|
||
curl -fsSL https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install.sh | sh
|
||
```
|
||
|
||
Windows（PowerShell）：
|
||
|
||
```powershell
|
||
irm https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install.ps1 | iex
|
||
```
|
||
|
||
登录（提示授权请扫码）：
|
||
|
||
```bash
|
||
dws auth login
|
||
```
|
||
|
||
【截图位：dws auth status 显示 token_valid: true】
|
||
|
||
### 1. 建一个知识库空间（10 秒）
|
||
|
||
```bash
|
||
dws wiki space create --name "IT服务台知识库" --desc "IT 常见问题与制度流程"
|
||
```
|
||
|
||
返回里的 `workspaceId` 就是空间的身份证号，后面每步都要用它。
|
||
|
||
【截图位：返回 workspaceId 与 spaceUrl】
|
||
|
||
### 2. 搭目录结构（20 秒）
|
||
|
||
知识库的结构 = 文件夹节点 + 文档节点。先建分类文件夹：
|
||
|
||
```bash
|
||
dws wiki node create --workspace <workspaceId> --name "常见问题FAQ" --type folder
|
||
dws wiki node create --workspace <workspaceId> --name "制度流程" --type folder
|
||
```
|
||
|
||
在文件夹下建一篇空文档（不加 `--folder` 就建在根目录）：
|
||
|
||
```bash
|
||
dws wiki node create --workspace <workspaceId> --name "VPN连接失败排查指南" --folder <文件夹nodeId>
|
||
```
|
||
|
||
### 3. 批量导入历史文档（1 分钟，重头戏！）
|
||
|
||
几百篇本地 FAQ 不用复制粘贴，`doc import` 直接整批灌进知识库，Word、Excel、Markdown、txt 通吃：
|
||
|
||
```bash
|
||
# 单篇导入到指定文件夹
|
||
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 直接写入：
|
||
|
||
```bash
|
||
dws doc update --node <文档nodeId> --content-file ./补充内容.md --mode append
|
||
```
|
||
|
||
【截图位：终端批量导入的滚动输出 + 知识库里齐刷刷的文档列表】
|
||
|
||
### 4. 配权限：把人拉进来（30 秒）
|
||
|
||
```bash
|
||
# 先用通讯录查到同事的 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 秒）
|
||
|
||
```bash
|
||
# 库内全文搜索
|
||
dws wiki node search --workspace <workspaceId> --query "VPN"
|
||
|
||
# 全局搜知识库空间
|
||
dws wiki space search --query "IT服务台"
|
||
```
|
||
|
||
【截图位：搜索结果命中文档标题】
|
||
|
||
### 6. 封神一步：挂到机器人上，知识自己开口答疑（30 秒）
|
||
|
||
如果你已经按《5分钟抱走你的嘴替机器人》建好了钉钉机器人，只需加一个参数：
|
||
|
||
```bash
|
||
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 交流群二维码】
|
||
|
||
遇到问题来群里喊一声，官方同学在线答疑。下一篇想看什么？批量备份知识库？给知识库做权限审计？留言区点菜！🍻
|