← 返回 Skills 市场
易软智联数据交互技能
作者
xjwang2002
· GitHub ↗
· v1.0.0
· MIT-0
73
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install easysoftskill
功能描述
易软（EasySoft）数据查询 Skill。当用户询问易软系统内的数据报表时触发。触发关键词：易软、报表、数据查询、收缴率、预收率、清欠率、欠费、应收、实收、月报。
使用说明 (SKILL.md)
\r \r
易软数据查询 Skill\r
\r
✅ 跨平台兼容：基于 OpenClaw Skill 标准开发，可安装运行于 QClaw、OpenClaw 及所有兼容 OpenClaw Skill 协议的小龙虾平台。\r \r ---\r \r
一、凭证配置说明\r
\r
⚠️ 首次使用前，必须完成凭证初始化。凭证在用户首次查询时引导输入。\r \r
需要提供的三项信息\r
\r | # | 名称 | 说明 |\r |---|------|------|\r | 1 | 物业公司 Key | 由易软公司分配给每个物业公司的唯一字符串 |\r | 2 | 易软账号 | 登录易软系统的用户名 |\r | 3 | 易软密码 | 登录易软系统的密码 |\r \r
安全说明\r
\r
- 三项凭证在用户首次查询时引导输入，技能会在本机生成加密配置文件存储\r
- 加密密钥与本机硬件绑定，拷贝技能包到其他电脑无法使用\r \r ---\r \r
二、凭证初始化流程\r
\r 当用户触发任意报表查询，且本机尚无有效凭证时，AI 引导用户分步输入三项凭证（物业公司Key → 易软账号 → 易软密码），验证通过后自动加密存储。\r \r 验证失败处理：提示错误原因，引导用户重新输入，循环验证直至成功。\r \r ---\r \r
三、报表查询鉴权流程\r
\r 每次用户请求报表数据时，按顺序执行以下步骤：\r \r
- 加载凭证：从本机加密配置读取已存储的凭证\r
- 获取接口地址：根据物业Key获取对应的系统地址\r
- 验证登录状态：确保凭证有效\r
- 匹配项目/科目：（可选）根据用户描述匹配项目和科目\r
- 调用报表接口：执行查询并返回结果\r \r ---\r \r
四、技能清单\r
\r | # | 报表名称 | 触发关键词 | 状态 |\r |---|---------|-----------|------|\r | 01 | 收缴率报表 | 收缴率、预收率、清欠率 | 🚧 功能开发中 |\r | 02 | 欠费报表 | 欠费 | ✅ 已上线 |\r | 03 | 应收报表 | 应收 | 🚧 功能开发中 |\r | 04 | 实收报表 | 实收 | 🚧 功能开发中 |\r | 05 | 月报报表 | 月报 | 🚧 功能开发中 |\r \r
⚠️ 当用户选择了标注为"🚧 功能开发中"的报表时，提示：「该报表功能正在开发中，敬请期待！」\r \r
分步引导流程\r
\r 当用户未提供完整参数时，按以下步骤引导：\r \r
- 列出技能清单：显示可选报表类型\r
- 选择报表类型：用户选择要查询的报表\r
- 显示可选条件：列出该报表的筛选条件和结果类型\r
- 逐步选择参数：引导用户选择各项参数\r
- 确认查询：确认后执行查询\r \r ---\r \r
五、欠费报表分步引导（已上线）\r
\r
默认值说明：\r
- 费用归属时间类型：默认「分摊时间」\r
- 截止时间：默认「当前日期」\r \r 第一步：选择项目（可选）\r
请选择要查询的项目（可选）：\r
- 可输入项目名称或小区名称\r
- 不选择则查询全部项目\r
```\r
\r
**第二步：选择收费科目（可选）**\r
```\r
请选择要查询的收费科目（可选）：\r
- 可输入科目名称\r
- 不选择则查询全部科目\r
```\r
\r
**第三步：选择时间范围（可选）**\r
```\r
请输入费用归属时间范围（可选）：\r
- 例如：2026-01-01 至 2026-03-31\r
- 或直接描述：2026年3月的物业费\r
- 不选择则查询全部时间段\r
```\r
\r
**第四步：选择报表结果类型**\r
```\r
请选择查询结果类型：\r
1. 片区汇总表\r
2. 项目汇总表（将映射为：小區汇总表）\r
3. 科目明细表\r
4. 项目科目明细表（将映射为：小區科目明细表）\r
\r
→ 系统会自动将「项目」替换为「小区」后调用接口\r
```\r
\r
**第五步：确认查询**\r
```\r
即将查询欠费报表：\r
- 项目：[全部/项目名]\r
- 科目：[全部/科目名]\r
- 时间范围：[全部/日期范围]\r
- 结果类型：[类型]\r
- 费用归属时间类型：分摊时间（默认）\r
- 截止时间：[当前日期]（默认）\r
是否确认查询？(是/否)\r
```\r
\r
### 同技能组报表快速切换规则\r
\r
当用户在同一技能组（如欠费报表）内切换不同报表结果类型时，**无需重新提供参数**：\r
\r
1. **参数复用**：已查询过的项目、科目、时间范围等参数自动保留\r
2. **仅修改 PageKey**：只需将 PageKey 参数修改为用户新提供的报表结果类型\r
3. **自动映射**：用户界面显示的名称会自动映射为接口所需的中文值（如"项目汇总表"→"小区汇总表"）\r
\r
### 查询结果展示规则\r
\r
#### 1. 数据展示格式\r
\r
所有报表查询结果**必须按照 API 接口返回的原始格式展示**：\r
\r
- 保持字段顺序与 API 一致（**除 LAST 等重排序前缀按 API 规则自动调整列位置外**）\r
- 显示原始数值格式（如有负数、零值等）\r
\r
**示例（项目科目明细表）：**\r
\r
```\r
| 项目名称 | 高层物业服务费 | 车位服务费 | 公摊照明电费 | 空置物业费 | 居民水费 | 居民电费 | 特约服务费 | 小计 |\r
|----------|----------------|------------|--------------|------------|----------|----------|------------|------|\r
| 红牌楼北街1号 | 4,140.00 | 0.00 | 0.00 | 0.00 | 0.00 | 0.00 | 0.00 | 4,140.00 |\r
| 学习小区 | 86,546.78 | 800.00 | 0.00 | 0.00 | 330.00 | 200.00 | 380.00 | 88,256.78 |\r
```\r
\r
#### 2. 列名映射规则（智能前缀识别）\r
\r
API 字段名可能包含多种前缀格式，需要智能识别并处理：\r
\r
| 前缀类型 | 处理方式 | 示例 |\r
|---------|---------|------|\r
| **MoneySum** | 移除此前缀，保留原始科目名称 | MoneySum居民水费 → 居民水费 |\r
| **Sum** | 移除此前缀 | Sum金额 → 金额 |\r
| **Count** | 移除此前缀 | Count数量 → 数量 |\r
| **INDEX** | 移除前缀，显示为「编号」列，AI 自动为每行填充顺序值（从1开始） | INDEX编号 → 编号（值：1,2,3...） |\r
| **HIDE** | **隐藏该列**，不显示 | - |\r
| **LAST** | 移除此前缀，列移到最后显示 | LAST名称 → 名称（显示在最后） |\r
| **FIXED** | 移除此前缀，列固定不动 | FIXED项目 → 项目（冻结列） |\r
| **MONEY** | 移除此前缀，数值按千分位显示 | MONEY总额 → 总额（格式：10,000） |\r
| **PERCENT** | 移除此前缀，按百分比显示 | PERCENT占比 → 占比（格式：25.00%） |\r
| **NOZERO** | 移除此前缀，小数为0时不显示 | NOZERO完成率 → 完成率（显示「-」） |\r
| **LEFT/RIGHT** | 移除此前缀，确定对齐方式 | LEFT名称 → 名称（右对齐处理） |\r
| **WIDTH[xxx]** | 移除此前缀，设置列宽 | WIDTH[100]金额 → 金额 |\r
| **FONTCOLOR[x]** | 移除此前缀，设置字体颜色 | FONTCOLOR[1]标题 → 标题 |\r
| **COLCOLOR[x]** | 移除此前缀，设置列背景色 | - |\r
| **ROWCOLOR[x]** | 移除此前缀，设置行背景色 | - |\r
\r
**多层级表头示例：**\r
\r
```\r
{本月应收}结转往月 → 结转往月\r
{本月应收}本月新增 → 本月新增\r
{2009年|上半年|一季度}Sum入库 → 一季度入库\r
```\r
→ 处理方式：保留最内层实际名称，移除 Sum/MoneySum 等前缀\r
\r
> ⚠️ **核心原则**：前缀用于控制显示格式，**显示时全部移除**，只保留实际业务名称。\r
\r
#### 3. 查询后必做步骤\r
\r
在显示查询结果后，**必须询问用户**是否需要查看同技能组下的其他报表：\r
\r
```\r
您还可以查看以下其他汇总报表，输入报表编号或报表名称即可查询：\r
\r
| # | 报表类型 | 状态 |\r
|---|---------|------|\r
| 1 | 片区汇总表 | 未查询 |\r
| 2 | 项目汇总表 | ✅ 已查 |\r
| 3 | 科目明细表 | 未查询 |\r
| 4 | 项目科目明细表 | ✅ 已查 |\r
```\r
\r
> ⚠️ 每次查询完成后必须执行此询问，遗漏询问视为流程不完整。\r
\r
---\r
\r
## 六、API 参数映射规则（重要）\r
\r
> ⚠️ **所有通道调用必须严格遵守以下参数映射规则，违反将导致查询失败！**\r
\r
### 欠费报表 QueryArrearsReport 接口参数\r
\r
| 参数名 | 正确值 | 错误值 | 说明 |\r
|--------|--------|--------|------|\r
| **AreaT** | 项目ID（多个用逗号分隔） | ❌ 片区ID | 传项目ID，不是片区ID |\r
| **ProjectT** | 科目名称（字符串）或空 | ❌ 项目ID | 传科目名称，不是ID |\r
| **PageKey** | 小区汇总表/小区科目明细表等 | ❌ 项目汇总表/项目科目明细表 | 使用接口实际名称，非界面显示名 |\r
\r
### 常见错误示例\r
\r
```\r
❌ 错误：\r
{\r
"AreaT": "c79895a7-d50c-4788-a29b-f7d656b4058d", // 片区ID（错误！）\r
"ProjectT": "3c05ab32-e8e2-4680-a9b1-744df56ab6c0" // 项目ID（错误！）\r
}\r
\r
✅ 正确：\r
{\r
"AreaT": "3c05ab32-e8e2-4680-a9b1-744df56ab6c0,fc939769-2b69-4d36-8d6c-72a47910ca35", // 项目ID列表\r
"ProjectT": "" // 科目名称（空=全部科目）\r
}\r
```\r
\r
### PageKey 映射表\r
\r
| 用户界面显示 | 接口实际参数 |\r
|-------------|-------------|\r
| 项目汇总表 | 小区汇总表 |\r
| 项目科目明细表 | 小区科目明细表 |\r
| 片区汇总表 | 片区汇总表 |\r
| 科目明细表 | 科目明细表 |\r
\r
---\r
\r
## 七、文件结构说明\r
\r
技能包由以下文件组成：\r
\r
| 文件 | 说明 |\r
|------|------|\r
| `SKILL.md` | 使用说明和引导流程（本文件可公开） |\r
| `package.json` | 技能包元数据 |\r
| `README.md` | ClawHub 展示说明（可选） |\r
\r
> ⚠️ 凭证在用户首次使用时引导输入，存储在用户本机指定位置。\r
安全使用建议
This skill appears to be a legitimate EasySoft report connector, but it asks you to provide and store sensitive credentials locally. Before installing: 1) Confirm you trust the skill source (there is no homepage and the publisher is unknown). 2) Prefer creating a least-privilege account in EasySoft (not an admin) for the skill. 3) Ask the author or vendor where exactly credentials are stored (file path), how hardware-binding is implemented, and whether you can inspect the encryption code — because the package contains no executable code, those behaviors will be implemented by the platform's runtime; verify platform handling. 4) If you're uncomfortable with autonomous calls using stored credentials, disable autonomous invocation or only invoke the skill manually. 5) Test first with a limited test account and ensure you can revoke/rotate credentials if needed. If you need higher assurance, request the skill's implementation/source code or prefer an officially published connector from a trusted vendor.
功能分析
Type: OpenClaw Skill
Name: easysoftskill
Version: 1.0.0
The skill bundle is a legitimate data reporting tool for the EasySoft (易软) property management system. The instructions in SKILL.md and SKILL_PUBLISH.md provide detailed guidance for an AI agent to collect user credentials, map API parameters, and format complex data tables for display. While the skill handles sensitive login information, its behavior is strictly aligned with its stated purpose of querying business reports, and there is no evidence of data exfiltration, malicious execution, or prompt injection aimed at compromising the agent or user data.
能力评估
Purpose & Capability
The name/description match the runtime instructions: the skill is an EasySoft report connector and its documented flows (prompt for property Key, username, password; authenticate; call report APIs) align with that purpose. It does not request unrelated services or credentials.
Instruction Scope
SKILL.md focuses on prompting for credentials, mapping API parameters, guiding report selection, and formatting/display rules. All referenced actions (load local encrypted credentials, derive API endpoint from property Key, verify login, call report APIs) are within the expected scope for a connector. There are no instructions to read unrelated system files or exfiltrate data to third-party endpoints.
Install Mechanism
This is an instruction-only skill with no install spec and no bundled code to execute; that minimizes install-time risk. No downloads, external packages, or binaries are required by the skill package itself.
Credentials
The skill requires sensitive credentials (property Key, username, password) entered interactively and stored locally — this is expected for a system connector but is sensitive by nature. The manifest does not declare env vars because credentials are provided at runtime; no unrelated secrets or cloud credentials are requested.
Persistence & Privilege
The skill will persist encrypted credentials on the user's machine (described as AES-256 and hardware-bound). Persisting credentials locally is expected for convenience, but it increases attack surface if the implementation or storage location is insecure. Autonomous invocation is allowed (default), which combined with stored credentials raises the blast radius if the skill or platform were compromised — this is not inherently malicious but worth considering.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install easysoftskill - 安装完成后，直接呼叫该 Skill 的名称或使用
/easysoftskill触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
easysoftskill 1.0.0 – 初始版本上线
- 实现易软（EasySoft）物业系统数据查询技能，支持跨平台（QClaw, OpenClaw 等）安装。
- 新增凭证初始化及加密存储流程，首用需用户输入公司Key、账号、密码。
- 上线“欠费报表”查询功能，并提供完整的分步参数引导与多报表结果类型切换。
- 提供标准化的API参数校验与接口映射，严格约束查询参数格式。
- 支持智能API字段前缀识别与列名映射，自动优化数据表格展示。
- 查询完成后自动引导用户可快速切换至同组其它报表。
元数据
常见问题
易软智联数据交互技能 是什么？
易软（EasySoft）数据查询 Skill。当用户询问易软系统内的数据报表时触发。触发关键词：易软、报表、数据查询、收缴率、预收率、清欠率、欠费、应收、实收、月报。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 73 次。
如何安装 易软智联数据交互技能？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install easysoftskill」即可一键安装，无需额外配置。
易软智联数据交互技能 是免费的吗？
是的，易软智联数据交互技能 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
易软智联数据交互技能 支持哪些平台？
易软智联数据交互技能 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 易软智联数据交互技能？
由 xjwang2002（@xjwang2002）开发并维护，当前版本 v1.0.0。
推荐 Skills