Skip to content

Releases: zhyuzh3d/PoseGi

PoseGi 0.1.3

Choose a tag to compare

@zhyuzh3d zhyuzh3d released this 26 Sep 06:20

PoseGi 是一个可直接运行在 HermitApp 中的 3D 摆姿 happ:在手机上直接拖动人形角色的关节摆好造型,把渲染出来的画面连同角色描述一起交给你自己配置的生图服务,得到一张有姿态,有构图,也符合你描述的图。不内置任何平台 API Key,作品与配置全部保存在本机。

这是 0.1.2 之后的一次小版本,只做应用图标,把上一版的两处问题修掉。


下载

文件 说明
PoseGi-v0.1.3-web.1.zip happ 发布包,460,086 字节。与官网安装清单指向的是同一个文件
  • SHA-256:30b3a081f56ed5728539510bb770a434f34f73919f91cb0a066e85d1f1fe4201

安装 / 更新

PoseGi 是 happ,不能脱离宿主单独安装,顺序是「先装宿主,再添加应用」。

  1. 安装宿主 HermitApp(Android 10 及以上)。
  2. 添加 PoseGi,二选一:
  3. 已经在用旧版的话,照上面任一条再走一次就是更新 —— version.code 从 4 升到 5,宿主会认作新版本,作品与配置保留。

图标换了之后要看到新图标,必须装上这个包:桌面快捷方式和 Hermit 应用库里的图标取自包里的那张图,不会因为网页换了就跟着变。

本次更新(0.1.3)

上一版的两个毛病

底部和四周有黑边。 上一版是在一张 794×814 的转载图上做的:那张图的主体包围盒偏竖,补成正方形之后四面都留了一条边,底部尤其像一条黑框。这一版换回设计原图(1920×1910),重新量了一次主体。

标签页里是硬角方图。 浏览器标签页不吃 border-radius,任何靠 CSS 做的圆角到了 favicon 上都不存在,所以标签栏里一直是一块直角黑方块。

这次怎么做的

  • 先排除原图自带的非设计内容,再量主体。 原图右上角有一段生成器留下的折线残迹,右边缘在字标高度上还有一条竖向残迹。直接按亮度求包围盒会把这条竖残迹算进主体,于是裁出一个明显偏右的方框 —— 图标右侧凭空多出一条黑带。脚本里那三块 IGNORE 窗口就是干这个的,排除之后主体是 1249×1365。
  • 方框边长取内容高,横向以内容居中。 结果是上下贴齐不留边,左右各让一小条(约 4%)。反过来取内容宽会在头顶和字标底部各留 195 px 黑边,那正是上一版的毛病。
  • 圆角直接烘进图里。 宿主端各处的圆角本来就不统一(分享页 25.9%,备份页 28.6%,应用库 32%),再加上浏览器标签页根本没有圆角,所以一次烘好、处处一致。半径取 24% 而不是站点 CSS 的 29%:字标左端那一点到左下角圆心的距离算下来,半径超过 26% 就会啃到「P」。
  • favicon 另出 192×192 PNG。 iOS 的 apple-touch-icon 不吃 WebP;换文件名同时也绕开了浏览器里已缓存的旧图。

tools/make-icon.py 跟着重写:自动测量主体(带 IGNORE 窗口),圆角参数化,按输出后缀决定格式(.png → PNG,其余 → WebP)。源图仍然归档在 docs/assets/posegi-icon-source.png,一处源图,多处派生。

现在这几处是同一份字节

c0678a6ab8b8442110cd16dc9af77173863df862ae9b7ea208be77d00a96cd9e

  • app/assets/icon.webp —— 随包分发,决定桌面快捷方式与 Hermit 应用库,管理页,分享页上的图标。
  • 官网 assets/site/posegi.webp —— 页头品牌标记与广场卡片。
  • 下载位的 icon.webp —— 由网站工具从发布包里提取,不单独维护。

官网 favicon 与 apple-touch-icon 另用新出的 posegi-icon-192.png。

应用内顶栏那一处仍是有意保留的例外

「软件信息」面板里的图标跟着更新;顶栏那个 24 px 的字母块依旧保留。同一张图缩到 24 px 只剩一团发光的糊点,而它旁边紧挨着就是「PoseGi」这几个字,再放一个认不出的图标只是噪声。

