Scan Report
15 /100
ssh-handoff
Create and reuse a secure shared terminal handoff when a human must authenticate first and the agent must resume work in the same shell session afterward.
SSH Handoff 技能提供 tmux 会话共享和浏览器终端功能,用于人与 AI Agent 共享 shell 会话。代码质量良好,行为与文档一致,无恶意行为发现。硬编码 IP 地址(192.0.2.x)为文档示例地址,合法用于技术说明。
Safe to install
可安全使用。建议明确声明 sudo/ufw 权限需求于 SKILL.md 中。
Findings 3 items
| Severity | Finding | Location |
|---|---|---|
| Medium | 未声明的 network:WRITE 权限 | scripts/start-url-token-web-terminal.sh:15 |
| Low | 文档使用 TEST-NET IP 地址 | SKILL.md:122 |
| Low | 未声明 sudo 权限需求 | scripts/start-url-token-web-terminal.sh:303 |
| Resource | Declared | Inferred | Status | Evidence |
|---|---|---|---|---|
| Shell | WRITE | WRITE | ✓ Aligned | scripts/start-url-token-web-terminal.sh:line 15-25 创建/管理 tmux 会话 |
| Network | NONE | WRITE | ✗ Violation | 启动 ttyd HTTP 服务和 Node.js 代理,SKILL.md 未声明 |
| Filesystem | NONE | WRITE | ✗ Violation | scripts/start-url-token-web-terminal.sh:line 189 使用 mktemp 创建临时目录 |
2 High 4 findings
High IP Address 硬编码 IP 地址
192.0.2.10 SKILL.md:122 High IP Address 硬编码 IP 地址
192.0.2.20 SKILL.md:122 Medium External URL 外部 URL
https://$EXPECTED_HOST scripts/start-url-token-web-terminal.sh:229 Medium External URL 外部 URL
http://$EXPECTED_HOST scripts/start-url-token-web-terminal.sh:231 File Tree
9 files · 41.5 KB · 1376 lines Markdown 5f · 555L
Shell 3f · 484L
JavaScript 1f · 337L
├─
▾
references
│ ├─
design-notes.md
Markdown
│ ├─
examples.md
Markdown
│ └─
lan-restricted.md
Markdown
├─
▾
scripts
│ ├─
start-local-web-terminal.sh
Shell
│ ├─
start-url-token-web-terminal.sh
⚠
Shell
│ ├─
stop-local-web-terminal.sh
Shell
│ └─
url-token-proxy.js
⚠
JavaScript
├─
README.md
Markdown
└─
SKILL.md
Markdown
Dependencies 4 items
| Package | Version | Source | Known Vulns | Notes |
|---|---|---|---|---|
node | any | system | No | Mode C 必须,系统自带即可 |
python3 | any | system | No | 用于生成 token 和管理状态 |
tmux | any | system | No | 核心组件,必须 |
ttyd | any | system | No | 浏览器终端,必须 |
Security Positives
✓ 代码结构清晰,注释完整
✓ 实现了完善的 TTL 超时自动清理机制
✓ 包含 IP 白名单、Host/Origin 验证等多层安全检查
✓ 使用 crypto.randomUUID/secrets 生成安全随机 token
✓ 无 base64|bash 管道、eval()、裸 IP 外部请求等高危模式
✓ 无凭证收割、环境变量遍历等敏感数据访问
✓ 无远程脚本下载/执行行为
✓ 无 HTML 注释隐藏指令
✓ 无访问 ~/.ssh、~/.aws、.env 等敏感路径