expert-writing-asmcp — 专家级编写-ASMCP

安全与排障文档（必读） 配置/Token 管理 → 本文件「🚀 首次配置」章节 错误排查 → references/troubleshooting.md 安全约束与审计 → SECURITY.md

Expert Writing ASMCP - 专家写作助手 基于 AnyShare ASMCP 的全文写作工具，采用「大纲 → 确认 → 正文」两阶段流程。

🚀 首次配置 术语说明 术语 含义 Access Token AnyShare 用户访问令牌，用于 API 身份认证 source_ranges 写作引用的源文档范围，格式为 [{"id":"短ID","type":"doc"}] skill_name 写作技能标识：__全文写作__3（大纲）、__大纲写作__1（正文）

Step 1: 配置 MCP 服务与 Token 本技能依赖 anyshare-asmcp MCP 服务，Token 须预先配置到 ~/.openclaw/workspace/config/mcporter.json： { "mcpServers": { "anyshare-asmcp": { "type": "Streamable", "url": "https://anyshare.aishu.cn/asmcp/", "headers": { "Authorization": "Bearer " } } } } 获取 Token：登录 AnyShare Web → 右上角头像 → MCP授权凭证 → 复制令牌。

Step 2: 验证连通性 mcporter call anyshare-asmcp.doc_lib_owned 返回文档库列表即表示认证成功。

Step 3: 配置 OpenClaw 运行时超时（必须） 正文生成为长耗时调用，必须在 ~/.openclaw/config.toml 中配置超时： [skills.entries.expert-writing-asmcp] env.MCPORTER_CALL_TIMEOUT = "300000" # 5 分钟，毫秒 或使用 gateway config.patch： { "skills": { "entries": { "expert-writing-asmcp": { "env": { "MCPORTER_CALL_TIMEOUT": "300000" } } } } }

⚠️ 核心流程约束 大纲确认规则 场景 处理方式 用户确认大纲 进入生成正文阶段 用户要求修改大纲 1. 修改大纲内容 2. 保存为"大纲v2.md" 3. 展示给用户确认 4. 等待用户明确确认 5. 才能写正文 用户说"可以了"/"没问题" 必须用户说"确认，开始写正文"才算确认 5分钟无响应 自动进入写正文环节（不再等待）

关键原则 大纲确认后才能写正文 - 必须得到用户明确回复"确认，开始写正文" 修改大纲必须重新确认 - 任何大纲调整都需要新版大纲+用户确认 大纲微调≠重新生成 - 只修改用户要求的内容，其他章节保持不变 超时自动执行 - 展示大纲后等待5分钟，如用户无操作则自动进入写正文

⚠️ 关键经验总结（2026-05-08 更新）

• 正文生成技能区分

任务 技能 times 说明 生成大纲 __全文写作__3 times=0 基于模板生成章节结构 生成正文 __大纲写作__1 times=1 基于大纲生成完整正文内容 重要：生成正文必须用 __大纲写作__1 + times=1，不要用 __全文写作__3（它会把正文需求也输出成提纲"本节将..."格式）

• 超时问题

默认超时：mcporter 默认 60000ms（60秒），完整正文生成会超时 解决方案：调用时必须加 --timeout 180000（180秒）或设置环境变量 MCPORTER_CALL_TIMEOUT=300000 示例：mcporter call ... --timeout 180000

• source_ranges JSON 格式

格式必须严格为：[{"id":"短ID","type":"doc"}] 如果 JSON 格式不正确，会报错：cannot unmarshal string into Go struct 建议使用 Python 脚本构建参数，避免 shell 转义问题

• selection 传大纲内容

生成正文时，selection 参数传入大纲完整内容 大纲内容较长时，建议通过文件读取后传递给脚本（避免 shell 特殊字符冲突）

• 建议的 Python 脚本方式

复杂参数（大纲内容、超长 query）建议用 Python 构建脚本，避免 shell 转义问题： # 保存大纲内容到文件 python3 -c "import json; print(json.load(open('/tmp/template_outline.json')).get('document_content',''))" > /tmp/selection.txt # 通过文件传递 nohup bash -c 'mcporter call ... selection:"$(cat /tmp/selection.txt)" skill_name:__大纲写作__1 times:1 --timeout 180000' &

使用流程 用户：帮我写个技术总结，基于这些项目资料 ↓ 系统：请上传项目文件或提供文件路径 ↓ 用户：[上传文件：技术方案.docx, 会议纪要.pdf] ↓ 系统：📤 上传中... ⏳ 等待索引... ✅ 完成 ↓ 系统：📄 获取内置写作模板... ↓ 系统：🔍 正在生成大纲文档... ↓ 系统： ┌─────────────────────────────────────┐ │ 📄 大纲已生成并保存 │ │ 位置：文档库/写作成果/ │ │ 2025-04-22/技术总结/ │ │ 大纲.md │ │ │ │ 内容预览： │ │ 1. 项目背景 │ │ 2. 技术方案概述 │ │ 3. 实施过程 │ │ 4. 成果与总结 │ └─────────────────────────────────────┘ 请确认大纲，如需修改请告诉我 ↓ 用户：确认，开始生成正文 ← 5分钟内确认 ↓ 或：5分钟后无响应 → 自动进入写正文 ↓ 系统：✍️ 正在基于大纲生成正文（使用 __大纲写作__1 + times:1）... ↓ 系统： ✅ 写作完成 📄 大纲：写作成果/2025-04-22/技术总结/大纲.md 📄 正文：写作成果/2025-04-22/技术总结/正文.md 📁 原文：写作成果/2025-04-22/技术总结/参考资料/ 🔗 分享链接：https://anyshare.aishu.cn/link/xxx

模板配置 技能支持两种大纲生成方式： 优先级 模板类型 来源 说明 优先 内置模板 API 获取 调用 __全文写作__3 内置模板接口，基于模板结构生成大纲 备用 无模板 直接生成 直接基于项目资料和query生成大纲

方式一：API 获取内置模板（推荐） # 获取内置全文写作模板 curl -s -X GET \ "https://anyshare.aishu.cn/api/intelli-search/v1/skills/templates/default?skill_name=__全文写作__3" \ -H "authorization: $ACCESS_TOKEN" \ -H "content-type: application/json" > /tmp/template_response.json TEMPLATE_CONTENT=$(python3 -c "import json; print(json.load(open('/tmp/template_response.json')).get('template',''))") if [ -z "$TEMPLATE_CONTENT" ]; then echo "⚠️ API获取模板失败，使用直接生成方式" else echo "✅ 使用内置模板（API获取），${#TEMPLATE_CONTENT} 字符" fi

目录结构设计 文档库/ ├── 写作成果/ ← 主目录（复用已存在的） │ └── 2025-04-22/ ← 日期目录（每天新建） │ └── 项目名称/ ← 项目专属目录 │ ├── 参考资料/ ← 上传的原始文件 │ │ ├── 技术方案.docx │ │ └── 会议纪要.pdf │ ├── 大纲.md ← 生成的大纲 │ └── 正文.md ← 生成的正文 └── ...

MCP Tool 调用详解

• smart_assistant (大纲生成: __全文写作__3 / 正文生成: __大纲写作__1