Server defines 4 tools with explicit schemas and descriptions in Chinese. All tools have input schemas with type definitions and parameter descriptions. However, descriptions are brief (10-50 chars), lack actionable context for LLM selection, and omit critical details like prerequisites, return structure, and error guidance. No output schemas documented. Parameters lack constraints (enums, ranges, patterns). Error handling returns generic text without recovery guidance. Tool composition is reasonable (list, search, create, get) but descriptions don't explain when to use each tool or dependencies between them.
创建一条笔记, content 为 Markdown(自动转 ENML)。
搜索笔记。可按搜索词(words)和/或笔记本(notebookGuid)过滤,返回标题等元数据。
按 guid 读取一条笔记, 内容转回 Markdown。
列出当前印象笔记账号的所有笔记本(名称与 guid)。
Descriptions are too brief (10-50 chars) and lack LLM-actionable context. 'List notebooks' does not explain when to call it vs find-notes, what structure is returned, or that it's a prerequisite for create-note. Baseline: A+ tools average 194 chars with WHAT/WHEN/WHY.
No output schemas documented. LLMs cannot plan downstream calls or extract required fields (e.g., notebook guid from list-notebooks for use in create-note). Baseline: 100% of A+ tools document return types.
Parameters lack constraints. maxResults accepts 1-50 but no enum/min/max in schema; words accepts free-form strings with no format guidance. Baseline: A+ tools use enums for known sets and numeric bounds.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 53 | 2026-07-28+ | v2 |
Error handling returns generic text ('调用失败: <msg>') without recovery guidance. LLM cannot determine if error is retryable, user-fixable, or fatal. Baseline: A+ tools categorize errors and suggest next steps.
Tool descriptions in Chinese may reduce LLM comprehension in English-first models. Descriptions should be in the model's primary language or bilingual.