dsh_ai1net_server/dsh-server-docs/INDEX.md

# dsh 平台文档导航（INDEX）









> **首读 `BRIEF.md`（现状卡）**：30 秒对齐现行事实；本文件只管"定位篇目 + 状态"。




> **双端模型**：本机 `D:\github\dsh_shenxian\dsh-server-docs\`（**工作树**，git 仓库 `dsh_shenxian_doc`）↔ 服务器 `/opt/dsh/docs`（**部署镜像**，root 600，**无 .git**，靠 scp）。




> **对账**：`bash scripts/docs-sync-check.sh`（退出码 0 = 全绿）。




> **最后核对**：2026-09-12 — **篇数与规模不在此写死**：本库由多会话并行改动，绝对值数十分钟即失效（同日实测 83 → 85 → 87，3 次作废）；**一律以 `python3 scripts/docs-manifest.py` 复跑结果为准**。代码 HEAD 看服务器：`git -C /opt/dshs log -1`（最后核对值 `ebe8075`）。域名 `alotbuy.com`（旧域 `dsh.alotbuy.com` 已 301）。









---









## 一、按场景快速定位









| 我要做什么 | 先读 |




|---|---|




| **访问入口（当前域名）** | 门户 `https://alotbuy.com`；用户实例 `https://<用户名>.alotbuy.com` ｜ `04-22`（迁移+回滚） |




| **重建 / 交接部署** | **`DEPLOY-本部署.md`**（拓扑·目录·env·依赖·脚本族·构建/部署/回滚） ｜ 档案 19 §C9 |




| 理解架构 / 多租户隔离 | `01-规划与架构.md`（一~五、九、十三） ｜ `archive/` 全文 |




| 日常运维（重启/备份/token/KEY/排障） | `02-运维手册.md` ｜ `03-路线图与待办.md` |




| **做一次平台改造（完整流程）** | **`skills/dsh-change-workflow/SKILL.md`**：六阶段 + **红线 R1-R11** + 档案模板 + 并行调度协议 |




| **开源导出 / 发新版本** | **`skills/dsh-opensource-release/SKILL.md`**：五条硬规则 R-O1–R-O5（源仓库只读 / 探针 0 命中 / 去插件 / 不带文档与 skill / 分层授权）+ 脱敏映射表 + **迭代 SOP** + 验证六件套；产物在本机 `_开源导出_20260913/` |




| **排查业务插件故障（没 UI / 装不上 / 改了没生效）** | **`skills/dsh-plugin-diagnose/SKILL.md`**：三层归属 + 三把尺子（inject 差集 / glibc 直测 / 产物插探针）|


| **换电脑 / 改了工作区路径，规则会不会丢** | **`skills/dsh-env-bootstrap/SKILL.md`**：常驻规则快照 + `--check` 校验 / `--inject` 注入 / `--env-check` 环境自检（默认只报不改）|
| **跑跨会话长任务（自动接力）** | **`skills/dsh-auto-handoff-chain/SKILL.md`**：六件套 prompt 骨架 ＋ 登记门禁 ＋ 五条实测防护 ＋ 复跑脚本 `scripts/chain_report.py` |
| 看还有什么没做完 | `03-路线图与待办.md` §二 ｜ **`交接单/README.md` §一**（已规划待执行） |




| **改前端页面（强制基线）** | **`06-工作台UI规范.md`** |




| **改实例 UI 分区（设置面板）** | **`07-实例UI分区登记表.md`**（哪个包提供 / 源码在哪 / 能不能改）+ `06-工作台UI规范.md` |




| 红线与硬约束 | `README.md` §红线（含 **R7 禁批量全仓写入**、**R8 中断用户须先知会**）｜ `04-07` |




| **插件兼容性预检（导入/上传即判定）** | **`04-71`**（判据 + PoC + 三层防线）｜**`交接单/T05`**（执行单）｜`scripts/plugin-compat-check.mjs`（可在服务器直接跑） |




