文档库:目录改为编号制(01-规范/02-架构设计/03-数据库/04-调整方案/
05-交接单/06-ops/07-scripts/08-skills/09-archive),顶层散文件归入 01-规范/;
INDEX.md 与 docs-manifest.json 重刷(档案 146 篇);旧目录名引用全量对齐。
IM 线:src/im/**(SDK / hub / store / presence / ws / gateway-token)、
src/web/routes/im.ts、src/db/plugin-data/**、src/supervisor/plugin-assembly.ts
及对应 test/**。
插件线:poc/{im-agent-bridge,im-connection-gateway,im-conversation-tabs,
business-plugins-im,carbon-mcp-probe}、src/web/routes/{sessions,overlay-device}.ts、
src/net/relay/{device-grant,instance-credential}.ts。
仓库卫生:清出 40 个历史误入库 / 已改名文件(34 个交接单归档 + 6 个旧结构,
本地均有副本);dsh-server-docs/.gitignore 补 tmp/;交接单不入库(政策)。
This commit is contained in:
1 parent
3d8f50e366
commit
e6207aa691
239 files changed
+34477
-14633
No files matched your search
+31
-23
@@ -5,19 +5,19 @@
|
||||
> 服务:systemd `dshs`(127.0.0.1:3080)| 现行状态与部署细节见 **`DEPLOY-本部署.md`**
|
||||
|
||||
> ⚠️ **两处 `docs/` 勿混**(档案 19 §C10):
|
||||
> - **本仓库**(`dsh-server-docs`)= **本项目改造文档**(档案 01-53、`ops/`、`scripts/`、`archive/`、`skills/`);
|
||||
> - **本仓库**(`dsh-server-docs`)= **本项目改造文档**(档案 01-53、`06-ops/`、`07-scripts/`、`09-archive/`、`08-skills/`);
|
||||
> - **代码仓库**(`/opt/dshs/docs/`)= **上游 dshs 自带 7 篇**(blueprint / deployment / k8s-deploy …),**不要往里写我们的改造记录**。
|
||||
> 构建/部署/回滚与依赖清单一律看根目录 **`DEPLOY-本部署.md`**。
|
||||
|
||||
## 阅读约定(先读这 7 条,避免歧义)
|
||||
|
||||
0. **首读 `BRIEF.md`**(现状卡):30 秒拿到"现在是什么样、该读哪篇";需要筛档时用 `python3 scripts/docs-manifest.py`(产出机读 `docs-manifest.json`)。
|
||||
0. **首读 `BRIEF.md`**(现状卡):30 秒拿到"现在是什么样、该读哪篇";需要筛档时用 `python3 07-scripts/docs-manifest.py`(产出机读 `docs-manifest.json`)。
|
||||
|
||||
1. **两套编号互不相同**:根级 `01/02/03/06` 是**长期文档**(架构、运维、路线图、UI 规范);`04-调整方案/NN-` 是**一次性改造成档案**。说"档案 NN"时**默认指后者**。
|
||||
2. **单一来源**:**清单与状态 = `INDEX.md` §二**;**待办与优先级 = `03-路线图与待办.md`**;**部署/构建/回滚 = `DEPLOY-本部署.md`**。其余文件提到这些内容时**只做指针,不复制**(历史上 README/INDEX 各存一份清单,已漂移 —— 见档案 53)。
|
||||
2. **单一来源**:**清单与状态 = `INDEX.md` §二**;**待办与优先级 = `01-规范/03-路线图与待办.md`**;**部署/构建/回滚 = `DEPLOY-本部署.md`**。其余文件提到这些内容时**只做指针,不复制**(历史上 README/INDEX 各存一份清单,已漂移 —— 见档案 53)。
|
||||
3. **术语以档案 38b 为准**:统一称「**功能插件**」(早期档案写"业务插件"= 同一事物;历史档案保留原文,不回改)。
|
||||
4. **域名以 `ai1net.com` 为准**:**2026-09-19** 由 `alotbuy.com` 迁入(档案 22 / `ops/域名迁移_ai1net_20260919/`)。早期档案里的 `dsh.alotbuy.com`、`alotbuy.com` 属当时事实,**保留原文**;现行入口一律 `ai1net.com`。
|
||||
5. **AI 默认不读**:`archive/`(历史全文)、`scripts/` `ops/`(工具与配置)、`*.bak*`、`04-调整方案/poc/`(源码)—— 需要时再按需打开。
|
||||
4. **域名以 `ai1net.com` 为准**:**2026-09-19** 由 `alotbuy.com` 迁入(档案 22 / `09-archive/域名迁移_ai1net_20260919/`)。早期档案里的 `dsh.alotbuy.com`、`alotbuy.com` 属当时事实,**保留原文**;现行入口一律 `ai1net.com`。
|
||||
5. **AI 默认不读**:`09-archive/`(历史全文)、`07-scripts/` `06-ops/`(工具与配置)、`*.bak*`、`04-调整方案/poc/`(源码)—— 需要时再按需打开。
|
||||
6. **档案头部格式**:`- 日期:` + `- 状态:`(✅已完成 / 🔄进行中 / ⏸暂缓 / ❌关闭)+ `- 触发:`;正文用「需求 → 改动点 → 验证」三段。
|
||||
|
||||
## 模块一览
|
||||
@@ -25,19 +25,27 @@
|
||||
| 文件 | 内容 | 用途 |
|
||||
|------|------|------|
|
||||
| **`BRIEF.md`** | **现状卡(AI / 人首读)**:现行事实(入口/服务/运行时/隔离/可见面/清理阈值/定时/证书/红线)+ 当前待办 top5 + 高频问题→档案映射 + **4 步读取顺序** | **先看这份**:30 秒对齐现状,再决定读哪篇 |
|
||||
| `01-规划与架构.md` | 背景/现状盘点、总体架构、目录布局、dsh 分层机制、归属矩阵、安全边界(一~五、九章)、架构切换实施记录(十三章) | 理解平台怎么搭的、为什么这样隔离 |
|
||||
| `01-规范/01-规划与架构.md` | 背景/现状盘点、总体架构、目录布局、dsh 分层机制、归属矩阵、安全边界(一~五、九章)、架构切换实施记录(十三章) | 理解平台怎么搭的、为什么这样隔离 |
|
||||
| `DEPLOY-本部署.md` | 本部署说明:拓扑/目录/env 键/依赖版本/脚本族/构建部署回滚三步/红线 | **重建或交接先看这份** |
|
||||
| `02-运维手册.md` | 迁移执行步骤、备份/恢复语义、多用户过渡方案、域名接入、面板反代站点、uid 排障、命令速查(六~八、十二、十四、十五章 + 附录) | **日常操作对照查**:重启/备份/看 token/改 key 流程 |
|
||||
| `03-路线图与待办.md` | 待验证项结论(Open Questions 已实测)、路线图(已完成/待办)、历史决策记录 | 追踪未完成事项与优先级 |
|
||||
| **`06-工作台UI规范.md`** | **前端 UI 强制基线**:设计 Token(色/字/圆角/阴影/间距)、布局框架与滚动规则、页面路由、组件规范(按钮/输入/表格/Tab/卡片/徽章/弹窗/Toast/空状态/分页/评分/图标)、关键交互约定、9 条已知坑与规避 | **开发/改任何前端页面前必读并遵循**(门户页 desktop/admin/skills/plugins + 工作台页);权威源 `mcn-work-shop/docs/工作台UI规范.md` |
|
||||
| `skills/dsh-change-workflow/` | 平台改造工作流 skill(**v2.9.2**):需求识别→调研→规划→开发→验证→归档六阶段 + 红线机制 R1-R11 + 档案模板 + **多任务并行调度协议**(按冲突域定并行度)+ **「三把锁」落地机制**(全局执行锁 / 单级占用锁 / 服务器侧操作锁) | 执行平台功能改造时对照本流程。**同步方向:工作副本在本机 `.workbuddy/skills/`(技能必须本地加载),本目录为服务器归档副本 —— 改动后单向推进来(本机 → 此处),勿反向覆盖** |
|
||||
| `skills/dsh-env-bootstrap/` | 环境引导 / 迁移 skill(**v1.0.4**):把工作区 `CODEBUDDY.md` 的**关键章节**做成技能内**快照**,并给出 `--check`(校验关键规则齐备,默认只报)/ `--inject`(标记块内替换,首次需 `--init`)/ `--env-check`(路径与 hooks 命令自检)/ `--snapshot`(由权威重生成快照) | 换电脑、换工作区路径、新环境初始化时用。**设计红线:权威方向单向(CODEBUDDY.md 为权威,快照为副本),避免造第二真相源** |
|
||||
| `skills/dsh-decision-method/` | **改造决策方法论** skill(**v2.8.0**):决策素材库(用户有效决策 U1-U28 / AI 有效决策 A1-A25 / 反例 X1-X14,已拆到 `references/`)+ **如何确认最优解**(判定矩阵 + 拍板前十问 + 验收口径 L1-L5)+ **技术选型判据轴 §4.6**(⛔ 热度 ≠ 安全/性能;先立轴再排序;必查默认值 + CVE 历史)+ 决策流程十步 + 交互 UI 改造专项清单 + 决策语言对照表 | **先定案再执行**:本技能管「怎么想、怎么定」,`dsh-change-workflow` 管「怎么落地」。素材源 = 本库 68 份改造档案的真实决策痕迹。**同步方向同上(本机 → 此处,勿反向覆盖)** |
|
||||
| `skills/dsh-feature-first/` | **功能优先协作协议** skill(**v1.7.0**):复盘证实「技术类 40% + 报障类 24% 吃掉用户注意力」→ 用户的输入收窄为**功能卡 4 问**;AI 自主决策的 **9 类白名单(永不问)**;只上抛**功能语义分叉与红线门禁**;上抛语言转换表;报障闭环前置五条;交付回执格式(功能性语言优先 + 技术附录折叠);**§5.3 五条铁律 / §5.4 九条硬约束:待确认项 = 回复最后一节、逐条编号、候选竖排成段(不横排)且必须写「优点 / 缺点」** | **改协作方式时对照本协议**:把"事前请示"改成"**默认自主 + 事后可推翻**" |
|
||||
| `skills/dsh-auto-handoff-chain/` | **多棒自动接力编排法** skill(**v1.3.2**):把跨多个上下文窗口的长任务拆成「规划棒 ↔ 执行棒」交替的**一次性自动化链条**,每棒做完自动开新会话接下一棒(零人工点击)。核心 = 六件套 prompt 骨架(状态单点 → 唯一执行依据指针 → 全局锁 → 单一动作 → 成本纪律 → 收尾四件套)+ **登记门禁**(要拍板的先等拍板再登记)+ 五条实测防护(断链 / 双开 / once 不转完成态 / 跨过拍板点 / 下一棒定太晚)+ 复跑脚本 `scripts/chain_report.py` | **跑跨会话长任务时用**:与 `dsh-change-workflow`(单次改造落地)、`dsh-decision-method`(单次取舍)分工互补;唯一执行依据 = 工作区 `接续入口_<线名>_<日期>.md`。**同步方向同上(本机 → 此处,勿反向覆盖)** |
|
||||
| `交接单/` | **规划会话 → 执行会话的任务单**(目标 / 只读前置 / 范围 / 决策点 / 步骤 / 验收 / 回滚 / 回报格式)+ 交接约定 | **要执行某个任务时才读**;单子完成后移入 `archive/交接单-已完成/` |
|
||||
| `01-规范/02-运维手册.md` | 迁移执行步骤、备份/恢复语义、多用户过渡方案、域名接入、面板反代站点、uid 排障、命令速查(六~八、十二、十四、十五章 + 附录) | **日常操作对照查**:重启/备份/看 token/改 key 流程 |
|
||||
| `01-规范/03-路线图与待办.md` | 待验证项结论(Open Questions 已实测)、路线图(已完成/待办)、历史决策记录 | 追踪未完成事项与优先级 |
|
||||
| **`01-规范/06-工作台UI规范.md`** | **前端 UI 强制基线**:设计 Token(色/字/圆角/阴影/间距)、布局框架与滚动规则、页面路由、组件规范(按钮/输入/表格/Tab/卡片/徽章/弹窗/Toast/空状态/分页/评分/图标)、关键交互约定、9 条已知坑与规避 | **开发/改任何前端页面前必读并遵循**(门户页 desktop/admin/08-skills/plugins + 工作台页);权威源 `mcn-work-shop/docs/工作台UI规范.md` |
|
||||
| `08-skills/dsh-change-workflow/` | 平台改造工作流 skill(**v1.0.0**):需求识别→调研→规划→开发→验证→归档六阶段 + 红线机制 R1-R11 + 档案模板 + **多任务并行调度协议**(按冲突域定并行度)+ **「三把锁」落地机制**(全局执行锁 / 单级占用锁 / 服务器侧操作锁)+ **重内容已拆到 `references/`**(00 平台速查 / 01 档案模板 / 02 红线详解-R5-R7-R8 / 03 沙箱与技能机制 / 04 运维锚点与取证 / 05 插件与数据源口径 / 06 实例可见面与共享边界 / 07 并行调度详解 / 08 浏览器验证栈详解,共 9 档) | 执行平台功能改造时对照本流程。**同步方向:工作副本在本机 `.workbuddy/08-skills/`(技能必须本地加载),本目录为服务器归档副本 —— 改动后单向推进来(本机 → 此处),勿反向覆盖** |
|
||||
| `08-skills/dsh-env-bootstrap/` | 环境引导 / 迁移 skill(**v1.0.0**):把工作区 `CODEBUDDY.md` 的**关键章节**做成技能内**快照**,并给出 `--check`(校验关键规则齐备,默认只报)/ `--inject`(标记块内替换,首次需 `--init`)/ `--env-check`(路径与 hooks 命令自检)/ `--snapshot`(由权威重生成快照) | 换电脑、换工作区路径、新环境初始化时用。**设计红线:权威方向单向(CODEBUDDY.md 为权威,快照为副本),避免造第二真相源** |
|
||||
| `08-skills/dsh-decision-method/` | **改造决策方法论** skill(**v1.0.0**):决策素材库(用户有效决策 U1-U28 / AI 有效决策 A1-A25 / 反例 X1-X14,已拆到 `references/`)+ **如何确认最优解**(判定矩阵 + 拍板前十问 + 验收口径 L1-L5)+ **技术选型判据轴 §4.6**(⛔ 热度 ≠ 安全/性能;先立轴再排序;必查默认值 + CVE 历史)+ 决策流程十步 + 交互 UI 改造专项清单 + 决策语言对照表 | **先定案再执行**:本技能管「怎么想、怎么定」,`dsh-change-workflow` 管「怎么落地」。素材源 = 本库 68 份改造档案的真实决策痕迹。**同步方向同上(本机 → 此处,勿反向覆盖)** |
|
||||
| `08-skills/dsh-feature-first/` | **功能优先协作协议** skill(**v1.0.0**):复盘证实「技术类 40% + 报障类 24% 吃掉用户注意力」→ 用户的输入收窄为**功能卡 4 问**;AI 自主决策的 **9 类白名单(永不问)**;只上抛**功能语义分叉与红线门禁**;上抛语言转换表;报障闭环前置五条;交付回执格式(功能性语言优先 + 技术附录折叠);**§5.3 五条铁律 / §5.4 九条硬约束:待确认项 = 回复最后一节、逐条编号、候选竖排成段(不横排)且必须写「优点 / 缺点」** | **改协作方式时对照本协议**:把"事前请示"改成"**默认自主 + 事后可推翻**" ⚠️ **v1.8.0 起**:§2(9 类白名单)/ §3.3(语言转换表)/ §5.4(排版规范)三节已收敛为指向 `agent-operating-rules` 的指针 + 最小兜底摘要(独有内容 §0 / §1 / §4 / §5.1 / §5.2 / §5.3 / §6 全部保留) |
|
||||
| `08-skills/dsh-auto-handoff-chain/` | **多棒自动接力编排法** skill(**v1.7.0**):把跨多个上下文窗口的长任务拆成「规划棒 ↔ 执行棒」交替的**一次性自动化链条**,每棒做完自动开新会话接下一棒(零人工点击)。核心 = 六件套 prompt 骨架(状态单点 → 唯一执行依据指针 → **域锁** → 单一动作 → 成本纪律 → 收尾四件套)+ **登记门禁**(要拍板的先等拍板再登记)+ 五条实测防护(断链 / 双开 / once 不转完成态 / 跨过拍板点 / 下一棒定太晚)+ **§0.6 工作区归属五律**(入口只一份 · `cwds` = 本工作区 · 参考规则用本技能 · prompt 额外 `cd` · 🔴 **`cwds` 只写反斜杠+大写盘符** —— 否则同一工作区在 UI 裂成两个同名分组)+ **§0.7 活库改动铁律**(动 `workbuddy.db` 前先关 app · ⛔ 禁文件级 `cp`/`mv` · 只走 SQL 连接 · 三件套一起备份)+ 复跑脚本 `07-scripts/chain_report.py` | **跑跨会话长任务时用**:与 `dsh-change-workflow`(单次改造落地)、`dsh-decision-method`(单次取舍)分工互补;唯一执行依据 = 工作区 `接续入口_<线名>_<日期>.md`。**同步方向同上(本机 → 此处,勿反向覆盖)** |
|
||||
| `08-skills/dsh-architecture-lifecycle/` | **过程/定稿分层机制** skill(**v1.0.0**):治「架构结论散落在几十份过程档案里、后续会话找不到、同一事实多处打架」。核心 = **两个目录的唯一分工判据**(过程答「怎么想的」/ 定稿答「该做成什么样」)+ 定稿命名 `<对象>-<架构名>.md`(**⛔ 无编号前缀 · 一个目录装全部**)+ **收敛五步**(定位 → **判新旧** → 按架构重组 → 标回溯 → **标未决**)+ 冲突仲裁(**以定稿为准**)+ 过时档案**只加状态块、⛔ 不改正文** + 定稿三道验收(可独立读懂 / 可照此施工 / 可回溯) | **写架构级设计、或要把推演结论定稿时对照本机制**;与 `dsh-knowledge-upkeep`(知识库怎么不变错)互补 —— 后者只定义 L5「过程只增不改」,**未定义「定稿层」**,本技能补 L0.5 定稿层与收敛流程。**同步方向同上(本机 → 此处,勿反向覆盖)** |
|
||||
| `08-skills/agent-operating-rules/` | **AI 会话作业总规矩** skill(**v1.0.0**):跨工作区通用的会话级规则集 —— 上抛唯一判据(边界内自决 / 边界外八类)、**回复排版契约**(结论先行 · 层级 ≤3 · 每节 ≤7 行 · 待拍板项落最后一节且候选竖排成段)、**§2.5 去 AI 味**(说话要像人,含语言组织与排版)、工作区归属三律、一把锁纪律、落位·提交·批量红线、交付门禁、多棒自动接力、环境陷阱速查、**§10.1 技能要不要合并的判据**、**§10.2 机制扩面后必须清退绕行方案**;重内容已拆到 `references/`(01 协作与上抛判据 / 02 工作区纪律 / 03 多棒接力编排 / 04 去AI味与说话方式) | **任何工作区开工前加载**:管「怎么想、怎么说、怎么不越界」,与 `dsh-change-workflow`(怎么落地)、`dsh-decision-method`(怎么定案)分工互补。**⛔ 本技能零硬编码路径,加载后不读取任何具体工作区文档 ⇒ 不影响其他工作区**。**同步方向同上(本机 → 此处,勿反向覆盖)** |
|
||||
| `08-skills/dsh-desktop-dev-shell/` | **在 Windows 上跑起官方 dsh 并做真跑验证** skill(**v1.0.0**):覆盖**两个形态** —— ① web 实例(`apps/cli` 的 `dsh --profile web`:起实例 / 回环监听 / token+cookie jar 取 200 / 探测 Windows 沙箱后端)② 桌面壳(`apps/desktop` 源码构建:pnpm 卡安装真根因 / Electron 参数与 `--no-sandbox` 判据 / CDP 真跑取证 / 离线可用验证)。两形态共用判据链(**Node 22** · 监听≠就绪 · 陈旧写锁致永久起不来)。另含 Electron 沙箱 ACL 组件级探针、`safe-delete` 护栏、假红防治(判据写窄)。 | **在 Windows 本机验官方 dsh 时用**;原 `dsh-windows-run-web-instance` 已于 v2.0.0 并入本技能(§11)。**同步方向同上(本机 → 此处,勿反向覆盖)** |
|
||||
| `08-skills/dsh-instance-diagnose/` | **单个用户实例故障诊断** skill(**v1.0.0**):当出现「实例打不开 / 实例起不来 / 实例挂了·崩了·一直重启 / 报 503·502 / 会话突然报错中断 / 跑着跑着断了 / 响应慢 / 怀疑内存不够」时用。核心 = 第 0 层**跨机日志取证**(dshlog)→ 分「服务级 / 实例级 / 会话级」三层定位 → **cgroup 内存三件套**定量归因 → **隔离 cgroup 内复现**(⛔ 绝不在生产实例上做压力测试);含 4 条死亡路径与分诊判据。 | ⚠️ **与 `dsh-desktop-dev-shell` 的边界**:本技能管**服务器上的用户实例**(含平台代理层);「**本机** dsh 实例起不来」(在 Windows 上跑官方 dsh 源码)属对方。**同步方向同上(本机 → 此处,勿反向覆盖)** |
|
||||
| `08-skills/dsh-knowledge-upkeep/` | **知识库 / 文档维护与纠偏方法** skill(**v1.0.0**):当发现「文档与现状不符」「同一事实多处打架」「知识越积越碎」「AI 忘了某条规则」「要收敛或重构知识库结构」时用。核心 = **六层知识结构 L0-L5**(含 L0.5 架构定稿)+ **分层判据(实体 vs 指针)** + **Lint 四件套**(可复跑、退出码可接 CI)+ **漂移处理 SOP 五步** + **自动化的边界**(检测可自动、改写不可自动)+ **§8.6「注入预算」**(每轮注入有上限 ⇒ 长文件后半段等于不存在;先重排后删减)+ **§9 技能集可用性体检(10 层取证法)** + **§10 技能重组:千行技能拆分(主干 + `references/` + `07-scripts/split_skill.py`)**。 | **定期体检知识库、或怀疑"规则写了但没生效"时用**;与 `dsh-architecture-lifecycle` 互补(后者补 L0.5 定稿层与收敛流程)。**同步方向同上(本机 → 此处,勿反向覆盖)** |
|
||||
| `08-skills/dsh-opensource-release/` | **开源导出与版本迭代** skill(**v1.0.0**):把私有代码仓导出成可公开的开源副本 —— **脱敏**(含"曾用名必须在 `LEAK_PROBES` 里"的教训:探针只探最老名字会漏中间名)+ **去插件 / 分层授权**(`LICENSE` 原样 + `COMMERCIAL-LICENSE.{md,zh-CN.md}` 两条平行许可各自成文件,⛔ 不给 AGPL/MIT 附加限制)+ **重写说明文档** + 按 commit 取树避免混入并行会话未提交的改动 + 发布前阻断性探针 + **重内容已拆到 `references/`**(01 保留移除与脱敏口径 / 02 多远端推送 / 03 实测坑 / 04 交互式图示-archify / 05 已知待办与漂移,共 5 档)。 | **说「开源一份」「导出到 GitHub / CNB」「发新版本」「开源那份同步一下」时用**。⚠️ 唯一例外:`dsh-univer-office` 经特许保留原名。**同步方向同上(本机 → 此处,勿反向覆盖)** |
|
||||
| `08-skills/dsh-plugin-diagnose/` | **业务插件故障诊断** skill(**v1.0.0**):专治「工具能用但浏览器里什么都没有」这类**静默失败** —— 当出现「插件没 UI / 预览不出现 / 卡片不渲染」「装了插件但界面没变化」「导入导出报 GLIBC 版本」「网关崩了但数据其实写进去了」「改了包上传了还是老行为」时用。核心 = 先按 **host 半边 / client 半边 / 网关·原生绑定** 三层归属定位,再用「**inject 差集**」「**glibc 直测**」「**产物插探针**」三把尺子取证(每次都要有可复现命令);含「同 version 号不会被重装 ⇒ 改代码必升 version + 内容门禁」等实测坑。 | ⚠️ **与 `dsh-desktop-dev-shell` 的边界**:本技能管**服务器实例里的插件**;本机源码壳里挂插件不出现属对方。**同步方向同上(本机 → 此处,勿反向覆盖)** |
|
||||
| `05-交接单/` | **规划会话 → 执行会话的任务单**(目标 / 只读前置 / 范围 / 决策点 / 步骤 / 验收 / 回滚 / 回报格式)+ 交接约定 | **要执行某个任务时才读**;单子完成后移入 `05-交接单/` |
|
||||
| `04-调整方案/` | 每个功能改造一份档案:需求 → 改动文件 → commit → 验证结果 | **核对用**:某功能当时怎么改的 |
|
||||
| `archive/` | `dsh-improvement-plan-20260909-full.md`:拆分前的 19 章完整时间线归档 | 保留历史全文,防拆分遗漏 |
|
||||
| `02-架构设计/` | **已定稿的架构设计**(一个目录装全部架构,文件名=架构名):当前 = `覆盖网络-顶层架构全貌.md`(两图分离 · 三层权威 · 多根与角色升格 · 缺口与推进序)。**与 `04-调整方案/` 的分工 = 过程 vs 成品**:那目录答「为什么这么做」(调研/推演/取证/权衡,会过时),本目录答「现在该做成什么样」(收敛后可施工,不轻易变);**两者冲突以本目录为准** | **想施工 / 想理解全局时读这份**;`04-调整方案/` 只用来追根因与看证据 |
|
||||
| `09-archive/` | `dsh-improvement-plan-20260909-full.md`:拆分前的 19 章完整时间线归档 | 保留历史全文,防拆分遗漏 |
|
||||
|
||||
`04-调整方案/` 档案清单:
|
||||
|
||||
@@ -52,7 +60,7 @@
|
||||
| `08-实例常驻上限与单活跃会话.md` | —(回收+last-wins 落地) | 928dde1 + 6336c53 |
|
||||
| `09-普通用户隐藏模型设置-角色化profile-patch.md` | —(cordis patch disable 裁剪 client 插件,`ensure-role-profile-patch.cjs`) | —(工具脚本,2026-09-09 落地) |
|
||||
| `10-共享技能只读部署-bundledSkillDir.md` | —(调研分析 + 实施:编排器 env 注入 + 共享只读目录,dsh 全员可见只读技能层) | —(已实施 2026-09-09;管理面见 11) |
|
||||
| `11-技能管理面-shared+mine-API与页面.md` | —(管理面:编排器新增 `/api/skills/{shared,mine}` + `/skills.html`;**v2 = zip-only 两阶段替换**:上传检测→同名提示确认→apply 全量替换) | —(已实施 2026-09-09,v2 同日) |
|
||||
| `11-技能管理面-shared+mine-API与页面.md` | —(管理面:编排器新增 `/api/08-skills/{shared,mine}` + `/skills.html`;**v2 = zip-only 两阶段替换**:上传检测→同名提示确认→apply 全量替换) | —(已实施 2026-09-09,v2 同日) |
|
||||
| `12-VoxEMW全云API化接入dsh-调研与M1落地.md` | —(外部产品插件化调研 + 云 API 方案:VoxEMW 魔镜 → dsh-plugin-voxemw-cloud) | —(本地插件 v0.1.0 已实现,2026-09-10;云端链路待接线验证) |
|
||||
| `13-登录直达冷启动竞态404修复.md` | —(登录直达冷启动竞态:enter 等 launch token 到位再返回 URL) | fa718d2 |
|
||||
| `14-实例会话敏感信息暴露面审计与加固.md` | —(读取→留存→外传链路审计;uid 段收敛 [100000,199999] + nftables 出网护栏封元数据端点/观测外联) | —(已上线 2026-09-10,`dsh-egress.service` enabled+active) |
|
||||
@@ -86,14 +94,14 @@
|
||||
## 使用约定
|
||||
|
||||
- **新增改造**:按主题写进对应文件;功能类改造在 `04-调整方案/` 新建档案(编号递增,**复跑取号勿写死**:`ls 04-调整方案/ | sort -n | tail -1`;**63 为空号,勿补占**),模板 = 需求 → 改动点表 → 验证结果。
|
||||
- **规范/基线类**(跨页面长期生效)→ 根级编号文档(`06-工作台UI规范.md`),**不入 `04-调整方案/`**。
|
||||
- **工作区根批量入仓(2026-09-17)**:工作区根尚未入仓的项目文档已一次性归位 —— 16 份方案 / 评估 / 复盘 / 规范类 → `04-调整方案/113–128`;13 份交接单 → `交接单/archive/交接单-已完成/T09–T21`;运行态指针(`接续入口_*` / `接续包_*`)→ `ops/`;临时与内部简报 → `archive/`。**档案清单仍以 `INDEX.md` §二 为单一来源**(本文件的 01–26 表按上条约定不新增行)。
|
||||
- **前端页面改动**:先读 `06-工作台UI规范.md` 再动手;视觉判断辅以 `.workbuddy/skills/impeccable`(Operate 模式)与 `taste-skill`(反 AI 味),**冲突时以 `06` 的实测 Token 为准**。
|
||||
- **排障**:追加进 `02-运维手册.md` 排障小节。
|
||||
- **自查**:归档/改动文档后跑一次 `python3 scripts/docs-audit.py`(歧义/悬空引用)与 `scripts/docs-manifest.py`(刷新机读清单)(编号冲突 / 标题号不符 / 悬空引用 / 重复 / 体量)——**编号冲突与悬空引用会让它退出码非 0**。
|
||||
- **01-规范/基线类**(跨页面长期生效)→ 根级编号文档(`01-规范/06-工作台UI规范.md`),**不入 `04-调整方案/`**。
|
||||
- **工作区根批量入仓(2026-09-17)**:工作区根尚未入仓的项目文档已一次性归位 —— 16 份方案 / 评估 / 复盘 / 规范类 → `04-调整方案/113–128`;13 份交接单 → `05-交接单/T09–T21`;运行态指针(`接续入口_*` / `接续包_*`)→ 当时入 `06-ops/`(**2026-09-23 再归置**:两份覆盖网络接续件 + 域名迁移目录 → `09-archive/`);临时与内部简报 → `09-archive/`。**档案清单仍以 `INDEX.md` §二 为单一来源**(本文件的 01–26 表按上条约定不新增行)。
|
||||
- **前端页面改动**:先读 `01-规范/06-工作台UI规范.md` 再动手;视觉判断辅以 `.workbuddy/08-skills/impeccable`(Operate 模式)与 `taste-skill`(反 AI 味),**冲突时以 `06` 的实测 Token 为准**。
|
||||
- **排障**:追加进 `01-规范/02-运维手册.md` 排障小节。
|
||||
- **自查**:归档/改动文档后跑一次 `python3 07-scripts/docs-audit.py`(歧义/悬空引用)与 `07-scripts/docs-manifest.py`(刷新机读清单)(编号冲突 / 标题号不符 / 悬空引用 / 重复 / 体量)——**编号冲突与悬空引用会让它退出码非 0**。
|
||||
- **保留原章节编号**(如"十六、"):方便与 archive 完整版对查。
|
||||
- **同步**:本机 `D:\github\dsh_shenxian\dsh-server-docs\` ↔ 服务器 `/opt/dsh/docs/` 整目录镜像,改完即 scp(服务器侧档案 `chmod 600` 保持 root-only,README 保持 644)。
|
||||
- **对账**:`bash scripts/docs-sync-check.sh`(工作区 `scripts/`,2026-09-10 落地)一条命令输出「一致 / 内容不一致 / 仅本地待推送 / 仅服务器待拉取」,退出码 0=全绿;加 `--push` 一键推送本机变更(档案 600 / README 644 自动设权)。
|
||||
- **对账**:`bash 07-scripts/docs-sync-check.sh`(工作区 `07-scripts/`,2026-09-10 落地)一条命令输出「一致 / 内容不一致 / 仅本地待推送 / 仅服务器待拉取」,退出码 0=全绿;加 `--push` 一键推送本机变更(档案 600 / README 644 自动设权)。
|
||||
- **定位**:先查 `INDEX.md` 的场景速查表(编号规则见「阅读约定」第 1 条)。
|
||||
|
||||
## 目录内其他文件(服务器侧)
|
||||
|
||||
Reference in new issue
Block a user