@succsoft/succapp 5.0.3 → 5.0.6

package/CHANGELOG.md

@@ -1,195 +1,64 @@
 # CHANGELOG
 
-## 0.3.4(2021-04-15)
-
-- 修复下载进度条无法消失的问题
-- 简化进度条弹框
-- 修复同步树本地下载新增失败
-- 数据源配置校验
-- 本地项目下载比较json未格式化问题
-- 本地新增文件无法比较问题
-- 修复projects.exclude失效问题
-- 修复刚启动succapp时刷新同步树按钮失效问题
-- 修复同步树根目录点击下载失效问题
-- 修复日志打印异常问题
-- 修复本地没有.meta文件会报错的问题
-- 添加同步树目录节点的描述信息
-- 改善数据源本地文件命名大小写问题
-  
-## 0.3.3(2021-02-23)
-
-- 修复未授信https请求失败问题
-
-## 0.3.2(2020-02-22)
-
-- 修改插件信息
-
-## 0.3.1(2020-12-17)
-
-- 添加datasource模块
-- 同步忽略
-- .meta文件同步描述
-- 添加设置开关，控制自动编译,自动格式化，自动备份
-- 优化视图，仅当succapp工作目录显示同步和服务视图
-
-## 0.3.0(2020-11-25)
-
-- 删除app模块
-
-## 0.2.19(2020-09-21)
-
-- 修复集群负载均衡下API请求错误问题
-- 兼容旧版war包API接口
-
-## 0.2.17，0.2.18(2020-09-18)
-
-- 修复无法加载项目文件
-
-## 0.2.16(2020-08-14)
-
-- 修复插件在4.0产品20200812之后的版本无法登录使用问题
-
-## 0.2.15(2020-01-13)
-
-- 修复关闭自动格式化不生效问题
-
-## 0.2.14(2020-01-07)
-
-- 修复引用node_module模块报错导致无法打包问题
-- 启动过程增加try catch，便于查启动内部报错的问题
-
-## 0.2.12, 0.2.13(2020-01-07)
-
-- 修复.js.map文件和图片文件无差别但仍显示有差异问题
-- 实现json的自动格式化，可在设置中配置是否启用，默认启用，格式化根据`editor.insertSpaces`设置方式为`Space`或`Tab`，根据`editor.tabSize`设置缩进数
-
-## 0.2.11(2020-01-05)
-
-- 修复下载图片后不能打开问题
-- 调整初始化设置，使项目初始化后编译不报错且编译结果与服务器保持一致
-
-## 0.2.7, 0.2.8, 0.2.9, 0.2.10(2019-11-28)
-
-- 调整插件服务端API，修复插件无法上传文件文件
-
-## 0.2.6(2019-11-11)
-
-- 启动插件会检查是否存在api-libs.json文件，若不存在则自动下载api
-- 修复同步树上change数不会刷新问题
-
-## 0.2.5(2019-11-09)
-
-- 修复服务器连接校验错误
-
-## 0.2.4(2019-11-08)
-
-- 优化扩展模板下载
-- 新增服务器增加校验
-- 修复命令中文不生效问题
-
-## 0.2.2, 0.2.3(2019-11-05)
-
-- 修复添加服务的一些bug
-- 新增api的下载入口
-
-## 0.2.1(2019-11-04)
-
-- `SuccBI Server`视图改为只显示当前服务器，切换服务器提供选择框选择
-- 添加第一个服务器时自动作为当前服务器，后续添加不改变当前服务器
-- `SuccBI Synchronize`视图支持收起所有
-- 屏蔽一些不需要的命令并添加命令的中文标题配置
-
-## 0.2.0(2019-11-01)
-
-- 插件更名为SuccApp，以前名为succADP-IDE
-- 视图改为`SuccBI Server`、`SuccBI Synchronize`，容器为`explorer`，以前是`修改待同步`、`持续同步`，自定义容器
-- 调整目录结构，compare、backup、temp等放在.vscode里
-- 新增日志文件，新增服务器备份、支持新增和删除的比较
-- 删除扩展发布功能，使用同步功能提交扩展，新增APP的同步
-
-## 0.1.28(2019-09-26)
-
-- fix: 跟远程仓库同步之后无法查看文件修改差异
-
-## 0.1.27(2019-09-23)
-
-- fix: 执行succ load project命令之后，点击“同步刷新”按钮，无法同步工程，没有显示新添加的文件
-
-## 0.1.22(2019-08-05)
-
-- fix:更新api的时候报错：9:38:36 Error: EPERM: operation not permitted, mkdir 'd:/succezIDE/github/bds/com.succez.bds/api'
-
-## 0.1.18(2019-07-20)
-
-- feat:启动插件时自动从服务器更新api文件。所以推荐启动插件之前服务器是启动的。如果没有启动，那么api目录将不会被更新。
-
-## 0.1.16(2019-07-20)
-
-- feat:上传文件到服务器时改成串行提交，避免服务器报异常
-
-## 0.1.12，0.1.13，0.1.14(2019-07-16)
-
-- feat:修改插件名字为succ-adp-ide，显示名为succADP-IDE。以前是叫succExtensionIDE
-- 解决ajax请求出现401错误时自动登录的问题
-
-## 0.1.11(2019-07-15)
-
-- feat:如果服务器启动的是本地开发环境，那么从vscode发布文件到服务器不需要确认
-
-## 0.1.9 , 0.1.10(2019-07-10)
-
-- fix:比较本地文件和服务器文件的修改时间时由于精度不同导致总是不相同。
-
-## 0.1.8(2019-07-09)
-
-- 同步时如果session失效那么自动登录
-- 执行操作时如果服务器没有启动，那么显示明确的提示信息
-
-## 0.1.7(2019-07-09)
-
-- 登录时输出日志，出现异常时也输出日志
-
-## 0.1.6(2019-07-08)
-
-- 增加插件启动日志，当发现ts文件有变化时也会在控制台输出日志
-
-## 0.1.1(2019-07-02)
-
-- 修复一些问题
-- 增加了部分文档
-
-## 0.1.0(2019-06-11)
-
-- 支持元数据项目级别的元数据同步
-- ts编译结果从jss改为js
-- 支持打开项目就直接开始编译
-- 支持元数据app的持续上传
-
-## 0.0.20(2019-04-11)
-
-- 支持在less中使用succ提供的默认less样式
-
-## 0.0.18(2019-01-09)
-
-- 支持在扩展内部引用第三方js文件
-- 修复偶尔出现的不编译脚本的问题
-
-## 0.0.15(2019-01-07)
-
-- 调整扩展目录结构
-
-## 0.0.14(2019-01-05)
-
-- 修复删除文件不能正确同步的问题
-
-## 0.0.13(2019-01-04)
-
-- 修复模板重命名的不正确的问题
-
-## 0.0.12 (2019-01-04)
-
-- 修复一些提示内容
-
-## 0.0.1 (2018-12-20)
-
-- 测试第一版发布
+## 5.0.6(2026-07-18)
+
+- 新增 `db source probe <datasource>`，支持验证已有数据源连接；`db source test` 同时支持已有数据源和 JSON 配置，并统一返回 schema、数据库版本和驱动等结构化连接信息。
+- 新增 `succapp model search`，支持按路径、项目、模型属性和字段属性跨模型检索，以及忽略大小写的字面匹配和正则匹配。
+- 增强 `server file search`，支持按正文执行 AND/OR 字面或正则匹配，并返回命中片段和文件级警告。
+- 统一文件和模型搜索的相关度排序、结果数量限制与目录范围语义，裸关键词默认执行包含搜索，并完善结果元数据和终端展示。
+- 优化 SuccApp CLI 帮助：human 输出支持选项分组和按终端宽度换行，`--help --json` 提供版本化、可导航的结构化命令契约。
+- `server file open` 和 `workspace file open` 新增 `--no-open`，可仅返回页面 URL 而不启动系统浏览器。
+- 新增 `succapp server cache list` 和 `succapp server cache clean`，支持列出和清空服务器系统缓存。
+- `workspace file compile` 增加元数据内容版本检查，旧版文件会提示先升级，避免按当前 Schema 产生误报。
+
+## 5.0.5(2026-07-06)
+
+- 新增 `succapp server file locate` 和 `succapp server file search`，支持按文件 id、路径、名称等条件定位和检索服务器文件。
+- 新增 `succapp model` 命令组，支持模型列表、字段、索引、预览查询和导出，并统一 `model select`、`model query` 的 JSON 与文件输出。
+- 新增 `succapp workspace file compile`，接入 Dev Tool V2 编译接口，用于在 CLI 中校验和编译本地工作区文件。
+- 扩展 Dev Tool V2 客户端协议，补齐模型查询、文件搜索、文件编译、流式导出等接口声明和实现。
+- 重构 CLI 参数解析为声明式参数契约，统一必填输入、互斥输入、输出文件、stdin 和 JSON 输出的校验与提示。
+- 优化数据库查询/导出、服务器设置、工作区文件打开和锁等待等命令输出，进一步统一 SuccApp 命令命名和帮助文案。
+- 将工作区开发支持资产迁移到文档 skill 维护，并收敛 `.agents` 系统目录边界，减少初始化和修复工作区时的重复写入。
+- 修复同步写入后 mirror 内容基线不完整的问题，避免后续状态检测误判本地文件变化。
+- 补充模型命令、工作区文件编译、服务器文件定位/搜索、CLI 参数解析、输出格式和同步基线相关单元测试与集成测试。
+
+## 5.0.4(2026-06-30)
+
+- 新增 SuccApp CLI 版本更新检查，`succapp --version` 会检查 npm 包版本，并在命令完成后通过 stderr 给出低打扰升级提示。
+- 支持按服务器版本线推荐配套 CLI 版本，避免旧服务器被默认引导升级到不兼容的新大版本。
+- 调整 Dev Tool API 请求的 User-Agent 标识，区分 `SuccAppCLI` 与 `SuccAppForVSCode` 调用端，并保留 Node.js 明文 JSON 异常输出协议。
+- 补充版本检查缓存目录、环境变量开关和单元测试，确保 JSON stdout 不被升级提示污染。
+
+## 5.0.3(2026-06-30)
+
+- 发布 SuccApp CLI npm 包 `@succsoft/succapp@5.0.3`，并将 `latest` 指向该版本。
+- 支持 SuccApp 官方离线文档 skill，完善 AI Agent 在 SuccApp 工作区内读取产品手册和开发规则的能力。
+- 补充开发辅助资源和内容类型识别，完善低代码元数据和资源文件的本地开发体验。
+- 修复 clone 不可见项目时的错误处理，提前返回结构化错误，避免后续同步流程继续执行。
+
+## 5.0.2(2026-06-28)
+
+- 优化 SuccApp CLI 的命令提示风格，补充未知命令建议，降低命令输错后的排查成本。
+- 改善 `workspace init`、`clone`、`auth status`、元数据升级提示等常用命令的人类可读输出。
+- 支持 OAuth 登录入口，完善 CLI 服务信息、同步状态和系统信息展示。
+- 增加 `workspace discard`、`workspace settings get/set` 等工作区命令，并统一无副作用预演参数为 `--dry-run`。
+- 重组 SuccApp 元数据 TypeScript 声明目录，迁移 `.meta` 类型声明，补充移动端、样式、布局、资源类型和 MIME 类型定义。
+- 简化 MCP 接口，完善 CLI、DevTool v2 和工作区同步能力之间的协议边界。
+
+## 5.0.1(2026-06-20)
+
+- 首次将 SuccApp CLI 发布到 npm，包名为 `@succsoft/succapp`，命令名为 `succapp`。
+- 重构 CLI 命令体系，补齐工作区、服务器连接、项目、文件、同步和辅助命令能力。
+- 适配 DevTool v2 认证和服务端能力，接入本机认证、自动认证和结构化错误输出。
+- 支持创建元数据项目，完善 CLI 与 VS Code 共享的工作区初始化、修复和同步流程。
+- 增加 CLI 构建、测试和 release 脚本，发布时生成仅包含 CLI 运行所需文件的 npm staging 包。
+
+## 5.0.0(2026-06-20)
+
+- 实现 SuccApp DevTools 5.0 基线，将原 SuccIDE 能力升级为面向低代码项目交付、二次开发和 AI 辅助开发的 SuccApp 工具。
+- 重建 VS Code 扩展的服务器视图、Changes 视图、日志输出、diff、同步和项目管理体验。
+- 引入本地 SuccApp 工作区模型，支持元数据项目识别、工作区初始化、服务器配置和前端开发框架配置。
+- 优化 clone、fetch、pull、push、reset、apply remote changes 等同步流程，提高远端变化、本地变化和冲突识别能力。
+- 增加跨进程 workspace 锁管理、文件锁、认证持久化和结构化错误模型，为 VS Code 扩展和 CLI 共用同一工作区打基础。
+- 增强元数据 schema、类型声明、内容指纹、rename 检测和 inode 缓存能力，改善大批量元数据同步和比较性能。

