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