soloncode 发行版

SolonCode CLI v2026.11.11

2026-11-13 07:10 v2026.11.11 36acb3f

* 收敛 soloncode 三端 @子代理 解析至 `AgentMentions`（harness input 包）：原 CLI/Web/桌面端各自内联 indexOf(" ") + hasAgent 判断，桌面端还额外持有 WsGate.firstWhitespaceIndex / removeLeadingAgentMention 两个私有 helper；现统一为「识别 + 剥离 + 兜底」，三端差异（请求体显式 agent 优先、名字格式校验、内容 trim）通过 Options 显式声明，不再靠各写一份维持
* 重构 AgentMentions 为策略式契约：核心 parse 只依赖 `Predicate<String>`（名字是否有效）而非 HarnessEngine，可脱离引擎单测；原 parse(engine, input, selectedAgent) 保留为便利重载，语义不变
* 删除 soloncode WsGate.firstWhitespaceIndex / removeLeadingAgentMention 两个 helper（已被 AgentMentions 覆盖）；WsGate.isValidAgentName 保留，作为 nameValidator 传入
* 添加 soloncode harness AgentMentionsTest 16 例：逐条锁定迁移前三端实际行为（CLI/Web 只吃一个分隔符、无效 @ 整段保留且不阻断兜底、无空格不构成提及、选择器兜底、桌面端显式 agent 剥离与边界不误剥、名字格式校验、trimContent 只影响首尾空白、null/单 @ 边界）
* 收敛 soloncode 各端手拼 request 的重复代码至 `HarnessEngine.prompt(session, prompt, modelName, agentName)`：CliShell（含 HITL 多轮循环）、PrintMode、WsGate Goal 轮次、GitService 摘要四处改为一行装配；WebSessionRunner / WebStreamBuilder / DesktopStreamTurn / DesktopInputRouter 保留原写法（其下游需独立持有 ChatModel 实例做模型名回填与能力探测，替换会使签名退化）
* 添加 soloncode harness 完整输入装配入口：`HarnessEngine.prompt(AgentSession, Prompt, modelName, agentName)`（含文本重载）收敛各端「取模型 → 取子代理 → 手拼 options」的重复代码，模型名空缺时回退会话级选择（CTX_MODEL_SELECTED）再回退默认模型，子代理名空缺时使用主代理；`promptDo` 原有的 retry/maxTurns/sessionWindowSize 保持设置，追加的 options 为累加语义
* 添加 soloncode harness 命令分发层 org.noear.solon.ai.harness.input：ParsedCommand（解析口径，单独输入 `/` 安全返回 null）、CommandContextFactory（宿主实现，isRemote 决定 cliOnly 拦截）、BufferedCommandContext（默认缓冲实现）、CommandDispatcher（解析→查找→渠道限制拦截→执行→回执收集）、InputTurn（分发结果，只承载同步态信息）、AgentMentions（@子代理解析，显式提及优先、selectedAgent 兜底）；三端命令链路改为共用同一套口径，CLI 专属命令的提示文案统一由 harness 生成
* 修复 soloncode 桌面端可直接执行 `/exit` 终止桌面进程：DesktopInputRouter.handleCommand 原只判 command == null，未校验 cliOnly()，现随上条的分发层一并获得拦截（cliOnly 命令只回执提示，不进入 execute）
* 修复 soloncode CLI 输入单个 `/` 抛 IndexOutOfBoundsException：原实现解析后直接 parts.get(0)，现由 ParsedCommand.parse 统一判空返回 null 走普通输入
* 简化 soloncode WebCommandContext：回执缓冲与 agentTask 标记改由 BufferedCommandContext 提供，本类只保留渠道元数据（source/sourceUserId/replyTarget/messageId）；顺带修正其类注释误写为「CLI 命令执行上下文」
* 加固 soloncode input 包架构护栏（InputBoundaryTest）：input 不得 import 宿主 codecli 包（负向验证已确认会真实失败）；InputTurn 不得依赖响应式流库或暴露 Flux —— 三端消费模型本质不同（CLI 一次输入多轮流、Web 消费 WebEvent 管道、桌面消费裸 AgentEvent），统一流消费口不可行
* 添加 soloncode 输入层单测：ParsedCommandTest 五例（非斜杠/单独斜杠/名称小写与参数切分/无参数/引号参数）、CommandDispatcherTest 四例（统一提示文案、缓冲回执、agentTask 标记、无回调不标记）、InputBoundaryTest 三例

