chore(backlog): 记录 g06 完成

.ua/backlog.json

@@ -386,8 +386,32 @@
       "title": "textField/textarea/inputNumber 补 prefix/suffix 附加内容槽",
       "motivation": "搜索框放大镜、金额单位等前后缀是输入组件高频需求，目前只能外部拼装",
       "acceptance": "三个输入组件新增 prefix/suffix（string|HTMLElement），渲染为输入框内侧前后附加块；manifest 参数表与 llms-full 同步；npm run check 全绿",
-      "status": "open",
+      "status": "done",
       "notes": "自补：可用性细节方向"
+    },
+    {
+      "id": "g04",
+      "title": "dataTable 筛选框用 prefix 放搜索图标",
+      "motivation": "g03 落地了 prefix 附加块，dataTable 工具栏筛选框是最佳实战落点，同时验证包装不影响事件冒泡",
+      "acceptance": "dataTable 筛选输入框带 🔍 prefix；筛选功能回归正常（smoke 不变绿转红）；npm run check 全绿",
+      "status": "done",
+      "notes": "自补：g03 实战验证"
+    },
+    {
+      "id": "g05",
+      "title": "ua verify 增加 llms-full.txt 生成同步校验",
+      "motivation": "llms-full.txt 是手工触发 ua docs 生成的产物，改 manifest 后忘记跑 docs 会产生文档漂移，目前无门禁",
+      "acceptance": "verify 内联重渲染 Agent 文档（时间戳归一化）与根目录 llms-full.txt 比对，不一致即报错提示 npm run docs；npm run check 全绿",
+      "status": "done",
+      "notes": "自补：工具链防漂移方向"
+    },
+    {
+      "id": "g06",
+      "title": "组件数门禁扩展 README 计数文本",
+      "motivation": "f01 的计数漂移校验只覆盖 AGENTS/ARCHITECTURE，README 的「N 个 DOM 组件」文本仍可漂移",
+      "acceptance": "checkCountDocs 扫描列表加入 README.md，漂移即 verify 失败；npm run check 全绿",
+      "status": "done",
+      "notes": "自补：f01 收尾"
     }
   ]
 }

.ua/index.json

