yang0/handraw-style/community-share

HandRaw Community Publisher & Manager (手绘风社区发帖与静态页面发布中枢)

本 Skill 是手绘风生态 (handraw-style.com) 的全功能社区发布引擎。 涵盖两大核心维度：

1. 动态论坛发帖与内容管理：向 Discourse 社区各大板块发布图文讨论、出版级手绘提示词卡片、跟帖互动及帖子全生命周期维护。
2. 静态画廊与资产部署上云：一键将风格画廊页面（index.html、tutorials.html、assets.html 等）、365 种视觉风格数据与 WebP 高清切片图增量同步部署至云服务器与 CDN，并支持自动发布论坛版本更新公告。

🏛️ 双维发布架构与体系划分

flowchart TD
    User["用户 / Agent 社区发布请求"] --> Decision{"发布目标类型"}
    
    Decision -- "论坛发帖 / 提示词分享 / 互动" --> Forum["Discourse 论坛 API 交互引擎\n(discourse_client.py post/share/reply)"]
    Decision -- "画廊更新 / 静态页面上云" --> Static["静态画廊与资产部署引擎\n(discourse_client.py deploy / sync_to_static.py)"]
    Decision -- "版本升级联动发布" --> Combo["一键部署 + 论坛自动发公告\n(discourse_client.py deploy --announce)"]
    
    Forum --> F1["自动配图上传 /uploads.json"]
    F1 --> F2["按板块智能路由 (ID 4-9)"]
    F2 --> F3["生成直达帖子链接"]
    
    Static --> S1["增量检测本地与远程 WebP 差异"]
    S1 --> S2["SCP 打包传输并远程解压"]
    S2 --> S3["刷新 Nginx 静态软链接与 CDN"]
    
    Combo --> Static
    Static --> Forum

社区 6 大核心板块体系

🛠️ 操作指南与核心发布模式

底层脚本支持在仓库根目录或 Skill 目录直接运行： scripts/discourse_client.py 或 skills/community-share/scripts/discourse_client.py。

1. 账号绑定与凭据管理 (Authentication)

• 检查当前登录账号：

``bash python scripts/discourse_client.py whoami ``

• 使用 API Key 绑定登录 (推荐模式)：

``bash python scripts/discourse_client.py login --api-key <your_api_key> ``

• 使用 用户名/邮箱 + 密码 登录：

``bash python scripts/discourse_client.py login --username <user> --password <pass> ``

• 退出登录并清除本地缓存：

``bash python scripts/discourse_client.py logout ``

2. 模式一：风格画廊与静态资产发布上云 (Static Gallery Deploy)

当风格画廊网页（gallery/*.html）、画风数据（styles.json）或图片资源（images/）更新后，一键同步部署至 tencent-vm 云服务器与 CDN。

• 一键增量部署至云端：

``bash python scripts/discourse_client.py deploy ` *(等效于 python scripts/sync_to_static.py --deploy`)*

• 部署同时提交推送到 GitHub handraw-static 仓库：

``bash python scripts/discourse_client.py deploy --git ``

• 部署并自动在论坛「手绘skill」板块发布版本更新公告：

``bash python scripts/discourse_client.py deploy --announce ``

[!TIP]

已部署线上访问地址：

- 风格画廊首页：https://handraw-style.com/gallery/index.html

- 提示词拼装器：https://handraw-style.com/gallery/tutorials.html

- 自建资产图库：https://handraw-style.com/gallery/assets.html

- 核心风格数据：https://static.handraw-style.com/data/styles.json

3. 模式二：通用全板块发帖 (Generic Post)

适用于发布任意讨论、长文教程、工具测评、行业分析或问题求助，支持纯文本或图文混合。

python scripts/discourse_client.py post \
  --title "【工具推荐】这个手绘风批量导出插件大幅提升出图效率" \
  --category "好用的工具" \
  --content "今天给大家分享一个非常实用的批量切图与转 WebP 格式的脚本..." \
  --image "path/to/screenshot.png" \
  --tags "工具,工作流,分享"

• 从本地 Markdown 文件读取正文：

正文内容可传入 @文件路径： ``bash python scripts/discourse_client.py post \ --title "【运营干货】小红书手绘风起号 7 天破万粉复盘" \ --category "运营与变现" \ --content "@path/to/post_review.md" \ --tags "运营,小红书,复盘" ``

4. 模式三：手绘风出版级作品与提示词分享 (Artwork & Prompts Share)

专为手绘风画廊打造，自动将本地画作直传对象存储，并格式化输出包含【画风编号】、【主题色彩】、【创作者名片】、【双语提示词代码块】的出版级社区卡片。

python scripts/discourse_client.py share \
  --image "path/to/images/poster-demo-autumn-equinox.webp" \
  --prompt "秋分节气手绘海报，暖秋落叶与静谧庭院，水彩手绘质感，极简构图与柔和光影，中英双语设计排版。A minimalist autumn watercolor illustration featuring golden falling leaves, a serene traditional courtyard, warm sunlight, clean layout, hand-drawn aesthetic, high resolution." \
  --title "【秋分节气手绘海报】暖秋意象与落叶 · 完整出版级提示词分享" \
  --category "创作交流" \
  --style "048" \
  --style-name "极简儿童绘本水彩" \
  --color "C-05" \
  --notes "通过 HandRaw Style Studio API Key 一键测试发布，包含完整高清配图与双语生图提示词。"

5. 模式四：跟帖与讨论互动 (Topic Reply)

支持向指定话题发表评论、追问或补充说明：

python scripts/discourse_client.py reply \
  --topic-id 38 \
  --content "亲测这个提示词在 DALL-E 3 上效果非常稳定，建议采样时把光影参数调柔和一些！" \
  --image "path/to/test_result.png"

6. 帖子资产管理 (Post Management)

• 查看论坛全部板块清单：

``bash python scripts/discourse_client.py categories ``

• 查看我发布的帖子列表 (实时统计浏览量、点赞、回复)：

``bash python scripts/discourse_client.py my-posts [--limit 15] ``

• 删除我的帖子：

``bash python scripts/discourse_client.py delete --topic-id <topic_id> ``

⚠️ 关键技术细节与协议避坑指南

1. 中文用户名 Header 编码陷阱 (Latin-1 崩溃)：

• Python 的标准库 http.client 在处理 HTTP Header 时仅允许 latin-1 范围字符。
• 当用户名为非 ASCII 中文（如 @小旺旺）时，切勿向请求头追加 `Api-Username`。
• Discourse 支持直接使用 User API Key 鉴权，只需传递 Api-Key: <key>，服务器会自动绑定对应的创作者身份。

1. 图片上传协议规范：

• 接口：POST /uploads.json
• Content-Type：multipart/form-data
• 必须字段：type="composer", synchronous="true", file=<二进制流>。
• 成功后返回 short_url（如 upload://xxx.webp），Discourse 前端会自动解析为带 Lightbox 灯箱缩放的高清视图。

1. 静态部署增量安全机制：

• 自动跳过 individual_backup 等历史目录，只同步有效 366 种画风和自建资产。
• 上传后自动触发 Nginx 软链接补齐 (ln -sfn)，保证 img.handraw-style.com、static.handraw-style.com 与主站即时生效。

1. Discourse 权限控制规则：

• 标题长度：必须 $\ge 5$ 个字符。
• 帖子删除权限：普通用户（TL1）可以自由删除自己发表的跟帖回复 (DELETE /posts/{id}.json)；但删除话题主贴（首楼）受论坛系统管理权限控制，若未配置允许用户删主题，论坛将返回 422/403 提示联系管理员。