它还能做什么

这一版没有功能变化。摆姿(十四段骨架,逐关节拖动,每个关节只在自己的解剖范围内活动,自写 IK 让整条链跟着走,五种预设姿态),成图(CVP / OpenAI Images 兼容 / SD WebUI / Stability 四类接口),作品形态(标题 + 描述 + 最多 12 张属于它的成图)都与 0.1.1 相同 —— 详见 0.1.1 的发布说明。

相关链接


English summary — PoseGi is a 3D posing happ for HermitApp: drag the joints of a humanoid rig on your phone, then hand the render plus a character description to a generative image service you configure. This release only fixes the application icon. The previous artwork was derived from a 794×814 copy whose subject box was portrait, so squaring it left a black band on all four sides, most visible at the bottom; and being a square image it rendered as a hard-cornered block in the browser tab, because favicons ignore border-radius. The icon is now derived from the original 1920×1910 render: non-design content that ships inside that file (a generator artifact top-right, a vertical artifact along the right edge, a watermark) is excluded before measuring, the square takes the subject's height so top and bottom sit flush with only ~4% given to the sides, and a 24% corner radius is baked in with transparent corners so every surface matches. The favicon is a separate 192×192 PNG, since iOS does not accept WebP for apple-touch-icon. The 24 px letter tile in the app's top bar is still deliberately unchanged. version.code moves from 4 to 5, so installing this over 0.1.2 is a normal update — your artworks and settings are kept.

PoseGi 0.1.2

Choose a tag to compare

@zhyuzh3d zhyuzh3d released this 26 Sep 05:42

PoseGi 是一个可直接运行在 HermitApp 中的 3D 摆姿 happ:在手机上直接拖动人形角色的关节摆好造型,把渲染出来的画面连同角色描述一起交给你自己配置的生图服务,得到一张有姿态,有构图,也符合你描述的图。不内置任何平台 API Key,作品与配置全部保存在本机。

这是 0.1.1(首个正式版)之后的一次小版本,只做应用图标。


下载

文件 说明
PoseGi-v0.1.2-web.1.zip happ 发布包,453,960 字节。与官网安装清单指向的是同一个文件
  • SHA-256:1c9e065aed1bce0222391826b9a33fcdfe8ea6cf3953a68dc715b5c7fc98bfc6

安装 / 更新

PoseGi 是 happ,不能脱离宿主单独安装,顺序是「先装宿主,再添加应用」。

  1. 安装宿主 HermitApp(Android 10 及以上)。
  2. 添加 PoseGi,二选一:
  3. 已经在用旧版的话,照上面任一条再走一次就是更新 —— version.code 从 3 升到 4,宿主会认作新版本,作品与配置保留。

图标换了之后要看到新图标,必须装上这个包:桌面快捷方式和 Hermit 应用库里的图标取自包里的那张图,不会因为网页换了就跟着变。

本次更新(0.1.2)

换上正式品牌图

图标从一个扁平的骨架示意换成正式的品牌图:木质关节人偶摆好姿势,下面一行发光的 PoseGi 字标。

设计原图归档在 docs/assets/posegi-icon-source.png,并新增 tools/make-icon.py 由它生成图标 —— 和同族的 VibeDraw 一个做法,一处源图,多处派生,不会再出现「官网换了一个版本、包里还是旧的」这种情况。脚本做了两件原图没直接提供的事:

  • 原图 794×814,不是正方形,而所有会显示图标的位置都是。做法不是压扁,而是按主体裁掉近黑的留白,再补成正方形缩到 512 —— 人偶与字标保持原设计的位置,没有被重新构图。
  • 它是写实渲染,不是扁平标记。 兄弟仓库的图标都是扁平图形,所以那边写的是无损 WebP;一张带明暗的 3D 渲染写无损要几百 KB,这里改用 quality 92 的有损,肉眼看不出差别,成品 20 KB。

现在这几处是同一份字节

  • app/assets/icon.webp —— 随包分发,决定桌面快捷方式与 Hermit 应用库,管理页,分享页上的图标。
  • 官网 assets/site/posegi.webp —— 同时是页头品牌标记,favicon,apple-touch-icon 与应用广场卡片上的图。
  • 下载位的 icon.webp —— 由网站工具从发布包里提取,不再单独维护。

