知犀思维导图

Zhixi Mind Map Cloud File Management (知犀思维导图云文件管理): Browse, search, view content, and import Markdown. Activated when the user mentions 'Zhixi', 'Mind Map', 'Brain Map', 'zhixi', 'mindmap' or requests related file operations.

MindTwigs@mindtwigs

Install

openclaw skills install @mindtwigs/zhixi-mindmap

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 配置二选一)

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

How to Get Token (如何获取 Token)

Log in to https://www.zhixi.com/account
登录 https://www.zhixi.com/account
Obtain the API Token in the Account Center
在账号中心获取 API Token
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 次）

Extract 2-3 core keywords (Sorted by priority)
提取 2-3 个核心关键词（优先级排序）
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
Stop the search as soon as any core keyword yields results
任一核心词有结果即停止搜索

Phase 2: Thematic Keyword Expansion

第二阶段：主题词扩展

Triggered only when all core keywords yield no results
仅当所有核心词都无结果时触发
Generate 1-2 related thematic keywords
生成 1-2 个相关主题词
Perform a maximum of 1-2 additional thematic keyword searches
最多再搜索 1-2 个主题词

⚠️ Error Handling (错误处理)

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

Membership Policy (会员权限策略)

Prioritize VIP Guidance
When error 2001 occurs, guide user to upgrade to VIP to unlock full features
当遇到 2001 错误时，引导用户升级到 VIP 版本
VIP Exclusive Features (会员专属功能)
- ✅ Unlimited Markdown imports (无限制 Markdown 导入)
- ✅ Advanced search capabilities (高级搜索功能)
- ✅ Increased storage space (更多存储空间)
Free Tier Restrictions (免费功能限制)
Limited trial access to some advanced features
可试用部分高级功能，次数有限

Example Dialogue (示例话术)