群脉MAI・全渠道用户运营

通过 CLI + Skills，为 WorkBuddy 专家、专家团和业务技能提供群脉MAI 数据取证、分析、会员分群预览、标准语义与运营建议能力。

代码按 规格快照 实现，action 映射和完成门见 交付说明，凭据和工作区机制见 架构。业务实现与标准目录来源分别记录在 SOURCES。

当前状态

本版为 0.3.4，统一知识查询为 knowledge.query，支持可选保存证据快照，并更新知识库与运营话术指引。正式发布与安装结果见 docs/delivery.md。0.3.2 新增未登录设备授权经官网注册页点击登录后继续授权的兼容链路；已在 staging 完成注册页登录、本人授权、CLI 领取与恢复/撤销验收；官网与网关链路已于 2026-10-26 部署 production 并完成入口检查。0.3.2 曾于 2026-10-26 发布 npm，production 新注册入口的完整租户授权生命周期仍需独立验收。已提交的 0.3.1 审核包保持不变。

本包提供 RFC 8628 设备码登录、远端 Token 撤销、Windows 凭据 DACL 和「群脉MAI」品牌。默认连接 production，包含连接器、三个专家、专家团和业务技能资产。

发布目标为 npmjs.com 的正式 latest 标签。精确版本的公开可用性以 registry 和 npm run verify:publication 的实时结果为准。npm 发布与 WorkBuddy 官方市场上架分别验收。

安装时必须同时指定普通 registry 和 scoped registry：

npm install -g @maiscrm/[email protected] \
  --registry=https://registry.npmjs.org/ \
  --@maiscrm:registry=https://registry.npmjs.org/

本机用户级 .npmrc 可能把 @maiscrm 指向内部 Nexus；只传 --registry 不能覆盖该 scoped 配置。发布核验使用 npm run verify:publication，它直接请求 npmjs metadata。

0.3.2 默认使用 RFC 8628 设备码登录，浏览器无需回调 CLI 本机；WorkBuddy 显示验证码与验证链接。授权服务已部署 production；Windows 5.8.3 的 staging 登录、重启恢复和真实撤销通过，production 已由用户本人授权并通过重启恢复与只读调用。macOS 原生、云任务和正式市场上架仍待验收。 具体交付与限制见 CLI 接入。真实登录、跨平台安装、客户端调度与云任务验收不能由本地测试替代。

本地开发

开发与验收边界为原生 WSL2 linux/amd64，仓库位于 Linux 文件系统，Node.js >=22。

npm ci
npm run check
npm test
npm run acceptance:pack

check 构建业务模块和 12 个主资产 ZIP（连接器、三专家、可选专家团和七技能）、8 个 Web 技能 ZIP 及 4 个 5.7.7 兼容包，执行类型与配置检查；test 同时运行 Node CLI/资产测试与 Vitest 业务测试。 acceptance:pack 在干净目录安装自身 tarball 和声明依赖，验证 CLI 帮助与无 Token 标准目录。 运行包、资产包及脱敏检查结果位于 dist/packages/、dist/assets/、dist/pack-acceptance.json。

CLI 与授权

maiscrm-workbuddy auth login
maiscrm-workbuddy auth status
maiscrm-workbuddy context inspect
maiscrm-workbuddy data metadata.list --json '{"limit":20}'
maiscrm-workbuddy schema catalog --json '{"limit":5}'
maiscrm-workbuddy data --help

凭据仅来自 Portal 链接授权后保存的私有文件或管理员用于开发验证的环境配置。 不通过业务参数、对话或 Skill 传入 Token。0.3.2 断开撤销当前 Token 并清理本地凭据；失败保留私有撤销记录供再次 logout 重试，不删除 Portal 应用。

能力边界

纯业务 API 无需工作区。CLI 管理的产物通过调用级 --workspace-dir 接入已核实的任务目录，可选稳定 --workspace-id；旧专用目录配置继续兼容。CLI cwd 或模型自报任务身份不能代替目录与权限检查；跨任务共享及原生展示仍需实际客户端证据。 WorkBuddy 没有项目工作区时也可用已有数据或在线查询生成自包含 HTML、分群预览、方案与评审报告。 有文件/附件工具时交付文件，没有时交付完整内容；普通任务不强制先登录、选择目录或配置 CLI 工作区。 四类条件和跨成员交接见任务运行方式。普通文件不代表 CLI 保存、提交或远端执行成功。 localArtifactRead 表示授权目录的只读文件服务可用，不表示领域 analysis.view、label.view 或建议回读免租户认证。 标准目录业务模块不要求租户 Token；WorkBuddy CLI 连接器的实际登录和调用须实测。 获授权工作区在远端创建查询前保存实际 SQL、输入摘要和来源；查询完成与业务产物提交分别报告。取消或重启后仅恢复同源已有查询状态，不重新提交；无状态模式仅返回安全运行身份并明确恢复限制。容量与恢复预算见架构。 标签保存/同步/停用、托管方案提交/批准/恢复和 Dashboard 发布已有当前对话动作入口；宿主助手取得明确指令，CLI 检查连接、对象修订和状态，详见对话业务操作。调用声明不代表独立的用户身份凭证。 业务目录包含既有 125 项企微 action 和新增 128 项客户、会员、券、商品订单、营销渠道、社群及物码 action。目录收录、固定合同与真实环境可用分别核验，未接通项保留不可用原因。 新增企微业务命令由 data-outreach 执行已确认触达，data-operation 负责运营策略；后端部署、权限和真实送达需分别验证，见企微业务命令。 单次朋友圈/消息、批量清单预检、素材、任务结果、定时业务指令和运营看板的 Skill/专家入口见企微运营流程导航。 预览、草稿、待评审和远端执行分别报告，独立评审 PASS 不表示业务批准或执行。

官方文档与模板差异见 能力调查。业务说明在包内 Skills，协作规则在 SOP，运行不读取相邻仓库。