@pencil-agent/nano-pencil 2.0.0-beta.9 → 2.0.0

package/dist/extensions/builtin/link-world/internet-search/internet-search.md

@@ -1,65 +1,65 @@
----
-name: internet-search
-description: 当用户需要联网搜索最新信息、新闻、在线内容时使用此技能。包括搜索 Twitter、YouTube、Bilibili、知乎、微博、小红书等平台。
----
-
-# 互联网搜索
-
-## 触发条件
-
-当用户请求以下内容时使用此技能：
-- 搜索互联网、联网搜索、网络搜索
-- 查找最新新闻、资讯、信息
-- 搜索 YouTube、Bilibili、Twitter、小红书、微博等内容
-- 查找某个话题的最新讨论
-- 获取实时信息或热点内容
-
-## 执行步骤
-
-### 步骤 1：检查 agent-reach 是否安装
-
-运行以下命令检查 agent-reach 是否可用：
-
-```bash
-agent-reach --version
-```
-
-### 步骤 2：如果未安装
-
-如果 agent-reach 命令不可用，告知用户需要先安装：
-
-> link-world (agent-reach) 未安装。请先运行 `/link-world` 安装 agent-reach 以支持联网搜索功能。
-
-### 步骤 3：如果已安装
-
-根据用户需求，使用 linkworld.md 中定义的工具进行搜索。
-
-**完整命令参考请查阅：extensions/link-world/linkworld.md**
-
-| 场景 | 推荐工具 | 示例命令 |
-|------|----------|----------|
-| 搜索 Twitter/X 推文 | xreach | `xreach search "关键词" --json` |
-| 解析 YouTube 视频 | yt-dlp | `yt-dlp --dump-json "视频URL"` |
-| 解析 Bilibili 视频 | yt-dlp | `yt-dlp --dump-json "视频URL"` |
-| 搜索 Reddit 帖子 | curl | `curl -s "https://reddit.com/r/xxx/search.json?q=关键词"` |
-| 搜索 GitHub 仓库 | gh | `gh search repos "关键词" --limit 5` |
-| 读取网页内容 | curl + Jina | `curl -s "https://r.jina.ai/网页URL"` |
-| 通用搜索引擎 | Exa (MCP) | `mcporter call 'exa.web_search_exa(query: "关键词", num_results: 5)'` |
-| 搜索小红书笔记 | 小红书 (MCP) | `mcporter call 'xiaohongshu.search_feeds(keyword: "关键词", limit: 5)'` |
-| 解析抖音视频 | 抖音 (MCP) | `mcporter call 'douyin.parse_douyin_video_info(url: "视频URL")'` |
-
-### 步骤 4：返回结果
-
-将搜索结果整理后返回给用户，包括：
-- 来源平台
-- 标题
-- 内容摘要
-- 链接
-
-## 注意事项
-
-1. 遵守平台的 API 使用规范
-2. 如需登录平台的搜索功能，确保用户已配置认证信息
-3. 如果搜索失败，尝试其他平台或告知用户可能的错误原因
-4. YouTube/Bilibili 需要提供具体的视频 URL，不能直接搜索关键词
-5. 详细的配置说明（Cookie、代理等）请参考 linkworld.md
+---
+name: internet-search
+description: 当用户需要联网搜索最新信息、新闻、在线内容时使用此技能。包括搜索 Twitter、YouTube、Bilibili、知乎、微博、小红书等平台。
+---
+
+# 互联网搜索
+
+## 触发条件
+
+当用户请求以下内容时使用此技能：
+- 搜索互联网、联网搜索、网络搜索
+- 查找最新新闻、资讯、信息
+- 搜索 YouTube、Bilibili、Twitter、小红书、微博等内容
+- 查找某个话题的最新讨论
+- 获取实时信息或热点内容
+
+## 执行步骤
+
+### 步骤 1：检查 agent-reach 是否安装
+
+运行以下命令检查 agent-reach 是否可用：
+
+```bash
+agent-reach --version
+```
+
+### 步骤 2：如果未安装
+
+如果 agent-reach 命令不可用，告知用户需要先安装：
+
+> link-world (agent-reach) 未安装。请先运行 `/link-world` 安装 agent-reach 以支持联网搜索功能。
+
+### 步骤 3：如果已安装
+
+根据用户需求，使用 linkworld.md 中定义的工具进行搜索。
+
+**完整命令参考请查阅：extensions/link-world/linkworld.md**
+
+| 场景 | 推荐工具 | 示例命令 |
+|------|----------|----------|
+| 搜索 Twitter/X 推文 | xreach | `xreach search "关键词" --json` |
+| 解析 YouTube 视频 | yt-dlp | `yt-dlp --dump-json "视频URL"` |
+| 解析 Bilibili 视频 | yt-dlp | `yt-dlp --dump-json "视频URL"` |
+| 搜索 Reddit 帖子 | curl | `curl -s "https://reddit.com/r/xxx/search.json?q=关键词"` |
+| 搜索 GitHub 仓库 | gh | `gh search repos "关键词" --limit 5` |
+| 读取网页内容 | curl + Jina | `curl -s "https://r.jina.ai/网页URL"` |
+| 通用搜索引擎 | Exa (MCP) | `mcporter call 'exa.web_search_exa(query: "关键词", num_results: 5)'` |
+| 搜索小红书笔记 | 小红书 (MCP) | `mcporter call 'xiaohongshu.search_feeds(keyword: "关键词", limit: 5)'` |
+| 解析抖音视频 | 抖音 (MCP) | `mcporter call 'douyin.parse_douyin_video_info(url: "视频URL")'` |
+
+### 步骤 4：返回结果
+
+将搜索结果整理后返回给用户，包括：
+- 来源平台
+- 标题
+- 内容摘要
+- 链接
+
+## 注意事项
+
+1. 遵守平台的 API 使用规范
+2. 如需登录平台的搜索功能，确保用户已配置认证信息
+3. 如果搜索失败，尝试其他平台或告知用户可能的错误原因
+4. YouTube/Bilibili 需要提供具体的视频 URL，不能直接搜索关键词
+5. 详细的配置说明（Cookie、代理等）请参考 linkworld.md

