docs(skills): pipeline-app-module与platform-architecture删pipeline_dist章节——模块已删除,分销功能统一由supplychain承载

This commit is contained in:
yumoqing 2026-09-10 12:00:00 +08:00
parent 5a6785c743
commit c61897009f
2 changed files with 9 additions and 19 deletions

View File

@ -1,13 +1,13 @@
--- ---
name: pipeline-app-module name: pipeline-app-module
version: 2.0.0 version: 2.0.0
description: "产线生态系统 — 通用执行引擎、产线定义/运营/分销/交互的完整开发规范和部署指南。" description: "产线生态系统 — 通用执行引擎、产线定义/运营/交互的完整开发规范和部署指南。"
trigger_conditions: trigger_conditions:
- 用户要求开发或修改产线功能 - 用户要求开发或修改产线功能
- 涉及 pipeline_core/pipeline_ops/pipeline_dist/pipeline_service/pipeline_task 模块 - 涉及 pipeline_core/pipeline_ops/pipeline_service/pipeline_task 模块
- 需要添加新的产线类型、步骤处理器或分销功能 - 需要添加新的产线类型或步骤处理器
- 讨论产线架构设计(Hermes验证→固化→独立运行) - 讨论产线架构设计(Hermes验证→固化→独立运行)
tags: [pipeline, module, independent-app, distribution, execution-engine] tags: [pipeline, module, independent-app, execution-engine]
--- ---
# Pipeline 产线生态系统 # Pipeline 产线生态系统
@ -57,11 +57,8 @@ tags: [pipeline, module, independent-app, distribution, execution-engine]
| pipeline_capacity | 供应量(pipeline_id, quota_type, quota_value, concurrent_limit) | | pipeline_capacity | 供应量(pipeline_id, quota_type, quota_value, concurrent_limit) |
| pipeline_usage_log | 使用记录(pipeline_id, user_id, step_id, usage_count, cost) | | pipeline_usage_log | 使用记录(pipeline_id, user_id, step_id, usage_count, cost) |
### pipeline_dist(分销管理 — 分销商) > 注:原 pipeline_dist(分销管理)模块已于 2026-09-10 删除,功能与 supplychain 重复,
| 表 | 说明 | > 分销商/分销协议/分销折扣统一由 supplychain 模块承载。
|----|------|
| distributors | 分销商(name, api_key, status, quota, org_id) |
| distributor_pipeline | 分销-产线关联(distributor_id, pipeline_id, custom_price, enabled) |
### pipeline_service(执行引擎 — 核心) ### pipeline_service(执行引擎 — 核心)
通用产线执行引擎,不知道自己在跑 KTV 还是找飞机还是写小说。 通用产线执行引擎,不知道自己在跑 KTV 还是找飞机还是写小说。
@ -127,13 +124,11 @@ UI: index.ui(内嵌 Tabular 任务列表 + 搜索筛选) / task_list.ui / ta
```python ```python
from pipeline_core.init import load_pipeline_core from pipeline_core.init import load_pipeline_core
from pipeline_ops.init import load_pipeline_ops 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_service.init import load_pipeline_service
from pipeline_task.init import load_pipeline_task from pipeline_task.init import load_pipeline_task
load_pipeline_core() load_pipeline_core()
load_pipeline_ops() load_pipeline_ops()
load_pipeline_dist()
load_pipeline_service() load_pipeline_service()
load_pipeline_task() 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 mysql -u hermes -phermes123 pipeline < rbac_ddl.sql
# 业务表(各模块 DDL) # 业务表(各模块 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 mysql -u hermes -phermes123 pipeline < $mod/mysql.ddl.sql
done done
``` ```
@ -280,7 +275,6 @@ ln -sf "$cdir/pkgs/bricks/dist" "$cdir/wwwroot/bricks" # build.sh 第44行就
# 模块 wwwroot 符号链接(仅服务静态文件,不影响 Python 导入) # 模块 wwwroot 符号链接(仅服务静态文件,不影响 Python 导入)
ln -sf pipeline_core_repo/wwwroot wwwroot/pipeline_core ln -sf pipeline_core_repo/wwwroot wwwroot/pipeline_core
ln -sf pipeline_ops_repo/wwwroot wwwroot/pipeline_ops 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 ln -sf ~/repos/pipeline-task/wwwroot wwwroot/pipeline_task
# ⚠️ Python 包必须放在 app 目录内才能 import! # ⚠️ 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`。 详细修复示例见 `references/serverenv-vs-run_ns.md`。
- **pipeline_service 仓库不存在**:`pipeline_service` 无公开仓库。`pipeline_app.py` 和 `ktv_adapter.py` 的导入必须用 `try/except ImportError` 包裹,优雅降级。 - **pipeline_service 仓库不存在**:`pipeline_service` 无公开仓库。`pipeline_app.py` 和 `ktv_adapter.py` 的导入必须用 `try/except ImportError` 包裹,优雅降级。
- **部署到 tokentest 不能用 `pipeline` 数据库**:`test` 用户无 CREATE DATABASE 权限,直接用 `sage` 库。详见 `references/tokentest-deployment.md`。 - **部署到 tokentest 不能用 `pipeline` 数据库**:`test` 用户无 CREATE DATABASE 权限,直接用 `sage` 库。详见 `references/tokentest-deployment.md`。
- **分销密钥生成**:distributor_generate_key.dspy 使用 secrets.token_hex(32)
- **步骤处理器可插拔**:register_handler(step_type, fn),不同产线注册不同 handler - **步骤处理器可插拔**:register_handler(step_type, fn),不同产线注册不同 handler
- **多租户隔离**:tenant_id 贯穿 pipeline_tasks 所有查询 - **多租户隔离**:tenant_id 贯穿 pipeline_tasks 所有查询
- **交互层极简**:pipeline_task 零数据表,JS 只写必要辅助函数,不写大段逻辑 - **交互层极简**: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**。 2. **用户菜单 → 弹窗**:Header 右上角 👤 用户菜单(`userinfo.ui` 点击 `target:"Popup"` + `popup_options`),弹窗加载 `user_menu.ui`,**不进 TabPanel**。
3. **TabPanel 内容中的点击 → 弹窗**:TabPanel 打开的模块页面内,点击按钮/链接一律弹窗(PopupWindow / Popup),**不在 TabPanel 内再嵌套 tab,也不整页跳转**破坏 tab 结构。 3. **TabPanel 内容中的点击 → 弹窗**:TabPanel 打开的模块页面内,点击按钮/链接一律弹窗(PopupWindow / Popup),**不在 TabPanel 内再嵌套 tab,也不整页跳转**破坏 tab 结构。
@ -895,17 +888,14 @@ cd ~/test/pipeline-app/pkgs/bricks/bricks && bash build.sh
├── wwwroot/ # 统一 wwwroot ├── wwwroot/ # 统一 wwwroot
│ ├── pipeline_core → ../pipeline_core_repo/wwwroot │ ├── pipeline_core → ../pipeline_core_repo/wwwroot
│ ├── pipeline_ops → ../pipeline_ops_repo/wwwroot │ ├── pipeline_ops → ../pipeline_ops_repo/wwwroot
│ ├── pipeline_dist → ../pipeline_dist_repo/wwwroot
│ ├── pipeline_task → ~/repos/pipeline-task/wwwroot │ ├── pipeline_task → ~/repos/pipeline-task/wwwroot
│ └── bricks → ../bricks │ └── bricks → ../bricks
├── pipeline_core → pipeline_core_repo/pipeline_core/ # Python 包 ├── pipeline_core → pipeline_core_repo/pipeline_core/ # Python 包
├── pipeline_ops → pipeline_ops_repo/pipeline_ops/ ├── pipeline_ops → pipeline_ops_repo/pipeline_ops/
├── pipeline_dist → pipeline_dist_repo/pipeline_dist/
├── pipeline-service → ~/repos/pipeline-service # 符号链接到 repos ├── pipeline-service → ~/repos/pipeline-service # 符号链接到 repos
├── pipeline-task → ~/repos/pipeline-task ├── pipeline-task → ~/repos/pipeline-task
├── pipeline_core_repo/ # 完整仓库(含 wwwroot, models, json) ├── pipeline_core_repo/ # 完整仓库(含 wwwroot, models, json)
├── pipeline_ops_repo/ ├── pipeline_ops_repo/
├── pipeline_dist_repo/
├── init_data.py # 初始化脚本 ├── init_data.py # 初始化脚本
├── build.sh ├── build.sh
├── start.sh ├── start.sh

View File

@ -16,7 +16,7 @@ capability: platform_knowledge
| pipeline-bidding | pipeline_bidding | 投标产线(解析→QC→章节→合成→评分) | | pipeline-bidding | pipeline_bidding | 投标产线(解析→QC→章节→合成→评分) |
| pipeline-opportunity | pipeline_opportunity | 商机产线 | | pipeline-opportunity | pipeline_opportunity | 商机产线 |
| pipeline-sdlc | pipeline_sdlc | 开发产线前端(项目/迭代/任务/交付件页面) | | pipeline-sdlc | pipeline_sdlc | 开发产线前端(项目/迭代/任务/交付件页面) |
| pipeline-ops / pipeline-dist / pipeline-task | — | 运维/分销/任务中心 | | pipeline-ops / pipeline-task | — | 运维/任务中心 |
| pipeline-app | — | 宿主应用:主菜单/菜单权限/构建脚本 | | pipeline-app | — | 宿主应用:主菜单/菜单权限/构建脚本 |
## 关键约定 ## 关键约定