laoyang/wordpress-kratos-yang
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
94 Commits 1 Branch 0 Tags
ba1245191c0aa06055b80a6c7954c2a8798ed529
Commit Graph
5 Commits
Author SHA1 Message Date
laoyang 1a31e412b0 写作增强：翻译服务商选了谁才显示谁对应的账号输入框 #26 
之前四个密钥框（百度 APPID/密钥、有道应用 ID/密钥）无论选哪家服务商
都全摆在设置页上，四组输入框里永远有三组用不上。

改动：
- inc/theme-options.php：新增 $yang_prov_class() 闭包，统一生成字段
  的 class。服务端就按「当前已保存的服务商」把 yq-cond-hide 打好，
  首帧不闪。分组标记 yang-prov / yang-prov-<key> 写在每个字段的
  'class' 上，是**唯一的分组声明处**，JS 不再抄服务商清单。
  原本一个 shared 的 info 块拆成三块，每家一句自己的说明。
- inc/options-framework/js/options-custom.js：重写
  yq_toggle_writing_slug_fields()。两层条件（总开关 + 服务商归属）
  必须在同一函数内合成一个结果再 toggleClass —— toggleClass 的
  force 是绝对赋值，拆成两个函数各 toggle 一次的话结果只取决于
  注册顺序。change 事件同时监听 #w_on_slug 与 #w_provider。
- style.css：3.2.57 -> 3.2.58

两处刻意避开的老坑：
- 用 class + display:none !important，不用 jQuery show()/hide()，
  后者会把行内 display 写成 block，回退 3.2.28 的 flow-root 修复。
- 隐藏不 disabled 输入框，密钥字段是「留空=不修改」语义，disabled
  不随表单提交，会把已保存的密钥冲掉。
 2026-10-27 21:40:00 +08:00
laoyang 0a5486e195 3.2.57 新增「写作增强」：发布时自动生成别名/标签/分类/摘要 #25 
需求（工单 #25）：写文章时自动生成别名（翻译）、自动生成标签、
自动选择分类、自动生成摘要，问主题能不能做、是否必须用插件。
结论：主题自己就能做，不依赖任何插件。

新增 inc/theme-writing.php（四个独立引擎 + 设置读写 + 密钥处理）：

- 触发点：transition_post_status，且要求
  new_status === publish && old_status !== publish
  ⇒ 只在「第一次点发布」时动手，自动保存不触发，已发布的文章一概不碰。
- 幂等锁 _yang_writing_done：同一篇只做一次，避免反复覆写。

四道「不覆盖」守卫（用户逐条确认的决策）：
- 摘要：只在 post_excerpt 为空时才写。
- 分类：只在文章还挂默认分类（未分类）时才动。
- 别名：只在「空」或「不是纯 ASCII」时才生成。判据不是"空"而是
  "不是纯 ASCII" —— 中文标题下 WP 生成的是 %e4%bf%a1... 这种编码串，
  它非空但不可用。已有英文别名的 966 篇一概不动（别名=URL，改了
  就是成批 404）。
- 标签：wp_set_post_tags(..., true) 追加，绝不删除手工标签。

修一个真实产品 bug：3.2.56 及以前 apply() 里写的是
list($suggest, $_) = yang_writing_make_tags(...)，$new 被整个丢掉；
接着又拿 $suggest 去 get_term_by 二次分类 —— 而 $suggest 里每个词
都来自词典、必然全部命中 ⇒「新建」分支永远进不去 ⇒ 这条功能在真实
发布流程里一次都没生效过。改为 list($exist_hits, $new_cands)，
两段分别复核后合并。

标签两级策略（新博客也能用）：先匹配已有标签池，匹配不到才新建，
每篇新增数量受 w_tag_new_limit 约束（默认 3，设 0 = 永不新建）。

中文分词（服务器无 scws/jieba）：先按虚词与标点切短语，再在短语
内部取 2~6 字 n-gram。不切句直接取窗口会产出「星等换算与赤」
这类跨词碎片，且字面上"出现 ≥2 次"能通过所有频次闸门 —— 这是
n-gram 的固有缺陷，只能靠切分规避，调阈值无效。
虚词表统一由 yang_writing_seps() 提供（闸门④ 复用同一函数）。

翻译：默认 MyMemory（免注册），可选百度/有道。任何失败都返回空串
跳过该项，绝不阻塞发布。

密钥：存独立选项 yang_writing_secrets，不进 kratos；password 类型 +
std 空串；页面只显示末 4 位；留空提交 = 不修改。

设置页：新增「写作增强」独立 heading 标签页，四个开关默认全关
（升级不改变现有行为）。framework 里 'requires' 这个键根本没被读取，
条件显示改用 options-custom.js 显式逻辑；info 类型不生成 .section
包裹层，补一条 .section-info 规则才能藏住服务商申请说明。

验证（发布前）：
- 写作端到端 71 条、后台渲染 21 条、密钥路径 9 条，合计 101 条全过
- 反证 22 组（W1~W16 端到端 / A1~A6 后台）× R1~R14 发布包注入，
  全部让失败数从 0 增加
- 测试自身不污染：每节差分回滚 + 总闸门，标签库稳定 703 / 967 篇
- 发布走 theme-update/，主题目录仍是 3.2.56，未被覆盖
 2026-10-27 16:05:43 +08:00
laoyang 4a2d62b1aa 3.2.31 目录「正文内显示」与「浮动显示」拆成两个独立开关（#1） 
原来「目录位置」是一个三选一下拉：正文中间 / 页面左侧 / 页面右侧，
等于把「放进正文」和「浮在页边」当成互斥的一件事 —— 想同时在正文
开头放一份、又在边上浮一份，做不到。

