TTokenySpace
返回 Skills 列表

Can Bus Toolkit Free

轻量级数据溯源工具，使用时间戳、内容哈希和可读名称三元组为数据流打戳，实现本地验证与防篡改日志管理。

#中文
下载 ZIP 来源页面
0

安装到 Tokeny（自动）

下载 ZIP
安装"can-bus-toolkit-free"技能
技能信息：
- 名称: Can Bus Toolkit Free
- 标识: can-bus-toolkit-free
- 描述: 轻量级数据溯源工具，使用时间戳、内容哈希和可读名称三元组为数据流打戳，实现本地验证与防篡改日志管理。
- 版本: 1.0.0
下载地址：
https://www.tokeny.space/api/skills/can-bus-toolkit-free/download
继续

复制上方内容到 Tokeny 客户端并在会话中发送即可自动安装；也可直接 下载 ZIP并拖动到技能窗口安装。

SKILL.md

CAN总线工具包免费版

一款轻量级数据溯源协议工具，通过"时间-地址-命名"三列模型为数据流打戳，实现本地验证与防篡改审计。

概述

在Agent与多个工具、API、其他Agent交互的过程中，数据来源的可信度是一个被忽视的痛点。你信任一个文件是因为它在某个路径下，但路径可以被移动；你按文件名搜索数据，但文件名是别人起的；你依赖时间戳判断数据新旧，但时间戳是文件系统控制的。这些信任基础都不在你手中。

CAN协议用最简单的三列模型解决这个问题：每条数据记录三个信息——它发生的时间（WHEN）、它内容的哈希（WHERE）、你给它起的名字（WHAT）。这三列完全由你控制，append-only追加写入，任何篡改都会导致哈希不匹配。

免费版聚焦于本地日志与基础验证能力，适合个人开发者与独立Agent在本地环境中建立数据溯源机制。

核心能力

三列协议

列名含义数据类型作用
WHEN发生时间Unix毫秒时间戳线性可排序，由你的时钟控制
WHERE内容地址SHA-256哈希片段可验证，不依赖文件系统
WHAT可读名称任意非空字符串可搜索，由你命名

每条事件追加一行记录，这就是协议的全部。

输入: 用户提供三列协议所需的指令和必要参数。 处理: 解析三列协议的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回三列协议的响应数据,包含状态码、结果和日志。

本地追加日志

  • 日志采用append-only设计，只增不删不改
  • 任何对历史记录的修改都会导致哈希校验失败
  • 日志存储在本地文件，完全由你控制

输入: 用户提供本地追加日志所需的指令和必要参数。 处理: 解析本地追加日志的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回本地追加日志的响应数据,包含状态码、结果和日志。

内容哈希验证

  • 对数据内容计算SHA-256哈希
  • 哈希匹配即内容相同，与路径、文件名、来源无关
  • 支持哈希片段或完整哈希两种格式

输入: 用户提供内容哈希验证所需的指令和必要参数。 处理: 解析内容哈希验证的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回内容哈希验证的响应数据,包含状态码、结果和日志。

自评估模式

  • 无需网络即可完成三元组校验
  • 三列齐全且格式合法即为"CAN"，缺失任何一列即为"NOT"
  • NOT也是有效数据，记录缺失原因用于审计

输入: 用户提供自评估模式所需的指令和必要参数。 处理: 解析自评估模式的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回自评估模式的响应数据,包含状态码、结果和日志。

传输无关设计

  • 不绑定任何特定传输协议
  • 无论数据通过HTTP、文件、消息队列还是Agent间通信流转，打戳逻辑一致
  • 保护数据本身，而非保护管道

输入: 用户提供传输无关设计所需的指令和必要参数。 处理: 解析传输无关设计的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回传输无关设计的响应数据,包含状态码、结果和日志。 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：轻量级数据溯源协、议工具、通过时间戳、内容哈希与可读名、称三元组为数据流、支持本地验证与日、总线工具包免费版、是一款面向独立开、发者的数据溯源协、三列模型、为流经任意管道的、数据打上可验证的、内容哈希与人类可、解决数据来源不可、查找效率低、时间戳被他人控制、三大痛点、核心能力、天然防篡改、不依赖文件系统路等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：Agent数据来源验证

Agent从多个API获取数据后存储到本地。在存储时为每条数据打上CAN戳（时间、哈希、名称）。后续使用时重新计算哈希，与日志中的哈希比对，确认数据未被篡改。

场景二：自动化流程审计

自动化脚本处理多个步骤的数据流转。每个步骤的输入输出都打上CAN戳，形成完整的审计链条。事后可通过日志追溯任意一步的数据状态。

场景三：按内容查找历史版本

同一份数据经过多次修改，你需要找到某个特定版本。按内容哈希在日志中查找，命中即找到，无需遍历目录或依赖文件名。

不适用场景

以下场景CAN总线工具包免费版不适合处理：

  • 需要100%确定性的关键决策
  • 医疗诊断
  • 法律判决

触发条件

需要AI模型调用、智能对话、Agent编排、LLM应用时使用。不适用于非本工具能力范围的需求。

快速开始

预计上手时间：约60秒。

第一步：理解三列模型

输入格式

