园丁手册

花园宣言 回答「为什么」；这份手册回答「怎么做」：范围在哪、往哪长、最终长成什么样、每天的活怎么干。入口是首页 index.md（公开站即 www.digiinfr.com/kb）。它总结自第一版 61 篇笔记的实际经验，供所有后续耕耘者统一风格参照。手册本身也按花园的规则生长：发现更好的做法就改，并说明为什么。

园内怎么互链

园内互链只用 Obsidian 双链，以能命中现有文件名为准：

• 笔记：[[什么是资产]]
• 导览：[[导览/资产管理者之路]]、[[导览/设备维保之路]]、[[导览/数字化建设者之路]]
• 显示文字与文件名不同时：[[投资规划的两种模式|投资规划模式]]
• 后缀说明放在双链外面：[[资产合规与穿透式监管]]（种子）

首页是唯一的例外，不要写 [[index]]：index.md 被发布器映射为站点根，双链转出来的地址在公开站 404。提到首页时写 index.md（给园丁看）或完整 URL（给读者看）。

禁止下面这种相对路径（公开站会把它收成不可点纯文本，本页图谱也认不出邻居）：

[什么是资产](../笔记/什么是资产.md)

真正的站外 URL 仍用 Markdown，例如 无边界技术。

一、范围：收什么，不收什么

花园关心三件事：资产管理、工业物联、设备维保服务。一篇内容是否收录，依次问四个问题：

1. 是业务的方法与道理吗？ 收方法、原理、坑与判断依据；不收任何软件产品的功能介绍与操作说明。源材料若混着两者（实施手册常如此），把业务逻辑萃取出来，把「在系统里点哪个按钮」留在门外。
2. 对三类读者有用吗？ 资产与设备的实践者、财务与合规人员、数字化建设者。三类人都用不上的，不收。
3. 能讲成一个概念吗？ 能，就写成笔记；不能拆清楚，先作为种子收进来，注明还没想清什么。
4. 敢公开吗？ 花园发布在外网。案例隐去可识别的企业与个人；不夹带推销；引用注明出处。

边界地带照收，但写明角色。 花园以「资产的完整生命周期」为经线，而生命周期的不少环节不由资产管理部门主导：投资规划在规划部，项目转固在项目部和财务，采购在供应链。这些内容照收——它们决定了资产部门日后接手的是什么——但笔记里必须写清谁主导、资产管理者的接口在哪（参照「投资规划与立项」「从项目到资产」两簇的写法），不让读者误以为这是自己的流程。

不要从这些目录抄进公开 Wiki： 公司作业规范、网络热门趋势（含代充）、客户与项目、官网博客。不要写客户名和内部作业。

二、形态：现在与将来

三层结构

• 导览（导览/）：按读者角色铺的路，串起笔记的阅读顺序。路是走出来的：先观察读者常问什么，再铺新路，不预设。
• 笔记（笔记/）：扁平目录，一篇一概念，靠链接与标签组织。这是花园的主体。
• 专题参考（未来）：当某簇果实足够密，沉淀成体系化长文或白皮书——完整的实践参考、行业专篇、案例集。它们由笔记聚合而成，不替代笔记。

花园目前只保留这些：index.md（首页）、花园宣言、导览/（三条路）、笔记/、本页 园丁手册。不要用 README.md 这类发布器会特殊处理的文件名（README 会被当成目录首页映射，链接在公开站变成 404，宣言因此在 2026-08-30 改名）。不要 网络思维.md。层次保持三条路 + 主题簇，见首页 index.md。

首页有行数预算

index.md 总行数永远不超过 160 行。 首页是浅入口，现在的词条密度已近上限；花园可以持续变深，但深度长在笔记之间的链接里，不长在首页。新概念要进 index，先想怎么给它腾位置——压缩的手法是收编：同簇里关系紧密的几篇，选一篇当枢纽（通常是讲总概念的那篇），index 只挂枢纽，被收编的笔记从枢纽的正文或相关笔记一跳可达，笔记本身不删除、不降级。压不出位置，说明这个概念还不够格上首页——先在笔记层长着，等它成为一簇的枢纽再登记。

