@local/rimworld-log
针对 RimCrow 安装的只读 RimWorld 游戏日志分析，以及 Combat Extended 兼容性参考：包括扫描工具、/rimlog 命令、编辑器下方的源选择器和 COMBAT_EXTENDED.md。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Jzc1098/rimworld-log-plugin#f89051a6006b498569cc7920a0688dfbaf9b93a8Rimworld Log 以 @local/rimworld-log 发布，当前版本为 1.6.9。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
中文 · English
Ludeon notice
Portions of the materials used to create this content/mod are trademarks and/or copyrighted works of Ludeon Studios Inc. All rights reserved by Ludeon. This content/mod is not official and is not endorsed by Ludeon.
A read-only DSH (DeepSeek Harness) plugin that reads and pre-clusters RimWorld game logs (RimCrow recommended), hands the findings to the current agent session, and lets the model pinpoint mod conflicts, crash causes and frame drops. It never modifies the game or the mod list.
| It does | It does not |
|---|---|
| Read RimCrow realtime logs / Player.log, cluster errors and warnings | Modify RimWorld or ModsConfig.xml |
| Attribute a problem to a specific mod with evidence and samples | Enable or disable mods for you (it prints the list; you tick the boxes) |
| Draft and audit fix patches (XML patches, Harmony DLL workspaces) | Download or distribute any third-party mod content |
| Snapshot and verify the workspace, export a migration pack | Upload any log or file anywhere |
| Required / optional | What |
|---|---|
| Required | DSH (DeepSeek Harness) desktop, working |
| Required | Node.js 20+ and pnpm (to install the one runtime dependency) |
| Optional | RimCrow: with it the logs are structured JSON and analysis quality improves a lot |
| Optional | Plain Player.log works without RimCrow, with less information |
Check my environment: Node version, whether pnpm is available, DSH version,
whether RimCrow is installed, and where RimWorld lives.
Give me one runnable install command for anything missing — don't just describe it.
In the repository root:
pnpm install
(No pnpm? use npm install.)
Why: the plugin exports
Config(a Schemastery schema for DSH row config), so it needs the public npm packageschemasteryat runtime. Without it, installing the plugin fails withERR_MODULE_NOT_FOUND. After the install,node_modules/schemasteryshould exist.
Paste this into DSH, replacing the path with your absolute clone path:
Install this directory with plugin_manager install_bundle: <absolute path to this repository>.
Report the result (applied / failed with the original text) and remind me to restart DSH.
Do not hand-edit the profile's
package.jsonorcordis.patch.yml, and do not runpnpm installinside the profile directory.
Quit the DSH process and start it again (the module cache is keyed by package, not by row).
Run rimworld_plugin_guide action=usage to confirm the tools are registered,
then rimworld_log_scan action=detect to confirm the logs are reachable,
then analyze the most recent game log and report only new ERRORs with their owning mod.
rimworld_log_scan (analysis)action | What it does |
|---|---|
analyze (default) | Cluster errors/warnings, attribute them to mods, show evidence and samples; compact=true gives one line per cluster (engine frames folded); ignore filters known noise |
detect | Environment and log-source inventory (profile, log files, enabled mods, cost/benefit per source) |
grep | Search the raw log by substring or /regex/; context=0..3 includes neighbouring lines |
mods | Draft an enable/disable list (draft only, never writes) |
mods-changed | Mods updated/added/removed in a time window (directory mtime + About version vs baseline) |
diff | This session vs the previous one: new / gone / count changes |
patchaudit | Workspace sources vs deployed DLLs: hash and mtime comparison |
aboutcheck | Six About.xml checks (structure, bare &, description type, BOM/mojibake) |
rimworld_workspace_archive (archive)list / snapshot (keeps the newest three days) / export (migration pack, newest snapshot only) /
verify (snapshot vs workspace, file by file) / note (write an archive record and snapshot).
rimworld_plugin_guide (self-report)report / usage (generated live from the tool registry) / since / config (effective settings and
the origin of each value).
rimworld_plugin_compare (block comparison)Compare this plugin against another copy, block by block (it does not decide which one is newer).
/rimlog and /rimmods.
After installing and restarting, Settings → “RimWorld 日志” (a page of its own, below the agent-preset section) exposes seven keys that can be edited directly.
Priority (highest first):
~/.dsh/rimworld-log/settings.jsonTwo honest notes: saving requires a DSH restart to take effect (the loaded host half does not hot-reload configuration), and environment variables always win.
| Variable | Purpose |
|---|---|
RIMWORLD_DIR | RimWorld install root (contains Data/, Mods/) |
WORKSHOP_DIR | Steam Workshop content …/workshop/content/294100 |
RIMCROW_HOME | RimCrow install root (when not in the default place) |
CE_MOD_DIR | Combat Extended mod directory (used by the CE diagnostic scripts) |
VISUAL_EXCEPTIONS_DLL | VisualExceptions DLL path (used by tools/probe-ve.mjs) |
DSH_RIMWORLD_PATCH_DIR | Where generated patches go (default ~/.dsh/rimworld-log/patches) |
RIMLOG_WORKSPACE_DIR | Workspace directory (source of snapshots and archives) |
RIMLOG_STATE_DIR | Plugin state directory (default ~/.dsh/rimworld-log) |
RIMLOG_SNAPSHOT_DIR | Snapshot directory (default snapshots/ beside the workspace) |
RIMLOG_AUTO_ARCHIVE=0 | Disable the automatic archive note after an analysis |
Paste this into DSH when the tools do not load or the settings page is missing:
Troubleshoot: first check plugin_manager list_plugins for rimworld-log and show the original error;
then confirm node_modules/schemastery exists in the plugin directory (if not, pnpm install);
then confirm I restarted DSH.
Checklist:
node_modules/schemastery exist in the plugin directory? If not, step 1 was skipped.rimworld-log enabled or failed in list_plugins? Read the diagnostic text when it failed.rimworld_plugin_guide action=config; if it
prints the settings, the host half is fine and only the page registration failed — report it with
your DSH version.rimworld_log_scan action=detect and check the profile and log paths.Remove the rimworld-log plugin with plugin_manager; tell me whether the folder and the
~/.dsh/rimworld-log state directory should be deleted, and let me decide.
Deleting ~/.dsh/rimworld-log also removes the incremental cursors, the mod version baseline and an
optional settings.json.
The documents below are Chinese for now (this README is the only bilingual one):
| Document | For whom |
|---|---|
| 使用参考.md | Users: one-line prompts you can copy into DSH |
| 安装说明.md | Full install, confirmation, troubleshooting, uninstall |
| COMBAT_EXTENDED.md | Combat Extended compatibility reference (decision rules, four patch types, verified pitfalls, vehicles) |
| 块功能介绍.md | Block registry, block comparison and selective import (maintainers) |
| 插件清单.md | What every file does, which ones are safe to delete |
| HISTORY.md | Cumulative version history |
| RELEASE.md | How to build a delivery package (maintainers) |
v1.6.9 — first public version. History in HISTORY.md.