技能 port-allocator
🔌

port-allocator

低风险 📁 文件系统访问

إدارة منافذ خادم التطوير عبر المشاريع

تشغيل مشاريع تطوير متعددة يؤدي إلى تعارضات_ports وتشوش. يخصص Port Allocator نطاقات منافذ فريدة لكل مشروع تلقائياً.

支持: Claude Codex Code(CC)
⚠️ 66 差
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“port-allocator”。 ما المنفذ الذي يجب أن أستخدمه لمشروعتي؟

预期结果:

  • دليل المشروع: ~/Codes/my-app
  • نطاق المنفذ: 3020-3029
  • التطبيق الرئيسي: 3020، واجهة البرمجة: 3021، خدمات أخرى: 3022-3029

正在使用“port-allocator”。 أعرض لي جميع المشاريع المسجلة

预期结果:

  • المشاريع المسجلة (3):
  • - my-app: 3000-3009
  • - api-server: 3010-3019
  • - dashboard: 3020-3029

安全审计

低风险
v1 • 1/18/2026

All 298 static findings are FALSE POSITIVES. This skill contains only markdown documentation files that instruct Claude on port management. The backticks are code examples in markdown, not executable code. The 'weak crypto' detections are matching 'MD' in filenames. High entropy in Japanese/Chinese files is expected for non-ASCII text.

4
已扫描文件
716
分析行数
2
发现项
1
审计总数
低风险问题 (1)
SKILL.md:39-43
Configuration file modification
Skill instructs Claude to modify ~/.claude/ configuration files - this is expected behavior for Claude Code settings management

风险因素

📁 文件系统访问 (1)
SKILL.md:39-43
审计者: claude

质量评分

38
架构
100
可维护性
85
内容
22
社区
88
安全
83
规范符合性

你能构建什么

إدارة منافذ مشاريع متعددة

قم بتشغيل عدة تطبيقات ويب في وقت واحد دون تعارضات في المنافذ من خلال تخصيص نطاق منافذ مخصص لكل مشروع.

توحيد تخصيصات المنافذ

أنشئ تخصيص منافذ متسق عبر أعضاء الفريق بحيث يستخدم الجميع نفس المنافذ للمشاريع المشتركة.

تنظيم منافذ الخدمات المصغرة

خصص نطاقات منافذ للخدمات في بنية الخدمات المصغرة مع منافذ التطبيق الرئيسي وواجهة البرمجة والخدمات المساعدة.

试试这些提示

الحصول على منفذ المشروع الحالي 
/port-allocator
عرض جميع المنافذ 
/port-allocator list
فحص المشاريع الجديدة 
/port-allocator scan
تكوين دليل الكود 
/port-allocator config ~/Projects

最佳实践

  • قم بتشغيل /port-allocator allow أولاً لتكوين الصلاحيات وتجنب طلبات التأكيد
  • استخدم /port-allocator scan بعد إضافة مشاريع جديدة إلى دليل الكود الخاص بك
  • قم فقط بإنهاء العمليات ضمن نطاق منفذ مشروعك عند إعادة تشغيل الخدمات

避免

  • لا تستخدم pkill -f node لأنه سيؤثر على مشاريع أخرى
  • لا تقم بتعيين منافذ يدوياً خارج النطاق المخصص لك
  • لا تقم بالكتابة فوق ~/.claude/CLAUDE.md - قم دائماً بالإلحاق للحفاظ على المحتوى الموجود

常见问题

ما نطاق المنفذ الذي ستحصل عليه مشروعتي؟
يحصل كل مشروع على 10 منافذ متتالية بدءاً من 3000. يحصل المشروع الأول على 3000-3009، والثاني على 3010-3019، وهكذا.
ماذا لو لم تحتوي مشروعتي على package.json؟
تقوم الأداة فقط بتخصيص المنافذ للأدلة التي تحتوي على package.json. أضف package.json أو استخدم /port-allocator add للتسجيل اليدوي.
كيف يمكنني تغيير دليل الكود الخاص بي؟
قم بتشغيل /port-allocator config ~/your/path لتعيين موقع دليل كود مخصص.
هل يمكنني استخدام هذا للمشاريع غير Node.js؟
نعم، لكنك تحتاج إلى ملف package.json أو استخدام الأمر add اليدوي لتسجيل المشروع.
ماذا يحدث إذا نفدت المنافذ؟
مع نطاقات المنافذ من 10 منافذ بدءاً من 3000، يمكنك الحصول على حوالي 700 مشروع قبل الوصول إلى المنفذ 10000.
هل يعمل هذا عبر مثيلات Claude Code المتعددة؟
نعم، سجل المنافذ في ~/.claude/port-registry.json مشترك عبر جميع مثيلات Claude Code على جهازك.

开发者详情

作者

guo-yu

许可证

MIT

仓库

https://github.com/guo-yu/skills/tree/master/port-allocator

引用

master

文件结构

📄 SKILL.ja.md

📄 SKILL.md

📄 SKILL.zh-CN.md