文件

2 个文件

对话

对话 · 2 轮

第 1 轮 · 你

调用 describe_artifact_format

AI 概要 › 调用了 prompthub_describe_artifact_format 工具，返回了 Artifact 与 File 的区别，以及两种发布方式：publish_artifact（内联文本）和 upload_artifact（二进制文件）。

第 2 轮 · 你

把这段会话总结成一份 Markdown 产物，发布到 prompthub 新仓库

AI 概要 › 依次查询 whoami 获取 handle，查询 describe_file_format 了解文件 content 结构，创建新仓库并发布 Markdown 产物。

产物

2 个产物

PromptHub Artifact 格式说明 · 会话总结

日期：2026-06-04
仓库：@lionel/artifact-format-session

本次会话做了什么

调用 describe_artifact_format 了解产物的定义与发布方式
决定将会话总结为 Markdown 产物，发布到 PromptHub 新仓库
依次查询 whoami、describe_file_format，创建仓库并发布此产物

核心知识点

Artifacts（产物）vs Files（文件）

| 概念 | 说明 | 发布工具 | |------|------|---------| | File | 可复用的 prompt 本身（文本/对话/工作流） | create_repo / publish_session / update_repo | | Artifact | 运行 prompt 后产生的结果，显示在「产物」面板 | publish_artifact / upload_artifact |

发布方式

1. 内联文本 — `publish_artifact`

类型：MARKDOWN 或 HTML
内容通过 content 字段传入（≤ 256 KiB）
适合生成的文档、网页

2. 二进制文件 — `upload_artifact`

| 扩展名 | 类型 | 大小上限 | |--------|------|---------| | .png .jpg .gif .webp | IMAGE | 10 MB | | .mp4 .webm | VIDEO | 100 MB | | .pdf | FILE | 25 MB |

关键注意事项

filePath 强烈建议省略：省略时产物为仓库级，在所有文件页可见；填错路径服务端不报错，但产物不出现在 UI。
替换产物：先 get_repo 查现有 artifacts[]，delete_artifact 删旧的，再重新发布——服务端只追加，不去重。

文件 content 格式速查

// text 类型
{ "kind": "text", "graph": {
    "nodes": [{ "id": "n1", "label": "Prompt", "outputType": "text", "promptText": "..." }],
    "edges": [] } }

// conversation 类型
{ "kind": "conversation", "turns": [
    { "userPrompt": "用户输入", "aiSummary": "AI 回复摘要（可选）" }] }

// workflow 类型
{ "kind": "workflow", "graph": {
    "nodes": [...], "edges": [{ "id": "e1", "source": "a", "target": "b" }] } }

由 Claude Code 自动生成并发布

README

README.md

本仓库记录了一次关于 PromptHub 产物（Artifact）格式的对话总结，作为参考文档使用。

文件

对话

产物