前言¶

调研纪要、销售表、接口返回的 JSON，往往已经「有内容」，却难变成一份能直接发给同事或在 Typora 里排版的报告。手写 HTML 内联样式、统一卡片和表格配色、再兼顾 Markor 与 PDF 导出，耗时长且容易格式错乱。下面介绍 SkillHub 上的社区 Skill「Typora视觉架构师」，它用固定的输出规范与提示词，把原始材料收敛成包裹在四反引号代码块内的可视化 Markdown。

这是什么¶

Typora视觉架构师（坐标 @user_d82fedf3/typora-visual-architect，版本 1.0.0）由社区发布者 user_d82fedf3 维护，在 SkillHub 分类为 office-efficiency，来源为 community。官方简介为：将结构化或半结构化数据转化为高质量 Markdown 可视化报告，适用于 Typora / Markor，并可通过 PDF 导出。SkillHub 页面标注作者为 EastSeaO；包内 SKILL.md 元数据另写有作者「王维」，以商店页与安装包并存信息为准即可。

标签 requires_api_key=false，不依赖外部 API Key。

核心功能¶

结合 SkillHub 说明与 v1.0.0 安装包内容，可核实的能力如下。

1. 结构化视觉输出：config.yaml 中 mode: structured_output，输出为 Markdown，并用 wrapper: "```markdown" 包裹全文，开启 html_support 与 typora_optimized，面向 Typora 类编辑器的 HTML 混排。
2. 组件与版式规则：prompt.md 规定主标题居中 <h1>、提示框、Flex 卡片、样式化 HTML 表格、渐变总结区，以及可选 Mermaid（flowchart / sequence / mindmap）；CSS 仅允许内联 style，且要求标签闭合。
3. 主题配色可配置：config.yaml 的 style.theme 提供主色、边框、强调色、表头、渐变与文字色（如 #e3f2fd、#bbdefb、#2196f3 等）。
4. 表达约束：capabilities 含 anti_ai_tone_rewrite 等，constraints 要求无外部 CSS、严格 HTML 闭合、Typora 兼容模式。
5. 轻量脚本封装：run.py 中的 TyporaVisualArchitect 将输入文本套入标题、内容区、总结与署名的 HTML 骨架，并返回四反引号 markdown 代码块字符串。
6. 文档中的扩展说明：同包 SKILL.md 还描述了从 CSV/JSON 加载数据、用 matplotlib 生成柱状图/折线图/散点图、经 config.yaml 配置 data_source、chart_type、output_file 等并执行 python run.py 的流程；当前包内 config.yaml 以输出与样式为主，若按该文档做数据图表，需自行对齐 SKILL.md 中的配置表与依赖（Python 3.8+，pandas、matplotlib、pyyaml）。

安装与启用¶

SkillHub 推荐让 Agent 按官方安装说明操作。先确认 CLI：

command -v skillhub && skillhub --version

未安装时可执行完整安装（见 SkillHub 安装文档）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。示例：

# Cursor
skillhub install @user_d82fedf3/typora-visual-architect --dir ~/.cursor/skills/

# Claude Code
skillhub install @user_d82fedf3/typora-visual-architect --dir ~/.claude/skills/

# Codex（用户级或项目级）
skillhub install @user_d82fedf3/typora-visual-architect --dir ~/.codex/skills/

也可在对话中直接说明（SkillHub 页面提供的提示）：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_d82fedf3/typora-visual-architect`。

安装完成后，在支持 Skill 的客户端中启用该 Skill，Agent 会加载包内的 SKILL.md、prompt.md 与 config.yaml 等说明。

典型用法¶

方式一：在 Agent 中整理内容¶

1. 准备好原始数据或文稿（表格、文本、JSON 等），并说明分析或排版目标（可选）。
2. 触发 Skill 后，Agent 按 prompt.md 生成仅含一个四反引号 markdown 代码块的回复，块外不附加解释。
3. 将代码块内正文复制到 Typora 或 Markor 预览；需要 PDF 时使用编辑器导出即可。

包内 结构化输出.md 提供可复用的中文指令片段，可贴在数据或文件说明之后，要求模型严格遵循全文包裹、卡片化、内联 CSS 与文末署名等规则。

方式二：调用 run.py 做骨架转换¶

在 Skill 目录下，用 Python 调用 run() 对短文本做最小结构化（标题提取、提示框与总结区）：

from run import run

markdown_block = run("这里是待整理的要点与数据说明……")
print(markdown_block)

方式三：按 SKILL.md 做数据图表报告（文档路径）¶

若走数据文件与图表生成，SKILL.md 给出的 config.yaml 示例为：

data_source: "sales.csv"
chart_type: "bar"
x_column: "Month"
y_column: "Revenue"
title: "月度销售报告"
output_file: "sales_report.md"
include_mermaid: true

文档要求安装依赖后执行：

pip install pandas matplotlib pyyaml
python run.py

使用前请确认本地 config.yaml 已与上述字段对齐，且 run.py 是否已实现文档中的完整流水线（v1.0.0 脚本主体为文本转换类，与文档描述可能存在差异，以你安装包内文件为准）。

适用场景与注意¶

适合：需要把结构化/半结构化材料快速变成 Typora、Markor 友好、可 PDF 导出的可视化 Markdown；市场调研、销售数据、竞品对比等需要统一版式的场景（SKILL.md 亦提到食品行业分析等）。

注意：

• 重度依赖 内联 HTML；纯 Markdown 渲染器可能无法还原卡片与表格样式。
• 四反引号外层包裹是为了避免内部代码块或 Mermaid 提前闭合外层，复制时须保留完整块。
• SkillHub 统计（以抓取资料为准）：评分 100000，下载 704，安装 8；与部分第三方摘要数字可能不一致，以 SkillHub 技能页 为准。
• 包内 SKILL.md 与 config.yaml、run.py 在数据图表能力上表述不完全一致，落地前建议打开安装目录核对。

结尾¶

Typora视觉架构师把「数据 + 版式规范」收成一套可复用的 Skill：Agent 侧靠 prompt.md 与模板指令出稿，必要时用 config.yaml 调主题，或在文档指导下接 CSV/JSON 与图表。需要安装或查看元信息时，可访问 SkillHub：https://www.skillhub.cn/skills/user_d82fedf3/typora-visual-architect，API 入口：https://api.skillhub.cn/user_d82fedf3/typora-visual-architect。