@samp3ng/aster-plugin-opc-cloud 0.1.0

package/README.md

@@ -0,0 +1,77 @@
+# @samp3ng/aster-plugin-opc-cloud
+
+Aster 访问 OPC 在线平台的工具插件。
+
+配置示例:
+
+```yaml
+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` 后缀)。

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import { StellarPlugin, PluginContext, ToolDefinition } from '@samp3ng/aster-core';
+
+declare class OpcCloudPlugin implements StellarPlugin {
+    readonly name = "opc-cloud";
+    readonly version = "0.1.0";
+    readonly description = "\u661F\u73AF OPC \u4F9B\u9700\u805A\u5408\u63D2\u4EF6(\u5165\u9A7B\u3001\u4E0A\u67B6\u3001\u627E\u5355\u3001\u53D1\u5355\u3001\u63A5\u5355\u3001\u79C1\u804A\u548C\u8BA2\u5355\u56DE\u6D41)";
+    private client;
+    private opcDbPath;
+    initialize(ctx: PluginContext): Promise<void>;
+    getTools(): ToolDefinition[];
+    getSystemPromptBlock(): string;
+}
+declare const plugin: OpcCloudPlugin;
+
+export { OpcCloudPlugin, plugin as default };