Youmind API 技能（仅 API 运行时）

使用 HTTP API 执行业务操作。对于看板/素材/聊天操作，请勿使用浏览器回退方案。

运行时规则

• - 仅通过 API 操作看板、素材、聊天和制品提取。
• 浏览器自动化仅允许用于认证引导/刷新（auth_manager.py）。
• 对于看板级命令，优先使用 --board-id；在素材/聊天/制品/包装命令中也支持 --board-url。

认证

bash
python3 scripts/run.py auth_manager.py status
python3 scripts/run.py auth_manager.py validate
python3 scripts/run.py auth_manager.py setup
python3 scripts/run.py auth_manager.py reauth
python3 scripts/run.py auth_manager.py clear

看板命令

bash
python3 scripts/run.py board_manager.py list

python3 scripts/run.py board_manager.py find --query roadmap

python3 scripts/run.py board_manager.py get --id

python3 scripts/run.py board_manager.py create --name 我的看板
python3 scripts/run.py board_manager.py create --name 我的看板 --prompt 初始化此看板用于AI编码代理研究

素材命令

bash
python3 scripts/run.py material_manager.py add-link --board-id --url https://example.com
python3 scripts/run.py material_manager.py add-link --board-url https://youmind.com/boards/ --url https://example.com

python3 scripts/run.py material_manager.py upload-file --board-id --file /path/to/file.pdf

python3 scripts/run.py material_manager.py get-snips --ids ,

python3 scripts/run.py material_manager.py list-picks --board-id

聊天命令

bash
python3 scripts/run.py chat_manager.py create --board-id --message 总结关键想法

python3 scripts/run.py chat_manager.py send --board-id --chat-id --message 给出下一步

python3 scripts/run.py chat_manager.py history --board-id
python3 scripts/run.py chat_manager.py detail --chat-id
python3 scripts/run.py chat_manager.py detail-by-origin --board-id
python3 scripts/run.py chat_manager.py mark-read --chat-id

python3 scripts/run.py chat_manager.py generate-image --board-id --prompt 极简蓝色AI海报
python3 scripts/run.py chat_manager.py generate-slides --board-id --prompt 6页AI编码代理路线图
python3 scripts/run.py chat_manager.py create --board-id --message 撰写1页产品简报

制品提取

bash
python3 scripts/run.py artifact_manager.py extract --chat-id
python3 scripts/run.py artifact_manager.py extract-latest --board-id
python3 scripts/run.py artifact_manager.py extract-latest --board-url https://youmind.com/boards/
python3 scripts/run.py artifact_manager.py extract --chat-id --include-raw-content

提取语义：

• - imagegenerate：返回图片 URL 和 mediaids。
• slidesgenerate：返回每张幻灯片的图片 URL 和 mediaids（目前不提供直接的 .pptx 文件 URL）。
• write：返回 page_id、预览内容，以及使用 --include-raw-content 时的可选原始文档内容。

兼容性包装

bash
python3 scripts/run.py ask_question.py --board-id --question ...
python3 scripts/run.py ask_question.py --board-url https://youmind.com/boards/ --question ...
python3 scripts/run.py ask_question.py --board-id --chat-id --question ...

本地数据

本地认证状态：

text
data/
├── auth_info.json
└── browser_state/
└── state.json

请勿提交 data/ 目录。