* 修复 soloncode /help 在远程渠道泄露 CLI 专属命令：`HelpCommand.formatHelp` 的命令清单分支未按 `cliOnly()` 过滤（此前只处理了 topic 分支且用 `continue` 落到“未找到命令”），导致 Web/IM 端 `/help` 仍列出 `/exit`；现清单分支整条跳过 CLI 专属命令，topic 分支改为明确提示“仅支持 CLI”而非伪装成不存在，抽取 `appendCommandLine` 消除两处重复拼接
* 修复 soloncode Web 端可直接执行 `/exit` 终止服务进程：`WebChatInputHandler.isCommand` 查到命令后未校验 `cliOnly()` 就直接 `command.execute()`（忙态旁路与提示列表两处已有过滤，唯独真正执行这条链路漏了），现拒绝执行并给出“仅支持 CLI”回执，回执仍用 `reset...done` 信封包住以免前端把它当作上一轮尾巴丢弃；同时为 `HelpCommandTest` 补上 `cliOnly()` 覆盖（原测试辅助方法从不设置该值，导致两条用例在实现正确时也必然失败）并新增 CLI 侧正向用例
* 迁移 soloncode goal 域下沉 harness：GoalState/BudgetThresholds/GoalPromptBuilder/GoalEngine/GoalScheduler/GoalTalent/GoalExtension/validate/* 由 codecli.goal 迁至 org.noear.solon.ai.harness.extension.goal（与 session/queue、session/steer 同级），执行桥三件（ErrorClassifier/ExecutionBridge/RoundResult）迁至 harness.runtime，/goal 命令迁至 harness.command.builtin；宿主 codecli.goal 仅保留 GoalDataMigrator（读 tasks.json + 直写 sessions/<id>/<id>.snapshot.json 属 codecli 私有存储知识）。harness 是被多端复用的库，goal 域不新增任何 HarnessEngine 入口，装配仍由宿主完成，HarnessEngine 本轮零改动
* 加固 soloncode 架构护栏（随 goal 下沉重建）：原 PackageBoundaryTest 的 6 条 goal 断言依赖 src/main/java/.../codecli/goal 目录且带 assumeTrue，目录搬走后会静默跳过而非失败；现迁至 harness 的 GoalBoundaryTest，并把「goal 不得 import loop」强化为「goal 不得 import 宿主 codecli 包」，负向验证已确认会真实失败；codecli 侧新增「codecli.goal 只允许保留 GoalDataMigrator」正向锁定，防领域实现回流宿主

* 清理 soloncode goal 与 loop 残余耦合：执行桥（ExecutionBridge）归属上提至组合根，由 WorkspaceManager 创建后同时注入 LoopScheduler 与 GoalEngine，删除 LoopScheduler.getBridge()（本类是桥的使用者而非拥有者，goal 的构造期不再依赖 loop 实例存活）；WorkspaceContext 新增 getExecutionBridge()，CliShell/WsGate/WorkspaceManager 六处注册点改为直接持有桥
* 清理 soloncode 桌面端无价值类型耦合：AbstractDesktopController 删除零读取的 loopScheduler 字段与构造参数，四个子 Controller 与 Configurator 装配同步瘦身；WsGate 改收 ExecutionBridge（原先仅通过 LoopScheduler.getBridge() 取桥，是它持有 loop 的唯一理由），桌面 goal 链从此完全不接触 loop
* 修复 soloncode goal 验证器跨工作区污染缺陷：ValidatorFactory 原为全局静态注册表且 register 只 append 不去重，而每个工作区创建时都会注册一次默认验证器，两个工作区后注册项累积为 4 条并分别携带各自 workspace 路径，goal 完成判定按 AND 语义遍历全部匹配项，导致在 A 工作区跑 goal 会连 B 工作区的 mvn test 一起跑、B 失败则 A 无法完成；现删除 ValidatorFactory，改为 GoalEngine 实例持有注册表（构造期按自身 workspace 注册 TestsPass/BuildPass 两个默认验证器），新增 resolveValidator(condition) 供 GoalTalent 调用，顺带去掉 GoalValidator.validate 中三个实现均未使用的 sessionId 参数
* 修复 soloncode GoalEngine 会话解析的半初始化隐患：删除 volatile sessionResolver 字段与 setSessionResolver 注入点（漏调用时静默返回 null），改为委托 ExecutionBridge.sessionOf()（桥本就持有 HarnessEngine）
* 清理 soloncode goal 包三处重构残留：GoalEngine 死常量 ROUND_INTERVAL_MS 与死 import RunUtil、GoalPromptBuilder 的自包 import
* 加固 soloncode 架构护栏：PackageBoundaryTest 新增「goal 包不得持有 static List 注册表」（锁定验证器实例化）与「goal 包不得引用 LoopScheduler」（锁定执行桥归属）两条断言；新增 GoalValidatorIsolationTest 四例覆盖多工作区注册隔离、验证器只绑定自身工作区、无工作区不注册、无匹配回退 Noop

* 修复 soloncode 启动失败：挂载发现阶段遇到 Windows 目录符号链接（junction / 目录重解析点，NIO 不识别为 SymbolicLink，walkFileTree 会进入其子树）时报 `Symbolic link escapes mount root` 并抛 SecurityException，一路冒泡到 WorkspaceManager 导致默认工作区初始化失败、web 无法启动；现改为发现阶段尽力而为——find 中对越界目录返回 SKIP_SUBTREE、单条目异常（越界/无权限/瞬时消失）与 visitFileFailed 仅跳过、技能与子代理目录扫描对单个来源/单个条目异常只记日志，工作区注册挂载统一走 addMountSafely 兜底，任一挂载点异常都不再阻断启动
* 添加 soloncode 挂载点跟随外部链接能力：本地目录上的符号链接/Junction 视为普通目录（典型场景：C 盘空间紧张，把技能/子代理目录整体放到 D/E 盘再 Junction 链回），启动路径的全部默认挂载、mountPools 配置项、设置界面添加挂载、设置跨工作区同步重放、`--add-dir` 额外目录统一开启；FileMountSource 新增 followExternalLinks 开关（库默认仍为 false，不改变既有安全语义），同时修正 MountManager.checkedLocalPath 不识别该开关导致「发现可列出、显式访问 @alias/path 却拒绝」的不一致；跟随模式下 find 不再解析挂载根真实路径（省一次 toRealPath，且避免根不可解析时整次扫描被跳过）；`..` 与绝对路径的语法级越界拒绝保持不变
* 修复 soloncode web 文件面板与挂载层链接策略不一致：树构建、关键词搜索、文本读取、原始二进制读取、写回、“打开文件夹”等仅按“最后一段是否为符号链接”一律 403/跳过的判定，现统一改为遵循所在挂载来源的 followExternalLinks（FileService.shouldFollowExternalLinks 解析来源策略，默认工作区按挂载侧同口径跟随），消除“文件树里能看见、点开却读不到”的半开半闭状态；严格来源仍完整保留原有拦截，链接目录也不得被当作树展开根（防止绕开列表过滤直读根外内容）；跟随模式下写回先解析到链接目标再原子写，避免把链接本体替换成普通文件
* 精简 soloncode loop/goal 共享层：删除 LoopExecutionResult 死包装（唯一调用方只消费 2/4 字段，doTrigger 直用 RoundResult）；重复的 classifyError/getFullMessage 收敛为 runtime.ErrorClassifier；删除 LoopScheduler 转发接口（TaskHandler/BusyChecker），入口统一经 getBridge() 注册
* 重构 soloncode goal 为会话级能力（包 codecli.goal）：每会话最多一个，状态随会话快照持久化（不再写 tasks.json）；loop 纯化为定时任务体系，二者仅共享执行桥
* 添加 soloncode `/goal` 独立命令（创建/pause/resume/clear/状态查看），`/loop goal` 提示迁移；`/loop pause|resume` 只作用于定时任务
* 添加 soloncode web 循环任务列表合并展示 goal（恒为第一条），删除/启停/立即执行按钮对 goal 行自动分流
* 添加 soloncode goal 重启恢复：快照中 PURSUING 的 goal 自动重新挂调度，PAUSED/BLOCKED 保持静默等用户恢复
* 添加 soloncode goal 配置节点 soloncode.goal.*（兼容旧 soloncode.loop.* 回填）
* 添加 soloncode goal 存量数据迁移（tasks.json 历史条目 → 会话快照，启动时一次性、幂等）
* 修复 soloncode goal job 跨工作区同名会话互相覆盖的问题（job 名加工作区前缀）
* 修复 soloncode 工作区关闭/LRU 释放时 goal job 泄漏在全局调度器的问题；有活跃 goal 的工作区不再被闲置释放
* 修复 soloncode `/loop` 帮助文本残留的 goal 用法（goal 已迁至 `/goal`，帮助内不再教已迁走的命令）
* 修复 soloncode web 循环任务列表中 goal 状态显示错误：resolveTaskState 先判 loop 的 cancelled/enabled，而后端为复用展示契约把 goal 语义映射进了这两个字段（enabled=是否 PURSUING，cancelled=是否终态），导致 ACHIEVED/BUDGET_LIMITED 显示为“已取消”、PAUSED/BLOCKED 显示为“已停用”，goal 分支永远不可达；改为 goal.status 优先判定，并补全 ITERATION_LIMITED 状态与 blocked/limited 样式
* 修复 soloncode web 面板 goal 创建/编辑链路断裂（重构回归）：loop/add 与 loop/update 硬性拒绝 GOAL 后，前端 goal 标签页仍走这两个端点，创建必失败、编辑在 getTaskById 处先返回 404；改为在两端点内按 GoalState.id 分流到 GoalEngine（与桌面版 goals/add、goals/update 同语义），前端零改动
* 清理 soloncode goal 迁移残留：WorkspaceManager 装配段变量 loopCfg→goalCfg 正名，及 WebQueueDispatcher/SessionWebController/WsGate/DesktopInputRouter/Configurator 五处行内全限定名改标准 import

最后提交信息为：添加：为定时任务、目标及命令提示接口注入界面语言(locale)，使后台调度轮次能按创建者语言输出结果