---
name: qiwei-official-doc
description: 通过企业微信官方 CLI 创建普通文档、读取或覆写 Markdown，并将真实企微文档沉淀到本地知识库后逐篇生成 AI 摘要、要点、决策和待办候选。适用于创建企微文档、读取 doc.weixin.qq.com/doc/ 链接、文档知识归档和 AI 文档分析；在线表格、智能表格和智能文档应路由到对应方法。
---

# 企业微信官方普通文档

本技能只处理 URL 形如 `https://doc.weixin.qq.com/doc/*` 的普通文档，通过 `qiwei_official_*` MCP 工具调用官方 CLI。

以下类型不由本技能直接处理：

| URL | 类型 |
|---|---|
| `/sheet/*` | 在线表格 |
| `/smartsheet/*` | 智能表格 |
| `/smartpage/*` | 智能文档 |

## 前置检查

1. 调用 `qiwei_official_status`；
2. 未安装时调用 `qiwei_official_prepare`；
3. 未初始化时停止业务调用，把返回的初始化命令交给用户完成扫码；
4. 调用 `qiwei_official_help` 核对当前方法参数。

## 支持的方法

| 意图 | category | method |
|---|---|---|
| 创建普通文档 | `doc` | `create_doc` |
| 读取 Markdown 内容 | `doc` | `get_doc_content` |
| 用 Markdown 覆写正文 | `doc` | `edit_doc_content` |

## 创建文档

创建普通文档时：

```json
{
  "category": "doc",
  "method": "create_doc",
  "args": {
    "doc_type": 3,
    "doc_name": "项目周报"
  }
}
```

`create_doc` 只创建空白文档。用户同时给出正文时，创建成功后再调用 `edit_doc_content` 写入 Markdown。返回 `docid` 和 URL。

## 读取内容

使用 `docid` 或 URL 二选一定位，`type` 固定为 `2`：

```json
{
  "docid": "DOC_ID",
  "type": 2
}
```

读取是异步任务：

1. 首次不传 `task_id`；
2. `task_done=false` 时保存返回的 `task_id`；
3. 携带同一 `task_id` 继续调用；
4. `task_done=true` 后返回完整 Markdown 内容。

## 覆写正文

`edit_doc_content` 会替换全部正文，参数中的 `content_type` 固定为 `1`。

执行前：

1. 如果用户未明确要求覆盖，先读取现有内容；
2. 说明该操作会替换全部正文；
3. 展示变更摘要并取得确认；
4. 再调用：

```json
{
  "category": "doc",
  "method": "edit_doc_content",
  "args": {
    "docid": "DOC_ID",
    "content": "# 新正文",
    "content_type": 1
  }
}
```

## 文档知识沉淀

在 4320 Dashboard 的“知识库 → 企微文档知识沉淀 → 文档工作台”中执行：

1. 创建普通文档并写入 Markdown，或用 docid/链接读取已有文档；
2. 对 `get_doc_content` 返回的异步任务持续使用同一 `task_id`，完成后再保存；
3. 将真实文档原文、docid、链接和同步时间写入 `outputs/knowledge/docs/`；
4. AI 分析与读取分开，逐篇触发摘要、关键要点、明确决策、风险和有原文证据的待办候选；
5. AI 失败时保留真实原文并标记失败，不补写伪结论。
6. 有原文证据的行动项进入“统一任务中心”的 AI 候选区；只有人工点击确认后才转为正式内部任务，不自动创建企微待办。

## 错误处理

- `851002 incompatible doc type`：重新识别 URL 类型，不要继续用普通文档方法；
- 未初始化：提示官方 CLI 初始化，不调用原有 `qiwei_login_*`；
- 方法或 schema 变化：重新调用 `qiwei_official_help`；
- 不展示机器人 Secret、Authorization 或本地加密配置内容。
- 文档读取权限暂缺时保留已确认成功的创建/写入结果，并允许在工作台重新读取复核；不能把本地写入内容伪装成官方读回结果。