@samp3ng/aster-plugin-opc-cloud

Aster 访问 OPC 在线平台的工具插件。

配置示例:

plugins:
  installed:
    - name: opc-cloud
      packageName: '@samp3ng/aster-plugin-opc-cloud'
      enabled: true
      config:
        baseUrl: http://127.0.0.1:8787/api

定位:

@samp3ng/aster-plugin-opc-cloud 是 Aster 的星环 OPC 供需聚合插件。用户主要通过本地 Aster 自然语言完成入驻、上架、找单、发单、接单、私聊和订单回流;Web 平台只是同一套供需数据的可视化入口。

优先使用的工作流工具:

• opc_platform_onboard:一键入驻,读取本地 OPC 公司资料,生成注册账户 + 上架服务商主页计划。
• opc_platform_find_work:根据本地 OPC 技能在需求大厅推荐适合接的单。
• opc_platform_apply_to_work:围绕某个需求生成接单申请文案并投递。

底层工具:

• opc_platform_register_account
• opc_platform_stats
• opc_platform_admin_overview
• opc_platform_admin_users
• opc_platform_list_policies
• opc_platform_publish
• opc_platform_update_supplier
• opc_platform_search_supplier
• opc_platform_get_supplier
• opc_platform_post_demand
• opc_platform_search_demand
• opc_platform_get_demand
• opc_platform_start_demand_chat
• opc_platform_apply
• opc_platform_list_applications
• opc_platform_review_application
• opc_platform_update_demand_status
• opc_platform_list_orders
• opc_platform_update_order_status
• opc_platform_list_conversations
• opc_platform_list_messages
• opc_platform_send_chat_message
• opc_platform_pull_orders

高影响动作默认 dry-run,需要 confirm:true 才真执行。

凭据 / Token 怎么来

@samp3ng/aster-plugin-opc-cloud 的 config.token 是你这个用户的 session token, 不是平台 admin token。两者关系:

• admin token(OPC_PLATFORM_ADMIN_TOKEN):部署 opc-platform 的人持有,用于 /api/admin/* 接口(列用户 / 改角色 / 查审计)。普通用户拿不到也用不上。
• session token:平台运营运行 services/opc-platform/scripts/seed-tenant.mjs 时,为你创建账号 + 颁发的 UUID,plugin 用它调 /api/auth/me 等业务接口。
• 平台方按 services/opc-platform/DEPLOY.md §6 轮换 admin token 时,你的 session token 不受影响,不需要改本地 config。
• 反之,如果你的 session token 自己泄露了(误贴到群 / 截图),联系平台运营 让他 node scripts/admin-cli.mjs users set-role <你的id> user 然后重新跑 seed-tenant.mjs 给你换一个 token。

凭据文件落盘位置(由 seed-tenant.mjs 生成):

~/.stellar/plugin-opc-cloud-credentials-<slug>.txt   # 0600

文件里写的是 OPC_PLATFORM_URL= 和 OPC_PLATFORM_TOKEN= 两行,可以原样塞进 config.token / config.baseUrl(注意 baseUrl 要带 /api 后缀)。