Zhixi Mind Map (知犀思维导图)#

A cloud file management tool supporting browsing, searching, content viewing, and Markdown importing for mind maps.

知犀思维导图云文件管理工具，支持思维导图的浏览、搜索、内容查看和 Markdown 导入。

⚙️ Configuration (配置)

Token Configuration (Choose one of two）（Token 配置 二选一)#

1. Environment Variable: export ZHIXI_TOKEN="your_token"
2. Local File: Create a token file in the skill directory and write the Token inside.

How to Get Token (如何获取 Token)#

1. Log in to https://www.zhixi.com/account

   登录 https://www.zhixi.com/account

2. Obtain the API Token in the Account Center

   在账号中心获取 API Token

3. Add it to the environment variable or the token file 配置到环境变量或 token 文件

Priority (优先级): Environment Variable > Local File (环境变量 > 本地文件)

🚀 Quick Start (快速开始)#

bash

# List files (查看文件列表)
node scripts/zhixi-files.js

# Enter a folder (进入文件夹)
node scripts/zhixi-files.js <folder_id>

# View content (查看内容)
node scripts/zhixi-files.js content <file_guid>

# Search files (搜索文件)
node scripts/zhixi-files.js search <keyword>

# Import Markdown (Limited usage on trial version) (导入 Markdown 可试用)
node scripts/zhixi-files.js import <file.md> [--dir <folder_id>]

📁 File Operations (文件操作)#

View Content (查看内容)#

bash

node scripts/zhixi-files.js content <file_guid>

Returns Markdown format; display long content in segments.

返回 Markdown 格式，请分段展示长内容。

Online Access (在线查看)#

Access directly via (直接访问): https://www.zhixi.com/drawing/{file_guid}

📊 Output Format (输出格式)#

json

[
  {
    "title": "File Name (文件名)",
    "type": "file",     // "file" (文件) or "folder" (文件夹)
    "file_guid": "xxx", // File ID, used to open the mind map (文件 ID，用于打开思维导图)
    "id": 0             // File = 0, Folder = Actual ID (文件=0，文件夹=实际 ID)
  }
]

Display Rules (展示规则)#

Formatted Output (格式化输出)#

text

📁 Data Recovery (数据恢复) (ID: 9037411)
📄 "Water Margin" Reading Notes (《水浒传》读书笔记) (ID: 01e64e2af46f3998ede4ecb9db37c6ae)

Important Reminders (重要提醒)#

• Do not display URL templates (e.g., /drawing/{file_guid})

  不要展示 URL 模板（如 /drawing/{file_guid}）

• For folders, show id; for files, show file_guid

  文件夹显示 id，文件显示 file_guid

• Segment and display full content when lengthy

  内容较长时分段展示完整内容

Search Strategy (搜索策略)#

Phase 1: Sequential Core Keyword Search (Max 3 attempts)#

第一阶段：核心词依次搜索（最多 3 次）

1. Extract 2-3 core keywords (Sorted by priority)

   提取 2-3 个核心关键词（优先级排序）

2. Try each core keyword sequentially

   依次尝试每个核心词：

   • Search Keyword 1 → If results exist, return and end search

     搜索核心词 1 → 有结果则返回，结束搜索

   • No results → Search Keyword 2

     无结果 → 搜索核心词 2

   • No results → Search Keyword 3

     无结果 → 搜索核心词 3

3. Stop the search as soon as any core keyword yields results

   任一核心词有结果即停止搜索

Phase 2: Thematic Keyword Expansion#

第二阶段：主题词扩展

1. Triggered only when all core keywords yield no results

   仅当所有核心词都无结果时触发

2. Generate 1-2 related thematic keywords

   生成 1-2 个相关主题词

3. Perform a maximum of 1-2 additional thematic keyword searches

   最多再搜索 1-2 个主题词

⚠️ Error Handling (错误处理)#

Error CodeDescription (说明)Solution (解决方案)1200Request limit exceeded (请求量超限)Try again later or contact support (稍后重试或联系客服)1201Token expired (Token 已过期)Obtain a new token and update configuration (重新获取并更新 Token)2001Membership restriction (会员限制)Prioritize upgrading to VIP (优先开通会员) https://www.zhixi.com/pricing?from=openclaw

Membership Policy (会员权限策略)#

1. Prioritize VIP Guidance

   When error 2001 occurs, guide user to upgrade to VIP to unlock full features

   当遇到 2001 错误时，引导用户升级到 VIP 版本

2. VIP Exclusive Features (会员专属功能)

   • ✅ Unlimited Markdown imports (无限制 Markdown 导入)
   • ✅ Advanced search capabilities (高级搜索功能)
   • ✅ Increased storage space (更多存储空间)

3. Free Tier Restrictions (免费功能限制)

   Limited trial access to some advanced features

   可试用部分高级功能，次数有限

Example Dialogue (示例话术)#

text

Detected 2001 Error → Free cloud file limit reached
检测到 2001 错误 → 免费云文件数量超限

Options (选项):
1. Upgrade to VIP (开通会员)
2. Continue with free features (使用免费功能)

---

After viewing "Water Margin Reading Notes" → Attach editing link:
查看"《水浒传》读书笔记"内容后 → 附上作图页链接:
`https://www.zhixi.com/drawing/01e64e2af46f3998ede4ecb9db37c6ae`

---

Search for "Java" yields no results → No matching files found
搜索"Java"无结果 → 当前搜索范围内无匹配文件

💡 Best Practices (最佳实践)#

Friendly User Interaction (友好的用户交互)#

• ❌ Avoid suggesting that users execute commands manually

  避免建议用户手动执行命令

• ✅ Do: Provide options to perform actions directly via the skill

  应该：提供通过技能直接操作的选项

• ✅ Example (示例): "I can help you view/search/create this directly..."

  "我可以直接帮你查看/搜索/创建..."

Content Presentation Suggestions (内容展示建议)#

• Segment long content for display

  分段展示长内容

• Use headings and dividers to improve readability

  使用标题和分隔线提高可读性

• Highlight key sections (e.g., "Reading Insights")

  突出显示关键部分（如"读后感悟"）

• Interactive browsing: Allow users to request specific chapters

  交互式浏览：用户可请求查看特定章节

Example Structure (示例结构)#

markdown

## 📚 Note Title (笔记标题)

### Chapter One (章节一)
- Point 1 (要点 1)
- Point 2 (要点 2)

📌 **Key Takeaway (关键部分)**:
- Critical content (重点内容)
- Core perspective (核心观点)