funx

① 不带 <?php 头；
② 正文里不能出现连续的 TYPE_HEX（会触发 gohex 放行，见 tempx 备注）；
③ 不能写正则（preg_* 相关会被 mkstr 的字符替换搞坏）；
④ % 后面必须跟空格或括号（%s 会被当成 printf 占位炸掉）；
⑤ 裸单引号用 dyh() 拼（'abc'.dyh().'def'），别直接写 '。

fn=<函数名> —— 整段替换函数正文（最常用）
fn=<键>@<表>.<列> —— 只改某一行的某一列
fn=SNO:<主键>.<列>@<表> —— 按主键精确定位改列

提交后必须重新取回端点内容比对字节数，别信返回的成功字样。

'→ノ　&→δ　+→＋　=→＝　?→'+String.fromCharCode(65311)+'　\→↘（且会被删光）　换行→卍　«»→<?php ?>

所以中文内容一律走 HEX（dTYPE:HEX:<hex>），明文提交英文代码也要避开上面这些字符。

在 funx 正文里先 header('Content-Type: text/css')（或 application/javascript），再用 nowdoc 把整份样式/脚本原样 echo 出来，这个 funx 就成了一个可被 <link> / <script> 引用的端点。

这是云酷德里「公共样式/公共脚本」的正确做法——不要往服务器上 FTP 传文件（铁哥规矩：服务器上的资源要用系统方法生成）。
本 SDK 的 xianfacss / xianfajs 就是这么来的。

现在函数端点统一是 /localxres/funx/<函数名>/。
旧资料里的 /DNA/EXF/anyfuns.php?fid=xxx → 等价新地址 /localxres/funx/<xxx>/。看到旧写法直接换算，别照抄。

入口就一个：/localxres/funx/askapi/，靠 optype + stype 两个参数走遍 26 种资源。 它不该问「这个资源要填哪些字段」——答案在两张表里：
coode_asklist（140 条，datamark=<类型码>_<操作>，记录作用主表、定位键 qrykey）
coode_askkey（1271 条，同 datamark 逐字段记录字段名、中文名、fromurl）。

六个 optype：crtres 新建 / fullinfo 改多字段 / view 读一条 / viewext 读扩展 / setbtn 按钮写值 / mkfile 生成落盘文件。

两条硬规律：
① 26 种资源的 crtres 都只要四样：定位键 + 标题 + sysid（公共填 0）+ srctype（填类型码）。 其余字段建完再用 fullinfo 补。
② fromurl 三种值要分清：GET=从 URL 取值、POST=从表单体取值、 VIEW=只展示不写库。crtres 会跳过 VIEW 字段，所以刚建出来的记录这些列是空的——这不是 bug，是提醒你接着走 fullinfo。

crtres 内部还会自动做三件事：补 OLMK,CRTOR,CRTM,UPTM；给 coode_devespace 放开发权限； tempx 特判把复合唯一键拆成 domainmark / unitmark；遇到 UNIQUE 列缺失自动塞 onlymark()。
重复创建会回 status=0「资源已存在」——别硬插，改值走 fullinfo / setbtn。

查某资源某操作有哪些可写字段，直接 SQL：
select keyname,keytitle,fromurl,keytype from coode_askkey where datamark='<类型码>_fullinfo' order by SNO;

症状：savefunc 返回 status=1 提交成功，目标字段字节数都没变。别去查 STATUS / CRTOR / devespace —— 那些不是障碍（coode_keydetailx 整表 STATUS 全是 0 照样能改）。真因一定是 fn 顺序：必须是 表名@SNO:x.字段，写反成 SNO:x.字段@表名 时源码会把表名解析成 SNO:x，拼出非法 SQL，被 UX() 吞掉后照样打印成功。自查：拿 1 行试提交，回读比对字节数，没变就是没写进去。另一个隐蔽点：HEX 编码的列用 SQL LIKE 搜不到明文。

需求：搞清 funx 脚本编辑器（htmleditor）到底怎么把代码存进去 —— 铁哥 2026-10-01 要求「两大编辑器的保存参数永久强烈记忆」。

编辑器地址：/localxres/pagex/htmleditor/WrvLoe/index.html?funid=tdfind 　funid = 函数名；改函数集时写 <表>@SNO:<主键>.<字段>。

真实提交串（把编辑器 scriptx.js 从库里 gohex 解码后读出来的原文）：

fmtxt = mkstr(fmtxt);
ajaxhtmlpost("//"+domain+"/localxres/funx/savefunc/?parall="+parallel+"&fn="+GetRequest().funid,
             "dt="+fmtxt);

拆开就是：POST 到 savefunc；GET 参数只有 parall 与 fn， fn 直接等于 funid 的原值、不做任何加工；POST 体只有一个字段 dt，且必须先过 mkstr()。

mkstr 在哪：/localxres/formx/coodesys/js/coode.min.js（约 L116217）。 它把单引号、和号、加号、等号、问号、反斜杠、换行换成 ノ δ ＋ ＝ '+String.fromCharCode(65311)+' ↘ 卍 这类安全字符； 服务端 unstrs()（EARTH.php:1029）做逆变换。自己写脚本提交时必须实现同款 mkstr， 否则特殊字符整篇错位。

顺序坑：编辑器 funid 是「表在前」<表>@SNO:<n>.<字段>， 而 SDK 里 savefunc 常用的 fn 写法是「SNO 在前」SNO:<n>.<字段>@<表> —— 两者顺序相反，编辑器这边是把 funid 原样塞给 fn。

铁哥当面纠正的一句话：「savefunc 不可用直接改库，文件也得改啊，访问的是文件」。 正解是：savefunc 本来就两件一起做 —— 写库 coode_funlist.funfull（gohex 编码） + 落盘 /localxres/funx/<fn>/index.php（自动套 23 行模板头）。 所以别手工改库、也别手工改盘，老老实实走 savefunc 就是唯一正路； 只有源码里躲不开反斜杠/正则时才降级到 SFTP 双写，且做完必须验收。

回执不可信：savefunc 结尾无条件 echo makereturnjson("1","提交成功","")， 从不查 insert/update 返回值 —— 提交完一定查库验收（见下一条 unhex 铁律）。

这是我在 coode 上栽过的最狠一跟头，2026-10-01 亲历，写完必须刻进骨头里。

现象：用 savefunc 提交完 funx.tdfind 的新版本，回执「提交成功」， 但我拿明文去库里搜特征串 samples 却一条也搜不到， 于是判定「这个老函数写不进去」，反手一条 UPDATE coode_funlist SET funfull=<明文> 把它「补」上 —— 结果是把 savefunc 刚写进去的正确版本整个覆盖掉了。最后靠 oldfull （写入前那份快照）才捞回来。

原因：coode_funlist.funfull 存的是 TYPE:HEX: 前缀 + 十六进制（顶层是 dTYPE:HEX:）， 换行还是字面 4 字符 ，而且不带磁盘那份模板头。 拿明文去 LIKE 搜索，当然永远搜不到 —— 不是没写进去，是我没解码。

正确验收姿势（三步，缺一不可）：

raw = row['funfull']        # 形如 dTYPE:HEX:xxxx 或明文
txt = unhex(raw)            # 有前缀才解 hex；解完再把 '
' 还原成真换行
ok  = ('samples' in txt) and ('stat' in txt)

再配合长度对比判断到底有没有更新（实例：funfull 6070→7094 字节， 解码后 3130→3294 字符）。长度变化比 status 可靠一万倍。

同一个坑在 tempx 侧又踩了一次：拿明文搜 coode_domainunit.scriptx 里的 album 搜不到，以为线上页面还是旧版；unhex 后确认 「解码 5953 字符，含 album=True 含 groups=True」，页面本来就是新的 —— 白紧张一场。

磁盘那份才是真身：/localxres/funx/<fn>/index.php （含模板头、CRLF、属主 www:www），HTTP 访问执行的是它。判断「线上跑的到底是哪版」 要 curl 落点文件，别只看库。

保命习惯：动任何已存在的 funx 之前，先把 funfull / oldfull / lastfull 三个版本拉下来存本地，出事能秒回退。

一句话总结：coode 的老接口普遍「裸拼 SQL + 无条件返回成功」， 唯一可信的验收是「解码后查库比对」。

铁哥 2026-10-01 定的铁律：「以后只要涉及 tempx、funx 如何传参保存， 就找各自的前端编辑器页面重新寻找实现过程」。

为什么：编辑器会升级、参数会变，SDK 和技能里记的那串可能已经过期。 所以提交前的第一步不是写代码，是把编辑器源码拉下来看它现在到底怎么提交的。

一键工具（已落地）：

python ~/.workbuddy/skills/coode-tempx/scripts/editorsrc.py --which funx
python ~/.workbuddy/skills/coode-tempx/scripts/editorsrc.py --which tempx
python ~/.workbuddy/skills/coode-tempx/scripts/editorsrc.py --unit pagex:htmleditor.index

它把编辑器各字段（scriptx / stylex / casecode …）gohex 解码后落盘， 再打印所有「保存相关」代码段：端点 URL、参数名、是否用 mkstr。

编辑器在哪（别找错表）：

① funx 编辑器 = pagex 资源，在 coode_unittiny 里， dumark='htmleditor.index'，中文名「网页代码编辑器」， 访问 /localxres/pagex/htmleditor/WrvLoe/index.html?funid=<名>。 ⛔ 不在 coode_domainunit 里 —— 找错表会以为它不存在。

② tempx 编辑器 = tempx 资源，在 coode_domainunit 里，dumark='tempeditor.index'。

现场扒出来的 funx 编辑器分支（2026-10-01，原文 L29~L33）：

if (GetRequest().funid!="" && typeof(GetRequest().funid)!="undefined")<
   bkrst=ajaxhtmlpost("//"+domain+"/localxres/funx/savefunc/?parall="+parallel+"&fn="+GetRequest().funid,"dt="+fmtxt);
>else<
   bkrst=ajaxhtmlpost("//"+domain+"/localxres/funx/saveclsc/?fn="+GetRequest().clsid,"dt="+fmtxt);
>

⭕ 新发现第三条分支：带 ?clsid= 打开时存的是类（clsx）， 走 saveclsc/?fn=<clsid>，POST 体同样是 dt=mkstr(正文)。 （另 L47 / L56 / L64 是试运行，不保存。）

一句话：以脚本打印出来的串为准，别照抄任何旧记忆。

铁哥 2026-10-01 定的规矩：「以后传网址可以用 makeviewurl、unviewurl 方法」。

为什么需要：把一个网址当参数传（如 ?u=<另一个网址>）时， 里面的 ? & = 会把外层 query string 截得七零八落 —— & 直接变成外层的新参数。coode 的既定解法就是这两个核心函数。

它们是什么（localxres/EARTH.php 里的核心函数，funx 里直接调，不用 include）：

makeviewurl($urlx)   // 发出去之前：? & =  换成  @@@ * $
unviewurl($urly)     // 收到之后：@@@ * $  换回  ? & =

变换后字符串里再没有 ? & =，可以安全塞进任何 query 参数值里，连 urlencode 都不用。

用法模板：

// ① 生成端
$px="/localxres/funx/tdimgpx/?u=".makeviewurl($u);
// ② 接收端（第一件事就是还原）
$u=_get("u"); if($u=="")<$u=_post("u");> $u=unviewurl($u);

边界（实测）：

⛔ 不处理中文 —— 只换那三个字符，中文原样保留。浏览器会自己 percent-encode， PHP 的 $_GET 拿到解码后的中文，没问题； 但服务端拿这个网址去 curl 取图时，路径要自己 rawurlencode（逐段编码）。

⛔ 别再整体 urlencode($u) —— 铁哥要的是系统自带的这套； 而且 % 在传输链路里本来就易出事。

实战出处：funx.tdimgpx（2026-10-01 建，千机连）—— 图库图片代理。 前台只调 https://本站/localxres/funx/tdimgpx/?u=<makeviewurl后的图址>&t=1， 后台 curl 取图吐流，用来绕开图库域名 https 证书过期导致的前台图片加载失败。 实测：缩略图 17113 字节、原图 192720 字节，中文路径与含 ? 的裁剪链接都正常。

一、PRIME = 测试集「代数」（2026-10-01 铁哥定，只能整数）

dbvideo_piccool.PRIME（coode 里中文名「素数定类」）在本项目里当测试集代数用：

值	含义
0	不在测试集
1	第 1 代测试集（对应 td1.2 算法）
2	第 2 代测试集（对应 td1.3 算法）
N	以后每换一版算法 +1

⛔ 算法版本号不进 PRIME —— 它写在 tdver（字符串 'td1.2'/'td1.3'），两码事。 铁哥原话：「这个 prime 只能设置成整数，小数不可以」。

升代流程：老标记全归 0 → 用新算法重跑 → 跑完标新代数。

二、代数必须由后台决定，页面不许写死

铁哥原话：「tempx 代码也得改一下，你可以改成后台决定输出 prime=多少」。

做法（funx.tdfind）：

$rx = SX("select max(PRIME) as g from dbvideo_piccool");
$gen = anyvalue($rx, "g", 0);        // 当前代 → stat / samples 都跟着它走

• act=stat 返回 gen；act=samples 也返回 gen；
• 页面 JS 拿 j.gen 显示「① 样图库（第 N 代）」——升代不用改页面；
• 挑测试集：python tdpage2.py prime --gen=2。

⛔ 踩过的坑：gen=0（还没标过任何一代）时如果直接拼 where PRIME=$gen，等于 PRIME=0 → 命中全表 19.7 万张， 统计会出现「样图集 197705 张」，跑批后还会把非测试集的图全倒给页面。 正解：gen<=0 时直接返回空 / 报 0。

三、查图只认向量，语义另走一条路（2026-10-01 铁哥定）

铁哥原话：「语义判断不应该放在拍照图片的识别里，语义可以作为语义检索配合，这个查图应该主要看向量。」

排序本来就是纯向量（score_pair），问题在展示层——结果卡把 AI 图注放在主位， 让人以为在做语义匹配。改法：

1. tdserve.py 新增 score_parts(A,B)，把总分拆成 align（杆间位置关系） 和 dir（纯方向直方图余弦），接口逐条透传；
2. 结果卡主展示 相似度 + 向量证据（位置关系/方向一致）， AI 图注降为小灰字并标注「仅供参考，不参与匹配」；
3. 样图库卡、目标样图卡不再显示图注（那只是干扰判断的文字）；
4. 新增独立 ③ 语义检索 Tab：funx.tdfind?act=sem&kw=关键词， 按 deswords LIKE 查。它代表「文字上相关」，不代表图像相似，与②互不掺。