Coder/deepseek-harness
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(i18n): core-data-structures and postmortem batch — 22 bilingual pairs

Browse Source 
core-data-structures 18 篇（core.md 因超长仍在产出、随后补）、
postmortem 3 篇与 RFC 前门 README 配对；流水线 + 二遍校验产出。
生成文件 docs/rfc/INDEX.md（gen-rfc-index 产物）列入排除。中文侧
页内锚点统一指向英文侧锚名，满足配对门禁的链接目标一致规则。
This commit is contained in:
Ziya
2026-07-15 23:11:25 -07:00
parent ec47f2e40f
commit 5270dcd61d
67 changed files with 2512 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/core-data-structures/filesystem.md
View File

@@ -1,5 +1,7 @@
# Filesystem
English | [中文](filesystem.zh.md)
The optional filesystem capability has four parts: [dsh-fs](../../packages/fs/fs) owns `ctx.fs` and atomic text operations with optional version guards, [dsh-fs-local](../../packages/fs/fs-local) implements local disk, [dsh-fs-policy](../../packages/fs/fs-policy) adds observed-state and freshness rules through events rather than a service, and [dsh-tool-fs](../../packages/fs/tool-fs) directly executes model-facing read/write/edit calls and renders windows. It is outside the agent-loop spine; alternate backends do not change policy or tool schemas.
The model is **additive, not subtractive**: `ctx.fs` alone is a complete, unconstrained text-storage seam (`write` unconditionally creates-or-overwrites, `edit` unconditionally replaces literal text). `dsh-fs-policy` is a plugin that *adds* policy on top by deciding the `fs/*` waterfalls; removing it leaves the bare provider rather than breaking the tool, because the tool is not method-coupled to the policy. A deployment that loads `dsh-tool-fs` is expected to also load `dsh-fs-policy` so the default behavior is read-before-write/edit.