SuperAPI AI 工具集

argdown

写作与研究

查看项目

更新于 10-15 22:14

技能介绍

用途:Argdown 用纯文本描述论证与辩论结构(主张、支持、反驳、质疑等),再渲染成可视化论证地图;适合整理 pro-con、异议树、前提-结论推理。

主要能力:语句 [Title]: text 与论证 <Title> 两类节点;+ 支持、- 攻击、>< 矛盾、_ 削弱;前提-结论用 (1)…-----…(N) 表达;# 分节;=== 开头为 YAML frontmatter。可导出 SVG、DOT、HTML、JSON。

使用方式:需 argdown 在 PATH 上,检查 command -v argdown;缺失时 npm install -g @argdown/cli。SVG/PNG 导出需 Graphviz:brew install graphviz。解析并报语法错误用 argdown path/to/file.argdown,也可用附带的 scripts/lint.sh <file>;渲染用 argdown map path/to/file.argdown ./svg -f svg 或 scripts/render.sh <file> [outdir]。常用标志:-v 显示 AST、-f dot 仅输出 DOT、--rankdir LR、html、json、--watch。

限制:解析器较宽松,会容忍错误括号、非连续编号、纯乱码行、未定义引用与错误缩进的关系符号,lint 仅在少数硬错误(缺推理线、未闭合行内格式等)失败,因此通过后仍需查看 SVG。语句正文会先按 Markdown 行内格式解析,标识符中的下划线可能触发斜体,建议放入反引号。引用可用 YAML 元数据(source、author、date、title),URL 需加引号。官方 CLI 参数以外的行为与收费情况暂未提供。