ErisPulse ShadowOps
影子灰度管理模块 —— 在聊天中启动、对比、转正、放弃影子模块。
基于 ErisPulse 2.9 影子模块运行时 API 的运营工具,附归属权审计,报告经 Takumi 渲染为卡片。
简介
ShadowOps 是基于 ErisPulse 架构开发的影子灰度运营模块。影子 = 同一模块的新版本,以独立 owner 与线上旧版并存试运行:收到真实事件副本、出站被拦截记账而非真正发出。本模块把这些运行时操作暴露为聊天命令:
shadow start:把 v2 代码目录装载为影子shadow diff:对比 v1 实际发送 × v2 意向发送(按 trace_id 对齐)shadow promote:确认后一键转正(失败自动回滚)shadow dismiss:放弃影子shadow audit:归属权审计(资源计数 / 孤儿 owner)
要求 ErisPulse >= 2.9.0。
效果展示
/shadow list |
/shadow diff |
/shadow audit |
|---|---|---|
安装
epsdk install ErisPulse-ShadowOps
命令
| 命令 | 说明 |
|---|---|
/shadow |
显示用法 |
/shadow start <模块名> <v2路径> |
启动影子(v2 代码目录或单 .py 文件,建议放在插件目录之外) |
/shadow list |
列出运行中的影子 |
/shadow diff <模块名> |
行为对比报告 |
/shadow promote <模块名> yes |
转正(必须带 yes 确认) |
/shadow dismiss <模块名> |
放弃影子 |
/shadow audit <模块名> |
归属权审计 |
全部命令需要框架主人权限。
使用示例
# 1. 把新版代码放到服务器任意目录(如 downloads/roll_v2/)
# 2. 启动灰度
/shadow start roll downloads/roll_v2
# 3. 试运行一段时间后对比行为
/shadow diff roll
# 4. 确认无害后转正(失败自动回滚旧版本)
/shadow promote roll yes
# 或放弃
/shadow dismiss roll
配置说明
[ShadowOps]
enabled = true # 是否启用模块
diff_max_rows = 10 # 对比报告单次展示条目数
audit_deep = false # 审计附带 gc 实例普查(有全局暂停开销)
render_card = true # 报告用 Takumi 渲染为卡片
theme = "auto" # 卡片配色 (auto/light/dark)
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
enabled |
bool | true |
是否启用模块 |
diff_max_rows |
int | 10 |
对比报告条目上限 |
audit_deep |
bool | false |
gc 实例普查 |
render_card |
bool | true |
卡片渲染 |
theme |
str | auto |
卡片配色 |
注意事项
- 影子源为本地路径;同一 PyPI 包无法在同解释器内新旧并存
- promote 是运行时切换,重启后需持久化安装新版本(
pip install -U) - 走框架的发送/API/KV 全部拦得住;绕过框架的副作用不可拦截(audit 可见资源归属)
参考链接
Metadata
Release files for ErisPulse-ShadowOps 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| erispulse_shadowops-0.1.0.tar.gz | 13.0 kB | With provenance | Details for erispulse_shadowops-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| erispulse_shadowops-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for erispulse_shadowops-0.1.0-py3-none-any.whl |
Total release size: 27.1 kB
Release files / erispulse_shadowops-0.1.0.tar.gz
| Download URL | erispulse_shadowops-0.1.0.tar.gz |
|---|---|
| Size | 13.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
97a7e79789e5b23518b29247e8777ecde691817b35d7164c54632970feded25b
|
|
BLAKE2b-256 checksum How to use checksums |
d5ec3a5079ec1505f40bd95335f02271330e5b0faeb4bcde86f7a4ccda3703e6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.
Transparency logRelease files / erispulse_shadowops-0.1.0-py3-none-any.whl
| Download URL | erispulse_shadowops-0.1.0-py3-none-any.whl |
|---|---|
| Size | 14.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
284864f9d9c2ea3de30a72bbf9f901b33947ac1839bc07b97610c7d9ed0d4f21
|
|
BLAKE2b-256 checksum How to use checksums |
0b00f4298d34045fece0b76613ecc0d5bd7419e9aff27d370d9e77e406307088
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.
Transparency logSecurity for ErisPulse-ShadowOps 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for erispulse_shadowops-0.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 10, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.