Cailianpress Unified

提供统一稳定的财联社电报数据访问，支持加红、电报、热度查询及文章详情，保证数据可审计和格式统一。

Security Scan

The skill's code, docs, and runtime instructions are coherent with its stated purpose: fetching and normalizing Cailian Press telegraph data and storing/querying it locally; it does not request secrets or unusual privileges.

Purpose & Capability

Name/description match the actual code and docs: adapters fetch from CLS endpoints, service layer normalizes items, CLI and SQLite snapshot/ingest/query tools are present. No unrelated credentials, binaries, or external services are requested.

Instruction Scope

SKILL.md limits scope to telegraph queries, detail resolution, snapshot/sqlite modes and operational advice (cron, tests). Runtime instructions and code only access local files under the skill tree and CLS endpoints; they do not read unrelated system files or attempt to transmit data to unexpected external hosts.

Install Mechanism

No install spec is provided (instruction-only in metadata) and only a minimal requirements.txt (requests). There are source files included; nothing is downloaded from arbitrary URLs and no extract/install steps are declared.

Credentials

No required environment variables or credentials are declared or accessed. The code performs network calls only to documented CLS hosts and writes local DB/files under the skill workspace, which is proportional to the stated purpose.

Persistence & Privilege

The skill creates and uses a local SQLite DB (data/telegraph.db) and a JSONL snapshot file and includes a prune script that deletes telegraph_raw_log rows older than 30 days. It does not request system-wide privileges or modify other skills, but users should be aware it stores and prunes local audit data when scheduled.

Assessment

This skill appears to do what it says: it fetches CLS telegraphs, normalizes them, and stores/query them locally. Before installing: 1) Review and accept that it will create files under skills/cailianpress-unified/data (telegraph.db and JSONL snapshots). 2) Note the raw-log retention policy: cls_prune_raw_log.py deletes telegraph_raw_log entries older than 30 days—if you need longer audit retention, modify the script or archive data before pruning. 3) The code makes HTTP requests only to CLS domains (www.cls.cn and api3.cls.cn); confirm this is acceptable and complies with your usage policies/CLS terms. 4) If you plan to run the ingest/snapshot cron entries, run the tests locally first (pytest) and/or run in an isolated workspace to avoid mixing with other data. 5) No secrets are requested, but you should still review and vet the code before scheduling automated runs. Autonomous agent invocation is enabled by platform default, but this skill is not marked always:true; restrict autonomous usage if you do not want agents to call it without explicit action.

统一的财联社（CLS）数据技能。该技能为整个工作区提供单一、稳定、可审计的财联社数据访问入口，避免不同脚本、任务、报告各自调用不同 CLS 接口而导致口径漂移。

核心目标

• 统一财联社电报数据入口
• 统一加红、热度、详情字段解释
• 为其他技能提供稳定的可复用接口
• 将“原始抓取”与“展示格式”解耦
• 让整个系统以后只维护一个 CLS 真相源

V1 能力边界

包含

• 普通电报查询
• 加红电报查询
• 热度电报查询
• 基础文章详情补全
• 页面兜底抓取

不包含

• 财联社深度稿件体系的完整解析
• 登录态内容或会员专享内容
• 评论、互动、专栏系统
• 专题页、热榜页、板块页的完整统一

统一数据源

主源

• https://www.cls.cn/nodeapi/telegraphList

详情源

• https://api3.cls.cn/share/article/{id}

兜底源

• https://www.cls.cn/telegraph

统一规则

基于当前工作区实测，V1 采用以下规则：

• level in {"A", "B"} → 视为加红
• level == "C" → 普通电报
• reading_num → 热度字段
• ctime → 原始发布时间戳
• shareurl → 文章分享链接

对外接口

CLI

python3 skills/cailianpress-unified/scripts/cls_query.py telegraph --hours 1
python3 skills/cailianpress-unified/scripts/cls_query.py telegraph --hours 24
python3 skills/cailianpress-unified/scripts/cls_query.py red --hours 24
python3 skills/cailianpress-unified/scripts/cls_query.py hot --hours 1 --min-reading 10000
python3 skills/cailianpress-unified/scripts/cls_query.py article --id 2326490

服务层

推荐供其他 Python 技能调用：

• scripts/cls_service.py

输出格式

支持：

• json
• text
• markdown

目录结构

skills/cailianpress-unified/
├── README.md
├── SKILL.md
├── CHANGELOG.md
├── docs/
│   └── api_contract.md
├── scripts/
│   ├── cls_query.py
│   ├── cls_service.py
│   ├── adapters/
│   │   ├── article_share.py
│   │   ├── telegraph_nodeapi.py
│   │   └── telegraph_page_fallback.py
│   ├── formatters/
│   │   ├── json_formatter.py
│   │   ├── markdown_formatter.py
│   │   └── text_formatter.py
│   └── models/
│       └── schemas.py
└── tests/

使用纪律

应该做

• 把本技能视为唯一公开 CLS 入口
• 保留原始字段，确保结果可审计
• 统一通过 schema 输出给下游

不应该做

• 不要在别的技能里直接请求 CLS 接口
• 不要再把页面热榜、加红、本地缓存、普通电报混为一谈
• 不要用临时脚本绕过这个技能去访问财联社

迁移建议

推荐顺序：

1. 先在本技能内跑通并稳定验证
2. 迁移 hourly-pulse-report-001
3. 迁移“过去1小时/24小时财联社电报”类任务
4. 迁移加红简报与依赖 CLS 的 stock-news 聚合链路
5. 最后清理旧的直接访问逻辑

发布说明

当前文档同步版本：0.1.2（2026-03-29）

这个技能已经按 GitHub / ClawHub 友好方式组织，但正式发布前仍建议：

• 在有 pytest 的环境里补跑测试
• 审查 README 示例与实际代码是否保持一致
• 确认发布仓库已配置远端与有效 GitHub 认证
• 发布到 ClawHub 前确认账号已登录且元数据完整
• 若独立仓库发布，补充仓库级 LICENSE