拓冰网站定制 
Diagram Design 客户端档案用命名 profile 与 .diagram-design 标记在多客户项目间切换品牌【免费下载链接】diagram-design38 editorial diagram types for Claude Code, Codex, and Pi. Self-contained HTML SVG. No shadows. No Mermaid slop.项目地址: https://gitcode.com/GitHub_Trending/di/diagram-design当你用同一套 Diagram Design为 Claude Code、Codex、Factory Droid、Pi 提供 38 种编辑风格图表的 Agent Skill服务多个客户时会遇到一个具体冲突安装目录里的references/style-guide.md只有一份直接改它意味着每个客户项目共用同一套皮肤而且托管式插件更新可能把改动整个替换掉。命名 profilenamed client profile加上项目根目录的.diagram-design标记就是官方给出的解法品牌样式快照存在家目录的 profile 库里每个客户项目用一个只含profile: slug的标记文件直接选中自己的那份互不覆盖。本文走通这条路径创建 profile、写项目标记、在多个工作区间切换品牌并给出每步的验证方式。存储结构三个位置各管什么按 profiles.md 的定义涉及三个路径对象位置作用Profile 库~/.diagram-design/profiles/存放全部命名 profile插件更新不会碰这里Profile 文件~/.diagram-design/profiles/slug.md一份完整的style-guide.md快照头部带一段元数据注释项目标记project-root/.diagram-design可选内容为恰好一行profile: slug随项目走工作副本当前安装里的references/style-guide.md未用 profile 时的生效样式规则里有两条硬性边界profile 绝不能放在插件安装目录内更新会替换那些目录也不要在家里目录存项目路径 → profile的索引标记文件本身跟项目走。slug 必须整体匹配[a-z0-9][a-z0-9-]{0,63}全小写、最多 64 字符只允许字母、数字和连字符default是内置保留名可以加载或重置到它但不能覆盖、更新或删除。第一步把品牌 onboarding 结果存成命名 profile每个客户品牌只需 onboarding 一次。在目标 Agent 里触发 onboardingURL、已安装 skill 或本地设计系统目录三种来源任选其一见 onboarding.md确认 diff 并写入后按 SKILL.md 的流程每次 onboarding 结束时都会提示把结果保存为命名 profile。调用入口因宿主而异README Working with multiple clients 一节# Claude Code /diagram-design:profile # Factory Droid 或 Pi /profilesave的执行要点来自 profiles.md 的save [slug]规程未提供 slug 时会询问如果给的客户端名不是合法 slug它只会提议一个规范化结果并等待批准不会替你静默决定default会被拒绝。目标 profile 已存在时会先显示其名称和 updated 日期并要求确认此时应优先用update。保存前会先剥离源内容顶部的旧 profile 头防止 save → load → save 叠加多个头只加一个新渲染的头正文逐字节拷贝。首次 save 会自动创建default.md快照它必须是当前包出厂原样的style-guide.md绝不把已定制的样式误标成default如果读不到原样副本默认快照创建失败reset将不可用直到重新安装或更新后才恢复。源若是未带标记的已安装工作副本save还会把新头写回该工作副本以标记当前激活的 profile让list和show立刻一致。save完成后会询问是否把项目标记写成profile: slug——这一步只对明确同意后才会执行。第二步给每个客户项目写 .diagram-design 标记标记是整个方案的隔离核心。文件位于各项目根目录语法极其严格整个文件必须匹配只允许水平空白和结尾一个换行profile: slug有且只有一行profile:不允许注释、路径、散文、frontmatter 或额外键slug会先按上面的 slug 规则校验再拼出~/.diagram-design/profiles/slug.md路径标记内容被视为不可信数据任何不合法的内容都会让整个标记被忽略并继续走无标记解析流程——绝不执行标记中的内容也不把它当文件系统路径。为什么必须隔离marker-first 的直接读取保证通过标记解析的生成过程必须让已安装的style-guide.md逐字节不变。两个并行工作区服务不同客户时各自直接读家目录里的 profile共享工作副本上不存在竞争。品牌切换load / switch 与 marker-first 解析每次生成图表前skill 都会重新解析生效样式指南不会跨项目缓存选择。解析顺序profiles.md Resolution before every generation项目根存在.diagram-design且合法 → 只解析~/.diagram-design/profiles/slug.md做结构检查后直接用它不复制覆盖安装里的工作副本。profile: default同样跳过首次运行门。无有效标记 → 读已安装工作副本头部有合法 profile 头则说明曾 copy-over 加载过某 profile无头且### Semantic roles或## Typography表与出厂默认有差异则归类为custom-unsaved并提示save全部默认则进入首次设置门。显式切换用loadswitch是它的同义词命令形态/diagram-design:profile load acmeload在有标记项目上的行为值得注意即使现有标记指向的是一个不存在的profile它也不会静默改用共享工作副本而是解释带标记的项目不走共享工作副本并征求你同意后把标记替换为profile: slug——同意后只写标记文件不动style-guide.md。无标记项目上load才会把校验过的完整 profile 覆盖写入工作副本且只在用户显式调用 load/switch 时允许这种 copy-over。加载后还会跑一次当前 schema 结构检查缺失的行从出厂默认整行补齐绝不猜 token 或字体值补齐的 role 会列出来告知你并提供update slug把修复后的完整快照持久化如果必需表头缺失或损坏到无法安全插入行会停下来询问是否从出厂默认修复而不是丢弃其余 profile。验证怎么确认品牌真的切对了文档规定的验证手段是写后重读不要只信任写入动作list无参数调用即执行list列出~/.diagram-design/profiles/下每个合法文件的显示名、slug、source URL 和 updated 日期并标出当前生效的 profile——优先标记来自合法项目标记的选择其次标记工作副本头部的选择。头部缺失或 slug 与文件名不符的条目会被标为 invalid。show按marker-first然后工作副本回退的顺序解析报告激活 profile 的名称、slug、规范源文件、source URL、updated 日期和 notes未带头的定制工作副本会报告custom-unsaved未动过的默认会报告default (not yet snapshotted)。重读校验save/update后会重读目标文件要求 slug 正确、恰好一个 profile 头、正文未变然后才报告保存路径copy-over 加载同样会重读目的地验证。命令面明确要求never claim a write succeeded without re-reading it未重读不得声称写入成功。工作副本未被污染在带标记的项目里生成图表后已安装的style-guide.md应保持逐字节不变——这是 marker-first 解析的直接可观察结果。已知失败场景与边界以下判断直接来自 profiles.md 的 Failure and recovery cases排查时按对应现象对号入座托管更新替换了工作副本命名 profile 存活。要么显式重新 load 一份要么依赖项目标记——标记本身不受更新影响。标记指向缺失的 profile不会静默回退到别的客户或工作副本会告诉你哪个 slug 缺失、提供list并询问要用哪个 profile。标记内容畸形或敌意整个标记被忽略解释一句为何无效继续无标记解析。profile 库不可写展示预期的规范路径并提供手动粘贴完整文件的方式不回退到安装目录内存储。安装目录不可写不会声称 copy-over load 成功转用基于标记的流程它直接读家目录 profile。delete只接受显式 slug 且拒绝default确认后才删除那一个校验过的文件从不 glob、不删 profiles 目录若某标记仍指向被删 profile会警告它现在解析为 missing并在同意后帮你改为profile: default或其他已存 slug。覆盖确认不可跳过无论命令是否来自脚本调用覆盖已有 profile、修改项目标记、删除 profile 之前都必须确认。这套设计被 ADR 0006 记录为已接受决策v2.4拒绝安装目录内存储会被更新替换、拒绝 token 级合并格式agent 需要解释版本化合并格式、拒绝中央路径索引路径随机器和移动变化、也拒绝仅 copy-over 的选择方式保留并行工作区竞争。代价是加载时多一次 schema 检查、新必需行出现时需要显式重新保存。最短主路径回顾为目标客户 onboarding 品牌 →save slug如/diagram-design:profile save acme在该客户项目根目录写.diagram-design内容恰好一行profile: slug生成图表前用show确认解析到了正确的 profilelist确认标记项目被标记为激活项切换到另一客户时直接在该客户项目里工作——marker-first 解析会自动读到对应 profile无需改动共享安装确需修改共享工作副本时再用load slug。完整命令面list|save|load|show|update|reset|delete的路由与参数约定见 commands/profile.mdPi 宿主下的同形提示模板见 prompts/profile.md存储、标记与恢复契约的全文以 profiles.md 为准。【免费下载链接】diagram-design38 editorial diagram types for Claude Code, Codex, and Pi. Self-contained HTML SVG. No shadows. No Mermaid slop.项目地址: https://gitcode.com/GitHub_Trending/di/diagram-design创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Diagram Design 客户端档案：用命名 profile 与 .diagram-design 标记在多客户项目间切换品牌
Diagram Design 客户端档案用命名 profile 与 .diagram-design 标记在多客户项目间切换品牌【免费下载链接】diagram-design38 editorial diagram types for Claude Code, Codex, and Pi. Self-contained HTML SVG. No shadows. No Mermaid slop.项目地址: https://gitcode.com/GitHub_Trending/di/diagram-design当你用同一套 Diagram Design为 Claude Code、Codex、Factory Droid、Pi 提供 38 种编辑风格图表的 Agent Skill服务多个客户时会遇到一个具体冲突安装目录里的references/style-guide.md只有一份直接改它意味着每个客户项目共用同一套皮肤而且托管式插件更新可能把改动整个替换掉。命名 profilenamed client profile加上项目根目录的.diagram-design标记就是官方给出的解法品牌样式快照存在家目录的 profile 库里每个客户项目用一个只含profile: slug的标记文件直接选中自己的那份互不覆盖。本文走通这条路径创建 profile、写项目标记、在多个工作区间切换品牌并给出每步的验证方式。存储结构三个位置各管什么按 profiles.md 的定义涉及三个路径对象位置作用Profile 库~/.diagram-design/profiles/存放全部命名 profile插件更新不会碰这里Profile 文件~/.diagram-design/profiles/slug.md一份完整的style-guide.md快照头部带一段元数据注释项目标记project-root/.diagram-design可选内容为恰好一行profile: slug随项目走工作副本当前安装里的references/style-guide.md未用 profile 时的生效样式规则里有两条硬性边界profile 绝不能放在插件安装目录内更新会替换那些目录也不要在家里目录存项目路径 → profile的索引标记文件本身跟项目走。slug 必须整体匹配[a-z0-9][a-z0-9-]{0,63}全小写、最多 64 字符只允许字母、数字和连字符default是内置保留名可以加载或重置到它但不能覆盖、更新或删除。第一步把品牌 onboarding 结果存成命名 profile每个客户品牌只需 onboarding 一次。在目标 Agent 里触发 onboardingURL、已安装 skill 或本地设计系统目录三种来源任选其一见 onboarding.md确认 diff 并写入后按 SKILL.md 的流程每次 onboarding 结束时都会提示把结果保存为命名 profile。调用入口因宿主而异README Working with multiple clients 一节# Claude Code /diagram-design:profile # Factory Droid 或 Pi /profilesave的执行要点来自 profiles.md 的save [slug]规程未提供 slug 时会询问如果给的客户端名不是合法 slug它只会提议一个规范化结果并等待批准不会替你静默决定default会被拒绝。目标 profile 已存在时会先显示其名称和 updated 日期并要求确认此时应优先用update。保存前会先剥离源内容顶部的旧 profile 头防止 save → load → save 叠加多个头只加一个新渲染的头正文逐字节拷贝。首次 save 会自动创建default.md快照它必须是当前包出厂原样的style-guide.md绝不把已定制的样式误标成default如果读不到原样副本默认快照创建失败reset将不可用直到重新安装或更新后才恢复。源若是未带标记的已安装工作副本save还会把新头写回该工作副本以标记当前激活的 profile让list和show立刻一致。save完成后会询问是否把项目标记写成profile: slug——这一步只对明确同意后才会执行。第二步给每个客户项目写 .diagram-design 标记标记是整个方案的隔离核心。文件位于各项目根目录语法极其严格整个文件必须匹配只允许水平空白和结尾一个换行profile: slug有且只有一行profile:不允许注释、路径、散文、frontmatter 或额外键slug会先按上面的 slug 规则校验再拼出~/.diagram-design/profiles/slug.md路径标记内容被视为不可信数据任何不合法的内容都会让整个标记被忽略并继续走无标记解析流程——绝不执行标记中的内容也不把它当文件系统路径。为什么必须隔离marker-first 的直接读取保证通过标记解析的生成过程必须让已安装的style-guide.md逐字节不变。两个并行工作区服务不同客户时各自直接读家目录里的 profile共享工作副本上不存在竞争。品牌切换load / switch 与 marker-first 解析每次生成图表前skill 都会重新解析生效样式指南不会跨项目缓存选择。解析顺序profiles.md Resolution before every generation项目根存在.diagram-design且合法 → 只解析~/.diagram-design/profiles/slug.md做结构检查后直接用它不复制覆盖安装里的工作副本。profile: default同样跳过首次运行门。无有效标记 → 读已安装工作副本头部有合法 profile 头则说明曾 copy-over 加载过某 profile无头且### Semantic roles或## Typography表与出厂默认有差异则归类为custom-unsaved并提示save全部默认则进入首次设置门。显式切换用loadswitch是它的同义词命令形态/diagram-design:profile load acmeload在有标记项目上的行为值得注意即使现有标记指向的是一个不存在的profile它也不会静默改用共享工作副本而是解释带标记的项目不走共享工作副本并征求你同意后把标记替换为profile: slug——同意后只写标记文件不动style-guide.md。无标记项目上load才会把校验过的完整 profile 覆盖写入工作副本且只在用户显式调用 load/switch 时允许这种 copy-over。加载后还会跑一次当前 schema 结构检查缺失的行从出厂默认整行补齐绝不猜 token 或字体值补齐的 role 会列出来告知你并提供update slug把修复后的完整快照持久化如果必需表头缺失或损坏到无法安全插入行会停下来询问是否从出厂默认修复而不是丢弃其余 profile。验证怎么确认品牌真的切对了文档规定的验证手段是写后重读不要只信任写入动作list无参数调用即执行list列出~/.diagram-design/profiles/下每个合法文件的显示名、slug、source URL 和 updated 日期并标出当前生效的 profile——优先标记来自合法项目标记的选择其次标记工作副本头部的选择。头部缺失或 slug 与文件名不符的条目会被标为 invalid。show按marker-first然后工作副本回退的顺序解析报告激活 profile 的名称、slug、规范源文件、source URL、updated 日期和 notes未带头的定制工作副本会报告custom-unsaved未动过的默认会报告default (not yet snapshotted)。重读校验save/update后会重读目标文件要求 slug 正确、恰好一个 profile 头、正文未变然后才报告保存路径copy-over 加载同样会重读目的地验证。命令面明确要求never claim a write succeeded without re-reading it未重读不得声称写入成功。工作副本未被污染在带标记的项目里生成图表后已安装的style-guide.md应保持逐字节不变——这是 marker-first 解析的直接可观察结果。已知失败场景与边界以下判断直接来自 profiles.md 的 Failure and recovery cases排查时按对应现象对号入座托管更新替换了工作副本命名 profile 存活。要么显式重新 load 一份要么依赖项目标记——标记本身不受更新影响。标记指向缺失的 profile不会静默回退到别的客户或工作副本会告诉你哪个 slug 缺失、提供list并询问要用哪个 profile。标记内容畸形或敌意整个标记被忽略解释一句为何无效继续无标记解析。profile 库不可写展示预期的规范路径并提供手动粘贴完整文件的方式不回退到安装目录内存储。安装目录不可写不会声称 copy-over load 成功转用基于标记的流程它直接读家目录 profile。delete只接受显式 slug 且拒绝default确认后才删除那一个校验过的文件从不 glob、不删 profiles 目录若某标记仍指向被删 profile会警告它现在解析为 missing并在同意后帮你改为profile: default或其他已存 slug。覆盖确认不可跳过无论命令是否来自脚本调用覆盖已有 profile、修改项目标记、删除 profile 之前都必须确认。这套设计被 ADR 0006 记录为已接受决策v2.4拒绝安装目录内存储会被更新替换、拒绝 token 级合并格式agent 需要解释版本化合并格式、拒绝中央路径索引路径随机器和移动变化、也拒绝仅 copy-over 的选择方式保留并行工作区竞争。代价是加载时多一次 schema 检查、新必需行出现时需要显式重新保存。最短主路径回顾为目标客户 onboarding 品牌 →save slug如/diagram-design:profile save acme在该客户项目根目录写.diagram-design内容恰好一行profile: slug生成图表前用show确认解析到了正确的 profilelist确认标记项目被标记为激活项切换到另一客户时直接在该客户项目里工作——marker-first 解析会自动读到对应 profile无需改动共享安装确需修改共享工作副本时再用load slug。完整命令面list|save|load|show|update|reset|delete的路由与参数约定见 commands/profile.mdPi 宿主下的同形提示模板见 prompts/profile.md存储、标记与恢复契约的全文以 profiles.md 为准。【免费下载链接】diagram-design38 editorial diagram types for Claude Code, Codex, and Pi. Self-contained HTML SVG. No shadows. No Mermaid slop.项目地址: https://gitcode.com/GitHub_Trending/di/diagram-design创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考