Skip to main content
Glama
yangmi829
by yangmi829

导出本地文稿为文本

export_article

Export local manuscripts to TXT or MD files with optional book title, ready to paste into the Qimao author backend, and get the absolute path for manual publishing.

Instructions

把本地文稿导出成可直接粘贴到七猫作者后台的文本文件(txt/md),返回绝对路径。适合人工发布流程。默认带书名抬头;不联网。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
formatNo导出格式,默认 txt
article_idYes本地文稿 article_id
export_dirNo自定义导出目录,省略则用 data/export
include_novel_titleNo是否在文件头带上所属书名,默认 true

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv0.1.0

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

无 annotations,描述承担全部披露义务。它交代了关键行为特征:离线执行(不联网)、返回绝对路径、默认带书名抬头,这对文件生成类工具的安全画像很有价值。未提及覆盖已有文件的行为或所需权限,属小缺口。

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

单句密集表达,目的前置,随后依次交代产物形式、适用场景、默认行为和离线属性,无冗余。

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

无 output schema,描述已说明返回值(绝对路径)和关键默认行为,对 4 参数工具而言信息基本充分。仅未覆盖文件覆盖/错误处理等边界情形。

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

schema 覆盖率达 100%,参数含义已由 schema 完整表达。描述补充了格式取值 (txt/md) 和默认带书名的行为,与 include_novel_title 默认值一致,但基本是对 schema 的重申,属基线水平。

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (导出)、resource (本地文稿) 和输出形态 (txt/md 文本文件) 并说明返回绝对路径。明确指出产物可粘贴到七猫作者后台,足以与 save_article、import_articles_from_dir 等兄弟工具区分。

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

「适合人工发布流程」点明了使用场景,与 batch_publish_chapters/publish_short_story_qimao 等自动化发布工具形成对照。语境清晰,但未显式点名替代工具或说明何时不该用。

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.