nav: 导航页全部改用 Markdown 相对链接(Gitea / GitHub 可点击)

问题:UDAS 主线规则强制 WikiLink,但 WikiLink 在 Gitea / GitHub Web
渲染为纯文本不可点 —— 团队在那两处浏览必须"翻文件目录"才能进文档。

规则更新(已写入 SKILL.md WikiLink 章节):
- 知识内容(concepts / scenarios / procedures / decisions / faq / glossary):
  继续用 [[...]] WikiLink(驱动 Graph View、位置无关)
- 导航页(任何 index.md、所有 maps/*.md):改用 [文本](相对路径.md)
  Markdown 链接 —— 三平台(Obsidian / Quartz / Gitea)都可点
- ![[...]] embed 可保留,但导航页必须同时配 [查看 X](path/to/X.md) 降级链接

本次改动:
- 顶层 index.md:6 域入口表 + embed + 降级链接
- maps/domain-map.md:6 域表(双链:域首页 + 域知识地图)
- cross/index.md:8 共享概念表 + embed + 降级链接
- cross/maps/cross-domain-map.md:8 概念表 + 编排场景预告
- prop-acc/index.md:7 子模块进度表(链 adhoc 深度图)+ embed + 降级 + 跨域链
- 4 新域 index.md + maps/knowledge-map.md(community/administrative/patrol/
  resident-portal):统一模板,子模块行占位,跨域共享 8 链

prop-acc 知识地图拆分:
- 原 maps/knowledge-map.md 内容(adhoc 子模块的 25 场景 + 3 概念)
  git mv → maps/adhoc-knowledge-map.md(子模块深度图)
- 新建 maps/knowledge-map.md(prop-acc 域总图,7 子模块表)
- 配合 SKILL.md 多域子模块规则 S-5:子模块数 > 3 或单子模块文档 > 20 时
  另建子模块深度图

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Willie
2026-05-25 21:46:28 +08:00
parent c08aa47dbd
commit 83b4e0277c
14 changed files with 333 additions and 173 deletions

View File

@@ -12,25 +12,38 @@ last_review: 2026-05-25
# Uniprop 知识库
物业管理 SaaS 平台的多业务域知识库。
物业管理 SaaS 平台的多业务域知识库。按 UDAS v1.0(多域 + 子模块扩展)架构组织 —— 每个业务域独立一套 10 标准目录,跨域协作集中在 `cross/`
按 [UDAS v1.0(多域扩展)](https://github.com/anthropics/) 架构组织 —— 每个业务域独立一套 10 标准目录,跨域协作集中在 `cross/`
## 业务域入口
## 业务域
| 域 | 中文 | 入口 | 状态 |
|---|---|---|---|
| prop-acc | 物业财务 | [prop-acc 域首页](prop-acc/index.md) | 一次性收费已完成 |
| community | 社区管理 | [community 域首页](community/index.md) | 🚧 |
| administrative | 行政人事 | [administrative 域首页](administrative/index.md) | 🚧 |
| patrol | 巡护工单 | [patrol 域首页](patrol/index.md) | 🚧 |
| resident-portal | 业户门户 | [resident-portal 域首页](resident-portal/index.md) | 🚧 |
| cross | 跨域协作 | [cross 协作中心](cross/index.md) | 8 个共享概念 stub |
## 顶层导航
- [业务域索引](maps/domain-map.md) — 6 域详情
- [跨域协作地图](cross/maps/cross-domain-map.md) — 共享概念 + 跨域编排
## Obsidian 内联视图
![[domain-map]]
## 跨域协作
- [[cross-domain-map|跨域协作地图]] — 共享概念 + 跨域编排场景
- [[cross · 跨域协作(中心)|cross 协作中心]] — 8 个跨域共享概念入口
[查看完整域索引(Gitea / GitHub 可点)](maps/domain-map.md)
## 编辑约定
- **新建文档**:先确定归属域(单域内容 → 该域;跨 2+ 域内容 → `cross/`),再选类型目录(concepts / scenarios / 等)
- **新建文档**:先确定归属域(单域内容 → 该域;跨 2+ 域内容 → `cross/`),再选类型目录(concepts / scenarios / 等),最后判定是否启用子模块嵌套
- **文件命名**:英文 kebab-case,不带版本/日期后缀
- **frontmatter**:必含 `title`(域前缀 `<domain> · <名>`) / `tags` / `status`(中文枚举)
- **WikiLinks**:纯名称,禁止路径式
- **frontmatter**:必含 `title`(域前缀 `<domain> · <名>`)`tags``status`(中文枚举)
- **WikiLinks**:仅用于知识内容互引(concepts / scenarios / procedures / ...)
- **导航页**(任何 `index.md` / `maps/*.md`):用 Markdown 相对链接,确保 Gitea / GitHub 可点
- **跨域文档**:frontmatter 必须有 `involves: [域名]`
- **子模块文档**:frontmatter 必须有 `sub_feature: <name>`
详细规范见仓库 `README.md`(待补)或参考 UDAS 文档。
详细规范见仓库 `README.md`(待补)或 UDAS skill 文档。