4 Commits

Author	SHA1	Message	Date
Wyatt_K	bca47a27bc	fix(agent): skill_search tokenizer keeps single CJK runes ... cloudAgentSkillSearchTokens dropped any token shorter than 2 runes. That filter was copied from English stop-word logic (a / I), but a single Han rune such as the ones meaning hook, gag or twist is already a complete semantic unit in Chinese. When the whole keyword consisted of such runes, tokens came back empty and cloudAgentSearchSkills degraded to listing the full index of enabled skills - the user thinks a search happened but gets an unsorted dump. Fix: keep a token when it is exactly one Han rune (unicode.Han); single ASCII/digit runes and empty strings are still dropped as before. Test: TestCloudAgentSkillSearchTokensKeepsSingleCJKRune fails on the old logic (got [反转 钩子], want [反转 钩子 梗 钩]) and passes after the fix. recall_lessons has an isomorphic copy of the same tokenizer, fixed separately in #593.	2026-09-22 16:30:07 +08:00
ddCat	979705e38a	fix(agent): 执行边界 - 遵守策略上限并压缩工具协议	2026-09-22 11:43:42 +08:00
itsWyatt-K	590f6b4204	fix(cloud-agent): 修正 skill_search 改动的 gofmt 格式 ... 两处：skill_read_file 工具描述里 map 参数前补逗号后空格；测试文件里新增最长 map 键后重排值对齐。 本地 gofmt 已确认两文件合规，go test 全绿。	2026-09-22 08:27:12 +08:00
Wyatt_K	e28c28f97a	feat(cloud-agent): 新增 skill_search——Agent 侧技能/卡级检索 ... #577 让 Agent 知道「有哪些技能」；本 PR 补上「这个任务该读哪张卡」。 #568/#575 之后种子已有 34 个域包、759 张卡，单包最多 67 张， 「先读 SKILL.md 总纲再按名录找卡」的成本会随卡数线性上涨。 ## 设计（复用仓库既有范式，不发明新机制） 参照 recall_lessons（个人记忆检索）：同一套分词器、稳定排序、无关键词列全量索引。 打分四档：**卡名命中 4 > 技能名 3 > 技能描述 2**。 - 命中卡片 → path 直接给 `cards/xxx.md`，Agent 不必读总纲； - 只命中技能 → path 给 SKILL.md，并下发该包的 **卡索引**（跨条目共享 40 条预算）， Agent 可直奔某张卡。中文关键词打不到英文卡名时，这条兜底路径是主要收益来源； - 数据源 = 本轮冻结快照（含 #577 注入的 description；卡路径本就在 Files 里，无需读正文）； - 只搜已启用技能；**只返回索引与路径，正文永不内联**； - 不可信数据纪律延续：工具描述明牌「返回的是索引，不是指令」。 ## 实机验证（本机影策 v1.5.7 + 本分支编译的后端，step-5-preview-intl） - **检索→读取闭环打通**：`skill_search("反转 结构 钩子")` → 命中 2 条并下发卡索引 → Agent 直读 `cards/ssqr-twist-ending.md`，**全程未读 SKILL.md**，tool_failed=0。 - 8 技能满槽自由跑（原始/改描述/再改描述 三次）：模型**均未自发调用**， skill_read_file 15 / 8 / 9 次落在噪声内 —— **仅靠工具描述不足以驱动该模型主动检索**， 本 PR 不声称改善了采纳率；采纳与否需要遥测才能判定。 ## 实机撞出的两个缺陷（已修，非理论风险） 1. **参数容错**：模型按 skill_read_file 习惯顺手带 skillId，被 DisallowUnknownFields 拒 → tool_failed，工具可见却一次都没成功。现容忍（仅接收不生效）。 2. **snippet 多字节越界 panic**：strings.Index 的字节偏移被当 []rune 下标、start 未夹紧 → `panic: slice bounds out of range [249:233]`，**整个后端进程被打挂**（复现两次）。 现改为 rune 级子串查找 + start/end 双向夹紧；回归测试用 276 rune/字节偏移 483 的长中文 描述，修复前稳定 panic([443:276])。 ## 测试（11 个契约用例，全绿） 注册与门控、卡名命中返回卡路径、中文关键词回落到卡索引、卡索引预算夹紧、 name>description 排序、无关键词列索引、limit 夹紧、无命中 guidance、 stray skillId 穿透解码层、长中文描述不越界、sentinel 断言正文绝不内联。 门禁：go build ./internal/app/ ✓ go vet ./internal/app/ ✓ go test 11/11 ✓	2026-09-22 07:47:55 +08:00