夜市技能（Night Market Skill） — 来源于 claude-night-market/archetypes。如需完整体验（含智能体、钩子与命令），请安装 Claude Code 插件。

客户端-服务器与点对点范式

适用场景

• 适用于具有中心化服务的传统应用，例如 Web 或移动客户端与后端 API 通信的场景。
• 适用于探索去中心化或“离线优先”能力的系统，此类系统依赖点对点同步机制。
• 用于正式界定信任边界、客户端-服务器版本协商机制，以及 API 演进策略。

采用步骤

1. 明确职责划分：清晰界定逻辑与数据在客户端与服务器之间的分布，目标是尽可能减少重复。
2. 文档化接口契约：正式记录所有 API、数据 Schema、认证流程，以及为支持不同客户端版本所需的能力协商机制。
3. 规划版本偏移应对方案：制定管理客户端与服务器版本差异的策略，例如使用功能开关（feature flags）、通过 Accept 请求头实现内容协商，或对 API 采用语义化版本控制（semantic versioning）。
4. 应对连接性问题：若应用并非纯粹的客户端-服务器架构，则需针对间歇性网络连接进行设计。这可能包括实现离线缓存、数据同步协议，或点对点网络中的节点发现与成员管理服务。
5. 保障所有通信安全：强制对所有传输中数据启用 TLS 加密；为每个端点实施授权策略、速率限制及细粒度遥测监控。

关键交付物

• 一份架构决策记录（ADR），涵盖客户端、服务器与对等节点的角色定义、信任边界说明，以及部署假设描述。
• 形式化的 API 或协议规范，以及配套的一套兼容性测试用例。
• 详细的操作手册（Runbooks），说明发布协调流程，例如客户端分批发布（release waves）、向后兼容性支持策略，或点对点网络的运维操作规程。

风险与缓解措施

• “话痨型”客户端（"Chatty" Clients）：
  • 缓解措施：客户端发出过多细碎请求将导致性能下降。可通过 Façade 或 Gateway 等模式合并 API 调用，并在客户端或网络边缘实施缓存策略。
• “厚重型”客户端（"Thick" Clients）导致逻辑重复：
  • 缓解措施：当客户端承载过多业务逻辑时，极易出现逻辑重复且与服务器端不同步的问题。应通过共享通用库封装校验逻辑，或将规则明确收归服务器端统一管理。
• 点对点数据冲突：
  • 缓解措施：在点对点模型中，数据冲突不可避免。应在设计初期即确立正式的冲突解决策略（例如 CRDTs、最后写入者胜出 last-write-wins）及共识机制。

具体组件

以下术语指代该范式落地时实际出现的具体工具与抽象概念。 它们并非强制依赖项，也不属于该技能的 tools: 前置元数据字段（该字段专用于限定 Claude Code 工具调用权限）。 可在架构讨论中参考此列表以消除歧义。

• api-contract-generator —— 生成客户端与服务器共用的机器可读 OpenAPI/RPC 接口契约
• networking-debugger —— 捕获请求/响应链路追踪信息，用于诊断延迟、重试与超时等问题