最终长成什么样

一个行业里人人可用的公共积累：

• 规模：数百篇笔记量级；每个主题簇有若干篇「果实」作为可靠核心，周围环绕幼苗与种子；首页始终是浅入口（行数预算见上），笔记多而首页不长；
• 网络：任何一篇笔记 3 次点击内可达任何相邻概念；同一篇笔记出现在多条导览上；
• 权威性：果实级内容交叉印证过标准（ISO 5500x、ISO 14224、SAE JA1011 等）与多个现场实践，可被外部引用；
• 活性：有人沿导览进来、从搜索进来、带着实践回来种笔记。花园真正的果实结在花园之外。

三、生长方向

按当前疏密（写作时：资产管理 26 篇、维修维保 16 篇、财务合规 8 篇、投资规划 5 篇、信息系统 4 篇、备件 MRO 3 篇），衍生的优先级：

1. 合规与穿透式监管——花园宣言 定位的深耕重点，目前只有一颗种子。向国资监管、行政事业单位资产、上市公司内控、特种设备法规等方向展开。同根的政策热点是闲置低效资产及物资的盘活（过紧日子、清理低效无效资产、存量资产证券化），从 闲置低效资产盘活 向公物仓实务、呆滞物资、不动产盘活等方向生长。
2. 工业物联——三大板块中最薄。从业务侧写起：状态监测的测点选择、数据质量、报警到工单的闭环、边缘与平台的分工；仍然不写产品。
3. 维保服务的手艺与生意——诊断案例、检维修工艺、班组管理、师徒传承；也包括服务提供方一侧的视角：制造商售后、授权服务中心（ASC）、集团运维公司（利润中心），起点见 面向客户的维保服务。这是「让维保成为值得尊敬的手艺」的落点，也最依赖现场经验入园。
4. 行业专篇——通用道理讲完后，按行业分蘖：钢铁、电力、石化、交通、医院、行政事业。用 行业/ 标签生长，成熟后聚合为行业导览。
5. 案例与数字——脱敏的真实案例、行业基准值（维修成本占比、库存周转、MTBF 参考区间）。数字比形容词更让笔记可信。

判断新方向的原则：读者的路走出来，再铺。 有人反复问的问题，就是下一簇的位置；没人走的路不预铺。

四、笔记规范

命名与文件

• 文件名即标题：简单直白的概念名，让搜索成为入口。好例子：工单.md、P-F曲线.md、从项目到资产的移交与转固.md；
• 中文优先，通行缩写保留英文（EAM、RCM、SAMP）；不用顿号以外的特殊符号、不用 emoji、不用序号前缀；
• 一篇只讲一个概念，3–5 分钟读完。讲不完就拆成两篇再互链。

Frontmatter 模板

---
tags: [主题/资产管理, 环节/运维, 行业/通用, 规模/通用]
maturity: 幼苗
source: 依据《某来源》某章整理
updated: 2026-08-30
---

四个维度是必要的，标签从下面的词表里选；词表不够用时先加词、再在本手册登记，避免同义分叉（教训：曾同时出现「环节/规划」与「环节/前期规划」，后合并）：

维度	现行取值
主题	资产管理 · 投资规划 · 维修维保 · 备件MRO · 财务合规 · 信息系统
环节	规划 · 购置 · 运维 · 退出 · 合规
行业	通用 · 流程制造 · 石油石化 · 交通 ·（按需新增）
规模	通用 · 中大型 · 大型 ·（按需新增）

正文骨架

1. 开头一段：这是什么、为什么值得管。若主导者不是资产管理部门，第一段就说清角色与接口；
2. 中间小节：讲道理，给例子，给数字。对比用短表格，流程可用 mermaid；不引用外链图床的图片（源材料里的语雀 CDN 图链在外网会失效），图要么用 mermaid 重画，要么落地为本地文件；
3. 「适用与局限」：必备小节。什么规模用得上、什么情况不适用、常见的误用——这是「中立与诚实」原则的落点；
4. 「相关笔记」：3–6 条互链，向上游（它依赖的概念）和下游（依赖它的概念）各至少一条。孤立的笔记等于没种。互链写法见上文「园内怎么互链」。

