Files

T

Shiny 3466e19d13 feat: 初始化shop-crm-agent项目，实现基础CLI与CRM操作能力

本提交初始化完整的shop-crm-agent项目：
1. 创建基础项目结构与配置文件（.gitignore、go.mod/go.sum）
2. 添加项目许可协议与文档（README.md、AGENTS.md、SKILL.md）
3. 实现核心CLI入口与命令框架
4. 封装Protobuf API客户端与完整的命令实现
5. 添加单元测试覆盖核心功能与边界情况
6. 提供构建脚本与版本管理能力

2026-08-01 01:36:37 +08:00

2.3 KiB

Raw Blame History

shop-crm-agent

shop-crm-agent 是通过正式 Protobuf HTTP API 操作 Shop CRM 项目和独立报价的受控命令行客户端。源码允许匿名读取，但使用业务 API 仍需要管理员签发的 CRM Agent 凭据。

环境要求

Git
Go 1.26 或更高版本
可访问目标 LightCore API 的网络环境
运行环境提供 LIGHTCORE_API_BASE_URL 和 LIGHTCORE_SHOP_CRM_AGENT_TOKEN

仓库在开发工作区中固定与 LightCore 同级。例如：

<workspace>/
├── LightCore/
└── shop-crm-agent/

普通构建不依赖 LightCore 仓库；只有修改 Protobuf 契约时才需要同级的 LightCore 源码。

首次安装

git clone https://code.zhecent.com/open/shop-crm-agent.git
cd shop-crm-agent
go run ./scripts/build.go
./bin/shop-crm-agent --version

Windows 构建产物为 bin/shop-crm-agent.exe。构建脚本执行测试后，只编译当前操作系统和 CPU 架构，不安装系统服务，也不修改全局 PATH。

运行业务命令前，由当前 Shell 或 Agent 的受控运行环境提供配置：

export LIGHTCORE_API_BASE_URL=https://api.example.com

LIGHTCORE_SHOP_CRM_AGENT_TOKEN 必须通过密码管理器、受控 Secret 注入或其他不会回显和记录明文的机制提供。不要在交互式命令中直接输入真实 Token，也不得把它写入仓库、Skill、.env、命令历史、普通日志或聊天内容。

更新

收到内部更新通知后，让 Agent 在仓库根目录执行：

git status --short
git pull --ff-only

确认拉取成功后，Agent 必须重新读取最新的 SKILL.md，再执行：

go run ./scripts/build.go
./bin/shop-crm-agent --version

如果工作区存在本地修改，必须先停止更新并确认修改来源，不得强制重置。只有重新构建和版本探针都通过后才可继续执行 CRM 操作。

开发验证

go test ./...
go build ./...
go run ./scripts/build.go

internal/api/shop_crm_agent.pb.go 是生成代码，不得手工编辑。协议源文件位于同级 LightCore 仓库，生成入口为：

(cd ../LightCore/backend && bash scripts/proto_gen_shop_crm_agent.sh)

许可

本仓库保留全部权利，仅授权 Zhecent 员工用于公司内部业务。详见 LICENSE。

2.3 KiB Raw Blame History

shop-crm-agent

环境要求

首次安装

更新

开发验证

许可

2.3 KiB

Raw Blame History