@succsoft/succapp 5.0.7 → 5.0.9

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # CHANGELOG
 
+## 5.0.9(2026-10-28)
+
+- 将低代码开发命令集中到 `dev` 域，元数据校验命令统一为 `dev file check`；接入服务端检查和自动修复，保留原始诊断，完善版本、引用和字段校验提示。
+- 新增组件属性、方法、事件、能力、子组件、布局、风格、颜色和主题色板查询，支持按目标位置发现可用资源、模板、显示格式和表达式函数。
+- 统一参考资料阅读入口与帮助展示，支持独立安装文档 Skill、下载服务器开发资料，并完善 DTS 导航、资源标签筛选和 HTTP 缓存。
+- 新增计划任务管理与运行查询、加工节点预览和后端任务取消，完善长任务进度、请求取消与认证刷新隔离。
+- 支持服务器文件夹创建、移动和重命名，支持临时 TypeScript 脚本及 dry-run；统一路径、输入输出、错误建议和锁竞争诊断。
+- 完善模型查询与可选严格校验、加工预览参数、元数据类型声明及同步保护，修复 VS Code 新建文件后资源树不刷新的问题。
+
+## 5.0.8(2026-10-10)
+
+- 推送前检查元数据内容版本，需要升级时阻止整批上传；VS Code 支持确认升级后重新推送，CLI 提示先升级，并记录具体文件和版本的失败日志。
+- 修复 VS Code 对包含大写字符的工作区路径或服务器地址生成差异文档 URI 后，可能无法读取同步基线的问题。
+- 克隆成功后的辅助初始化遇到工作区锁占用时跳过，避免把已完成的克隆误报为失败；完善文件已是最新版时的升级提示。
+- 补充差异对比、重命名、重置和推送的回归用例，统一真实服务器测试的源码同步保护，并改用模型接口准备权限数据。
+- 本机发布支持 npm 登录会话和 Microsoft Entra ID 认证，统一检查、打包、发布及失败补发流程。
+
 ## 5.0.7(2026-08-17)
 
 - 修复批量 clone 文件时 Node 内置 Undici 可能在响应流背压与服务器关闭连接同时发生时触发断言并终止进程的问题；SuccApp 改用显式固定的已修复 Undici，并将 CLI 最低 Node.js 版本提升到 22.19.0。

package/README.md

@@ -35,11 +35,13 @@ succapp auth login <server-url>
 succapp workspace project clone <project>
 succapp workspace status --json
 succapp workspace status --pretty-json
-succapp workspace file diff <path>
+succapp dev file diff <path>
 succapp workspace push <path>
 ```
 
-`auth login` 使用默认登录方式，会打开浏览器完成 OAuth2 授权；无法自动打开浏览器时，按命令输出的授权地址在浏览器中完成登录即可。PAT 仅作为受限环境下的显式备用方式，不作为推荐登录路径。
+`auth login` 使用默认登录方式，会打开浏览器完成 OAuth2 授权；无法自动打开浏览器时，按命令输出的授权地址在浏览器中完成登录即可。无人值守脚本或无法完成浏览器授权的环境，可显式使用 `--pat` 并通过标准输入提供令牌。
+
+本地相对路径以当前执行目录为基准。可用 `-C <目录>` 指定执行目录，CLI 会从该目录向上识别工作区；`-C` 没有长选项，只能指定一次；相对目录以启动目录为基准，重复或空值会报错。服务器资源参数使用服务器元数据绝对路径。默认结果中的本地路径相对执行目录；JSON 使用 `localPath`／`remotePath` 区分本地和远程绝对路径，`inputPath` 仅回显原输入。完整规则见 [CLI 路径约定](https://docs.succapp.com/ai/connect/cli#paths)。
 
 其中 `workspace push` 会写入服务器。推送前应先检查差异；生产服务器必须按团队发布流程确认。
 
@@ -68,6 +70,6 @@ code --install-extension succapp-for-vscode-版本号.vsix
 
 更多使用说明见产品手册：
 
-- [AI 低代码开发](https://docs.succbi.com/v5/dev/ai-building)
-- [SuccApp CLI](https://docs.succbi.com/v5/dev/ai-building/cli)
-- [SuccApp for VS Code](https://docs.succbi.com/v5/dev/ai-building/vscode)
+- [AI 低代码开发](https://docs.succapp.com/ai)
+- [SuccApp CLI](https://docs.succapp.com/ai/connect/cli)
+- [SuccApp for VS Code](https://docs.succapp.com/ai/connect/vscode)