You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
172 lines
8.7 KiB
172 lines
8.7 KiB
<!DOCTYPE html>
|
|
<html lang="zh-CN">
|
|
<head>
|
|
<meta charset="UTF-8" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
<title data-i18n="docs.meta.title">Popi.art Docs</title>
|
|
<meta name="description" data-i18n-content="docs.meta.description" content="Popi.art CLI 与 SkillHub 的静态文档页原型。" />
|
|
<link rel="stylesheet" href="./skillhub_assets/site.css" />
|
|
<script src="./skillhub_assets/site.js" defer></script>
|
|
</head>
|
|
<body data-page="docs">
|
|
<div class="site-shell">
|
|
<header class="site-header">
|
|
<a class="site-brand" href="./skillhub_index.html">
|
|
<span class="site-brand-dot"></span>
|
|
<span>Popi<span class="accent">.art</span></span>
|
|
</a>
|
|
<nav class="site-nav">
|
|
<a href="./skillhub_index.html" data-i18n="common.nav.home">首页</a>
|
|
<a class="is-active" href="./skillhub_docs.html" data-i18n="common.nav.docs">文档</a>
|
|
<a href="./skillhub_skills.html" data-i18n="common.nav.skills">技能页</a>
|
|
<a href="./skillhub_console.html" data-i18n="common.nav.console">控制台</a>
|
|
<a href="./skillhub_pricing.html" data-i18n="common.nav.pricing">定价</a>
|
|
</nav>
|
|
<div class="site-actions">
|
|
<a class="locale-link" href="./skillhub_docs.html" data-locale-toggle data-i18n="common.localeToggle">中文</a>
|
|
<a class="button button-primary button-header" href="./skillhub_login.html" data-i18n="common.login">登录</a>
|
|
</div>
|
|
</header>
|
|
|
|
<main class="site-main">
|
|
<div class="page-stack">
|
|
<section class="section">
|
|
<div class="section-title section-heading" data-i18n-html="docs.heading">
|
|
<div class="eyebrow">DOCUMENTATION</div>
|
|
<h2>围绕 <span>真实 CLI 命令面</span> 写文档</h2>
|
|
<p>本页内容来自 `popiartcli` README、当前状态文档和命令树，不使用想象中的未来命令。</p>
|
|
</div>
|
|
</section>
|
|
|
|
<section class="docs-layout">
|
|
<aside class="toc-card" data-i18n-html="docs.toc">
|
|
<div class="eyebrow">ON THIS PAGE</div>
|
|
<ul class="toc-list">
|
|
<li><a href="#install">安装</a></li>
|
|
<li><a href="#quick-start">快速开始</a></li>
|
|
<li><a href="#commands">命令面</a></li>
|
|
<li><a href="#mcp">MCP</a></li>
|
|
<li><a href="#baseline">Runtime Baseline</a></li>
|
|
</ul>
|
|
</aside>
|
|
|
|
<div class="doc-stack">
|
|
<article class="doc-card" id="install" data-i18n-html="docs.install">
|
|
<div class="eyebrow">INSTALL</div>
|
|
<h3>安装方式</h3>
|
|
<p>`popiartcli` 当前 README 已经明确列出 Homebrew、curl/install.sh、PowerShell 与 source build 四条安装路径。</p>
|
|
<div class="code-block">
|
|
<div class="code-head">
|
|
<span>Homebrew</span>
|
|
<button class="button copy-button" data-copy-target="docs-install-brew" type="button">复制</button>
|
|
</div>
|
|
<pre><code id="docs-install-brew">brew tap wtgoku-create/popi
|
|
brew install wtgoku-create/popi/popiart
|
|
popiart bootstrap --agent codex --discoverable</code></pre>
|
|
</div>
|
|
<div class="code-block">
|
|
<div class="code-head">
|
|
<span>Source Build</span>
|
|
<button class="button copy-button" data-copy-target="docs-install-source" type="button">复制</button>
|
|
</div>
|
|
<pre><code id="docs-install-source">git clone https://github.com/wtgoku-create/popiartcli.git
|
|
cd popiartcli
|
|
go install ./cmd/popiart
|
|
popiart --help</code></pre>
|
|
</div>
|
|
</article>
|
|
|
|
<article class="doc-card" id="quick-start" data-i18n-html="docs.quickstart">
|
|
<div class="eyebrow">QUICK START</div>
|
|
<h3>快速开始</h3>
|
|
<p>最小闭环是：安装 CLI、登录、发现 skill、运行任务、轮询 jobs、拉取 artifacts。</p>
|
|
<div class="code-block">
|
|
<div class="code-head">
|
|
<span>Quick Start</span>
|
|
<button class="button copy-button" data-copy-target="docs-quick-start" type="button">复制</button>
|
|
</div>
|
|
<pre><code id="docs-quick-start">popiart auth login --key pk-...
|
|
popiart skills list --tag image
|
|
popiart run popiskill-image-text2image-basic-v1 --input @params.json --wait
|
|
popiart jobs get job_xxx
|
|
popiart artifacts pull art_xxx</code></pre>
|
|
</div>
|
|
</article>
|
|
|
|
<div class="doc-grid" id="commands">
|
|
<article class="doc-card" data-i18n-html="docs.coreCommands">
|
|
<div class="eyebrow">COMMAND GROUP</div>
|
|
<h3>Core Commands</h3>
|
|
<ul class="meta-list">
|
|
<li><strong>auth</strong> 管理身份验证和 API key</li>
|
|
<li><strong>skills</strong> 发现、安装和查看 skill schema</li>
|
|
<li><strong>run</strong> 调用一个 skill 并返回 `job_id`</li>
|
|
<li><strong>jobs</strong> 查询和等待作业状态</li>
|
|
<li><strong>artifacts</strong> 拉取作业产物</li>
|
|
</ul>
|
|
</article>
|
|
|
|
<article class="doc-card" data-i18n-html="docs.platformCommands">
|
|
<div class="eyebrow">COMMAND GROUP</div>
|
|
<h3>Platform Commands</h3>
|
|
<ul class="meta-list">
|
|
<li><strong>budget</strong> 查看令牌使用情况和剩余预算</li>
|
|
<li><strong>project</strong> 管理当前项目上下文</li>
|
|
<li><strong>models</strong> 查询模型路由与直接推理能力</li>
|
|
<li><strong>bootstrap</strong> 生成本地 discoverability 资产</li>
|
|
<li><strong>update</strong> 从 GitHub Releases 下载新版本</li>
|
|
</ul>
|
|
</article>
|
|
</div>
|
|
|
|
<article class="doc-card" id="mcp" data-i18n-html="docs.mcp">
|
|
<div class="eyebrow">MCP</div>
|
|
<h3>MCP discoverability 已落地的部分</h3>
|
|
<p>当前 repo 已实现 `popiart mcp serve / print-config / doctor`，并暴露一套可调用的 tool surface。</p>
|
|
<div class="code-block">
|
|
<div class="code-head">
|
|
<span>MCP</span>
|
|
<button class="button copy-button" data-copy-target="docs-mcp" type="button">复制</button>
|
|
</div>
|
|
<pre><code id="docs-mcp">popiart mcp serve --describe
|
|
popiart mcp print-config
|
|
popiart mcp doctor
|
|
popiart bootstrap --agent codex --discoverable</code></pre>
|
|
</div>
|
|
<ul class="meta-list meta-list-spaced">
|
|
<li><strong>Implemented tools:</strong> list_skills, get_skill, run_skill, get_job, wait_job, pull_artifact</li>
|
|
<li><strong>Not done yet:</strong> MCP resources / prompts / sampling</li>
|
|
</ul>
|
|
</article>
|
|
|
|
<article class="doc-card" id="baseline" data-i18n-html="docs.baseline">
|
|
<div class="eyebrow">RUNTIME BASELINE</div>
|
|
<h3>当前官方执行基线</h3>
|
|
<p>`popiartcli` 当前状态文档明确只把三个 skill 视为官方 runtime baseline，它们是官网和控制台里最适合优先展示的可执行能力。</p>
|
|
<ul class="meta-list meta-list-spaced">
|
|
<li><strong>popiskill-image-text2image-basic-v1</strong></li>
|
|
<li><strong>popiskill-image-img2img-basic-v1</strong></li>
|
|
<li><strong>popiskill-video-image2video-basic-v1</strong></li>
|
|
</ul>
|
|
</article>
|
|
</div>
|
|
</section>
|
|
</div>
|
|
</main>
|
|
|
|
<footer class="site-footer">
|
|
<div class="footer-grid">
|
|
<div>
|
|
<strong data-i18n="docs.footer.title">Popi.art Docs Prototype</strong>
|
|
<div class="footer-subtitle" data-i18n-html="docs.footer.subtitle">文档内容改写自 `popiartcli` README、命令树和 current-status 文档。</div>
|
|
</div>
|
|
<div class="footer-links">
|
|
<a href="./skillhub_index.html" data-i18n="common.nav.home">首页</a>
|
|
<a href="./skillhub_skills.html" data-i18n="common.nav.skills">技能页</a>
|
|
<a href="./skillhub_console.html" data-i18n="common.nav.console">控制台</a>
|
|
</div>
|
|
</div>
|
|
</footer>
|
|
</div>
|
|
</body>
|
|
</html>
|
|
|