| **实例崩溃循环 / 插件不兼容** | `04-70`（anysearch 与 dsh-llm `assertNever` 不兼容；判据「重启后错误是否变化」）｜`04-20`（自愈熔断）｜`04-25`（崩溃循环前例）｜`02 §C.4` |




| **锁机制（防并行冲突）** | **`04-73`（强制钩子）｜`04-69`（三把锁建立）**｜`交接单/README.md` §一·§三·§六｜`scripts/{handoff-guard.sh,op-lock.sh,lock-guard-hook.py}` |




| **多会话并行 / 冲突治理** | **`04-69`**（两级文档锁 + 服务器侧操作锁 + commit 常态化）｜`交接单/README.md`（占用锁 / 写者归属 / §六 服务器侧锁）｜`scripts/handoff-guard.sh`、`scripts/op-lock.sh` |




| 插件管理面 | `04-16`（三层归属）｜ `04-31`（门户双 Tab）｜ `04-57`/`04-60`（设置面板分区） |




| **搜索 provider / 联网搜索** | `04-64`（接入 AnySearch）｜`04-65`（启停与 web provider 联动）｜`04-66`（P0 误报与 admin 显式信任） |




| **「能力管理」section UI** | `04-67`（按 UI 规范重做）｜`04-36`/`04-38b`（分区铺开 / 术语统一）｜`04-68`（启停属主污染根治）｜**`04-100`（「我的技能」分组 · 09-15）**｜**`04-101`（改名「能力管理」+ tab 分页 + 卡片三行 + DeepSeek 改名 · 09-15）** |




| 安全 / 暴露面 | `04-14`（出网护栏）｜`04-39`（可见面收窄·封 loopback）｜`04-41`（上传加固） |




| 技能共享层 / 管理面 | `04-10`（bundledSkillDir）｜`04-11`（API+页面）｜`04-40`（挂载修复） |




| 会话/登录跳转 · 断连恢复 | `04-13`（冷启动 404）｜`04-24`（实例侧 401）｜`04-49`（回收后反馈）｜`04-51`（401 透明重放）｜**`04-72`（回收/关闭后回到页面自动唤醒）** |




| 实例易用性 | `04-45`（老会话档位提示）｜`04-56`（实例助手）｜`04-59`（启动动画） |




| 实例资源 / 配额 | `04-58`（内存口径 + 配额 384M）｜`04-38a`（边界：无磁盘配额） |




| VoxEMW | `04-12`（摘要）｜ `archive/工作区草案/` 两份全文 |




| 历史全量时间线 | `archive/dsh-improvement-plan-20260909-full.md` |









---









## 二、全量清单









> **状态摘要**（**机器生成，勿手改**）：档案 **115** 份（`04-*`），另含根级编号 5 条（01/02/03/06/07），另有非编号行 14 条（README / INDEX / 技能 / poc 等）—— ✅ 16 ｜ 🔄 5 ｜ 🔍 1 ｜ 📋 22 ｜ 未标记 76。复跑 `python3 scripts/docs-index-stats.py` 取数，`--write` 就地刷新本行。
> **分层与机读明细**（路径 / 日期 / 字符数 / 被引次数 / tier，可 `jq` 先筛后读）：**`docs-manifest.json`**；复跑 `scripts/docs-manifest.py` 即刷新。




> 图例：✅已落地 ｜ 🔄维护中 ｜ 🧪PoC ｜ 📝待开发 ｜ 🔍核查完成 ｜ 📋评估 ｜ 🟡保留兜底 ｜ 🗄归档｜🔧修复｜🔴｜🚧｜❓





| 号 | 状态 | 一句话 |




|---|---|---|




| README | 🔄 | 文档库总说明、模块一览、红线、使用约定（**档案清单唯一来源**）|




| INDEX | 🔄 | 本文件：场景速查 + 状态总览 |




| 01 | ✅ | 背景/架构/目录布局/dsh 分层/归属矩阵/安全边界 |




| 02 | ✅ | 迁移、备份恢复、域名接入、uid 排障、命令速查（**正文为历史，现行以附录 C 为准**）|