Files
marqdo/lib/hash.mq.md
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00

2.7 KiB
Executable File

markup, title, description
markup title description
occlusion lib/hash Digests and HMAC (Mid M3). Integrity / cache keys — not password hashing.

Digests and HMAC. For integrity and cache keys — not password storage.

Compute content digests and keyed message authentication.

Behavior and limits: MD5/SHA1 are compatibility checksums, not password storage. Use security auth for passwords and fs.file_hash for bounded-memory binary file hashing.

This single source file is the usage and development manual. Import it directly, or use marqdo call with a function heading below. Parameter tables give types and defaults; required parameters must be supplied. Return tables are progressive contracts; prose describes failure and limits.

Implementation: src/host/hash.rs

For development, keep EN/ZH behavior aligned and compose public libraries first. Add host primitives only at OS or algorithm boundaries and declare their effects. Run marqdo check --narrative-ratio on this file and the real workflows in tests/stdlib_tasks.rs after edits.

sha256

参数 类型 默认 说明
text text required Text supplied by the caller
返回 类型 说明
result text SHA-256 hex digest of text

Use text as the inputs for this operation.

Effects: pure.

Call this function directly:

marqdo call lib/hash.mq.md sha256 'text="abc"' --effects none --json

SHA-256 hex digest of text.

Caller: [hash.sha256] text=s

Return [SHA-256 hex digest of text](> host_hash_sha256 text=text).

sha1

参数 类型 默认 说明
text text required Text supplied by the caller
返回 类型 说明
result text SHA-1 hex digest of text

Use text as the inputs for this operation.

Effects: pure.

SHA-1 hex digest of text.

Return [SHA-1 hex digest of text](> host_hash_sha1 text=text).

md5

参数 类型 默认 说明
text text required Text supplied by the caller
返回 类型 说明
result text MD5 hex digest of text

Use text as the inputs for this operation.

Effects: pure.

MD5 hex digest of text.

Return [MD5 hex digest of text](> host_hash_md5 text=text).

hmac_sha256

参数 类型 默认 说明
key text required Field name or key required by this operation
text text required Text supplied by the caller
返回 类型 说明
result text HMAC-SHA256 of text with key

Use key, text as the inputs for this operation.

Effects: pure.

HMAC-SHA256 of text with key.

Return [HMAC-SHA256 of text with key](> host_hash_hmac_sha256 key=key text=text).