human2ai 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 贾思斋
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,120 @@
+# Human2AI
+
+Human2AI 是供人和 AI Agent 协作的本地视觉工作区：用户在桌面浏览器中编辑构图、UI 草图和 3D 空间，Agent 通过 CLI 连接同一会话、读取版本、修改和导出结果。
+
+## 环境要求
+
+- Node.js 22 或更高版本；源码开发使用 npm 11。
+- 桌面电脑浏览器。
+- SQLite 和图片处理使用原生依赖，安装包需要与本机操作系统、架构和 Node.js 版本匹配。
+
+## 安装与使用
+
+在需要接入 Human2AI 的项目中执行：
+
+```bash
+npm install --save-dev human2ai
+npx --no-install human2ai integration install --agent codex --mode copy
+npx --no-install human2ai web
+```
+
+保持服务终端运行，在浏览器打开 <http://127.0.0.1:4179>。安装包包含预构建的 Web 页面、CLI、数据库迁移、Schema 和消费项目 Skill。
+
+接入命令生成 `.human2ai/integration.json` 和 `.agents/skills/human2ai/`。连接配置包含本机路径，由生成的 `.gitignore` 排除；Skill 可以随消费项目提交。Agent 按配置中的 runner 调用 CLI。
+
+```bash
+npx --no-install human2ai service status
+npx --no-install human2ai session connect --session <session-id>
+npx --no-install human2ai session open --session <session-id>
+```
+
+`session connect` 返回浏览器地址、最新 Capture 版本和当前会话支持的命令。`capture get` 读取指定版本，`capture save` 保存新版本，`capture undo` 追加恢复版本。不同项目通过项目 ID 和会话 ID 组织在同一本地服务中。
+
+构图和 UI 会话可使用 `/styles/` 中的风格库。Agent 可通过 `style list|get|create|update|add-reference|remove-reference|delete` 操作同一风格库。完整命令和协作方式见 [Human2AI Skill](skills/human2ai/SKILL.md)。
+
+## 数据与产物
+
+| 环境 | API 端口 | 数据库 | 服务图片与风格参考图 |
+| --- | --- | --- | --- |
+| npm 安装版 | `4179` | `~/.human2ai/human2ai.sqlite` | `~/.human2ai/artifacts/` |
+| 源码 `npm run dev` | `4180` | `<源码仓库>/.human2ai-data/human2ai.sqlite` | `<源码仓库>/.human2ai-data/artifacts/` |
+
+开发版与安装版分别保存数据。`HUMAN2AI_PORT`、`HUMAN2AI_DATABASE_PATH` 和 `HUMAN2AI_ARTIFACTS_PATH` 可覆盖对应设置；未单独设置图片目录时，它位于数据库同级的 `artifacts/`。服务只监听本机回环地址。
+
+在 Human2AI 源码仓库中，导出的图片、提示词记录和临时结果统一放到 `.human2ai-data/output/`；已有构图产物可放到 `.human2ai-data/exports/`，备份放到 `.human2ai-data/backups/`。CLI 的 `--output` 和 `--preview` 按指定路径写入，调用者应选择这个被忽略的目录。
+
+例如，从开发服务中导出一个已保存版本的 UI 草图；输出文件扩展名可选 `.png` 或 `.svg`：
+
+```bash
+mkdir -p .human2ai-data/output
+npm run cli -- --api-url http://127.0.0.1:4180 ui-layout render --session <session-id> --revision <revision> --output .human2ai-data/output/ui-layout.png
+```
+
+内部 `docs/` 和 `.human2ai-data/` 保留在本地，均不提交 Git、不进入 npm 包。数据库及其 WAL/SHM 文件也由忽略规则排除。停服后备份整个数据目录，可同时保留数据库和图片；在线备份数据库应使用 SQLite backup API。
+
+## 源码开发与日常使用
+
+在 Human2AI 源码仓库执行：
+
+```bash
+npm ci
+npm run dev
+```
+
+Web 开发页面为 <http://localhost:3000>，API 为 <http://127.0.0.1:4180>。Web 支持热更新，API 源码变化后自动重启。端口已有兼容服务时会复用它；要运行修改后的后端，先停止该端口上的旧服务。
+
+另开终端，在源码仓库直接运行 CLI 源码：
+
+```bash
+npm run cli -- --api-url http://127.0.0.1:4180 --web-url http://localhost:3000 service status
+```
+
+从源码仓库将 Skill 接入另一个本地项目：
+
+```bash
+npm run build:server
+npm run cli -- --api-url http://127.0.0.1:4180 --web-url http://localhost:3000 integration install --agent codex --root /absolute/path/to/consumer --mode copy
+```
+
+开发服务由源码仓库的 `npm run dev` 保持运行。接入配置中的 CLI runner 指向源码仓库的 `dist/cli/main.js`；CLI 源码修改后运行 `npm run build:server`，也可以直接使用上面的 `npm run cli`。`--mode link` 只链接 Skill 文件。
+
+源码 Skill 更新后运行 `integration sync --check` 检查，再运行 `integration sync` 同步。消费项目修改过的 Skill 出现冲突时会保留其修改。
+
+Storybook 使用 `npm run storybook`，默认地址为 <http://localhost:6006>。已同步的 UI 源码可以独立构建；只有维护者更新上游 YisiUI 时才需要访问私有源。
+
+## 升级安装版
+
+在消费项目执行：
+
+```bash
+npm install --save-dev human2ai@latest
+npx --no-install human2ai integration sync --check
+npx --no-install human2ai integration sync
+```
+
+升级前停止服务并备份数据目录，升级后重新运行 `human2ai web`。数据库迁移在启动时执行；软件版本回退时应使用对应版本的数据备份。
+
+## 验证与本地打包
+
+```bash
+npm run repository:check
+npm run i18n:check
+npm run domain-baseline:check
+npm run domain-baseline:test
+npm run typecheck
+npm test
+npm run pack:check
+```
+
+生成安装包后，在独立消费项目中安装验证：
+
+```bash
+mkdir -p .human2ai-data/packages
+npm pack --pack-destination .human2ai-data/packages
+```
+
+在独立项目中执行 `npm install --save-dev /absolute/path/to/human2ai-0.1.0.tgz`，再按安装步骤接入并启动。安装包检查会验证必需文件和许可证，并拒绝内部文档、数据库及用户产物。
+
+## 许可证
+
+Human2AI 自有代码采用 [MIT](LICENSE)，版权署名为贾思斋。YisiUI 的完整 MIT 许可证随安装包保存在 `licenses/YisiUI-LICENSE`。Quaternius 模型保留其 [CC0 声明](assets/quaternius/License_Standard.txt)；依赖的原始许可声明随包保存在 `licenses/THIRD-PARTY-NOTICES.txt`，继续适用各自的许可证。