应用内那两处的一个取舍

「软件信息」面板里 38px 的字块换成了真实图标 —— 38px 是这套品牌图还能看清字标的最小尺寸。

顶栏那个 24px 的字母块保留原样。 同一张图缩到 24px 只剩一团发光的糊点,而它旁边紧挨着就是「PoseGi」这几个字,再放一个认不出的图标只是噪声。这是有意留下的例外,不是漏改。

它还能做什么

这一版没有功能变化。摆姿(十四段骨架,逐关节拖动,每个关节只在自己的解剖范围内活动,自写 IK 让整条链跟着走,五种预设姿态),成图(CVP / OpenAI Images 兼容 / SD WebUI / Stability 四类接口),作品形态(标题 + 描述 + 最多 12 张属于它的成图)都与 0.1.1 相同 —— 详见 0.1.1 的发布说明。

相关链接


English summary — PoseGi is a 3D posing happ for HermitApp: drag the joints of a humanoid rig on your phone, then hand the render plus a character description to a generative image service you configure. This is a small release after 0.1.1 that only swaps the application icon for the official brand artwork. The source render is archived in the repository and a new tools/make-icon.py derives the icon from it (the artwork is not square, so it is cropped to the subject and re-padded rather than squashed; it is photographic, so the WebP is lossy at quality 92 — 20 KB instead of several hundred). The packaged icon, the website brand mark and the gallery icon are now the same bytes. The 24 px letter tile in the app's top bar is deliberately unchanged: at that size the artwork is an illegible smudge and the word "PoseGi" already sits right next to it. version.code moves from 3 to 4, so installing this over 0.1.1 is a normal update — your artworks and settings are kept.

PoseGi 0.1.1

Choose a tag to compare

@zhyuzh3d zhyuzh3d released this 26 Sep 05:34

PoseGi 是一个可直接运行在 HermitApp 中的 3D 摆姿 happ:在手机上直接拖动人形角色的关节摆好造型,把渲染出来的画面连同角色描述一起交给你自己配置的生图服务,得到一张有姿态,有构图,也符合你描述的图。不内置任何平台 API Key,作品与配置全部保存在本机。

全部是原生 HTML,CSS,JavaScript 源码(3D 视图用 WebGL 自绘,没有第三方引擎,没有构建步骤),你可以在开发模式下直接改它。

这是 PoseGi 的第一个正式版本。


安装

PoseGi 是 happ,不能脱离宿主单独安装,顺序是「先装宿主,再添加应用」。

  1. 安装宿主 HermitApp(Android 10 及以上)。
  2. 添加 PoseGi,二选一:
  3. 进「设置 → 模型」添加一个生图服务:本地 ComfyUI,SD WebUI,OpenAI Images 兼容接口或 Stability 都行,填地址或 API Key,点「测试连接」确认通。

下载

文件 说明
PoseGi-v0.1.1-web.1.zip happ 发布包,442,762 字节。与官网安装清单指向的是同一个文件
  • SHA-256:8fa38254f1076403c93c95eae4a17bbe5c2dc94ced36e53c25dcd7d5f4387758

happ 运行在 Hermit 的 WebView 里,浏览器打不开这个包。日常添加走上面第 2 步的安装清单最省事;发布包适合留存,查看源码或手动导入。

它能做什么

摆姿

  • 十四段骨架,可逐关节拖动:源点,骨盆,腰,胸,颈,头,左右肩,上臂,前臂,手,左右大腿,小腿,脚。点中关节直接拖,旋转按关节自己的局部轴走,不是把整个模型拧来拧去。
  • 每个关节都有自己的活动范围:手 x ∈ [-70, 80],脚 x ∈ [-50, 25],膝只许向后弯(小腿 x ∈ [-150, 0])……超出范围会被夹住,所以摆不出「膝反张」「肩后伸 130 度」这类解剖上不存在的姿势。
  • 五种预设姿态:站姿,T 字,行走,举手,坐下。预设写的是相对休息姿态转多少度,不是绝对角度,所以换成外部模型(它的绑定姿态可能完全不同)预设依然成立。
  • 纯前端解算:拖动用的是自写的 IK —— 两节肢体(上臂-前臂,大腿-小腿)走闭式解,其余用 CCD 迭代收敛(12 次迭代,单步上限 14°,容差 0.004)。所以拖手的时候肘和肩会自己让位,不需要你一段一段摆。
  • 取景与截图:环境球拖视角,双指缩放,网格地面给个参照;渲染出画面后一键截图送进作品。界面固定深色 —— 这是刻意的,环境球跟着系统切亮色会让「深色场景」的定位散掉。

