# structured-info-skill

**Repository Path**: woipanda/structured-info-skill

## Basic Information

- **Project Name**: structured-info-skill
- **Description**: Structured Info skill for OpenClaw: read links/materials, restructure into reusable readable output.
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-31
- **Last Updated**: 2026-04-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Structured Info

把链接或材料整理成一版**可直接阅读、可直接转发**的结构化结果，并保存本地。

## 设计定位

这是一个**材料重组器**。

它只负责三件事：
1. 读取正文
2. 按稳定结构重组内容
3. 产出可复用的结构化结果

默认结构收口为 4 段：
- **基础信息**
- **核心内容**
- **相关视角**
- **下一步**

## 主入口

```bash
python3 scripts/structured_info.py "<URL 或本地文件>"
```

常用：

```bash
python3 scripts/structured_info.py "https://mp.weixin.qq.com/s/xxxx" --template benchmark
python3 scripts/structured_info.py "/path/to/raw.md" --template benchmark
python3 scripts/structured_info.py "https://example.com/post" --structure "基础信息 / 核心内容 / 相关视角 / 下一步"
```

## 输出

默认会落到：

```text
/root/.openclaw/workspace-manager/staging/structured-info/<日期-标题>/
```

每次保存：
- `raw.md`
- `structured.md`
- `meta.json`

## 模板

- `default`：通用整理
- `value-action`：价值判断 / 下一步
- `benchmark`：对标 / 比较 / 风险

也支持：
- `--template auto`：自动判断最合适模板
- 中文别名：`通用版` / `价值版` / `对标版`
- `--structure "基础信息 / 核心内容 / 相关视角 / 下一步"`

## 模板选择优先级

脚本按下面顺序选模板：
1. 本次显式指定模板
2. 已保存默认模板
3. 自动路由判断模板
4. 系统兜底模板

如果觉得这版不合适，直接重跑切模板即可：

```bash
python3 scripts/structured_info.py "<URL>" --template 对标版
python3 scripts/structured_info.py "<URL>" --template 价值版
```

## 解析策略（轻量增强）

当前版本不是靠复杂文体分类去硬分流，而是先做一层 **轻量语义分块 + 栏目匹配**：

1. 先按标题 / 段落生成多个内容块
2. 给不同栏目（核心内容 / 相关视角 / 下一步 等）分别做轻量打分
3. 优先选和当前栏目最匹配的内容块，而不是只摘前几段
4. 命中不足时再回退到原有规则

这样做的目标不是追求重型理解，而是让它在 **文章、清单、演讲稿、访谈、对话体、散文式说明** 之间更稳一点，不因为文体变化就明显跑偏。

## 当前状态

已完成：
- 链接 / 本地材料读取
- 自动选模板
- 自定义结构
- 模板前台栏目统一为：基础信息 / 核心内容 / 相关视角 / 下一步

一句话：
**它只负责把内容整理成稳定、可复用的结构化结果。**


## 渲染控制

模板除了定义内容结构，也可以通过 `render` 字段约束默认渲染格式，例如：

```yaml
render:
  section_header: "## "
  field_prefix: "**"
  list_bullet: "- "
```