Feishu MCP Doc Write Stable

Feishu MCP Stable Writer

Use this workflow to keep Feishu MCP doc output readable and deterministic.

Rules

1. Always use Feishu MCP (mcporter call lark.*) for create/update/read in this flow.
2. Never pass markdown as escaped \\n text.
3. Always send real multiline markdown.
4. Always run fetch-doc after write and verify structure.

Standard Flow

1. Draft content in chat and get user confirmation.
2. Create doc (or use given doc URL).
3. Write/update with real multiline markdown.
4. Read back and verify headings/lists/order.
5. Report concise result + doc URL.

Command Patterns

A) Create doc

mcporter call lark.create-doc \
  title='文档标题' \
  wiki_space='my_library' \
  markdown='# 占位\n\n准备写入' \
  --output json

B) Safe overwrite with real multiline markdown

cat > /tmp/doc.md <<'MD'
# 标题

## 1. 背景
正文

## 2. 目标
- A
- B
MD

python3 - <<'PY'
import json, shlex, subprocess
from pathlib import Path
md = Path('/tmp/doc.md').read_text()
args = json.dumps({
  'doc_id': 'https://www.feishu.cn/wiki/xxxxx',
  'mode': 'overwrite',
  'markdown': md
}, ensure_ascii=False)
cmd = f"mcporter call lark.update-doc --args {shlex.quote(args)} --output json"
print(subprocess.check_output(cmd, shell=True, text=True))
PY

C) Append + precise replace

mcporter call lark.update-doc doc_id='https://www.feishu.cn/wiki/xxxxx' \
  mode='append' \
  markdown='## 新章节
内容' \
  --output json

mcporter call lark.update-doc doc_id='https://www.feishu.cn/wiki/xxxxx' \
  mode='replace_range' \
  selection_with_ellipsis='## 2. 目标...- B' \
  markdown='## 2. 目标
- A（修订）
- B（修订）
- C（新增）' \
  --output json

Validation Checklist

• fetch-doc output does not contain literal \\n in body text.
• Heading hierarchy is preserved.
• Lists render as lists (not plain joined text).
• No missing section after update.

Failure Handling

• If selection_by_title fails, use fetch-doc then switch to selection_with_ellipsis.
• If format drifts, rebuild markdown in /tmp/*.md and overwrite once.
• If permissions fail, confirm MCP URL/auth and retry with same user identity.