AGENTS.md@frontend/packages/react/src/modulesA

AGENTS.md@frontend/packages/react/src/modules from volcengine/openviking is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add volcengine/openviking/frontend/packages/react/src/modules/AGENTS.md@git:20261105.9c48090

Pins git:20261105.9c48090 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
volcengine/openviking
Path
frontend/packages/react/src/modules/AGENTS.md
Versions recorded
2
Latest version
git:20261105.9c48090, committed Nov 5, 2026
First version recorded
Nov 4, 2026
Size
3,852 bytes
Repository stars
41,589
License
AGPL-3.0

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Modules Agent Guide

适用于本目录及其子目录,同时遵循 [Frontend Agent Guide](../../../../AGENTS.md)。目录用途与开发入口见 [README](./README.md)。

## 业务模块职责

- 当前模块规划聚焦个人终端,不包含管理后台;模块粒度与组合边界以 [README](./README.md) 为准,不再以工作台整页作为交付单元。
- 按可独立接入的业务能力组合 Hook 与 `components/`,不承载完整页面。Hook 管理请求、响应适配、业务数据状态和操作;组合视图调用 Hook,将数据与回调传给组件。不把请求或业务编排下沉到组件及其内部 Hook。
- 以共同完成的交互流程划分模块,共享状态与联动在模块内维护。目录、搜索和预览组成 `file-browser`,由统一 Hook 协调资源选择、定位、加载与刷新;VikingBot 与 TUI 组成 `console`,统一管理面板模式、工具栏与上下文,各自维护会话和执行状态。不按这些内部视图分别开放业务模块。内部可拆私有 Hook,纯视图组件仍可独立消费。
- 模块公开 Hook 必须能脱离组合视图独立使用,返回数据、状态与操作,允许宿主替换视图或重新组合。通用展示与交互复用组件层,模块私有视图、Hook、类型和工具留在模块内。
- 默认通过共享 Client 消费 OpenViking 原生 API 的路径、入参与响应类型,继承 Provider 请求配置;模块与独立 Hook 通过可选 `requestOptions` 局部覆盖,不要求宿主逐模块提供 Adapter。不硬编码服务地址、凭证或账号,不引用宿主私有接口类型。非标准网关在宿主请求接入层适配;认证、账号作用域、路由、权限执行及产品专属流程由宿主负责。
- 加载、错误、分页、刷新、重试及流式连接等数据状态与异步清理由模块 Hook 负责。资源或账号切换、卸载时清理请求和订阅,避免过期结果覆盖当前状态。跨实例共享行为通过明确的数据服务接入。
- 依赖方向为 `modules → components`,模块 Hook 调用共享 Client,Client 不依赖 React Context;组件层不反向依赖模块。配置继承、URL 拼接、headers 与响应解析遵循 [请求约定](./README_CN.md#请求契约与默认配置),不在模块中重复实现。跨模块通用 Hook 有真实复用需求后再放入 `hooks/`。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add volcengine/openviking/frontend/packages/react/src/modules/AGENTS.md@sha256:b2c53c9fed3e2ca7

The line at the top of this page pins the label git:20261105.9c48090, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_z6sk2hxwf6a2sfpa.svg)](https://markdownregistry.com/a/art_z6sk2hxwf6a2sfpa)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Nov 4, 2026 and Nov 5, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261105.9c48090 latest2026-11-05 9c48090 3,852 BA view · diff
git:20261104.0b713a52026-11-04 0b713a5 3,849 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (3852 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

volcengine/openviking · 41,589 stars · license AGPL-3.0 · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_z6sk2hxwf6a2sfpa
GET https://markdownregistry.com/api/v1/resolve?ref=volcengine/openviking/frontend/packages/react/src/modules/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/b2c53c9fed3e2ca7a19de269e2dc8bf8591623ae4c067727e46103f23cb51229

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from volcengine/openviking

openviking-memory SKILL.md skill
volcengine/openviking · agent-plugins/skills/openviking-memory/SKILL.md · Recall and persist long-term memory through the OpenViking MCP tools. Use at the start of any substantive task (coding…
git:20261014.46e15a2 · audit A · 41,589 stars
openviking-skills SKILL.md skill
volcengine/openviking · agent-plugins/skills/openviking-skills/SKILL.md · Find, use, create, install, share, update, and migrate agent skills stored in OpenViking (viking://~/skills and…
git:20261102.88c72b9 · audit A · 41,589 stars
ov-experience-memory SKILL.md skill
volcengine/openviking · agent-plugins/skills/ov-experience-memory/SKILL.md · Retrieve and apply OpenViking Experience memories through the Agent runtime's generic OpenViking search and read tools…
git:20261001.0fabc5e · audit A · 41,589 stars
ov-kanban SKILL.md skill
volcengine/openviking · agent-plugins/skills/ov-kanban/SKILL.md · Work through tasks on a kanban board stored in OpenViking (viking://agent/kanban/<board>/, one markdown file per task)…
git:20260929.5b23459 · audit A · 41,589 stars
ov-memory-troubleshoot SKILL.md skill
volcengine/openviking · agent-plugins/skills/ov-memory-troubleshoot/SKILL.md · Diagnose OpenViking memory issues by tracing backward from a memory file to its archive memory_diff.json and, when…
git:20260910.e03ce0a · audit A · 41,589 stars
ov-resources SKILL.md skill
volcengine/openviking · agent-plugins/skills/ov-resources/SKILL.md · Search and read documents, repos, URLs, and other resources stored in OpenViking under viking://resources/. Use…
git:20261102.88c72b9 · audit A · 41,589 stars
experience_loader SKILL.md skill
volcengine/openviking · benchmark/tau2/train/experience_loader_template/SKILL.md · Load relevant OpenViking experience memories via case-linked experience candidates before solving a task.
git:20260703.fd73dcf · audit A · 41,589 stars
cron SKILL.md skill
volcengine/openviking · bot/workspace/skills/cron/SKILL.md · Schedule reminders and recurring tasks.
git:20260228.006a06f · audit A · 41,589 stars
github-proxy SKILL.md skill
volcengine/openviking · bot/workspace/skills/github-proxy/SKILL.md · GitHub 国内访问加速 skill,使用 githubproxy.cc 代理加速 GitHub 仓库克隆、文件下载、Raw 文件访问等操作。使用场景:(1) 需要 git clone GitHub 仓库时加速,(2) 下载…
git:20260228.006a06f · audit A · 41,589 stars
github SKILL.md skill
volcengine/openviking · bot/workspace/skills/github/SKILL.md · Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and…
git:20260228.006a06f · audit A · 41,589 stars
opencode SKILL.md skill
volcengine/openviking · bot/workspace/skills/opencode/SKILL.md · Monitor and manage your OpenCode tasks using helper scripts.
git:20260309.c4cdb5f · audit A · 41,589 stars
skill-creator SKILL.md skill
volcengine/openviking · bot/workspace/skills/skill-creator/SKILL.md · Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
git:20260228.006a06f · audit A · 41,589 stars

Every file in volcengine/openviking

Browse by kind, by grade A, or by owner.