shuzhi-open

数秦开放平台统一接口封装，支持区块链API服务、自动化取证、保管单组件、电子签章。

⚠️ 重要原则：所有不确定的信息必须询问用户，禁止自动填充！
本 skill 涉及法律效力文件（保管单、电子合同等），所有字段必须：

- ✅ 由用户明确提供
✅ 来源可追溯
✅ 格式已确认

禁止行为：

- ❌ 自动填充任何未确认的字段
❌ 假设字段的计算方式（如 evidenceHash）
❌ 猜测模板的字段定义

配置

编辑 config.json，填入你的凭证和产品标识：

CODEBLOCK0

⚠️ 注意：

- appKey 和 appSecret 由数秦开放平台提供
区块链API服务的每个接口都有独立的产品标识，需要分别配置

用法

区块链API服务

支持数据上链存证，支持 tritium 和 conflux 两条链。

数据上链

CODEBLOCK1

带可选参数上链

CODEBLOCK2

批量查询上链结果

CODEBLOCK3

查询多个交易

node scripts/chain/query.js --index "索引1,索引2,索引3"

自动化取证

支持拼多多、淘宝、抖音、公众号取证。

⚠️ 重要：所有不确定的信息必须询问用户！

取证类型：

- 1 - 拼多多电商取证
INLINECODE6 - 淘宝电商取证
INLINECODE7 - 抖音电商取证
INLINECODE8 - 公众号取证

🌟 推荐：交互式取证（会询问所有必要信息）
CODEBLOCK5

创建取证任务（命令行）

node scripts/evidence/create-task.js --batch-id "批次ID" --url "https://..." --type 1 --att-id "保全号"

📋 自动化取证流程（交互式）

核心原则：所有不确定的信息必须询问用户！

Step 1: 询问取证类型

CODEBLOCK7

Step 2: 询问取证信息

CODEBLOCK8

示例回复：
CODEBLOCK9

Step 3: 确认信息

CODEBLOCK10

Step 4: 执行并返回结果

CODEBLOCK11

❓ 必须询问的问题

信息	必须询问的问题
取证类型	选择哪种取证类型？
URL

CAP-保管单组件

生成和管理保管单 PDF 文件。

🌟 推荐：交互式生成（会询问所有不确定的信息）
CODEBLOCK12

生成保管单（命令行）

CODEBLOCK13

下载保管单

CODEBLOCK14

获取模板列表

node scripts/certificate/templates.js

电子签章

完整的电子签章流程管理。

⚠️ 重要：所有不确定的信息必须询问用户！

🌟 推荐：AI 助手通过对话收集信息后调用
CODEBLOCK16

交互式模式（用户直接在终端输入）
CODEBLOCK17

使用配置文件
CODEBLOCK18

企业主体管理

CODEBLOCK19

个人主体管理

CODEBLOCK20

签署流程管理

# 创建签署流程
node scripts/sign/sign-flow.js create --file params.json

# 查询流程详情
node scripts/sign/sign-flow.js detail --flow-id "流程ID"

# 获取签署链接
node scripts/sign/sign-flow.js preview --flow-id "流程ID"

# 获取签署文件
node scripts/sign/sign-flow.js files --flow-id "流程ID"

# 获取签署方列表
node scripts/sign/sign-flow.js signers --flow-id "流程ID"

# 下载签署后的文件
node scripts/sign/sign-flow.js download --flow-id "流程ID" [--output "输出路径"]

📋 电子签章流程（交互式）

核心原则：所有不确定的信息必须询问用户！

Step 1: 询问合同文件和签署方数量

CODEBLOCK22

Step 2: 提供信息填写模板

根据签署方数量，提供填写模板：

CODEBLOCK23

Step 3: 确认信息

CODEBLOCK24

Step 4: 执行流程

用户确认后，AI 助手执行脚本：

CODEBLOCK25

注意：

