@zwbigi/ink-xy 0.1.1 → 0.1.2

package/.next/trace-build

@@ -1 +1 @@
-[{"name":"run-webpack","duration":9866453,"timestamp":20578909385,"id":14,"parentId":1,"tags":{},"startTime":1780565966209,"traceId":"6fca737e6cf29ffc"},{"name":"run-typescript","duration":10915657,"timestamp":20588781210,"id":426,"parentId":1,"tags":{},"startTime":1780565976080,"traceId":"6fca737e6cf29ffc"},{"name":"static-check","duration":4369110,"timestamp":20600012518,"id":429,"parentId":1,"tags":{},"startTime":1780565987312,"traceId":"6fca737e6cf29ffc"},{"name":"static-generation","duration":4402846,"timestamp":20605206753,"id":497,"parentId":1,"tags":{},"startTime":1780565992506,"traceId":"6fca737e6cf29ffc"},{"name":"collect-build-traces","duration":49677260,"timestamp":20604383960,"id":494,"parentId":1,"tags":{},"startTime":1780565991683,"traceId":"6fca737e6cf29ffc"},{"name":"telemetry-flush","duration":72,"timestamp":20654066939,"id":506,"parentId":1,"tags":{},"startTime":1780566041366,"traceId":"6fca737e6cf29ffc"},{"name":"next-build","duration":75395432,"timestamp":20578671594,"id":1,"tags":{"buildMode":"default","version":"16.2.1","bundler":"webpack","has-custom-webpack-config":"false","use-build-worker":"true"},"startTime":1780565965971,"traceId":"6fca737e6cf29ffc"}]
+[{"name":"run-webpack","duration":7494275,"timestamp":21354611587,"id":14,"parentId":1,"tags":{},"startTime":1780566741910,"traceId":"aa5a877b702e0528"},{"name":"run-typescript","duration":7788861,"timestamp":21362109472,"id":426,"parentId":1,"tags":{},"startTime":1780566749408,"traceId":"aa5a877b702e0528"},{"name":"static-check","duration":2741760,"timestamp":21370162115,"id":429,"parentId":1,"tags":{},"startTime":1780566757460,"traceId":"aa5a877b702e0528"},{"name":"static-generation","duration":3039182,"timestamp":21373195327,"id":497,"parentId":1,"tags":{},"startTime":1780566760494,"traceId":"aa5a877b702e0528"},{"name":"collect-build-traces","duration":42773756,"timestamp":21372905445,"id":494,"parentId":1,"tags":{},"startTime":1780566760204,"traceId":"aa5a877b702e0528"},{"name":"telemetry-flush","duration":42,"timestamp":21415682291,"id":506,"parentId":1,"tags":{},"startTime":1780566802981,"traceId":"aa5a877b702e0528"},{"name":"next-build","duration":61281225,"timestamp":21354401118,"id":1,"tags":{"buildMode":"default","version":"16.2.1","bundler":"webpack","has-custom-webpack-config":"false","use-build-worker":"true"},"startTime":1780566741699,"traceId":"aa5a877b702e0528"}]

package/README.md

@@ -113,50 +113,77 @@ graph TD
 
 ## 🧭 快速开始 (Quick Start)
 
