メニュー
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/crimsonblazezero/Zero-Tools --skill ima-skillsコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
| name | ima-skills |
| description | ima笔记与知识库管理（读取、写入、检索）；统一 IMA OpenAPI 技能，支持 notes 与 knowledge-base 两个模块。 |
| version | 1.1.8 |
| homepage | https://ima.qq.com |
| display_name | 腾讯ima |
| display_name_en | Ima Skills |
| description_zh | ima笔记与知识库管理（读取、写入、检索） |
| description_en | IMA notes & knowledge base management (read, write, search) |
| visibility | public |
Unified IMA OpenAPI skill. Currently supports: notes, knowledge-base.
import_doc or append_doc, ALL string fields (content, title) MUST be validated as legal UTF-8. Non-UTF-8 content causes irreversible garbled text. See Detailed Rules for platform-specific methods.title MUST equal file_name (with extension). Never rename, shorten, translate, or modify the original filename.file:// URLs are not supported — tell user to use IMA desktop client.| 用户意图 | 模块 | 读取 |
|---|---|---|
| 搜索笔记、浏览笔记本、获取笔记内容、创建笔记、追加内容 | notes | notes/SKILL.md |
| 上传文件、添加网页链接、搜索知识库、浏览知识库内容、获取知识库信息、获取可添加的知识库列表 | knowledge-base | knowledge-base/SKILL.md |
| 查看原文、分析原文、导出原文（需要 media_id） | knowledge-base | knowledge-base/SKILL.md |
| 用户说的 | 实际意图 | 正确路由 |
|---|---|---|
| "把这段内容添加到知识库XX里的笔记YY" | 往已有笔记追加内容 | notes — 先搜索笔记获取 note_id，再用 append_doc |
| "把这个写到XX笔记里"、"记到XX笔记" | 往已有笔记追加内容 | notes — append_doc |
| "把这篇笔记添加到知识库" | 将笔记关联到知识库 | knowledge-base — add_knowledge with media_type=11 |
| "上传文件到知识库" | 上传文件到知识库 | knowledge-base — create_media → COS → add_knowledge |
| "新建一篇笔记记录这些内容" | 创建新笔记 | notes — import_doc |
| "帮我记一下"、"记录一下"、"保存为笔记"（未指定已有笔记） | 意图不明确，需要确认 | notes — 先询问用户是创建新笔记还是追加到哪篇已有笔记 |
| "添加到笔记里"（未指定具体哪篇） | 意图不明确，需要确认 | notes — 先询问用户是创建新笔记还是追加到哪篇已有笔记 |
某些意图跨越 notes 和 knowledge-base 两个模块。不要只读取一个子模块就开始执行，必须先读取两个模块的 SKILL.md 再按顺序操作。
| 用户说的 | 实际流程 | 读取顺序 |
|---|---|---|
| "把知识库里的XX内容记到笔记" | KB 搜索/读取 → Notes 创建/追加 | 先读 knowledge-base/SKILL.md → 再读 notes/SKILL.md |
| "查看原文"（知识库中的笔记类型媒体） | KB get_media_info → Notes get_doc_content | 先读 knowledge-base/SKILL.md → 再读 notes/SKILL.md |
| "把这篇笔记添加到知识库" | Notes 搜索获取 note_id → KB add_knowledge | 先读 notes/SKILL.md → 再读 knowledge-base/SKILL.md |
规则：如果用户意图同时涉及「笔记」和「知识库」，或者 API 响应揭示需要另一个模块（如 media_type=11 表示笔记类型），必须读取两个子模块再继续。
核心判断规则：
get_doc_content）!test -f ~/.config/ima/client_id && test -f ~/.config/ima/api_key && echo "✅ Credentials configured" || echo "⚠️ NO CREDENTIALS — setup required before any API call"
If ⚠️ NO CREDENTIALS: Guide the user through setup BEFORE attempting any API call:
方式 A — 配置文件（推荐）：
mkdir -p ~/.config/ima
echo "your_client_id" > ~/.config/ima/client_id
echo "your_api_key" > ~/.config/ima/api_key
方式 B — 环境变量：
export IMA_OPENAPI_CLIENTID="your_client_id"
export IMA_OPENAPI_APIKEY="your_api_key"
Agent 会按优先级依次尝试：环境变量 → 配置文件。缺少凭证时，node ima_api.cjs ... 会以程序错误退出（code: -100），并在 stderr 输出对应 msg。
Security note: Credentials are only sent as HTTP headers to
ima.qq.comand never to any other domain, file, or log. Runtime dependencies: Checkmeta.json→required_binaries
所有请求统一为 HTTP POST + JSON Body，仅发往官方 Base URL https://ima.qq.com。
ima_api 已抽离到脚本：./ima_api.cjs
# Example usage (cross-platform, pass credentials via options JSON)
SKILL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
OPTS=$(printf '{"clientId":"%s","apiKey":"%s"}' "$IMA_OPENAPI_CLIENTID" "$IMA_OPENAPI_APIKEY")
# stdout 返回正常响应；stderr 返回结构化错误 {"code":-100|-200,"msg":"..."}
if ! resp=$(node "$SKILL_DIR/ima_api.cjs" "openapi/list_docs" '{"limit":10}' "$OPTS" 2>/tmp/ima_err); then
err_json=$(cat /tmp/ima_err)
err_code=$(echo "$err_json" | jq -r '.code // empty' 2>/dev/null)
err_msg=$(echo "$err_json" | jq -r '.msg // empty' 2>/dev/null)
if [ "$err_code" = "-200" ]; then
# 有新版本，原请求未发送；stdout 中带有更新上下文 JSON（含 instruction）
echo "[update] $err_msg" >&2
else
# -100 或其他程序错误：msg 已包含可直接展示给用户的说明
echo "[error] $err_msg" >&2
fi
exit 1
fi
echo "$resp"
错误处理有两层，必须都检查：
第一层 — 脚本执行错误（进程非 0 退出，错误在 stderr）：
-100：程序错误（缺少凭证、参数非法、网络错误等），msg可直接展示给用户-200：skill 需要更新，原请求未发送，stdout 中有更新上下文 JSON第二层 — 后端业务错误（进程正常退出，响应在 stdout）：
- stdout 返回 JSON
{"code": 0, "msg": "...", "data": {...}}code=0表示成功，从data提取业务字段code≠0表示后端业务错误（如参数不合法、权限不足、资源不存在等），直接将msg展示给用户- 常见后端错误码见各子模块的「错误处理」章节
ima_api 已内置更新检查：默认每天首次 API 调用自动检查一次，同一天内不会重复检查。
latest_version：最新版本号，格式为 MAJOR.MINOR.PATCHrelease_desc：最新版本发布说明instruction：更新指引（prompt 文本）出错时进程以非 0 退出，并在 stderr 输出结构化 JSON：
{"code":-100|-200,"msg":"具体错误描述"}。
-200（skill 需要更新）
ima_api.cjs 的 stdout 读取更新上下文 JSON，根据其中 instruction（prompt）引导用户完成更新，然后重试原请求-100（程序错误，兜底）
msg 向用户展示；msg 已指出具体原因与修复建议更新检查调用本身失败时，会直接跳过本次检查并继续原请求，不会抛错。
如需主动触发（忽略"每天一次"限制），可在调用前设置：
export IMA_FORCE_UPDATE_CHECK=1
The sections below contain full platform-specific examples for the mandatory rules above. Refer to these when you need implementation details.
此规则为强制性要求，不可跳过。 非法编码会导致内容在 IMA 中显示为乱码，且无法修复，必须重新写入。
适用范围：notes 模块（
import_doc、append_doc等文本写入 API）。不适用于 knowledge-base 模块的文件上传：上传文件时必须保持文件原始内容，不得转码。文件以二进制方式上传，服务端自行处理。
每次调用 notes 写入类 API（import_doc/append_doc）之前，必须对 content、title 等所有字符串字段执行 UTF-8 编码校验/转换。 无论内容来源如何——用户直接输入、从文件读取、WebFetch 抓取、剪贴板粘贴、外部 API 返回——都不能假设已经是合法 UTF-8，必须显式确认。
在构造 notes 写入请求的 body 之前，完成以下步骤：
\xff\xfe 等）title 也必须为合法 UTF-8Python（推荐，几乎所有环境都有）：
# 读取文件，自动检测编码并转为 UTF-8
content=$(python3 -c "
import sys
data = open('tmpfile', 'rb').read()
for enc in ['utf-8', 'gbk', 'gb2312', 'big5', 'latin-1']:
try:
sys.stdout.write(data.decode(enc))
break
except (UnicodeDecodeError, LookupError):
continue
" 2>/dev/null)
# 如果内容已在变量中，清洗非法 UTF-8 字节
content=$(printf '%s' "$content" | python3 -c "import sys; sys.stdout.write(sys.stdin.buffer.read().decode('utf-8','ignore'))")
Node.js：
content=$(node -e "const fs=require('fs');const buf=fs.readFileSync('tmpfile');process.stdout.write(buf.toString('utf8'))")
# 已知编码（如 GBK）：
content=$(node -e "const fs=require('fs');process.stdout.write(new TextDecoder('gbk').decode(fs.readFileSync('tmpfile')))")
Unix (macOS/Linux)：
content=$(iconv -f "$(file -b --mime-encoding tmpfile)" -t UTF-8 tmpfile 2>/dev/null || cat tmpfile)
Windows PowerShell：
# 读取非 UTF-8 文件并转码
$content = [System.IO.File]::ReadAllText('tmpfile', [System.Text.Encoding]::Default)
[System.IO.File]::WriteAllText('tmpfile.utf8', $content, [System.Text.Encoding]::UTF8)
此问题影响所有 API 调用（notes、knowledge-base 等）
此问题极其隐蔽：PowerShell 5.1 下
Invoke-RestMethod会静默将请求 Body 从 UTF-8 转为系统 ANSI 编码（中文 Windows 为 GBK），即使设置了Content-Type: charset=utf-8也无效。结果是请求看起来发送成功，但服务端收到的内容已经是乱码，且无任何错误提示。
当 agent 运行在 PowerShell 环境时，必须在首次 API 调用前检测版本：
# 检测 PowerShell 版本 — 在任何 API 调用之前执行（notes 和 knowledge-base 都需要）
if ($PSVersionTable.PSVersion.Major -le 5) {
Write-Host "⚠️ 检测到 PowerShell 5.1，将使用 UTF-8 字节数组模式发送请求"
$useUtf8Bytes = $true
} else {
Write-Host "✅ PowerShell 7+，默认 UTF-8，无需额外处理"
$useUtf8Bytes = $false
}
PowerShell 5.1 下必须使用以下方式发送请求（用 ConvertTo-Json 构建 JSON 以避免手动拼接的转义风险，再显式转为 UTF-8 字节数组）：
# PowerShell 5.1 安全请求模板（适用于所有模块的所有 API 调用）
$body = @{ title = "标题"; content = $content; content_format = 1 } | ConvertTo-Json -Depth 10
if ($useUtf8Bytes) {
# CRITICAL: 必须转为字节数组，否则中文/非ASCII内容会变成乱码
$utf8Bytes = [System.Text.Encoding]::UTF8.GetBytes($body)
Invoke-RestMethod -Uri $url -Method Post -Body $utf8Bytes -ContentType "application/json; charset=utf-8" -Headers $headers
} else {
# PowerShell 7+ 可直接传字符串
Invoke-RestMethod -Uri $url -Method Post -Body $body -ContentType "application/json; charset=utf-8" -Headers $headers
}
总结： 在 PowerShell 5.1 环境中，所有 API 调用（无论 notes 还是 knowledge-base）都必须将 Body 显式转为 UTF-8 字节数组。不检测版本直接发请求 = 中文内容必乱码。这是 PowerShell 5.1 的已知设计缺陷，不是 bug 可以被修复。
领星 ERP 数据拉取、周报/月报汇总、运营周会 Excel 表格自动填报并交王祎审核确认后自动提交运营周复盘日志（附件以钉盘链接贴正文）、六组周会纪要自动生成与推送工作流。
Use when generating, pulling, auditing, filling, or rolling monthly business review reports (月度运营复盘/月报/主管月复盘/当月销售分析) for LingXing ERP and Nanjing Europe Group (南京欧洲组KS) Amazon stores.
Use when the user wants to pull Amazon sales/ad profit data from LingXing ERP (跨境电商ERP), build a weekly/monthly business dashboard (经营周报/月报/数据看板/排名环比/父ASIN), or send the report to a DingTalk group (钉钉群). Triggers: "拉上周数据/拉上个月数据", "父ASIN销售广告利润", "经营周报看板", "BSR排名环比", "发送到钉钉/欧洲群", "lingxing周报", "lingxing看板", "月报/月度复盘/全年完成表/退款率/退货率/仓储费/库销比". Pulls order-profit reports at parent-ASIN granularity, cross-validates ads spend, enriches Chinese product names, optionally fetches BSR rank trends, builds a self-contained Chart.js HTML dashboard (monthly variant adds fee-structure/rating/refund-rate/annual-target columns), and sends it to a specified DingTalk group via the dws CLI.
SOC 職業分類に基づく