From c61897009f6afc4a3544107a330973d352d8d8e8 Mon Sep 17 00:00:00 2001 From: yumoqing Date: Thu, 10 Sep 2026 12:00:00 +0800 Subject: [PATCH] =?UTF-8?q?docs(skills):=20pipeline-app-module=E4=B8=8Epla?= =?UTF-8?q?tform-architecture=E5=88=A0pipeline=5Fdist=E7=AB=A0=E8=8A=82?= =?UTF-8?q?=E2=80=94=E2=80=94=E6=A8=A1=E5=9D=97=E5=B7=B2=E5=88=A0=E9=99=A4?= =?UTF-8?q?,=E5=88=86=E9=94=80=E5=8A=9F=E8=83=BD=E7=BB=9F=E4=B8=80?= =?UTF-8?q?=E7=94=B1supplychain=E6=89=BF=E8=BD=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../all/pipeline-app-module/SKILL.md | 26 ++++++------------- .../common/platform-architecture/SKILL.md | 2 +- 2 files changed, 9 insertions(+), 19 deletions(-) diff --git a/skills_library/all/pipeline-app-module/SKILL.md b/skills_library/all/pipeline-app-module/SKILL.md index d325b82..f06c5dd 100644 --- a/skills_library/all/pipeline-app-module/SKILL.md +++ b/skills_library/all/pipeline-app-module/SKILL.md @@ -1,13 +1,13 @@ --- name: pipeline-app-module version: 2.0.0 -description: "产线生态系统 — 通用执行引擎、产线定义/运营/分销/交互的完整开发规范和部署指南。" +description: "产线生态系统 — 通用执行引擎、产线定义/运营/交互的完整开发规范和部署指南。" trigger_conditions: - 用户要求开发或修改产线功能 - - 涉及 pipeline_core/pipeline_ops/pipeline_dist/pipeline_service/pipeline_task 模块 - - 需要添加新的产线类型、步骤处理器或分销功能 + - 涉及 pipeline_core/pipeline_ops/pipeline_service/pipeline_task 模块 + - 需要添加新的产线类型或步骤处理器 - 讨论产线架构设计（Hermes验证→固化→独立运行） -tags: [pipeline, module, independent-app, distribution, execution-engine] +tags: [pipeline, module, independent-app, execution-engine] --- # Pipeline 产线生态系统 @@ -57,11 +57,8 @@ tags: [pipeline, module, independent-app, distribution, execution-engine] | pipeline_capacity | 供应量（pipeline_id, quota_type, quota_value, concurrent_limit） | | pipeline_usage_log | 使用记录（pipeline_id, user_id, step_id, usage_count, cost） | -### pipeline_dist（分销管理 — 分销商） -| 表 | 说明 | -|----|------| -| distributors | 分销商（name, api_key, status, quota, org_id） | -| distributor_pipeline | 分销-产线关联（distributor_id, pipeline_id, custom_price, enabled） | +> 注：原 pipeline_dist（分销管理）模块已于 2026-09-10 删除，功能与 supplychain 重复， +> 分销商/分销协议/分销折扣统一由 supplychain 模块承载。 ### pipeline_service（执行引擎 — 核心） 通用产线执行引擎，不知道自己在跑 KTV 还是找飞机还是写小说。 @@ -127,13 +124,11 @@ UI: index.ui（内嵌 Tabular 任务列表 + 搜索筛选） / task_list.ui / ta ```python from pipeline_core.init import load_pipeline_core from pipeline_ops.init import load_pipeline_ops -from pipeline_dist.init import load_pipeline_dist from pipeline_service.init import load_pipeline_service from pipeline_task.init import load_pipeline_task load_pipeline_core() load_pipeline_ops() -load_pipeline_dist() load_pipeline_service() load_pipeline_task() ``` @@ -244,7 +239,7 @@ mysqldump -u hermes -phermes123 --no-data sage users role permission rolepermiss mysql -u hermes -phermes123 pipeline < rbac_ddl.sql # 业务表（各模块 DDL） -for mod in pipeline_core pipeline_ops pipeline_dist pipeline-service; do +for mod in pipeline_core pipeline_ops pipeline-service; do mysql -u hermes -phermes123 pipeline < $mod/mysql.ddl.sql done ``` @@ -280,7 +275,6 @@ ln -sf "$cdir/pkgs/bricks/dist" "$cdir/wwwroot/bricks" # build.sh 第44行就 # 模块 wwwroot 符号链接（仅服务静态文件，不影响 Python 导入） ln -sf pipeline_core_repo/wwwroot wwwroot/pipeline_core ln -sf pipeline_ops_repo/wwwroot wwwroot/pipeline_ops -ln -sf pipeline_dist_repo/wwwroot wwwroot/pipeline_dist ln -sf ~/repos/pipeline-task/wwwroot wwwroot/pipeline_task # ⚠️ Python 包必须放在 app 目录内才能 import！ @@ -355,7 +349,6 @@ curl -s -o /dev/null -w "%{http_code}" -u admin:admin123 https://pipeline.openco 详细修复示例见 `references/serverenv-vs-run_ns.md`。 - **pipeline_service 仓库不存在**：`pipeline_service` 无公开仓库。`pipeline_app.py` 和 `ktv_adapter.py` 的导入必须用 `try/except ImportError` 包裹，优雅降级。 - **部署到 tokentest 不能用 `pipeline` 数据库**：`test` 用户无 CREATE DATABASE 权限，直接用 `sage` 库。详见 `references/tokentest-deployment.md`。 -- **分销密钥生成**：distributor_generate_key.dspy 使用 secrets.token_hex(32) - **步骤处理器可插拔**：register_handler(step_type, fn)，不同产线注册不同 handler - **多租户隔离**：tenant_id 贯穿 pipeline_tasks 所有查询 - **交互层极简**：pipeline_task 零数据表，JS 只写必要辅助函数，不写大段逻辑 @@ -603,7 +596,7 @@ VBox (height:100%, padding:0) 三层导航层次，统一交互，不混用： -1. **系统菜单 → TabPanel**：侧边栏 Menu 的系统菜单项（产线管理/开发产线/运营/分销/任务中心/审计日志/远程空间等），点击用 `this.open_tab({name,label,url,removable:true})` 在 `app.main_content`（TabPanel）打开为可切换标签页。参考 `index.ui` 侧边栏 `sidebar_menu` 的 script 写法。 +1. **系统菜单 → TabPanel**：侧边栏 Menu 的系统菜单项（产线管理/开发产线/运营/任务中心/审计日志/远程空间等），点击用 `this.open_tab({name,label,url,removable:true})` 在 `app.main_content`（TabPanel）打开为可切换标签页。参考 `index.ui` 侧边栏 `sidebar_menu` 的 script 写法。 2. **用户菜单 → 弹窗**：Header 右上角 👤 用户菜单（`userinfo.ui` 点击 `target:"Popup"` + `popup_options`），弹窗加载 `user_menu.ui`，**不进 TabPanel**。 3. **TabPanel 内容中的点击 → 弹窗**：TabPanel 打开的模块页面内，点击按钮/链接一律弹窗（PopupWindow / Popup），**不在 TabPanel 内再嵌套 tab，也不整页跳转**破坏 tab 结构。 @@ -895,17 +888,14 @@ cd ~/test/pipeline-app/pkgs/bricks/bricks && bash build.sh ├── wwwroot/ # 统一 wwwroot │ ├── pipeline_core → ../pipeline_core_repo/wwwroot │ ├── pipeline_ops → ../pipeline_ops_repo/wwwroot -│ ├── pipeline_dist → ../pipeline_dist_repo/wwwroot │ ├── pipeline_task → ~/repos/pipeline-task/wwwroot │ └── bricks → ../bricks ├── pipeline_core → pipeline_core_repo/pipeline_core/ # Python 包 ├── pipeline_ops → pipeline_ops_repo/pipeline_ops/ -├── pipeline_dist → pipeline_dist_repo/pipeline_dist/ ├── pipeline-service → ~/repos/pipeline-service # 符号链接到 repos ├── pipeline-task → ~/repos/pipeline-task ├── pipeline_core_repo/ # 完整仓库（含 wwwroot, models, json） ├── pipeline_ops_repo/ -├── pipeline_dist_repo/ ├── init_data.py # 初始化脚本 ├── build.sh ├── start.sh diff --git a/skills_library/pipelines/platform_general/common/platform-architecture/SKILL.md b/skills_library/pipelines/platform_general/common/platform-architecture/SKILL.md index 6ec75ba..7f65bc6 100644 --- a/skills_library/pipelines/platform_general/common/platform-architecture/SKILL.md +++ b/skills_library/pipelines/platform_general/common/platform-architecture/SKILL.md @@ -16,7 +16,7 @@ capability: platform_knowledge | pipeline-bidding | pipeline_bidding | 投标产线（解析→QC→章节→合成→评分） | | pipeline-opportunity | pipeline_opportunity | 商机产线 | | pipeline-sdlc | pipeline_sdlc | 开发产线前端（项目/迭代/任务/交付件页面） | -| pipeline-ops / pipeline-dist / pipeline-task | — | 运维/分销/任务中心 | +| pipeline-ops / pipeline-task | — | 运维/任务中心 | | pipeline-app | — | 宿主应用：主菜单/菜单权限/构建脚本 | ## 关键约定