← 返回 Skills 市场
78
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install workspace-browser-3
功能描述
Browse and search workspace files with syntax-highlighted code and AI-generated explanations saved persistently in SQLite.
安全使用建议
This package implements the described file-browser + AI-explanation functionality, but several mismatches and exposure risks mean you should review and harden it before running:
- Do not run it as-is on a production or host-visible network. By default it binds to 0.0.0.0 and sets CORS: '*', which can expose your workspace if the host is reachable. Change HOST to 127.0.0.1 and remove the wildcard CORS if you only need local access.
- The code expects DEEPSEEK_API_KEY / DEEPSEEK_API_URL (see config.py) but the skill metadata does not declare this. If you provide an API key, be aware the app will make outbound requests to that API. Only configure a key you trust and prefer to use a dedicated service account with limited scope.
- Update WORKSPACE_ROOT to the actual intended directory (or make it configurable via environment variable) — the current hard-coded path (/root/.openclaw/workspace) may expose unexpected files. Verify ALLOWED_PATHS and ensure path validation works for your environment.
- Inspect app.py fully (the provided file was partially truncated in the bundle) to confirm there are no additional hidden network calls, backdoors, or exfiltration to unexpected endpoints.
- The start.sh contains a public IP in an echo message and kills processes via pkill; remove or adjust these lines if they are not appropriate. Run the service in an isolated container or VM first so accidental exposure is limited.
- Ensure the SQLite database (explanations.db) is stored where you expect and that its permissions are appropriate.
If you need to trust this skill: ask the author to (a) declare required environment variables in the registry (DEEPSEEK_API_KEY/DEEPSEEK_API_URL), (b) make WORKSPACE_ROOT configurable via env var, (c) change default HOST to localhost and remove wildcard CORS, and (d) remove or explain the public IP message in start.sh. Until those are addressed, treat the package as suspicious and run only in an isolated environment.
功能分析
Type: OpenClaw Skill
Name: workspace-browser-3
Version: 3.0.0
The skill bundle exhibits several high-risk behaviors and misleading configurations. Most notably, 'start.sh' hardcodes an external IP address (175.178.154.173) as the access URL instead of localhost, which could mislead the agent or user into interacting with a remote server. The Flask application in 'app.py' binds to '0.0.0.0' and uses a wildcard CORS policy ('*'), exposing the local workspace file system to the network. Additionally, the 'app.py' file contains a logical error where the database initialization is placed after a blocking 'app.run' call, rendering the persistence feature non-functional. While the tool provides broad file access and sends code to an external AI API (DeepSeek), these align with its stated purpose, but the misleading IP and insecure network configuration warrant a suspicious classification.
能力评估
Purpose & Capability
The code (app.py + front-end) matches the declared purpose (file browser + AI explanations + SQLite persistence). However the skill metadata/registry claims 'no required env vars' while the code expects a DEEPSEEK_API_KEY/DEEPSEEK_API_URL (in config.py) to call an external AI service — that credential is not declared in requires.env. Also the package was presented as 'instruction-only' but contains many code files, a start script and a requirements file, which is inconsistent.
Instruction Scope
SKILL.md instructs users to run start.sh and points to localhost, but config.py hard-codes WORKSPACE_ROOT = '/root/.openclaw/workspace' (not 'current workspace' as the docs state). start.sh prints an external IP (175.178.154.173) which is inconsistent with the 'localhost' guidance. The server binds to HOST='0.0.0.0' and the app sets CORS '*' — this combination can expose workspace files if the host/network is reachable. The runtime instructions do not mention configuring the required API key or restricting network exposure.
Install Mechanism
There is no formal install spec in the registry, but the bundle includes code files, a requirements.txt and a start.sh that launches the app. The start script runs pkill and starts app.py in the background; it does not download external code. Lack of an install spec despite included code is an inconsistency that increases the chance of unexpected local actions during install/run.
Credentials
The code uses DEEPSEEK_API_KEY and DEEPSEEK_API_URL to call an external AI service, but the skill metadata does not declare any required environment variables. The configured WORKSPACE_ROOT points at /root/.openclaw/workspace which could allow access to any files under that path; ALLOWED_PATHS is also hard-coded to that path. These configuration choices and the missing declaration for the remote API key are disproportionate to the documented installation instructions and increase risk of accidental data exposure or exfiltration.
Persistence & Privilege
The skill persists explanations in a local SQLite database (explanations.db) in the project directory — that is consistent with the described functionality. It does not request 'always: true' or system-wide privileges. However, binding to 0.0.0.0 and enabling CORS '*' increases runtime exposure risk, so run-time network exposure should be limited.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install workspace-browser-3 - 安装完成后,直接呼叫该 Skill 的名称或使用
/workspace-browser-3触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v3.0.0
Workspace浏览器3.0全新发布,增强文件浏览及AI代码解释体验:
- 全新马卡龙配色文件树,支持展开/收起文件夹
- 代码查看双Tab:源代码与AI自动生成的代码解释(含语法高亮)
- 代码解释持久化存储,支持自动与手动输入,下次直接显示
- 工作区全文搜索,实时展示递归匹配结果
- 支持文件下载、代码复制,并保障移动端自适应体验
- 引入分离的状态管理、SQLite数据库自动创建与存储
元数据
常见问题
Release Package 是什么?
Browse and search workspace files with syntax-highlighted code and AI-generated explanations saved persistently in SQLite. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 78 次。
如何安装 Release Package?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install workspace-browser-3」即可一键安装,无需额外配置。
Release Package 是免费的吗?
是的,Release Package 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Release Package 支持哪些平台?
Release Package 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Release Package?
由 coopeter(@coopeter)开发并维护,当前版本 v3.0.0。
推荐 Skills