改成两个独立勾选，各自带子选项：

  · 在正文中显示 → 正文中的对齐（靠左 / 靠右）+ 自动插入位置
  · 浮动显示     → 浮动方向（页面左侧 / 页面右侧）

两个都勾就同时出现两份，只勾一个就只出现一种。四种组合都在后台
联动里逐个验证过（探针 70/0）。

新增能力「正文内靠左 / 靠右」是本单的主要新需求。实现上两个要点：

  1. 必须给正文目录一个宽度上限（max-width: min(100%, 28em)）。
     块级盒子默认撑满正文栏，此时 margin:auto 没有剩余空间可分配，
     「靠左/靠右」会是一个属性正确、画面纹丝不动的空操作。
  2. 用 data-align 属性把方向带下去，CSS 只需两条规则，
     不随方向数量膨胀。属性在 yang_toc_slot_html() 里输出。

语义收窄：手写 [TOC] 以前会让整份自动处理全停（连带 rail=false），
现在只手管「正文那一份」—— 手写位置优先，浮动仍由 float 开关独立
决定。这样「精确定位正文位置」和「全站边上都有目录」可以并存。

顺手修掉一处默认值错配：checkbox 用 !empty() 判断会把「键不存在」
和「键明确为空」混成一件事，导致新装站点后台框显示勾上、页面却
不出目录。改用 array_key_exists() 区分的三态判断。

老配置不迁移：3.2.30 的 toc_place 直接作废，不做兼容。
默认 inline=1 / float=0，升级后页面与升级前一致。

重构：把内容过滤器拆成 yang_toc_apply()（纯执行层）+ 运行时壳，
使设置组合能在单进程单测里逐个喂进去（PHP 无法重置函数 static）。

验证
  逻辑 101/0 · 逻辑反向 15/15
  旧回归 53/0
  静态契约 58/0 · 反向 11/11
  后台几何+交互 70/0 · 反向 11/11
  侧栏几何 73/0 · 反向 8/8
  正文对齐几何 23/0 · 反向 5/5（含阴性对照）
  包内容契约 59/0 · 反向 9/9

正文对齐的几何探针量到真实的 Δleft = 348px（靠右比靠左），
而不是只断言 data-align 字符串存在。
 2026-10-25 13:37:26 +08:00
laoyang 6f51d50a58 3.2.30: 文章目录进后台（新增「自动目录」标签页）—— 位置/插入点/默认展开可配，手写 [TOC] 永远优先 
后台「主题设置」新增第 5 个标签页「自动目录」，7 个选项：
  目录位置   正文中间 / 页面左侧（浮动）/ 页面右侧（浮动）
  添加方式   手动（只认 [TOC]）/ 自动
  自动插入位置  文章开头 / 第一个 H1、H2 之前 / 文章结尾
  默认状态   默认显示 / 默认隐藏
  另外：目录标题、收录层级（H1~H4）、是否显示序号

设计要点：
- 插入方式拆成 toc_mode(manual/auto) x toc_anchor(start/first/end) 两个正交
  字段，不合成一个四值下拉：侧栏模式下插入位置毫无意义，合并会产生歧义。
- 手写 [TOC] 绝对优先：yang_toc_plan() 里 $has_marker 最先返回，inline_at
  ='marker' 且 rail=false —— 否则同一篇会出现两份目录，老文章升级后突然多
  出一个目录。这条是刻意守住的。
- 纯函数 + 薄壳分层：normalize_settings / plan / inject / build_list 全部不查库，
  单进程可喂几十种组合；settings() 只负责读库 + 调纯函数 + static 缓存。
- <details open> 是唯一可靠的「默认收起」手段：展开态不接受 CSS 覆盖，只能
  由 open 属性决定，所以隐藏时必须不输出该属性。
- 侧栏收起态必须 translateX(±100%) 完全移出视口：只做 opacity 会让透明面板
  留在原位吃掉正文点击（探针 elementFromPoint 才抓得到）。
- yang_toc_rail_ready() 开关：侧栏在 wp_footer 输出，那时正文可能没走
  the_content（缓存插件/OEmbed），标题没 id ⇒ 侧栏链接全跳不动却看起来正常。
  宁可不出侧栏。
- 后台联动隐藏「插入位置」不用 jQuery show()/hide()：会把 .section 的行内
  display 写成 block，悄悄回退 3.2.28 的 display:flow-root BFC 修复。改用
  class + display:none!important。

验证（全部在本轮重跑）：
  _test_toc.php       53/0   旧 TOC 行为回归
  _toc330_logic.php   88/0   逻辑判据
  _toc330_falsify     13/13  注入全变红且红对地方
  _geo330_rail.js     73/0   侧栏真实几何（左/右 x 展开/收起 x 宽窄屏）
  _geo330_falsify     8/8
  _guard330.php       46/0   后台控件与运行时默认值双向一致
  _guard330_falsify   8/8
  _admin330_tab_check 36/0   新标签页几何 + 联动 + 载入态
  _admin330_falsify   8/8
  _admin328_check     13/0   3.2.28 布局回归

发布：只发 zip + readme + update.json 到 theme-update/，不动服务器主题目录，
用户在 WP 后台自行升级（沿用 3.2.24 起的策略）。
 2026-10-25 12:18:52 +08:00
laoyang a826b26bee 从gitee代码库中初始化项目。 2022-01-07 11:15:42 +08:00