package/assets/quaternius/License_Standard.txt

@@ -0,0 +1,22 @@
+This is the standard FREE version of the Universal Base Characters Kit, which only contains 
+a portion of the models . You can buy the SOURCE version which has all the models with rigged .blends,
+and Unity(URP), Unreal Engine and Godot projects
+with custom shaders already set up.
+
+You can get the other version from the website https://quaternius.com
+
+-------------------------------------------------------
+License:
+CC0 1.0 Universal (CC0 1.0) 
+Public Domain Dedication
+https://creativecommons.org/publicdomain/zero/1.0/
+
+------------------------------------------------------
+Models by @Quaternius
+Consider supporting me on Patreon!
+
+https://www.patreon.com/quaternius
+
+-------------------------------------------------------
+Join the Discord Server:
+https://discord.gg/vJqnRUYRfT

package/assets/quaternius/README.md

@@ -0,0 +1,31 @@
+# Quaternius Universal Base Characters
+
+Source: https://quaternius.com/packs/universalbasecharacters.html
+Official free download: https://quaternius.itch.io/universal-base-characters
+Author: Quaternius. License: CC0 1.0, see License_Standard.txt.
+Downloaded 2026-09-09, Standard package updated 2025-12-16.
+
+Included sources: Superhero_Male_FullBody.gltf and Superhero_Female_FullBody.gltf,
+each with its original geometry/skin buffer.
+The free pack currently includes the Superhero variants; the Regular and Teen
+models advertised for the full kit are not bundled here. No paid assets are used.
+
+The app uses the original character geometry and reduced skin weights, retargeted
+to its editable joints/bones. It uses plain configurable body color, eyes and brows;
+external texture images referenced by the original source glTF are intentionally
+omitted. This glTF is the geometry conversion input, not a standalone textured viewer asset.
+
+Rebuild the runtime asset:
+
+    node scripts/prepare-spatial-model.mjs assets/quaternius/Superhero_Male_FullBody.gltf
+    node scripts/prepare-spatial-model.mjs assets/quaternius/Superhero_Female_FullBody.gltf
+
+The derived JSON is emitted into src/domain/spatial/assets and included in both
+browser and server builds. The male source retains 8,483 vertices and 14,318
+triangles; the female source retains 8,844 vertices and 15,060 triangles. Each
+uses its own anatomical landmarks with the same joint IDs and rendering path.
+Duplicated limbs/heads reuse the real mesh modules and skin weights. Attachments
+are overlapping mesh seams, not an automatic watertight topology union. The five finger chains retain their original skin weights; the palm and each
+phalange are separately selectable. Thumb articulation includes the metacarpal
+and two phalanges. Fixed palm-to-finger attachments have no skin module.
+Textures remain deferred.