openxiangda 1.0.21 → 1.0.24

package/README.md

@@ -7,21 +7,20 @@ It uses normal platform user login tokens through `/openxiangda-api/v1`; it does
 Private platform routing is fixed: backend APIs are under `/service`, platform management is under `/platform`, and app runtime access is under `/view`. Passing a root domain such as `https://yida.wisejob.cn/` to the CLI is supported; OpenXiangda stores the API base as `https://yida.wisejob.cn/service`.
 
 ```bash
-npm install -g .
-# or during local development:
+npm install -g openxiangda@latest --registry=https://registry.npmjs.org
+openxiangda update check
+openxiangda skill install
+
+# during local development:
 npm link
 
-openxiangda skill install
 openxiangda skill status
-openxiangda workspace init ./my-app-workspace
-cd ./my-app-workspace
-pnpm install
 openxiangda platform add dev https://dev-lowcode.example.com
 openxiangda login --profile dev
 openxiangda env
-openxiangda app list --profile dev
-openxiangda workspace bind --profile dev --app-type APP_XXXX
-cd /path/to/sy-lowcode-app-workspace
+openxiangda workspace init ./my-app-workspace --profile dev --app-name "示例应用"
+cd ./my-app-workspace
+pnpm install
 openxiangda workspace publish --profile dev
 openxiangda menu list --profile dev
 openxiangda workflow list --profile dev
@@ -37,6 +36,16 @@ openxiangda app snapshot APP_XXXX --profile dev --json
 
 User tokens are stored in `~/.openxiangda/profiles.json` with `0600` permissions. Project state is stored in `.openxiangda/state.json` and contains only profile-specific resource IDs.
 
+Use the official npm registry for OpenXiangda updates:
+
+```bash
+npm install -g openxiangda@latest --registry=https://registry.npmjs.org
+openxiangda update check --json
+openxiangda update install
+```
+
+Domestic npm mirrors may lag and return an older OpenXiangda version. `openxiangda update check --json` is designed for AI agents: it returns the installed version, latest official npm version, whether an update is available, and the compatibility commands to run after updating. `openxiangda update install` installs from the official registry and refreshes OpenXiangda skills by default.
+
 Codex skills are installed separately from login/profile state. Run `openxiangda skill install` after installing or linking the CLI. It installs the `openxiangda` root skill plus the 7 top-level subskills into `${CODEX_HOME:-~/.codex}/skills` by default:
 
 - `openxiangda`
@@ -50,10 +59,19 @@ Codex skills are installed separately from login/profile state. Run `openxiangda
 
 Use `openxiangda skill install --dest <skills-dir>` to target a different Codex skills directory. If a same-name skill exists but was not installed by OpenXiangda, the command refuses to overwrite it unless `--force` is provided. Restart Codex after installing skills.
 
-Create a new publishable app workspace with `openxiangda workspace init <dir>`. The command writes a minimal `sy-lowcode-app-workspace` template with React, Ant Design, the single `openxiangda` package, and the required `publish:all` / `openxiangda:publish` scripts. Use `--install` to run `pnpm install` immediately, or run it manually after creation. You can also bind during initialization:
+Create a new publishable app workspace with `openxiangda workspace init <dir>`. The command writes a minimal `sy-lowcode-app-workspace` template with React, Ant Design, the single `openxiangda` package, and the required `publish:all` / `openxiangda:publish` scripts. Use `--install` to run `pnpm install` immediately, or run it manually after creation.
+
+Local workspace state is authoritative. If the current folder has no `.openxiangda/state.json` app binding, create a new app instead of searching the platform for a similar app name:
+
+```bash
+openxiangda workspace init ./my-app-workspace --profile dev --app-name "示例应用"
+```
+
+Bind to an existing app only when the user explicitly provides an `appType` or asks to reuse an existing platform app:
 
 ```bash
 openxiangda workspace init ./my-app-workspace --profile dev --app-type APP_XXXX
+openxiangda workspace bind --profile dev --app-type APP_XXXX
 ```
 
 表单页、流程表单页和自定义代码页都应在 `sy-lowcode-app-workspace` 中实现，由 `openxiangda workspace publish --profile <name>` 统一构建、上传 OSS 并注册到平台。`openxiangda form create`、`form publish`、`page publish` 只作为底层修复/诊断命令，不作为 AI 生成页面的主入口。