v1.0.1 — 修复首次启动安装失败

修复 v1.0 首次启动安装失败 的问题。

问题

在 Python 3.10.0–3.10.7 上双击 start-shellsentry.cmd，安装依赖时报：

ERROR: File "setup.py" or "setup.cfg" not found. Directory cannot be installed in editable mode
(A "pyproject.toml" file was found, but editable mode currently requires a setuptools-based build.)

原因

与项目本身无关，是新建 venv 里自带的 pip 太旧：从只有 pyproject.toml 的项目做 editable 安装需要 PEP 660，而这是 pip 21.3 才有的能力；Python 3.10 早期版本内置的正是 pip 21.2.3。

修复

• 启动脚本安装依赖前先升级 pip / setuptools / wheel
• 解释器改为挑选真正的 3.10+（py -3 在部分机器上会指向更旧的版本）
• 若检测到遗留的旧 Python 环境，自动重建

已经踩过坑的用户

不必重新下载：在你的 .venv 里手动执行一次

.venv\Scripts\python -m pip install -U pip

然后重新双击启动脚本即可。

其他

• README 补充了 pip install -e . 报此错时的手动处理方式

v1.0 — 首个开源版本

首个开源版本：确定性取证 × 大模型定性 × Agent 反证复核的恶意代码审计智能体 —— 先由确定性工具固定证据，再交大模型读码定性，最后经 Agent 反证复核，全程零执行、样本不落盘。

亮点

• 128 条检测规则（含 30 条跨语言通用规则）、9 种程序化解码算法
• 零执行：样本从不运行 / 编译 / 加载 / 反序列化，也从不落盘
• Agent 反证复核：主动证伪、排除误报后才下结论；核不出就标注「需运行时验证」，绝不编造
• 网页界面（仅绑定 127.0.0.1）+ 纯静态 CLI（shellsentry scan，输出 JSON，不需要 API Key）
• 覆盖 PHP / Java·JSP / ASP·ASPX / C# / Python / JavaScript / Ruby / Shell / Go

快速开始

见 README。

安全边界

• 「零执行」的确切含义见 README「安全模型」：待审样本只当纯文本读取
• 界面无认证，不要把本地界面暴露到公网
• 样本内容只会发往你自己配置的模型接口

Apache-2.0