@@ -1,6 +1,6 @@
 {
   "$schema": "ui-arch-registry-index/0.1",
-  "generatedAt": "2026-10-23T10:58:48.833Z",
+  "generatedAt": "2026-10-23T11:03:12.689Z",
   "repoRoot": ".",
   "packages": [
     {
@@ -143,9 +143,9 @@
         "entry": "src/index.ts",
         "exports": [
           "button(props)：按钮，variant = primary | ghost | danger，disabled 支持布尔或信号禁用",
-          "textField(props)：文本输入，value 信号双向绑定，disabled 支持布尔或信号禁用",
+          "textField(props)：文本输入，value 信号双向绑定，disabled 支持布尔或信号，onInput 输入回调；prefix/suffix 可选渲染为输入框内侧附加块",
-          "inputNumber(props)：数字输入，−/+ 按钮 + 键盘 ↑↓ 调节，value 信号双向绑定，min/max/step 超界自动夹取",
+          "inputNumber(props)：数字输入，−/+ 按钮与键盘 ↑↓ 调节，min/max/step 夹取；prefix/suffix 可选渲染为整组前后附加块",
-          "textarea(props)：多行输入，value 信号双向绑定，disabled 支持布尔或信号禁用",
+          "textarea(props)：多行输入，value 信号双向绑定，disabled 支持布尔或信号，rows 控行数；prefix/suffix 可选渲染为上下附加块",
           "slider(props)：滑块，value 信号双向绑定，min/max/step 可配，原生 range 承载键盘交互，右侧可显示当前值",
           "checkbox(props)：复选框，checked 信号双向绑定，disabled 支持布尔或信号禁用",
           "switchButton(props)：开关，checked 信号双向绑定，disabled 支持布尔或信号禁用",
@@ -325,13 +325,24 @@
                 "t": "(value: string) => void",
                 "k": 1,
                 "d": "输入回调，每次按键触发"
+              },
+              {
+                "n": "prefix",
+                "t": "string | HTMLElement",
+                "d": "前置附加块（textField/inputNumber 在输入框内侧前、textarea 在上方）；缺省不渲染"
+              },
+              {
+                "n": "suffix",
+                "t": "string | HTMLElement",
+                "d": "后置附加块（textField/inputNumber 在输入框内侧后、textarea 在下方）；缺省不渲染"
               }
             ],
             "example": "const name = signal(''); const el = textField({ value: name, placeholder: '输入名字…', onInput: (v) => console.log(v) })",
             "steps": [
               "先用 signal('') 创建字符串信号",
               "传入 value 完成双向绑定：用户输入自动写回，外部赋值自动回显",
-              "在任意响应式位置用 name() 读取最新值，如 () => `你好，${name()}`"
+              "在任意响应式位置用 name() 读取最新值，如 () => `你好，${name()}`",
+              "需要图标、货币符、单位等前后缀时传 prefix/suffix（字符串或 DOM），控件会包进带边框的附加组，聚焦光环由组统一承载"
             ]
           },
           {
@@ -371,13 +382,24 @@
                 "t": "(value: number) => void",
                 "k": 1,
                 "d": "值变化回调（已夹取到合法区间）"
+              },
+              {
+                "n": "prefix",
+                "t": "string | HTMLElement",
+                "d": "前置附加块（textField/inputNumber 在输入框内侧前、textarea 在上方）；缺省不渲染"
+              },
+              {
+                "n": "suffix",
+                "t": "string | HTMLElement",
+                "d": "后置附加块（textField/inputNumber 在输入框内侧后、textarea 在下方）；缺省不渲染"
               }
             ],
             "example": "const qty = signal(1); const el = inputNumber({ value: qty, min: 1, max: 99, onChange: (v) => console.log(v) })",
             "steps": [
               "用 signal(1) 创建数字信号并传入 value 完成双向绑定",
               "点击 −/+ 按钮或在输入框聚焦时按 ↑↓ 以 step 调节；直接输入在失焦或回车时解析",
-              "非法输入自动回滚为当前值；min/max 超界自动夹取，disabled 支持布尔或信号禁用"
+              "非法输入自动回滚为当前值；min/max 超界自动夹取，disabled 支持布尔或信号禁用",
+              "需要图标、货币符、单位等前后缀时传 prefix/suffix（字符串或 DOM），控件会包进带边框的附加组，聚焦光环由组统一承载"
             ]
           },
           {
@@ -411,13 +433,24 @@
                 "t": "(value: string) => void",
                 "k": 1,
                 "d": "输入回调"
+              },
+              {
+                "n": "prefix",
+                "t": "string | HTMLElement",
+                "d": "前置附加块（textField/inputNumber 在输入框内侧前、textarea 在上方）；缺省不渲染"
+              },
+              {
+                "n": "suffix",
+                "t": "string | HTMLElement",
+                "d": "后置附加块（textField/inputNumber 在输入框内侧后、textarea 在下方）；缺省不渲染"
               }
             ],
             "example": "const bio = signal(''); textarea({ value: bio, rows: 4, placeholder: '一句话介绍…' })",
             "steps": [
               "创建信号并传入 value",
               "用 rows 控制初始高度，用户可纵向拉伸",
-              "字数统计等派生逻辑直接在响应式文本里读 bio().length"
+              "字数统计等派生逻辑直接在响应式文本里读 bio().length",
+              "需要图标、货币符、单位等前后缀时传 prefix/suffix（字符串或 DOM），控件会包进带边框的附加组，聚焦光环由组统一承载"
             ]
           },
           {

.ua/iterations.log

@@ -47,3 +47,7 @@
 {"ts":"2026-10-23T18:53:33+08:00","id":"f06","result":"done","commit":"a5439fe","summary":"pnpm-lock.yaml 经 pnpm install --lockfile-only 生成入库；ARCHITECTURE.md 目录树补 scripts/、COMMITTING、ITERATION、pnpm-workspace、.ua 明细"}
 {"ts":"2026-10-23T18:55:24+08:00","id":"g01","result":"done","commit":"98f557c","summary":"writeIfChanged 支持归一化比较，llms-full.txt 仅时间戳之差时跳写，docs 双跑工作区干净；backlog 灌入 g01-g03"}
 {"ts":"2026-10-23T18:59:34+08:00","id":"g02","result":"done","commit":"33979b2","summary":"新增 image 组件：缩略图点击/回车开遮罩大图，Esc/点击遮罩关闭并归还焦点；组件 33→34，manifest/docs/README/demo 同步"}
+{"ts":"2026-10-23T19:04:29+08:00","id":"g03","result":"done","commit":"bfa7013","summary":"textField/textarea/inputNumber 新增 prefix/suffix（addonWrap 零侵入包装，无附加不包裹），样式聚焦光环由组承载；demo 与 manifest 同步"}
+{"ts":"2026-10-23T19:05:48+08:00","id":"g04","result":"done","commit":"c0bb8d7","summary":"dataTable 筛选输入框用 g03 的 prefix 放搜索图标，事件冒泡与筛选回归正常，门禁全绿"}
+{"ts":"2026-10-23T19:07:37+08:00","id":"g05","result":"done","commit":"9651c39","summary":"verify 内联重渲染 Agent 文档与 llms-full.txt 归一化比对，漂移即拦截提示 npm run docs"}
+{"ts":"2026-10-23T19:08:37+08:00","id":"g06","result":"done","commit":"b6c9489","summary":"checkCountDocs 扫描列表加入 README.md，三份文档组件计数文本全部纳入漂移门禁"}

apps/demo/main.ts

@@ -127,6 +127,8 @@ const volume = signal(40);
 
 // —— 数字输入：购买数量演示，与禁用态实例共用同一信号 ——
 const qty = signal(1);
+const price = signal('9.9'); // 演示 suffix 附加块
+const amount = signal(2); // 演示 inputNumber 前后缀
 
 // —— 步骤条：下单流程演示，按钮推进、点已完成步骤回跳 ——
 const stepIdx = signal(0);
@@ -169,8 +171,10 @@ const content = h(
   section(
     'sec-bind',
     '双向绑定',
-    'textField 与信号双向同步：输入即回显。',
+    'textField 与信号双向同步：输入即回显；prefix/suffix 渲染为输入框内侧附加块。',
     textField({ placeholder: '输入名字…', value: name }),
+    textField({ placeholder: '搜索…', value: name, prefix: '🔍' }),
+    textField({ value: price, suffix: '元' }),
     h('span', { class: 'out' }, () => (name() ? `你好，${name()}！` : '等待输入…')),
   ),
   section(
@@ -267,6 +271,7 @@ const content = h(
       { class: 'row' },
       inputNumber({ value: qty, min: 1, max: 99, onChange: (v) => toast.info(`数量 ${v}`) }),
       inputNumber({ value: qty, disabled: locked }),
+      inputNumber({ value: amount, min: 0, prefix: '¥', suffix: '件' }),
     ),
   ),
   section(

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-23T10:58:48.833Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-23T11:03:12.689Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -104,6 +104,8 @@ button({ label: '提交', variant: 'primary', onClick: () => console.log('clicke
 - placeholder：string —— 占位文案
 - disabled：boolean | Signal<boolean> —— 禁用态：布尔直接置位，传信号则动态同步
 - onInput（回调）：(value: string) => void —— 输入回调，每次按键触发
+- prefix：string | HTMLElement —— 前置附加块（textField/inputNumber 在输入框内侧前、textarea 在上方）；缺省不渲染
+- suffix：string | HTMLElement —— 后置附加块（textField/inputNumber 在输入框内侧后、textarea 在下方）；缺省不渲染
 
 示例：
 
@@ -116,6 +118,7 @@ const name = signal(''); const el = textField({ value: name, placeholder: '输
 1. 先用 signal('') 创建字符串信号
 2. 传入 value 完成双向绑定：用户输入自动写回，外部赋值自动回显
 3. 在任意响应式位置用 name() 读取最新值，如 () => `你好，${name()}`
+4. 需要图标、货币符、单位等前后缀时传 prefix/suffix（字符串或 DOM），控件会包进带边框的附加组，聚焦光环由组统一承载
 
 现场演示：apps/docs/demo.html#sec-bind
 
@@ -129,6 +132,8 @@ const name = signal(''); const el = textField({ value: name, placeholder: '输
 - step（默认 1）：number —— 步长；缺省 1
 - disabled：boolean | Signal<boolean> —— 禁用态：布尔直接置位，传信号则动态同步
 - onChange（回调）：(value: number) => void —— 值变化回调（已夹取到合法区间）
+- prefix：string | HTMLElement —— 前置附加块（textField/inputNumber 在输入框内侧前、textarea 在上方）；缺省不渲染
+- suffix：string | HTMLElement —— 后置附加块（textField/inputNumber 在输入框内侧后、textarea 在下方）；缺省不渲染
 
 示例：
 
@@ -141,6 +146,7 @@ const qty = signal(1); const el = inputNumber({ value: qty, min: 1, max: 99, onC
 1. 用 signal(1) 创建数字信号并传入 value 完成双向绑定
 2. 点击 −/+ 按钮或在输入框聚焦时按 ↑↓ 以 step 调节；直接输入在失焦或回车时解析
 3. 非法输入自动回滚为当前值；min/max 超界自动夹取，disabled 支持布尔或信号禁用
+4. 需要图标、货币符、单位等前后缀时传 prefix/suffix（字符串或 DOM），控件会包进带边框的附加组，聚焦光环由组统一承载
 
 现场演示：apps/docs/demo.html#sec-inputnumber
 
@@ -153,6 +159,8 @@ const qty = signal(1); const el = inputNumber({ value: qty, min: 1, max: 99, onC
 - placeholder：string —— 占位文案
 - disabled：boolean | Signal<boolean> —— 禁用态：布尔直接置位，传信号则动态同步
 - onInput（回调）：(value: string) => void —— 输入回调
+- prefix：string | HTMLElement —— 前置附加块（textField/inputNumber 在输入框内侧前、textarea 在上方）；缺省不渲染
+- suffix：string | HTMLElement —— 后置附加块（textField/inputNumber 在输入框内侧后、textarea 在下方）；缺省不渲染
 
 示例：
 
@@ -165,6 +173,7 @@ const bio = signal(''); textarea({ value: bio, rows: 4, placeholder: '一句话
 1. 创建信号并传入 value
 2. 用 rows 控制初始高度，用户可纵向拉伸
 3. 字数统计等派生逻辑直接在响应式文本里读 bio().length
+4. 需要图标、货币符、单位等前后缀时传 prefix/suffix（字符串或 DOM），控件会包进带边框的附加组，聚焦光环由组统一承载
 
 现场演示：apps/docs/demo.html#sec-form
 
@@ -892,9 +901,9 @@ dataTable({ data: users, selectable: true, columns: [{ key: 'name', header: '姓
 API 速览：
 
 - button(props)：按钮，variant = primary | ghost | danger，disabled 支持布尔或信号禁用
-- textField(props)：文本输入，value 信号双向绑定，disabled 支持布尔或信号禁用
+- textField(props)：文本输入，value 信号双向绑定，disabled 支持布尔或信号，onInput 输入回调；prefix/suffix 可选渲染为输入框内侧附加块
-- inputNumber(props)：数字输入，−/+ 按钮 + 键盘 ↑↓ 调节，value 信号双向绑定，min/max/step 超界自动夹取
+- inputNumber(props)：数字输入，−/+ 按钮与键盘 ↑↓ 调节，min/max/step 夹取；prefix/suffix 可选渲染为整组前后附加块
-- textarea(props)：多行输入，value 信号双向绑定，disabled 支持布尔或信号禁用
+- textarea(props)：多行输入，value 信号双向绑定，disabled 支持布尔或信号，rows 控行数；prefix/suffix 可选渲染为上下附加块
 - slider(props)：滑块，value 信号双向绑定，min/max/step 可配，原生 range 承载键盘交互，右侧可显示当前值
 - checkbox(props)：复选框，checked 信号双向绑定，disabled 支持布尔或信号禁用
 - switchButton(props)：开关，checked 信号双向绑定，disabled 支持布尔或信号禁用

llms.txt

@@ -48,9 +48,9 @@
 - 描述: DOM 皮肤组件库：button / textField / textarea / slider / checkbox / switch / select / menu / radioGroup / accordion / breadcrumb / card / badge / image / tag / avatar / alert / toast / tooltip / popover / skeleton / spinner / progress / tabs / pagination / modal / drawer / form / formItem / dataTable，构建在 @ui-arch/frame 与 @ui-arch/table-core 之上，样式只消费 --ua-* 令牌。
 - API:
   - button(props)：按钮，variant = primary | ghost | danger，disabled 支持布尔或信号禁用
-  - textField(props)：文本输入，value 信号双向绑定，disabled 支持布尔或信号禁用
+  - textField(props)：文本输入，value 信号双向绑定，disabled 支持布尔或信号，onInput 输入回调；prefix/suffix 可选渲染为输入框内侧附加块
-  - inputNumber(props)：数字输入，−/+ 按钮 + 键盘 ↑↓ 调节，value 信号双向绑定，min/max/step 超界自动夹取
+  - inputNumber(props)：数字输入，−/+ 按钮与键盘 ↑↓ 调节，min/max/step 夹取；prefix/suffix 可选渲染为整组前后附加块
-  - textarea(props)：多行输入，value 信号双向绑定，disabled 支持布尔或信号禁用
+  - textarea(props)：多行输入，value 信号双向绑定，disabled 支持布尔或信号，rows 控行数；prefix/suffix 可选渲染为上下附加块
   - slider(props)：滑块，value 信号双向绑定，min/max/step 可配，原生 range 承载键盘交互，右侧可显示当前值
   - checkbox(props)：复选框，checked 信号双向绑定，disabled 支持布尔或信号禁用
   - switchButton(props)：开关，checked 信号双向绑定，disabled 支持布尔或信号禁用

packages/skin/ui/src/addons.ts

@@ -0,0 +1,13 @@
+import { h } from '@ui-arch/frame';
+
+/*** 输入附加块包装：prefix/suffix 存在时把控件包进附加组，否则原样返回（零侵入，结构不变） ***/
+export function addonWrap(
+  el: HTMLElement,
+  prefix?: string | HTMLElement,
+  suffix?: string | HTMLElement,
+  column = false, // 多行控件用纵向布局：prefix 在上、suffix 在下
+): HTMLElement {
+  if (!prefix && !suffix) return el; // 卫语句：无附加不包裹
+  const addon = (v?: string | HTMLElement) => (v == null ? null : h('span', { class: 'ua-input-addon' }, v));
+  return h('div', { class: column ? 'ua-input-group ua-input-group-column' : 'ua-input-group' }, addon(prefix), el, addon(suffix));
+}

packages/skin/ui/src/dataTable.ts

@@ -156,6 +156,7 @@ export function dataTable<T extends { id: RowKey }>(props: DataTableProps<T>): H
 
   const filterInput = textField({
     placeholder: `筛选 ${filterKey}…`,
+    prefix: '🔍',
     disabled: props.loading, // 加载中禁止筛选，避免与在途结果竞争
     onInput: (value) => {
       table.dispatch({ type: 'setFilter', key: filterKey, value });

packages/skin/ui/src/inputNumber.ts

@@ -1,9 +1,10 @@
 import { effect, h } from '@ui-arch/frame';
 import { button } from './button.js';
+import { addonWrap } from './addons.js';
 import type { InputNumberProps } from './types.js';
 
 /*** 数字输入：−/+ 按钮 + 输入框三段式，value 信号双向绑定，min/max/step 超界自动夹取，键盘 ↑↓ 调节 ***/
-export function inputNumber(props: InputNumberProps): HTMLDivElement {
+export function inputNumber(props: InputNumberProps): HTMLElement {
   const min = props.min ?? -Infinity; // 无下限缺省
   const max = props.max ?? Infinity; // 无上限缺省
   const step = props.step ?? 1; // 步长缺省 1
@@ -22,5 +23,5 @@ export function inputNumber(props: InputNumberProps): HTMLDivElement {
   const inc = button({ label: '+', variant: 'ghost', disabled: props.disabled, onClick: () => emit(props.value() + step) });
   dec.setAttribute('aria-label', '减少');
   inc.setAttribute('aria-label', '增加');
-  return h('div', { class: 'ua-input-number', role: 'group' }, dec, input, inc) as HTMLDivElement;
+  return addonWrap(h('div', { class: 'ua-input-number', role: 'group' }, dec, input, inc) as HTMLDivElement, props.prefix, props.suffix);
 }

packages/skin/ui/src/textField.ts

@@ -1,8 +1,9 @@
 import { effect, h } from '@ui-arch/frame';
+import { addonWrap } from './addons.js';
 import type { TextFieldProps } from './types.js';
 
-/*** 文本输入：value 信号双向绑定，disabled 支持布尔或信号禁用，onInput 为输入回调 ***/
+/*** 文本输入：value 信号双向绑定，disabled 支持布尔或信号禁用，onInput 为输入回调；prefix/suffix 包附加组 ***/
-export function textField(props: TextFieldProps): HTMLInputElement {
+export function textField(props: TextFieldProps): HTMLElement {
   const el = h('input', { class: 'ua-input', placeholder: props.placeholder ?? '', disabled: props.disabled }) as HTMLInputElement; // false/undefined 移除属性，Signal 走响应式
   if (props.value) {
     const signal = props.value;
@@ -12,5 +13,5 @@ export function textField(props: TextFieldProps): HTMLInputElement {
     });
   }
   if (props.onInput) el.addEventListener('input', () => props.onInput!(el.value));
-  return el;
+  return addonWrap(el, props.prefix, props.suffix);
 }

packages/skin/ui/src/textarea.ts

@@ -1,8 +1,9 @@
 import { effect, h } from '@ui-arch/frame';
+import { addonWrap } from './addons.js';
 import type { TextareaProps } from './types.js';
 
-/*** 多行输入：value 信号双向绑定，disabled 支持布尔或信号禁用，onInput 为输入回调 ***/
+/*** 多行输入：value 信号双向绑定，disabled 支持布尔或信号禁用，onInput 为输入回调；prefix/suffix 包纵向附加组 ***/
-export function textarea(props: TextareaProps): HTMLTextAreaElement {
+export function textarea(props: TextareaProps): HTMLElement {
   const el = h('textarea', { class: 'ua-textarea', rows: props.rows ?? 3, placeholder: props.placeholder ?? '', disabled: props.disabled }) as HTMLTextAreaElement; // false/undefined 移除属性，Signal 走响应式
   if (props.value) {
     const signal = props.value;
@@ -12,5 +13,5 @@ export function textarea(props: TextareaProps): HTMLTextAreaElement {
     });
   }
   if (props.onInput) el.addEventListener('input', () => props.onInput!(el.value));
-  return el;
+  return addonWrap(el, props.prefix, props.suffix, true);
 }

packages/skin/ui/src/types.ts

@@ -32,6 +32,8 @@ export interface TextFieldProps {
   value?: Signal<string>;            // 双向绑定的信号
   disabled?: boolean | Signal<boolean>; // 禁用态：布尔直接置位，传信号则动态同步
   onInput?: (value: string) => void; // 输入回调
+  prefix?: string | HTMLElement;     // 输入框内侧前置附加块（如图标、货币符）；缺省不渲染
+  suffix?: string | HTMLElement;     // 输入框内侧后置附加块（如单位）；缺省不渲染
 }
 
 /*** 卡片入参 ***/
@@ -163,6 +165,8 @@ export interface TextareaProps {
   value?: Signal<string>;            // 双向绑定的信号
   disabled?: boolean | Signal<boolean>; // 禁用态：布尔直接置位，传信号则动态同步
   onInput?: (value: string) => void; // 输入回调
+  prefix?: string | HTMLElement;     // 上方附加块（如标题、计数说明）；缺省不渲染
+  suffix?: string | HTMLElement;     // 下方附加块（如字数提示）；缺省不渲染
 }
 
 /*** 数字输入入参 ***/
@@ -173,6 +177,8 @@ export interface InputNumberProps {
   step?: number;           // 步长；缺省 1
   disabled?: boolean | Signal<boolean>; // 禁用态：布尔直接置位，传信号则动态同步
   onChange?: (value: number) => void;   // 值变化回调（已夹取到合法区间）
+  prefix?: string | HTMLElement;        // −/+ 按钮前的附加块（如货币符）；缺省不渲染
+  suffix?: string | HTMLElement;        // +/+ 按钮后的附加块（如单位）；缺省不渲染
 }
 
 /*** 步骤条条目 ***/

packages/skin/ui/ua.manifest.json

@@ -14,9 +14,9 @@
     "entry": "src/index.ts",
     "exports": [
       "button(props)：按钮，variant = primary | ghost | danger，disabled 支持布尔或信号禁用",
-      "textField(props)：文本输入，value 信号双向绑定，disabled 支持布尔或信号禁用",
+      "textField(props)：文本输入，value 信号双向绑定，disabled 支持布尔或信号，onInput 输入回调；prefix/suffix 可选渲染为输入框内侧附加块",
-      "inputNumber(props)：数字输入，−/+ 按钮 + 键盘 ↑↓ 调节，value 信号双向绑定，min/max/step 超界自动夹取",
+      "inputNumber(props)：数字输入，−/+ 按钮与键盘 ↑↓ 调节，min/max/step 夹取；prefix/suffix 可选渲染为整组前后附加块",
-      "textarea(props)：多行输入，value 信号双向绑定，disabled 支持布尔或信号禁用",
+      "textarea(props)：多行输入，value 信号双向绑定，disabled 支持布尔或信号，rows 控行数；prefix/suffix 可选渲染为上下附加块",
       "slider(props)：滑块，value 信号双向绑定，min/max/step 可配，原生 range 承载键盘交互，右侧可显示当前值",
       "checkbox(props)：复选框，checked 信号双向绑定，disabled 支持布尔或信号禁用",
       "switchButton(props)：开关，checked 信号双向绑定，disabled 支持布尔或信号禁用",
@@ -196,13 +196,24 @@
             "t": "(value: string) => void",
             "k": 1,
             "d": "输入回调，每次按键触发"
+          },
+          {
+            "n": "prefix",
+            "t": "string | HTMLElement",
+            "d": "前置附加块（textField/inputNumber 在输入框内侧前、textarea 在上方）；缺省不渲染"
+          },
+          {
+            "n": "suffix",
+            "t": "string | HTMLElement",
+            "d": "后置附加块（textField/inputNumber 在输入框内侧后、textarea 在下方）；缺省不渲染"
           }
         ],
         "example": "const name = signal(''); const el = textField({ value: name, placeholder: '输入名字…', onInput: (v) => console.log(v) })",
         "steps": [
           "先用 signal('') 创建字符串信号",
           "传入 value 完成双向绑定：用户输入自动写回，外部赋值自动回显",
-          "在任意响应式位置用 name() 读取最新值，如 () => `你好，${name()}`"
+          "在任意响应式位置用 name() 读取最新值，如 () => `你好，${name()}`",
+          "需要图标、货币符、单位等前后缀时传 prefix/suffix（字符串或 DOM），控件会包进带边框的附加组，聚焦光环由组统一承载"
         ]
       },
       {
@@ -242,13 +253,24 @@
             "t": "(value: number) => void",
             "k": 1,
             "d": "值变化回调（已夹取到合法区间）"
+          },
+          {
+            "n": "prefix",
+            "t": "string | HTMLElement",
+            "d": "前置附加块（textField/inputNumber 在输入框内侧前、textarea 在上方）；缺省不渲染"
+          },
+          {
+            "n": "suffix",
+            "t": "string | HTMLElement",
+            "d": "后置附加块（textField/inputNumber 在输入框内侧后、textarea 在下方）；缺省不渲染"
           }
         ],
         "example": "const qty = signal(1); const el = inputNumber({ value: qty, min: 1, max: 99, onChange: (v) => console.log(v) })",
         "steps": [
           "用 signal(1) 创建数字信号并传入 value 完成双向绑定",
           "点击 −/+ 按钮或在输入框聚焦时按 ↑↓ 以 step 调节；直接输入在失焦或回车时解析",
-          "非法输入自动回滚为当前值；min/max 超界自动夹取，disabled 支持布尔或信号禁用"
+          "非法输入自动回滚为当前值；min/max 超界自动夹取，disabled 支持布尔或信号禁用",
+          "需要图标、货币符、单位等前后缀时传 prefix/suffix（字符串或 DOM），控件会包进带边框的附加组，聚焦光环由组统一承载"
         ]
       },
       {
@@ -282,13 +304,24 @@
             "t": "(value: string) => void",
             "k": 1,
             "d": "输入回调"
+          },
+          {
+            "n": "prefix",
+            "t": "string | HTMLElement",
+            "d": "前置附加块（textField/inputNumber 在输入框内侧前、textarea 在上方）；缺省不渲染"
+          },
+          {
+            "n": "suffix",
+            "t": "string | HTMLElement",
+            "d": "后置附加块（textField/inputNumber 在输入框内侧后、textarea 在下方）；缺省不渲染"
           }
         ],
         "example": "const bio = signal(''); textarea({ value: bio, rows: 4, placeholder: '一句话介绍…' })",
         "steps": [
           "创建信号并传入 value",
           "用 rows 控制初始高度，用户可纵向拉伸",
-          "字数统计等派生逻辑直接在响应式文本里读 bio().length"
+          "字数统计等派生逻辑直接在响应式文本里读 bio().length",
+          "需要图标、货币符、单位等前后缀时传 prefix/suffix（字符串或 DOM），控件会包进带边框的附加组，聚焦光环由组统一承载"
         ]
       },
       {

packages/skin/ui/ui.css

@@ -1608,3 +1608,42 @@ button.ua-step-dot:hover {
     transition: none !important;
   }
 }
+
+/* ---- 输入附加组（prefix/suffix） ---- */
+.ua-input-group {
+  display: inline-flex;
+  align-items: center;
+  border: 1px solid var(--ua-color-border);
+  border-radius: var(--ua-radius-md);
+  background: var(--ua-color-bg);
+  transition: border-color 0.15s, box-shadow 0.15s;
+}
+.ua-input-group:focus-within {
+  border-color: var(--ua-color-accent);
+  box-shadow: 0 0 0 3px color-mix(in srgb, var(--ua-color-accent) 18%, transparent);
+}
+.ua-input-group .ua-input,
+.ua-input-group .ua-textarea {
+  border: none;           /* 组已带边框，内层去边防双线 */
+  border-radius: 0;
+  min-width: 160px;
+  background: transparent;
+}
+.ua-input-group .ua-input:focus,
+.ua-input-group .ua-textarea:focus {
+  box-shadow: none;       /* 聚焦光环由组统一承载 */
+  outline: none;
+}
+.ua-input-group-column {
+  flex-direction: column;
+  align-items: stretch;
+}
+.ua-input-addon {
+  display: inline-flex;
+  align-items: center;
+  padding: 6px 10px;
+  color: var(--ua-color-text-muted);
+  background: color-mix(in srgb, var(--ua-color-text) 5%, transparent);
+  font-size: var(--ua-font-size-md);
+  user-select: none;
+}

packages/tools/cli/bin/ua.js

@@ -610,7 +610,7 @@ function checkReadme(pkgs) {
 function checkCountDocs(actual) {
   const issues = [];
   const re = /(\d+)\s*个(?:\s*DOM\s*)?组件/;
-  for (const name of ['AGENTS.md', 'ARCHITECTURE.md']) {
+  for (const name of ['AGENTS.md', 'ARCHITECTURE.md', 'README.md']) {
     const file = path.join(ROOT, name);
     if (!fs.existsSync(file)) continue; // 卫语句：文档缺失不校验
     fs.readFileSync(file, 'utf8').split(/\r?\n/).forEach((line, i) => {
@@ -623,6 +623,18 @@ function checkCountDocs(actual) {
   return issues;
 }
 
+/*** llms-full.txt 同步校验：内联重渲染 Agent 文档（时间戳归一化）与落盘产物比对，防 manifest 改后忘跑 docs ***/
+function checkLlmsFull(pkgs, issues) {
+  if (!fs.existsSync(LLMS_FULL)) return; // 卫语句：产物缺失不算漂移（可能是新仓库）
+  const tokensPath = path.join(ROOT, 'packages', 'design', 'tokens', 'tokens.json');
+  const tokens = fs.existsSync(tokensPath) ? JSON.parse(fs.readFileSync(tokensPath, 'utf8')) : null;
+  const norm = (s) => s.replace(/\r\n/g, '\n').replace(/自动生成于 [^，]*/, '自动生成于 X');
+  const expected = renderAgentDocs({ generatedAt: '', packages: pkgs }, tokens);
+  if (norm(fs.readFileSync(LLMS_FULL, 'utf8')) !== norm(expected)) {
+    issues.push('llms-full.txt 与清单不一致，请运行 npm run docs 重新生成');
+  }
+}
+
 /*** 清单一致性校验：组件文档块的 id / props 说明 / demo 锚点必须与代码和演示产物对齐 ***/
 function cmdVerify() {
   const issues = [];
@@ -663,6 +675,7 @@ function cmdVerify() {
     .flatMap((p) => p.docs?.components ?? []).length;
   issues.push(...checkCountDocs(skinTotal));
   issues.push(...checkReadme(pkgs));
+  checkLlmsFull(pkgs, issues);
 
   if (issues.length) {
     for (const it of issues) console.error('verify: ' + it);