Arena 研究

面向 Are.na 的通用型智能体研究能力。将任意研究问题拆解为定向搜索任务，探索频道（Channel），沿连接图谱（connection graph）发掘相邻概念，识别关键策展人（curator），深度查阅关联内容，并最终整合生成带来源标注的简报。

如需了解 API 详情（端点、认证方式、响应格式等），请阅读 references/arena-api.md。

何时选用 Arena 而非其他信息源

• Are.na —— 精选参考资料、可视化研究、设计思维、文化分析、阅读清单，以及人们组织思想的方式。信噪比高、人工策展、长尾覆盖广。
• X/Twitter（x-research）—— 实时反应、开发者讨论、产品发布、突发新闻、专家短评。信息流快、数据量大。
• 网页搜索 —— 事实性答案、文档资料、时事动态、特定 URL。

Are.na 是一座图书馆，而非信息喷涌的消防水龙头（firehose）。其价值不仅在于人们保存了什么，更在于他们如何组织这些内容，以及又将它们与哪些其他内容关联起来。

CLI 工具

所有命令均需在此技能目录下运行：

cd ~/clawd/skills/arena-research
source ~/.config/env/global.env

搜索

bun run arena-search.ts search "" [options]

选项说明：

• --type Channel|Block|Text|Image|Link|User|Group —— 按结果类型过滤（默认：全部）
• --sort score|created|updated|connections|random —— 排序方式（默认：score）
• --scope all|my|following —— 搜索范围（默认：all；my/following 需认证）
• --per N —— 每页返回条数（默认：24，上限：100）
• --page N —— 页码
• --quick —— 快速模式：仅返回 10 条结果、缓存时效 1 小时、仅限 Channel 类型、按 connections 排序
• --save —— 保存至 ~/clawd/drafts/arena-research-{slug}-{date}.md
• --json —— 输出原始 JSON 格式
• --markdown —— 输出格式化 Markdown

使用示例：

bun run arena-search.ts search "tools for thought" --type Channel --sort connections
bun run arena-search.ts search "brutalist web design" --quick
bun run arena-search.ts search "cybernetics" --type Link --per 50
bun run arena-search.ts search "spatial computing" --scope my

频道（Channel）

bun run arena-search.ts channel  [options]

选项说明：

• --sort position|created|updated —— 内容排序方式（默认：position）
• --type Text|Image|Link|Attachment|Embed|Channel —— 按内容类型过滤
• --per N / --page N —— 分页控制
• --connections —— 显示与此频道共享 Block 的其他频道（图谱遍历）
• --save / --json / --markdown

使用示例：

bun run arena-search.ts channel arena-influences
bun run arena-search.ts channel arena-influences --type Link --per 50
bun run arena-search.ts channel arena-influences --connections

区块（Block）

bun run arena-search.ts block  [options]

选项说明：

• --connections —— 显示该 Block 所在的所有频道（图谱遍历）
• --json

使用示例：

bun run arena-search.ts block 3235876
bun run arena-search.ts block 3235876 --connections

用户（User）

bun run arena-search.ts user  [options]

选项说明：

• --per N / --page N
• --json

当前用户（Me）

bun run arena-search.ts me

显示已认证用户的个人资料及所属频道。需配置 ARENA_ACCESS_TOKEN。

缓存（Cache）

bun run arena-search.ts cache clear

研究闭环（Agentic）

开展深度研究（而非简单检索）时，请遵循以下闭环流程：

1. 将问题拆解为多种搜索策略

将研究问题转化为 3–5 个从不同角度切入的搜索查询。

尝试从多个抽象层级思考该主题：

• 直接术语：显而易见的关键词（如 spatial computing、brutalist web design）
• 相邻概念：相关领域（如 haptic interfaces、concrete architecture）
• 实践者用语：Are.na 用户实际使用的命名方式（如 tools for thought、digital gardens、vernacular web）
• 上位类目：统摄性主题（如 interaction design、web aesthetics）
• 具体参考项：该领域内已知的作品、人物或项目

建议优先以“连接数”排序获取最高度互联的集合：

bun run arena-search.ts search "tools for thought" --type Channel --sort connections --per 20

2. 执行搜索并评估频道质量

逐一执行各查询。每次搜索后，请评估：

• 哪些频道具备真实深度？ 查看结果中各频道的条目数量。含 2–3 条内容的频道多为占位符（stub）；含 50+ 条的则属于严肃的内容集合。
• 谁是所有者？ 若同一用户或群组反复出现在多个相关频道中，则其为值得深入考察的关键策展人。
• 是否应完整浏览某些频道？ 按内容数量和相关性筛选出前 3–5 个频道。

也可直接搜索 Block 类型以定位特定外部链接内容：

bun run arena-search.ts search "cybernetics" --type Link --sort connections --per 20

3. 深入探索优质频道

对每个有潜力的频道，获取其全部内容：

bun run arena-search.ts channel tools-for-thought --per 50

若仅关注外部链接（对深度研究最具价值）：

bun run arena-search.ts channel tools-for-thought --type Link --per 50

重点关注以下内容类型：

• Link 类型 Block（含 source URL）—— 外部参考资源，适合深度查阅
• Text 类型 Block（含 content 字段）—— 笔记、批注或原创文字
• Image 类型 Block —— 关注标题与描述，文本型研究中可酌情降级处理
• 嵌套频道（type: Channel） —— 值得进一步探索的子集合

