guands

观远 BI 数据源/数据集管理工具，支持连接账号管理、数据集创建/配置/刷新、增量设置、定时更新、目录管理。

本地安装（开发/测试阶段）

# 编译所有平台 binary（需要 Go 工具链）
npm run build

# 安装到本地 node global
npm link

安装后即可在终端使用：

guands account list
guands dataset list
guands dataset create-db --ac-id <acId> --tables "t1,t2"
guands dataset refresh <dsId> --wait
guands dataset schedule <dsId> --cron-type daily --hour 2 --minute 0
guands task status <taskId>

说明：npm 包名为 @guandata/guands，用户侧 CLI 命令统一为 guands。

也可以为 AI Coding Assistant 安装 Skill：

guands install-skill

版本更新

@guandata/guands 0.1.21

• 数据集导入默认等待任务完成并返回真实结果，同时会提前识别扩展名与内容不一致的文件，减少异步失败和乱码数据集。
• Excel 导入、追加和替换数据支持明确选择 Sheet；单 Sheet 自动选择，多 Sheet 必须指定一个，避免隐式合并造成数据错误。
• 新增独立的数据集主键设置与清空能力，修改后会等待数据重写任务完成并回读验证。

@guandata/guands 0.1.20

• 数据连接账号支持安全原地改名，保留账号 ID、凭证、权限和已有数据集引用，并在更新后自动回读确认。
• 数据集刷新会识别和跟随已有更新任务，避免重复提交；等待、覆盖刷新和任务失败后的最终状态判断更准确。
• 增强资源 ID 校验和创建结果解析，写操作输出契约更清晰，便于 Agent 稳定获取新建资源并继续后续操作。

@guandata/guands 0.1.19

• 数据集支持追加数据和按条件/全量清理数据，便于维护 CSV/Excel 导入类数据集。
• 新增数据集 schema 同步、自动同步结构开关和字段更新预校验，减少源表结构变化后的手工处理成本。
• 支持批量新增计算字段，并增强分组字段、字段展示名和字段来源识别能力。
• 支持从填报表单创建数据集，并可查看数据集行列权限配置。
• 增强数据集目录校验、依赖提示、任务历史和抽数结果诊断，提升批量建集、刷新和排障体验。

@guandata/guands 0.1.18

• dataset import 支持按列指定字段类型，导入 CSV/Excel 时可更准确地控制字段解析结果。
• dataset replace-data 增加 --encoding 和 --delimiter，替换数据时可处理更多文件编码和分隔符格式。
• 导入参数校验会忽略未导入列的类型提示，减少按列配置时的误报。

@guandata/guands 0.1.17

• install-skill 适配 WorkBuddy 配置目录，提升本机编码助手安装兼容性。

@guandata/guands 0.1.16

• dataset list 统一使用目录搜索接口，提升目录筛选和列表结果的一致性。

@guandata/guands 0.1.15

• 新增 dataset update-fields，支持批量更新数据集字段展示名和注释，可通过命令行参数或 JSON 文件提交，并支持 --dry-run 预览请求体。
• dataset import 增加 --header-row、--encoding、--delimiter，并在导入前识别单列解析异常，降低 CSV/Excel 导入参数误配风险。
• 修复 replace-data 处理 UTF-8 BOM 表头时的 schema 校验误判；account columns 默认使用账号配置中的 schema/database。
• 修复 dataset batch-move、save-as 等数据集请求参数，并为 refresh 增加 --overwrite 全量覆盖模式。

@guandata/guands 0.1.14

• dataset alias 支持更新数据集字段展示名，便于为新版 ETL 输入列名做准备和验证。

@guandata/guands 0.1.13

• install-skill 增加 WorkBuddy skill 安装路径支持。

0.1.12

• 优化试用账号场景下的运行上下文识别，提升命令执行记录与问题排查的一致性。
• 重新构建发布产物，纳入共享运行上下文处理更新。

卸载

npm unlink -g @guandata/guands

支持平台

• macOS (Apple Silicon / Intel)
• Windows (x64)

开发

# 编译所有平台 binary（需要 Go 工具链）
npm run build

# 发布到内部 Nexus npm 仓库
npm publish