成图

  • 四类接口:CVP(ComfyUI 插件,推荐) / OpenAI Images 兼容 / Stable Diffusion WebUI · Forge / Stability AI。
  • 画幅 512–1024(正方):按所选接口自报的能力取值 —— CVP 的快速任务是 512,高质量重绘是 1024,render 那一路 512–1024 每 64 一档。
  • 参考图强度 0–200(100 为中性):调低更贴近你摆好的姿态,调高更放开让模型重画。这一项只对 CVP 生效。
  • 角色描述可中英双语:描述会译成英文再提交(出图模型对英文更稳),原文与译文成对保存 —— 你改了原文,旧译文自动作废,不会拿着过期译文去生图。
  • 作品 = 标题 + 描述 + 属于它的历史成图(最多 12 张):成图挂在作品下面,换作品就是换一组成图,历史成图跟随作品保存,不需要额外「另存」。

用本地 ComfyUI 出图(推荐)

装 VibeDraw 的 ComfyUI 插件(v2.2.0)到你自己已经跑起来的 ComfyUI 上,然后让 PoseGi 连它:

  • 插件把「这台机器能做什么」通过 /vibedraw/v1/plugins 与 /capabilities 自报,PoseGi 点「测试连接」时读它,再按实际报出来的能力决定表单里有哪些任务 —— 不是硬编码一套固定的任务名。
  • 快速草图是 512 画幅,一两秒出图;放大任务把 1024 渲染图补细节,构图基本不动;高质量重绘(render)会按参考图重新作画,是这里最重也最像成片的一档,单张几十秒。
  • 装好后可以用 curl -s http://127.0.0.1:8188/cvp/info 确认插件活着(spec 应为 cvp/1)。

本次更新(0.1.1:首个正式版)

骨架按解剖学校正

初版的骨架能摆,但摆出来的东西经不起看:预设里的「举手」是靠肩关节向后甩 130 度实现的(人体实际后伸约 60 度),坐下的髋与膝符号写反了 —— 越想坐下越像跪着往后翻。这一版按解剖学重做了关节轴向与活动范围,五个预设逐个手算角度重写,并补上了范围校验:越界的值会被夹住,而不是原样生效。

自写 IK

拖动从「直接改这一段的旋转」变成「按目标点解算整条链」:两节肢体闭式解,其余 CCD 迭代。拖手的时候肘与肩会跟着让位,手也就真的落在你按的地方。

作品形态定型

「作品」不再是一次性的结果图,而是标题 + 描述 + 属于它的历史成图(最多 12 张)这样一个整体。成图跟随作品保存 —— 这是数据形状本身保证的,不靠某个保存时机去补救。

视口重写

环境球,相机,网格地面,关节高亮与拖拽反馈全部重做;界面按钮重新分成三组(底部常驻 / 关节与姿态 / 作品与成图)。

生图链路

新增 CVP(按插件自报能力选任务)与 Stability 两路,与既有的 SD WebUI,OpenAI Images 兼容接口并列;画幅与参考图强度改为按目标接口的能力夹取,不再往所有接口发同一套参数。中文描述改由图侧翻译,应用内的旧翻译路径退役。

官网与开源配套

官网 https://posegi.airen.life/ 上线;README 按 GitHub 项目规范重写,补上 CONTRIBUTING.md,MIT LICENSE 与 Issue 模板。应用标识为 life.airen.posegi。

相关链接


English summary — PoseGi is a 3D posing happ for HermitApp: drag the joints of a humanoid rig on your phone, then hand the render plus a character description to a generative image service you configure. It cannot be installed standalone — install HermitApp first, then add PoseGi from the gallery. This is the first official release: an anatomically corrected rig with real joint limits, hand-written IK (closed-form for two-bone chains, CCD for the rest), five presets rewritten as offsets from the rest pose, a rebuilt WebGL viewport, a work model where a title + description + up to 12 finished images travel together, and four image backends including CVP via the VibeDraw ComfyUI plugin.