4. 沿连接图谱拓展探索

这是 Are.na 研究最具独特性的能力。包含两种策略：

4a. Block 连接 —— “该内容还存在于哪些地方？”

针对高价值 Block（如高质量链接、描述详尽的文字），查看其出现于哪些其他频道中：

bun run arena-search.ts block 3235876 --connections

一个 Block 出现在 28 个频道中，意味着有 28 位不同用户认为它值得收藏。这些频道展现了不同人对该同一概念的差异化语境构建方式。

4b. 频道连接 —— “与该集合相邻的是什么？”

对已确认为高质量的频道，查找与其共享 Block 的其他频道：

bun run arena-search.ts channel arena-influences --connections

这将揭示概念邻域（conceptual neighbors）—— 即与你当前探索频道共享 Block 的其他频道。例如，“tools for thought” 频道可能关联到 “cybernetics”、“memory palaces” 和 “personal knowledge management” 等频道。

图谱深度建议： 一跳（one hop）即为最佳平衡点。“Block → connections → those channels” 已足够。两跳会迅速导致指数级爆炸增长；除非有明确目标，否则请止步于一跳。

5. 识别关键策展人

在探索过程中，持续追踪高频出现的用户：

• 同一用户拥有多个相关频道
• 同一用户将多个 Block 关联至你已探索的若干频道
• 在该领域拥有高关注数（followers）的用户

获取其资料与频道列表：

bun run arena-search.ts user charles-broskoski

6. 深度查阅关联内容

当 Block 类型为 Link 且带有 source URL 时，使用 web_fetch 获取其实际内容。优先选择以下链接：

• 出现在大量频道中（来自步骤 4a 的高 connection count）
• 源自条目数量多或粉丝数高的频道
• 指向文章、博客、GitHub 仓库、学术论文或技术文档
• 与研究问题直接相关

以下类型内容建议跳过深度查阅：

• 社交媒体帖子（请改用 x-research）
• 图片画廊或作品集
• 付费墙内容（paywalled content）
• 失效链接（检查 state 字段 —— available 表示链接有效）

7. 检索自有收藏

若需查找自己曾保存的内容：

bun run arena-search.ts search "query" --scope my

或检索你关注的用户所发布的内容：

bun run arena-search.ts search "query" --scope following

8. 综合归纳

按主题（theme）归类发现，而非按搜索词归类。每个主题应涵盖一组具有概念关联性的频道、Block 与策展人。

### [主题/发现标题]

[1–2 句摘要：说明策展人正在收集什么内容，以及他们如何为其定性]

**核心频道：**
- [频道标题](https://www.are.na/owner/slug) by @username — N 条内容  
  [简述其覆盖范围与质量]
- [频道标题](https://www.are.na/owner/slug) by @username — N 条内容  
  [简述]

**重要内容：**
- [Block 标题](source_url) — 出现在 N 个频道中  
  [说明其重要性]

**关键策展人：**
- [@username](https://www.are.na/slug) — N 个频道，N 位关注者  
  [说明其专注方向]

**关联领域：**
- [相邻频道](https://www.are.na/owner/slug) — 因共享 Block 而产生交集  
  [说明该连接对理解本主题的启示]

9. 保存成果

使用 --save 参数，或手动保存至 ~/clawd/drafts/arena-research-{topic-slug}-{YYYY-MM-DD}.md。

请在文末添加元数据页脚：

---
## 研究元数据
- **查询语句**：[原始问题]
- **日期**：YYYY-MM-DD
- **数据源**：Are.na v3 API
- **API 调用次数**：N 次搜索 + N 次频道获取 + N 次 Block 连接查询 + N 次深度查阅
- **探索频道数**：N
- **扫描 Block 数**：~N
- **使用搜索词**：[列出实际使用的搜索字符串]
- **局限性**：[指出任何未覆盖的盲区]

优化启发式方法

• 结果中浅层频道过多？ 在搜索结果中过滤条目数 >10 的频道
• 结果过少？ 扩展关键词、尝试同义词、移除 --type 过滤条件
• 想找到被最多人收藏的内容？ 使用 --sort connections 搜索 Block
• 想查找特定类型的链接？ 使用 --type Link 获取外部引用，--type Text 获取笔记
• 频道过大难以浏览？ 对 channel 命令使用 --type 和 --sort 参数
• 想向外蛛网式扩展？ 挑选 3 个 connection 数最多的 Block，获取其连接关系，观察新涌现的内容
• 卡住了？ 搜索某个已知参考项或思想家，找到其频道，再由此出发探索
• 进行视觉研究？ 使用 --type Image —— Are.na 广泛用于情绪板（mood boards）与美术指导（art direction）

内容类型速查表

文件结构

skills/arena-research/
├── SKILL.md              （本文档）
├── arena-search.ts       （CLI 入口文件）
├── lib/
│   ├── api.ts            （Are.na v3 API 封装：search / channels / blocks / users）
│   ├── cache.ts          （基于文件的缓存，TTL = 15 分钟）
│   └── format.ts         （终端与 Markdown 格式化工具）
├── data/
│   └── cache/            （自动管理）
└── references/
    └── arena-api.md      （Are.na v3 API 端点参考文档）