Abacus（算盘）

本地 Excel 自动化框架，以中国算学文化为命名体系。

项目状态

指标	数值
核心能力	84 个
测试用例	437 个（全部通过，7 跳过）
MCP 工具	88 个
CLI 命令	66 个
知识库文件	29 个
测试覆盖率	81%

特性

• 84 个通用 Excel 操作能力
• 九章分类（方田、粟米、衰分、少广、商功、均输、盈不足、方程、勾股）
• CLI + MCP Server + Python 库三种使用方式
• SKILL.md 文档驱动的 Skill 引擎
• 支持 .xlsx、.xls、.csv 格式
• CodeGraph 代码知识图谱
• SkillIndexer 知识库索引器

安装

pip install abacus

快速开始

CLI 使用

# 查看帮助
abacus --help

# 读取数据
abacus read -f data.xlsx -s Sheet1 -r A1:D10

# 查看结构
abacus structure -f data.xlsx

# 列出所有能力
abacus capabilities

Python 库使用

from abacus.core import MeasureRangeCapability

cap = MeasureRangeCapability()
result = cap.execute(None, file="data.xlsx", sheet="Sheet1", range="A1:D10")
print(result)

MCP Server 使用

# 启动 MCP Server
python -m abacus.mcp_server

九章分类

章节	英文	能力数	说明
方田章	Field	12	数据读取、单元格操作、工作表管理
粟米章	Grain	7	格式转换、类型转换、单位转换、数据清洗、转置、分列
衰分章	Share	6	分组、分配、汇总、透视分析、透视向导、分类汇总
少广章	Dimension	3	反向计算、推导、计算
商功章	Work	29	批量操作、图表、透视表、表格、工作流、样式、批注、冻结、筛选、隐藏、分组、保护、缩放、打包
均输章	Transport	5	导入导出、迁移、合并、Markdown转换
盈不足章	Balance	7	数据验证、代码审计、文件审计、文件验证
方程章	Equation	7	公式创建、解方程、计算、公式生成、公式诊断、公式重算、自动求和
勾股章	Triangle	8	统计分析、趋势分析、相关性分析、数据分析、可视化、差异分析、高级分析

文档

• 快速开始
• 九章使用指南
• API 参考
• 项目规约

许可证

MIT License