文风

• 短句，先结论后展开；术语首次出现给英文或缩写；
• 用「常见做法是」而不是「必须」，除非引的是法规和准则的硬性要求；
• 讲砸过的事和坑，和讲对的方法一样有价值；
• 不出现产品名与厂商倾向（发起方也不例外）；来源写进 frontmatter 的 source。

五、成熟度与晋升

标注	判据	可以什么样
种子	有线索，没想透	一个问题清单、一段案例片段也行，注明缺什么
幼苗	讲清了一个概念，来源可能单一	结构完整（含适用与局限），仍会修订
果实	两个以上独立来源交叉印证，或经现场检验	可作可靠参照、可对外引用

晋升靠证据：幼苗补上第二个独立来源或实践反馈，即可升果实。发现果实有错，先改错，必要时降级——降级不丢人，错着不改才丢人。修订理由写在正文或提交记录里。

六、日常工作流

每天补充材料的人，按七步走：

1. 读源料，找概念：一份材料通常拆出 1–5 个概念，别整篇搬运；
2. 先查重：搜 笔记/ 和 术语速查。已有笔记就补充或晋升它，不另起炉灶；只有新概念才开新文件；
3. 按规范写：骨架、frontmatter、词表标签、成熟度；
4. 织网：新笔记连旧笔记（3–6 条），再回到 1–3 篇旧笔记里补上指向新笔记的链接——双向织网是必做动作，只出不进的链接长不成网络；
5. 登记：加入 index.md 对应主题簇——先看行数预算（≤160 行），超了先收编旧词条再登记，或暂不上首页；判断是否进导览；新术语进术语速查；
6. 自查：链接可达、frontmatter 合规、无外链图床、无产品推销、案例已脱敏；
7. 成簇后铺路：某方向积累 5 篇以上，考虑在 index 单开主题簇、在导览里加节。

每月修剪：跑一次链接与 frontmatter 校验；查 index.md 行数是否仍在 160 行预算内；查标签词表有无同义分叉；updated 超过一年的果实复核一遍；重复的合并，离题的移走。

怎么提交

改完走 feature 分支 + Merge Request，不要直推 main。Obsidian 本机自动同步若直写 main，先 git pull origin main 再提交，避免与 Editor_Wiki 的 MR 交叉。

七、修订记录

• 2026-08-30 初版。基于第一版 61 篇（8 个主题簇、3 条导览）的整理经验写成。
• 2026-08-30 并入园内双链约定、不抄内部目录、feature 分支提交纪律。
• 2026-08-30 生长方向第 3 条并入服务提供方视角（制造商售后、ASC、集团运维公司），对应新笔记 面向客户的维保服务。
• 2026-08-30 README.md 改名为 花园宣言：VitePress 对 README 做首页映射，[[README]] 在公开站解析成 ..html 导致 404。
• 2026-08-30 「商业案例」改名 立项论证：Business Case 直译成「商业案例」易误解为案例分析，全园 9 处引用同步更新。
• 2026-08-30 index 主题簇按生命周期重排：原「投资规划与项目转固」「生命周期环节」两簇互相重叠，拆为「投资规划与立项」「从项目到资产」「在用与退出」三簇；资产关键性分析 归入维修维保，生命周期成本 归入财务与合规，在建工程与资本化 不再重复登记。
• 2026-08-30 撤销 index「案例与参考」簇：SAMP文件长什么样、交通行业资产管理指南概览 并入基础概念，术语速查 保留在入口段。
• 2026-08-30 「闲置资产与共享调剂」改名 闲置低效资产盘活，范围扩到低效资产、不动产与呆滞物资——对象不只设备，状态不只闲置。
• 2026-08-30 全园停用 [[index]] 双链：index 被发布器映射为站点根，双链在公开站 404。指首页改写 index.md 或完整 URL，规则记入「园内怎么互链」。
• 2026-08-30 定下首页行数预算：index.md 不超过 160 行，新词条靠收编旧词条换空间，入口保持浅、深度靠链接生长。