# 连接钉钉（文档 / 表格）：浏览器里选组织、确认

工坊要读写钉钉文档、在线表格（写报告进钉钉文档、读资料导入知识库、记录去处），**用的是你本人的钉钉账号**。

## 怎么连

1. 打开「连接」页，找到**钉钉文档 / 表格**，点**连接钉钉**。第一次点，工坊会先在本机准备好钉钉官方的命令行工具（`dws`，下载一次，卡上有进度）。
2. 浏览器会自动打开钉钉的授权页（打不开就点卡上的「打开链接」，或用手机钉钉扫卡上的二维码），**选你的组织，确认**。
3. 确认完不用回来点任何按钮，卡会自己变成**已连接**，显示你的名字和组织。

只认**已经加入组织（企业 / 团队）**的钉钉账号，纯个人账号连不上。

## 组织第一次用：请管理员开通

组织的 CLI 权限默认关着，要**组织主管理员**用自己的账号登录钉钉开发者后台 open-dev.dingtalk.com，打开两个开关：

1. 「CLI 设置」→ 打开「允许成员通过 CLI 访问个人数据」；
2. 「Agent 管理」→ 渠道里打开「其他渠道」（Agents 工坊算「其他渠道」）。

你不是管理员：连的时候钉钉页面上点「立即申请」，管理员会收到一张审批卡，一键同意后回工坊再点一次「连接钉钉」。

> 这两个开关的名字和位置是照钉钉官方文档写的，还没在真组织后台里核对过；对不上请告诉我们。

## 写进钉钉是什么样

- 不给链接：新建一篇，放在你自己的「我的文档」里；给一个文件夹链接就建在文件夹里。
- 给一篇已有文档的链接：同一份报告再写，**整篇换成新内容**。这只经官方工具做，**不会用浏览器去改已有的文档**；写完工坊会回读一次，发现没换干净会告诉你。
- 分享短链（`/i/p/` 开头的）官方工具认不了，请给文档本身的链接。

## 断开 / 换账号

点卡上的**断开**，工坊会退出这个品牌的钉钉授权，已经写好的文档不动。**换账号** = 断开后再连一次。