codebee 0.1.4 → 0.1.6

package/app/core/bookmeta_catalog.py

@@ -1,16 +1,23 @@
 # -*- coding: utf-8 -*-
-"""建书表单的真实选项目录：番茄官方 API 实抓 + 七猫官网书库页实抓。
+"""建书表单的真实选项目录：官方渠道实抓（2026-09-17）。
 
-数据来源（2026-09-16 抓取）：
-- 番茄：https://fanqienovel.com/api/author/book/category_list/v0/?gender=1|0
-  （官方接口，无需登录；主分类 + 主题/角色/情节 三组标签，按目标读者分两套）
-- 七猫：官网书库 SSR 页 + 榜单 API 的 category1/category2 真实配对；标签池来自
-  作者专区标签系统快照（GitHub Lorn.NovelWriteSkills，2026-06，四组：风格/角色/
-  情节/背景）。级联表未覆盖的一级分类（出版类等非主赛道）二级宽松放行。
+数据来源（快照见 tools/fanqie_bookmeta.json / tools/qimao_bookmeta.json）：
+- 番茄·阅读标签：官方接口
+  https://fanqienovel.com/api/author/book/category_list/v0/?gender=1|0（匿名可用），
+  并与建书页弹层实抓逐词比对一致。弹层规则：主分类必选且只能选一个，
+  主题/角色/情节每组最多两个。男频/女频两套完全独立。
+- 番茄·内容标签：建书页「内容标签」弹层实抓，男女性共用一套；
+  情节/人设最多四个、情感最多两个、世界观最多一个。
+- 番茄·签约模式：建书表单真实选项为「连载模式/完本模式」。
+- 七猫：登录态下 book-option 接口实抓
+  https://zuozhe.qimao.com/api/pc/v1/book/book-option；频道（男生/女生）→一级→
+  二级级联为官方全量；作品标签四组（风格/角色/情节/背景），每组必选 1-3 个。
 
 改这些表不影响已保存任务（book_meta 生成时快照）。
 """
 
+# ================= 番茄·阅读标签（category_list API，弹层校验一致） =================
+
 # 番茄·男频主分类（gender=1）
 FANQIE_MALE_CATEGORIES = [
     "西方奇幻", "东方仙侠", "科幻末世", "男频衍生", "都市高武", "悬疑灵异",
@@ -19,7 +26,7 @@ FANQIE_MALE_CATEGORIES = [
     "都市修真",
 ]
 
-# 番茄·男频标签-主题组
+# 番茄·男频标签-主题组（最多选 2）
 FANQIE_MALE_TAGS_THEME = [
     "衍生", "仕途", "综影视", "天灾", "第一人称", "赛博朋克",
     "第四天灾", "规则怪谈", "搞笑轻松", "古代", "悬疑", "克苏鲁",
@@ -29,7 +36,7 @@ FANQIE_MALE_TAGS_THEME = [
     "历史", "体育", "武侠",
 ]
 
-# 番茄·男频标签-角色组
+# 番茄·男频标签-角色组（最多选 2）
 FANQIE_MALE_TAGS_ROLE = [
     "多女主", "赘婿", "全能", "大佬", "大小姐", "特工",
     "游戏主播", "神探", "贵族", "皇帝", "单女主", "校花",
@@ -37,7 +44,7 @@ FANQIE_MALE_TAGS_ROLE = [
     "学霸", "天才", "腹黑", "扮猪吃虎",
 ]
 
-# 番茄·男频标签-情节组
+# 番茄·男频标签-情节组（最多选 2）
 FANQIE_MALE_TAGS_PLOT = [
     "都市江湖", "风水秘术", "斩神衍生", "十日衍生", "西游衍生", "公版衍生",
     "红楼衍生", "甄嬛衍生", "如懿衍生", "惊悚游戏", "卡牌", "山海经",
@@ -63,7 +70,7 @@ FANQIE_FEMALE_CATEGORIES = [
     "年代", "种田", "快穿",
 ]
 
-# 番茄·女频标签-主题组
+# 番茄·女频标签-主题组（最多选 2）
 FANQIE_FEMALE_TAGS_THEME = [
     "古言权谋", "悬疑恋爱", "纯爱", "衍生", "仕途", "综影视",
     "天灾", "第一人称", "赛博朋克", "规则怪谈", "搞笑轻松", "古代",
@@ -72,7 +79,7 @@ FANQIE_FEMALE_TAGS_THEME = [
     "幻想言情",
 ]
 
-# 番茄·女频标签-角色组
+# 番茄·女频标签-角色组（最多选 2）
 FANQIE_FEMALE_TAGS_ROLE = [
     "位尊权重", "总裁", "忠犬", "全能", "白切黑", "双学霸",
     "作精", "大佬", "大小姐", "游戏主播", "神探", "贵族",
@@ -83,7 +90,7 @@ FANQIE_FEMALE_TAGS_ROLE = [
     "精灵", "天才", "腹黑", "扮猪吃虎", "团宠",
 ]
 
-# 番茄·女频标签-情节组
+# 番茄·女频标签-情节组（最多选 2）
 FANQIE_FEMALE_TAGS_PLOT = [
     "男二上位", "代嫁代娶", "攻略反派", "风水秘术", "斩神衍生", "十日衍生",
     "西游衍生", "公版衍生", "红楼衍生", "甄嬛衍生", "如懿衍生", "惊悚游戏",
@@ -103,85 +110,55 @@ FANQIE_FEMALE_TAGS_PLOT = [
     "穿越", "二次元", "娱乐圈", "空间", "推理",
 ]
 
-# 七猫·一级分类（官网书库筛选栏，23 个）
-QIMAO_MAIN_CATEGORIES = [
-    "现代言情", "古代言情", "幻想言情", "历史", "军事", "科幻",
-    "游戏", "游戏竞技", "玄幻奇幻", "都市", "奇闻异事", "武侠仙侠",
-    "体育", "N次元", "文学艺术", "人文社科", "经管励志", "经典文学",
-    "出版小说", "少儿教育", "衍生言情", "现实题材", "现实主义",
-]
+# ================= 番茄·内容标签（建书弹层实抓，男女性共用） =================
+
+# 内容标签-情节（最多选 4）
+FANQIE_CONTENT_PLOT = ["互撩", "和亲", "独宠", "攻略反派", "寄人篱下", "冷宫", "恋爱日常", "流放", "门阀斗争", "男二上位", "女扮男装", "强强", "深情错付", "失忆", "双向奔赴", "逃婚", "天作之合", "休夫", "休妻", "修罗场", "选秀入宫", "追妻火葬场", "双穿", "随军", "召唤流", "隐居", "异族入侵", "基因改造", "记忆篡改", "觉醒天赋", "时间循环", "封地", "古武传承", "争霸", "赶山赶海", "黑科技", "角色扮演", "家人曝光", "财运亨通", "变身", "经营建设", "挂机", "无后宫", "修改背景", "百鬼夜行", "抱大腿", "保家卫国", "爆装备", "避难所", "抄家", "吃瓜", "抽卡", "带货直播", "代嫁代娶", "古墓探秘", "打怪升级", "电竞", "第四天灾", "囤物资", "夺嫡", "读心", "发育", "捉鬼", "风水秘术", "分家", "复仇", "父凭子贵", "附身", "赶尸", "高考", "黑化", "黄昏恋", "欢喜冤家", "化身", "捡漏", "家长里短", "假结婚", "锦鲤", "基建", "绝不原谅", "绝症", "科举", "慢穿", "胎穿", "群穿", "古穿今", "两界穿梭", "恋综", "聊天群", "灵魂互换", "灵气复苏", "历劫", "历史直播", "美食", "民国传奇", "宝物秘境", "密室逃脱", "末世基建", "逆袭", "虐渣", "破案", "气运之子", "全民觉醒", "全民领主", "全民转职", "权谋", "全球灾变", "全员恶人", "全员火葬场", "驱魔降妖", "入魔", "商战", "升学", "收徒", "双修", "双重生", "逃荒", "推理", "无限流", "无限物资", "一夜情", "游戏入侵", "越狱", "致富", "转职", "追夫火葬场", "宗门大比", "末世种田", "退婚", "直播", "直播穿越", "鉴宝", "荒岛求生", "海洋求生", "豪门世家", "群像", "大逃杀", "多宝", "全民神祇", "公路求生", "全员重生", "游戏制作", "开局辞退", "旁门左道"]
+
+# 内容标签-情感（最多选 2）
+FANQIE_CONTENT_EMOTION = ["追夫", "死对头", "年龄差", "暗恋", "暗恋无果", "宠妻", "祈福联姻", "破镜不重圆", "奉子成婚", "破镜重圆", "青梅竹马", "闪婚", "双向暗恋", "相爱相杀", "先婚后爱", "隐婚", "一见钟情", "智性恋", "双宠", "年上", "老夫少妻", "水仙", "宠夫", "双洁", "救赎", "单箭头", "久别重逢", "无固定cp", "无CP", "1v1", "单女主", "无女主", "师徒", "病态依赖", "错位爱情", "姐弟恋", "浪子回头", "强娶豪夺", "日久生情", "家族联姻", "网恋", "人外恋", "替身", "白月光", "初恋", "多CP", "和离", "离婚", "虐恋情深", "女追男", "前任", "未婚夫", "未婚妻", "追妻", "道侣", "夫管严", "妻管严", "妾室"]
 
-# 七猫·一级→二级级联（已确认部分；未列出的二级宽松放行）
-QIMAO_CASCADE = {
-    "现代言情": [
-        "总裁豪门", "职场情缘", "民国旧影", "娱乐明星", "现实生活", "青春校园",
-        "年代重生", "都市奇幻", "现代悬疑",
-    ],
-    "古代言情": [
-        "种田经商", "宫闱宅斗", "古代情缘", "权谋天下", "武侠江湖", "远古大陆",
-        "古代悬疑",
-    ],
-    "幻想言情": [
-        "玄幻仙侠", "未来科幻", "无限快穿", "末世求生", "异世幻想",
-    ],
-    "都市": [
-        "明星娱乐", "乡村生活", "都市高武", "都市高手", "商战职场", "热血校园",
-        "都市生活", "灵气复苏", "官场",
-    ],
-    "玄幻奇幻": [
-        "东方玄幻", "异世大陆", "西方奇幻", "诸天万界", "王朝争霸",
-    ],
-    "奇闻异事": [
-        "侦探推理", "恐怖灵异", "寻宝探险", "奇门秘术",
-    ],
-    "武侠仙侠": [
-        "上古洪荒", "古典仙侠", "传统武侠", "幻想修真", "武侠幻想",
-    ],
-    "军事": [
-        "现代军事", "抗战烽火", "谍战特工", "战争幻想",
-    ],
-    "科幻": [
-        "星际机甲", "末世危机", "未来幻想",
-    ],
-    "游戏": [
-        "电子竞技", "虚拟网游",
-    ],
-    "游戏竞技": [
-        "网游电竞", "运动竞技",
-    ],
-    "体育": [
-        "其他竞技", "篮球风云", "足球天下",
-    ],
-    "N次元": [
-        "原生幻想", "衍生同人", "轻小说",
-    ],
-    "历史": [
-        "架空历史",
-    ],
+# 内容标签-人设（最多选 4）
+FANQIE_CONTENT_CHARACTER = ["马甲", "女主萌宝", "对照组", "太奶奶", "农女", "商女", "穿成女配", "老太太", "灰姑娘", "真假千金", "豪门千金", "金丝雀", "宠妃", "团宠", "佛子", "夫郎", "鬼夫", "精灵", "九千岁", "名媛", "王妃", "弃妃", "丫鬟", "主母", "总裁", "医妃", "非穿越重生", "皇叔", "位尊权重", "继室", "神豪", "勇者", "战神", "赘婿", "高手下山", "奶爸", "神医", "天才", "师尊", "娇妻", "真假少爷", "废材", "海后", "海王", "萌宝", "高智商", "富二代", "孤儿", "落魄千金", "养女", "暴君", "超凡者", "大魔王", "师兄", "嫡福晋", "恶毒女配", "反派", "高智反派", "贵妃", "后妈", "狐妖", "奸臣", "间谍特工", "老祖宗", "领主", "满级大佬", "美人鱼", "冥王", "魔尊", "女帝", "炮灰", "兽人", "网红", "王爷", "仙尊", "校霸", "邪神", "邪修", "修仙者", "吸血鬼", "玄学大佬", "阴妻", "知青", "阎王", "主神", "宗主", "双学霸", "学霸", "军嫂", "奶妈", "傻女", "职工", "非人类", "网红雇佣兵"]
+
+# 内容标签-世界观（最多选 1）
+FANQIE_CONTENT_WORLD = ["女尊", "兽世", "都市江湖", "军旅", "诸天万界", "洪荒", "乡村", "九叔", "规则怪谈", "惊悚游戏", "虫族", "仕途", "穿剧", "穿书", "位面", "港圈", "截教", "70年代", "80年代", "90年代", "港综", "韩娱", "机甲", "抗战", "历史演义", "赛博朋克", "丧尸", "神话复苏", "文娱", "综武", "宋朝", "清朝", "大秦", "三国", "大唐", "明朝", "宝可梦", "奥特曼", "火影", "西游衍生", "封神", "海贼王", "废土", "山海经", "综漫", "综影视", "星际", "四合院", "如懿衍生", "甄嬛衍生", "红楼衍生", "公版衍生", "十日衍生", "斩神衍生", "漫威", "龙珠", "龙族", "王者荣耀", "儒道", "末世冰封"]
+
+# ================= 七猫（book-option 接口实抓，官方全量） =================
+
+# 七猫·频道→一级→二级级联（男生 11 个一级 / 女生 6 个一级）
+QIMAO_CATS = {
+    "男生": {
+        "玄幻奇幻": ["东方玄幻", "异世大陆", "诸天万界", "王朝争霸", "西方奇幻"],
+        "都市": ["都市高手", "都市高武", "乡村生活", "热血校园", "商战职场", "明星娱乐", "都市生活", "灵气复苏", "官场"],
+        "奇闻异事": ["恐怖灵异", "奇门秘术", "侦探推理", "寻宝探险"],
+        "武侠仙侠": ["幻想修真", "上古洪荒", "古典仙侠", "武侠幻想", "传统武侠"],
+        "军事": ["现代军事", "抗战烽火", "战争幻想", "谍战特工"],
+        "历史": ["穿越历史", "架空历史", "历史传记"],
+        "游戏": ["虚拟网游", "电子竞技"],
+        "科幻": ["未来幻想", "末世危机", "星际机甲"],
+        "体育": ["篮球风云", "足球天下", "其他竞技"],
+        "N次元": ["原生幻想", "衍生同人", "轻小说"],
+        "现实题材": ["现实百态"],
+    },
+    "女生": {
+        "现代言情": ["总裁豪门", "职场情缘", "民国旧影", "娱乐明星", "都市奇幻", "年代重生", "青春校园", "现实生活", "现代悬疑"],
+        "古代言情": ["宫闱宅斗", "种田经商", "古代情缘", "远古大陆", "权谋天下", "武侠江湖", "古代悬疑"],
+        "幻想言情": ["玄幻仙侠", "异世幻想", "未来科幻", "无限快穿", "末世求生"],
+        "游戏竞技": ["运动竞技", "网游电竞"],
+        "衍生言情": ["次元衍生", "经典衍生"],
+        "现实主义": ["现实故事"],
+    },
 }
 
-# 七猫·作品标签池（四组，作者专区快照常用子集；校验宽松：池外不拒）
+# 兼容并集（男女生一级名互不重叠）：老调用方/模板扫描用
+QIMAO_MAIN_CATEGORIES = [m for ch in QIMAO_CATS.values() for m in ch]
+QIMAO_CASCADE = {m: subs for ch in QIMAO_CATS.values() for m, subs in ch.items()}
+
+# 七猫·作品标签四组（男女生频道同池），每组必选 1-3 个
 QIMAO_TAG_GROUPS = {
-    "风格": [
-        "热血", "轻松", "爽文", "甜宠", "虐恋", "悬疑",
-        "快节奏", "反套路", "第一人称", "种田", "权谋", "宫斗",
-        "宅斗", "美食", "经营", "克苏鲁", "规则怪谈", "无CP",
-    ],
-    "角色": [
-        "战神", "赘婿", "神医", "神豪", "奶爸", "女帝",
-        "嫡女", "真千金", "大女主", "兵王", "医生", "主播",
-        "总裁", "大佬", "学霸", "团宠", "萌宝", "反派",
-    ],
-    "情节": [
-        "系统", "金手指", "签到", "御兽", "重生", "穿越",
-        "穿书", "快穿", "逆袭", "开局流", "无敌流", "先婚后爱",
-        "追妻火葬场", "破镜重圆", "闪婚", "打脸虐渣", "马甲", "养成",
-    ],
-    "背景": [
-        "末世", "无限流", "玄学", "盗墓", "鉴宝", "娱乐圈",
-        "电竞", "官场", "架空历史", "三国", "大唐", "大明",
-        "大秦", "年代", "民国", "高武", "灵气复苏", "诸天万界",
-        "科幻", "赛博朋克", "校园", "都市", "乡村", "海岛",
-        "星际", "玄幻", "武侠", "仙侠",
-    ],
+    "风格": ["热血", "轻松", "暗黑", "现实题材", "虐恋", "治愈", "甜宠", "悬疑", "种田", "清穿", "宅斗", "宫斗", "中短篇", "青春", "军事", "爽文", "恐怖", "烧脑", "正剧", "商战", "权谋", "励志", "搞笑", "日常", "短篇", "短故事", "买股文", "第一人称", "纯爱", "快节奏", "反套路", "新疆现实题材", "国安现实题材"],
+    "角色": ["兵王", "护花高手", "仙帝", "学生", "赘婿", "神豪", "奶爸", "皇帝", "道士", "女总裁", "校花", "皇后", "王妃", "医妃", "公主", "嫡女", "庶女", "王爷", "太子", "首辅", "丑女", "大叔", "医生", "律师", "吸血鬼", "特工", "法医", "仵作", "女配", "全能", "杀伐果断", "霸道", "偏执", "忠犬", "残疾", "毒舌", "傲娇", "病娇", "萌宝", "龙", "僵尸", "欢喜冤家", "师徒恋", "弃少", "战神", "强强", "魔尊", "团宠", "特种兵", "暴君", "皇叔", "皇子", "摄政王", "奸臣", "世子", "锦衣卫", "太监", "女帝", "明星", "豪门总裁", "老师", "校草", "侦探", "警察", "主播", "少年", "师兄", "领主", "温柔", "呆萌", "可盐可甜", "娇媚", "绿茶", "铁血", "败家子", "弃妇", "女扮男装", "女尊", "女强", "替身", "二婚", "姐姐", "学霸", "天才", "杀手", "将军", "腹黑", "废柴", "反派", "扮猪吃虎", "智商在线", "真假千金", "咸鱼", "锦鲤", "小众职业", "双女主", "后妈", "哥哥", "黑莲花", "黑月光", "白月光", "书生", "糙汉", "老千", "渔女", "丞相", "驸马", "双洁", "作精", "外卖员", "丫鬟", "恶婆婆", "幕后BOSS", "奶团", "大女主", "主母", "妾室", "人间清醒", "无节操", "嘴炮", "痴情", "超A", "高冷", "财迷", "醋王", "万人迷", "戏精", "炮灰", "吃货", "旺夫", "美强惨", "顶流", "小狼狗", "反差萌", "心机", "暖男", "逗比", "毒医", "厨娘", "冰山", "古灵精怪", "宠妻", "黑化", "独宠", "御姐", "佛系", "神医", "真假少爷"],
+    "情节": ["鉴宝", "剑道", "透视", "美食", "无敌流", "争霸", "召唤", "盗墓", "快穿", "穿书", "随身空间", "契约婚姻", "娱乐圈", "穿越", "荒岛求生", "家族崛起", "逆袭", "强者回归", "一统天下", "直播", "聊天群", "红包", "御兽", "血脉", "武魂", "丹药", "风水", "青梅竹马", "破镜重圆", "替嫁", "闪婚", "隐婚", "逃婚", "致富", "错嫁", "先婚后爱", "脑洞", "进化", "吞噬", "影视", "无限流", "马甲", "开局流", "签到", "同人", "体育", "官场", "神祇", "修仙", "古穿今", "性转", "HE", "BE", "1V1", "姐弟恋", "相爱相杀", "追妻火葬场", "打脸虐渣", "暗恋", "日久生情", "一见钟情", "带球跑", "职场", "金手指", "异能", "技术流", "全球", "基建", "求生", "丧尸", "机甲", "网游", "游戏", "电竞", "篮球", "足球", "推理", "探险", "怪谈", "长生流", "国术", "古武", "战争", "魔法", "经典衍生", "奇闻异事", "前世今生", "重生", "系统", "复仇", "读心术", "恋综", "双男主", "无CP", "非典型修仙", "双重生", "诡异流", "爱国流", "单元故事", "迪化流", "灵魂互换", "克苏鲁", "稳健流", "扮演", "双向奔赴", "科技", "男二上位", "无女主", "单女主", "离婚后", "逃荒", "国运", "钓鱼", "恋爱", "群穿", "都市脑洞", "玄幻脑洞", "历史脑洞", "港综", "记忆曝光", "囤物资", "玄学", "模拟器", "相亲", "综艺", "规则怪谈", "黑道", "军婚", "谍战", "股海风云", "综武", "全家火葬场", "多女主", "多重人格", "全民", "宠夫", "NBA", "通古今", "全民领主", "草根崛起", "氪金", "荒野求生", "死对头", "天作之合", "婚恋", "双向救赎", "萌宠", "爆红", "失忆", "倒追", "修罗场", "崩人设", "偷听心声", "父子火葬场", "后悔流", "弹幕文", "万物沟通", "影视原著"],
+    "背景": ["诸天万界", "三国", "大唐", "水浒", "西游", "漫威", "火影", "海贼王", "英雄联盟", "绝地求生", "王者荣耀", "武侠", "灵气复苏", "神奇宝贝", "奥特曼", "末世", "洪荒", "玄幻", "仙侠", "异界", "西幻", "奇幻", "都市", "年代", "民国", "校园", "古代", "架空历史", "远古", "星际", "历史", "大明", "乡村", "未来世界", "科幻", "精灵鬼怪", "红楼", "封神", "天庭", "卡牌", "神话", "哈利波特", "假面骑士", "龙珠", "游戏衍生", "动漫衍生", "影视衍生", "现代言情", "古代言情", "幻想言情", "高武", "四合院", "兽世", "大秦", "原神", "我的世界", "铠甲勇士", "超神学院", "柯南", "抗战", "宋朝", "赛博朋克", "惊悚世界", "崩坏星穹铁道", "衍生言情", "传统玄幻"],
 }

package/app/core/builtin_agent.py

@@ -11,20 +11,29 @@
 """
 from __future__ import annotations
 
