Grades are a hygiene check, not a security guarantee.

MCP, MCP server

Effect 中文文档

站点:https://effect-ts.cn —— Effect(TypeScript 的 effect system)官方文档全量中文翻译 (v4 + v3 共 234 页,每页标注上游基线)+ 可溯源的问答(每条引用可点回原文,无依据即拒答) + 报错百科(真实报错的检索索引)+ 26 个用 Effect 写的开源 AI 项目推荐。 给 AI / Agent 的入口:/llms.txt · /llms-full.txt · /docs/ .md · /cit

Compatibility: Not stated.

Grade B

Minor issues only, no Medium or High. Worth a quick look at the findings below before installing.

Graded by PlugVetRubric v2

Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.

NETWORK_NO_FIXED_HOST NETWORK_UNNAMED_HOST SECRETS_PATH_DOTENV SECRETS_ENV_READ OBFUSCATION_FILE_OVER_READ_CAP OBFUSCATION_FILE_CAP_REACHED

Why this grade

  • NETWORK_NO_FIXED_HOST Low

    Makes a network call whose host is not written as a fixed address.

    apps/api/src/interfaces/http/knowledge.ts, line 5 * GET /api/knowledge/ask?q= 提问(便于 curl / Agent)

  • NETWORK_UNNAMED_HOST Low

    Calls a fixed host that the description does not name.

    apps/api/src/interfaces/http/knowledge.ts, line 5 * GET /api/knowledge/ask?q= 提问(便于 curl / Agent)

  • SECRETS_PATH_DOTENV Low

    Mentions a .env file.

    apps/api/scripts/llm-check.ts, line 13 * cp .env.example .env # 填入 DEEPSEEK_API_KEY=sk-...

  • SECRETS_ENV_READ Note

    Reads an environment variable whose name contains KEY, SECRET, TOKEN, PASSWORD or CREDENTIAL.

    apps/api/scripts/llm-check.ts, line 32 LLM_API_KEY: process.env.LLM_API_KEY,

  • OBFUSCATION_FILE_OVER_READ_CAP Note

    A file was over the read cap and was not fully read.

    pnpm-lock.yaml, line 1 lockfileVersion: '9.0'

  • OBFUSCATION_FILE_CAP_REACHED Note

    The 400 file cap was reached before every file was read.

    pnpm-lock.yaml, line 1 lockfileVersion: '9.0'

Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.

Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.

What was checked

Plain notes from the hygiene checks.

  • Permissions

    Pass

    No shell or command execution found, and no extra permission was declared.

  • Install and update

    Pass

    No install-time script found, and dependencies are pinned or absent.

  • Network

    Concern

    can reach a host that is not written as a fixed address. can reach api.example.demo. The description does not name that host. can reach jsonplaceholder.typicode.com. The description does not name that host. can reach codeload.github.com. The description does not name that host. can reach raw.githubusercontent.com. The description does not name that host.

    NETWORK_NO_FIXED_HOST NETWORK_UNNAMED_HOST

    apps/api/src/interfaces/http/knowledge.ts, line 5

    * GET /api/knowledge/ask?q= 提问(便于 curl / Agent)

    apps/site/src/components/ApiHealth.tsx, line 17

    fetch("/api/health")

    apps/site/src/components/TrafficDashboard.tsx, line 141

    const res = await fetch(`/api/admin/traffic?hours=${useHours}`, {

    Show more

    apps/site/src/components/AgentDock.astro, line 81

    const response = await fetch("/api/knowledge/stats", { headers: { accept: "application/json" } })

    apps/site/src/components/AskPanel.astro, line 242

    const response = await fetch("/search-index.json")

    apps/site/src/components/AskPanel.astro, line 411

    const response = await fetch("/api/knowledge/ask", {

    apps/site/src/components/AskPanel.astro, line 449

    fetch("/api/knowledge/stats")

    apps/site/src/components/SearchDialog.astro, line 56

    const response = await fetch("/search-index.json")

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    apps/api/scripts/llm-check.ts, line 13

    * cp .env.example .env # 填入 DEEPSEEK_API_KEY=sk-...

    apps/api/scripts/llm-check.ts, line 32

    LLM_API_KEY: process.env.LLM_API_KEY,

    apps/api/scripts/llm-check.ts, line 35

    DEEPSEEK_API_KEY: process.env.DEEPSEEK_API_KEY,

    Show more

    apps/api/scripts/llm-check.ts, line 45

    console.log("提示:未找到 .env 文件 - - 只用命令行环境变量(仍可正常工作)")

    apps/api/scripts/llm-check.ts, line 53

    console.log("要启用模型:cp .env.example .env 并填入 DEEPSEEK_API_KEY=sk-...(或 LLM_BASE_URL + LLM_API_KEY)")

    apps/api/src/bootstrap/config.ts, line 41

    // 为什么必须显式过滤:`Config.option` 只判断变量**存在**,而 `.env.example` 里

    apps/api/src/bootstrap/load-env.ts, line 2

    * bootstrap · `.env` 加载(显式、可预测、可观察)

    apps/api/src/bootstrap/load-env.ts, line 5

    * 它只在 **cwd** 找 `.env`,而本仓库的进程 cwd 是 `apps/api`(`pnpm --filter @ecn/api dev`),

    apps/api/src/bootstrap/load-env.ts, line 6

    * 于是"按 README 把 Key 填进仓库根目录的 `.env`"**根本不会被读到** - - 配置看着没问题,

    apps/api/src/bootstrap/load-env.ts, line 10

    * 1. `apps/api/.env.local` 2. `apps/api/.env`

  • Agent instructions

    Pass

    No instruction to ignore earlier instructions or to hide a step.

  • Obfuscation

    Note

    a file was over the read cap and was not fully read. the file cap was reached before every file was read.

    OBFUSCATION_FILE_OVER_READ_CAP OBFUSCATION_FILE_CAP_REACHED

    pnpm-lock.yaml, line 1

    lockfileVersion: '9.0'

    apps/site/public/observatory/agents.csv, line 1

    repo,url,stars,forks,open_issues,github_language,created_at,pushed_at,license,topics,via,description,is_agent,agent_verdict,agent_type,agent_confidence,agent_evidence_tier,has_llm,

    apps/site/public/observatory/typescript-agents.csv, line 1

    repo,url,stars,forks,open_issues,github_language,created_at,pushed_at,license,topics,via,description,is_agent,agent_verdict,agent_type,agent_confidence,agent_evidence_tier,has_llm,

    Show more

    apps/site/src/content/docs/v4/testing/testclock.mdx, line 1

    ---

  • Licence

    Pass

    A licence file is present (LICENSE).

  • Maintainer activity

    Pass

    The latest commit is within the last 365 days.

Note

Hygiene check of commit 114ca14af0ff. can reach a host that is not written as a fixed address. can reach api.example.demo. The description does not name that host. can reach jsonplaceholder.typicode.com. The description does not name that host. can reach codeload.github.com. The description does not name that host. can reach raw.githubusercontent.com. The description does not name that host. reads a credential or environment file. a file was over the read cap and was not fully read. the file cap was reached before every file was read.

Date and source

Date checked:

View source

github.com

Commit graded: 114ca14af0ff612be27b9c860a2956b6cc3ce1ef

This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.

Read how this letter is chosen