用途
该技能面向最基础的“从内容生成在线 page 文档”场景：用户给出主题、文本或要点后，由模型生成 markdown，再通过 clouddocs-cli 一次性创建在线 page 文档并交付链接，最后通过导出能力把在线文档转为本地 docx 作为离线交付物。它从 slide 技能裁剪而来，只保留全新创建、导出收尾与幂等断点这三项能力，不包含单块编辑、模板、批量等扩展功能。
主要能力与流程
核心链路是“生成 markdown → 一次创建 → 导出 docx”，全程一条主链路，无分阶段渲染：
- 生成：模型根据用户原始需求构造 markdown，写入
<项目工作目录>/drafts/page.md，内容规范参考 references/page-content.md。文档标题取自内容主题，# <标题>首行与--title一致；需覆盖用户全部要点，禁止连续重复空行与编造数据；若内容超过 CLI 参数上限（约 30KB），提示用户分段或精简。 - 创建：
create_page.py读取 markdown，经clouddocs-cli page +create --title <t> --content <c> [--format 1]一次创建在线 page 文档，落 created_doc.json 锚点，返回 doc_id 与 doc_url。organization_id / wiki_id 由 CLI 自动解析（个人空间 + 默认文档库），可用--parent-document-id建到指定父文档。 - 交付：将 doc_url（
{base}/wapp/doc/<docId>）交给用户；创建成功后不主动打开文档链接。 - 导出：等待 10 秒后，用
clouddocs-cli file +export --document_id <doc_id> --export_type word把在线文档导出为 docx 存到本地交付目录。
使用方式
前置检查包括：CLI 已安装（command -v clouddocs-cli，Windows 使用 where / Get-Command），未安装时按 bin/cli-installation-guide.md 的安装子技能完成安装（仅支持 Windows）；认证状态为 ready，否则用两步走设备授权（auth login --no-wait --json 取 verification_url 与 device_code，后台运行 auth login --device-code <device_code> 自动感知授权）；服务地址通过 clouddocs-cli config init --host <url> 或 ~/.clouddocs/config.json 配置。
创建命令示例：
cd <项目工作目录>
python3 <技能基目录>/scripts/create_page.py --title '<按主题命名的文档标题>'
可选参数：--content '<markdown 文本>' 不走文件；--parent-document-id '<父文档ID>' 建到指定父文档；--dry-run 预览请求不发网络；--drafts-dir '<自定义目录>' 指定草稿目录（默认 ./drafts）。退出码含义：0 创建成功，1 参数或前置缺失，2 鉴权/网络失败（应停下报用户，不反复重试，可先 --probe-auth 排查）。
导出示例：
sleep 10
clouddocs-cli file +export \
--document_id '<doc_id>' \
--export_type word \
--file_name '<按主题命名>' \
--output '<本地保存目录或全路径>'
导出失败最多重试一次（间隔 10 秒），仍失败则放弃导出、只交付链接；--output 目标目录需已存在，否则会被当作全路径文件写入。
适用场景
适用于需要快速把主题、文本或要点转成在线 page 文档并附带本地 docx 副本的单次创建任务，例如日常内容整理、文档初稿生成与离线归档。
限制与约束
- 只保留全新创建链路，不包含单块编辑、模板、批量等能力。
- 建文档只走 clouddocs-cli（经共享适配层 scripts/_hws_cli.py 调 CLI），禁止脚本直连后端 HTTP，禁止绕过
create_page.py直接调用page +create或手写脚本调用后端 API。 - created_doc.json 只能由 create_page.py 落盘，模型与协调器不得手写覆盖；锚点已存在时重跑只返回结果、绝不重复建文档。
- drafts 中间产物（page.md / created_doc.json / page.kpge）一律落在项目工作目录，禁止写入技能安装目录或技能源码目录。
- 内容优先直传 markdown，仅当后端明确拒绝 markdown 时按规范改用 block JSON 兜底。
- 向用户只输出“正在生成文档内容…”“文档已创建：<链接>”“本地Word：<本地路径>”或简洁错误说明，内部状态（技能名、脚本名、文件路径、doc_id、接口返回原文等）不对外呈现；收尾只报本地文件路径。
- 运行时依赖 clouddocs-cli 可执行文件，需已安装、已登录并配置服务地址；脚本仅使用 Python 3.8+ 标准库，无第三方依赖。
- 资料未提供该技能的收费、价格、性能指标与更细的平台支持范围。