youmind

TotalClaw 作者 totalclaw
当用户需要通过 API 进行 Youmind 板操作（列出/查找/创建板、添加链接/文件、聊天、生成图像/幻灯片/文档、提取工件）时，请使用此技能。浏览器仅用于身份验证引导/刷新。
安装 / 下载方式

TotalClaw CLI推荐
totalclaw install totalclaw:totalclaw~p697-youmind
cURL直接下载，无需登录
curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~p697-youmind/file -o p697-youmind.md
# Youmind API Skill (API-Only Runtime)

Use HTTP APIs for business operations. Do not use browser fallback for board/material/chat actions.

## Runtime Rules

- API-only for boards, materials, chat, and artifact extraction.
- Browser automation is only allowed for auth bootstrap/refresh (`auth_manager.py`).
- For board-scoped commands, prefer `--board-id`; `--board-url` is also supported in material/chat/artifact/wrapper commands.

## Authentication

```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
```

## Board Commands

```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 <board-id>

python3 scripts/run.py board_manager.py create --name "My Board"
python3 scripts/run.py board_manager.py create --name "My Board" --prompt "Initialize this board for AI coding agent research"
```

## Material Commands

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

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

python3 scripts/run.py material_manager.py get-snips --ids "<snip-id-1>,<snip-id-2>"

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

## Chat Commands

```bash
python3 scripts/run.py chat_manager.py create --board-id <board-id> --message "Summarize key ideas"

python3 scripts/run.py chat_manager.py send --board-id <board-id> --chat-id <chat-id> --message "Give next steps"

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

python3 scripts/run.py chat_manager.py generate-image --board-id <board-id> --prompt "Minimal blue AI poster"
python3 scripts/run.py chat_manager.py generate-slides --board-id <board-id> --prompt "6-page AI coding agent roadmap"
python3 scripts/run.py chat_manager.py create --board-id <board-id> --message "Write a 1-page product brief"
```

## Artifact Extraction

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

Extraction semantics:
- `image_generate`: returns image URLs and `media_ids`.
- `slides_generate`: returns per-slide image URLs and `media_ids` (no direct `.pptx` file URL currently).
- `write`: returns `page_id`, preview content, and optional raw doc content with `--include-raw-content`.

## Compatibility Wrapper

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

## Local Data

Local auth state:

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

Do not commit `data/`.

---

## 中文说明

# Youmind API Skill（仅 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 <board-id>

python3 scripts/run.py board_manager.py create --name "My Board"
python3 scripts/run.py board_manager.py create --name "My Board" --prompt "Initialize this board for AI coding agent research"
```

## 素材命令

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

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

python3 scripts/run.py material_manager.py get-snips --ids "<snip-id-1>,<snip-id-2>"

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

## 聊天命令

```bash
python3 scripts/run.py chat_manager.py create --board-id <board-id> --message "Summarize key ideas"

python3 scripts/run.py chat_manager.py send --board-id <board-id> --chat-id <chat-id> --message "Give next steps"

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

python3 scripts/run.py chat_manager.py generate-image --board-id <board-id> --prompt "Minimal blue AI poster"
python3 scripts/run.py chat_manager.py generate-slides --board-id <board-id> --prompt "6-page AI coding agent roadmap"
python3 scripts/run.py chat_manager.py create --board-id <board-id> --message "Write a 1-page product brief"
```

## 工件提取

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

提取语义：
- `image_generate`：返回图像 URL 和 `media_ids`。
- `slides_generate`：返回每张幻灯片的图像 URL 和 `media_ids`（当前没有直接的 `.pptx` 文件 URL）。
- `write`：返回 `page_id`、预览内容，以及使用 `--include-raw-content` 时的可选原始文档内容。

## 兼容性包装器

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

## 本地数据

本地身份验证状态：

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

请勿提交 `data/`。