psyche-manual · diff
git:20260906.77bde61 to git:20260909.62926cf
45 added, 58 removed. Audit A to A.
---
name: psyche-manual
- last_changed_at: 2026-09-06T00:00:00Z
+ last_changed_at: 2026-09-09T00:00:00Z
description: >
- Short routing table for the four durable domains — pad, lingtai (灵台), knowledge,
- and skills — with one shared file-mutation/rebuild model; routes settings and the
- separate `.rules` heartbeat signal to focused references.
+ Compact router for Psyche's four durable domains (pad, lingtai, knowledge,
+ skills), the shared file→rebuild model, redacted settings, and the separate
+ `.rules` heartbeat reference.
related_files:
- src/lingtai/tools/psyche/CONTRACT.md
- src/lingtai/tools/psyche/ANATOMY.md
- src/lingtai/tools/psyche/settings.py
- src/lingtai/agent.py
- src/lingtai/intrinsic_skills/pad-manual/SKILL.md
- src/lingtai/intrinsic_skills/lingtai-manual/SKILL.md
- src/lingtai/tools/knowledge/manual/SKILL.md
- src/lingtai/tools/skills/manual/SKILL.md
- src/lingtai/tools/context/manual/SKILL.md
- src/lingtai/kernel/base_agent/lifecycle.py
- src/lingtai/kernel/base_agent/__init__.py
- src/lingtai/tools/avatar/manual/SKILL.md
- src/lingtai/intrinsic_skills/psyche-manual/reference/settings/SKILL.md
- src/lingtai/intrinsic_skills/psyche-manual/reference/network-rules/SKILL.md
- tests/test_psyche_family.py
- tests/test_avatar_rules.py
maintenance: |
- This is the psyche family's own manual, loaded by
- `psyche(action='manual', input={}, reasoning='...')`.
- Keep it a short router: settings and `.rules` procedures belong to the two
- focused references below. Update it with src/lingtai/tools/psyche/{CONTRACT,ANATOMY}.md
- when the public action inventory, durable-source ownership, or rebuild model
- changes; keep the `.rules` signpost aligned with `avatar-manual § 9` and
- `_check_rules_file`.
+ Keep this short router aligned with the psyche Contract/Anatomy, installed
+ domain manuals, settings anchors, and the `.rules` lifecycle signpost. Put
+ detailed procedure in the focused references rather than expanding this entry.
---
# Psyche
- `psyche` is the one public root for the four durable domains that survive a molt:
-
- > pad + lingtai + knowledge + skills = psyche
+ Psyche is the read-only public root for **pad + lingtai + knowledge + skills**.
+ Routine schema-sufficient calls may go directly to their action. For unfamiliar
+ or consequential work, read the matching domain manual first; use this router
+ only if the domain is unclear. There is no required router-then-domain double read.
## Routing table
- | Call | Returns | Durable source it teaches |
- |---|---|---|
- | `psyche(action="pad", input={}, reasoning="load Pad guidance")` | `pad-manual` | `system/pad.md` and pinned Pad references |
- | `psyche(action="lingtai", input={}, reasoning="load identity guidance")` | `lingtai-manual` | `system/lingtai.md` (灵台 / character) |
- | `psyche(action="knowledge", input={}, reasoning="load knowledge guidance")` | the knowledge manual | `knowledge/<name>/KNOWLEDGE.md` entries |
- | `psyche(action="skills", input={}, reasoning="load skills guidance")` | the skills manual | `.library/{intrinsic,custom}/` and configured skill paths |
- | `psyche(action="settings", input={}, reasoning="inspect Psyche settings")` | a fully redacted settings view | Psyche's owner inputs and applied snapshot |
- | `psyche(action="manual", input={}, reasoning="load the routing table")` | this router | — |
+ | Call (strict `input={}`) | Returns / owner |
+ |---|---|
+ | `psyche(action="pad", input={}, reasoning="load Pad guidance")` | Pad manual: `system/pad.md`, `system/pad_append.json` |
+ | `psyche(action="lingtai", input={}, reasoning="load identity guidance")` | LingTai manual: `system/lingtai.md` |
+ | `psyche(action="knowledge", input={}, reasoning="load knowledge guidance")` | Knowledge manual: `knowledge/<name>/KNOWLEDGE.md` |
+ | `psyche(action="skills", input={}, reasoning="load skills guidance")` | Skills manual: `.library/{intrinsic,custom}/` and configured paths |
+ | `psyche(action="settings", input={}, reasoning="inspect Psyche settings")` | redacted settings SHOW |
+ | `psyche(action="manual", input={}, reasoning="load the routing table")` | this router |
- All six calls use strict empty `input` (`input={}`); any key is rejected before dispatch.
- Every action is read-only. For an unfamiliar domain, call manual first; the
- returned domain manuals own the detailed procedure.
+ All six actions require strict empty `input` and are read-only: no authoring,
+ editing, pinning, installing, migration, catalog rescan, or prompt reload. Keep
+ root `summarize=false` when exact guidance matters.
## One mutation model
- `psyche` has no mutating action. To change durable content, use `file.write` for
- a full rewrite or `file.edit` for an exact replacement on the owning source, then
- apply it once with `context(action="rebuild", input={}, reasoning="apply durable changes")`.
- A file mutation never hot-loads the prompt; passive refresh or molt may apply the
- same candidate. There is no per-domain reload, and catalog setup/refresh remains
- owned by Skills or Knowledge.
-
- ## Lifecycle ownership
-
- `psyche` owns no lifecycle action: `context` owns `molt`, `summarize`, and
- `rebuild`, while `system` owns identity/name. Full reconstruction composes the
- enabled durable sections together; domain manuals own their own catalog and
- source procedures.
+ Change durable content with `file.write` (full rewrite) or `file.edit` (exact
+ replacement) on its owning path, then apply one
+ `context(action="rebuild", input={}, reasoning="apply durable changes")` (or let
+ refresh/molt reconstruct). File mutation never hot-loads; there is no per-domain
+ reload, and Skills/Knowledge retain catalog ownership.
- ## Settings
+ ## Lifecycle and settings
- `psyche(action="settings", input={}, reasoning="inspect Psyche settings")` is a
- SHOW-only action with fully redacted values. Read the [settings reference](reference/settings/SKILL.md)
- for the complete owner-document contract and application procedure.
+ `context` owns `molt`, `summarize`, and `rebuild`; `system` owns lifecycle
+ controls and mechanical names. LingTai owns self-authored character guidance.
+ `settings` is SHOW-only, fully redacted, and reports the last successful applied
+ snapshot. Read [the settings reference](reference/settings/SKILL.md) for grammar,
+ precedence, timing, rollback, and all eight anchors.
### Setting pad
- Owner/default/apply contract: [settings reference](reference/settings/SKILL.md#setting-pad).
+ [settings reference](reference/settings/SKILL.md#setting-pad)
### Setting pad file
- Owner/default/apply contract: [settings reference](reference/settings/SKILL.md#setting-pad-file).
+ [settings reference](reference/settings/SKILL.md#setting-pad-file)
### Setting base prompt
- Owner/default/apply contract: [settings reference](reference/settings/SKILL.md#setting-base-prompt).
+ [settings reference](reference/settings/SKILL.md#setting-base-prompt)
### Setting base prompt file
- Owner/default/apply contract: [settings reference](reference/settings/SKILL.md#setting-base-prompt-file).
+ [settings reference](reference/settings/SKILL.md#setting-base-prompt-file)
### Setting covenant
- Owner/default/apply contract: [settings reference](reference/settings/SKILL.md#setting-covenant).
+ [settings reference](reference/settings/SKILL.md#setting-covenant)
### Setting covenant file
- Owner/default/apply contract: [settings reference](reference/settings/SKILL.md#setting-covenant-file).
+ [settings reference](reference/settings/SKILL.md#setting-covenant-file)
### Setting comment
- Owner/default/apply contract: [settings reference](reference/settings/SKILL.md#setting-comment).
+ [settings reference](reference/settings/SKILL.md#setting-comment)
### Setting comment file
- Owner/default/apply contract: [settings reference](reference/settings/SKILL.md#setting-comment-file).
+ [settings reference](reference/settings/SKILL.md#setting-comment-file)
## Network rules protocol (`.rules`)
- `.rules` is a separate heartbeat signal, not a Psyche action or a rebuild API.
- Read the [network-rules reference](reference/network-rules/SKILL.md) before using
- that boundary.
-
- ## `summarize`
-
- Use the short-result profile and leave root `summarize` `false`: manual actions
- return exact guidance, while settings returns its redacted view.
+ `.rules` is a separate heartbeat signal, not a Psyche action or rebuild API. Read
+ the [network-rules reference](reference/network-rules/SKILL.md) before using it;
+ its atomic write, consumption, replacement, and verification hazards differ from
+ ordinary file→rebuild.