- --signers 参数需要用单引号包裹 JSON 字符串
企业签署方 type 为 INLINECODE11
个人签署方 type 为 INLINECODE13

执行结果：

1. 创建主体（企业/个人）
创建印章
上传合同文件
创建合同模板
返回预览链接（用户配置签署位置）

❓ 必须询问的问题

信息	必须询问的问题
合同文件	合同文件路径是什么？文件格式是否符合要求？
签署方数量

⚠️ 禁止行为

❌ 禁止自动填充以下信息：

- 签署方的姓名、身份证、手机号
企业名称、统一社会信用代码
合同文件路径
印章样式（除非用户确认使用默认）

❌ 禁止假设：

- 假设用户只有一个签署方
假设签署方的角色（甲方/乙方）
假设印章样式或字体

信息收集模板

请用户提供以下信息：

1. 合同文件（必填）

- 合同文件路径（支持格式：PDF、DOCX、DOC，最大10MB）

2. 签署方信息（最多6个）

字段	说明	示例
签署方标识	如：甲方、乙方、丙方等	甲方
签署主体类型

注意：用户必须先提供合同文件路径，才能创建合同模板。

示例格式：
CODEBLOCK26

说明：

- 签署主体类型填写"企业"或"个人"
企业签署方需填写企业名称和统一社会信用代码
个人签署方无需填写企业相关字段

Step 0: 信息校验

检查签署方是否存在，并验证信息一致性：

1. 企业校验

- 根据「统一社会信用代码」查询企业是否存在 - 如果存在：检查「企业名称」是否与系统记录一致 - 如果不一致：返回错误提示，告知用户系统中该信用代码对应的企业名称

2. 个人校验

- 根据「身份证号」查询个人是否存在 - 如果存在：检查「姓名」是否与系统记录一致 - 如果不一致：返回错误提示，告知用户系统中该身份证对应的姓名

校验失败示例：
CODEBLOCK27

Step 1: 创建主体

- 企业签署：创建企业主体 → 获取企业的 userId
个人签署：创建个人主体 → 获取个人的 userId

Step 2: 创建印章

- 企业签署：为企业创建印章（默认：enterpriseSealType: 1, sealMode: 2）
个人签署：为个人创建签名（默认：sealMode: 2）

Step 3: 上传合同文件

- 上传待签署的合同文件
支持格式：PDF、DOCX、DOC
文件大小：最大10MB

Step 4: 创建合同模板

- 创建模板，配置签署方

Step 5: 获取模板预览链接

- 返回预览链接供用户配置签署位置
链接格式：使用超链接格式，用户可直接点击打开配置

CODEBLOCK28

Step 6: 创建签署流程

根据签署主体类型使用对应的 userId：

企业签署：
CODEBLOCK29

个人签署：
CODEBLOCK30

Step 7: 获取签署链接

- 返回 PC 预览链接和 H5 签署链接
链接格式：

- 模板预览链接：超链接格式，点击可直接配置 - 签署链接：同时提供超链接和纯文本链接（方便手机签署时复制） CODEBLOCK31

输出结果

流程完成后，系统将返回：

1. 主体信息 - userId、sealId（企业或个人）
合同模板信息 - templateId
模板预览链接 - 超链接格式，点击可直接配置签署位置
签署流程信息 - signFlowId、signFlowNo
签署链接 - PC预览链接、H5签署链接（超链接格式，可直接点击）

代码调用

也可在代码中直接调用模块：

CODEBLOCK32

回调验签

电子签章组件的回调需要验证签名：

CODEBLOCK33

🧪 开发规则

在开发调试接口时，遵循以下规则：

1. 不确定信息必须询问

对于 API 文档中未明确说明的字段或参数，必须询问用户，禁止自行假设或填充。

示例 - 需要询问的情况:

- 字段的值应该从哪个接口获取？
字段的计算规则是什么？（如哈希算法）
字段的格式要求是什么？
字段之间的关联关系是什么？