package/README.md

@@ -10,7 +10,7 @@ SuccApp 的核心思路是把页面、仪表板、报表、数据模型、程序
 
 ## SuccApp CLI / 命令行工具
 
-SuccApp CLI 面向终端、脚本和 AI Agent，命令名为 `succapp`。它适合初始化工作区、连接服务器、查询状态、查看 diff、拉取和推送元数据、读取文件历史、解析页面地址、查询数据库结构，并用 `--json` 输出结构化结果。
+SuccApp CLI 面向终端、脚本和 AI Agent，命令名为 `succapp`。它适合初始化工作区、连接服务器、查询状态、查看 diff、拉取和推送元数据、读取文件历史、解析页面地址、查询数据库结构，并用 `--json` 输出结构化结果。需要人工阅读结构化结果时，可以使用 `--pretty-json` 输出格式化 JSON。
 
 Install:
 
@@ -32,6 +32,7 @@ succapp workspace init --server=<server-url>
 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 workspace push <path>
 ```
@@ -40,6 +41,17 @@ succapp workspace push <path>
 
 其中 `workspace push` 会写入服务器。推送前应先检查差异；生产服务器必须按团队发布流程确认。
 
+数据查询类命令分为预览和导出两类。预览命令只向 stdout 返回有限行数，导出命令必须写入本地文件：
+
+```bash
+succapp db query default "select * from orders" --max-rows=100 --json
+succapp db export default --query-file=./orders.sql --output=orders.csv
+succapp model select /DEMO/data/tables/orders.tbl --select ID,NAME --max-rows=100 --json
+succapp model query --query-file=./query.json --max-rows=100 --json
+succapp model export /DEMO/data/tables/orders.tbl --select ID,NAME --output=orders.csv
+succapp model export --query-file=./query.json --output=result.csv
+```
+
 ## SuccApp for VS Code / VS Code 工具
 
 SuccApp for VS Code 面向人工检查和交互式开发。它提供服务器视图、Changes 视图、文件历史、diff、脚本编辑、远端文件打开和 Git 协作入口，适合项目成员查看 AI 修改结果、处理冲突和执行需要人工确认的同步操作。