前言¶
在 DeepSeek Harness（DSH）里做 VRChat 相关开发时，常见问题是模型会先给出「听起来合理」的答案：Udon 里某个 API 能不能用、Quest 性能红线、VPM 包是否兼容，往往缺少可核对的依据。社区插件生态里，DSH 的理念是「一切皆插件」；SkillHub 等目录是独立站点，与 DeepSeek / 幻方无官方从属关系。下面介绍维护者 VRChatCN-Kipfel 发布的 dsh-vrchat（GitHub：VRChatCN-Kipfel/dsh-vrchat），它把离线知识库、专用检索工具、红线注入和流程技能打包进一次安装，让 agent 在边界内查事实、在流程内做 World / Avatar 项目。
这是什么¶
dsh-vrchat 是面向 DSH 的 VRChat 创作者工具链：随包分发数百页 VRChat 知识库（当前页数以会话内 /vrchat stats 为准；package 描述为 414 页量级）、9 个专用工具、6 个随包技能，并在选用「VRChat 创作模式」预设时注入红线与域块。分类上在 SkillHub 归入「记忆」类插件。
它不替代 Unity 编辑器或 SDK 面板，而是补「查得到、扫得到、能脚手架工程」这一层：例如 Udon API 暴露三态、本机 Unity 进程与许可证只读探测、以及 vrc-get 可衔接的 Blank 形态工程创建。
核心功能¶
知识库与检索¶
语料本体来自 submodule VRChat-Agent-Creator-Library/，查询时按需打开命中的 Markdown 页，不经 data/ 重序列化全文。构建产物在 data/，包括红线块（t0-core.txt）、域块（t1-{world,avatar,shader}.txt）、覆盖地图（domain-map.txt）、预设主体（always-load.txt），以及 index.json、api-table.json（README 写明 SDK 3.10.3 已暴露清单：80 类型 / 1253 成员）、keyword-routes.json 等。
检索设计有三条硬性要求（README 原文）：准入必须「关于」话题而不能仅靠正文提及；高频词不能单独成事；ASCII 须整词匹配。检索是词法的（bigram + 文档频率），没有向量——库外问题应返回空，由覆盖边界声明止住编造。
九个工具¶
| 工具 | 用途概要 |
|---|---|
vrchat_kb |
查概念（同步变量、PhysBone 上限、Shader 变体等） |
vrchat_kb_grep |
按符号定位行号 |
vrchat_kb_read |
按行号读上下文 |
vrchat_kb_api |
查 API 在 Udon 中是否暴露（三态） |
vrchat_kb_filter |
按 type / category / confidence / status / tags 筛页 |
vrchat_kb_list |
查看库构成 |
vrchat_kb_unity |
只读探测运行中的 Unity / Hub / MCP 桥及许可证相关信息 |
vrchat_kb_scan |
扫描 .cs / .shader 硬约束违例（只报告） |
vrchat_kb_project_new |
在无工程时创建 World 或 Avatar 的 Blank 形态目录与包清单（不联网、不启动 Unity、不装 SDK） |
建工程后 SDK 需用户侧用 vrc-get resolve -p "<工程路径>" 解析；README 说明 ALCOM GUI 的建工程在 vrc-get 中没有对等子命令，该工具补的是 agent 可执行的脚手架步骤。
六个技能与预设¶
技能与知识库分工：事实查库，流程走技能。随包包括 World 设计—实施—核验（vrchat-world 及子技能）、Avatar 审计（inspect-vrchat-avatar-project）、VPM 命令行（vrc-get-cli），以及外部开源技能推荐表路径 vendor/vrchat-world-codex-skills/docs/RECOMMENDED_OPEN_SOURCE_SKILLS.md。
未选预设时：9 个工具可用，不注入 prompt 文本。选用会话预设 「VRChat 创作模式」 后，额外注入红线、覆盖地图、域块与完整项目流程（README 称约三万五千字符量级，以 /vrchat stats 实测为准）。输入框上方的「注入 N 字符 · M 次查询」是会话级成本提示，未选预设且未查库时不显示。
斜杠命令（自查）¶
| 命令 | 作用 |
|---|---|
/vrchat stats |
本会话注入字符数、知识库版本与构建时间、语料页数、已问问题 |
/vrchat stale |
知识库构建时长，提示是否需重建 |
/vrchat scan <路径> |
提示模型扫描该路径代码（命令本身不读文件） |
安装与启用¶
安装会从 GitHub 拉三个上游仓库（语料与两套技能），需要 git、能访问 github.com，以及 Node.js 18+（DSH 自带 node 时通常无需另装）。pnpm 默认禁止安装脚本执行，需在同一终端会话里放行构建：
$env:npm_config_dangerously_allow_all_builds="true"; dsh plugin --profile web add github:VRChatCN-Kipfel/dsh-vrchat
npm_config_dangerously_allow_all_builds=true && dsh plugin --profile web add github:VRChatCN-Kipfel/dsh-vrchat
该环境变量仅对当前终端窗口有效。Windows 下若无 git，README 建议：
winget install --id Git.Git --silent
装完后在会话输入 /vrchat stats：能看到注入字符、版本、页数即表示数据完整；若报「data/ 不完整」，说明安装钩子未成功，需按 README 卸载重装排查。
启用专家流程：在会话顶部预设选择器切换到 「VRChat 创作模式」，或新建会话时选中该预设。
典型用法¶
README 给出的试句示例：用户描述「在 Blender 里改了形态键，Unity 里模型不显示」，agent 应检索到 blender-shape-keys.md 并给出 FBX 导出/导入的具体设置，而不是泛泛建议「检查导入设置」。
查 Udon API 时用 vrchat_kb_api；写完脚本后用 vrchat_kb_scan；需要从零开工程时用 vrchat_kb_project_new，参数包括必填 targetDir（父目录须已存在）、必填 type（world 或 avatar），可选 unityVersion（默认 2022.3.22f1）、force（存在则改名为 .bak-<时间戳> 备份而非覆盖）、dryRun。
选用预设后，流程覆盖「用户什么都没有」时的 Avatar / World 分路、资产来源优先级、改动—截图—验收闭环、git 基线，以及「做完」与「上传」的区分（上传仍依赖用户 SDK 面板与 Trust Rank 等条件）。
适用场景与注意¶
适合谁：在 DSH 里做 VRChat World / Avatar / Udon / Shader / Quest 限制相关开发，希望 agent 先查库再回答、并能扫代码违例、探测本机 Unity、脚手架 VPM 工程的使用者与维护者。
运行与信任：插件以当前 dsh 进程的权限运行；安装前请自行查看 GitHub 源码与 MIT 许可证。语料与技能 submodule 许可随各自上游仓库。安装不应在不可信环境盲目放行 npm_config_dangerously_allow_all_builds。
已知边界（README）：预设未内置 mcp-client，Unity 编辑器深度操作需自行配置 Unity MCP 桥；vrchat_kb_unity 仅为只读进程探测。上游更新后维护者需重跑 node tools/build-knowledge.mjs。离线环境无法完成依赖 GitHub 的安装钩子。
版本参考：package.json 当前为 1.0.0-alpha.4；GitHub 星标数以仓库页为准（线索为 4 stars）。
结尾¶
dsh-vrchat 把 VRChat 创作者需要的「可查事实、可扫红线、可开工程、可走流程」收进 DSH 插件：工具随时可用，预设按需付上下文成本。目录页：https://www.skillhub.cn/plugins/VRChatCN-Kipfel/dsh-vrchat；源码与完整说明：https://github.com/VRChatCN-Kipfel/dsh-vrchat。