错误做法:
CODEBLOCK34

正确做法:
CODEBLOCK35

2. 数据来源追溯

开发时需要明确每个字段的数据来源：

字段类型	来源说明
用户输入	由用户提供（如姓名、身份证号）
接口返回

3. 开发前确认

在编写代码前，需要确认：

1. 所有必填字段的数据来源
关联字段之间的依赖关系
字段的格式和取值范围

📋 保管单生成流程（交互式）

⚠️ 核心原则：所有不确定的信息必须询问用户！

当用户请求生成保管单时，采用多次交互确认的方式：

Step 1: 查询并选择模板

CODEBLOCK36

Step 2: 询问字段信息

⚠️ 重要：模板字段因客户而异，必须询问用户！

CODEBLOCK37

示例回复：
CODEBLOCK38

Step 3: 确认信息

展示完整信息让用户确认：

CODEBLOCK39

Step 4: 执行并返回结果

CODEBLOCK40

📌 API 参数格式

自定义字段格式：

CODEBLOCK41

📌 字段取值逻辑

字段	来源	计算方式
INLINECODE14	计算得出	SHA256(JSON.stringify(上链数据))
INLINECODE15

⚠️ 注意：

- blockchainHash 使用 block_hash（区块哈希），不是 hash（交易哈希）
INLINECODE21 在上链成功后获取北京时间

📌 字段来源确认表

必须向用户确认每个字段的来源：

字段	必须确认的问题
evidenceHash	从哪个接口获取？还是自行计算？用什么算法？
blockchainHash

❓ 询问提示模板

当字段来源不明时，使用以下提示：

CODEBLOCK42

⚠️ 禁止行为

❌ 错误示例（禁止这样做）：

CODEBLOCK43

✅ 正确做法：

CODEBLOCK44

API 文档

详见 references/ 目录：

- chain-api.md - 区块链API服务文档
INLINECODE24 - 自动化取证 API 文档
INLINECODE25 - 保管单组件 API 文档
INLINECODE26 - 电子签章 API 文档

环境说明

线上环境请使用 shuqin-open skill。

错误处理

所有接口调用失败会抛出错误，建议使用 try-catch：

CODEBLOCK45

状态枚举

上链状态
值说明
0 上链失败
1
上链成功 |

值	说明
0	上链失败
1

| 2 | 等待上链 |

批次状态
值说明
NEW 新建
ASSIGNED
已分配 |

值	说明
NEW	新建
ASSIGNED

任务状态
值说明
NEW 新建
RUNNING
执行中 |

| SUCCESSED | 成功 | | FAILED | 失败 |

值	说明
NEW	新建
RUNNING

shuzhi-open

数秦开放平台统一接口封装，支持区块链API服务、自动化取证、保管单组件、电子签章。

⚠️ 重要原则：所有不确定的信息必须询问用户，禁止自动填充！
本 skill 涉及法律效力文件（保管单、电子合同等），所有字段必须：

- ✅ 由用户明确提供
✅ 来源可追溯
✅ 格式已确认

禁止行为：

- ❌ 自动填充任何未确认的字段
❌ 假设字段的计算方式（如 evidenceHash）
❌ 猜测模板的字段定义

配置

编辑 config.json，填入你的凭证和产品标识：

json
{
baseUrl: 接口地址,
appKey: 你的 appKey,
appSecret: 你的 appSecret,
products: {
chain: {
endpoints: {
upload: { productId: 上链产品标识 },
queryResult: { productId: 查询结果产品标识 }
}
},
evidence: { productId: 自动化取证产品标识 },
certificate: { productId: 保管单产品标识 },
sign: { productId: 电子签章产品标识 }
}
}

⚠️ 注意：

- appKey 和 appSecret 由数秦开放平台提供
区块链API服务的每个接口都有独立的产品标识，需要分别配置

用法

区块链API服务