+import base64
+import io
 import json
+import mimetypes
 import os
 from pathlib import Path
 
-from . import modelhub
+from . import modelhub, runner
 
 MAX_TOOL_ITERS = 16          # 单步工具循环上限（防模型打转）
 READ_MAX_BYTES = 64 * 1024   # read_file 单次读取上限
 LIST_MAX_ENTRIES = 200
+MAX_IMAGES = 8                 # 单次最多随消息传几张图（请求体防爆）
+IMAGE_MAX_EDGE = 1568          # 长边上限（视觉模型通行建议值，超出等比缩）
+IMAGE_JPEG_BYTES = 3500 * 1024   # 缩放后仍超此大小 → 转 JPEG q85
+IMAGE_MAX_BYTES = 5 * 1024 * 1024   # 单张最终字节硬上限（超出剔除并日志）
 
 _SYSTEM_PROMPT = """你是 CodeBee 的内置执行智能体，直接完成用户交代的任务。用户的目标、背景与工作目录内的附件就是全部输入。
 
 ## 工作方式
 - 需要读文件、看目录、写文件时调用工具；所有路径都是工作目录内的相对路径。
+- read_file 只能读文本文件；图片、压缩包等二进制文件读不了，如实告知用户即可，不要反复尝试。
+- 用户消息中的图片附件会直接出现在对话里，可直接看图作答，无需用工具读取。
 - 产出文件一律 UTF-8 编码。
 - 回答用户的语言与用户一致（默认中文）。直接给结论和内容，不要输出任何机器标记或协议行。"""
 
