Skip to main content
ErisPulse ShadowOps

ErisPulse ShadowOps

影子灰度管理模块 —— 在聊天中启动、对比、转正、放弃影子模块。

基于 ErisPulse 2.9 影子模块运行时 API 的运营工具,附归属权审计,报告经 Takumi 渲染为卡片。

PyPI Python License Stars Downloads ErisPulse

简体中文 | English


简介

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
list diff 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 = "doodle"          # 卡片风格 (doodle/editorial)
配置项 类型 默认值 说明
enabled bool true 是否启用模块
diff_max_rows int 10 对比报告条目上限
audit_deep bool false gc 实例普查
render_card bool true 卡片渲染
theme str doodle 卡片风格 (doodle/editorial)

注意事项

  1. 影子源为本地路径;同一 PyPI 包无法在同解释器内新旧并存
  2. promote 是运行时切换,重启后需持久化安装新版本(pip install -U)
  3. 走框架的发送/API/KV 全部拦得住;绕过框架的副作用不可拦截(audit 可见资源归属)

参考链接

Metadata

Release files for ErisPulse-ShadowOps 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ErisPulse-ShadowOps 0.1.1
File Size Uploaded Provenance Actions
erispulse_shadowops-0.1.1.tar.gz 14.2 kB With provenance Details for erispulse_shadowops-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ErisPulse-ShadowOps 0.1.1
File Interpreter ABI Platform Actions
erispulse_shadowops-0.1.1-py3-none-any.whl Python 3 none any Details for erispulse_shadowops-0.1.1-py3-none-any.whl

Total release size: 29.4 kB

Release files / erispulse_shadowops-0.1.1.tar.gz

Download URL erispulse_shadowops-0.1.1.tar.gz
Size 14.2 kB
Tags Source
SHA-256 checksum
How to use checksums
dddd4eb075ebdab442bd38150368cc871f3f7c97f22c8fd917f427a11e67ba3c
BLAKE2b-256 checksum
How to use checksums
22b65742fe8909e0d9430523e4a398e4f432a320d68f3a90b2f7ec42713d15c1
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 log

Release files / erispulse_shadowops-0.1.1-py3-none-any.whl

Download URL erispulse_shadowops-0.1.1-py3-none-any.whl
Size 15.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
17cdd43835abbaecc017e809e3cc667ac77b192c388fea711fa99d1d76367b40
BLAKE2b-256 checksum
How to use checksums
7206b500512495617805ea5555113e683e83c28dabb2d33e7840558be6d30e8f
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 log

Security for ErisPulse-ShadowOps 0.1.1

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.

Select from 2 files

Attestation for erispulse_shadowops-0.1.1.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 log

A 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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page