@succsoft/succapp 5.0.7 → 5.0.9

package/dist/cli/l10n/bundle.l10n.zh-cn.json

@@ -1,71 +1,38 @@
 {
 	"common.err.unexpected": "发生未知错误。",
-	"err.workspace.required": "当前没有可用的 SuccApp 工作区。请打开已有的 SuccApp 工作区，或先初始化当前文件夹。",
-	"err.workspace.activeFileRequired": "请先打开文件，再{actionName}。",
-	"err.base.cancel": "已取消。",
-	"err.net.connectionFailed": "无法连接到服务器：{url}{causeMessage}",
-	"err.net.connectionFailed.desc": "请检查服务器地址和网络连接，然后重试或重新登录。",
-	"err.cluster.nodeUnavailable": "集群节点 {clusterNode} 不可用。",
-	"err.cluster.nodeUnavailable.desc": "该节点可能未启动、已离开当前集群或网络不可达，请检查节点状态和网络连接后重试。",
-	"err.server.notReady": "服务器尚未就绪",
-	"err.server.notReady.desc": "服务器尚未完成启动和初始化。",
-	"err.server.notReady.hint": "请稍后重试；如果长时间未就绪，请检查服务器状态和服务日志。",
-	"err.server.capabilityUnsupported": "服务器 {serverUrl} 不支持能力 {capability}。",
-	"err.server.capabilityUnsupported.desc": "请将服务器升级到支持该 Dev Tool 能力的版本后重试。",
-	"err.server.clusterNodeNotFound": "集群节点 {nodeId} 不在当前快照中。",
-	"err.server.clusterNodeNotFound.desc": "请先运行 'succapp server cluster list' 确认节点 ID。",
-	"err.server.threadNotFound": "线程 {threadId} 已结束或不存在。",
-	"err.server.threadNotFound.desc": "请重新运行 'succapp server thread list' 获取当前线程快照。",
-	"err.server.threadTaskChanged": "线程 {threadId} 上的可取消任务已经变化。",
-	"err.server.threadTaskChanged.desc": "请重新查看线程，并使用当前取消序号。",
-	"err.server.threadNotCancelable": "线程 {threadId} 上没有可取消的产品任务。",
-	"err.login.notlogin": "认证失败，请重新登录",
-	"err.login.notlogin.hint": "请重新登录后重试当前命令。",
-	"err.login.busy": "系统繁忙，暂无法登录，请稍后再试！",
-	"err.login.busy.desc": "可能原因包括在线会话或用户数达到许可限制，也可能是数据库连接或查询失败。",
-	"err.oauth2.tokenExpired": "OAuth2 访问令牌已过期。",
-	"err.login.oauthTimeout": "OAuth2 授权超时。",
-	"err.login.oauthTimeout.desc": "请重新登录并在浏览器中完成授权；无浏览器环境可改用 PAT 登录。",
-	"err.login.oauthStateMismatch": "OAuth2 授权状态不匹配。",
-	"err.login.oauthStateMismatch.desc": "请重新登录，并从新打开的浏览器页面完成授权。",
-	"err.login.oauthInvalidCallback": "OAuth2 授权回调无效。",
-	"err.login.oauthInvalidCallback.desc": "请重新登录，并在浏览器中完成授权。",
-	"err.login.oauthLoopbackFailed": "无法启动本机 OAuth2 回调服务。",
-	"err.login.oauthLoopbackFailed.desc": "请检查本机 loopback 访问是否被拦截，然后重试；也可以改用 PAT 登录。",
-	"err.login.oauthTokenInvalid": "OAuth2 token 响应无效。",
-	"err.login.oauthTokenInvalid.desc": "请检查服务器版本和 OAuth2 配置，然后重试。",
-	"err.sync.conflict": "远程版本已变化：{remotePath}",
-	"err.sync.conflict.desc": "请先拉取或对比后再推送。原因：{reason}",
-	"err.sync.projectUnavailable": "无法{actionName}不可确认的远端项目：{paths}",
-	"err.sync.projectUnavailable.desc": "请先检查服务器、用户、项目权限和项目名称，再重试。",
-	"err.sync.projectUnavailable.hint": "请先运行 'succapp server project list' 查看当前登录可见的项目，再使用准确的项目名重试。",
-	"err.sync.projectNotFound": "工作区项目不存在：{projectNames}",
-	"err.sync.projectRootRenameUnsupported": "无法{actionName}被重命名的远端项目：{paths}",
-	"err.sync.projectRootRenameUnsupported.desc": "暂不支持自动应用项目重命名。请重新 clone 该项目，或在本地改名以保持一致。",
-	"err.sync.pathOutOfScope": "此文件不在同步范围内：{remotePath}",
-	"err.extension.sysdataNotCloned": "无法新建扩展，因为当前工作区尚未 clone sysdata 项目。",
-	"err.extension.sysdataNotCloned.desc": "请先 clone sysdata 项目，然后重试。",
-	"err.extension.templateUnavailable": "当前连接的服务器没有提供任何扩展模板。",
-	"err.extension.rootUnresolved": "无法根据输入定位扩展根目录。",
-	"err.extension.rootUnresolved.desc": "请提供扩展名，或提供扩展目录内的路径。",
-	"err.extension.rootNotFound": "扩展目录不存在：{extensionRoot}",
-	"err.workspace.problem": "检测到工作区同步问题。",
-	"err.workspace.problem.desc": "请先执行 'succapp workspace repair --dry-run' 或 'succapp workspace repair'，再重试需要完整本地同步基线的操作。",
-	"err.net.invalidUrl": "URL 无效：{url}",
-	"err.meta.invalidPath": "元数据路径不合法",
-	"err.meta.invalidPath.desc": "请使用合法的绝对元数据路径后重试。",
-	"err.meta.invalidPath.relativeSearchQuery": "不支持相对搜索路径：{path}",
-	"err.meta.invalidPath.relativeSearchQuery.hint": "请使用以 '/' 开头的绝对路径，或使用不含 '/' 的文件名。",
-	"err.meta.invalidPath.parentDirGlob": "--parent-dir 不支持 glob 通配符：{path}",
-	"err.meta.invalidPath.parentDirGlob.hint": "--parent-dir 已默认递归搜索；只匹配直接子项时使用 --path='/DIR/*'，其他 glob 也请使用 --path。",
-	"err.meta.invalidPath.parentProjectMismatch": "父目录 {path} 不属于项目 {projectName}。",
-	"err.meta.invalidPath.parentProjectMismatch.hint": "请让父目录的第一个路径段与 --project 一致。",
-	"err.meta.projectExist": "已存在同名项目。",
-	"err.meta.projectname.illegal": "项目名不合法。只能使用字母、数字和下划线，长度不能超过 16。",
-	"err.meta.projectname.reservedwords": "项目名是系统保留字，不能使用。",
+	"err.base.invalidParameter": "参数不合法",
+	"err.base.invalidParameter.exactlyOne": "必须且只能指定一个组件身份：--component 或 --component-type。",
+	"err.base.invalidParameter.exactlyOne.hint": "查询服务器页面中的组件时使用 --component=<id>；按组件类型查询时使用 --component-type=<type>，不要同时指定。",
+	"err.base.invalidParameter.unknownMethod": "当前组件未声明方法“{value}”。",
+	"err.base.invalidParameter.unknownMethod.hint": "运行 succapp dev component-method list <target>，指定相同的 --component 或 --component-type，再使用返回的精确方法 ID。",
+	"err.base.invalidParameter.notInUsage": "属性“{value}”未列入当前用途“{usage}”的候选。",
+	"err.base.invalidParameter.notInUsage.hint": "使用相同组件身份并加 --usage=metadata 检查完整静态属性；若能查到，按该用途查看声明。若仍查不到，检查属性名、组件类型和匹配版本的 DTS。",
+	"err.base.invalidParameter.unknownComponentType": "未知的组件类型：{value}。",
+	"err.base.invalidParameter.unknownType.hint": "运行 succapp dev component list <target> --json 查询适用类型，核对精确类型名称；属性查询还需核对 --kind 类别。",
+	"err.base.invalidParameter.unknownComponent": "服务器已保存的页面中未找到组件 ID“{value}”。",
+	"err.base.invalidParameter.unknownComponent.hint": "通过 succapp server file show <target> 检查服务器已保存的页面，使用组件 ID 而非标题；本地新增组件需先推送再查询。",
+	"err.base.invalidParameter.ambiguousComponent": "服务器页面中的组件 ID“{value}”不唯一。",
+	"err.base.invalidParameter.ambiguousComponent.hint": "为组件设置唯一 ID，推送修正后的页面，再用目标组件 ID 查询。",
+	"err.base.invalidParameter.unknownLayout": "未知的布局类型：{value}。",
+	"err.base.invalidParameter.unknownLayout.hint": "先用 dev layout list 核对同一组件的布局 ID；服务器未提供定义时，检查对应布局扩展。",
+	"err.base.invalidParameter.unsupportedPageContext": "当前页面类型或类别不支持按组件实例查询。",
+	"err.base.invalidParameter.pageContext.hint": "--component 仅支持服务器已保存的 SPG 或仪表板中的组件；其他受支持类别请改用 --component-type 查询。",
 	"err.file.invalidPath": "文件路径不合法或不安全：{path}",
+	"err.file.invalidPath.empty": "路径不能为空字符串。",
+	"err.file.invalidPath.empty.hint": "需要默认值时省略该参数；表示当前目录请使用 .。",
+	"err.file.noMatch": "没有匹配到本地文件：{path}",
+	"err.file.noMatch.hint": "请核对执行目录、路径和文件名大小写；glob 用引号包裹，目录中须有可处理的文件。相对路径以执行目录（应用 -C 后）为基准，所有输入均匹配后才会继续执行命令。",
 	"err.file.notFound": "路径不存在：{path}",
+	"err.file.notFound.hint": "请核对路径及文件名大小写；相对路径以执行目录（应用 -C 后）为基准。文件位于其他目录时，改用正确的本地路径或用 -C 指定执行目录。",
 	"err.file.notDirectory": "路径不是目录：{path}",
+	"err.workspace.pathOutOfScope": "本地路径不在工作区 {workspace} 的元数据范围内：{path}",
+	"err.workspace.pathOutOfScope.hint": "请提供指定工作区内的本地元数据路径，并检查路径及其基准目录。",
+	"err.workspace.pathOutOfScope.notProject": "无法识别文件所属的元数据项目，工作区为 {workspace}：{path}",
+	"err.workspace.pathOutOfScope.notProject.hint": "请先查看 workspace project list 确认本地项目。仅下载文件的目录可能缺少项目级 .meta；需要准备所属项目时，先查看 workspace project clone --help --json。若文件在另一个工作区，用 -C 指向该工作区；不要手工伪造 .meta。",
+	"err.workspace.required": "当前没有可用的 SuccApp 工作区。请打开已有的 SuccApp 工作区，或先初始化当前文件夹。",
+	"err.workspace.activeFileRequired": "请先打开文件，再{actionName}。",
+	"err.workspace.problem": "检测到工作区同步问题。",
+	"err.workspace.problem.desc": "请先检查并修复工作区问题，再重试依赖完整本地同步基线的操作。",
 	"err.workspace.sameServerUrl": "新服务器地址必须和当前地址不同。",
 	"err.workspace.serverAlreadyExists": "服务器已存在：{duplicatedServer}",
 	"err.workspace.issue.E201": "工作区配置缺失",
@@ -86,25 +53,33 @@
 	"err.workspace.issue.E403": "AI agent 工作区文件缺失",
 	"err.workspace.issue.E404": "TypeScript 辅助文件缺失",
 	"err.workspace.issue.E405": "元数据校验辅助文件缺失",
-	"err.workspace.issue.E405.hint": "请先执行 'succapp workspace init --scope dev'，然后重试当前命令。",
+	"err.workspace.issue.E405.hint": "请先初始化开发辅助文件，再重试。",
 	"err.workspace.issue.E407": "SuccApp 官方文档 skill 文件缺失",
-	"err.lock.busy": "无法{attemptedCommand}：工作区范围 {conflictScope} 正被另一个进程持有。",
-	"err.lock.busy.desc": "请停止正在运行的进程后重试；崩溃进程留下的锁会在下次尝试时自动清理。",
-	"err.lock.busy.hint": "请等待正在运行的 SuccApp 进程结束后重试。",
-	"err.lock.compromised": "工作区锁已被另一个进程接管，当前{attemptedCommand}已中止。",
-	"err.lock.compromised.desc": "请先运行 'succapp workspace status' 确认一致性，再重试。",
 	"err.workspace.activeConnectionRequired": "当前没有可用服务器连接，无法{actionName}。",
-	"err.base.operationFailed": "操作失败",
-	"err.base.operationFailed.desc": "操作未能完成，请查看错误详情或联系管理员处理。",
-	"err.net.invalidResponse": "远端响应格式不正确",
-	"err.net.invalidResponse.desc": "远端响应不符合当前协议要求，请检查服务版本或联系管理员处理。",
-	"err.net.invalidResponse.dbTableDescribeEmpty.hint": "请检查数据源 {dataSource} 和表 {tableName} 是否存在。",
-	"err.db.tableNotFound": "数据库表不存在：{tableName}",
+	"err.server.templateNotFound": "位置 {path} 的 {type} 类型下没有模板 {id}。",
+	"err.server.themeNotFound": "位置 {target} 没有可用的主题 {theme}。",
+	"err.server.startupFailed": "服务器启动失败",
+	"err.server.startupFailed.desc": "服务器初始化已失败，仅等待无法恢复。",
+	"err.server.startupFailed.hint": "请先排查并解决服务器启动失败的问题，再重试当前命令。",
+	"err.server.notReady": "服务器尚未就绪",
+	"err.server.notReady.desc": "服务器尚未完成启动和初始化。",
+	"err.server.notReady.hint": "请稍后重试；如果长时间未就绪，请检查服务器状态和服务日志。",
+	"err.server.capabilityUnsupported": "服务器 {serverUrl} 不支持能力 {capability}。",
+	"err.server.capabilityUnsupported.desc": "请将服务器升级到支持所需功能的版本后重试。",
+	"err.server.clusterNodeNotFound": "集群节点 {nodeId} 不在当前快照中。",
+	"err.server.clusterNodeNotFound.desc": "请查看当前集群快照并确认节点 ID。",
+	"err.server.threadNotFound": "线程 {threadId} 已结束或不存在。",
+	"err.server.threadNotFound.desc": "请获取当前线程快照后重试。",
+	"err.server.threadTaskChanged": "线程 {threadId} 上的可取消任务已经变化。",
+	"err.server.threadTaskChanged.desc": "请重新查看线程，并使用当前取消序号。",
+	"err.server.threadNotCancelable": "线程 {threadId} 上没有可取消的产品任务。",
+	"err.server.expressionFunctionNotFound": "有效目录中没有表达式函数 {name}。",
+	"err.cli.httpResourceNotFound": "服务器资源不存在（HTTP 404）：{path}。请检查资源路径；DTS 请从对应类型索引或帮助中的地址查找。",
 	"err.cli.unknownCommand": "未知命令：{commandName}",
-	"err.cli.unknownCommand.hint": "请运行 {helpCommand} 查看可用命令。",
-	"err.cli.unknownCommand.suggestion.hint": "你是不是想运行：{commands}",
+	"err.cli.unknownCommand.hint": "请查看可用命令及其用法。",
 	"err.cli.invalidInvocation": "发现 {count} 个用法问题。",
 	"err.cli.invalidInvocation.hint": "请修正下面列出的用法问题后重试。",
+	"err.cli.duplicateOption": "选项只能指定一次：{option}",
 	"err.cli.unknownOption": "未知选项：{option}",
 	"err.cli.missingOptionValue": "选项需要提供值：{option}",
 	"err.cli.unexpectedOptionValue": "选项不接受值：{option}",
@@ -132,6 +107,8 @@
 	"err.cli.invalidChoice.hint": "可用值：{allowedValues}。",
 	"err.cli.invalidChoice.namedLogger": "logger 名称无效：{value}。",
 	"err.cli.invalidChoice.namedLogger.hint": "请使用准确的具名 logger；不能是 root，也不能包含通配符。",
+	"err.cli.invalidChoice.labelFilter": "标签表达式格式无效：{value}。",
+	"err.cli.invalidChoice.labelFilter.hint": "使用 & 连接必需标签、| 连接候选分支、! 排除标签，例如 'page-full|texture&!map'。不支持括号，运算符之间不能缺少标签。",
 	"err.cli.invalidKeyValue": "{input} 的 key=value 无效：{value}。",
 	"err.cli.invalidKeyValue.hint": "请使用 key=value 格式。",
 	"err.cli.invalidNonEmptyKeyValue": "{input} 的 key=value 无效：{value}。",
@@ -140,11 +117,12 @@
 	"err.cli.invalidReadableFile": "输入文件不可读取：{source}。",
 	"err.cli.invalidRegularFile": "输入路径不是普通文件：{source}。",
 	"err.cli.invalidWorkspace": "不是 SuccApp 工作区：{source}。",
-	"err.cli.invalidWorkspace.hint": "请先运行 'succapp workspace init --server <url>'，或用 '-C <workspace>' 选择已有工作区。",
+	"err.cli.invalidWorkspace.hint": "请初始化目标文件夹，或选择已有的 SuccApp 工作区。",
 	"err.cli.invalidWorkspaceConfigJson": "工作区配置已损坏：{source}。",
 	"err.cli.unconfiguredServer": "当前工作区未配置此服务器：{value}。",
+	"err.cli.unconfiguredServer.hint": "请检查已配置的服务器。添加服务器也会将其设为工作区的活跃服务器。",
 	"err.cli.serverMismatch": "服务器与当前工作区活跃服务器不一致：{value}。",
-	"err.cli.serverMismatch.hint": "期望的活跃服务器：{expected}。",
+	"err.cli.serverMismatch.hint": "期望的活跃服务器：{expected}。请检查已配置的服务器，再决定是否切换目标。",
 	"err.cli.serverCapabilityUnavailable": "当前服务器未提供此能力：{capability}。",
 	"err.cli.serverCapabilityUnavailable.hint": "请将服务器升级到兼容版本后重试。",
 	"err.cli.unsupportedAuthFlow": "认证流程暂未实现：{authType}。",
@@ -152,6 +130,7 @@
 	"err.cli.invalidExtensionName": "扩展名无效：{value}。",
 	"err.cli.invalidExtensionName.hint": "请使用 <公司名>-<扩展点>-<短名称> 格式。",
 	"err.cli.unknownExtensionTemplate": "扩展模板不可用：{value}。",
+	"err.cli.unknownExtensionTemplate.hint": "请查看可用的扩展点和模板名称。",
 	"err.cli.confirmationRequired": "此操作需要确认后才能继续。",
 	"err.cli.confirmationRequired.hint": "确认影响后传入 {flag} 继续。",
 	"err.cli.confirmationRequired.dbSourceDelete": "删除此数据源需要确认。",
@@ -169,22 +148,126 @@
 	"err.cli.confirmationRequired.logLevel.hint": "确认目标 logger 和影响范围后，传入 {flag} 继续。",
 	"err.cli.confirmationRequired.logCluster": "应用 Logback 配置会替换所有可达集群节点的完整配置。",
 	"err.cli.confirmationRequired.logCluster.hint": "确认源配置和目标集群后，传入 {flag} 继续。",
-	"err.cli.confirmationRequired.cloneOverwrite": "继续 clone 会覆盖已有本地工作区项目：{projectNames}。",
+	"err.cli.confirmationRequired.cloneOverwrite": "继续 clone 会覆盖已有本地项目路径：{projectNames}。",
 	"err.cli.confirmationRequired.cloneOverwrite.hint": "确认这些本地项目可以被覆盖后，传入 {flag} 继续。",
+	"err.cli.confirmationRequired.cloneIncomplete": "继续 clone 会覆盖未完成克隆留下的本地项目路径：{projectNames}。",
+	"err.cli.confirmationRequired.cloneIncomplete.hint": "这些文件可能已有本地修改。检查并保存需要保留的内容后，传入 {flag} 重新克隆。",
 	"err.cli.confirmationRequired.projRemove": "移除本地工作区项目需要确认：{projectNames}。",
-	"err.cli.confirmationRequired.projRemove.hint": "确认本地项目文件和 mirror 基线可以删除后，传入 {flag} 继续。",
+	"err.cli.confirmationRequired.projRemove.hint": "确认本地项目文件和本地同步基线可以删除后，传入 {flag} 继续。",
 	"err.cli.confirmationRequired.discardAll": "放弃整个工作区变化需要确认。",
 	"err.cli.confirmationRequired.discardAll.hint": "确认所有本地工作区变化都可以放弃后，传入 {flag} 继续。",
 	"err.cli.confirmationRequired.openLocalChanged": "本地工作区文件有未推送变化：{path}。",
 	"err.cli.confirmationRequired.openLocalChanged.desc": "浏览器打开的是服务器版本，新文件可能显示 404，已修改文件可能仍显示旧内容。",
 	"err.cli.confirmationRequired.openLocalChanged.hint": "请先运行 'succapp workspace push {path}'，或传入 {flag} 强行打开服务器页面。",
-	"err.db.nonReadOnlySql": "db query 只执行只读 SQL。可能修改数据或表结构的 SQL 请改用 db exec。",
-	"err.db.nonReadOnlySql.hint": "确认 SQL 影响范围后，运行 'succapp db exec {flag}'。",
+	"err.cli.httpGetPath": "无效的服务器资源路径：{path}",
+	"err.cli.httpGetPath.hint": "使用以 / 开头的部署相对路径，不要包含完整 URL、片段或上级目录。",
+	"err.cli.templateTarget": "请传入 tpg/dash/rpt/spg 服务器文件路径且不指定 --file-type，或传目录并指定 --file-type。目标：{target}，类型：{fileType}。",
+	"err.cli.portalTemplateMissing": "TPG 创建内容缺少有效的 settings.template，无法查询门户属性描述。",
+	"err.cli.templateShowSelection": "请选择目标路径和 --name，或单独使用 --template；两种方式不能混用。",
+	"err.cli.resourceUnsupported": "服务器不支持 {resource} 查询，请联系管理员确认服务器版本与 CLI 是否配套。",
+	"err.base.sourceInvalid": "源码或配置内容不合法",
+	"err.base.cancel": "已取消。",
+	"err.base.operationFailed": "操作失败",
+	"err.base.operationFailed.desc": "操作未能完成，请查看错误详情或联系管理员处理。",
+	"err.net.connectionFailed": "无法连接到服务器：{url}{causeMessage}",
+	"err.net.connectionFailed.desc": "请检查服务器地址、网络连接和服务状态，确认服务器可达后再重试。",
+	"err.net.invalidUrl": "URL 无效：{url}",
+	"err.net.invalidResponse": "远端响应格式不正确",
+	"err.net.invalidResponse.desc": "远端响应不符合当前协议要求，请检查服务版本或联系管理员处理。",
+	"err.net.invalidResponse.dbTableDescribeEmpty.hint": "请检查数据源 {dataSource} 和表 {tableName} 是否存在。",
 	"err.net.httpStatusUnexpected": "HTTP 响应状态不符合预期",
 	"err.net.httpStatusUnexpected.desc": "远端服务返回了调用方无法归类的 HTTP 状态，请查看错误详情或联系管理员处理。",
+	"err.cluster.nodeUnavailable": "集群节点 {clusterNode} 不可用。",
+	"err.cluster.nodeUnavailable.desc": "该节点可能未启动、已离开当前集群或网络不可达，请检查节点状态和网络连接后重试。",
+	"err.login.notlogin": "认证失败，请重新登录",
+	"err.login.notlogin.hint": "请重新登录后重试当前命令。",
+	"err.login.busy": "系统繁忙，暂无法登录，请稍后再试！",
+	"err.login.busy.desc": "可能原因包括在线会话或用户数达到许可限制，也可能是数据库连接或查询失败。",
+	"err.login.oauthTimeout": "OAuth2 授权超时。",
+	"err.login.oauthTimeout.desc": "请重新登录并在浏览器中完成授权；无法完成浏览器授权时可改用 PAT。",
+	"err.login.oauthStateMismatch": "OAuth2 授权状态不匹配。",
+	"err.login.oauthStateMismatch.desc": "请重新登录，并从新打开的浏览器页面完成授权。",
+	"err.login.oauthInvalidCallback": "OAuth2 授权回调无效。",
+	"err.login.oauthInvalidCallback.desc": "请重新登录，并在浏览器中完成授权。",
+	"err.login.oauthLoopbackFailed": "无法启动本机 OAuth2 回调服务。",
+	"err.login.oauthLoopbackFailed.desc": "请检查本机 loopback 访问是否被拦截，然后重试；也可以改用 PAT 登录。",
+	"err.login.oauthTokenInvalid": "OAuth2 token 响应无效。",
+	"err.login.oauthTokenInvalid.desc": "请检查服务器版本和 OAuth2 配置，然后重试。",
+	"err.oauth2.tokenExpired": "OAuth2 访问令牌已过期。",
+	"err.sync.conflict": "远程版本已变化：{remotePath}",
+	"err.sync.conflict.desc": "请先查看同步状态，包括删除、移动和元数据变化，再决定如何处理。内容对比为空不代表冲突已解决。原因：{reason}",
+	"err.sync.projectUnavailable": "无法{actionName}不可确认的远端项目：{paths}",
+	"err.sync.projectUnavailable.desc": "请先检查服务器、用户、项目权限和项目名称，再重试。",
+	"err.sync.projectUnavailable.hint": "请查看当前登录可见的项目，再使用准确的项目名重试。",
+	"err.sync.projectNotFound": "工作区项目不存在：{projectNames}",
+	"err.sync.projectNotFound.hint": "请检查本地项目和服务器上可克隆的项目。",
+	"err.sync.projectRootRenameUnsupported": "无法{actionName}被重命名的远端项目：{paths}",
+	"err.sync.projectRootRenameUnsupported.desc": "暂不支持自动应用项目重命名。请重新 clone 该项目，或在本地改名以保持一致。",
+	"err.sync.pathOutOfScope": "此文件不在同步范围内：{remotePath}",
+	"err.extension.sysdataNotCloned": "无法新建扩展，因为当前工作区尚未 clone sysdata 项目。",
+	"err.extension.sysdataNotCloned.desc": "请先克隆 sysdata 项目，然后重试。",
+	"err.extension.templateUnavailable": "当前连接的服务器没有提供任何扩展模板。",
+	"err.extension.rootUnresolved": "无法根据输入定位扩展根目录。",
+	"err.extension.rootUnresolved.desc": "请提供扩展名，或提供扩展目录内的路径。",
+	"err.extension.rootNotFound": "扩展目录不存在：{extensionRoot}",
+	"err.meta.invalidPath": "元数据路径不合法",
+	"err.meta.invalidPath.desc": "请使用合法的绝对元数据路径后重试。",
+	"err.meta.invalidPath.relativeSearchQuery": "不支持相对搜索路径：{path}",
+	"err.meta.invalidPath.relativeSearchQuery.hint": "请使用以 '/' 开头的绝对路径，或使用不含 '/' 的文件名。",
+	"err.meta.invalidPath.parentDirGlob": "--parent-dir 不支持 glob 通配符：{path}",
+	"err.meta.invalidPath.parentDirGlob.hint": "--parent-dir 已默认递归搜索；只匹配直接子项时使用 --path='/DIR/*'，其他 glob 也请使用 --path。",
+	"err.meta.invalidPath.parentProjectMismatch": "父目录 {path} 不属于项目 {projectName}。",
+	"err.meta.invalidPath.parentProjectMismatch.hint": "请让父目录的第一个路径段与 --project 一致。",
+	"err.meta.projectExist": "已存在同名项目。",
+	"err.meta.projectname.illegal": "项目名不合法。只能使用字母、数字和下划线，长度不能超过 16。",
+	"err.meta.projectname.reservedwords": "项目名是系统保留字，不能使用。",
+	"err.lock.busy": "无法{attemptedCommand}：工作区范围 {conflictScope} 正被另一个进程持有。",
+	"err.lock.busy.desc": "请停止正在运行的进程后重试；崩溃进程留下的锁会在下次尝试时自动清理。",
+	"err.lock.busy.hint": "请查看锁持有者，等待正在运行的 SuccApp 进程结束后重试。",
+	"err.lock.fileBusy": "本地文件锁正被另一个进程持有：{lockPath}。",
+	"err.lock.fileBusy.desc": "等待正在执行的文件操作结束后重试。",
+	"err.lock.fileBusy.hint": "请等待持锁操作结束后重试，不要手动删除正在使用的锁。",
+	"err.lock.fileCompromised": "本地文件锁已失效，当前操作已中止：{lockPath}。",
+	"err.lock.fileCompromised.desc": "请核对本地文件状态后重试。",
+	"err.lock.compromised": "工作区锁已被另一个进程接管，当前{attemptedCommand}已中止。",
+	"err.lock.compromised.desc": "请先检查工作区同步状态，再重试。",
+	"err.db.connectorNotFound": "数据库连接器不可用：{name}。",
+	"err.db.connectorNotFound.hint": "请查看可用的数据库连接器。",
+	"err.db.tableNotFound": "数据库表不存在：{tableName}",
+	"err.db.nonReadOnlySql": "db query 只执行只读 SQL。可能修改数据或表结构的 SQL 请改用 db exec。",
+	"err.db.nonReadOnlySql.hint": "确认 SQL 影响范围后，运行 'succapp db exec {flag}'。",
 	"err.permission.denied": "权限不足",
 	"err.permission.denied.desc": "当前账号无权执行此操作。",
 	"err.permission.denied.hint": "请联系管理员授予所需权限，或改用有权限的账号重试。",
+	"err.base.invalidParameter.unknownEvent": "当前组件未列出事件“{value}”。",
+	"err.base.invalidParameter.unknownEvent.hint": "运行 succapp dev component-event list <target>，指定相同组件身份，使用返回的精确事件 ID；其他事件需核对扩展与类型资料。",
+	"err.cli.invalidFileName": "新名称不合法：{name}",
+	"err.cli.invalidFileName.hint": "只填写单个文件或文件夹名称，不包含路径分隔符，不使用 . 或 ..。",
+	"err.meta.invalidMoveTarget": "移动目标位置不合法：{targetPath}",
+	"err.meta.invalidMoveTarget.hint": "检查目标位置后重试。",
+	"err.meta.invalidMoveTarget.samePath.hint": "无需更改；如需移动或重命名，请提供不同的目标路径或名称。",
+	"err.meta.invalidMoveTarget.selfOrDescendant.hint": "不能将目录移入自身或后代目录，请选择源目录之外的目标父目录。",
+	"err.meta.fileExists": "目标资源已存在：{path}",
+	"err.meta.fileExists.hint": "先查询源路径和目标路径，再选择其他目标名称；不会覆盖已有资源。",
+	"err.meta.fileExistsIgnoreCase": "目标位置存在仅大小写不同的同名资源：{path}",
+	"err.meta.fileExistsIgnoreCase.hint": "查询目标目录后选择其他名称。",
+	"err.meta.file.notfound": "服务器资源不存在：{filePath}",
+	"err.meta.file.notfound.hint": "核对服务器和资源路径，再通过 server file info 或 server file list 查询。",
+	"err.meta.filefolder.notfound": "父目录不存在：{filePath}",
+	"err.meta.filefolder.notfound.hint": "先用 server file create <目录路径> --folder 逐级创建缺失目录，再重试。",
+	"err.meta.parent.dir.illegal": "目标父路径不是可用目录：{filePath}",
+	"err.meta.parent.dir.illegal.hint": "查询目标父路径，选择已有文件夹作为目标父目录。",
+	"err.meta.saveConcurrent": "服务器资源已发生变化，操作未执行：{path}",
+	"err.meta.saveConcurrent.hint": "用 server file info 重新读取并比较资源状态，再决定是否重试。",
+	"err.meta.saveConcurrent.revision.hint": "期望修订 {expectedRevision}，实际修订 {actualRevision}。用 server file info 重新读取并比较资源状态，再决定是否重试。",
+	"err.cli.confirmationRequired.scheduleRemove": "删除计划任务对象需要 --force 确认。",
+	"err.schedule.notExists": "计划不存在。",
+	"err.task.notExists": "任务不存在。",
+	"err.base.resourceNotFound": "请求的资源不存在。",
+	"err.base.invalidParameter.scheduleInput": "调度参数或字段 {field} 不合法，要求：{expected}。",
+	"err.base.operationFailed.scheduleIncomplete": "操作未完整完成，请按错误属性中的对象 id 和步骤核对服务器状态后再继续。",
+	"err.base.invalidParameter.scheduleInput.hint": "按当前命令 --help 检查参数组合及配置字段；配置使用接口驼峰属性，例如 timeout:600；不嵌套 settings，不提交结果信封。",
+	"err.cli.docsUnavailable": "资料不可用：{path}。请检查资料路径、来源和完整性；离线模式不会下载，显式目录不会自动补齐。",
 	"workspace.compat.connectedServerAppears": "当前连接的服务器低于此工作区记录过的版本基线，可能连接到了错误的旧服务器。",
 	"workspace.compat.serverVersion": "服务器版本：{0} < {1}",
 	"workspace.extension.progress.create.done": "已创建扩展 {0}。",
@@ -245,29 +328,36 @@
 	"workspace.sync.progress.upgradeMeta.checked": "已检查 {0} 个元数据文件：{1} 个可升级。",
 	"workspace.sync.progress.upgradeMeta.done": "已升级元数据文件：变更 {0} 个，失败 {1} 个，检查 {2} 个。",
 	"workspace.sync.progress.upgradeMeta.scan": "正在扫描元数据文件",
+	"workspace.sync.push.upgradeRequired": "元数据文件 {0} 必须先升级才能推送。请执行 succapp dev file upgrade 或使用 VS Code 的“升级文件”。",
 	"cli.cmd.common.desc": "常用命令。",
 	"cli.cmd.common.summary": "常用命令",
 	"cli.cmd.common.title": "常用",
 	"cli.cmd.root.summary": "SuccApp 命令行工具。",
+	"cli.cmd.root.desc": "通过命令行连接和操作 SuccApp，查询与分析数据，开发和维护模型、报表及业务应用，管理本地工作区和服务器。\n\n提供元数据同步、数据库操作、开发资源查询和运行诊断等能力。",
+	"cli.cmd.root.out": "结构化帮助位于 help：description 说明用途与条件，可选的 output 解释业务结果，可选的 references 提供本地和在线资料。children 列出直接下级，按其中的 helpArgs 可继续读取下一层帮助。\n\n判断完成时同时检查退出码和业务结果；kind=result 也可能包含冲突、跳过或截断。--json 不取消浏览器打开或写入等副作用，输出和退出码说明见下面指南。\n\n本地路径的文本输出相对执行目录；JSON 中 localPath 为磁盘绝对路径，remotePath 为服务器元数据绝对路径，inputPath 只回显输入。cwd 表示应用 -C 后的执行目录。",
 	"cli.host.localeFallback": "区域语言 {0} 不可用，已使用默认文案。",
 	"cli.opt.help": "显示此帮助。",
-	"cli.opt.json": "输出脚本用 NDJSON；二进制内容结果使用 Base64 编码。",
+	"cli.opt.json": "向 stdout 输出 NDJSON，每行一个结果或错误对象（含结构化诊断）；日志写入 stderr。公共格式见 CLI 手册，具体结果字段见当前帮助。",
+	"cli.opt.json.brief": "向 stdout 输出 NDJSON，每行一个结果或错误对象；日志写入 stderr。",
 	"cli.opt.locale": "使用指定区域语言显示 CLI 文案。",
 	"cli.opt.lockTimeout": "失败前等待 workspace 锁释放。",
 	"cli.opt.logLevel": "设置日志级别：trace、debug、info、warn 或 error。",
 	"cli.opt.prettyJson": "输出便于人工阅读的格式化 JSON；不适合按行解析脚本。",
+	"cli.opt.prettyJson.brief": "输出格式化 JSON，供人工阅读；不适合按行解析。",
 	"cli.opt.quiet": "隐藏进度和普通信息输出。",
-	"cli.opt.server": "为支持该选项的命令指定服务器。",
+	"cli.opt.server": "直连服务器，优先于活跃服务器和 SUCCAPP_SERVER；命令支持位置 URL 时，位置 URL 优先。工作区同步须匹配活跃服务器。",
 	"cli.opt.verbose": "启用调试日志。",
 	"cli.opt.version": "显示版本信息，并检查 SuccApp CLI 更新。",
-	"cli.opt.workspace": "按指定工作区运行 SuccApp。",
+	"cli.opt.directory": "在指定目录执行命令；本地相对路径以此目录为基准，并向上识别工作区。只能指定一个 -C，相对目录以启动目录为基准；重复指定或显式空字符串报错；表示当前目录必须使用 .。",
+	"cli.opt.directory.brief": "在指定目录执行；本地相对路径以此为基准，向上查找工作区。",
 	"cli.cmd.auth.title": "认证",
 	"cli.cmd.auth.summary": "登录、退出并查看本地服务器认证",
-	"cli.cmd.auth.desc": "登录、退出并查看本地服务器认证。",
+	"cli.cmd.auth.desc": "管理 SuccApp 服务器的本地认证，支持登录、查看认证状态和退出。\n\n认证记录由 CLI 与 IDE 共享，后续访问服务器时可复用。",
 	"cli.cmd.auth.login.summary": "登录服务器。",
-	"cli.cmd.auth.login.desc": "使用 OAuth2 或 PAT 登录 SuccApp 服务器并保存本地认证状态。",
-	"cli.cmd.auth.login.oauth": "使用 OAuth2 登录，这是默认方式。",
-	"cli.cmd.auth.login.pat": "使用 Personal Access Token 登录。交互终端会提示输入 token；管道输入仍从标准输入读取。",
+	"cli.cmd.auth.login.desc": "登录 SuccApp 服务器，为后续命令建立可复用的认证。\n\n支持浏览器 OAuth2 授权和个人访问令牌（PAT），适用于交互终端和无人值守脚本。\n\n登录需要访问目标服务器；成功后将认证信息保存到本机，CLI 与 IDE 共享使用。",
+	"cli.cmd.auth.login.out": "loggedIn=true、stored=true 表示本次登录成功并保存本地认证；authType 为认证方式。token 和 refreshToken 是是否存在的布尔值，不包含令牌正文；expiresAt 仅在可用时返回。",
+	"cli.cmd.auth.login.oauth": "通过浏览器 OAuth2 授权登录（默认方式）；不能与 --pat 同时使用。",
+	"cli.cmd.auth.login.pat": "使用个人访问令牌（PAT）登录；交互终端会提示输入，管道输入从标准输入读取。不能与 --oauth 同时使用。",
 	"cli.cmd.auth.login.patPrompt": "个人访问令牌（PAT）：",
 	"cli.cmd.auth.login.openingBrowser": "正在打开浏览器完成 OAuth2 授权...",
 	"cli.cmd.auth.login.waitingForCallback": "正在等待 OAuth2 授权完成...",
@@ -276,19 +366,22 @@
 	"cli.cmd.auth.login.loggedIn": "已登录：{0}",
 	"cli.cmd.auth.login.loggedInAs": "已登录：{0}，用户：{1}",
 	"cli.cmd.auth.logout.summary": "删除本地认证配置。",
-	"cli.cmd.auth.logout.desc": "从本地认证配置中删除已保存的认证信息。",
-	"cli.cmd.auth.logout.all": "删除所有服务器的本地认证配置。",
+	"cli.cmd.auth.logout.desc": "删除本机保存的服务器认证信息。\n\n可退出单个服务器，也可清除所有服务器的本地认证。\n\n操作同时影响 CLI 与 IDE 使用的认证记录，不撤销服务器签发的 PAT，也不删除工作区服务器配置。",
+	"cli.cmd.auth.logout.out": "删除单个服务器认证时，removed 是布尔值，false 表示本地原本没有该认证。使用 --all 时，all=true，removed 是删除的认证记录数。",
+	"cli.cmd.auth.logout.all": "删除所有服务器的本地认证配置。\n\n不能与位置参数 URL 同时使用；省略本选项时删除目标服务器的认证。",
 	"cli.cmd.auth.logout.removedAllAuth": "已删除所有服务器的本地认证配置：{0}",
 	"cli.cmd.auth.logout.removedAuth": "已删除本地认证配置：{0}",
 	"cli.cmd.auth.logout.serverUrlTogether": "不要同时传入服务器 URL 和 --all。",
 	"cli.cmd.auth.logout.storedAuth": "没有本地认证配置：{0}",
 	"cli.cmd.auth.status.summary": "显示本地认证状态。",
-	"cli.cmd.auth.status.desc": "显示指定服务器的本地认证信息。",
+	"cli.cmd.auth.status.desc": "查看指定服务器在本机保存的认证状态。\n\n只检查本地记录，不请求服务器验证认证是否有效。",
+	"cli.cmd.auth.status.out": "storedAuth 表示是否有本地认证记录；token 和 refreshToken 是是否存在的布尔值，不输出秘密值。expiresAt、lastLoginAt 和 updatedAt 是可选的 ISO 8601 日期时间字符串；记录存在不代表服务器仍接受该认证。",
 	"cli.cmd.auth.status.noStoredOutput": "服务器：{server}\n已保存认证：{storedAuth}",
 	"cli.cmd.auth.status.output": "服务器：{server}\n已保存认证：{storedAuth}\n认证方式：{authType}\n用户名：{username}\n用户 ID：{userId}\nToken：{token}\n刷新 Token：{refreshToken}\n过期时间：{expiresAt}\n上次登录时间：{lastLoginAt}\n更新时间：{updatedAt}",
+	"cli.cmd.auth.*.url": "目标服务器 URL；优先于 --server、工作区活跃服务器和 SUCCAPP_SERVER。",
 	"cli.cmd.db.title": "数据库",
 	"cli.cmd.db.summary": "查看和操作服务器数据库与数据源",
-	"cli.cmd.db.desc": "查看和操作服务器数据库与数据源。",
+	"cli.cmd.db.desc": "查看和操作服务器数据库与数据源。\n\n支持连接器和数据源管理、数据库结构查询、SQL 查询执行及 CSV 导入导出。物理表查询与 SuccApp 语义模型查询分别提供。\n\n写入类操作可能修改服务器配置、数据库数据或结构。",
 	"cli.cmd.db.dataSource": "数据源",
 	"cli.cmd.db.connection": "连接",
 	"cli.cmd.db.defaultSchema": "逻辑默认 schema",
@@ -319,10 +412,16 @@
 	"cli.cmd.db.sqlOrFileConflict": "SQL 只能通过 <sql> 或 --file 传入，不能同时使用。",
 	"cli.cmd.db.sqlUpdateCount": "SQL 影响行数：{0}",
 	"cli.cmd.db.query.empty": "查询成功，返回 0 行。",
+	"cli.cmd.db.query.summary": "执行只读 SQL 查询。",
+	"cli.cmd.db.query.desc": "对指定数据源执行只读 SQL，预览查询结果。\n\n适用于数据库物理表查询；预览受服务器行数限制，不代表完整数据或总量。",
+	"cli.cmd.db.query.out": "JSON 关键输出示例（省略公共结果字段，注释仅供说明，实际输出为严格 JSON）：\n    {\n      \"dataSource\": \"default\",             // 数据源标识\n      \"schema\": \"public\",                  // 指定 --schema 时返回\n      \"readOnly\": true,                    // 本命令执行只读查询\n      \"timeoutSeconds\": 30,                // 请求超时，单位秒\n      \"maxRows\": 100,                      // 显式指定时回显请求值\n      \"result\": {                          // 查询结果\n        \"fields\": [                        // 字段定义，数组顺序就是列顺序\n          {\n            \"name\": \"id\",                  // 对应 rows 中记录的键\n            \"sqlType\": \"VARCHAR\",          // SQL 类型，可选\n            \"typeName\": \"varchar\"          // 驱动类型名，可选；dataType 可省略\n          }\n        ],\n        \"rows\": [                          // 记录数组；空结果为 []\n          {\n            \"id\": \"A001\"                   // 按实际 JSON 类型读取，区分 null 和 \"\"\n          }\n        ],\n        \"rowCount\": 1,                     // 返回行数，不是总量；缺失时读 result.rows.length\n        \"maxRows\": 100,                    // 实际预览上限，可选\n        \"truncated\": false,                // 是否因预览上限截断，可选\n        \"elapsedMs\": 12,                   // 耗时，单位毫秒，可选\n        \"timeoutMs\": 30000                 // 超时，单位毫秒，可选\n      }\n    }\n\ntruncated 缺失时不能推断为 false；即使为 false，查询自身的行数限制仍然生效。空结果还可能在顶层返回 empty.reason=\"noRows\"。",
+	"cli.cmd.db.query.maxRows": "最大返回行数。\n\n当前配套服务器默认 100、上限 1000；0 使用服务器默认值，不表示无限制。",
+	"cli.cmd.db.query.nonReadOnlySql": "db query 只允许只读 SQL。写入或 schema 变更请使用 db exec；确认影响后再添加 --force。",
+	"cli.cmd.db.query.sqlOrFileConflict": "SQL 只能通过 <sql> 或 --file 传入，不能同时使用。",
 	"cli.cmd.db.tableOrQueryConflict": "<table> 与 --query/--query-file 不能同时传。",
 	"cli.cmd.db.connector.title": "数据库连接器",
-	"cli.cmd.db.connector.summary": "发现服务器可用的数据库连接器",
-	"cli.cmd.db.connector.desc": "查看当前服务器可用的数据库连接器及各连接器特有的配置项。",
+	"cli.cmd.db.connector.summary": "查看数据库连接器及其配置项。",
+	"cli.cmd.db.connector.desc": "查看服务器可用的数据库连接器及其配置要求。\n\n提供通用与连接器特有字段、默认配置及 JDBC URL 模板，帮助准备数据源连接。可用连接器由目标服务器决定。",
 	"cli.cmd.db.connector.connector": "连接器",
 	"cli.cmd.db.connector.displayName": "显示名称",
 	"cli.cmd.db.connector.dbKind": "数据库分类",
@@ -331,129 +430,161 @@
 	"cli.cmd.db.connector.secret": "秘密字段",
 	"cli.cmd.db.connector.list.summary": "列出服务器可用的数据库连接器。",
 	"cli.cmd.db.connector.list.desc": "列出当前服务器可用于创建数据源的数据库连接器。",
+	"cli.cmd.db.connector.list.out": "connectors[] 中 name 是连接器 ID，可用于 db connector show 和 db source template；displayName 是显示名称。列表表示服务器可用的连接器，不代表已配置的数据源或数据库连接已经可用。",
 	"cli.cmd.db.connector.show.summary": "查看数据库连接器支持的配置项。",
-	"cli.cmd.db.connector.show.desc": "查看当前服务器返回的通用及连接器特有配置项、安全默认值和 JDBC URL 模板。",
+	"cli.cmd.db.connector.show.desc": "查看数据库连接器支持的配置项和 JDBC URL 模板。\n\n可了解字段类型、必填项、秘密字段和安全默认值。模板示例不是已验证的连接配置。",
+	"cli.cmd.db.connector.show.out": "connector.name 是连接器 ID；connector.configFields[] 描述配置字段的 name、type、required、secret 和可选 defaultValue。connector.defaults 是安全默认配置，jdbcUrlTemplate 是可选 JDBC URL 模板。secret=true 的字段需要另行提供秘密值，默认配置不是可直接使用的完整连接配置。",
 	"cli.cmd.db.connector.show.connector": "由 db connector list 返回的数据库连接器 ID。",
-	"cli.cmd.db.source.title": "数据库源",
-	"cli.cmd.db.source.summary": "查看和管理数据库源",
-	"cli.cmd.db.source.desc": "查看和管理数据库源。",
-	"cli.cmd.db.source.*.config": "从文件读取数据源配置 JSON，或使用 - 读取标准输入。",
-	"cli.cmd.db.source.*.test": "保存前先测试连接。",
+	"cli.cmd.db.source.title": "数据源",
+	"cli.cmd.db.source.summary": "查看、测试和管理数据源。",
+	"cli.cmd.db.source.desc": "查看、测试和管理服务器上的数据源。\n\n支持配置查看、连接探测、配置模板生成以及数据源的创建、更新和删除。\n\n连接测试会实际访问数据库；创建、更新和删除会修改服务器数据源配置。",
+	"cli.cmd.db.source.*.config": "完整配置 JSON 文件，或 - 从标准输入读取；不能提交 CLI 结果信封。模板需填写真实连接参数。",
+	"cli.cmd.db.source.*.test": "保存前先测试连接。\n\n测试成功不代表后续模型查询或数据权限已验证。",
+	"cli.cmd.db.source.*.datasource": "db source list 返回的数据源标识，不是连接器 ID。",
 	"cli.cmd.db.source.list.summary": "列出可见数据源。",
 	"cli.cmd.db.source.list.desc": "列出当前 SuccApp 服务器会话可见的数据源。",
+	"cli.cmd.db.source.list.out": "dataSources[] 中 name 是后续 show、probe、schema、table 和 SQL 命令使用的数据源标识。空列表只表示当前服务器会话未返回可见数据源，empty.reason=emptyCollection。",
 	"cli.cmd.db.source.list.empty": "没有可用的数据源。",
 	"cli.cmd.db.source.show.summary": "查看数据源配置。",
-	"cli.cmd.db.source.show.desc": "显示数据源配置。",
+	"cli.cmd.db.source.show.desc": "查看服务器上已有数据源的配置。\n\n只读取配置，不验证数据库连接。",
+	"cli.cmd.db.source.show.out": "JSON 的 config 字段是配置正文，输出可能移除 password；不要把整个结果信封或脱敏后的值直接当成完整更新输入。",
 	"cli.cmd.db.source.probe.summary": "验证已有数据源连接，并显示逻辑默认 schema、数据库及驱动信息。",
-	"cli.cmd.db.source.probe.desc": "打开并验证已有数据源连接，返回逻辑默认 schema、数据库产品、标准及完整版本和 JDBC 驱动信息；JSON 输出还会包含脱敏后的数据源配置。",
+	"cli.cmd.db.source.probe.desc": "探测已有数据源的连接，了解数据库产品、版本、驱动和逻辑默认 schema。\n\n探测会实际访问数据库；连接成功只说明本次连接可用，不保证后续查询权限或模型配置正确。",
+	"cli.cmd.db.source.probe.out": "connected 表示本次连接结果，defaultSchema 是逻辑默认 schema；databaseProductName、databaseVersion、databaseProductVersion 分别表示数据库产品、标准版本和完整版本，driverName/driverVersion 表示 JDBC 驱动。config 是移除 password 后的配置，不应直接作为完整更新输入。",
 	"cli.cmd.db.source.probe.datasource": "要探测的已有数据源名称。",
 	"cli.cmd.db.source.test.summary": "测试已有数据源或未保存的 JSON 配置能否建立连接。",
-	"cli.cmd.db.source.test.desc": "验证已有数据源，或在不保存的情况下验证 JSON 配置能否建立连接；两种方式都会返回逻辑默认 schema、数据库及驱动信息。",
-	"cli.cmd.db.source.test.datasource": "要测试的已有数据源名称。",
+	"cli.cmd.db.source.test.desc": "测试已有数据源或尚未保存的配置能否建立数据库连接。\n\n可了解逻辑默认 schema、数据库及驱动信息。\n\n测试会实际访问数据库，但不保存配置。",
+	"cli.cmd.db.source.test.out": "result 表示本次连接测试是否成功。defaultSchema、databaseProductName、databaseVersion 和 driverName/driverVersion 在可用时返回；config 是移除 password 后的配置。测试成功不表示配置已保存。",
+	"cli.cmd.db.source.test.datasource": "要测试的已有数据源名称。\n\n与 --config 必须且只能选择一个。",
+	"cli.cmd.db.source.test.config": "UTF-8 严格 JSON 配置对象文件，或 - 从标准输入读取；与 <datasource> 必须且只能选择一个。根对象为 JdbcConfig，不是 CLI 结果或 {\"config\":...} 包装；不支持注释和尾逗号。配置字段和骨架分别由 db connector show、db source template 提供。\n\n对 JDBC 连接，模板中的 url 已代入示例地址；修改 host、port、databaseName 不会自动重算 url。必须按 connector.jdbcUrlTemplate 填写实际 JDBC URL，并核对其中的主机、端口和库名。额外驱动属性使用 connectionProperties，具体结构见配置类型。",
 	"cli.cmd.db.source.template.summary": "根据服务器连接器生成安全的数据源 JSON 模板。",
-	"cli.cmd.db.source.template.desc": "根据当前服务器中的连接器生成数据源配置模板。模板采用连接器提供的默认配置，且不会包含密码或其他秘密值。",
+	"cli.cmd.db.source.template.desc": "根据服务器连接器生成数据源配置模板。\n\n模板采用连接器的默认配置，不包含密码或其他秘密值，便于准备新的数据源。\n\n此命令不创建数据源或测试连接。",
+	"cli.cmd.db.source.template.out": "普通输出就是配置 JSON，可直接保存为 --config 的输入文件；--json 或 --pretty-json 的配置在 config 字段中，须提取该对象，不能保存整个结果。\n\n对 JDBC 连接，模板中的 url 已代入示例地址；修改 host、port、databaseName 不会自动重算 url。必须按 connector.jdbcUrlTemplate 填写实际 JDBC URL，并核对其中的主机、端口和库名。额外驱动属性使用 connectionProperties，具体结构见配置类型。",
 	"cli.cmd.db.source.template.connector": "由 db connector list 返回的数据库连接器 ID。",
 	"cli.cmd.db.source.create.summary": "新建数据源。",
-	"cli.cmd.db.source.create.desc": "根据 JSON 配置创建数据源。在 SuccApp 工作区中，AI Agent 应先阅读 .agents/skills/succapp-docs/SKILL.md，并按其中的索引查找数据源元数据和连接器配置文档。",
+	"cli.cmd.db.source.create.desc": "在目标服务器上创建数据源。\n\n支持在保存前验证数据库连接，帮助发现连接配置问题；连接成功不代表后续模型查询和数据权限已经验证。\n\n操作会保存服务器数据源配置；响应中断时，创建可能已经完成。",
+	"cli.cmd.db.source.create.out": "result 是保存结果，dataSource 是保存后的数据源标识，config 是返回的配置且会移除 password。--test 的连接信息在可用时返回；保存成功不等于数据查询已验证。",
+	"cli.cmd.db.source.create.config": "UTF-8 严格 JSON 配置对象文件，或 - 从标准输入读取；不支持注释或尾逗号。\n\n字段结构见 succ.meta.dbconnector.JdbcConfig。创建时必须提供 name（新数据源名称），不会按本地文件名推断；dbConnector 使用 db connector list 返回的连接器 ID。url、user、password 及连接器专属字段按目标连接器要求填写。\n\n用 db connector show <connector> --json 查看 connector.configFields[] 的字段名、类型、必填和秘密值标记，再用 db source template <connector> 生成配置骨架。普通模板输出就是可保存到 datasource.json 的配置对象；模板不含密码等秘密值，需要补充真实连接信息。\n\n若模板使用 --json 或 --pretty-json 输出，只提取 config 对象保存；不要提交整个结果，也不要额外包裹 config 层。静态 .jdbc 文件允许 JSONC 或省略 name 的约定不适用于此输入。\n\n对 JDBC 连接，模板中的 url 已代入示例地址；修改 host、port、databaseName 不会自动重算 url。必须按 connector.jdbcUrlTemplate 填写实际 JDBC URL，并核对其中的主机、端口和库名。额外驱动属性使用 connectionProperties，具体结构见配置类型。",
 	"cli.cmd.db.source.create.created": "已新建数据源：{0}",
 	"cli.cmd.db.source.update.summary": "修改数据源。",
-	"cli.cmd.db.source.update.desc": "根据 JSON 配置更新数据源。",
+	"cli.cmd.db.source.update.desc": "更新服务器上已有的数据源配置。\n\n采用完整配置替换，可在保存前测试数据库连接。\n\n修改直接作用于服务器；响应中断不代表更新未发生。",
+	"cli.cmd.db.source.update.out": "result 是保存结果，dataSource 是目标数据源标识。originalDataSource 在服务器提供时表示原标识；当前两者相同，不支持重命名。config 会移除 password，不能把整个结果对象当作下一次更新输入。",
 	"cli.cmd.db.source.update.updated": "已修改数据源：{0}",
+	"cli.cmd.db.source.update.config": "UTF-8 严格 JSON 配置对象文件，或 - 从标准输入读取；根对象为 JdbcConfig，不是 CLI 结果或额外的 config 包装；不支持注释或尾逗号。\n\nname 可省略，省略时使用 <datasource>；填写时必须与该位置参数一致。当前不支持重命名，不能沿用其他数据源或模板的示例名称。先用 db source show <datasource> --json 读取目标配置，只提取 config 对象修改后提交。\n\n更新不是字段补丁；当前服务器保留缺失或空的 password，但其他缺失字段不保证保留。不能将脱敏占位值作为密码写回。\n\n对 JDBC 连接，模板中的 url 已代入示例地址；修改 host、port、databaseName 不会自动重算 url。必须按 connector.jdbcUrlTemplate 填写实际 JDBC URL，并核对其中的主机、端口和库名。额外驱动属性使用 connectionProperties，具体结构见配置类型。",
 	"cli.cmd.db.source.remove.summary": "删除数据源。",
-	"cli.cmd.db.source.remove.desc": "显式确认后删除数据源。",
-	"cli.cmd.db.source.remove.force": "确认删除数据源。",
+	"cli.cmd.db.source.remove.desc": "删除服务器上的数据源配置。\n\n删除不会移除数据库物理表，但依赖此数据源的模型和任务可能无法访问数据。",
+	"cli.cmd.db.source.remove.out": "result 表示删除结果，dataSource 是目标数据源标识。删除确认只针对数据源配置，不表示已清理引用它的模型或任务。",
+	"cli.cmd.db.source.remove.force": "必须显式指定，确认删除服务器数据源配置。",
 	"cli.cmd.db.source.remove.dbSourceRemove": "删除数据源需要 --force。",
 	"cli.cmd.db.source.remove.deleted": "已删除数据源：{0}",
 	"cli.cmd.db.schema.title": "数据库 schema",
-	"cli.cmd.db.schema.summary": "查看数据库 schema",
-	"cli.cmd.db.schema.desc": "查看数据库 schema。",
+	"cli.cmd.db.schema.summary": "查看数据源中的 schema。",
+	"cli.cmd.db.schema.desc": "查看数据源中的数据库 schema，帮助确定表查询范围。",
 	"cli.cmd.db.schema.list.summary": "列出数据源 schema。",
-	"cli.cmd.db.schema.list.desc": "列出数据源中的 schema。",
+	"cli.cmd.db.schema.list.desc": "列出数据源中可见的数据库 schema。\n\n可见范围取决于数据库连接及其权限。",
+	"cli.cmd.db.schema.list.out": "schemas[] 返回 schema 名称 name 和可选 catalog；dataSource 标明查询的数据源。没有可见 schema 时返回空数组，并给出 empty.reason=emptyCollection。",
 	"cli.cmd.db.schema.list.catalog": "目录",
 	"cli.cmd.db.schema.list.empty": "数据源 '{0}' 中没有 schema。",
+	"cli.cmd.db.schema.list.catalogArg": "限定数据库目录（catalog）；省略时使用数据源默认范围。",
+	"cli.cmd.db.schema.*.datasource": "db source list 返回的数据源标识，不是连接器 ID。",
 	"cli.cmd.db.table.title": "数据库表",
-	"cli.cmd.db.table.summary": "查看数据库表",
-	"cli.cmd.db.table.desc": "查看数据库表。",
+	"cli.cmd.db.table.summary": "查看数据库表及其结构。",
+	"cli.cmd.db.table.desc": "查看数据库物理表及其字段和元数据。\n\n适用于了解数据库结构；物理表与 SuccApp 的 .tbl 语义模型不同。",
 	"cli.cmd.db.table.list.summary": "列出数据源中的表。",
-	"cli.cmd.db.table.list.desc": "列出数据源中的表。",
+	"cli.cmd.db.table.list.desc": "列出数据源中的物理表，帮助查找需要查询或维护的表。\n\n支持限定 schema 和按表名筛选，不读取表内数据。",
+	"cli.cmd.db.table.list.out": "tables[] 返回 tableName、schema、tableType 和可选 tableComment。tableName 是用于 describe/query/export 的物理表名。空列表可能表示没有可见表或当前筛选无匹配，以 empty.reason 区分。",
 	"cli.cmd.db.table.list.tableNameContains": "按名称过滤表。支持 * 和 ? 通配符。",
 	"cli.cmd.db.table.list.empty": "没有可用的数据库表。",
 	"cli.cmd.db.table.list.noMatches": "当前条件没有匹配的数据库表。",
 	"cli.cmd.db.table.describe.summary": "查看数据库表结构。",
-	"cli.cmd.db.table.describe.desc": "查看数据库表的字段和元数据。",
+	"cli.cmd.db.table.describe.desc": "查看数据库表的字段和元数据，帮助了解查询所需的名称与类型。\n\n只读取表结构，不返回表内数据。",
+	"cli.cmd.db.table.describe.out": "table 是表信息对象；columns[] 是字段信息，name 为物理字段名，dataType 为通用类型，dbType 为数据库类型，primaryKey、nullable、length 和 scale 描述约束与精度。可选信息缺失时不应推断为 false 或 0。",
 	"cli.cmd.db.table.describe.schema": "schema 名称。",
-	"cli.cmd.db.*.file": "从文件读取 SQL。",
+	"cli.cmd.db.table.*.datasource": "db source list 返回的数据源标识，不是连接器 ID。",
+	"cli.cmd.db.table.*.schema": "db schema list 返回的 schema；省略时由数据源处理默认范围。",
+	"cli.cmd.db.table.*.table": "db table list 返回的表名；不传 --schema 时支持 schema.table。\n\n显式指定 --schema 时，表名整体按字面处理，应只填写表名，避免重复限定。",
+	"cli.cmd.db.*.file": "从文件读取 SQL。\n\nUTF-8 SQL 原文文件；与 <sql> 互斥，均省略时读取标准输入。",
 	"cli.cmd.db.*.schema": "SQL 执行 schema。",
-	"cli.cmd.db.*.timeout": "SQL 超时时间，单位秒，默认 30。",
-	"cli.cmd.db.query.summary": "执行只读 SQL 查询。",
-	"cli.cmd.db.query.desc": "通过 Dev Tool v2 执行 SQL。SuccApp CLI 的 query 命令只允许只读查询。",
-	"cli.cmd.db.query.maxRows": "最大返回行数。",
-	"cli.cmd.db.query.nonReadOnlySql": "db query 只允许只读 SQL。写入或 schema 变更请使用 db exec；确认影响后再添加 --force。",
-	"cli.cmd.db.query.sqlOrFileConflict": "SQL 只能通过 <sql> 或 --file 传入，不能同时使用。",
+	"cli.cmd.db.*.timeout": "SQL 超时时间，单位秒。",
+	"cli.cmd.db.*.datasource": "db source list 返回的数据源标识，不是连接器 ID。",
+	"cli.cmd.db.*.sql": "SQL 文本；与 --file 互斥，均省略时从标准输入读取。",
+	"cli.cmd.db.*.table": "db table list 返回的表名；不传 --schema 时支持 schema.table。\n\n显式指定 --schema 时，表名整体按字面处理，应只填写表名，避免重复限定。",
 	"cli.cmd.db.exec.summary": "执行任意 SQL。",
-	"cli.cmd.db.exec.desc": "通过 Dev Tool v2 执行 SQL。写入或 schema 变更需要显式确认。",
-	"cli.cmd.db.exec.maxRows": "限制结果集返回行数。",
-	"cli.cmd.db.exec.force": "确认执行安全分析标记为危险的 SQL。",
+	"cli.cmd.db.exec.desc": "执行 SQL，获取结果集或更新计数。\n\n支持查询以及数据、结构变更；结果集受服务器预览限制。\n\n操作可能修改数据库。危险 SQL 的检查不覆盖所有写入风险；超时或断连后，写入可能已经生效。",
+	"cli.cmd.db.exec.out": "JSON 中 resultType 为 resultSet、updateCount、empty 或 mixed；updateCount 是非负更新计数的累计值。结果集使用 fields[] 字段名与 data[][] 行值数组，同一列的位置一一对应；这与 db query 的 result.rows 对象记录不同。results[] 是各项执行结果的摘要，sqlInfos[] 为语句分析信息。\n\nrowCount 是返回行数，maxRows 为预览上限，truncated 表示是否截断；缺失不能当成 false。elapsedMs/timeoutMs 的单位为毫秒，与输入 --timeout 的秒不同。",
+	"cli.cmd.db.exec.maxRows": "限制结果集返回行数。\n\n当前配套服务器默认 100、上限 1000；0 使用服务器默认值，不表示无限制。",
+	"cli.cmd.db.exec.force": "确认执行安全分析标记为危险的 SQL。\n\n未要求此选项不等于只读；超时或断连后先核对数据库状态，再决定是否重试。",
 	"cli.cmd.db.exec.dangerousSql": "危险 SQL 已被拦截。请检查影响后再使用 --force 重新执行。{0}",
 	"cli.cmd.db.exec.forceRequired": "已停止执行。确认 SQL 影响后再添加 --force。",
 	"cli.cmd.db.exec.fullTableData": "全表数据变更",
 	"cli.cmd.db.exec.schemaMutation": "schema 变更",
 	"cli.cmd.db.import.summary": "将 CSV 数据导入表。",
-	"cli.cmd.db.import.desc": "将 CSV 数据导入数据库表。",
-	"cli.cmd.db.import.input": "从文件读取表数据 CSV，或使用 - 读取标准输入。",
-	"cli.cmd.db.import.mode": "导入模式。默认 append；truncate 和 replace 必须显式传入。",
-	"cli.cmd.db.import.dryRun": "只校验导入，不写入行。",
+	"cli.cmd.db.import.desc": "将 CSV 数据导入数据库表。\n\n支持追加、清空后导入，以及只解析和统计数据的试运行。试运行不验证实际数据库约束。\n\n实际导入会修改数据库，响应中断后重复导入可能造成数据重复。",
+	"cli.cmd.db.import.out": "dryRun 表示是否为试运行，mode 是采用的导入模式。importedRows 是 CSV 数据行数，不是独立核验的落库行数；skippedRows 是跳过的行数。elapsedMs/timeoutMs 的单位为毫秒，与输入 --timeout 的秒不同。",
+	"cli.cmd.db.import.input": "UTF-8 CSV 文件，或 - 从标准输入读取；目标物理表必须已存在，首行为表头。用 db table describe 核对实际物理列名及类型。按表头名称匹配目标列，不按列位置猜测；优先使用唯一的物理列名，不依赖描述或主键兼容匹配。也接收 db export 整表导出的 # 类型扩展表头。\n\n使用逗号分隔；含逗号、双引号或换行的值用双引号包围，内部双引号写成两个。以下为字符列示例，表名和列名需替换：\n    ID,NOTE\n    1,\"a,b\"\n    2,\n    3,\"\"\n未加引号的字段会修剪首尾空白；要保留原始空白，必须将值放在双引号内，例如 \" P1 \"。引号内的空白保留。\n未加引号的空字段按 null 读取；带引号的空字段为字符空串，但目标数据库或字段类型仍可能把它转成 null。文本 null 和反斜杠 N 不是通用空值标记。\n\n日期优先使用 yyyy-MM-dd，时间戳使用 yyyy-MM-dd HH:mm:ss，按目标字段验证转换。二进制迁移保留整表导出的类型表头及 Base64 内容；查询导出的二进制长度标签不能还原字节。--dry-run 只解析和计数，不验证列映射、类型转换及数据库约束；正式导入后须查询目标表核验。",
+	"cli.cmd.db.import.mode": "append 追加数据；truncate 和 replace 均先清空目标表再导入，不是按主键更新。",
+	"cli.cmd.db.import.dryRun": "只解析和统计 CSV，不写入，也不验证实际数据库约束。",
 	"cli.cmd.db.import.schema": "表 schema。",
 	"cli.cmd.db.export.summary": "将表数据或查询结果导出为 CSV。",
-	"cli.cmd.db.export.desc": "将表数据或查询结果导出为 CSV。",
-	"cli.cmd.db.export.query": "导出查询结果而不是表数据。",
-	"cli.cmd.db.export.queryFile": "从文件读取导出查询 SQL。",
+	"cli.cmd.db.export.desc": "将数据库表数据或 SQL 查询结果导出为本地 CSV 文件。\n\n导出范围取决于查询条件和数据库访问权限。\n\n操作会写入本地文件，不修改数据库内容。",
+	"cli.cmd.db.export.out": "JSON 关键输出示例（省略公共结果字段，注释仅供说明，实际输出为严格 JSON）：\n    {\n      \"dataSource\": \"default\",             // 数据源标识\n      \"schema\": \"public\",                  // 指定或从表名解析出时返回\n      \"tableName\": \"orders\",               // 整表方式；查询方式改为 \"query\": true\n      \"timeoutSeconds\": 30,                // 请求超时，单位秒\n      \"output\": \"/work/orders.csv\",        // 本地绝对路径，CSV 内容写入此文件\n      \"size\": 128                          // 文件大小，单位字节\n    }\n\n当前配套服务器生成 UTF-8、无 BOM、逗号分隔、LF 换行的 CSV。含逗号、双引号或换行的字段用双引号包围，内部双引号重复，例如 中文,\"引号\" 写成 \"中文,\"\"引号\"\"\"。null 与空字符串都可能为空字段，不能据此恢复类型。\n\n查询导出的首行是结果字段名，二进制值输出长度标签。整表导出的首行以 # 开头，包含字段类型、长度、主键等元信息，例如 #id(I|10|PK),name(C|256)，二进制值默认用 Base64。需要普通字段名表头时使用查询导出。",
+	"cli.cmd.db.export.input": "<table>、--query、--query-file 必须且只能选择一种输入。查询输入为 SQL 原文。",
+	"cli.cmd.db.export.query": "导出查询结果而不是表数据，内容为 SQL 原文。",
+	"cli.cmd.db.export.queryFile": "从 UTF-8 文件读取导出查询 SQL 原文。",
 	"cli.cmd.db.export.schema": "表 schema 或 SQL 执行 schema。",
-	"cli.cmd.db.export.output": "把 CSV 输出写入本地文件。",
-	"cli.cmd.db.export.force": "输出文件已存在时允许覆盖。",
+	"cli.cmd.db.export.output": "CSV 输出的本地文件；文件已存在时需要 --force。",
+	"cli.cmd.db.export.force": "允许覆盖已存在的本地输出文件。",
 	"cli.cmd.db.export.exportedData": "已导出数据到 {0}",
 	"cli.cmd.server.title": "服务器",
 	"cli.cmd.server.summary": "查看和操作目标 SuccApp 服务器",
-	"cli.cmd.server.desc": "查看和操作目标 SuccApp 服务器。",
+	"cli.cmd.server.desc": "直接访问 SuccApp 服务器，管理远端资源并诊断运行状态。\n\n提供远端项目和文件操作、设置与回收站管理，以及缓存、集群、线程和技术日志工具，无需先克隆项目。开发资源查询与开发工具使用 dev 命令域。\n\n服务器访问需要相应认证和权限；写入类操作会直接影响服务器。",
 	"cli.cmd.server.serverNotConfigured": "此工作区未配置服务器：{0}",
 	"cli.cmd.server.serverReachable": "服务器可达：{0}",
 	"cli.cmd.server.ping.summary": "检查服务器是否可达。",
-	"cli.cmd.server.ping.desc": "检查 SuccApp Dev Tool v2 ping 接口是否可达。",
+	"cli.cmd.server.ping.desc": "检查 SuccApp 服务器是否可达。\n\n成功只表示服务器响应了连通性检查，不代表已登录、具有业务权限或数据库可用。",
+	"cli.cmd.server.ping.out": "--json 返回 reachable=true 表示连通性检查成功；请求失败时返回标准错误和非零退出码。",
 	"cli.cmd.server.info.summary": "显示服务器信息。",
-	"cli.cmd.server.info.desc": "显示服务器信息和元数据版本。",
-	"cli.cmd.server.info.scope": "只显示指定范围。可重复使用或用逗号分隔：product、sys、metadata、inspect、jvm、env、all。",
+	"cli.cmd.server.info.desc": "查看服务器信息和元数据版本，帮助识别目标环境。\n\n支持主要信息及产品、系统、JVM 等范围的详细信息。\n\n只读取信息，不执行升级。",
+	"cli.cmd.server.info.out": "--json 返回 info 对象：productType、version、apiVersion 标识产品和协议版本，scopes 表示选择的信息范围；productInfo、sysInfo、metadataVersions、sysInspectInfo、jvmInfo、systemEnvirInfo 按范围返回。未选择或服务器未提供的字段省略，不表示值为零。--raw 保留服务器详细信息的原始字段结构，仍位于 info 中。",
+	"cli.cmd.server.info.scope": "选择返回的信息范围，可重复或用逗号分隔。",
 	"cli.cmd.server.info.all": "显示全部信息范围。",
 	"cli.cmd.server.info.raw": "输出服务器详细信息的原始响应。",
 	"cli.cmd.server.cache.title": "服务器缓存",
 	"cli.cmd.server.cache.summary": "管理服务器缓存",
-	"cli.cmd.server.cache.desc": "管理服务器缓存。",
+	"cli.cmd.server.cache.desc": "查看和清理服务器系统缓存。\n\n可了解缓存条目、容量和命中率。\n\n清理会使缓存失效，后续访问可能重新加载数据。",
 	"cli.cmd.server.cache.list.summary": "列出服务器缓存条目。",
-	"cli.cmd.server.cache.list.desc": "列出服务端系统缓存条目（条数、磁盘/内存占用、命中率）。",
+	"cli.cmd.server.cache.list.desc": "列出服务器系统缓存，帮助了解条目数量、磁盘和内存占用及命中率。\n\n结果反映查询时的状态，统计值可能随运行变化。",
+	"cli.cmd.server.cache.list.out": "--json 返回 caches[] 和 summary.caches（条目数）。cacheName 用于 clean；entitiesCount 为缓存条数，diskUsed、memUsed 为字节数，hitRate 为 0 到 1 的命中率，lastAccessTime 为 Unix 毫秒时间戳。未提供的统计省略，不表示 0；无条目时 caches 为 [] 并返回 empty。",
 	"cli.cmd.server.cache.list.empty": "无服务器缓存条目。",
 	"cli.cmd.server.cache.clean.summary": "清空服务器缓存。",
-	"cli.cmd.server.cache.clean.desc": "按 <name> 清空指定服务端系统缓存，或用 --all 清空全部。",
-	"cli.cmd.server.cache.clean.all": "清空全部服务器缓存条目。",
+	"cli.cmd.server.cache.clean.desc": "清空指定或全部服务器系统缓存。\n\n清理会使缓存失效，后续访问可能重新加载数据，影响短期访问性能。",
+	"cli.cmd.server.cache.clean.out": "--json 返回 cleaned=true 和 cacheName；清理全部时 cacheName 为 *。",
+	"cli.cmd.server.cache.clean.all": "清空全部服务器缓存条目。\n\n与 <name> 必须且只能选择一个，无需 --force。",
 	"cli.cmd.server.cache.clean.cleaned": "已清空服务器缓存：{1}（{0}）",
+	"cli.cmd.server.cache.clean.name": "server cache list 返回的缓存名；与 --all 二选一。",
+	"cli.cmd.server.cache.*.url": "目标服务器 URL；优先于 --server、工作区活跃服务器和 SUCCAPP_SERVER。",
 	"cli.cmd.server.cluster.title": "服务器集群",
 	"cli.cmd.server.cluster.summary": "查看服务器集群节点",
-	"cli.cmd.server.cluster.desc": "查看集群成员、健康状态、网络状态和运行诊断。",
+	"cli.cmd.server.cluster.desc": "查看集群成员、健康状态、网络状态和运行诊断。\n\n提供集群总览和单节点详情；信息可能随节点上下线变化。",
 	"cli.cmd.server.cluster.list.summary": "列出服务器集群节点。",
-	"cli.cmd.server.cluster.list.desc": "列出与服务器系统设置页面相同的集群节点数据。",
-	"cli.cmd.server.cluster.list.health": "只显示指定健康级别的节点：ok、warning、error 或 unknown。",
-	"cli.cmd.server.cluster.list.watch": "持续刷新集群状态，直到用户中断。",
-	"cli.cmd.server.cluster.list.interval": "设置 watch 刷新间隔（毫秒，3000 到 60000），仅可与 --watch 一起使用。",
+	"cli.cmd.server.cluster.list.desc": "列出集群节点，帮助了解成员、在线情况和健康状态。\n\n支持一次性查询及持续观察，数据与服务器系统设置页面一致。不可达节点不代表健康。",
+	"cli.cmd.server.cluster.list.out": "--json 返回 nodes[]、generatedAt（Unix 毫秒）和 summary。summary.knownNodes 为筛选前节点数，summary.returnedNodes 为返回数；不是分页总数。节点 id 用于 show，name 用于需要节点名称的 --cluster。healthState、status 和 properties 提供健康及连接信息；字段缺失表示服务器未提供，不能当作健康或零负载。",
+	"cli.cmd.server.cluster.list.health": "按健康级别筛选节点。",
+	"cli.cmd.server.cluster.list.watch": "持续刷新集群状态，直到用户中断。\n\n按 Ctrl+C 停止；不支持 --json 或 --pretty-json，脚本可重复执行一次性 JSON 查询。",
+	"cli.cmd.server.cluster.list.interval": "watch 刷新间隔，单位毫秒；仅与 --watch 同用。",
 	"cli.cmd.server.cluster.list.empty": "没有集群节点匹配当前过滤条件。",
 	"cli.cmd.server.cluster.list.updatedAt": "更新时间：{0}",
 	"cli.cmd.server.cluster.show.summary": "显示一个服务器集群节点。",
-	"cli.cmd.server.cluster.show.desc": "按节点 ID 精确显示详情，并使用与 server info 相同的分范围信息布局。",
-	"cli.cmd.server.cluster.show.scope": "只显示指定的人类可读详情。可重复使用或用逗号分隔：product、sys、inspect、jvm、env、all。",
-	"cli.cmd.server.cluster.show.all": "显示全部人类可读详情范围。",
+	"cli.cmd.server.cluster.show.desc": "查看单个集群节点的详细运行状态。\n\n提供与服务器信息查询一致的分范围详情。节点可能在两次请求之间离线。",
+	"cli.cmd.server.cluster.show.out": "--json 返回 node 对象，保留节点 id、name 和状态；详细诊断位于 node.properties，按 --scope 或 --all 选择范围。缺失的诊断字段不表示正常或为零。",
+	"cli.cmd.server.cluster.show.scope": "选择返回的详情范围，同时影响文本和 JSON；可重复使用或用逗号分隔。",
+	"cli.cmd.server.cluster.show.all": "返回全部详情范围，同时影响文本和 JSON。",
 	"cli.cmd.server.cluster.out.name": "名称",
 	"cli.cmd.server.cluster.out.role": "角色",
 	"cli.cmd.server.cluster.out.health": "健康状态",
 	"cli.cmd.server.cluster.out.current": "当前节点",
 	"cli.cmd.server.cluster.out.master": "主节点",
-	"cli.cmd.server.cluster.out.heartbeat": "心跳间隔",
+	"cli.cmd.server.cluster.out.heartbeat": "距上次心跳",
 	"cli.cmd.server.cluster.out.latency": "延迟",
 	"cli.cmd.server.cluster.out.sessions": "会话数",
 	"cli.cmd.server.cluster.out.startedAt": "启动时间",
@@ -474,30 +605,52 @@
 	"cli.cmd.server.cluster.out.deployPath": "部署目录",
 	"cli.cmd.server.cluster.out.lastReceivedAt": "最近接收时间",
 	"cli.cmd.server.cluster.out.lastSentAt": "最近发送时间",
+	"cli.cmd.server.cluster.*.url": "目标服务器 URL；优先于 --server、工作区活跃服务器和 SUCCAPP_SERVER。",
+	"cli.cmd.server.cluster.*.nodeId": "server cluster list 返回的节点 ID。",
 	"cli.cmd.server.thread.title": "服务器线程",
 	"cli.cmd.server.thread.summary": "查看 JVM 线程",
-	"cli.cmd.server.thread.desc": "查看 JVM 线程快照，并请求取消已登记的产品任务。",
-	"cli.cmd.server.thread.*.state": "只显示指定 JVM 状态：new、runnable、blocked、waiting、timed-waiting 或 terminated。",
+	"cli.cmd.server.thread.desc": "查看 JVM 线程快照，分析热点、阻塞及 SQL 执行情况，并请求取消已登记的产品任务。\n\n提供线程摘要、完整堆栈和连续采样。取消仅为产品任务的协作式请求，不能终止任意 JVM 线程。",
+	"cli.cmd.server.thread.*.state": "按 JVM 线程状态筛选。",
 	"cli.cmd.server.thread.*.working": "只显示当前正在工作的线程。",
 	"cli.cmd.server.thread.*.sql": "只显示当前正在执行 SQL 的线程。",
+	"cli.cmd.server.thread.*.url": "目标服务器 URL；优先于 --server、工作区活跃服务器和 SUCCAPP_SERVER。",
+	"cli.cmd.server.thread.*.threadId": "同一节点上 server thread list 返回的线程 ID；使用前应重新核对。",
 	"cli.cmd.server.thread.list.summary": "列出 JVM 线程。",
-	"cli.cmd.server.thread.list.desc": "列出 JVM 线程摘要，不返回完整堆栈。",
-	"cli.cmd.server.thread.list.cluster": "在指定的单个集群节点上执行查询。",
+	"cli.cmd.server.thread.list.desc": "列出 JVM 线程摘要，帮助定位正在工作、执行 SQL 或处于特定状态的线程。\n\n不返回完整堆栈。线程 ID 只在对应节点和时刻有意义。",
+	"cli.cmd.server.thread.list.out": "--json 返回 threads[]，threadId、taskSerial 和 cancelSerial 均为字符串，避免大整数精度丢失；state 使用大写 JVM 状态，如 TIMED_WAITING。working、executingSql、cancelable 分别表示工作、SQL 执行和可取消状态；cancelSerial 用于 cancel，缺失时不能据此发起取消。列表不含完整 stacks。",
+	"cli.cmd.server.thread.list.cluster": "查询 server cluster list 返回的节点 name；省略时查询当前 HTTP 节点。",
 	"cli.cmd.server.thread.list.empty": "没有 JVM 线程匹配当前过滤条件。",
 	"cli.cmd.server.thread.dump.summary": "抓取 JVM 线程转储。",
-	"cli.cmd.server.thread.dump.desc": "抓取匹配条件的 JVM 线程及其未截断的调用堆栈。",
-	"cli.cmd.server.thread.dump.cluster": "从指定的单个集群节点抓取线程转储。",
+	"cli.cmd.server.thread.dump.desc": "抓取 JVM 线程及其完整调用堆栈，帮助排查阻塞和执行位置。\n\n支持按线程状态、工作任务和 SQL 执行情况筛选。结果是一次采样的快照，不代表持续占用。",
+	"cli.cmd.server.thread.dump.out": "--json 返回 capturedAt（Unix 毫秒）、threads[] 和 deadlockedThreadIds[]；线程的 stacks 为完整调用帧数组，线程 ID 使用字符串。deadlockedThreadIds 为此快照检测到的死锁线程，空数组只表示本次未检测到；不代表持续运行状态。",
+	"cli.cmd.server.thread.dump.cluster": "从 server cluster list 返回的节点 name 抓取；省略时使用当前 HTTP 节点。",
 	"cli.cmd.server.thread.dump.deadlocks.none": "死锁：无",
 	"cli.cmd.server.thread.dump.deadlocks.found": "死锁：{0}",
 	"cli.cmd.server.thread.dump.waitingLock": "正在等待锁 {0}",
 	"cli.cmd.server.thread.dump.waitingLockOwned": "正在等待锁 {0}，持有线程 #{1}",
 	"cli.cmd.server.thread.top.summary": "采样 JVM 线程热点。",
-	"cli.cmd.server.thread.top.desc": "轮询 CPU、线程、内存和 GC 原始采样并在本地分析，服务器不保留最终报告。",
-	"cli.cmd.server.thread.top.cluster": "采样指定集群节点；传入 all 时由客户端并发轮询当前全部成员。",
+	"cli.cmd.server.thread.top.desc": "连续采样并分析 CPU、线程、内存和 GC，帮助定位热点和疑似停滞。\n\n分析在本地完成，服务器不保留最终报告。采样只反映观察窗口，缺失采样不能视为零负载。",
+	"cli.cmd.server.thread.top.out": "--json 返回最终报告。单节点含 status（completed 或 partial）、sampleCount、hotThreads、findings、memory、garbageCollectors 和 warnings；findings 是诊断线索，不是已确认故障。--cluster=all 时返回 nodes[]、globalHotThreads、globalFindings、requestedNodeCount 和 sampledNodeCount，失败节点保留错误信息。partial 或 warnings 表示采样不完整或存在限制；缺失 CPU 等统计不能当作零。",
+	"cli.cmd.server.thread.top.out.node": "节点",
+	"cli.cmd.server.thread.top.out.cpu": "CPU 占用",
+	"cli.cmd.server.thread.top.out.processShare": "进程占比",
+	"cli.cmd.server.thread.top.out.location": "首帧",
+	"cli.cmd.server.thread.top.out.details": "详情",
+	"cli.cmd.server.thread.top.out.reason": "原因",
+	"cli.cmd.server.thread.top.out.hits": "命中",
+	"cli.cmd.server.thread.top.out.status": "状态",
+	"cli.cmd.server.thread.top.out.error": "错误",
+	"cli.cmd.server.thread.top.out.samples": "采样数",
+	"cli.cmd.server.thread.top.out.heap": "堆内存",
+	"cli.cmd.server.thread.top.out.heapDelta": "堆变化",
+	"cli.cmd.server.thread.top.out.collector": "收集器",
+	"cli.cmd.server.thread.top.out.gcCount": "回收次数",
+	"cli.cmd.server.thread.top.out.gcTime": "GC 时间",
+	"cli.cmd.server.thread.top.cluster": "采样 server cluster list 返回的节点 name；all 表示当前全部成员。",
 	"cli.cmd.server.thread.top.duration": "设置客户端 1 秒到 20 秒的分析窗口，使用 ms 或 s 后缀。",
 	"cli.cmd.server.thread.top.interval": "设置服务端每次 200 毫秒到 2 秒的采样窗口，分析窗口内至少需要包含两次采样。",
 	"cli.cmd.server.thread.top.refresh": "设置 500 毫秒到 5 秒的客户端实时报告刷新间隔。",
-	"cli.cmd.server.thread.top.limit": "限制热点线程和疑似停滞项的条数，范围为 1 到 50。",
+	"cli.cmd.server.thread.top.limit": "限制热点线程和疑似停滞项的条数。",
 	"cli.cmd.server.thread.top.noProgress": "不显示实时报告，只输出最终报告。",
 	"cli.cmd.server.thread.top.nodeSummary": "节点 {0}：采样 {1}，完成 {2} 次采样，观察到 {3} 个线程。",
 	"cli.cmd.server.thread.top.cpuSummary": "JVM 进程 CPU：{0}；已归集 Java 线程 CPU：{1}。",
@@ -520,31 +673,18 @@
 	"cli.cmd.server.thread.top.hotThreads": "热点线程：",
 	"cli.cmd.server.thread.top.stallCandidates": "长期线程诊断项（仅为诊断线索，不表示已确认故障）：",
 	"cli.cmd.server.thread.top.warnings": "警告：{0}",
-	"cli.cmd.server.thread.top.out.node": "节点",
-	"cli.cmd.server.thread.top.out.cpu": "CPU 占用",
-	"cli.cmd.server.thread.top.out.processShare": "进程占比",
-	"cli.cmd.server.thread.top.out.location": "首帧",
-	"cli.cmd.server.thread.top.out.details": "详情",
-	"cli.cmd.server.thread.top.out.reason": "原因",
-	"cli.cmd.server.thread.top.out.hits": "命中",
-	"cli.cmd.server.thread.top.out.status": "状态",
-	"cli.cmd.server.thread.top.out.error": "错误",
-	"cli.cmd.server.thread.top.out.samples": "采样数",
-	"cli.cmd.server.thread.top.out.heap": "堆内存",
-	"cli.cmd.server.thread.top.out.heapDelta": "堆变化",
-	"cli.cmd.server.thread.top.out.collector": "收集器",
-	"cli.cmd.server.thread.top.out.gcCount": "回收次数",
-	"cli.cmd.server.thread.top.out.gcTime": "GC 时间",
 	"cli.cmd.server.thread.show.summary": "显示一个 JVM 线程。",
-	"cli.cmd.server.thread.show.desc": "显示线程当前快照、已授权 SQL 信息和完整堆栈。",
-	"cli.cmd.server.thread.show.cluster": "从指定的单个集群节点读取线程。",
+	"cli.cmd.server.thread.show.desc": "查看单个线程的当前快照、已授权 SQL 信息和完整堆栈。\n\n线程可能已经结束或切换任务；快照和取消序号只代表读取时的状态。",
+	"cli.cmd.server.thread.show.out": "--json 返回 thread 对象。threadId、taskSerial、cancelSerial 为字符串；stacks 为调用帧数组，state 为大写 JVM 状态。sql 受权限和脱敏影响，sqlTruncated 表示 SQL 被截断，maskedFields 标记脱敏字段；字段缺失不表示没有执行 SQL。cancelable 和最新 cancelSerial 用于判断能否请求取消。",
+	"cli.cmd.server.thread.show.cluster": "读取 server cluster list 返回的节点 name；与 list 使用同一节点。",
 	"cli.cmd.server.thread.show.stack": "堆栈：",
 	"cli.cmd.server.thread.show.stackEmpty": "  （堆栈已不可用）",
 	"cli.cmd.server.thread.cancel.summary": "请求取消 JVM 线程任务。",
-	"cli.cmd.server.thread.cancel.desc": "仅当当前任务仍匹配取消序号时，请求协作式取消已登记的产品任务。",
-	"cli.cmd.server.thread.cancel.cancelSerial": "传入 thread list 或 show 返回的当前取消序号。",
-	"cli.cmd.server.thread.cancel.cluster": "取消指定单个集群节点上的任务。",
-	"cli.cmd.server.thread.cancel.force": "确认发起协作式取消请求。",
+	"cli.cmd.server.thread.cancel.desc": "请求协作式取消 JVM 线程上已登记的产品任务。\n\n只有当前任务仍与取消序号匹配时才会发起请求，不能用于任意 JVM 线程终止。\n\n成功表示已请求取消，不保证任务立即结束。",
+	"cli.cmd.server.thread.cancel.out": "--json 返回 success=true 仅表示取消请求已受理，不代表线程或任务已经结束。",
+	"cli.cmd.server.thread.cancel.cancelSerial": "传入 thread list 或 show 返回的当前取消序号，须与最新任务匹配，并保持与 show 相同的节点。",
+	"cli.cmd.server.thread.cancel.cluster": "取消指定节点 name 上的任务；与 show 使用同一节点。",
+	"cli.cmd.server.thread.cancel.force": "确认发起协作式取消请求。\n\n必填。",
 	"cli.cmd.server.thread.cancel.requested": "已请求取消节点 {1} 上的线程 {0}。",
 	"cli.cmd.server.thread.out.id": "线程 ID",
 	"cli.cmd.server.thread.out.working": "工作中",
@@ -562,46 +702,56 @@
 	"cli.cmd.server.thread.out.logAvailable": "可查看日志",
 	"cli.cmd.server.techLog.title": "服务器技术日志",
 	"cli.cmd.server.techLog.summary": "查看和管理服务器技术日志",
-	"cli.cmd.server.techLog.desc": "查看技术日志并管理运行时 logger 级别；这些命令需要系统设置中控制台的访问权限。",
-	"cli.cmd.server.techLog.*.cluster": "从指定集群节点读取；省略时使用当前 HTTP 节点。运行 'succapp server cluster list' 获取节点名。",
+	"cli.cmd.server.techLog.desc": "查看服务器技术日志并管理运行时日志级别，帮助排查运行问题。\n\n支持文件列表、日志读取与持续跟踪、文件下载及节点日志级别管理。\n\n需要系统设置控制台的相应访问权限。日志级别修改会影响服务器运行时配置。",
+	"cli.cmd.server.techLog.*.cluster": "从指定集群节点读取；省略时使用当前 HTTP 节点。运行 'succapp server cluster list' 获取节点的 name。",
+	"cli.cmd.server.techLog.*.url": "目标服务器 URL；优先于 --server、工作区活跃服务器和 SUCCAPP_SERVER。",
 	"cli.cmd.server.techLog.list.summary": "列出技术日志文件。",
-	"cli.cmd.server.techLog.list.desc": "列出服务器系统设置控制台中相同的 .log 文件；需要控制台查看权限。",
+	"cli.cmd.server.techLog.list.desc": "列出服务器技术日志文件，帮助选择需要读取或下载的日志。\n\n列表来自服务器日志目录，与系统设置控制台一致，不是本地 CLI 日志。\n\n需要控制台查看权限。",
+	"cli.cmd.server.techLog.list.out": "--json 返回 files[]、levels[] 和 warnings[]。files[].name 用于 download，size 为字节数，modifyTime 为 Unix 毫秒；levels 为日志级别信息，专门查看请用 level list。warnings 说明节点读取等限制，不应忽略；无日志文件时 files 为 []。",
 	"cli.cmd.server.techLog.list.empty": "此节点没有可用的技术日志文件。",
 	"cli.cmd.server.techLog.tail.summary": "读取技术日志尾部。",
-	"cli.cmd.server.techLog.tail.desc": "使用系统设置页面相同的游标协议读取当前技术日志；需要控制台查看权限。单次 JSON 结果中的 content 是日志明文。",
-	"cli.cmd.server.techLog.tail.lines": "首次日志片段保留的末尾行数（1 到 5000，默认 200）。",
-	"cli.cmd.server.techLog.tail.from": "从上一次单次 JSON 结果的位置继续读取；必须同时传入 --log-file。",
-	"cli.cmd.server.techLog.tail.logFile": "使用上一次单次 JSON 结果中的日志文件；必须同时传入 --from。",
-	"cli.cmd.server.techLog.tail.follow": "持续轮询并追加新日志，按 Ctrl+C 结束。",
-	"cli.cmd.server.techLog.tail.interval": "设置跟随轮询间隔（毫秒，500 到 60000）；必须同时使用 --follow。",
+	"cli.cmd.server.techLog.tail.desc": "读取当前技术日志，帮助排查运行问题。支持单次读取、持续跟踪，以及从上次读取位置继续获取日志。\n\n需要控制台查看权限。只读取日志，不修改服务器日志内容或日志级别。",
+	"cli.cmd.server.techLog.tail.out": "文本模式直接输出日志正文；需要续读游标时使用 --json 或 --pretty-json。JSON 中的关键字段如下：\n\ncontent：本次日志明文。logFile 非空而 content 为空，表示本次没有返回日志内容；不等于读取失败。logFile=null 表示本次没有可用日志文件，不能据此构造续读请求。\n\nfrom：以字符串返回的非负十进制整数游标，应原样传回，不是行号，不要自行计算。logFile：与该游标配套的日志文件名。reset=true 表示游标已重置，不能把本次内容当作原文件的连续增量。\n\n示例先读取一次 JSON，再将同一次响应的 from 和非空 logFile 分别赋给 POSITION 和 CURSOR_FILE。使用相同的 SERVER 和 NODE 续读；没有可用文件时重新查询，不把旧文件的游标用于另一节点或文件。",
+	"cli.cmd.server.techLog.tail.cluster": "从指定集群节点读取；省略时使用当前 HTTP 节点。NODE 取自 succapp server cluster list 返回的节点 name；首次查询和续读须保持相同节点。",
+	"cli.cmd.server.techLog.tail.lines": "首次读取保留的末尾行数；不能与 --from 或 --log-file 同用。",
+	"cli.cmd.server.techLog.tail.from": "上次 JSON 返回的 from 游标，以字符串表示非负十进制整数，原样传回；不是行号。必须配合 --log-file，不能与 --lines 同用，续读须保持相同服务器及节点。",
+	"cli.cmd.server.techLog.tail.logFile": "与 --from 来自同一次 JSON 响应的非空 logFile；必须配合 --from，不能与 --lines 同用。",
+	"cli.cmd.server.techLog.tail.follow": "持续读取新增日志，按 Ctrl+C 停止；省略时读取一次。仅支持文本输出，不能与 --json 或 --pretty-json 同用。",
+	"cli.cmd.server.techLog.tail.interval": "跟随轮询间隔，单位毫秒；仅用于 --follow。",
 	"cli.cmd.server.techLog.tail.retry": "临时网络错误；第 {0} 次重试将在 {1} 毫秒后执行。",
 	"cli.cmd.server.techLog.download.summary": "下载技术日志文件。",
-	"cli.cmd.server.techLog.download.desc": "下载 'succapp server tech-log list' 返回的文件；需要控制台日志导出权限。",
-	"cli.cmd.server.techLog.download.cluster": "从指定集群节点下载；省略时使用当前 HTTP 节点。运行 'succapp server cluster list' 获取节点名。",
-	"cli.cmd.server.techLog.download.file": "使用 'succapp server tech-log list' 返回的准确文件名。",
-	"cli.cmd.server.techLog.download.output": "将日志写入此本地文件。",
-	"cli.cmd.server.techLog.download.force": "本地输出文件已存在时覆盖。",
+	"cli.cmd.server.techLog.download.desc": "将指定的服务器技术日志文件下载到本机。\n\n适用于保留日志供离线排查；只下载选定节点的日志，不清理或轮转服务器日志。\n\n需要控制台日志导出权限。操作会写入本地文件。",
+	"cli.cmd.server.techLog.download.out": "--json 返回 file（服务器日志文件名）、output（本地绝对路径）和 size（下载后的字节数）。日志正文保存在 output，不包含在 JSON 中。",
+	"cli.cmd.server.techLog.download.cluster": "从指定集群节点下载；省略时使用当前 HTTP 节点。运行 'succapp server cluster list' 获取节点的 name。",
+	"cli.cmd.server.techLog.download.file": "使用 'succapp server tech-log list' 返回的准确文件名。\n\nLOG_FILE 取自同一节点的 tech-log list；NODE 使用 server cluster list 返回的 name，变量加双引号。",
+	"cli.cmd.server.techLog.download.output": "日志输出的本地文件；覆盖已有文件需要 --force。",
+	"cli.cmd.server.techLog.download.force": "允许覆盖已存在的本地输出文件。",
 	"cli.cmd.server.techLog.download.downloaded": "已将技术日志 {0} 下载到 {1}",
 	"cli.cmd.server.techLog.level.title": "技术日志级别",
 	"cli.cmd.server.techLog.level.summary": "查看和管理 logger 级别",
-	"cli.cmd.server.techLog.level.desc": "查看、持久化、热更新和重置 logger 级别；这些命令需要系统设置中控制台的查看权限。",
-	"cli.cmd.server.techLog.level.*.cluster": "修改指定集群节点；省略时使用当前 HTTP 节点。运行 'succapp server cluster list' 获取节点名。",
+	"cli.cmd.server.techLog.level.desc": "查看和管理服务器节点的日志级别。\n\n可比较保存值与实际生效值，修改或恢复单个 logger 的继承级别，并向集群下发完整日志配置。\n\n需要控制台查看权限；配置修改会持久化并影响运行时日志。",
+	"cli.cmd.server.techLog.level.*.cluster": "修改指定集群节点；省略时使用当前 HTTP 节点。运行 'succapp server cluster list' 获取节点的 name。",
+	"cli.cmd.server.techLog.level.*.url": "目标服务器 URL；优先于 --server、工作区活跃服务器和 SUCCAPP_SERVER。",
 	"cli.cmd.server.techLog.level.list.summary": "列出 logger 级别。",
-	"cli.cmd.server.techLog.level.list.desc": "列出目标节点持久化和实际生效的 logger 级别；需要控制台查看权限。",
-	"cli.cmd.server.techLog.level.list.cluster": "从指定集群节点读取；省略时使用当前 HTTP 节点。运行 'succapp server cluster list' 获取节点名。",
+	"cli.cmd.server.techLog.level.list.desc": "列出目标节点的日志级别，帮助比较持久化配置和实际生效值。\n\n可判断 logger 继承结果；一个节点的结果不代表集群所有节点一致。\n\n需要控制台查看权限。",
+	"cli.cmd.server.techLog.level.list.out": "--json 返回 levels[]；package 是 logger 名称，configuredLevel 是显式配置级别，effectiveLevel 是运行时实际级别，level 为服务器返回的级别值。未配置项可继承父级，字段缺失不等于 OFF；用 effectiveLevel 判断实际生效情况。",
+	"cli.cmd.server.techLog.level.list.cluster": "从指定集群节点读取；省略时使用当前 HTTP 节点。运行 'succapp server cluster list' 获取节点的 name。",
 	"cli.cmd.server.techLog.level.set.summary": "设置 logger 级别。",
-	"cli.cmd.server.techLog.level.set.desc": "在目标节点持久化并热更新一个 logger 级别；需要控制台查看权限。",
-	"cli.cmd.server.techLog.level.set.force": "确认使用 TRACE 或 DEBUG，并已检查运行影响。",
+	"cli.cmd.server.techLog.level.set.desc": "修改并持久化目标节点上一个 logger 的级别，使其在运行时生效。\n\n需要控制台查看权限。更详细的日志级别可能增加日志量与运行开销；修改不会自动传播到其他集群节点。",
+	"cli.cmd.server.techLog.level.set.out": "--json 返回 package（logger 名称）和提交的 level；修改后的实际生效值使用 level list 查询。",
+	"cli.cmd.server.techLog.level.set.force": "确认使用 TRACE 或 DEBUG，并已检查运行影响。\n\nTRACE 和 DEBUG 必须使用。",
 	"cli.cmd.server.techLog.level.set.logger": "使用准确的具名 logger；不能是 root，也不能包含通配符。",
 	"cli.cmd.server.techLog.level.set.level": "只能使用 TRACE、DEBUG、INFO 或 ERROR，且区分大小写。",
 	"cli.cmd.server.techLog.level.set.updated": "已将 logger {0} 更新为 {1}",
 	"cli.cmd.server.techLog.level.reset.summary": "重置具名 logger 级别。",
-	"cli.cmd.server.techLog.level.reset.desc": "删除 logger 的显式级别，使其继承父级；需要控制台查看权限。",
+	"cli.cmd.server.techLog.level.reset.desc": "移除 logger 的显式级别，使其恢复继承父级配置。\n\n需要控制台查看权限。实际生效级别取决于父级，恢复继承不等于关闭日志。",
+	"cli.cmd.server.techLog.level.reset.out": "--json 返回 package（logger 名称）；不回传继承后的实际级别，使用 level list 查询。",
 	"cli.cmd.server.techLog.level.reset.logger": "使用准确的具名 logger；不能是 root，也不能包含通配符。",
 	"cli.cmd.server.techLog.level.reset.reset": "已重置 logger 级别：{0}",
 	"cli.cmd.server.techLog.level.apply.summary": "向集群应用 logger 级别。",
-	"cli.cmd.server.techLog.level.apply.desc": "向可达节点提交当前 HTTP 节点的完整 Logback 配置；需要控制台查看权限。成功仅表示已提交，不表示每个节点均处理成功。",
-	"cli.cmd.server.techLog.level.apply.force": "确认替换可达集群节点的完整 Logback 配置。",
+	"cli.cmd.server.techLog.level.apply.desc": "向可达集群节点提交当前 HTTP 节点的完整日志配置。\n\n需要控制台查看权限。下发范围是完整 Logback 配置，不只是单个 logger；操作可能替换目标节点原有配置。\n\n成功仅表示已提交，不保证每个节点均处理成功。",
+	"cli.cmd.server.techLog.level.apply.out": "命令成功只表示完整配置已提交，不包含逐节点执行结果；请逐节点使用 level list 核验。",
+	"cli.cmd.server.techLog.level.apply.force": "确认替换可达集群节点的完整 Logback 配置。\n\n必填。",
 	"cli.cmd.server.techLog.level.apply.applied": "已向集群提交 Logback 配置。",
 	"cli.cmd.server.techLog.out.file": "文件",
 	"cli.cmd.server.techLog.out.size": "大小",
@@ -612,19 +762,26 @@
 	"cli.cmd.server.techLog.out.effectiveLevel": "生效级别",
 	"cli.cmd.server.proj.title": "服务器项目",
 	"cli.cmd.server.proj.summary": "查看服务器项目",
-	"cli.cmd.server.proj.desc": "查看服务器项目。",
+	"cli.cmd.server.proj.desc": "查看和创建服务器上的元数据项目。\n\n可了解当前用户可见的项目，帮助确定资源所属范围。\n\n新建操作直接在服务器生效，不会自动生成本地工作区副本。",
 	"cli.cmd.server.proj.list.summary": "列出服务器项目。",
-	"cli.cmd.server.proj.list.desc": "列出服务器上的可见项目。",
+	"cli.cmd.server.proj.list.desc": "列出服务器上当前用户可见的项目。\n\n列表受用户权限影响，未列出不一定表示项目不存在。",
+	"cli.cmd.server.proj.list.out": "--json 返回 projects[]；name 是后续命令使用的项目名称，id 为项目标识，desc 为可选描述。没有可见项目时 projects 为 [] 并返回 empty。",
 	"cli.cmd.server.proj.list.empty": "未找到可见项目。",
 	"cli.cmd.server.proj.create.summary": "创建服务器项目。",
-	"cli.cmd.server.proj.create.desc": "在服务器上创建元数据项目。",
+	"cli.cmd.server.proj.create.desc": "在服务器上创建元数据项目。\n\n创建直接影响服务器，不会自动克隆到本地。响应中断时，项目可能已经创建。",
+	"cli.cmd.server.proj.create.out": "--json 返回 project，包含新项目的 name、id 和可选 desc；使用 name 继续克隆或查询项目。",
 	"cli.cmd.server.proj.create.descOption": "设置项目描述。",
 	"cli.cmd.server.proj.create.created": "已创建服务器项目：{0}",
+	"cli.cmd.server.proj.create.project": "新项目名称；已有项目可用 server project list 查询。",
+	"cli.cmd.server.proj.*.url": "目标服务器 URL；优先于 --server、工作区活跃服务器和 SUCCAPP_SERVER。",
 	"cli.cmd.server.file.title": "服务器文件",
 	"cli.cmd.server.file.summary": "查看和操作服务器元数据文件",
-	"cli.cmd.server.file.desc": "查看和操作服务器元数据文件。",
+	"cli.cmd.server.file.desc": "查询和管理服务器元数据文件。\n\n支持目录浏览、文件搜索、信息与内容读取、版本历史、下载，以及创建、更新、移动、重命名和删除。\n\n写入类操作直接修改服务器资源，不更新本地工作区。",
 	"cli.cmd.server.file.*.file": "从本地文件读取内容。",
 	"cli.cmd.server.file.*.stdin": "从标准输入读取内容。",
+	"cli.cmd.server.file.*.url": "目标服务器 URL；优先于 --server、工作区活跃服务器和 SUCCAPP_SERVER。",
+	"cli.cmd.server.file.*.path": "服务器元数据路径，例如 /DEMO/ana/sales.dash，不是本地文件路径。",
+	"cli.cmd.server.file.*.id": "元数据 ID，可从 server file info 的文件信息取得。",
 	"cli.cmd.server.file.badValue": "{0} 的值无效：{1}",
 	"cli.cmd.server.file.expectedRevRequired": "{0} 需要 --expected-revision=<n>，除非使用 --force。",
 	"cli.cmd.server.file.fileOrStdinConflict": "--file 和 --stdin 只能使用一个。",
@@ -634,12 +791,21 @@
 	"cli.cmd.server.file.missingServerFile": "缺少服务器文件路径。",
 	"cli.cmd.server.file.revForceConflict": "{0} 只能使用 --expected-revision 或 --force 之一。",
 	"cli.cmd.server.file.success": "{0} 成功：{1}",
+	"cli.cmd.server.file.success.Create": "已创建服务器文件：{0}",
+	"cli.cmd.server.file.success.Put": "已更新服务器文件：{0}",
+	"cli.cmd.server.file.success.Update": "已更新服务器文件：{0}",
+	"cli.cmd.server.file.success.Delete": "已删除服务器文件：{0}",
+	"cli.cmd.server.file.success.Move": "已移动服务器文件：{0}",
+	"cli.cmd.server.file.success.Rename": "已重命名服务器文件：{0}",
 	"cli.cmd.server.file.unknownServerFile": "未知服务器文件错误。",
 	"cli.cmd.server.file.list.summary": "列出服务器文件。",
-	"cli.cmd.server.file.list.desc": "列出服务器元数据目录的直接子项。",
+	"cli.cmd.server.file.list.desc": "列出服务器元数据目录的直接子项。\n\n适用于浏览当前目录，不递归列出整棵目录树。",
+	"cli.cmd.server.file.list.out": "--json 返回 files[] 和 summary.files。每项包含 id、name、remotePath、remoteParentPath、isFolder 及服务器提供的可选元数据；详细字段见 server file info --help。无子项时 files 为 [] 并返回 empty；这只是当前目录的直接子项，不是目录树总量。",
 	"cli.cmd.server.file.list.empty": "目录为空：{0}",
+	"cli.cmd.server.file.list.path": "服务器元数据目录的绝对路径，例如 /DEMO/ana，不是本地文件路径。含空格时须加引号；只返回目录直接子项。\n\n省略时查询服务器元数据根目录 /。",
 	"cli.cmd.server.file.search.summary": "搜索服务器文件。",
-	"cli.cmd.server.file.search.desc": "按完整路径，或按可组合的项目、父目录和文件名条件搜索可读取的服务器元数据文件。",
+	"cli.cmd.server.file.search.desc": "搜索当前用户可读取的服务器元数据文件。\n\n支持完整路径定位，以及项目、父目录、文件名和内容等组合筛选。结果受权限与返回数量限制，空结果或达到上限不能证明资源不存在。",
+	"cli.cmd.server.file.search.out": "--json 返回 results[]：file 为文件元数据，file.remotePath 是服务器路径；score 为相关性得分，matchedOn 说明命中位置，warnings 说明部分正文未检查等限制。文件字段见 server file info --help。summary.returned 为返回数，summary.limit 为本次上限，summary.hasMore 表示仍有匹配项；不提供匹配总数和 offset 分页。无匹配时 results 为 [] 并返回 empty。",
 	"cli.cmd.server.file.search.url": "可选的服务器 URL。只传一个非 URL 参数时，该参数按 <query> 处理。",
 	"cli.cmd.server.file.search.query": "以 '/' 开头时按完整路径或路径 glob 搜索；包含 '*' 或 '?' 时按文件名 glob 搜索；其他输入按文件元数据关键词搜索。",
 	"cli.cmd.server.file.search.path": "按元数据绝对路径 glob 搜索，项目根路径默认递归搜索；可以与关键词 <query> 组合，不能与路径型 <query>、--project、--parent-dir 或 --name 组合。",
@@ -650,7 +816,7 @@
 	"cli.cmd.server.file.search.subType": "只搜索指定元数据子类型。可重复使用或用逗号分隔。",
 	"cli.cmd.server.file.search.minSize": "原始内容最小字节数。",
 	"cli.cmd.server.file.search.maxSize": "原始内容最大字节数。",
-	"cli.cmd.server.file.search.limit": "最多返回指定数量的最相关文件。默认 50，最大 1000。",
+	"cli.cmd.server.file.search.limit": "最多返回的最相关文件数；省略时为 50。",
 	"cli.cmd.server.file.search.includeFolders": "结果中包含文件夹。",
 	"cli.cmd.server.file.search.contentContains": "文本文件正文必须包含每个重复传入的普通文本或 /pattern/flags 正则；普通文本忽略大小写且不解析通配符，正则无 flags 时默认多行；参数值不会按逗号拆分。",
 	"cli.cmd.server.file.search.contentContainsAny": "文本文件正文至少包含一个重复传入的普通文本或 /pattern/flags 正则；普通文本忽略大小写且不解析通配符，正则无 flags 时默认多行；参数值不会按逗号拆分。",
@@ -659,103 +825,214 @@
 	"cli.cmd.server.file.search.nameHint": "没有通配符时文件名按精确值匹配，CLI 不会自动补通配符。",
 	"cli.cmd.server.file.search.hasMore": "仅显示最相关的 {0} 个文件；请增加项目、目录、类型或更准确的关键词来缩小范围。",
 	"cli.cmd.server.file.search.warningDetails": "正文未检查；请使用 --json 查看完整原因。",
-	"cli.cmd.server.recyclebin.title": "服务器回收站",
-	"cli.cmd.server.recyclebin.summary": "搜索服务器回收站文件",
-	"cli.cmd.server.recyclebin.desc": "搜索和查看服务器项目回收站中当前用户可见的已删除文件。",
-	"cli.cmd.server.recyclebin.search.summary": "搜索服务器回收站文件。",
-	"cli.cmd.server.recyclebin.search.desc": "按关键词、路径、类型或删除时间搜索项目回收站中当前用户可见的文件。",
-	"cli.cmd.server.recyclebin.search.url": "可选的服务器 URL。第一个非 URL 参数按 <project> 处理。",
-	"cli.cmd.server.recyclebin.search.project": "要搜索回收站的项目名。",
-	"cli.cmd.server.recyclebin.search.query": "搜索关键词、完整元数据路径或路径 glob。",
-	"cli.cmd.server.recyclebin.search.type": "只搜索指定元数据类型。可重复使用或用逗号分隔。",
-	"cli.cmd.server.recyclebin.search.deletedAfter": "只返回在该时间之后删除的文件，包含边界。支持毫秒时间戳或 ISO-8601。",
-	"cli.cmd.server.recyclebin.search.deletedBefore": "只返回在该时间之前删除的文件，包含边界。支持毫秒时间戳或 ISO-8601。",
-	"cli.cmd.server.recyclebin.search.limit": "最多返回指定数量的文件。默认 50，最大 1000。",
-	"cli.cmd.server.recyclebin.search.empty": "项目 {0} 的回收站中没有匹配文件。",
-	"cli.cmd.server.recyclebin.search.hasMore": "仅显示 {0} 个回收站文件；请增加类型、删除时间范围或更准确的关键词来缩小范围。",
 	"cli.cmd.server.file.locate.summary": "根据元数据 ID 定位服务器文件。",
-	"cli.cmd.server.file.locate.desc": "把元数据 ID 解析为当前服务器文件路径。",
+	"cli.cmd.server.file.locate.desc": "根据元数据 ID 定位服务器文件。\n\n可获取当前文件路径及查看、编辑地址，帮助从资源标识找到对应文件。",
+	"cli.cmd.server.file.locate.out": "--json 返回 id、remotePath、viewUrl、editUrl 和 file 元数据；文件字段见 server file info --help。--url 只改变文本输出，JSON 仍返回完整定位结果。",
 	"cli.cmd.server.file.locate.url": "只打印服务器查看或编辑 URL。",
 	"cli.cmd.server.file.locate.viewUrl": "查看 URL：{0}",
 	"cli.cmd.server.file.locate.editUrl": "编辑 URL：{0}",
 	"cli.cmd.server.file.info.summary": "显示服务器文件信息。",
-	"cli.cmd.server.file.info.desc": "显示文件或目录的服务器端元数据。",
+	"cli.cmd.server.file.info.desc": "查看服务器文件或目录的元数据。\n\n可了解资源路径、类型、描述、修订和修改时间等信息，帮助确认目标和版本。",
+	"cli.cmd.server.file.info.out": "JSON 业务字段示例（省略公共上下文；注释仅供说明，实际输出为严格 JSON；可选字段仅在服务器提供时返回）：\n    {\n      \"remotePath\": \"/project/data/table.tbl\",   // 请求的服务器元数据路径\n      \"file\": {                                  // 服务器文件或目录的元数据\n        \"id\": \"file-id\",                         // 资源标识\n        \"revision\": 3,                           // 可选；内容版本，用于 --expected-revision；纯属性变化不递增\n        \"remotePath\": \"/project/data/table.tbl\", // 资源完整路径\n        \"remoteParentPath\": \"/project/data\",     // 父目录路径\n        \"name\": \"table.tbl\",                     // 文件名或目录名\n        \"projectName\": \"project\",                // 可选；所属项目\n        \"isFolder\": false,                       // true 表示目录\n        \"type\": \"tbl\",                           // 可选；资源类型\n        \"subFileType\": \"DataFlow\",               // 可选；服务器识别的子类型，仅适用的资源返回\n        \"icon\": \"icon-file\",                     // 可选；图标样式名或 URL\n        \"desc\": \"Table\",                         // 可选；资源描述\n        \"order\": 1,                              // 可选；排序值，省略或 0 时按名称排序\n        \"creator\": \"user-id\",                    // 可选；创建者用户 ID\n        \"createTime\": 1700000000000,             // 可选；创建时间，Unix 毫秒\n        \"modifier\": \"user-id\",                   // 可选；最后修改者用户 ID\n        \"modifyTime\": 1700000001000,             // 可选；Unix 毫秒，含内容或部分属性变化；目录反映整棵子树的变化\n        \"hidden\": true,                          // 可选；是否隐藏，省略时为 false\n        \"labels\": \"label-a,label-b\",             // 可选；逗号分隔的标签 ID\n        \"size\": 5,                               // 可选；文件未压缩原始内容字节数；目录可返回 0，不代表目录树大小\n        \"hash\": \"<SHA-256>\",                     // 可选；原始内容的 64 位十六进制 SHA-256，目录不返回；此处为占位值\n        \"option\": {},                            // 可选；产品附加属性对象\n        \"customOption\": {}                       // 可选；业务扩展的自定义属性\n      }\n    }\n\n文件属性 DTS 中的 path/parentDir 在 CLI 中分别命名为 remotePath/remoteParentPath，实际字段以本帮助为准。",
 	"cli.cmd.server.file.show.summary": "显示服务器文件内容。",
-	"cli.cmd.server.file.show.desc": "将服务器文件内容写入标准输出。查看可读文本时不要使用 --json；--json 会把内容按 Base64 包装给脚本使用。",
+	"cli.cmd.server.file.show.desc": "读取服务器文件内容。\n\n支持当前内容、历史版本，以及服务器提供的升级后内容。\n\n只读取内容，不把升级结果写回服务器。",
+	"cli.cmd.server.file.show.out": "普通输出是原始内容；JSON 对已知类型且有效的 UTF-8 文本直接返回 content，encoding 为 utf8；二进制、未知类型或无效 UTF-8 使用 Base64，encoding 为 base64。",
 	"cli.cmd.server.file.show.revision": "读取服务器文件修订。",
-	"cli.cmd.server.file.show.upgradeContent": "支持时返回升级后的元数据 JSON 内容。",
+	"cli.cmd.server.file.show.upgradeContent": "支持时返回升级后的元数据 JSON 内容。\n\n只影响返回内容，不写回服务器。",
 	"cli.cmd.server.file.download.summary": "下载服务器文件内容。",
-	"cli.cmd.server.file.download.desc": "将服务器文件内容下载到本地文件。",
+	"cli.cmd.server.file.download.desc": "将服务器文件内容下载到本地文件。\n\n支持历史版本及服务器提供的升级后内容。\n\n下载会写入本地文件，不修改服务器内容，也不建立工作区同步基线。",
+	"cli.cmd.server.file.download.out": "JSON 业务字段示例（省略公共上下文；注释仅供说明，实际输出为严格 JSON）：\n    {\n      \"remotePath\": \"/project/app/example.app/page.ftl\",  // 服务器资源路径\n      \"output\": \"/work/page.ftl\",                         // 本地绝对路径，文件内容写入此处\n      \"revision\": 3,                                      // 修订号，服务器提供时返回\n      \"modifyTime\": 1792195200000                         // 修改时间，毫秒时间戳，服务器提供时返回\n    }",
 	"cli.cmd.server.file.download.revision": "下载服务器文件的指定修订。",
 	"cli.cmd.server.file.download.upgradeContent": "支持时下载升级后的元数据 JSON 内容。",
-	"cli.cmd.server.file.download.output": "将内容写入本地文件。",
-	"cli.cmd.server.file.download.force": "如果本地输出文件已存在则覆盖。",
+	"cli.cmd.server.file.download.output": "内容输出的本地文件；已有文件需 --force 确认覆盖。",
+	"cli.cmd.server.file.download.force": "允许覆盖已存在的本地输出文件。",
 	"cli.cmd.server.file.download.downloaded": "已下载 {0} 到 {1}",
 	"cli.cmd.server.file.open.summary": "打开服务器文件页面。",
-	"cli.cmd.server.file.open.desc": "在系统浏览器中打开服务器文件的查看或编辑页面，也可以只返回页面 URL 而不打开浏览器。",
+	"cli.cmd.server.file.open.desc": "在系统浏览器中打开服务器资源页面。\n\n支持查看、编辑和只获取链接，可视化文件和代码文件分别进入对应编辑器。\n\n只打开页面或构造链接，不上传内容，也不检查资源是否存在。",
+	"cli.cmd.server.file.open.out": "--json 返回 remotePath、url、edit 和 opened。edit 表示是否使用编辑地址；opened 表示是否请求系统浏览器打开，--no-open 时为 false，不表示资源已通过存在性检查。",
 	"cli.cmd.server.file.open.edit": "打开服务器编辑页面，而不是默认的查看页面。",
 	"cli.cmd.server.file.open.noOpen": "只返回页面 URL，不启动系统浏览器。",
 	"cli.cmd.server.file.open.path": "服务器元数据绝对路径。命令只构造页面 URL，不检查文件是否存在。",
 	"cli.cmd.server.file.open.openedEdit": "已打开服务器编辑页面：{0}",
 	"cli.cmd.server.file.open.openedView": "已打开服务器查看页面：{0}",
 	"cli.cmd.server.file.history.summary": "显示服务器文件历史。",
-	"cli.cmd.server.file.history.desc": "显示服务器文件路径的服务器端历史。",
+	"cli.cmd.server.file.history.desc": "查看服务器文件的版本历史。\n\n记录来自服务器，不是本地 Git 历史；可用于了解变更和选择历史内容版本。",
+	"cli.cmd.server.file.history.out": "--json 返回 histories[] 和 summary.histories。revision 为历史内容版本，remotePath 为服务器路径，action 为变更动作，modifyTime 为 Unix 毫秒时间戳；message、detail 等字段在服务器提供时返回。无记录时 histories 为 [] 并返回 empty；条数受 --limit 限制，不代表全部历史。",
 	"cli.cmd.server.file.history.limit": "限制历史记录返回条数。",
-	"cli.cmd.server.file.create.summary": "创建服务器文件。",
-	"cli.cmd.server.file.create.desc": "创建服务器文件，若已存在则失败。",
+	"cli.cmd.server.file.create.summary": "创建服务器文件或文件夹。",
+	"cli.cmd.server.file.create.desc": "在服务器上创建元数据文件或文件夹，无需建立本地工作区。\n\n文件创建不覆盖已有资源；创建文件夹时，已有同名文件夹按成功处理，同名文件报错。父目录缺失时，服务器按权限决定是否连带创建。\n\n操作直接写入服务器，不更新本地工作区。响应中断时，创建可能已经完成，应先查询目标再决定是否重试。",
+	"cli.cmd.server.file.create.out": "JSON 返回 remotePath（目标服务器路径）和 result。文件创建还返回 source（file、stdin 或 template），本地文件来源包含 sourceFilePath；文件夹创建不返回正文来源。\n\nresult.metaInfo 为目标属性，isFolder 表示是否为文件夹；result.modifyTime 为 Unix 毫秒修改时间。result.contentMutation=created 表示本次新建，已有文件夹返回 none，且 result.metaInfoChanged=false；result.createdFiles 列出本次创建的资源。字段以服务器实际返回为准，属性说明见 server file info --help。",
+	"cli.cmd.server.file.create.input": "--folder、--file、--stdin 和 --template 最多选择一个。--folder 明确创建文件夹；未指定 --folder 时创建文件，不能通过无扩展名或路径末尾的斜杠推断为文件夹。\n\n显式正文可为空，指定模板时按模板创建；以上参数全部省略时，服务器尝试脚本内容模板、默认模板，否则创建空文件。正文须符合目标类型声明，不包含 CLI 结果信封。示例中的 /TEST_CLI 替换为目标项目，new.rpt 为已准备的本地正文文件。",
+	"cli.cmd.server.file.create.folder": "创建文件夹，不接收正文或模板；已有同名文件夹按成功处理。",
+	"cli.cmd.server.file.create.file": "本地内容文件。",
+	"cli.cmd.server.file.create.stdin": "从标准输入读取正文。",
+	"cli.cmd.server.file.create.template": "创建模板 ID，可从 dev template list 获取。",
 	"cli.cmd.server.file.update.summary": "更新服务器文件。",
-	"cli.cmd.server.file.update.desc": "更新已有服务器文件，默认带修订保护。",
-	"cli.cmd.server.file.update.expectedRevision": "仅当服务器修订仍匹配时更新。",
-	"cli.cmd.server.file.update.force": "不带修订保护覆盖当前服务器内容。",
-	"cli.cmd.server.file.remove.summary": "删除服务器文件。",
-	"cli.cmd.server.file.remove.desc": "删除已有服务器文件，默认带修订保护。",
-	"cli.cmd.server.file.remove.expectedRevision": "仅当服务器修订仍匹配时删除。",
-	"cli.cmd.server.file.remove.force": "不带修订保护删除当前服务器文件。",
-	"cli.cmd.server.ext.title": "服务器扩展",
-	"cli.cmd.server.ext.summary": "查看服务器扩展资源",
-	"cli.cmd.server.ext.desc": "查看服务器扩展资源。",
-	"cli.cmd.server.ext.template.title": "服务器扩展模板",
-	"cli.cmd.server.ext.template.summary": "查看服务器扩展模板",
-	"cli.cmd.server.ext.template.desc": "查看服务器扩展模板。",
-	"cli.cmd.server.ext.template.list.summary": "列出扩展模板。",
-	"cli.cmd.server.ext.template.list.desc": "列出服务器可用的扩展模板。",
-	"cli.cmd.server.ext.template.list.extensionPoint": "只列出指定扩展点的模板。",
-	"cli.cmd.server.script.title": "服务器脚本",
-	"cli.cmd.server.script.summary": "执行和检查服务器脚本",
-	"cli.cmd.server.script.desc": "执行和检查服务器脚本。",
-	"cli.cmd.server.script.done": "脚本命令完成。",
-	"cli.cmd.server.script.invalidJsonInput": "JSON 输入文件无效：{0}",
-	"cli.cmd.server.script.exec.summary": "在服务器上执行本地脚本。",
-	"cli.cmd.server.script.exec.desc": "读取本地脚本文件，并在服务器支持时通过 Dev Tool v2 执行。",
-	"cli.cmd.server.script.exec.input": "从文件读取脚本输入。",
-	"cli.cmd.server.script.exec.param": "传入脚本参数，可重复。",
-	"cli.cmd.server.script.check.summary": "在服务器上检查本地脚本。",
-	"cli.cmd.server.script.check.desc": "读取本地脚本文件，并在服务器支持时通过 Dev Tool v2 编译。",
+	"cli.cmd.server.file.update.desc": "更新服务器上已有元数据文件的内容。\n\n支持根据已读取的修订进行并发保护，避免覆盖其他人的修改。\n\n操作直接修改服务器文件，不更新本地工作区；跳过修订保护可能覆盖远端变化。",
+	"cli.cmd.server.file.update.out": "JSON 返回 remotePath、source（file 或 stdin）和 result。文件输入另有 sourceFilePath，为本地绝对路径。\n\nresult 包含服务器确认的变更信息，例如 metaInfo、modifyTime 和 warnings；仅在服务器返回时提供。metaInfo.revision 是内容版本，modifyTime 为修改时间（Unix 毫秒）。文件属性含义见 server file info --help。",
+	"cli.cmd.server.file.update.revisionInput": "--expected-revision 与 --force 必须且只能选择一个：根据已读取的修订更新，或明确跳过修订保护。",
+	"cli.cmd.server.file.update.expectedRevision": "仅当服务器当前内容修订与此值一致时更新；取自 server file info。冲突后重新读取并比较。",
+	"cli.cmd.server.file.update.force": "跳过修订保护，覆盖服务器当前内容。",
+	"cli.cmd.server.file.update.input": "--file 与 --stdin 必须且只能选择一个。内容须符合目标文件类型的声明，如 rpt.d.ts、dash.d.ts、tbl.d.ts，不是 CLI 结果信封。",
+	"cli.cmd.server.file.update.file": "本地内容文件。",
+	"cli.cmd.server.file.update.stdin": "从标准输入读取内容。",
+	"cli.cmd.server.file.move.summary": "移动服务器文件或文件夹。",
+	"cli.cmd.server.file.move.desc": "移动服务器元数据文件或文件夹，也可同时更改名称。目标父目录必须已存在，且不能是源目录自身或其后代；目标填写包含名称的完整路径，不是用于接收源资源的目录。\n\n目标同名冲突时报错；目标与源路径相同时提示无需更改，不执行写入。文件夹操作会改变其中资源的路径；不会自动重写其他资源中的路径引用，执行后应核对相关页面和任务。\n\n直接修改服务器，不更新本地工作区。响应中断后，先查询源路径和目标路径确认结果。示例中的项目、路径和修订号须替换为实际资源。",
+	"cli.cmd.server.file.move.out": "JSON 返回 remotePath（操作后的完整路径）和 result。result.oldRemotePath 为原路径，result.pathMutation 为 renamed、moved 或 renamedAndMoved；result.metaInfo 为操作后的属性，result.modifyTime 为 Unix 毫秒修改时间。可用 remotePath 继续执行 server file info 核验；字段以服务器实际返回为准。",
+	"cli.cmd.server.file.move.expectedRevision": "仅当源资源修订号仍匹配时执行。与 --force 必须且只能选择一个；修订号从 server file info 获取，冲突后重新读取并比较。revision 只保护内容修订，不保证检测文件夹子项或属性变化。",
+	"cli.cmd.server.file.move.force": "跳过源资源的修订保护；与 --expected-revision 必须且只能选择一个。不覆盖目标同名资源，也不绕过权限检查。",
+	"cli.cmd.server.file.move.targetPath": "服务器元数据完整目标路径，包含名称；父目录必须已存在。",
+	"cli.cmd.server.file.rename.summary": "重命名服务器文件或文件夹。",
+	"cli.cmd.server.file.rename.desc": "修改服务器元数据文件或文件夹的名称，保持原父目录。新名称须为单个路径段；需要更改位置时使用 server file move。\n\n目标同名冲突时报错；目标与源路径相同时提示无需更改，不执行写入。文件夹操作会改变其中资源的路径；不会自动重写其他资源中的路径引用，执行后应核对相关页面和任务。\n\n直接修改服务器，不更新本地工作区。响应中断后，先查询源路径和目标路径确认结果。示例中的项目、路径和修订号须替换为实际资源。",
+	"cli.cmd.server.file.rename.out": "JSON 返回 remotePath（操作后的完整路径）和 result。result.oldRemotePath 为原路径，result.pathMutation 为 renamed；result.metaInfo 为操作后的属性，result.modifyTime 为 Unix 毫秒修改时间。可用 remotePath 继续执行 server file info 核验；字段以服务器实际返回为准。",
+	"cli.cmd.server.file.rename.expectedRevision": "仅当源资源修订号仍匹配时执行。与 --force 必须且只能选择一个；修订号从 server file info 获取，冲突后重新读取并比较。revision 只保护内容修订，不保证检测文件夹子项或属性变化。",
+	"cli.cmd.server.file.rename.force": "跳过源资源的修订保护；与 --expected-revision 必须且只能选择一个。不覆盖目标同名资源，也不绕过权限检查。",
+	"cli.cmd.server.file.rename.name": "新名称，包含文件扩展名；不得包含目录、斜杠或使用 .、..。",
+	"cli.cmd.server.file.remove.summary": "删除服务器文件或文件夹。",
+	"cli.cmd.server.file.remove.desc": "删除服务器上的已有元数据文件或文件夹。删除文件夹会同时删除其中的资源。\n\n仅校验被删除资源自身的内容修订。目录 revision 不代表子树快照，子资源变化不会使目录修订失效，也不会阻止整棵目录删除。\n\n操作直接删除服务器资源，可能影响引用它的页面和任务；跳过保护可能删除已被修改的文件。",
+	"cli.cmd.server.file.remove.out": "--json 返回 remotePath 和 result；result 包含服务器确认的变更信息，可能包含 metaInfo、modifyTime 和 warnings。metaInfo.revision 是服务器提供的新内容版本，纯属性修改不保证递增。未返回的字段不补造；文件元数据含义见 server file info --help。",
+	"cli.cmd.server.file.remove.expectedRevision": "仅当资源自身修订仍匹配时删除；目录修订不能保护其中子资源的变化。\n\n与 --force 必须且只能选择一个。使用 server file info 返回的最新 revision；冲突后重新读取并比较。",
+	"cli.cmd.server.file.remove.force": "不带修订保护删除当前服务器文件。\n\n跳过修订保护；与 --expected-revision 必须且只能选择一个。",
+	"cli.cmd.server.recyclebin.title": "服务器回收站",
+	"cli.cmd.server.recyclebin.summary": "搜索服务器回收站文件",
+	"cli.cmd.server.recyclebin.desc": "查询服务器项目回收站中的已删除文件。\n\n可核对原路径和删除时间；只提供查询，不恢复文件或永久清理。",
+	"cli.cmd.server.recyclebin.search.summary": "搜索服务器回收站文件。",
+	"cli.cmd.server.recyclebin.search.desc": "搜索项目回收站中当前用户可见的已删除文件。\n\n支持关键词、路径、类型和删除时间筛选。结果是回收站记录，不表示原路径当前仍有文件。\n\n只读取记录，不执行恢复或清理。",
+	"cli.cmd.server.recyclebin.search.out": "--json 返回 results[]；file.recyclebinId 是回收站记录标识，file.id 是原资源标识，file.remotePath 是删除前的服务器路径，file.deleteTime 为 Unix 毫秒时间戳。score、matchedOn 和 warnings 说明匹配与查询限制。summary.returned、summary.limit、summary.hasMore 分别表示返回数、上限和是否还有结果；不提供总数或 offset 分页。无匹配时 results 为 [] 并返回 empty。",
+	"cli.cmd.server.recyclebin.search.url": "可选的服务器 URL。第一个非 URL 参数按 <project> 处理。",
+	"cli.cmd.server.recyclebin.search.project": "要搜索回收站的项目名。",
+	"cli.cmd.server.recyclebin.search.query": "搜索关键词、完整元数据路径或路径 glob。",
+	"cli.cmd.server.recyclebin.search.type": "只搜索指定元数据类型。可重复使用或用逗号分隔。",
+	"cli.cmd.server.recyclebin.search.deletedAfter": "只返回在该时间之后删除的文件，包含边界。支持毫秒时间戳或 ISO-8601。",
+	"cli.cmd.server.recyclebin.search.deletedBefore": "只返回在该时间之前删除的文件，包含边界。支持毫秒时间戳或 ISO-8601。",
+	"cli.cmd.server.recyclebin.search.limit": "最多返回的文件数；省略时为 50。",
+	"cli.cmd.server.recyclebin.search.empty": "项目 {0} 的回收站中没有匹配文件。",
+	"cli.cmd.server.recyclebin.search.hasMore": "仅显示 {0} 个回收站文件；请增加类型、删除时间范围或更准确的关键词来缩小范围。",
 	"cli.cmd.server.settings.title": "服务器设置",
-	"cli.cmd.server.settings.summary": "获取和设置服务器设置",
-	"cli.cmd.server.settings.desc": "通过 Dev Tool v2 获取和设置系统、项目或应用级设置。",
+	"cli.cmd.server.settings.summary": "读取和修改服务器设置",
+	"cli.cmd.server.settings.desc": "读取和修改服务器的系统、项目或应用设置。\n\n支持按顶层键读取和修改配置，以及新增、替换和删除列表条目。\n\n写入直接在服务器生效，无需工作区推送，也不更新本地文件。",
+	"cli.cmd.server.settings.target": "system 表示系统设置；项目设置填写项目名（如 DEMO）；应用设置填写元数据绝对路径（如 /DEMO/app/demo.app），不是本地文件路径。仅 get 可省略目标以读取系统设置，set 必须明确目标。",
 	"cli.cmd.server.settings.target.system": "系统级",
+	"cli.cmd.server.settings.url": "目标服务器 URL；优先于 --server、工作区活跃服务器和 SUCCAPP_SERVER。",
+	"cli.cmd.server.settings.itemTarget": "系统列表别名：llms、sso、credentials、messagers、message-templates、encryption、masking。填写项目名或应用元数据绝对路径时，还需提供 --key。",
 	"cli.cmd.server.settings.get.summary": "获取服务器设置。",
-	"cli.cmd.server.settings.get.desc": "读取系统、项目或应用级设置。省略 <target> 或传 system 读取系统级设置。",
-	"cli.cmd.server.settings.get.key": "只返回指定的一级 key，可重复。",
+	"cli.cmd.server.settings.get.desc": "读取服务器的系统、项目或应用设置，帮助核对当前配置。\n\n可限定配置键。秘密字段可能已脱敏，读取结果不一定适合作为完整写入内容。\n\n只读取设置，不修改配置。",
+	"cli.cmd.server.settings.get.out": "--json 返回 settings 对象；即使只选择一个 --key，仍按完整顶层键名组织，不直接返回该键的值。缺失键不补造默认值。秘密字段可能已脱敏，返回值不能直接当作完整写入模板。",
+	"cli.cmd.server.settings.get.key": "完整顶层键名，可重复；点号属于键名，不表示嵌套路径。\n\n系统列表键：llm.services、sso.providers、service.credentials、messaging.services、messaging.templates、security.encryption.algorithms、security.masking.rules。查询这些列表时目标用 system，不用 llms 或 masking 等条目操作别名。",
 	"cli.cmd.server.settings.get.header": "{0} 的设置：",
-	"cli.cmd.server.settings.set.summary": "设置服务器设置。",
-	"cli.cmd.server.settings.set.desc": "把增量设置合并到系统、项目或应用级设置。至少提供 --set、--file、--stdin 或 --unset 之一。",
-	"cli.cmd.server.settings.set.set": "内联增量 JSON，可一次设置多个顶层 key。",
-	"cli.cmd.server.settings.set.file": "从本地文件读取增量 JSON。",
-	"cli.cmd.server.settings.set.stdin": "从标准输入读取增量 JSON。",
-	"cli.cmd.server.settings.set.unset": "删除指定的一级 key，可重复。",
-	"cli.cmd.server.settings.set.key": "只在指定的一级 key 下合并。",
-	"cli.cmd.server.settings.set.expectedRevision": "仅当服务器设置版本仍匹配时写入。",
+	"cli.cmd.server.settings.set.summary": "修改远程设置。",
+	"cli.cmd.server.settings.set.desc": "修改服务器设置中的顶层配置项。\n\n只修改提交的键；对象和数组整体替换，不递归合并，也支持删除配置键。\n\n写入直接在服务器生效，不更新本地文件。响应中断时，保存可能已经完成。",
+	"cli.cmd.server.settings.set.out": "--json 返回 keys（提交的顶层键）、success 和可选 warnings。success=false 时退出码非零；warnings 仍需检查。结果不返回完整设置，使用 get 核验当前值。",
+	"cli.cmd.server.settings.set.input": "--set、--file、--stdin 最多选择一种；可与 --unset 组合。\n\n默认输入为顶层配置项对象，使用完整键名，如 system.name，不要改成嵌套 JSON；指定 --key 时，输入对象作为该键的完整值。",
+	"cli.cmd.server.settings.set.set": "内联 JSON 对象，包含待修改键的完整值。",
+	"cli.cmd.server.settings.set.file": "读取本地文件中的 JSON 对象并提交到远端，不编辑或同步该文件。",
+	"cli.cmd.server.settings.set.stdin": "从标准输入读取设置 JSON。",
+	"cli.cmd.server.settings.set.unset": "删除指定的顶层配置键，可重复。\n\n可单独使用；输入值为 null 时也会删除对应键。",
+	"cli.cmd.server.settings.set.key": "把输入对象作为此键的完整值，而非一组配置项；不能与 --unset 同用。",
+	"cli.cmd.server.settings.set.expectedRevision": "可省略；省略时不检查调用方读取版本。只接受目标对应 settings.json 的内容修订号，不是任意文件版本。\n\n需要并发保护时，先用 server file info 获取设置文件的 revision=R，再用 server file show --revision=R --json 读取该版本内容；基于这份内容准备修改，并将同一 R 传回。系统文件为 /sysdata/settings/settings.json，项目文件为 /<项目>/settings/settings.json，应用文件为 <应用根路径>/settings/settings.json。\n\n此方式要求文件已存在且有读取权限。settings get 不返回配套修订；无法取得可信版本时可省略本选项，不猜测版本号。冲突后应重新读取并比较。",
 	"cli.cmd.server.settings.set.success": "已更新 {0} 的设置：{1}",
 	"cli.cmd.server.settings.set.noKeys": "（无 key）",
+	"cli.cmd.server.settings.add.summary": "新增设置条目。",
+	"cli.cmd.server.settings.add.input": "--item、--file、--stdin 必须且只能选择一种。输入为一个包含 id 的完整条目 JSON 对象，不要包裹在数组中。新条目需使用新的 id 及对应类型的必填字段。\n\n新建或更换扩展类型前先发现目标服务器的字段定义：\n    succapp server http-get /api/catalog/llm-connectors --json\n    succapp server http-get /api/catalog/sso-providers --json\n    succapp server http-get /api/resources/extension-points/serviceCredential.json --json\n    succapp server http-get /api/resources/extension-points/messager.json --json\n    succapp server http-get /api/resources/extension-points/encryptAlgorithm.json --json\nLLM、SSO 返回候选数组；其余响应分别从 serviceCredential[]、messager[]、encryptAlgorithm[] 读取贡献定义。HTTP JSON 输出的 content 可能是 JSON 文本，按 http-get 的输出说明解析后再使用。\n\nLLM 数组项的 name 用作 connectorId，extName 是扩展包名；confItems 的字段填写到条目顶层，supportedModels 按实际部署选择。SSO 使用 name 作为 type，并按 settingsForm 配置；script 方案按脚本 SSO 规则处理。\n\n服务凭证使用贡献的 name 作为 type，credentialType 只表示平台分类，不能代替 type；消息服务使用贡献的 name 作为 messager；加密算法使用贡献的 name 作为 algorithm。这三类按所选贡献的 confItems 在条目顶层填写参数，不复制设置界面的内部字段前缀。\n\n不要把已配置实例列表当作扩展类型表单。LLM 候选查询需要数据源查看权限，SSO 候选查询需要单点登录设置查看权限；读取定义不授予配置写入权限。缺少定义时先核对权限、扩展安装状态和服务器版本，再取得对应扩展资料，不猜字段。",
+	"cli.cmd.server.settings.add.item": "直接传入条目 JSON 对象。",
+	"cli.cmd.server.settings.add.file": "从本地文件读取条目 JSON 对象。",
+	"cli.cmd.server.settings.add.stdin": "从标准输入读取条目 JSON 对象。",
+	"cli.cmd.server.settings.add.key": "列表所在的完整顶层键名；<target> 不是系统列表别名时必填。",
+	"cli.cmd.server.settings.add.desc": "向服务器设置列表新增一条配置。\n\n新条目需要独立标识及对应类型的必填字段。\n\n操作直接修改服务器配置，不更新本地文件；响应中断时，条目可能已经新增。",
+	"cli.cmd.server.settings.add.out": "--json 返回 target、key（实际列表键）、action、id、success 和可选 warnings。success=false 时退出码非零；结果不回传完整条目，使用 get 核验实际内容。",
+	"cli.cmd.server.settings.add.success": "已向 {0} 新增条目 {1}。",
+	"cli.cmd.server.settings.add.failed": "未能向 {0} 新增条目 {1}。",
+	"cli.cmd.server.settings.update.summary": "修改设置条目。",
+	"cli.cmd.server.settings.update.input": "--item、--file、--stdin 必须且只能选择一种；输入是含原 id 的单个完整条目对象，不要包裹在数组中。普通字段省略后不保留。\n\n同 ID LLM 的 apiKey 省略、null 或 \"******\" 时保留原密钥；需要替换时提交新值，不能把省略当作清除。脚本 SSO 的顶层 params 独立存储：省略保留，显式 null 删除；不适用于其他 Provider。其他模块按对应类型和指南的保留规则处理，更新后读取普通字段并验证实际功能。\n\n新建或更换扩展类型前先发现目标服务器的字段定义：\n    succapp server http-get /api/catalog/llm-connectors --json\n    succapp server http-get /api/catalog/sso-providers --json\n    succapp server http-get /api/resources/extension-points/serviceCredential.json --json\n    succapp server http-get /api/resources/extension-points/messager.json --json\n    succapp server http-get /api/resources/extension-points/encryptAlgorithm.json --json\nLLM、SSO 返回候选数组；其余响应分别从 serviceCredential[]、messager[]、encryptAlgorithm[] 读取贡献定义。HTTP JSON 输出的 content 可能是 JSON 文本，按 http-get 的输出说明解析后再使用。\n\nLLM 数组项的 name 用作 connectorId，extName 是扩展包名；confItems 的字段填写到条目顶层，supportedModels 按实际部署选择。SSO 使用 name 作为 type，并按 settingsForm 配置；script 方案按脚本 SSO 规则处理。\n\n服务凭证使用贡献的 name 作为 type，credentialType 只表示平台分类，不能代替 type；消息服务使用贡献的 name 作为 messager；加密算法使用贡献的 name 作为 algorithm。这三类按所选贡献的 confItems 在条目顶层填写参数，不复制设置界面的内部字段前缀。\n\n不要把已配置实例列表当作扩展类型表单。LLM 候选查询需要数据源查看权限，SSO 候选查询需要单点登录设置查看权限；读取定义不授予配置写入权限。缺少定义时先核对权限、扩展安装状态和服务器版本，再取得对应扩展资料，不猜字段。",
+	"cli.cmd.server.settings.update.item": "直接传入条目 JSON 对象。",
+	"cli.cmd.server.settings.update.file": "从本地文件读取条目 JSON 对象。",
+	"cli.cmd.server.settings.update.stdin": "从标准输入读取条目 JSON 对象。",
+	"cli.cmd.server.settings.update.key": "列表所在的完整顶层键名；<target> 不是系统列表别名时必填。",
+	"cli.cmd.server.settings.update.desc": "替换服务器设置列表中的一条配置。\n\n普通字段采用完整条目替换，不递归合并；模块专属的密钥和独立参数保留规则仍生效。\n\n操作直接修改服务器配置，不更新本地文件；响应中断时，更新可能已经生效。",
+	"cli.cmd.server.settings.update.out": "--json 返回 target、key（实际列表键）、action、id、success 和可选 warnings。success=false 时退出码非零；结果不回传完整条目，使用 get 核验实际内容。",
+	"cli.cmd.server.settings.update.success": "已修改 {0} 中的条目 {1}。",
+	"cli.cmd.server.settings.update.failed": "未能修改 {0} 中的条目 {1}。",
+	"cli.cmd.server.settings.remove.summary": "删除设置条目。",
+	"cli.cmd.server.settings.remove.input": "--item、--file、--stdin 必须且只能选择一种。",
+	"cli.cmd.server.settings.remove.item": "条目 ID，或仅包含 id 的 JSON 对象，如 '{\"id\":\"service-1\"}'。",
+	"cli.cmd.server.settings.remove.file": "从本地文件读取条目 ID 或仅包含 id 的 JSON 对象。",
+	"cli.cmd.server.settings.remove.stdin": "从标准输入读取条目 ID 或仅包含 id 的 JSON 对象。",
+	"cli.cmd.server.settings.remove.key": "列表所在的完整顶层键名；<target> 不是系统列表别名时必填。",
+	"cli.cmd.server.settings.remove.desc": "删除服务器设置列表中的一条配置。\n\n仅删除指定条目，不删除整个顶层配置键。\n\n操作直接修改服务器配置，可能影响依赖此条目的功能；响应中断时，删除可能已经完成。",
+	"cli.cmd.server.settings.remove.out": "--json 返回 target、key（实际列表键）、action、id、success 和可选 warnings。success=false 时退出码非零；结果不回传完整条目，使用 get 核验实际内容。",
+	"cli.cmd.server.settings.remove.success": "已从 {0} 删除条目 {1}。",
+	"cli.cmd.server.settings.remove.failed": "未能从 {0} 删除条目 {1}。",
+	"cli.cmd.server.settings.*.module": "系统设置列表模块。",
+	"cli.cmd.server.settings.*.item": "内联完整条目 JSON；删除时也可传条目 ID。",
+	"cli.cmd.server.settings.*.file": "从本地文件读取条目 JSON 或 ID。",
+	"cli.cmd.server.settings.*.stdin": "从标准输入读取条目 JSON 或 ID。",
+	"cli.cmd.server.*.url": "目标服务器 URL；优先于 --server、工作区活跃服务器和 SUCCAPP_SERVER。",
+	"cli.cmd.server.httpGet.summary": "读取服务器 HTTP 资源。",
+	"cli.cmd.server.httpGet.desc": "读取服务器提供的 DTS、JSON、文本或其他动态资源。\n\n适用于通过已知地址获取原始资源，无需初始化工作区。请求复用已有登录信息，不自动跟随重定向。\n\n可将响应保存到本地文件；GET 请求的实际影响取决于目标接口。",
+	"cli.cmd.server.httpGet.out": "默认向 stdout 原样输出响应正文的字节，不补换行，可用 > 重定向到文件或通过管道处理。\n\n--json 或 --pretty-json 使用公共结果对象，正文放在 content 字符串中，encoding 为 utf8 或 base64。例如服务器返回 {\"name\":\"demo\"}，JSON 结果中的 content 为 \"{\\\"name\\\":\\\"demo\\\"}\"；根据 encoding 解码后即可还原正文。已知文本类型、不含 NUL 字节且能无损按 UTF-8 解码时使用 utf8，否则使用 base64。\n\nJSON 结果同时包含 resourcePath、url、status、contentType（服务器提供时）和 size（字节数）。\n\n指定 --output 时保存原始字节；默认 stdout 为空，保存提示写入 stderr。JSON 模式返回 output 文件绝对路径，不包含 content 和 encoding。",
+	"cli.cmd.server.httpGet.path": "服务器部署地址下的资源路径，可包含查询参数；不接受完整 URL。\n\n以 / 开头，相对于服务器部署地址。例如部署地址 https://example.com/bi 与 /api/resources/themes/system.json 组合为 /bi/api/resources/themes/system.json。含查询参数时用引号包围。",
+	"cli.cmd.server.httpGet.output": "保存到本地文件，相对路径以应用 -C 后的执行目录为基准。\n\n保存原始字节；已有文件需 --force 覆盖。",
+	"cli.cmd.server.httpGet.force": "允许覆盖 --output 指定的已有本地输出文件。",
+	"cli.cmd.server.httpGet.saved": "已保存到 {0}",
+	"cli.cmd.expFunc.name": "完整函数名，不区分大小写。\n\n无匹配函数时返回错误。",
+	"cli.cmd.expFunc.contains": "不区分大小写的字面包含，匹配函数名称或简介。",
+	"cli.cmd.expFunc.extension": "限定生效来源的扩展名，不返回被同名函数覆盖的声明。",
+	"cli.cmd.expFunc.group": "精确目录分组，不表示聚合类型。",
+	"cli.cmd.resource.label": "标签 ID 或标签表达式，区分大小写。& 表示同时具备，| 表示任一分支，! 表示排除；& 优先于 |，不支持括号。无标签资源不匹配，包括仅有排除条件时。\n使用 shell 引号保护表达式，例如 --label='input|chart' 或 --label='input&!chart'。可重复传入，各 --label 条件取交集，并与 --keyword、--contains 及其他筛选条件取交集；分页命令先筛选再分页。省略时不限定标签，无匹配时不自动放宽。",
+	"cli.cmd.resource.keyword": "按名称、描述、标签 ID、标题和近义词搜索。\n资源名称和描述匹配完整输入；标签 ID、标题和近义词按空格或中英文逗号拆词，多个词须同时命中。所有筛选条件取交集；使用关键词时按匹配度排序，同分保持原有顺序，省略时保留返回顺序。",
+	"cli.cmd.resource.contains": "不区分大小写的字面包含，匹配资源文本及标签 ID、标题。\n与标签、关键词及其他筛选条件取交集。",
+	"cli.out.theme.token": "变量名",
+	"cli.out.theme.source": "主题：{0}　来源：{1}",
+	"cli.out.theme.title": "标题",
+	"cli.out.uiResource.unrestricted": "未限定",
+	"cli.out.uiResource.id": "标识",
+	"cli.out.uiResource.styleType": "风格种类",
+	"cli.out.uiResource.source": "来源",
+	"cli.out.uiResource.components": "组件类型",
+	"cli.out.uiResource.theme": "主题",
+	"cli.out.uiResource.module": "页面模块",
+	"cli.out.uiResource.name": "名称",
+	"cli.out.uiResource.description": "说明",
+	"cli.out.uiResource.location": "位置",
+	"cli.out.component.empty": "没有匹配此页面类型的组件模板。",
+	"cli.out.component.name": "名称",
+	"cli.out.component.labels": "分组标签",
+	"cli.out.component.description": "说明",
+	"cli.out.component.group.component": "页面组件",
+	"cli.out.component.group.cellType": "单元格类型",
+	"cli.out.component.group.actionComponent": "程序流节点",
+	"cli.out.style.notApplicable": "该类型存在，但不适用于此页面类型。可用 dev component list <target> 查询候选类型。",
+	"cli.out.style.unsupported": "此类型没有可选风格；程序流节点不使用视觉风格。",
+	"cli.out.style.noMatches": "没有符合组件类型、页面和主题条件的风格，不代表该类型不存在。",
+	"cli.out.style.emptyCollection": "没有可用风格。",
+	"cli.out.template.empty": "当前位置没有匹配的文件模板。",
+	"cli.out.displayFormat.empty": "没有可用的显示格式。",
+	"cli.out.displayFormat.pattern": "格式串",
+	"cli.out.displayFormat.system": "系统",
+	"cli.out.displayFormat.project": "项目",
+	"cli.out.displayFormat.app": "应用",
+	"cli.out.displayFormat.page": "页面",
+	"cli.out.media.empty": "当前查询没有可选择的条目。",
+	"cli.out.media.more": "仍有结果；使用 --offset={0} 继续，或 --limit=0 返回全部。",
+	"cli.out.font.name": "字体名称",
+	"cli.out.font.value": "字体值",
+	"cli.out.font.source": "来源",
+	"cli.out.font.preset": "系统预置",
+	"cli.out.font.auto": "自动（跟随主题）",
+	"cli.out.font.extension": "扩展：{0}",
+	"cli.out.resource.labels": "标签",
+	"cli.out.expFunc.registered": "注册状态",
+	"cli.out.expFunc.registered.yes": "已注册",
+	"cli.out.expFunc.registered.no": "仅文档",
+	"cli.cmd.server.file.folderExists": "文件夹已存在：{0}",
 	"cli.cmd.workspace.title": "工作区",
 	"cli.cmd.workspace.summary": "使用本地 SuccApp 工作区",
-	"cli.cmd.workspace.desc": "使用本地 SuccApp 工作区。",
+	"cli.cmd.workspace.desc": "管理本地 SuccApp 工作区及其与服务器之间的元数据同步。\n\n提供工作区初始化、远端连接、本地项目管理、同步状态、拉取、推送和丢弃改动，以及修复、升级、锁和备份工具。\n\n文件检查、编译和元数据升级使用 dev file，扩展开发使用 dev extension。",
 	"cli.cmd.workspace.init.summary": "初始化 SuccApp 工作区。",
-	"cli.cmd.workspace.init.desc": "初始化 .succapp/config.json、推荐的工作区辅助文件和可选的 SuccApp 官方离线文档 skill。",
-	"cli.cmd.workspace.init.server": "使用该活跃服务器初始化工作区。",
-	"cli.cmd.workspace.init.scope": "限制初始化范围。可选值：base、dev、agent-docs、all。",
+	"cli.cmd.workspace.init.desc": "准备 SuccApp 本地开发工作区。\n\n包括工作区配置、开发辅助文件、类型声明、JSON Schema 和官方离线文档 Skill。在已有工作区内运行会更新该工作区，否则在执行目录创建。\n\n目标目录必须已经存在；服务器资料下载需要网络与认证。初始化会写入本地辅助文件，并保留已有工作区配置。",
+	"cli.cmd.workspace.init.out": "使用 --json 时，结合退出码检查结果：supportFiles.updatedCount 表示更新的辅助文件项数，supportFiles.skipped 列出跳过项及原因，supportFiles.agentDocs.status 表示离线资料状态。跳过或资料不可用不表示相关内容已准备完成，应按原因补齐后再使用。\n\n类型声明保存在 .agents/skills/succapp-docs/dev-types/，JSON Schema 保存在 .agents/skills/succapp-docs/json-schemas/。",
+	"cli.cmd.workspace.init.server": "指定初始化服务器并获取其类型声明和 JSON Schema；首次初始化可登记该地址，已有活跃服务器时须与其一致。",
+	"cli.cmd.workspace.init.scope": "仅初始化指定内容；默认 all。base：工作区配置、编辑器设置、忽略规则和 Agent 文件；dev：类型声明与 JSON Schema；agent-docs：官方离线文档 Skill。",
 	"cli.cmd.workspace.init.force": "即使索引未变化，也强制 SuccApp 官方离线文档 skill 检查本地文件。",
 	"cli.cmd.workspace.init.active": "活跃服务器：{0}",
 	"cli.cmd.workspace.init.agentDocsSummary": "SuccApp 官方文档 skill：共 {0} 个文件，新增 {1}，更新 {2}，删除 {3}，未变 {4}。",
@@ -770,25 +1047,31 @@
 	"cli.cmd.workspace.init.supportFiles": "工作区辅助文件：已更新 {0} 项，已跳过 {1} 项。",
 	"cli.cmd.workspace.init.workspaceInit": "工作区已初始化：{0}",
 	"cli.cmd.workspace.status.summary": "显示工作区同步状态。",
-	"cli.cmd.workspace.status.desc": "显示工作区同步状态。",
+	"cli.cmd.workspace.status.desc": "查看本地工作区与活跃服务器之间的同步状态。\n\n可了解本地修改、远端变化和冲突，也可仅检查本地。\n\n远端检查需要有效认证和网络连接；检查不完整时，结果不能作为完整的推送前检查。",
+	"cli.cmd.workspace.status.out": "先检查退出码、remoteCheck 和 warnings，再判断 changes。remoteCheck=complete 才表示本次远端检查完成，skipped 表示主动跳过；failed/cancelled 表示检查不完整，返回非零退出码。失败时可能保留上次远端变化，空结果也不能证明远端没有变化。\n\nchanges[].type 表示变化方向：added/modified/deleted/renamed 是待同步的本地变化；remoteAdded/remoteModified/remoteDeleted/remoteRenamed 是服务器变化；conflict 需要核对双边内容；remoteProjectUnavailable 表示当前身份无法确认项目可见性，不代表项目已删除。变化通过本地工作区、同步基线和本次已取得的远端状态判定，不按文件时间猜方向。\n\nlocalPath 是本地绝对路径，remotePath 是远端元数据路径；重命名时查看 oldLocalPath/oldRemotePath。contentChanged 与 metaChanged 分别标记正文与元信息变化，可缺省，不能把缺失值当作 false。示例节选：\n    {\"changes\":[{\"type\":\"modified\",\"localPath\":\"/work/DEMO/page.dash\",\"remotePath\":\"/DEMO/page.dash\",\"contentChanged\":true},{\"type\":\"remoteModified\",\"localPath\":\"/work/DEMO/other.dash\",\"remotePath\":\"/DEMO/other.dash\"}]}\n根据类型检查差异、选择 pull/push 或处理冲突；状态本身不是覆盖或删除授权。",
 	"cli.cmd.workspace.status.forceRefresh": "重新检查服务器变化，不使用本地缓存的状态。",
 	"cli.cmd.workspace.status.localOnly": "只显示本地工作区变化，不检查服务器。",
 	"cli.cmd.workspace.status.remoteAuthRequired": "当前未登录，已只显示本地变化。请先执行 'succapp auth login'，再重试查看服务器变化。",
+	"cli.cmd.workspace.status.incomplete": "远端检查未完成（{0}）；远端变化可能是上次结果，请检查 warnings 并重新核验。",
 	"cli.cmd.workspace.upgrade.summary": "规划工作区结构迁移。",
-	"cli.cmd.workspace.upgrade.desc": "规划 SuccApp 工作区结构迁移。当前实现没有迁移项。",
+	"cli.cmd.workspace.upgrade.desc": "规划 SuccApp 工作区结构迁移。\n\n本命令针对工作区组织结构；元数据文件版本升级由 dev file upgrade 提供。\n\n当前没有可执行的迁移，运行不会修改工作区。",
 	"cli.cmd.workspace.upgrade.targetVersion": "规划到目标工作区结构版本的迁移。",
 	"cli.cmd.workspace.upgrade.dryRun": "预览迁移计划，不修改文件。",
 	"cli.cmd.workspace.upgrade.actions": "工作区升级：{0} 个动作。当前={1}，目标={2}。",
 	"cli.cmd.workspace.upgrade.noActions": "工作区升级：无动作。当前={0}，目标={1}。",
 	"cli.cmd.workspace.pull.summary": "将服务器变化拉取到工作区。",
-	"cli.cmd.workspace.pull.desc": "把活跃服务器上的变化应用到当前工作区。",
+	"cli.cmd.workspace.pull.desc": "把活跃服务器上的元数据变化同步到本地工作区。\n\n需要先绑定活跃服务器。支持限定文件或目录范围，并在本地与服务器均有变化时尝试合并。\n\n拉取会修改本地文件，合并时可能产生冲突。",
+	"cli.cmd.workspace.pull.out": "结果即使是 kind=result，存在 conflicts 时仍退出 6；先核对 updated、deleted、conflicts 和 summary.oldFiles，再用 backup list 查看保存的本地版本。旧格式文件仅返回总数；升级预演建议按所属项目汇总，需要更小范围的明细时，可自行指定目录或文件执行 dev file upgrade --dry-run。\n\nconflicts[].outcome=conflictMarkersWritten 表示已向本地文件写入文本冲突标记；localPreserved 表示原地保留本地内容。outcome 缺失时不能推断任何一种状态，应结合差异和诊断核对。updated 是实际写入文件清单，可能与 conflicts 重叠，不代表这些文件已解决冲突。\n\n先处理冲突标记或比较保留的本地内容，再重新检查状态、校验并决定下一步。remoteProjectUnavailable 不能当作项目删除处理；部分结果和退出码都需检查。",
 	"cli.cmd.workspace.pull.force": "允许服务器变化覆盖本地修改。",
 	"cli.cmd.workspace.pull.conflicts": "冲突：{0}",
-	"cli.cmd.workspace.pull.oldMeta": "旧版元数据文件：{0}",
 	"cli.cmd.workspace.pull.pullResultUpdated": "Pull 结果：更新 {0}，删除 {1}，冲突 {2}",
 	"cli.cmd.workspace.pull.upDate": "已是最新，无需拉取",
+	"cli.cmd.workspace.pull.conflictMarkersWritten": "冲突尚未解决，已写入冲突标记：{0}",
+	"cli.cmd.workspace.pull.localPreserved": "冲突未应用，本地内容保持不变：{0}",
+	"cli.cmd.workspace.pull.path": "限定要拉取的工作区文件或目录，例如 PROJECT/data/tables/example.tbl；省略时处理全部对应变化。相对路径以执行目录（应用 -C 后）为基准，也可使用工作区内的磁盘绝对路径。",
 	"cli.cmd.workspace.push.summary": "将工作区变化提交到服务器。",
-	"cli.cmd.workspace.push.desc": "把本地工作区变化提交到活跃服务器。",
+	"cli.cmd.workspace.push.desc": "把本地工作区的元数据变化提交到活跃服务器。\n\n支持限定路径范围，并检查与远端变化的冲突。\n\n推送会写入服务器元数据。失败或断连后，部分操作可能已经完成。",
+	"cli.cmd.workspace.push.out": "JSON 中 pushed[] 是已提交项，rejected[] 是因冲突拒绝的项，failures[] 是其他失败项，metadataVersionSuggestions[] 是文件版本建议。结果可能包含部分成功：有拒绝项退出 6，否则有失败项退出 1；kind=result 不代表全部成功。完成后重新查看 status。",
 	"cli.cmd.workspace.push.force": "允许本地变化覆盖远端变化。",
 	"cli.cmd.workspace.push.failed": "失败文件：{0}",
 	"cli.cmd.workspace.push.kind": "类别",
@@ -799,16 +1082,19 @@
 	"cli.cmd.workspace.push.pushResultPushed": "推送结果：已推送 {0}，被拒绝 {1}，失败 {2}",
 	"cli.cmd.workspace.push.targetVersion": "目标版本",
 	"cli.cmd.workspace.push.version": "当前版本",
+	"cli.cmd.workspace.push.path": "工作区本地路径；相对路径以执行目录（应用 -C 后）为基准，也可使用工作区内的磁盘绝对路径。省略时处理全部对应变化。",
 	"cli.cmd.workspace.discard.summary": "放弃工作区本地变化。",
-	"cli.cmd.workspace.discard.desc": "用本地 mirror 基线恢复工作区文件，并放弃本地变化。",
+	"cli.cmd.workspace.discard.desc": "用本地同步基线恢复工作区文件，放弃本地变化。\n\n同步基线是本机已保存的版本，可能不是服务器最新内容。\n\n操作会覆盖或移除所选范围的本地修改，需要保留的内容应事先另行保存。",
+	"cli.cmd.workspace.discard.out": "JSON 的 updated[] 列出从基线恢复的文件，deleted[] 列出为撤销本地新增而删除的文件；summary.updated/summary.deleted 是对应条目数。各项的 localPath 为本地绝对路径，remotePath 为服务器资源路径。",
 	"cli.cmd.workspace.discard.force": "不指定路径时，确认放弃整个工作区的本地变化。",
 	"cli.cmd.workspace.discard.deletedFiles": "已删除文件：{0}",
 	"cli.cmd.workspace.discard.noLocalChanges": "没有本地变更需要放弃",
 	"cli.cmd.workspace.discard.restoredFiles": "已恢复文件：{0}",
 	"cli.cmd.workspace.discard.result": "放弃结果：已恢复 {0}，已删除 {1}",
 	"cli.cmd.workspace.repair.summary": "检查或修复工作区一致性问题。",
-	"cli.cmd.workspace.repair.desc": "检查或修复可自动处理的工作区结构和同步状态问题。",
-	"cli.cmd.workspace.repair.only": "只运行指定的工作区修复检查项。",
+	"cli.cmd.workspace.repair.desc": "检查并修复可自动处理的工作区结构和同步状态问题。\n\n支持仅检查问题或选择部分检查项，不替代业务文件的冲突处理。\n\n实际修复可能更新本地辅助文件和同步状态。",
+	"cli.cmd.workspace.repair.out": "JSON 的 issues[] 按问题码分组，remotePaths/localPaths 定位受影响资源；summary.byCode 提供问题说明和计数。--dry-run 发现问题即退出 1，不表示已经修复。实际修复后查看 repaired[]、unresolved[] 和 skipped[]；仍有未解决问题退出 1，跳过项应按 reason 判断是否需要后续处理。",
+	"cli.cmd.workspace.repair.only": "只运行指定检查项，可重复传入。workspace-support 选择编辑器设置、忽略规则、Agent 文件、类型声明和 JSON Schema；sync-baseline 检查同步基线。",
 	"cli.cmd.workspace.repair.dryRun": "预演可修复的工作区问题，不修改文件。",
 	"cli.cmd.workspace.repair.badCheck": "工作区修复检查项无效：{0}",
 	"cli.cmd.workspace.repair.checkColumn": "检查项",
@@ -820,150 +1106,101 @@
 	"cli.cmd.workspace.repair.repairable": "可修复",
 	"cli.cmd.workspace.repair.repaired": "工作区修复：已修复 {0} 个，未解决 {1} 个。",
 	"cli.cmd.workspace.repair.repairedIssues": "已修复问题：",
+	"cli.cmd.workspace.repair.byCode": "按问题码汇总：",
+	"cli.cmd.workspace.repair.issues": "问题明细：",
 	"cli.cmd.workspace.repair.strategy": "策略",
 	"cli.cmd.workspace.repair.unresolved": "未解决问题：",
 	"cli.cmd.workspace.proj.title": "工作区项目",
 	"cli.cmd.workspace.proj.summary": "管理工作区项目",
-	"cli.cmd.workspace.proj.desc": "管理工作区项目。",
+	"cli.cmd.workspace.proj.desc": "管理本地工作区项目，支持查看、克隆和移除。\n\n克隆会下载活跃服务器项目；移除只影响本地项目文件及其同步基线。",
 	"cli.cmd.workspace.proj.list.summary": "列出本地工作区项目。",
-	"cli.cmd.workspace.proj.list.desc": "列出本地工作区项目。",
+	"cli.cmd.workspace.proj.list.desc": "列出本地工作区项目。\n\n包含工作目录和本地同步基线中发现的项目，便于识别缺失的一侧；不表示服务器上的完整项目清单。",
+	"cli.cmd.workspace.proj.list.out": "JSON 的 projects[] 包含 name、workspace 和 baseline。workspace/baseline 是布尔值，分别表示工作目录与本地同步基线中是否存在该项目；单侧缺失不等于服务器项目已删除。",
 	"cli.cmd.workspace.proj.list.empty": "当前工作区没有跟踪项目。",
 	"cli.cmd.workspace.proj.clone.summary": "克隆服务器项目到工作区。",
-	"cli.cmd.workspace.proj.clone.desc": "从活跃服务器克隆项目到当前工作区。",
-	"cli.cmd.workspace.proj.clone.force": "允许 clone 覆盖已有本地工作区项目。",
+	"cli.cmd.workspace.proj.clone.desc": "从活跃服务器克隆项目到本地工作区。\n\n支持单个、多个或全部可见项目。\n\n需要访问目标服务器；已有活跃服务器时，克隆目标必须与其一致。克隆会写入项目文件和同步基线，覆盖已有目录可能丢失本地修改。",
+	"cli.cmd.workspace.proj.clone.out": "完成后检查输出中的旧版元数据提示。JSON 在 summary.oldFiles 中返回旧格式文件总数，并提供按需升级建议；需要明细时用 dev file upgrade --dry-run 查询。",
+	"cli.cmd.workspace.proj.clone.force": "允许 clone 覆盖已有本地项目路径，包括未完成克隆的残留文件。\n\n只有同步缓存而尚无本地项目路径时，可直接重试，无需覆盖确认。",
 	"cli.cmd.workspace.proj.clone.configuredActive": "已配置活跃服务器：{0}",
 	"cli.cmd.workspace.proj.clone.cloned": "已克隆项目：{0}",
-	"cli.cmd.workspace.proj.clone.oldMetaNotice": "注意：{count} 个元数据文件使用较旧格式。\n可选：执行 '{command}' 可将它们升级为新版格式。\n这可能会更新很多文件；如需确认影响范围，可先加 `--dry-run` 预演。\n如果只是查看项目，可以先跳过这一步。",
+	"cli.cmd.workspace.proj.clone.project": "要从服务器克隆的项目名称，来自 server project list；省略时克隆全部可见项目。\n\n尚无活跃服务器时，可用 --server 登记首次克隆目标；已有活跃服务器时必须与其一致。",
 	"cli.cmd.workspace.proj.remove.summary": "移除工作区项目。",
-	"cli.cmd.workspace.proj.remove.desc": "移除本地工作区项目和 mirror 基线，不删除服务器项目。",
-	"cli.cmd.workspace.proj.remove.force": "确认删除本地项目文件和 mirror 基线。",
+	"cli.cmd.workspace.proj.remove.desc": "移除本地工作区项目及其同步基线。\n\n未推送的本地修改也会被删除，不影响服务器项目。",
+	"cli.cmd.workspace.proj.remove.out": "JSON 的 projectNames[] 是已移除的本地项目名称字符串数组，不表示服务器项目已删除。",
+	"cli.cmd.workspace.proj.remove.force": "确认删除本地项目文件和本地同步基线。\n\n必填；本地未推送的修改也会删除。",
 	"cli.cmd.workspace.proj.remove.removed": "已移除工作区项目：{0}",
+	"cli.cmd.workspace.proj.remove.project": "要移除的本地项目名称，来自 workspace project list；可指定多个。",
 	"cli.cmd.workspace.remote.title": "工作区远程服务器",
 	"cli.cmd.workspace.remote.summary": "管理工作区远程服务器",
-	"cli.cmd.workspace.remote.desc": "管理工作区远程服务器。",
+	"cli.cmd.workspace.remote.desc": "管理工作区远程服务器配置。\n\n支持查看、添加、切换、修改地址和移除。配置决定后续同步的目标，认证信息独立管理。\n\n操作会修改本地工作区配置，不修改服务器内容。",
 	"cli.cmd.workspace.remote.list.summary": "列出已配置服务器。",
-	"cli.cmd.workspace.remote.list.desc": "列出当前工作区已配置的服务器。",
+	"cli.cmd.workspace.remote.list.desc": "列出当前工作区配置的服务器，帮助确认同步目标。\n\n列表来自本地配置，不验证服务器是否在线或认证是否有效。",
+	"cli.cmd.workspace.remote.list.out": "JSON 的 servers[] 包含 url 和布尔值 active，activeServer 是当前活跃服务器 URL，无活跃服务器时省略。servers 为空时返回 empty.reason=emptyCollection；这些字段仅反映本地配置。",
 	"cli.cmd.workspace.remote.add.summary": "添加服务器并设为活跃服务器。",
-	"cli.cmd.workspace.remote.add.desc": "将服务器添加到当前 SuccApp 工作区，并设为活跃服务器。",
+	"cli.cmd.workspace.remote.add.desc": "将服务器添加到当前工作区，并设为活跃服务器。\n\n操作会修改本地配置及后续同步目标，不会克隆项目或建立登录认证。",
+	"cli.cmd.workspace.remote.add.out": "JSON 的 activeServer 是操作后的活跃服务器 URL；added 是布尔值，false 表示该地址原已配置，本次仍将其设为活跃服务器。",
 	"cli.cmd.workspace.remote.add.active": "活跃服务器：{0}",
 	"cli.cmd.workspace.remote.use.summary": "切换活跃服务器。",
-	"cli.cmd.workspace.remote.use.desc": "切换当前工作区的活跃服务器。",
+	"cli.cmd.workspace.remote.use.desc": "切换当前工作区的活跃服务器。\n\n目标必须是已配置服务器。\n\n切换会改变后续同步目标，不会自动把工作目录替换成新服务器内容。",
+	"cli.cmd.workspace.remote.use.out": "JSON 的 activeServer 是切换后的活跃服务器 URL，只确认工作区配置已切换，不表示服务器连接或认证已通过。",
 	"cli.cmd.workspace.remote.use.active": "活跃服务器：{0}",
 	"cli.cmd.workspace.remote.setUrl.summary": "修改已配置服务器地址。",
-	"cli.cmd.workspace.remote.setUrl.desc": "修改已配置服务器地址并迁移本地 mirror key。",
+	"cli.cmd.workspace.remote.setUrl.desc": "更新工作区中同一服务器的访问地址。\n\n适用于服务器地址变更，已有项目的同步记录会随地址更新。\n\n操作会修改本地配置和同步记录，不迁移服务器上的项目。",
+	"cli.cmd.workspace.remote.setUrl.out": "JSON 的 oldServer 是原地址，server 是更新后的地址；activeServer 是操作后的活跃地址，无活跃服务器时省略。修改非活跃服务器的地址不会使其自动成为活跃服务器。",
 	"cli.cmd.workspace.remote.setUrl.changed": "服务器地址已变更：{0} -> {1}",
 	"cli.cmd.workspace.remote.remove.summary": "移除已配置服务器。",
-	"cli.cmd.workspace.remote.remove.desc": "从当前工作区配置中移除服务器。",
+	"cli.cmd.workspace.remote.remove.desc": "从当前工作区配置中移除服务器。\n\n只修改本地服务器配置，不删除远程服务器、项目或本地认证记录。",
+	"cli.cmd.workspace.remote.remove.out": "JSON 的 server 是移除的地址，removedActive 是布尔值，表示它是否为原活跃服务器。activeServer 是操作后的活跃地址，无活跃服务器时省略。",
 	"cli.cmd.workspace.remote.remove.active": "已移除服务器：{0}\n活跃服务器：{1}",
 	"cli.cmd.workspace.remote.remove.removed": "已移除服务器：{0}",
-	"cli.cmd.workspace.file.title": "工作区文件",
-	"cli.cmd.workspace.file.summary": "查看工作区文件",
-	"cli.cmd.workspace.file.desc": "查看工作区文件。",
-	"cli.cmd.workspace.file.resolve.summary": "解析工作区文件路径。",
-	"cli.cmd.workspace.file.resolve.desc": "解析工作区文件的本地路径、远程路径和浏览器 URL。",
-	"cli.cmd.workspace.file.resolve.url": "human 模式仅打印查看或编辑 URL。",
-	"cli.cmd.workspace.file.resolve.badUrl": "--url 的值无效：{0}",
-	"cli.cmd.workspace.file.resolve.editUrl": "编辑 URL：{0}",
-	"cli.cmd.workspace.file.resolve.localPath": "本地路径：{0}",
-	"cli.cmd.workspace.file.resolve.path": "路径：{0}",
-	"cli.cmd.workspace.file.resolve.remote": "远程路径：{0}",
-	"cli.cmd.workspace.file.resolve.viewUrl": "查看 URL：{0}",
-	"cli.cmd.workspace.file.open.summary": "打开服务器文件页面。",
-	"cli.cmd.workspace.file.open.desc": "打开当前工作区文件的服务器查看或编辑页面，也可以只返回页面 URL 而不打开浏览器。",
-	"cli.cmd.workspace.file.open.edit": "打开服务器编辑页面，而不是默认的查看页面。",
-	"cli.cmd.workspace.file.open.noOpen": "只返回页面 URL，不启动系统浏览器。",
-	"cli.cmd.workspace.file.open.path": "工作区相对文件路径或服务器元数据绝对路径。",
-	"cli.cmd.workspace.file.open.force": "即使本地文件有未推送变化，也打开服务器页面。",
-	"cli.cmd.workspace.file.open.localChangedForce": "本地文件有未推送变化。浏览器将打开 {0} 的服务器版本。",
-	"cli.cmd.workspace.file.open.openedEdit": "已打开服务器编辑页面：{0}",
-	"cli.cmd.workspace.file.open.openedView": "已打开服务器查看页面：{0}",
-	"cli.cmd.workspace.file.show.summary": "显示文件内容。",
-	"cli.cmd.workspace.file.show.desc": "显示文件内容。",
-	"cli.cmd.workspace.file.show.source": "从 mirror 或服务器读取。",
-	"cli.cmd.workspace.file.show.revision": "读取服务器历史版本。",
-	"cli.cmd.workspace.file.show.badRev": "--revision 的值无效：{0}",
-	"cli.cmd.workspace.file.show.badSource": "--source 的值无效：{0}",
-	"cli.cmd.workspace.file.show.revSource": "--revision 只支持和 --source=server 一起使用。",
-	"cli.cmd.workspace.file.diff.summary": "显示工作区文件与服务器内容的差异。",
-	"cli.cmd.workspace.file.diff.desc": "对比本地工作区元数据文件和服务器内容。可以传入文件、目录（递归目录下所有文件）或 glob。",
-	"cli.cmd.workspace.file.diff.source": "与服务器内容比较。",
-	"cli.cmd.workspace.file.diff.badSource": "--source 的值无效：{0}",
-	"cli.cmd.workspace.file.history.summary": "显示服务器文件历史。",
-	"cli.cmd.workspace.file.history.desc": "显示当前工作区文件的服务器端历史。",
-	"cli.cmd.workspace.file.history.limit": "限制历史记录返回条数。",
-	"cli.cmd.workspace.file.compile.summary": "校验工作区元数据文件。",
-	"cli.cmd.workspace.file.compile.desc": "校验本地工作区元数据文件。可以传入文件、目录（递归目录下所有文件）或 glob。",
-	"cli.cmd.workspace.file.compile.compiler": "编译器",
-	"cli.cmd.workspace.file.compile.done": "已完成 {0} 个工作区元数据文件的编译校验。",
-	"cli.cmd.workspace.file.compile.failed": "失败文件：{0}",
-	"cli.cmd.workspace.file.compile.newerVersion": "{0} 个文件的版本高于当前服务器，已跳过。请连接匹配版本的服务器后重新校验。",
-	"cli.cmd.workspace.file.compile.result": "元数据校验结果：共 {0} 个文件，通过 {1}，失败 {2}",
-	"cli.cmd.workspace.file.compile.running": "正在编译校验工作区元数据文件",
-	"cli.cmd.workspace.file.compile.schemaFailed": "元数据校验失败。",
-	"cli.cmd.workspace.file.compile.schemaFailedMsg": "元数据校验失败：{0}",
-	"cli.cmd.workspace.file.compile.skipped": "跳过文件：{0}",
-	"cli.cmd.workspace.file.compile.upgradeRequired": "{0} 个文件需要先升级。请使用相同的 pathspec 执行 `{1}`，升级完成后重新校验。",
-	"cli.cmd.workspace.file.upgrade.summary": "升级旧版 SuccApp 元数据文件。",
-	"cli.cmd.workspace.file.upgrade.desc": "预演或升级本地工作区旧版 SuccApp 元数据文件。可以传入文件、目录（递归目录下所有文件）或 glob；不传时处理所有本地项目。",
-	"cli.cmd.workspace.file.upgrade.dryRun": "预演升级候选文件，不修改文件。",
-	"cli.cmd.workspace.file.upgrade.cands": "升级候选文件：{0}",
-	"cli.cmd.workspace.file.upgrade.dryRunRes": "元数据升级 dry-run：已检查 {0}，候选 {1}，跳过 {2}，失败 {3}",
-	"cli.cmd.workspace.file.upgrade.failed": "失败文件：{0}",
-	"cli.cmd.workspace.file.upgrade.reason": "原因",
-	"cli.cmd.workspace.file.upgrade.result": "元数据升级结果：已检查 {0}，已更新 {1}，跳过 {2}，失败 {3}",
-	"cli.cmd.workspace.file.upgrade.skipped": "跳过文件：{0}",
-	"cli.cmd.workspace.file.upgrade.upgraded": "已升级文件：{0}",
+	"cli.cmd.workspace.remote.*.url": "已配置或待添加的服务器 URL，例如 https://bi.example.com。",
+	"cli.cmd.workspace.remote.*.oldUrl": "已配置的旧服务器 URL。",
+	"cli.cmd.workspace.remote.*.newUrl": "同一服务器的新访问 URL。",
 	"cli.cmd.workspace.lock.title": "工作区锁",
 	"cli.cmd.workspace.lock.summary": "查看工作区锁",
-	"cli.cmd.workspace.lock.desc": "查看工作区锁。",
+	"cli.cmd.workspace.lock.desc": "查看工作区锁，帮助诊断并发操作。\n\n支持范围列表、持有者详情及等待空闲；不强制删除锁或终止持锁进程。",
 	"cli.cmd.workspace.lock.badScope": "workspace 锁范围无效：{0}",
 	"cli.cmd.workspace.lock.list.summary": "列出当前被锁定的工作区范围。",
-	"cli.cmd.workspace.lock.list.desc": "列出当前 SuccApp 工作区中已被锁定的范围。",
+	"cli.cmd.workspace.lock.list.desc": "列出当前工作区中已被锁定的范围。\n\n状态可能随其他进程变化，当前列表不保证后续操作能立即取得锁。",
+	"cli.cmd.workspace.lock.list.out": "JSON 的 scopes[] 只列占用范围，不含持锁者详情。空列表表示当前未读到有效持锁记录；有占用范围本身仍退出 0。",
 	"cli.cmd.workspace.lock.list.scope": "范围",
 	"cli.cmd.workspace.lock.list.empty": "当前没有被占用的工作区锁。",
 	"cli.cmd.workspace.lock.status.summary": "显示工作区锁持有者。",
-	"cli.cmd.workspace.lock.status.desc": "工作区锁状态",
+	"cli.cmd.workspace.lock.status.desc": "查看工作区锁范围及其持有者，帮助定位并发操作。\n\n锁状态可能随其他进程变化，当前查询不保证后续操作能立即取得锁。",
+	"cli.cmd.workspace.lock.status.out": "JSON 的 scopes[] 中，status=free 表示空闲，status=busy 表示被占用；busy 项的 holder 包含进程 PID、主机名、来源、命令和心跳时间。查询到 busy 本身仍退出 0，不代表已取得锁。",
 	"cli.cmd.workspace.lock.status.heartbeat": "最近心跳",
 	"cli.cmd.workspace.lock.status.pid": "PID",
 	"cli.cmd.workspace.lock.status.scope": "范围",
+	"cli.cmd.workspace.lock.status.scopeArg": "一个或多个工作区锁范围，如 config、sync；省略时查看全部。",
 	"cli.cmd.workspace.lock.wait.summary": "等待工作区锁空闲。",
-	"cli.cmd.workspace.lock.wait.desc": "等待指定工作区锁范围空闲。",
-	"cli.cmd.workspace.lock.wait.timeout": "达到指定秒数后停止等待。",
+	"cli.cmd.workspace.lock.wait.desc": "等待工作区锁范围空闲，供后续操作衔接使用。\n\n支持持续等待或设置等待时限。\n\n成功只表示检查时空闲，不会持有锁；超时以非零退出码结束。",
+	"cli.cmd.workspace.lock.wait.out": "超时退出码为 124。",
+	"cli.cmd.workspace.lock.wait.timeout": "达到指定秒数后停止等待。\n\n单位秒；省略时持续等待。",
 	"cli.cmd.workspace.lock.wait.badTimeout": "--timeout 的值无效：{0}",
 	"cli.cmd.workspace.lock.wait.locksBusy": "等待 {0} 秒后工作区锁仍被占用：{1}",
 	"cli.cmd.workspace.lock.wait.locksFree": "工作区锁已空闲：{0}",
+	"cli.cmd.workspace.lock.wait.scope": "一个或多个工作区锁范围，如 config、sync；省略时等待 config 和 sync。",
+	"cli.cmd.workspace.lock.*.scope": "工作区锁范围，如 config、sync；默认范围见正文。",
 	"cli.cmd.workspace.backup.title": "工作区备份",
 	"cli.cmd.workspace.backup.summary": "查看和清理工作区备份",
-	"cli.cmd.workspace.backup.desc": "查看和清理工作区备份。",
+	"cli.cmd.workspace.backup.desc": "查看和清理工作区合并备份。\n\n备份是拉取冲突处理前保存的本地版本，不覆盖工作区所有文件，也不替代 Git 历史。",
 	"cli.cmd.workspace.backup.backupPath": "备份路径",
 	"cli.cmd.workspace.backup.cleared": "合并备份清理：已清理 {0}，剩余 {1}。",
 	"cli.cmd.workspace.backup.list.summary": "列出已保存的合并备份。",
-	"cli.cmd.workspace.backup.list.desc": "列出拉取冲突处理前保存的本地版本。",
+	"cli.cmd.workspace.backup.list.desc": "列出拉取冲突处理前保存的本地版本，帮助查找可恢复的内容。\n\n列表不自动还原文件；这些备份不覆盖工作区的所有文件。",
+	"cli.cmd.workspace.backup.list.out": "JSON 的 entries[] 中，localPath/remotePath 指向原资源，backupPath 是保存的本地副本绝对路径；size 为字节数。summary.entries 是本次返回的备份条目数。",
 	"cli.cmd.workspace.backup.list.empty": "未找到合并备份。",
 	"cli.cmd.workspace.backup.clear.summary": "清理已保存的合并备份。",
-	"cli.cmd.workspace.backup.clear.desc": "清理由拉取冲突处理前保存的本地版本。",
-	"cli.cmd.workspace.ext.title": "工作区扩展",
-	"cli.cmd.workspace.ext.summary": "创建和发布工作区扩展",
-	"cli.cmd.workspace.ext.desc": "创建和发布工作区扩展。",
-	"cli.cmd.workspace.ext.dirNamedSame": "sysdata/extensions/ 下已存在同名目录。",
-	"cli.cmd.workspace.ext.extNameMust": "扩展名必须符合模式 {0}。",
-	"cli.cmd.workspace.ext.extNameRequired": "必须填写扩展名。",
-	"cli.cmd.workspace.ext.invalidExtName": "扩展名无效。",
-	"cli.cmd.workspace.ext.middleSegmentMust": "中间段必须等于 \"{0}\"（当前：\"{1}\"）。",
-	"cli.cmd.workspace.ext.list.summary": "列出本地扩展。",
-	"cli.cmd.workspace.ext.list.desc": "列出工作区 sysdata 项目下的本地扩展。",
-	"cli.cmd.workspace.ext.create.summary": "创建本地扩展。",
-	"cli.cmd.workspace.ext.create.desc": "从服务器模板创建本地扩展目录。",
-	"cli.cmd.workspace.ext.create.extTemplate": "找不到扩展模板：{0}/{1}",
-	"cli.cmd.workspace.ext.push.summary": "推送本地扩展。",
-	"cli.cmd.workspace.ext.push.desc": "将本地扩展目录推送到活跃服务器。",
-	"cli.cmd.workspace.ext.push.path": "根据 sysdata/extensions 下的本地路径解析扩展。",
-	"cli.cmd.workspace.ext.push.force": "允许本地扩展文件覆盖远端变化。",
-	"cli.cmd.workspace.ext.push.needNamePath": "请传入扩展名或 --path=<path>。",
-	"cli.cmd.workspace.ext.push.onlyOne": "<name> 和 --path=<path> 只能使用一个。",
+	"cli.cmd.workspace.backup.clear.desc": "清理拉取冲突处理前保存的本地版本。\n\n操作会删除所选范围的备份，不修改当前工作文件或远程文件。需要恢复的内容应在清理前另行保存。",
+	"cli.cmd.workspace.backup.clear.out": "JSON 的 cleared[] 是本次删除的备份，remaining[] 是清理后保留的全部备份，summary.cleared/summary.remaining 是对应条目数。各项的 backupPath 为本地备份绝对路径，localPath/remotePath 定位原资源；cleared 为空可表示没有匹配的备份。",
+	"cli.cmd.workspace.backup.clear.path": "工作区本地路径；相对路径以执行目录（应用 -C 后）为基准，也可使用工作区内的磁盘绝对路径。省略时清理全部合并备份，无需 --force。",
+	"cli.cmd.workspace.backup.*.path": "工作区本地路径；相对路径以执行目录（应用 -C 后）为基准，也可使用工作区内的磁盘绝对路径。",
+	"cli.cmd.workspace.*.path": "工作区本地路径；相对路径以执行目录（应用 -C 后）为基准，也可使用工作区内的磁盘绝对路径。",
+	"cli.json.syntax": "非法的 JSON",
+	"cli.compile.utf8": "文件包含无效的 UTF-8 字节。请按原始编码正确解码并保存为 UTF-8，然后重新编译；不要直接替换或删除乱码。",
 	"cli.out.search.score": "相关度",
 	"cli.out.common.active": "活跃",
-	"cli.out.common.api": "Dev Tool 接口",
+	"cli.out.common.api": "SuccApp API 版本",
 	"cli.out.common.baseline": "基线",
 	"cli.out.common.changes": "没有变更。",
 	"cli.out.common.changesLocalRemote": "变更：{0}（本地 {1}，远端 {2}，冲突 {3}）",
@@ -981,6 +1218,8 @@
 	"cli.out.common.targetVersion": "目标版本",
 	"cli.out.common.version": "当前版本",
 	"cli.out.common.workspace": "工作区",
+	"cli.out.common.localOnlyChanges": "本地变更：{0}（未检查远端）",
+	"cli.out.common.noLocalChanges": "没有本地变更。",
 	"cli.out.db.exists": "输出文件已存在：{0}。使用 --force 覆盖。",
 	"cli.out.file.createTime": "创建时间",
 	"cli.out.file.creator": "创建者",
@@ -1004,6 +1243,7 @@
 	"cli.out.file.size": "大小",
 	"cli.out.file.subFileType": "子文件类型",
 	"cli.out.file.type": "类型",
+	"cli.out.file.sizeBytes": "大小（字节）",
 	"cli.out.model.businessKeys": "业务键",
 	"cli.out.model.dataType": "数据类型",
 	"cli.out.model.dbField": "物理字段",
@@ -1081,10 +1321,21 @@
 	"cli.out.header.upgrade": "支持升级",
 	"cli.out.header.value": "值",
 	"cli.out.header.version": "版本",
-	"cli.out.help.commandHelpRead": "运行 'succapp {0} <command> --help' 查看具体命令帮助。",
+	"cli.out.header.localPath": "本地路径",
+	"cli.out.header.modifiedTime": "修改时间",
+	"cli.out.help.commandHelpRead": "运行 'succapp {0} <command> --help' 查看下一级帮助。",
 	"cli.out.help.commandHelpSee": "运行 'succapp <command> --help' 查看命令帮助。",
-	"cli.out.help.commands": "命令",
+	"cli.out.help.commands": "命令：",
 	"cli.out.help.arguments": "参数：",
+	"cli.out.help.paramRequired": "[必填]",
+	"cli.out.help.paramDefault": "默认值：{0}",
+	"cli.out.help.paramRange": "范围：{0}–{1}",
+	"cli.out.help.paramMin": "最小值：{0}",
+	"cli.out.help.paramMax": "最大值：{0}",
+	"cli.out.help.paramChoices": "可选值：{0}",
+	"cli.out.help.paramSep": "；",
+	"cli.out.help.relatedCommands": "相关命令：",
+	"cli.out.help.relatedNote": "以下为相关用法，尖括号中的占位符需替换为实际值。",
 	"cli.out.help.examples": "示例：",
 	"cli.out.help.group.content": "正文选项：",
 	"cli.out.help.group.field": "字段选项：",
@@ -1095,7 +1346,14 @@
 	"cli.out.help.group.query": "查询选项：",
 	"cli.out.help.group.search": "搜索选项：",
 	"cli.out.help.usageHeader": "用法：",
-	"cli.out.help.usageLine": "用法： succapp {command} {usageArgs}",
+	"cli.out.help.usageLine": "用法：succapp {command} {usageArgs}",
+	"cli.out.help.commandGroups": "命令分组：",
+	"cli.out.help.rootUsage": "succapp [全局选项] <command> [<args>]",
+	"cli.out.help.output": "输出说明：",
+	"cli.out.help.references": "参考资料：",
+	"cli.out.help.refNote": "使用以下命令读取资料。服务器资料请使用与业务操作相同的目标服务器。",
+	"cli.out.help.refLocal": "本地：{0}",
+	"cli.out.help.globalNote": "全局选项的完整说明见 succapp --help。",
 	"cli.out.human.error": "错误：{0}",
 	"cli.out.human.hint": "提示：{0}",
 	"cli.out.human.info": "信息：{0}",
@@ -1124,6 +1382,7 @@
 	"cli.out.value.unknown": "未知",
 	"cli.out.value.updated": "已更新",
 	"cli.out.value.yes": "是",
+	"cli.out.value.upToDate": "无需更新",
 	"cli.out.workspace.ext.createdExt": "已创建扩展 {0}：{1}",
 	"cli.out.workspace.ext.ext": "{0} 下没有扩展。",
 	"cli.out.workspace.ext.extPoint": "扩展点",
@@ -1140,6 +1399,185 @@
 	"cli.out.workspace.ext.version": "当前版本",
 	"cli.out.workspace.file.hist.empty": "暂无服务器历史记录",
 	"cli.out.workspace.file.history.badLimit": "--limit 的值无效：{0}",
+	"cli.out.suggest.correction": "输入纠错：{0}",
+	"cli.out.suggest.prerequisite": "前置条件：{0}",
+	"cli.out.suggest.diagnostic": "诊断建议：{0}",
+	"cli.out.suggest.cwd": "工作目录：{0}",
+	"cli.out.check.summary": "检查结果：共 {0} 个文件，通过 {1}，失败 {2}，跳过 {3}",
+	"cli.out.check.summaryWithExecutionFailures": "检查结果：共 {0} 个文件，通过 {1}，源码错误 {2}，跳过 {3}，执行故障 {4}",
+	"cli.out.check.fixedCount": "已修复 {0} 个问题",
+	"cli.out.check.written": "已写入文件",
+	"cli.out.check.nothingToFix": "没有需要修复的问题",
+	"cli.out.check.fixFailed": "修复失败：{0}",
+	"cli.out.check.remotePath": "元数据路径：{0}",
+	"cli.out.check.passed": "通过",
+	"cli.out.check.failed": "失败",
+	"cli.out.check.skipped": "跳过：未执行检查。",
+	"cli.out.check.executionFailed": "执行失败：未能完成检查。",
+	"cli.out.check.compilerFile": "编译器文件标识：{0}",
+	"cli.out.check.unknownFailure": "失败：未确定失败性质，请根据原始原因确认。",
+	"cli.out.check.jsonDetails": "更多诊断细节：使用 --json 查看。",
+	"cli.out.check.context": "源码上下文",
+	"cli.out.check.code": "编译器诊断编号",
+	"cli.out.check.severity": "级别",
+	"cli.out.check.type": "类型",
+	"cli.out.check.location": "位置",
+	"cli.out.check.related": "关联诊断：",
+	"cli.out.check.suppressed": "附属异常：",
+	"cli.out.check.errorCode": "错误码",
+	"cli.out.check.propertyLocation": "组件或属性",
+	"cli.out.check.endPosition": "结束位置（行:列，从 1 起）",
+	"cli.out.check.start": "字符偏移（UTF-16，从 0 起）",
+	"cli.out.check.length": "字符长度（UTF-16）",
+	"cli.out.check.expression": "表达式",
+	"cli.out.check.token": "错误词法单元",
+	"cli.out.check.tokenOffset": "表达式内字符偏移（从 0 起）",
+	"cli.out.check.tokenIndex": "词法单元标识",
+	"cli.out.check.tokenType": "词法单元类型",
+	"cli.out.check.errorType": "表达式错误类型",
+	"cli.out.check.locationValue": "定位值",
+	"cli.out.check.contextPosition": "原始上下文位置（非文件坐标，计数基准未声明）",
+	"cli.out.check.mergeReferenceResources": "将以下条目合并到文件根 referenceResources，保留其他条目；组件 type 和 layoutType 保持不变：",
+	"cli.out.check.referenceCandidates": "可核对的已登记数据引用代号；填写代号，不直接填写资源路径：",
+	"cli.out.check.noReferenceCandidates": "当前没有已登记的数据引用；先登记实际数据资源，再填写其引用代号。",
+	"cli.out.check.datasetCandidates": "当前作用域已定义的数据集，请核对引用的 ID：",
+	"cli.out.check.noDatasetCandidates": "当前作用域没有已定义的数据集；先定义数据集，再引用其 ID。",
+	"cli.out.check.propertyCandidates": "当前配置支持的相近属性名，请确认后修改：",
+	"cli.out.check.propertyDisabled": "该属性在当前配置中未启用；不需要时移除，或调整其启用条件。",
+	"cli.out.check.enableCondition": "启用条件：",
+	"cli.out.check.enableDependencies": "启用条件依赖：",
+	"cli.out.check.nativePosition": "原始补充位置（计数基准未声明）",
+	"cli.out.check.nativeIndex": "原生索引（编译器原值）",
+	"cli.out.sync.oldMetaNotice": "发现 {0} 个旧格式元数据文件，本次未自动升级。",
+	"cli.out.mutation.created": "已创建",
+	"cli.out.mutation.modified": "已修改",
+	"cli.out.mutation.deleted": "已删除",
+	"cli.out.mutation.renamed": "已重命名",
+	"cli.out.mutation.moved": "已移动",
+	"cli.out.mutation.renamedAndMoved": "已重命名并移动",
+	"cli.out.mutation.metadataUpdated": "已更新元信息",
+	"cli.out.mutation.accepted": "已处理",
+	"cli.out.conflictMarkers": "已写入冲突标记",
+	"cli.suggest.command.candidate": "查看这个候选命令的用法。",
+	"cli.suggest.command.help": "查看命令用法并修正输入。",
+	"cli.suggest.auth.login": "在浏览器中登录目标服务器，也可选择下方的 PAT 方式。",
+	"cli.suggest.auth.pat": "使用 PAT 登录目标服务器：在终端按提示输入令牌；脚本通过标准输入提供。",
+	"cli.suggest.workspace.init": "将目标文件夹初始化为 SuccApp 工作区。",
+	"cli.suggest.workspace.status": "查看同步状态，包括删除、移动和元数据变化；此操作不会消除冲突。",
+	"cli.suggest.workspace.repair": "预览工作区修复，不应用修改。",
+	"cli.suggest.workspace.dev": "初始化工作区开发辅助文件。",
+	"cli.suggest.remote.list": "查看当前工作区已配置的服务器。",
+	"cli.suggest.remote.add": "添加此服务器并将其设为工作区活跃服务器。",
+	"cli.suggest.remote.use": "查看如何切换工作区活跃服务器。",
+	"cli.suggest.lock.status": "查看锁持有者，并等待正在运行的进程结束。",
+	"cli.suggest.project.sysdata": "将 sysdata 项目克隆到本地工作区。",
+	"cli.suggest.project.localList": "查看本地工作区的项目。",
+	"cli.suggest.project.cloneHelp": "查看如何将所属项目准备到本地工作区及其下载范围。",
+	"cli.suggest.project.list": "查看当前登录可见的远端项目。",
+	"cli.suggest.extension.templates": "查看可用的扩展点和模板名称。",
+	"cli.suggest.db.connectors": "查看可用的数据库连接器。",
+	"cli.suggest.server.info": "查看目标服务器信息。",
+	"cli.suggest.server.startupLogs": "请查看目标服务器的启动日志，根据日志排查并修复原因后重启服务器；无权查看日志时，请联系服务器管理员。",
+	"cli.suggest.thread.show": "查看当前线程和取消序号。",
+	"cli.suggest.thread.list": "获取当前线程快照。",
+	"cli.suggest.cluster.list": "查看当前集群快照。",
+	"cli.suggest.logger.list": "查看当前 logger 名称和日志级别。",
+	"cli.suggest.metadata.upgradePreview": "后续需要修改旧格式文件时，请先升级相关文件；也可按需整体升级项目。以下命令仅预演升级范围，不修改文件。",
+	"cli.suggest.metadata.dts": "请按错误原因和位置查阅 DTS，修正后重新编译。",
+	"cli.err.workspacePathOutOfScope": "请提供当前工作区内的本地元数据路径；相对路径以执行目录为基准。文件位于其他工作区时，用 -C 指向该工作区或其子目录。不要将服务器元数据路径当作本地磁盘路径。",
+	"cli.ref.recoverChanges": "恢复丢失的修改",
+	"cli.ref.compileMetadata": "编译与验证元数据",
+	"cli.ref.cloneProjects": "连接服务器与克隆项目",
+	"cli.ref.metadataChecks": "元数据静态检查",
+	"cli.ref.syncChanges": "修改、对比、拉取与推送",
+	"cli.ref.initWorkspace": "初始化工作区",
+	"cli.ref.displayFormats": "显示格式管理",
+	"cli.ref.portalGuide": "实现应用页面",
+	"cli.ref.portalTypes": "门户页面类型",
+	"cli.ref.actionNodes": "程序流节点类型",
+	"cli.ref.cellTypes": "单元格类型",
+	"cli.ref.components": "页面组件类型",
+	"cli.ref.systemSettingTypes": "系统设置类型",
+	"cli.ref.systemSettings": "系统设置",
+	"cli.ref.dynamicSettingFields": "动态设置类型与字段",
+	"cli.ref.settingsSecrets": "秘密值与更新保留规则",
+	"cli.ref.businessLogic": "实现业务逻辑",
+	"cli.ref.backendApi": "后端 API 索引",
+	"cli.ref.metadataApi": "后端元数据 API",
+	"cli.ref.rptTypes": "报表元数据类型",
+	"cli.ref.dashTypes": "仪表板元数据类型",
+	"cli.ref.spgTypes": "SuperPage 元数据类型",
+	"cli.ref.backendScripts": "后端脚本与 API",
+	"cli.ref.extensions": "扩展开发",
+	"cli.ref.metadataTypes": "元数据文件类型索引",
+	"cli.ref.fileOptions": "文件附加属性类型",
+	"cli.ref.fileInfo": "文件属性类型",
+	"cli.ref.typeReferences": "获取类型与配置参考",
+	"cli.ref.findResources": "查找元数据资源",
+	"cli.ref.diagnostics": "系统运行排障",
+	"cli.ref.styleValues": "风格属性值类型",
+	"cli.ref.componentStyle": "组件风格类型",
+	"cli.ref.appearance": "主题、风格与页面外观",
+	"cli.ref.themeTypes": "主题类型与变量",
+	"cli.ref.queryTypes": "模型查询类型",
+	"cli.ref.dataSourceConfig": "数据源连接配置类型",
+	"cli.ref.modelAnalysis": "探查模型数据",
+	"cli.ref.dataTransfer": "导入和导出数据",
+	"cli.ref.databaseChanges": "执行数据库变更",
+	"cli.ref.databaseAnalysis": "探查数据库数据",
+	"cli.ref.connectData": "连接数据",
+	"cli.ref.taskIndex": "使用 AI Agent",
+	"cli.ref.cliGuide": "CLI 使用指南",
+	"cli.ref.authentication": "认证配置",
+	"cli.ref.projectSettingTypes": "项目设置类型",
+	"cli.ref.appSettingTypes": "应用设置类型",
+	"cli.ref.resourceReferences": "页面资源引用",
+	"cli.ref.imageFill": "图片填充类型",
+	"cli.ref.iconValue": "图标值类型",
+	"cli.ref.mediaGuide": "页面资源选用指南",
+	"cli.ref.modelTypes": "模型元数据类型",
+	"cli.ref.pageTemplates": "页面模板与资源选用指南",
+	"cli.ref.techLogs": "技术日志排查指南",
+	"cli.ref.componentCommands": "组件命令声明",
+	"cli.ref.componentCommandArgs": "命令参数声明",
+	"cli.ref.executeComponentCommand": "执行命令动作的元数据",
+	"cli.ref.componentEvents": "组件事件声明",
+	"cli.ref.componentEventMetadata": "组件交互事件的元数据",
+	"cli.ref.componentCapabilities": "组件能力和子组件定义",
+	"cli.ref.commonRunEnv": "运行环境",
+	"cli.ref.layoutMetadata": "布局元数据",
+	"cli.ref.layoutCapabilities": "布局能力和属性定义",
+	"cli.out.resContext.group": "推荐分组",
+	"cli.out.resContext.recommended": "推荐",
+	"cli.out.resContext.additional": "更多",
+	"cli.out.resContext.persist": "保存时按 {0} 的持久化类型构造属性值；推荐标签不限制其他素材。",
+	"cli.ref.imageValue": "图片属性保存类型",
+	"cli.out.dts.metadata": "元数据赋值",
+	"cli.out.dts.declaration": "查询声明",
+	"cli.out.dts.owner": "所属父组件元数据",
+	"cli.out.dts.member": "查找字段：{0}",
+	"cli.out.dts.note": "本次查询只检查本地资料；下列阅读命令已绑定目标服务器，资料缺失时会准备到 Home。声明类型不能直接作为元数据赋值结构，局部部件需沿父组件目录查找。",
+	"cli.ref.themeMetadata": "主题元数据",
+	"cli.ref.displayFormatValue": "显示格式引用值",
+	"cli.ref.fontFamilyValue": "字体引用值",
+	"cli.out.dts.component": "组件元数据",
+	"cli.ref.directoryMetadata": "目录资源元信息",
+	"cli.ref.knowledgeBaseTypes": "知识库配置类型",
+	"cli.ref.fillValue": "填充属性存储值",
+	"cli.ref.imageSliceFill": "图片切片填充存储值",
+	"cli.out.scope.system": "当前仅查询系统默认资源，未考虑具体项目或应用的自定义资源及覆盖。",
+	"cli.out.scope.systemWithTheme": "当前仅查询系统默认资源及指定系统主题的素材，未考虑具体项目或应用的自定义资源及覆盖。",
+	"cli.out.scope.systemThemeOnly": "当前仅查询指定系统主题的素材，未考虑具体项目或应用的自定义资源及覆盖。",
+	"cli.out.scope.specify": "要查询具体位置的有效资源，请指定目标路径：",
+	"cli.out.scope.global": "当前为设计器全局字体目录，未解析具体页面的最终字体，也未检查运行环境的字体安装情况。",
+	"cli.out.scope.next": "替换 <target> 后，查询同一服务器具体位置的资源；保留当前筛选。",
+	"cli.out.scope.path": "替换为该命令支持的实际服务器位置；不是本地路径。",
+	"cli.out.scope.pageFontNotResolved": "自动选项表示跟随主题，不能据此确认页面实际字体。",
+	"cli.out.scope.fontInstallationNotChecked": "不检查浏览器、操作系统及导出环境是否安装字体。",
+	"cli.out.scope.targetOverridesNotApplied": "未考虑具体项目或应用的自定义资源及覆盖。",
+	"cli.out.scope.target": "当前按指定服务器位置查询；资源来源、覆盖与适用范围以本命令规则及逐条信息为准。",
+	"cli.out.scope.targetFilenameNotApplied": "未按目标文件名匹配脚本内容模板。",
+	"cli.out.scope.themeMediaNotRequested": "未指定主题，本次不包含主题素材。",
 	"cli.err.context.exampleCommandServer": "succapp --server=<url> {commandName}",
 	"cli.err.context.exampleCommandUrl": "succapp {commandName} <url>",
 	"cli.err.context.exampleEnvUrl": "{envName}=<url> succapp {commandName}",
@@ -1291,6 +1729,7 @@
 	"vs.cmd.sync.push.serverHasNewer": "服务器上有更新的变化。请回到 Changes 视图或命令面板拉取或对比后再推送。",
 	"vs.cmd.sync.push.showLogs": "查看日志",
 	"vs.cmd.sync.push.successPushedFile": "成功推送 {0} 个文件",
+	"vs.cmd.sync.push.upgradeRequired": "推送前需要升级 {0} 个旧版元数据文件，是否升级？取消将停止本次推送。",
 	"vs.cmd.sync.removeProject.confirm": "移除本地项目？",
 	"vs.cmd.sync.removeProject.empty": "没有可移除的本地项目",
 	"vs.cmd.sync.removeProject.localProjectS": "已移除 {0} 个本地项目",
@@ -1438,71 +1877,857 @@
 	"vs.ui.workspaceProblem.showLogs": "查看日志",
 	"vs.ui.workspaceProblem.staleBaseline": "SuccApp 检测到本地同步基线过旧。修改工作区前请查看日志详情。",
 	"vs.ui.workspaceProblem.syncProblem": "SuccApp 检测到工作区同步问题。详见日志。",
+	"cli.cmd.dev.dataflow.title": "数据加工",
+	"cli.cmd.dev.dataflow.summary": "调试模型加工的节点输出。",
+	"cli.cmd.dev.dataflow.desc": "编译模型加工正文，查看开发过程中某个节点的数据和 SQL。",
+	"cli.cmd.dev.dataflow.preview.summary": "编译后预览加工节点的数据和 SQL。",
+	"cli.cmd.dev.dataflow.preview.desc": "预览 .tbl 数据加工中某个节点的数据和 SQL，帮助定位加工结果从哪一步开始不符合预期。\n\n预览前先检查加工正文。引用的模型、附属脚本和连接配置使用服务器版本，应先同步这些依赖。当前不支持内嵌加工和 FetchData 模型。\n\n预览不保存模型定义，也不更新同步基线，但会执行节点所需的上游处理，可能运行脚本、非查询 SQL 或创建中间表。运行中的数据预览可用 Ctrl+C 或 SIGTERM 请求取消。",
+	"cli.cmd.dev.dataflow.preview.source": "选择服务器模型路径或本地文件，二者必须且只能提供一个；示例中的模型路径和节点 ID 请替换为实际值。",
+	"cli.cmd.dev.dataflow.preview.model": "服务器 .tbl 模型的元数据绝对路径，例如 /DEMO/data/tables/sales.tbl。读取服务器当前保存的正文，需要模型查看权限；在工作区外执行时，可用全局 --server 指定连接。",
+	"cli.cmd.dev.dataflow.preview.file": "工作区内单个 .tbl 文件的本地路径。相对路径以应用 -C 后的执行目录为准，也可用绝对路径。提交当前正文作临时预览，无需推送；需要目标路径的模型查看权限及引用资源的访问权限。",
+	"cli.cmd.dev.dataflow.preview.node": "dataFlow 数组中节点的 id，区分大小写；从模型正文查找，不是显示名称。",
+	"cli.cmd.dev.dataflow.preview.step": "Select 节点 steps 数组的零基下标，预览到该步骤（包含）；-1 表示执行步骤之前。省略时预览节点最终输出，其他类型不接受此选项。",
+	"cli.cmd.dev.dataflow.preview.paramsSource": "运行参数 JSON 对象，键为模型参数 ID，值为对应 JSON 值；三种来源最多选择一个，省略时使用模型默认值。例如 {\"开始日期\":\"2026-01-01\",\"数量\":10}。\n\n运行参数同时用于节点数据与静态 SQL 预演。连接较旧服务器时，仍需核对实际记录是否符合传入参数，不能仅凭请求成功或生成 SQL 判断参数已生效。",
+	"cli.cmd.dev.dataflow.preview.params": "内联运行参数 JSON 对象。",
+	"cli.cmd.dev.dataflow.preview.paramsFile": "从 UTF-8 JSON 文件读取运行参数对象。",
+	"cli.cmd.dev.dataflow.preview.stdin": "从标准输入读取运行参数 JSON 对象。",
+	"cli.cmd.dev.dataflow.preview.maxRows": "最多返回的数据行数；不代表模型总行数，也不限制上游计算代价。",
+	"cli.cmd.dev.dataflow.preview.offset": "跳过的结果行数；数据变化或无稳定排序时，不保证跨次分页一致。",
+	"cli.cmd.dev.dataflow.preview.dryRun": "只检查加工正文并生成可静态确定的 SQL，不执行数据查询、上游脚本或创建中间表；无法静态生成时返回原因，不模拟数据结果。",
+	"cli.cmd.dev.dataflow.preview.out": "文本按节点信息、数据表格和 SQL 展示；--json 返回一份最终结果，任务日志和进度单独输出。\n\n成功结果中，model 是服务器模型路径，localPath 仅本地输入时存在；node 和可选 step 标识预览位置，dryRun 表示是否仅预演。执行数据预览时返回 taskId，可用于关联后端任务。\n\nresult 与 model select/query、db query 使用相同结构：fields 为字段对象数组，当前提供 name；rows 为按字段名取值的对象数组。rowCount 是本次返回行数，maxRows 是返回上限，truncated=true 表示还有数据，elapsedMs 为可选的耗时（毫秒）。空结果保留 fields 并返回空 rows；dry-run 省略 result。\n\nsqlInfos 是 SQL 信息对象数组，保留 sql 正文及可用的 datasource、schema。SQL 不可得时返回空数组，并由 sqlUnavailable.reason 说明原因：requiresExecution（依赖运行）、requiresIntermediateTable（需落地）、requiresDynamicSplit（动态拆分）或 noSql（无查询 SQL）。SQL 不可得不表示编译失败，也不影响已返回的数据。\n\n编译失败与 dev file compile 使用相同的诊断结构：kind=result，包含 validationComplete、summary 和 items[]；失败项的 error.properties.diagnostics 提供源码诊断，退出码非零。网络、权限和执行错误返回 kind=error。",
+	"cli.cmd.dev.dataflow.preview.heading": "节点：{0}",
+	"cli.cmd.dev.dataflow.preview.notExecuted": "执行方式：仅预演，未查询数据",
+	"cli.out.dataflow.sql.runtime": "此流程依赖运行时结果，无法静态生成 SQL。",
+	"cli.out.dataflow.sql.materialized": "此流程需要创建中间表，无法静态生成 SQL。",
+	"cli.out.dataflow.sql.dynamicSplit": "此流程包含需要运行时数据的拆分步骤，无法静态生成 SQL。",
+	"cli.out.dataflow.sql.none": "此节点没有可展示的查询 SQL。",
+	"cli.ref.dataflowMetadata": "加工节点和步骤格式",
+	"cli.ref.dataflowVerification": "验证加工结果",
+	"cli.cmd.dev.dataflow.preview.stepRequiresSelect": "节点 {0} 不是 Select 节点，不能指定 --step。",
+	"cli.cmd.dev.dataflow.preview.nodeNotFound": "加工中不存在节点 {0}，请使用模型正文中的节点 id。",
+	"cli.cmd.dev.dataflow.preview.stepOutOfRange": "节点 {0} 的 --step 必须在 -1 到 {1} 之间。",
+	"cli.out.dataflow.datasource": "数据源：{0}",
+	"cli.out.dataflow.schema": "Schema：{0}",
+	"cli.out.dataflow.rows": "数据 · {0} 行",
+	"cli.out.dataflow.rowsTruncated": "数据 · 前 {0} 行，仍有更多数据",
+	"cli.cmd.dev.title": "开发",
+	"cli.cmd.dev.summary": "查询资源并使用低代码开发工具。",
+	"cli.cmd.dev.desc": "查询低代码开发资源，并检查文件、开发扩展和执行后端脚本。\n\n支持页面组件与布局、外观资源和表达式函数的查询，以及工作区文件检查、元数据升级、扩展开发和后端脚本操作。\n\n资源查询使用目标服务器；工作区相关命令使用本地上下文，具体前置条件以各命令帮助为准。部分操作会写入本地文件、上传扩展或执行服务器脚本。",
+	"cli.cmd.dev.component.list.componentType": "仅列出指定组件、单元格或节点类型，保留其完整属性及模板。",
+	"cli.cmd.dev.component.list.summary": "列出页面可用的组件模板。",
+	"cli.cmd.dev.component.list.target": "以 rpt、dash、spg、fapp 或 afl 结尾的服务器页面路径；页面不必已存在。",
+	"cli.cmd.dev.component.list.desc": "列出指定页面类型可用的组件，帮助选择页面元素和创建模板。\n\n报表和表单应用同时包含页面组件和单元格类型；独立程序流包含可在服务端运行的节点。支持按类型、标签和关键词筛选。\n\n页面不必已经创建。类型能否放入具体容器还取决于页面配置，参考声明索引不能替代此处的可用性结果。",
+	"cli.cmd.dev.component.list.out": "普通列表在组件下列出创建模板。JSON 按 components、cellTypes、actionComponents 分类，类型标识为 name，创建模板保存在 templates 中。模板 content 可作为初始配置；布局、数据绑定和交互仍需按页面需求补充。\n\nJSON 中每个资源的 labels 为 [{\"id\":\"texture\",\"name\":\"纹理\"}] 形式的数组，name 跟随 --locale，缺失时回退英文，再回退 ID；无标签时为 []。\n\n组件及 templates[] 内的创建模板分别返回标签。\n\n组件本身或其创建模板匹配时保留组件；仅模板匹配时只保留匹配模板。模板 content 等初始配置保持原格式。第三方扩展未提供 DTS 时，请参阅扩展文档。\n\nreferences[] 提供 DTS 阅读命令 readDocument 和类型符号 symbol；purpose=metadata 用于核对元数据赋值，declaration 用于理解查询声明，两者不能互换。阅读命令使用本次查询的服务器。本次查询不下载资料；local.available=true 时可读取 local.path 或搜索 local.root，否则执行 readDocument 获取并阅读资料。",
+	"cli.cmd.dev.component.title": "组件",
+	"cli.cmd.dev.component.summary": "发现页面可用组件",
+	"cli.cmd.dev.component.desc": "查询页面可用的组件、单元格类型和程序流节点。\n\n可查看创建模板、基本能力和子组件目录，帮助选择页面元素。\n\n只读取服务器资源，不修改页面文件。",
+	"cli.cmd.dev.component.show.summary": "查看组件能力和子组件目录。",
+	"cli.cmd.dev.component.show.desc": "查看组件的基本能力和可配置的子组件，帮助确定页面结构及后续配置方式。\n\n可按类型查看新建页面将要使用的组件，也可查看服务器 SPG 或仪表板中已有的组件。单元格类型和程序流动作仅支持按类型查询。\n\n查询以服务器上的组件定义和已保存页面为准，不读取本地未推送的修改，也不创建组件或执行交互。",
+	"cli.cmd.dev.component.show.out": "默认文本显示组件名称、基本能力和子组件目录。JSON 的 component 包含类型 type、名称 caption、类别 kind；description 仅在有说明时提供。component.capabilities 的 input、children、events 分别表示类型支持输入、普通子组件及交互事件，仅适用于页面组件，不保证当前页面状态下可用。支持指定目录中的部件不表示支持普通 children。\n\ncomponent.subcomponents[] 按 catalog 列出部件，types[] 包含写入该目录的 type、名称、multiple、supportsAdd 和可选的 maxCount。multiple=false 表示同类型不能有多个子项；supportsAdd 表示设计器是否提供新增操作，仍需遵守 maxCount 给出的同类型子项数量上限。目录最终使用对象还是数组还需核对 DTS。definitionName 用于识别组件定义，不能把局部部件名称作为全局类型使用。空清单不表示组件没有任何子组件。\n\ncomponent.layoutProperties 列出布局选择属性及可用默认值，不是当前布局值或可选布局清单；component.categories 用于核对数据、外观和布局类别。动作类型的 component.runEnv 为类型定义的运行环境，1 为服务器、2 为数据库、4 为浏览器，不表示某个动作实例最终采用的环境；组合值及依赖配置的环境按对应类型资料判断。\n\nqueries[].argv 是可传给 succapp 的参数数组，保留本次服务器和组件身份，末尾带 --json；读取属性、方法、事件或布局清单后再配置元数据，不把总览对象写入页面。非页面组件只提供属性查询入口。\n\ncoverage.status 为 partial，coverage.limitations 说明可能缺少的扩展部件、依赖数据绑定或页面状态的配置。source.content 在实例查询时为 server，在类型查询时为 none。查询不返回组件当前属性值；修改后仍需编译并验证实际效果。\n\nreferences[] 提供 DTS 阅读命令 readDocument 和类型符号 symbol；purpose=metadata 用于核对元数据赋值，declaration 用于理解查询声明，两者不能互换。阅读命令使用本次查询的服务器。本次查询不下载资料；local.available=true 时可读取 local.path 或搜索 local.root，否则执行 readDocument 获取并阅读资料。",
+	"cli.cmd.dev.component.show.identity": "必须且只能指定 --component 或 --component-type 中的一个，分别按组件 ID 或组件类型查询。",
+	"cli.cmd.dev.component.show.component": "服务器 SPG 或仪表板中已有的组件 ID。",
+	"cli.cmd.dev.component.show.componentType": "从 dev component list 获取与 --kind 对应的类型。",
+	"cli.cmd.dev.component.show.kind": "要查看的类型类别；cellType 和 actionComponent 仅支持按类型查询。",
+	"cli.cmd.dev.component.show.target": "服务器页面路径，后缀为 spg、dash、rpt、fapp 或 afl；按类型查询允许页面尚未创建。实例示例中的 /PROJECT/page.spg 和 componentId 须替换为已有页面路径及组件 ID。",
+	"cli.out.component.type": "类型",
+	"cli.out.component.cap.input": "支持输入",
+	"cli.out.component.cap.children": "支持普通子组件",
+	"cli.out.component.cap.events": "支持交互事件",
+	"cli.out.component.layoutProps": "布局属性",
+	"cli.out.component.subs": "子组件目录",
+	"cli.out.component.catalog": "目录",
+	"cli.out.component.multiple": "允许同类型多个子项",
+	"cli.out.component.showNote": "部分部件和依赖页面状态的配置可能未列出。添加 --json 查看后续查询参数和限制；写入格式请查匹配版本的 DTS。",
+	"cli.out.component.runEnv": "运行环境",
+	"cli.out.component.env.server": "服务器",
+	"cli.out.component.env.database": "数据库",
+	"cli.out.component.env.browser": "浏览器",
+	"cli.out.component.env.serverOrBrowser": "服务器或浏览器",
+	"cli.out.component.env.all": "服务器、数据库或浏览器",
+	"cli.out.component.env.cooperative": "浏览器与服务器协同",
+	"cli.out.component.env.other": "其他（{0}），请查对应类型资料",
+	"cli.cmd.dev.theme.show.summary": "查看主题变量、色板和图标集。",
+	"cli.cmd.dev.theme.show.desc": "查看主题处理后的配置，帮助了解实际生效的外观值。\n\n包括颜色、字体、尺寸变量、色板和图标集；同名主题优先使用应用配置，其次是项目，最后是系统。",
+	"cli.cmd.dev.theme.show.out": "普通输出列出 token 名称和值，对象和数组显示为单行 JSON。使用 --json 查看完整编译信息，位于结果的 theme 对象中；变量位于 theme.tokens。\n\n主题变量不等于组件的最终样式，还需结合组件默认值、所选风格和页面覆盖判断。应用风格时应保留变量引用。创建或修改主题时使用的元数据与这里的编译信息不同。\n\nreferences[] 提供 DTS 阅读命令 readDocument 和类型符号 symbol；purpose=metadata 用于核对元数据赋值，declaration 用于理解查询声明，两者不能互换。阅读命令使用本次查询的服务器。本次查询不下载资料；local.available=true 时可读取 local.path 或搜索 local.root，否则执行 readDocument 获取并阅读资料。\n\nqueryScope.kind 为 system、target 或 global，分别表示系统、指定位置及全局目录；message 说明范围，limitations[] 给出稳定 code 和本地化 message。系统查询的 targetQuery.argvTemplate 是待替换位置的调用模板（不含程序名），placeholders 声明必须替换的 <target>；不能原样执行。空结果仍保留范围；系统查询同时保留位置导航。--pretty-json 仅改变排版。",
+	"cli.cmd.dev.theme.show.theme": "主题名称，来自 dev theme list 返回的 name。",
+	"cli.cmd.dev.theme.show.target": "准备创建文件的服务器目标路径，也可指定项目名、应用路径或已有页面路径；不是本地路径。\n省略时查看指定主题的系统默认配置。",
+	"cli.cmd.dev.theme.title": "主题",
+	"cli.cmd.dev.theme.summary": "查询服务器可用主题",
+	"cli.cmd.dev.theme.desc": "查询可用的页面主题及其实际配置。\n\n可比较主题，并查看处理后的颜色、字体、尺寸变量、色板和图标集，帮助配置页面外观。\n\n只读取主题数据，不修改页面。",
+	"cli.cmd.dev.theme.list.summary": "列出可用主题。",
+	"cli.cmd.dev.theme.list.target": "准备创建文件的服务器目标路径，也可指定项目名、应用路径或已有页面路径；不是本地路径。\n省略时列出系统默认主题。",
+	"cli.cmd.dev.theme.list.empty": "没有匹配的主题。",
+	"cli.cmd.dev.theme.list.desc": "列出指定位置可用的主题，帮助选择页面的配色和尺寸方案。\n\n同名主题优先使用应用配置，其次是项目，最后是系统。",
+	"cli.cmd.dev.theme.list.out": "普通输出显示主题名称、标题、说明和来源。使用 --json 查看 themes[]：name 是主题标识，desc 是标题，description 是用途说明，location 是来源，thumbnail 是预览图地址。location 缺省表示系统主题；部分主题没有说明或预览图。\n\n查看主题处理后的变量、色板等完整编译信息：\n    succapp dev theme show <target> --theme=<name> --json\n\nreferences[] 提供 DTS 阅读命令 readDocument 和类型符号 symbol；purpose=metadata 用于核对元数据赋值，declaration 用于理解查询声明，两者不能互换。阅读命令使用本次查询的服务器。本次查询不下载资料；local.available=true 时可读取 local.path 或搜索 local.root，否则执行 readDocument 获取并阅读资料。\n\nqueryScope.kind 为 system、target 或 global，分别表示系统、指定位置及全局目录；message 说明范围，limitations[] 给出稳定 code 和本地化 message。系统查询的 targetQuery.argvTemplate 是待替换位置的调用模板（不含程序名），placeholders 声明必须替换的 <target>；不能原样执行。空结果仍保留范围；系统查询同时保留位置导航。--pretty-json 仅改变排版。",
+	"cli.cmd.dev.style.list.summaryOutput": "仅在 JSON 中保留风格标识、名称、说明及主题和页面限制，省略风格属性和资源引用；不减少服务器下载量。",
+	"cli.cmd.dev.style.list.summary": "列出可用风格。",
+	"cli.cmd.dev.style.list.target": "准备创建文件的服务器目标路径，也可指定项目名、应用路径或已有页面路径；不是本地路径。\n省略时列出系统默认风格。",
+	"cli.cmd.dev.style.list.empty": "没有符合组件类型、页面和主题条件的风格，不代表该类型不存在。",
+	"cli.cmd.dev.style.list.desc": "列出指定位置可用的风格，帮助为组件、单元格或默认子组件选择外观。\n\n可查看完整风格属性，并按页面类型、组件类型、风格种类和主题筛选。系统与项目风格合并后返回，同一种类、同一分类下的同名风格优先使用项目定义。\n\n按组件 ID 查询时，读取服务器已保存的 SPG 或仪表板；不读取本地未推送的修改。目录和类型查询不要求页面已经创建。只查询资源，不修改页面。",
+	"cli.cmd.dev.style.list.out": "默认表格列出风格标识、名称、说明、种类、来源及适用范围。--json 返回完整风格定义；--summary 省略其中的风格属性和资源引用。\n\nJSON 中，componentStyle、cellTypeStyle 和 conditionStyle 按分类组织风格数组，例如 componentStyle.button[]；tooltipStyle 直接返回数组。条目的 id 是风格标识，content 是风格属性。风格 ID 仅在所属种类和分类中唯一。\n\n按属性查询时，selection.property 是实际采用的属性路径，selection.rootProperty 是所属顶层属性。selection.styleType 和 selection.styleCategory 标识候选风格的种类与分类，selection.source 说明有效属性声明的来源，例如 components:tree 或 cellTypes:buttonGroup。候选位于 componentStyle[selection.styleCategory]；将选中条目的 id 作为该属性的值，写入结构按相应类型资料确认，不把完整查询结果写入页面。单元格内的子组件也可能使用组件风格。\n\n实例查询、属性查询和指定 --kind 的类型查询还返回 context 与 source。context 说明实际组件类型、风格分类及本次使用的场景和主题；主题仅在查询使用主题筛选时提供。source 说明查询数据来源，source.content 在实例查询时为 server，在类型查询时为 none，与 selection.source 的属性声明来源不同。属性查询的 coverage.limitations 说明未加载的扩展能力和未计算的动态条件。\n\n没有候选时返回 empty.reason：notApplicable 表示不适用于目标页面，unsupported 表示该类型不支持相应风格，noMatches 表示没有符合查询条件的条目，emptyCollection 表示目录为空。属性已解析但没有对应风格时，仍保留 selection，不能据此判断属性无效。\n\nreferences[] 提供 DTS 阅读命令 readDocument 和类型符号 symbol；purpose=metadata 用于核对元数据赋值，declaration 用于理解查询声明，两者不能互换。阅读命令使用本次查询的服务器。本次查询不下载资料；local.available=true 时可读取 local.path 或搜索 local.root，否则执行 readDocument 获取并阅读资料。\n\nqueryScope.kind 为 system、target 或 global，分别表示系统、指定位置及全局目录；message 说明范围，limitations[] 给出稳定 code 和本地化 message。系统查询的 targetQuery.argvTemplate 是待替换位置的调用模板（不含程序名），placeholders 声明必须替换的 <target>；不能原样执行。空结果仍保留范围；系统查询同时保留位置导航。--pretty-json 仅改变排版。",
+	"cli.cmd.dev.style.list.property": "默认子组件风格属性的名称或点分隔路径，例如 buttonCompStyle。须同时指定 --component 或 --component-type，属性类型须为 defaultCompStyle，可通过 dev component-property show 查看声明。按继承和局部覆盖后的属性分类筛选组件风格；仅可搭配 --scene=componentStyle。省略时查询组件或单元格自身的风格。",
+	"cli.cmd.dev.style.list.componentType": "组件或单元格元数据 type，例如 button、number；先用 dev component list <target> 发现类型。",
+	"cli.cmd.dev.style.list.kind": "查询对象所属类别。按组件 ID 查询仅支持 component；查询单元格属性须指定 cellType。指定 --property 时，省略则按 component 解析；其他类型查询省略时保留组件及同名单元格的风格分类。",
+	"cli.cmd.dev.style.list.scene": "风格种类。指定 --property 时固定为 componentStyle，不能指定其他种类。其他查询省略时，实例查询和 --kind=component 类型查询使用 componentStyle，--kind=cellType 类型查询使用 cellTypeStyle；未指定 --kind 的类型查询和目录查询保留全部种类。conditionStyle 为条件风格，tooltipStyle 为提示风格。",
+	"cli.cmd.dev.style.list.theme": "主题标识，保留通用风格和此主题的风格。按组件 ID 查询时省略使用页面主题，未设置时为 default；显式值覆盖本次查询。目录和类型查询省略时不过滤主题。",
+	"cli.cmd.dev.style.title": "风格",
+	"cli.cmd.dev.style.summary": "查询服务器可用风格",
+	"cli.cmd.dev.style.desc": "查询可用于页面制作的视觉风格。\n\n可查看风格属性、适用组件及来源，帮助为组件或单元格选择外观。",
+	"cli.cmd.dev.ext.template.title": "服务器扩展模板",
+	"cli.cmd.dev.ext.template.summary": "查看服务器扩展模板",
+	"cli.cmd.dev.ext.template.desc": "查询服务器上的扩展模板。\n\n模板对应可创建的扩展点和初始内容，应与后续扩展开发使用的服务器配套。",
+	"cli.cmd.dev.ext.template.list.summary": "列出扩展模板。",
+	"cli.cmd.dev.ext.template.list.desc": "列出服务器可用的扩展模板，帮助选择扩展的初始内容。\n\n支持按扩展点、标签和关键词筛选。\n\n只读取模板信息，不创建或安装扩展。",
+	"cli.cmd.dev.ext.template.list.out": "JSON 中 templates[] 的 extensionPoint 是扩展点，templateName 是创建时使用的模板标识；name、desc、version 是可选的名称、说明和版本。\n\nJSON 中每个资源的 labels 为 [{\"id\":\"texture\",\"name\":\"纹理\"}] 形式的数组，name 跟随 --locale，缺失时回退英文，再回退 ID；无标签时为 []。",
+	"cli.cmd.dev.ext.template.list.extensionPoint": "只列出指定扩展点的模板。",
+	"cli.cmd.dev.script.title": "临时后端脚本",
+	"cli.cmd.dev.script.summary": "用临时脚本完成一次性服务器任务",
+	"cli.cmd.dev.script.desc": "通过临时后端脚本完成一次性查询、计算、修改，或补充现有 CLI 尚未覆盖的服务器操作。\n\n脚本以匿名方式使用，不保存为服务器元数据。执行和编译检查均需要管理员权限。执行可能修改服务器资源；响应中断后先核对实际效果，再决定是否重试。\n\n需要持续维护和发布的业务逻辑使用项目后端脚本（.action.ts）。",
+	"cli.cmd.dev.script.done": "脚本命令完成。",
+	"cli.cmd.dev.script.invalidJsonInput": "JSON 输入文件无效：{0}",
+	"cli.cmd.dev.script.exec.summary": "执行临时后端脚本，完成一次性服务器任务。",
+	"cli.cmd.dev.script.exec.desc": "在服务器上执行临时后端 TypeScript，完成查询、计算或修改，无需创建服务器脚本资源。\n\n默认编译通过后执行。仅编译模式检查源码，不运行用户代码；它不模拟业务结果，也不验证运行时依赖、资源权限或实际业务效果。\n\n需要管理员权限。脚本可在自身权限范围内访问和修改服务器资源。超时或断连后先核对实际效果，再决定是否重试。",
+	"cli.cmd.dev.script.exec.out": "--json 输出中，source 为 file 或 stdin，dryRun 表示是否仅编译检查。文件输入包含 inputPath（原输入路径）和 localPath（本地绝对路径）；stdin 省略这两项。\n\n执行成功时 result 是 main 的返回值，params 包含提交的字符串参数（无参数时为 {}），elapsedMs 是服务器执行耗时（毫秒，服务器提供时返回）。result 的业务结构由脚本决定；普通文本只报告完成，复用返回值应使用 --json。\n\n仅编译检查或当前脚本编译失败时返回 summary 和 items[]。每项 compiler 为 typescript，status 为 passed 或 failed；通过项没有 error。失败诊断位于 items[].error.properties.diagnostics，行列从 1 开始，对应原始 TypeScript。诊断未提供 file 时使用当前项的 localPath 或 stdin；relatedInformation 保留关联位置。原始堆栈可在 debug 日志中查看。\n\n源码错误返回退出码 1；来源缺失、冲突或脚本为空白返回 2。连接、读文件、编译器内部故障和运行期业务失败使用标准 CLI 错误。执行后仍需核对返回值与实际效果，编译通过不代表业务执行成功。",
+	"cli.cmd.dev.script.exec.source": "用 <file> 或显式 --stdin 提供 UTF-8 脚本文本，必须且只能选择一个来源。普通 JavaScript 也可输入；文件后缀不决定语言，也不会使其成为元数据资源。文件或 stdin 为空或只有空白时，按输入错误拒绝。\n入口使用顶层同步普通函数 function main(args) 或 export function main(args)，返回值成为 result。不支持 async、生成器或 default 导出，也不会等待 Promise 结果。request_main 是项目 HTTP 脚本入口，不适用于此命令。\n临时脚本没有服务器文件名或相对资源基准目录。本地相邻文件不会成为服务器模块；系统模块按模块名 import，服务器项目模块及文件、元数据 API 使用服务器绝对路径。API 以目标服务器的声明为准，不按 Node.js 的 fs、fetch 或任意 npm 包推断可用能力。",
+	"cli.cmd.dev.script.exec.stdin": "从标准输入读取完整脚本文本。只读取脚本；业务输入需另外用 --input 提供。",
+	"cli.cmd.dev.script.exec.dryRun": "检查 TypeScript 语法、转译、静态 main 声明及引擎可解析性，不执行顶层代码或 main。支持类型标注、import/export 和常量枚举；仍读取 --input 并检查文件可读性及 JSON 格式；不做完整类型检查，不加载运行时依赖，不验证输入的业务语义，也不模拟实际效果。",
+	"cli.cmd.dev.script.exec.file": "UTF-8 本地临时后端脚本文件，相对路径基于应用 -C 后的执行目录。文件只提供脚本文本，不会上传为服务器脚本资源。\n只读 API 示例（保存为 inspect.js，项目数量随环境变化；result 形如 {\"projectCount\":3}）：\n    var metadata = require(\"svr-api/metadata\");\n    function main(args) {\n      return { projectCount: metadata.getAllProjects().length };\n    }\n用 dev script exec inspect.js --json 读取返回值；按参考资料中的 API 索引和服务器配套 DTS 确认所需模块、权限及返回结构。",
+	"cli.cmd.dev.script.exec.input": "本地 UTF-8 输入文件，内容传入 main(args) 的 args.input。去掉首尾空白后以 { 或 [ 开头时按 JSON 对象或数组解析；此时非法 JSON 报错。其他内容保持原始字符串，包括空白、42、true、null 和带引号的字符串；文件后缀不决定类型。\n例如文件内容为 {\"count\":2} 时 args.input.count 为数字 2；内容为 true 时 args.input 是字符串 \"true\"。--param=mode=preview 则提供 args.params.mode=\"preview\"，参数值始终为字符串。\n回显脚本及返回值示意：\n    function main(args) { return { input: args.input, params: args.params }; }\n    {\"result\":{\"input\":{\"count\":2},\"params\":{\"mode\":\"preview\"}}}",
+	"cli.cmd.dev.script.exec.param": "key=value 字符串参数，可重复，由 args.params 读取，例如 --param=mode=preview。仅第一个等号分隔键和值，参数值保留原始文本及空白。",
+	"cli.cmd.dev.template.title": "文件模板",
+	"cli.cmd.dev.template.summary": "查询可用的文件模板。",
+	"cli.cmd.dev.template.desc": "查询目标位置可用的文件创建模板、正文和相关配置描述。\n\n文件类型和可用来源由目标服务器决定。",
+	"cli.cmd.dev.template.list.summary": "列出可用的文件创建模板。",
+	"cli.cmd.dev.template.list.desc": "列出目标位置可用的创建模板，比较用途、标签和预览。\n\n支持标签和文本筛选。",
+	"cli.cmd.dev.template.list.out": "JSON 返回 templates[]。id 是供 show --name 使用的模板标识，不是 displayName；type 为文件类型。保留来源 location、所属应用模板 ownerTemplate、缩略图 thumbnail、截图 screenshots 和服务器其他摘要字段。\n\ntemplates[].labels[] 返回标签 id 和当前语言 name，缺少名称时回退 ID；无标签为 []。标签 ID 可组成 --label 表达式；重复的 --label 条件取交集。\n\ntemplates=[] 表示没有结果；empty.reason=noMatches 表示筛选无匹配，emptyCollection 表示服务器没有返回该类型的模板。默认保持服务器顺序。\n\n选定模板后保持相同服务器和查询范围读取详情。系统查询需保留列表使用的文件类型（以下为 SPG 示例），$TEMPLATE_ID 替换为该列表返回的真实 id：\n    succapp dev template show --file-type=spg --name=\"$TEMPLATE_ID\" --json\n\n按位置查询时，<target> 替换为列表使用的完整服务器目标文件路径；目录查询还须保留同一 --file-type：\n    succapp dev template show \"<target>\" --name=\"$TEMPLATE_ID\" --json\n\n也可以直接基于选定模板创建文件，用法见：\n    succapp server file create --help\n\nreferences[] 提供 DTS 阅读命令 readDocument 和类型符号 symbol；purpose=metadata 用于核对元数据赋值，declaration 用于理解查询声明，两者不能互换。阅读命令使用本次查询的服务器。本次查询不下载资料；local.available=true 时可读取 local.path 或搜索 local.root，否则执行 readDocument 获取并阅读资料。\n\nqueryScope.kind 为 system、target 或 global，分别表示系统、指定位置及全局目录；message 说明范围，limitations[] 给出稳定 code 和本地化 message。系统查询的 targetQuery.argvTemplate 是待替换位置的调用模板（不含程序名），placeholders 声明必须替换的 <target>；不能原样执行。空结果仍保留范围；系统查询同时保留位置导航。--pretty-json 仅改变排版。\n\n系统模板查询不按目标文件名匹配脚本内容模板；需要这类初始内容时提供完整目标路径。",
+	"cli.cmd.dev.template.list.fileType": "显式文件类型，通常用于目录目标，例如 rpt、tbl、app、d.docx；由服务器校验。\n省略目标位置或目标为 system 时必须指定。",
+	"cli.cmd.dev.template.list.target": "准备创建文件的服务器完整绝对路径，或配合 --file-type 的父目录；不是本地路径。完整文件名用于匹配内容模板，文件目标默认按后缀识别类型。\n目标文件无需存在；查询成功不代表目录存在或可写。省略时列出系统默认创建模板。",
+	"cli.cmd.dev.template.list.keyword": "不区分大小写地搜索模板 ID、名称、说明和标签。模板文本匹配完整输入；标签 ID、名称和同义词按空格或中英文逗号拆词，多个词取交集。与其他筛选条件取交集。\n按相关度排序，同分保持原有顺序；省略时保持服务器顺序。",
+	"cli.cmd.dev.template.show.summary": "读取模板正文和完整详情。",
+	"cli.cmd.dev.template.show.desc": "读取目标位置可用的创建模板及其配置描述。",
+	"cli.cmd.dev.template.show.out": "普通输出仅为主文件正文：文本原样输出，JSON 对象缩进输出。目录模板输出文件清单，文件正文需分别读取。\n\nJSON 返回模板详情，包括 id、type、displayName、description、labels、location、ownerTemplate、thumbnail、screenshots，以及 content 和 definitions。labels 是逗号分隔的标签 ID；标签显示名称可从 list 的 templates[].labels[] 获取。\n\ncontent.kind 区分 file、component 和 directory。主文件正文在 content.value；保存时字符串直接写入，对象序列化为 JSON，不保存整个结果对象。\n\ncontent.others 是按子类型索引的关联源码，值可以是文本或 JSON 对象。以 monthly.dash 为例，ts 和 dash.ts 都对应 monthly.dash.ts，拼接前移除已有主类型前缀，避免 monthly.dash.dash.ts。保存本地模板内容时同时保存关联源码。\n\n目录模板的 content.files[] 包含相对根目录的 path、文件或目录种类 kind，以及文件的读取地址 url；空目录也保留在清单中，目录条目没有 url。可用 server http-get 读取文件，具体用法见其帮助。\n\ndefinitions[] 是编辑正文所需的配置描述，没有时为 []。每项包含 id、kind、typeDescription 和 content；typeDescription 指向描述对象的 DTS。portal 描述门户的可用节点和属性，是参考信息，不写入页面正文。\n\nreferences[] 提供 DTS 阅读命令 readDocument 和类型符号 symbol；purpose=metadata 用于核对元数据赋值，declaration 用于理解查询声明，两者不能互换。阅读命令使用本次查询的服务器。本次查询不下载资料；local.available=true 时可读取 local.path 或搜索 local.root，否则执行 readDocument 获取并阅读资料。\n\n目录型资源的 references[].contentPath 指明适用的配置路径或模式，相对所查询的资源目录；例如应用设置位于 settings/settings.json，知识库配置位于 settings.json。../.meta 表示父目录中记录该资源的条目。专属声明缺失的特殊类型提供类型索引或资源元信息资料，不代表正文可按 JSON 编辑。\n\nqueryScope.kind 为 system、target 或 global，分别表示系统、指定位置及全局目录；message 说明范围，limitations[] 给出稳定 code 和本地化 message。系统查询的 targetQuery.argvTemplate 是待替换位置的调用模板（不含程序名），placeholders 声明必须替换的 <target>；不能原样执行。空结果仍保留范围；系统查询同时保留位置导航。--pretty-json 仅改变排版。\n\n普通输出的范围说明和位置查询命令写入 stderr，stdout 仍仅为正文；--quiet 也保留范围说明。\n\n系统模板查询不按目标文件名匹配脚本内容模板；需要这类初始内容时提供完整目标路径。",
+	"cli.cmd.dev.template.show.name": "模板 ID，来自同一位置的 dev template list；省略时由服务器选择默认模板。",
+	"cli.cmd.dev.template.target": "准备创建文件的服务器完整绝对路径，或配合 --file-type 的父目录；不是本地路径。\n省略时读取系统默认创建模板。",
+	"cli.cmd.dev.template.fileType": "显式文件类型，通常用于目录查询，由服务器校验。\n省略目标位置或目标为 system 时必须指定。",
+	"cli.cmd.dev.displayFormat.title": "显示格式",
+	"cli.cmd.dev.displayFormat.summary": "查询服务器可用显示格式",
+	"cli.cmd.dev.displayFormat.desc": "查询可用的显示格式，帮助为页面选择金额、百分比或日期等展示方式。\n\n可了解目标位置生效的格式及来源；只读取资源，不修改页面。",
+	"cli.cmd.dev.displayFormat.list.summary": "列出按编号合并后的显示格式。",
+	"cli.cmd.dev.displayFormat.list.target": "文件所属的服务器项目名、应用根路径，或已有页面的服务器绝对路径；不是本地路径。新建文件时指定所属项目或应用，不使用尚未创建的页面路径。\n页面支持 .rpt、.dash、.spg、.fapp；目录不能作为页面范围。省略时列出系统默认显示格式；嵌套应用仅取最近的应用及所属项目。",
+	"cli.cmd.dev.displayFormat.list.desc": "列出指定位置可引用的显示格式，帮助选择格式编号。\n\n合并系统、项目、最近应用及页面的适用定义；同编号优先级为页面、应用、项目、系统。指定组件后可查看相应属性及推荐和更多格式；更多格式仍可使用。\n\n页面范围查询读取服务器已保存的页面，不读取本地未推送的内容；类型查询也使用页面级格式。部分依赖绑定字段或动态类型的推荐可能无法确定。只查询格式，不修改页面。",
+	"cli.cmd.dev.displayFormat.list.out": "默认表格显示编号、名称、格式串、来源层级和服务器位置；组件查询增加推荐分组。--json 返回 language 和 displayFormats[]，条目含 name、format、source（system/project/app/page）、location 及可选 caption、desc。用 name 引用格式；format 为 Excel 风格格式串。--locale 同时选择系统语言包和自定义格式的 i18ns，缺少非空覆盖时使用基础值。\n\n组件查询额外返回 source、context、selection 和 recommendation。selection.property 是选择器中的属性路径，type 是编辑类型；rootProperty、rootType 标识所属顶层属性及其编辑类型。currentValue 为该顶层属性在服务器保存的原值，不是解码后的子属性值。currentSource 为 server 或 none；defaultValue 为声明缺省值，不代表页面已保存此值。recommendation.recommended 与 recommendation.additional 是 displayFormats 中的编号数组；不依据推荐结果排除格式。recommendation.status 为 available、noFeature 或 partial；noFeature 表示没有针对性推荐，系统格式均放入 recommended；不据此推断绑定字段类型，复杂格式和未支持的推荐条件见 recommendation.limitations。coverage.status 为 partial，部分扩展属性和依赖页面状态的推荐未计算。\n\nauto 不在固定格式定义中。recommendation.automatic.value 为 auto；recommendation.automatic.suggestedFormat 是已声明特征下的参考编号，不等同于执行页面后自动格式的最终结果。缺少特征时 recommendation.automatic.status 为 unresolved，且省略 suggestedFormat。按属性持久化类型写入格式编号，不把推荐分组对象写入元数据。\n\nreferences[] 提供 DTS 阅读命令 readDocument 和类型符号 symbol；purpose=metadata 用于核对元数据赋值，declaration 用于理解查询声明，两者不能互换。阅读命令使用本次查询的服务器。本次查询不下载资料；local.available=true 时可读取 local.path 或搜索 local.root，否则执行 readDocument 获取并阅读资料。\n\nqueryScope.kind 为 system、target 或 global，分别表示系统、指定位置及全局目录；message 说明范围，limitations[] 给出稳定 code 和本地化 message。系统查询的 targetQuery.argvTemplate 是待替换位置的调用模板（不含程序名），placeholders 声明必须替换的 <target>；不能原样执行。空结果仍保留范围；系统查询同时保留位置导航。--pretty-json 仅改变排版。",
+	"cli.cmd.dev.icon.title": "图标",
+	"cli.cmd.dev.icon.summary": "查询图标",
+	"cli.cmd.dev.icon.list.summary": "列出图标资源。",
+	"cli.cmd.dev.icon.list.desc": "列出指定位置可选的图标，帮助选择页面素材。\n\n可按标签、关键词、来源或主题查找，也可针对组件属性查看推荐标签。推荐帮助缩小选择范围，不排除其他素材。\n\n素材范围包含系统、项目及适用应用，不包含页面私有附件。按组件 ID 查询时使用服务器已保存的 SPG 或仪表板，不读取本地未推送的修改。只查询资源，不下载素材或修改页面。",
+	"cli.cmd.dev.icon.list.out": "--json 返回 icons[] 和 summary。条目包含 name、来源 location（sys/project/app/theme）、可选的扩展名称 extensionName 和 labels[]；标签 id 用于筛选，name 跟随当前语言并回退英文或 ID，无标签为 []。\n\nrefValue 是图片资源引用，登记到页面 referenceResources 条目的 targetPath 后，用资源代号赋值。previewUrl 仅供预览。width、height 是可选像素尺寸，可能为字符串；pictureFillInfo 提供填充配置参考。\n\n以下示例将项目图片登记为 bg，实际 targetPath 须替换为所选素材的 refValue：\n    {\"referenceResources\":{\"bg\":{\"targetPath\":\"$PROJECTIMG:/images/bg.svg\",\"targetType\":\"PROJECT\",\"refType\":\"link\"}}}\n\n字体图标直接保存返回的 $ICON: value；图片型图标的 IconValueString 保存为 \"bg\"。静态图片填充属性的 ImageFillPersistValue 保存为 {\"sourceType\":\"static\",\"image\":{\"path\":\"bg\"}}，写到相应组件属性，不把片段当作完整页面。\n\n组件查询额外提供 source、context、selection、recommendation 和 coverage。source.content 为 server（实例）或 none（类型）；coverage.status=partial 表示部分动态属性未覆盖。selection.property/type/typeArgs 描述选择器；rootProperty/rootType 标明顶层属性，currentValue 是其服务器保存原值，currentSource 为 server 或 none，defaultValue 是声明默认值。\n\nrecommendation.label 为推荐标签表达式，status 为 available 或 none。条目 available=true 仅表示类别匹配，recommended 表示命中推荐；无推荐规则时省略 recommended。\n\nsummary.matched、summary.returned、summary.hasMore 分别表示匹配总数、返回数及是否还有结果。empty.reason 为 noMatches、emptyCollection 或 notApplicable；任一来源读取失败时整体报错。\n\nreferences[] 提供赋值所需 DTS 的阅读命令 readDocument 和类型符号 symbol，阅读命令使用本次查询的服务器。本次查询不下载资料；local.available=true 时可读取 local.path 或搜索 local.root，否则执行 readDocument 获取并阅读资料。\n\nqueryScope.kind 为 system、target 或 global，分别表示系统、指定位置及全局目录；message 说明范围，limitations[] 给出稳定 code 和本地化 message。系统查询的 targetQuery.argvTemplate 是待替换位置的调用模板（不含程序名），placeholders 声明必须替换的 <target>；不能原样执行。空结果仍保留范围；系统查询同时保留位置导航。--pretty-json 仅改变排版。",
+	"cli.cmd.dev.icon.desc": "查询服务器可用图标，帮助为页面选择图标素材。\n\n支持不同来源、位置和标签的素材检索，字体图标与图片型图标的引用方式不同。\n\n只查询资源，不修改页面。",
+	"cli.cmd.dev.image.title": "图片",
+	"cli.cmd.dev.image.summary": "查询图片",
+	"cli.cmd.dev.image.list.summary": "列出图片素材。",
+	"cli.cmd.dev.image.list.desc": "列出指定位置可选的图片素材，帮助选择页面素材。\n\n可按标签、关键词、来源或主题查找，也可针对组件属性查看推荐标签。推荐帮助缩小选择范围，不排除其他素材。\n\n素材范围包含系统、项目及适用应用，不包含页面私有附件。按组件 ID 查询时使用服务器已保存的 SPG 或仪表板，不读取本地未推送的修改。只查询资源，不下载素材或修改页面。",
+	"cli.cmd.dev.image.list.out": "--json 返回 images[] 和 summary。条目包含 name、来源 location（sys/project/app/theme）、可选的扩展名称 extensionName 和 labels[]；标签 id 用于筛选，name 跟随当前语言并回退英文或 ID，无标签为 []。\n\nrefValue 是图片资源引用，登记到页面 referenceResources 条目的 targetPath 后，用资源代号赋值。previewUrl 仅供预览。width、height 是可选像素尺寸，可能为字符串；pictureFillInfo 提供填充配置参考。\n\n以下示例将项目图片登记为 bg，实际 targetPath 须替换为所选素材的 refValue：\n    {\"referenceResources\":{\"bg\":{\"targetPath\":\"$PROJECTIMG:/images/bg.svg\",\"targetType\":\"PROJECT\",\"refType\":\"link\"}}}\n\n按 selection.rootType 选择保存格式，将值写入 selection.rootProperty：\n    image → ImageString：\"url(bg)\"\n    imageFill → ImageFillPersistValue：{\"sourceType\":\"static\",\"image\":{\"path\":\"bg\"}}\n    imageSliceFill → ImageSliceFillPersistValue：{\"image\":\"bg\"}\n    fill → FillPersistValue：{\"type\":\"image\",\"image\":{\"path\":\"bg\"}}\n例如 panel 的 fill.image 查询返回 rootProperty=fill、rootType=fill，应把 FillPersistValue 的值写入 panel.fill。以上是属性值片段，不是完整页面。\n\n组件查询额外提供 source、context、selection、recommendation 和 coverage。source.content 为 server（实例）或 none（类型）；coverage.status=partial 表示部分动态属性未覆盖。selection.property/type/typeArgs 描述选择器；rootProperty/rootType 标明顶层属性，currentValue 是其服务器保存原值，currentSource 为 server 或 none，defaultValue 是声明默认值。\n\nrecommendation.label 为推荐标签表达式，status 为 available 或 none。条目 available=true 仅表示类别匹配，recommended 表示命中推荐；无推荐规则时省略 recommended。\n\nsummary.matched、summary.returned、summary.hasMore 分别表示匹配总数、返回数及是否还有结果。empty.reason 为 noMatches、emptyCollection 或 notApplicable；任一来源读取失败时整体报错。\n\nreferences[] 提供赋值所需 DTS 的阅读命令 readDocument 和类型符号 symbol，阅读命令使用本次查询的服务器。本次查询不下载资料；local.available=true 时可读取 local.path 或搜索 local.root，否则执行 readDocument 获取并阅读资料。\n\nqueryScope.kind 为 system、target 或 global，分别表示系统、指定位置及全局目录；message 说明范围，limitations[] 给出稳定 code 和本地化 message。系统查询的 targetQuery.argvTemplate 是待替换位置的调用模板（不含程序名），placeholders 声明必须替换的 <target>；不能原样执行。空结果仍保留范围；系统查询同时保留位置导航。--pretty-json 仅改变排版。",
+	"cli.cmd.dev.image.desc": "查询服务器图片素材，帮助为页面选择图片。\n\n支持不同来源、位置和标签的素材检索；预览地址与页面保存的资源引用用途不同。\n\n只查询资源，不上传文件或修改页面。",
+	"cli.cmd.dev.font.title": "字体",
+	"cli.cmd.dev.font.summary": "查询字体",
+	"cli.cmd.dev.font.list.summary": "列出设计器字体选项。",
+	"cli.cmd.dev.font.list.desc": "列出设计器可选字体，帮助选择页面文字的字体。\n\n包含当前语言的预置字体、跟随页面主题的自动选项和已启用扩展提供的字体。支持按字体值或名称筛选；相同字体值合并并保留全部来源。\n\n不验证浏览器、操作系统或 PDF 导出环境是否安装字体，也不解析页面主题最终采用的字体。",
+	"cli.cmd.dev.font.list.out": "默认表格显示字体名称、字体值和来源。--json 返回 fonts[]，条目包含 value、caption、kind、extensionName、sources。kind 为 preset（系统预置）、extension（扩展）或 themeVariable（自动）；自动选项的 value 为 fontFamily，表示跟随页面主题。sources 保留各个来源，扩展来源包含 extensionName。\n\nreferences[] 提供 DTS 阅读命令 readDocument 和类型符号 symbol；purpose=metadata 用于核对元数据赋值，declaration 用于理解查询声明，两者不能互换。阅读命令使用本次查询的服务器。本次查询不下载资料；local.available=true 时可读取 local.path 或搜索 local.root，否则执行 readDocument 获取并阅读资料。\n\nqueryScope.kind=global 表示全局字体目录；message 说明范围，limitations[] 给出稳定 code 和本地化 message。字体没有位置覆盖语义，不提供 targetQuery。空结果仍保留范围说明。--pretty-json 仅改变排版。",
+	"cli.cmd.dev.font.list.contains": "不区分大小写的字面包含，匹配字体值和标题。",
+	"cli.cmd.dev.font.desc": "查询设计器字体选项，帮助选择页面字体。\n\n包含当前语言的预置字体、跟随页面主题的自动选项和启用扩展提供的字体。\n\n目录不验证浏览器、操作系统或 PDF 渲染环境中的字体安装情况。",
+	"cli.cmd.dev.expression.title": "表达式",
+	"cli.cmd.dev.expression.summary": "查询表达式",
+	"cli.cmd.dev.expression.function.title": "表达式函数",
+	"cli.cmd.dev.expression.function.summary": "查询表达式函数",
+	"cli.cmd.dev.expression.function.list.summary": "列出表达式函数。",
+	"cli.cmd.dev.expression.function.list.desc": "查询服务器上的表达式函数，帮助查找编写表达式所需的函数。\n\n结合实际注册信息和随服务器提供的手册，展示名称、分类、简介及来源，支持筛选和分页。目录不包含完整的页面或模型上下文函数。\n\n需要服务器支持此查询能力；不支持时需确认 CLI 与服务器版本是否配套。",
+	"cli.cmd.dev.expression.function.list.out": "默认表格显示名称、简介、分组、来源、注册状态和执行环境。--json 返回 functions[]、coverage 和 summary。条目包含 name、source、registered，以及可用的 description、group、extensionName、参数和返回类型。完整参数字段含义见 dev expression function show --help。\n\nsource 为 global（全局注册）、extension（生效扩展）或 documentation（仅手册）。registered=false 表示未查到注册信息，不代表不可用；此时参数、返回类型和执行环境保持缺失。同名函数优先全局，其次生效扩展；shadowedSources 列出被覆盖的扩展来源。手册不覆盖注册元数据，也不将其他实现的同名手册用于扩展函数。\n\nreturnType 和参数 type 使用 int、number、string、boolean、date、any、array、json、geo；any 表示变体，未知类型省略。evalEnv 为 svr（服务器）、db（数据库）、browser（浏览器）组成的数组；单一环境也为数组，[] 表示未声明可执行环境，无法识别的环境省略该字段。数据库标记不保证具体数据库支持；使用前应在实际表达式位置验证。\n\ncoverage.registeredFunctions 表示包含注册目录，coverage.documentationIndex 表示取得手册索引，coverage.contextSpecific=false 表示未穷举上下文函数。缺少手册索引时仍返回注册信息；权限、网络和解析错误会使查询失败。\n\nsummary.matched、summary.returned、summary.hasMore 分别为匹配总数、本次返回数和是否还有结果。empty.reason 为 noMatches 或 emptyCollection。",
+	"cli.cmd.dev.expression.function.show.summary": "查看函数参数、返回类型及帮助。",
+	"cli.cmd.dev.expression.function.show.desc": "查看表达式函数的参数、返回类型、执行环境和帮助。\n\n适用于确认函数签名和使用边界；目录不能替代具体页面或模型上下文中的可用性判断。\n\n需要服务器支持此查询能力；不支持时需确认 CLI 与服务器版本是否配套。",
+	"cli.cmd.dev.expression.function.show.out": "--json 返回 function、coverage 和 documentation。function 的 name 为函数名，source 为 global（全局注册）、extension（生效扩展）或 documentation（仅手册），registered 表示是否查到注册信息；还可能有 description、group、extensionName 和 shadowedSources。仅手册条目不补造参数、返回类型或执行环境，也不表示函数不可用。\n\n参数描述位于 function.arguments[]：name 可省略，type 为类型，optional 表示可选，repeatable 表示可重复。argumentsCount 非负时为最大参数个数，-1 表示个数不固定；minArgumentsCount 为最小个数。returnType 是静态返回类型；returnArgType 存在时表示返回类型参考第几个参数，从 0 开始。constrained=true 表示计算依赖后端约束和 API 支持；anaFuncType 是分析函数类型名称，不是适用场景。\n\nreturnType 和参数 type 使用 int、number、string、boolean、date、any、array、json、geo；any 为变体，未知类型省略。evalEnv 为 svr（服务器）、db（数据库）、browser（浏览器）组成的数组；单一环境也为数组，[] 表示未声明可执行环境，无法识别的环境省略该字段。实际类型和可用性仍需结合参数、当前页面或模型以及具体数据库验证。\n\ncoverage.registeredFunctions 表示包含注册目录，coverage.documentationIndex 表示取得手册索引，coverage.contextSpecific=false 表示未穷举上下文函数。documentation.status 为 available 时，content 是帮助正文，path 是帮助地址；unavailable 表示没有可读取的帮助，已有函数信息仍可使用。权限或其他读取错误会使查询失败。",
+	"cli.cmd.dev.expression.function.desc": "查找表达式函数并查看其使用信息。\n\n支持按名称、简介、分组和扩展筛选，以及查看参数、返回类型、执行环境和帮助。",
+	"cli.cmd.dev.expression.desc": "查询服务器表达式函数，帮助编写表达式。\n\n支持函数查找及签名、执行环境和帮助查看；实际使用还取决于页面或模型中的字段、变量和数据类型。",
+	"cli.cmd.media.target": "准备创建文件的服务器完整绝对路径，也可指定已有页面或目录路径；不是本地路径，新页面的父目录必须存在。\n省略或为 system 时查询系统默认素材；其他位置默认合并系统、项目和适用应用素材。",
+	"cli.cmd.media.keyword": "按名称、描述、标签 ID、标题和近义词搜索。名称和描述匹配完整输入；标签按空格或中英文逗号拆词，多个词须同时命中。按匹配度排序，省略时保留原顺序。",
+	"cli.cmd.media.contains": "不区分大小写的字面包含；匹配名称、简介或标签标题。",
+	"cli.cmd.media.location": "按来源类别筛选；选择 theme 时须指定 --theme。",
+	"cli.cmd.media.extension": "按扩展名称筛选，仅查询系统素材；不能与 --theme 同用。",
+	"cli.cmd.media.theme": "显式主题名，按 target 就近解析，不推断当前页面主题。指定后加入主题素材；默认不查询主题素材。\n\n指定 --theme 时，--location 只能省略或为 theme，不能与 sys、project、app 同用，也不能与 --extension 同用。",
+	"cli.cmd.media.offset": "排序后的起始偏移，从 0 开始；读取下一页时增加本次返回数。",
+	"cli.cmd.media.limit": "返回上限；0 表示返回剩余全部。",
+	"cli.cmd.media.label": "标签 ID 或表达式，区分大小写。& 为同时具备，| 为任一分支，! 为排除；& 优先于 |，不支持括号，无标签资源不匹配。\n用 shell 引号保护表达式，如 --label='input&!chart'；可重复传入。各 --label、--keyword、--contains 及其他筛选条件取交集，先筛选再分页；省略时不限定标签，无匹配时不放宽。\n组件属性的推荐条件见 recommendation.label 或匹配版本 DTS 的 @mediaLabelFilter；推荐不限制可保存的素材。",
+	"cli.cmd.dev.file.title": "工作区文件",
+	"cli.cmd.dev.file.summary": "查看工作区文件",
+	"cli.cmd.dev.file.desc": "检查、校验和处理工作区中的元数据文件。\n\n提供路径解析、内容及历史读取、差异比较、编译校验、版本升级和浏览器访问。\n\n本地文件修改与升级不会自动同步到服务器。",
+	"cli.cmd.dev.file.resolve.summary": "解析工作区文件路径。",
+	"cli.cmd.dev.file.resolve.desc": "解析工作区文件的本地路径、服务器路径和浏览器地址。\n\n帮助确认文件对应的服务器资源。\n\n只解析目标，不上传文件或打开浏览器，也不验证最终页面是否可访问。",
+	"cli.cmd.dev.file.resolve.out": "JSON 关键字段：inputPath 保留原始路径输入，localPath 是本地绝对路径，remotePath 是服务器资源路径。viewUrl/editUrl 分别为查看和编辑链接；--url 只影响文本输出，不删减 JSON 字段。",
+	"cli.cmd.dev.file.resolve.url": "human 模式仅打印查看或编辑 URL。",
+	"cli.cmd.dev.file.resolve.badUrl": "--url 的值无效：{0}",
+	"cli.cmd.dev.file.resolve.editUrl": "编辑 URL：{0}",
+	"cli.cmd.dev.file.resolve.localPath": "本地路径：{0}",
+	"cli.cmd.dev.file.resolve.path": "路径：{0}",
+	"cli.cmd.dev.file.resolve.remote": "远程路径：{0}",
+	"cli.cmd.dev.file.resolve.viewUrl": "查看 URL：{0}",
+	"cli.cmd.dev.file.open.summary": "打开服务器文件页面。",
+	"cli.cmd.dev.file.open.desc": "在系统浏览器中打开工作区文件对应的服务器页面。\n\n支持查看、编辑和只获取链接，可视化文件与代码文件分别进入对应编辑器。\n\n打开的是服务器内容，不会推送本地修改。本地变化检查仅覆盖目标文件，不包括其引用的模板、脚本等依赖。",
+	"cli.cmd.dev.file.open.out": "JSON 的 url 是所选服务器页面地址，edit 表示是否选择编辑界面，opened 表示是否已请求启动浏览器；opened=true 不代表页面已成功加载。localChanged 表示目标本地文件有未推送变化；--no-open 时 opened=false，但仍返回 url。",
+	"cli.cmd.dev.file.open.edit": "打开服务器编辑页面，而不是默认的查看页面。",
+	"cli.cmd.dev.file.open.noOpen": "只返回页面 URL，不启动系统浏览器。",
+	"cli.cmd.dev.file.open.path": "工作区本地路径；相对路径以执行目录（应用 -C 后）为基准，也可使用工作区内的磁盘绝对路径。\n\n目标本地文件必须存在且为普通文件。",
+	"cli.cmd.dev.file.open.force": "即使本地文件有未推送变化，也打开服务器页面。\n\n该选项不会推送本地修改。",
+	"cli.cmd.dev.file.open.localChangedForce": "本地文件有未推送变化。此链接指向 {0} 的服务器版本，不包含尚未推送的本地修改。",
+	"cli.cmd.dev.file.open.openedEdit": "已打开服务器编辑页面：{0}",
+	"cli.cmd.dev.file.open.openedView": "已打开服务器查看页面：{0}",
+	"cli.cmd.dev.file.show.summary": "显示文件内容。",
+	"cli.cmd.dev.file.show.desc": "读取工作区文件在服务器或本地同步基线中保存的内容。\n\n支持当前服务器内容、服务器历史版本和本地同步基线，不读取工作目录中的当前文件。",
+	"cli.cmd.dev.file.show.out": "普通输出是原始内容；JSON 对已知类型且有效的 UTF-8 文本直接返回 content，encoding 为 utf8，二进制、未知类型或无效 UTF-8 使用 Base64，encoding 为 base64。",
+	"cli.cmd.dev.file.show.source": "内容来源：server 为当前服务器，mirror 为本地同步基线；--revision 仅适用于 server。",
+	"cli.cmd.dev.file.show.revision": "读取服务器历史版本。",
+	"cli.cmd.dev.file.show.badRev": "--revision 的值无效：{0}",
+	"cli.cmd.dev.file.show.badSource": "--source 的值无效：{0}",
+	"cli.cmd.dev.file.show.revSource": "--revision 只支持和 --source=server 一起使用。",
+	"cli.cmd.dev.file.diff.summary": "显示工作区文件与服务器内容的差异。",
+	"cli.cmd.dev.file.diff.desc": "对比本地工作区元数据与服务器内容，帮助审查修改。\n\n支持单文件及批量比较，也能比较本地已删除而服务器仍存在的文件。\n\n比较不修改本地或服务器文件；两侧均不存在的文件会报错。",
+	"cli.cmd.dev.file.diff.out": "JSON 的 patches[] 是逐文件结果，changed 表示是否有变化，workspaceExists 区分本地文件缺失与空文件，binary 表示二进制内容，patch 为可显示的差异文本。binary=true 时不能只根据 patch 是否为空判断有无差异；有差异本身仍退出 0，脚本应检查 summary.changed 或 patches[].changed。",
+	"cli.cmd.dev.file.diff.source": "与服务器内容比较。",
+	"cli.cmd.dev.file.diff.badSource": "--source 的值无效：{0}",
+	"cli.cmd.dev.file.history.summary": "显示服务器文件历史。",
+	"cli.cmd.dev.file.history.desc": "查看工作区文件在活跃服务器上保存的版本历史。\n\n历史记录来自服务器，与本地 Git 历史不同。",
+	"cli.cmd.dev.file.history.out": "JSON 的 histories[] 返回服务器历史记录；revision 可交给 dev file show --revision=<n>，modifyTime 是 Unix 时间戳（毫秒），remotePath 是服务器资源路径。没有可返回的历史时 histories 为空，并返回 empty.reason=emptyCollection。",
+	"cli.cmd.dev.file.history.limit": "限制历史记录返回条数。",
+	"cli.cmd.dev.file.check.rootObject": "元数据文件必须是 JSON 对象格式。",
+	"cli.cmd.dev.file.check.versionRequired": "元数据文件缺少 version 字段。",
+	"cli.cmd.dev.file.check.versionOlder": "文件版本低于目标服务器要求的版本“{0}”。请先升级元数据后重新检查。",
+	"cli.cmd.dev.file.check.versionNewer": "文件版本高于目标服务器支持的版本“{0}”。请连接匹配的服务器或升级服务器后重新检查。",
+	"cli.cmd.dev.file.check.versionUnrecognized": "无法识别文件版本与目标服务器版本的新旧关系，期望版本为“{0}”。请查阅元数据 DTS，并核对文件来源和目标服务器。",
+	"cli.cmd.dev.file.check.upgradeHint": "请先预演这些文件的元数据升级，检查后再升级并重新检查。以下命令仅预演，不修改文件。",
+	"cli.cmd.dev.file.check.summary": "校验工作区元数据和源码。",
+	"cli.cmd.dev.file.check.desc": "校验本地工作区元数据和源码，帮助在推送前发现问题。\n\n检查元数据格式、版本、字段和表达式，以及 FTL、TypeScript 和 Less 的语法或编译错误。元数据版本须与目标服务器要求一致；TypeScript 不做完整类型检查。\n\n校验需要连接目标服务器，文件依赖的其他资源和设置均读取服务器上的版本。编译前，应先推送这些依赖在本地尚未同步的修改；待编译文件本身无需先推送。\n\n检查不执行模板或脚本，也不修改服务器资源；本地文件只在开启自动修复时才写回。校验通过不代表引用资源、数据、权限和业务效果已经验证。",
+	"cli.cmd.dev.file.check.out": "文本按文件展示结果和错误位置；AI 建议使用 --json。下面节选一个 SPG 表达式错误的结果，省略其他字段；注释仅供说明，实际输出为严格 JSON：\n    {\n      \"kind\": \"result\",                         // 源码错误仍返回 result，退出码非零\n      \"validationComplete\": true,               // 全部目标已完成校验，不代表通过\n      \"summary\": { \"total\": 1, \"passed\": 0, \"failed\": 1, \"skipped\": 0 },\n      \"items\": [{\n        \"localPath\": \"/work/DEMO/app/page.spg\",   // 本地绝对路径\n        \"status\": \"failed\",                     // 当前文件存在源码错误\n        \"error\": {\n          \"errorCode\": \"err.base.sourceInvalid\",\n          \"properties\": {\n            \"diagnostics\": [{                   // 具体诊断\n              \"code\": \"err.exp.operandMissing\",\n              \"message\": \"缺少操作数\",\n              \"jsonPath\": \"$.body.canvas.children[0].visibleExp\"\n            }]\n          }\n        }\n      }]\n    }\n\n先看统计和文件状态，再读失败文件的 error.properties.diagnostics。status 为 passed（通过）、failed（源码错误）、skipped（跳过）或 executionFailed（检查未能完成）。跳过项须查看 skipReason，退出 0 不能视为全部通过；summary.failed 包含执行故障。kind=error 表示检查过程故障，先处理连接、文件访问或编译服务问题；properties.partialResults 如存在，保留已取得的文件结果。\n\n按诊断原因、jsonPath 或可用的文件行列定位，结合期望值和关联位置修复后重新检查。line/column 从 1 开始，诊断未带 file 时使用当前文件项；其他位置字段只按明确声明的坐标基准解释。warn 也表示存在待处理问题，返回非零退出码。版本不匹配时按提示升级旧文件或处理服务器兼容性，不要仅修改 version 声明。\n\n使用 --autofix 时，每个文件项都带 fixStatus：fixed 表示修好了问题并把正文写回本地文件，unchanged 表示没有可修问题或该类型不支持自动修复，failed 表示修复或写入文件失败，原因在 fixErrorMessage。fixed 时还带 fixedProblems（本次修好的问题，含 code、message 与 properties.jsonPath）；正文可能是重新序列化的结果，也可能是原内容补上引用条目，都不做第二轮校验。写回后仍有剩余问题时 status 为 failed，退出码规则不变；写回失败时 status 为 executionFailed。命令不保留备份，回退依赖版本控制。",
+	"cli.cmd.dev.file.check.done": "已完成 {0} 个工作区元数据文件的检查。",
+	"cli.cmd.dev.file.check.autofix": "检查后修掉已确定改法的问题并把正文写回本地文件，其余原样返回；只对元数据检查的文件类型生效，源码错误不修。",
+	"cli.cmd.dev.file.check.writeFailed": "写入本地文件失败：{0}",
+	"cli.cmd.dev.file.check.running": "正在编译校验工作区元数据文件",
+	"cli.cmd.dev.file.check.schemaFailed": "元数据校验失败。",
+	"cli.cmd.dev.file.check.schemaFailedMsg": "元数据校验失败：{0}",
+	"cli.cmd.dev.file.check.upgradeRequired": "{0} 个文件需要先升级。请使用相同的 pathspec 执行 `{1}`，升级完成后重新校验。",
+	"cli.cmd.dev.file.check.pathspec": "工作区本地路径：支持文件、递归目录或加引号的 glob；相对路径以执行目录（应用 -C 后）为基准，也可使用工作区内磁盘绝对路径。每项必须匹配，文件名及后缀区分大小写。\n文本须为 UTF-8；JSON 元数据使用严格 JSON，不支持注释或尾逗号，.jsonc 同样按严格 JSON 检查。FTL、.action.ts、前端 .ts 和 Less 按源码检查；.d.ts 不作为运行脚本编译。",
+	"cli.cmd.dev.file.upgrade.summary": "升级旧版 SuccApp 元数据文件。",
+	"cli.cmd.dev.file.upgrade.desc": "预演或升级本地工作区的旧版 SuccApp 元数据文件。\n\n支持单个文件或批量处理，预演可查看候选项和失败项。\n\n实际升级会修改本地文件，不会自动推送到服务器。",
+	"cli.cmd.dev.file.upgrade.out": "JSON 的 candidates[] 是升级候选项，changed[] 是实际更新项，skipped[] 和 failures[] 分别列出跳过项与失败项。--dry-run 只列候选、不更新文件；有失败项退出 1，候选或跳过项本身不表示失败。先核对 summary 和各项原因，再决定后续处理。",
+	"cli.cmd.dev.file.upgrade.dryRun": "预演升级候选文件，不修改文件。",
+	"cli.cmd.dev.file.upgrade.cands": "升级候选文件：{0}",
+	"cli.cmd.dev.file.upgrade.dryRunRes": "元数据升级 dry-run：已检查 {0}，候选 {1}，跳过 {2}，失败 {3}",
+	"cli.cmd.dev.file.upgrade.failed": "失败文件：{0}",
+	"cli.cmd.dev.file.upgrade.reason": "原因",
+	"cli.cmd.dev.file.upgrade.result": "元数据升级结果：已检查 {0}，已更新 {1}，跳过 {2}，失败 {3}",
+	"cli.cmd.dev.file.upgrade.skipped": "跳过文件：{0}",
+	"cli.cmd.dev.file.upgrade.upgraded": "已升级文件：{0}",
+	"cli.cmd.dev.file.upgrade.pathspec": "工作区本地路径：支持文件、递归目录或加引号的 glob；相对路径以执行目录（应用 -C 后）为基准，也可使用工作区内磁盘绝对路径。省略时处理全部本地项目。",
+	"cli.cmd.dev.file.*.pathspec": "工作区本地路径；相对路径以执行目录（应用 -C 后）为基准，也可使用工作区内的磁盘绝对路径。目录递归处理；glob 同样从执行目录展开，并用引号包裹。",
+	"cli.cmd.dev.file.*.path": "工作区本地路径；相对路径以执行目录（应用 -C 后）为基准，也可使用工作区内的磁盘绝对路径。",
+	"cli.cmd.dev.ext.title": "工作区扩展",
+	"cli.cmd.dev.ext.summary": "创建和发布工作区扩展",
+	"cli.cmd.dev.ext.desc": "创建和发布工作区扩展。\n\n支持查看本地扩展、从服务器模板创建扩展目录，以及上传到活跃服务器。\n\n创建会写入本地文件，发布会影响服务器上的扩展。",
+	"cli.cmd.dev.ext.dirNamedSame": "sysdata/extensions/ 下已存在同名目录。",
+	"cli.cmd.dev.ext.extNameMust": "扩展名必须符合模式 {0}。",
+	"cli.cmd.dev.ext.extNameRequired": "必须填写扩展名。",
+	"cli.cmd.dev.ext.invalidExtName": "扩展名无效。",
+	"cli.cmd.dev.ext.middleSegmentMust": "中间段必须等于 \"{0}\"（当前：\"{1}\"）。",
+	"cli.cmd.dev.ext.list.summary": "列出本地扩展。",
+	"cli.cmd.dev.ext.list.desc": "列出工作区 sysdata 项目下的本地扩展。\n\n列表来自本地扩展目录，不代表服务器已安装扩展。",
+	"cli.cmd.dev.ext.list.out": "JSON 的 extensions[] 是扩展名称字符串数组，不是扩展描述对象；名称可直接用于 dev extension push。没有本地扩展时数组为空，并返回 empty.reason=emptyCollection。",
+	"cli.cmd.dev.ext.create.summary": "创建本地扩展。",
+	"cli.cmd.dev.ext.create.desc": "从服务器模板创建本地扩展目录。\n\n需要已有活跃服务器、已克隆的 sysdata 项目及服务器连接，目标扩展目录不能已存在。\n\n操作会生成本地文件，不会自动发布到服务器。",
+	"cli.cmd.dev.ext.create.out": "JSON 返回 extensionName、extensionPoint 和 templateName，以及新建目录 extensionRoot 和 packageJsonPath 的本地绝对路径。创建成功只表示本地文件已准备，不表示扩展已发布或在服务器生效。",
+	"cli.cmd.dev.ext.create.extTemplate": "找不到扩展模板：{0}/{1}",
+	"cli.cmd.dev.ext.create.name": "新扩展名称：小写字母、数字和短横线，至少三段，第二段必须等于扩展点，例如 succ-component-card。",
+	"cli.cmd.dev.ext.push.summary": "推送本地扩展。",
+	"cli.cmd.dev.ext.push.desc": "将本地扩展上传到活跃服务器。\n\n操作会写入服务器并影响该扩展，覆盖已有扩展时可能替换远端变化。",
+	"cli.cmd.dev.ext.push.out": "JSON 中 pushed[]、rejected[]、failures[] 分别是已提交、因冲突拒绝和其他失败的文件，metadataVersionSuggestions[] 提供版本建议。可能部分成功：有拒绝项退出 6，否则有失败项退出 1；kind=result 不代表全部文件上传成功。",
+	"cli.cmd.dev.ext.push.path": "根据 sysdata/extensions 下的本地路径解析扩展；相对路径以执行目录（应用 -C 后）为基准。\n\n与 <name> 必须且只能选择一个。",
+	"cli.cmd.dev.ext.push.force": "允许本地扩展文件覆盖远端变化。",
+	"cli.cmd.dev.ext.push.needNamePath": "请传入扩展名或 --path=<path>。",
+	"cli.cmd.dev.ext.push.onlyOne": "<name> 和 --path=<path> 只能使用一个。",
+	"cli.cmd.dev.ext.push.name": "dev extension list 返回的扩展名称；与 --path 二选一。",
+	"cli.cmd.dev.ext.*.extensionPoint": "dev extension template list 返回的扩展点。",
+	"cli.cmd.dev.ext.*.template": "所选扩展点下的模板名称，来自 dev extension template list。",
+	"cli.cmd.dev.componentProperty.title": "组件属性",
+	"cli.cmd.dev.componentProperty.summary": "查询组件可配置和可读取的属性",
+	"cli.cmd.dev.componentProperty.desc": "查询组件可设置的属性，或查找元数据和表达式中可使用的属性。\n\n查询以服务器上的组件定义和已保存页面为准，不读取本地未推送的页面。",
+	"cli.cmd.dev.componentProperty.list.summary": "按用途列出组件属性。",
+	"cli.cmd.dev.componentProperty.list.desc": "按用途查找组件属性，帮助选择交互中要设置的属性、元数据字段或表达式可读取的属性。\n\n查询使用服务器组件定义和已保存页面，不读取本地未推送的修改。",
+	"cli.cmd.dev.componentProperty.list.out": "默认文本显示属性概览；JSON 的 properties[] 包含属性名称 name、标题 caption、编辑类型 type、来源 source、readonly 和声明标记。按组件 ID 查询也只返回声明，不返回实例当前属性值。选定 name 后用同一组件身份和用途执行 component-property show。\n\ncoverage.status 为 partial：部分扩展属性和依赖页面状态的属性可能未列出；不计算条件或动态候选值。coverage.limitations 列出具体限制，data-* 自定义属性不在有限清单内。筛选为空不证明属性非法。summary.hasMore=false 表示没有后续分页。\n\nsource.content 在实例查询时为 server，在类型查询时为 none。编辑类型不等同于持久化 JSON 值格式，赋值前应查对应 DTS。\n\nreferences[] 提供 DTS 阅读命令 readDocument 和类型符号 symbol；purpose=metadata 用于核对元数据赋值，declaration 用于理解查询声明，两者不能互换。阅读命令使用本次查询的服务器。本次查询不下载资料；local.available=true 时可读取 local.path 或搜索 local.root，否则执行 readDocument 获取并阅读资料。",
+	"cli.cmd.dev.componentProperty.show.summary": "查看一个组件属性的类型和选项。",
+	"cli.cmd.dev.componentProperty.show.desc": "查看指定属性的类型、默认值和选项，帮助确定赋值方式。\n\n查询使用服务器组件定义和已保存页面，不读取本地未推送的修改。",
+	"cli.cmd.dev.componentProperty.show.out": "默认文本展示属性基本信息、静态选项和子属性列表；复合值的完整结构通过 --json 查看。\n\nJSON 的 property 包含名称、标题、编辑类型、typeArgs、来源、只读及条件标记。按组件 ID 查询也不返回实例当前属性值；defaultValue 是声明默认值，不表示必须写入。property.options 保留静态字符串、数字和布尔原值；property.valueProvider 保留动态候选的定义，不计算候选值。\n\n复合属性的子项在 property.subProperties 中递归列出。例如查看 fill 后从 subProperties 读取 image。编辑类型不能代替持久化格式说明，赋值前应读取对应 DTS。\n\ncoverage.status 为 partial；coverage.limitations 说明可能缺少的属性及适用限制，不计算条件或动态候选值。source.content 在实例查询时为 server，在类型查询时为 none。\n\nreferences[] 提供 DTS 阅读命令 readDocument 和类型符号 symbol；purpose=metadata 用于核对元数据赋值，declaration 用于理解查询声明，两者不能互换。阅读命令使用本次查询的服务器。本次查询不下载资料；local.available=true 时可读取 local.path 或搜索 local.root，否则执行 readDocument 获取并阅读资料。 member 是待查字段名，不保证该字段可持久化；表达式和运行期属性需核对相应运行接口。",
+	"cli.cmd.dev.componentProperty.target": "服务器页面路径，后缀为 spg、dash、rpt、fapp 或 afl；类型查询允许页面尚未创建。实例示例中的 /PROJECT/page.spg 和 componentId 须替换为已有页面路径和组件 ID。",
+	"cli.cmd.dev.componentProperty.identity": "必须且只能指定 --component 或 --component-type 中的一个，分别按组件 ID 或组件类型查询。",
+	"cli.cmd.dev.componentProperty.component": "已存在的服务器 SPG 或仪表板中的组件 ID。",
+	"cli.cmd.dev.componentProperty.componentType": "从 dev component list 获取与 kind 匹配的类型。仅查询类型定义，不读取页面正文。",
+	"cli.cmd.dev.componentProperty.kind": "类型类别；cellType 和 actionComponent 当前只支持类型查询。",
+	"cli.cmd.dev.componentProperty.usage": "set-property 返回非只读属性及显式禁用的属性，隐藏状态不影响候选；metadata 包含只读声明；expression 返回允许表达式读取的属性。",
+	"cli.cmd.dev.componentProperty.contains": "属性名称或当前语言标题的字面包含筛选。",
+	"cli.cmd.dev.componentProperty.property": "同一组件和用途的 component-property list 返回的精确顶层属性名；不支持 fill.image 这样的嵌套路径。查看 fill 的详情可获取其 image 子属性。",
+	"cli.out.property.coverage": "部分属性可能未列出，不计算条件或动态候选值。在当前命令后加 --json 查看 source 和 coverage.limitations；赋值格式请查对应 DTS。",
+	"cli.out.property.name": "属性名",
+	"cli.out.property.type": "编辑类型",
+	"cli.out.property.source": "来源",
+	"cli.cmd.dev.componentMethod.title": "组件方法",
+	"cli.cmd.dev.componentMethod.summary": "查询组件交互中可调用的方法",
+	"cli.cmd.dev.componentMethod.desc": "查找“执行命令”交互中可调用的组件方法，了解方法用途和参数。\n\n使用服务器组件定义，不读取本地未推送的页面。按组件 ID 查询时使用服务器已保存的页面；按类型查询不读取页面正文。查询不会执行方法。",
+	"cli.cmd.dev.componentMethod.list.summary": "列出组件交互中可调用的方法。",
+	"cli.cmd.dev.componentMethod.list.desc": "查找“执行命令”交互中可调用的组件方法，帮助选择要执行的操作。这里不包含组件对象的其他脚本方法。\n\n查询使用服务器组件定义和已保存页面，不读取本地未推送的修改。查询不会执行方法。",
+	"cli.cmd.dev.componentMethod.list.out": "ID 以 _ 开头的系统命令不列出。\n\n默认文本显示方法概览，使用 component-method show 查看参数详情；JSON 的 methods[] 包含方法声明和参数。methods[].id 用作执行命令动作的 command 值，不要把整个结果对象写入页面。\n\nmethods[].source 标明方法来源，便于核对对应组件定义；顶层 source 描述本次查询使用的服务器和页面。\n\nmethods[].parameters.status 为 declared 时，methods[].parameters.items 保留已声明参数及其可选的必填标记、静态枚举；空数组表示显式声明无参数，undeclared 不表示无需参数。methods[].availability.status 为 notEvaluated，仅保留启用条件；methods[].returns.status 为 undeclared，不表示返回 void。\n\ncoverage.status 为 partial；coverage.limitations 列出未覆盖部分，可能涉及扩展、单元格方法或嵌入页面命令。不验证浏览器当前状态，查到声明不保证当前可调用，筛选为空也不能证明不可调用。source.content 在实例查询时为 server，在类型查询时为 none。summary.hasMore=false 表示没有后续分页。\n\nreferences[] 提供 DTS 阅读命令 readDocument 和类型符号 symbol；purpose=metadata 用于核对元数据赋值，declaration 用于理解查询声明，两者不能互换。阅读命令使用本次查询的服务器。本次查询不下载资料；local.available=true 时可读取 local.path 或搜索 local.root，否则执行 readDocument 获取并阅读资料。",
+	"cli.cmd.dev.componentMethod.show.summary": "查看一个组件方法的用途和参数。",
+	"cli.cmd.dev.componentMethod.show.desc": "查看“执行命令”交互中指定方法的用途和参数，帮助配置动作。这里不包含组件对象的其他脚本方法。\n\n查询使用服务器组件定义和已保存页面，不读取本地未推送的修改。查询不会执行方法。",
+	"cli.cmd.dev.componentMethod.show.out": "默认文本显示方法基本信息和逐项参数列表；JSON 的 method.id 用作执行命令动作的 command 值。参数按参考资料中“执行命令动作的元数据”赋值，不把整个 method 或 parameters 对象写入页面。\n\nmethod.parameters.status 为 declared 时，method.parameters.items 包含参数名称、标题、说明和可用的 optionCaptions。参数的 options 保留字符串、数字和布尔原值，multiple 表示多选。items 为空表示显式声明无参数，undeclared 不表示无需参数；编辑控件类型不等同于参数数据类型。\n\nmethod.source 标明方法来源；顶层 source 描述本次查询使用的服务器和页面，source.content 在实例查询时为 server，在类型查询时为 none。\n\ncoverage.status 为 partial，coverage.limitations 列出未覆盖部分。method.availability.status 为 notEvaluated，method.availability.condition 存在时保留启用条件，不保证当前可调用；method.returns.status 为 undeclared，不表示返回 void。\n\nreferences[] 提供 DTS 阅读命令 readDocument 和类型符号 symbol；purpose=metadata 用于核对元数据赋值，declaration 用于理解查询声明，两者不能互换。阅读命令使用本次查询的服务器。本次查询不下载资料；local.available=true 时可读取 local.path 或搜索 local.root，否则执行 readDocument 获取并阅读资料。",
+	"cli.cmd.dev.componentMethod.target": "服务器页面路径，后缀为 spg、dash、rpt、fapp 或 afl；类型查询允许页面不存在。实例示例中的 /PROJECT/page.spg 和 componentId 须替换为已有页面路径和组件 ID。",
+	"cli.cmd.dev.componentMethod.identity": "必须且只能指定 --component 或 --component-type 中的一个，分别按组件 ID 或组件类型查询。",
+	"cli.cmd.dev.componentMethod.component": "已存在的服务器 SPG 或仪表板中的组件 ID。",
+	"cli.cmd.dev.componentMethod.componentType": "从 dev component list 获取的页面组件类型。仅查询类型定义，不读取页面正文。",
+	"cli.cmd.dev.componentMethod.contains": "命令 ID 或当前语言标题的字面包含筛选。",
+	"cli.cmd.dev.componentMethod.method": "同一组件的 component-method list 返回的精确命令 ID；不支持 ID 以 _ 开头的系统命令。",
+	"cli.out.method.id": "方法 ID",
+	"cli.out.method.coverage": "查询不会执行方法；参数说明可能不完整，实际赋值格式请查对应 DTS。",
+	"cli.out.method.undeclared": "未声明",
+	"cli.out.method.condition": "启用条件",
+	"cli.out.method.argsUndeclared": "参数未声明，不代表无需参数。",
+	"cli.out.method.noArgs": "已显式声明无参数。",
+	"cli.out.method.parameters": "参数列表",
+	"cli.out.method.required": "必填",
+	"cli.out.method.yes": "是",
+	"cli.out.method.no": "否",
+	"cli.out.method.description": "说明",
+	"cli.out.property.querySource": "查询来源: 服务器组件声明；目标: {target}；页面内容: {content}",
+	"cli.out.property.serverContent": "服务器已保存内容",
+	"cli.out.property.typeContent": "未读取（按类型查询）",
+	"cli.cmd.dev.componentEvent.title": "组件事件",
+	"cli.cmd.dev.componentEvent.summary": "查询组件可配置的交互事件",
+	"cli.cmd.dev.componentEvent.desc": "查询组件可配置的事件，帮助选择交互的触发方式。\n\n查询以服务器上的组件定义和已保存页面为准，不读取本地未推送的页面。查询不会触发事件或执行交互。",
+	"cli.cmd.dev.componentEvent.list.summary": "列出组件可配置的事件。",
+	"cli.cmd.dev.componentEvent.list.desc": "查找组件可配置的交互事件，例如单击、内容变化，帮助选择交互的触发方式。\n\n查询使用服务器组件定义和已保存页面，不读取本地未推送的修改。查询不会触发事件或执行交互。",
+	"cli.cmd.dev.componentEvent.list.out": "默认文本显示事件概览；JSON 的 events[] 包含声明及 bindingTemplate，events[].id 写入组件 events[] 中的 event 字段。用同一组件身份执行 component-event show 查看详情。\n\nsupportsEvents=false 表示该组件不支持配置交互，此时 events[] 为空。events[].source 提供事件来源，便于核对对应组件定义。\n\n实例查询的 configuredEvents.status 为 read，items 保留服务器组件上已有的事件及动作，包括未出现在候选中的事件，不受 --contains 筛选影响；类型查询为 notRead，不表示组件未配置事件。编辑时先保留已有配置，再合并目标事件，不能用候选清单覆盖组件 events[]。\n\ncoverage.status 为 partial，coverage.limitations 列出未覆盖部分；部分扩展事件和单元格事件可能未列出；不检查事件在当前页面状态下能否触发。事件参数类型未声明不表示没有参数，需查匹配版本的事件及动作类型资料。source.content 在实例查询时为 server，在类型查询时为 none。summary.hasMore=false 表示没有后续分页，筛选为空不能证明事件非法。\n\nreferences[] 提供 DTS 阅读命令 readDocument 和类型符号 symbol；purpose=metadata 用于核对元数据赋值，declaration 用于理解查询声明，两者不能互换。阅读命令使用本次查询的服务器。本次查询不下载资料；local.available=true 时可读取 local.path 或搜索 local.root，否则执行 readDocument 获取并阅读资料。",
+	"cli.cmd.dev.componentEvent.show.summary": "查看一个事件的说明和配置模板。",
+	"cli.cmd.dev.componentEvent.show.desc": "查看指定事件的说明和配置模板，帮助添加或修改组件交互。\n\n查询使用服务器组件定义和已保存页面，不读取本地未推送的修改。查询不会触发事件或执行交互。",
+	"cli.cmd.dev.componentEvent.show.out": "默认文本显示事件基本信息和配置位置；JSON 的 event.id 对应组件 events[] 中的 event 字段。event.bindingTemplate 是 {\"event\":\"<事件 ID>\",\"actions\":[]} 形式的新增骨架；根据动作类型资料填充 actions，再合并到目标组件，不能把整个查询结果写入页面，也不能用空 actions 覆盖已有动作。\n\n实例查询的 configuredEvents.status 为 read，items 仅包含该事件在服务器页面中的已有配置；类型查询为 notRead。编辑已有交互时以 items 为起点保留其他字段。event.originEvent、repeating、repeatingStrategy、startEvent 和 endEvent 仅在组件定义中提供时返回；repeatingStrategy 是事件声明的推荐值，不是实例最终生效策略。\n\nevent.parameters.status 为 undeclared 表示未提供事件参数类型，不代表无参数；配置时查阅对应事件和动作的类型资料。coverage.status 为 partial，coverage.limitations 说明可能缺少的事件和触发条件等限制。source.content 在实例查询时为 server，在类型查询时为 none。查询不能证明交互在浏览器中一定能触发，配置后仍需编译并验证实际效果。\n\nreferences[] 提供 DTS 阅读命令 readDocument 和类型符号 symbol；purpose=metadata 用于核对元数据赋值，declaration 用于理解查询声明，两者不能互换。阅读命令使用本次查询的服务器。本次查询不下载资料；local.available=true 时可读取 local.path 或搜索 local.root，否则执行 readDocument 获取并阅读资料。",
+	"cli.cmd.dev.componentEvent.target": "服务器页面路径，后缀为 spg、dash、rpt、fapp 或 afl；类型查询允许页面不存在。实例示例中的 /PROJECT/page.spg 和 componentId 须替换为已有页面路径及组件 ID。",
+	"cli.cmd.dev.componentEvent.identity": "必须且只能指定 --component 或 --component-type 中的一个，分别按组件 ID 或组件类型查询。",
+	"cli.cmd.dev.componentEvent.component": "服务器 SPG 或仪表板中的组件 ID。",
+	"cli.cmd.dev.componentEvent.componentType": "从 dev component list 获取的页面组件类型。仅查询类型定义，不读取页面正文。",
+	"cli.cmd.dev.componentEvent.contains": "事件 ID 或当前语言名称的字面包含筛选，不区分大小写；不筛选页面已有配置。",
+	"cli.cmd.dev.componentEvent.event": "同一组件的 component-event list 返回的精确事件 ID。",
+	"cli.out.event.id": "事件 ID",
+	"cli.out.event.binding": "新增配置位置：组件 events[]；event={0}，在 actions[] 中配置动作。",
+	"cli.out.event.parameters": "事件参数类型未声明，请查匹配版本的事件及动作类型资料。",
+	"cli.out.event.configured": "服务器已有事件配置：{0} 条（使用 --json 查看）。",
+	"cli.out.event.notRead": "按类型查询，未读取页面已有事件配置。",
+	"cli.out.event.coverage": "查询不会触发事件；添加 --json 查看配置模板和适用限制。",
+	"cli.cmd.dev.layout.title": "布局",
+	"cli.cmd.dev.layout.summary": "查询组件可用的布局与布局属性",
+	"cli.cmd.dev.layout.desc": "查询组件可用的布局及其属性，帮助安排容器和子组件的排列方式。\n\n可按组件类型查询，也可针对服务器 SPG 或仪表板中已有的组件查询。查询使用服务器定义和已保存页面，不读取本地未推送的修改。\n\n查询不会切换布局或修改页面。",
+	"cli.cmd.dev.layout.list.summary": "列出组件可用的布局。",
+	"cli.cmd.dev.layout.list.desc": "查找组件可用的布局，帮助选择容器内组件的排列方式。\n\n可选布局随组件和页面类型变化，组件明确限定的布局优先。默认情况下，SPG 画布提供 flex，仪表板画布提供 tile、ppt、gravity；普通容器提供服务器可用的布局。\n\n查询使用服务器定义和已保存页面，不读取本地未推送的修改，也不切换布局或修改页面。",
+	"cli.cmd.dev.layout.list.out": "默认文本列出布局 ID、名称以及是否提供详情；JSON 的 layouts[] 包含 id、caption、definitionAvailable 和可选的 description。使用同一组件身份、布局属性和返回的 id 执行 dev layout show。definitionAvailable=false 表示服务器未提供该布局的定义，需先核对对应扩展，不能据此确认可以正常使用。\n\nselection.property 是需要写入的布局属性名。selection.currentValue 是服务器实例的配置或定义默认值，currentSource 为 server、default 或 none，none 时省略 currentValue；defaultValue 不表示必须写入。按类型查询不能获知实例当前布局。context.isCanvas 表示按画布规则查询；类型 canvas 按目标页面画布处理，实例则以其在页面中的实际位置为准。\n\nselection.status=available 表示可查询该属性的候选；unsupported 表示组件没有布局选择属性；unresolved 表示无法确定此属性的动态候选。空结果的 empty.reason 分别为 noLayoutProperty、unresolvedOptions、noMatches 或 emptyCollection。summary.hasMore=false 表示没有后续分页。\n\ncoverage.status 为 partial，coverage.limitations 说明未覆盖的扩展或依赖页面状态的配置；不计算条件和自定义动态候选。source.content 在实例查询时为 server，在类型查询时为 none。候选不保证布局效果符合页面需求，修改后仍需编译并验证。\n\nreferences[] 提供 DTS 阅读命令 readDocument 和类型符号 symbol；purpose=metadata 用于核对元数据赋值，declaration 用于理解查询声明，两者不能互换。阅读命令使用本次查询的服务器。本次查询不下载资料；local.available=true 时可读取 local.path 或搜索 local.root，否则执行 readDocument 获取并阅读资料。",
+	"cli.cmd.dev.layout.show.summary": "查看布局的容器属性和子组件属性。",
+	"cli.cmd.dev.layout.show.desc": "查看布局属性及其写入位置，帮助配置容器和子组件的尺寸、间距与位置。\n\n查询使用服务器定义和已保存页面，不读取本地未推送的修改。查询不会切换布局，也不会迁移已有组件的位置和尺寸。",
+	"cli.cmd.dev.layout.show.out": "默认文本分别列出容器属性和子组件属性；JSON 的 layout.id 为布局 ID，layout.properties[] 中的属性写到容器自身，layout.childProperties[] 中的属性写到该容器的直接子组件。两组属性均提供 name、caption 和编辑类型 type；默认值、静态选项及子属性仅在有定义时返回。options 保留原始值的类型，valueProvider 仅说明动态选项来源，不提供计算结果。空数组表示未提供对应属性；编辑控件类型不能代替实际 JSON 值格式。\n\nlayout.assignment 是选择此布局的最小赋值片段，例如 {\"layoutType\":\"flex\"}；合并到目标容器，保留原有内容，不把整个 layout 或查询结果写入页面。layout.capabilities 的 drag、drop、group 分别表示布局支持拖动、新增拖放和成组，不保证当前页面状态下可执行。\n\nselection.property 指明布局属性；currentValue 及 currentSource 区分服务器配置、定义默认值和未提供；currentSource=none 时省略 currentValue。按类型查询不返回实例当前值。默认值仅供参考，不要求全部写入。\n\ncoverage.status 为 partial；不计算条件或动态选项，不验证具体子组件的尺寸约束。已有子组件可按 ID 查询 component-property list --usage=metadata 核对服务器已保存布局下的属性；该结果不反映本地尚未推送的新布局。绝对定位的子组件可能使用不同的布局属性。切换已有布局时应同时检查容器属性、子组件位置和尺寸，不能仅修改布局 ID 就认定完成。source.content 在实例查询时为 server，在类型查询时为 none；完成后编译并验证实际排列效果。\nreferences[] 提供对应布局及通用 DTS 的阅读命令 readDocument 和类型符号 symbol；阅读命令使用本次查询的服务器。本次查询不下载资料。local.available=true 时可读取 local.path 或搜索 local.root；否则执行 readDocument 获取并阅读资料。TypeMap[布局 ID] 对应容器属性，ChildTypeMap[布局 ID] 对应直接子组件属性。",
+	"cli.cmd.dev.layout.identity": "必须且只能指定 --component 或 --component-type 中的一个，分别按组件 ID 或组件类型查询。",
+	"cli.cmd.dev.layout.component": "服务器 SPG 或仪表板中已有的容器组件 ID；画布也可以按 ID 查询。",
+	"cli.cmd.dev.layout.componentType": "从 dev component list 或 dev component show 确认的页面组件类型；canvas 表示目标页面画布。仅查询类型定义，不读取页面正文。",
+	"cli.cmd.dev.layout.property": "布局属性名，可从 dev component show 的 layoutProperties 获取；仅有一个时自动选择，存在多个时必须指定。",
+	"cli.cmd.dev.layout.contains": "布局 ID 或当前语言名称的字面包含筛选，不区分大小写。",
+	"cli.cmd.dev.layout.layout": "同一组件及布局属性的 dev layout list 返回的精确布局 ID。",
+	"cli.cmd.dev.layout.target": "服务器页面路径，后缀为 spg、dash、rpt、fapp 或 afl；按类型查询允许页面尚未创建。实例示例中的 /PROJECT/page.spg 和 componentId 须替换为已有页面路径及容器组件 ID。",
+	"cli.out.layout.id": "布局 ID",
+	"cli.out.layout.definition": "提供详情",
+	"cli.out.layout.default": "默认值",
+	"cli.out.layout.properties": "写到容器上的属性",
+	"cli.out.layout.childProperties": "写到直接子组件上的属性",
+	"cli.out.layout.noProperties": "未提供属性。",
+	"cli.out.layout.assignment": "布局赋值：{0}={1}，写到目标容器。",
+	"cli.out.layout.containerType": "容器属性类型",
+	"cli.out.layout.childType": "直接子组件属性类型",
+	"cli.out.layout.referenceNote": "本次查询只检查本地资料；下列阅读命令已绑定目标服务器，资料缺失时会准备到 Home。",
+	"cli.out.layout.showNote": "查询不会迁移已有位置和尺寸；结合类型资料配置，编译后验证排列效果。添加 --json 查看完整选项和限制。",
+	"cli.out.layout.listNote": "添加 --json 查看布局属性名、当前配置来源和限制；用 dev layout show 查看选定布局的属性。",
+	"cli.out.layout.empty.noLayoutProperty": "该组件没有布局选择属性。",
+	"cli.out.layout.empty.unresolvedOptions": "此布局属性的动态候选暂无法确定，请结合类型资料和设计器确认。",
+	"cli.out.layout.empty.noMatches": "没有匹配的布局。",
+	"cli.out.layout.empty.emptyCollection": "该属性没有布局候选。",
+	"cli.cmd.resContext.component": "服务器 SPG 或仪表板中的组件 ID。查询已保存内容，不读取本地未推送的修改。",
+	"cli.cmd.resContext.componentType": "组件或单元格类型；配合目标页面位置查询声明，所属类别由 --kind 指定。",
+	"cli.cmd.resContext.kind": "类型所属类别；省略为 component。cellType 仅支持按类型查询。",
+	"cli.cmd.resContext.property": "与当前资源类别匹配的选择器属性路径。省略时自动选择唯一匹配位置；存在多个位置时须明确选择。子属性路径用于定位选择器，保存值的格式仍以所属顶层属性的持久化类型为准。",
+	"cli.cmd.resContext.identity": "不指定身份时查询资源目录；组件属性查询使用服务器页面路径。--property 和 --kind 需要组件身份。示例中的 /PROJECT/page.spg 和 componentId 需替换为已有页面及组件 ID。",
+	"cli.cmd.resContext.styleIdentity": "不指定组件身份时查询风格目录；--property 和 --kind 须配合 --component 或 --component-type 使用。按组件 ID 查询须提供服务器页面路径。示例中的 /PROJECT/page.spg 和 componentId 须替换为已有页面路径及组件 ID。",
+	"cli.out.property.readonly": "只读",
+	"cli.out.property.expressionAccessible": "表达式可读",
+	"cli.out.property.enable": "启用",
+	"cli.out.property.visible": "属性栏可见",
+	"cli.out.property.options": "静态选项",
+	"cli.out.property.value": "值",
+	"cli.out.property.noOptions": "未提供静态选项。",
+	"cli.out.property.children": "子属性",
+	"cli.out.property.conditions": "启用或显示条件尚未计算；实际状态取决于页面。",
+	"cli.out.property.dynamic": "动态选项未计算；添加 --json 查看声明。",
+	"cli.out.property.composite": "复合值，添加 --json 查看。",
+	"cli.out.property.default": "默认值",
+	"cli.cmd.dev.color.title": "颜色",
+	"cli.cmd.dev.color.summary": "查询可用颜色及主题引用",
+	"cli.cmd.dev.color.desc": "列出主题纯色、渐变色和标准色，获取可用于页面元数据的颜色引用。",
+	"cli.cmd.dev.color.list.summary": "列出可用颜色及其主题引用。",
+	"cli.cmd.dev.color.list.desc": "按用途分组列出主题纯色、渐变色和标准色，帮助选择页面的文字、填充、边框及系列配色。\n\n读取服务器已保存的页面与主题，不修改页面。返回预设颜色，不枚举任意自定义色值，也不反映运行时外部主题覆盖；渐变是否可用取决于目标属性。主题缺失或无权读取时失败。",
+	"cli.cmd.dev.color.list.target": "文件所属的服务器项目名、应用绝对路径，或已有页面的绝对路径（spg、dash、rpt、fapp）；不是本地路径。新建文件时可指定所属项目或应用。\n省略时查询指定系统主题的默认颜色。将示例中的 /PROJECT/home.spg 替换为已有页面，将 /PROJECT/app/demo.app 替换为实际应用。",
+	"cli.cmd.dev.color.list.theme": "主题名称，来自 dev theme list 的 name。页面省略时读取 settings.theme，未配置时采用 default；系统、项目和应用位置必须指定。显式指定时不读取页面正文。\n省略目标位置时也必须指定主题。",
+	"cli.cmd.dev.color.list.type": "仅返回纯色或渐变；省略时返回两种类型。",
+	"cli.cmd.dev.color.list.group": "仅返回一个颜色分组；colorPrimary 为品牌，gradient 为主题渐变，standard 为固定标准色。与 --type 同时指定时取交集。",
+	"cli.cmd.dev.color.list.out": "--json 返回 theme（name、location、selection）、colors[]、missingTokens[] 和 filters。theme.selection 为 explicit（显式指定）、page（页面配置）或 default（页面未配置）。location 为实际主题来源，system 表示系统主题。文本输出显示分组、类型、名称、引用值和解析值。\n\ncolors[] 包含 group、groupCaption、caption、type（pure/gradient）、source（theme/standard）、value、resolvedValue；主题颜色还有 themeVar。value 是 ColorString 持久化值，例如 colorPrimary、gradientColor1 或 #C00400，可赋给 DTS 声明为 ColorString 的属性。resolvedValue 是编译后的 CSS 纯色或渐变定义，仅供预览，不应替代主题引用；其他属性结构须按目标 DTS 转换。\n\nmissingTokens[] 列出本次筛选范围内主题缺失的变量，对应颜色不输出。颜色为空时返回 colors=[] 和 empty.reason=noMatches，退出码仍为 0。JSON 返回成功不代表页面视觉效果已验证。\n\nqueryScope.kind 为 system、target 或 global，分别表示系统、指定位置及全局目录；message 说明范围，limitations[] 给出稳定 code 和本地化 message。系统查询的 targetQuery.argvTemplate 是待替换位置的调用模板（不含程序名），placeholders 声明必须替换的 <target>；不能原样执行。空结果仍保留范围；系统查询同时保留位置导航。--pretty-json 仅改变排版。",
+	"cli.out.color.group": "分组",
+	"cli.out.color.type": "类型",
+	"cli.out.color.name": "名称",
+	"cli.out.color.value": "引用值",
+	"cli.out.color.resolved": "解析值",
+	"cli.ref.colorValue": "颜色持久化值类型",
+	"cli.out.color.missing": "主题缺失变量（已跳过）：{0}",
+	"cli.cmd.dev.colorPalette.title": "色板",
+	"cli.cmd.dev.colorPalette.summary": "查询可用主题色板",
+	"cli.cmd.dev.colorPalette.desc": "列出主题中的色板及有序配色，帮助选择图表系列的颜色组合。",
+	"cli.cmd.dev.colorPalette.list.summary": "列出色板 ID、名称和有序配色。",
+	"cli.cmd.dev.colorPalette.list.desc": "列出指定位置可用的主题色板，帮助选择图表系列的配色方案。每个色板包含一组有序颜色，可以同时包含纯色和渐变色。\n\n只读取服务器已保存的页面和主题，不修改页面。查询不包含本地未推送修改、运行时外部主题覆盖或动态数据分配后的最终颜色；主题缺失、无权读取或目录格式错误时失败。",
+	"cli.cmd.dev.colorPalette.list.target": "文件所属的服务器项目名、应用绝对路径，或已有页面的绝对路径（spg、dash、rpt、fapp）；不是本地路径。新建文件时可指定所属项目或应用。\n省略时查询指定系统主题的默认色板。将示例中的 /PROJECT/home.spg 替换为已有页面，将 PROJECT 替换为实际项目名。",
+	"cli.cmd.dev.colorPalette.list.theme": "主题名称，来自 dev theme list 的 name。页面省略时读取 settings.theme，未配置时采用 default；系统、项目和应用位置必须指定。显式指定时不读取页面正文；同名主题按应用、项目、系统的顺序选择。\n省略目标位置时也必须指定主题。",
+	"cli.cmd.dev.colorPalette.list.out": "默认文本显示主题来源及色板 ID、名称、有序配色；渐变以 JSON 定义展示。--json 返回 theme（name、location、selection）和 colorPalettes[]。theme.selection 为 explicit（显式指定）、page（页面配置）或 default（页面未配置）；location 为实际主题来源，system 表示系统主题。\n\ncolorPalettes[] 包含 id、caption 和 paletteData。名称优先使用色板配置，否则使用当前语言名称，缺失时回退为 ID。paletteData 按色板定义的顺序保留服务器编译后的 CSS 纯色字符串和渐变对象；渐变对象包含 type、deg（线性渐变角度，可省略）和 value 色标数组，每个色标为 [颜色字符串, 0 到 1 的位置]。\n\n将 id 字符串赋给 DTS 声明为 ColorPaletteString 的属性，例如 \"colorPalette\": \"default1\"；不要把 caption、整个色板对象或 paletteData 写入该属性。其他属性结构仍以目标 DTS 为准。色板中的颜色已经解析，仅供比较配色；保留色板 ID 可让配色跟随主题变化。实际颜色分配由组件与数据决定，应用后仍需检查效果。\n\n主题未提供色板时返回 colorPalettes=[] 和 empty.reason=emptyCollection，退出码为 0。查询错误不会回退为部分目录。\n\nqueryScope.kind 为 system、target 或 global，分别表示系统、指定位置及全局目录；message 说明范围，limitations[] 给出稳定 code 和本地化 message。系统查询的 targetQuery.argvTemplate 是待替换位置的调用模板（不含程序名），placeholders 声明必须替换的 <target>；不能原样执行。空结果仍保留范围；系统查询同时保留位置导航。--pretty-json 仅改变排版。",
+	"cli.cmd.dev.colorPalette.list.empty": "当前主题没有可用色板。",
+	"cli.out.colorPalette.id": "色板 ID",
+	"cli.out.colorPalette.name": "名称",
+	"cli.out.colorPalette.colors": "有序配色",
+	"cli.ref.colorPaletteValue": "色板属性存储类型",
+	"cli.cmd.docs.title": "参考资料",
+	"cli.cmd.docs.summary": "发现、阅读和管理产品手册及服务器配套资料。",
+	"cli.cmd.docs.desc": "管理 SuccApp 产品手册、类型声明（DTS）和 JSON Schema，供本地查阅及 AI Agent 使用。\n\n手册来自官方手册站点，类型声明和 JSON Schema 与目标应用服务器配套。无需初始化工作区或克隆项目。",
+	"cli.cmd.docs.install.summary": "将官方文档 Skill 安装到指定目录，供 AI 客户端加载。",
+	"cli.cmd.docs.install.desc": "安装 succapp-docs 官方文档 Skill，提供 Markdown 正文、索引、配套附件和示例，供 AI Agent 查阅。\n\n无需业务服务器、登录或工作区。重复安装会更新受管理的资料文件并保留无关文件。",
+	"cli.cmd.docs.install.out": "output 是安装目录，entrypoint 是 SKILL.md 入口，均为本地绝对路径。complete=true 表示按资料索引完整安装，不包含图片和视频；status 为 installed、updated 或 up-to-date，分别表示首次安装、有更新或无需更新。安装成功不代表 Agent 已加载 Skill。\n\n成功后读取 entrypoint。通过 docs read/locate 阅读本次安装的资料时，将 output 作为 --directory 传入；默认读取不会自动发现任意安装目录。服务器 DTS 和 JSON Schema 通过 docs download 另行获取。",
+	"cli.cmd.docs.install.done": "Skill {0}：{1}",
+	"cli.cmd.docs.install.name": "官方 Skill 名称，目前仅支持 succapp-docs。",
+	"cli.cmd.docs.install.output": "Skill 最终目录；相对路径按执行目录（应用 -C 后）解析，也可传绝对路径。该目录包含 SKILL.md，需按所用 Agent 的约定指定。",
+	"cli.cmd.docs.install.force": "允许覆盖本地修改或同名冲突文件，保留无关文件。",
+	"cli.cmd.docs.list.summary": "按路径前缀查找索引中的手册、DTS 和 JSON Schema 文件。",
+	"cli.cmd.docs.list.desc": "按本地索引列出资料文件，帮助查找产品手册、类型声明和 JSON Schema。",
+	"cli.cmd.docs.locate.summary": "返回资料的本地绝对路径，供编辑器或本地工具读取。",
+	"cli.cmd.docs.locate.desc": "查找资料文件的本地位置与来源，便于使用编辑器或本地工具继续阅读和搜索。",
+	"cli.cmd.docs.read.summary": "直接输出资料正文；缺失的资料包自动下载到 Home。",
+	"cli.cmd.docs.read.desc": "输出资料文件的文本正文，供人或 AI Agent 阅读。\n\n支持 UTF-8 文本；二进制附件可获取本地位置后使用相应工具打开。",
+	"cli.cmd.docs.download.summary": "将手册或服务器配套资料下载到 ~/.succapp/，也可指定目录。",
+	"cli.cmd.docs.download.desc": "下载产品手册、类型声明和 JSON Schema，供本地查阅和离线使用。",
+	"cli.cmd.docs.update.summary": "更新 Home 中已下载的资料，也可指定待更新目录。",
+	"cli.cmd.docs.update.desc": "将已下载的本地资料更新到来源站点或服务器提供的最新内容，保留无关文件并检查本地修改冲突。",
+	"cli.cmd.docs.list.path": "资料包内的路径前缀，例如 guide/ai/analysis/。省略时列出手册；dev-types/ 和 json-schemas/ 分别选择目标服务器的声明和 Schema。",
+	"cli.cmd.docs.*.path": "资料包内的 POSIX 相对路径，例如 guide/ai/README.md、dev-types/types/meta/file-types/query.d.ts；不接受绝对路径、URL 或 ..。读取 dev-types/ 或 json-schemas/ 需要选择目标服务器。",
+	"cli.cmd.docs.*.directory": "只读取指定资料根目录，不自动补齐或回退。服务器资料位于根目录的 dev-types/ 或 json-schemas/ 下。相对本地路径按应用 -C 后的执行目录解析。",
+	"cli.cmd.docs.*.offline": "禁止联网，资料缺失时返回错误。未指定此选项时，先复用工作区同源且可用的资料，再使用 Home 副本；缺失的资料包会下载到 Home，不修改工作区。",
+	"cli.cmd.docs.*.symbol": "附带需要查阅的 DTS 类型或成员名称，不截取正文。",
+	"cli.cmd.docs.*.anchor": "附带需要查阅的章节锚点，不含 #，不截取正文。",
+	"cli.cmd.docs.read.maxChars": "正文最多输出的字符数（JavaScript UTF-16 长度）；超出时标记截断并提供本地文件位置。",
+	"cli.cmd.docs.*.scope": "选择资料包，可重复或逗号分隔。manual 为官网文本手册、附件和示例，不含图片和视频；server 为目标服务器配套的完整 DTS 和 JSON Schema，两者一起下载和更新。all 表示两类资料，不能与其他值混用。",
+	"cli.cmd.docs.*.output": "资料根目录；默认手册位于 ~/.succapp/docs/manual，服务器资料位于 ~/.succapp/servers/<服务器>/support。相对路径按应用 -C 后的执行目录解析。",
+	"cli.cmd.docs.update.scope": "选择要更新的资料包，可重复或逗号分隔：manual 为官网手册，server 为目标服务器的完整 DTS 和 Schema，all 为两类资料且不能与其他值混用。省略时检查两类资料，跳过没有目标服务器的范围；显式选择 server 时需要目标服务器。未下载的范围跳过，没有可更新资料时返回错误。",
+	"cli.cmd.docs.update.output": "待更新的资料根目录；默认只更新 Home 中的资料，不自动选择工作区。手册位于 ~/.succapp/docs/manual，服务器资料位于 ~/.succapp/servers/<服务器>/support。相对路径按应用 -C 后的执行目录解析。",
+	"cli.cmd.docs.*.force": "允许覆盖本地修改，不允许改变资料目录绑定的来源。",
+	"cli.cmd.docs.list.out": "按本地索引列出，不逐个检查文件；entries[] 包含逻辑路径 relativePath 和本地绝对路径 path；count 为匹配文件数，0 表示没有匹配。root 是本地资料根目录，source 说明来源。获取目录后可以使用本地工具继续查阅。",
+	"cli.cmd.docs.locate.out": "relativePath 是逻辑资料路径；path 是本地文件绝对路径；root 是资料根目录；source.kind 为 manual 或 server，source.url 为来源。服务器资料的 source.version 是整套资料完成下载时的版本；旧缓存无法确认完整版本时省略。读取不检查远端更新。symbol、anchor 是阅读提示。可直接读取 path，或在 root 中搜索。",
+	"cli.cmd.docs.read.out": "默认文本输出正文，并在末尾附上本地位置提示；--quiet 隐藏该提示。JSON 同时包含 relativePath、path、root 和 source，以及 content、truncated、totalChars。source 说明来源及整套服务器资料完成下载时的版本；旧缓存无法确认完整版本时省略。读取不主动检查远端更新。\n\ntruncated=true 表示正文被截断，需读取 path 指向的本地文件；totalChars 为完整正文的 UTF-16 长度。symbol、anchor 仅为定位提示，不表示正文已截取。可以在 root 中使用本地工具继续查阅。",
+	"cli.cmd.docs.download.out": "results[] 列出各类资料的准备结果，output 为本地绝对根目录；手册结果包含 entrypoint，服务器结果包含配套服务器版本 serverVersion、整套资料状态文件的本地绝对路径 statePath，以及两个资料目录 scopes[].path。completedScopes 为本次完成范围，complete=true 表示所选资料包已按索引完整准备；官网资料不包含图片和视频。\n\n使用自定义目录时，将对应结果的 output 作为 docs read/locate 的 --directory，读取本次下载的资料；服务器资料仍需选择相同目标服务器。\n\nmanual 与 server 分别处理；server 范围内的 DTS 与 JSON Schema 一起准备，整套成功后才记录新版本。失败返回非零退出码，错误 properties 中的 completedScopes、failedScopes、pendingScopes 和 results 区分部分成功；此前已完成的资料范围不会撤销。",
+	"cli.cmd.docs.update.out": "results[] 与 completedScopes 列出实际更新的资料范围及结果，skippedScopes 列出未准备或没有目标服务器而跳过的范围。服务器结果包含配套服务器版本 serverVersion 和整套资料状态文件的本地绝对路径 statePath。complete=true 表示已选中且已准备的资料均处理完成，不包括跳过的范围。\n\n默认更新 Home 不会改变工作区资料或默认读取优先级；需要读取本次更新的副本时，将对应 results[] 的 output 作为 docs read/locate 的 --directory 传入。\n\nmanual 与 server 分别处理；server 范围内的 DTS 与 JSON Schema 一起更新，整套成功后才记录新版本。失败返回非零退出码，错误 properties 中的 completedScopes、failedScopes、pendingScopes、skippedScopes 和 results 保留部分完成情况；此前已完成的资料范围不会撤销。",
+	"cli.docs.empty": "没有匹配的资料。",
+	"cli.docs.preparing": "正在准备本地资料：{0}",
+	"cli.docs.truncated": "正文已截断，请读取完整本地文件：{0}",
+	"cli.docs.localRoot": "本地资料目录：{0}。可在该目录中直接搜索和阅读。",
+	"cli.docs.localFile": "本地文件：\n  {0}\n资料目录：\n  {1}\n\n可直接读取文件，或在资料目录中搜索。",
+	"cli.docs.referenceLocal": "本地文件：{1}；资料目录：{0}。可直接读取或搜索。",
+	"cli.docs.referenceMissing": "当前服务器的默认资料目录：{0}。目标文件尚无可用本地副本；本次查询未下载资料，可用下列阅读命令获取。",
 	"cli.cmd.model.title": "模型",
 	"cli.cmd.model.summary": "查看和查询语义数据模型",
-	"cli.cmd.model.desc": "查看和查询 SuccApp 语义数据模型。",
+	"cli.cmd.model.desc": "查看和查询 SuccApp 语义数据模型。\n\n提供模型搜索、元数据与字段结构、索引声明、模型和字段画像，以及数据预览和 CSV 导出。支持单模型过滤、聚合和多模型关联。",
 	"cli.cmd.model.search.summary": "搜索语义模型。",
-	"cli.cmd.model.search.desc": "按完整路径，或按可组合的位置、模型属性和字段属性条件搜索可见的 .tbl 语义模型。",
+	"cli.cmd.model.search.desc": "搜索当前用户可见的 .tbl 语义模型，帮助找到适合分析任务的数据。\n\n支持按完整路径定位，也可组合位置、模型属性和字段属性条件搜索。结果受用户权限和返回数量限制。",
+	"cli.cmd.model.search.out": "results[] 按相关性排序，每项包含 model 模型摘要、fields[] 命中字段、score 得分和 matchedOn 匹配依据。后续命令使用 results[].model.path；fields[] 不是模型全部字段。\n\nsummary.returned 是返回模型数，summary.hasMore 表示仍有未返回的模型，summary.matchedFields 只统计已返回的命中字段。无匹配时 results=[]，empty.reason=noMatches。",
 	"cli.cmd.model.search.query": "以 '/' 开头时按完整模型路径或路径 glob 搜索；包含 '*' 或 '?' 时按模型文件名 glob 搜索；其他输入按关键词宽搜索模型属性或默认可见字段属性。",
 	"cli.cmd.model.search.path": "按模型元数据绝对路径 glob 搜索，项目根路径默认递归搜索；可以与关键词 <query> 组合，不能与路径型 <query>、--project、--parent-dir 或 --name 组合。",
 	"cli.cmd.model.search.name": "按模型文件名 glob 搜索；不含通配符时精确匹配。可以与关键词 <query>、--project、--parent-dir 组合，不能与 glob 型 <query> 或 --path 组合。",
 	"cli.cmd.model.search.parentDir": "递归搜索一个绝对目录范围，不支持 glob 通配符；只搜索直接子模型时使用 --path='/DIR/*'。与 --project 同时使用时，第一个路径段必须等于项目名。",
 	"cli.cmd.model.search.project": "精确匹配一个项目名，可与 --parent-dir 和 --name 组合。",
 	"cli.cmd.model.search.type": "匹配 Table.tableType。可重复使用或用逗号分隔，多个值按 OR 组合。",
-	"cli.cmd.model.search.contains": "要求模型名称、描述或物理表名匹配每个传入值（AND）：普通文本按忽略大小写的包含匹配；/pattern/flags 按正则匹配，支持 i（忽略大小写）、m（多行）和 g（仅兼容，无实际影响）。",
-	"cli.cmd.model.search.containsAny": "模型名称、描述或物理表名匹配任一传入值即可（OR）：普通文本按忽略大小写的包含匹配；/pattern/flags 按正则匹配，支持 i、m 和 g（仅兼容，无实际影响）。",
-	"cli.cmd.model.search.fieldContains": "要求字段名称、描述、物理名或关键字匹配每个传入值（AND）：普通文本按忽略大小写的包含匹配；/pattern/flags 按正则匹配，支持 i（忽略大小写）、m（多行）和 g（仅兼容，无实际影响）。",
-	"cli.cmd.model.search.fieldContainsAny": "字段名称、描述、物理名或关键字匹配任一传入值即可（OR）：普通文本按忽略大小写的包含匹配；/pattern/flags 按正则匹配，支持 i、m 和 g（仅兼容，无实际影响）。",
-	"cli.cmd.model.search.fieldMatch": "将字段文本匹配范围限定为 dim、measure 或 all，默认 all。",
+	"cli.cmd.model.search.contains": "要求模型名称、描述或物理表名匹配每个传入值（AND）：普通文本按忽略大小写的包含匹配；/pattern/flags 按正则匹配，支持 i（忽略大小写）、m（多行）和 g（仅兼容，无实际影响）。 多个值请重复传入同一选项；单个值中的逗号按原文匹配，不会拆分。",
+	"cli.cmd.model.search.containsAny": "模型名称、描述或物理表名匹配任一传入值即可（OR）：普通文本按忽略大小写的包含匹配；/pattern/flags 按正则匹配，支持 i、m 和 g（仅兼容，无实际影响）。 多个值请重复传入同一选项；单个值中的逗号按原文匹配，不会拆分。",
+	"cli.cmd.model.search.fieldContains": "要求字段名称、描述、物理名或关键字匹配每个传入值（AND）：普通文本按忽略大小写的包含匹配；/pattern/flags 按正则匹配，支持 i（忽略大小写）、m（多行）和 g（仅兼容，无实际影响）。 多个值请重复传入同一选项；单个值中的逗号按原文匹配，不会拆分。",
+	"cli.cmd.model.search.fieldContainsAny": "字段名称、描述、物理名或关键字匹配任一传入值即可（OR）：普通文本按忽略大小写的包含匹配；/pattern/flags 按正则匹配，支持 i、m 和 g（仅兼容，无实际影响）。 多个值请重复传入同一选项；单个值中的逗号按原文匹配，不会拆分。",
+	"cli.cmd.model.search.fieldMatch": "限定参与文本匹配的字段角色；dim 表示维度，measure 表示度量，all 表示全部角色（默认）。",
 	"cli.cmd.model.search.allFields": "让隐藏字段和扩展字段参与字段文本匹配。",
-	"cli.cmd.model.search.fieldLimit": "每个模型最多返回的命中字段数，默认 5，有效范围为 1 到 50。",
-	"cli.cmd.model.search.limit": "最多返回指定数量的最相关模型，默认 50，有效范围为 1 到 200。",
+	"cli.cmd.model.search.fieldLimit": "每个模型返回的命中字段数，省略时为 5。",
+	"cli.cmd.model.search.limit": "返回最相关模型的数量，省略时为 50。",
 	"cli.cmd.model.search.empty": "未找到匹配的模型。",
 	"cli.cmd.model.search.pathHint": "'{0}' 是精确模型路径。使用 '{1}' 递归搜索。",
 	"cli.cmd.model.search.nameHint": "没有通配符时模型名按精确值匹配，CLI 不会自动补通配符或 .tbl 后缀。",
 	"cli.cmd.model.search.hasMore": "仅显示最相关的 {0} 个模型；请增加项目、目录、类型或更准确的关键词来缩小范围。",
 	"cli.cmd.model.show.summary": "查看模型元数据摘要。",
-	"cli.cmd.model.show.desc": "查看语义模型元数据摘要。",
+	"cli.cmd.model.show.desc": "查看语义模型的元数据摘要，了解模型类型、字段数量和键声明。\n\n不查询模型数据行。",
+	"cli.cmd.model.show.out": "model 是模型摘要对象，含 path、tableType、fieldCount、primaryKeys 和 businessKeys 等；不是模型路径字符串。键和索引信息是元数据声明，不代表已验证数据唯一性。",
 	"cli.cmd.model.profile.summary": "获取单个语义模型画像。",
-	"cli.cmd.model.profile.desc": "返回模型摘要、当前版本完整元数据和物理表真实行数。human 输出保持简洁，使用 --json 获取完整元数据。",
+	"cli.cmd.model.profile.desc": "查看模型摘要、当前版本完整元数据和物理表真实行数。\n\n适用于了解模型整体结构与数据规模，不包含字段级统计分布。\n\n行数统计会访问数据源，可能受权限或连接状态影响。",
+	"cli.cmd.model.profile.out": "model 是模型摘要，fullMetadata 是当前版本完整元数据（succ.meta.dw.Table）。使用 --json 获取完整元数据；dataRowCount.value 为真实行数，dataRowCount.errorInfo 说明统计失败原因，缺失或失败不能当成 0。",
 	"cli.cmd.model.fieldProfile.summary": "获取指定模型字段画像。",
-	"cli.cmd.model.fieldProfile.desc": "查看指定字段、推断的分析角色、维属性和按需计算的数据统计。一次选择 1 到 20 个字段；解析到同一 fieldPath 的别名会自动去重。\n\n实际能力取决于字段类型、数据源、数据量、权限和脱敏设置。nullCount/nullRate 适用于可查询字段；数值字段可使用 distinctCount、minValue、maxValue、sum、avg、zeroCount、negativeCount、topValues 和 sampleValues；字符串和日期字段可使用 distinctCount、minValue、maxValue、topValues 和 sampleValues；布尔字段可使用 distinctCount、topValues 和 sampleValues。median、p90 和 p95 仅为协议兼容保留，当前返回 unsupported。请以 dataProfile.unavailableProperties 为准。数量级未知的模型只有在当前账号可见行数不超过 100,000 时才执行 distinctCount/topValues；百万级模型返回 costLimit。JSON 中 sum/avg 使用十进制字符串保留精度。",
-	"cli.cmd.model.fieldProfile.field": "字段物理名、业务名或 fieldPath。可重复传入，最多选择 20 个字段；等价名称按 fieldPath 去重。",
-	"cli.cmd.model.fieldProfile.dataProperty": "要计算的数据统计。可重复传入或用逗号分隔。可选值：nullCount、nullRate、distinctCount、minValue、maxValue、sum、avg、median、p90、p95、zeroCount、negativeCount、topValues、sampleValues。未传时计算 nullCount、nullRate、distinctCount、minValue 和 maxValue。",
+	"cli.cmd.model.fieldProfile.desc": "查看模型字段画像，帮助理解字段语义、分析角色、维属性和数据分布。\n\n支持只读结构信息或按需计算数据统计。实际能力取决于字段类型、数据源、数据量、权限和脱敏设置。\n\n数据统计可能扫描数据源并产生查询开销。",
+	"cli.cmd.model.fieldProfile.out": "fields[] 返回所选字段画像，以 fieldPath 为稳定标识；role/inferredRole 描述分析角色，dataProfile 包含请求的统计项。未返回的统计不代表 0，无法计算的项目见 fields[].dataProfile.unavailableProperties。以下 dimension、dimensionAttributes 和 dataProfile 都位于对应 fields[] 项中。\n\ndimension 描述关联维表和显示字段；dimensionAttributes[].fieldPath 提供维属性查询路径。topValues 返回原始值，不保证包含显示名称。\n\n实际能力取决于字段类型、数据源、数据量、权限和脱敏设置。nullCount/nullRate 适用于可查询字段；数值字段可使用 distinctCount、minValue、maxValue、sum、avg、zeroCount、negativeCount、topValues 和 sampleValues；字符串和日期字段可使用 distinctCount、minValue、maxValue、topValues 和 sampleValues；布尔字段可使用 distinctCount、topValues 和 sampleValues。median、p90 和 p95 仅为协议兼容保留，当前返回 unsupported。请以 dataProfile.unavailableProperties 为准。数量级未知的模型只有在当前账号可见行数不超过 100,000 时才执行 distinctCount/topValues；百万级模型返回 costLimit。JSON 中 sum/avg 使用十进制字符串保留精度。",
+	"cli.cmd.model.fieldProfile.field": "字段物理名、业务名或 fieldPath。可重复传入，最多选择 20 个字段；等价名称按 fieldPath 去重。\n\n至少选择一个字段。",
+	"cli.cmd.model.fieldProfile.dataProperty": "要计算的数据统计，可重复或逗号分隔。省略时计算 nullCount、nullRate、distinctCount、minValue 和 maxValue。",
 	"cli.cmd.model.fieldProfile.noData": "不扫描字段数据，只返回字段语义和维属性。不能与 --data-property 同时使用。",
-	"cli.cmd.model.fieldProfile.topN": "topValues 最大返回数量，默认 20，有效范围为 1 到 50。",
-	"cli.cmd.model.fieldProfile.sampleLimit": "sampleValues 最大返回数量，默认 10，有效范围为 1 到 50。",
-	"cli.cmd.model.fieldProfile.dimensionAttributeDepth": "维属性展开深度，默认 1，有效范围为 0 到 3。",
+	"cli.cmd.model.fieldProfile.topN": "topValues 最大返回数量，省略时为 20。",
+	"cli.cmd.model.fieldProfile.sampleLimit": "sampleValues 最大返回数量，省略时为 10。",
+	"cli.cmd.model.fieldProfile.dimensionAttributeDepth": "维属性展开深度，省略时为 1。",
 	"cli.cmd.model.fields.summary": "列出模型字段。",
-	"cli.cmd.model.fields.desc": "列出语义模型字段。",
+	"cli.cmd.model.fields.desc": "列出语义模型字段，帮助确定查询使用的字段及其类型。\n\n支持按字段属性和名称筛选，不计算字段统计分布。",
+	"cli.cmd.model.fields.out": "fields[] 返回字段信息：name 是稳定模型字段名，不保证在底层物理表存在同名列；计算、链接等字段须结合模型定义使用。表达式引用优先使用 expVarName，缺失时回退 name。dataType 是字段类型，dim 表示维键，hidden 表示隐藏字段。物理 SQL 的列名另按实际表结构核对，不能直接照抄全部模型字段。无匹配时 fields=[]，empty.reason=noMatches。",
 	"cli.cmd.model.fields.all": "包含隐藏字段和扩展属性。",
-	"cli.cmd.model.fields.contains": "按字段名、标题或物理字段匹配：普通文本按忽略大小写的包含匹配；/pattern/flags 按正则匹配，支持 i、m 和 g（仅兼容，无实际影响）。",
+	"cli.cmd.model.fields.contains": "按模型字段名、标题、说明或关键字匹配：普通文本按忽略大小写的包含匹配；/pattern/flags 按正则匹配，支持 i、m 和 g（仅兼容，无实际影响）。",
 	"cli.cmd.model.fields.dim": "仅列出维键字段。",
 	"cli.cmd.model.fields.measure": "仅列出度量字段。",
 	"cli.cmd.model.fields.empty": "未找到匹配的字段。",
 	"cli.cmd.model.indexes.summary": "列出模型索引。",
-	"cli.cmd.model.indexes.desc": "列出主键、业务键和模型索引。",
+	"cli.cmd.model.indexes.desc": "列出语义模型的主键、业务键和索引声明。\n\n声明不代表已经验证数据唯一性；命令不会创建或重建数据库索引。",
+	"cli.cmd.model.indexes.out": "indexes[] 返回索引声明，kind 区分键或索引类型，fields[] 是组成字段，unique 和 enabled 表示唯一性声明与启用状态。无索引时 indexes=[]，empty.reason=emptyCollection。",
 	"cli.cmd.model.indexes.empty": "该模型没有索引。",
 	"cli.cmd.model.*.select": "查询字段，多个字段用逗号分隔，可重复传入。",
-	"cli.cmd.model.*.maxRows": "最大预览行数。",
-	"cli.cmd.model.*.query": "Query DSL JSON。",
-	"cli.cmd.model.*.queryFile": "从文件读取 Query DSL JSON。",
-	"cli.cmd.model.*.stdin": "从标准输入读取 Query DSL JSON。",
-	"cli.cmd.model.select.summary": "查询单个模型数据。",
-	"cli.cmd.model.select.desc": "使用 SuccApp 表达式过滤条件查询单个 .tbl 模型。",
-	"cli.cmd.model.select.where": "过滤表达式，例如 STATUS='ACTIVE'。",
+	"cli.cmd.model.*.maxRows": "最大预览行数。当前配套服务器默认 100、上限 1000；实际以目标服务器为准。",
+	"cli.cmd.model.*.model": "model search 返回的 .tbl 模型路径，例如 /DEMO/data/tables/customer.tbl。",
+	"cli.cmd.model.select.summary": "查询服务器上单个模型的数据。",
+	"cli.cmd.model.select.desc": "查询服务器上单个 .tbl 模型的数据，适合查看明细记录和核对数据样例。\n\n使用 SuccApp 表达式进行筛选和排序。查询采用服务器已保存的模型定义，不读取或上传本地未同步的 .tbl 内容。\n\n返回结果受目标服务器的预览行数限制，不能据此判断完整数据或总量。",
+	"cli.cmd.model.select.out": "JSON 关键输出示例（省略公共结果字段，注释仅供说明，实际输出为严格 JSON）：\n    {\n      \"model\": \"/project/data/orders.tbl\",  // 目标模型路径\n      \"result\": {                           // 查询结果\n        \"fields\": [                         // 字段定义，数组顺序就是列顺序\n          {\n            \"name\": \"id\",                   // 对应 rows 中记录的键\n            \"dataType\": \"string\",           // 数据类型\n            \"sqlType\": \"VARCHAR\"            // SQL 类型，可选\n          }\n        ],\n        \"rows\": [                           // 记录数组；空结果为 []\n          {\n            \"id\": \"A001\"                    // 按实际 JSON 类型读取，区分 null 和 \"\"\n          }\n        ],\n        \"rowCount\": 1,                      // 返回行数，不是总量；缺失时读 result.rows.length\n        \"maxRows\": 100,                     // 实际预览上限，可选\n        \"truncated\": false,                 // 是否因预览上限截断，可选\n        \"elapsedMs\": 12,                    // 耗时，单位毫秒，可选\n        \"timeoutMs\": 30000                  // 超时，单位毫秒，可选\n      }\n    }\n\ntruncated 缺失时不能推断为 false；即使为 false，查询自身的行数限制仍然生效。",
+	"cli.cmd.model.select.where": "过滤表达式，例如 STATUS='ACTIVE'。\n\n使用 SuccApp 表达式，不是一条 SQL。此选项过滤查询结果，不给模型参数赋值；带参数查询使用 model query 的来源参数设置。",
 	"cli.cmd.model.select.order": "排序表达式，例如 CREATE_TIME desc。",
-	"cli.cmd.model.select.limit": "最大返回行数。",
-	"cli.cmd.model.query.summary": "使用 Query DSL 查询模型。",
-	"cli.cmd.model.query.desc": "使用 Query DSL JSON 查询一个或多个 .tbl 模型。\n\nJSON 类型：query.d.ts 中的 succ.meta.dw.Query。\n在线 DTS：https://docs.succapp.com/dev-types/types/meta/file-types/query.d.ts\n当前 workspace DTS：.agents/skills/succapp-docs/dev-types/types/meta/file-types/query.d.ts",
+	"cli.cmd.model.query.summary": "在服务器的语义层执行复杂数据查询。",
+	"cli.cmd.model.query.desc": "在服务器的语义层执行复杂数据查询，查询对象为一个或多个 .tbl 模型。\n\n支持明细查询、字段计算、条件筛选、排序、分组汇总、多模型关联，以及向来源模型传参。使用 Query DSL 组织所需的查询逻辑，字段计算和条件使用 SuccApp 表达式。\n\n按路径或 ID 引用的模型采用服务器已保存的定义；查询文件描述查询请求，不是待运行的本地 .tbl 文件。\n\n查询不写入模型数据，返回结果受目标服务器的预览行数限制。",
+	"cli.cmd.model.query.out": "JSON 关键输出示例（省略公共结果字段，注释仅供说明，实际输出为严格 JSON）：\n    {\n      \"result\": {                          // 查询结果\n        \"fields\": [                        // 字段定义，数组顺序就是列顺序\n          {\n            \"name\": \"id\",                  // 输出字段名；指定 alias 时按别名读取\n            \"dataType\": \"string\",          // 数据类型\n            \"sqlType\": \"VARCHAR\"           // SQL 类型，可选\n          }\n        ],\n        \"rows\": [                          // 记录数组；空结果为 []\n          {\n            \"id\": \"A001\"                   // 按实际 JSON 类型读取，区分 null 和 \"\"\n          }\n        ],\n        \"rowCount\": 1,                     // 返回行数，不是总量；缺失时读 result.rows.length\n        \"maxRows\": 100,                    // 实际预览上限，可选\n        \"truncated\": false,                // 是否因预览上限截断，可选\n        \"elapsedMs\": 12,                   // 耗时，单位毫秒，可选\n        \"timeoutMs\": 30000                 // 超时，单位毫秒，可选\n      }\n    }\n\ntruncated 缺失时不能推断为 false；即使为 false，查询自身的行数限制仍然生效。",
 	"cli.cmd.model.query.empty": "查询成功，返回 0 行。",
+	"cli.cmd.model.query.maxRows": "最大预览行数；当前配套服务器默认 100、上限 1000。",
+	"cli.cmd.model.query.input": "--query、--query-file、--stdin 必须且只能选择一种。\n\n输入结构为 succ.meta.dw.Query；使用严格 JSON，键名和字符串用双引号，不支持注释或尾随逗号。字段与条件使用 SuccApp 表达式，相关指南见参考资料。复杂内容优先使用文件或标准输入。\n\n完整结构、来源模型传参与查询参数声明见参考资料中的 Query DTS。\n\n省略 groupFields 且没有字段设置 group:true 时表示明细查询，设置为 [] 表示全表汇总。\n\n最小输入示例（模型路径和 ID 字段需替换为已确认存在且有权限的实际值；可保存为 query.json）：\n    {\n      \"sources\": [\"/DEMO/data/tables/customer.tbl\"],\n      \"fields\": [{ \"alias\": \"id\", \"exp\": \"ID\" }],\n      \"options\": { \"limit\": 10 }\n    }",
+	"cli.cmd.model.query.query": "直接传入 Query DSL JSON 对象。",
+	"cli.cmd.model.query.queryFile": "UTF-8 Query DSL JSON 文件。",
+	"cli.cmd.model.query.stdin": "从标准输入读取 Query DSL JSON。",
 	"cli.cmd.model.export.summary": "将模型查询结果导出为 CSV。",
-	"cli.cmd.model.export.desc": "将单模型或 Query DSL 查询结果导出为 CSV。",
-	"cli.cmd.model.export.where": "单模型导出的过滤表达式。",
+	"cli.cmd.model.export.desc": "将单模型或 Query DSL 查询结果导出为本地 CSV 文件。\n\n支持单模型的字段选择、过滤和排序，以及聚合和关联查询；结果受查询条件、DSL 能力和访问权限约束。\n\n操作会写入本地文件，不修改模型数据。",
+	"cli.cmd.model.export.out": "JSON 关键输出示例（省略公共结果字段，注释仅供说明，实际输出为严格 JSON）：\n    {\n      \"model\": \"/project/data/orders.tbl\",  // 单模型方式；DSL 方式改为 \"query\": true\n      \"output\": \"/work/orders.csv\",         // 本地绝对路径，CSV 内容写入此文件\n      \"size\": 128                           // 文件大小，单位字节\n    }\n\n当前配套服务器生成 UTF-8、无 BOM、逗号分隔、LF 换行的 CSV。含逗号、双引号或换行的字段用双引号包围，内部双引号重复，例如 中文,\"引号\" 写成 \"中文,\"\"引号\"\"\"。null 与空字符串都可能为空字段，不能据此恢复类型。首行是查询结果字段名；二进制值是长度标签，不包含原始内容。",
+	"cli.cmd.model.export.where": "单模型导出的 SuccApp 过滤表达式，不是一条 SQL；Query DSL 模式不生效。",
 	"cli.cmd.model.export.order": "单模型导出的排序表达式。",
-	"cli.cmd.model.export.output": "把 CSV 输出写入本地文件。",
-	"cli.cmd.model.export.force": "输出文件已存在时允许覆盖。",
+	"cli.cmd.model.export.output": "CSV 输出的本地文件；覆盖已有文件需要 --force。",
+	"cli.cmd.model.export.force": "允许覆盖已存在的本地输出文件。",
 	"cli.cmd.model.export.exportedData": "已导出数据到 {0}",
+	"cli.cmd.model.export.input": "<model>、--query、--query-file、--stdin 必须且只能选择一种输入。--select、--where、--order 仅在单模型方式生效。\n\nQuery DSL 输入结构为 succ.meta.dw.Query；使用严格 JSON，键名和字符串用双引号，不支持注释或尾随逗号。复杂内容优先使用文件或标准输入。\n最小输入示例（模型路径和 ID 字段需替换为已确认存在且有权限的实际值；可保存为 query.json）：\n    {\n      \"sources\": [\"/DEMO/data/tables/customer.tbl\"],\n      \"fields\": [{ \"alias\": \"id\", \"exp\": \"ID\" }],\n      \"options\": { \"limit\": 10 }\n    }",
+	"cli.cmd.model.export.query": "直接传入 Query DSL JSON 对象。",
+	"cli.cmd.model.export.queryFile": "UTF-8 Query DSL JSON 文件。",
+	"cli.cmd.model.export.stdin": "从标准输入读取 Query DSL JSON。",
+	"cli.cmd.model.export.model": "model search 返回的 .tbl 模型路径，例如 /DEMO/data/tables/customer.tbl。",
+	"cli.cmd.server.schedule.title": "系统计划",
+	"cli.cmd.server.schedule.summary": "管理系统计划及分类。",
+	"cli.cmd.server.schedule.desc": "直接管理所选服务器上的系统计划任务；不需要本地工作区或项目参数。",
+	"cli.cmd.server.schedule.*.name": "按名称包含文本筛选。",
+	"cli.cmd.server.schedule.*.enabled": "仅查询已启用计划；与 --disabled 互斥。",
+	"cli.cmd.server.schedule.*.disabled": "仅查询已停用计划；与 --enabled 互斥。",
+	"cli.cmd.server.schedule.*.categoryId": "按分类 id 筛选，不是分类管理模式。",
+	"cli.cmd.server.schedule.*.resource": "已有服务器资源绝对路径，先解析为元数据 id。",
+	"cli.cmd.server.schedule.*.state": "英文逗号分隔的状态集合，去除空白及重复值；不能重复传参。UNKNOWN 未开始或未知、WAITING 等待、RUNNING 运行中、SUCCESS 成功、ERROR 错误、TIMEOUT 超时、SKIP 跳过、BLOCK 阻塞、CANCEL 取消。",
+	"cli.cmd.server.schedule.*.offset": "匹配记录的偏移。",
+	"cli.cmd.server.schedule.*.limit": "每页匹配记录的条数。",
+	"cli.cmd.server.schedule.*.force": "确认删除指定对象；不绕过服务器权限或运行状态限制。",
+	"cli.cmd.server.schedule.*.retry": "历史计划运行 id，重试其中失败或阻塞的任务。",
+	"cli.cmd.server.schedule.*.ignoreTaskCondition": "显式忽略任务执行条件；默认遵守。",
+	"cli.cmd.server.schedule.*.run": "精确计划运行 id，与 --latest 互斥。",
+	"cli.cmd.server.schedule.*.latest": "仅定位一次最近运行，不证明与上一次执行请求相关。",
+	"cli.cmd.server.schedule.*.startTime": "startTime >= 指定日期时间（如 2026-10-23 12:34:56.789，也接受毫秒值），包含下界。 无偏移字符串按服务器时区解释。",
+	"cli.cmd.server.schedule.*.endTime": "endTime < 指定日期时间（如 2026-10-23 12:34:56.789，也接受毫秒值），排除上界和未结束记录；不是开始时间窗口。 无偏移字符串按服务器时区解释。",
+	"cli.cmd.server.schedule.*.minDuration": "秒；单独指定为 >=；与 max 同时指定时使用包含两端的 between。",
+	"cli.cmd.server.schedule.*.maxDuration": "秒；单独指定为 <；与 min 同时指定时使用包含两端的 between。",
+	"cli.cmd.server.schedule.list.summary": "查询系统计划或计划分类。",
+	"cli.cmd.server.schedule.list.desc": "根据名称、启用状态、分类或引用资源查找系统计划，供后续查看、修改和执行。\n\n需要登录并具有系统计划查看权限；按资源筛选时还需对应资源的查看权限。",
+	"cli.cmd.server.schedule.list.out": "schedules 为 ScheduleQueryInfo 数组，组合当前配置、查询附加信息和最近关联运行的字段；categories 为 ScheduleCategory 数组。当前配置可能已在该次运行后修改；totalCount 为匹配总数。\n\n人类输出为摘要，完整字段使用 --json 或 --pretty-json 查看。身份、计数、结果状态和时间单位见完整查询对象及运行信息参考。准确筛选可能读取全部匹配数据，运行中数据不保证快照一致性；日期字符串包含服务器时区偏移。",
+	"cli.cmd.server.schedule.list.category": "查询分类列表的布尔开关，不是分类 id。默认查询计划；指定此开关时返回完整分类列表，不接受计划筛选条件。",
+	"cli.cmd.server.schedule.show.summary": "查看计划或计划分类配置。",
+	"cli.cmd.server.schedule.show.desc": "读取指定计划或计划分类自身配置，供检查配置或准备更新输入。\n\n读取不会启动计划。任务配置使用 server task list 查询，运行记录使用 server schedule history 查询。\n\n需要登录并具有目标计划或计划分类的查看权限。",
+	"cli.cmd.server.schedule.show.out": "schedule 为 ScheduleQueryInfo，组合当前配置和最近关联运行；category 为 ScheduleCategory。当前配置不是执行时快照。提取该对象保存为 JSON 后交给 update，不提交整个结果信封；目标不存在时报错。提取方式见示例；修改保存的 schedule-patch.json 后，使用 server schedule update --schedule=./schedule-patch.json --json 回写。\n\n人类输出展示业务设置及可用的任务数、创建修改信息和运行状态，完整字段使用 --json 或 --pretty-json 查看。日期字符串包含服务器时区偏移，回写时保留原值。",
+	"cli.cmd.server.schedule.show.schedule": "计划 id，与 --category 二选一，不可重复指定。",
+	"cli.cmd.server.schedule.show.category": "计划分类 id，与 --schedule 二选一。",
+	"cli.cmd.server.schedule.create.summary": "从 JSON 创建计划或计划分类。",
+	"cli.cmd.server.schedule.create.desc": "创建一个系统计划或计划分类。任务通过 server task create 添加。\n\n需要登录并具有系统计划管理权限。",
+	"cli.cmd.server.schedule.create.out": "id 为保存的对象 id；schedule 或 category 为回读的完整服务器对象。失败保留已确认效果，不自动重试。启用失败时保留已创建计划及已确认步骤。",
+	"cli.cmd.server.schedule.create.input": "UTF-8 JSON 对象文件或 - 表示 stdin；--schedule 与 --category 必须且只能选择一个。对象字段使用服务器驼峰名称；enableRetry 只接受 true/false 或数值 0/1，其他布尔配置按服务器规则转换。字段、类型及单位见 DTS。",
+	"cli.cmd.server.schedule.create.schedule": "必填 scheduleName，不传 scheduleId；scheduleType 支持 common/data/sub，默认 common；enabled 默认 false。配置周期执行的计划还应设置 scheduleType、cron 等业务配置，详见 DTS 中的 ScheduleInfo；任务另用 server task create 添加。可通过 enabled 指定创建时是否启用。",
+	"cli.cmd.server.schedule.create.category": "必填 caption；id 可省略（最多 32 字符）。",
+	"cli.cmd.server.schedule.update.summary": "从 JSON 局部修改计划或分类。",
+	"cli.cmd.server.schedule.update.desc": "调整计划调度、启用状态、分类，或修改计划分类名称。\n\n需要登录并具有目标计划的管理权限。",
+	"cli.cmd.server.schedule.update.out": "单项返回 id 和完整 schedule 或 category。批量 results 各项包含 id/status/schedule。确认未提交的业务拒绝会继续其他目标；连接、认证或未知提交状态时中止，其余目标为 notStarted。业务部分失败退出 1，CLI 用法或 JSON 语法错误退出 2，后端校验拒绝退出 1，网络/认证退出 5；无跨计划事务，不自动重试。",
+	"cli.cmd.server.schedule.update.input": "UTF-8 JSON 对象文件或 - 表示 stdin；--schedule 与 --category 必须且只能选择一个。省略字段不改；可提交接口字段局部修改或从 show/list 提取的完整接口对象，不提交结果信封。完整字段定义见 DTS 参考资料。更新先读再合并，不保证并发写入保护。",
+	"cli.cmd.server.schedule.update.schedule": "单项必填 scheduleId；也支持 {\"schedules\":[...]} 批量根对象，id 不重复，全部目标存在性预检后逐项由后端校验并写入。enabled:false 表示停用，不是翻转状态。 scheduleStartTime/scheduleEndTime 为 null 时清除对应日期，省略则保留。",
+	"cli.cmd.server.schedule.update.category": "必填 id、caption；只支持修改名称。",
+	"cli.cmd.server.schedule.run.summary": "执行整计划或重试历史运行。",
+	"cli.cmd.server.schedule.run.desc": "手动执行整个计划，或重试某次历史运行中的失败或阻塞任务。选定任务执行使用 server task run。\n\n执行可能修改业务数据。手动执行忽略计划时间和条件，任务条件默认仍遵守。请求不自动重试，成功只代表受理。\n\n需要登录并具有目标计划的使用权限。",
+	"cli.cmd.server.schedule.run.out": "accepted:true 仅表示请求受理，mode 为 schedule/retry；不返回新运行 id，需通过 history 核验实际运行，不支持 --wait。",
+	"cli.cmd.server.schedule.run.schedule": "目标计划的精确 id。 不支持 group 计划或含 workflow/sub/check/schedule 类型任务的计划。",
+	"cli.cmd.server.schedule.stop.summary": "中止计划当前运行。",
+	"cli.cmd.server.schedule.stop.desc": "请求中止正在运行的计划，保持启用状态不变。\n\n不撤销已经完成任务的效果，也不保证响应时所有任务已退出。\n\n需要登录并具有目标计划的使用权限。",
+	"cli.cmd.server.schedule.stop.out": "accepted 表示取消受理；受理不等于运行结束。",
+	"cli.cmd.server.schedule.stop.schedule": "目标计划的精确 id。",
+	"cli.cmd.server.schedule.history.summary": "查询计划运行记录。",
+	"cli.cmd.server.schedule.history.desc": "查询计划运行列表，或定位指定的一次运行。任务结果使用 server task history，依赖快照使用 server schedule dependencies，日志使用 server schedule logs/server task logs 查询。\n\n需要登录并具有目标计划的查看权限。",
+	"cli.cmd.server.schedule.history.out": "runs 为 ScheduleQueryInfo 数组，totalCount 为匹配总数；每项 scheduleRunId 定位所选历史运行。仅当该次运行仍是计划最近运行时才附带当前计划配置，更早的记录可能缺少这些字段；附带配置也不是历史配置快照。taskCount 是当前配置任务数，taskRunCount 和结果计数属于该次运行。\n\n--run/--latest 最多返回一条记录，无分页信息。完整字段及状态见完整查询对象和运行信息参考。准确总数可能遍历全部匹配页，运行中数据不保证快照一致性；日期字符串包含服务器时区偏移。",
+	"cli.cmd.server.schedule.history.run": "计划运行 id，与 --latest 互斥。指定任一运行定位选项后，不接受 --state、--failed、--start-time、--end-time、--min-duration、--max-duration、--offset、--limit、--all。",
+	"cli.cmd.server.schedule.history.latest": "仅定位一次最近运行；筛选和分页限制与 --run 相同，不证明与上次执行请求相关。",
+	"cli.cmd.server.schedule.history.schedule": "目标计划的精确 id。",
+	"cli.cmd.server.schedule.history.offset": "计划运行列表的记录偏移，与 --run/--latest 互斥。",
+	"cli.cmd.server.schedule.history.limit": "计划运行列表的每页条数，与 --run/--latest 互斥。",
+	"cli.cmd.server.schedule.remove.summary": "删除计划及任务，或计划分类。",
+	"cli.cmd.server.schedule.remove.desc": "删除明确指定的系统计划及其任务，或删除计划分类。\n\n删除要求明确确认；分类的子分类和对象归类处理沿用服务器规则。不会删除任务引用的脚本或模型。\n\n需要登录并具有目标计划或系统计划分类的管理权限。",
+	"cli.cmd.server.schedule.remove.out": "ids 为请求删除的目标，success 和 results 表示逐目标删除核验结果。",
+	"cli.cmd.server.schedule.remove.schedule": "计划 id；与 --category 二选一。可重复指定。",
+	"cli.cmd.server.schedule.remove.category": "删除的计划分类 id，可重复指定；与 --schedule 二选一。",
+	"cli.cmd.server.task.title": "计划任务",
+	"cli.cmd.server.task.summary": "管理计划内任务及分类。",
+	"cli.cmd.server.task.desc": "直接管理所选服务器上的系统计划任务；不需要本地工作区或项目参数。",
+	"cli.cmd.server.task.*.name": "按关联资源名称或描述包含匹配，不搜索任务 id。",
+	"cli.cmd.server.task.*.categoryId": "匹配该任务分类及其后代分类中的当前任务；不是分类目录查询开关。",
+	"cli.cmd.server.task.*.resource": "已有服务器资源绝对路径，先解析为元数据 id。",
+	"cli.cmd.server.task.*.type": "任务类型，例如 script、etl、afl、kdb；查询可使用已有记录的类型原值。",
+	"cli.cmd.server.task.*.creator": "创建人 id。",
+	"cli.cmd.server.task.*.state": "英文逗号分隔的状态集合，去除空白及重复值；不能重复传参。UNKNOWN 未开始或未知、WAITING 等待、RUNNING 运行中、SUCCESS 成功、ERROR 错误、TIMEOUT 超时、SKIP 跳过、BLOCK 阻塞、CANCEL 取消。",
+	"cli.cmd.server.task.*.priority": "按当前任务的生效优先级筛选，包含分类和计划继承值。",
+	"cli.cmd.server.task.*.offset": "匹配任务或任务运行的记录偏移。",
+	"cli.cmd.server.task.*.limit": "每页任务或任务运行的条数。",
+	"cli.cmd.server.task.*.force": "确认删除指定对象；不绕过服务器权限或运行状态限制。",
+	"cli.cmd.server.task.list.summary": "查询系统任务或计划内任务分类。",
+	"cli.cmd.server.task.list.desc": "查询当前任务或分类目录。\n\n准确总数、筛选及稳定排序可能遍历全部匹配页，增加网络、CPU 和内存开销；运行中数据不保证快照一致性。\n\n需要登录及查看权限。",
+	"cli.cmd.server.task.list.out": "tasks 为 TaskQueryInfo 数组，组合自身配置、最近运行字段和当前关联资源信息；categories 为 TaskCategory 数组。可继承设置缺省不表示没有生效值。schedules 为当前页关联的 ScheduleQueryInfo 数组，按 scheduleId 去重；totalCount 为匹配总数。\n\n人类输出为摘要，完整字段和路径使用 --json 或 --pretty-json 查看；字段含义见完整查询对象及运行信息参考。准确筛选可能遍历全部匹配页，运行中数据不保证快照一致性；日期字符串包含服务器时区偏移。",
+	"cli.cmd.server.task.list.schedule": "所属计划的精确 id；任务列表省略时跨计划查询，分类模式必填。",
+	"cli.cmd.server.task.list.category": "查询分类列表的布尔开关，不是分类 id。必须指定 --schedule；返回完整分类目录，不接受任务筛选和分页。",
+	"cli.cmd.server.task.create.summary": "向计划批量添加任务，或创建任务分类。",
+	"cli.cmd.server.task.create.desc": "将已有服务器资源作为任务加入一个系统计划，或在计划内创建任务分类。\n\n命令不上传资源，也不启用所属计划。重复添加计划内已有资源可能复用原任务并更新所提交的配置；重试前先回读任务，verified 不代表本次新建。\n\n需要登录并具有目标计划的使用权限；引用资源还需相应资源权限。",
+	"cli.cmd.server.task.create.out": "tasks 为回读的完整任务数组；分类为 id 和完整 category。results 提供逐任务核实状态；verified 仅表示目标已匹配，不证明本次新建。失败保留已确认效果，不自动重试。",
+	"cli.cmd.server.task.create.schedule": "所属计划的精确 id，必填。",
+	"cli.cmd.server.task.create.input": "UTF-8 JSON 对象文件或 - 表示 stdin；--task 与 --category 必须且只能选择一个。对象字段使用服务器驼峰名称；布尔配置建议用 true/false 或 0/1；其他值按服务器规则转换。字段、类型及单位见 DTS。",
+	"cli.cmd.server.task.create.task": "根对象为非空 {\"tasks\":[...]}。每项必填 taskType，并用 resid 或 resPath（已有服务器资源绝对路径）定位资源，二选一；不传 taskId；scheduleId 如提供须与 --schedule 一致，enabled 默认 true。普通资源类型为 script/etl/afl/kdb；业务内部和系统任务类型见 TASK_TYPE。不支持 workflow/sub/check/schedule 任务类型。",
+	"cli.cmd.server.task.create.category": "必填 caption，id 可省略（最多 32 字符）；enableTaskConfs 创建时默认 false，沿用祖先分类或计划设置；true 启用本分类的默认设置。继承规则见参考资料。",
+	"cli.cmd.server.task.update.summary": "局部修改任务或任务分类配置。",
+	"cli.cmd.server.task.update.desc": "批量修改计划内任务，或调整任务分类名称、父级、顺序及默认执行配置。\n\n需要登录并具有目标计划的使用权限。",
+	"cli.cmd.server.task.update.out": "tasks 为回读的完整任务数组，results 提供逐任务核实状态；分类为 id 和完整 category。失败保留已确认效果，不自动重试。",
+	"cli.cmd.server.task.update.schedule": "所属计划的精确 id，必填。",
+	"cli.cmd.server.task.update.input": "UTF-8 JSON 对象文件或 - 表示 stdin；--task 与 --category 必须且只能选择一个。省略字段不改；可提交接口字段局部修改或从 show/list 提取的完整接口对象，不提交结果信封。读改写没有并发版本保护。完整字段定义见 DTS 参考资料。",
+	"cli.cmd.server.task.update.task": "根对象为非空 {\"tasks\":[...]}。每项必填 taskId；资源、类型和所属计划不可变；不支持修改 workflow/sub/check/schedule 任务类型。priority:null、timeout:null 恢复继承。",
+	"cli.cmd.server.task.update.category": "必填 id；省略字段不改。priority/timeout 用 null 清空，条件和执行时间限制用空字符串清空，retryStrategies 用空数组清空。修改分类时自动维护受影响后代的继承来源。继承规则见参考资料。",
+	"cli.cmd.server.task.remove.summary": "从计划移除任务，或删除任务分类。",
+	"cli.cmd.server.task.remove.desc": "从指定计划移除选定任务，或删除任务分类及服务器规则要求的子分类。\n\n要求显式确认，并先核对所有目标属于该计划。不会删除任务引用的资源。\n\n需要登录并具有目标计划的使用权限。",
+	"cli.cmd.server.task.remove.out": "ids 为请求删除的目标，success 和 results 表示逐目标删除核验结果。",
+	"cli.cmd.server.task.remove.schedule": "目标计划的精确 id。",
+	"cli.cmd.server.task.remove.category": "删除的任务分类 id，可重复指定；必须属于 --schedule 指定的计划，与 --task 二选一。",
+	"cli.cmd.server.task.remove.task": "从计划移除的任务 id，可重复指定；与 --category 二选一，不删除任务引用的资源。",
+	"cli.out.schedule.schedules": "计划",
+	"cli.out.schedule.tasks": "任务",
+	"cli.out.schedule.categories": "分类",
+	"cli.out.schedule.config": "配置",
+	"cli.out.schedule.runs": "运行记录",
+	"cli.out.schedule.id": "标识",
+	"cli.out.schedule.ids": "目标 id",
+	"cli.out.schedule.objectType": "对象类型",
+	"cli.out.schedule.accepted": "请求已受理",
+	"cli.out.schedule.mode": "执行模式",
+	"cli.out.schedule.success": "操作已确认",
+	"cli.out.schedule.scheduleId": "所属计划",
+	"cli.out.schedule.offset": "偏移",
+	"cli.out.schedule.limit": "每页条数",
+	"cli.out.schedule.totalCount": "总数",
+	"cli.out.schedule.counts": "数量统计",
+	"cli.out.schedule.taskPage": "任务分页范围",
+	"cli.out.schedule.taskRun": "任务运行状态",
+	"cli.out.schedule.logs": "计划日志",
+	"cli.out.schedule.dependencies": "依赖图",
+	"cli.out.schedule.field": "字段",
+	"cli.out.schedule.value": "内容",
+	"cli.out.schedule.empty": "无匹配记录，共 0 条",
+	"cli.ref.scheduleConfig": "计划配置字段",
+	"cli.ref.scheduleTaskConfig": "任务配置字段",
+	"cli.ref.scheduleTaskCategory": "任务分类接口字段",
+	"cli.out.schedule.name": "名称",
+	"cli.out.schedule.type": "类型",
+	"cli.out.schedule.enabled": "启用",
+	"cli.out.schedule.priority": "优先级",
+	"cli.out.schedule.categoryId": "所属分类",
+	"cli.out.schedule.parentId": "父分类",
+	"cli.out.schedule.order": "顺序",
+	"cli.out.schedule.independent": "独立任务配置",
+	"cli.out.schedule.resourceId": "资源 id",
+	"cli.out.schedule.scheduleRunId": "计划运行 id",
+	"cli.out.schedule.scheduleName": "计划名称",
+	"cli.out.schedule.taskId": "任务 id",
+	"cli.out.schedule.taskRunId": "任务运行 id",
+	"cli.out.schedule.runState": "运行状态",
+	"cli.out.schedule.startTime": "开始时间",
+	"cli.out.schedule.endTime": "结束时间",
+	"cli.out.schedule.step": "步骤",
+	"cli.out.schedule.status": "确认结果",
+	"cli.out.schedule.status.success": "已确认",
+	"cli.out.schedule.status.failed": "失败",
+	"cli.out.schedule.status.unknown": "结果未知",
+	"cli.input.scheduleConfig": "计划任务 JSON 配置",
+	"cli.input.scheduleObject": "计划任务操作对象",
+	"cli.ref.scheduleCategory": "计划分类接口字段",
+	"cli.cmd.server.schedule.*.failed": "等同 --state=ERROR,TIMEOUT，与 --state 互斥；不包含 BLOCK。",
+	"cli.cmd.server.schedule.*.all": "遍历全部匹配页，与显式 --offset/--limit 互斥。",
+	"cli.cmd.server.schedule.*.toTime": "日志时间上界，标准日期字符串或毫秒值，logTime <；由服务器筛选，无偏移字符串按服务器时区解释。",
+	"cli.cmd.server.schedule.*.keyword": "本地匹配日志正文或独立详情；仅详情命中时，人类输出仍只显示正文。",
+	"cli.cmd.server.schedule.*.level": "精确日志级别：OFF=0、FATAL=1、ERROR=2、WARN=3、IMPT=4、INFO=5、DEBUG=6、TRACE=7；本地筛选。",
+	"cli.cmd.server.schedule.*.logType": "按数字日志类型精确筛选。先不带 --log-type 查询 --json，从 logs[].logType 取得需要的值，再据此筛选。它表示日志类别，不是 --level 指定的严重级别；筛选在本地执行。",
+	"cli.cmd.server.schedule.*.tail": "读取时间下界以来的全部日志后保留最后 N 条匹配日志；不是服务端分页或有界读取。",
+	"cli.cmd.server.schedule.*.groupBy": "显式指定一个分组字段，分组与总数覆盖相同筛选集合；支持组合见输出说明。",
+	"cli.cmd.server.task.*.failed": "等同 --state=ERROR,TIMEOUT，与 --state 互斥；不包含 BLOCK。",
+	"cli.cmd.server.task.*.all": "遍历全部匹配页，与显式 --offset/--limit 互斥。",
+	"cli.cmd.server.task.*.startTime": "startTime >= 指定日期时间（如 2026-10-23 12:34:56.789，也接受毫秒值），包含下界。 无偏移字符串按服务器时区解释。",
+	"cli.cmd.server.task.*.endTime": "endTime < 指定日期时间（如 2026-10-23 12:34:56.789，也接受毫秒值），排除上界和未结束记录；不是开始时间窗口。 无偏移字符串按服务器时区解释。",
+	"cli.cmd.server.task.*.minDuration": "秒；单独指定为 >=；与 max 同时指定时使用包含两端的 between。",
+	"cli.cmd.server.task.*.maxDuration": "秒；单独指定为 <；与 min 同时指定时使用包含两端的 between。",
+	"cli.cmd.server.task.*.fromTime": "标准日期字符串或毫秒值；按 lastUpdateTime 严格 > 筛选，0 表示不设更新下界。",
+	"cli.cmd.server.task.*.toTime": "日志时间上界，标准日期字符串或毫秒值，logTime <；由服务器筛选，无偏移字符串按服务器时区解释。",
+	"cli.cmd.server.task.*.keyword": "本地匹配日志正文或独立详情；仅详情命中时，人类输出仍只显示正文。",
+	"cli.cmd.server.task.*.level": "精确日志级别：OFF=0、FATAL=1、ERROR=2、WARN=3、IMPT=4、INFO=5、DEBUG=6、TRACE=7；本地筛选。",
+	"cli.cmd.server.task.*.logType": "按数字日志类型精确筛选。先不带 --log-type 查询 --json，从 logs[].logType 取得需要的值，再据此筛选。它表示日志类别，不是 --level 指定的严重级别；筛选在本地执行。",
+	"cli.cmd.server.task.*.tail": "读取时间下界以来的全部日志后保留最后 N 条匹配日志；不是服务端分页或有界读取。",
+	"cli.cmd.server.task.*.groupBy": "显式指定一个分组字段，分组与总数覆盖相同筛选集合；支持组合见输出说明。",
+	"cli.cmd.server.task.*.run": "精确计划运行 id，与 --latest 互斥。",
+	"cli.cmd.server.task.*.latest": "仅定位一次最近运行，不证明与上一次执行请求相关。",
+	"cli.cmd.server.task.*.schedule": "所属计划 id；分类目录和 run/latest 范围必填。",
+	"cli.cmd.server.task.*.task": "任务配置 id，可重复指定多个。",
+	"cli.cmd.server.task.*.parentDir": "精确匹配资源父目录。",
+	"cli.cmd.server.task.*.rootDir": "按后端资源目录前缀规则匹配，包含后代。",
+	"cli.cmd.server.task.*.order": "排序方向，要求 --order-by。",
+	"cli.cmd.server.task.*.orderBy": "按任务字段排序：taskId、createTime、modifiedTime、priority、resName、taskType、startTime、endTime、runState；最终以唯一 id 收尾。",
+	"cli.cmd.server.task.*.taskRun": "精确任务运行 id，不是任务配置 id。",
+	"cli.cmd.server.task.*.withInherited": "合并生效默认值到 task 并返回 sources；回写会固化继承值。",
+	"cli.cmd.server.schedule.enable.summary": "启用自动调度。",
+	"cli.cmd.server.schedule.enable.desc": "启用指定计划的后续自动调度，不立即执行计划。全部目标预检后批量提交，并回读核验目标状态；没有跨计划事务。\n\n需要登录及目标范围的相应权限。",
+	"cli.cmd.server.schedule.disable.summary": "停用自动调度。",
+	"cli.cmd.server.schedule.disable.desc": "停用指定计划的后续自动调度，正在运行的实例继续执行。\n\n需要登录及目标范围的相应权限。",
+	"cli.cmd.server.schedule.count.summary": "统计计划、分类或历史运行数量。",
+	"cli.cmd.server.schedule.count.desc": "默认统计计划，也可统计分类目录或单个计划的运行历史。\n\n需要登录及目标范围的相应权限。\n\n为准确总数、筛选及稳定排序，可能遍历全部匹配页，增加网络、CPU 和内存开销；运行中数据不保证快照一致性。",
+	"cli.cmd.server.task.count.summary": "统计当前任务、分类或任务运行数量。",
+	"cli.cmd.server.task.count.desc": "统计当前任务、分类或单次计划运行中的任务数量；跨次历史使用 task history 结果中的 totalCount。\n\n需要登录及目标范围的相应权限。\n\n为准确总数、筛选及稳定排序，可能遍历全部匹配页，增加网络、CPU 和内存开销；运行中数据不保证快照一致性。",
+	"cli.cmd.server.task.show.summary": "查看任务自身或含继承的配置。",
+	"cli.cmd.server.task.show.desc": "读取任务自身配置及只读原始信息，供检查配置和准备更新输入；也可合并分类和计划默认值并返回继承来源。\n\n需要登录及目标范围的相应权限。",
+	"cli.cmd.server.task.history.summary": "查询指定运行或有界跨次任务结果。",
+	"cli.cmd.server.task.history.desc": "查询指定运行内的任务结果，或查询指定任务的有界跨次历史。\n\n需要登录及目标范围的相应权限。\n\n为准确总数、筛选及稳定排序，可能遍历全部匹配页，增加网络、CPU 和内存开销；运行中数据不保证快照一致性。",
+	"cli.cmd.server.schedule.logs.summary": "读取一次计划运行的日志。",
+	"cli.cmd.server.schedule.logs.desc": "读取指定计划运行的日志。\n\n需要登录及目标范围的相应权限。",
+	"cli.cmd.server.task.logs.summary": "读取一次任务运行的日志。",
+	"cli.cmd.server.task.logs.desc": "读取指定任务运行的日志。\n\n需要登录及目标范围的相应权限。",
+	"cli.cmd.server.schedule.enable.schedule": "计划 id，可重复指定多个；去重，所有目标存在性预检通过后才写入。",
+	"cli.cmd.server.schedule.enable.out": "ids、enabled、success 及逐目标 results；status=verified 只表示目标状态已回读核实，不证明本次发生新变化。不确定结果不自动重试。",
+	"cli.cmd.server.schedule.disable.schedule": "计划 id，可重复指定多个；去重，所有目标存在性预检通过后才写入。",
+	"cli.cmd.server.schedule.disable.out": "ids、enabled、success 及逐目标 results；status=verified 只表示目标状态已回读核实，不证明本次发生新变化。不确定结果不自动重试。",
+	"cli.cmd.server.schedule.count.history": "显式统计运行历史，要求 --schedule，拒绝配置专属筛选。",
+	"cli.cmd.server.schedule.count.category": "只统计计划分类，与其它筛选互斥。",
+	"cli.cmd.server.task.count.schedule": "所属计划 id；默认统计当前任务，可省略以跨计划查询。指定 --run/--latest 时必填，统计该次运行；--category 模式也必填。时间及耗时筛选仅用于运行统计，--resource/--type/--creator 仅用于当前任务统计；分类目录不接受任务或运行筛选。",
+	"cli.cmd.server.task.count.priority": "当前任务按生效优先级筛选；运行统计按运行记录保存的优先级筛选。",
+	"cli.cmd.server.task.count.categoryId": "当前任务匹配该分类及其后代；运行统计精确匹配记录保存的分类，不按当前分类树重算。",
+	"cli.cmd.server.task.count.category": "统计任务分类目录，要求 --schedule，不接受任务或运行筛选。",
+	"cli.cmd.server.schedule.count.out": "totalCount 为全部匹配数；--group-by 配置支持 category/type/enabled，历史支持 state，分类目录不支持分组；groups 为 {value,count} 数组，null 为未设置分组。",
+	"cli.cmd.server.task.count.out": "totalCount 为全部匹配数；--group-by=category/priority/state 按相同集合分组。当前任务的 priority 分组使用生效优先级，运行分组使用记录保存值。分类目录计数不分组，null 分组保留未设置值。",
+	"cli.cmd.server.task.show.out": "task 为 TaskQueryInfo，组合自身设置、最近运行字段和当前资源信息；schedules 为关联的 ScheduleQueryInfo 数组。更新时将 task 包装为 {\"tasks\":[task]} 交给 task update --task，并用 --schedule 指定所属计划；保存时忽略只读查询字段。\n\n普通 show 返回自身设置。--with-inherited 包含生效值及 sources 来源；回写这些值会将继承值固定为自身覆盖。重试时间单位为秒。人类输出展示名称、身份、路径和业务设置，完整字段使用 --json 或 --pretty-json 查看。日期字符串包含服务器时区偏移。",
+	"cli.cmd.server.task.show.schedule": "可选的所属计划 id；提供时校验任务归属，省略时按任务 id 查找。",
+	"cli.cmd.server.task.show.task": "一个精确任务配置 id，不是任务运行 id。",
+	"cli.cmd.server.task.history.out": "runs 为 TaskQueryInfo 数组并返回 totalCount；每项包含 scheduleId/scheduleRunId/taskId/taskRunId 及可用的任务名称、资源路径。--task-run 返回一项，无 runPage；列表查询返回 scheduleId 和 runPage（offset/limit/truncated），包括 --latest 尚无运行时的空列表。\n\n跨次和空结果根层无 scheduleRunId，按每项 scheduleRunId 关联运行。schedules 为当前页关联的计划信息，按 scheduleId 去重，空结果为 []；这些是当前配置，不代表执行时快照。人类输出展示任务名称、状态和带秒单位的耗时。日期字符串包含服务器时区偏移。",
+	"cli.cmd.server.schedule.logs.out": "单次查询返回 logs 数组、totalCount（--tail 截取前匹配数）和 truncated（是否被 --tail 截取）。每条日志为 ScheduleLog，保留全部字段，包括 logContent2；logTime 为 Unix 毫秒时间戳。人类输出展示 UTC 时间、级别和原始正文，独立详情使用 --json 或 --pretty-json 查看。无日志不代表运行成功。\n\n--follow --json 在 stdout 逐行输出 JSON，kind=result，event=snapshot/log/end。计划运行状态位于 snapshot；每个 log 事件在 log 中携带一条日志，不返回 logs 数组。各事件包含递增的 sequence 和固定的 scheduleId/scheduleRunId。end 包含最终 snapshot、reason=terminal/timeout/interrupted 和 logCompleteness=unknown。确认终态后退出 0，超时 124，中断 130；请求失败输出 kind=error。--quiet 保留这些结果事件。",
+	"cli.cmd.server.task.logs.out": "单次查询返回 logs 数组、totalCount（--tail 截取前匹配数）和 truncated（是否被 --tail 截取）。每条日志为 ScheduleTaskLog，保留全部字段，包括 logContent2；logTime 为 Unix 毫秒时间戳。人类输出展示 UTC 时间、级别和原始正文，独立详情使用 --json 或 --pretty-json 查看。无日志不代表运行成功。\n\n--follow --json 在 stdout 逐行输出 JSON，kind=result，event=snapshot/log/end。任务运行状态位于 snapshot.run（TaskRunStateInfo），snapshot.terminal 表示是否结束；每个 log 事件在 log 中携带一条日志，不返回 logs 数组。各事件包含递增的 sequence 和固定的 scheduleId/scheduleRunId/taskRunId。end 包含最终 snapshot、reason=terminal/timeout/interrupted 和 logCompleteness=unknown。确认终态后退出 0，超时 124，中断 130；请求失败输出 kind=error。--quiet 保留这些结果事件。",
+	"cli.cmd.server.task.logs.schedule": "所属计划 id；使用任务配置 id 定位日志时，必须同时提供 --task 和 --run/--latest；与 --task-run 互斥。",
+	"cli.cmd.server.task.logs.run": "计划运行 id；未指定 --task-run 时，与 --latest 必须且只能指定一个。",
+	"cli.cmd.server.task.logs.task": "选定计划运行中的一个任务配置 id。",
+	"cli.cmd.server.task.logs.taskRun": "单独给任务运行 id，与 schedule/run/latest/task 互斥，自动反查归属身份。",
+	"cli.out.schedule.noLogs": "暂无日志",
+	"cli.out.schedule.logDetails": "独立详情见 --pretty-json",
+	"cli.out.schedule.fullValues": "完整值见 --pretty-json",
+	"cli.out.schedule.unknown": "未知",
+	"cli.out.schedule.source": "来源",
+	"cli.out.schedule.runPage": "运行分页",
+	"cli.out.schedule.results": "逐目标结果",
+	"cli.out.schedule.groups": "分组",
+	"cli.out.schedule.count": "数量",
+	"cli.out.schedule.resourcePath": "资源路径",
+	"cli.out.schedule.elapsedMs": "耗时",
+	"cli.out.schedule.pageSummary": "本页 {count} 条，共 {total} 条匹配记录。",
+	"cli.out.schedule.status.verified": "已核实",
+	"cli.cmd.server.schedule.count.schedule": "历史计数所属计划 id；仅 --history 模式使用。",
+	"cli.cmd.server.schedule.logs.run": "计划运行 id；与 --latest 必须且只能指定一个。",
+	"cli.cmd.server.schedule.logs.latest": "定位一次最近运行，与 --run 二选一；单次读取没有运行时返回空日志，不证明与上次执行请求相关。",
+	"cli.cmd.server.schedule.logs.schedule": "日志所属计划 id，必填。",
+	"cli.out.schedule.default": "默认",
+	"cli.cmd.server.task.run.summary": "提交执行选定的调度任务。",
+	"cli.cmd.server.task.run.desc": "提交计划内一个或多个已有任务。\n\n实际执行可能修改业务数据，忽略计划条件，默认遵守任务条件；请求不自动重试。\n\n需要登录、计划使用权限和适用资源权限。",
+	"cli.cmd.server.task.run.out": "accepted 仅表示受理；mode=tasks、taskIds 表示请求范围。不返回新运行 id；先通过历史定位运行，再用 status/logs 排查，latest 不能证明请求关联。",
+	"cli.cmd.server.task.run.schedule": "所属计划的精确 id，必填。 不支持 group 计划或含 workflow/sub/check/schedule 类型任务的计划。",
+	"cli.cmd.server.task.run.task": "任务配置 id，可重复指定多个；所有任务必须属于指定计划。",
+	"cli.cmd.server.task.run.includeDepends": "同时执行选定任务的依赖。",
+	"cli.cmd.server.task.run.includeImpacts": "同时执行受选定任务影响的任务。",
+	"cli.cmd.server.task.run.excludeSelected": "不执行选中任务本身；必须同时指定依赖或影响范围。",
+	"cli.cmd.server.task.run.ignoreTaskCondition": "显式忽略任务执行条件；默认遵守。",
+	"cli.cmd.server.schedule.status.summary": "查看单个计划最近或指定运行的状态。",
+	"cli.cmd.server.schedule.status.desc": "查看计划最近或指定运行的状态、服务器耗时和任务分组数量。\n\n需要登录和计划查看权限。",
+	"cli.cmd.server.schedule.status.out": "单次查询返回 run（ScheduleQueryInfo）、counts.total/byState、elapsedMs 和 terminal；嵌套字段含义见完整查询对象、运行信息和结果状态参考。counts 为观察到的任务记录数量；无运行时 run/counts/elapsedMs 为 null。elapsedMs 为服务器时间计算的毫秒数，无法计算时为 null；人类输出以 s 标注秒。\n\n--watch --json 在 stdout 逐行输出 JSON，kind=result，event=snapshot/end。snapshot 事件将状态放在 snapshot 中；各事件包含递增的 sequence 和固定的 scheduleId/scheduleRunId。end 包含最终 snapshot 和 reason=terminal/timeout/interrupted。确认终态后退出 0，即使业务运行失败；超时退出 124，中断退出 130。请求失败输出 kind=error。run 中的日期字符串包含服务器时区偏移。",
+	"cli.cmd.server.schedule.*.follow": "固定运行跟踪，与 pretty-json 互斥。每轮重读原时间范围并按 logId 去重，消耗网络和内存；终态后补读两次，无 EOF 保证，logCompleteness=unknown。",
+	"cli.cmd.server.schedule.*.interval": "观察间隔，单位毫秒；仅 --follow 可用。",
+	"cli.cmd.server.schedule.*.timeout": "观察期限，单位毫秒，0 表示不限；覆盖请求及补读，仅 --follow 可用。超时退出 124，中断 130。",
+	"cli.cmd.server.task.*.follow": "固定运行跟踪，与 pretty-json 互斥。每轮重读原时间范围并按 logId 去重，消耗网络和内存；终态后补读两次，无 EOF 保证，logCompleteness=unknown。任务跟踪保守地等待所属计划运行结束，避免把重试间隙误判为终态。",
+	"cli.cmd.server.task.*.interval": "观察间隔，单位毫秒；仅 --follow 可用。",
+	"cli.cmd.server.task.*.timeout": "观察期限，单位毫秒，0 表示不限；覆盖请求及补读，仅 --follow 可用。超时退出 124，中断 130。",
+	"cli.cmd.server.schedule.status.interval": "观察间隔，单位毫秒；仅 --watch 可用。",
+	"cli.cmd.server.schedule.status.timeout": "观察期限，单位毫秒，0 表示不限；覆盖请求及补读，仅 --watch 可用。超时退出 124，中断 130。",
+	"cli.cmd.server.schedule.status.watch": "连续观察固定运行，与 pretty-json 互斥；JSON 在 stdout 输出 NDJSON 业务事件。要求已有运行，固定首次解析的运行，确认终态后结束；每轮数量统计读取该运行的全部任务页。",
+	"cli.out.schedule.observationEnd": "观察结束：{reason}",
+	"cli.out.schedule.run": "运行",
+	"cli.out.schedule.snapshot": "状态快照",
+	"cli.out.schedule.terminal": "已确认终态",
+	"cli.cmd.server.schedule.status.schedule": "所属计划 id，必填。默认读取计划记录的最近运行；尚无运行记录时显示空状态。",
+	"cli.cmd.server.task.history.orderBy": "按任务运行字段排序：taskRunId、taskRunOrder、startTime、endTime、priority、runState、resName、errorTimes、taskId；最终以唯一 id 收尾。",
+	"cli.cmd.server.task.history.priority": "精确匹配任务运行记录保存的优先级，不按当前配置或继承重算。",
+	"cli.cmd.server.task.history.categoryId": "精确匹配每条运行保存的分类 id；分类已删除仍可查询，不按当前分类树重算历史归属。",
+	"cli.out.schedule.status.notStarted": "未开始",
+	"cli.cmd.server.task.history.schedule": "所属计划 id；指定 run/latest 或跨次查询均必填。精确 task-run 模式可省略；提供时必须与运行归属一致。\n三种模式：单次列表指定 --schedule 和 --run/--latest；跨次查询省略 run/latest，必填 --schedule、至少一个 --task 及 --start-time/--end-time，结束时间须大于开始时间；精确 --task-run 仅可附 --schedule、--run 校验归属，不接受筛选、分页及 --latest。",
+	"cli.cmd.server.schedule.logs.fromTime": "日志时间下界，标准日期字符串或毫秒值，logTime >=。服务器按时间上下界筛选，无偏移字符串按服务器时区解释；其余筛选在本地执行；--tail 不减少服务器读取量。",
+	"cli.cmd.server.task.logs.fromTime": "日志时间下界，标准日期字符串或毫秒值，logTime >=。服务器按时间上下界筛选，无偏移字符串按服务器时区解释；其余筛选在本地执行；--tail 不减少服务器读取量。",
+	"cli.cmd.server.schedule.dependencies.summary": "查询计划任务的当前依赖图或历史快照。",
+	"cli.cmd.server.schedule.dependencies.desc": "查询一个计划内的完整任务依赖关系，支持当前配置和执行时保存的历史快照。\n\n只读，需要登录和计划查看权限。历史关系来自执行时快照，任务说明与 WebUI 一样关联同次任务运行信息；图较大时，读取和展示完整图会增加网络和内存开销。",
+	"cli.cmd.server.schedule.dependencies.schedule": "所属计划的精确 id，必填。未指定 --run/--latest 时读取当前配置；历史快照使用 --run 或 --latest。",
+	"cli.cmd.server.schedule.dependencies.run": "指定历史计划运行 id，必须属于所选计划，与 --latest 互斥。",
+	"cli.cmd.server.schedule.dependencies.latest": "查询最近一次运行保存的快照；没有运行时报错，不回退到当前图。",
+	"cli.cmd.server.schedule.dependencies.out": "scheduleId 标明计划，dependencySource 为 current/historical；历史查询另附 scheduleRunId。dependencies 始终为数组，每项含 taskId、dependsOn、resourceId、resourcePath，以及可用时的 name、removedDependsOn。当前图提供资源 id 和完整资源路径。历史图按 taskId 合并同次任务运行记录：resourceId 取运行记录，name 和 resourcePath 使用服务器查询返回的任务说明；名称和路径关联当前资源，改名或移动后会变化，并非执行时快照。缺少任务运行或资源信息时仍保留快照节点；资源字段缺失为 null，名称缺失时人类输出回退到任务 id。dependsOn 中的任务须先完成。\nname 按当前语言读取服务器语言包及自定义覆盖来翻译任务标题；没有译文时保留原文，未配置标题的系统备份任务使用默认标题。人类输出从末端任务向依赖递归展开，保留独立任务；(*) 表示重复子树，不代表重复执行，(cycle) 表示循环，(missing) 表示被引用的任务未出现在图中。已移除依赖单独列出；完整关系以 JSON 为准。\n历史接口的空数组无法区分没有任务与未保存快照；不据此宣称快照完整，也不会回退到当前图。不支持任务筛选、分页或跨次合并。",
+	"cli.out.schedule.dependencySource": "依赖来源",
+	"cli.out.schedule.dependenciesCurrent": "当前配置",
+	"cli.out.schedule.dependenciesHistorical": "历史快照",
+	"cli.out.schedule.dependenciesEmpty": "未返回依赖记录。",
+	"cli.out.schedule.dependenciesDirection": "方向：任务下面列出它依赖的任务（须先完成）。",
+	"cli.out.schedule.dependenciesRepeated": "(*) 此依赖子树已在上方展开，不代表重复执行。",
+	"cli.out.schedule.dependenciesCycle": "(cycle) 当前路径出现循环依赖，已停止展开。",
+	"cli.out.schedule.dependenciesMissing": "(missing) 被引用的任务未出现在返回的图中。",
+	"cli.out.schedule.dependenciesRemoved": "已移除的依赖（不属于生效关系）：",
+	"cli.out.schedule.schedule": "计划",
+	"cli.out.schedule.task": "任务",
+	"cli.out.schedule.category": "分类",
+	"cli.out.schedule.scheduleStartTime": "生效开始时间",
+	"cli.out.schedule.scheduleEndTime": "生效结束时间",
+	"cli.ref.scheduleOperations": "调度数据任务：创建、修改与结果核验",
+	"cli.ref.scheduleQuery": "计划完整查询对象",
+	"cli.ref.taskQuery": "任务完整查询对象",
+	"cli.ref.scheduleRuntime": "计划运行信息、计数与时间",
+	"cli.ref.taskRuntime": "任务运行信息与依赖",
+	"cli.ref.scheduleRunState": "计划与任务结果状态",
+	"cli.ref.scheduleLog": "计划原始日志字段",
+	"cli.ref.taskLog": "任务原始日志字段",
+	"cli.ref.taskRunState": "任务运行状态记录",
 	"vs.cmd.title.addServer": "添加服务器",
 	"vs.cmd.title.useServer": "使用服务器",
 	"vs.cmd.title.loginServer": "登录服务器",
@@ -1555,7 +2780,7 @@
 	"vs.cmd.title.views.mergeChange": "合并修改",
 	"vs.cmd.title.views.acceptServerChange": "采用服务器版本",
 	"vs.cmd.title.views.restoreLocalChange": "恢复本地版本",
+	"vs.cmd.title.views.resetProjectFromServer": "从服务器重置本地项目",
 	"vs.cmd.title.openServerSource": "打开服务器源码",
-	"vs.cmd.title.showServerFileHistory": "查看服务器文件历史",
-	"vs.cmd.title.views.resetProjectFromServer": "从服务器重置本地项目"
+	"vs.cmd.title.showServerFileHistory": "查看服务器文件历史"
 }