popo-doc-manage
SKILL.md
POPO 文档管理
🔴 硬规则（必须严格遵守）
- 禁止 API 替代：所有文档操作必须通过浏览器 MCP 完成，不得用 API
- 脚本路径查找：必须使用智能查找，禁止硬编码路径
- ⚠️ 禁止等待新页面：
- 点击 Markdown 后 禁止调用 list_pages
- 点击 Markdown 后 禁止等待新标签页
- 新文档直接出现在当前页面的目录列表末尾
- 正确做法：click(Markdown) → take_snapshot() → 从末尾找"未命名Markdown"
- 从后往前找：搜索"未命名Markdown"时从快照末尾开始，选时间最近的（"刚刚"或"–"）
快速开始
脚本目录查找
SKILL_DIR=""
for b in ~/.codemaker/skills ~/.claude/skills; do
[ -f "$b/popo-doc-manage/scripts/popo-notify.js" ] && SKILL_DIR="$b/popo-doc-manage/scripts" && break
done
[ -z "$SKILL_DIR" ] && echo "❌ 未找到脚本目录" || echo "✅ $SKILL_DIR"
配置检查
cat ~/.popo-config.json
必需字段：email, password（或 Cookie 有效时可省略）
操作分类
| 操作 | 详情参考 |
|---|---|
| 读取文档 | references/operations.md |
| 写入/更新/删除 | references/operations.md |
| 登录流程 | references/login.md |
| 发送通知 | references/notify.md |
| 常见问题 | references/troubleshooting.md |
核心流程速览
读取文档
navigate_page(url) → take_snapshot() → 提取内容
写入文档
1. navigate_page(目录URL)
2. click("新建子节点") → click("Markdown")
3. take_snapshot() → 【不等新页面】直接从末尾找"未命名Markdown"
4. click(刚创建的文档) → 进入编辑
5. click(编辑区) → type_text(内容)
6. 双击重命名
注意：点击 Markdown 后不会打开新标签页，新文档直接出现在当前目录列表最后
发送通知
cd $SKILL_DIR && node popo-notify.js --type write --title "标题" --url "链接" -g "群号"
UI 元素定位技巧
"更多"按钮（...）
紧跟在"分享&权限"后面的 image 元素：
uid=XX StaticText "分享&权限"
uid=YY image ← 这就是"更多"
"未命名Markdown"
- 新创建的在目录树最后面
- 搜索时从快照末尾开始，选择 uid 数字最大的
示例
MCP 异常恢复
pkill -f "chrome-devtools-mcp" 2>/dev/null; sleep 2
然后重新调用 list_pages() 测试连接。