package/dist/extensions/builtin/link-world/link-world-agent.md

@@ -1,82 +1,82 @@
----
-name: link-world
-description: Built-in internet access bridge for NanoPencil. Use when a task needs agent-reach backed web search, browsing, or remote internet actions.
----
-
-# Link-world
-
-NanoPencil exposes link-world as first-class tools. Prefer these tools over calling `agent-reach` through `bash`.
-
-## Tool Selection
-
-- Use `web_search` for ordinary search and lightweight web research, but only if the tool is available in the current session.
-- Use `web_fetch` when you already have the target URL and need its content, but only if the tool is available in the current session.
-- Use `link_world_admin` first when you need setup status, version, install help, or diagnostics.
-- Use `link_world_exec` only when you need a lower-level `agent-reach` command that `web_search` does not model.
-- If the task is about interacting with a live page rather than retrieving knowledge, switch to the `browser` tool family instead of forcing link-world.
-- Do not hand-build shell strings for `agent-reach` unless the dedicated tools are unavailable.
-
-## Recommended Flow
-
-1. Check readiness with `link_world_admin` action `status` or `doctor`.
-2. If the runtime is missing, use `link_world_admin` action `install_help` or `/link-world install`.
-3. If `web_search` is available, use it for ordinary search.
-4. If `web_fetch` is available and the exact URL is already known, use it.
-5. If high-level link-world tools are unavailable, call `link_world_exec` with explicit argv-style arguments.
-6. Prefer bundled site or domain skills before inventing a new web workflow.
-
-## Examples
-
-Admin:
-
-```json
-{
-  "action": "status"
-}
-```
-
-Execution:
-
-High-level search:
-
-```json
-{
-  "query": "OpenAI Responses API"
-}
-```
-
-```json
-{
-  "query": "Playwright file upload",
-  "provider": "web",
-  "limit": 5
-}
-```
-
-High-level fetch:
-
-```json
-{
-  "url": "https://example.com/docs"
-}
-```
-
-Lower-level execution:
-
-```json
-{
-  "args": ["doctor"]
-}
-```
-
-```json
-{
-  "args": ["search", "OpenAI Responses API"]
-}
-```
-
-## Notes
-
-- Pass `args` as an array of tokens, not as one shell command string.
-- If `agent-reach` is not installed, the tools will return install guidance.
-- Keep NanoPencil as the integration boundary: diagnostics through `link_world_admin`, search through `web_search`, direct retrieval through `web_fetch`, lower-level execution through `link_world_exec`.
+---
+name: link-world
+description: Built-in internet access bridge for NanoPencil. Use when a task needs agent-reach backed web search, browsing, or remote internet actions.
+---
+
+# Link-world
+
+NanoPencil exposes link-world as first-class tools. Prefer these tools over calling `agent-reach` through `bash`.
+
+## Tool Selection
+
+- Use `web_search` for ordinary search and lightweight web research, but only if the tool is available in the current session.
+- Use `web_fetch` when you already have the target URL and need its content, but only if the tool is available in the current session.
+- Use `link_world_admin` first when you need setup status, version, install help, or diagnostics.
+- Use `link_world_exec` only when you need a lower-level `agent-reach` command that `web_search` does not model.
+- If the task is about interacting with a live page rather than retrieving knowledge, switch to the `browser` tool family instead of forcing link-world.
+- Do not hand-build shell strings for `agent-reach` unless the dedicated tools are unavailable.
+
+## Recommended Flow
+
+1. Check readiness with `link_world_admin` action `status` or `doctor`.
+2. If the runtime is missing, use `link_world_admin` action `install_help` or `/link-world install`.
+3. If `web_search` is available, use it for ordinary search.
+4. If `web_fetch` is available and the exact URL is already known, use it.
+5. If high-level link-world tools are unavailable, call `link_world_exec` with explicit argv-style arguments.
+6. Prefer bundled site or domain skills before inventing a new web workflow.
+
+## Examples
+
+Admin:
+
+```json
+{
+  "action": "status"
+}
+```
+
+Execution:
+
+High-level search:
+
+```json
+{
+  "query": "OpenAI Responses API"
+}
+```
+
+```json
+{
+  "query": "Playwright file upload",
+  "provider": "web",
+  "limit": 5
+}
+```
+
+High-level fetch:
+
+```json
+{
+  "url": "https://example.com/docs"
+}
+```
+
+Lower-level execution:
+
+```json
+{
+  "args": ["doctor"]
+}
+```
+
+```json
+{
+  "args": ["search", "OpenAI Responses API"]
+}
+```
+
+## Notes
+
+- Pass `args` as an array of tokens, not as one shell command string.
+- If `agent-reach` is not installed, the tools will return install guidance.
+- Keep NanoPencil as the integration boundary: diagnostics through `link_world_admin`, search through `web_search`, direct retrieval through `web_fetch`, lower-level execution through `link_world_exec`.