Files
1hew 161b87e870 feat(release): 发布 v4.1.0,新增 Any to Any 与计数节点,增强 IO 与动态端口
- feat(conversion): 新增 Any to Any 通配透传节点
- feat(int): 新增 Int Mask/Audio/Text Count,并统一计数共享层
- feat(logic): Multi Switch Select 支持 a/all 全选
- feat(io): Load PS 预览默认开启并抑制 psd_tools INFO 噪音;Save Audio 默认 mp3,播放器兼容 Nodes 2.0
- fix(multi): Multi String Join 的 string_1 改为纯插槽,修复动态端口错位
- refactor(shared): 复用 parse_pad_color / pad_to_rgb
- docs: 同步中英文节点文档、README 列表与 v4.1.0 日志
- test: 新增/更新相关回归测试
2026-10-23 22:21:26 +08:00

39 lines
1.9 KiB
Markdown

# Multi String Join - Ordered Join with Filtering and Placeholder
**Node Purpose:** `Multi String Join` joins multiple string inputs in numeric order using a configurable separator, with options to filter empty lines and comments, and to substitute `{input}` placeholders.
## Inputs
| Name | Port | Type | Default | Range | Description |
| ---- | ---- | ---- | ------- | ----- | ----------- |
| `filter_empty_line` | - | BOOLEAN | False | - | Remove empty lines after processing. |
| `filter_comment` | - | BOOLEAN | False | - | Remove comments and triple-quoted blocks. |
| `separator` | - | STRING | `\n` | - | Join separator; supports escapes `\n`, `\t`, `\r`. |
| `input` | - | STRING | `` | - | Value to substitute into `{input}` placeholders. |
| `string_1` | optional | STRING | - | - | First string (socket only, no text box).
| `string_2…string_N` | optional | STRING | - | - | Additional strings recognized by numeric suffix ordering.
## Outputs
| Name | Type | Description |
|------|------|-------------|
| `string` | STRING | Joined and filtered result.
## Features
- Ordered collection: gathers `string_*` inputs by numeric suffix.
- Placeholder substitution: replaces `{input}` inside each string and final result.
- Comment filtering: removes `#` comments and respects `'''`/`"""` block quotes with stateful parsing.
- Empty-line filtering: optional removal after trimming.
- Separator decoding: interprets escape sequences for clean joins.
## Typical Usage
- Prompt assembly: combine prompt fragments with placeholders for dynamic content.
- Config templating: join sections while stripping comments and blank lines.
- Ordered merging: ensure `string_1..N` join in intended sequence.
## Notes & Tips
- Block-quote handling ensures multi-line quoted content is preserved when filtering comments.
- Provide `separator="\n\n"` for paragraph breaks, or `", "` for comma-separated lists.