Home / webnsnm / terminal-manage · AGENTS.md · GitHub

AGENTS.md agentsA

Name: AGENTS.md
Author: webnsnm

AGENTS.md is agent-read markdown (agents) from webnsnm/terminal-manage.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# AGENTS.md

This file provides guidance to Codex (Codex.ai/code) when working with code in this repository.

## 项目概述

DevMaster 是一个基于 Electron 33 + Vue 3 + Express 5 的跨平台桌面开发管理工具。用于可视化管理本地项目、执行脚本、监控进程资源、集成 AI 辅助功能。

## 常用命令

```bash
# 开发模式（同时启动 server:3000 + client:2118）
npm run dev

# 仅启动后端（带 --watch 自动重载）
npm run server

# 仅启动前端
npm run client

# 前端构建
cd client && npm run build

# Electron 桌面应用启动
npm start

# 打包桌面安装程序（Windows NSIS / macOS DMG）
npm run dist
```

**注意：** 项目无测试套件，无 ESLint 配置。

## 架构

### 整体结构：Electron 三层架构

```
main.js (Electron 主进程)
  ├── server/index.js (Express 后端，端口自动分配)
  └── client/dist/ (Vue 3 前端，生产环境由 Express 静态托管)
```

- **Electron 主进程** (`main.js`)：创建 BrowserWindow，启动内嵌 Express 服务器，端口使用 `0` 自动分配可用端口。
- **开发模式**下前端独立运行在 2118 端口，通过 Socket.io 连接后端 3000 端口。

### 前后端通信

所有前后端交互通过 **Socket.io** 实现，不使用 REST API。

关键 Socket 事件：
- `scan-dir` / `open-folder-dialog` — 项目扫描与目录选择
- `start-task` / `stop-task` — 脚本执行与进程管理
- `git:get-diff` / `git:commit` — Git 操作
- `config:load` / `config:save` — 持久化配置（存储于 `~/.devmaster-config.json`）
- `proxy:Codex` — AI 代理请求
- `monitor:update` — 进程资源监控广播（每 2 秒）

### 后端核心 (`server/index.js`)

单文件服务器，职责：
…

Read the whole file at its exact version.

How to install

Latest version

mdr add webnsnm/terminal-manage/AGENTS.md@git:20260326.199fc1a

Exact content

mdr add webnsnm/terminal-manage/AGENTS.md@sha256:2f9fa9b0c965c3b9

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

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

1 badge views in 30 days

Versions

version	committed	commit	size	audit
git:20260326.199fc1a latest	2026-03-26	199fc1a	3,351 B	A	view

Audit of the latest version

A 14 of 14 checks passed. Deterministic, no model, same answer every run.

pass: Size between 200 bytes and 200 KB (3351 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

webnsnm/terminal-manage · 32 stars · license none · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_423yz37u5jau6cos
GET https://markdownregistry.com/api/v1/resolve?ref=webnsnm/terminal-manage/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/2f9fa9b0c965c3b904eb942ddcd0473ad92a8258ce3b43986aea57a76ffa7794

Your agent 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.