@@ -90,6 +99,131 @@ def _tool_list_files(workdir, args):
     return "\n".join(out) or "（空目录）"
 
 
+_BIN_MAGIC = (
+    (b"\x89PNG\r\n\x1a\n", "PNG 图片"),
+    (b"\xff\xd8\xff", "JPEG 图片"),
+    (b"GIF8", "GIF 图片"),
+    (b"%PDF-", "PDF 文档"),
+    (b"PK\x03\x04", "ZIP 压缩包"),
+    (b"\x1f\x8b", "GZIP 压缩包"),
+    (b"7z\xbc\xaf\x27\x1c", "7z 压缩包"),
+    (b"Rar!\x1a\x07", "RAR 压缩包"),
+    (b"\x00\x00\x01\x00", "ICO 图标"),
+    (b"OggS", "OGG 音频"),
+    (b"ID3", "MP3 音频"),
+)
+
+
+def _bin_format(head):
+    """常见二进制魔数 → 人类可读格式名（写进给模型的提示，让它立刻止损）。"""
+    if len(head) >= 12 and head[:4] == b"RIFF":
+        return {"WEBP": "WEBP 图片", "WAVE": "WAV 音频",
+                "AVI ": "AVI 视频"}.get(head[8:12].decode("ascii", "replace"),
+                                        "RIFF 媒体")
+    if len(head) >= 8 and head[4:8] == b"ftyp":
+        return "MP4/MOV 视频"
+    for magic, name in _BIN_MAGIC:
+        if head.startswith(magic):
+            return name
+    return "二进制文件"
+
+
+def _looks_binary(head):
+    """文本判定从宽：NUL 字节即判二进制（git 同款启发式），控制字符占比兜底
+    （部分二进制头 8KB 内无 NUL）。"""
+    if not head:
+        return False
+    if b"\x00" in head:
+        return True
+    sample = head[:8192]
+    ctrl = sum(1 for b in sample if b < 32 and b not in (9, 10, 12, 13))
+    return ctrl * 20 > len(sample)   # >5% 视为二进制
+
+
+def _trim_partial_utf8(chunk):
+    """头部截断可能把多字节字符切成两半：剥掉尾部不完整序列，否则 UTF-8
+    strict 失败会误落 GBK 解出错字（runner.tail_decoded 的头截断对偶）。"""
+    i = len(chunk) - 1
+    while i >= 0 and i >= len(chunk) - 3 and (chunk[i] & 0xC0) == 0x80:
+        i -= 1
+    if 0 <= i < len(chunk):
+        b = chunk[i]
+        need = 4 if (b & 0xF8) == 0xF0 else 3 if (b & 0xF0) == 0xE0 \
+            else 2 if (b & 0xC0) == 0xC0 else 1
+        if len(chunk) - i < need:
+            return chunk[:i]
+    return chunk
+
+
+def _guess_image_mime(path, raw=b""):
+    m = mimetypes.guess_type(str(path))[0]
+    if m:
+        return m
+    if raw.startswith(b"\x89PNG"):
+        return "image/png"
+    if raw.startswith(b"\xff\xd8"):
+        return "image/jpeg"
+    if raw.startswith(b"GIF8"):
+        return "image/gif"
+    if raw.startswith(b"RIFF"):
+        return "image/webp"
+    return "image/png"
+
+
+def _prep_images(paths, log=None):
+    """图片路径 → [(mime, b64)]。Pillow 可用时：长边超 1568px 等比缩（万级像素
+    原图既烧 token 又常被网关拒），仍超 3.5MB 转 JPEG q85；Pillow 缺失或解码
+    失败时原图直传，单张超 5MB 剔除并日志。最多 MAX_IMAGES 张。"""
+    try:
+        from PIL import Image
+    except Exception:
+        Image = None
+    out = []
+    for p in (paths or [])[:MAX_IMAGES]:
+        try:
+            raw = Path(p).read_bytes()
+        except OSError:
+            if log:
+                log("[图片] 跳过（读取失败）: %s" % os.path.basename(str(p)))
+            continue
+        mime = _guess_image_mime(p, raw)
+        data = raw
+        if Image is not None:
+            try:
+                im = Image.open(io.BytesIO(raw))
+                im.load()
+                w, h = im.size
+                edge = max(w, h, 1)
+                if edge > IMAGE_MAX_EDGE:
+                    r = IMAGE_MAX_EDGE / float(edge)
+                    im = im.resize((max(1, round(w * r)), max(1, round(h * r))),
+                                   Image.LANCZOS)
+                fmt = {"image/png": "PNG", "image/jpeg": "JPEG",
+                       "image/gif": "GIF", "image/webp": "WEBP"}.get(mime, "PNG")
+                buf = io.BytesIO()
+                im.save(buf, format=fmt)   # GIF 多帧仅存首帧，可接受
+                data = buf.getvalue()
+            except Exception:
+                data = raw                 # 解码/编码失败退回原始字节
+        if (Image is not None and mime != "image/jpeg"
+                and len(data) > IMAGE_JPEG_BYTES):
+            try:                           # 仍过大：转 JPEG q85（RGB 拍平 alpha）
+                im = Image.open(io.BytesIO(data)).convert("RGB")
+                buf = io.BytesIO()
+                im.save(buf, format="JPEG", quality=85)
+                data = buf.getvalue()
+                mime = "image/jpeg"
+            except Exception:
+                pass
+        if len(data) > IMAGE_MAX_BYTES:
+            if log:
+                log("[图片] 剔除（过大 %d MB）: %s"
+                    % (len(data) // (1024 * 1024), os.path.basename(str(p))))
+            continue
+        out.append((mime, base64.b64encode(data).decode("ascii")))
+    return out
+
+
 def _tool_read_file(workdir, args):
     rel = str(args.get("path") or "").replace("\\", "/").strip("/")
     if not rel or ".." in Path(rel).parts or any(":" in seg for seg in Path(rel).parts):
@@ -102,7 +236,25 @@ def _tool_read_file(workdir, args):
         return "（文件不存在: %s）" % rel
     data = p.read_bytes()[:READ_MAX_BYTES + 1]
     truncated = len(data) > READ_MAX_BYTES
-    text = data[:READ_MAX_BYTES].decode("utf-8", "replace")
+    head = data[:READ_MAX_BYTES]
+    if not head:
+        return "（空文件）"
+    if _looks_binary(head):
+        try:
+            size = p.stat().st_size
+        except OSError:
+            size = len(head)
+        fmt = _bin_format(head)
+        if "图片" in fmt:
+            return ("（图片文件: %s — %s，%d B，无法按文本读取。用户以附件发来的图片会"
+                    "直接出现在对话中，无需用工具读取；若需要目录里这张图的内容，"
+                    "请提示用户把它作为附件发送。）" % (rel, fmt, size))
+        return ("（二进制文件，无法按文本读取: %s — %s，%d B。read_file 只支持文本文件；"
+                "请如实告知用户该文件内容无法以文本方式查看，不要反复重读。）"
+                % (rel, fmt, size))
+    if truncated:
+        head = _trim_partial_utf8(head)
+    text = runner.decode_output(head)
     return ("…（超过 64KB 已截断）\n" if truncated else "") + text
 
 
@@ -123,7 +275,7 @@ def _tool_write_file(workdir, args):
 TOOLS_SPEC = [
     {"name": "list_files", "description": "列出工作目录（或其子目录）下的文件",
      "args": {"path": "子目录相对路径，留空=根目录"}},
-    {"name": "read_file", "description": "读取工作目录内一个文本文件（UTF-8，超 64KB 截断）",
+    {"name": "read_file", "description": "读取工作目录内一个文本文件（UTF-8/GBK 自动识别，超 64KB 截断；图片等二进制文件无法读取）",
      "args": {"path": "文件相对路径"}},
     {"name": "write_file", "description": "把文本内容写入工作目录内一个文件（UTF-8，父目录自动创建）",
      "args": {"path": "文件相对路径", "content": "完整文本内容"}},
@@ -182,6 +334,13 @@ def _m_openai(m):
     if m["role"] == "tool_results":
         return [{"role": "tool", "tool_call_id": cid, "content": text}
                 for cid, text in m["tool_results"]]
+    imgs = m.get("images") or []
+    if imgs:   # 多模态：content 变数组，图跟在文本后（role=tool 只收文本，故图只走 user）
+        content = [{"type": "text", "text": m.get("content") or ""}]
+        content += [{"type": "image_url",
+                     "image_url": {"url": "data:%s;base64,%s" % (mime, b64)}}
+                    for mime, b64 in imgs]
+        return {"role": "user", "content": content}
     return {"role": "user", "content": m.get("content") or ""}
 
 
@@ -198,6 +357,13 @@ def _m_anthropic(m):
         return {"role": "user", "content": [
             {"type": "tool_result", "tool_use_id": cid, "content": text}
             for cid, text in m["tool_results"]]}
+    imgs = m.get("images") or []
+    if imgs:
+        blocks = [{"type": "text", "text": m.get("content") or ""}]
+        blocks += [{"type": "image",
+                    "source": {"type": "base64", "media_type": mime, "data": b64}}
+                   for mime, b64 in imgs]
+        return {"role": "user", "content": blocks}
     return {"role": "user", "content": [{"type": "text", "text": m.get("content") or ""}]}
 
 
@@ -210,9 +376,15 @@ def _build_request(proto, base, use_key, model, system, msgs, with_tools):
         else:
             url = base + "/v1beta/models/%s:generateContent" % model
         headers = {"x-goog-api-key": use_key}
-        contents = [{"role": ("user" if m["role"] == "user" else "model"),
-                     "parts": [{"text": m.get("content") or ""}]}
-                    for m in msgs if m["role"] in ("user", "assistant")]
+        contents = []
+        for m in msgs:
+            if m["role"] not in ("user", "assistant"):
+                continue
+            parts = [{"text": m.get("content") or ""}]
+            parts += [{"inline_data": {"mime_type": mime, "data": b64}}
+                      for mime, b64 in (m.get("images") or [])]
+            contents.append({"role": ("user" if m["role"] == "user" else "model"),
+                             "parts": parts})
         body = {"contents": contents,
                 "systemInstruction": {"parts": [{"text": system}]},
                 "generationConfig": {"maxOutputTokens": 8000}}
@@ -291,10 +463,11 @@ def _parse_reply(proto, data):
 
 # ---------------------------------------------------------------- 主循环
 
-def run(bi, prompt, workdir, timeout=180, cancel_event=None, log=None):
+def run(bi, prompt, workdir, timeout=180, cancel_event=None, log=None, images=None):
     """跑一次内置智能体（内部自带工具循环直到给出最终回答）。
 
     bi: resolve() 的返回；prompt: 本轮完整输入（目标/续轮块由 pipeline 拼）；
+    images: 用户随本轮消息提供的图片绝对路径列表（任务附件/对话追话）；
     log: 追加一行日志的回调（步骤日志）。返回 runner 风格统一结果：
     {ok, text, usage, error, model, provider_name, provider_id, iterations, cost_usd}。
     """
@@ -302,7 +475,16 @@ def run(bi, prompt, workdir, timeout=180, cancel_event=None, log=None):
     model = bi["model"]
     allow_private = bool(prov.get("allow_private"))
     system = _SYSTEM_PROMPT + "\n\n## 工作目录\n%s" % os.path.abspath(workdir or ".")
-    msgs = [{"role": "user", "content": prompt}]
+    imgs = _prep_images(images, log) if images else []
+    if imgs and not modelhub._model_image_in(prov, model):
+        # 能力闸门：模型未声明图片输入就不塞图（网关多半会拒），改为显式告知
+        if log:
+            log("[图片] 模型 %s 未开启图片输入，%d 张图不随消息发送" % (model, len(imgs)))
+        prompt = ("（用户提供了 %d 张图片，但当前模型未开启图片输入；请在回答开头提示用户"
+                  "到绑定页为该模型开启「图」开关，或改绑多模态模型。本条回答请基于"
+                  "文字部分完成。）\n\n%s" % (len(imgs), prompt))
+        imgs = []
+    msgs = [{"role": "user", "content": prompt, "images": imgs}]
     candidates = list(modelhub._protocol_candidates(prov))
     tools_ok = all(proto != "google" for proto, _ in candidates)   # google wire 无工具协议
     total_usage = {"input": 0, "cached": 0, "output": 0, "total": 0}