支持数据上链存证，支持 tritium 和 conflux 两条链。

数据上链

bash node scripts/chain/upload.js --data 业务数据

带可选参数上链

bash node scripts/chain/upload.js --data {ano:BQ123,sha256:xxx} --business EVIDENCEPRESERVATION --source BQINTERNATIONAL

批量查询上链结果

bash node scripts/chain/query.js --index 交易索引

查询多个交易

bash node scripts/chain/query.js --index 索引1,索引2,索引3

自动化取证

支持拼多多、淘宝、抖音、公众号取证。

⚠️ 重要：所有不确定的信息必须询问用户！

取证类型：

- 1 - 拼多多电商取证
3 - 淘宝电商取证
4 - 抖音电商取证
12 - 公众号取证

🌟 推荐：交互式取证（会询问所有必要信息）
bash
node scripts/evidence/create-task-interactive.js

创建取证任务（命令行）

bash node scripts/evidence/create-task.js --batch-id 批次ID --url https://... --type 1 --att-id 保全号

📋 自动化取证流程（交互式）

核心原则：所有不确定的信息必须询问用户！

Step 1: 询问取证类型

📋 请选择取证类型：

序号	类型	说明
1	拼多多电商取证	商品详情页、店铺信息等
3

请输入序号或类型代码：

Step 2: 询问取证信息

❓ 请提供以下信息：

取证类型: [已选择]

取证信息:
取证URL: [填写网页地址]
批次ID: [填写]
保全号: [填写]
取证名称: [可选，直接回车跳过]

可选参数:
是否取证营业执照: [yes/no]

示例回复：

取证类型: 拼多多电商取证

取证信息:
取证URL: https://mobile.yangkeduo.com/goods.html?goods_id=xxx
批次ID: batch-001
保全号: att-001
取证名称: 测试取证

可选参数:
是否取证营业执照: no

Step 3: 确认信息

📝 确认信息

取证类型: 拼多多电商取证

取证信息:
取证URL: https://mobile.yangkeduo.com/goods.html?goods_id=xxx
批次ID: batch-001
保全号: att-001
取证名称: 测试取证

可选参数:
是否取证营业执照: 否

确认创建取证任务？(yes/no)

Step 4: 执行并返回结果

确认后执行：

1. 创建取证任务
返回任务状态
提供查询和下载方式

❓ 必须询问的问题

信息	必须询问的问题
取证类型	选择哪种取证类型？
URL

CAP-保管单组件

生成和管理保管单 PDF 文件。

🌟 推荐：交互式生成（会询问所有不确定的信息）
bash
node scripts/certificate/generate-interactive.js

生成保管单（命令行）

bash node scripts/certificate/create.js --file params.json

下载保管单

bash node scripts/certificate/download.js --cert-no 存证编号

获取模板列表

bash node scripts/certificate/templates.js

电子签章

完整的电子签章流程管理。

⚠️ 重要：所有不确定的信息必须询问用户！

🌟 推荐：AI 助手通过对话收集信息后调用
bash
node scripts/sign/workflow.js --contract 合同文件路径 --signers [{signerNo:甲方,type:enterprise,...}]

交互式模式（用户直接在终端输入）
bash
node scripts/sign/workflow.js --interactive

使用配置文件
bash
node scripts/sign/workflow.js --file signers.json

企业主体管理

bash

创建企业

node scripts/sign/enterprise.js create --name 公司名称 --credit-code 统一社会信用代码

查询企业列表

node scripts/sign/enterprise.js list --name 公司名称

查询企业详情

node scripts/sign/enterprise.js detail --user-id 用户ID

删除企业

node scripts/sign/enterprise.js delete --user-id 用户ID

个人主体管理

bash

创建个人

node scripts/sign/person.js create --name 姓名 --id-card 身份证号

查询个人列表

node scripts/sign/person.js list --name 姓名

查询个人详情