-### 1. 基础依赖准备
-确保您的开发环境安装了 **Node.js v20+** 与 **pnpm**：
+### 📦 桌面端 (Standalone App)
+
+#### ⚙️ 1. 前置依赖准备（重要）
+为了能完整使用软件的所有高级功能（例如 Add Skill / 安装外部技能插件），您的系统需要安装并配置好 **Git**：
+* **常见问题**：如果在添加 Skill 时遇到红色报错 `spawn git ENOENT`，说明您的电脑尚未安装 Git，或者 Git 路径未正确配置到系统的环境变量中。
+* **配置步骤**：
+  1. 前往 [Git 官方网站](https://git-scm.com/) 下载适用于 Windows 或 macOS 的最新版安装程序。
+  2. 安装时，建议选择默认设置（特别注意确保勾选 *"Git from the command line and also from 3rd-party software"*，这会自动将 Git 自动添加至系统环境变量 `PATH` 中）。
+  3. 安装完成后，务必完全退出并重启 Pi Agent xY 桌面客户端，以便软件重新加载最新的环境变量。
+
+#### 🖥️ 2. Windows 安装与运行
+1. 前往 GitHub Releases 下载最新生成的 `Pi Agent xY Desktop Setup.exe` 一键安装包。
+2. 双击运行 `.exe` 文件，跟随向导完成一键安装。
+3. 安装完成后，即可直接通过桌面快捷方式或开始菜单打开客户端。
+
+#### 🍏 3. macOS 安装与运行 (重要)
+1. 前往 GitHub Releases 下载 `.dmg` 安装包。
+2. 双击打开并将应用拖拽至 `Applications` (应用程序) 目录中。
+3. ⚠️ **macOS 提示“文件已损坏”或“身份不明的开发者”解决办法**：由于 standalone 桌面客户端未在 Apple 开发者账号进行官方代码签名，macOS Gatekeeper 安全体系可能会在首次打开应用时拦截，并弹出“软件已损坏，无法打开”或“无法验证开发者”等警告。
+4. **极速解锁与绕过指令**：请打开您的 Mac 终端（Terminal），直接复制并执行以下命令（以清除 macOS 的隔离 quarantine 标识属性）：
+   ```bash
+   xattr -cr /Applications/Pi\ Agent\ xY\ Desktop.app
+   ```
+   运行后，即可直接在 Launchpad 或 Applications 中双击秒开，完美运行！
+
+#### 🛠️ 开发调试 (Dev Mode)
+```bash
+# 1. 编译本地 InkOS 子模块 (首次或代码更新后需要)
+cd inkos && pnpm install && pnpm build && cd ..
+
+# 2. 安装 Next.js 项目依赖
+npm install
 
+# 3. 并发启动 Next.js 本地微服务并自动唤起 Electron 主窗口
+npm run electron:dev
+```
+
+#### 📦 生产打包 (Production Build)
 ```bash
-# 全局安装 pnpm (如果尚未安装)
-npm install -g pnpm
+# 自动编译 Next.js production 优化包并生成 Windows/macOS 原生安装程序
+npm run electron:build
 ```
 
-### 2. 编译本地 InkOS 子模块
-`ink-xY` 将 `InkOS` monorepo 仓库作为核心写作算力子包，存放于根目录下的 `inkos/` 中。启动前需要完成子包的本地构建：
+---
 
-```bash
-# 进入 inkos 文件夹并安装依赖
-cd inkos
-pnpm install
+### 🌐 网页端 (Web UI)
 
-# 执行 InkOS 引擎编译
-pnpm build
-cd ..
+#### 1. 免安装瞬时运行 (NPX)
+```bash
+npx @zwbigi/ink-xy@latest
 ```
 
-### 3. 运行本地开发服务器
-回到 `ink-xY` 项目根目录，安装主项目依赖并启动 Web 开发服务器：
-
+#### 2. 全局安装使用
 ```bash
-# 安装主项目依赖
-npm install
+# 全局安装包
+npm install -g @zwbigi/ink-xy
 
-# 启动 Next.js 极速开发服务（本地监听端口 30142）
-npm run dev
+# 启动客户端
+ink-xy
 ```
+启动后自动在浏览器拉起工作台：`http://localhost:30142`
 
-### 4. 运行 Typecheck 与 Lint 校验
+#### 3. 丰富命令行参数
 ```bash
-# 静态类型安全校验 (忽略 inkos 嵌套干扰)
-node_modules/.bin/tsc --noEmit
+ink-xy --port 8080               # 自定义启动端口
+ink-xy --hostname 127.0.0.1      # 限制仅本机回环访问
+ink-xy -p 8080 -H 127.0.0.1      # 参数组合使用
 
-# 运行代码规范检测
-node_modules/.bin/eslint .
+PORT=8080 ink-xy                 # 也支持环境变量注入
 ```
 
-> [!WARNING]
-> **绝对不要在开发期间运行 `next build`**。这会污染 `.next/` 生成文件，从而导致 `npm run dev` 运行异常。
-
 ---
 
 ## 🔒 隐私隔离与路径规范 (Privacy & Data Isolation)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zwbigi/ink-xy",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "author": "demon820308",
   "description": "ink-xY Novel Studio - Professional Intelligent Collaborative Novel Editor",
   "main": "electron/main.js",
@@ -9,7 +9,7 @@
     "url": "git+https://github.com/demon820308/ink-xy.git"
   },
   "bin": {
-    "pi-agent-xy": "bin/pi-web.js"
+    "ink-xy": "bin/pi-web.js"
   },
   "files": [
     "bin",