Borrowing it
Nothing to install: this file belongs to Fromsko/siyuan-mcp-server. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/Fromsko/siyuan-mcp-server/main/AGENTS.mdgit clone --depth 1 https://github.com/Fromsko/siyuan-mcp-serverWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/fromsko/siyuan-mcp-server/agents-md)<a href="https://agentmods.dev/instructions/fromsko/siyuan-mcp-server/agents-md"><img src="https://agentmods.dev/badge/instructions/fromsko/siyuan-mcp-server/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/fromsko/siyuan-mcp-server/agents-md"><img src="https://agentmods.dev/badge/instructions/fromsko/siyuan-mcp-server/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00758 | $0.00758 |
| Opus 5.5 | $0.00303 | $0.00303 |
| Sonnet 5.5 | $0.00152 | $0.00152 |
| Haiku 4.5 | $0.00076 | $0.00076 |
Grade A, and why
siyuan-mcp-server AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
siyuan-mcp-server 开发规范
本文件面向 AI 代理和人类开发者，规范本仓库的所有操作。
提交规范
格式
<emoji> <type>: <简短描述>
详细描述：
- 分点 1
- 分点 2
Emoji 对照
| Emoji | Type | 用途 |
|---|---|---|
| 🐛 | fix | Bug 修复 |
| ✨ | feat | 新功能 |
| 📝 | docs | 文档变更 |
| 🔧 | chore | 构建/工具/版本号 |
| ♻️ | refactor | 重构 |
| ⚡ | perf | 性能优化 |
| ✅ | test | 增加测试 |
| 🔒 | security | 安全修复 |
示例
🐛 fix: MCP 协议违规修复
详细描述：
- index.ts: console.log 改为仅在 NODE_ENV=development 时输出到 stderr
- client.ts: 错误日志尊重运行模式
- version.ts: 增强 readFileSync 健壮性
✨ feat: 新增 5 个 filetree 端点
详细描述：
- 新增 removeDoc 文档删除命令
- 新增 moveDocs 文档移动命令
- 新增 getHPathByPath/getHPathByID 路径查询
开发流程
提交前必须
- ✅
npm run build通过（TypeScript 编译无错误） - ✅
npm test全部通过 - ✅ 对比官方 API 文档确认端点存在
- ❌ 禁止未经测试直接推送
版本发布流程
# 1. 确认构建和测试
npm run build && npm test
# 2. 提交代码
git add -A
git commit -m "🐛 fix: ..."
# 3. 更新版本号
sed -i 's/"version": "x.y.z"/"version": "NEW"/' package.json
git add package.json
git commit -m "🔧 chore: bump version to NEW"
# 4. 打 tag + 推送
git tag vNEW
git push origin main
git push origin vNEW
思源版本兼容
当前兼容范围记录在 package.json 的 siyuan 字段中：
{
"siyuan": {
"minVersion": "3.0.0",
"maxVersion": "3.x",
"apiDoc": "https://github.com/siyuan-note/siyuan/blob/master/docs/API.md"
}
}
每次对比官方 API 文档后，更新兼容版本范围。
API 对比方法
- 获取官方文档：
https://raw.githubusercontent.com/siyuan-note/siyuan/master/docs/API.md - 提取所有
/api/路径 - 逐一对比代码中的
createHandler('...')调用 - 标注：✅ 匹配 / ❌ 不存在 / ⚠️ 参数不匹配
禁止事项
- ❌ 直接推送未测试的代码
- ❌ 使用不存在的 API 端点（必须先查官方文档）
- ❌ 在 stdout 输出非 JSON-RPC 内容
- ❌ 使用
console.log代替console.error输出日志
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2mo ago First seen · 107 lines · 758 tokens per session scan A 17e0202d0e61
siyuan-mcp-server AGENTS.md is an instructions file published in the GitHub repository Fromsko/siyuan-mcp-server (40 stars, last pushed 3mo ago), licensed ISC. It adds 758 tokens to every session, about $0.0030 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
siyuan-mcp-server AGENTS.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| siyuan-mcp-server AGENTS.mdFromsko/siyuan-mcp-server | Instructions file | 40 | 3mo ago | ISC | A | 758 | Codex, OpenCode |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 143k | yesterday | MIT | A | 7,461 | Codex, OpenCode |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 149k | yesterday | MIT | A | 4,680 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 5,516 | GitHub Copilot |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 3,093 | GitHub Copilot |
| deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness | Instructions file | 274k | 2d ago | MIT | A | 4,313 | Codex, OpenCode |