node scripts/sign/person.js detail --user-id 用户ID

删除个人

node scripts/sign/person.js delete --user-id 用户ID

签署流程管理

bash

创建签署流程

node scripts/sign/sign-flow.js create --file params.json

查询流程详情

node scripts/sign/sign-flow.js detail --flow-id 流程ID

获取签署链接

node scripts/sign/sign-flow.js preview --flow-id 流程ID

获取签署文件

node scripts/sign/sign-flow.js files --flow-id 流程ID

获取签署方列表

node scripts/sign/sign-flow.js signers --flow-id 流程ID

下载签署后的文件

node scripts/sign/sign-flow.js download --flow-id 流程ID [--output 输出路径]

📋 电子签章流程（交互式）

核心原则：所有不确定的信息必须询问用户！

Step 1: 询问合同文件和签署方数量

❓ 请提供以下信息：

合同文件:
文件路径: [填写PDF/DOCX/DOC路径，最大10MB]

签署方:
共几个签署方: [填写总数，最多6个]
其中企业方: [填写几方企业]
其中个人方: [填写几方个人]

Step 2: 提供信息填写模板

根据签署方数量，提供填写模板：

【企业方 1】
企业名称: [填写]
统一社会信用代码: [填写]
联系人姓名: [填写]
联系人身份证: [填写]
联系人手机: [填写]

【个人方 1】
姓名: [填写]
身份证: [填写]
手机: [填写]

（如有多个企业方/个人方，按序号继续：企业方 2、个人方 2...）

Step 3: 确认信息

📝 确认信息

合同文件: [文件路径]
签署方: [X

shuzhi-open 数秦开放接口

shuzhi-open

shuzhi-open

配置

用法

区块链API服务

数据上链

带可选参数上链

批量查询上链结果

查询多个交易

自动化取证

创建取证任务（命令行）

📋 自动化取证流程（交互式）

Step 1: 询问取证类型

Step 2: 询问取证信息

Step 3: 确认信息

Step 4: 执行并返回结果

❓ 必须询问的问题

CAP-保管单组件

生成保管单（命令行）

下载保管单

获取模板列表

电子签章

企业主体管理

个人主体管理

签署流程管理

📋 电子签章流程（交互式）

Step 1: 询问合同文件和签署方数量

Step 2: 提供信息填写模板

Step 3: 确认信息

Step 4: 执行流程

❓ 必须询问的问题

⚠️ 禁止行为

信息收集模板

Step 0: 信息校验

Step 1: 创建主体

Step 2: 创建印章

Step 3: 上传合同文件

Step 4: 创建合同模板

Step 5: 获取模板预览链接

Step 6: 创建签署流程

Step 7: 获取签署链接

输出结果

代码调用

回调验签

🧪 开发规则

1. 不确定信息必须询问

2. 数据来源追溯

3. 开发前确认

📋 保管单生成流程（交互式）

Step 1: 查询并选择模板

Step 2: 询问字段信息

Step 3: 确认信息

Step 4: 执行并返回结果

📌 API 参数格式

📌 字段取值逻辑

📌 字段来源确认表

❓ 询问提示模板

⚠️ 禁止行为

API 文档

环境说明

错误处理

状态枚举

上链状态值说明0上链失败1 上链成功 |

批次状态值说明NEW新建ASSIGNED 已分配 |

任务状态值说明NEW新建RUNNING 执行中 |

shuzhi-open

配置

用法

区块链API服务

数据上链

带可选参数上链

批量查询上链结果

查询多个交易

自动化取证

创建取证任务（命令行）

📋 自动化取证流程（交互式）

Step 1: 询问取证类型

Step 2: 询问取证信息

Step 3: 确认信息

上链状态
值说明
0 上链失败
1
上链成功 |

批次状态
值说明
NEW 新建
ASSIGNED
已分配 |

任务状态
值说明
NEW 新建
RUNNING
执行中 |