Align popiart-server repo with the clean local source snapshot
The remote master branch was carrying AppleDouble metadata, local database state, and checked-in Next.js build output. This commit syncs the repository to the current local source snapshot, preserves the skillhub static pages that exist locally, and extends ignore rules so these runtime artifacts stay out of history going forward. Constraint: The existing remote history already contained tracked macOS metadata files and web build output Constraint: The local source tree must remain deployable after removing repository noise Rejected: Force-push the unrelated local bootstrap commit | would discard the existing remote history Rejected: Leave tracked runtime artifacts in place | would keep polluting future diffs and deployments Confidence: high Scope-risk: moderate Reversibility: clean Directive: Keep AppleDouble files, local SQLite state, and web build artifacts out of version control; regenerate them per-environment instead Tested: go test ./...; go build -o /tmp/popiartserver-sync ./cmd/popiartserver Not-tested: Remote test-server deployment
This commit is contained in:
wtgoku
@@ -0,0 +1,172 @@
|
||||
<!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>
|
||||
Reference in New Issue
Block a user