anbeime/skill / skills/handraw-style/handraw-style/skills/community-share
community-share
Verified通用手绘风社区发帖与静态页面/资产发布 Skill。打通 handraw-style.com (Discourse) 官方论坛账号系统与静态画廊发布系统。涵盖双重能力:(1) 全板块论坛发帖与管理(创作交流、好用的工具、综合大厅、运营与变现、实战作品与爆款、手绘skill):支持发布通用长帖、出版级手绘提示词卡片、自动配图直传短链、回帖、帖子查询与删除;(2) 风格画廊与静态资产一键部署上云(index.html、tutorials.html、assets.html、368 种画风WebP、色彩/版式元数据)与论坛联动公告。触发词:手绘风发帖, 社区发帖, 论坛发帖, 发到论坛, 发到社区, 发布帖子, 分享作品, 手绘提示词分享, 查看我的帖子, 删除帖子, 发布静态页面到社区, 发布静态页, 同步画廊, 更新网站, 部署静态页, 画廊发布.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 11.5 KB |
| references/conversation-sharing.md | markdown | 8.0 KB |
| scripts/conversation_share.py | script | 24.5 KB |
| scripts/conversation_share_ui.py | script | 15.7 KB |
| scripts/discourse_client.py | script | 40.6 KB |
| tests/test_conversation_share.py | script | 15.8 KB |
| tests/test_conversation_share_ui.py | script | 6.0 KB |
scripts/discourse_client.py
View on GitHub#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
HandRaw Style Community Client - 社区账号与内容管理模块
用于打通手绘风网站 (handraw-style.com) Discourse 账号系统,
支持:账号登录/绑定、作品与提示词一键分享发布、查看和管理(编辑/删除)我的帖子。
"""
import os
import sys
import json
import uuid
import subprocess
import mimetypes
import urllib.request
import urllib.error
import urllib.parse
import http.cookiejar
from pathlib import Path
# 默认手绘风社区基准配置
DEFAULT_COMMUNITY_URL = "https://handraw-style.com"
DEFAULT_CATEGORY_ID = 4 # 默认板块: 创作与变现
# 凭据存储路径 (优先用户主目录 ~/.handraw-style/,后备客户端缓存目录)
HOME_DIR = Path.home() / ".handraw-style"
AUTH_FILE = HOME_DIR / "community_auth.json"
COOKIE_FILE = HOME_DIR / "community_cookies.txt"
if getattr(sys, "frozen", False):
_local_app_data = os.environ.get("LOCALAPPDATA") or os.environ.get("APPDATA")
CLIENT_CACHE_DIR = (Path(_local_app_data) / "HandRawStyleStudio" / "cache") if _local_app_data else HOME_DIR / "cache"
else:
CLIENT_CACHE_DIR = Path(__file__).resolve().parent.parent / "client" / "cache"
CLIENT_AUTH_FILE = CLIENT_CACHE_DIR / "community_auth.json"
def ensure_auth_dirs():
HOME_DIR.mkdir(parents=True, exist_ok=True)
try:
CLIENT_CACHE_DIR.mkdir(parents=True, exist_ok=True)
except Exception:
pass
def load_auth_profile():
"""读取已保存的用户登录凭据"""
for filepath in [AUTH_FILE, CLIENT_AUTH_FILE]:
if filepath.exists():
try:
with open(filepath, "r", encoding="utf-8") as f:
data = json.load(f)
if data and (data.get("api_key") or data.get("session_cookie") or data.get("username")):
return data
except Exception:
pass
return None
def save_auth_profile(data):
"""保存用户登录凭据到本地文件"""
ensure_auth_dirs()
success = False
for filepath in [AUTH_FILE, CLIENT_AUTH_FILE]:
try:
with open(filepath, "w", encoding="utf-8") as f:
json.dump(data, f, ensure_ascii=False, indent=2)
success = True
except Exception:
pass
return success
def clear_auth_profile():
"""清除登录凭据 (退出登录)"""
for filepath in [AUTH_FILE, CLIENT_AUTH_FILE, COOKIE_FILE]:
if filepath.exists():
try:
os.remove(filepath)
except Exception:
pass
class DiscourseClient:
def __init__(self, base_url=DEFAULT_COMMUNITY_URL):
self.base_url = base_url.rstrip("/")
self.cookie_jar = http.cookiejar.LWPCookieJar()
ensure_auth_dirs()
if COOKIE_FILE.exists():
try:
self.cookie_jar.load(str(COOKIE_FILE), ignore_discard=True, ignore_expires=True)
except Exception:
pass
self.opener = urllib.request.build_opener(urllib.request.HTTPCookieProcessor(self.cookie_jar))
self.auth = load_auth_profile() or {}
def _save_cookies(self):
try:
self.cookie_jar.save(str(COOKIE_FILE), ignore_discard=True, ignore_expires=True)
except Exception:
pass
def get_csrf_token(self):
"""获取 Discourse CSRF Token"""
req = urllib.request.Request(
f"{self.base_url}/session/csrf.json",
headers={
"User-Agent": "HandRawStudio/1.0",
"Accept": "application/json"
}
)
with self.opener.open(req, timeout=10) as resp:
data = json.loads(resp.read().decode("utf-8"))
return data.get("csrf", "")
def login_with_password(self, username_or_email, password):
"""
使用用户名/邮箱与密码登录 Discourse
"""
csrf = self.get_csrf_token()
payload = urllib.parse.urlencode({
"login": username_or_email,
"password": password
}).encode("utf-8")
req = urllib.request.Request(
f"{self.base_url}/session",
data=payload,
headers={
"User-Agent": "HandRawStudio/1.0",
"X-CSRF-Token": csrf,
"Accept": "application/json",
"Content-Type": "application/x-www-form-urlencoded"
}
)
with self.opener.open(req, timeout=12) as resp:
data = json.loads(resp.read().decode("utf-8"))
if data.get("error"):
raise ValueError(data.get("error"))
user_info = data.get("user") or {}
self._save_cookies()
profile = {
"auth_type": "session",
"username": user_info.get("username", username_or_email),
"user_id": user_info.get("id"),
"name": user_info.get("name"),
"avatar_template": user_info.get("avatar_template"),
"trust_level": user_info.get("trust_level"),
"base_url": self.base_url
}
save_auth_profile(profile)
self.auth = profile
return profile
def login_with_api_key(self, api_key, username=None):
"""
使用 Discourse API Key 绑定登录
"""
headers = {
"Api-Key": api_key,
"User-Agent": "HandRawStudio/1.0",
"Accept": "application/json"
}
if username:
try:
# 仅 ASCII 用户名可安全放入 Api-Username 请求头
username.encode('ascii')
headers["Api-Username"] = username
except UnicodeEncodeError:
pass
req = urllib.request.Request(f"{self.base_url}/session/current.json", headers=headers)
with urllib.request.urlopen(req, timeout=10) as resp:
data = json.loads(resp.read().decode("utf-8"))
user_info = data.get("current_user") or {}
real_username = user_info.get("username") or username or "user"
profile = {
"auth_type": "api_key",
"api_key": api_key,
"username": real_username,
"user_id": user_info.get("id"),
"name": user_info.get("name"),
"avatar_template": user_info.get("avatar_template"),
"trust_level": user_info.get("trust_level"),
"base_url": self.base_url
}
save_auth_profile(profile)
self.auth = profile
return profile
def whoami(self):
"""获取当前登录用户信息"""
if not self.auth:
return {"logged_in": False}
username = self.auth.get("username")
# 尝试在线校验最新会话状态
headers = {"User-Agent": "HandRawStudio/1.0", "Accept": "application/json"}
if self.auth.get("api_key"):
headers["Api-Key"] = self.auth.get("api_key")
try:
username.encode('ascii')
headers["Api-Username"] = username
except (UnicodeEncodeError, AttributeError):
pass
req = urllib.request.Request(f"{self.base_url}/session/current.json", headers=headers)
try:
with urllib.request.urlopen(req, timeout=8) as resp:
data = json.loads(resp.read().decode("utf-8"))
u = data.get("current_user")
if u:
self.auth.update({
"username": u.get("username"),
"name": u.get("name"),
"avatar_template": u.get("avatar_template"),
"trust_level": u.get("trust_level"),
"user_id": u.get("id")
})
save_auth_profile(self.auth)
except Exception:
pass
return {
"logged_in": True,
"username": self.auth.get("username"),
"name": self.auth.get("name"),
"user_id": self.auth.get("user_id"),
"trust_level": self.auth.get("trust_level"),
"avatar_url": self.get_avatar_url(self.auth.get("avatar_template")),
"auth_type": self.auth.get("auth_type"),
"community_url": self.base_url
}
def get_avatar_url(self, template, size=120):
if not template:
return f"{self.base_url}/images/avatar.png"
url = template.replace("{size}", str(size))
if not url.startswith("http"):
url = f"{self.base_url}{url}"
return url
def upload_image(self, file_path_or_bytes, filename=None):
"""上传图片到 Discourse,返回 upload 对象"""
if isinstance(file_path_or_bytes, (str, Path)):
path = Path(file_path_or_bytes)
if not path.exists():
raise FileNotFoundError(f"本地图片文件不存在: {path}")
filename = filename or path.name
with open(path, "rb") as f:
img_data = f.read()
else:
img_data = file_path_or_bytes
filename = filename or f"handraw_{uuid.uuid4().hex[:8]}.png"
mime_type, _ = mimetypes.guess_type(filename)
mime_type = mime_type or "image/png"
boundary = f"----HandRawBoundary{uuid.uuid4().hex}"
body = bytearray()
body.extend(f'--{boundary}\r\nContent-Disposition: form-data; name="type"\r\n\r\ncomposer\r\n'.encode('utf-8'))
body.extend(f'--{boundary}\r\nContent-Disposition: form-data; name="synchronous"\r\n\r\ntrue\r\n'.encode('utf-8'))
body.extend(f'--{boundary}\r\nContent-Disposition: form-data; name="file"; filename="{filename}"\r\nContent-Type: {mime_type}\r\n\r\n'.encode('utf-8'))
body.extend(img_data)
body.extend(f'\r\n--{boundary}--\r\n'.encode('utf-8'))
headers = {
"User-Agent": "HandRawStudio/1.0",
"Content-Type": f"multipart/form-data; boundary={boundary}",
"Accept": "application/json"
}
# 认证头装配
if self.auth.get("api_key"):
headers["Api-Key"] = self.auth.get("api_key")
username = self.auth.get("username")
if username:
try:
username.encode('ascii')
headers["Api-Username"] = username
except UnicodeEncodeError:
pass
req = urllib.request.Request(f"{self.base_url}/uploads.json", data=bytes(body), headers=headers)
with urllib.request.urlopen(req, timeout=30) as resp:
return json.loads(resp.read().decode("utf-8"))
else:
csrf = self.get_csrf_token()
headers["X-CSRF-Token"] = csrf
req = urllib.request.Request(f"{self.base_url}/uploads.json", data=bytes(body), headers=headers)
with self.opener.open(req, timeout=30) as resp:
return json.loads(resp.read().decode("utf-8"))
def list_categories(self, refresh=False):
"""获取论坛所有板块列表(带缓存与离线兜底)"""
if hasattr(self, "_categories_cache") and self._categories_cache and not refresh:
return self._categories_cache
url = f"{self.base_url}/categories.json"
headers = {"User-Agent": "HandRawStudio/1.0", "Accept": "application/json"}
if self.auth.get("api_key"):
headers["Api-Key"] = self.auth.get("api_key")
try:
req = urllib.request.Request(url, headers=headers)
with urllib.request.urlopen(req, timeout=10) as resp:
data = json.loads(resp.read().decode("utf-8"))
cats = data.get("category_list", {}).get("categories", [])
result = []
for c in cats:
result.append({
"id": c.get("id"),
"name": c.get("name"),
"slug": c.get("slug"),
"description": c.get("description_text", ""),
"topic_count": c.get("topic_count", 0),
"post_count": c.get("post_count", 0)
})
self._categories_cache = result
return result
except Exception:
fallback = [
{"id": 4, "name": "综合大厅", "slug": "creation-monetization", "description": "社区公告、新人报到与行业资讯交流大厅"},
{"id": 5, "name": "好用的工具", "slug": "tools", "description": "开源项目与工具分享,工作流与排错求助"},
{"id": 6, "name": "创作交流", "slug": "creative-exchange", "description": "创作经验交流与提示词分享"},
{"id": 7, "name": "运营与变现", "slug": "operations", "description": "起号与运营变现经验分享"},
{"id": 8, "name": "实战作品与爆款", "slug": "showcase", "description": "晒成片、晒图文、爆款拆解点评"},
{"id": 9, "name": "手绘skill", "slug": "handraw-skill", "description": "手绘风专项Skill交流与改进建议"}
]
self._categories_cache = fallback
return fallback
def resolve_category(self, category_input=None):
"""智能解析板块名称、关键词或ID,返回规范的 category_id (支持泛用性全板块路由)"""
if category_input is None or category_input == "":
return DEFAULT_CATEGORY_ID
if isinstance(category_input, int):
return category_input
if str(category_input).strip().isdigit():
return int(str(category_input).strip())
cat_str = str(category_input).strip().lower()
cats = self.list_categories()
# 1. 精确名称或 slug 匹配
for c in cats:
if cat_str == c["name"].lower() or cat_str == str(c["slug"]).lower():
return c["id"]
# 2. 包含匹配
for c in cats:
if cat_str in c["name"].lower() or cat_str in str(c["slug"]).lower() or c["name"].lower() in cat_str:
return c["id"]
# 3. 语义关键词映射
keywords_map = {
"工具": 5, "开源": 5, "workflow": 5, "工作流": 5, "排错": 5, "软件": 5,
"创作": 6, "提示词": 6, "prompt": 6, "经验": 6, "交流": 6, "画风": 6,
"运营": 7, "变现": 7, "推流": 7, "带货": 7, "起号": 7, "商业": 7,
"爆款": 8, "作品": 8, "实战": 8, "晒图": 8, "成片": 8, "案例": 8,
"skill": 9, "手绘": 9, "技能": 9, "插件": 9,
"大厅": 4, "综合": 4, "公告": 4, "新人": 4
}
for kw, cid in keywords_map.items():
if kw in cat_str:
return cid
return DEFAULT_CATEGORY_ID
def create_topic(self, title, content, category=None, tags=None, image_path=None):
"""
通用发帖方法:可向论坛任意板块发布纯文本或图文主题
"""
if not self.auth:
raise PermissionError("尚未登录手绘风社区账号,请先执行登录或绑定!")
category_id = self.resolve_category(category)
img_markdown = ""
img_url = None
if image_path:
p = Path(image_path)
if p.exists():
print(f"[*] 正在上传配图至社区: {image_path} ...")
upload_res = self.upload_image(str(p))
img_url = upload_res.get("url") or upload_res.get("short_url")
short_url = upload_res.get("short_url") or img_url
orig_name = upload_res.get("original_filename", "配图")
img_markdown = f"\n\n"
else:
print(f"[!] 警告:配图文件不存在,将作为纯文本发布: {image_path}")
raw_text = content
if content.startswith("@") and Path(content[1:]).exists():
with open(content[1:], "r", encoding="utf-8") as f:
raw_text = f.read()
elif Path(content).exists() and Path(content).is_file():
try:
with open(content, "r", encoding="utf-8") as f:
raw_text = f.read()
except Exception:
raw_text = content
full_raw = f"{img_markdown}{raw_text}".strip()
if len(title.strip()) < 5:
title = f"【分享】{title.strip()} · 手绘风社区"
tag_list = []
if tags:
if isinstance(tags, list):
tag_list = tags
elif isinstance(tags, str):
tag_list = [t.strip() for t in tags.replace(",", ",").split(",") if t.strip()]
payload = {
"title": title.strip(),
"raw": full_raw,
"category": category_id
}
if tag_list:
payload["tags"] = tag_list
cats = self.list_categories()
cat_name = next((c["name"] for c in cats if c["id"] == category_id), f"板块#{category_id}")
print(f"[*] 正在向 [{cat_name}] (ID: {category_id}) 发布主题: 《{title}》 ...")
post_data = self._post_json(f"{self.base_url}/posts.json", payload)
topic_id = post_data.get("topic_id")
topic_slug = post_data.get("topic_slug", "topic")
post_id = post_data.get("id")
full_url = f"{self.base_url}/t/{topic_slug}/{topic_id}"
return {
"success": True,
"post_id": post_id,
"topic_id": topic_id,
"topic_slug": topic_slug,
"category_id": category_id,
"category_name": cat_name,
"title": title,
"url": full_url,
"image_url": img_url
}
def reply_topic(self, topic_id, content, image_path=None):
"""
通用回复方法:向指定主题发布跟帖回复
"""
if not self.auth:
raise PermissionError("尚未登录手绘风社区账号,请先执行登录或绑定!")
img_markdown = ""
img_url = None
if image_path:
p = Path(image_path)
if p.exists():
print(f"[*] 正在上传跟帖配图至社区: {image_path} ...")
upload_res = self.upload_image(str(p))
img_url = upload_res.get("url") or upload_res.get("short_url")
short_url = upload_res.get("short_url") or img_url
orig_name = upload_res.get("original_filename", "配图")
img_markdown = f"\n\n"
raw_text = content
if content.startswith("@") and Path(content[1:]).exists():
with open(content[1:], "r", encoding="utf-8") as f:
raw_text = f.read()
full_raw = f"{img_markdown}{raw_text}".strip()
payload = {
"topic_id": int(topic_id),
"raw": full_raw
}
print(f"[*] 正在向主题 (ID: {topic_id}) 发布回复 ...")
post_data = self._post_json(f"{self.base_url}/posts.json", payload)
post_num = post_data.get("post_number", 1)
full_url = f"{self.base_url}/t/topic/{topic_id}/{post_num}"
return {
"success": True,
"post_id": post_data.get("id"),
"topic_id": topic_id,
"post_number": post_num,
"url": full_url,
"image_url": img_url
}
def share_creation(self, image_path, prompt, title=None, style_id=None, style_name=None,
color_id=None, color_name=None, category=None, tags=None, notes=None):
"""
一键分享作品与提示词到社区论坛(支持指定任意板块)
"""
if not self.auth:
raise PermissionError("尚未登录手绘风社区账号,请先执行登录或绑定!")
# 智能解析目标板块,默认优先"创作交流"板块 (ID 6)
target_category = category if category is not None else 6
category_id = self.resolve_category(target_category)
print(f"[*] 正在上传作品图片至手绘风社区: {image_path} ...")
upload_res = self.upload_image(image_path)
img_url = upload_res.get("url") or upload_res.get("short_url")
short_url = upload_res.get("short_url") or img_url
orig_name = upload_res.get("original_filename", "作品")
# 智能生成标题
if not title:
style_label = f"#{style_id}" if style_id else "原创手绘"
theme_snippet = prompt.split(",")[0].split("。")[0].split(",")[0][:25]
title = f"【手绘风 {style_label}】{theme_snippet}"
if len(title) < 5:
title = f"{title} · 手绘风创作分享"
# 构造图文出版级 Markdown 帖子结构
meta_items = []
if style_id:
s_name = f" · {style_name}" if style_name else ""
meta_items.append(f"🎨 **画风编号**:`#{style_id}{s_name}`")
if color_id:
c_name = f" · {color_name}" if color_name else ""
meta_items.append(f"🌈 **主题色彩**:`{color_id}{c_name}`")
meta_items.append(f"👤 **创作者**:@{self.auth.get('username')}")
meta_block = "\n".join(meta_items)
notes_block = f"\n> 💡 **创作心得/说明**:\n> {notes}\n" if notes else ""
raw_content = f"""
{meta_block}
{notes_block}
---
### 📝 完整出版级生图提示词 (Prompts)
```markdown
{prompt.strip()}
```
---
*本帖由 [HandRaw Style Studio](https://handraw-style.com) 一键分享生成。欢迎点赞、交流与临摹复现!*
"""
topic_payload = {
"title": title,
"raw": raw_content,
"category": category_id
}
if tags and isinstance(tags, list):
topic_payload["tags"] = tags
elif tags and isinstance(tags, str):
topic_payload["tags"] = [t.strip() for t in tags.replace(",", ",").split(",") if t.strip()]
else:
auto_tags = ["手绘风", "提示词分享"]
if style_id:
auto_tags.append(f"style-{style_id}")
topic_payload["tags"] = auto_tags
cats = self.list_categories()
cat_name = next((c["name"] for c in cats if c["id"] == category_id), f"板块#{category_id}")
print(f"[*] 正在向 [{cat_name}] (ID: {category_id}) 发布帖子: 《{title}》 ...")
post_data = self._post_json(f"{self.base_url}/posts.json", topic_payload)
topic_id = post_data.get("topic_id")
topic_slug = post_data.get("topic_slug", "topic")
post_id = post_data.get("id")
full_url = f"{self.base_url}/t/{topic_slug}/{topic_id}"
return {
"success": True,
"post_id": post_id,
"topic_id": topic_id,
"topic_slug": topic_slug,
"category_id": category_id,
"category_name": cat_name,
"title": title,
"url": full_url,
"image_url": img_url
}
def list_my_posts(self, username=None, limit=20):
"""
获取当前登录用户发布的全部帖子列表
"""
target_user = username or self.auth.get("username")
if not target_user:
raise PermissionError("请先登录或指定用户名查看帖子!")
quoted_user = urllib.parse.quote(target_user)
url = f"{self.base_url}/topics/created-by/{quoted_user}.json"
headers = {"User-Agent": "HandRawStudio/1.0", "Accept": "application/json"}
if self.auth.get("api_key"):
headers["Api-Key"] = self.auth.get("api_key")
u = self.auth.get("username")
if u:
try:
u.encode('ascii')
headers["Api-Username"] = u
except UnicodeEncodeError:
pass
req = urllib.request.Request(url, headers=headers)
with urllib.request.urlopen(req, timeout=10) as resp:
data = json.loads(resp.read().decode("utf-8"))
else:
req = urllib.request.Request(url, headers=headers)
with self.opener.open(req, timeout=10) as resp:
data = json.loads(resp.read().decode("utf-8"))
topics = data.get("topic_list", {}).get("topics", [])
results = []
for t in topics[:limit]:
topic_id = t.get("id")
slug = t.get("slug", "topic")
image_url = t.get("image_url")
if image_url and not image_url.startswith("http"):
image_url = f"{self.base_url}{image_url}"
results.append({
"topic_id": topic_id,
"title": t.get("title"),
"slug": slug,
"url": f"{self.base_url}/t/{slug}/{topic_id}",
"created_at": t.get("created_at"),
"views": t.get("views", 0),
"like_count": t.get("like_count", 0),
"posts_count": t.get("posts_count", 1),
"image_url": image_url,
"category_id": t.get("category_id")
})
return results
def delete_post(self, topic_id=None, post_id=None):
"""
删除帖子或主题 (需要当前用户具备删除权限)
"""
if not self.auth:
raise PermissionError("尚未登录手绘风社区账号!")
if topic_id:
url = f"{self.base_url}/t/{topic_id}.json"
elif post_id:
url = f"{self.base_url}/posts/{post_id}.json"
else:
raise ValueError("必须提供 topic_id 或 post_id")
headers = {
"User-Agent": "HandRawStudio/1.0",
"Accept": "application/json"
}
try:
if self.auth.get("api_key"):
headers["Api-Key"] = self.auth.get("api_key")
username = self.auth.get("username")
if username:
try:
username.encode('ascii')
headers["Api-Username"] = username
except UnicodeEncodeError:
pass
req = urllib.request.Request(url, headers=headers, method="DELETE")
with urllib.request.urlopen(req, timeout=10) as resp:
return resp.status in (200, 204)
else:
csrf = self.get_csrf_token()
headers["X-CSRF-Token"] = csrf
req = urllib.request.Request(url, headers=headers, method="DELETE")
with self.opener.open(req, timeout=10) as resp:
return resp.status in (200, 204)
except urllib.error.HTTPError as e:
try:
err_data = json.loads(e.read().decode("utf-8"))
errors = err_data.get("errors", [])
err_msg = " | ".join(errors) if errors else str(e)
except Exception:
err_msg = str(e)
raise PermissionError(f"删除失败 (HTTP {e.code}): {err_msg}")
def edit_post(self, post_id, new_raw, new_title=None):
"""编辑帖子内容或标题"""
payload = {"post": {"raw": new_raw}}
if new_title:
payload["title"] = new_title
return self._put_json(f"{self.base_url}/posts/{post_id}.json", payload)
def _post_json(self, url, payload):
data_bytes = json.dumps(payload).encode("utf-8")
headers = {
"User-Agent": "HandRawStudio/1.0",
"Content-Type": "application/json",
"Accept": "application/json"
}
if self.auth.get("api_key"):
headers["Api-Key"] = self.auth.get("api_key")
username = self.auth.get("username")
if username:
try:
username.encode('ascii')
headers["Api-Username"] = username
except UnicodeEncodeError:
pass
req = urllib.request.Request(url, data=data_bytes, headers=headers, method="POST")
with urllib.request.urlopen(req, timeout=15) as resp:
return json.loads(resp.read().decode("utf-8"))
else:
csrf = self.get_csrf_token()
headers["X-CSRF-Token"] = csrf
req = urllib.request.Request(url, data=data_bytes, headers=headers, method="POST")
with self.opener.open(req, timeout=15) as resp:
return json.loads(resp.read().decode("utf-8"))
def _put_json(self, url, payload):
data_bytes = json.dumps(payload).encode("utf-8")
headers = {
"User-Agent": "HandRawStudio/1.0",
"Content-Type": "application/json",
"Accept": "application/json"
}
if self.auth.get("api_key"):
headers["Api-Key"] = self.auth.get("api_key")
req = urllib.request.Request(url, data=data_bytes, headers=headers, method="PUT")
with urllib.request.urlopen(req, timeout=15) as resp:
return json.loads(resp.read().decode("utf-8"))
else:
csrf = self.get_csrf_token()
headers["X-CSRF-Token"] = csrf
req = urllib.request.Request(url, data=data_bytes, headers=headers, method="PUT")
with self.opener.open(req, timeout=15) as resp:
return json.loads(resp.read().decode("utf-8"))
# ---------------- 命令行 CLI 支持 ----------------
def cli_main():
if hasattr(sys.stdout, 'reconfigure'):
try:
sys.stdout.reconfigure(encoding='utf-8')
except Exception:
pass
import argparse
parser = argparse.ArgumentParser(description="HandRaw Style 社区互动命令行工具 (全板块通用发帖与内容管理)")
subparsers = parser.add_subparsers(dest="command", help="子命令")
# login
p_login = subparsers.add_parser("login", help="登录手绘风社区账号")
p_login.add_argument("--username", "-u", help="用户名或邮箱")
p_login.add_argument("--password", "-p", help="登录密码")
p_login.add_argument("--api-key", "-k", help="Discourse API Key (可选直接绑定)")
# whoami
subparsers.add_parser("whoami", help="查看当前登录账号状态")
# logout
subparsers.add_parser("logout", help="退出当前登录账号")
# categories (板块列表)
subparsers.add_parser("categories", help="列出社区全部板块、ID与说明")
# post (通用全板块发帖)
p_post = subparsers.add_parser("post", help="发布通用帖子(支持任意板块、纯文本或图文)")
p_post.add_argument("--title", "-t", required=True, help="帖子标题(至少5个字符)")
p_post.add_argument("--content", "-c", required=True, help="Markdown正文内容,或传入 @filepath.md")
p_post.add_argument("--category", "-C", default=None, help="目标板块名称或ID (如 '创作交流' / '好用的工具' / '手绘skill' / 6 等)")
p_post.add_argument("--image", "-i", default=None, help="可选:自动上传并在帖首嵌入配图")
p_post.add_argument("--tags", default=None, help="逗号分隔的标签列表 (如 '手绘风,工具,分享')")
# share (手绘创作专用分享)
p_share = subparsers.add_parser("share", help="分享手绘作品与提示词到社区 (智能排版)")
p_share.add_argument("--image", "-i", required=True, help="要分享的图片本地路径")
p_share.add_argument("--prompt", required=True, help="生成的完整提示词")
p_share.add_argument("--title", "-t", help="帖子标题(留空自动生成)")
p_share.add_argument("--category", "-C", default=None, help="目标板块名称或ID (默认优先: 创作交流 / 6)")
p_share.add_argument("--style", "-s", help="画风编号 (如 048)")
p_share.add_argument("--style-name", help="画风名称")
p_share.add_argument("--color", "-c", help="主题色编号 (如 C-01)")
p_share.add_argument("--notes", "-n", help="创作心得或说明")
p_share.add_argument("--tags", default=None, help="自定义标签 (逗号分隔)")
# reply (回复主题)
p_reply = subparsers.add_parser("reply", help="回复论坛指定主题")
p_reply.add_argument("--topic-id", "-id", type=int, required=True, help="目标主题ID")
p_reply.add_argument("--content", "-c", required=True, help="回复正文内容,或 @filepath.md")
p_reply.add_argument("--image", "-i", default=None, help="可选:回复中附带的配图路径")
# my-posts
p_posts = subparsers.add_parser("my-posts", help="查看我发布的帖子列表")
p_posts.add_argument("--limit", type=int, default=15, help="显示数量")
# delete
p_del = subparsers.add_parser("delete", help="删除我的指定帖子")
p_del.add_argument("--topic-id", type=int, required=True, help="要删除的主题 ID")
# deploy (发布/同步画廊静态页面与资产至云端社区)
p_deploy = subparsers.add_parser("deploy", help="同步并发布画廊静态页面、样式数据与图片资产至云端社区")
p_deploy.add_argument("--announce", action="store_true", help="部署完成后自动在论坛「手绘skill」板块发布更新公告帖")
p_deploy.add_argument("--git", action="store_true", help="同时提交并推送到 GitHub 远端 handraw-static 仓库")
args = parser.parse_args()
client = DiscourseClient()
if args.command == "login":
if args.api_key:
res = client.login_with_api_key(args.api_key, args.username)
print(f"[OK] API Key 绑定成功!欢迎创作者: @{res.get('username')}")
elif args.username and args.password:
res = client.login_with_password(args.username, args.password)
print(f"[OK] 登录成功!欢迎回来: @{res.get('username')} (信任等级: TL{res.get('trust_level')})")
else:
print("请输入 --username 和 --password,或提供 --api-key 进行登录。")
elif args.command == "whoami":
info = client.whoami()
if info.get("logged_in"):
print(f"✅ 当前已登录手绘风社区账号:")
print(f" 用户名: @{info.get('username')}")
print(f" 昵称: {info.get('name') or '无'}")
print(f" 社区地址: {info.get('community_url')}")
print(f" 认证方式: {info.get('auth_type')}")
else:
print("❌ 当前未登录任何手绘风社区账号。请使用 login 命令进行登录绑定。")
elif args.command == "logout":
clear_auth_profile()
print("[OK] 已安全退出手绘风社区账号并清除本地凭据。")
elif args.command == "categories":
cats = client.list_categories(refresh=True)
print("📌 手绘风社区可用板块一览 (发帖可直接指定板块名称或ID):")
print("-" * 65)
for c in cats:
desc = f" - {c['description']}" if c.get("description") else ""
print(f" • [ID: {c['id']:2d}] {c['name']:<12s} ({c.get('slug', 'default')}){desc}")
print("-" * 65)
elif args.command == "post":
res = client.create_topic(
title=args.title,
content=args.content,
category=args.category,
tags=args.tags,
image_path=args.image
)
print(f"🎉 帖子已成功发布至 [{res.get('category_name')}]!")
print(f" 标题: {res.get('title')}")
print(f" 直达链接: {res.get('url')}")
if res.get("image_url"):
print(f" 配图短链: {res.get('image_url')}")
elif args.command == "share":
res = client.share_creation(
image_path=args.image,
prompt=args.prompt,
title=args.title,
category=args.category,
style_id=args.style,
style_name=args.style_name,
color_id=args.color,
notes=args.notes,
tags=args.tags
)
print(f"🎉 作品与提示词已成功分享到 [{res.get('category_name')}]!")
print(f" 标题: {res.get('title')}")
print(f" 直达链接: {res.get('url')}")
elif args.command == "reply":
res = client.reply_topic(
topic_id=args.topic_id,
content=args.content,
image_path=args.image
)
print(f"💬 回复成功!直达链接: {res.get('url')}")
elif args.command == "my-posts":
posts = client.list_my_posts(limit=args.limit)
if not posts:
print("暂未发布任何帖子。快去生成一幅手绘画作分享吧!")
else:
print(f"📚 你在手绘风社区发布的帖子列表 (共 {len(posts)} 条):")
for idx, p in enumerate(posts, 1):
print(f"[{idx}] (ID: {p['topic_id']}) {p['title']}")
print(f" 链接: {p['url']} | 浏览: {p['views']} | 点赞: {p['like_count']} | 回复: {p['posts_count']}")
elif args.command == "delete":
try:
ok = client.delete_post(topic_id=args.topic_id)
if ok:
print(f"🗑️ 帖子 (ID: {args.topic_id}) 已成功删除。")
else:
print(f"删除失败,请检查网络或是否拥有该帖子的删除权限。")
except Exception as e:
print(f"⚠️ {e}")
elif args.command == "deploy":
candidates = [
Path(__file__).resolve().parent / "sync_to_static.py",
Path(__file__).resolve().parents[1] / "scripts" / "sync_to_static.py",
Path(__file__).resolve().parents[2] / "scripts" / "sync_to_static.py",
Path(os.environ.get("HANDRAW_STYLE_ROOT", Path(__file__).resolve().parents[1])) / "scripts" / "sync_to_static.py",
]
sync_script = None
for c in candidates:
if c.exists():
sync_script = c
break
if not sync_script:
print("❌ 未找到 scripts/sync_to_static.py 脚本!")
sys.exit(1)
cmd = [sys.executable, str(sync_script), "--deploy"]
if getattr(args, "git", False):
cmd.append("--git")
print("🚀 正在执行静态画廊与资产部署上云...")
res = subprocess.run(cmd)
if res.returncode != 0:
print(f"❌ 静态部署执行失败 (Exit code {res.returncode})")
sys.exit(res.returncode)
print("\n✅ 风格画廊与静态资产已成功同步部署到云端服务器!")
print(" 风格画廊首页: https://handraw-style.com/gallery/index.html")
print(" 提示词拼装器: https://handraw-style.com/gallery/tutorials.html")
print(" 自建资产图库: https://handraw-style.com/gallery/assets.html")
if getattr(args, "announce", False):
print("\n📢 正在自动生成论坛更新公告并发布至「手绘skill」板块...")
version_path = sync_script.parent.parent / "version.json"
version_str = "最新版"
if version_path.exists():
try:
with open(version_path, "r", encoding="utf-8") as f:
version_str = f"v{json.load(f).get('version', '')}"
except Exception:
pass
manifest_path = sync_script.parent.parent.parent / "handraw-static" / "manifest.json"
styles_count = 365
if manifest_path.exists():
try:
with open(manifest_path, "r", encoding="utf-8") as f:
styles_count = json.load(f).get("styles_count", 365)
except Exception:
pass
title = f"【官方更新】手绘风格画廊 {version_str} 全新上线与在线拼装指南"
content = f"""## 🎨 手绘风格画廊 {version_str} 已同步上线!
手绘风生态静态资源与风格画廊已完成全量更新,包含全量 {styles_count} 种视觉画风、主题色彩、版式结构库以及全新写实摄影与自建资产!
### 🔗 在线直达
- 🏛️ **风格画廊首页**: [https://handraw-style.com/gallery/index.html](https://handraw-style.com/gallery/index.html)
- 🧩 **提示词拼装器与教程**: [https://handraw-style.com/gallery/tutorials.html](https://handraw-style.com/gallery/tutorials.html)
- 🗂️ **自建资产图库**: [https://handraw-style.com/gallery/assets.html](https://handraw-style.com/gallery/assets.html)
欢迎大家在评论区交流画风使用心得或反馈建议!
"""
post_res = client.post_topic(
title=title,
raw=content,
category_name="手绘skill",
tags="更新,画风库,公告,gallery"
)
print(f"🎉 公告帖子已发布至 [{post_res.get('category_name')}]!")
print(f" 标题: {post_res.get('title')}")
print(f" 直达链接: {post_res.get('url')}")
else:
parser.print_help()
if __name__ == "__main__":
cli_main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Unverified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |