★ 宪法总纲:编辑任何资源的唯一正确姿势

★ 建站顺序另见《云酷德建站流程法》(tempx buildlaw.index,打开章程,2026-10-05 定稿):先名后形 → 计划六表 → 补正 → 开工 → newresname 建名 → 照 funtxt 施工 → samekdatatotab 回填 → 验收。

以前文档里写的是「直接调 API 接口」——那是旧约,作废。所有资源的增删改,一律按下述六步走。

  1. 先登录,拿三件套
    GET 本站域名/localxres/funx/commonlogin/?uid=<账号>&pass=<makepass密文>&sysid=<系统id>
    返回 JSON 的 msg 就是 stoken。随后 Cookie 必须带 三个值:uid、stoken、deadline=time()+3600*72。
    坑:只带 uid+stoken、不带 deadline,会被 heartbeat 的 $leftt>0 拦掉,现象是 302 静默跳转,接口返回空。
  2. 建资源名
    funx.newresname?restype=<类型>&rescode=<域.名>&sysid=<系统>&restitle=<标题>
    Cookie 里的 uid 在 coode_userlist 中必须 PRIME=1。tempx 的 rescode 若含点号,点前是域、点后是单元名;不含点号则自动补 .index。
  3. 查编辑器地址
    到 coode_sysrestypedefine 按 restypecode 查 cloudpath 字段——它就是该类型资源的编辑器地址。
    分水岭:cloudpath 值为 mysql 的,说明这类资源基本不落盘,可以直接改数据;值是一条 URL 的,说明会落盘,必须进编辑器改,直接改库会造成库盘不一致。
  4. 打开编辑器
    编辑器地址不用猜、不用记——去 coode_sysrestypedefine 找到该 restypecode 那一行,读它的 cloudpath 字段,那就是现成的完整编辑器地址,? 后面已经把参数位留好了;你要做的只是把占位符换成资源名或该数据的 SNO 序号。
    三个完整地址示例:
    https://qianjilian.com/localxres/tempx/tempeditor/index.html?unitid=xianfa.index
    https://qianjilian.com/localxres/pagex/htmleditor/WrvLoe/index.html?funid=savefunc
    https://qianjilian.com/localxres/pagex/htmleditor/WrvLoe/index.html?funid=coode_funsetfile@SNO:12345.funfull
  5. 编辑器里能调哪些后端方法
    由 coode_funlist 的 usearea 字段声明:它写明该方法允许被哪个页面调用,形如 tempx.tempeditor.index。
    heartbeat 会把 HTTP Referer 解析成 pgmark(资源类型.目录.单元),拿它和 usearea 比对,不匹配直接判无权。所以「在哪个页面里调」不是形式,是权限本身。
    usearea 为空 = 不限制来源,可从外部调用(如 newresname、savetoseed、makelayfolder)。
  6. 鉴权在哪
    数据集 heartbeat 的 refreshtoken 方法:校验 stoken 是否有效、刷新 coode_loginstoken 有效期、并下发 deadline。所有「为什么明明登录了还是没权限」的答案都在这里。

26 类资源:编辑器完整地址 / 能不能直接改库

下表「编辑器 / 落点」列即 coode_sysrestypedefine.cloudpath 的值(已补全域名前缀),可直接复制使用。

类型主表编辑器 / 落点(完整地址)
funx 函数coode_funlisthttps://qianjilian.com/localxres/pagex/htmleditor/WrvLoe/index.html?funid=<函数名>
clsx 类coode_phpclshttps://qianjilian.com/localxres/pagex/htmleditor/WrvLoe/index.html?funid=<类名>
sfunx 函数集coode_funsetfilehttps://qianjilian.com/localxres/pagex/htmleditor/WrvLoe/index.html?funid=coode_funsetfile@SNO:<该数据序号>.funfull
dfunx 数据函数coode_datafunhttps://qianjilian.com/localxres/pagex/htmleditor/WrvLoe/index.html?funid=coode_funsetfile@SNO:<该数据序号>.funfull
constx 静态量coode_sysconstanthttps://qianjilian.com/localxres/pagex/htmleditor/WrvLoe/index.html?funid=coode_funsetfile@SNO:<该数据序号>.funfull
configx 系统参数coode_sysconfighttps://qianjilian.com/localxres/pagex/htmleditor/WrvLoe/index.html?funid=coode_funsetfile@SNO:<该数据序号>.funfull
tempx 模板coode_domainunithttps://qianjilian.com/localxres/tempx/tempeditor/index.html?unitid=<域.单元>
pagex 页面coode_tinyhttps://qianjilian.com/localxres/tempx/tinylayeditor/index.html?unitid=<域.单元>&tinyid=<tinymark>
mfunx 分布函数coode_multifunlisthttps://qianjilian.com/localxres/tempx/tinylayeditor/index.html?unitid=resuptool.index&tinyid=o16CUI
tabx 表coode_tablisthttps://qianjilian.com/localxres/funx/anyjsshort/?stid=2qPIqS-sfile:anyjsshort.php-&pnum=150:<表名>&page=1:TABLE_NAME&
formx 表单coode_shortdatahttps://qianjilian.com/localxres/funx/anyjsshort/?datatype=html&stid=keydtly-&pnum=100:<shortid>&page=1:shortid&
dataspacex 数据空间coode_dataspacehttps://qianjilian.com/localxres/tempx/dspcmgr/index.html
sysx 系统容器coode_sysinformationmysql:不落盘,可直接改库
appx 应用容器coode_appdefaultmysql:不落盘,可直接改库
layx 输出容器coode_applaymysql:不落盘,可直接改库
cdtrdrx 条件跳转coode_cdtrdrmysql:不落盘,可直接改库
parardrx 参数跳转coode_parardrmysql:不落盘,可直接改库
groupx 一级分类coode_grouplistmysql:不落盘,可直接改库
plotx 节点coode_plotlistmysql:不落盘,可直接改库
csspagex 样式页面coode_facelistmysql:不落盘,可直接改库
iconsetx 图标库coode_iconsetmysql:不落盘,可直接改库
databasex 数据库coode_dblistmysql:不落盘,可直接改库
afunx 事务函数coode_affairfunlistmysql:不落盘,可直接改库
parax 外部框架coode_paramysql:不落盘,可直接改库
apix 接口密钥coode_apipoolmysql:不落盘,可直接改库
smallcssx 小CSScoode_codedemomysql:不落盘,可直接改库
云酷德宪法/dataspacex

dataspacex

数据空间已验证

数据空间(给某类数据一个独立命名空间)。主表 coode_dataspace(datamark)。落盘 /localxres/dataspacex/<名>/。

它是什么

先看懂
数据类:定义存在库里,内容落到盘上,两处要对得上主表coode_dataspace字段定义 coode_keydetailxsysshowfun / jsshowfun 决定前端怎么渲染这一格落盘 /localxres/dataspacex/savetoseed 刷索引,别站能装

图:dataspacex(数据空间)在云酷德体系里的位置

一句话:数据空间(给某类数据一个独立命名空间)。主表 coode_dataspace(datamark)。落盘 /localxres/dataspacex/<名>/。

数据空间 = 九张表的小型数据库,操作全靠 dspbasecoprt 函数集:NS 建空间 / ND 新增 / UD 改 / KD 删 / RD 落盘 / SY 读。
⚠ 空间记录里的归属字段存的是 syskey(字符串),不是 sysid 数字,别拼错。

生命周期

四个接口走一圈
资源生命周期:建 → 存 → 读 → 卸(四个接口,走完一圈)anahtmlcode新建·拆骨架·落盘savetempdata保存·刷索引·回写gettempdata读取·编辑器取回unstallres卸载·摘掉资源

所有资源都是这套节奏:先建,再存,要改就取回来改,不用了就卸载

元信息

先认表
类型码
dataspacex
中文名
数据空间
主表
coode_dataspace
定位键
datamark
落盘目录
/localxres/dataspacex/
库内条数
5

主表字段(coode_dataspace,共 14 个起):
SNO sysid vermd5 domainmark datamark datatitle outclstxt jsondata jsonshort filetext datarcd keyfrmver tabcls totrcd…

主表速查 SQL复制
select * from coode_dataspace where datamark='dataspacex';

创建

anahtmlcode
1
准备一份成品 HTML

含 head 里要引的 css/js,以及完整 body;本地先拼好再提交

2
正文转 HEX

'dTYPE:HEX:' + html.encode('utf8').hex() —— 中文走明文会被 unstrs() 改字符

3
POST 到 anahtmlcode

带 resid=域.名、wb=1、sysid=0,必须带 Cookie

4
看返回值确认

wbinfo.isnew=1 才是真新建,fileok=1 说明盘上已落

第一次新建走 anahtmlcode:给它一份完整成品 HTML,它会自己拆成 样式 / 脚本 / 主体 / 骨架,写进 coode_domainunit,并落盘 /localxres/tempx/xianfa/dataspacex.html。
这一步就把「库 + 盘 + 索引」都建好了,不要自己插 SQL、不要 SFTP 传文件。

用 askapi 创建

万能通道 · 含必填字段

除了本类型自己的专用接口,26 种资源全部可以走同一个入口:funx.askapi。
它怎么知道每种资源该填哪些字段'+String.fromCharCode(65311)+'——看这两张表:
coode_asklist(datamark=<类型码>_<操作>,记录作用在哪个主表、定位键是哪个)
coode_askkey(同 datamark,逐字段记录字段名、中文名、fromurl=GET / POST / VIEW)。
所以「这个资源要建哪些字段」不用猜,查这两张表就有。

必填字段含义提交方式类型说明
datamark数据标记POSTvarchar★ 定位键——整个资源靠它被找到;fullinfo / view 都得拿它当<定位值>
datatitle请求标题POSTvarchar资源的中文名(标题/别名)。必填,但随时可改——改走 fullinfo 或 setbtn
sysid系统IDPOSTvarchar所属系统ID。公共资源填 0(云酷德运行时);填了具体 sysid 就归到那个系统名下
srctype资源类型POSTvarchar资源类型码,固定填 dataspacex,不要拼错
规律:26 种资源的 crtres 基本都只要这四样——定位键(datamark)+ 标题 + sysid(公共资源填 0)+ srctype(填资源类型码 dataspacex)。剩下的字段建完再用 optype=fullinfo 补。
本类型实测 4 个必填字段(上表即全部)。
HTTP · 创建(dataspacex)复制
POST 本站域名/localxres/funx/askapi/?optype=crtres&stype=dataspacex
Cookie: uid=divlovecss; stoken=; deadline=
Content-Type: application/x-www-form-urlencoded
datamark=<值>
datatitle=<值>
sysid=<值>
srctype=<值>
# 返回:{"status":"1","msg":"已创建 … 共 N 个字段(权限已放行)","redirect":"<定位键值>"}
# status=0 的两种情况:
#   1. 缺少定位值 datamark   -> 必须提交这个字段
#   2. 资源已存在:XXX      -> 别重复插,改值走 fullinfo / setbtn
创建之后:补全字段 / 读取 / 生成文件复制
# ① 补全其余字段(一次可改多个)
POST 本站域名/localxres/funx/askapi/?optype=fullinfo&stype=dataspacex&datamark=<定位值>
Cookie: uid=divlovecss; stoken=; deadline=
Content-Type: application/x-www-form-urlencoded
<字段名>=<新值>&<字段名2>=<新值2>
# ② 读回来看看对不对
GET  本站域名/localxres/funx/askapi/?optype=view&stype=dataspacex&datamark=<定位值>
Cookie: uid=divlovecss; stoken=; deadline=
# ③ 让它落盘成真正的资源文件
GET  本站域名/localxres/funx/askapi/?optype=mkfile&stype=dataspacex&code=<定位值>
Cookie: uid=divlovecss; stoken=; deadline=
#   函数类 -> /localxres/dataspacex/<code>/index.php
#   模板类 -> /localxres/dataspacex/<code>/index.html
#   force=1 强制重写(默认文件缺失或为空才写)
# ④ 查这个类型到底有哪些字段可写
select keyname,keytitle,fromurl from coode_askkey where datamark='dataspacex_fullinfo' order by SNO;
optype干什么说明
crtres新建资源插一条记录到主表,并自动给你放开发权限(coode_devespace)
fullinfo改多个字段按定位键找到记录,一次改掉提交上来的所有可写字段
view读取一条按定位键取出这条记录的主字段
viewext读取扩展取出关联的扩展信息(子项、依赖面等)
setbtn按钮写值改少量字段(通常是开关、状态位)
mkfile生成资源文件按类型生成落盘文件:函数类 index.php、模板类 index.html,其余生成数据出口
fromurl 三种值:GET=从 URL 参数取值、POST=从表单体取值、VIEW=只展示不写库。crtres 时 VIEW 字段会被跳过,所以创建后它们还是空的——这正是要接着走 fullinfo 的原因。
HTTP · 新建复制
POST 本站域名/localxres/funx/anahtmlcode/
Cookie: uid=divlovecss; stoken=; deadline=
Content-Type: application/x-www-form-urlencoded
resid     = xianfa.dataspacex
htmlcode  = dTYPE:HEX:<完整 HTML 的十六进制>      # ★ 中文必须 hex,明文会被 unstrs 改字符
hex       = 1
wb        = 1                                     # 返回 JSON
unittitle = dataspacex 数据空间
sysid     = 0                                     # 顺手登记 coode_sysregres
返回 · JSON复制
{"status":"1","msg":"生成成功","redirect":"",
 "wbinfo":{"resid":"xianfa.dataspacex","outurl":"/localxres/tempx/xianfa/dataspacex.html",
           "isnew":1,"fileok":1,"bytes":32110,"regok":1}}
Python · 完整可跑(含公共库)复制
import io, urllib.parse, urllib.request
SITE  = 'https://<你的本站域名>'
COOKIE = 'uid=divlovecss; stoken=; deadline='      # ★ 铁律:系统资源操作必带,否则 CRTOR 写空
def post(fn, data, timeout=180):
    url  = SITE + '/localxres/funx/' + fn + '/'
    body = urllib.parse.urlencode(data).encode('utf8')
    req  = urllib.request.Request(url, data=body, headers={
        'Content-Type': 'application/x-www-form-urlencoded',
        'Cookie': COOKIE})
    return urllib.request.urlopen(req, timeout=timeout).read().decode('utf8', 'replace')
def tohex(s):
    return 'dTYPE:HEX:' + s.encode('utf8').hex()   # ★ 中文正文必须走 hex,明文会被 unstrs 改字符
def nl(s):
    return s.replace('\r\n', '\n').replace('\n', '
')   # 换行 -> 
,unstrs 还原成 \r\n
# ---------- 1. 新建:anahtmlcode ----------
html = io.open('dataspacex.html', encoding='utf8').read()
r = post('anahtmlcode', {
    'resid':     'xianfa.dataspacex',              # 域.名 -> 落盘 /localxres/tempx/xianfa/dataspacex.html
    'htmlcode':  tohex(html),               # 完整成品页(含 <head> 里的 css/js 引用)
    'hex':       '1',
    'wb':        '1',                       # 返回 JSON:isnew / fileok / bytes / regok
    'unittitle': 'dataspacex 数据空间',
    'sysid':     '0',                       # 顺手登记进 coode_sysregres
})
print(r)      # isnew:1 才是真新建;isnew:0 说明同名已存在,走的是更新分支

不想写脚本'+String.fromCharCode(65311)+'用可视化通道:打开 本站域名/localxres/tempx/abhtmlcode/index.html?resid=xianfa.dataspacex(页面标题就叫「html代码吸收器」),把整页 HTML 粘进文本框点提交即可。
它其实就是 anahtmlcode 的前端壳,提交的是 resid=<域.名>&htmlcode=mkstr(整页源码)——走明文、不带 hex=1,值统一过 mkstr();同名直接覆盖,所以也是改页面最省事的办法(铁哥 2026-09-29 亲授)。

参数要点:resid 必须是 域.名 两段式,wb=1 才返回 JSON;isnew 为 0 说明同名已存在,这次走的是更新分支(不会重复插库)。

怎么调用

用起来

数据类资源不是"调"出来的,是查出来的:直接 SQL 查主表,或走 coode 的数据通道(例如 dataspacex 用 dspbasecoprt 函数集读写)。它的价值在结构定义,字段怎么渲染要看 coode_keydetailx。

1
定位它

用 datamark 在主表 coode_dataspace 里查到这一条

2
取内容

库里正文是 dTYPE:HEX: 开头的十六进制,要先解出来才是可读原文

3
真正使用

SQL 查表,或走对应的数据通道函数

4
确认生效

看盘上文件是否更新、页面刷新后是否变了

取一条记录出来看复制
select SNO,* from coode_dataspace where datamark='<资源码>';
# 按主键改某列(SNO 用上面查出来的真实值)
POST 本站域名/localxres/funx/savefunc/?fn=SNO:<真实主键>.<列名>@coode_dataspace
Cookie: uid=divlovecss; stoken=; deadline=
dt=<这一列的新值>
# 库里正文是 TYPE_HEX 包装的十六进制,解出来才是原文
# Python:  bytes.fromhex(值[len('dTYPE:HEX:'):]).decode('utf8')

维护 / 保存

savetempdata
1
改本地那份 HTML

别在服务器上直接改文件,改本地源再重新提交

2
重新 anahtmlcode

同名会走更新分支(isnew=0),不会重复插库

3
savetempdata 回写

casecode 会被 eval,写错就是静默失败——返回空串要警惕

4
savetoseed 刷索引

让别的站能 installpod 装走

改完内容用 savetempdata 回写。它负责替换骨架里的 6 个占位、重算 vermd5、重新落盘 outurl,并自动调 savetoseed 刷索引。
⛔ 返回空串 = 失败(最常见的原因是 casecode 语法错,它内部会 eval,错了就静默不写库)。

HTTP · 保存复制
POST 本站域名/localxres/funx/savetempdata/
Cookie: uid=divlovecss; stoken=; deadline=
Content-Type: application/x-www-form-urlencoded
domain      = xianfa
mark        = dataspacex
unittitle   = dataspacex 数据空间
unitclass   = content              # ★ 自绘页必须 content(list/form/… 会被加 listdemo)
unitdescrib = 云酷德宪法 - dataspacex 数据空间
stylex      =                      # 留空:公共样式走 cssfiles
scriptx     = <script src="/localxres/funx/xianfajs/"></script>
casecode    = $utitle="..."; 换行 $tmpcode='...';     # 会被 eval,语法错必失败
tmpcode     = <页面主体,< > 写成 { }>
srdcode     = <页面骨架,含 {!--thesecomCSSFILES--} 等占位>
cssfiles    = /localxres/funx/xianfacss/
jsfiles     = /localxres/funx/xianfajs/             # 多个用 ; 分隔
outurl      = /localxres/tempx/xianfa/dataspacex.html
Python · 完整可跑复制
# ---------- 2. 保存:savetempdata ----------
BODY   = html[html.index('<div class="cg-wrap"'):]        # 页面主体
SCRIPT = '<script src="/localxres/funx/xianfajs/"></script>'
to_code = lambda s: s.replace('<', '{').replace('>', '}')  # coode 码:< > 写成 { }
r = post('savetempdata', {
    'domain': DOMAIN, 'mark': 'dataspacex',
    'unittitle': 'dataspacex 数据空间',
    'unitclass': 'content',                 # ★ 自绘页必须是 content
    'unitdescrib': '云酷德宪法 - dataspacex 数据空间',
    'stylex': '',                           # 公共样式走 cssfiles,不内联
    'scriptx': nl(SCRIPT),
    'casecode': nl('$utitle="dataspacex 数据空间";' + chr(10) + "$tmpcode='" +
                   to_code(BODY).replace("'", "'.dyh().'") + "';"),
    'tmpcode': nl(to_code(BODY)),
    'srdcode': nl(SRD),                     # 页面骨架,含 {!--thesecomCSSFILES--} 等占位
    'cssfiles': '/localxres/funx/xianfacss/',
    'jsfiles':  '/localxres/funx/xianfajs/',   # 多个用 ; 分隔
    'outurl':   '/localxres/tempx/xianfa/dataspacex.html',
})
print(r)      # 返回 '1' = 成功;返回空串 = 失败(多半是 casecode 语法错)
提交前必须消毒:每个字段都会过 unstrs()——\ 反斜杠直接删光(所以别写正则);换行用 ;& 会被还原成 &;全角问号会被变半角。
另外从库里取回的 casecode 是 形态,必须先还原成真换行再提交,否则 eval 直接语法错。

详情 / 读取

gettempdata
HTTP · 读取复制
GET 本站域名/localxres/funx/gettempdata/?unitid=xianfa.dataspacex
Cookie: uid=divlovecss; stoken=; deadline=
Python · 读取复制
# ---------- 3. 读取:gettempdata ----------
import urllib.request
url = SITE + '/localxres/funx/gettempdata/?unitid=xianfa.dataspacex'
req = urllib.request.Request(url, headers={'Cookie': COOKIE})
print(urllib.request.urlopen(req, timeout=60).read().decode('utf8', 'replace'))

可视化编辑器:本站域名/localxres/tempx/tempeditor/index.html?unitid=xianfa.dataspacex
⛔ 编辑器在 tempx 下,不是 csspagex(那只是 CSS 样式模板库)。
只有库 + 盘都存对了,编辑器才取得到内容并能改——这也是「不许直接写文件」的原因。

卸载 / 同步

unstallres · savetoseed
HTTP · 三件套复制
# 卸载资源
GET 本站域名/localxres/funx/unstallres/?restype=tempx&rescode=xianfa.dataspacex&sysid=0&insmark=xianfa.dataspacex
# 存为种子(刷 resdata 索引,让别的站能装)
GET 本站域名/localxres/funx/savetoseed/?restype=tempx&sysid=0&resmark=xianfa.dataspacex
# 从别的站装过来
GET 本站域名/localxres/funx/installpod/?fromhost=<源站>&restype=tempx&rescode=xianfa.dataspacex&sysid=0
登记表 · sysregres复制
insert into coode_sysregres(grpid,restype,resmark,restitle,STATUS,CRTM,UPTM,OLMK)
values('0','tempx','xianfa.dataspacex','dataspacex 数据空间','0',now(),now(),'...');
注意:本页讲的是「用 tempx 通道生成页面型资源」。dataspacex 这种资源本身的主表是 coode_dataspace,定位键 datamark;卸载时把 restype 换成 dataspacex 即可。

实操备注 / 踩坑沉淀

共 1 条 · 只增不删

下面每一条都是真跑过、真踩过之后记下来的,按时间正序排列。新发现只往上加,旧的绝不删——同一个资源的认识就是这样一点点变准、变细的。

1数据空间是九张表 + 四个落盘文件2026-09-29
主表 coode_dataspace(datamark=命名空间),围绕它有九张表:空间定义、字段定义、索引、数据行、版本、权限、日志等。
落盘四个文件到 /localxres/dataspacex/<名>/。

函数集:sfunx/dspbasecoprt 提供了全套增删改查函数,写数据空间相关 funx 前先去看它,别从零写。

⚠ 改完主表记得 savetempdata 类操作让库与盘对齐——两边都要对得上。
云酷德宪法 · 本页是 tempx 资源 xianfa.dataspacex,落盘 /localxres/tempx/xianfa/dataspacex.html,上面每段代码就是造它自己的真实调用
操作方法会随造系统的过程持续补充——每实操一次,就回来补一段