参数名类型必填说明
inputstring是CAN总线工具包免费版处理的输入数据或指令
optionsobject否附加配置选项,如模式选择、格式偏好等
callback_urlstring否异步处理完成后的回调通知URL
WHEN    1742428800000          （Unix毫秒时间戳）
WHERE   a7f3b2c1d4e5           （SHA-256哈希片段）
WHAT    客户名单-2024Q1        （你给的可读名称）

第二步：为数据打戳

# 计算内容哈希
echo -n "your-data-content" | sha256sum
# 输出: a7f3b2c1d4e5...
# ...
# 记录三列
echo "1742428800000 a7f3b2c1d4e5 客户名单-2024Q1" >> can.log

第三步：验证数据完整性

# 重新计算当前内容的哈希
current_hash=$(echo -n "your-data-content" | sha256sum | cut -c1-12)
# ...
# 在日志中查找
grep "$current_hash" can.log
# 命中即表示内容与打戳时一致

第四步：自评估三元组

检查一条记录是否具备完整的三列：

有Unix时间戳？        → WHEN ✓
有内容哈希？          → WHERE ✓
有可读名称？          → WHAT ✓
三列齐全？            → CAN
缺失任何一列？        → NOT

示例

日志文件格式

每行一条记录，三列以空格或制表符分隔：

# WHEN                WHERE           WHAT
1742428800000    a7f3b2c1d4e5    客户名单-2024Q1
1742428900000    b8e4c3d2e5f6    订单数据-2024Q1
1742429000000    c9f5d4e3f6a7    产品目录-2024Q1

验证规则

列合法值非法值
WHENUnix毫秒，非未来时间，非零未来时间、零、负数
WHERE十六进制字符串（哈希片段或完整SHA-256）非十六进制字符、空字符串
WHAT任意非空字符串空字符串

哈希计算示例

# 文件内容哈希
sha256sum data.json
# ...
# 字符串哈希
echo -n "content" | sha256sum
# ...
# 哈希片段（取前12位）
echo -n "content" | sha256sum | cut -c1-12

最佳实践

日志管理建议

  • 日志文件设置只读权限，防止意外修改
  • 定期归档历史日志，避免单文件过大
  • 日志文件加入版本控制，便于追溯变更

哈希使用建议

  • 哈希片段取12位即可满足日常查找需求，冲突概率极低
  • 对完整文件计算哈希时，确保使用二进制模式避免换行符差异
  • 敏感数据可先脱敏再哈希，避免哈希泄露信息

命名规范建议

  • WHAT列采用"类型-时间-版本"结构化命名，便于检索
  • 避免在名称中使用空格，用连字符或下划线替代
  • 为同类数据建立命名约定，提升日志可读性

验证策略建议

  • 关键数据每次使用前都应验证哈希
  • NOT记录也应保留，记录缺失原因有助于审计
  • 定期全量校验日志中所有条目的哈希一致性

常见问题

Q1：哈希片段会冲突吗？

12位十六进制哈希片段有约2^48种可能，日常使用规模下冲突概率可忽略。若数据量超过百万级，建议使用完整SHA-256。

Q2：NOT记录有什么用？

NOT表示某条记录缺失了一列或多列。保留NOT记录比只记录成功更诚实——审计时能看出哪些数据打戳不完整，便于追溯问题。

Q3：日志被篡改了怎么办？

日志采用append-only设计。若被篡改，重新计算所有条目的哈希，与日志中的WHERE列比对，不匹配的即为被篡改的条目。建议日志文件设置只读权限并纳入版本控制。

Q4：能否与外部时间戳服务集成？

免费版仅支持本地时钟。如需与OTS（OpenTimestamps）等外部时间戳服务同步，提升时间戳的可信度，请使用专业版。

Q5：如何处理大规模数据的哈希计算？

对大文件使用流式哈希计算，避免一次性读入内存。sha256sum命令本身支持流式处理，直接对文件路径执行即可。

已知限制

本免费体验版限制以下高级功能：

  • 仅支持本地时钟，无外部时间戳服务同步
  • 无并行索引与批量验证能力
  • 无篡改检测告警与自动修复
  • 无多传输协议适配器（仅支持文件与命令行）
  • 无审计报表导出与可视化

解锁全部功能请使用专业版：can-bus-toolkit-pro

  • 当前为免费版本,如需完整功能请升级到付费版获取全部能力

依赖说明

运行环境

  • Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
  • 操作系统: Windows / macOS / Linux
  • Shell: 支持标准Unix命令（sha256sum、echo、grep）
  • 网络: 无需网络，完全本地运行

依赖详情

依赖项类型是否必需获取方式
sha256sum系统命令必需大部分操作系统内置
LLM APIAPI必需由Agent内置LLM提供

本工具零外部依赖，仅使用操作系统内置命令。

API Key 配置

  • 本工具完全本地运行，无需任何API Key
  • 无需网络访问，无外部服务调用

可用性分类

  • 分类: MD+EXEC（纯Markdown指令，部分功能需要exec命令行执行能力）
  • 说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent完成操作

错误处理

错误场景原因处理方式
配置错误参数缺失或格式错误检查依赖说明中的配置要求
运行时错误运行环境不满足确认运行环境符合依赖说明
网络错误连接超时或不可达执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

输出格式

{
  "success": true,
  "data": {
    "result": "CAN总线工具包免费版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "can buskit"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}

评论

加载中…